Planning how to process orders from your MarcomCentral store

In this procedure, you map MarcomCentral XML elements for orders and job tickets to RICOH ProcessDirector job properties. You decide how to supply the information required for RICOH ProcessDirector to process the items in an order. You also decide what criteria to use to report status to MarcomCentral.
To plan how to process orders from your MarcomCentral store:
  1. Review your MarcomCentral orders and decide which XML elements to map to RICOH ProcessDirector job properties.

    Later in this procedure, you map the XML elements to job properties using a third-party tool (such as Altova MapForce) that creates XSLT style sheets.

    For reference, this table lists the eight MarcomCentral XML elements for orders that are mapped to five RICOH ProcessDirector job properties in the sample MarcomProcessOrders workflow.

    XML element for order Database name of job property User interface name of job property
    OrderNumber Job.Marcom.OrderNumber MarcomCentral order number
    ID Job.Marcom.OrderId MarcomCentral order ID
    User/Email Job.CustomerName Customer name
    ShippingAddress/Address1ShippingAddress/CityShippingAddress/StateShippingAddress/Zip Job.Info.Attr1 Custom 1
    count(OrderDetails/OrderDetail) Job.Info.Attr2 Custom 2

    Keep in mind this information about RICOH ProcessDirector job properties as you do the mapping:

    • Two job properties for orders are supplied with the MarcomCentral Connect feature: MarcomCentral order number and MarcomCentral order ID.

    • Two job properties for job tickets are supplied with the MarcomCentral Connect feature: MarcomCentral job ticket ID and MarcomCentral product type.

    • For a list of all job properties supplied with the base product, see the related reference about database property names for jobs.

    • RICOH ProcessDirector supplies 10 custom job properties.

      • If one workflow processes order jobs and another workflow processes ticket jobs, you can use a custom job property for different purposes in each workflow. For example, you can use the Custom 1 property for the shipping address of an order in the workflow for order jobs. You can use the Custom 1 property for the SKU description in the workflow for ticket jobs.

      • You cannot use the same custom job property for different purposes within the same workflow. For example, you use the Custom 1 property for the SKU description in the job ticket workflow. If you also use the Custom 1 property to provide packaging information in the job ticket workflow, the packaging information overwrites the SKU description.

    • If you need more than 10 custom job properties, contact your Ricoh support representative.

      Note: If you are not using some of the job properties supplied with the base product or an installed feature, you can use those properties for MarcomCentral. For example, you have the AFP Support feature, but you are not using the Job.Info.Department and Job.Info.Programmer job properties. You can use those properties for MarcomCentral.

    Use the following table to record the MarcomCentral order elements to map to RICOH ProcessDirector job properties.

    Note: The sample MarcomProcessOrders workflow uses three of the 10 custom job properties to determine when all the expected job tickets have been retrieved. The other seven custom job properties are available for your use.
    Database name of job property User interface name of job property XML element for order
    Job.Marcom.OrderNumber MarcomCentral order number OrderNumber
    Job.Marcom.OrderId MarcomCentral order ID ID
    Job.Info.Attr1 Custom 1
    Job.Info.Attr2 Custom 2 count(OrderDetails/OrderDetail)
    Job.Info.Attr3 Custom 3 count(ns0:Envelope/ns0:Body/ns2:GetJobTicketsByOrderNumberResponse/ns1:GetJobTicketResponse/JobTicket)
    Job.Info.Attr4 Custom 4 Used to determine when all job tickets for an order have been retrieved from MarcomCentral.
    Job.Info.Attr5 Custom 5
    Job.Info.Attr6 Custom 6
    Job.Info.Attr7 Custom 7
    Job.Info.Attr8 Custom 8
    Job.Info.Attr9 Custom 9
    Job.Info.Attr10 Custom 10

  2. Review your MarcomCentral job tickets and decide which XML elements for job tickets to map to RICOH ProcessDirector job properties.

    For reference, this table lists the nine MarcomCentral XML elements for job tickets that are mapped to nine RICOH ProcessDirector job properties in the sample MarcomProcessJobTicket workflow.

    XML element for job ticket Database name of job property User interface name of job property
    OrderDetails/OrderDetail/ID Job.Marcom.JobTicketId MarcomCentral job ticket ID
    OrderDetails/OrderDetail/ProductType Job.Marcom.ProductType MarcomCentral product type
    OrderDetails/OrderDetail/ProductName Job.Name Job name
    OrderDetails/OrderDetail/ProductDescription Job.Description Job description
    OrderDetails/OrderDetail/Quantity Job.Copies Job copies requested
    OrderDetails/OrderDetail/SKUDescription Job.Info.Attr1 Custom 1
    OrderDetails/OrderDetail/Shipping/Method Job.Info.Attr2 Custom 2
    FinalOutputFileURL/URL Job.Info.Attr3 Custom 3
    OrderDetails/OrderDetail/SKU/ID Job.Info.Attr4 Custom 4

    Use the following table to record the MarcomCentral job ticket elements to map to RICOH ProcessDirector job properties.

    Database name of job property User interface name of job property XML element for job ticket
    Job.Marcom.JobTicketId MarcomCentral job ticket ID OrderDetails/OrderDetail/ID
    Job.Marcom.ProductType MarcomCentral product type OrderDetails/OrderDetail/ProductType
    Job.Info.Attr1 Custom 1
    Job.Info.Attr2 Custom 2
    Job.Info.Attr3The DownloadFile step uses this job property. Custom 3 JobTicket/FinalOutputFileURL/URL
    Job.Info.Attr4 Custom 4
    Job.Info.Attr5 Custom 5
    Job.Info.Attr6 Custom 6
    Job.Info.Attr7 Custom 7
    Job.Info.Attr8 Custom 8
    Job.Info.Attr9 Custom 9
    Job.Info.Attr10 Custom 10

  3. Decide how to supply the information required for RICOH ProcessDirector to process the items in an order from your MarcomCentral store.
    MarcomCentral does not store the information required to process the items in an order. For example, MarcomCentral does not store the media, duplex, and finishing options required for print items or the packing material required for non-print items.
    1. Decide whether you want your MarcomCentral workflows to process both print and non-print items or only print items.

      If you want your workflows to process only print items, skip the instructions for non-print items. When you copy the sample MarcomProcessJobTicket workflow and modify it for your needs, remove the branch that processes non-print items.

    2. Decide what information RICOH ProcessDirector requires to process print items.

      For reference, this table lists the two RICOH ProcessDirector job properties that provide information required to process print items in the sample MarcomProcessJobTicket workflow.

      Database name of job property User interface name of job property
      Job.Media Media
      Job.Duplex Duplex

      Use the following table to record the RICOH ProcessDirector job properties that provide information required to process print items in your job ticket workflow.

      Database name of job property User interface name of job property XML element (optional, for use later in this procedure)

    3. Decide what information RICOH ProcessDirector requires to process non-print items.

      For reference, this table lists the RICOH ProcessDirector job property that provides information required to process non-print items in the sample MarcomProcessJobTicket workflow.

      Database name of job property User interface name of job property
      Job.Info.Attr5 Custom 5

      Use the following table to record the RICOH ProcessDirector job properties that provide information required to process non-print items in your job ticket workflow.

      Database name of job property User interface name of job property XML element (optional, for use later in this procedure)

    4. Identify the MarcomCentral XML element or elements required to look up the information RICOH ProcessDirector uses to process each item ordered at your MarcomCentral store.

      For example:

      • At one MarcomCentral store, different print items require different media and duplex options. The MarcomCentral elements for product type and product ID identify each print item. RICOH ProcessDirector maps the product type and product ID elements to job properties. RICOH ProcessDirector then uses the values of the job properties to determine the media and duplex setting required for each print item.

      • At another MarcomCentral store, different non-print items require different packing material and gift wrap options. The MarcomCentral element for stock-keeping unit (SKU) ID identifies each non-print item. RICOH ProcessDirector maps the SKU ID element to a job property. RICOH ProcessDirector then uses the SKU ID to determine the packing material and gift wrap options required for each non-print item.

      • At a third MarcomCentral store, a portion of the MarcomCentral SKU ID identifies each print or non-print item. RICOH ProcessDirector maps SKU ID to a job property and uses a substring function in the XSLT style sheet to remove digits that are not needed. RICOH ProcessDirector then uses the portion of the SKU ID to determine the processing options required for each print or non-print item.