StandaloneClientMethods

Métodos de cliente autônomos são métodos que você pode usar em seus Javascripts de 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.

Autônomo - reflistOpen (cadeia de caracteres target, 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 é normalmente usado ao selecionar um ícone de lupa, ao lado de qualquer campo de referência, em formulários da IU 16.

Por exemplo, usando este método, você pode exibir dados de 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 ao usuário inserir seu próprio conjunto de critérios de consulta para selecionar os dados do campo de referência a serem exibidos.

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

"sys_user_list.do?sysparm_tiny=7ea02c4ff8a8b510f877c74d78b60460".

Nota:

reflistOpen() não é compatível com o client script do espaço. Em vez disso, use o método g_modal.showFrame().

Tabela 1. Parâmetros

Nome	Tipo	Descrição
destino	Cadeia de caracteres	ID do campo de referência de destino do formulário. Por exemplo, o ID do campo de referência de destino do parâmetro caller_id é 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 elemento target especificado. Para obter informações adicionais, confira Make a field dependent.
usarQBE	Cadeia de caracteres	Sinalizador que indica o tipo de informação a ser retornado na janela pop-up. Valores válidos: verdadeiro: exibe 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 elemento target especificado. 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.
adicionalQual	Cadeia de caracteres	Opcional. Consulta de qualificador adicional a ser usada para filtrar os resultados exibidos na janela pop-up. Por exemplo, para um campo de referência caller_id em um incidente, você pode passar o sys_id sys_id=62826bf03710200044e0bfc8bcbe5df1do usuário. A função filtra a tabela Usuário [sys_user] e mostra os resultados filtrados na janela pop-up.
parentID	Cadeia de caracteres	Opcional. Atualmente, é apenas um parâmetro interno, não é necessário passar um valor.
forceReference	Cadeia de caracteres	Opcional. Atualmente, é apenas um parâmetro interno, não é necessário passar um valor.
ignoreTargetValue	Cadeia de caracteres	Opcional. Atualmente, é apenas um parâmetro interno, não é necessário passar um valor.

Tabela 2. Retorna

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 de 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 = true, 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', '');
}