Préparation de la récupération de l’entrée des services Web SOAP
- Découvrez les exigences de communication avec le service Web SOAP pour l’application
:
- Les valeurs d’authentification avec l’application
- Les valeurs de demande de données au service Web SOAP
- Le format des données fournies dans la réponse
Reportez-vous à documentation de l’application ou consultez l’entreprise qui l’héberge.
- Pour préparer RICOH ProcessDirector à communiquer avec l’application, procédez comme suit :
- Si l’application nécessite un certificat de sécurité, installez-le sur l’ordinateur principal RICOH ProcessDirector.
- Si votre environnement exige un serveur proxy pour communiquer avec les services Web, configurez le système afin de l’utiliser.
- Importez des fichiers WSDL pour tous les services Web que vous comptez appeler.
RICOH ProcessDirector Crée des objets requêtes SOAP à partir des opérations SOAP du fichier WSDL. Vous spécifiez un préfixe que RICOH ProcessDirector ajoute aux noms des opérations SOAP lors de la création des objets. Un objet requête SOAP permet à RICOH ProcessDirector de déterminer la version de SOAP et d’autres informations nécessaires pour effectuer un appel correct du service Web.
Pour plus d'informations, consultez les tâches connexes.
- Exécutez un test manuel qui effectue une authentification avec l’application et demande
une réponse du service Web SOAP. Assurez-vous que le service Web renvoie la réponse
désirée.De nombreux navigateurs disposent de plug-ins, comme Boomerang pour Google Chrome, qui testent les appels du service Web aux clients SOAP.
- Décidez comment vous souhaitez que l’unité d'entrée du service Web SOAP crée les travaux
à partir des données de la réponse renvoyée par le service Web.
- Chaque fois que l'unité d'entrée reçoit une réponse, elle peut créer un travail contenant toutes les données XML dans la réponse.
- L'unité d'entrée peut examiner la réponse à l’aide d’une expression XPath.
Si l'unité d'entrée trouve des éléments XML spécifiés par l'expression, elle crée un travail pour chaque élément ou objet correspondant. Chaque travail contient l’élément correspondant et tous les éléments qui y sont imbriqués. Si l'unité d'entrée trouve plusieurs éléments, elle peut créer des travaux indépendants ou des travaux enfants.
Si l'unité d'entrée ne trouve aucun élément correspondant, elle ne crée par de travail.
- Définissez une unité d'entrée du service Web SOAP :
- Cliquez sur l'onglet Administration.
- Dans la sous-fenêtre de gauche, cliquez sur .
- Cliquez sur .
- Dans l'onglet Général :
- Indiquez un nom pour l’unité d’entrée.
- Définissez la valeur de la propriété Intervalle d’interrogation sur la durée pendant laquelle vous souhaitez que l'unité d'entrée attende entre les appels du service Web.
- Après avoir défini un flot de travaux pour traiter les travaux XML, définissez la valeur de la propriété Flot de travaux enfant sur le nom de ce flot de travaux.
- Entrez des valeurs pour les autres propriétés à définir.
- Dans l’onglet Requête :
- Définissez la valeur de la propriété URL de la requête sur l’URL du service Web qui renvoie les données que RICOH ProcessDirector utilise pour créer un ou plusieurs travaux.
- Pour la valeur de la propriété Charge de la requête, spécifiez le corps de la requête de services Web que l'unité d'entrée soumet à l’application.Pour spécifier une marque d’accréditation et une plage de temps qui correspond à la valeur de la propriété Intervalle d’interrogation, utilisez des symboles pour ces propriétés :
Nom de base de données de la propriété Nom d'interface utilisateur de la propriété Remarques WebService.Credential Néant RICOH ProcessDirector Stocke la marque d’accréditation du service Web dans cette propriété. WebService.CurrentRequestTime Néant RICOH ProcessDirector définit la valeur de cette propriété sur le début de l’intervalle d’interrogation. WebService.LastSuccessRequestTime Onglet Statut : Heure de la dernière requête réussie Lorsque l'unité d'entrée communique avec succès avec l’application, RICOH ProcessDirector définit la valeur de cette propriété sur la valeur de la propriété WebService.CurrentRequestTime. Une communication réussie se traduit par un code de réponse 200, même si RICOH ProcessDirector ne reçoit aucune donnée permettant de créer des travaux. Dans cet exemple, la charge inclut les éléments suivants : <Token>, <TimeRange>, <Start> et <End>. La valeur de chaque élément est un symbole :
<Token>${WebService.Credential}</Token> <TimeRange> <Start>${WebService.LastSuccessRequestTime}</Start> <End>${WebService.CurrentRequestTime}</End> </TimeRange>
L'unité d'entrée résout ces symboles lorsqu’elle interroge l’entrée XML.
- Définissez la propriété Requête SOAP sur la requête SOAP créée par RICOH ProcessDirector lorsque vous avez importé le fichier WSDL.Supposons que vous voulez utiliser la requête SOAP GetOrdersByDate. Vous avez ajouté PrintShop aux noms des requêtes SOAP lorsque vous les avez importées. Sélectionnez PrintShop-GetOrdersByDate.
- Sélectionnez une valeur pour la propriété Créer un travail à partir de la réponse afin de spécifier comment l'unité d'entrée crée des travaux à partir de l’entrée
:
- Pour créer un travail chaque fois que l'unité d'entrée reçoit une réponse, sélectionnez Toujours.
- Pour examiner le code XML de la réponse et créer un travail chaque fois qu’un élément XML est trouvé, sélectionnez Uniquement lorsque le masque de réponse correspond.
- Si vous avez sélectionné Uniquement lorsque le masque de réponse correspond :
- Définissez la propriété Masque de correspondance de la réponse sur l’expression XPath qui identifie l’élément XML que vous souhaitez utiliser pour
chaque travail.
Par exemple, vous souhaitez un travail pour chaque commande et les données de la réponse contiennent un élément commande. Entrez l’expression XPath qui représente l’élément dans le contenu XML.
- Définissez la propriété Créer des travaux enfants sur Oui si vous souhaitez créer des travaux enfants lorsque l'unité d'entrée trouve plusieurs correspondances. L'unité d'entrée crée aussi un travail parent sans aucune donnée. Si l'unité d'entrée trouve une correspondance, elle crée un travail indépendant.
- Définissez la propriété Créer des travaux enfants sur Non si vous souhaitez créer des travaux indépendants quel que soit le nombre de correspondances que trouve l'unité d'entrée.
- Définissez la propriété Masque de correspondance de la réponse sur l’expression XPath qui identifie l’élément XML que vous souhaitez utiliser pour
chaque travail.
- Si votre environnement exige un serveur proxy pour communiquer avec les services Web, définissez la propriété Utiliser un proxy sur le serveur proxy correct.
- Définissez la propriété Décalage de fuseau horaire sur le décalage en heures entre le fuseau UTC (Coordinated Universal Time) et celui
utilisé par le service Web.Par exemple, si le service Web utilise l’heure normale du Pacifique (PST), définissez la propriété sur -8.
- Remarque:
- Veillez à modifier cette propriété lorsqu’un emplacement où est hébergé le service Web passe de l’heure normale à l’heure d'été. À défaut, vous risquez, pendant l’heure perdue ou gagnée, de perdre les données que RICOH ProcessDirector utilise pour créer les travaux.
- Si le service Web utilise l’heure UTC, indiquez 0 ou laissez le champ vide.
- Dans l’onglet Authentification, spécifiez les valeurs requises pour l’authentification avec l’application.Pour plus d’informations, consultez la tâche connexe associée à l’authentification avec un service Web SOAP.
Si l’application ne nécessite pas d’authentification, laissez toutes les propriétés d’authentification vides.
- En option: Dans l’onglet Avancé, spécifiez les éventuelles propriétés facultatives de votre environnement.
- Lorsque vous avez terminé, cliquez sur OK.
Lorsque vous avez fini de configurer vos unités d’entrée, les notifications et les flots de travaux, testez l’échange de données entre RICOH ProcessDirector et l’application.
La notification de service Web REST fournie RestfulWebServiceSample est similaire à une notification de service Web SOAP. La fonctionnalité MarcomCentral Connect inclut une unité d’entrée de service Web SOAP fournie.