Configuração

Introdução

Para estabelecer uma conexão e enviar solicitações à API do ServiceNow, a atividade ServiceNow Scope precisa de um URL de ponto de extremidade para seu tenant do ServiceNow (URL do Endpoint), um nome de usuário (UserName) e senha (Password). Opcionalmente, você pode recuperar um token de acesso do OAuth do seu tenant do ServiceNow. Para recuperar o token de acesso do OAuth, ele precisa da ID do Cliente da sua instância do ServiceNow, Segredo do Cliente e URL do endpoint.

Se você optar por usar OAuth, deverá permitir que a atividade ServiceNow Scope recupere o token de acesso OAuth e permita que outras atividades enviem solicitações com sucesso à API ServiceNow. Você deve concluir as seguintes etapas:

1. Configure o OAuth.
2. Criar ativos de credenciais.
3. Construa seu projeto.
   
   

   

   
   

Configurar OAuth

Conclua as etapas da configuração do OAuth na documentação do ServiceNow. Embora as etapas documentadas provavelmente sejam as mesmas em todas as regiões da plataforma do ServiceNow, é recomendável que você siga as etapas para sua região específica caso haja diferenças (por exemplo, Token, Nova York etc.)

Para referência, veja abaixo como configuramos o OAuth para nossos exemplos.

Observação: se você já configurou o OAuth para sua instância do ServiceNow, anote o ID do cliente e o Segredo do cliente atribuídos ao registro do seu aplicativo e prossiga para a etapa 2. Criar ativos das credenciais .

1. Faça login em sua instância do ServiceNow (por exemplo, https://dev74293.service-now.com/login)

2. Acesse Definições do sistema > Plug-ins e verifique se o Status do plug-in OAuth está definido como Ativo.

   
   

   

   
   

3. Acesse Sistema OAuth > Registro de Aplicativo e clique em Novo.

   • Quando perguntado Que tipo de aplicativo OAuth?, clique em Criar um terminal de API OAuth para clientes externos.

     
     

     

     
     

4. Insira um Nome para seu aplicativo (por exemplo, UiPathQuickstart) e clique em Enviar (se for bem-sucedido, você será redirecionado de volta à lista de Registros de aplicativos ).

   
   

   

   
   
5. Na lista de Registros de aplicativos , encontre seu novo aplicativo e clique em seu Nome para abrir a página de detalhes.
6. Clique no ícone de cadeado ao lado de Segredo do cliente para mostrar o valor.

7. Anote os valores de ID do cliente e Segredo do cliente (você os inserirá na atividade Escopo do ServiceNow ).

   
   

   

   
   
8. Se você deseja que esse aplicativo OAuth seja compatível com OAuth2, defina o URL de redirecionamento como http://127.0.0.1:10001/authorize/.
   Importante:

   A partir da v1.3.8, adicionamos suporte para porta local. O parâmetro Porta Local , disponível em Escopo do Aplicativo do ServiceNow, é opcional e configurável. Por padrão, seu valor é definido como 10001 (por exemplo, http://127.0.0.1:10001/authorize/). Ao configurar seu aplicativo OAuth, defina a URL de redirecionamento como: http://127.0.0.1:{LocalPort}/authorize/. Por exemplo, para a porta local 10002, a URL de redirecionamento seria http://127.0.0.1:10002/authorize/. Não é aconselhável alterar a porta local no mesmo projeto. Se a porta for alterada, crie um projeto ou fluxo de trabalho para evitar erros de cache, se houver.
   
   

   

   
   

Criar ativos de credenciais

A atividade ServiceNow Scope requer entradas SecureString para suas credenciais do ServiceNow (Password e ClientSecret). Para gerar as variáveis SecureString , é recomendável que você crie dois Ativos de credenciais em seu tenant do Orchestrator.

1. Faça logon no Tenant do Orchestrator que você deseja usar para seu projeto.
2. Na navegação à esquerda, clique em Ativos (isso abre a página Ativos).

3. Clique no ícone + para criar um novo Ativo (isso abre a janela Criar Ativo ).

   
   

   

   
   
4. Insira um Nome e selecione Credencial em Tipo.
5. No campo Nome de usuário , insira o ClientId do registro do aplicativo ServiceNow.
6. No campo Senha , insira o ClientSecret do registro do aplicativo ServiceNow.

7. Clique em Criar.

   
   

   

   
   

8. Repita as etapas 3-7 para criar outro ativo para seu nome de usuário e senha do ServiceNow.

   
   

   

   
   

Crie seu projeto

1. Crie um novo projeto de automação.

   1. Abra o UiPath Studio.
   2. Em Novo projeto, clique em Processo (isso abre uma janela Novo processo em branco ).
   3. Insira um Nome, Locale Descriçãodo projeto.

   4. Clique em Criar.

      
      

      

      
      

2. Instale o pacote UiPath.ServiceNowActivities .

   1. Na faixa de opções Design , clique em Gerenciar pacotes (isso abre a janela Gerenciar pacotes ).
   2. Em Todos os pacotes, clique em Beta
   3. Na barra de pesquisa , digite ServiceNow.

   4. Clique, instale e aceite a licença para UiPath.ServiceNow.Activities.

      • Para obter mais informações sobre os pacotes do Uipath Studio, consulte Gerenciando pacotes no Guia do Studio.

Está feito!

Agora que você concluiu a configuração, pode começar a adicionar as atividades do ServiceNow ao seu projeto.

Próximas Etapas

Para um aprendizado prático e para começar a usar as atividades rapidamente, consulte o Guia de início rápido. Este guia fornece instruções passo a passo para ajudar você a criar uma amostra de trabalho das diferentes atividades para que você possa verificar a conexão com sua instância do ServiceNow e se familiarizar com as propriedades de entrada/saída.

Para saber mais sobre as atividades do ServiceNow (incluindo um exemplo de entradas/saídas de propriedades), consulte a página Atividades para obter uma lista completa de atividades e links para as páginas de detalhes das atividades.