A integração do OneStream com o Workiva da permite que as organizações automatizem a extração, a transformação e o envio de dados do OneStream Cloud para a plataforma Workiva. Essa integração pode ser implementada tanto por meio de uma conexão direta baseada na API do , utilizando o Workiva Chains e o Conector HTTP, quanto por meio de um fluxo de trabalho SFTP baseado em arquivos , utilizando o OneStream Smart Integration Connector (SIC).
Ambos os métodos de integração permitem a importação de dados para o Workiva, a fim de alimentar os processos de geração de relatórios conectados a jusante.
Integração de API
Requisitos de conexão com a API
- Ambiente de nuvem do OneStream: A abordagem de integração por API é compatível apenas quando o OneStream está hospedado em um ambiente de nuvem acessível ao público.
- Conta de serviço dedicada: Por motivos de segurança, auditoria e estabilidade operacional, crie uma conta de serviço dedicada e não interativa no OneStream especificamente para a integração.
- Permissões mínimas necessárias: Atribua à conta de serviço apenas as permissões necessárias para acessar as visualizações do cubo relevantes e os dados associados.
- Token de acesso pessoal (PAT): Gere um PAT usando as credenciais da conta de serviço e armazene o token com segurança imediatamente após a criação, pois ele poderá não ser recuperável posteriormente.
- Acesso à rede e ao firewall: Certifique-se de que os endereços IP estáticos da Workiva estejam na lista de endereços permitidos para autorizar a comunicação HTTPS de saída (porta 443) com o endpoint da API do OneStream.
Configurar a integração da API
A integração da API utiliza os endpoints GetCubeView ou GetAdoDataSetForCubeViewCommand para recuperar dados da Cube View do OneStream.
As cadeias do Workiva podem realizar a autenticação no OneStream, executar a solicitação de API, transformar a carga JSON retornada e carregar o conjunto de dados resultante nas tabelas do Wdata para geração de relatórios e processamento posterior.
Etapas de configuração do Workiva
- Armazene o PAT com segurança: Crie uma variável de espaço de trabalho do (por exemplo,
onestream_api_pat) no Chain Builder e marque a variável como Segredo do para criptografar o valor e impedir o acesso não autorizado. - Ativar conectores necessários: Verifique se o Conector HTTP, o Conector de Transformação JSON e o Conector de Transformação Tabular estão ativados e configurados corretamente no ambiente Workiva.
- Crie a tabela Wdata de destino: Exporte uma visualização de cubo de exemplo do OneStream como um arquivo CSV e use-a como modelo para o esquema da tabela Wdata “ ”. Anote o ID da tabela para uso na configuração da cadeia.
- Transformar e mapear dados: Converta a resposta JSON em um formato tabular, se necessário, e, em seguida, mapeie os nomes dos campos do OneStream às colunas e tipos de dados correspondentes da tabela do Workiva.
- Configurar a automação da cadeia: Configure o mecanismo de acionamento da cadeia para controlar quando ela será executada; as opções incluem a execução de acordo com uma programação definida , sob demanda (execução manual), como uma etapa dentro de um fluxo de trabalho de orquestração mais amplo ou acionada por uma folha de controle .
Parâmetros obrigatórios da API
| Parâmetro | Necessário | Descrição |
| BaseWebServerUrl | Sim | A URL base do servidor de aplicativos do OneStream. |
| Nome do aplicativo | Sim | O nome do aplicativo OneStream que contém a visualização do cubo. |
| Nome do cubo | Sim | A visualização “Cube View” utilizada para recuperar o conjunto de dados. |
| Nome do cubo | Sim | O nome do cubo associado utilizado pela visualização do cubo. |
Integração com SFTP
Em uma integração baseada em SFTP, o OneStream exporta arquivos de dados (geralmente no formato CSV) para um local SFTP intermediário por meio do Smart Integration Connector. O Workiva Chains, então, recupera os arquivos usando o conector SFTP do , processa os dados e os carrega nas tabelas do Wdata.
Essa abordagem é comumente utilizada em organizações nas quais o acesso direto à API não está disponível ou nas quais se prefere não criar nem utilizar CubeViews.
| Responsabilidades da equipe de TI/Finanças do cliente | Responsabilidades do parceiro de implementação |
|
|