API de inclusão de script - ServiceNow Fluent

A API Inclusão de script define inclusões de script [sys_script_include] que armazenam funções e classes JavaScript para uso por scripts do lado do servidor.

Nota:

Para novos scripts, use módulos JavaScript em vez de inclusões de script quando possível para oferecer suporte à reutilização de código e ao uso de bibliotecas de terceiros em uma aplicação com escopo. Para obter mais informações sobre suporte e limitações do módulo JavaScript, consulte Módulos JavaScript e bibliotecas de terceiros.

Para obter informações gerais sobre inclusões de script, consulte Script includes.

Conceitos relacionados

• ServiceNow Fluent

ScriptIncluir objeto

Crie uma inclusão de script [sys_script_include] para definir um script do lado do servidor que seja executado quando chamado de outros scripts.

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. O nome da inclusão de script. Se você definir uma classe, o nome deverá corresponder ao nome da classe, do protótipo e do tipo. Se você usar uma inclusão de script sem classe (sob demanda), o nome deverá corresponder ao nome da função.
script	Script	Necessário. Um script do lado do servidor para chamar de outros scripts. O script deve definir uma única classe JavaScript ou uma função global. O nome da classe ou função deve corresponder a. nome propriedade. Esta propriedade oferece suporte a JavaScript em linha ou a uma referência a outro arquivo na aplicação que contém um script. 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" .
ApiName	Cadeia de caracteres	Um nome interno para a inclusão de script, que é usado para chamar a inclusão de script de aplicações fora do escopo. Padrão: <scope>.<name>
descrição	Cadeia de caracteres	Uma descrição da finalidade e da função da inclusão de script.
ClientCallable	Booliano	Sinalizador que indica se scripts do lado do cliente podem chamar a inclusão de script usando GlideAjax. A inclusão de script está disponível para scripts de cliente, filtros de lista/relatório, qualificadores de referência ou se especificado como parte da URL. As inclusões de script chamáveis do cliente são invocadas de GlideAjax E exigem que os usuários atendam a uma ACL associada à inclusão de script. Valores válidos: Verdadeiro: A inclusão de script está disponível para scripts do lado do cliente. Falso: A inclusão de script não está disponível para scripts do lado do cliente. Padrão: falso
Mobile Callable	Booliano	Sinalizador que indica se a inclusão de script está disponível para scripts de cliente chamados de dispositivos móveis. Valores válidos: Verdadeiro: A inclusão de script está disponível para scripts de cliente chamados de dispositivos móveis. Falso: A inclusão de script não está disponível para scripts de cliente chamados de dispositivos móveis. Padrão: falso
SandboxChamável	Booliano	Sinalizador que indica se a inclusão de script está disponível para scripts invocados na área restrita de script, como uma condição de consulta. Importante: As inclusões de script só devem ser disponibilizadas para a área restrita de script se necessário. Valores válidos: Verdadeiro: A inclusão de script está disponível para scripts invocados na área restrita de script. Falso: A inclusão de script não está disponível para scripts invocados na área restrita de script. Padrão: falso
Acesso do solicitante	Cadeia de caracteres	Uma opção de como o acesso entre escopos à inclusão de script é permitido. Para obter mais informações, consulte Configurações de privilégio de acesso do solicitante restrito. Valores válidos: Restrição: As chamadas para a inclusão de script devem ser aprovadas manualmente. As solicitações de acesso são rastreadas na tabela Acesso de solicitante restrito com o status Solicitado. Acompanhamento: As chamadas para a inclusão de script são aprovadas automaticamente. As chamadas são rastreadas na tabela Acesso de solicitante restrito com o status Permitido.
Acessível de	Cadeia de caracteres	Especifica quais aplicações podem acessar a inclusão de script. Valores válidos: Público: Todos os escopos da aplicação podem chamar a inclusão de script. Package_PRIVATE: A inclusão de script só pode ser chamada a partir do escopo da aplicação em que está. Padrão: Package_private
ativo	Booliano	Sinalizador que indica se a inclusão de script está habilitada. Valores válidos: Verdadeiro: A inclusão de script pode ser chamada. Falso: A inclusão de script não pode ser chamada. Padrão: verdadeiro
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.

No exemplo a seguir, a inclusão de script usa um script do SampleClass.server.js arquivo.

import { ScriptInclude } from '@servicenow/sdk/core';

ScriptInclude({
    $id: Now.ID['sample-script-include'],
    name: 'SampleScriptInclude',
    script: Now.include("./SampleClass.server.js"),
    description: 'some description',
    apiName: 'x_scope.SampleScriptInclude',
    callerAccess: 'tracking',
    clientCallable: true,
    mobileCallable: true,
    sandboxCallable: true,
    accessibleFrom: 'public',
    active: true,
})