ServiceNow Application Scope

UiPath.ServiceNow.Activities.ServiceNowScopeActivity

Dica: Embora a atividade do escopo do aplicativo ServiceNow possa usar autenticação padrão (UserName) e (Password), é altamente recomendável usar a segurança OAuth para todas as suas conexões de acordo com as etapas abaixo.

As atividades do ServiceNow usam o protocolo OAuth 1.0 para estabelecer uma conexão autenticada entre o UiPath e sua instância do ServiceNow. Essa conexão autoriza um robô a chamar as APIs do ServiceNow e acessar recursos em seu nome.

Para habilitar a autorização, você cria um endpoint de aplicativo OAuth para sua instância do ServiceNow. A criação desse endpoint gera um registro do aplicativo cliente do OAuth, ID do cliente e segredo do cliente para habilitar o acesso autenticado à sua instância.

Depois de criar seu endpoint, você insere suas credenciais do ServiceNow junto com o URL do endpoint do aplicativo, ID do cliente e segredo do cliente na atividade ServiceNow Application Scope .

Dica:

As funções de usuário da integração devem receber apenas as permissões mínimas necessárias para executar as tarefas habilitadas pelas atividades neste pacote (por exemplo, admin, itil, barra_ecc e etc. não devem ser usados para funções de usuário de integração). Os serviços web de entrada que modificam tabelas devem ficar restritos às funções de sistema apropriadas .

Para obter mais informações, consulte a seção Funções na documentação do ServiceNow.

Como funciona

As etapas a seguir e o diagrama de sequência de mensagens são um exemplo de como a atividade funciona desde o tempo de design (ou seja, as dependências da atividade e as propriedades de entrada/saída) até o tempo de execução.

1. Conclua as etapas de Configuração .
2. Adicione uma atividade para cada propriedade de entrada SecureString (por exemplo, duas no total — uma para Senha e uma para SegredoDoCliente)
3. Adicione a atividade ServiceNow Application Scope ao seu projeto.
4. Insira valores para as propriedades da Autenticação e Conexão .
5. Crie e insira uma variável IConnection para as propriedades de Saída .

   • Você pode usar essa variável em usos subsequentes da atividade do escopo do aplicativo ServiceNow .

     
     

     

     
     

Se você tiver problemas ao usar a autenticação padrão, consulte Dicas de autenticação padrão.

No corpo da atividade

Para construir seu projeto e habilitar o Object Wizard em outras atividades, você deve utilizar o Connection Wizard clicando no botão Configurar .

Para saber mais, consulte a seção Assistentes na página Sobre .

Propriedades

Autenticação

• Nome de usuário - o nome de usuário da instância do ServiceNow. Insira uma variável String .
  • Esse valor pode ser diferente de sua conta ServiceNow se você tiver várias instâncias.
  • O Nome de Usuário está associado à Senha . É recomendável que você gere uma variável String seguindo a seção Criar ativos de credenciais do Guia de configuração .
  • Para inserir sua variável String , use uma atividade que gere seu Ativo de Credencial (consulte o exemplo abaixo).
• Senha - a senha (associada ao nome de usuário) para sua instância do ServiceNow. Insira uma variável String ou String .
  • Esse valor pode ser diferente de sua conta ServiceNow se você tiver várias instâncias.
  • O Nome de Usuário está associado à Senha . É recomendável que você gere uma variável String seguindo a seção Criar ativos de credenciais do Guia de configuração .
  • Para inserir sua variável String , use uma atividade que gere seu Ativo de Credencial (consulte o exemplo abaixo).
• Segredo do cliente - O SecureString usado para autorizar as comunicações entre o UiPath e sua instância do ServiceNow. Insira uma variável SecureString .
  • O SegredoDoCliente é gerado para sua instância do ServiceNow quando você conclui o registro de um aplicativo. Para obter mais informações, consulte a seção Configuração do OAuth do Guia de configuração .
  • Para gerar uma variável SecureString , consulte a seção Criar ativos de credenciais do Guia de configuração .
  • Para inserir sua variável SecureString , use uma atividade que gere seu Ativo de Credencial (consulte o exemplo abaixo).
