Connexion

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

Rôle

Lit ou écrit des données au moyen d’une connexion enregistrée. Les propriétés disponibles dépendent du service : IBM Planning Analytics, UBC Analytics, stockage de fichiers, base de données ou API. Les identifiants sont configurés dans la connexion elle-même ; le bloc sélectionne l’objet et les règles d’échange.

Entrées et sorties

Une source n’a pas d’entrée et fournit un tableau par out. Une destination reçoit in et possède les sorties facultatives success et failure. success transmet le tableau écrit ; failure transmet une description d’erreur sur une ligne. Pour un processus TurboIntegrator, le bloc est une destination qui lance le processus une fois ou pour chaque combinaison distincte de valeurs des colonnes de paramètres.

Paramètres

Le paramètre	Réglages et valeurs	Options et limites
`role`	Rôle du bloc : une source lit les données ; une destination écrit le résultat.	Options : `source`, `target`
`connection_id`	La connexion enregistrée par laquelle le bloc accède au système.	Jusqu’à 64 caractères
`object_type`	Type d’objet du système métier : cube, dimension ou formulaire. Une dimension IBM prend en charge les rôles source et destination ; une dimension UBC Analytics est une source.	Options : `cube`, `dimension`, `form` Par défaut : `cube`
`dimension`	La dimension dont les éléments sont lus.	Par défaut : `empty` Jusqu’à 256 caractères
`hierarchy`	La hiérarchie de la dimension sélectionnée.	Par défaut : `empty` Jusqu’à 256 caractères
`cube`	Le cube à lire ou dans lequel écrire.	Par défaut : `empty` Jusqu’à 256 caractères
`mapping`	Mappage intégré des champs du tableau vers les dimensions et la valeur du cube.	Par défaut : `not set`
`environment`	L’environnement UBC Analytics ; sélectionnez-le avant l’objet et les champs.	Par défaut : `empty` Jusqu’à 80 caractères
`form`	Le formulaire UBC Analytics à lire ou dans lequel écrire.	Par défaut : `empty` Jusqu’à 256 caractères
`read_scope`	Pour un formulaire : tous les enregistrements ou celui qui a lancé le flux.	Options : `all`, `launch_record` Par défaut : `all`
`columns`	Lit uniquement les champs ou toutes les colonnes disponibles, y compris les codes et noms de l’objet.	Options : `fields`, `all` Par défaut : `fields`
`write_mode`	Pour un formulaire : ajoute avec insert, met à jour avec update, ou ajoute/met à jour avec upsert.	Options : `insert`, `update`, `upsert` Par défaut : `insert`
`key_field`	Le champ clé du formulaire utilisé pour trouver l’enregistrement lors d’une opération update/upsert.	Par défaut : `empty` Jusqu’à 256 caractères
`form_mapping`	Mappage des colonnes d’entrée, constantes, paramètres, valeurs de référence ou valeurs générées vers les champs du formulaire.	Par défaut : `not set`
`view`	Une vue partagée de cube IBM ; les vues privées ne sont pas prises en charge.	Par défaut : `empty` Jusqu’à 256 caractères
`read_mode`	Lit la vue ou le cube sélectionné.	Options : `view`, `cube` Par défaut : `view`
`element_mode`	Lit tous les éléments de dimension, uniquement les éléments feuilles ou uniquement les éléments consolidés.	Options : `leaf`, `consolidated`, `all` Par défaut : `all`
`value_column`	Le champ du tableau contenant la valeur de la mesure.	Par défaut : `Value` Jusqu’à 256 caractères
`file_kind`	Le type de service de fichiers pour les connexions compatibles.	Options : `google_sheets`, `google_drive`, `onedrive`, `s3`, `ftp`, `network`, `agent_folder` Par défaut : `google_drive`
`selection_mode`	Lit les cellules indiquées ou une plage nommée du classeur.	Options : `cells`, `defined_name` Par défaut : `cells`
`defined_name`	Le nom d’une plage définie dans le classeur Excel.	Par défaut : `empty` Jusqu’à 255 caractères
`defined_scope`	La portée de la plage nommée : classeur ou feuille.	Par défaut : `empty` Jusqu’à 128 caractères
`json_path`	Le chemin vers le tableau d’enregistrements dans un document JSON.	Par défaut : `empty` Jusqu’à 1 024 caractères
`xml_path`	Le chemin vers les éléments à lire comme lignes XML.	Par défaut : `./*` Jusqu’à 1 024 caractères
`file_id`	L’identifiant ou le chemin du fichier dans le stockage sélectionné.	Par défaut : `empty` Jusqu’à 2 048 caractères
`sheet`	Le nom de la feuille du classeur.	Par défaut : `empty` Jusqu’à 128 caractères
`range`	Une plage de cellules en notation A1, par exemple A1:F500.	Par défaut : `A1:M100` Jusqu’à 40 caractères
`header`	Utilise la première ligne de la plage comme noms de champs.	Par défaut : `enabled`
`delimiter`	Le séparateur de champs du fichier texte.	Options : `,`, `;`, `tab` Par défaut : `;`
`clear_range`	Efface le reste de la plage configurée après l’écriture ; les données situées en dehors restent inchangées.	Par défaut : `disabled`
`target_mode`	Écrit des données dans un objet ou lance un processus IBM TurboIntegrator.	Options : `write`, `process` Par défaut : `write`
`process`	Le nom du processus TurboIntegrator choisi dans la liste disponible.	Par défaut : `empty` Jusqu’à 256 caractères
`process_parameters`	Paramètres du processus : une constante, un paramètre d’exécution ou une colonne des données d’entrée.	Nombre : 0–100
`external`	Paramètres du tableau, de la requête ou de la ressource d’un service externe, d’une API ou d’une base de données.	Par défaut : `not set`
`cube_write`	Comportement d’écriture dans un cube : addition, remplacement ou addition transactionnelle ; effacement préalable facultatif.	Par défaut : `not set`

