◫UBC Data BridgeDocumentation2.1.1
Site du produit Conseil

UBC DATA BRIDGE

Documentation

Guides pratiques pour votre premier flux, la préparation des données, les API, Agent, les connecteurs, l’exécution, les accès et les exemples.

Premiers pas

Nouveautés d’UBC Data Bridge 2.1.1

UBC Data Bridge 2.1.1 : échange de données, API, ressources de réseaux privés et processus contrôlés.

↗
Fonctionnalités d’UBC Data Bridge

De la source de données à un résultat validé dans un même flux visuel.

↗
Votre premier flux

Pas à pas : importer une table, sélectionner des lignes et produire un fichier.

↗
Concepts fondamentaux

Source, connexion, bloc, flux, brouillon et exécution sont des objets distincts du système.

↗

Architecture

Architecture du système

Composants du système et responsabilités, indépendamment des langages d’implémentation.

↗
Moteur et performances

Comment le système exécute un graphe, contrôle les ressources et prépare les écritures.

↗
Options de déploiement

Un produit autonome ou intégré à UBC Analytics ; distributions en ligne et hors ligne.

↗
Stockage des métadonnées et des fichiers

Ce qui est conservé dans la base, ce qui est stocké dans des fichiers et le fonctionnement de l’isolation.

↗

Flux et exécution

Bibliothèques et organisation du travail

Retrouver les flux, connexions et sources, et utiliser les dossiers et les verrous d’édition.

↗
Concepteur de flux

Canevas, blocs, ports, propriétés et analyse des résultats intermédiaires.

↗
Brouillons et Production

Modification, enregistrement automatique, simulation et publication d’une version opérationnelle.

↗
Exécution, validation et résultats

Comment interpréter les états et éviter les doublons après un échec.

↗
Un bouton de lancement sur un autre site

Exécuter un flux depuis un portail d’entreprise : rôle, intégration par URL, états et assistant interactif.

↗
Calendriers et tâches automatisées

Démarrer à une heure donnée, à intervalles réguliers ou après une modification de source.

↗

Sources et connecteurs

Sources de fichiers et plages

Transformer un fichier en table stable pour un flux.

↗
Gestionnaire de fichiers

Fichiers gérés, versions, dossiers et paramètres de conservation.

↗
Stockage distant des fichiers

Configurer Google Drive, OneDrive, S3, FTP/FTPS et un lecteur réseau.

↗
Utiliser les connexions

Une procédure commune pour créer, tester et utiliser l’accès aux services.

↗
Lire et écrire dans les bases de données

Tables, requêtes, clés et modes d’insertion ou de mise à jour.

↗
REST API et OData

Ressources, formats, pages de réponse et transmission des lignes.

↗
Microsoft Dynamics 365

Paramètres de connexion, champs obligatoires et règles d’utilisation.

↗
1C:Enterprise 8 (serveur local)

Paramètres de connexion, champs obligatoires et règles d’utilisation.

↗
Microsoft SQL Server

Paramètres de connexion, champs obligatoires et règles d’utilisation.

↗
Azure SQL Database

Paramètres de connexion, champs obligatoires et règles d’utilisation.

↗
Oracle Database

Paramètres de connexion, champs obligatoires et règles d’utilisation.

↗
IBM Db2

Paramètres de connexion, champs obligatoires et règles d’utilisation.

↗
PostgreSQL

Paramètres de connexion, champs obligatoires et règles d’utilisation.

↗
MySQL / MariaDB

Paramètres de connexion, champs obligatoires et règles d’utilisation.

↗
ClickHouse

Paramètres de connexion, champs obligatoires et règles d’utilisation.

↗
Redis

Paramètres de connexion, champs obligatoires et règles d’utilisation.

↗
Source de données ODBC

Paramètres de connexion, champs obligatoires et règles d’utilisation.

↗
REST API (tout service HTTP)

Paramètres de connexion, champs obligatoires et règles d’utilisation.

↗
Courriel (SMTP)

Paramètres de connexion, champs obligatoires et règles d’utilisation.

↗
Bot Telegram

Paramètres de connexion, champs obligatoires et règles d’utilisation.

↗

Configuration API

API : trois directions d’échange

Choisir une direction d’échange API, préparer les accès, publier un flux et vérifier le cycle complet.

