QA Actions workflow - HxGN SDx - Update 64 - Administration & Configuration

Administration and Configuration of HxGN SDx

Language
English
Product
HxGN SDx
Search by Category
Administration & Configuration
SmartPlant Foundation / SDx Version
10

The QA Actions workflow directs action items, such as markups and comments, to the contractor following a document review. After receiving notification, the contractor completes the workflow step, and the communication is sent back to the originator for acknowledgment and completion.

The following information describes the QA Actions Workflow template. It explains what can and cannot be changed.

Manage the default behavior of the compliance review, their follow up branches, and their recipients

You can control the compliance review prior to issue by doing the following in the Desktop Client.

  1. Find the SCLBOutgoingActionCS column set, and manage the column items for edit.

  2. Modify the settings for the SCLBProjComsContractualComplianceReviewReqd column item.

    • Set the Default Create Value (true/false) and Read Only (true/false) options as required.

You can set the recipient for the compliance review prior to issue by doing the following in the Desktop Client.

  1. Find and update the Outgoing Action Workflow template.

  2. Update the recipient for the Compliance review step.

    • Select a user, role, or matrix. If the role or matrix resolves to more than one recipient, then one of these users will be required to claim the task.

You can control the followup requirement after a response is issued by doing the following in the Desktop Client.

  1. Find the SCLBOutgoingActionCS column set, and manage the column items for edit.

  2. Modify the settings for the SCLBProjComsFollowUpReviewRqd column item setting the Default Create Value (true/false) and Read Only (true/false) options as required.

Set the review and response periods

Manage the review and response periods using properties on the individual contract objects in each project. These can be set differently for each contractor.

  • Find the contract for the project, and update its properties.

Remodel the work process

Work process remodeling, including creating new steps, requires changes to the underlying workflow template. For more information, see the rules for work process remodeling in Configure workflows and the detailed procedures in How to Configure the Workflow Model.

Details of internal process steps

The actions are managed by two different workflows depending on if they are created during the document review or interactively.

  • If the system fails to generate and attach any of the PDF renditions, it directs the workflow to the Correct failure step.

  • To capture the reason for the closure, set argument 17 (Set Closure Reason) on the SCLBProjComsReviewActionResponse method to True. The Set Closure Reason box is then displayed in the Review Responses dialog, and you must select a reason from the list, such as Created by mistake, Duplicate, Fixed, Not valid anymore, or Other, to complete the step.

What does the workflow look like?

The steps that make up the workflow are described in the following table.

If you choose to edit the workflow, do not remove any steps marked as mandatory.

SHARED Tip For information on how to upgrade a workflow template, and the changes that have been made in various updates, see Upgrading workflow templates.

Step name

Description

Mandatory?

Comments

ValidateDocOrgsShareCommonToOrgOfAction

Validates if the collaborating or originating organization of the documents (related to the action) is the same as the target organization of the action.

If yes, the next step is ValidatePrimaryDocOrgsShareCommonToOrgOfAction.

If no, the next step is VerifyAttachments.

Yes

This step is needed as the information added to the action should be accessible to the external recipient.

ValidatePrimaryDocOrgsShareCommonToOrgOfAction

Validates if the collaborating or originating organization of the primary documents (related to the action) is the same as the target organization of the action.

If yes, the next step is ValidateTagOrgsShareCommonToOrgOfAction.

If no, the next step is VerifyAttachments.

Yes

This step is needed as the information added to the action should be accessible to the external recipient.

ValidateTagOrgsShareCommonToOrgOfAction

Validates if the collaborating or originating organization of the tags (related to the action) is the same as the target organization of the action.

If yes, the next step is RejectIfNoToUserOrToRole.

If no, the next step is VerifyAttachments.

Yes

This step is needed as the information added to the action should be accessible to the external recipient.

VerifyAttachments

Allows the submitter to correct any information related to the reference data attached to the action.

The next step is ValidateDocOrgsShareCommonToOrgOfAction.

Yes

This step is needed to ensure the reference data attached to the action can be viewed by the recipient organization.

RejectIfNoToUserOrToRole

Rejects if the To user or the To role is not specified on the communication object, and routes the workflow to the IdentifyToUserOrToRole step. Otherwise, routes the workflow to the ActionIssueStateToIssued step.

Yes

This step is needed to specify the recipients to issue the communication to.

IdentifyToUserOrToRole

Allows the submitter to select a To user or a To role.

The next step is ValidateDocOrgsShareCommonToOrgOfAction.

Yes

This step is needed to specify the recipients to issue the communication to.

ActionIssueStateToIssued

Sets the state of the action object to ISSUED.

If this step is removed, the action object status will not be modified.

The next step is Check Due Date.

No

Check Due Date

Checks if the due date is provided in the form. If accepted, the next step is Generate PDF and replace for all files. If rejected, the next step is SetOutgoingActionDueDateFromDaysToRespondOnContract.

No

SetOutgoingActionDueDateFromDaysToRespondOnContract

Sets the due date on the action based on the Days to respond property on the contract.

