Thor.API.Operations

Interface AttestationOperationsIntf

All Superinterfaces:

tcUtilityOperationsIntf

public interface AttestationOperationsIntf
extends tcUtilityOperationsIntf

Method Summary

Modifier and Type	Method and Description
void	attestSpecificTask(java.lang.String[] attestationTaskKeys, long attestationTaskKey) This API attests the specific tasks and initiates any work flow setup.
void	attestTask(long attestationTaskKey) This API attests the specified task and initiates any work flow setup.
Thor.API.tcResultSet	getAttestationProcessExecutionHistory(long processDefKey) Returns all the attestation requests created for a given attestation process.
Thor.API.tcResultSet	getAttestationRecordDelegatedPath(long recordKey) Returns all the delegation that occurred for a specific record
Thor.API.tcResultSet	getAttestationRequestDetails(long attestationRequestKey, java.util.Map attributes, int startRow, int pageSize) Returns the attestation records associated with an attestation request.
Thor.API.tcResultSet	getAttestationRequestDetails(long attestationRequestKey, java.util.Map attributes, int startRow, int pageSize, java.lang.String[] order, boolean ascendingOrder) Returns the attestation records associated with an attestation request.
int	getAttestationRequestTasksCount(long attestationRequestKey) Returns the attestation records associated with an attestation request.
com.thortech.xl.dataobj.tcDataSet	getAttestationTaskDetailKeys(long attestationRequestKey) Returns the attestation records associated with an attestation request.
UDFormData	getEntitlementRecordDetails(long recordKey) Returns the process form data given a record key.
Thor.API.tcResultSet	getOwnerAttestationProcesses() Returns the attestation processes that are owned by the groups the logged in user is member of.
Thor.API.tcResultSet	getPendingAttestationTasks(long userKey) Returns all the pending attestation tasks assigned to the specified user
Thor.API.tcResultSet	getPendingAttestationTasks(long userKey, java.util.Map searchCriterion) Returns all the pending attestation tasks assigned to the specified user
Thor.API.tcResultSet	getRequestDetailsForDashBoard(long attestationRequestKey, java.util.Map attributes, int startRow, int pageSize) Returns the attestation records associated with an attestation request.
void	initiateAttestationProcess(java.lang.String processName) Initiates the specified attestation process by creating the attestation tasks
void	sendWarningEmails(java.util.List lstKeys) Sends the warning emails
void	submitReponses(long attestationTaskKey, AttestationItemResponse[] responses, java.lang.String defaultDelegate, java.lang.String defalutComment) Submits the specified responses on the records of a attestation task
void	updateResponses(java.lang.String[] atd_keys, java.lang.String apd_key, java.lang.String apt_key) Submits the attestation task when the grace period expires and response for each task is to be set to delegated and the process is thus to be delegated to some other user

Methods inherited from interface Thor.API.Base.tcUtilityOperationsIntf

close, getName, setCountry, setLanguage, setVariant

Method Detail

initiateAttestationProcess

void initiateAttestationProcess(java.lang.String processName)
                         throws tcAPIException,
                                tcInvalidPermissionsException,
                                AttestationProcessNotFoundException,
                                tcAPIException

Initiates the specified attestation process by creating the attestation tasks

Parameters:

processName, - Name of the Attestation Process to be instantiated

Throws:

AttestationProcessNotFoundException, - If the specified attestation process name does not exist

tcAPIException, - If an error occurs while querying or creating attestation requests

tcInvalidPermissionsException, - If the process is not instantiated by scheduler or process owner

tcAPIException

tcInvalidPermissionsException

AttestationProcessNotFoundException

submitReponses

void submitReponses(long attestationTaskKey,
                    AttestationItemResponse[] responses,
                    java.lang.String defaultDelegate,
                    java.lang.String defalutComment)
             throws TaskAlreadyAttestedException,
                    tcAPIException,
                    tcInvalidPermissionsException,
                    UnknownAttestationRecordResponse,
                    tcAPIException

