workday.compensation
Module workday.compensation
API
Definitions
![](https://bcentral-packageicons.azureedge.net/images/ballerinax_workday.compensation_1.5.1.png)
ballerinax/workday.compensation Ballerina library
Overview
This is a generated connector for WorkDay Compensation REST API v1 OpenAPI specification.
The Workday compensation service enables applications to extend Workday's HCM compensation features.
Prerequisites
Before using this connector in your Ballerina application, complete the following:
- Create a workday application in the Credential Administrator console
- Obtain tokens by following this guide
Clients![](/images/permalink.svg)
workday.compensation: Client![](/images/permalink.svg)
This is a generated connector for WorkDay Compensation REST API v1 OpenAPI specification. The Workday compensation service enables applications to extend Workday's HCM compensation features.
Constructor![](/images/permalink.svg)
Gets invoked to initialize the connector
.
The connector initialization requires setting the API credentials.
Follow [this guide] https://credentials.workday.com/docs/authentication/ and obtain tokens.
init (ConnectionConfig config, string serviceUrl)
- config ConnectionConfig - The configurations to be used when initializing the
connector
- serviceUrl string - URL of the target service
getScorecardResults![](/images/permalink.svg)
function getScorecardResults(int? 'limit, int? offset) returns InlineResponse200|error
Provides the ability to set up and retrieve Scores on Scorecard Results.
Parameters
- 'limit int? (default ()) - The maximum number of objects in a single response. The default is 20. The maximum is 100.
- offset int? (default ()) - The zero-based index of the first object in a response collection. The default is 0. Use offset with the limit parameter to control paging of a response collection. Example: If limit is 5 and offset is 9, the response returns a collection of 5 objects starting with the 10th object.
Return Type
- InlineResponse200|error - Successful response. A successful response can return no matched data.
createsNewScorecardResults![](/images/permalink.svg)
function createsNewScorecardResults(CreateScorecardResults payload) returns CreateScorecardResults|error
Creates a new Scorecard Result.
Parameters
- payload CreateScorecardResults -
Return Type
- CreateScorecardResults|error - Resource created.
getCompensationScorecards![](/images/permalink.svg)
function getCompensationScorecards(string? effectiveDate, int? 'limit, int? offset) returns InlineResponse2001|error
Retrieves Compensation Scorecard information.
Parameters
- effectiveDate string? (default ()) - Effective date the scorecard task takes effect.
- 'limit int? (default ()) - The maximum number of objects in a single response. The default is 20. The maximum is 100.
- offset int? (default ()) - The zero-based index of the first object in a response collection. The default is 0. Use offset with the limit parameter to control paging of a response collection. Example: If limit is 5 and offset is 9, the response returns a collection of 5 objects starting with the 10th object.
Return Type
- InlineResponse2001|error - Successful response. A successful response can return no matched data.
createsCompensationScorecards![](/images/permalink.svg)
function createsCompensationScorecards(CreateScoreCard payload, string? effectiveDate) returns CreateScoreCard|error
Creates a Compensation Scorecard
Parameters
- payload CreateScoreCard -
- effectiveDate string? (default ()) - Effective date the scorecard task takes effect.
Return Type
- CreateScoreCard|error - Resource created.
getWorkerInstance![](/images/permalink.svg)
function getWorkerInstance(string id) returns WorkerProfile|error
Retrieves a worker instance.
Parameters
- id string - The Workday ID of the resource.
Return Type
- WorkerProfile|error - Successful response. A successful response can return no matched data.
getAndSetUpScoresOnScorecardResults![](/images/permalink.svg)
function getAndSetUpScoresOnScorecardResults(string id) returns ScoresetContainer|error
Provides the ability to set up and retrieve Scores on Scorecard Results.
Parameters
- id string - The Workday ID of the resource.
Return Type
- ScoresetContainer|error - Successful response. A successful response can return no matched data.
deleteScorecardResultsByID![](/images/permalink.svg)
Deletes the Scorecard Results with the specified ID.
Parameters
- id string - The Workday ID of the resource.
Return Type
getWorkerCollection![](/images/permalink.svg)
function getWorkerCollection(int? 'limit, int? offset, string? search) returns InlineResponse2002|error
Retrieves a collection of workers.
Parameters
- 'limit int? (default ()) - The maximum number of objects in a single response. The default is 20. The maximum is 100.
- offset int? (default ()) - The zero-based index of the first object in a response collection. The default is 0. Use offset with the limit parameter to control paging of a response collection. Example: If limit is 5 and offset is 9, the response returns a collection of 5 objects starting with the 10th object.
- search string? (default ()) - Searches ~workers~ by name. The search is case-insensitive. You can include space-delimited search strings for an OR search.
Return Type
- InlineResponse2002|error - Successful response. A successful response can return no matched data.
requestOneTimePayment![](/images/permalink.svg)
function requestOneTimePayment(string id, OneTimePaymentPlanEventInput payload) returns OneTimePaymentPlanEventInput|error
Request a one-time payment for a worker with the specified ID.
Return Type
- OneTimePaymentPlanEventInput|error - Resource created.
updateScore![](/images/permalink.svg)
function updateScore(string id, string subresourceID, ScoreInput payload) returns ScoreInput|error
Updates the Score for the specified Scorecard Result.
Parameters
- id string - The Workday ID of the resource.
- subresourceID string - The Workday ID of the subresource.
- payload ScoreInput -
Return Type
- ScoreInput|error - Successful response. A successful response can return no matched data. Updating resource.
getCompensationScoreCardInfo![](/images/permalink.svg)
Retrieves Compensation Scorecard information.
Parameters
- id string - The Workday ID of the resource.
updateCompensationScorecard![](/images/permalink.svg)
function updateCompensationScorecard(string id, EditScoreCards payload) returns EditScoreCards|error
Updates a Compensation Scorecard
Return Type
- EditScoreCards|error - Successful response. A successful response can return no matched data. Updating resource.
deleteCompensationScorecardByID![](/images/permalink.svg)
Deletes a Compensation Scorecard with the specified ID.
Parameters
- id string - The Workday ID of the resource.
Records![](/images/permalink.svg)
workday.compensation: ClientHttp1Settings![](/images/permalink.svg)
Provides settings related to HTTP/1.x protocol.
Fields
- keepAlive KeepAlive(default http:KEEPALIVE_AUTO) - Specifies whether to reuse a connection for multiple requests
- chunking Chunking(default http:CHUNKING_AUTO) - The chunking behaviour of the request
- proxy ProxyConfig? - Proxy server related options
workday.compensation: ConnectionConfig![](/images/permalink.svg)
Provides a set of configurations for controlling the behaviours when communicating with a remote HTTP endpoint.
Fields
- auth BearerTokenConfig - Configurations related to client authentication
- httpVersion HttpVersion(default http:HTTP_2_0) - The HTTP version understood by the client
- http1Settings ClientHttp1Settings? - Configurations related to HTTP/1.x protocol
- http2Settings ClientHttp2Settings? - Configurations related to HTTP/2 protocol
- timeout decimal(default 60) - The maximum time to wait (in seconds) for a response before closing the connection
- forwarded string(default "disable") - The choice of setting
forwarded
/x-forwarded
header
- poolConfig PoolConfiguration? - Configurations associated with request pooling
- cache CacheConfig? - HTTP caching related configurations
- compression Compression(default http:COMPRESSION_AUTO) - Specifies the way of handling compression (
accept-encoding
) header
- circuitBreaker CircuitBreakerConfig? - Configurations associated with the behaviour of the Circuit Breaker
- retryConfig RetryConfig? - Configurations associated with retrying
- responseLimits ResponseLimitConfigs? - Configurations associated with inbound response size limits
- secureSocket ClientSecureSocket? - SSL/TLS-related options
- proxy ProxyConfig? - Proxy server related options
- validation boolean(default true) - Enables the inbound payload validation functionality which provided by the constraint package. Enabled by default
workday.compensation: CreateGoals![](/images/permalink.svg)
Fields
- goalDescription string? - The description of the Compensation Scorecard Goal
- goalWeight int - The weight given to the Compensation Scorecard Goal. [90% will be displayed as 0.9]
- goalName string - The name of the Compensation Scorecard Goal.
- id string? - Id of the instance
workday.compensation: CreateScoreCard![](/images/permalink.svg)
Fields
- effectiveDate string - The Effective Date of the Compensation Scorecard in format YYYY-MM-DD
- scorecardName string - The name of the Compensation Scorecard.
- defaultScorecardGoals CreateGoals[] - The ~goals~ for the Compensation Scorecard.
- scorecardProfiles CreateScorecardProfiles[]? - The profiles for the Compensation Scorecard.
- inactive boolean? - Indicates whether the Scorecard is inactive using a value of true/false.
- scorecardDescription string? - The description of the Compensation Scorecard.
- id string? - Id of the instance
workday.compensation: CreateScorecardProfiles![](/images/permalink.svg)
Fields
- profileScorecardGoals CreateGoals[] - The ~goals~ for the Compensation Scorecard.
- eligibilityRule EligibilityRule -
- id string? - Id of the instance
workday.compensation: CreateScorecardResults![](/images/permalink.svg)
Fields
- scorecardName string? - The ~goal~ name of the scorecard criteria result.
- scorecardID ScoreCardID -
- evaluationDate string - Scorecard Result Evaluation Date
- descriptor string? - A preview of the instance
- id string? - Id of the instance
workday.compensation: DefaultScoreCard![](/images/permalink.svg)
Fields
- id string? - Id of the instance
workday.compensation: DefaultScorecardGoalsResult![](/images/permalink.svg)
Fields
- Fields Included from *ScoreSet
- eligibiltyRule EligibiltyRule
- performanceScores ScoresetScore[]
- weightedFundingPercent int
- id string
- descriptor string
- anydata...
workday.compensation: EditScoreCards![](/images/permalink.svg)
Fields
- inactive boolean? - Replaces the inactive status of the Compensation Scorecard as of the specified effectiveDate. Default value: false.
- effectiveDate string - The Effective Date of the updates to the Compensation Scorecard. Date must be entered in format: YYYY-MM-DD.
- scorecardDescription string? - Replaces the description of the Compensation Scorecard as of the specified effectiveDate. Deletes the description if a description exists as of the specified effectiveDate and this field is not included in the PUT.
- scorecardProfiles ScorecardProfiles[]? - Replaces the array of Profile Scorecard Goals and Eligibility Rules as of the specified effectiveDate. Creates a new array if one does not exist. Deletes the array if one exists as of the specified effectiveDate and the array is not included in the PUT.
- defaultScorecardGoals ScoreCardGoals[] - Replaces the array of Default Scorecard Goal fields as of the specified effectiveDate.
- scorecardName string - Replaces the name of the Compensation Scorecard as of the specified effectiveDate.
- id string? - Id of the instance
workday.compensation: EligibilityRule![](/images/permalink.svg)
Fields
- Fields Included from *InstanceModelReference
workday.compensation: EligibiltyRule![](/images/permalink.svg)
Fields
- Fields Included from *InstanceModelReference
workday.compensation: ErrorModelReference![](/images/permalink.svg)
Fields
- 'error string - A description of the error
workday.compensation: FacetsModelReferenceInner![](/images/permalink.svg)
This object represents the possible facets for this resource
Fields
- descriptor string? - A description of the facet
- facetParameter string? - The alias used to select the facet
workday.compensation: GoalID![](/images/permalink.svg)
Fields
- Fields Included from *ScoreGoal
- id string
- anydata...
workday.compensation: InlineResponse200![](/images/permalink.svg)
collection something or other
Fields
- data ScoresetContainer[]? -
- total int? -
workday.compensation: InlineResponse2001![](/images/permalink.svg)
collection something or other
Fields
- data ScoreCard[]? -
- total int? -
workday.compensation: InlineResponse2002![](/images/permalink.svg)
collection something or other
Fields
- data WorkerSummary[]? -
- total int? -
workday.compensation: InstanceModelReference![](/images/permalink.svg)
Fields
- id string - wid / id / reference id
- descriptor string? - A description of the instance
- href string? - A link to the instance
workday.compensation: Location![](/images/permalink.svg)
Fields
- Fields Included from *InstanceModelReference
workday.compensation: MultipleInstanceModelReference![](/images/permalink.svg)
Fields
- total int? -
- data InstanceModelReference[]? -
workday.compensation: OneTimePaymentInput![](/images/permalink.svg)
Fields
- payrollWorktags PayrollWorkTags[]? - One-Time Payment Worktags for REST API
- paymentCurrency PaymentCurrency? -
- coverageStartDate string? - The start date of the Coverage Period for the payment, which enables Workday Payroll or Payroll Integration to associate dates with the one-time payment for Fair Labor Standards Act (FLSA) reporting requirements.
- paymentAmount record {}? - Amount of compensation payment
- coverageEndDate string? - The end date of the Coverage Period for the payment, which enables Workday Payroll or Payroll Integration to associate dates with the one-time payment for Fair Labor Standards Act (FLSA) reporting requirements.
- additionalInformation string? - Additional information for this compensation payment
- paymentPercent int? - The actual amount for the ~bonus~ payment represented as a percentage. The percentage is usually calculated as a percentage of base pay, but on the ~bonus~ plan setup it is possible to override the calculation basis to calculate as a percentage of a set of compensation elements.
- oneTimePaymentPlan OneTimePaymentPlan? -
- scheduledPaymentDate string? - The payment date scheduled for the one-time payment request.
- sendToPayroll boolean? - This is true if you selected Send to Payroll on the ~bonus~ payment, future payment, or one-time payment. If false, Workday Payroll doesn't process the payment.
- descriptor string? - A preview of the instance
- id string? - Id of the instance
workday.compensation: OneTimePaymentPlan![](/images/permalink.svg)
Fields
- Fields Included from *InstanceModelReference
workday.compensation: OneTimePaymentPlanEventInput![](/images/permalink.svg)
Fields
- reason Reason? -
- effectiveDate string? - The date this business process takes effect.
- employeeVisibilityDate string? - Returns the date that a compensation change is visible to a ~worker~.
- position Position? -
- oneTimePayments OneTimePaymentInput[]? - All one-time payments associated with the event.
- id string? - Id of the instance
- descriptor string? - A preview of the instance
workday.compensation: PaymentCurrency![](/images/permalink.svg)
Fields
- Fields Included from *InstanceModelReference
workday.compensation: PayrollWorkTags![](/images/permalink.svg)
Fields
- id string? - Id of the instance
- descriptor string? - A preview of the instance
workday.compensation: Position![](/images/permalink.svg)
Fields
- Fields Included from *InstanceModelReference
workday.compensation: PrimarySupervisoryOrganization![](/images/permalink.svg)
Fields
- Fields Included from *InstanceModelReference
workday.compensation: ProxyConfig![](/images/permalink.svg)
Proxy server configurations to be used with the HTTP client endpoint.
Fields
- host string(default "") - Host name of the proxy server
- port int(default 0) - Proxy server port
- userName string(default "") - Proxy server username
- password string(default "") - Proxy server password
workday.compensation: Reason![](/images/permalink.svg)
Fields
- Fields Included from *InstanceModelReference
workday.compensation: ScoreCard![](/images/permalink.svg)
Fields
- inactive boolean? - Indicates whether the Scorecard is inactive using a value of true/false.
- defaultScorecardGoals ScorecardGoalSummary[]? - The goals for the Compensation Scorecard.
- scorecardDescription string? - The description of the Compensation Scorecard.
- scorecardProfiles ScoreCardProfile[]? - The profiles for the Compensation Scorecard.
- scorecardName string? - The name of the Compensation Scorecard.
- effectiveDate string? - The Effective Date of the Compensation Scorecard in format YYYY-MM-DD.
- id string? - Id of the instance
workday.compensation: ScoreCardGoals![](/images/permalink.svg)
Fields
- goalDescription string? - Replaces the description of the Compensation Scorecard Goal as of the specified effectiveDate. Deletes the description if a description exists as of the specified effectiveDate and this field is not included in the PUT.
- goalWeight int - Replaces the weight of the Compensation Scorecard ~Goal~ as of the specified effectiveDate. [Weight should be entered as 0.9 for a goalWeight of 90%]
- goalName string - Replaces the name of the Compensation Scorecard Goal as of the specified effectiveDate.
- id string? - Id of the instance
workday.compensation: ScorecardGoalSummary![](/images/permalink.svg)
Fields
- goalWeight int? - The weight given to the Compensation Scorecard ~Goal~. [90% will be displayed as 0.9]
- goalDescription string? - The description of the Compensation Scorecard ~Goal~.
- goalName string? - The name of the Compensation Scorecard ~Goal~.
- id string? - Id of the instance
workday.compensation: ScoreCardID![](/images/permalink.svg)
Fields
- Fields Included from *DefaultScoreCard
- id string
- anydata...
workday.compensation: ScorecardID![](/images/permalink.svg)
Fields
- Fields Included from *DefaultScoreCard
- id string
- anydata...
workday.compensation: ScoreCardProfile![](/images/permalink.svg)
Fields
- eligibilityRule EligibilityRule? -
- profileScorecardGoals ScorecardGoalSummary[]? - The goals for the Compensation Scorecard.
- id string? - Id of the instance
workday.compensation: ScorecardProfiles![](/images/permalink.svg)
Fields
- eligibilityRule EligibilityRule -
- profileScorecardGoals ScoreCardGoals[] - Replaces the array of Profile Scorecard Goal fields as of the specified effectiveDate. Creates a new array if one does not exist. Deletes the array if one exists as of the specified effectiveDate and the scorecardProfiles array is not included in the PUT.
- id string? - Id of the instance
workday.compensation: ScoreGoal![](/images/permalink.svg)
Fields
- id string? - Id of the instance
workday.compensation: ScoreInput![](/images/permalink.svg)
Fields
- achievement int? - The achievement percentage for the scorecard criteria result.
- descriptor string? - A preview of the instance
- id string? - Id of the instance
workday.compensation: ScoreSet![](/images/permalink.svg)
Fields
- eligibiltyRule EligibiltyRule? -
- performanceScores ScoresetScore[]? - The set of Performance Scores for a Compensation Scorecard.
- weightedFundingPercent int? - Calculates the total Weighted Funding Percent for all the scores in the scorecard result set.
- id string? - Id of the instance
- descriptor string? - A preview of the instance
workday.compensation: ScoresetContainer![](/images/permalink.svg)
Fields
- scorecardDescription string? - Returns the Scorecard's Description
- scorecardName string? - The ~goal~ name of the scorecard criteria result.
- scorecardID ScorecardID? -
- profileScorecardGoalsResult ScoreSet[]? - Returns the Scorecard Profiles for a Scorecard Result
- defaultScorecardGoalsResult DefaultScorecardGoalsResult? -
- evaluationDate string? - Scorecard Result Evaluation Date
- descriptor string? - A preview of the instance
- id string? - Id of the instance
workday.compensation: ScoresetScore![](/images/permalink.svg)
Fields
- goalID GoalID? -
- goalName string? - The ~goal~ name of the scorecard criteria result.
- achievement int? - The achievement percentage for the scorecard criteria result.
- goalWeight int? - The criteria weighted percentage of the scorecard criteria result.
- id string? - Id of the instance
workday.compensation: ValidationErrorModelReference![](/images/permalink.svg)
Fields
- Fields Included from *ErrorModelReference
- error string
- anydata...
- errors ErrorModelReference[]? - An array of validation errors
workday.compensation: WorkerProfile![](/images/permalink.svg)
Fields
- primaryWorkEmail string? - The primary work email address for the ~worker~.
- isManager boolean? - Identifies if the ~worker~ has a ~manager~ role.
- primaryWorkPhone string? - The primary work phone number for the ~worker~ including the area code and ~country~ code.
- location Location? -
- primarySupervisoryOrganization PrimarySupervisoryOrganization? -
- primaryWorkAddressText string? - Returns the primary work address for the ~worker~, or from their default primary work location, full format on a single line.
- yearsOfService int? - The years of service for the ~worker~.
- businessTitle string? - The business title for the ~worker's~ primary position. If no business title is defined for a position, the position title is returned back.
- supervisoryOrganizationsManaged string? - All ~supervisory organizations~, excluding inherited organizations, in which the ~worker~ has a leadership role.
- dateOfBirth string? - The birth date of the ~worker~.
- href string? - A link to the instance
- id string? - Id of the instance
- descriptor string? - A preview of the instance
workday.compensation: WorkerSummary![](/images/permalink.svg)
Fields
- primaryWorkPhone string? - The primary work phone number for the ~worker~ including the area code and ~country~ code.
- isManager boolean? - Identifies if the ~worker~ has a ~manager~ role.
- primaryWorkEmail string? - The primary work email address for the ~worker~.
- businessTitle string? - The business title for the ~worker's~ primary position. If no business title is defined for a position, the position title is returned back.
- primarySupervisoryOrganization PrimarySupervisoryOrganization? -
- descriptor string? - A preview of the instance
- href string? - A link to the instance
- id string? - Id of the instance
Import
import ballerinax/workday.compensation;
Metadata
Released date: over 1 year ago
Version: 1.5.1
License: Apache-2.0
Compatibility
Platform: any
Ballerina version: 2201.4.1
GraalVM compatible: Yes
Pull count
Total: 0
Current verison: 0
Weekly downloads
Keywords
Human Resources/HRMS
Cost/Paid
Contributors
Dependencies