Ejecución de flujos de trabajo de ejemplo para el procesamiento de pedidos recuperados de MarcomCentral

Los flujos de trabajo MarcomProcessOrders y MarcomProcessJobTicket muestran cómo se procesan pedidos recuperados de un almacén de ejemplo en el sitio web de MarcomCentral. El almacén de ejemplo sirve como entorno de prueba de la interfaz de servicios web de RICOH ProcessDirector a MarcomCentral. Un dispositivo de entrada de servicio web SOAP, un paso CallSOAPService y una notificación de servicio web SOAP se comunican con el sitio web de MarcomCentral. Los flujos de trabajo también incluyen ejemplos de estos pasos: ApplyXSLTransform, CreateOrdersFromFile y DownloadFile.

El dispositivo de entrada de ejemplo, el paso CallSOAPService y la notificación ejecutan una simulación. No llaman a los servicios web especificados de MarcomCentral. La simulación le permite ejecutar los ejemplos sin obtener sus propias credenciales de MarcomCentral y configurar un almacén de ejemplo de MarcomCentral que se asemeja al almacén de ejemplo. Los ejemplos utilizan cargas de solicitud SOAP 1.1 para recuperar un pedido de MarcomCentral simulado y dos detalles de trabajo. El valor de los campos de la credencial estática y la contraseña indica a RICOH ProcessDirector que debe ejecutar la simulación.

Después de ejecutar los ejemplos, puede copiarlos. A continuación, puede ajustar los valores de las copias para intercambiar datos con su propio almacén en el sitio web de MarcomCentral.

    Nota:
  • Los archivos y objetos de ejemplo se instalan con el dispositivo MarcomCentral Connect.

La simulación incluye servicios objetos de solicitud SOAP WSDL (Idioma de descripción de servicio web) importados de MarcomCentral. El dispositivo de entrada de ejemplo, los pasos CallSOAPService y la notificación especifican una solicitud SOAP cada uno.

Esta simulación utiliza estos objetos y archivos:

  • Flujos de trabajo:
    • MarcomProcessOrders
    • MarcomProcessJobTicket
  • Correlación de propiedades de pedido: MarconOrderSample
  • Dispositivo de entrada: MarcomReceiveOrders

    El dispositivo de entrada recupera pedidos XML del sitio web de MarcomCentral mediante la simulación de una llamada a un servicio web en https://services.printable.com/Trans/1.0/Order.asmx

    La solicitud SOAP es Marcom-GetOrdersByDate.

  • Notificación: MarcomCloseoutOrder

    La notificación envía información de finalización del pedido al sitio web de MarcomCentral mediante la simulación de una llamada a un servicio web en https://services.printable.com/Trans/1.0/Closeout.asmx

    La solicitud SOAP es Sample-CloseoutByOrder Marcom.

  • Pedidos XML

    En la simulación, un pedido se recupera cada 30 segundos desde el servicio web.

    Después de que ejecute los flujos de trabajo de ejemplo, puede ver el contenido de un pedido de ejemplo. Vaya a: C:\aiw\aiw1\spool\default\número_de_trabajo

    Sustituya número_de_trabajo por el número del trabajo, por ejemplo, 10000001.

    Visualice el contenido del archivo número_de_trabajo.print.xml, por ejemplo, 10000001.print.xml.

  • Detalles de trabajo XML

    En la simulación, se recuperan dos detalles de trabajo para cada pedido.

    Después de ejecutar los flujos de trabajo de ejemplo, puede ver el contenido de los dos detalles de trabajo de ejemplo. Vaya a: C:\aiw\aiw1\spool\default\número_de_trabajo_hijo

    Sustituya número_de_trabajo_hijo por el número del trabajo hijo, por ejemplo, 10000001.1 o 10000001.2.

    Visualice el contenido del archivo número_de_trabajo_hijo.print.xml, por ejemplo, 10000001.1.print.xml o 10000001.2.print.xml.

  • Archivo de impresión: Savings.pdf

    Este archivo se descarga de forma local de http://localhost:15080/restapi/

  • Archivo de hoja de estilo XSLT: downloadOverrides.xslt

    El archivo se encuentra en el directorio de Marcom: C:\aiw\aiw1\testfiles\Marcom

  • Paso CallSOAPService:
    • El paso CallSOAPService recupera un detalle de trabajo del sitio web de MarcomCentral mediante la simulación de una llamada a un servicio web en https://services.printable.com/Trans/1.0/JobTicket.asmx

      La solicitud SOAP es Marcom-GetJobTicketByLineItem.