Submits the specified responses on the records of a attestation task

Parameters:

attestationTaskKey, - Attestation task key on which responses to be submitted

responses, - Value object containing the record keys and responses to be submitted for each of the records

defaultDelegate, - If the response for a record is 'Delegate' and corresponding delegate value is not provided, this value will be used. Value should be a user login

defalutComment, - Uses this value for all the records where comment is not provided

Throws:

TaskAlreadyAttestedException, - If responses for all the records are already provided and task is already sumbmitted for attestation

tcAPIException, - If any of the records do not belong to the specified attestation task or user to delegate is not specified for one or more attestation records where the response specified is delegate

tcInvalidPermissionsException, - if the logged in user is not same as the attestation task reviewer

UnknownAttestationRecordResponse, - If responses provided for one or more records is not Certify/Reject/Decline/Delegate

TaskAlreadyAttestedException

tcAPIException

tcInvalidPermissionsException

UnknownAttestationRecordResponse

attestTask

void attestTask(long attestationTaskKey)
         throws MissingResponsesException,
                tcAPIException,
                tcInvalidPermissionsException,
                tcAPIException

This API attests the specified task and initiates any work flow setup. This should be called after responses responses are provided to all the records in the attestation task

Parameters:

attestationTaskKey, - Task to be attested

Throws:

MissingResponsesException, - If response is not provided to one or more records in the task

tcAPIException, - If an error occurs while querying for the data

tcInvalidPermissionsException, - if the logged in user is not same as the attestation task reviewer

MissingResponsesException

tcAPIException

tcInvalidPermissionsException

attestSpecificTask

void attestSpecificTask(java.lang.String[] attestationTaskKeys,
                        long attestationTaskKey)
                 throws MissingResponsesException,
                        tcAPIException,
                        tcInvalidPermissionsException,
                        tcAPIException

This API attests the specific tasks and initiates any work flow setup. This should is called when the process owner delegates some of the recors from the attestation run

Parameters:

attestationTaskKeys - tasks to be attested

Throws:

MissingResponsesException, - If response is not provided to one or more records in the task

tcAPIException, - If an error occurs while querying for the data

tcInvalidPermissionsException, - if the logged in user is not same as the attestation task reviewer

MissingResponsesException

tcAPIException

tcInvalidPermissionsException

Since:

9.1.0.0

getPendingAttestationTasks

Thor.API.tcResultSet getPendingAttestationTasks(long userKey,
                                                java.util.Map searchCriterion)
                                         throws tcAPIException,
                                                tcAPIException

Returns all the pending attestation tasks assigned to the specified user

Parameters:

userKey, - User for whom the tasks are assigned

Returns:

A tcResultSet that contains the following information:

• Attestation Definition.Key, Key of the attestation process that generated the task
• Attestation Definition.Process Name, Name of the attestation process that generated the task
• Attestation Definition.Process Code, Code of the attestation process that gerenated the task
• Attestation Requests.Scope Type, Attestation process scope type
• Attestation Tasks.Delegated By, Key of the delegator if the task is delegated
• Attestation Task.Delegator User Id , Login of the delegator user if the task is delegated
• Attestation Task.Delegator First Name , First Name of the delegator if the task is delegated
• Attestation Task.Delegator Last Name, Last name of the delegaor if the task is delegated
• Attestation Requests.Execution Time, Date and time at which the task created
• Attestation Requests.Key, Attestation request key form which the task belongs to
• Attestation Tasks.Key , Attestation Task Key

Throws:

tcAPIException, - If an error occurs while retrieving the task data

tcAPIException

getPendingAttestationTasks

Thor.API.tcResultSet getPendingAttestationTasks(long userKey)
                                         throws tcAPIException,
                                                tcAPIException

Returns all the pending attestation tasks assigned to the specified user

Parameters:

userKey, - User for whom the tasks are assigned

Returns:

A tcResultSet that contains the following information:

