L'intégration OneStream vers Workiva proposée par l', accessible à l'adresse, permet aux entreprises d'automatiser l'extraction, la transformation et le transfert des données depuis OneStream Cloud vers la plateforme Workiva. Cette intégration peut être mise en œuvre soit via une connexion directe basée sur l'API d' via Workiva Chains et le connecteur HTTP, soit via un workflow SFTP basé sur des fichiers à l'aide du connecteur OneStream Smart Integration Connector (SIC).
Ces deux méthodes d'intégration permettent l'importation de données dans Workiva en vue des processus de reporting connectés en aval.
Intégration d'API
Exigences relatives à la connexion à l'API
- Environnement cloud OneStream : L'approche d'intégration via l'API n'est prise en charge que lorsque OneStream est hébergé dans un environnement cloud accessible au public.
- Compte de service dédié : Pour des raisons de sécurité, d'audit et de stabilité opérationnelle, créez dans OneStream un compte de service dédié non interactif, spécialement destiné à l'intégration.
- Autorisations minimales requises : N'attribuez au compte de service que les autorisations nécessaires pour accéder aux vues de cube concernées et aux données associées.
- Jeton d'accès personnel (PAT) : Générez un PAT à l'aide des identifiants du compte de service et conservez-le en toute sécurité dès sa création, car il risque de ne plus être récupérable par la suite.
- Accès au réseau et au pare-feu : Assurez-vous que les adresses IP statiques de Workiva ( ) figurent dans la liste des adresses autorisées afin de permettre les communications HTTPS sortantes (port 443) vers le point de terminaison de l'API OneStream.
Configurer l'intégration de l'API
L'intégration de l'API utilise les points de terminaison suivants : (GetCubeView) ou (GetAdoDataSetForCubeViewCommand) afin de récupérer les données de Cube View depuis OneStream.
Les chaînes Workiva peuvent s'authentifier auprès d'OneStream, exécuter la requête API, transformer la charge utile JSON renvoyée et charger l'ensemble de données obtenu dans des tables Wdata à des fins de reporting et de traitement en aval.
Étapes de configuration de Workiva
- Conservez le PAT en lieu sûr : Créez une variable d'espace de travail « » (par exemple,
onestream_api_pat) dans Chain Builder et marquez cette variable comme « Secret » afin de chiffrer sa valeur et d'empêcher tout accès non autorisé. - Activer les connecteurs requis : Vérifiez que le connecteur HTTP, le connecteur de transformation JSON et le connecteur de transformation tabulaire sont activés et correctement configurés dans l'environnement Workiva.
- Créer la table Wdata de destination : Exporter un exemple de vue de cube depuis OneStream sous forme de fichier CSV et l'utiliser comme modèle pour le schéma de la table Wdata « ». Notez l'identifiant de la table afin de l'utiliser dans la configuration de la chaîne.
- Transformation et mappage des données : Convertissez la réponse JSON en format tabulaire si nécessaire, puis mappez les noms de champs OneStream aux colonnes et types de données correspondants de la table Workiva.
- Configurer l'automatisation de la chaîne : Configurez le mécanisme de déclenchement de la chaîne pour contrôler le moment de son exécution. Les options disponibles incluent l'exécution selon un calendrier défini , à la demande (exécution manuelle), en tant qu'étape d'un workflow d'orchestration plus large , ou déclenchée par une feuille de contrôle .
Paramètres requis de l'API
| Paramètre | Obligatoire | Description |
| BaseWebServerUrl | Oui | L'URL de base du serveur d'applications OneStream. |
| Nom de l'application | Oui | Nom de l'application OneStream contenant la vue « Cube ». |
| Nom du cube | Oui | La vue « Cube » utilisée pour récupérer l'ensemble de données. |
| Nom du cube | Oui | Nom du cube associé utilisé par la vue de cube. |
Intégration SFTP
Dans le cadre d'une intégration via SFTP, OneStream exporte des fichiers de données (généralement au format CSV) vers un emplacement SFTP intermédiaire à l'aide de Smart Integration Connector. Workiva Chains récupère ensuite les fichiers à l'aide du connecteur SFTP « » (), traite les données, puis les charge dans les tables Wdata.
Cette approche est couramment utilisée dans les organisations où l'accès direct à l'API n'est pas disponible ou bien où l'on préfère ne pas créer ni utiliser de CubeViews.
| Responsabilités de l'équipe Informatique / Finance chargée de la clientèle | Responsabilités du partenaire chargé de la mise en œuvre |
|
|