Objets & métadonnées ELO

Objectif et utilisation

Le composant objets & métadonnées ELO vous proposent des fonctions de base qui vous permettront de communiquer avec une archive ELO.

Données d'accès et de connexion

Enregistrez les données de connexion pour le composant Objets ELO & métadonnées. Une connexion par défaut est disponible. Celle-ci est saisie dans les fichiers de configuration. Le contexte utilisateur utilise la session de l'utilisateur authentifié dans le client ELO. Par ailleurs, vous pouvez créer de nouvelles connexions pour exécuter les services avec des droits définis.

Déclencheurs

Les déclencheurs sont les points de départ d'un flow. Le composant Objets et métadonnées ELO propose les déclencheurs suivants :

Nom	Evénement	Informations complémentaires
Déclencheur de requête avec résultat générique	Est démarré lorsque le point final est lancé via un POST-HTTP.	Flow synchrone
Déclencheur de requête avec résultat générique (multi-instances)	Est démarré en tant que déclencheur multi-instances lorsque le point final est lancé par un HTTP-POST.	Flow synchrone
Liste de mots-clés dynamique lancée	Le déclencheur peut être démarré avec les métadonnées ELO de la première et de la deuxième génération. Métadonnées (1ère génération) Dans le Créateur de formulaires ou dans les Modèles de champ, enregistrez des listes de mots-clés avec un appel de flows. Métadonnées (2ème génération) Dans les aspects, enregistrez des listes de mots-clés avec un appel de flows.	Flow synchrone
Objet créé	Est démarré lorsqu'un objet a été déposé dans ELO.	Flow asynchrone
Objet modifié	Est démarré lorsqu'un objet a été modifié dans ELO (métadonnées, versions).	Flow asynchrone
Objet supprimé	Est démarré lorsqu'un objet a été modifié dans ELO (métadonnées, versions).	Flow asynchrone
Objet déplacé	Est démarré lorsqu'un objet a été modifié dans ELO (métadonnées, versions).	Flow asynchrone

Configuration du déclencheur 'Déclencheur de requête avec résultat générique'

Vous pouvez déterminer les données de configuration ou un appel REST, ou bien ne pas faire de transfert de données de configuration. Pour ceci, n'effectuez pas de configuration supplémentaire dans l'onglet Réglages.

Réglages supplémentaires

Option : enregistrez les données de configuration statiques via la méthode de saisie Positions, par exemple données de saisie provenant d'un système tiers. Dans la liste Key Value, entrez vos données personnalisées. La clé (1) est un champ obligatoire, l'indication de la valeur (2) est en option.

Exemple d'entrée

Clé - user

Valeur - renz

Suite de la procédure pour le déclencheur 'Déclencheur de requête avec résultat générique'

Ce déclencheur est démarré lorsque le point final est lancé via un POST-HTTP. Le point final peut être lancé sous Résumé > Service.

Configuration de déclencheur 'Liste de mots-clé dynamique'

Lancez des listes de mots-clés dynamiques avec un appel de flows. Le déclencheur peut démarrer dans le contexte des métadonnées de la première et de la seconde génération. Le lancement suit le schéma flows-plugin/trigger/Trigger-ID et peut ressembler à ceci : flows-plugin/trigger/08e40e34-2e3e-4725-baed-1442d1e25143.

Pour les métadonnées de la première génération, les données de saisie ne sont pas automatiquement transmises de manière formatées. Si nécessaire, vous pouvez configurer le formatage dans l'onglet Réglages. Les métadonnées de la seconde génération livrent automatiquement les formatages.

Enregistrer l'appel flows pour les listes de mots-clés dynamiques

Pour pouvoir lancer des listes de mots-clés asynchrones avec flows, l'appel de ELO Flows doit être enregistré dans les métadonnées ELO. Vous trouverez ci-dessous plus d'informations au sujet de la procédure avec les métadonnées de la première et de la seconde génération.

Métadonnées (1ème génération)

Le déclencheur est démarré lorsque les listes de mots-clés dynamiques (1ère génération) sont enregistrées avec un lancement de ELO Flows dans le créateur de formulaires ou dans les Modèles de champ (1ère génération).

Vous pouvez lire l'ID du déclencheur dans le créateur de flows du déclencheur sous Résumé > Propriétés > ID.

Enregistrement dans le créateur de formulaires :

