Criar e usar módulos JavaScript em aplicações no ServiceNow IDE

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 2 min. de leitura

    • Otimize sua base de código definindo blocos de código reutilizáveis com módulos JavaScript no ServiceNow IDE.

    Antes de Iniciar

    Crie, converta ou clone uma aplicação e adicione-a ao seu espaço. Para obter mais informações, consulte os seguintes tópicos:
    Nota:
    Para usar o 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 a página de módulos JavaScript no site do MDN Web Docs.

    Procedimento

    1. Navegar até Tudo > Desenvolvimento de apps > IDE da ServiceNow.
    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. No diretório src/server da aplicação, crie um arquivo JavaScript ou TypeScript para conter o código do módulo que você deseja reutilizar.
    5. Opcional: Importe as APIs globais do Glide para chamá-las do seu módulo. 
      import { gs } from '@servicenow/glide'
    6. No módulo, identifique o código a ser exportado com instruções de exportação.

      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. No diretório src/server, crie ou abra um módulo JavaScript.
      2. Importe o código do módulo com instruções de importação.
        O exemplo a seguir é uma maneira de importar um recurso exportado em um módulo:
        import { feature } from "path/to/module";
      3. Chame o código do módulo deste módulo para reutilizá-lo.
      Script do lado do servidor no código de origem
      1. Crie ou abra a definição de metadados da aplicação que inclui um script do lado do servidor, como uma regra de negócio, no código de origem (arquivo.now.ts ).
      2. Na propriedade do 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 precedido por um marcador de script.
        • Importe uma função exportada, uma expressão de função ou uma função padrão. Por exemplo:
          script: FunctionExport,
        • Os scripts em linha devem usar instruções de requisição para importar o código do módulo. Por exemplo:
          script: 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 de origem, consulte ServiceNow Fluent Referência de API.
      Registro de script do lado do servidor
      1. Abra o registro para um script do lado do servidor, como uma regra de negócio.
      2. Importe o código do módulo com declarações de requisitos.
        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 implantar.

      Criar e implantar

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

      Depois de criar, 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 Usar bibliotecas de terceiros em aplicações no ServiceNow IDE.