• Attestation Definition.Key, Key of the attestation process that generated the task
• Attestation Definition.Process Name, Name of the attestation process that generated the task
• Attestation Definition.Process Code, Code of the attestation process that gerenated the task
• Attestation Requests.Scope Type, Attestation process scope type
• Attestation Tasks.Delegated By, Key of the delegator if the task is delegated
• Attestation Task.Delegator User Id , Login of the delegator user if the task is delegated
• Attestation Task.Delegator First Name , First Name of the delegator if the task is delegated
• Attestation Task.Delegator Last Name, Last name of the delegaor if the task is delegated
• Attestation Requests.Execution Time, Date and time at which the task created
• Attestation Requests.Key, Attestation request key form which the task belongs to
• Attestation Tasks.Key , Attestation Task Key

Throws:

tcAPIException, - If an error occurs while retrieving the task data

tcAPIException

getEntitlementRecordDetails

UDFormData getEntitlementRecordDetails(long recordKey)
                                throws tcAPIException,
                                       tcAPIException

Returns the process form data given a record key.

Parameters:

recordKey, - Attestation Record Key

Returns:

A value object containing the process form data at the time the attestation record is created

Throws:

tcAPIException, - If an error occurs while retrieving the data

tcAPIException

getAttestationRequestTasksCount

int getAttestationRequestTasksCount(long attestationRequestKey)
                             throws tcAPIException,
                                    tcAPIException

Returns the attestation records associated with an attestation request. Results are sorted by the following columns in the order Attestation Tasks.Reviewer, Provisioned User.Key, Objects.Key

Parameters:

attestationRequestKey, - Attestation Request key

attributes, - Values to filter the results on. Only supported filter column are 'Attestation Tasks.Key' and 'Attestation Data.Record Status'

startRow, - the start row to retrieve the data

pageSize, - Number of rows to retrieve

Returns:

A tcResultSet that contains the following information:

• Attestation Tasks.Key , Attestation Task for which the current record belongs to
• Provisioned User.Key, key of user whose provisioned resource instance being attested
• Provisioned User.First Name, First Name of user whose provisioned resource instance being attested
• Provisioned User.Last Name, Last Name of user whose provisioned resource instance being attested
• Provisioned User.User Id, Login of user whose provisioned resource instance being attested
• Process Instance.Descriptive Data, The descriptive data field for the provisioned resource instance
• Users-Object Instance For User.Last Attested By, Key of the user who last attested this provisioned resource instance
• Users-Object Instance For User.Last Attested On, Date and Time at which this provisioned resource instance is last attested
• Attestation Data.Record Comment, Comments provided by the reviewer for the record
• Attestation Data.Record Status, Status of the record
• Attestation Data.Record Response, Response provided by the reviewer for the current record
• Objects.Key, Key of the resource object
• Objects.Name, Name of the resource object that is basis for current record
• Attestation Data.Record Delegated To, Key of the user for whom the record is delegated to if the record is delegated
• Delegated User.First Name, First Name of the user for whom the record is delegated to if the record is delegated
• Delegated User.Last Name, Last Name of the user for whom the record is delegated to if the record is delegated
• Delegated User.User Id, Login of the user for whom the record is deletaed to if the record is delegated
• Attestation Tasks.Reviewer, Key of the user for whom the attestation task is assigned where the current record is part of
• Reviewer.First Name, First Name of the user for whom the attestation task is assigned where the current record is part of
• Reviewer.Last Name, Last Name of the user for whom the attestation task is assigned where the current record is part of
• Reviewer.User Id, Login of the user for whom the attestation task is assigned where the current record is part of
• User Profile Audit.Key, Key to provisioned user profile information at the time attestation task is created.
• Attestation Data.Record Key, Record Key

Throws:

tcAPIException, - If an error occurs while retrieving the data

tcAPIException

getAttestationRequestDetails

