--- sourceDocument: Criar ou modificar aplicações do Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/application-development Release : - xanadu ft:locale : - pt-BR ft:publication_title : - Criar ou modificar aplicações do Xanadu ft:clusterId : - cadev bundleId : - cadev workflow : - Creator --- # ServiceNow CLI # ServiceNow CLI {#ariaid-title1} * Versão de lançamento: Xanadu * * Atualizado 1 de ago. de 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 min. de leitura O ServiceNow CLI é uma interface de linha de comando que permite executar operações de instância do seu sistema local. Você pode estender a CLI para incluir novos comandos que atendam às necessidades da sua aplicação. ## Benefícios {#servicenow-cli__section_a1z_jcg_f4b} O ServiceNow CLI permite que você: * Execute operações CRUD básicas em registros em sua instância. * Desenvolva componentes personalizados e implante-os em sua instância para personalizar uma IU. * Crie comandos personalizados que permitem gerenciar aplicações personalizadas na linha de comando. * Use o ServiceNow CLI em scripts para simplificar as tarefas de configuração e as atividades operacionais. {#servicenow-cli__ul_stw_lcg_f4b} ## Arquitetura {#servicenow-cli__section_mrl_kbh_f4b} Os comandos são armazenados em uma tabela na instância à qual você está conectado. Quando o ServiceNow CLI se conecta à instância, ele recebe todos os comandos disponíveis compatíveis com essa instância. Os comandos são mapeados para um endpoint REST que é executado de forma assíncrona. Para obter mais informações, consulte [Criar um comando personalizado no ServiceNow CLI](https://servicenow-prod.fluidtopics.net/gdD0_h3dN~UkN95utGAk6Q "Gerencie sua aplicação personalizada na linha de comando criando comandos personalizados no ServiceNow CLI."). ## Como ativar o ServiceNow CLI {#servicenow-cli__section_mkq_tcr_2nb} Instale ServiceNow CLI solicitando-o do ServiceNow Store. Acesse o site [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) para ver todos os aplicativos disponíveis e obter informações sobre como enviar solicitações para a loja. Para obter informações sobre notas de versão cumulativa para todos os aplicativos liberados, consulte as [ServiceNow Store notas de versão do histórico de versão](https://www.servicenow.com/docs/bundle/store-release-notes/page/release-notes/store/sn-store-release-notes.html).{#servicenow-cli__servicenow-cli-rn-activation} ## Arquivo de configuração {#servicenow-cli__section_g4p_fzt_j4b} O ServiceNow CLI armazena informações de perfil em um arquivo config.json que, por padrão, é armazenado em seu diretório inicial no seguinte caminho: * Linux e Mac: \~/.snc/config.json * Windows: %USERPROFILE%\\.snc\\config.json {#servicenow-cli__ul_evp_nf5_j4b} A CLI usa este arquivo para determinar quais informações usar para se conectar a uma instância e quais configurações usar para gerar a saída. Por padrão, o ServiceNow CLI usa as configurações encontradas no perfil padrão para se conectar a uma instância. Para usar configurações alternativas, você pode criar e fazer referência a perfis nomeados adicionais. Para obter mais informações, consulte [Configurando e gerenciando seus perfis de conexão ServiceNow CLI](https://servicenow-prod.fluidtopics.net/PBxmmAOF5JpJ1MnCYWYm5w "Crie um perfil de conexão para se conectar com sua instância, exibir perfis de conexão, atualizar sua conexão e comandos disponíveis ou excluir perfis que não são mais necessários."). O exemplo a seguir mostra um arquivo de configuração com um perfil padrão e um perfil nomeado. Cada perfil pode usar credenciais diferentes e especificar hosts e formatos de saída diferentes. { "profiles":{ "default":{ "host":"https://myinstance.service-now.com", "loginmethod":"basic", "username":"admin", "output":"json", "hostversion":"Paris", "appversion":"1.0" }, "user1":{ "host":"https://otherinstance.service-now.com", "loginmethod":"basic", "username":"user1", "output":"yaml", "hostversion":"Paris", "appversion":"1.0" } } } Nota: As informações de credenciais confidenciais são armazenadas somente no conjunto de chaves do SO, não no arquivo de configuração. ## Estrutura de comando {#servicenow-cli__section_igh_ysm_j4b} ServiceNow CLI comandos seguem esta estrutura: 1. A chamada de base para o programa `snc`. 2. O grupo de comandos de nível superior seguido por quaisquer grupos de comandos secundários. 3. O comando que especifica qual operação executar. 4. Argumentos gerais da CLI necessários para a operação. Você pode especificar argumentos em qualquer ordem. {#servicenow-cli__ol_nz1_nrm_j4b} $ snc [arguments] Os argumentos podem ter vários tipos de valores de entrada, como números, cadeias de caracteres e objetos JSON. Os tipos compatíveis dependem do comando especificado. ## Valores de argumento {#servicenow-cli__section_hs4_4vt_j4b} Muitos valores de argumento em ServiceNow CLI são cadeias de caracteres simples ou valores numéricos, como a tabela e o nome da tabela no exemplo a seguir. $ snc record create --table incident --data "{short_description: 'New Incident'}" Você pode colocar entre aspas cadeias de caracteres que não contenham caracteres de espaço ou não. No entanto, você deve usar entre aspas as cadeias de caracteres que incluem um ou mais caracteres de espaço. ## Formatos de saída {#servicenow-cli__section_zkf_xst_j4b} O ServiceNow CLI oferece suporte a quatro formatos de saída: * `json`: a saída é formatada como JSON. Este é o padrão. { "default": { "appversion": "1.0.8", "host": "https://myinstance.service-now.com", "hostversion": "Paris", "loginmethod": "basic", "output": "json", "username": "admin" }, "user1": { "appversion": "1.0.8", "host": "https://otherinstance.service-now.com", "hostversion": "Paris", "loginmethod": "basic", "output": "yaml", "username": "admin" } } * `yaml`: a saída é formatada como YAML. Use YAML para lidar com a saída com serviços e ferramentas que emitem ou consomem cadeias de caracteres no formato YAML. default: appversion: 1.0.8 host: https://myinstance.service-now.com hostversion: Paris loginmethod: basic output: json username: admin user1: appversion: 1.0.8 host: https://otherinstance.service-now.com hostversion: Paris loginmethod: basic output: yaml username: admin * `text`: a saída é formatada como várias linhas de valores de cadeia de caracteres separados por tabulação. Use esta saída com ferramentas de texto tradicionais do UNIX, como grep, sed e awk, e com o processamento de texto realizado pelo PowerShell. default https://myinstance.service-now.com Paris 1.0.8 basic admin json user1 https://otherinstance.service-now.com Paris 1.0.8 basic admin yaml * `tabela`: a saída é formatada como uma tabela que apresenta as informações em um formato legível. NAME HOST HOST VERSION APP VERSION LOGIN METHOD USERNAME OUTPUT ------------------------------------------------------------------------------- default myinstance Paris 1.0.8 basic admin json user1 otherinstance Paris 1.0.8 basic admin yaml * `none`: a CLI não imprime a saída no console. As mensagens de sucesso, erro e andamento ainda são exibidas. {#servicenow-cli__ul_zwq_zdt_l4b} Você pode especificar a saída do comando de duas maneiras: Use a opção de `saída` em um perfil nomeado no arquivo de configuração : O exemplo a seguir define o formato de saída padrão como texto. { "profiles":{ "default":{ "output":"text" } } Use o argumento `--output` na linha de comando : O exemplo a seguir define a saída de um único comando como JSON. Esta opção no comando substitui qualquer valor definido atualmente no arquivo de configuração. $ snc record query --table incident --query 'active=true' --output json * **[Instalar o ServiceNow CLI](https://servicenow-prod.fluidtopics.net/Gs3s3ouv0stG3P6udnRqNw)** Instale o ServiceNow CLI em uma máquina Mac, Windows ou Linux. * **[Configurando e gerenciando seus perfis de conexão ServiceNow CLI](https://servicenow-prod.fluidtopics.net/PBxmmAOF5JpJ1MnCYWYm5w)** Crie um perfil de conexão para se conectar com sua instância, exibir perfis de conexão, atualizar sua conexão e comandos disponíveis ou excluir perfis que não são mais necessários. * **[Obtenha ajuda com ServiceNow CLI](https://servicenow-prod.fluidtopics.net/0fqbLS7T5tqqEM1STgmfqA)** Consulte os comandos, opções de comando e exemplos disponíveis ou gere a saída de registro em log de depuração. * **[Executar operações de registro usando ServiceNow CLI](https://servicenow-prod.fluidtopics.net/StLqwrp37oICUkUr3_6FaA)** Crie, leia, atualize, exclua e consulte registros em sua instância usando a ferramenta de linha de comando ServiceNow CLI. * **[Criar um comando personalizado no ServiceNow CLI](https://servicenow-prod.fluidtopics.net/gdD0_h3dN~UkN95utGAk6Q)** Gerencie sua aplicação personalizada na linha de comando criando comandos personalizados no ServiceNow CLI. * **[Gerenciar ServiceNow CLI extensões](https://servicenow-prod.fluidtopics.net/WWJ~vzAIYvs~5wnT_Mtgfg)** Adicione extensões a ServiceNow CLI para carregar funcionalidades e comandos adicionais, atualizar extensões existentes ou remover extensões de que não precisa mais. * **[ServiceNow CLI comandos disponíveis](https://servicenow-prod.fluidtopics.net/0EQqqGNMjHin8XWPf5hPmg)** Comandos e argumentos de comando disponíveis para o sistema de base ServiceNow CLI. * **[Comandos instalados com CMDB API e CLI da aplicação](https://servicenow-prod.fluidtopics.net/xjPKEM8SW_Be2GLN~F1AWQ)** Comandos e grupos de comandos disponíveis para o ServiceNow CLI quando o plug-in app-cmdb-api-cli está instalado.