StandaloneClientMethods

Métodos de cliente autônomo são métodos que você pode usar em JavaScripts cliente, como reflistOpen, mas não fazem parte de nenhuma classe ou API.

Você pode acessar diretamente esses métodos em um client script sem qualquer construtor ou outro tipo de instanciação antes do uso.

ReflistOpen (cadeia de caracteres de destino, cadeia de caracteres ElementName, cadeia de caracteres refTableName, cadeia de caracteres dependente, cadeia de caracteres useQBE, cadeia de caracteres refQualElements, cadeia de caracteres additionalQual, cadeia de caracteres parentId, cadeia de caracteres forceReference, cadeia de caracteres ignoreTargetValue)

Mostra os dados do campo de referência em uma janela pop-up padrão. Este método é comumente usado ao selecionar um ícone de lupa, ao lado de qualquer campo de referência, em formulários de IU 16.

Por exemplo, usando este método, você pode exibir dados do campo de referência para um conjunto específico de critérios de consulta:

Da mesma forma, você pode usar este método para exibir um formulário de pesquisa que permite que o usuário insira seu próprio conjunto de critérios de consulta para selecionar os dados do campo de referência a serem exibidos.

Ao abrir o URL no pop-up padrão, se o tamanho do URL for maior que o tamanho do TinyURL, 1024 por padrão, o URL será convertido em TinyURL, como:

"sys_user_list.do?sysparm_tiny .

Nota:

ReflistOpen() Não há suporte no Client Script do espaço. Use G_modal.showFrame() em vez disso.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
target	Cadeia de caracteres	ID do campo de referência de destino do formulário. Por exemplo, o. caller_id O ID do campo de referência de destino do parâmetro é incident.caller_id .
ElementName	Cadeia de caracteres	Nome do elemento do campo de referência do formulário. Por exemplo: caller_id
refTableName	Cadeia de caracteres	Tabela de referência a ser mapeada para o campo de referência do formulário. Por exemplo, para o campo de referência caller_id sys_user é a tabela de referência. Nesse caso, você passaria o valor sys_user .
dependente	Cadeia de caracteres	Campo dependente configurado para o especificado targetelemento. Para obter informações adicionais, confira Make a field dependent.
UseQBE	Cadeia de caracteres	Sinalizador que indica o tipo de informação a ser retornada na janela pop-up. Valores válidos: Verdadeiro: Exiba um formulário de consulta com um botão de pesquisa. Falso: Exibe os resultados da consulta. Padrão: falso
RefQualElements	Cadeia de caracteres	Qualificador de referência configurado para o especificado targetelemento. A função anexa os qualificadores de referência especificados ao URL e exibe somente os resultados filtrados na janela pop-up. Se você não quiser incluir um qualificador de referência, passe uma cadeia de caracteres vazia. Para obter informações adicionais sobre qualificadores de referência, consulte Reference qualifiers.
Qual adicional	Cadeia de caracteres	Opcional. Consulta de qualificador adicional a ser usada para filtrar os resultados exibidos na janela pop-up. Por exemplo, para um caller_id campo de referência em um incidente, você pode passar o sys_id do usuário e-mail . A função filtra a tabela Usuário [sys_user] e mostra os resultados filtrados na janela pop-up.
ID do pai	Cadeia de caracteres	Opcional. Atualmente apenas um parâmetro interno, não há necessidade de passar um valor.
ForceReferência	Cadeia de caracteres	Opcional. Atualmente apenas um parâmetro interno, não há necessidade de passar um valor.
IgnoreTargetValue	Cadeia de caracteres	Opcional. Atualmente apenas um parâmetro interno, não há necessidade de passar um valor.

Tabela 2. Retornos

Tipo	Descrição
Janela pop-up	Exibe os dados do campo de referência retornados em uma janela pop-up padrão.

O exemplo a seguir mostra como invocar este método para mostrar os dados do campo do solicitante na janela pop-up da tabela de incidentes (primeira imagem acima).

function onChange(control, oldValue, newValue, isLoading, isTemplate) {
   if (isLoading || newValue === '') {
      return;
   }

   reflistOpen('incident.caller_id', 'caller_id', 'sys_user','company', 'false', '');
}

O exemplo a seguir mostra como invocar este mesmo client script, mas com UseQBE: Verdadeiro , que exibe um botão de pesquisa e os critérios de pesquisa associados na janela pop-up (segunda imagem acima).

function onChange(control, oldValue, newValue, isLoading, isTemplate) {
   if (isLoading || newValue === '') {
      return;
   }

   //  Type appropriate comment here, and begin script below
   reflistOpen('incident.caller_id', 'caller_id', 'sys_user','company', 'true', '');
}