HR-XML 3.0 Standards, 2009  September  23.

Menu: [ Home  |  Guidelines  |  BODs  |  Nouns  |  Global elements  |  WSDL  |  Packages  |  Code Lists  |  Master Index ]

Trace back: » ch46s26 | ch46s05 | ch03s09 | ch46s28 | ch05s03 »

Assessment Order: Examples

Example 5.1. ProcessAssessmentOrder - Example 1

What follows is an example of using ProcessAssessmentOrder to create an order for an assessment. Note the following:

  • The actionCode attribute of ActionExpression is specified as "Add."

  • The ActionExpression is specified as "/ProcessAssessmentOrder/DataArea/AssessmentOrder."

  • PackageID specifies the test or set of services ordered.

  • The assessment subject's contact information is provided. This would be necessary where the assessment company will contact the subject to schedule a testing time and place. Note that where the requesting company schedules the test, no personally identifying information need be communicated to the assessment provider - only an opaque identifier for the assessment subject would be necessary.

Source


<?xml version="1.0" encoding="UTF-8"?>
<ProcessAssessmentOrder systemEnvironmentCode="Production" releaseID="3.0" languageCode="en-US" xsi:schemaLocation="http://www.hr-xml.org/3 ../Developer/BODs/ProcessAssessmentOrder.xsd" xmlns="http://www.hr-xml.org/3" xmlns:oa="http://www.openapplications.org/oagis/9" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<oa:ApplicationArea>
		<oa:CreationDateTime>2008-10-12T10:09:02.01Z</oa:CreationDateTime>
	</oa:ApplicationArea>
	<DataArea>
		<oa:Process acknowledgeCode="Always">
			<oa:ActionCriteria>
				<oa:ActionExpression actionCode="Add">/ProcessAssessmentOrder/DataArea/AssessmentOrder</oa:ActionExpression>
			</oa:ActionCriteria>
		</oa:Process>
		<AssessmentOrder languageCode="en-US">
			<DocumentID>53RR20031618</DocumentID>
			<CustomerParty>
				<PartyID>OurClient-1342</PartyID>
				<PartyReportingIDs>
					<ID schemeID="PO Number">53RR20031618</ID>
					<ID schemeID="Department Name">Administration</ID>
				</PartyReportingIDs>
			</CustomerParty>
			<PackageID validFrom="2003-01-24">Acct.2002.r1</PackageID>
			<ComparisonGroupID schemeID="Requisition Number">ACCT-1023-58</ComparisonGroupID>
			<AssessmentRequesterName>Dawn Dart</AssessmentRequesterName>
			<AssessmentSubject>
				<SubjectID schemeAgencyID="Recruiting Co">12345</SubjectID>
				<PersonName>
					<FormattedName>John Smith</FormattedName>
					<oa:GivenName>John</oa:GivenName>
					<FamilyName>Smith</FamilyName>
				</PersonName>
				<Communication>
					<ChannelCode>Email</ChannelCode>
					<UseCode>business</UseCode>
					<oa:URI>john.smith@epredix.com</oa:URI>
				</Communication>
			</AssessmentSubject>
			<AssessmentLanguageCode>EN-US</AssessmentLanguageCode>
			<AssessmentResultLanguageCode>en-US</AssessmentResultLanguageCode>
			<AssessmentResultLanguageCode>de-DE</AssessmentResultLanguageCode>
		</AssessmentOrder>
	</DataArea>
</ProcessAssessmentOrder>
<!--


Copyright The HR-XML Consortium. All Rights Reserved. http://www.hr-xml.org 
Copyright (c) 1997-2009 Open Applications Group, Inc. All Rights Reserved 
-->



Example 5.2. AcknowledgeAssessmentOrder - Example 1

The example below is based on the previous message that created an order. "Acknowledge" is a response verb. ResponseExpressions are used to point to two new pieces of data that the provider has associated with the order: an OrderID and AssessmentAccess.

As discussed in the separate data management document, trading partners need to have well defined and understood approaches to the way they handle data. In the example below, the acknowledgement includes only the additional incremental components (OrderID and AssessmentAccess). Trading partners relying on a "snapshot" or "full-file" data management approach might provide the entire AssessmentOrder including the two modifications.

Source