The next step is Generate PDF and replace for all files.

No

Generate PDF and replace for all files

Generates a PDF and replaces the existing files attached to the action.

If the PDF is successfully created, the next step is GeneratePrimaryDocPDFRenditionForAction. If the PDF generation fails, routes to Re-set action issue state to RESERVED step.

Yes

This step is needed to ensure the comments are shared with the recipient. The markups (selected by the approver) are not visible to the recipient unless a rendition is created.

GeneratePrimaryDocPDFRenditionForAction

Generates a PDF rendition and relates it to the document rendition for any files attached to the primary document of the action.

If the PDF is successfully created, the next step is GenerateDocPDFRenditionsForAction. If the PDF generation fails, routes to Re-set action issue state to RESERVED step.

Yes

This step is needed to ensure the comments are shared with the recipient. The markups (selected by the approver) are not visible to the recipient unless a rendition is created.

GenerateDocPDFRenditionsForAction

Generates a PDF rendition and relates it to the document rendition for any files attached to the reference document of the action.

If the PDF is successfully created, the next step is Check for from cc users. If the PDF generation fails, routes to Re-set action issue state to RESERVED step.

Yes

This step is needed to ensure the comments are shared with the recipient. The markups (selected by the approver) are not visible to the recipient unless a rendition is created.

Re-set action issue state to RESERVED

Sets the state of the action object to RESERVED.

If this step is removed, the action object status will not be modified.

The next step is Correct failure.

No

Check for from cc users

Checks if any From CC users have been selected.

If selected, the next step is Propagate recipient from cc users.

If not, the next step is Check for to cc users.

No

Propagate recipient from cc users

Identifies the users mentioned in the From CC box to issue a notification to.

The next step is Action issue notification.

No

Action issue notification

Informs the user that an action has been issued. This is an acknowledgment step.

The next step is Check for to cc users.

No

Check for to cc users

Checks if any To CC users have been selected.

If accepted, the next step is Propagate recipient to cc users.

If rejected, the next step is SetToUserOrRole.

No

Propagate recipient to cc users

Identifies the users mentioned in the To CC box to issue a notification to.

The next step is Action receipt notification.

No

Action receipt notification

Informs the user that an action has been received. This is a notification step.

The next step is SetToUserOrRole.

No

SetToUserOrRole

Sets the users mentioned in the To User and To Role boxes to send a task to.

The next step is Perform action and respond.

No

Perform action and respond

Allows the recipient to act on the review comments and respond to the submitter.

If accepted, the next step is ActionIssueStateToResponded.

If rejected, the next step is ActionIssueStateToRejected.

Yes

This step is needed so that the recipient can act upon the request, such as to update or validate the engineering documents.

ActionIssueStateToResponded

Sets the state of the action object to RESPONDED.

If this step is removed, the action object status will not be modified.

The next step is Responded response state to ISSUED.

No

Responded response state to ISSUED

Sets the response state of the action object to ISSUED.

If this step is removed, the action response object status will not be modified.

The next step is Generate PDF and replace for all files related to response object in target organization.

No

Generate PDF and replace for all files related to response object in target organization

Generates a PDF and replaces the existing files attached to the primary document of the action response object.

If the PDF is successfully created, the next step is Generate response document renditions. If the PDF generation fails, routes to the Re-set action issue state to ISSUED step.

Yes

This step is needed to ensure the comments are shared with the submitter. The markups (selected by the approver) are not visible to the submitter unless a rendition is created.

Generate response document renditions

Generates a PDF and replaces the existing files attached to the response document of the action response object.

If the PDF is successfully created, the next step is Generate primary rendition document renditions. If the PDF generation fails, routes to the Re-set action issue state to ISSUED step.

Yes

This step is needed to ensure the comments are shared with the submitter. The markups (selected by the approver) are not visible to the submitter unless a rendition is created.

Generate primary rendition document renditions

Generates a PDF for any markups created on the primary rendition document.

If the PDF is successfully created, the next step is Generate reference rendition document renditions. If the PDF generation fails, routes to the Re-set action issue state to ISSUED step.

Yes

This step is needed to ensure the comments are shared with the submitter. The markups (selected by the approver) are not visible to the submitter unless a rendition is created.

Generate reference rendition document renditions

Generates a PDF for any markups created on the reference rendition document.

If the PDF is successfully created, the next step is Generate PDF and replace for all files related to action object in target organization. If the PDF generation fails, routes to the Re-set action issue state to ISSUED step.

Yes

This step is needed to ensure the comments are shared with the submitter. The markups (selected by the approver) are not visible to the submitter unless a rendition is created.

Generate PDF and replace for all files related to action object in target organization

Generates a PDF and replaces the existing files attached to the action response object by the reviewer.

If the PDF is successfully created, the next step is BranchFollowUpReview. If the PDF generation fails, routes to the Re-set action issue state to ISSUED step.

Yes

This step is needed to ensure the comments are shared with the submitter. The markups (selected by the approver) are not visible to the submitter unless a rendition is created.

Re-set action issue state to ISSUED

