Crie ou converta uma aplicação com o ServiceNow SDK

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

    • Crie uma aplicação com escopo ou converta uma aplicação existente para desenvolver no código de origem com o ServiceNow SDK.

    Antes de Iniciar

    Instale ou faça upgrade do ServiceNow SDK usando npm. Para mais informações, confira Instalar o ServiceNow SDK ou Atualizar a ServiceNow SDK.

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Este procedimento usa a ServiceNow SDK interface de linha de comando (CLI). Para obter mais informações sobre os comandos e os parâmetros disponíveis, consulte ServiceNow SDK CLI.

    Procedimento

    1. No diretório em que você deseja adicionar uma aplicação, abra uma ferramenta de linha de comando no sistema.
    2. Inicie o ServiceNow SDK. 
      now-sdk
      O ServiceNow SDK retorna informações sobre os comandos disponíveis.
      Dica:
      Para obter informações adicionais sobre um comando, insira o comando e o parâmetro --help ou -h. Por exemplo, now-sdk auth --help.
    3. Autentique-se em uma instância de não produção ServiceNow.
      A instância deve estar na versão Xanadu.
      1. Armazene suas credenciais de usuário usando um alias com o comando auth. 
        now-sdk auth save [<alias>] [--host <instance url>] [--username <admin username>]

        As credenciais são armazenadas no conjunto de chaves do dispositivo ou no gerenciador de credenciais do seu sistema.

        Para definir este alias como o alias padrão, adicione o parâmetro --default ou -d ao seu comando.

        Por exemplo:
        now-sdk auth save devuser1 --host https://myinstance.service-now.com --username user1 --default
      2. No prompt, insira sua senha.
    4. Crie uma aplicação com escopo ou converta uma aplicação existente para uso com o ServiceNow SDK.
      OpçãoEtapas
      Criar uma aplicação com escopo
      1. Crie uma aplicação seguindo um conjunto orientado de avisos usando o comando create :
        now-sdk create <scopeName> --interactive
        Por exemplo:
        now-sdk create x_snc_example --interactive
        Nota:
        O nome do escopo deve ser exclusivo na instância, começar com x_<prefix> e ter 12 caracteres ou menos. Para obter mais informações, consulte Identificador de namespace.
      2. Responda aos seguintes avisos:
        • Nome da aplicação com escopo:<application name>
        • Descrição associada a sys_app:<description>
        • Modelo de projeto? Selecionar TypeScript ou JavaScript
        • Nome do pacote do NPM:<package name>
        • Adicionar uma tabela de amostra à aplicação? [Sim/Não]
        • Criar estrutura de projeto de módulo JS ou Fluent? Selecionar Fluente ou Módulo

          Esta opção determina a estrutura da aplicação padrão com base em se você deseja usar ServiceNow Fluent e módulos JavaScript e bibliotecas de terceiros na aplicação (fluente) ou usar somente módulos JavaScript e bibliotecas de terceiros (módulo).
      Converter uma aplicação existente Converta uma aplicação com escopo existente da sua instância usando o comando convert :
      now-sdk convert <scopeName> <packageName> --projectType <type>

      Use o parâmetro --projectType para especificar o tipo de aplicação a ser criado. Esta opção determina a estrutura da aplicação padrão com base em se você deseja usar ServiceNow Fluent e módulos JavaScript e bibliotecas de terceiros na aplicação (fluente) ou usar somente módulos JavaScript e bibliotecas de terceiros (módulo).

      Por exemplo:
      now-sdk convert x_snc_example example-app --projectType fluent

      A conversão de uma aplicação adiciona os arquivos e diretórios necessários para usar o ServiceNow SDK localmente e baixa os metadados da aplicação como ServiceNow Fluent código de origem ou arquivos XML, dependendo do tipo de projeto. A aplicação não é alterada na instância.

    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 a seção Estrutura da aplicação do tópico Criando aplicações no código de origem.

    Se a aplicação for criada e implantada na instância, a CLI retornará o URL para a aplicação, como https://myinstance.service-now.com/sys_app.do?sys_id=<sysID> . Se você optar por não criar e registrar a aplicação na instância durante a criação, a aplicação não será implantada na instância até que você faça isso. Para obter mais informações, consulte Criar e implantar uma aplicação com o ServiceNow SDK.

    O que Fazer Depois

    Em Visual Studio Code, comece a desenvolver sua aplicação em código de origem com ServiceNow Fluent, escrevendo módulos JavaScript personalizados ou adicionando bibliotecas de terceiros.