Início rápido — objetos e anexos

Visão geral

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.

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 doServiceNow ( Escopodo 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 gerar 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

Crie seu projeto

1. Adicione uma atividade.
2. Insira o AssetName para o ativo de credencial que você criou (durante a configuração) para seu nome de usuário e senha da instância do ServiceNow (por exemplo, "ServiceNowSignin").
3. Crie e insira uma variável SecureString para o valor de sua senha (por exemplo, senha).
4. Crie e insira uma variável String para o valor de seu nome de usuário (por exemplo, nome de usuário).
5. Adicione uma segunda atividade Get Credential .
6. Insira o AssetName para o ativo de credencial que você criou (durante a configuração) para a ID do cliente da 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 o valor de seu nome de usuário (por exemplo, clientId).
9. Adicione a atividade ServiceNow Scope após as duas atividades Get Credential .
10. Na propriedade Client Secret , insira a variável SecureString que você criou para seu Client Secret nas etapas acima (por exemplo, clientSecret).
11. Na propriedade Client Id , insira a variável String que você criou para sua Client Id (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 Username , 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 EndpointURL (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 variável String para o valor sys_id (por exemplo, sysID)

19. Usando a caixa de texto Add Single Field , digite short_description.

    • Digite um valor short_description (por exemplo, "UiPath-Attachment").
20. Clique em Concluído.
21. Crie e insira uma variável ResponseStatus para o valor ServiceNowStatus (por exemplo, insertRecordResponse).
22. Adicione uma atividade após a atividade Inserir Registro do ServiceNow Record .

23. Insira o seguinte texto: "Registro criado: "+insertRecordResponse.Success.ToString+" | sys_id: "+sysID (onde sysID é a variável criada para o campo 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 FileName , 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 Inserir registro (por exemplo, sysID)
29. Crie e insira uma variável String para a propriedade AttachmentId (por exemplo, attachmentId).
30. Crie e insira uma variável ResponseStatus para o valor ServiceNowStatus (por exemplo, addAttachmentResponse).
31. Adicione uma atividade após a atividade Inserir Registro do ServiceNow Record .
32. Insira o seguinte texto: "Anexo adicionado: "+addAttachmentResponse.Success.ToString+ " | sys_id: "+attachmentId (em que attachmentId é a variável criada para a propriedade AttachmentId acima).
33. Adicione a atividade Download Attachment após a atividade Write Line .
34. Digite o FilePath onde 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 sys_id Value , 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 ServiceNowStatus (por exemplo, getRecordResponse).
7. Adicione uma atividade após a atividade Get ServiceNow Record .
8. Na propriedade Condition , insira getRecordResponse.Success=False And getRecordResponse.Message.Contains("No Record") para determinar se o registro do anexo foi excluído com êxito verificando a mensagem de erro (onde getRecordResponse é a variável que você criou para a propriedade ServiceNowStatus acima ).

9. Na caixa da instrução Then , adicione uma atividade Write Line .

   1. Na propriedade Texto , digite "Teste aprovado: "+getRecordResponse.Message.

   2. Adicione a atividade Delete ServiceNow Record após a atividade Write Line .

   3. Clique no botão Configurar dentro da atividade Adicionar Anexo .

   4. Na lista suspensa Selecionar objeto , selecione Incidente.

   5. Na propriedade Id , insira a variável sys_id que você criou para a atividade Inserir registro (por exemplo, sysID).

   6. Crie e insira uma variável ResponseStatus para o valor ServiceNowStatus (por exemplo, deleteRecordResponse).

10. Adicione uma atividade Write Line após a atividade Delete ServiceNow Record .

    1. Na propriedade Texto , insira "Registro excluído: "+deleteRecordResponse.Success.ToString.

11. Na caixa da instrução Else , adicione uma atividade Write Line .

    1. Na propriedade Text , digite "Test failed: "+getRecordResponse.Message.

12. 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.