API de ação de script - ServiceNow Fluent

A API Ação de script define ações de script [sysevent_script_action] que são executadas quando ocorre um evento.

Para obter informações gerais sobre execuções de script agendadas, consulte Script actions.

Conceitos relacionados

• ServiceNow Fluent

Objeto ScriptAction

Crie uma ação de script [sysevent_script_action] que execute uma tarefa quando acionada por um evento.

Tabela 1. Propriedades

Nome	Tipo	Descrição
id	Cadeia de caracteres ou número	Necessário. Um ID exclusivo para o objeto de metadados. Quando você cria a aplicação, este ID é hash em um sys_id exclusivo. Para obter mais informações, consulte ServiceNow Fluent construções de linguagem. Formato: Now.ID['Cadeia de caracteres' ou número]
nome	Cadeia de caracteres	Necessário. Um nome exclusivo para a ação de script.
script	Script	Necessário. Um script do lado do servidor que é executado quando acionado por um evento. Esta propriedade é compatível com uma função de um módulo JavaScript, uma referência a outro arquivo na aplicação que contém um script ou JavaScript em linha. Formato: Para funções, use o nome de uma função, expressão de função ou função padrão exportada de um módulo JavaScript e importe-a para o. .now.ts arquivo. Para obter informações sobre módulos JavaScript, consulte Módulos JavaScript e bibliotecas de terceiros. Para usar conteúdo de texto de outro arquivo, consulte um arquivo na aplicação usando o seguinte formato: Now.include('path/to/file') . Para obter mais informações, consulte ServiceNow Fluent construções de linguagem. Para fornecer um script em linha, use literais de cadeia de caracteres ou literais de modelo para várias linhas de código: "Script" ou "Script" .
eventName	Cadeia de caracteres	Necessário. O evento que aciona a execução da ação de script. Para obter informações sobre como criar eventos, consulte Create an event.
ativo	Booliano	Sinalizador que indica se a ação de script está habilitada. Valores válidos: Verdadeiro: A ação de script é executada quando acionada pelo evento. Falso: A ação de script não é executada. Padrão: falso
descrição	Cadeia de caracteres	Uma descrição da funcionalidade e da finalidade da ação de script.
pedido	Número	Um número que indica a sequência na qual a ação de script deve ser executada. Se houver várias ações de script em um evento específico, as ações de script serão executadas na ordem especificada, da mais baixa para a mais alta. Padrão: 100
Script	Cadeia de caracteres	Uma declaração condicional JavaScript que especifica os campos e valores que devem ser verdadeiros para que o script seja executado. Nota: Não use esta propriedade se você incluir a declaração de condição com script propriedade. Formato: Para usar conteúdo de texto de outro arquivo, consulte um arquivo na aplicação usando o seguinte formato: Now.include('path/to/file') . Para obter mais informações, consulte ServiceNow Fluent construções de linguagem. Para fornecer um script em linha, use literais de cadeia de caracteres ou literais de modelo para várias linhas de código: "Script" ou "Script" .
meta	Objeto	Metadados dos metadados da aplicação. Com o. Método de instalação , você pode mapear os metadados da aplicação para um diretório de saída que carrega somente em circunstâncias específicas. $meta: {       installMethod: 'String' } Valores válidos para Método de instalação : Demonstração: Gera os metadados da aplicação para o. metadados/unload.demo diretório a ser instalado com a aplicação quando Carregar dados de demonstração a opção está selecionada. Primeira instalação: Gera os metadados da aplicação para o. metadados/descarregamento diretório a ser instalado somente na primeira vez que uma aplicação for instalada em uma instância.

import { ScriptAction } from '@servicenow/sdk/core'
import { insertIncident } from '../server/scripts.js'

ScriptAction({
    $id: Now.ID['sample-script-action'],
    name: 'SampleScriptAction',
    active: true,
    description: 'Insert an incident',
    script: insertIncident,
    eventName: 'sample.event',
    order: 100,
    conditionScript: "gs.hasRole('my_role')"
})

. script a propriedade refere-se a uma função do scripts.js módulo. Por exemplo:

import { GlideRecord } from '@servicenow/glide'

export const insertIncident = () => {
    var gr = new GlideRecord('incident')
    gr.initialize()
    gr.setValue('short_description', 'New incident from event')
    gr.insert()
}