Help Center > Foundation Help

S’applique à :

  • Winshuttle Foundation

Utilisation des services Web et des scripts

Dans cette page

Vous pouvez importer des services Web et des scripts Winshuttle Transaction et Winshuttle Query dans votre solution pour activer des fonctions, telles que la vérification d’adresse et d’adresse e-mail, etc.

L’importation d’un service ou d’un script dans votre solution s’effectue principalement en trois étape :

  1. Importation d’un service Web ou d’un script.
  2. Création de mappages de champs pour associer des champs du script à des champs du formulaire.
  3. Modification ou remappage des champs dans le service ou le script.

Remarque : Si vous envisagez d’exécuter des scripts Query via Winshuttle SAP Integration Server 11.x, vous devez avoir installé Winshuttle Function Module.

Liaisons de service Web et types de messages pris en charge

Types de messages pris en charge

Liaisons WSDL prises en charge
  • Message d’entrée
  • Messages de sortie
  • En-têtes d’entrée
  • En-têtes de sortie

Non pris en charge

  • Messages d’erreur
  • base64binary
  • boolean
  • octet
  • date
  • dateTime
  • decimal
  • double
  • int
  • long
  • short
  • chaîne
  • time
  • unsignedbyte

Importation d’un service Web ou d’un script

Retour au début

Pour importer un service Web afin de l’utiliser dans la solution, procédez comme suit :

  1. Cliquez l’onglet Solution.
  2. Dans le volet Solution, cliquez avec le bouton droit sur Services Web, puis cliquez sur Importer.
  3. Dans l’écran Importer, procédez comme suit :
    • Cliquez sur Choisir un fichier pour accéder au fichier WSDL.
    • Sélectionnez Adresse URL, puis saisissez l’adresse URL du fichier WSDL.
    • Si nécessaire, entrez vos données d’identification (Domaine, Nom d’utilisateur, Mot de passe). Cette section s’applique uniquement si vous avez sélectionné Adresse URL (ci-dessous).
  4. Cliquez sur Suivant.
  5. Dans la liste des services, cochez la case du ou des services à importer.
  6. Cliquez sur Suivant, puis reportez-vous à Création d'un mappage de champ(ci-dessous).

Lorsque vous utilisez des groupes répétitifs ou des tables répétitives, tenez compte des points suivants.

Lorsque vous utilisez des élémentsrépétitifs de n’importe quel type (par exemple des groupes répétitifs et/ou des tables répétitives) dans un service Web (ou autre part), tenez compte des points suivants :

  • Un champ dans un dossier de contenu répétitif dans l’arborescence Données de formulaire se trouve également dans le formulaire dans un contenu répétitif.
  • Tous les champs non répétitifs dans l’arborescence Données de formulaire ne sont pas répétitifs dans le formulaire.

Le non-respect des instructions ci-dessus peut entraîner un comportement inattendu lors de l'utilisation d'éléments répétitifs lors de l'exécution d'un service Web..

 

 

Lorsque vous utilisez des groupes répétitifs ou des tables répétitives, tenez compte des points suivants.

Lorsque vous utilisez des élémentsrépétitifs de n’importe quel type (par exemple des groupes répétitifs et/ou des tables répétitives) dans un service Web (ou autre part), tenez compte des points suivants :

  • Un champ dans un dossier de contenu répétitif dans l’arborescence Données de formulaire se trouve également dans le formulaire dans un contenu répétitif.
  • Tous les champs non répétitifs dans l’arborescence Données de formulaire ne sont pas répétitifs dans le formulaire.

Le non-respect des instructions ci-dessus peut entraîner un comportement inattendu lors de l'utilisation d'éléments répétitifs lors de l'exécution d'un service Web..

Création d’un mappage de champs

Retour au début

