Update an action plan template
patch
/crmRestApi/resources/11.13.18.05/actiontemplates/{TemplateId}
Request
Path Parameters
-
TemplateId(required): integer(int64)
The unique identifier of the action plan template.
Header Parameters
-
Metadata-Context:
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version:
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object
-
ActionPlanTypeCd: string
Title:
Category
Maximum Length:30
The code indicating the type of the action plan with which the template is associated. A list of valid values is defined in the lookup ORA_SVC_AP_ACTION_PLAN_TYPE_CD. -
ActionPlanTypeCdMeaning: string
Title:
Action Plan Type Value
Maximum Length:255
The display value corresponding to the action plan type lookup code for the template. -
AutoStartFlag: boolean
Title:
Auto Start
Maximum Length:1
Default Value:false
Indicates whether the action plans created using the template start automatically. -
BUOrgId: integer
(int64)
Title:
Business Unit ID
The unique identifier of the business unit name associated to the action plan template. -
BusinessUnitName: string
Title:
Business Unit
The name of the business unit associated to the template. -
CalendarId: integer
(int64)
Title:
Calendar
The unique identifier of the calendar that is associated with the action plan template. -
DeletedFlag: boolean
Title:
Deleted
Maximum Length:1
Default Value:false
Indicates whether the action plan template has been deleted. The default value is false. -
Description: string
Title:
Description
Maximum Length:1000
The description of the action plan template. -
EnabledFlag: boolean
Title:
Published
Maximum Length:1
Default Value:false
Indicates whether the action plan template is enabled in the system. The default value is true. -
EndDate: string
(date-time)
Title:
End Date
The date when the action plan template ends. -
Name: string
Title:
Template
Maximum Length:400
The name of the action plan template. -
ObjectEntityName: string
Title:
Context
Maximum Length:400
The name of the object entity that the template uses to create action plans. -
ObjectEntityNameMeaning: string
Title:
Object Entity Name Value
Maximum Length:255
The display value corresponding to the object entity name lookup code for the template. -
StartDate: string
(date-time)
Title:
Start Date
The date when the action plan template starts. -
StripeCd: string
Title:
Stripe Code
Maximum Length:30
The application context of the action plan template. -
StripeCdMeaning: string
Title:
Stripe Value
Maximum Length:255
The display value corresponding to the stripe lookup code for the template. -
templateAction: array
Template Actions
Title:
Template Actions
The template actions resource is used to view, create, update, and delete the associations of actions with action plan templates.
Nested Schema : Template Actions
Type:
array
Title:
Template Actions
The template actions resource is used to view, create, update, and delete the associations of actions with action plan templates.
Show Source
Nested Schema : schema
Type:
Show Source
object
-
actionRelation: array
Action Relations
Title:
Action Relations
The action relations resource is used to view, create, update, and delete the dependencies of actions on other actions in an action plan template. -
DeletedFlag: boolean
Title:
Deleted
Maximum Length:1
Default Value:false
Indicates whether the template action has been deleted. The default value is false. -
MandatoryFlag: boolean
Title:
Mandatory
Maximum Length:1
Default Value:true
Indicates whether the action in an action plan is mandatory. The default value is true. -
OrderNumber: integer
(int64)
Title:
Sort Number
The order of display for an action within an action template.
Nested Schema : Action Relations
Type:
array
Title:
Action Relations
The action relations resource is used to view, create, update, and delete the dependencies of actions on other actions in an action plan template.
Show Source
Nested Schema : schema
Type:
Show Source
object
-
ActionStatusCd: string
Title:
Action Status
Maximum Length:30
Default Value:ORA_SVC_COMPLETED
The status code which indicates the dependency condition of an action relation. A list of valid values is defined in the lookup ORA_SVC_AP_STATUS_CD. -
ActionStatusCdMeaning: string
Title:
Action Status Value
Maximum Length:255
The display value corresponding to the action status lookup code for the action relation. -
DeletedFlag: boolean
Title:
Deleted
Maximum Length:1
Default Value:false
Indicates whether the action dependency has been deleted. The default value is false. -
DepTemplateActionId: integer
(int64)
Title:
Dependent Template Action ID
The unique identifier of the dependent action in an action plan.
Response
Supported Media Types
- application/json
Default Response
The following table describes the default response for this task.
Headers
-
Metadata-Context:
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version:
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Root Schema : actiontemplates-item-response
Type:
Show Source
object
-
ActionPlanTypeCd: string
Title:
Category
Maximum Length:30
The code indicating the type of the action plan with which the template is associated. A list of valid values is defined in the lookup ORA_SVC_AP_ACTION_PLAN_TYPE_CD. -
ActionPlanTypeCdMeaning: string
Title:
Action Plan Type Value
Maximum Length:255
The display value corresponding to the action plan type lookup code for the template. -
AutoStartFlag: boolean
Title:
Auto Start
Maximum Length:1
Default Value:false
Indicates whether the action plans created using the template start automatically. -
BUOrgId: integer
(int64)
Title:
Business Unit ID
The unique identifier of the business unit name associated to the action plan template. -
BusinessUnitName: string
Title:
Business Unit
The name of the business unit associated to the template. -
CalendarId: integer
(int64)
Title:
Calendar
The unique identifier of the calendar that is associated with the action plan template. -
CoverageName: string
Title:
Calendar
Read Only:true
The name of the calendar associated with the action plan template. -
CoverageTimeId: integer
Title:
Coverage Time ID
Read Only:true
The unique identifier of the calendar associated with the action plan template. -
CreatedBy: string
Title:
Created By
Read Only:true
Maximum Length:64
The user who created the action plan template. -
CreationDate: string
(date-time)
Title:
Creation Date
Read Only:true
The date and time when the action plan template was created. -
DeletedFlag: boolean
Title:
Deleted
Maximum Length:1
Default Value:false
Indicates whether the action plan template has been deleted. The default value is false. -
DeleteFlag: boolean
Read Only:
true
Indicates whether the action plan template can be deleted. -
Description: string
Title:
Description
Maximum Length:1000
The description of the action plan template. -
EnabledFlag: boolean
Title:
Published
Maximum Length:1
Default Value:false
Indicates whether the action plan template is enabled in the system. The default value is true. -
EndDate: string
(date-time)
Title:
End Date
The date when the action plan template ends. -
LastUpdateDate: string
(date-time)
Title:
Last Update Date
Read Only:true
The date and time when the action plan template was last updated. -
LastUpdatedBy: string
Title:
LastUpdatedBy
Read Only:true
Maximum Length:64
The user who last updated the action plan template. -
LastUpdateLogin: string
Title:
Last Update Login
Read Only:true
Maximum Length:32
The login details of the user who last updated the action plan template. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
Name: string
Title:
Template
Maximum Length:400
The name of the action plan template. -
ObjectEntityName: string
Title:
Context
Maximum Length:400
The name of the object entity that the template uses to create action plans. -
ObjectEntityNameMeaning: string
Title:
Object Entity Name Value
Maximum Length:255
The display value corresponding to the object entity name lookup code for the template. -
SchedulePuid: string
Title:
Schedule PUID
Read Only:true
Maximum Length:120
The public unique identifier of a standard coverage schedule. -
StartDate: string
(date-time)
Title:
Start Date
The date when the action plan template starts. -
StripeCd: string
Title:
Stripe Code
Maximum Length:30
The application context of the action plan template. -
StripeCdMeaning: string
Title:
Stripe Value
Maximum Length:255
The display value corresponding to the stripe lookup code for the template. -
templateAction: array
Template Actions
Title:
Template Actions
The template actions resource is used to view, create, update, and delete the associations of actions with action plan templates. -
TemplateId: integer
(int64)
Title:
Template ID
The unique identifier of the action plan template. -
TemplateNumber: string
Title:
Template Number
Maximum Length:30
The reference number of the action plan template. -
UpdateFlag: boolean
Read Only:
true
Indicates whether the action plan template can be updated.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : Template Actions
Type:
array
Title:
Template Actions
The template actions resource is used to view, create, update, and delete the associations of actions with action plan templates.
Show Source
Nested Schema : link
Type:
Show Source
object
-
href: string
Title:
hyperlink reference
The URI to the related resource. -
kind: string
Title:
kind
Allowed Values:[ "collection", "item", "describe", "other" ]
The kind of the related resource. -
name: string
Title:
name
The name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relation
Allowed Values:[ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]
The name of the relation to the resource instance. Example: self.
Nested Schema : properties
Type:
Show Source
object
-
changeIndicator: string
Change indicator or the ETag value of the resource instance.
Nested Schema : actiontemplates-templateAction-item-response
Type:
Show Source
object
-
ActionId: integer
(int64)
Title:
Action ID
The unique identifier of the action. -
ActionNumber: string
Title:
Action Number
Maximum Length:64
The reference number of the action. -
actionRelation: array
Action Relations
Title:
Action Relations
The action relations resource is used to view, create, update, and delete the dependencies of actions on other actions in an action plan template. -
CreatedBy: string
Title:
Created By
Read Only:true
Maximum Length:64
The user who added the action to the template. -
CreationDate: string
(date-time)
Title:
Creation Date
Read Only:true
The date and time when the action was added to the template. -
DeletedFlag: boolean
Title:
Deleted
Maximum Length:1
Default Value:false
Indicates whether the template action has been deleted. The default value is false. -
DeleteFlag: boolean
Read Only:
true
Indicates whether the template action can be deleted. -
LastUpdateDate: string
(date-time)
Title:
Last Update Date
Read Only:true
The date and time when the template action was last updated. -
LastUpdatedBy: string
Title:
Last Updated By
Read Only:true
Maximum Length:64
The user who last updated the template action. -
LastUpdateLogin: string
Title:
Last Update Login
Read Only:true
Maximum Length:32
The login details of the user who last updated the template action. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
MandatoryFlag: boolean
Title:
Mandatory
Maximum Length:1
Default Value:true
Indicates whether the action in an action plan is mandatory. The default value is true. -
OrderNumber: integer
(int64)
Title:
Sort Number
The order of display for an action within an action template. -
Prerequisites: string
Read Only:
true
The prerequisite action steps for the action. -
TemplateActionId: integer
(int64)
Title:
Template Action ID
Read Only:true
The unique identifier of the template action. -
TemplateActionNumber: string
Title:
Template Action Number
Maximum Length:30
The template action reference number. -
TemplateId: integer
(int64)
Title:
Template ID
The unique identifier of the action plan template. -
TemplateNumber: string
Title:
Template Number
Maximum Length:30
The reference number of the action plan template. -
Tier: integer
Read Only:
true
The tier used in an action plan diagram to display the action nodes at appropriate levels. -
UpdateFlag: boolean
Read Only:
true
Indicates whether the template action can be updated.
Nested Schema : Action Relations
Type:
array
Title:
Action Relations
The action relations resource is used to view, create, update, and delete the dependencies of actions on other actions in an action plan template.
Show Source
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : actiontemplates-templateAction-actionRelation-item-response
Type:
Show Source
object
-
ActionStatusCd: string
Title:
Action Status
Maximum Length:30
Default Value:ORA_SVC_COMPLETED
The status code which indicates the dependency condition of an action relation. A list of valid values is defined in the lookup ORA_SVC_AP_STATUS_CD. -
ActionStatusCdMeaning: string
Title:
Action Status Value
Maximum Length:255
The display value corresponding to the action status lookup code for the action relation. -
CreatedBy: string
Title:
Created By
Read Only:true
Maximum Length:64
The user who created the dependencies of an action. -
CreationDate: string
(date-time)
Title:
Creation Date
Read Only:true
The date and time when the action dependency was created. -
DeletedFlag: boolean
Title:
Deleted
Maximum Length:1
Default Value:false
Indicates whether the action dependency has been deleted. The default value is false. -
DeleteFlag: boolean
Read Only:
true
Indicates whether the action relation can be deleted. -
DepTemplateActionId: integer
(int64)
Title:
Dependent Template Action ID
The unique identifier of the dependent action in an action plan. -
DepTemplateActionNumber: string
Title:
Dependent Template Action Number
Maximum Length:30
The template action reference number of a dependent action. -
DepTmpActionOrderNumber: integer
(int64)
Title:
Sort Number
Read Only:true
The order of display for an action within an action template. -
LastUpdateDate: string
(date-time)
Title:
Last Update Date
Read Only:true
The date and time when the action dependency was last updated. -
LastUpdatedBy: string
Title:
Last Updated By
Read Only:true
Maximum Length:64
The user who last updated the dependencies of an action. -
LastUpdateLogin: string
Title:
Last Update Login
Read Only:true
Maximum Length:32
The login details of the user who last updated the action dependency. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
RelationId: integer
(int64)
Title:
Relation ID
The unique identifier of the relation between the actions in an action plan. -
TemplateActionId: integer
(int64)
Title:
Template Action ID
The unique identifier of the template action. -
TemplateActionNumber: string
Title:
Template Action Number
Maximum Length:30
The template action reference number. -
UpdateFlag: boolean
Read Only:
true
Indicates whether the action relation can be updated.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Links
- ActionPlanTypeLookupPVO
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_SVC_AP_ACTION_PLAN_TYPE_CD
The list of values indicating the type of action plan the template is associated with.
The following properties are defined on the LOV link relation:- Source Attribute: ActionPlanTypeCd; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- BusinessUnitLOV
-
The list of values indicating the name of the business unit associated to the template.
The following properties are defined on the LOV link relation:- Source Attribute: BusinessUnitName; Target Attribute: Name
- Display Attribute: Name
- ObjectEntityNameLookup
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_SVC_AP_PARENT_ENTITY_NAME
The list of values indicating the application context of the action plan template.
The following properties are defined on the LOV link relation:- Source Attribute: ObjectEntityName; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- StripeCdLOV
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_SVC_STRIPE_CD
The following properties are defined on the LOV link relation:- Source Attribute: StripeCd; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- YesNoLookup
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DYES_NO
The list of values indicating if the action plan will initiate automatically after the creation.
The following properties are defined on the LOV link relation:- Source Attribute: AutoStartFlag; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- templateAction
-
Parameters:
- TemplateId:
$request.path.TemplateId
The template actions resource is used to view, create, update, and delete the associations of actions with action plan templates. - TemplateId:
Examples
The following example shows how to update an action template by submitting a PATCH request on the REST resource using cURL.
cURL Command
curl -u <username:password> \ -X PATCH -d
@example_request_payload.json https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/actiontemplates/300100118921028
Example of Request Body
The following example shows the contents of the request body in JSON format.
{ "Name" : "REST-t2" }
Example of Response Body
The following example shows the contents of the response body in JSON format.
{ "ActionPlanTypeCd": null, "CalendarId": 300100028308361, "CreatedBy": "SALES_ADMIN", "CreationDate": "2017-09-27T14:41:48+00:00", "DeletedFlag": false, "Description": null, "EnabledFlag": true, "EndDate": null, "LastUpdateDate": "2017-09-27T14:43:53+00:00", "LastUpdateLogin": "5A2BD805BC436ED2E0538E09F20A9D1F", "LastUpdatedBy": "SALES_ADMIN", "Name": "REST-t2", "ObjectEntityName": "ServiceRequest", "StartDate": null, "TemplateId": 300100118921028, "CoverageName": "24 by 7", "CoverageTimeId": 300100028308361, "UpdateFlag": true, "DeleteFlag": true, "DclTemplate_Id_c": null, "DclTemplate_c": null, "links": [ ... ] }