--- title: MS Excel slug: ms-excel docTags: createdAt: 2025-07-09T18:47:54.370Z --- ## Objetivo/Resumo Este conector foi desenvolvido para facilitar a integração e a automação de tarefas com o Microsoft Excel. Seu objetivo principal é proporcionar aos usuários uma maneira eficiente de acessar, manipular e compartilhar dados em planilhas do Excel diretamente de outras aplicações e serviços. Com esse conector, os usuários podem economizar tempo, reduzir erros manuais e aprimorar a colaboração em processos que envolvem o uso de planilhas estruturadas no Excel. ## Criando um fluxo utilizando Conector Microsoft Excel Para criar um fluxo utilizando o conector Microsoft Excel é preciso criar uma conexão e em seguida configurar o fluxo. ### Criando conexão Microsoft Excel Primeiramente é necessário acessar seu aplicativo no Microsoft Azure, e adicionar a uri de redirecionamento da Fluid em sua aplicação web `https://console.fluidapi.io` para mais informações acessa a documentação oficial da microsoft [https://learn.microsoft.com/en-us/entra/identity-platform/how-to-add-redirect-uri](https://learn.microsoft.com/en-us/entra/identity-platform/how-to-add-redirect-uri) Após adicionar a URI de redirecionamento**,** é necessário criar uma conexão na **Fluid**, fornecendo os valores requisitados. [Criar Conexão](#) para acessar o passo a passo para criar a conexão. Estes são os parâmetros de configuração da conexão com Microsoft Excel que serão requisitados na criação: - **Nome**: parâmetro padrão em qualquer criação de uma conexão, te ajudará a identificar melhor sua conexão (campo obrigatório); - **Descrição**: parâmetro padrão e opcional em qualquer criação de uma conexão, aqui você pode relatar detalhadamente para que fins servirá sua conexão; - **ID do Cliente**: informe o client\_id da aplicação (campo obrigatório); - **Chave Secreta do Cliente: informe o client\_secret da aplicação (campo obrigatório);** - **Escopos**: escopos de acesso que será liberado para essa conexão; Como o tipo de conexão é OAuth2.0 será preciso efetuar o login logo após o preenchimento dos campos acima, para isso basta clicar no botão **Login OAuth2, **efetuar o login e salvar a conexão: ![](https://api.archbee.com/api/optimize/d8nzUgBNtMWHFCNizsS7h/GLo41X4zc30Xw3NYrqtKd_image.png) ### Configurando fluxo com Microsoft Excel Crie um fluxo (passo a passo [Criar Fluxo](#)) e arraste o conector Microsoft Excel para o canvas. ![](https://api.archbee.com/api/optimize/d8nzUgBNtMWHFCNizsS7h/I5Ew56KKhvAh-UK98XJlM_image.png) Selecione o conector e na aba de `Parametrização` preencha os seguintes parâmetros de configuração: - **Recurso**: entidade para qual será realizada a ação. - **Operação**: ação que será realizada para o recurso selecionado. - Operações disponíveis para recurso ***Planilha/Documento:*** - **Criar planilha**: requer o preenchimento do campo "Título" para nomear a planilha e opcionalmente pode ser informado o nome da página. Caso o nome não seja informado, será criado por padrão `Sheet1`; - Operações disponíveis para recurso ***Página dentro da Planilha:*** - **Adicionar ou editar dados: **requer o 'ID da planilha', 'Nome da Página', 'Intervalo' e o 'Conteúdo' a ser adicionado ou editado, podendo ser eviado utilizando [De/para](#) ou [Template](#); - **Formatar Linha**: requer o 'ID da planilha', 'Nome da Página', 'Intervalo', 'Conteúdo' e o 'Tipo de Formatação' a utilizado; - **Adicionar página: **requer o 'ID da planilha' e o 'Nome da página' da página a ser inserida; Na aba `Propriedades` selecione a conexão desejada, dê um nome ao 'Passo' e se necessário detalhe uma descrição. ## Na prática Neste tópico criaremos um fluxo utilizando o conector do Microsoft Excel. O fluxo terá dois passos, sendo eles **criar** e **inserir, **onde será criada uma planilha e na sequência alimentaremos ela com dados. ![](https://api.archbee.com/api/optimize/d8nzUgBNtMWHFCNizsS7h/E_-Lq4iYwO59zni5jZDs1_image.png) ### Passo criar Assim ficará a `Parametrização` do nosso primeiro passo: ::Image[]{src="https://api.archbee.com/api/optimize/d8nzUgBNtMWHFCNizsS7h/TdiCjMYYKTQVj5oh3SIie_image.png" size="60" width="426" height="609" position="center" darkWidth="426" darkHeight="609" showCaption="false"} Na aba `Propriedades` informamos o nome do passo e a conexão criada para o Microsoft Excel: ::Image[]{src="https://api.archbee.com/api/optimize/d8nzUgBNtMWHFCNizsS7h/icC3z3gnKQRv7zVPiWyrK_image.png" size="60" width="419" height="648" position="center" darkWidth="419" darkHeight="648" showCaption="false"} ### Passo inserir Assim ficará a `Parametrização` do nosso último passo: ::Image[]{src="https://api.archbee.com/api/optimize/d8nzUgBNtMWHFCNizsS7h/frtoisN6ZrKuS570X8ZLb_image.png" size="60" width="423" height="760" position="center" darkWidth="423" darkHeight="760" showCaption="false"} Os dados a serem inseridos na planilha estão fixos no [Template](#). E assim ficou nosso template: ::Image[]{src="https://api.archbee.com/api/optimize/d8nzUgBNtMWHFCNizsS7h/RIQPzs7Ewy9QFB6L4Sw-u_image.png" size="60" width="334" height="396" position="center" darkWidth="334" darkHeight="396" showCaption="false"} :::hint{type="info"} ** OBS:** O conector do Microsoft Excel espera como entrada um objeto contendo dois campos: `valueTypes` e `values`. Ambos devem ser preenchidos como matrizes (arrays de arrays – `[][]`). É necessário preparar o **De/Para** ou o **Template** de forma que: - O campo `valueTypes` contenha o tipo de dado esperado (exemplo: `"String"`). - O campo `values` contenha as linhas a serem inseridas na planilha, cada uma representada por um array com os respectivos valores. ::: Na aba `Propriedades` informamos o nome do passo e a conexão criada para o conector Microsoft Excel: ::Image[]{src="https://api.archbee.com/api/optimize/d8nzUgBNtMWHFCNizsS7h/W978IuskMJ6rt4hSmdEB4_image.png" size="60" width="419" height="645" position="center" darkWidth="419" darkHeight="645" showCaption="false"} ### Disparando o Fluxo Com os passos configurados basta disparar o fluxo. Nesse caso não precisaremos informar um payload de entrada, pois os dados que estamos usando no exemplo estão fixos no conector. Após o disparo, o resultado do fluxo será apresentado em tempo real no canvas: ![](https://api.archbee.com/api/optimize/d8nzUgBNtMWHFCNizsS7h/CIre7wdQxTFmFt_L3KcaR_image.png)