Mappage et écriture dans un cube

Le paramètre	Paramètre
mapping.bindings	Chaque dimension et hiérarchie ; source de type colonne/constante/paramètre, valeur, Alias facultatif et correspondance par référence.
mapping.value_column / value_type / decimal	Champ de mesure, nombre ou texte, séparateur décimal.
mapping.blank / duplicates	skip/zero/error pour les valeurs vides ; error/sum pour les coordonnées répétées.
mapping.portion_cells / response_seconds	500–50 000 cellules, 10 000 par défaut ; 10–3 600 secondes, 120 par défaut.
cube_write.mode	add, replace ou transaction. Le mode transaction utilise un événement d’enregistrement de formulaire UBC Analytics.
cube_write.clear	Le cube entier ou des tranches sélectionnées par éléments, données ou paramètres. L’effacement utilise le remplacement.

Tables, API et services externes

Le paramètre	Élément configuré
`external.object / source_mode / query`	L’objet à lire ou une requête personnalisée lorsque le service le permet.
`select / filter / order_by`	Champs, condition de sélection et ordre ; la syntaxe dépend du service.
`write_mode / key_fields`	insert/update/upsert et champs clés pour les opérations d’écriture prises en charge.
`method / query_params / body / records_path`	Pour les API : GET/POST/PUT/PATCH, paramètres de requête, corps de requête et chemin vers les lignes dans la réponse.
`pagination / next_link_path`	Sans pagination, lien vers la page suivante, numéro de page ou décalage. next_link_path indique le chemin vers le lien.
`page_param / size_param / page_size / first_page / max_pages`	Noms des paramètres de page, taille de 1 à 10 000, page initiale 0/1 et nombre maximal de pages de 1 à 10 000.
`send_mode / batch_size / batch_key`	Envoie chaque ligne ou un lot ; taille du lot et clé du tableau dans le corps de la requête.
`value_format / value_field / ttl`	Pour un stockage clé–valeur compatible : hash/json/string, champ de contenu et durée de conservation en secondes (jusqu’à 31 536 000).
`extra_params`	Paramètres supplémentaires d’un service pris en charge ; utilisez uniquement les propriétés proposées par son formulaire.

