a. Ler intervalos de células.
b. Adicionar linhas ao final de uma planilha.
c. Atualizar o conteúdo de um intervalo de células.
d. Limpar o conteúdo de um intervalo de células.
Configuração do nodeA seguir, estão os campos necessários para sua configuração:
- Name (opcional): permite personalizar o nome do node dentro do fluxo, substituindo o valor padrão.
- Credentials (obrigatório): credenciais de autenticação da Microsoft Authentication Library (Client Credentials). É possível salvar múltiplas credenciais, embora apenas uma possa estar ativa ao mesmo tempo.
- Location Type (obrigatório): define o tipo de localização da workbook. As opções disponíveis são SharePoint Site e Shared Drive.
-
SharePoint Site Domain (obrigatório): domínio do site do SharePoint.
→ Exemplo: contoso.sharepoint.com -
SharePoint Site Name (obrigatório): nome do site do SharePoint.
→ Exemplo: MySite - Shared Drive Name (obrigatório apenas para Location Type = Shared Drive): nome da biblioteca de documentos compartilhada.
- Workbook URL (obrigatório): URL completa da workbook do Excel armazenada na unidade. Essa URL é obtida por meio da opção Copiar link no SharePoint.
- Action (obrigatório): define o tipo de operação que o node irá executar.
-
Output Path (obrigatório): variável onde os resultados ou metadados da operação serão armazenados.
→ Exemplo: msg.output
Você pode baixar um fluxo de exemplo neste link. Configuração de credenciaisA seguir, estão os campos necessários para configurar a Microsoft Authentication Library:
- Tenant ID (obrigatório): identificador do tenant do Azure Active Directory.
- Client ID (obrigatório): identificador da aplicação registrada no Azure AD.
- Client Secret (obrigatório): segredo do cliente da aplicação registrada no Azure AD.
O campo SheetName/Cells aceita diferentes formatos dependendo da ação selecionada:- Somente nome da planilha: Sheet1 - Válido apenas para a ação Append Rows.
- Intervalo completo: Sheet1!A1:C3 - Válido para as ações Get Cells, Update Cells e Clear Cells.
Também é possível utilizar templates para construir intervalos dinamicamente.→ Exemplo: {{{sheetRange}}}
Configuração das operaçõesA seguir, estão descritos os campos específicos de cada ação:
Get Cells: lê um intervalo de células da workbook do Excel e armazena o resultado em uma propriedade da mensagem de saída.-
Cells (obrigatório): intervalo de células a ser lido.
→ Formato: SheetName!A1:C3 - Flatten Output (opcional): quando ativado, converte o array bidimensional resultante em um array unidimensional.
Por padrão, esta opção vem desativada:→ Exemplo:
- Resultado padrão: [["João"], ["Silva"]]
- Com Flatten Output ativado: ["João", "Silva"]
Append Rows: adiciona novas linhas ao final do intervalo utilizado na planilha especificada.-
SheetName (obrigatório): nome da planilha de destino.
→ Formato: SheetName (sem intervalo de células) -
Input Data (obrigatório): variável da qual serão lidos os dados a serem armazenados.
→ Exemplo: msg.input
Este campo pode conter:- Um valor único: "João" → adiciona uma linha com uma única célula.
- Um array de valores: [["João", "Silva"]] → adiciona uma linha com múltiplas células.
- Um array de arrays: [["João", "Silva"], ["Ana", "Garcia"]] → adiciona múltiplas linhas.
Update Cells: substitui o conteúdo do intervalo de células especificado pelos novos valores fornecidos.-
Cells (obrigatório): intervalo de células a ser atualizado.
→ Formato: SheetName!A1:C3 -
Input Data (obrigatório): variável da qual serão lidos os dados a serem armazenados. Deve ser um array bidimensional compatível com o intervalo especificado.
→ Exemplo: msg.input
Exemplo: Para atualizar o intervalo Sheet1!A1:B2, o campo Input Data deve conter → [["Valor A1", "Valor B1"], ["Valor A2", "Valor B2"]] Clear Cells: remove o conteúdo das células do intervalo especificado, preservando a formatação aplicada.-
Cells (obrigatório): intervalo de células a ser limpo.
→ Formato: SheetName!A1:C3
Esta operação remove apenas os valores das células. Formatações, bordas e estilos são preservados.
No vídeo a seguir, mostramos como configurar o node no Studio: