Objetos e anexos

O objetivo deste guia é ajudar você a criar uma amostra de trabalho que usa as seguintes atividades do ServiceNow:

• Inserir Registro do ServiceNow
• Add Attachment
• Download Attachment
• Delete Attachment
• Get ServiceNow Record
• Delete ServiceNow Record

Este exemplo de trabalho permite que você verifique rapidamente a conexão com sua instância do ServiceNow e se familiarize com os tipos de dados de entrada/saída da atividade.

Visão geral

Depois de concluir as etapas deste guia, você terá uma sequência de automação que faz o seguinte:

1. Estabelece uma conexão com sua instância do ServiceNow (Escopo do ServiceNow).
2. Cria um novo incidente do ServiceNow (Insert ServiceNow Record).
3. Carrega um arquivo para o novo incidente (Adicionar Anexo).
4. Baixa o arquivo carregado para uma pasta local (Download Attachment).
5. Exclui o arquivo carregado (Delete Attachment).
6. Verifica se o arquivo foi excluído ao tentar recuperar o registro do anexo e emitir a mensagem de erro esperada (Get ServiceNow Record, If).
7. Exclui o incidente criado (Excluir Registro do ServiceNow).
   
   

   

   
   

Pré-requisitos

Antes de você começar:

1. Conclua as etapas de Configuração do ServiceNow.
2. Um arquivo local para anexar a um registro do ServiceNow.

Etapas

1. Crie seu projeto.
2. Testar seu projeto.

Crie seu projeto

1. Adicione uma atividade Get Credential .
2. Insira o AssetName para o ativo de credencial que você criou (durante a Configuração) para o nome de usuário e senha da instância do ServiceNow (por exemplo, ServiceNowSignin).
3. Crie e insira uma variável SecureString para seu valor de Senha (por exemplo, password).
4. Crie e insira uma variável String para seu valor de Nome de usuário (.por exemplo, username).
5. Adicione uma segunda atividade Get Credential .
6. Insira o AssetName para o ativo de credencial que você criou (durante a Configuração) para o ID do cliente da sua instância do ServiceNow e o Segredo do cliente (por exemplo, ServiceNowClients).
7. Crie e insira uma variável SecureString para seu valor de Senha (por exemplo, clientSecret).
8. Crie e insira uma variável String para seu valor de Nome de usuário (.por exemplo, clientId).
9. Adicione a atividade ServiceNow Scope após as duas atividades Get Credential .
10. Na propriedade Segredo do cliente , insira a variável SecureString que você criou para seu segredo do cliente nas etapas acima (por exemplo, clientSecret).
11. Na propriedade ID do cliente , insira a variável String que você criou para sua ID do cliente (por exemplo, clientId).
12. Na propriedade Senha , insira a variável SecureString que você criou para sua senha nas etapas acima (por exemplo, password).
13. Na propriedade Nome de usuário, insira a variável String que você criou para seu nome de usuário (por exemplo, clientId).
14. Crie e insira uma variável String para seu UrlDoEndpoint (por exemplo, endpointURL).
15. Adicione a atividade Insert ServiceNow Record dentro da atividade ServiceNow Scope .
16. Clique no botão Configurar dentro da atividade Inserir Registro do ServiceNow Record (isso abre o Assistente de Objetos).
17. Na lista suspensa Selecionar objeto , selecione Incidente.
18. Crie e insira uma String variável para o Valor de sys_id (por exemplo, sysID)
19. Usando a caixa de texto Adicionar Campo Único , insira short_description.
    • Insira um Valor de short_description (por exemplo, UiPath-Attachment).
20. Clique em Concluído.
21. Crie e insira uma variável ResponseStatus para o valor do StatusDoServiceNow (por exemplo, insertRecordResponse).
22. Adicione uma atividade Write Line após a atividade Insert ServiceNow Record .
23. Digite o seguinte Texto: "Record created: "+insertRecordResponse.Success.ToString+" | sys_id: "+sysID (onde sysID é a variável criada para o campo de Valor sys_id acima).
    
    

    

    
    
