Centro de suporte da Workiva

Este artigo fornece uma visão geral das opções disponíveis para a integração com os produtos da Microsoft sobre os quais nossos clientes mais comumente fazem perguntas.

Observação: Há muitos produtos da Microsoft; aqui abordaremos apenas uma pequena seleção.

Quem precisa estar envolvido?

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 em qualquer integração é o que deve transportar os dados entre a Workiva e o sistema externo (ou a plataforma Microsoft, nesse caso específico). A Workiva tem cadeias para realizar isso, enquanto a Microsoft tem muitas plataformas diferentes (Azure Data Factory, Power Automate, Power Query, entre outras). Você também pode usar software ou código de programação de terceiros que não sejam das duas empresas. Desde que o que você usa tenha a capacidade de trabalhar com APIs, ele deve ser capaz de transportar dados entre as plataformas.

Observação: Em geral, recomendamos tentar usar apenas uma dessas ferramentas. Na maioria dos casos de uso, é melhor para a eficiência, o dimensionamento e a manutenção limitar os pontos de falha de sua integração e, portanto, o número de diferentes pacotes de software envolvidos.

Usando as cadeias da Workiva

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

Conectores dedicados para correntes

O Chains tem vários conectores dedicados que facilitam a conexão com determinados produtos da Microsoft.

Observação: Todos os conectores premium exigirão a ativação do e podem ter custos adicionais. Verifique seu contrato ou entre em contato com o CSM para obter mais detalhes.

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

• O OneDrive é um conector de núcleo em cadeias, o que significa que seu uso é gratuito para todos com a licença Wdata.
• Você pode copiar, excluir e pesquisar arquivos e pastas, bem como fazer download e upload de arquivos e listar as unidades disponíveis.

Power BI®

• Um conector premium .
• Excelente 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.
• Ele não pode extrair dados do Power BI em um formato que possa ser usado na plataforma Workiva. Se você quiser trazer dados do Power BI para a Workiva, precisará buscar um método alternativo, como o conector HTTP .

Microsoft® SQL Server® (também Banco de Dados SQL do Azure)

• Um conector premium .
• Execute comandos SQL, recupere detalhes sobre uma tabela ou insira registros em um banco de dados.
• Compatível com o Banco de Dados SQL do Azure, o Azure Synapse Analytics, a Instância Gerenciada de SQL do Azure e o SQL Server 2017-2022.

Armazenamento de arquivos do Azure

• Um conector premium .
• Baixe um arquivo de sua instância do Armazenamento de Arquivos do Azure.
• Não é possível fazer mais nada.

Microsoft® Dynamics® CRM

• Um conector premium .
• Gerenciar entidades e consultas.

Onde não existem conectores dedicados para correntes

Se não houver um conector dedicado para o seu produto Microsoft ou se um recurso que você deseja não estiver disponível nos conectores existentes, isso não é necessariamente o fim do caminho; pode significar apenas um pouco mais de trabalho.

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

Conector de solicitação HTTP (usa HTTPS)

• Um conector de núcleo em cadeias, o que significa que é de uso gratuito para todos com a licença Wdata.
• Capaz de se conectar diretamente a qualquer API, incluindo muitas das da Microsoft, mas você precisará aprender a API e corrigir as mensagens e os formatos que precisam ser trocados.
• Exemplo de uso: Pode ser usado para extrair dados do Power BI quando o conector dedicado não tiver essa funcionalidade.

Microsoft Fabric

• Usando o conector HTTP Request para fazer download de métricas ESG computadas do Microsoft Fabric® para relatórios de sustentabilidade

Microsoft® Sustainability Manager

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

Usando uma Microsoft Option em vez de cadeias

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

Fábrica de Dados do Azure (ADF)