Sets the state of the action object to ISSUED.

If this step is removed, the action object status will not be modified.

The next step is Re-set issued response state to INITIATED.

No

Re-set issued response state to INITIATED

Sets the state of the action response object to INITIATED.

If this step is removed, the action response object status will not be modified.

The next step is Correct response failure.

No

BranchFollowUpReview

Routes the workflow to the SetFromUser step if the Follow up required option in the RESPONSE CONTROL tab of the action form is selected. Otherwise, routes to ActionIssueStateToClosed.

No

SetFromUser

Sets the originator user on the action object.

The next step is Review responses.

No

ActionIssueStateToRejected

Sets the state of the action object to REJECTED.

If this step is removed, the action object status will not be modified.

The next step is Rejected response state to ISSUED.

No

Rejected response state to ISSUED

Sets the state of the action response rejected object to ISSUED.

If this step is removed, the action object status will not be modified.

The next step is Generate PDF and replace for all files related to rejected response object in target organization for rejection.

No

Generate PDF and replace for all files related to rejected response object in target organization for rejection

Generates a PDF and replaces the existing files attached to the primary document of the action rejected response object.

If the PDF is successfully created, the next step is Generate rejected response document renditions for rejection. If the PDF generation fails, routes to the Re-set issue state of action to ISSUED for rejection step.

Yes

This step is needed to ensure the comments are shared with the submitter. The markups (selected by the approver) are not visible to the submitter unless a rendition is created.

Generate rejected response document renditions for rejection

Generates a PDF and replaces the existing files attached to the response document of the action rejected response object.

If the PDF is successfully created, the next step is Generate primary rendition document renditions for rejection. If the PDF generation fails, routes to the Re-set issue state of action to ISSUED for rejection step.

Yes

This step is needed to ensure the comments are shared with the submitter. The markups (selected by the approver) are not visible to the submitter unless a rendition is created.

Generate primary rendition document renditions for rejection

Generates a PDF for any markups created on the primary rendition document.

If the PDF is successfully created, the next step is Generate reference rendition document renditions for rejection. If the PDF generation fails, routes to the Re-set issue state of action to ISSUED for rejection step.

Yes

This step is needed to ensure the comments are shared with the submitter. The markups (selected by the approver) are not visible to the submitter unless a rendition is created.

Generate reference rendition document renditions for rejection

Generates a PDF for any markups created on the reference rendition document.

If the PDF is successfully created, the next step is Generate PDF and replace for all files related to action object for rejection. If the PDF generation fails, routes to the Re-set issue state of action to ISSUED for rejection step.

Yes

This step is needed to ensure the comments are shared with the submitter. The markups (selected by the approver) are not visible to the submitter unless a rendition is created.

Generate PDF and replace for all files related to action object for rejection

Generates a PDF and replaces the existing files attached to the action rejected response object by the reviewer.

If the PDF is successfully created, the next step is SetFromUser. If the PDF generation fails, routes to the Re-set issue state of action to ISSUED for rejection step.

Yes

This step is needed to ensure the comments are shared with the submitter. The markups (selected by the approver) are not visible to the submitter unless a rendition is created.

Re-set issue state of action to ISSUED for rejection

Sets the state of the action object to ISSUED.

If this step is removed, the action object status will not be modified.

The next step is Re-set issued response state to REJECTED for rejection.

No

Re-set issued response state to REJECTED for rejection

Sets the state of the action object to ISSUED.

If this step is removed, the action object status will not be modified.

The next step is Correct response failure for rejection.

No

Review responses

Allows the user to review the response, and revise the action, if needed.

If accepted, the next step is ActionIssueStateToClosed.

If rejected, the next step is ActionIssueStateToResponseRejected.

Yes

This step is needed to close the communication loop.

ActionIssueStateToResponseRejected

Sets the state of the action object to RESPONSE REJECTED.

If this step is removed, the action object status will not be modified.

The next step is Revise the action object with form.

No

Revise the action object with form

Revises the action, and any related documents, tags, and files on the existing revision are copied to the new revision.

The next step is SendOutgoingActionBackToOriginator, which is part of the Outgoing Actions workflow.

No

ActionIssueStateToClosed

Sets the state of the action object to CLOSED.

If this step is removed, the action object status will not be modified.

This is the last step in the workflow.

No

Correct response failure

Allows the user to fix the errors that caused the rendition failure and resubmit the response.

The next step is ActionIssueStateToResponded.

Yes

This step is needed as, otherwise, the rendition failure cannot be fixed and the responses cannot be shared with the submitter.

Correct response failure for rejection

Allows the user to fix the errors that caused the rendition failure and resubmit the response.

The next step is ActionIssueStateToRejected.

Yes

This step is needed as, otherwise, the rendition failure cannot be fixed and the responses cannot be shared with the submitter.

Correct failure

Allows the user to fix the errors that caused the rendition failure and resubmit the action.

The next step is ActionIssueStateToIssued.

Yes

This step is needed as, otherwise, the rendition failure cannot be fixed and the action cannot be sent to the target organization.