Thor.API.tcResultSet getAttestationRequestDetails(long attestationRequestKey,
                                                  java.util.Map attributes,
                                                  int startRow,
                                                  int pageSize)
                                           throws tcAPIException,
                                                  tcAPIException

Returns the attestation records associated with an attestation request. Results are sorted by the following columns in the order Attestation Tasks.Reviewer, Provisioned User.Key, Objects.Key

Parameters:

attestationRequestKey, - Attestation Request key

attributes, - Values to filter the results on. Only supported filter column are 'Attestation Tasks.Key' and 'Attestation Data.Record Status'

startRow, - the start row to retrieve the data

pageSize, - Number of rows to retrieve

Returns:

A tcResultSet that contains the following information:

• Attestation Tasks.Key , Attestation Task for which the current record belongs to
• Provisioned User.Key, key of user whose provisioned resource instance being attested
• Provisioned User.First Name, First Name of user whose provisioned resource instance being attested
• Provisioned User.Last Name, Last Name of user whose provisioned resource instance being attested
• Provisioned User.User Id, Login of user whose provisioned resource instance being attested
• Process Instance.Descriptive Data, The descriptive data field for the provisioned resource instance
• Users-Object Instance For User.Last Attested By, Key of the user who last attested this provisioned resource instance
• Users-Object Instance For User.Last Attested On, Date and Time at which this provisioned resource instance is last attested
• Attestation Data.Record Comment, Comments provided by the reviewer for the record
• Attestation Data.Record Status, Status of the record
• Attestation Data.Record Response, Response provided by the reviewer for the current record
• Objects.Key, Key of the resource object
• Objects.Name, Name of the resource object that is basis for current record
• Attestation Data.Record Delegated To, Key of the user for whom the record is delegated to if the record is delegated
• Delegated User.First Name, First Name of the user for whom the record is delegated to if the record is delegated
• Delegated User.Last Name, Last Name of the user for whom the record is delegated to if the record is delegated
• Delegated User.User Id, Login of the user for whom the record is deletaed to if the record is delegated
• Attestation Tasks.Reviewer, Key of the user for whom the attestation task is assigned where the current record is part of
• Reviewer.First Name, First Name of the user for whom the attestation task is assigned where the current record is part of
• Reviewer.Last Name, Last Name of the user for whom the attestation task is assigned where the current record is part of
• Reviewer.User Id, Login of the user for whom the attestation task is assigned where the current record is part of
• User Profile Audit.Key, Key to provisioned user profile information at the time attestation task is created.
• Attestation Data.Record Key, Record Key

Throws:

tcAPIException, - If an error occurs while retrieving the data

tcAPIException

getAttestationRequestDetails

Thor.API.tcResultSet getAttestationRequestDetails(long attestationRequestKey,
                                                  java.util.Map attributes,
                                                  int startRow,
                                                  int pageSize,
                                                  java.lang.String[] order,
                                                  boolean ascendingOrder)
                                           throws tcAPIException,
                                                  tcAPIException

Returns the attestation records associated with an attestation request. Results are sorted by the following columns in the order Attestation Tasks.Reviewer, Provisioned User.Key, Objects.Key

Parameters:

attestationRequestKey, - Attestation Request key

attributes, - Values to filter the results on. Only supported filter column are 'Attestation Tasks.Key' and 'Attestation Data.Record Status'

startRow, - the start row to retrieve the data

pageSize, - Number of rows to retrieve

order, - The order in which the result set is based since only a subset of the whole matching set is returned, the caller will not be able to sort accurately with only that subset.

ascendingOrder,A - boolean value if the sorting is to be ascending or descending

Returns:

A tcResultSet that contains the following information:

• Attestation Tasks.Key , Attestation Task for which the current record belongs to
• Provisioned User.Key, key of user whose provisioned resource instance being attested
• Provisioned User.First Name, First Name of user whose provisioned resource instance being attested
• Provisioned User.Last Name, Last Name of user whose provisioned resource instance being attested
• Provisioned User.User Id, Login of user whose provisioned resource instance being attested
• Process Instance.Descriptive Data, The descriptive data field for the provisioned resource instance
• Users-Object Instance For User.Last Attested By, Key of the user who last attested this provisioned resource instance
• Users-Object Instance For User.Last Attested On, Date and Time at which this provisioned resource instance is last attested
• Attestation Data.Record Comment, Comments provided by the reviewer for the record
• Attestation Data.Record Status, Status of the record
• Attestation Data.Record Response, Response provided by the reviewer for the current record
• Objects.Key, Key of the resource object
• Objects.Name, Name of the resource object that is basis for current record
• Attestation Data.Record Delegated To, Key of the user for whom the record is delegated to if the record is delegated
• Delegated User.First Name, First Name of the user for whom the record is delegated to if the record is delegated
• Delegated User.Last Name, Last Name of the user for whom the record is delegated to if the record is delegated
• Delegated User.User Id, Login of the user for whom the record is deletaed to if the record is delegated
• Attestation Tasks.Reviewer, Key of the user for whom the attestation task is assigned where the current record is part of
• Reviewer.First Name, First Name of the user for whom the attestation task is assigned where the current record is part of
• Reviewer.Last Name, Last Name of the user for whom the attestation task is assigned where the current record is part of
• Reviewer.User Id, Login of the user for whom the attestation task is assigned where the current record is part of
• User Profile Audit.Key, Key to provisioned user profile information at the time attestation task is created.
• Attestation Data.Record Key, Record Key

Throws:

tcAPIException, - If an error occurs while retrieving the data

tcAPIException

getRequestDetailsForDashBoard

Thor.API.tcResultSet getRequestDetailsForDashBoard(long attestationRequestKey,
                                                   java.util.Map attributes,
                                                   int startRow,
                                                   int pageSize)
                                            throws tcAPIException,
                                                   tcAPIException

Returns the attestation records associated with an attestation request. Results are sorted by the following columns in the order Attestation Tasks.Reviewer, Provisioned User.Key, Objects.Key This API returns responses for only the records that are submitted and returns null otherwise This also filters all the submitted records where the response id 'Delegate'

Parameters:

attestationRequestKey, - Attestation Request key

attributes, - Values to filter the results on. Only supported filter column are 'Attestation Tasks.Key' and 'Attestation Data.Record Status'

startRow, - the start row to retrieve the data

pageSize, - Number of rows to retrieve

Returns:

A tcResultSet that contains the following information:

• Attestation Tasks.Key , Attestation Task for which the current record belongs to
• Provisioned User.Key, key of user whose provisioned resource instance being attested
• Provisioned User.First Name, First Name of user whose provisioned resource instance being attested
• Provisioned User.Last Name, Last Name of user whose provisioned resource instance being attested
• Provisioned User.User Id, Login of user whose provisioned resource instance being attested
• Process Instance.Descriptive Data, The descriptive data field for the provisioned resource instance
• Users-Object Instance For User.Last Attested By, Key of the user who last attested this provisioned resource instance
• Users-Object Instance For User.Last Attested On, Date and Time at which this provisioned resource instance is last attested
• Attestation Data.Record Comment, Comments provided by the reviewer for the record
• Attestation Data.Record Status, Status of the record
• Attestation Data.Record Response, Response provided by the reviewer for the current record if corresponding task is submitted. Null, otherwise
• Objects.Key, Key of the resource object
• Objects.Name, Name of the resource object that is basis for current record
• Attestation Data.Record Delegated To, Key of the user for whom the record is delegated to if the record is delegated
• Delegated User.First Name, First Name of the user for whom the record is delegated to if the record is delegated
• Delegated User.Last Name, Last Name of the user for whom the record is delegated to if the record is delegated
• Delegated User.User Id, Login of the user for whom the record is deletaed to if the record is delegated
• Attestation Tasks.Reviewer, Key of the user for whom the attestation task is assigned where the current record is part of
• Reviewer.First Name, First Name of the user for whom the attestation task is assigned where the current record is part of
• Reviewer.Last Name, Last Name of the user for whom the attestation task is assigned where the current record is part of
• Reviewer.User Id, Login of the user for whom the attestation task is assigned where the current record is part of
• User Profile Audit.Key, Key to provisioned user profile information at the time attestation task is created.
• Attestation Data.Record Key, Record Key
• Attestation Data.Record Delegated From, Key of the user from whom the record is delegated from if the record is delegated

Throws:

tcAPIException, - If an error occurs while retrieving the data

tcAPIException

getAttestationProcessExecutionHistory

Thor.API.tcResultSet getAttestationProcessExecutionHistory(long processDefKey)
                                                    throws tcAPIException,
                                                           AttestationProcessNotFoundException,
                                                           tcAPIException

Returns all the attestation requests created for a given attestation process.

Parameters:

processDefKey, - Attestation process definition key

Returns:

A tcResultSet and returned columns vary based on the attestation scope type.

For the scope type Provisioned Users, the returned columns are

• Attestation Requests.Key, Attestation request key this instance belongs to
• Attestation Requests.Scope Type, Scope type defined for the corresponding attestation process at the time the current instance is run
• Attestation Requests.Scope Parameter, Scope parameter defined for the corresponding attestation process at the time the current instance is run
• Attestation Requests.Reviewer Type, Reviewer type defined for the corresponding attestation process at the time the current instance is run
• Attestation Requests.Reviewer, Reviewer key defined for the corresponding attestation process at the time the current instance is run
• Attestation Requests.Execution Time, Date and Time at which the current request is initiated on
• Attestation Requests.Completion Time, Date and time at which the current request is completed on
• Objects.Name, Resource object name of the scope parameter value
• Reviewer.First Name, this column is only populated if the reviewer type is a specific user
• Reviewer.Last Name, this column is only populated if the reviewer type is a specific user
• Reviewer.User Id, this column is only populated if the reviewer type is a specific user

For the scope type Group Users, the returned columns are

• Attestation Requests.Key, Attestation request key this instance belongs to
• Attestation Requests.Scope Type, Scope type defined for the corresponding attestation process at the time the current instance is run
• Attestation Requests.Scope Parameter, Scope parameter defined for the corresponding attestation process at the time the current instance is run
• Attestation Requests.Reviewer Type, Reviewer type defined for the corresponding attestation process at the time the current instance is run
• Attestation Requests.Reviewer, Reviewer key defined for the corresponding attestation process at the time the current instance is run
• Attestation Requests.Execution Time, Date and Time at which the current request is initiated on
• Attestation Requests.Completion Time, Date and time at which the current request is completed on
• Groups.Group Name, Group name of the scope parameter value
• Reviewer.First Name, this column is only populated if the reviewer type is a specific user
• Reviewer.Last Name, this column is only populated if the reviewer type is a specific user
• Reviewer.User Id, this column is only populated if the reviewer type is a specific user

For the scope type Organization Users, the returned columns are

• Attestation Requests.Key, Attestation request key this instance belongs to
• Attestation Requests.Scope Type, Scope type defined for the corresponding attestation process at the time the current instance is run
• Attestation Requests.Scope Parameter, Scope parameter defined for the corresponding attestation process at the time the current instance is run
• Attestation Requests.Reviewer Type, Reviewer type defined for the corresponding attestation process at the time the current instance is run
• Attestation Requests.Reviewer, Reviewer key defined for the corresponding attestation process at the time the current instance is run
• Attestation Requests.Execution Time, Date and Time at which the current request is initiated on
• Attestation Requests.Completion Time, Date and time at which the current request is completed on
• Organizations.Organization Name, Organization name of the scope parameter value
• Reviewer.First Name, this column is only populated if the reviewer type is a specific user
• Reviewer.Last Name, this column is only populated if the reviewer type is a specific user
• Reviewer.User Id, this column is only populated if the reviewer type is a specific user

For the scope type Managed Users, the returned columns are

• Attestation Requests.Key, Attestation request key this instance belongs to
• Attestation Requests.Scope Type, Scope type defined for the corresponding attestation process at the time the current instance is run
• Attestation Requests.Scope Parameter, Scope parameter defined for the corresponding attestation process at the time the current instance is run
• Attestation Requests.Reviewer Type, Reviewer type defined for the corresponding attestation process at the time the current instance is run
• Attestation Requests.Reviewer, Reviewer key defined for the corresponding attestation process at the time the current instance is run
• Attestation Requests.Execution Time, Date and Time at which the current request is initiated on
• Attestation Requests.Completion Time, Date and time at which the current request is completed on
• Attestation Manager Scope. Manager User Id, Login of the scope parameter value
• Attestation Manager Scope. Manager First Name, First name of the scope parameter value
• Attestation Manager Scope. Manager Last Name, Last name of the scope paramater value
• Reviewer.First Name, this column is only populated if the reviewer type is a specific user
• Reviewer.Last Name, this column is only populated if the reviewer type is a specific user
• Reviewer.User Id, this column is only populated if the reviewer type is a specific user

Throws:

tcAPIException - if an error occurs while retrieving the attestation request data

AttestationProcessNotFoundException, - If the specified attestation process key does not exist

AttestationProcessNotFoundException

getAttestationRecordDelegatedPath

Thor.API.tcResultSet getAttestationRecordDelegatedPath(long recordKey)
                                                throws tcAPIException,
                                                       AttestationRecordNotDelegatedException,
                                                       tcAPIException

Returns all the delegation that occurred for a specific record

Parameters:

recordKey, - Record for which to retrieve the delegation path

Returns:

A tcResultSet that contains the following information:

• Attestation Tasks.Reviewer, Key of the user who was assigned the provisioned instance for attestation
• Reviewer.First Name, First Name of the user who was assigned the provisioned instance for attestation
• Reviewer.Last Name, Last of the user who was assigned the provisioned instance for attestation
• Reviewer.User Id, Login of the user who was assigned the provisioned instance for attestation
• Attestation Tasks.Completion Time, Date and time on which reviewer provided the attestation response
• Attestation Data.Record Comment, Comments reviewer has provided
• Attestation Data.Record Response, Response reviewer has provided
• Attestation Data.Record Delegated To, Key of the user for whom the record is delegated to
• Attestation Requests.Key, Request Key for which the records belong to

Throws:

tcAPIException, - If an error occurs while getting the delegation path

AttestationRecordNotDelegatedException, - If the specified record is not delegated

tcAPIException

AttestationRecordNotDelegatedException

getOwnerAttestationProcesses

Thor.API.tcResultSet getOwnerAttestationProcesses()
                                           throws tcAPIException,
                                                  tcAPIException

Returns the attestation processes that are owned by the groups the logged in user is member of. Returns only the processes that are not Disabled or Deleted. Along with process information API also returns information about last request for this process and a request prior to the last one.

Returns:

A tcResultSet that contains the following information:

• Attestation Definition.Key, Key of the attestation process owned
• Attestation Definition.Process Name, Name of the attestation process owned
• Attestation Definition.Process Code, Code of the attestation process owned
• Attestation Requests.Key, Attestation request key
• Attestation Requests.Execution Time, Date and time at which the last instance of the process was executed
• Attestation Requests.Completion Time, Date and time at which last instance execution was completed
• Attestation Requests.Total Rcords, Total number of provisioned instances identified for attestation and covered by as part of last process instance
• Attestation Requests.Certified Records, Number of certified records in this last process instance
• Attestation Requests.Rejected Records, Number of rejected records in this last process instance
• Attestation Requests.Declined Records, Number of declined records in this last process instance
• Attestation Requests.Delegated Records, Number of delegated records in this last process instance
• Attestation Requests.Previous Request Execution Time, Date and Time at which the instance before the latest one was executed
• Attestation Requests.Previous Request Completion Time, Date and Time at which the instance before the latest one was completed