↗
Recevoir des données et des fichiers par API

Configurer un point d’entrée, la validation des champs, un flux Production, l’idempotence et le suivi des livraisons.

↗
Lire et envoyer des données par des API externes

Configurer une connexion REST : authentification, analyse des réponses, pagination, écritures par lots et contrôle des nouvelles tentatives.

↗
Publier les données d’un flux par API

Publier un jeu de données avec filtres, pagination, contrôle de fraîcheur ou exécution à la demande.

↗
Clients API, clés et signature des requêtes

Accorder à un système externe un accès contrôlé aux flux et vérifier sa clé, sa signature HMAC et ses autorisations.

↗
Référence technique et vérification des API

Générer la référence actuelle d’un point à partir de ses paramètres, autoriser les intégrateurs et vérifier le contrat.

↗

Configuration Agent

UBC Data Bridge Agent : premiers pas

Connecter UBC Data Bridge aux ressources d’un réseau privé, enregistrer un agent et gérer ses accès pendant tout son cycle de vie.

↗
Agent sous Windows : installation et configuration

Installer le service Windows, l’enregistrer de façon sécurisée, autoriser les dossiers, vérifier la connexion et assurer la maintenance de l’Agent.

↗
Agent sous macOS : installation et configuration

Installer l’Agent sur un Mac, l’enregistrer, configurer les droits du service et les volumes réseau, et gérer les mises à jour.

↗
Agent sous Linux : installation et configuration

Préparez Linux, connectez l’Agent à Data Bridge, accordez l’accès aux dossiers et vérifiez le fonctionnement du service.

↗
Agent : ressources, autorisations et réseau

Configurez les dossiers, bases de données et API autorisés, l’authentification du proxy, les certificats de confiance et la connexion à Data Bridge.

↗
Agent : diagnostic et dépannage

Trouvez la cause des défaillances de l’Agent, vérifiez le réseau et les autorisations, relancez les opérations sur fichiers en toute sécurité et préparez un rapport utile pour l’assistance.

↗

Blocs et transformations

Référence des blocs du concepteur

Blocs de traitement, d’interaction, d’appel de flux, d’API et de livraison des résultats.

↗
Fichier

Lit une source de fichier enregistrée ou écrit dans sa plage.

↗
Connexion

Un bloc unique pour les applications métier, les bases de données, les espaces de stockage et les API externes.

↗
Ordre et visibilité des champs

Conserve les champs nécessaires et modifie leur ordre et leur nom.

↗
Dépivoter les colonnes

Convertit un tableau large de périodes en lignes « période — valeur ».

↗
Mappage des colonnes

Construit un nouveau tableau à partir de colonnes sélectionnées et de valeurs constantes.

↗
Filtre

Conserve les lignes qui respectent les conditions définies.

↗
Regroupement

Regroupe les lignes par clés et calcule des agrégats.

↗
Paramètres d’exécution

Un formulaire utilisateur et des valeurs constantes qui pilotent l’exécution.

↗
Union

Réunit les lignes de plusieurs tableaux dans un seul jeu de données.

↗
Jointure

Ajoute des champs d’autres tableaux à l’aide de clés communes.

↗
Dédoublonnage

Conserve l’occurrence souhaitée de chaque clé, ou uniquement les clés qui n’apparaissent qu’une fois.

↗
Routage

Répartit les lignes entre des branches conditionnelles, notamment selon des données de référence.

↗
Répartiteur

Transmet le tableau entier à plusieurs branches en même temps.

↗
Champs calculés

Ajoute des calculs sur les nombres, les textes, les dates et les conditions.

↗
Choisir un fichier pendant l’exécution

Compatibilité avec les flux enregistrés qui chargent un fichier à cette étape.

↗
Aperçu des données

Un tableau de vérification pendant l’exécution et un moyen de terminer une branche sans écriture.

↗
Exportation de données

Crée un fichier Excel, CSV, TXT, JSON, XML ou SQLite.

↗
Transformation de texte

Nettoyage et normalisation successifs des champs de texte.

↗
Identifiant unique

Ajoute un GUID, un identifiant Snowflake ou un numéro séquentiel.

↗
Formats des nombres et des dates

