Crie e use módulos JavaScript em aplicações com ServiceNow SDK

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura

    • Otimize sua base de código definindo blocos de código reutilizáveis com módulos JavaScripte o. ServiceNow SDK.

    Antes de Iniciar

    Adicione uma aplicação ao seu sistema local com ServiceNow SDK. Para obter mais informações, consulte Adicionando aplicações com ServiceNow SDK.

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Para saber mais sobre o suporte ao uso de módulos JavaScript em aplicações com escopo, incluindo algumas limitações, consulte Módulos JavaScript e bibliotecas de terceiros. Para obter informações gerais sobre a sintaxe usada para criar módulos JavaScript, consulte Módulos JavaScript Página no site de Documentos da Web da MDN.

    Procedimento

    1. Em Visual Studio Code, abra o diretório da aplicação com escopo.
    2. Em src/servidor Diretório da aplicação, crie um arquivo javascript ou typescript para conter o código do módulo que você deseja reutilizar.
    3. Opcional: Importe APIs do servidor ou inclusões de script para chamá-los do seu módulo.

      As APIs do Glide podem ser importadas do em servicenow/glide ou seu namespace no pacote. As inclusões de script podem ser importadas do escopo da aplicação ou do escopo global no em servicenow/glide pacote.

      Por exemplo:
      import { API } from "@servicenow/glide";
import { API } from "@servicenow/glide/<namespace>";
import { ScriptInclude } from "@servicenow/glide/<scope>";
import { global } from "@servicenow/glide/global";
    4. No módulo, identifique o código com o qual exportar exportação declarações.

      Você pode usar uma exportação nomeada ou uma exportação padrão. As exportações nomeadas podem ser variáveis, constantes, funções ou classes, enquanto as exportações padrão podem ser somente funções ou classes.

      O exemplo a seguir é uma maneira de adicionar uma exportação nomeada para vários recursos (uma função e uma variável) em um módulo:
      export { myFunction, myVariable };
    5. Use o código do módulo exportado em outros módulos ou scripts do lado do servidor.
      ArquivoEtapas
      Módulo
      1. Em src/servidor Criar ou abrir um módulo javascript.
      2. Importe o código do módulo com importação declarações.
        O exemplo a seguir é uma maneira de importar um recurso exportado em um módulo:
        import { feature } from "path/to/module";
        Nota:
        Para importar código de um arquivo typescript para outro arquivo typescript, você deve incluir o. .ts extensão do arquivo. Por exemplo, importar recurso de './module.ts' .
      3. Chame o código do módulo deste módulo para reutilizá-lo.
      Script do lado do servidor no código-fonte
      1. Crie ou abra a definição de metadados da aplicação que inclua um script do lado do servidor, como uma regra de negócios, no código-fonte ( .now.ts arquivo).
      2. Em script , importe e chame o código do módulo para reutilizá-lo.
        Você pode importar uma função ou fornecer um script em linha.
        • Importe uma função exportada, expressão de função ou função padrão. Por exemplo:
          script: FunctionExport,
        • Scripts em linha devem usar necessário declarações para importar o código do módulo. Por exemplo:
          script: `
    const { process } = require('./dist/modules/server/handler.js')
    process(request, response)`,

        Para obter mais informações sobre scripts do lado do servidor no código-fonte, consulte ServiceNow Fluent Referência de API.
      Registro de script do lado do servidor
      1. Abra o registro de um script do lado do servidor, como uma regra de negócios.
      2. Importe o código do módulo com necessário declarações.
        O exemplo a seguir é uma maneira de importar um recurso exportado em um script:
        const { feature } = require("path/to/module");
      3. Chame o código do módulo deste script para reutilizá-lo.
    6. Salve as mudanças.

    O que Fazer Depois

    Para usar bibliotecas de terceiros em um módulo JavaScript, consulte Use bibliotecas de terceiros em aplicações com ServiceNow SDK.

    Para criar sua aplicação e adicionar os módulos à tabela Módulo ECMAScript [sys_module], consulte Crie e. instalar uma aplicação com ServiceNow SDK.