La procédure suivante explique comment créer un mappage de champs pour un service Web importé.

  1. Dans le volet Solution, cliquez sur Services Web pour le développer.
  2. Cliquez avec le bouton droit sur le service Web, puis cliquez sur Créer un mappage de champ.
  3. Sous Description, saisissez la description du service Web.
  4. Sous Nom du groupe, sélectionnez un groupe dans le menu ou tapez le nom du groupe. Le nom doit commencer par une lettre ou le caractère de soulignement, et il peut contenir uniquement des caractères alphanumériques et des caractères de soulignement. Le nom peut être le nom d’un groupe existant ou un nouveau groupe que vous voulez créer.

    REMARQUE : Si vous sélectionnez un groupe existant avec Utiliser des champs d’entrée/sortie existants, l’importation rechercher les groupes existants dans ce groupe.


    (Voir Utilisation des groupes pour plus d’informations.)
  5. Sélectionnez/Désélectionnez la case Génération d’une section répétitive (le cas échéant).
  6. Sous Nom du mappage, saisissez le nom du service.
  7. Sous Opération, cliquez sur la flèche et sélectionnez une opération dans le menu.
  8. Sous Connexion, choisissez l’un des éléments suivants :
    • Utiliser le compte Windows de connexion (valeur par défaut) pour utiliser le compte connecté.
    • Utiliser le compte défini. Saisissez le domaine, le nom d’utilisateur et le mot de passe du compte.
  9. Cliquez sur Générer pour ouvrir la zone Modification des mappages de champs.
  10. Si vous voulez créer des mappages de champs, cliquez sur Oui dans la boîte de dialogue, puis accédez à Gestion des mappages de champs (ci-dessous), en commençant à l’étape 4. (Autrement, cliquez sur Non pour terminer l’opération.)

     

 

 

 

Modification d’un mappage de champs

Retour au début

Si vous utilisez la même valeur d’entrée dans plusieurs scripts et que vous ne souhaitez pas que le même champ figure plusieurs fois dans le formulaire, vous pouvez changer le mappage des champs.

  1. Cliquez l’onglet Solution.
  2. Dans l’arborescence Solution, développez Scripts Transaction, Scripts Query ou Services Web pour afficher les scripts mappés.
  3. Cliquez avec le bouton droit sur un mappage de script dans l’arborescence Solution, puis cliquez sur Modifier les mappages de champs.
  4. Sous Champ de service Web figure une liste de champs.
  5. Dans la colonne Champ de formulaire, cliquez sur le menu déroulant pour sélectionner le champ auquel vous voulez associer le champ de service Web. Effectuez cette procédure pour chaque champ à associer.
  6. Cliquez sur OK pour terminer.

Important :veillez à ne pas supprimer les champs d’entrée du formulaire. Entrez à la place l’indicateur de saut de champ (le caractère / par défaut) et masquer le champ pour qu’il ne soit pas utilisé. Pour plus d'informations, vous la section Indicateur de saut dans Paramètres d’exécution de Transaction et Paramètres de filtrage du mappeur.

Si vous supprimez le champ, le script charge une champ vide et remplacer la valeur existante.

Remarques :

  • Si vous avez coché Utiliser des champs existants, Composer effectue l’association avec des champs de formulaire qui existent déjà dans le schéma avec le même nom. Dans la liste des champs de formulaire, les champs comportant un astérisque (*) sont les champs qui n’existent pas encore dans le schéma et qui seront créés (que l’option Utiliser des champs existants soit cochée ou non).

    Si cette option n’est pas cochée et qu’un champ n’a pas d’astérisque, Composer génère un nouveau nom de champ unique en utilisant le suffixe « _n » (où n=un nombre).
  • La case Utiliser les données d’identification SAP est cochée si vous effectuez le mappage à un script Winshuttle Query ou Transaction. Cette option inclut les champs Données d’identification SAP dans le mappage et permet de différer l’authentification dans SAP pour la personne qui utilise le formulaire.

 

Dans l’arborescence de solution, vous pouvez cliquer avec le bouton droit sur un champ mappé pour afficher les options de menu.

Ci-dessous : Paramètres de mappage de champs