BatchServicesExecuteApprovalItemAction Method |
Approves or Rejects an approval item on behalf of a particular user.
This method may also be used to change the current status of the from under construction to pending approval, or vice versa.
Namespace:
FactoryLogix.xTend.Production
Assembly:
FactoryLogix.xTend.API (in FactoryLogix.xTend.API.dll) Version: 8.245.0.0 (8.245.0.0)
Syntax public void ExecuteApprovalItemAction(
Guid sessionId,
Guid approvalItemId,
string userGroupName,
string userName,
ApprovalStatus action,
string comments
)
Public Sub ExecuteApprovalItemAction (
sessionId As Guid,
approvalItemId As Guid,
userGroupName As String,
userName As String,
action As ApprovalStatus,
comments As String
)
public:
virtual void ExecuteApprovalItemAction(
Guid sessionId,
Guid approvalItemId,
String^ userGroupName,
String^ userName,
ApprovalStatus action,
String^ comments
) sealed
abstract ExecuteApprovalItemAction :
sessionId : Guid *
approvalItemId : Guid *
userGroupName : string *
userName : string *
action : ApprovalStatus *
comments : string -> unit
override ExecuteApprovalItemAction :
sessionId : Guid *
approvalItemId : Guid *
userGroupName : string *
userName : string *
action : ApprovalStatus *
comments : string -> unit
Parameters
- sessionId
- Type: SystemGuid
The session identifier that was returned by the Connect(String, String, String, String, String) method. - approvalItemId
- Type: SystemGuid
The Id of the ApprovalItem to be acted upon. - userGroupName
- Type: SystemString
The name of the user group associated with the step in the approval process to be acted upon. - userName
- Type: SystemString
The user name of the user on whose behalf the action will be taken. - action
- Type: FactoryLogix.xTend.DataObjectsApprovalStatus
An enumerated value indicating the type of action to be taken. - comments
- Type: SystemString
An optional parameter for rejection type actions, this parameter represents free form notes that are to be recorded with the history record for this action.
Exceptions Exception | Condition |
---|
InvalidSessionException | Thrown if the sessionId parameter is invalid. |
NotFoundException | An approval item with matching Id was not found, or the approval item does not contain a step associated with the specified userGroupName. |
NotAuthorizedException | The user specified by the userName parameter is not authorized to act upon the approval item. Typically, this is because the user is not a member of the specified user group. |
See Also