Créer un Processus Welcome Action - 7.1

Guide utilisateur de Talend Data Fabric Studio

author
Talend Documentation Team
EnrichVersion
7.1
EnrichProdName
Talend Data Fabric
task
Création et développement
EnrichPlatform
Studio Talend

Comme un Processus Entity Action, un Processus Welcome Action est un Processus créé dans le Studio pouvant être lancé manuellement par un utilisateur métier à partir de Talend MDM Web UI. A la différence du Processus Entity Action, le Processus Welcome Action n'est pas lié à une entité métier spécifique.

Vous pouvez créer ce Processus afin d'effectuer toute tâche que vous souhaitez sur les données maître, par exemple ajouter un nouvel enregistrement/une nouvelle entité dans le hub MDM, lancer un workflow pour effectuer des modifications sur des données maître, lancer un Job pour vérifier ou transformer des données maître, etc. Les Processus Welcome Action et Entity Action peuvent lancer un Job pour retourner un résultat spécifique dans un nouvel onglet de l'interface Web.

Le nom du Processus Welcome Action suit un modèle spécifique : Runnable#[name] ; par exemple Runnable#AddNewRecord or Runnable#LaunchJob.

Avant de commencer

Vous devez être connecté au serveur MDM à partir du Studio Talend. Vous devez avoir l'autorisation appropriée pour créer des Processus. Vous devez déjà avoir créé un Job fournissant l'URL de la variable de sortie "output_variable" et l'avoir déployé sur le serveur MDM.

Pourquoi et quand exécuter cette tâche

Cet exemple vous guide à travers les étapes de la création d'un Processus Welcome Action retournant un résultat dans Talend MDM Web UI. Il appelle un Job fournissant l'URL d'un fichier PDF que vous souhaitez afficher dans l'interface Web. Vous pouvez utiliser le Job pour afficher tout type de contenu, par exemple des documents Word ou PDFs, des images, des sites web, etc.

Créez le Job nommé ProduceURL dans la perspective Integration de votre Studio. Voici un exemple simple d'un tel Job :

Procédure

  1. Configurez le composant tJava en saisissant les commandes que vous souhaitez exécuter.
    Cet exemple génère l'URL d'un PDF.
    Remarque : output_url est la variable de sortie utilisée pour retourner le résultat dans l'interface Web. Vous devez toujours définir cette variable comme variable de sortie dans l'éditeur de Processus, comme expliqué ci-dessous.
  2. Configurez le composant tBufferOutput afin de sauvegarder temporairement l'URL définie dans le tJava et le fournir à la variable de sortie que vous utiliserez lors de la définition du Processus Welcome Action. Déposez la colonne de schéma d'entrée du tJava dans le schéma du tBufferOutput.
  3. Cliquez sur OK pour valider vos changements et fermer la boîte de dialogue.
  4. Sauvegardez votre Job et déployez-le sur le serveur MDM. Pour plus d'informations concernant le déploiement de Jobs, consultez Déployer automatiquement des Jobs sur le serveur MDM.

Que faire ensuite

Pour créer le Processus Welcome Action qui lancera le Job ci-dessus afin d'afficher un PDF dans un nouvel onglet de l'interface Web MDM, procédez comme suit :

  1. Dans la vue MDM Repository, développez Event Management puis cliquez-droit sur Process et sélectionnez New dans le menu contextuel.

    La boîte de dialogue New Process s'ouvre.

  2. Sélectionnez l'option Create an Entity/Welcome Action Process puis cliquez sur Next.

  3. Sélectionnez Create a Welcome Action puis, dans le champ Optional Name, saisissez LaunchJob.

    Cela crée un Processus nommé Runnable#LaunchJob.

  4. Cliquez une fois sur Next pour passer les écrans de l'assistant, pus cliquez sur Finish pour fermer la boîte de dialogue.

    Un éditeur vide pour le nouveau Processus s'ouvre dans l'espace de travail.

  5. Si nécessaire, cliquez sur le bouton ... à côté du champ Description, afin d'ouvrir une boîte de dialogue dans laquelle vous pouvez saisir des descriptions multilingues de votre Processus.

    Cette description sera listée comme le nom du Processus Standalone dans la page Welcome de Talend MDM Web UI. Pour plus d'informations, consultez le Guide utilisateur de Talend MDM Web UI.

  6. Dans le champ Step Description, saisissez un nom pour l'étape que vous souhaitez configurer dans le Processus créé puis cliquez sur l'icône pour ajouter le nom d'étape à la liste qui suit.

  7. Si nécessaire, répétez l'opération pour ajouter une nouvelle étape et effectuer une autre tâche.

Le Processus Welcome Action que vous créez possède une étape déclenchant un Job Talend utilisant le plug-in callJob. Ce plug-in consomme des données en paramètres d'entrée et produit un résultat en paramètres de sortie. Le résultat de cet exemple est l'affichage du contenu d'un PDF dans un nouvel onglet de l'interface Web. Le Processus appelle un Job qui fournit à son tour l'URL du fichier dans une variable output_url.

Vous devez définir les paramètres et les variables d'entrée et de sortie pour les étapes listées, une seule dans cet exemple.

  1. Sélectionnez l'étape afin d'afficher la vue Step Specification dans l'éditeur. Vous pouvez définir les paramètres et les variables d'entrée et de sortie de l'étape.

  2. Dans la liste Plugin name, sélectionnez  callJob.

    Remarque : L'icône affiche une description du plug-in et détaille ses paramètres.
  3. Comme le plug-in callJob est la première étape, laissez la variable d'entrée vide, sélectionnez l'entrée text et cliquez sur le bouton pour les ajouter à la table.

    Le serveur MDM démarre le pipeline avec une variable par défaut appelée _DEFAULT_ .

    Vous souhaitez mapper les variables vers le paramètre d'entrée du plug-in et mapper le paramètre de sortie du plug-in vers une autre variable.

  4. Sélectionnez le paramètre de sortie result et configurez la variable de sortie output_url puis cliquez sur le bouton pour les ajouter à la table.

  5. Dans la zone Parameters, cliquez sur le bouton [...] pour afficher une liste de tous les Jobs Talend ayant été déployés sur le serveur MDM.

  6. Sélectionnez le Job que vous souhaitez attacher au Processus,  ProduceURL dans cet exemple.

    Remarque : Si votre Processus contient plus d'une étape, vous devez définir les variables contenant le résultat de votre première étape. Envoyez ensuite la variable à l'entrée de la seconde étape. Vous pouvez définir un "pipeline" dans lequel chaque résultat d'étape est lié à l'étape suivante via une variable. Pour chaque étape, vous pouvez sélectionner une des variables par défaut ou l'une des variables définies pour le plug-in précédent dans le Processus configuré. Pour plus d'informations concernant un Processus ayant plus d'une étape, consultez Créer un Processus Entity Action.
    Remarque : Vous pouvez désactiver à tout moment l'étape sélectionnée dans l'éditeur si vous cochez la case Disable.
  7. Sauvegardez vos modifications.

    Le Processus Welcome Action s'affiche sous le nœud Process dans la vue MDM Repository.

Le même processus est accessible à partir de Talend MDM Web UI. Un utilisateur métier autorisé peut lancer ce Processus et afficher le résultat depuis la page Welcome dans l'Interface Web. Pour plus d'informations, consultez le Guide utilisateur de Talend MDM Web UI.