Início rápido: trabalhando com linhas

Visão geral

O objetivo deste guia é orientá-lo através de vários exemplos de como trabalhar com linhas em uma planilha no Smartsheet. Utilizaremos as seguintes atividades:

• List Rows
• Get Row
• Get Attachment
• Update Rows

Este exemplo de trabalho permite obter uma lista de linhas e, em seguida, iterar por meio dessa lista de linhas, primeiro obtendo quaisquer anexos dessa linha e, em seguida, atualizando um valor nessa linha.

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 doSmartsheet ( Escopodo Smartsheet ).
2. Obtém uma lista de linhas de uma planilha (List Rows).
3. Para cada linha recuperada, faça o seguinte:
4. Obtenha os anexos dessa linha (List Rows).
5. Faz o download de todos os anexos nessa linha Get Attachment.
6. Atualiza o valor dessa linha. Update Rows

Para o item 4 acima, poderíamos optar por criar um objeto Row[] e fazer uma única chamada Update, mas para os fins desta demonstração, ele será chamado uma vez para cada Row que desejamos atualizar.

Abaixo está uma captura de tela da aparência da nossa planilha de exemplo.

Para obter o ID da planilha, vá para Arquivo->Propriedades e veja o SheetID. Deve ser algo como 5903706102228868.

Pré-requisitos

Antes de você começar:

1. Conclua as etapas de Configuração do Smartsheet.
2. Um caminho de pasta local para baixar os anexos.

Etapas

Crie seu projeto

1. Crie e insira uma variável String para seu valor de token de API (por exemplo, apiToken).
2. Adicione o Escopo do Smartsheet.
3. Para Tipo de autenticação, escolha API Token.
4. Insira sua variável apiToken como o valor para o valor do API Access Token .

Crie e defina variáveis que serão usadas em diversas atividades

1. Crie e insira uma variável Int64 para seu valor SheetId (por exemplo, sheetId).
2. Crie e insira uma variável String para seu valor de caminho de download (por exemplo, downloadPath).

Obtenha uma lista de linhas para as quais desejamos obter anexos e também atualizar e configurar um para cada loop.

1. Adicione a atividade List Rows .
2. Clique no botão Configurar dentro da atividade Listar Linhas .
3. Para o campo Sheet Id, insira seu sheetId na coluna Valor.
4. Para o campo Rows, crie uma variável Row[] (por exemplo, rowsRetrieved).
5. Clique no botão Concluído.
6. Adicione uma atividade Para Cada após a atividade Listar Linhas.
7. Para a propriedade Values , insira sua variável rowsRetrieved .
8. Para a propriedade Tipo de argumento , use Smartsheet.Api.Models.Row.
9. No corpo da atividade For Each, adicione uma atividade List Rows .
10. Para SheetId, insira sua variável sheetId .
11. Para RowId, insira "item.Id.value".
12. Para Incluir, escolha "Anexos" como opção.
13. Para Row, crie e insira uma variável Row (por exemplo, rowRetrieved)
    
    

    

    
    
    
    

    

    
    

Configurar uma verificação de condição If

1. Adicione uma atividade If* após a atividade Get Row .
2. Para a Condição, use o valor "RowRetrieved.Attachments is Nothing".
3. Na seção Else da atividade If , adicione um Para cada atividade
4. Na atividade Para cada , defina as seguintes propriedades:
5. Para Values, defina-o como rowRetrieved.Attachments (presumindo que você esteja usando rowRetrieved como sua variável de saída conforme 7d acima).
6. Para TypeArgument, defina-o como "Smartsheet.Api.Model.Attachment"
7. Renomeie a variável ForEach de item para attachment.

Para cada linha com um anexo, baixe o anexo e atualize um valor nessa linha

1. Adicione uma atividade Obter Anexo .
2. Para SheetId, insira sua variável sheetId .
3. Para AttachmentId, insira "attachment.Id.Value"
4. Para Download Folder Path, insira sua variável downloadPath .
5. Adicionar uma atividade Atribuir após a atividade Obter Anexo
6. Para To, crie uma variável Row (por exemplo, rowUpdate).
7. Para Value, crie um novo objeto Row e defina-o usando um código semelhante ao padrão abaixo.

   New Row() With { 
   .Id = RowRetrieved.Id,
   .Cells = New List(Of Cell) From {
       New Cell() With {.Value = '100', .ColumnId = RowRetrieved.Cells(3).ColumnId}
       }
   }

   
   

   

   
   
8. Adicione uma atividade Atualizar Linhas após a atividade Atribuir .
9. Clique no botão Configurar .
10. Para o campo Sheet Id , use a variável sheetId .
11. Para o campo Linhas , clique no botão de link Linha .
12. Clique no botão Adicionar
13. Insira a variável rowUpdate que você criou anteriormente.
14. Clique no botão Concluído

Está feito!

Para saber mais sobre as atividades do Smartsheet (incluindo exemplos 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.

Você pode baixar uma cópia deste robô no seguinte link:

https://discourse-cloud-file-uploads.s3.dualstack.us-west-2.amazonaws.com/uipath/original/3X/2/8/28b17aad52194518cf0c4977635e8e381a68636d.zip