Staffing Work Site

Recommendation, 2006 Feb 28

Editors: 

Kim Bartkus, HR-XML Consortium, Inc.

Contributors:  

Paul Kiel, HR-XML Consortium, Inc.

Kim Bartkus, HR-XML Consortium, Inc.

Members of the SIDES global workgroup

Copyright statement

©2006 HR-XML.  All rights reserved.  No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, photocopying, recording, or otherwise, without the prior written permission of the publisher. 

Abstract

The document defines the work site and worksite environment information, which may be used for a variety of business processes such as a temporary staffing order or posting a position.  

Status of this Document

The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED",  "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119.

 

 

 

 

Table of Contents

 

1     Overview.. 3

1.1     Objective. 3

1.2     Relationship to Business Processes. 3

1.3     Scope. 3

1.4     Design Requirements. 3

2     Schema/DTD Design. 4

2.1     WorkSite. 4

2.2     WorkSiteEnvironment 6

3     Implementation Considerations. 8

4     Appendix A - Revision History. 8

5     Appendix B - Related Documents. 8

6     Appendix C – Schema Examples. 9

6.1     WorkSite. 9

6.2     WorkSiteEnvironment 9

 


1    Overview

1.1        Objective

Update the WorkSite and WorkSiteEnvironment schemas to make them flexible enough for international use within SIDES 1.0. The schemas MUST be backwards compatible with the WorkSite and WorkSiteEnvironment.

The schemas were changed to address the new HR-XML architecture. An attribute was also added to EnvironmentConsiderations within WorkSiteEnvironment to specify if the safety equipment is provided by the organization. The files were renamed with a Staffing prefix to differentiate between the SIDES versions from the CPO versions. However, the schema names did not change.

1.2        Relationship to Business Processes

The business purpose for these schemas is to exchange data between staffing companies and their customers or intermediaries. Within the contingent staffing industry, details about the work site and other work environment conditions have an impact on both the StaffingResource selection process and rates, as they relate to a particular position.

1.3        Scope

1.3.1       Within Scope

These versions of WorkSite and WorkSiteEnvironment will belong to the SIDES workgroup.  They will contain:

·         Information pertaining to the site or location of a job or position.

·         Information pertaining to the environment of a job or position.

­          General Considerations

­          Physical Considerations

­          Safety Equipment

­          Dress Code

1.4        Design Requirements

·         Syntax MUST be self-documenting

·         Schema MUST be easy to understand and use

·         Backwards compatible with SIDES 1.0

·         Must take into consideration global requirements

2    Schema/DTD Design

2.1        WorkSite

2.1.1       Schema

 

2.1.2       Schema Elements and Data Types Explained

Component Name

ContentModel
Data type
Occurrence:
Sequence | Choice | All
(minOccurs/maxOccurs)
Attributes

Definition

/
WorkSite

