Exécution des exemples de flots de travaux pour le traitement des commandes extraites de MarcomCentral

Les flux de travail MarcomProcessOrders et MarcomProcessJobTicket montrent comment traiter des commandes extraites d'un exemple de magasin sur le site Web MarcomCentral. L'exemple de magasin sert d'environnement de test pour l'interface des services Web RICOH ProcessDirector avec MarcomCentral. Une unité d'entrée du service Web SOAP, une étape CallSOAPService et une notification du service Web SOAP communiquent avec le site Web MarcomCentral. Les flux de travail incluent également des exemples de ces étapes : ApplyXSLTransform, CreateOrdersFromFile et DownloadFile

L'exemple d'unité d'entrée, l'étape CallSOAPService et la notification exécutent une simulation. Ils n'appellent pas les services Web MarcomCentral spécifiés. La simulation vous permet d'exécuter les exemples sans recourir à vos informations d'identification MarcomCentral et en configurant un exemple de magasin MarcomCentral qui ressemble au magasin utilisé en exemple. Les exemples utilisent les charges de requête SOAP 1.1 pour récupérer une commande MarcomCentral simulée et deux fiches de travail. La valeur présente dans le champ des informations d'accréditation statique et du mot de passe indique à RICOH ProcessDirector d'exécuter la simulation.

Une fois les exemples exécutés, vous pouvez les copier. Vous pouvez alors ajuster les valeurs dans les copies pour échanger les données avec votre propre magasin au niveau du site Web MarcomCentral.

    Remarque:
  • Les exemples d'objets et de fichiers sont installés avec la fonction MarcomCentral Connect.

La simulation inclut des objets de requête SOAP WSDL (Web Services Description Language) qui sont importés de MarcomCentral. L'exemple d'unité d'entrée, les étapes CallSOAPService et la notification spécifient chacun une requête SOAP.

Cette simulation utilise ces objets et fichiers :

  • Flots de travaux :
    • MarcomProcessOrders
    • MarcomProcessJobTicket
  • Mappage de propriétés de commande : MarconOrderSample
  • Unité d'entrée : MarcomReceiveOrders

    L'unité d'entrée récupère les commandes XML à partir du site Web MarcomCentral en simulant un appel à un service Web à l'adresse https://services.printable.com/Trans/1.0/Order.asmx

    La requête SOAP est Marcom-GetOrdersByDate.

  • Notification : MarcomCloseoutOrder

    La notification envoie les informations de fin de commande au site Web MarcomCentral en simulant un appel à un service Web à l'adresse https://services.printable.com/Trans/1.0/Closeout.asmx

    La requête SOAP est MarcomSample-CloseoutByOrder.

  • Commandes XML

    Dans la simulation, une commande est récupérée du service Web toutes les 30 secondes.

    Après avoir exécuté les flots de travaux utilisés en exemple, vous pouvez afficher le contenu d'un exemple de commande. Accédez au répertoire : /aiw/aiw1/spool/default/numéro_travail

    Remplacez numéro_travail par le numéro du travail, par exemple, 10000001.

    Affichez le contenu du fichier numéro_travail.print.xml, par exemple 10000001.print.xml.

  • Fiches de travail XML

    Dans la simulation, deux fiches de travail sont récupérées pour chaque commande.

    Une fois les exemples de flux de travail exécutés, vous pouvez afficher le contenu des deux exemples de fiches de travail. Accédez au répertoire : /aiw/aiw1/spool/default/numéro_travail_enfant

    Remplacez numéro_travail_enfant par le numéro de travail enfant, par exemple, 10000001.1 ou 10000001.2.

    Affichez le contenu du fichier numéro_travail_enfant.print.xml, par exemple, 10000001.1.print.xml ou 10000001.2.print.xml.

  • Imprimez le fichier : Savings.pdf

    Ce fichier est téléchargé localement à partir de http://localhost:15080/restapi/

  • Fichier de feuille de style XSLT : downloadOverrides.xslt

    Le fichier se trouve dans le répertoire Marcom : /aiw/aiw1/testfiles/Marcom

  • Étape CallSOAPService :
    • L'étape CallSOAPService récupère une fiche de travail à partir du site Web MarcomCentral en simulant un appel à un service Web à l'adresse https://services.printable.com/Trans/1.0/JobTicket.asmx

      La requête SOAP est Marcom-GetJobTicketByLineItem.

