Criar uma aplicação com ServiceNow SDK

  • Versão de lançamento: Zurich
  • Atualizado 30 de jan. de 2025
  • 2 min. de leitura
  • Crie uma aplicação com escopo para desenvolver no código-fonte com o. ServiceNow SDK.

    Antes de Iniciar

    Use o. ServiceNow SDKpara autenticar em um ServiceNowinstância. Para obter mais informações, consulte Autenticando em um ServiceNowinstância com ServiceNow SDK.

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Este procedimento usa o. ServiceNow SDKInterface de linha de comando (CLI). Em uma ferramenta de linha de comando, insira now-sdk --help para obter informações sobre os comandos disponíveis e opções globais. Para obter informações adicionais sobre um comando e seus parâmetros, insira o comando e. --help ou -h . Por exemplo, now-sdk auth --help . Para obter mais informações sobre a CLI, consulte ServiceNow SDK CLI.

    Procedimento

    1. Crie um diretório local para sua aplicação.
    2. Em Visual Studio Code, abra o diretório.
    3. No diretório da aplicação, abra uma janela de terminal integrada.
    4. Crie uma aplicação seguindo um conjunto guiado de prompts com o. iniciar comando:
      npx @servicenow/sdk init
      Nota:
      Usando o. npx o comando instala o. ServiceNow SDKem seu diretório de aplicações em vez de globalmente.
    5. Responda à série de prompts a seguir.
      Aviso Resposta
      Selecione um modelo Selecione um modelo que defina a estrutura da aplicação padrão:
      • Padrão básico do Now-sdk: Uma aplicação com apenas a estrutura básica necessária para o desenvolvimento no código-fonte.
      • Now-sdk e básico: Uma aplicação configurada para desenvolvimento em ServiceNow FluentE JavaScript.
      • JavaScript Now-sdk e fullstack React: Uma aplicação configurada para desenvolvimento em ServiceNow FluentJavaScript e React.
      • Now-sdk e básico: Uma aplicação configurada para desenvolvimento em ServiceNow FluentE typescript. Arquivos de origem typescript no src/servidor Os diretórios são transferidos para os módulos JavaScript.
      • Now-sdk e fullstack React: Uma aplicação configurada para desenvolvimento em ServiceNow Fluent, Typescript e React. Arquivos de origem typescript no src/servidor Os diretórios são transferidos para os módulos JavaScript.
      Nome da aplicação ServiceNow Insira um nome para a aplicação.
      Nome do pacote npm Insira um nome para o pacote de aplicações usado no pacote.json arquivo.

      O nome do pacote deve aderir aos padrões de nomenclatura de pacote do Gerenciador de pacotes de nó (npm).

      Nome do escopo Insira o escopo da aplicação.

      O nome do escopo deve ser exclusivo na instância, começar com x_<prefix> e ter 18 caracteres ou menos. Para obter mais informações, consulte Identificador do namespace.

      No exemplo a seguir, uma aplicação com escopo chamada Exemplo de aplicação (x_snc_example_app) é criada.
      $ npx @servicenow/sdk init
      [now-sdk] Bootstrapping a new ServiceNow application project...
      ? Select a template: now-sdk + basic
      ? Name of ServiceNow Application:  Example App
      ? NPM package name:  example-app
      ? Scope name:  x_snc_example_app
      [now-sdk] Application created successfully.
                Install the required dependencies with your preferred package manager before running "$now-sdk build".
                Ex: Run "npm install" if using npm.
    6. Instale as dependências de terceiros necessárias usando o gerenciador de pacotes preferido.
      Por exemplo, se você usar o Gerenciador de pacotes de nós (npm), execute instalação do npm .
    7. Crie a aplicação com o. criar comando:
      now-sdk build
    8. Opcional: Instale a aplicação em uma instância com instalar comando:
      now-sdk install --auth <alias>

    Resultado

    Uma aplicação com escopo com a estrutura de aplicação padrão está disponível localmente. Para obter informações sobre a estrutura da aplicação, consulte Estrutura da aplicaçãoSeção do tópico Criando aplicações no código-fonte.

    Se você instalou a aplicação com sucesso, ela estará disponível na instância. Para obter mais informações sobre como instalar aplicações, consulte Crie e. instalar uma aplicação com ServiceNow SDK.

    O que Fazer Depois

    Em Visual Studio Code, comece a desenvolver sua aplicação no código-fonte com ServiceNow Fluent, Escrevendo módulos JavaScript personalizados ou adicionando bibliotecas de terceiros. Para obter mais informações, consulte Desenvolvendo aplicações com o. ServiceNow SDK.