Client scripts de catálogo

Scripts do lado do cliente podem adicionar efeitos dinâmicos e validação aos 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 que está disponível em outros formulários.

Você pode usar scripts do lado do cliente para:

• Obter ou definir valores de variáveis.
• Ocultar ou exibir variáveis.
• Tornar variáveis obrigatórias ou não.
• Validar o envio do formulário.
• Adicione algo ao carrinho.
• Peça algo imediatamente.

Considerações de client script do catálogo

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

• Scripts de cliente de catálogo são executados quando um usuário solicita um item do catálogo de serviços. Os client scripts do 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 seja acessível 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 scripts de cliente padrão em um Item solicitado ou formulário de 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, aborde especificamente a variável nomeando-a. nome de variáveis.variável . Por exemplo: g_form.setValue('variables.replacement', 'falso');
• 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 Definir Exibição , ConfiguObrigatório , SetValue e GetValue .
• Client scripts do catálogo podem ser usados para itens do catálogo incluídos em um assistente.
• Você pode usar G_form.refreshSlushBucket(fieldName) API para atualizar uma variável do coletor de lista.

Diferenças de script do cliente do catálogo

Client scripts de catálogo são muito semelhantes aos scripts de cliente 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 um 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 Client Script padrão usa.
• Ao usar um Onchange() script de cliente do catálogo, ele está vinculado a uma variável específica em vez de um campo. O sistema preenche automaticamente a lista de seleção de nome de variável 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 isso 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 script do cliente do catálogo aos itens do catálogo exibidos na tela 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 script do cliente do catálogo em um formulário 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 scripts de cliente para executar ações comuns.

Obtenha o valor de uma variável

Use a sintaxe a seguir para obter o valor de uma variável do catálogo. Observe que a variável deve ter um nome. Substituir variable_name com o 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 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;
}