Para ejecutar el flujo de trabajo de muestra:

  1. Pulse la pestaña Principal.
  2. En el portlet Impresoras, pulse con el botón derecho del ratón la impresora de ejemplo y seleccione Habilitar.
  3. En el portlet Dispositivos de entrada, pulse con el botón derecho el dispositivo de entrada de servicio web SOAP MarcomReceiveOrders y seleccione Habilitar y conectar.

    En la tabla de trabajos, aparece un trabajo con el nombre Orden de ejemplo de Marcom.

  4. Pulse con el botón derecho el dispositivo de entrada MarcomReceiveOrders y seleccione Inhabilitar y desconectar.
      Nota:
    • El dispositivo de entrada de ejemplo sondea en busca de pedidos cada 30 segundos y recupera un trabajo XML. Si no inhabilita ni desconecta el dispositivo de entrada, aparecerá un nuevo trabajo en la tabla de trabajos cada 30 segundos.

    La carga de solicitud para el dispositivo de entrada incluye estos símbolos de RICOH ProcessDirector:

    • ${WebService.StaticCredential}

      Especifica la credencial estática

    • ${WebService.LastSuccessRequestTime}

      Especifica la fecha y la hora de la última vez que el dispositivo de entrada solicitó correctamente una respuesta al servicio web.

    • ${WebService.CurrentRequestTime}

      Especifica la fecha y hora de la solicitud actual.

    Cada vez que el dispositivo de entrada MarcomReceiveOrders recupera un trabajo XML, envía el trabajo al flujo de trabajo MarcomProcessOrders.

    El trabajo pasa a través de estos y de otros pasos del flujo de trabajo MarcomProcessOrders:

    • El paso SetJobPropsFromTextFile define la propiedad Nombre de trabajo en Marcom Sample Order.
    • El paso CreateOrdersFromFile utiliza el objeto de correlación de propiedades MarcomOrderSample para identificar pedidos y trabajos y, a continuación, asignar los valores de algunos elementos XML del archivo de pedidos XML a propiedades de pedidos y trabajos.
    • La tabla enumera las propiedades que se establecen.

      Elemento XML Nombre de base de datos Nombre de interfaz de usuario
      /Order/OrderNumber Order.Name Nombre del pedido
      /Order/ID Order.Reference Referencia de pedido externa
      /Order/OrderDetails/OrderDetail/User/Name Order.Customer Nombre de cliente
      /Order/OrderDetails/OrderDetail/SKUDescription Order.Description Descripción
      /Order/OrderDetails/OrderDetail/Quantity Job.Copies Copias de trabajo solicitadas
      /Order/OrderDetails/OrderDetail/OrderNumber Job.Marcom.OrderNumber Número de orden de MarcomCentral
      /Order/ID Job.Marcom.OrderId ID de orden de MarcomCentral
      /Order/OrderDetails/OrderDetail/ID Job.Marcom.JobTicketId Detalle de trabajo de MarcomCentral
      /Order/OrderDetails/OrderDetail/ProductType Job.Marcom.ProductType Tipo de producto de MarcomCentral
      /Order/OrderDetails/OrderDetail/ProductName Job.Name Nombre de trabajo

      El paso identifica un pedido que consta de dos. Crea dos trabajos, Jensen Bank Baseball Cap y Brochure, y los envía al flujo de trabajo MarcomProcessJobTicket.

      El trabajo del pedido original se envía al paso WaitForRelatedJobs.

    Los trabajos comienzan a procesarse en el flujo de trabajo MarcomProcessJobTicket. Cuando los trabajos salen del paso SetJobPropsFromTextFile, la regla en el conector [1] Almacén comprueba el valor de la propiedad Tipo de producto de MarcomCentral. Versioned, Variable y JobDirect son los tipos de producto para elementos imprimibles.

    • Si el elemento no tiene un tipo de producto imprimible, el flujo de trabajo envía el trabajo a través de la derivación Almacén.
    • Si el elemento tiene un tipo de producto imprimible, el flujo de trabajo envía el trabajo a través de la derivación Imprimible.

    Los trabajos no imprimibles van a través del paso ManualStepWithAutoStart en la derivación Almacén del flujo de trabajo. Los trabajos esperan en ese paso hasta que el personal del almacén indica que los trabajos están listos para su envío.

    Los trabajos imprimibles atraviesan estos pasos y conectores en la derivación Imprimible del flujo de trabajo:

    • Cuando el trabajo llega al segundo paso ContinueToNextStep, la regla en el conector [1] Archivo preparado comprueba si la propiedad Personalizado 3 (URL del archivo de descarga) está definida en un valor.
      • Si lo está, el archivo de impresión está listo para descargar. El flujo de trabajo envía el trabajo directamente al paso DownloadFile.
      • Si no lo está, la regla en el conector [2] Comprobar archivo comprueba si el valor de la propiedad de trabajo Entero personalizado 1 es inferior a 10. La primera vez que el trabajo llega al segundo paso ContinueToNextStep, el valor de la propiedad Entero personalizado 1 es de 0.
        • Si el valor es 0 a 9, el flujo de trabajo envía el trabajo al paso Esperar, que espera durante 30 segundos. A continuación, el flujo de trabajo envía el trabajo al paso CallSOAPService.

          El paso CallSOAPService llama al servicio web de MarcomCentral que devuelve un detalle de trabajo para un elemento imprimible. El paso especifica dos símbolos RICOH ProcessDirector como parte del valor en la propiedad Carga de solicitud:

          • ${Job.WebService.Password}

            Especifica la credencial estática.

          • ${Job.Marcom.JobTicketId}

            Especifica el ID de detalle de trabajo.

          El paso ApplyXSLTransform2 utiliza la hoja de estilo XSLT downloadOverrides.xslt para convertir un elemento XML en una propiedad de trabajo de RICOH ProcessDirector:

          Elemento XML Nombre de base de datos de la propiedad de trabajo Nombre de interfaz de usuario de la propiedad de trabajo
          JobTicket/FinalOutputFileURL/URL Job.Info.Attr3 Personalizado 3

          El paso coloca el valor en un archivo de alteraciones temporales y sobrescribe dicho archivo en el directorio de spool para el trabajo con el nuevo archivo de alteraciones temporales.

          Este ejemplo muestra el contenido del archivo de alteraciones temporales de ejemplo:

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

          El paso AssignJobValues incrementa el valor de la propiedad Entero personalizado 1 en 1. A continuación, el flujo de trabajo envía el trabajo de vuelta al segundo paso ContinueToNextStep, que envía el trabajo a través del paso Esperar al paso CallSOAPService. El paso CallSOAPService repite la llamada al servicio web de MarcomCentral que recupera un detalle de trabajo para un elemento imprimible. Si la propiedad Personalizado 3 todavía no tiene un valor para la URL, el flujo de trabajo envía el trabajo a través del paso CallSOAPService hasta nueve veces.

        • Si el valor es 10, el trabajo se ha enviado al paso CallSOAPService diez veces. Después de 5 minutos, la propiedad Personalizado 3 todavía no tiene un valor para el archivo que desea descargar. El trabajo no cumple la regla en el conector [2] Comprobar archivo. El flujo de trabajo envía el trabajo a través del conector [3] Tiempo de espera al paso FailWithMesssage y escribe un mensaje de fallo para el registro de trabajos. El mensaje indica: El archivo no estaba disponible para descargar en el tiempo asignado.

            Nota:
          • Debido a que el mensaje es una propiedad de trabajo, se muestra en la pestaña Información del cuaderno de propiedades del trabajo para todos los trabajos que pasan por el flujo de trabajo. El mensaje aparece en el registro de trabajos sólo cuando el flujo de trabajo envía el trabajo a través del conector [3] Tiempo de espera al paso FailWithMesssage.

    • El paso DownloadFile descarga el archivo de impresión Savings.pdf de http://localhost:15080/restapi/ definiendo el valor de la propiedad URL para descargar archivo para el símbolo ${Job.Info.Attr3}.
    • Los pasos OptimizePDF, CountPages, CreatePageRanges y PrintJobs procesan e imprimen el trabajo en la impresora Ejemplo.

    El paso WaitForRelatedJobs mantiene el trabajo padre y cada uno de los trabajos hijo hasta que todos los trabajos hijo llegan al paso.

  5. En la tabla de trabajos, pulse con el botón derecho el trabajo Gorra de béisbol Jensen Bank y seleccione Completar manualmente.
  6. Seleccione Mover al paso siguiente y pulse Aceptar.

    El trabajo pasa al paso WaitForRelatedJobs.

    Cuando ambos trabajos llegan al paso WaitForRelatedJobs, el flujo de trabajo envía los tres trabajos (el trabajo del pedido original, el trabajo no imprimible y el trabajo imprimible) al paso RetainCompletedJobs. El estado de cada trabajo cambia a Retenido. El estado del pedido cambia a Finalizado.

    La notificación de servicio web MarcomCloseoutOrder llama al servicio web en https://services.printable.com/Trans/1.0/Closeout.asmx

    La carga de solicitud incluye estos símbolos de RICOH ProcessDirector:

    • ${WSNotification.WebService.Credential}

      Especifica la credencial estática.

    • El ${Job.Marcom.OrderId}

      Especifica el ID del pedido.

    Si la notificación llamó al servicio web en lugar de ejecutar la simulación, este cambio podría producirse en el almacén de ejemplo del sitio web de MarcomCentral. En el cuadro de diálogo Mostrar por elemento del Gestor de pedidos, el valor en la columna Estado de pedido para cada elemento en el número de pedido WS113 cambiaría de Trabajo en curso a Enviado.

  7. En la tabla de trabajos, pulse con el botón derecho el trabajo Folleto y seleccione Ver.
    El visor muestra el archivo PDF que se imprimió como parte del pedido.
Para ejecutar de nuevo los flujos de trabajo de ejemplo, habilite y conecte el dispositivo de entrada MarcomReceiveOrders. A continuación, inhabilítelo y desconéctelo.

Ahora que ha ejecutado los ejemplos, puede copiarlos. Ajuste los valores de las copias para intercambiar datos con su propio almacén en el sitio web de MarcomCentral. Consulte los temas relacionados.