<?xml version="1.0" encoding="UTF-8"?>
<AcknowledgeAssessmentOrder 
		systemEnvironmentCode="Production" 
		releaseID="3.0" 
		languageCode="en-US" 
             xsi:schemaLocation="http://www.hr-xml.org/3 ../Developer/BODs/AcknowledgeAssessmentOrder.xsd" 
		xmlns="http://www.hr-xml.org/3" 
		xmlns:oa="http://www.openapplications.org/oagis/9" 
		xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<oa:ApplicationArea>
		<oa:CreationDateTime>2008-10-12T10:10:10.10Z</oa:CreationDateTime>
	</oa:ApplicationArea>
	<DataArea>
		<oa:Acknowledge>
			<oa:OriginalApplicationArea>
				<oa:CreationDateTime>2008-10-12T10:09:02.01Z</oa:CreationDateTime>
			</oa:OriginalApplicationArea>
			<oa:ResponseCriteria>
				<oa:ResponseExpression actionCode="Accepted">/AcknowledgeAssessmentOrder/DataArea/AssessmentOrder</oa:ResponseExpression>
			</oa:ResponseCriteria>
			<oa:ResponseCriteria>
				<oa:ResponseExpression actionCode="Modified">/AcknowledgeAssessmentOrder/DataArea/AssessmentOrder/DocumentIDGroup/DocumentID</oa:ResponseExpression>
			</oa:ResponseCriteria>
			<oa:ResponseCriteria>
				<oa:ResponseExpression actionCode="Modified">/AcknowledgeAssessmentOrder/DataArea/AssessmentOrder/AssessmentAccessDetails</oa:ResponseExpression>
			</oa:ResponseCriteria>
		</oa:Acknowledge>
		<AssessmentOrder languageCode="en-US">
			<DocumentID schemeID="Order ID">53RR20031618-1</DocumentID>
			<AssessmentAccess>
				<AssessmentCommunication>
						<oa:URI>http://www.assessmentprovider.com/test/ares08.r1</oa:URI>
				</AssessmentCommunication>
				<AccessCredentials>
					<UserID>john.smith@epredix.com</UserID>
					<AccessCredential>
						<AccessCredentialTypeCode>Password</AccessCredentialTypeCode>
						<AccessCredentialValue>ad7x111</AccessCredentialValue>
					</AccessCredential>
				</AccessCredentials>
			</AssessmentAccess>
		</AssessmentOrder>
	</DataArea>
</AcknowledgeAssessmentOrder>
<!--


Copyright The HR-XML Consortium. All Rights Reserved. http://www.hr-xml.org 
Copyright (c) 1997-2009 Open Applications Group, Inc. All Rights Reserved 
-->



Example 5.3. CancelAssessmentOrder - Example 1

Whether and how a customer can cancel an assessment order requires an understanding between trading partners. In the scenario below, it is assumed that a "business calculation" is required regarding cancelation requests (thus the use of the Cancel verb versus using the Process verb and a Delete action code).

  • An "Incremental" style update is assumed (see separate document on Data Management).

  • The ActionExpression is scoped at the /CancelAssessmentOrder/DataArea/AssessmentOrder level. "Delete" is specified as the actionCode.

  • The associated DocumentID is specified. No other content is provided.

Source


<?xml version="1.0" encoding="UTF-8"?>
<CancelAssessmentOrder 
                systemEnvironmentCode="Production" 
				releaseID="3.0" 
				languageCode="en-US" 
				 xsi:schemaLocation="http://www.hr-xml.org/3 ../Developer/BODs/CancelAssessmentOrder.xsd" 
				 xmlns="http://www.hr-xml.org/3" 
				 xmlns:oa="http://www.openapplications.org/oagis/9" 
				 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<oa:ApplicationArea>
		<oa:CreationDateTime>2008-11-11T12:10:10.10Z</oa:CreationDateTime>
	</oa:ApplicationArea>
	<DataArea>
		<oa:Cancel>
		<oa:ActionCriteria>
		<oa:ActionExpression actionCode="">/CancelAssessmentOrder/DataArea/AssessmentOrder</oa:ActionExpression>
			</oa:ActionCriteria>
		</oa:Cancel>
		<AssessmentOrder languageCode="en-US">
		<DocumentID schemeID="Order ID">53RR20031618</DocumentID>
		</AssessmentOrder>
	</DataArea>
</CancelAssessmentOrder>
<!--


Copyright The HR-XML Consortium. All Rights Reserved. http://www.hr-xml.org 
Copyright (c) 1997-2009 Open Applications Group, Inc. All Rights Reserved 
-->



Links to Additional Assessment Order Examples

ProcessAssessmentOrder - Example 2

Comment on this Component


Use the form below to submit your question or comment about "ch05s03"

By submitting you indicate that you are accepting HR-XML's Feedback Policy


  * = required field
First/Given Name: *
Last/Family Name: *
Position Title:
Organization:
Country:
Website:
E-mail: *
Topic:

  Please use the area below to write your comment or question: