Applications

Écran des applications

Barre de menu

Liens

Remarques

Nouvelle application

Affiche l’écran d’édition des applications en mode ajout

Rafraîchir

Rafraîchit la liste des applications

Filtres

Filtrer sur *

Remarques

Nom

Filtre par nom d’application

Description

Filtre par description d’application

* Un filtre peut s’appliquer à une partie d’un champ.

Filtres externes

Remarques

Active uniquement

Affiche seulement les applications actives

Formulaire application

Champs

Remarques

Nom

Identifiant unique pour l’application; doit être conforme à la nomenclature et limité à 30 caractères (champ obligatoire)

Description

Description de l’application limitée à 255 caractères (champ obligatoire)

Type

Types d’application possible :

  • Application Web

  • Assembly

  • Client non interactif

  • Procédure Web

  • Procédure Web Asynchrone

  • Service WCF

  • Service Web

  • Webhook entrant

URL

URL relative ou absolue de l’application (champ obligatoire)

WSDL

L’URL de WSDL pour définir un service Web (si nécessaire); voir la section Services Web WSDL pour plus de renseignements sur les services Web avec WSDL.

Nom d’utilisateur *

Nom d’utilisateur utilisé si une authentification est demandée pour accéder à l’URL de l’application

Mot de passe *

Mot de passe utilisé si une authentification est demandée pour accéder à l’URL de l’application

Encodage

Type d’encodage des données utilisé lors du retour de l’application vers WorkflowGen :

  • Par défaut (application/x-www-form-urlencoded)

  • Upload (multipart/form-data)

  • application/xml; charset=UTF-8

Paramètres

Paramètres de l’application (un lien permet d’afficher la fiche d’édition des paramètres)

Application par défaut

L’application est celle par défaut si l’option est sélectionnée

Actif

L’application active si l’option est sélectionnée

Schéma XML

Choisissez le type de Schéma XML entre ADO recordset ou WorkflowGen

Schéma embarqué

Le Schéma sera incorporé au XML si l’option est sélectionnée

* Requis seulement pour les procédures Web et les services Web.

Écran liste des applications

Liste des applications

Colonnes

Remarques

Ordre

Ordre d’affichage de l’application dans la liste

Nom

Nom de l’application (un lien permet d’afficher la fiche d’édition de l’application)

Description

Description de l’application

Actif

L’application est active

Utilisation

Nombre d’actions dans lesquelles l’application est utilisée

Écran liste des paramètres d’une application

Colonnes

Remarques

Nom

Nom du paramètre de l’application

Type de donnée

Type de donnée du paramètre de l’application

Direction

Direction du paramètre de l’application

Obligatoire

Paramètre obligatoire

Par défaut

Paramètre optionnel affiché dans la liste des paramètres des actions en fonction de l’action actuelle

Suppression *

Lien permettant la suppression du paramètre de l’application

* Le lien de suppression est identifié par un x visible uniquement si l'application n'est pas utilisée par une action de processus.

Pour ajouter un paramètre, cliquez sur le lien Paramètres sur l'écran d'édition de l'application, puis cliquez sur Ajouter sur l'écran Liste des paramètres.

Édition des paramètres d’une application

Champs

Remarques

Nom

Nom du paramètre de l’application (champ obligatoire)

Description

Description du paramètre de l’application (champ obligatoire)

Type de donnée

Type de donnée du paramètre de l’application :

  • Texte

  • Numérique

  • Date/Heure

  • Fichier

Direction

Direction du paramètre de l’application :

  • IN : Entrée (Input)

  • OUT : Sortie (Output)

  • INOUT : Entrée/Sortie (Input/Output)

Obligatoire

Le paramètre est-il obligatoire ?

  • Oui (désactive la propriété par défaut)

  • Non (autorise la propriété par défaut)

Défaut

Le paramètre est affiché dans la liste des paramètres de l’action de l’application actuelle si cette option est sélectionnée

Les noms des paramètres des applications devraient respecter les conventions d'appellation XML suivantes :

  • Commencer par une lettre ou par un tiret bas

  • Contenir uniquement des lettres, des chiffres, des traits d'union, des tirets bas et des points

  • Ne pas contenir des espaces

  • Ne pas commencer par les lettres XML dans n'importe quelle casse (p.ex. xml ou Xml)

Pour plus d'informations, voir https://www.w3schools.com/xml/xml_elements.asp.

Suppression d’une application

Une application ne peut pas être supprimée si elle est utilisée dans un processus.

Suppression d’un paramètre

Un paramètre ne peut pas être supprimé si son application est utilisée dans un processus.

Application de type assembly

Ce type d’application vous permet de déclarer une méthode .NET d’une classe comme une application de workflow. C'est la solution la plus rapide pour développer une application de workflow personnalisée (par rapport à des services Web). La performance d'exécution est exceptionnelle car WorkflowGen instancie directement l’assembly sans communication réseau ou d'authentification du service Web.

Exemple

  1. Copiez un assembly .DLL dans le répertoire \wfgen\bin de WorkflowGen.

  2. Dans le module d’administration, cliquez sur Applications, puis Nouvelle application.

  3. Saisissez les informations suivantes :

    • Nom : SAMPLE_GET_STRING

    • Description : Retourne une chaîne de caractères avec ! (point d’exclamation)

    • Type : Assembly

    • Nom ou chemin de l’assembly : WorkflowAppSample

  4. Cliquez sur Enregistrer.

    • Nom de la classe : Sélectionnez la class désirée WorkflowApp.Test

    • Méthode : Sélectionnez la méthode désirée GetString