Reconnaissance, normalisation et mise en forme des nombres et des valeurs calendaires.

↗
Nettoyage et contrôle de qualité des données

Règles de remplacement, de rejet des lignes et d’arrêt en cas d’erreur de qualité.

↗
Enrichir avec un tableau d’une seule ligne

Ajoute les mesures d’une ligne auxiliaire à chaque ligne du tableau principal.

↗
Transposer les lignes et les colonnes

Intervertit les lignes et les colonnes d’un tableau.

↗
Message

Affiche une notification ou une boîte de dialogue pendant une exécution interactive.

↗
Choisir une option

Une décision manuelle de l’utilisateur qui active une branche.

↗
Fusionner les branches

Poursuit l’une des branches alternatives qui a été exécutée.

↗
Définir les valeurs des champs

Modifie les champs existants et en ajoute de nouveaux selon des conditions.

↗
Courriel

Envoie des courriels au moyen d’une connexion de messagerie configurée.

↗
Message Telegram

Envoie des messages et des pièces jointes par l’intermédiaire d’un bot.

↗
Rôle et utilisateur

Ajoute les valeurs du rôle et de l’utilisateur UBC Analytics actuels.

↗
Référence des fonctions de formule

Toutes les fonctions de la version documentée : signatures, usage et exemples.

↗
Transfert de fichiers

Copie et déplace des fichiers et des dossiers entre le Gestionnaire de fichiers et les espaces de stockage connectés.

↗
Orienter selon le mode de lancement

Des branches distinctes pour un lancement manuel, une API entrante et un bouton Workspace.

↗
Appeler des flux

Lance les versions Production d’un ou de plusieurs autres flux avec des paramètres et des données.

↗
Recevoir les données d’un flux

Une entrée pour un sous-flux ou un processus recevant un tableau d’un autre flux.

↗
Appeler un flux (sous-flux)

Réutilise un flux comme une fonction : un tableau d’entrée et un tableau de sortie transformé.

↗
Renvoyer les données au flux

Une sortie déclarée renvoyée au bloc de sous-flux appelant.

↗
Données entrantes API

Un bloc source pour les données et fichiers de requêtes externes : formats, champs, clés, validation et simulation.

↗
Publication de données API

Un bloc de fin de branche qui publie le résultat d’un flux avec des paramètres, des filtres et un mode d’exécution.

↗

IBM Planning Analytics

IBM Planning Analytics : possibilités d’intégration

Comment UBC Data Bridge fonctionne avec TM1, quels objets sont disponibles et comment choisir un scénario d’intégration.

↗
Créer et tester une connexion TM1

Adresse REST, accès réseau, certificats et cinq méthodes d’authentification.

↗
CAM, authentification unique et session personnelle

Comment fonctionnent ensemble la connexion UBC Data Bridge, Cognos et l’accès à TM1 avec les droits personnels.

↗
Connexion d’entreprise et exécutions en arrière-plan

Un compte enregistré pour les flux automatiques, la passerelle Cognos et les contraintes de connexion.

↗
Lire les cubes et les vues publiques

Paramètres de source IBM, colonnes de sortie, consolidations et limites de volume.

↗
Dimensions, hiérarchies et attributs

Comment extraire les référentiels IBM avec leur structure, leurs poids et les occurrences répétées d’éléments.

↗
Sous-ensembles et paramètres d’éléments IBM

Sélectionner un élément de dimension dans le formulaire d’exécution et utiliser sa valeur dans les destinations.

↗
Associer les lignes aux cellules TM1

Dimensions, constantes, tables de correspondance, alias et traitement des coordonnées dupliquées.

↗
Écrire dans un cube : validation, lots et résultats

Ce qui est vérifié avant l’écriture et comment traiter les résultats confirmés ou incertains.

↗
Effacement du cube et addition transactionnelle

Addition, remplacement, effacement contrôlé et mises à jour de cube déclenchées par l’enregistrement de formulaires.

↗
Processus TurboIntegrator et automatisation

Sélection d’un processus TI, paramètres, simulation, état IBM et différence avec les Chores.

↗
Un bouton de lancement dans IBM Planning Analytics Workspace

Connectez un classeur par URL : configuration Data Bridge et PAW, exemples de styles, états et assistant d’actualisation de rapport.

↗

Administration

Utilisateurs, rôles et autorisations

Un modèle d’accès unifié pour la connexion locale, OIDC, IBM CAM et UBC Analytics.

↗
Intégration UBC Analytics

Environnements, espaces de travail, formulaires, cubes et boutons de lancement.

↗
Import, export et migration

Comment déplacer les flux, sources et connexions entre environnements.

↗
Diagnostic et erreurs courantes

Du message d’erreur à la vérification d’un bloc précis.

↗
Licence et état de l’installation

Activation, période de validité et vérification du fonctionnement du système.

↗
À propos de cette documentation

Utiliser la documentation, les exemples et les illustrations d’UBC Data Bridge 2.1.1.

↗

Exemples de flux

20 flux configurés

Une progression pratique, d’un simple import CSV à l’écriture dans IBM Planning Analytics.

↗
01. Convertir CSV en JSON

Lisez un fichier de ventes séparé par des points-virgules, conservez les noms de colonnes et produisez du JSON pour l’intégration suivante.

↗
02. Excel : passer les mois des colonnes aux lignes

Préparez un modèle de budget Excel large pour le charger dans un modèle avec une dimension de période.

↗
03. JSON : extraire un tableau d’enregistrements imbriqués

Prenez le tableau data.items d’un JSON et créez un CSV plat avec un ordre de colonnes cohérent.

↗
04. XML : du catalogue produit à Excel

Sélectionnez les éléments XML répétés, utilisez l’attribut id comme code et écrivez le catalogue dans Excel.

↗
05. Normaliser les codes et supprimer les doublons

Uniformisez l’écriture des codes produit et conservez le dernier enregistrement de chaque code.

↗
06. Règles de qualité successives

Corrigez les valeurs manquantes et les quantités négatives, remplacez les erreurs Excel et rejetez les lignes contenant du texte inacceptable.

↗
07. Chiffre d’affaires et totaux régionaux

Calculez le chiffre d’affaires de chaque vente et préparez un tableau récapitulatif par région.

↗
08. Jointure : ventes et référentiel de prix

Joignez les prix aux ventes par une clé numérique en conservant les lignes sans prix.

↗
09. Union : réunir les données des agences

Réunissez deux jeux de ventes dans un tableau selon les noms de colonnes, même si leur ordre diffère.

↗
10. Orienter les grosses commandes

Répartissez les commandes entre prioritaires et ordinaires selon leur montant, avec un fichier distinct par branche.

↗
11. Orienter à partir d’un référentiel de plafonds

Comparez le montant d’une demande au plafond propre à son service plutôt qu’à une constante unique pour tous.

↗
12. Filtrer avec un paramètre d’exécution

Laissez l’utilisateur choisir une région et un montant minimal sans modifier le flux lui-même.

↗
13. SQL : sélectionner les commandes ouvertes

Lisez un ensemble limité d’enregistrements SQL avec une requête SELECT et créez un CSV de vérification.

↗
14. SQL : ajouter ou actualiser le référentiel produit

Actualisez un produit existant par sa clé sku et ajoutez un produit manquant à une table SQL pédagogique.

↗
15. API REST : commandes d’une réponse JSON

Lisez une ressource API, extrayez le tableau data.items, conservez les commandes ouvertes et produisez un fichier Excel.

↗
16. IBM Planning Analytics : extraire une vue publique

Lisez une vue publique de cube IBM Planning Analytics et transmettez-la à un rapport tabulaire.

↗
17. IBM Planning Analytics : du budget Excel au cube

Dépivotez les mois d’un classeur de budget et écrivez quatre valeurs dans un cube pédagogique avec un mappage explicite de chaque dimension.

↗
18. IBM Planning Analytics : exécuter TurboIntegrator

Lancez un processus TI pédagogique avec une année fixe et un scénario choisi dans l’assistant d’exécution.

↗
19. Choix manuel d’un scénario et fusion des branches

Laissez l’opérateur approuver ou rejeter un ensemble de demandes, puis revenir à un export commun après l’action sélectionnée.

↗
20. Notifications d’anomalies par courriel et Telegram

Repérez les commandes au montant négatif et envoyez un rapport concis à un groupe de contrôle par deux canaux.

↗
Illustration agrandie