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 (Inserir Registro do ServiceNow).

3. Carrega um arquivo para o novo incidente (Adicionar anexo).

4. Baixa o arquivo carregado para uma pasta local (Baixar anexo).

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 (Delete ServiceNow Record).

   

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. Construa seu projeto.
2. Teste seu projeto.

Crie seu projeto

1. Adicione uma atividade Obter credencial .

2. Insira o NomeDoAtivo para o ativo de credencial que você criou (durante a Configuração) para o nome de usuário e senha de sua 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. Add a second Get Credential activity.

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 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. In the Password property, enter the SecureString variable you created for your password in the steps above (e.g., 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 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 Insert 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 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. Click Done.

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. Insira o seguinte Texto: "Registro criado: "+insertRecordResponse.Success.ToString+" | sys_id: "+sys_id (onde sysID é a variável criada para o campo Valor do sys_id acima).

    

24. Adicione a atividade Add Attachment após a atividade Write Line .

25. Click the Configure button inside the Add Attachment activity.

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 , digite 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 AttachmentId (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. Insira o seguinte Texto: "Anexo adicionado: "+addAttachmentResponse.Success.ToString+ " | sys_id: "+attachmentId (onde attachmentId é a variável criada para a propriedade AttachmentId acima).

33. Adicione a atividade Download Attachment após a atividade Write Line .

34. Insira o CaminhoDoArquivo 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 Adicionar anexo (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 Adicionar anexo (por exemplo, attachmentId).

    

Teste seu projeto

1. Adicione a atividade Get ServiceNow Record após a atividade Delete Attachment .

2. Click the Configure button inside the Insert ServiceNow Record activity.

3. Na lista suspensa Selecionar Objeto , selecione Anexo.

4. No campo Valor de sys_id , insira a variável AttachmentId que você criou para a atividade Adicionar anexo (por exemplo, attachmentId)

5. Click Done.

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 de 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. In the Then statement box, add a Write Line activity.

   1. Na propriedade Text , insira "Test pass: "+getRecordResponse.Message.

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

    1. Click the Configure button inside the Add Attachment activity.
    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. Add a Write Line activity after the Delete ServiceNow Record activity.

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

12. In the Else statement box, add a Write Line activity.

    1. Na propriedade Text , insira "Test vault: "+getRecordResponse.Message.

13. Click Run and verify the Output window includes the expected write line values.

    

Está feito!

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