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 de 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, soap_ecc e etc. não devem ser usadas para funções de usuário de integração). Os serviços da Web de entrada que modificam tabelas devem ser restritos às funções de sistemaapropriadas.

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).
• Porta local (opcional) — a porta local para redirecionamento. O valor padrão é 10001. Insira uma String ou uma variável String .
• 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: