Use a Graph API para ler arquivos Excel do SharePoint

O Power Automate, parte do conjunto de ferramentas da Microsoft, está se tornando cada vez mais a escolha preferida para automatizar fluxos de trabalho e processos de negócios em diversas plataformas e serviços. Ele fornece um rico conjunto de recursos e conectores para ajudar as empresas a automatizar suas operações com o mínimo de codificação. Uma operação comum é a leitura de arquivos Excel do SharePoint. No entanto, ao lidar com grandes conjuntos de dados, surgem alguns desafios inerentes. Nesta postagem do blog, mergulharemos em um método eficiente para superar esses desafios usando a Graph API.
O desafio
Para aqueles familiarizados com as ações prontas para uso (OOTB) do Power Automate, você pode ter se deparado com suas restrições. A limitação mais gritante é a capacidade de ler apenas até 250 registros de arquivos Excel. Isto pode ser suficiente para conjuntos de dados mais pequenos, mas num cenário empresarial onde os registos podem facilmente ultrapassar este número, é um estrangulamento significativo. Além disso, estas ações OOTB muitas vezes carecem da eficiência desejada em termos de desempenho.
Entrar na Graph API
A API Graph é a interface de programação unificada da Microsoft para acessar dados nos serviços do Microsoft 365, incluindo o SharePoint. Ao aproveitar a Graph API, você pode acessar o conteúdo dos arquivos do Excel armazenados nas bibliotecas de documentos do SharePoint de forma integrada e sem as restrições mencionadas acima.
Vantagens de usar Graph API
- Escalabilidade: com a API Graph, a limitação de 250 registros deixa de ser um problema. Ele foi projetado para lidar com grandes conjuntos de dados, tornando-o uma solução ideal para empresas com extensos dados do Excel.
- Desempenho: a Graph API oferece desempenho superior em comparação com as ações OOTB do Power Automate. Tempos de leitura mais rápidos e latência reduzida significam que os fluxos de trabalho funcionam de forma mais suave e eficiente.
- Flexibilidade: oferece uma variedade de opções de consulta, permitindo buscar dados exatamente de acordo com suas necessidades. Quer se trate de colunas, linhas ou dados específicos com base em determinadas condições, a Graph API pode lidar com tudo.
Etapas para integrar a API Graph com o Power Automate
- Registre seu aplicativo no Azure AD: antes de fazer chamadas para a Graph API, você precisa registrar seu aplicativo no Azure AD da sua assinatura do Microsoft 365. Isso fornecerá um ID do aplicativo, que será usado para autenticar suas solicitações.
- Definir permissões: Após o registro, atribua as permissões necessárias para que seu aplicativo leia arquivos do SharePoint.
- Crie um fluxo do Power Automate: comece criando um novo fluxo automatizado. Adicione um gatilho com base nos seus requisitos. Pode ser um gatilho cronometrado ou baseado em determinados eventos, como quando um novo arquivo é adicionado ao SharePoint.
- Adicionar uma ação HTTP: esta ação será usada para fazer uma chamada para a Graph API. Configure a ação HTTP para OBTER os dados Excel desejados. Aqui você usará o ID do aplicativo obtido anteriormente para autenticação.
- Analise os resultados: o resultado da Graph API normalmente estará no formato JSON. Use a ação ‘Analisar JSON’ do Power Automate para estruturar os dados. Depois disso, você poderá usar os dados conforme necessário em seu fluxo de trabalho.
- Finalize seu fluxo: adicione quaisquer ações adicionais necessárias para seu processo comercial. Por exemplo, se você estiver lendo dados para atualizar um banco de dados ou enviar um relatório, adicione estas etapas adequadamente.
Conclusão
Na era digital, onde os dados orientam as decisões, a necessidade de acessar, processar e utilizar grandes conjuntos de dados de forma eficiente é fundamental. Embora o Power Automate seja uma ferramenta poderosa por si só, a incorporação da API Graph aprimora seus recursos de várias maneiras, especialmente ao lidar com grandes arquivos Excel no SharePoint.
Resumindo, para empresas e indivíduos que procuram aproveitar todo o potencial dos seus dados Excel no SharePoint, a integração do Power Automate com a Graph API não é apenas uma opção, mas um requisito. Ele garante escalabilidade, desempenho e precisão – componentes essenciais para o sucesso em qualquer fluxo de trabalho automatizado.
Veja também nosso artigo sobre Benefícios do SharePoint Online para prestadores de serviço
Luiz Antonio Sgargeta é sócio fundador e CEO da Trinapse, consultoria brasileira de Microsoft 365 com quase duas décadas de operação, acumula mais de 20 anos em desenvolvimento de software e em ambientes corporativos de alta complexidade.
Ver maisVer menos
Trabalha com SharePoint desde o SharePoint Portal Server 2003 e com .NET desde a versão 1.0. Acompanhou a plataforma em todas as suas reinvenções, do portal de documentos on-premises ao SharePoint Online dentro do Microsoft 365, o que dá a ele uma leitura rara sobre o que muda de verdade e o que é apenas nome novo para o mesmo problema.
No início da carreira atuou em uma das maiores operações de e-commerce do país, em sistemas que não toleram degradação de performance nem indisponibilidade, essa origem definiu o critério que ele aplica até hoje: solução boa é a que sustenta volume real, integra com o legado que já existe e não quebra no pico.
Depois disso, passou por praticamente todo tipo de projeto corporativo, de portais e intranets de milhares de usuários a integrações críticas e automação de processos de ponta a ponta, sempre em grandes empresas e em desafios de alta exigência.
A marca do trabalho dele é a tradução entre tecnologia e negócio, levanta a necessidade real por trás do pedido do cliente, questiona o processo antes de automatizá-lo e desenha a solução pelo resultado esperado, não pela ferramenta disponível, é o que permite conversar com a diretoria sobre retorno e com o time técnico sobre arquitetura na mesma reunião.
Hoje lidera a frente comercial e estratégica da Trinapse e conduz a empresa no novo ciclo da inteligência artificial, com foco em agentes de IA e operação de processos assistida por IA para cooperativas de crédito, agronegócio e indústria. Escreve no blog da Trinapse desde 2019, com mais de 450 artigos sobre IA, SharePoint, Power Platform, Modern Workplace e transformação de processos, sempre a partir de projeto entregue e não de teoria.