24. Adicione a atividade Add Attachment após a atividade Write Line .
25. Clique no botão Configurar dentro da atividade Add Attachment .
26. Na lista suspensa Selecionar objeto , selecione Incidente
27. Na propriedade NomeDeArquivo , insira o caminho completo para seu arquivo local (por exemplo, "C:\UiPath_Projects\DemoFile.docx") ou clique no botão Escolher arquivo na atividade.
28. Na propriedade ObjectSysId , insira a variável sys_id que você criou para a atividade Insert Record (por exemplo, sysID)
29. Crie e insira uma variável String para a propriedade IdDoAnexo (por exemplo, attachmentId).
30. Crie e insira uma variável ResponseStatus para o valor do StatusDoServiceNow (por exemplo, addAttachmentResponse).
31. Adicione uma atividade Write Line após a atividade Insert ServiceNow Record .
32. Digite o seguinte Texto: "Anexo adicionado: "+addAttachmentResponse.Success.ToString+ " | sys_id: "+attachmentId (onde attachmentId é a variável criada para a propriedade IdDoAnexo acima).
33. Adicione a atividade Download Attachment após a atividade Write Line .
34. Insira o CaminhoDoArquivo para o qual você deseja baixar o arquivo (por exemplo, "C:\UiPath_Projects\Downloads").
35. Na propriedade SysId , insira a variável AttachmentId que você criou para a atividade Add Attachment (por exemplo, attachmentId).
36. Adicione a atividade Delete Attachment após a atividade Download Attachment .
37. Na propriedade ObjectSysId , insira a variável AttachmentId que você criou para a atividade Add Attachment (por exemplo, attachmentId).
    
    

    

    
    

Teste seu projeto

1. Adicione a atividade Get ServiceNow Record após a atividade Delete Attachment .
2. Clique no botão Configurar dentro da atividade Inserir Registro do ServiceNow .
3. Na lista suspensa Selecionar objeto , selecione Anexo.
4. No campo Valor sys_id , insira a variável AttachmentId que você criou para a atividade Add Attachment (por exemplo, attachmentId)
5. Clique em Concluído.
6. Crie e insira uma variável ResponseStatus para o valor do StatusDoServiceNow (por exemplo, getRecordResponse).
7. Adicione uma atividade If após a atividade Get ServiceNow Record .
8. Na propriedade Condição , insira getRecordResponse.Success=False And getRecordResponse.Message.Contains("No Record") para determinar se o registro do anexo foi excluído com sucesso verificando a mensagem de erro (onde getRecordResponse é a variável que você criou para a propriedade StatusDoServiceNow acima).
9. Na caixa da instrução Then , adicione uma atividade Write Line .
   1. Na propriedade Texto , insira "Teste aprovado: "+getRecordResponse.Message.
10. Adicione a atividade Delete ServiceNow Record após a atividade Write Line .
    1. Clique no botão Configurar dentro da atividade Add Attachment .
    2. Na lista suspensa Selecionar objeto , selecione Incidente
    3. Na propriedade ID , insira a variável sys_id que você criou para a atividade Insert Record (por exemplo, sysID).
    4. Crie e insira uma variável ResponseStatus para o valor do StatusDoServiceNow (por exemplo, deleteRecordResponse).
11. Adicione uma atividade Write Line após a atividade Delete ServiceNow Record .
    1. Na propriedade Texto , insira "Registro excluído: "+deleteRecordResponse.Success.ToString.
12. Na caixa da instrução Else , adicione uma atividade Write Line .
    1. Na propriedade Texto , insira "Test failed: "+getRecordResponse.Message.
13. Clique em Executar e verifique se a janela Saída inclui os valores esperados da linha de gravação.
    
    

    

    
    

Está feito!

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.