À quoi sert le bouton
Un bouton de lancement permet à un utilisateur d’exécuter un flux UBC Data Bridge préparé sans ouvrir le concepteur. Il peut être placé à côté d’un rapport ou d’un formulaire de travail sur un site HTTPS autorisé. Un clic démarre la séquence définie par l’auteur : acquisition des données, saisie des paramètres, validation, transformation et transmission du résultat.
Un exemple de libellé est « Actualiser le rapport de gestion ». Le libellé explique le résultat de l’action. D’autres exemples sont « Envoyer le budget approuvé », « Actualiser les prévisions de ventes » et « Charger les données du service ».
Le bouton appelle un flux Data Bridge. Si celui-ci contient une destination TurboIntegrator, il peut aussi exécuter un processus IBM. Pour un livre PAW, consultez le guide distinct d’IBM Planning Analytics Workspace.
Fonctionnalités et scénarios
| Fonctionnalité | Rôle |
|---|---|
| Lancement depuis une page de travail | Actualiser un rapport ou transférer des données depuis l’endroit où l’utilisateur analyse le résultat. |
| Un bouton — un flux | Un libellé explicite, des autorisations définies et un scénario d’exécution contrôlé. |
| État sur le bouton | Un indicateur, une barre de progression lorsque l’information est disponible et une infobulle explicative. |
| Assistant interactif | Fichier, paramètres, aperçu des données, choix et messages selon les blocs du flux. |
| Exécution sans formulaire | Un flux avec des valeurs prédéfinies s’exécute sans fenêtre supplémentaire après l’authentification éventuellement nécessaire. |
| Gestion centralisée | L’administrateur définit le libellé, l’apparence, les sites autorisés et les utilisateurs. |
Ouvrir une page contenant le bouton ne démarre rien à lui seul. Le journal complet et le résultat d’exécution sont conservés dans Data Bridge.
Configuration dans Data Bridge
- Préparez le flux et vérifiez les sources, les destinations et les étapes interactives. Publiez une version Production validée pour l’exploitation.
- Connectez-vous en tant qu’administrateur et ouvrez, pour le flux voulu, « Bouton Workspace ». Ce nom de commande s’applique aussi aux autres sites autorisés.
- Sélectionnez « Activer le bouton de ce flux ». Dans « Libellé du bouton », saisissez « Actualiser le rapport de gestion ».
- Dans « Adresses Workspace autorisées », ajoutez l’adresse du site conteneur : protocole, serveur et port. Exemples :
https://portal.example.comouhttps://portal.example.com:8443. Une adresse par ligne, sans chemin de page, paramètres d’URL ni*. - Choisissez « Administrateurs et utilisateurs sélectionnés » ou « Toute personne autorisée à exécuter ce flux ». Dans le premier mode, ajoutez les utilisateurs nécessaires. Une liste vide réserve l’accès aux administrateurs.
- Configurez l’apparence, vérifiez l’aperçu puis cliquez sur « Enregistrer les paramètres ».
- Cliquez sur « Copier l’adresse ». Intégrez l’adresse générée du bouton lui-même.
La structure habituelle de l’adresse est https://bridge.example.com/embed/flows/…; en cas d’installation dans un sous-répertoire, celui-ci figure dans l’URL. Le domaine de l’exemple est illustratif : copiez l’adresse complète depuis votre installation.
Intégration par un lien
Sur l’autre site, ajoutez un composant « Page web », « Contenu intégré » ou iframe et insérez l’URL du bouton. Commencez par 280 × 44 px. Il s’agit de la taille du bouton sur la page, pas de celle de l’assistant.
<iframe
src="СКОПІЙОВАНА_HTTPS_АДРЕСА_КНОПКИ"
title="Оновити управлінський звіт"
width="280" height="44"
style="border:0">
</iframe>Remplacez l’espace réservé dans src par l’adresse des paramètres Data Bridge. Le site conteneur doit autoriser ce contenu intégré et la fenêtre de lancement. Si la plateforme restreint les iframes, convenez des autorisations nécessaires avec son administrateur.
Un lien hypertexte ordinaire ouvre une page contenant le bouton. Pour afficher son état à côté d’un rapport, utilisez un composant web intégré. L’adresse ne contient aucun mot de passe et ne donne pas, à elle seule, le droit d’exécuter le flux.
États et indicateurs
Le libellé principal reste visible pendant une exécution ordinaire. L’état est indiqué par une icône, une barre de progression et une infobulle au survol. Un contour bleu de focus indique la sélection du bouton, pas la réussite de l’exécution.
| État | Apparence et signification | Action de l’utilisateur |
|---|---|---|
| Prêt | Libellé personnalisé sans indicateur. | Cliquez une seule fois pour démarrer. |
| Connexion / démarrage / « En file d’attente » | Indicateur animé et barre mobile : authentification, préparation ou attente d’un exécuteur. | Attendez le formulaire requis ou le début du traitement. Aucune écriture n’est encore confirmée. |
| « En cours » | Indicateur animé ; progression lorsqu’un pourcentage est disponible. Une barre mobile sans pourcentage indique une durée inconnue. | Surveillez l’état. |
| « En attente d’une action utilisateur » | Pause et barre jaunes. Un fichier, des paramètres, un choix ou une confirmation sont nécessaires. | Effectuez l’étape de l’assistant ; un clic rouvre la fenêtre actuelle. |
| « Réussi » | Coche verte ✓ pendant environ 8 secondes, puis retour à l’état prêt. | Vérifiez le résultat métier. |
| « Échec » | Point d’exclamation rouge ! et bordure rouge. | Lisez l’infobulle et le journal, puis corrigez la cause avant de réessayer. |
| « Résultat partiel » | Point d’exclamation rouge ! ; l’infobulle précise l’état exact. Certaines actions sont confirmées. | Commencez par rapprocher les actions déjà réalisées. |
| « Rapprochement nécessaire » | Point d’exclamation rouge ! ; le système cible n’a pas fourni de confirmation sans ambiguïté. | Vérifiez son état avant une nouvelle exécution. |
| « Arrêté » | Le bouton est de nouveau prêt. L’exécution suivante recommence depuis le début. | Tenez compte des actions externes confirmées : l’arrêt ne les annule pas. |
Une brève coupure de connexion peut afficher un indicateur animé et un message de reconnexion automatique dans l’infobulle. Des problèmes de service peuvent remplacer temporairement le libellé par « Autoriser les fenêtres surgissantes », « Échec du lancement », « Déconnecté » ou « Bouton indisponible ». Consultez les détails dans le journal d’exécution.
Quel assistant peut s’ouvrir
L’assistant affiche les étapes configurées par l’auteur du flux. Leur ordre dépend des liens et de la branche active. Aucun formulaire universel n’est ajouté avant chaque exécution.
| Étape | Ce que voit l’utilisateur | Configuration du flux |
|---|---|---|
| Mise à jour de fichier | Sélectionnez ou faites glisser un fichier ; consultez son format, les règles de lecture et le résultat de validation. | Un bloc « Fichier » provenant du gestionnaire de fichiers → « Demander un fichier actualisé à l’utilisateur ». |
| Paramètres d’exécution | Période, scénario, service, texte, nombres, interrupteurs ou éléments de dimension. | « Paramètres d’exécution » → afficher dans l’assistant ou une boîte de dialogue distincte. |
| Aperçu des données | Une table pour vérifier les lignes et les champs. | Un bloc d’aperçu des données affiché dans l’assistant. |
| Sélection de l’itinéraire | Un choix de continuation qui détermine la branche active. | Un bloc Choix et les transitions configurées. |
| Message | Une explication, un résultat de validation ou un avertissement. | Un bloc Message et son mode d’affichage. |
| Enregistrer le résultat | Récupérer le fichier généré sur l’ordinateur. | Une destination de fichier configurée pour l’usage approprié. |
Exécution du flux
Importez une nouvelle version de Management reporting.xlsx. Cet exemple utilise la plage nommée « ReportData ».
Lors de l’actualisation d’un fichier lié, la version enregistrée ne remplace pas le nouveau fichier demandé. « Continuer » devient disponible après le chargement et une lecture réussie. En exécution opérationnelle, le fichier confirmé est enregistré comme nouvelle version sous le nom de l’objet du gestionnaire de fichiers, même si son nom local diffère. La simulation et la validation n’enregistrent pas de nouvelle version.
Pour un nouveau flux, utilisez le bloc actuel « Fichier » . L’ancien bloc distinct de sélection de fichier reste disponible pour la compatibilité avec les flux existants. Pour les paramètres d’exécution, l’auteur peut modifier les libellés et la disponibilité des boutons, les dimensions et le titre de la boîte de dialogue distincte.
Authentification, fenêtres et clics répétés
En l’absence de session valide, la connexion à Data Bridge s’ouvre. Sur un autre domaine, les formulaires interactifs apparaissent dans une fenêtre de navigateur distincte : autorisez-la pour l’adresse Data Bridge. Si la page conteneur et Data Bridge partagent le protocole, le domaine et le port, le formulaire peut s’afficher par-dessus la page.
Si la fenêtre est déjà ouverte, un nouveau clic y ramène. Pour votre propre exécution active sans formulaire, un clic supplémentaire ne crée pas de seconde exécution simultanée. Fermer l’assistant actif, de quelque manière que ce soit, arrête cette exécution. Le lancement suivant recommence au début sans annuler les actions externes confirmées.
Les messages définis par le flux peuvent apparaître dans une fenêtre ou dans la zone du bouton. Un flux sans étapes visibles s’exécute sans formulaire supplémentaire et sans ouverture automatique du journal.
Autorisations et limites de l’intégration
L’utilisateur doit être autorisé à exécuter le flux dans Data Bridge et respecter la règle d’accès du bouton. L’accès au site externe ne remplace pas ces autorisations. IBM exige également les autorisations appropriées pour le compte de connexion TM1.
Modifier les adresses autorisées ou la liste des utilisateurs, ou désactiver le bouton, révoque ses autorisations actives et arrête les exécutions inachevées. Les changements de libellé et d’apparence ne nécessitent pas de nouvelle connexion ; la nouvelle apparence est chargée lors de l’actualisation de la page conteneur.
Les filtres et valeurs sélectionnées sur un site tiers ne sont pas transmis automatiquement au flux. Définissez-les dans le formulaire des paramètres ou dans le flux lui-même. Après l’écriture, actualisez le rapport s’il affiche encore d’anciennes données.