Route Creation (RouteSchemaInitialization)

An opening ID is an entry point used to customize business logic. The route creation opening ID lets you define the initialization schema for routes.

By default, this opening ID is deactivated. to activate this opening ID, run the following TCLs.

<server_name>/server/Apps/EnterpriseChangeMgt/V6R2022x/Modules/ENOEnterpriseChangeMgt/AppInstall/Programs/FUN114354_ChangeAction_Enablement.tcl;
<server_name>/server/Apps/EnterpriseChangeMgt/V6R2022x/Modules/ENOEnterpriseChangeMgt/AppInstall/Programs/FUN114354_ChangeRequest_Enablement.tcl;
<server_name>/server/Apps/BusinessProcessServices/V6R2022x/Modules/ENOAppsCommon/AppInstall/Programs/FUN114354_Issue_Enablement.tcl;

Note: For more information about customization by business rules, see Installation and Setup: Customize: Behavior: Data Setup: Customization by Business Rules.

This page discusses:

Environment: On premises only

General Information

This opening ID is invoked: RouteSchemaInitialization

This opening ID is used to customize the route initialization process for change action, change request, and issue.

This opening ID is invoked during the promote and demote transitions of issue, and change objects.

  • When an issue is promoted:
    • From the Draft (Create) to the To Do (Assign) state.
    • From the To Do (Assign) to the In Work (Active) state.
    • From the In Work (Active) to the In Approval (Review) state.
  • When an issue is demoted:
    • From the In Work (Active) to the To Do (Assign) state.
    • From the In Approval (Review) to the In Work (Active) state.
  • When a change request or a change action is promoted:
    • From the Draft (Prepare) to the In Work (In Work) state.
    • From the Approved (Approved to the Completed (Complete) state.
  • When a change request or a change action is demoted from the In Approval (In Approval) to the In Work (In Work) state.

If a content object is repromoted, a new route is initialized every time a business logic is run. If any content object is in a state that blocks existing routes, they are completed automatically. The modifications made on the completed routes are not copied to the newly created route. The new route is created in the same organization and project as the object, and the object owner is assigned as the route owner.

The following table provides you with information related to the definition of the Opening ID.

Definition Description
PLM Opening ID RouteSchemaInitialization
Customization intent Computation
Execution context Server

Input Objects

Input objects must be of the following types:

  • ThisObject: Change action, change request, or issue
  • Parameters corresponds to the context object.

Context Object Parameters

Parameter Name Type Read or Write Comments
Transition String Read Maturity change event name (Promote or Demote)
ComputedRouteSchema Feature Write -

Sample

The following sample describes how to define initialization schema for routes.

let contextSchema(RouteEKLSchema)
let transition(String)
set contextSchema = Parameters->GetAttributeObject("ComputedRouteSchema")
set transition = Parameters->GetAttributeObject("Event") 
if(ThisObject.current == "Assign" and transition == "Promote") {
contextSchema.setRouteTemplateId("template_id_1")
contextSchema.setRouteCompletionAction("Promote Connected Object")
contextSchema.setRouteDemoteOnRejection ("Yes")
}else {
contextSchema.setTemplateName ("template_name_2")
}

setRouteTemplateId is used to define the id of the route template that is used to initiate a route. This value is mandatory.

setTemplateName is used to define the name of the template that is used to initiate a route. This value is mandatory.

setRouteCompletionAction is used to define the value of the Route Completion Action paramater on the newly created route. If this value is not provided, Notify Route Owner is defined as the value of the Route Completion Action parameter.

setRouteDemoteOnRejection is used to define the value of the Demote on Rejection paramater on the newly created route. If this value is not provided, the value of the Demote on Rejection parameter is defined as No.