Criar ou converter uma aplicação com o SDK ServiceNow

Crie uma aplicação com escopo ou converta uma aplicação existente para usar módulos JavaScript e bibliotecas de terceiros em sua aplicação.

Antes de Iniciar

Instale o ServiceNow SDK usando o Node Package Manager (npm). Para obter mais informações, consulte Instalar o SDK ServiceNow.

Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

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

Procedimento

1. Abra uma ferramenta de linha de comando em seu sistema a partir do diretório ao qual você deseja adicionar uma aplicação.
2. Inicie o ServiceNow SDK.

   now-sdk

   O 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. Autenticar para uma instância de não produção ServiceNow.
   A instância deve estar na versão Washington DC.
   1. Armazene suas credenciais de usuário nas chaves do dispositivo ou no gerenciador de credenciais do sistema usando um alias com o comando auth.

      now-sdk auth save [<alias>] [--host <instance url>] [--username <admin username>]

      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 SDK.

   Opção	Etapas
   Criar uma aplicação com escopo	Crie uma aplicação seguindo um conjunto orientado de avisos usando o comando create : now-sdk create <projectName> <scopeName> --interactive Por exemplo: now-sdk create example-app x_snc_example --interactive Nota: O nome do projeto deve estar em conformidade com os padrões de nomenclatura de pacote do NPM. O nome do escopo deve começar com x_<prefix> e ter 18 caracteres ou menos. Para obter mais informações, consulte Identificador de namespace. Responda aos seguintes avisos: Descrição associada a sys_app:<description> Criar e registrar a aplicação na instância? [Sim/Não] Adicionar uma tabela de amostra à aplicação? [Sim/Não]
   Converter uma aplicação existente	Converta uma aplicação com escopo existente de sua instância usando o comando converter : now-sdk convert <scopeName> <packageName> Por exemplo: now-sdk convert x_snc_example example-app Nota: Para converter uma aplicação global, use o nome da aplicação para o parâmetro scopeName e o sys_ID da aplicação com o parâmetro --scopeId. A conversão de uma aplicação baixa os arquivos XML de metadados da aplicação e adiciona os arquivos e diretórios necessários para usar o SDK localmente. A aplicação não é alterada na instância. Para obter mais informações, consulte a seção Estrutura da aplicação ] do tópico ServiceNow do SDK.

Resultado

Uma aplicação com escopo com a estrutura de aplicação básica está disponível localmente. 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 SDK ServiceNow.

O que Fazer Depois

Crie e use módulos JavaScript ou bibliotecas de terceiros em sua aplicação. Para obter mais informações, consulte Criar e usar módulos JavaScript em aplicações e Usar bibliotecas de terceiros em aplicações.