1. Veuillez sélectionner un champ.
2. Ouvrez les propriétés du champ sélectionné.
3. Sous Liste de mots-clés, sélectionnez l'option Dynamic Keyword Map.
4. Dans le champ d'entrée Nom de script, entrez le lancement selon le schéma flows-plugin/trigger/Trigger-ID.

Enregistrement dans les modèles de champ :

1. Veuillez sélectionner un champ.
2. Ajoutez l'appel sous Liste de mots-clés > Liste de mots-clés dynamique.

Métadonnées (2ème génération)

Le déclencheur est démarré lorsque les listes de mots-clés dynamiques (1ère génération) sont enregistrées avec un lancement de flows dans un champ d'aspects.

1. Naviguez vers Aspects dans votre package.
2. Sélectionnez un aspect ou ajoutez un nouvel aspect.
3. Naviguez dans la section Champs dans l'aspect.
4. Sélectionnez un champ ou ajoutez un nouveau champ. Les réglages du champ sont ouverts.
5. En tant que type de champ, sélectionnez Texte général.
6. Dans le champ d'entrée Liste de mots-clés dynamique, entrez le lancement selon le schéma flows-plugin/trigger/Trigger-ID.

Réglages supplémentaires

Option : formatage manuelle des données d'entrées pour les métadonnées de la première génération.

1 Type de saisie : sélectionnez un type de saisie via le menu déroulant. Vous avez le choix : Integer, Number, Date, Datetime.

2 Nom de champ : entrez le nom de champ avec liste de mots-clés dynamique dans le contexte des formulaires avec des métadonnées de la première génération.

Exemple d'entrée

Type d'entrée - Date

Nom de champ - Date de dépôt

Procédure ultérieure pour le déclencheur 'Liste de mots-clé dynamique lancée'

A la fin du flow, entrez le résultat SimpleDynKwlColumnsResult ou DynKwlColumnsResult sous retour synchrone.

Définition de résultat sous 'SimpleDynKwlColumnsResult'

Configurez le résultat d'objet manuellement avec les propriétés d'objet suivantes :

1 Titre du tableau : le champ Titre du tableau est un champ obligatoire. Entrez le titre du tableau de résultat généré.

2 Retour s'il n'y a pas de données : entrez un texte qui doit être affiché en tant que message lorsque le tableau ne contient pas de données.

3 Colonnes : ouvrez la configuration avancée des colonnes via le symbole +.

Information

La configuration manuelle de colonnes individuelles du tableau de résultat est une option. Si vous souhaitez procéder de cette manière, les champs Titre de la colonne, nom du champ de formulaire et Type de colonne sont obligatoires.

4 Titre de la colonne : entrez un titre d'affichage du titre. Si vous ne souhaitez pas faire afficher de titre de colonne, entrez null.

5 Nom du champ de formulaire : entrez le nom du champ de formulaire dans lequel les donnés doivent être transmises. Si vous ne souhaitez pas transmettre les données de cette colonne dans un champ de formulaires, entrez null.

6 Type de colonne : entrez le type de données de la colonne. TEXT est entré par défaut. En alternative, vous pouvez également entrer INTEGER, NUMBER, DATE ou DATETIME.

7 Données de colonne : configurez une transformation de liste individuelle.

Information

La configuration manuelle de la transformation de listes est une option. Si oui, le champ Contexte est obligatoire.

8 Contexte : entrez le contexte de données de la transformation, par exemple concernant les dernières Etapes dans votre flow.

9 string : entrez la valeur que vous souhaitez sélectionner.

Information

Si vous souhaitez effectuer un enchainement pour la transformation de liste, l'entrée doit se faire via l'éditeur des flows JSONata. Vous trouverez d'autres informations à ce sujet dans le paragraphe Problèmes connus > enchainement dans les champs de transformation.

• Exemple de saisie
  • Titre du tableau - Liste utilisateurs
  • Retour s'il n'y a pas de données - Pas d'utilisateurs
  • Titre de la colonne - Nom utilisateur
  • Nom du champ de formulaire - PERSON.PERSONAL_DATA
  • Type de colonne - TEXT
  • Transformation : transformer List<Person> en liste de noms List<String>.
  • Contexte - stepBefore.persons
  • string - $.name

Définition du résultat via 'DynKwlColumnsResult'

La définition de résultat via DynKwlColumnsResult met à disposition des possibilités de configuration avancées. Dans la configuration des colonnes, vous avez le choix entre les modes Entrée libre, Position et Transformation de liste.

Méthode d'entrée 'Entrée libre'