WorkSiteId - WorkSiteIdentifierType - S (0/1)
WorkSiteName - xsd:string - S (1/1)
WorkSiteType - xsd:string - S (0/1)
WorkSiteDetail - xsd:string - S (0/*)
PostalAddress - PostalAddressType - S (0/1)
TravelDirections - xsd:string - S (0/1)

Contains common Work Site information to be used within other HR-XML Schemas.

/ WorkSite/
WorkSiteId

- WorkSiteIdentifierType - S (0/1)

Unique Id to define the worksite

/ WorkSite/ WorkSiteId/
Id

- xsd:string - S (1/1)

A sequence of characters used to identify a WorkSite.

/ WorkSite/ WorkSiteId/
Domain

IdIssuer - xsd:string - S (0/1)
IdType - xsd:string - S (0/1)

Contains the domain information for the Id.

/ WorkSite/ WorkSiteId/ Domain/
IdIssuer

- xsd:string - S (0/1)

The entity responsible for the issuing Id.

/ WorkSite/ WorkSiteId/ Domain/
IdType

- xsd:string - S (0/1)

The type of Id for the Work Site, e.g. WorkSiteId.

/ WorkSite/
WorkSiteName

- xsd:string - S (1/1)

Contains a name or brief description of the worksite, e.g. Office, Warehouse, Fieldwork, etc.

/ WorkSite/
WorkSiteDetail

- xsd:string - S (0/*)

Describes any information not previously defined. For example, when a specific postal address isn't provided, then a brief description may be defined here, such as: Report to 4th floor mailroom.

/ WorkSite/ WorkSiteDetail/
workSiteType

- xsd:string -

Specifies the type or purpose of the worksite, e.g. Report to first day, Report to permanently, Virtual worksite, Report for training, etc.

/ WorkSite/
PostalAddress

- PostalAddressType - S (0/1)

CPO's PostalAddress 1.2 version. Defines the mailing address of the worksite.

/ WorkSite/
TravelDirections

- xsd:string - S (0/1)

Provides directions to the site. These could include directions by bus, air, car, walking, etc.

/ WorkSite/
ParkingDirections

- xsd:string - S (0/1)

Provides instructions for parking, including fees. E.g. parking is available on upper level of parking structure. Fees are $70 per month.  


2.2        WorkSiteEnvironment

2.2.1       Schema

 

2.2.2       Schema Elements and Data Types Explained

Component Name

ContentModel
Data type
Occurrence:
Sequence | Choice | All
(minOccurs/maxOccurs)
Attributes

Definition

/
WorkSiteEnvironment

EnvironmentId - WorkSiteEnvironmentIdentifierType - S (0/1)
EnvironmentName - xsd:string - S (1/1)
EnvironmentDescription - xsd:string - S (0/1)
Considerations - xsd:string - S (0/*)

Contains common Work Site Environment information to be used within other HR-XML Schemas.

/ WorkSiteEnvironment/
EnvironmentId

- WorkSiteEnvironmentIdentifierType - S (0/1)

Unique Id to define the worksite environment.

/ WorkSiteEnvironment/ EnvironmentId/
Id

- xsd:string - S (1/1)

A sequence of characters used to identify a WorkSite Environment.

/ WorkSiteEnvironment/ EnvironmentId/
Domain

IdIssuer - xsd:string - S (0/1)
IdType - xsd:string - S (0/1)

Contains the domain information for the Id.

/ WorkSiteEnvironment/ EnvironmentId/ Domain/
IdIssuer

- xsd:string - S (0/1)

The entity responsible for the issuing Id.

/ WorkSiteEnvironment/ EnvironmentId/ Domain/
IdType

- xsd:string - S (0/1)

The type of Id for the Work Site Environment, e.g. EnvironmentId.

/ WorkSiteEnvironment/
EnvironmentName

- xsd:string - S (1/1)

Contains a name or brief description of the worksite environment, e.g. Office, Warehouse, Fieldwork, etc.

/ WorkSiteEnvironment/
EnvironmentDescription

- xsd:string - S (0/1)

Describes any information not previously defined. For example, square footage of work area.

/ WorkSiteEnvironment/
EnvironmentConsideration

xsd:extension base: xsd:string

Describes any special considerations for the environment. Types are General, Physical, Safety Equipment, and Dress Code.

/ WorkSiteEnvironment/ EnvironmentConsideration/
suppliedByOrganization

-xsd:Boolean

Specifies whether items listed in the EnvironmentConsiderations are provided by the organization. For example: safety glasses, uniforms, etc.

/ WorkSiteEnvironment/ EnvironmentConsideration/
typeConsideration

xsd:restriction base: xsd:string (enumeration)

General Consideration- Additional information on the work environment, which may be useful to both the Staffing Supplier and Human Resource. e.g. lunch facility, smoke free, etc.

Physical Consideration - description of physical aspects of the environment, which may influence the Staffing Supplier or the Human Resource when the position or assignment is offered. E.g. wheelchair accessible, no elevator, climate control, dust level, bio-hazardous material, etc.

SafetyEquipment - defines any safety equipment required for the work site environment. E.g. Hard Hat, safety glasses, steel-toed shoes, etc.

 DressCode - Defines any dress code requirements for the environment. E.g. tie, suit, business casual, etc.

 


3    Implementation Considerations

Most elements in the Schemas are optional; this provides the maximum flexibility for reuse.  Receiving systems must perform their own integrity checking and validation.

4    Appendix A - Revision History

Date

Description

2002-Dec-10

Initial draft

2002-Dec-11

Updated document based on SIDES feedback.

2003-Jan-13

Renamed doc to StaffingWorkSite and schemas to StaffingWorkSite, StaffingWorkSiteEnvironment.

2003-Feb-06

WorkSiteType - corrected table, removed incorrect default.

2003-Feb-26

Approved recommendation by HR-XML Consortium. The default and targetNamespaces of all HR-XML schemas have been standardized to "http://ns.hr-xml.org". This recommendation is available as part of the HR-XML 2_0 architecture.

2004-Aug-02

Changed WorkSiteId and WorkSiteEnvironmentId to optional.

2006-Feb-28

Approved by Consortium

5    Appendix B - Related Documents

Reference

Link

SIDES schemas

http://ns.hr-xml.org/2_4/HR-XML-2_4/SIDES/Assignment.xsd

http://ns.hr-xml.org/2_4/HR-XML-2_4/SIDES/ContactInfo.xsd

http://ns.hr-xml.org/2_4/HR-XML-2_4/SIDES/CustomerReportingRequirements.xsd

http://ns.hr-xml.org/2_4/HR-XML-2_4/SIDES/HumanResource.xsd

http://ns.hr-xml.org/2_4/HR-XML-2_4/SIDES/Rates.xsd

http://ns.hr-xml.org/2_4/HR-XML-2_4/SIDES/ResourceScreening.xsd

http://ns.hr-xml.org/2_4/HR-XML-2_4/SIDES/StaffingAction.xsd

http://ns.hr-xml.org/2_4/HR-XML-2_4/SIDES/StaffingContactType.xsd

http://ns.hr-xml.org/2_4/HR-XML-2_4/SIDES/StaffingOrder.xsd

http://ns.hr-xml.org/2_4/HR-XML-2_4/SIDES/StaffingOrganization.xsd

http://ns.hr-xml.org/2_4/HR-XML-2_4/SIDES/StaffingPosition.xsd

http://ns.hr-xml.org/2_4/HR-XML-2_4/SIDES/StaffingShift.xsd

http://ns.hr-xml.org/2_4/HR-XML-2_4/SIDES/StaffingWorkSite.xsd

http://ns.hr-xml.org/2_4/HR-XML-2_4/SIDES/TimeCardAdditionalData.xsd

SIDES Documentation

http://ns.hr-xml.org/2_4/HR-XML-2_4/SIDES/SIDES.html

http://ns.hr-xml.org/2_4/HR-XML-2_4/SIDES/Assignment.html

http://ns.hr-xml.org/2_4/HR-XML-2_4/SIDES/HumanResource.html

http://ns.hr-xml.org/2_4/HR-XML-2_4/SIDES/StaffingAction.html

http://ns.hr-xml.org/2_4/HR-XML-2_4/SIDES/StaffingOrder.html

http://ns.hr-xml.org/2_4/HR-XML-2_4/SIDES/StaffingOrganization.html

http://ns.hr-xml.org/2_4/HR-XML-2_4/SIDES/SIDESReusableModules.html

http://ns.hr-xml.org/2_4/HR-XML-2_4/SIDES/StaffingInvoice.html

http://ns.hr-xml.org/2_4/HR-XML-2_4/SIDES/StaffingWorkSite.html

http://ns.hr-xml.org/2_4/HR-XML-2_4/SIDES/ExtendedTimeCard.html

OAGIS Invoice and instance

http://ns.hr-xml.org/2_4/HR-XML-2_4/SIDES/Invoice.xsd

(a stand alone version - see http://www.openapplications.org/ for the original)

http://ns.hr-xml.org/2_4/HR-XML-2_4/SIDES/Invoice.xml

User Area

http://ns.hr-xml.org/2_4/HR-XML-2_4/CPO/HRXMLExtension.html

http://ns.hr-xml.org/2_4/HR-XML-2_4/CPO/UserArea.xsd

 PersonName

http://ns.hr-xml.org/2_4/HR-XML-2_4/CPO/PersonName.html

http://ns.hr-xml.org/2_4/HR-XML-2_4/CPO/PersonName.xsd

PostalAddress

http://ns.hr-xml.org/2_4/HR-XML-2_4/CPO/PostalAddress.html

http://ns.hr-xml.org/2_4/HR-XML-2_4/CPO/PostalAddress.xsd

ContactMethod

http://ns.hr-xml.org/2_4/HR-XML-2_4/CPO/ContactMethod.html

http://ns.hr-xml.org/2_4/HR-XML-2_4/CPO/ContactMethod.xsd

PositionHeader

http://ns.hr-xml.org/2_4/HR-XML-2_4/CPO/JobAndPositionHeader.html

http://ns.hr-xml.org/2_4/HR-XML-2_4/CPO/PositionHeader.xsd

DateTimeDataTypes

http://ns.hr-xml.org/2_4/HR-XML-2_4/CPO/DateTimeDataTypes.html

http://ns.hr-xml.org/2_4/HR-XML-2_4/CPO/DateTimeDataTypes.xsd

Resume

http://ns.hr-xml.org/2_4/HR-XML-2_4/SEP/Resume.html

http://ns.hr-xml.org/2_4/HR-XML-2_4/SEP/Resume.xsd

Competencies

http://ns.hr-xml.org/2_4/HR-XML-2_4/CPO/Competencies.html

http://ns.hr-xml.org/2_4/HR-XML-2_4/CPO/Competencies.xsd

TimeCard

http://ns.hr-xml.org/2_4/HR-XML-2_4/TimeCard/TimeCard.html

http://ns.hr-xml.org/2_4/HR-XML-2_4/TimeCard/TimeCard.xsd

 


6    Appendix C – Schema Examples

6.1        WorkSite

<WorkSite>

     <WorkSiteId>

        <Id>RF21</Id>

        <Domain>

           <IdIssuer>Staffing Company</IdIssuer>

           <IdType>WorkSiteId</IdType>

        </Domain>

     </WorkSiteId>

     <WorkSiteName>ResearchFacility</WorkSiteName>

     <WorkSiteDetail workSiteType = "Report to permanently">2nd floor of Research Wing</WorkSiteDetail>

     <PostalAddress>

        <CountryCode>US</CountryCode>

        <PostalCode>60187</PostalCode>

        <Region>IL</Region>

        <Municipality>Wheaton</Municipality>

        <DeliveryAddress>

           <AddressLine>455</AddressLine>

           <StreetName>Meadow Parkway</StreetName>

        </DeliveryAddress>

     </PostalAddress>

     <TravelDirections>Take Interstate 405 to Interstate 5. Take exit 6 south. Go to 2nd traffic light and make a left turn onto Meadow Parkway. First building on right side.</TravelDirections>

     <ParkingInstructions>Park in lot south of building.</ParkingInstructions>

</WorkSite>

6.2        WorkSiteEnvironment

<WorkSiteEnvironment>

     <EnvironmentId>

        <Id>LA21</Id>

        <Domain>

           <IdIssuer>Staffing Company</IdIssuer>

           <IdType>Environment Id</IdType>

        </Domain>

     </EnvironmentId>

     <EnvironmentName>Laboratory</EnvironmentName>

     <EnvironmentDescription>Clean Room</EnvironmentDescription>

     <EnvironmentConsideration typeConsideration = "General">Lunch Room Facilities</EnvironmentConsideration>

     <EnvironmentConsideration typeConsideration = "Physical">Wheelchair Accessible</EnvironmentConsideration>

     <EnvironmentConsideration suppliedByOrganization = “true” typeConsideration = "SafetyEquipment">Protective clothing required in Clean Room</EnvironmentConsideration>

     <EnvironmentConsideration typeConsideration = "DressCode">Business Casual for non-lab activities</EnvironmentConsideration>

</WorkSiteEnvironment>