Find_Organization Operation Details (2024)

This operation responds with a set of references to Organizations that match the criteria specified in the request element.

@ - A parameter name with this symbol denotes an XML attribute within the document instead of an XML element.

Request Element: Organization_Find

Utilize the following criteria options to search for Organizations within the Workday system. The Organization references that are returned are those that satisfy ALL criteria included in the request. Therefore, the result set will become more limited with every criterium that is populated.

Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version
As_Of_Date date [0..1] Defines the As Of Date to be used for any application effective dated data within the Workday system. For "Find" operations, the "As Of Date" determines what data to be used within the search logic. For "Get" operations, the response element will only include data that is the most effective as of the "As Of Date".
Organization_Name string [0..1] If specified, this search criterium will return those references with an exact match. The search index used to query on this value is not case-sensitive.
Location_Reference_Data Business_Site_Reference_Data [0..1] If specified, this search criterium will return those references with an exact match. The search index used to query on this value is not case-sensitive.
Validation Description
Location Reference does not exist. A valid instance of Location must exist for the given Integration ID Reference.
Employee_Reference_Data Employee_Reference [0..1] If specified, this search criterium will return those references with an exact match. The search index used to query on this value is not case-sensitive.
Validation Description
Employee Reference Integration ID does not exist! A valid instance of Employee must exist for the given Integration ID Reference.
Contingent_Worker_Reference_Data Contingent_Worker_Reference_Data [0..1] If specified, this search criterium will return those references with an exact match. The search index used to query on this value is not case-sensitive.
Validation Description
Contingent Worker Reference Integration ID does not exist! A valid instance of Contingent Worker must exist for the given Integration ID Reference.
top

Response Element: Organization_References

Set of Organization Reference elements.

Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version
@As_Of_Date date [0..1] Defines the As Of Date to be used for any application effective dated data within the Workday system. For "Request" elements, the "As Of Date" determines what data is to be used within search logic or returned in a response. For "Response" elements, this element will echo "As Of Date" entered in the "Request" element or the default "As Of Date" if omitted..
Organization_Reference Organization_Reference_WWS [0..*] Reference element representing an object within the Workday system. The sub-elements and attributes within this element are used to return one and only one instance of the identifying object.
Validation Description
Organization Reference Integration ID does not exist! A valid instance of Organization must exist for the given Integration ID Reference.
Only Integration ID Reference or Organization ID Reference is allowed for the Organization Reference, but both are not allowed. Only Integration ID Reference or Organization ID Reference is allowed for the Organization Reference, but both are not allowed.
top

Business_Site_Reference_Data

part of: Organization_Find

Reference element representing a unique instance of Location.

Parameter name Type/Value Cardinality Description Validations
Integration_ID_Reference External_Integration_ID_Reference_Data [1..1] Integration ID reference is used as a unique identifier for integratable objects in the Workday system.
Validation Description
Location Reference does not exist. A valid instance of Location must exist for the given Integration ID Reference.
top

External_Integration_ID_Reference_Data

part of: Business_Site_Reference_Data, Employee_Reference, Contingent_Worker_Reference_Data, Organization_Reference_WWS

Integration ID reference is used as a unique identifier for integratable objects in the Workday system.

Parameter name Type/Value Cardinality Description Validations
@Descriptor string [0..1] Display name inside the Workday system.
ID ID [1..1] External ID that uniquely identifies the integratable object within the context of the integration system identified by the System ID attribute.
top

ID

part of: External_Integration_ID_Reference_Data

External ID that uniquely identifies the integratable object within the context of the integration system identified by the System ID attribute.

Parameter name Type/Value Cardinality Description Validations
#text string
@System_ID string [0..1] Integration system identifier, part of a two part key (including the text value of the ID element) that uniquely identify integratable object.
Validation Description
Integration System ID does not exist. A valid instance of Integration ID must exist for the given System ID.
top

Employee_Reference

part of: Organization_Find

Reference element representing a unique instance of Employee.

Parameter name Type/Value Cardinality Description Validations
Integration_ID_Reference External_Integration_ID_Reference_Data [1..1] Integration ID reference is used as a unique identifier for integratable objects in the Workday system.
Validation Description
Employee Reference Integration ID does not exist! A valid instance of Employee must exist for the given Integration ID Reference.
top

Contingent_Worker_Reference_Data

part of: Organization_Find

Reference element representing a unique instance of Contingent Worker.

Parameter name Type/Value Cardinality Description Validations
Integration_ID_Reference External_Integration_ID_Reference_Data [1..1] Integration ID reference is used as a unique identifier for integratable objects in the Workday system.
Validation Description
Contingent Worker Reference Integration ID does not exist! A valid instance of Contingent Worker must exist for the given Integration ID Reference.
top

Organization_Reference_WWS

part of: Organization_References

Reference element representing a unique instance of Organization.

Parameter name Type/Value Cardinality Description Validations
Integration_ID_Reference External_Integration_ID_Reference_Data [0..1] Integration ID reference is used as a unique identifier for integratable objects in the Workday system.
Organization_ID_Reference OrganizationObject [0..1] Contains a reference to the organization.
Validation Description
Organization Reference Integration ID does not exist! A valid instance of Organization must exist for the given Integration ID Reference.
Only Integration ID Reference or Organization ID Reference is allowed for the Organization Reference, but both are not allowed. Only Integration ID Reference or Organization ID Reference is allowed for the Organization Reference, but both are not allowed.
top

OrganizationObject

part of: Organization_Reference_WWS
Parameter name Type/Value Cardinality Description Validations
@Descriptor string [0..1] Display information used to describe an instance of an object. This 'optional' information is for outbound descriptive purposes only and is not processed on inbound Workday Web Services requests.
ID OrganizationObjectID [0..*] Contains a unique identifier for an instance of an object.
top

OrganizationObjectID

part of: OrganizationObject

Contains a unique identifier for an instance of an object.

Parameter name Type/Value Cardinality Description Validations
#text string
@type WID, Company_Reference_ID, Cost_Center_Reference_ID, Custom_Organization_Reference_ID, Organization_Reference_ID, Region_Reference_ID [1..1] The unique identifier type. Each "ID" for an instance of an object contains a type and a value. A single instance of an object can have multiple "ID" but only a single "ID" per "type". Some "types" require a reference to a parent instance.
top

OrganizationReferenceEnumeration

part of: OrganizationObjectID
Base Type
string
top
Find_Organization Operation Details (2024)
Top Articles
Latest Posts
Article information

Author: Horacio Brakus JD

Last Updated:

Views: 5778

Rating: 4 / 5 (51 voted)

Reviews: 90% of readers found this page helpful

Author information

Name: Horacio Brakus JD

Birthday: 1999-08-21

Address: Apt. 524 43384 Minnie Prairie, South Edda, MA 62804

Phone: +5931039998219

Job: Sales Strategist

Hobby: Sculling, Kitesurfing, Orienteering, Painting, Computer programming, Creative writing, Scuba diving

Introduction: My name is Horacio Brakus JD, I am a lively, splendid, jolly, vivacious, vast, cheerful, agreeable person who loves writing and wants to share my knowledge and understanding with you.