Configuration étape par étape

Créez et testez une connexion dans « Connexions ». Faites-la glisser depuis la palette vers le flux.
Choisissez le rôle. Pour un système métier, sélectionnez d’abord l’environnement et le type d’objet, puis le cube, la dimension, le formulaire ou le processus.
Pour une source, choisissez la méthode de lecture ; pour un service externe, définissez l’objet ou la requête, la sélection et la liste des champs. Lisez les champs.
Pour une destination, connectez le tableau préparé. Configurez le mappage, le mode d’écriture et les clés de mise à jour.
Si l’exécution doit se poursuivre après l’écriture, connectez success à l’étape suivante et failure à un message ou à un autre traitement d’erreur.
Lancez une simulation ; vérifiez les coordonnées, le nombre de lignes et le périmètre des données concernées, puis lancez l’écriture.

Règles et diagnostics

Les possibilités de lecture et d’écriture dépendent du service précis ; un champ de configuration commun ne signifie pas que chaque connexion prend en charge tous les modes.
Un cube nécessite une valeur pour chaque dimension et pour le champ de mesure. Le mappage est généralement enregistré directement dans la destination.
Les formulaires UBC Analytics acceptent des mappages tabulaires ; le mappage de cube et l’exécution TI ne s’y appliquent pas. Le champ clé update/upsert doit recevoir une valeur du mappage.
Lors d’une simulation, le processus TI est vérifié dans IBM mais n’est pas exécuté. Une valeur de paramètre constante vide correspond à la valeur par défaut du processus.
La sortie failure traite une erreur certaine de la destination. Un résultat incertain d’écriture externe et une annulation nécessitent une vérification distincte de l’état ; ne supposez pas que l’écriture n’a certainement pas eu lieu.

Exemple de configuration

Pour charger un plan, sélectionnez la connexion IBM, role=target et cube=SalesPlan. Reliez Product et Month aux colonnes, Version à la constante Budget, Measure à Amount et value_column à Value. Choisissez replace pour remplacer les cellules visées ; après success, affichez un message avec le résultat.

Écrire dans une dimension IBM

Pour une destination, sélectionnez « Dimension », puis la dimension et la hiérarchie. Dans « Écrire dans la dimension », choisissez la colonne du nom principal. Autorisez la création des éléments feuilles numériques manquants, ou désactivez cette option pour un contrôle strict du référentiel. Pour actualiser un attribut, choisissez son nom, la colonne de valeur et le mode de mise à jour : sans effacement ou après effacement de toutes les autres valeurs. Les lignes répétées pour un même élément doivent avoir la même valeur d’attribut.

Un parent consolidé peut provenir d’une constante, d’un paramètre de lancement ou d’une colonne. Pour une structure à plusieurs niveaux, ajoutez jusqu’à 20 paires colonne parent → colonne enfant. Les parents manquants peuvent être créés comme consolidations ; les cycles et les types d’éléments inadaptés sont rejetés. Les relations existantes ne sont pas supprimées. La simulation lit et valide la hiérarchie sans modifier IBM ; l’état est à nouveau vérifié avant l’écriture. Transmettez un tableau sans mappage de cube.

Champs pour les scénarios spécialisés

Le paramètre	Utilisez
simulation_record / simulation_previous	L’enregistrement de formulaire utilisé pour la simulation et celui fournissant les valeurs avant enregistrement ; uniquement pour une source launch_record.
dimension_write	Paramètres de destination d’une dimension IBM : nom d’élément, attribut, parent et relations hiérarchiques.
file_kind=agent_folder	Un fichier dans un dossier local autorisé, accessible par UBC Agent.