Creating an order property mapping
Before you begin, generate a sample order XML file using your order management system. Try to create a file that includes representative samples of the jobs you usually process. For example, include:
- Orders with multiple jobs
- Orders with different types of jobs
- Multiple orders in one XML file
- High Priority or Rush orders
When you have the XML file, open it in a text editor and review the structure. Identify the XML tags that indicate where each order begins, and then inside each order, where each job begins.
- Note:
- Different types of orders (and jobs) can use different XML elements. Make note of all the elements that identify the beginning of an order or job.
- If you cannot include all types of orders in one file, export multiple XML files.
In addition, review the elements that include information about orders or jobs, such as a due date, number of copies, or the order identifier in the ordering system. Decide which values you want to use in RICOH ProcessDirector as order or job properties and which RICOH ProcessDirector properties they correspond with.
After you have reviewed the file, make sure that it is available to upload.
To create an order property mapping:
- Click the Administration tab.
- In the left pane, click .
- Click Add in the top right corner, and select Order Mapping.
- In section 1, enter a name for the object and choose the time format that is used in the sample XML file.
- In the Sample order XML file field, find the sample file that you exported and reviewed, and click Open.
- In section 2, IDENTIFY ORDERS AND JOBS:
- In a field under XML element (XPath expression), select an XML element that you identified as the beginning of an order. Under Represents, choose Order.
- In the next row, under XML element (XPath expression), choose an element that represents
jobs inside the order from the previous step. Under Represents, choose Job.
- Note:
- You must include at least two XML elements in this section: one to identify orders and one to identify the jobs within that type of order. The XML element identifying jobs must be a child of the XML element identifying the order.
- Orders cannot contain orders, so the XML element representing an order cannot be a child of another order element.
- If you found more than one element that indicates the beginnings of orders or jobs, add more rows to this section. Click to the right of any row and select the XML element and object type for each order and job identifier you found.
- Continue with section 3 after you add all the order and job identifiers.
- In section 3, MAP ELEMENTS TO PROPERTIES:
- Refer to the list of elements whose values you want to use in RICOH ProcessDirector and their corresponding properties that you created before you started the procedure. In the first row, under XML element (XPath expression), choose one of the elements. Under Object type, choose Order or Job.
- Under Property, select the RICOH ProcessDirector property to use to store the value.
- Repeat these steps for each element you want to use as an order or job property. To add more mapping rows, click to the right of any mapping. To delete a mapping, click to the right of the mapping you want to delete.
- Click OK.