Pour la méthode de saisie Entrée libre, vous pouvez configurer les colonnes individuelles sous forme de commandes JSONata. Pour ceci, utilisez l'éditeur JSONata pour le champ Colonnes.

Exemple de saisie

//Exemple de variation statique de l'entrée libre
[{
    "title": "Colonne",
    "formFieldName": "Champ1",
    "columnType": "TEXTE",
    "data": [
        "Colonne1-Ligne1",
        "Colonne1-Ligne2"
    ]
},
{
    "title": "Colonne2",
    "formFieldName": "Champ2",
    "columnType": "TEXTE",
    "data": [
        "Colonne2-Ligne1",
        "Colonne2-Ligne2"
    ]
}]

Méthode de saisie 'Positions'

Information

Le mode Positions correspond aux possibilités de réglage de la définition de résultat via SimpleDynKwlColumnsResult.

Au sein des données de colonne, vous pouvez définir les données de colonne via les positions, en plus du titre de la colonne, du nom du champ de formulaire et du type de colonne. Comme méthode d'entrée, sélectionnez également Positions, et entrez une valeur fixe dans le champ de string. Vous pouvez par exemple sélectionner des propositions préconfigurées via le symbole de la flèche à la fin du champ.

Méthode de saisie 'Transformation de liste'

La méthode de saisie Transformation de liste mise sur la transformation de données de liste provenant d'étapes précédentes du flow.

1 Contexte : définissez le contexte auquel se réfère la transformation, par exemple une étape précédente dans le flow.

2 Titre de la colonne : entrez le titre de la colonne dans laquelle doivent s'afficher les données de la liste transformée.

3 Nom du champ de formulaire : entrez le nom du champ de formulaire dans lequel les donnés doivent être transmises. Si vous ne souhaitez pas transmettre les données de cette colonne dans un champ de formulaires, entrez null.

4 Type de colonne : entrez le type de données de la colonne. TEXT est entré par défaut. En alternative, vous pouvez également entrer INTEGER, NUMBER, DATE ou DATETIME.

5 Méthode de saisie Données de colonne : pour affiner la configuration, vous avez le choix entre les méthodes de saisie positions, entrée libre et transformation de liste.

Information

La configuration complémentaire de la transformation de liste est en option. Si oui, le champ Contexte est obligatoire.

6 Contexte : entrez le contexte de données de la transformation, par exemple concernant les dernières Etapes dans votre flow.

7 string : entrez la valeur que vous souhaitez sélectionner.

Configuration de déclencheur 'Objet créé', 'Objet modifié', 'Objet supprimé', 'Objet déplacé'

Les déclencheurs avec relations aux objets sont démarrés lorsqu'une modification est effectuée pour un objet ELO (SORD).

En option : vous pouvez limiter le déclencheur à des masques et champs de données spécifiques qui sont dans le contexte de l'objet créé.

Information

Vous pouvez communiquer avec les métadonnées ELO de la première et de la seconde génération. Vous trouverez d'autres informations au sujet des métadonnées ELO sous Informations générales > Communiquer avec les métadonnées de la première et de la seconde génération.

1 Masque : entrez le masque de métadonnées qui réagit au déclencheur. Le déclencheur n'est démarré que pour ce masque.

2 Prendre en compte les enfants des masques : activez cette fonction lorsque l'automatisation doit également être démarrée lorsqu'un SORD possède un masque qui hérite d'un des masques indiqués.

3 Surveillance de champs : activez la surveillance de champs si le déclencheur ne doit être démarré que dans le contexte de certains champs de métadonnées.

4 Mode de vérification : sélectionnez entre le mode de vérification Le champ correspond à une valeur de comparaison et Le champ a été modifié.

• Feld entspricht einem Vergleichswert - Löst den Flow aus, wenn ein bestimmter Wert gesetzt ist.
• Le champ a été modifié - ne déclenche le flow que lorsqu'un champ précis a été modifié.

5 Nom de champ : entrez le champ de données qui doit être surveillé.

6 Valeur de champ : si vous avez sélectionné Le champ correspond à une valeur de champ, entrez la valeur qui doit être vérifiée.

Exemple d'entrée

Masque : Facture (masque de la 1ère génération) ou BASIC.PERSON (masque de la 2ème génération)

Mode de vérification : - Le champ correspond à une valeur de comparaison

Nom de champ : INVOICE_NO (champ d'indexation) ou INVOICE_POSITION.STATUS (champ d'aspect)

Valeur du champ : 12345

Procédure à suivre