• ClientId - O ID exclusivo gerado automaticamente do registro do aplicativo. Insira uma variável String .
  • O ClientId é gerado para sua instância do ServiceNow quando você conclui um registro de aplicativo. Para obter mais informações, consulte a seção Configuração do OAuth do Guia de configuração .
  • O IdDoCliente está associado a SegredoDoCliente. É recomendável que você gere uma variável String seguindo a seção Criar ativos de credenciais do guia de Configuração .
  • Para inserir sua variável String , use uma atividade que gere seu Ativo de Credencial (consulte o exemplo abaixo).
• Usar OAuth 2.0 - Marque isso para usar o fluxo de concessão de código OAuth2 do ServiceNow.

Comum

• DisplayName - O nome de exibição da atividade. Insira uma variável String ou String .

Conexão

• EndpointURL - O URL da instância do ServiceNow. Insira uma variável String ou String . A URL deve ser para sua instância do ServiceNow e não para a URL de redirecionamento no registro do aplicativo.

Diversos

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

Opções

• ReportApiErrorAsException - Quando selecionado, as respostas de erro da API são relatadas em BusinessActivityExecutionException por todas as atividades filhas que usam esse escopo de aplicativo. Quando desmarcada, a atividade filho preenche a mensagem de erro da API na propriedade de saída ResponseStatus e a execução do fluxo de trabalho continua. Verifique a propriedade ResponseStatus para confirmar a execução bem-sucedida.

Saída

• ServiceNowConnection - Um registro de sua conexão estabelecida que você pode usar em atividades subseqüentes do ServiceNow Application Scope . Insira uma variável IConnection (UiPath.BAF.Models.Connection.IConnection).

Usar Conexão Existente

• ExistingServiceNowConnection - Um registro de conexão de uma atividade pai do escopo do aplicativo ServiceNow que você pode usar em vez de estabelecer uma nova conexão. Insira uma variável IConnection (UiPath.BAF.Models.Connection.IConnection).
  • A variável IConnection deve ser de uma atividade SeriviceNow Scope executada anteriormente (pai) que ainda tenha uma conexão ativa.
  • Se você não conseguir estabelecer uma conexão usando esta propriedade, tente executar novamente sua atividade pai do escopo do aplicativo ServiceNow .

Exemplo

A imagem a seguir mostra um exemplo do relacionamento de dependência de atividade e valores de propriedade de entrada/saída.

Para obter instruções passo a passo e exemplos, consulte o Guia de início rápido.

Dicas de autenticação padrão

No pacote de atividades ServiceNow, a autenticação básica (nome de usuário e senha) pode ser usada para executar atividades. As etapas são delineadas abaixo:

Tempo de projeto

Em Design Time, insira o nome de usuário e a senha com a URL do terminal e esses detalhes serão salvos. Observe que as credenciais não são validadas com o ServiceNow para autenticação básica no nível do escopo. Somente em um estágio posterior, quando as entidades do ServiceNow são buscadas em uma atividade individual ou no tempo de execução durante a execução de uma atividade, essas credenciais básicas de autenticação são usadas para autenticar.

Se as credenciais de autenticação básicas fornecidas estiverem incorretas, ao carregar a lista de entidades, será gerado um erro, pois ela usa as credenciais de autenticação básicas salvas para se conectar ao ServiceNow e obter nomes de entidades/tabelas.

Se as credenciais (Username, Password, EndpointUrl) estiverem corretas, as entidades serão preenchidas no menu suspenso de atividade como abaixo:

Runtime

Certifique-se de que as credenciais sejam preenchidas no painel de propriedades à direita.

Se as credenciais estiverem corretas, a atividade será executada. Se incorreto, lançará um erro em tempo de execução, conforme mostrado abaixo: