Client scripts de catálogo

Os scripts do lado do cliente podem adicionar efeitos dinâmicos e validação a formulários. Os scripts podem ser aplicados a itens do catálogo de serviços ou conjuntos de variáveis, permitindo que os administradores usem a mesma funcionalidade disponível em outros formulários.

Você pode usar scripts do lado do cliente para:

• Obtenha ou defina valores de variáveis.
• Oculte ou exiba variáveis.
• Tornar as variáveis obrigatórias ou não.
• Valide o envio do formulário.
• Adicione algo ao carrinho.
• Peça algo imediatamente.

Considerações sobre client script do catálogo

Ao criar client scripts de catálogo, esteja ciente das seguintes considerações.

• Os client scripts do catálogo são executados quando um usuário solicita um item do catálogo de serviços. Os client scripts de catálogo também podem ser executados quando variáveis ou conjuntos de variáveis para um item do catálogo são exibidos quando um usuário solicita esse item.
• Para que uma variável possa ser acessada usando um client script de catálogo, ela deve ter um nome de variável. Variáveis sem nomes não aparecem na lista de variáveis disponíveis.
• Ao usar client scripts padrão em um formulário Item solicitado ou Tarefa do catálogo, anote os campos com o mesmo nome das variáveis. Se um campo de tabela e uma variável com o mesmo nome estiverem presentes em um formulário, o campo da tabela será correspondido quando for acessado usando um script. Se isso acontecer, resolva especificamente a variável nomeando-a como variáveis.variable name. Por exemplo: g_form.setValue('variables.replacement', 'false');
• Se você estiver usando produtores de registro para passar variáveis do catálogo de serviços para outros tipos de registros, essas variáveis ficarão visíveis nesses registros com um editor de variáveis, como o formatador de IU do editor de variáveis de mudança nos formulários de solicitação de mudança. Você pode manipular essas variáveis usando métodos de client script padrão, como setDisplay, setMandatory,setValuee getValue.
• Os client scripts de catálogo podem ser usados para itens do catálogo incluídos em um assistente.
• Você pode usar a API g_form.refreshSlushbucket(fieldName) para atualizar uma variável do coletor de lista.

Diferenças do client script do catálogo

Os client scripts de catálogo são muito semelhantes aos client scripts padrão, com algumas diferenças importantes.

• Em vez de selecionar uma tabela como Incidente para o script, selecione um item do catálogo ou conjunto de variáveis. Como seu sistema pode ter um grande número de itens do catálogo, você deve selecionar um item do catálogo ou conjunto de variáveis usando um campo de referência em vez da lista de seleção que o formulário de Script de cliente padrão usa.
• Ao usar um client script de catálogo onChange(), ele é vinculado a uma variável específica em vez de um campo. O sistema preenche automaticamente a lista de seleção de nomes de variáveis com todas as variáveis nomeadas do item do catálogo ou do conjunto de variáveis selecionado.

Criar um client script de catálogo

Siga este procedimento para criar um client script de catálogo.

Procedimento

1. Navegar até Tudo > Catálogo de serviços > Administração de Catálogo > Scripts de cliente de catálogo.
   Uma lista de client scripts do catálogo personalizado atual é exibida.
2. Clique em Nova.
3. Preencha os campos, conforme apropriado (consulte a tabela).

   Campo	Descrição
   Nome	Insira um nome exclusivo para o client script do catálogo.
   Aplica-se a	Selecione o tipo de item ao qual este client script se aplica: Um item do catálogo: habilita o campo Item do catálogo. Um conjunto de variáveis: habilita o campo Conjunto de variáveis.
   Ativo	Marque a caixa de seleção para habilitar o client script. Desmarque a caixa de seleção para desabilitar o script.
   Tipo de IU	Se deve ser aplicado ao desktop, dispositivo móvel ou ambos.
   Script	Insira o client script que deve ser executado no item do catálogo de serviços.
   Tipo	Selecione quando o script deve ser executado, como onLoad ou onSubmit.
   Item do catálogo ou conjunto de variáveis	Selecione um item do catálogo ou um conjunto de variáveis na lista. O nome do campo e as opções disponíveis dependem da seleção no campo Aplica-se a.
   Aplica-se a uma exibição de Item do catálogo	Marque a caixa de seleção para aplicar o client script do catálogo aos itens do catálogo exibidos na tela de pedido no catálogo de serviços. Disponível na exibição do solicitante.
   Aplica-se a itens solicitados	Marque a caixa de seleção para aplicar o client script do catálogo em um formulário de item solicitado, depois que o item for solicitado. Disponível na exibição do executante. Consulte VEditor.
   Aplica-se a Tarefas de catálogo	Marque a caixa de seleção para aplicar o script do cliente do catálogo quando um formulário de Tarefa do catálogo para o item estiver sendo exibido. Disponível na exibição do executante. Consulte VEditor.
   Aplicável ao registro de destino	Marque a caixa de seleção para oferecer suporte à política de IU de catálogo em um registro criado para tabelas estendidas de tarefa por meio de produtores de registro. Consulte Editor de variáveis padrão.

4. Clique em Enviar.

Exemplos de client script do catálogo

Exemplos de client scripts para executar ações comuns.

Obter o valor de uma variável

Use a seguinte sintaxe para obter o valor de uma variável do catálogo. Observe que a variável deve ter um nome. Substitua o nome_da_variável pelo nome da variável.

g_form.getValue('variable_name');

Restringir o número de caracteres que um usuário pode digitar em uma variável

Este é um exemplo de um script que é executado quando a variável é exibida, em vez de quando o item é solicitado.

function onLoad(){
  var sd = g_form.getControl('short_description');
  sd.maxLength=80;
}