Centro de suporte da Workiva

Este artigo apresenta uma visão geral das opções disponíveis para integração com os produtos da Microsoft sobre os quais nossos clientes mais frequentemente nos consultam.

Observação: Existem muitos produtos da Microsoft; aqui, abordaremos apenas uma pequena seleção deles.

Quem precisa participar?

Qualquer integração com um produto da Microsoft exigirá alguém com acesso e experiência no Azure. Na maioria das empresas, provavelmente será alguém da equipe de TI; portanto, certifique-se de que essa pessoa esteja envolvida em todo o planejamento e nas discussões desde o início, para evitar problemas.

A Primeira Decisão: O Transportador

A primeira decisão a ser tomada em qualquer integração é determinar o que deve ser utilizado para transportar os dados entre o Workiva e o sistema externo (ou a plataforma da Microsoft, neste caso específico). A Workiva dispõe de cadeias para realizar isso, enquanto a Microsoft conta com diversas plataformas (Azure Data Factory, Power Automate, Power Query e outras). Você também poderia utilizar um software ou código de programação de um terceiro que não pertença a nenhuma das duas empresas. Desde que o que você usar tenha a capacidade de trabalhar com APIs, ele deverá ser capaz de transferir dados entre as plataformas.

Observação: Em geral, recomendamos tentar usar apenas uma dessas ferramentas. Na maioria dos casos, é mais vantajoso em termos de eficiência, escalabilidade e manutenção limitar os pontos de falha da sua integração e, consequentemente, o número de pacotes de software diferentes envolvidos.

Utilizando as cadeias da Workiva

Se você pretende usar o produto Chains da Workiva, verifique primeiro se o Wdata está ativado em seu espaço de trabalho.

Conectores específicos para correntes

O Chains possui vários conectores específicos que facilitam a integração com determinados produtos da Microsoft.

Observação: Quaisquer conectores premium exigirão a ativação e poderão acarretar custos adicionais. Verifique seu contrato ou entre em contato com seu CSM para obter mais detalhes.

Microsoft® OneDrive® (também inclui o SharePoint®)

• O OneDrive é um conector principal do em cadeia, o que significa que seu uso é gratuito para todos que possuam a licença Wdata.
• Você pode copiar, excluir e pesquisar arquivos e pastas, bem como baixar e enviar arquivos e listar as unidades disponíveis.

Power BI®

• Um conector premium da .
• Ótimo para criar ou enviar dados do Workiva para conjuntos de dados do Power BI e listar itens como relatórios, gateways, painéis e conjuntos de dados.
• O site não consegue extrair dados do Power BI em um formato que possa ser utilizado na plataforma Workiva. Se você deseja importar dados do Power BI para o Workiva, precisará buscar um método alternativo, como o conector HTTP “ ”.

Microsoft® SQL Server® (também conhecido como Azure SQL Database)

• Um conector premium da .
• Execute comandos SQL, obtenha detalhes sobre uma tabela ou insira registros em um banco de dados.
• Compatível com o Azure SQL Database, o Azure Synapse Analytics, o Azure SQL Managed Instance e o SQL Server 2017-2022.

Armazenamento de Arquivos do Azure

• Um conector premium da .
• Baixe um arquivo da sua instância do Azure File Storage.
• Não dá para fazer mais nada.

Microsoft® Dynamics® CRM

• Um conector premium da .
• Gerenciar entidades e consultas.

Nos casos em que não há conectores específicos para correntes

Se não houver um conector específico para o seu produto da Microsoft ou se um recurso que você deseja não estiver disponível nos conectores existentes, isso não significa necessariamente que não há mais o que fazer; pode apenas significar um pouco mais de trabalho.

Todos os conectores facilitam o uso da API da Microsoft, mas se você tiver conhecimento técnico, motivação e disposição para aprender a API da Microsoft, poderá utilizá-la diretamente por meio do nosso Conector HTTP.

Conector de solicitação HTTP (usa HTTPS)

• Um conector do núcleo do está disponível em cadeias, o que significa que seu uso é gratuito para todos sob a licença Wdata.
• É possível conectar-se diretamente a qualquer API, incluindo muitas da Microsoft, mas você precisará aprender a API e as mensagens e formatos corretos que precisam ser trocados.
• Exemplo de uso: Pode ser usado para extrair dados do Power BI nos casos em que o conector específico não possua essa funcionalidade.

Microsoft Fabric®

• Utilização do conector de solicitação HTTP para baixar métricas ESG calculadas do Microsoft Fabric® para relatórios de sustentabilidade

Microsoft® Sustainability Manager

• Utilização do conector de solicitação HTTP para baixar dados de relatórios externos no Microsoft® Sustainability Manager
• Utilização do conector de solicitação HTTP para baixar dados de emissões do Microsoft® Sustainability Manager

Usando uma opção da Microsoft em vez de cadeias

Em vez de cadeias, você poderia usar uma das muitas plataformas de software da Microsoft que permitem integrações. Todas as opções exigiriam o uso e o conhecimento da API da Workiva .