Le déclencheur Objet créé est un flow asynchrone, c'est pourquoi vous ne devez pas configurer de noeud de clôture.

Services

Les services sont des actions qui peuvent être exécutées dans un flow. Le composant Objets et métadonnées ELO propose les services suivants :

Groupe 'Aspects'

Nom	Fonction
Actualiser les jeux de données en fonction de l'ID	Actualisez des entrées spécifiques en fonction de l'ID (aspect multiple)
Actualiser les jeux de données	Actualiser les entrées existantes (aspect multiple)
Ajouter les jeux de données	Ajoutez de nouvelles entrées (aspect multiple)
Supprimer les jeux de données	Supprimez des entrées spécifiques (aspect multiple)
Rechercher les jeux de données	Parcourez les entrées (aspect multiple)

Information

Vous trouverez plus d'informations au sujet des aspect pouvant être créés plusieurs fois, consultez la documentation Packages ELO > Métadonnées > Masques > Assigner les aspects (opens new window)

Groupe 'Autorisations'

Nom	Fonction
Supprimer toutes les autorisations	Supprime toutes les entrées d'autorisations d'un objet
Supprimer les autorisations	Supprime les autorisations d'un objet
Ajouter des autorisations	Ajoute des autorisations à un objet

Groupe 'documents'

Nom	Fonction
Télécharger la version de travail	Télécharge la version d'un objet et la met à disposition dans les flows.
Télécharger la version de document	Charge un fichier de flows dans un objet, en tant que version de document

Groupe 'Liens'

Nom	Fonction
Créer un lien ECD	Crée un nouveau lien ELO sur la base de l'ID d'objet d'un document.
Créer un lien externe	Crée un nouveau lien externe sur la base de l'ID d'objet d'un document

Groupe 'Métadonnées'

Nom	Fonction
Modifier la couleur	Définit la couleur d'un objet
Chargement des métadonnées	Lit les métadonnées d'un objet et les met à disposition dans le flow
Télécharger les métadonnées (1ère génération)	Lit les métadonnées (1ère génération) d'un objet et les met à disposition dans le flow
Modifier le masque	Définit le masque d'un objet
Modifier le masque (1ère génération)	Définit le masque (1ère génération) d'un objet
Définir les métadonnées	Assigne des métadonnées définies à un objet
Définir les métadonnées (1ère génération)	Assigne des métadonnées (1ère génération) définies à un objet

Groupe 'Nouveau'

Nom	Fonction
Nouveaux documents	Crée plusieurs nouveaux documents
Nouveaux documents (1ère génération)	Crée plusieurs nouveaux documents (1ère génération)
Nouveau document	Dépose un nouveau document dans l'archive
Nouveau document (1ère génération)	Dépose un nouveau document (1ère génération) dans l'archive
Nouveau classeur	Dépose un nouveau classeur dans l'archive
Nouveau classeur (1ère génération)	Dépose un nouveau classeur (1ère génération) dans l'archive

Groupe 'Administrer'

Nom	Fonction
Supprimer toutes les références	Supprime toutes les références d'un objet
Copier	Copie un objet ELO et dépose la copie
Supprimer	Supprime un objet ELO
Déplacer	Déplace une entrée dans l'archive
Créer une référence	Crée une référence d'un objet ELO dans l'archive

Groupe 'Métadonnées supplémentaires'

Nom	Fonction
Charger les champs de mappage sous forme de liste	Charge les champs de mappage d'un objet ELO sous forme de liste
Charger les champs de mappage	Charge les champs de mappage d'un objet et les met à disposition dans les flows
Ecrire les champs de mappage	Ecrit les valeurs dans les champs de mappage d'un objet

Sans assignation de groupe

Nom	Fonction
Charger le fichier de configuration	Charge un fichier de configuration depuis l'archive ELO

Transfert d'enregistrements de champs d'aspects individuels ou d'aspects complets

Vous pouvez transmettre certains champs d'aspects de manière ciblée ou des aspects complets de masques existants à d'autres masques.

1 Assignations d'aspect : utilisez cette fonction pour transférer des valeurs de champs d'aspect de manière ciblée d'un masque à un autre.

2 Prise en charge du jeu de données : utilisez cette fonction pour transférer des aspects complets d'un masque à un autre. Vous pouvez prendre en charge tous ces jeux de données d'étapes préliminaires directement dans les aspects du SORD actuel.

La prise en charge de données d'aspect est possible pour les services suivants :

• Définir les métadonnées
• Nouveaux documents
• Nouveau classeur
• Nouveau document