Pour exécuter le flot de travaux échantillon :

  1. Cliquez sur l'onglet Principal.
  2. Dans le portlet Imprimantes, cliquez avec le bouton droit de la souris sur l'imprimante Exemple et sélectionnez Activer.
  3. Dans le portlet Unités d'entrée, cliquez avec le bouton droit sur l'unité d'entrée du service Web SOAP MarcomReceiveOrders et sélectionnez Activer et connecter.

    Un travail nommé Exemple de commande Marcom s'affiche dans le tableau Travaux.

  4. Effectuez un clic droit sur l'unité d'entrée MarcomReceiveOrders et sélectionnez Désactiver et déconnecter.
      Remarque:
    • L'exemple d'unité d'entrée interroge les commandes toutes les 30 secondes et récupère un travail XML. Si vous ne désactivez ni ne déconnectez l'unité d'entrée, un nouveau travail apparaît dans le tableau Travaux toutes les 30 secondes.

    La charge de requête pour l'unité d'entrée inclut ces symboles RICOH ProcessDirector :

    • ${WebService.StaticCredential}

      Permet d'indiquer l'accréditation statique

    • ${WebService.LastSuccessRequestTime}

      Indique la date et l'heure auxquelles l'unité d'entrée a demandé et obtenu une réponse du service Web pour la dernière fois.

    • ${WebService.CurrentRequestTime}

      Indique la date et l'heure de la demande en cours.

    Chaque fois que l'unité d'entrée MarcomReceiveOrders récupère un travail XML, elle envoie le travail au flot de travaux MarcomProcessOrders.

    Le travail passe par ces étapes et par d'autres dans le flux de travail MarcomProcessOrders :

    • L'étape SetJobPropsFromTextFile définit la propriété Nom de travail sur Marcom Sample Order.
    • L'étape CreateOrdersFromFile utilise l'objet de mappage de propriétés MarcomOrderSample pour identifier les commandes et les travaux, puis mappe les valeurs de certains éléments XML du fichier de commande XML aux propriétés de commande et de travail.
    • Le tableau répertorie les propriétés définies.

      Élément XML Nom de la base de données Nom de l'interface utilisateur
      /Order/OrderNumber Order.Name Nom de la commande
      /Order/ID Order.Reference Référence de commande externe
      /Order/OrderDetails/OrderDetail/User/Name Order.Customer Nom du client
      /Order/OrderDetails/OrderDetail/SKUDescription Order.Description Description
      /Order/OrderDetails/OrderDetail/Quantity Job.Copies Nombre de copies du travail requises
      /Order/OrderDetails/OrderDetail/OrderNumber Job.Marcom.OrderNumber Numéro de commande MarcomCentral
      /Order/ID Job.Marcom.OrderId ID de commande MarcomCentral
      /Order/OrderDetails/OrderDetail/ID Job.Marcom.JobTicketId Fiche de travail MarcomCentral
      /Order/OrderDetails/OrderDetail/ProductType Job.Marcom.ProductType Type de produit MarcomCentral
      /Order/OrderDetails/OrderDetail/ProductName Job.Name Nom du travail

      L'étape identifie une commande contenant deux travaux. Elle crée deux travaux, Casquette de Baseball Jensen Bank et Brochure, qu'elle soumet au flux de travail MarcomProcessJobTicket.

      Le travail de la commande d'origine est envoyé à l'étape WaitForRelatedJobs.

    Le traitement des travaux commence dans le flux de travail MarcomProcessJobTicket. Lorsque les travaux quittent l'étape SetJobPropsFromTextFile, la règle associée au connecteur [1] Entrepôt vérifie la valeur de la propriété Type de produit MarcomCentral. Versioned, Variable et JobDirect sont des types de produit pour les articles imprimables.

    • Si l'article n'est associé à aucun type de produit imprimable, le flot de travaux envoie le travail via la branche Entrepôt.
    • Si l'article est associé à un type de produit imprimable, le flux de travail envoie le travail via la branche Imprimable.

    Les travaux non imprimables passent par l'étape ManualStepWithAutoStart dans la branche Entrepôt du flux de travail. Les travaux attendent dans cette étape jusqu'à ce que les membres du personnel de l'entrepôt indiquent qu'ils sont prêts à être expédiés.

    Les travaux imprimables passent par les étapes et connecteurs suivants dans la branche Imprimable du flux de travail :

    • Lorsque le travail arrive à la deuxième étape ContinueToNextStep, la règle associée au connecteur [1] Fichier prêt vérifie si la propriété Personnalisé 3 (URL du fichier de téléchargement) est définie sur une valeur.
      • Si tel est le cas, le fichier d'impression est prêt à être téléchargé. Le flot de travaux envoie le travail directement à l'étape DownloadFile.
      • Dans le cas contraire, la règle associée au connecteur [2] Vérifier le fichier vérifie si la valeur de la propriété de travail Nombre entier personnalisé 1 est inférieure à 10. La première fois que le travail arrive à la deuxième étape ContinueToNextStep, la valeur de la propriété Nombre entier personnalisé 1 est 0.
        • Si la valeur est comprise entre 0 et 9, le flot de travaux envoie le travail à l'étape Wait, qui impose une attente de 30 secondes. Le flot de travaux envoie ensuite le travail à l'étape CallSOAPService.

          L'étape CallSOAPService appelle le service Web MarcomCentral qui récupère la fiche de travail d'un article imprimable. L'étape indique deux symboles RICOH ProcessDirector dans la valeur de la propriété Charge de requête :

          • ${Job.WebService.Password}

            Permet d'indiquer l'accréditation statique.

          • ${Job.Marcom.JobTicketId}

            Indique l'ID de fiche de travail.

          L'étape ApplyXSLTransform2 utilise la feuille de style XSLT downloadOverrides.xslt pour convertir un élément XML en une propriété de travail RICOH ProcessDirector :

          Élément XML Nom de base de données de la propriété de travail Nom d'interface utilisateur de la propriété de travail
          JobTicket/FinalOutputFileURL/URL Job.Info.Attr3 Personnalisé3

          L'étape place la valeur dans un fichier de substitutions et remplace le fichier de substitutions du répertoire spoule du travail par le nouveau fichier de substitutions.

          L'exemple suivant présente le contenu de l'exemple de fichier de substitutions :

          Job.Info.Attr3=http://localhost:15080/restapi/Savings.pdf

          L'étape AssignJobValues augmente la valeur de la propriété Nombre entier personnalisé 1 par incréments de 1. Le flot de travaux renvoie ensuite le travail à la deuxième étape ContinueToNextStep, qui fait passer le travail de l'étape Attendre à l'étape CallSOAPService. Cette dernière étape renouvelle l'appel au service Web MarcomCentral qui extrait une fiche de travail pour un article imprimable. Si la propriété Personnalisé3 n'est toujours associée à aucune valeur d'URL, le flot de travaux envoie le travail à l'étape CallSOAPService jusqu'à 9 fois.

        • Si la valeur est 10, cela signifie que le travail a été envoyé 10 fois à l'étape CallSOAPService. Après 5 minutes, la propriété Personnalisé3 n'a toujours aucune valeur pour le fichier de téléchargement. Le travail ne répond pas à la règle associée au connecteur [2] Rechercher le fichier. Le flot de travaux envoie le travail par le biais du connecteur [3] Délai expiré à l'étape FailWithMesssage et écrit un message d'échec dans le journal du travail. Ce message est le suivant : File was not available to download in the time allowed (Fichier non disponible au téléchargement dans le délai imparti).

            Remarque:
          • Comme ce message est une propriété de travail, il apparaît sur l'onglet Information du bloc-notes des propriétés de tous les travaux qui transitent dans le flux de travail. Ce message apparaît dans le journal du travail uniquement lorsque le flot de travaux envoie le travail à l'étape FailWithMesssage via le connecteur [3] Délai expiré.

    • L'étape DownloadFile télécharge le fichier d'impression Savings.pdf à partir de http://localhost:15080/restapi/ en définissant la valeur de la propriété URL pour télécharger le fichier sur le symbole ${Job.Info.Attr3}.
    • Les étapes OptimizePDF, CountPages, CreatePageRanges et PrintJobs traitent et impriment le travail sur l'imprimante Exemple.

    L'étape WaitForRelatedJobs conserve le travail parent et chacun des travaux enfants jusqu'à ce que l'ensemble des travaux enfants atteignent l'étape.

  5. Dans le tableau Travaux, cliquez avec le bouton droit sur le travail Casquette de Baseball Jensen Bank et sélectionnez Manuel Terminer.
  6. Sélectionnez Passer à l'étape suivante, puis cliquez sur OK.

    Le travail passe à l'étape WaitForRelatedJobs.

    Lorsque les deux travaux atteignent l'étape WaitForRelatedJobs, le flux de travail envoie les trois travaux (le travail de la commande d' origine, le travail non imprimable et le travail imprimable) à l'étape RetainCompletedJobs. L'état de chaque travail devient Conservé. Cette commande prend alors l'état Terminé.

    La notification du service Web MarcomCloseoutOrder appelle le service Web à l'adresse https://services.printable.com/Trans/1.0/Closeout.asmx

    La charge de requête inclut ces symboles RICOH ProcessDirector :

    • ${WSNotification.WebService.Credential}

      Permet d'indiquer l'accréditation statique.

    • ${Job.Marcom.OrderId}

      Indique l'ID de la commande.

    Si la notification appelait le service Web au lieu d'exécuter la simulation, ce changement interviendrait au niveau du magasin utilisé en exemple sur le site Web MarcomCentral. Dans la boîte de dialogue Afficher par article du Gestionnaire de commandes, la valeur de la colonne Statut de la commande pour chaque article du numéro de commande WS113 passerait de Travail en cours à Expédié.

  7. Dans le tableau Travaux, cliquez avec le bouton droit sur le travail Brochure et sélectionnez Afficher.
    Le visualiseur affiche le fichier PDF qui a été imprimé dans le cadre de la commande.
Pour exécuter à nouveau les exemples de flot de travaux, activez et connectez l'unité d'entrée MarcomReceiveOrders. Ensuite, désactivez-la et déconnectez-la.

À présent que vous avez exécuté les exemples, vous pouvez les copier. Ajustez les valeurs dans les copies pour échanger les données avec votre propre magasin au niveau du site Web MarcomCentral. Voir les rubriques associées.