Throws:

tcAPIException, - If an error occurs while getting the attestation requests

tcAPIException

getAttestationTaskDetailKeys

com.thortech.xl.dataobj.tcDataSet getAttestationTaskDetailKeys(long attestationRequestKey)
                                                        throws tcAPIException,
                                                               tcAPIException

Returns the attestation records associated with an attestation request. Results are sorted by the following columns in the order Attestation Tasks.Reviewer, Provisioned User.Key, Objects.Key

Parameters:

attestationRequestKey, - Attestation Request key

attributes, - Values to filter the results on. Only supported filter column are 'Attestation Tasks.Key' and 'Attestation Data.Record Status'

startRow, - the start row to retrieve the data

pageSize, - Number of rows to retrieve

Returns:

A tcResultSet that contains the following information:

• Attestation Tasks.Key , Attestation Task for which the current record belongs to
• Provisioned User.Key, key of user whose provisioned resource instance being attested
• Provisioned User.First Name, First Name of user whose provisioned resource instance being attested
• Provisioned User.Last Name, Last Name of user whose provisioned resource instance being attested
• Provisioned User.User Id, Login of user whose provisioned resource instance being attested
• Process Instance.Descriptive Data, The descriptive data field for the provisioned resource instance
• Users-Object Instance For User.Last Attested By, Key of the user who last attested this provisioned resource instance
• Users-Object Instance For User.Last Attested On, Date and Time at which this provisioned resource instance is last attested
• Attestation Data.Record Comment, Comments provided by the reviewer for the record
• Attestation Data.Record Status, Status of the record
• Attestation Data.Record Response, Response provided by the reviewer for the current record
• Objects.Key, Key of the resource object
• Objects.Name, Name of the resource object that is basis for current record
• Attestation Data.Record Delegated To, Key of the user for whom the record is delegated to if the record is delegated
• Delegated User.First Name, First Name of the user for whom the record is delegated to if the record is delegated
• Delegated User.Last Name, Last Name of the user for whom the record is delegated to if the record is delegated
• Delegated User.User Id, Login of the user for whom the record is deletaed to if the record is delegated
• Attestation Tasks.Reviewer, Key of the user for whom the attestation task is assigned where the current record is part of
• Reviewer.First Name, First Name of the user for whom the attestation task is assigned where the current record is part of
• Reviewer.Last Name, Last Name of the user for whom the attestation task is assigned where the current record is part of
• Reviewer.User Id, Login of the user for whom the attestation task is assigned where the current record is part of
• User Profile Audit.Key, Key to provisioned user profile information at the time attestation task is created.
• Attestation Data.Record Key, Record Key

Throws:

tcAPIException, - If an error occurs while retrieving the data

tcAPIException

Since:

9.1.0.0

updateResponses

void updateResponses(java.lang.String[] atd_keys,
                     java.lang.String apd_key,
                     java.lang.String apt_key)
              throws com.thortech.xl.orb.dataaccess.tcDataAccessException,
                     tcAPIException,
                     com.thortech.xl.dataaccess.tcDataSetException,
                     tcAPIException

Submits the attestation task when the grace period expires and response for each task is to be set to delegated and the process is thus to be delegated to some other user

Parameters:

atd_keys -

apd_key -

apt_key -

Throws:

com.thortech.xl.orb.dataaccess.tcDataAccessException

tcAPIException

com.thortech.xl.dataaccess.tcDataSetException

Since:

9.1.0.0

sendWarningEmails

void sendWarningEmails(java.util.List lstKeys)
                throws tcAPIException,
                       tcAPIException

Sends the warning emails

Parameters:

lstKeys - List of APT Keys for which mail is to be sent

Throws:

tcAPIException

Since:

9.1.0.0