Parte 4 do tutorial: Instalar e usar uma biblioteca de terceiros

Instale uma biblioteca de terceiros do Gerenciador de pacotes de nós (npm) e use-a em um módulo JavaScript.

Antes de Iniciar

Concluído Tutorial parte 3: Definir uma tabela em ServiceNow Fluentcódigo.

Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

A instalação de bibliotecas de terceiros permite que você use a funcionalidade de código aberto existente em módulos JavaScript para acelerar o desenvolvimento de aplicações. Em seguida, você pode consultar os módulos JavaScript que chamam código de terceiros a partir de definições de script do lado do servidor em seu código-fonte, como a regra de negócio no index.now.ts arquivo.

Neste exemplo, você instala uma biblioteca Lodash para obter utilitários e métodos JavaScript comuns. Você usa um desses métodos, SnakeCase , em ShowStateUpdate Em um módulo JavaScript de amostra para exibir uma cadeia de caracteres de mensagem em maiúsculas, que separa palavras com sublinhados em vez de espaços. Em index.now.ts arquivo, a regra de negócio de amostra está configurada para usar o. ShowStateUpdate Para o script e a ser executado depois que um registro é atualizado na tabela de itens de tarefa pendente [x_snc_hello_world_to_do].

Procedimento

1. Instale o. SnakeCase Método da biblioteca Lodash em sua aplicação.
   1. Na Barra de atividades, selecione a exibição do Explorador de arquivos ( ).
   2. Abra o. pacote.json arquivo da aplicação.
   3. Após o. Dependências , adicione o. dependências campo com o nome do pacote e a versão da biblioteca.

      },
          "dependencies": {
              "lodash.snakecase": "4.1.1"
          }
      }

   4. Para aplicações que usam typescript em módulos JavaScript, adicione os tipos lodash.snakecase ao Dependências campo para obter as anotações de tipo para a biblioteca.

      "devDependencies": {
              "@types/lodash.snakecase": "4.1.1",
              "typescript": "5.5.4",
              "@servicenow/sdk": "2.2.4",
              "@servicenow/glide": "26.0.1",
              "eslint": "8.50.0",
              "@servicenow/eslint-plugin-sdk-app-plugin": "2.2.4"
          }

   5. Salve as mudanças.
   6. Quando solicitado, selecione Instale dependências ausentes .
      Dica:

      Você também pode selecionar o ícone Instalar dependências ( ) ou use o. Gerenciador de pacotes: Instalar dependências da paleta de comandos.

      

      As bibliotecas são instaladas como módulos no node_modules diretório.
2. Use o código da biblioteca Lodash em um módulo JavaScript em sua aplicação.
   1. Navegue até src/servidor em sua aplicação.
   2. Abra o. script.ts módulo de amostra.
   3. Em AddInfoMessage método, encapsular a cadeia de caracteres da mensagem no SnakeCase Método de Lodash para convertê-lo em snake case.

      gs.addInfoMessage(snakeCase(`state updated from "${previousState}" to "${currentState}"`))

   4. Na linha 2, adicione uma importação para SnakeCase método no lodash módulo.

      import snakeCase from 'lodash.snakecase'

      Nota:

      As APIs globais Glide também são importadas para que você possa usar métodos como AddInfoMessage no código do módulo.

      import { gs } from '@servicenow/glide'

   5. Salve as mudanças.
3. Na Barra de status, selecione Criar e instalar .

   . instalação Concluído com sucesso, as bibliotecas Lodash são adicionadas à tabela Módulo ECMAScript [sys_module] e o. script.ts O módulo é atualizado na tabela Módulo ECMAScript [sys_module].

Resultado

Após você atualizar qualquer campo em um registro na tabela Itens de tarefa pendente [x_snc_hello_world_to_do], a regra de negócio de amostra é executada e exibe a mensagem em maiúsculas e minúsculas, com as palavras separadas por sublinhados em vez de espaços.

O que Fazer Depois

Continuar para Tutorial parte 5: Clonar a aplicação em uma instância diferente.