Crie e use módulos JavaScript em aplicações no IDE da ServiceNow

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 3 min. de leitura
  • Otimize sua base de código definindo blocos de código reutilizáveis com módulos JavaScriptem IDE da ServiceNow.

    Antes de Iniciar

    Crie, converta ou clone uma aplicação e adicione-a ao seu espaço. Para obter mais informações, consulte Adicionando aplicações em IDE da ServiceNow.

    Nota:
    Para usar typescript em módulos, selecione typescript como o tipo de modelo ao criar uma aplicação.

    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.

    Nota:
    Com Now Assist para Code, Você pode usar a habilidade de preenchimento automático de código para gerar sugestões de código para scripts de módulo. Para obter mais informações, consulte Generate code with autocomplete.

    Procedimento

    1. Navegar até Tudo > Desenvolvimento de apps > ServiceNow IDE.
    2. Abra um espaço com uma aplicação.
    3. Na Barra de atividades, selecione a exibição do Explorador de arquivos ( Explorador de arquivos).
    4. 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.
    5. 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";
    6. 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 };
      
    7. 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.
    8. Salve as mudanças.
    9. Na Barra de status, selecione Criar e instalar .

      Crie e implante

      O arquivo ativo que está aberto no editor determina qual aplicação criar. Se nenhum arquivo estiver aberto, selecione a aplicação a ser criada quando solicitado.

      Após a compilação, os módulos são adicionados à tabela Módulo ECMAScript [sys_module].

    O que Fazer Depois

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