Scripts em linha

Permita que usuários com experiência em codificação escrevam scripts em linha que definem e modificam valores de entrada durante a configuração de uma ação ou fluxo. Use scripts em linha para modificar valores de entrada que exigem pequenas conversões de formato, transformações de dados ou operações matemáticas.

Você também pode modificar valores de entrada sem script usando funções de transformação. Para obter uma lista de opções disponíveis, consulte Funções de transformação.

Workflow Studio Exibe um botão Script quando você configura esses componentes.

• Entradas de ação quando você configura a ação para um fluxo
• As saídas de ação quando você configura a ação para um fluxo
• Entradas de lógica de fluxo quando você configura a lógica de fluxo para um fluxo
• A lógica de fluxo é gerada quando você configura a lógica de fluxo para um fluxo
• Entradas de etapa quando você configura a etapa para uma ação.
• Entradas de subfluxo quando você configura o subfluxo para um fluxo.
• Saídas de subfluxo quando você configura o subfluxo para um fluxo.

Os scripts em linha devem retornar valores no mesmo tipo de dados que a entrada espera. Por exemplo, um script em linha para uma entrada de registro deve retornar um objeto GlideRecord e um script em linha para uma entrada de data deve retornar um valor de data/hora. Sempre teste ações e fluxos que contenham scripts em linha e verifique se não há erros de tempo de execução nos detalhes de execução do fluxo.

Os escritores de script devem estar familiarizados com ServiceNow AI Platform estruturas de tabela e. tipos de campo . Além disso, eles devem saber como trabalhar com dados de registro e do sistema usando o. ServiceNow API.

Benefícios

Os scripts em linha oferecem esses benefícios.

• Ative a conversão ou transformação de dados simples sem precisar criar ações ou fluxos personalizados.
• Identifique quais dados de entrada um script afeta.
• Acesso restrito a recursos de script para usuários ou grupos que tenham conhecimento do disponível ServiceNow APIs.

Acesso ao script em linha

Você pode conceder aos usuários acesso a scripts on-line concedendo a eles a função flow_designer_scripting ou o. Permitir script permissão de desenvolvimento delegada. A função e a permissão de desenvolvedor exibem um campo de botão de script para cada um Workflow Studio entrada.

Botão de script

Quando você habilita um usuário para criar scripts em linha, Workflow Studio exibe um botão de script ao lado das entradas de fluxo e etapa.

Figura 1. Os botões de script são exibidos ao lado das entradas

Clicando em Script O botão abre o editor de scripts, que substitui a interface de entrada padrão. Insira um script para calcular o valor de entrada.

Certifique-se de que seu script inclua um retorno declaração com os resultados do seu script. Por exemplo, Devolver shortDesc; retorna o valor de ShortDesc variável.

Figura 2. Editor de script para entrada

Clicando em Recolher script O botão oculta o editor de scripts e exibe uma versão somente leitura da entrada. Clicando em Expanda Script O botão exibe o editor de scripts e permite que você edite o script.

Figura 3. Entrada que contém script

Workflow Studio objeto de dados

Os gravadores de script podem usar o. fd_data objeto para acessar dados de ações e etapas anteriores. Use o. fd_data objeto para passar por pontos para uma saída específica do fluxo. Você pode usar as sugestões de digitação antecipada do editor de scripts para selecionar um valor de saída específico. Por exemplo, insira fd_data e selecione _2__for_each.item a partir das sugestões de digitação antecipada para criar uma referência de referência de referência com pontos fd_data._2__for_each.item . Esta referência acessa dados da segunda saída do fluxo, que neste exemplo é um para cada item de lógica de fluxo.

Importante:

O objeto fd_data sempre requer uma referência de referência de referência com pontos para uma saída de fluxo específica. Sem uma referência de referência com pontos, o script em linha não pode acessar Workflow Studio dados.

Workflow Studio atualiza o objeto de dados sempre que você salva sua ação, fluxo ou subfluxo. Se as sugestões de digitação antecipada não incluírem sua meta, tente salvar a ação, o fluxo ou o subfluxo e, em seguida, digite novamente o caractere de ponto para atualizar a lista de sugestões.

Tabela 1. Opções de objeto de dados do Designer de fluxo

Destino de dados	Sintaxe de referência	Exemplo
Entrada de ação	fd_data.action_inputs. action-input-name	tarefa de var: fd_data.action_inputs.task;
Variável de fluxo	fd_data.flow_var. nome-variável-fluxo	Var shortDesc: fd_data.flow_var.short_description;
Saída da ação anterior, lógica de fluxo ou etapa	fd_data._ output-target-step-number __ output-target-name	Var taskRecord: fd_data._2__create_task;
Entrada de subfluxo	fd_data.subflow_inputs. nome-de-entrada-subfluxo	VAR reqItem: fd_data.subflow_inputs.requested_item;
Gatilho	fd_data.gatilho. trigger-data-pílula	fd_data.trigger.current;

