Service Directory > v31.2 > Human_Resources > Assign_Members_to_Custom_Organization
 

Operation: Assign_Members_to_Custom_Organization

Directly assign or unassign worker positions as members to a custom organization. The custom organization type must be configured in 'Maintain Organization Types' as 'Allow Reorganization Tasks (like Move Workers, Assign Workers)' = Y and 'Position Unique' = N. The Reorganization determines the effective date that a position is added as a member. In the UI, the equivalent task is executed via related action off the custom organization: Reorganization > Assign Workers > Select Workers by Individual.


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


Contents

 

Web Service

 

Request

 

Response

 

Element(s)

 

Request Element: Assign_Members_to_Custom_Organization_Request

Request element having the organization, positions to be added/removed and the effective date.
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
Assign_Members_to_Custom_Organization_Reference  OrganizationObject  [1..1]  Custom organization with options ‘Allow Organization Tasks’ = Yes and ‘Position Assignment Unique’ = No 
Validation Description
The entered Organization must be a custom organization whose organization type is configured with options: ‘Allow Organization Tasks’ = Yes and ‘Position Assignment Unique’ = No.   
 
Assign_Members_to_Custom_Organization_Data  Assign_Members_to_Custom_Organization_Data  [0..1]  Sub element of the request having positions to add/remove.   
top
 

Response Element: Assign_Members_to_Custom_Organization_Response

Response element, returning only the organization.
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
Assign_Workers_to_Custom_Organization_Reference  OrganizationObject  [0..1]  Returning custom organization.   
top
 

OrganizationObject

part of: Assign_Members_to_Custom_Organization_Request, Assign_Members_to_Custom_Organization_Response
 
Parameter name Type/Value Cardinality Description Validations
@Descriptor  string  [1..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".   
top
 

Assign_Members_to_Custom_Organization_Data

part of: Assign_Members_to_Custom_Organization_Request
Sub element of the request having positions to add/remove.
 
Parameter name Type/Value Cardinality Description Validations
Reorganization_Reference  ReorganizationObject  [1..1]  Reorganization determines the effective date that positions are added as a member   
Positions_to_Add_Reference  Position_ElementObject  [0..*]  The position or position restriction you want to add to the custom organization. For position restrictions, Workday uses the reorganization effective date to determine the position. When a position restriction has job overlap as of the reorganization effective date, Workday assigns membership to the principal and overlap positions. If the position is unavailable or unfilled as of the date you view the custom organization it's assigned to, Workday doesn't display it.   
Positions_to_Remove_Reference  Position_ElementObject  [0..*]  Positions to be removed from the custom organization. 
Validation Description
'Positions to Remove’ contains one or more positions that are are not assigned to the Organization as of the specified effective date.   
 
top
 

ReorganizationObject

part of: Assign_Members_to_Custom_Organization_Data
 
Parameter name Type/Value Cardinality Description Validations
@Descriptor  string  [1..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  ReorganizationObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

ReorganizationObjectID

part of: ReorganizationObject
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, Reorganization_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".   
top
 

Position_ElementObject

part of: Assign_Members_to_Custom_Organization_Data, Assign_Members_to_Custom_Organization_Data
 
Parameter name Type/Value Cardinality Description Validations
@Descriptor  string  [1..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  Position_ElementObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

Position_ElementObjectID

part of: Position_ElementObject
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, Position_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".   
top
 

OrganizationReferenceEnumeration

part of: OrganizationObjectID
Base Type
string
top
 

ReorganizationReferenceEnumeration

part of: ReorganizationObjectID
Base Type
string
top
 

Position_ElementReferenceEnumeration

part of: Position_ElementObjectID
Base Type
string
top