Sales Territory Dimension Service
Service to operate on territory dimension and territory dimension member business objects. It can be used by third-party applications to perform standard query operations on territory dimension and territory dimension member business objects.
Life Cycle Status: Active
QName: {http://xmlns.oracle.com/apps/sales/territoryMgmt/territories/dimensionPublicService/}TerritoryDimensionPublicService
Service WSDL URL: https://servername/crmService/TerritoryDimensionPublicService?WSDL
Logical Business Objects
-
CRM : Territory Management : Sales Territory Dimension
Relationships
The following table describes how this service data object is related to other service data objects or business object services.
Relationship Type | Object or Service |
---|---|
Handles |
|
Handles |
|
Handles |
|
Handles |
Operations
getTerritoryDimension
Retrieves territory dimension by the specified territory dimension identifier.
Life Cycle Status: Active
Request Payload
Element Name | Type | Description |
---|---|---|
terrDimensionId |
long |
The identifier of the territory dimension to be retrieved. |
Response Payload
Element Name | Type | Description |
---|---|---|
result |
The territory dimension record retrieved by the method. |
findTerritoryDimension
Retrieves the territory dimensions for a given query criteria.
Life Cycle Status: Active
Request Payload
Element Name | Type | Description |
---|---|---|
findCriteria |
{http://xmlns.oracle.com/adf/svc/types/}FindCriteria |
The criteria values to retrieve the records. |
findControl |
{http://xmlns.oracle.com/adf/svc/types/}FindControl |
The control value that indicates whether to retrieve translations or not. |
Response Payload
Element Name | Type | Description |
---|---|---|
result |
The list of territory dimension objects matching the criteria. |
getTerritoryDimensionMember
Retrieves the territory dimension member by a specified territory dimension member identifier.
Life Cycle Status: Active
Request Payload
Element Name | Type | Description |
---|---|---|
terrDimMemberId |
long |
The identifier of the territory dimension member to be retrieved. |
Response Payload
Element Name | Type | Description |
---|---|---|
result |
The sales territory dimension member record. |
findTerritoryDimensionMember
Retrieves the territory dimension members for a given query criteria.
Life Cycle Status: Active
Request Payload
Element Name | Type | Description |
---|---|---|
findCriteria |
{http://xmlns.oracle.com/adf/svc/types/}FindCriteria |
The criteria values to retrieve the records. |
findControl |
{http://xmlns.oracle.com/adf/svc/types/}FindControl |
The control value that indicates whether to retrieve the translations or not. |
Response Payload
Element Name | Type | Description |
---|---|---|
result |
The list of territory dimension member objects matching the criteria. |
getDfltObjAttrHints
Retrieves the user interface hints, such as the service data object label and the object attribute labels, for the specified service data object and locale. As a prerequisite, invoke the getEntityList operation defined on this service to get the list of possible values for the viewName request payload element.
Life Cycle Status: Active
Request Payload
Element Name | Type | Description |
---|---|---|
viewName |
string |
The service view usage name which is the internal name for the service data object. Specify the value of the <name> element from the getEntityList operation response payload. |
localeName |
string |
The locale to use when evaluating locale-based user interface hints. The localeName is in ISO 639-1 format. |
Response Payload
Element Name | Type | Description |
---|---|---|
result |
{http://xmlns.oracle.com/adf/svc/types/}ObjAttrHints |
The label and user interface hints for the specified service data object and its attributes in a name-value pair format. |
getServiceLastUpdateTime
An operation that returns the date and time when the schema files referenced in the service definition last changed.
Life Cycle Status: Active
Request Payload
Response Payload
Element Name | Type | Description |
---|---|---|
result |
{http://xmlns.oracle.com/adf/svc/types/}dateTime-Timestamp |
The date and time when the service definition last changed in ISO 8601 format. |
getEntityList
Retrieves the list of service data objects defined on the service.
Life Cycle Status: Active
Request Payload
Response Payload
Element Name | Type | Description |
---|---|---|
result |
{http://xmlns.oracle.com/adf/svc/types/}ServiceViewInfo |
A list of service data objects defined on the service. For each service data object, the result includes the QName, internal name, and Boolean values indicating whether create, update, merge, and delete operations can be performed on the object. |
Security
The following tables list the privileges required to perform the service operations, and the duty roles that each privilege is granted to.
Service Operations to Privileges Mapping
Operation Name | Privilege Code | Privilege Name | Privilege Description |
---|---|---|---|
All Operations |
MOT_MANAGE_SALES_TERRITORY_PRIV |
Manage Sales Territory |
Allows managing of sales territories. A Territory is the jurisdiction of responsibility of a sales representative over a set of sales accounts. |
All Operations |
MOT_MANAGE_SALES_TERRITORY_SETUP_PRIV |
Manage Sales Territory Setup |
Allows defining and managing of sales territory lookups, profile options, flexfields, and dimension data. |
Privileges to Duty Roles Mapping
Privilege Code | Granted to Duty Role Code | Granted to Duty Role Name | Granted To Duty Role Description |
---|---|---|---|
MOT_MANAGE_SALES_TERRITORY_SETUP_PRIV |
ORA_MOT_TERRITORY_MANAGEMENT_SETUP_DUTY |
Territory Management Setup |
Manages sales territory setup, including lookups, profile options, flexfields, and dimension data. Runs dimension synchronization, and visibility jobs. Additional duties include quota management setup. |
MOT_MANAGE_SALES_TERRITORY_PRIV |
ORA_MOT_TERRITORY_MANAGEMENT_ADMINISTRATION_DUTY |
Territory Management Administration |
Manages sales territories and territory proposals. Additional duties include territory management setup and quota management administration. |
MOT_MANAGE_SALES_TERRITORY_PRIV |
ORA_MOT_TERRITORY_MANAGEMENT_DUTY |
Territory Management |
Manages sales territories, territory proposals, and quotas. |
MOT_MANAGE_SALES_TERRITORY_PRIV |
ORA_MOT_TERRITORY_MANAGEMENT_SETUP_DUTY |
Territory Management Setup |
Manages sales territory setup, including lookups, profile options, flexfields, and dimension data. Runs dimension synchronization, and visibility jobs. Additional duties include quota management setup. |
Duty Roles to Duty or Job Roles Mapping
Duty Role Code | Granted to Duty or Job Role Code | Granted to Duty or Job Role Name | Granted To Duty or Job Role Description |
---|---|---|---|
ORA_MOT_TERRITORY_MANAGEMENT_SETUP_DUTY |
ORA_MOT_QUOTA_EXPORT_MANAGEMENT_DUTY |
Quota Export Management |
Manages bulk export of all sales territory quota related objects. |
ORA_MOT_TERRITORY_MANAGEMENT_DUTY |
ORA_MOT_QUOTA_MANAGEMENT_DUTY |
Quota Management |
Manages sales territory quotas and territory quota formulas. Additional duties include incentive compensation goal management, user and roles management, and party information inquiry. |
ORA_MOT_TERRITORY_MANAGEMENT_ADMINISTRATION_DUTY |
ORA_MOT_QUOTA_MANAGEMENT_ADMINISTRATION_DUTY |
Quota Management Administration |
Manages sales territory quotas, quota setups, territory quota formulas, spread formulas, and seasonality groups, and can view quota plans. Additional duties include incentive compensation goal management, user and roles management, and party information inquiry. |
ORA_MOT_TERRITORY_MANAGEMENT_SETUP_DUTY |
ORA_MOT_QUOTA_MANAGEMENT_SETUP_DUTY |
Quota Management Setup |
Manages sales territory quota setup, quota plans, prediction and spread formula parameters, and seasonality groups. Runs sales territory quota synchronization and sales quota plan activation and completion processes. Additional duties include party information inquiry. |
ORA_MOT_TERRITORY_MANAGEMENT_ADMINISTRATION_DUTY |
ORA_MOT_TERRITORY_MANAGEMENT_EXPORT_IMPORT_DUTY |
Territory Management Export Import |
Manages sales territory export and import. Provides users with the ability to export territory data, modify it offline and import. |
ORA_MOT_TERRITORY_MANAGEMENT_DUTY |
ORA_MOT_TERRITORY_MANAGEMENT_EXPORT_IMPORT_DUTY |
Territory Management Export Import |
Manages sales territory export and import. Provides users with the ability to export territory data, modify it offline and import. |
ORA_MOT_TERRITORY_MANAGEMENT_SETUP_DUTY |
ORA_MOT_TERRITORY_MANAGEMENT_T2P_MIGRATION_DUTY |
Territory Management T2P Migration |
Manages sales territory export and import. Provides users with the ability to export territory data from a test environment and import into production. |