Get a goal objective
get
/crmRestApi/resources/11.13.18.05/businessPlans/{BusinessPlanId}/child/Goals/{GoalNumber}/child/SalesObjectives/{ObjectiveId}
Request
Path Parameters
-
BusinessPlanId(required): integer(int64)
The unique identifier of the business plan.
-
GoalNumber(required): string
The identifier for the goal number.
-
ObjectiveId(required): integer(int64)
The unique identifier of the objective.
Query Parameters
-
dependency: string
This parameter specifies dependencies which are fields that are set before and rolled back after generating the response. Generally they are used to preview the effects of an attribute change. The fields specified in this parameter are always set in the resource instance in question. When a child resource collection is requested and the parameter is set, the fields will be set in the parent resource instance before generating the resource collection payload. The value of this query parameter is a set of dependency fields. Example: dependency=ProductId=2
Format: <attr1>=<val1>,<attr2>=<value2> -
expand: string
When this parameter is provided, the specified children are included in the resource payload (instead of just a link). The value of this query parameter is "all" or "". More than one child can be specified using comma as a separator. Example: ?expand=Employees,Localizations. Nested children can also be provided following the format "Child.NestedChild" (Example: ?expand=Employees.Managers). If a nested child is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?expand=Employees.Managers" is the same as "?expand=Employees,Employees.Managers" (which will expand Employees and Managers).
-
fields: string
This parameter filters the resource fields. Only the specified fields are returned, which means that if no fields are specified, no fields are returned (useful to get only the links). If an indirect child resource is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?fields=Employees.Managers:Empname" is the same as "?fields=;Employees:;Employees.Managers:Empname" (which will only return the "Empname" field for Managers). the value of this query parameter is a list of resource fields. The attribute can be a direct (Example: Employees) or indirect (Example: Employees.Managers) child. It cannot be combined with expand query parameter. If both are provided, only fields will be considered.
Format: ?fields=Attribute1,Attribute2
Format for fields in child resource: ?fields=Accessor1:Attribute1,Attribute2 -
links: string
This parameter can be used to show only certain links while accessing a singular resource or a resource collection. The parameter value format is a comma-separated list of : <link_relation>
Example:
self,canonical -
onlyData: boolean
The resource item payload will be filtered in order to contain only data (no links section, for example).
Header Parameters
-
Metadata-Context: string
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: string
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.
There's no request body for this operation.
Back to TopResponse
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 : businessPlans-Goals-SalesObjectives-item-response
Type:
Show Source
object-
AccountId: integer
(int64)
Title:
AccountThe unique identifier of the account assigned to the objective. -
AccountName: string
Title:
AccountThe account name for a sales objective target. -
AccountNumber: string
Read Only:
trueMaximum Length:30Unique identifier of a party in the TCA registry. -
ActualValue: integer
Title:
AttainmentThe actual attainment value for the objective. -
BusinessPlanId: integer
(int64)
Title:
Business Plan IDThe unique identifier of the business plan. -
BusinessPlanName: string
Title:
Business PlanRead Only:trueMaximum Length:275The name of the business plan for the objective. -
BusinessPlanNumber: string
Title:
Business Plan NumberMaximum Length:64The alternate key identifier for the business plan. -
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:64The user who created the record. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueThe date when the record was created. -
CurrencyCode: string
Title:
Currency CodeMaximum Length:15The currency code associated with the objective. A list of valid values are defined in the lookup RatedCurrenciesVO. -
DeleteFlag: boolean
Read Only:
trueIndicates whether the objective can be deleted. The default value is true. -
Description: string
Title:
DescriptionMaximum Length:2000The description of the objective. -
EndDisplayPeriodName: string
Title:
End Period NameMaximum Length:60The display name of the end period for the objective. A list of valid values is defined in the lookup SalesGLEndPeriodPickTimeListToViewAccessor. -
EndPeriodName: string
Title:
Period End Internal NameMaximum Length:15The internal name of the end period for the objective. -
GeographyId: integer
(int64)
Title:
GeographyThe unique identifier for the geography. -
GeographyKey: string
The geography key of the geography.
-
GeographyName: string
Title:
GeographyMaximum Length:255The name of the geography, such as JAPAC, EMEA, or Americas. -
GoalId: integer
(int64)
Title:
Goal IDThe system generated identifier for the business plan goals. -
GoalNumber: string
Title:
Goal NumberThe unique alternative identifier of the goal. -
Initiatives: array
Initiatives
Title:
InitiativesThe initiatives resource is used to view, create, update and delete initiatives associated with business plan's sales objective. -
LastUpdateDate: string
(date-time)
Title:
Last Updated DateRead Only:trueThe date on which the record was last updated. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:64The user who last updated the record. -
LastUpdateLogin: string
Title:
Last Update LoginRead Only:trueMaximum Length:32The login of the user who last updated the record. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
Name: string
Title:
NameMaximum Length:300The name of the objective. -
ObjectiveId: integer
(int64)
Title:
Objective IDThe unique identifier of the objective. -
ObjectiveNumber: string
Title:
NumberMaximum Length:30The alternate key identifier for the objective. -
ObjectiveOwnerId: integer
(int64)
Title:
Owner IDThe identification key for the resource who owns the sales objective. -
ObjectiveTypeCode: string
Title:
Objective Type CodeMaximum Length:30The code indicating how the objective is categorized. The list of codes is available in LovSalesObjectiveTypeVO. -
ObjectiveTypeName: string
Title:
TypeMaximum Length:60The type of the objective. -
OrigCreationDate: string
(date-time)
Title:
Original Creation DateThe date when the objective was originally created in an external system. -
OwnerPartyName: string
Title:
OwnerRead Only:trueName of the owner of the sales objective. -
OwnerPartyNumber: string
Title:
Owner NumberThe unique alternative identifier of the owner. -
PeriodEndDate: string
(date)
Title:
End DateRead Only:trueThe last date the object is active. -
PeriodStartDate: string
(date)
Title:
Start DateRead Only:trueThe first date the object is active. -
PeriodTypeCode: string
Title:
Period Type CodeMaximum Length:30The code indicating the type of period for the objective. A list of valid values is defined in the lookup SalesObjectiveGLPeriodTypeViewAccessor. -
PeriodTypeName: string
Title:
PeriodRead Only:trueMaximum Length:80The name of the period type for the objective. -
ProductGroupId: integer
(int64)
Title:
Product GroupThe unique identifier for the product group. -
ProductGroupName: string
Title:
Product GroupMaximum Length:250The name of the product group. -
ProductGroupReferenceNumber: string
Title:
Reference NumberMaximum Length:50The reference number for the product Group. -
StartDisplayPeriodName: string
Title:
Start Period NameMaximum Length:60The display name of the start period for the objective. A list of valid values is defined in the lookup SalesGLStartPeriodPickerTimeListViewAccessor. -
StartPeriodName: string
Title:
Period Start Internal NameMaximum Length:15The internal name of the start period for the objective. -
TargetValue: integer
Title:
TargetThe unique identifier for the target of the objective. -
UnitOfMeasureCode: string
Title:
Unit of Measure CodeRead Only:trueMaximum Length:30The code indicating the unit of measure for the objective. -
UnitOfMeasureName: string
Title:
Unit of MeasureRead Only:trueMaximum Length:80The unit of measure of the objective. -
UpdateFlag: boolean
Read Only:
trueIndicates whether the objective can be updated. The default value is true.
Nested Schema : Initiatives
Type:
arrayTitle:
InitiativesThe initiatives resource is used to view, create, update and delete initiatives associated with business plan's sales objective.
Show Source
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : businessPlans-Goals-SalesObjectives-Initiatives-item-response
Type:
Show Source
object-
BusinessPlanId: integer
(int64)
Title:
Business Plan IDThe identification key for business plan. -
BusinessPlanNumber: string
Title:
Business Plan NumberRead Only:trueMaximum Length:64The number of the business plan for which an initiative was created. -
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:64Lists who created the row of data. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueThe date when the record was created. -
CustomerId: integer
(int64)
Title:
Customer IDRead Only:trueThe customer identifier that is associated with the business plan. -
GoalId: integer
(int64)
Title:
Goal IDThe system generated identifier for the business plan goals. -
InitiativeId: integer
(int64)
Title:
Initiative IDThe unique identifier for initiative. -
LastUpdateDate: string
(date-time)
Title:
Last Updated DateRead Only:trueThe date on which the record was last updated. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:64The user who last updated the record. -
LastUpdateLogin: string
Title:
Last Update LoginRead Only:trueMaximum Length:32The login of the user who last updated the record. -
LeadId: integer
(int64)
Title:
Lead IDThe unique identifier for the lead associated with the business plan. -
LeadNumber: string
Title:
Lead NumberUnique identifier for lead. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
ObjectiveId: integer
(int64)
Title:
Objective IDThe unique identifier for objective. -
OptyId: integer
(int64)
Title:
Opportunity IDThe unique identifier for the opportunity associated with the business plan. -
OptyNumber: string
Title:
Opportunity NumberUnique identifier for opportunity.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : link
Type:
Show Source
object-
href: string
Title:
hyperlink referenceThe URI to the related resource. -
kind: string
Title:
kindAllowed Values:[ "collection", "item", "describe", "other" ]The kind of the related resource. -
name: string
Title:
nameThe name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relationAllowed 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.
Links
- Initiatives
-
Parameters:
- BusinessPlanId:
$request.path.BusinessPlanId - GoalNumber:
$request.path.GoalNumber - ObjectiveId:
$request.path.ObjectiveId
The initiatives resource is used to view, create, update and delete initiatives associated with business plan's sales objective. - BusinessPlanId:
- LovSalesObjectiveTypeVO
-
Parameters:
- finder:
SalesObjectiveTypeFinder%3BBindObjectiveTypeCode%3D{ObjectiveTypeCode}
The list of values indicating the type of the sales objective.
The following properties are defined on the LOV link relation:- Source Attribute: ObjectiveTypeName; Target Attribute: Name
- Display Attribute: Name
- finder:
- ProductGroupViewAccessor
-
Parameters:
- finder:
ProductGroupList
The list of values of the sales objective product group.
The following properties are defined on the LOV link relation:- Source Attribute: ProductGroupName; Target Attribute: ProdGroupName
- Display Attribute: ProdGroupName
- finder:
- RatedCurrenciesVO
-
The list of values for the currency conversion rate type associated with the sales objective, such as US Dollar or Indian Rupee.
The following properties are defined on the LOV link relation:- Source Attribute: CurrencyCode; Target Attribute: CurrencyCode
- Display Attribute: CurrencyCode
- SalesGLEndPeriodPickTimeListToViewAccessor
-
Parameters:
- finder:
EndPeriodFinder%3BbindPeriodType%3D{PeriodTypeCode}
The list of values of the display names for the sales objective end period.
The following properties are defined on the LOV link relation:- Source Attribute: EndDisplayPeriodName; Target Attribute: PeriodName
- Display Attribute: PeriodName
- finder:
- SalesGLStartPeriodPickerTimeListViewAccessor
-
Parameters:
- finder:
StartPeriodFinder%3BbindPeriodType%3D{PeriodTypeCode}
The list of values of the display names for the sales objective start period.
The following properties are defined on the LOV link relation:- Source Attribute: StartDisplayPeriodName; Target Attribute: PeriodName
- Display Attribute: PeriodName
- finder:
- SalesObjectiveGLPeriodTypeViewAccessor
-
The list of values indicating the type of the sales objective period.
The following properties are defined on the LOV link relation:- Source Attribute: PeriodTypeCode; Target Attribute: LookupCode
- Display Attribute: LookupCode