• O que é: Um serviço ETL (Extract, Transform, Load) baseado em nuvem, projetado para ingestão de dados em grande escala e pipelines complexos de engenharia de dados. Ele é o "levantador de peso" para mover 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 Client ID/Secret) para 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>) para extrair dados reais.
• Casos de uso típicos: Você precisa mover grandes volumes de dados ou está criando uma solução de "back-end" de nível empresarial que requer monitoramento, registro e tratamento de erros.

Power Automate (antigo Flow)

• O que é: Uma ferramenta de automação com pouco código projetada para lógica comercial, notificações e fluxos de trabalho "se isso, então aquilo".
• Integração com as APIs da Workiva: Você usa a ação HTTP (recurso Premium) para fazer solicitações POST/GET brutas ou cria um conector personalizado no qual define as configurações de segurança OAuth2 da Workiva uma vez. Isso permite que você arraste e solte ações "Workiva" em seu fluxo sem se preocupar com o código de autenticação todas as vezes.
• Casos de uso típicos:
  • Você está automatizando processos comerciais em vez de apenas mover dados (por exemplo, "Aprovar este registro", "Enviar uma notificação do Teams").
  • O volume é de baixo a médio (dados transacionais).
  • Você precisa de ações quase em tempo real com base em acionadores (eventos) em vez de lotes.

Aplicativos lógicos do Azure

• O que é: O "irmão mais velho" do Power Automate. Ele usa exatamente o mesmo designer de fluxo de trabalho e conectores, mas é executado no Azure em vez do Microsoft 365. Ele foi projetado para integrações de missão crítica em toda a empresa, e não para produtividade pessoal ou de equipe.
• Integração com as APIs da Workiva: Idêntico ao Power Automate (ações HTTP ou conectores personalizados). A principal diferença é que os aplicativos lógicos são executados na infraestrutura do Azure.
• Quando escolher:
  • Você precisa de governança de TI, monitoramento avançado e alertas (por exemplo, "Se a API da Workiva falhar, chame a equipe de DevOps").
  • Você quer um modelo de faturamento "pay-per-execution" (barato para baixo volume) em vez de comprar licenças de usuário para cada pessoa que toca o fluxo.
  • O fluxo de trabalho envolve dados financeiros críticos que exigem logs de auditoria e padrões de segurança mais altos do que um fluxo padrão do Office 365.

Funções do Azure

• O que é: "Serverless compute" (computação sem servidor). É aqui que você escreve código puro (C#, Python, JavaScript, etc.) que é executado sob demanda. É a solução definitiva quando as ferramentas prontas para uso não são suficientemente flexíveis.
• Integração com as APIs da Workiva: Você escreve o código para solicitar o token OAuth, manipula a paginação complexa (looping em páginas de dados) ou analisa dados JSON/XBRL confusos que as ferramentas padrão não conseguem analisar. Em seguida, você "publica" esse código como um URL simples que pode ser chamado por outras ferramentas (como o Power BI ou o ADF).
• Quando escolher:
  • A API da Workiva requer lógica complexa (por exemplo, "Percorra essas 50 planilhas, mas somente se a célula A1 contiver 'Active' e, em seguida, reformate a cadeia de datas").
  • Você precisa processar dados extremamente rápido ou paralelizar solicitações para permanecer dentro dos limites de taxa da API.
  • Você deseja criar um "wrapper de API personalizado" para que suas equipes internas possam obter ou enviar dados da Workiva sem saber como o OAuth funciona.

Microsoft Fabric (especificamente Data Factory in 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 da Workiva: Muito semelhante ao Azure Data Factory (ADF), usando pipelines e atividades de cópia.
• Quando escolher:
  • Sua organização já está se movendo em direção ao Microsoft Fabric como sua futura plataforma de dados.
  • Você deseja encurtar o caminho de "Raw Workiva Data" para "Power BI Report" (o Fabric elimina a necessidade de gerenciar um banco de dados SQL separado no meio).
  • Você quer o poder do ADF, mas com a simplicidade de uma interface SaaS (sem gerenciar recursos/assinaturas do Azure).

Resumo