Skip to main content

MGCLatticeWorkflowActionRequestContract

Data contract for workflow work item action requests: the work item (WorkItemRecId or WorkflowCorrelationId), the acting user (ActingUserId), Comment, and DelegateToUserId for a delegation.

Methods​

new​

Initializes a new instance of the MGCLatticeWorkflowActionRequestContract class.

  • Visibility: public
  • Returns: void

No parameters.

construct​

Creates a new instance of the MGCLatticeWorkflowActionRequestContract class.

  • Visibility: public
  • Returns: MGCLatticeWorkflowActionRequestContract A new MGCLatticeWorkflowActionRequestContract instance.

No parameters.

parmCorrelationId​

Gets or sets the correlation identifier for tracing the request across systems.

  • Visibility: public
  • Returns: Guid The CorrelationId value.
NameTypeOptionalDescription
_correlationIdGuidYesThe CorrelationId value.

parmRequestId​

Gets or sets the unique request identifier for idempotency.

  • Visibility: public
  • Returns: Guid The RequestId value.
NameTypeOptionalDescription
_requestIdGuidYesThe RequestId value.

parmLegalEntityId​

Gets or sets the legal entity (company) in which to execute the operation.

  • Visibility: public
  • Returns: DataAreaId The LegalEntityId value.
NameTypeOptionalDescription
_legalEntityIdDataAreaIdYesThe LegalEntityId value.

parmUserContext​

Gets or sets the caller's user context. Informational: the user the work-item action is taken as is ActingUserId.

  • Visibility: public
  • Returns: UserId The UserContext value.
NameTypeOptionalDescription
_userContextUserIdYesThe UserContext value.

parmActingUserId​

Gets or sets the user the work-item action is taken as. Required. It must be the assignee of the work item: the action runs as that user (the workflow history records it), and a work item assigned to anyone else is refused.

  • Visibility: public
  • Returns: UserId The ActingUserId value.
NameTypeOptionalDescription
_actingUserIdUserIdYesThe ActingUserId value.

parmWorkItemRecId​

Gets or sets the workflow work item record identifier.

  • Visibility: public
  • Returns: int64 The WorkItemRecId value.
NameTypeOptionalDescription
_workItemRecIdint64YesThe WorkItemRecId value.

parmWorkflowCorrelationId​

Gets or sets the workflow correlation identifier (the DocumentId submitToWorkflow returns) used to resolve the pending work item assigned to ActingUserId when WorkItemRecId is not supplied.

  • Visibility: public
  • Returns: Guid The WorkflowCorrelationId value.
NameTypeOptionalDescription
_workflowCorrelationIdGuidYesThe WorkflowCorrelationId value.

parmComment​

Gets or sets the comment or note associated with the request.

  • Visibility: public
  • Returns: str The Comment value.
NameTypeOptionalDescription
_commentstrYesThe Comment value.

parmDelegateToUserId​

Gets or sets the user the work item is delegated to. Required by delegateWorkItem; must be an enabled user other than the acting user. Not used by approve and reject.

  • Visibility: public
  • Returns: UserId The DelegateToUserId value.
NameTypeOptionalDescription
_delegateToUserIdUserIdYesThe DelegateToUserId value.

parmPreviewMode​

Gets or sets whether the request runs in preview mode. This operation does not implement a preview: a request with PreviewMode set to true is refused with PreviewUnsupported before anything is created or posted.

  • Visibility: public
  • Returns: boolean The current preview flag.
NameTypeOptionalDescription
_previewModebooleanYesThe preview flag to set.