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

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 2 min. de leitura

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

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    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. Para usar o TypeScript em módulos, consulte Uso de TypeScript em módulos JavaScript com o ServiceNow SDK.

    Procedimento

    1. Em Visual Studio Code, abra o diretório de aplicações com escopo.
    2. 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.
    3. Opcional: Importe as APIs globais do Glide para chamá-las do seu módulo. 
      import { gs } from '@servicenow/glide'
    4. 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 };
    5. 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.
    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 o ServiceNow SDK.

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