Les paramètres suivants sont automatiquement générés :

  • IN message (texte)

  • OUT RETURN_VALUE (texte)

Vous pouvez maintenant utiliser votre application de workflow dans vos processus.

Application de type service Web WCF

Ce type d’application vous permet de déclarer un proxy client d’un service Web WCF comme application de workflow.

Exemple

  1. Dans le module d’administration, cliquez sur Applications, puis sur Nouvelle application.

  2. Saisissez les informations suivantes :

    • Nom : WCFSERVICE_SAMPLE_GET_STRING

    • Description : Retourne une chaîne de caractères avec ! (point d’exclamation)

    • Type : Service WCF

    • Nom ou chemin de l’assembly : WorkflowAppWCFSampleTest

  3. Cliquez sur Enregistrer.

    • Nom de la classe : Sélectionnez la classe désirée workflowAppWCFSampleTest.ServiceClient

    • Méthode : Sélectionnez la méthode désirée GetString

Les paramètres suivants sont automatiquement générés :

  • IN message (texte)

  • OUT RETURN_VALUE (texte)

Vous pouvez maintenant utiliser votre application de workflow dans vos processus.

Nom : WCFSERVICE_SAMPLE_GET_STRING

Services Web WSDL

Aperçu

WorkflowGen supporte les Web Services basés sur le standard SOAP. Les Web Services peuvent s’intégrer avec WorkflowGen sans programmation et être utilisés par des actions de processus. Vous pouvez prédéfinir des services web et les références en utilisant leurs fichiers WSDL (Web Services Description Language).

Il est nécessaire d’avoir un URL qui pointe au fichier de définition WSDL pour que les méthodes web se rendent disponibles à WorkflowGen. Suite à l’ajout du WSDL (dans le répertoire d’application WorkflowGen), la sélection d’un service web sera disponible, et les paramètres de l’application WorkflowGen sont générés automatiquement.

Les types de données des paramètres sont associés aux types des données WorkflowGen correspondants (numérique, texte, datetime, fichier). Tous les types XML complexes sont associés à une donnée de type fichier.

Services Web publics

Les services de Web publics sont disponibles pour consomption publique. Pour voir un exemple WorkflowGen, suivez l'exemple ci-dessous.

Créer un service Web WSDL

  1. Dans le module d’administration, créez une nouvelle application et définissez ce qui suit :

    • Nom

    • Description

    • Type : Service Web

    • Nom d’utilisateur : [un administrateur valide de WorkflowGen]

    • Mot de passe : [le mot de passe valide pour le nom d’utilisateur]

  2. Définissez un URL service Web valide et son WSDL associé, et sauvez l’application.

    📌 Exemple d'URL :

    http://quickstarts.asp.net/QuickStartv20/webservices/Samples/MathService/vb/Server/MathService.asmx

    📌 Exemple de WSDL :

    http://quickstarts.asp.net/QuickStartv20/webservices/Samples/MathService/vb/Server/MathService.asmx?WSDL
  3. Choisissez la méthode à employer. Le WSDL définit quelles méthodes sont disponibles. Suite à la sélection d’une méthode Web, les paramètres associés seront automatiquement associés et l'application pourra être employée par les actions de processus.

Exemple d’un service Web privé

Aperçu

Les services de Web privés sont des services de Web qui ne sont pas disponibles pour être réutilisés au public. Ils emploient généralement un URL qui exige de l'authentification interne à votre organisation. Pour voir un exemple WorkflowGen, suivez l'exemple ci-dessous.

Créer un service Web WSDL

  1. Dans le module d’administration, créez une nouvelle application et définir ce qui suit :

    • Nom

    • Description

    • Type : Service Web

    • Nom d’utilisateur : [un administrateur valide de WorkflowGen]

    • Mot de passe : [le mot de passe valide pour le nom d’utilisateur]

  2. Définissez un URL Web Service valide et son WSDL associé et sauvegardez l'application. L'exemple ci-dessous décrit l'utilisation d'un service Web situé sur un site Web 2007 de SharePoint. Dans cet exemple, le Web Service s'appelle lists.asmx. Pour plus d'information, référez-vous à https://msdn.microsoft.com/fr-fr/library/ms445760.aspx.

    📌 Exemple d'URL :

    http://myspsserver/_vti_bin/lists.asmx

    📌 Exemple de WSDL :

    http://myspsserver/_vti_bin/lists.asmx?WSDL
  3. Choisissez la méthode à employer. Le WSDL définit quelles méthodes sont disponibles. Suite à la sélection d’une méthode Web, les paramètres associés seront automatiquement associés et l'application pourra être employée par les actions de processus.

Action de service Web de WSDL : paramètres supplémentaires

Aperçu

WorkflowGen créera quelques paramètres supplémentaires en mettant en référence un WSDL. Ces autres paramètres peuvent être employés en plus de ceux déjà définis dans le dossier de WSDL.

Paramètres supplémentaires

Les autres paramètres qui sont définis par WorkflowGen sont les suivants :

  • RETURN_VALUE : Si le service Web renvoie une valeur, WorkflowGen ajoutera automatiquement un paramètre OUT.

  • WFG_WS_URL : Spécifie un URL de service Web pour outrepasser l'URL prédéfini.

  • WFG_WS_USERNAME : Spécifie un nom d’utilisateur pour outrepasser le nom d’utilisateur prédéfini.

  • WFG_WS_PASSWORD : Spécifie un mot de passe pour outrepasser le mot de passe prédéfini.

Dernière mise à jour