Diretrizes gerais

Siga estas diretrizes gerais para criar scripts em linha reutilizáveis e de fácil manutenção.

Escreva script em linha para lógica pequena não reutilizável

Use o formato de script em linha ou modifique os dados para entradas e casos de uso específicos. Para operações de formatação e conversões de dados de entrada padrão e reutilizáveis, selecione uma função de transformação.

Revise as funções de transformação disponíveis

Workflow Studio fornece uma lista de funções de transformação padrão para conversões de dados e operações de formatação. Em vez de gravar e manter uma solução de script personalizada, selecione uma função de transformação existente, se houver uma disponível.

Inclusões de script de chamada do script em linha

Chame uma inclusão de script do seu script em linha para reduzir a quantidade de código que você escreve e também para manter o código comum em um único local. Use o construtor de classe para chamar sua inclusão de script. Para obter mais informações sobre como criar uma inclusão de script, consulte Script includes.

var si = new MyScriptInclude();
si.functionOne();

Crie ações personalizadas ou subfluxos para código reutilizável em vez de script em linha

Crie ações ou subfluxos personalizados para lógica de dados reutilizáveis ou complexos, como alterar o tipo de dados dos dados de origem. Você também pode querer fornecer ações personalizadas ou subfluxos para designers de fluxo que não se sentem confortáveis com o código.

Evite duplicar a ação e a funcionalidade de fluxo

Evite escrever script em linha que duplica a funcionalidade de ação e fluxo. Por exemplo, em vez de gravar script em linha para executar operações de registro, use as ações de linha de base Criar e atualizar registro.

Evite mudanças de tipo de dados

Evite erros de tempo de execução verificando se o script em linha fornece informações no mesmo tipo de dados que a entrada ou saída espera.

Crie variáveis declarando-as com a palavra-chave var

Use o. var Palavra-chave para declarar variáveis para que elas permaneçam dentro do escopo JavaScript apropriado. Quando você cria uma variável atribuindo um valor a ela, o JavaScript pode anexá-la ao objeto global, o que pode resultar em valores de variáveis persistindo fora do escopo local e causando erros.

Saídas de registros de processo com para cada lógica de fluxo e o objeto de dados de fluxo

O script em linha só pode acessar o. registros Saída de uma ação Pesquisar registros de para cada lógica de fluxo. Adicione uma ação Pesquisar registros ao fluxo para gerar a saída de registros. Adicione um para cada lógica de fluxo ao fluxo para processar cada registro na saída de registros. Crie uma referência de script em linha para cada lógica de fluxo usando os objetos fd_data e item. Por exemplo, esta referência pressupõe que para cada lógica de fluxo é o segundo item no contorno de fluxo fd_data._2__for_each.item .

Use sugestões de digitação antecipada para gerar referências a dados de fluxo e ação.

Crie referências para dados de fluxo e ação usando o objeto fd_data. O editor de script exibe sugestões de digitação antecipada para dados de fluxo e ação existentes quando você digita fd_data . Selecione uma sugestão para criar referências para dados de fluxo e ação.

Nota:

Consulte os dados de registro em um para cada lógica de fluxo usando item objeto.

Contadores de loop de escopo

Os loops de script não têm um número máximo de iterações, portanto, os loops são executados infinitamente quando não há uma condição de saída válida.

Para garantir que haja uma condição de saída válida, use contadores de loop de escopo em scripts em linha ou em etapas de script em uma ação.Adicionar var para para (i: 0; i menor comprimento; i maior que) e obter para (var i: 0; i menor comprimento; i maior que)

Considerações de licenciamento

Os scripts em linha que chamam APIs de integração estão sujeitos a. IntegrationHub licenciamento.

Editor de código

O editor de código fornece suporte ao editor de texto para scripts em linha.

O editor de código tem esses recursos para os serviços de idiomas compatíveis e. Scripts em linha .

• Coloração de sintaxe, recuo, números de linha e criação automática de chaves de fechamento e aspas
• Auto-sugestões e conclusões automáticas

Figura 4. Editor de código

Editando dicas

• Para inserir um espaço fixo em qualquer lugar do seu código, pressione Tab.
• Para recuar uma única linha de código, clique no espaço em branco à esquerda da linha e pressione Tab.
• Para recuar uma ou mais linhas de código, selecione o código e pressione Tab. Para diminuir o recuo, pressione Shift e Tab.
• Para remover uma guia do início de uma linha de código, clique na linha e pressione Shift e Tab.
• Para declarar variáveis, use var Palavra-chave para que permaneçam dentro do escopo JavaScript apropriado.