Adicionar novos clientes a uma lista do SharePoint

Sobre

Resumo: adicione novos clientes a uma lista do SharePoint e crie contas do Salesforce usando os dados deles.

Aplicativos: Listas do SharePoint, Excel, Salesforce

Description: This example explains how to add all the new customers from a new Excel file to a SharePoint List, then create a new account and contact in Salesforce for each of them. Next, update the SharePoint List items with the Salesforce ID and status Processed. Finally, create a new folder for processed files and move the Excel file.

Este exemplo apresenta as atividades do Microsoft 365, como File Created, Add List Item, Get List Items, bem como as atividades do Salesforce, como Create Account e Create Contact.

Observação:

As atividades da lista do SharePoint usam nomes de colunas, mas a interface do usuário do Studio expõe os nomes de exibição das colunas. Por exemplo, se você tiver uma coluna chamada ID do Salesforce, ao recuperar esse campo em uma variável, a variável será [...]field_5, porque field_5 é o nome da coluna no backend.

Fluxo de Trabalho

1. Abra o Studio Web e crie um novo projeto.
2. Para Como iniciar a automação , selecione Baseado em eventoe, em seguida, selecione a atividade Microsoft 365 File Created .
3. No gatilho da atividade:
   1. Configure sua conexão do Microsoft OneDrive e SharePoint.
   2. Defina o campo No Local . Por exemplo, selecione uma de suas pastas do OneDrive.
      
      

      

      
      
4. Adicione uma atividade For Each Row in Workbook :
   1. No campo Pasta de trabalho, selecione a variável de saída da atividade File Created Trigger.
   2. Selecione o Intervalo. Por exemplo, a primeira planilha na pasta de trabalho, Sheet1.
   3. Configure os outros campos para atender às suas necessidades. Por exemplo:
      1. Tem cabeçalhos - Definido como True.
      2. Se a linha estiver vazia - Definir como Ignorar.
         
         

         

         
         
5. Dentro da atividade For Each Row , adicione uma atividade SharePoint Add List Item , para criar novos clientes.
   1. Escolha a lista do SharePoint que você precisa.
      
      

      

      
      
6. Em seguida, ainda dentro de For Each, adicione uma atividade. Renomeie-a para Write Cell - Status, para identificá-la facilmente mais tarde, e configure-a:
   1. No campo Pasta de trabalho, selecione a variável de saída da atividade de gatilho File Created .
   2. Selecione a Planilha/Intervalo nomeado.
   3. No campo Célula, selecione a variável CurrentRow da atividade For Each Row in Workbook e pesquise a propriedade Status_Address .
   4. Para O que escrever - Digite Adicionado no campo.
      
      

      

      
      
7. Adicione uma segunda atividade Write Cell . Renomeie-a para Write Cell - SharePoint List ID e configure-a:
   1. No campo Pasta de trabalho, selecione a variável de saída da atividade de gatilho File Created .
   2. Selecione a Planilha/Intervalo nomeado.
   3. No campo Célula, selecione a variável CurrentRow da atividade For Each Row in Workbook e pesquise a propriedade SP_List_ID_Address .
   4. Para O que escrever - Selecione a variável de saída da atividade Add List Item e defina a propriedade ID .
      
      

      

      
      
8. Em seguida, fora da atividade For Each Row , adicione uma atividade Get List Items . Isso recupera as informações do cliente.
   1. Selecione a lista do SharePoint.
   2. No campo Colunas para recuperar , selecione todos os campos do cliente dos quais você precisa. Por exemplo: Nome, Sobrenome, E-mail, Telefone, ID do Salesforce, ID e Título.
      Observação: esses são os nomes de exibição das colunas. Os títulos das colunas no backend serão diferentes.
      
      

      

      
      
      
      

      

      
      
9. Adicione uma atividade For Each :
   1. Para o campo Lista de Itens , selecione a variável de saída da atividade Get List Items anterior e aba até a propriedade Rows .
   2. O campo Item é automaticamente definido como currentDataRow.
      
      

      

      
      
10. Dentro de For Each, adicione uma atividade If . Isso estabelece o que fazer caso o campo ID do Salesforce esteja vazio.
    1. Definir a Condição: se currentDataRow.field_5 (o ID do Salesforce das Colunas a recuperar) for texto vazio. No editor de Expressão, a condição é: string.IsNullOrEmpty(currentDataRow.field_5) = true
       Observação: Salesforce ID é o nome de exibição, field_5 é o nome da coluna do backend.

       
       

       

       
       
11. Definir a ramificação Then , ou seja, a atividade a ser executada caso a condição seja verdadeira.
    1. Em vez disso, adicione uma atividade Log Message para registrar o título do item da lista. No campo Mensagem , selecione a variável For Each currentDataRow e pesquise a propriedade Title . Isso corresponde ao nome do cliente (a coluna Título na lista do SharePoint).
12. Adicione uma atividade Criar Conta do Salesforce.
    1. Para o Nome da conta, selecione a variável currentDataRow.Title .
13. Adicione um Salesforce Create Contact e configure-o. Faça a correspondência aos campos da atividade com as informações recuperadas usando o campo Colunas para recuperar na atividade Get List Items :
    1. Sobrenome - Definido como currentDataRow.Lastname variável. Exibido como currentDataRow.field_2.
    2. Conta — selecione a variável de saída da atividade Create Account .
    3. Email - Definido como currentDataRow.Email variável. Exibido como currentDataRow.field_3.
    4. Nome - Definido como currentDataRow.Firstname variável. Exibido como currentDataRow.field_1.
    5. Telefone — Defina como variável currentDataRow.Phone . Exibido como variável currentDataRow.field_4 .
       
       

       

       
       
14. Em seguida, adicione uma atividade Update Single List Item e configure-a:
    1. Selecione a lista do SharePoint.
    2. Para ID do item de lista, selecione a variável currentDataRow.ID para cada.
    
    

    

    
    
15. Não configure a ramificação Else .
16. Em seguida, adicione uma atividade Get File/Folder :
    1. URL do arquivo ou pasta - Selecione a variável de saída da atividade de gatilho File Created e faça uma busca detalhada até sua propriedade ParentUri .
       
       

       

       
       
17. Adicione uma atividade Create Folder e configure-a:
    1. Nome da pasta — por exemplo, defina o nome como Arquivos Processados.
    2. Pasta pai — selecione a variável de saída da atividade Get File/Folder .
    3. Se a pasta já existir - Definido como Renomear automaticamente.
       
       

       

       
       
18. Adicione uma atividade Move File/Folder , para mover o novo arquivo para a pasta de itens processados.
    1. Arquivo ou pasta a mover - Selecione a variável de saída da atividade de gatilho Criação de Arquivo .
    2. Pasta de destino — selecione a variável de saída da atividade Create Folder .
    3. Se o arquivo/pasta já existir - Definir para Substituir.
       
       

       

       
       
19. Pronto para executar seu projeto.