Azure Data Factory (ADF)

• O que é o: Um serviço de ETL (Extract, Transform, Load) baseado em nuvem, projetado para a ingestão de dados em grande escala e pipelines complexos de engenharia de dados. É o “motor principal” para a transferência de grandes quantidades de dados entre sistemas.
• Integração com as APIs da Workiva: O fluxo de trabalho: você pode começar com um pipeline de duas etapas: a Etapa 1 é uma “Atividade da Web” para acessar o endpoint de autenticação da Workiva (enviando o ID do cliente e o segredo) a fim de recuperar um token de acesso. A Etapa 2 é uma “Atividade de Cópia” que passa esse token dinamicamente para o cabeçalho de autorização (Bearer <token>) a fim de obter os dados propriamente ditos.
• Casos de uso típicos: Você precisa transferir grandes volumes de dados ou está desenvolvendo uma solução de “back-end” de nível empresarial que exige monitoramento, registro de logs e tratamento de erros.

Power Automate (anteriormente conhecido como Flow)

• O que é: Uma ferramenta de automação com baixo uso de código, projetada para lógica de negócios, notificações e fluxos de trabalho do tipo “se isso, então aquilo”.
• Integração com as APIs da Workiva: Você utiliza a Ação HTTP (recurso Premium) para enviar solicitações POST/GET brutas ou criar um Conector Personalizado, no qual define as configurações de segurança OAuth2 da Workiva uma única vez. Isso permite que você arraste e solte ações do “Workiva” no seu fluxo sem precisar se preocupar com o código de autenticação todas as vezes.
• Casos de uso típicos:
  • Você está automatizando processos de negócios, em vez de apenas transferir dados (por exemplo, “Aprovar este registro”, “Enviar uma notificação no Teams”).
  • O volume é baixo a médio (dados transacionais).
  • Você precisa de ações quase em tempo real baseadas em gatilhos (eventos), em vez de processamentos em lote.

Azure Logic Apps

• O que é: O “irmão mais velho” do Power Automate. Ele utiliza exatamente o mesmo designer de fluxo de trabalho e os mesmos conectores, mas é executado no Azure, em vez de no Microsoft 365. Ele foi projetado para integrações essenciais à missão em toda a empresa, e não para a produtividade pessoal ou em equipe.
• Integração com as APIs da Workiva: Idêntica à do Power Automate (ações HTTP ou conectores personalizados). A principal diferença é que os Logic Apps são executados na infraestrutura do Azure.
• Quando escolher:
  • Você precisa de uma governança de TI , monitoramento avançado e alertas (por exemplo, “Se a API do Workiva falhar, avise a equipe de DevOps”).
  • Você prefere um modelo de cobrança “ ” do tipo “pagamento por execução” (econômico para volumes baixos) em vez de adquirir licenças de usuário para cada pessoa que trabalha com o fluxo.
  • O fluxo de trabalho envolve dados financeiros críticos que exigem registros de auditoria e padrões de segurança mais rigorosos do que os de um fluxo padrão do Office 365.

Azure Functions

• O que é: “Computação sem servidor”. É aqui que você escreve código puro (C#, Python, JavaScript, etc.) que é executado sob demanda. É a solução definitiva para tudo quando as ferramentas prontas para uso não são flexíveis o suficiente.
• Integração com as APIs da Workiva: Você escreve código para solicitar o token OAuth, lidar com paginação complexa (percorrer páginas de dados) ou analisar dados JSON/XBRL desorganizados que as ferramentas padrão não conseguem processar. Em seguida, você “publica” esse código como uma URL simples que outras ferramentas (como o Power BI ou o ADF) podem acessar.
• Quando escolher:
  • A API da Workiva requer uma lógica complex (por exemplo, “Percorra essas 50 planilhas, mas somente se a célula A1 contiver ‘Ativo’, e, em seguida, reformate a sequência de caracteres da data”).
  • Você precisa processar os dados com extrema rapidez ou paralelizar as solicitações para permanecer dentro dos limites de taxa da API.
  • Você quer criar um “wrapper de API personalizado” para que suas equipes internas possam obter ou enviar dados do Workiva sem precisar saber como funciona o OAuth.

Microsoft Fabric (especificamente o Data Factory no Fabric)

• O que é:, a nova plataforma de análise “tudo em um” da Microsoft. Basicamente, ele combina o Azure Data Factory, o Power BI e um Data Lake (OneLake) em um único produto SaaS.
• Integração com as APIs do Workiva: Muito semelhante ao Azure Data Factory (ADF), utilizando pipelines e atividades de cópia.
• Quando escolher:
  • Sua organização já está adotando o Microsoft Fabric como sua futura plataforma de dados.
  • Você deseja encurtar o caminho entre os “Dados brutos do Workiva” e o “Relatório do Power BI” (o Fabric elimina a necessidade de gerenciar um banco de dados SQL separado nesse meio).
  • Você quer o poder do ADF, mas com a simplicidade de uma interface SaaS (sem precisar gerenciar recursos ou assinaturas do Azure).

Resumo