Get one initiative

get

/fscmRestApi/resources/11.13.18.05/supplierInitiatives/{InitiativeId}

Request

Path Parameters
Query Parameters
  • 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>
  • 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).
  • 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
  • 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
  • The resource item payload will be filtered in order to contain only data (no links section, for example).
Header Parameters
  • 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".
  • 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 Top

Response

Supported Media Types

Default Response

The following table describes the default response for this task.
Headers
  • 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".
  • 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.
Body ()
Root Schema : supplierInitiatives-item-response
Type: object
Show Source
  • Title: Evaluation Due Date
    Date when the assessment was due for evaluation.
  • Title: Assessment Owner
    Maximum Length: 240
    Name of the assessment owner.
  • Value that uniquely identifies the owner of the assessment.
  • Attachments
    Title: Attachments
    The Attachments resource manages the attachments.
  • Title: Automatically Accept Responses
    Maximum Length: 1
    Value that indicates whether to accept questionnaire responses automatically or not. Contains one of the following values: true or false. If true, then the questionnaire response is automatically accepted. If false, then the qualification manager has to manually accept the response. The default value is false.
  • Title: Automatically Populate Responses
    Maximum Length: 1
    Value that indicates whether to default responses from response repository or not. Contains one of the following values: true or false. If true, then the response from repository is default on the questionnaire. If false, then the response does not default on the questionnaire. The default value is false.
  • Title: Canceled By
    Read Only: true
    Maximum Length: 240
    User who canceled the initiative.
  • Value that uniquely identifies the user who canceled the initiative.
  • Title: Canceled Reason
    Maximum Length: 1000
    Reason for cancellation of the initiative specified by the user.
  • Read Only: true
    Date and time when the initiative is created.
  • Title: Creation Source
    Read Only: true
    Maximum Length: 80
    Value that indicates the creation source of the initiative. Valid values are Manual, Requalification, Supplier Promotion, or Supplier Registration Approval.
  • Maximum Length: 80
    Abbreviation that identifies the creation source of initiative. A list of accepted values is defined in the lookup type ORA_POQ_CREATION_SOURCE. Review the values for this attribute using the Setup and Maintenance work area, and the Manage Standard Lookups task.
  • Title: Description
    Maximum Length: 250
    Description of the initiative entered by the user.
  • Flexfields for Initiatives
    Title: Flexfields for Initiatives
    The Flexfields for Initiatives resource gets the initiative descriptive flexfields.
  • Evaluation Team Members
    Title: Evaluation Team Members
    The Evaluation Team Members resource gets the evaluation team members on an initiative.
  • Title: Initiative
    Maximum Length: 30
    Number that is assigned to the initiative.
  • Title: Cancellation Date
    Date and time when the initiative was canceled.
  • Title: Completion Date
    Date and time when the initiative was completed.
  • Value that uniquely identifies the initiative.
  • Title: Initiative Owner
    Maximum Length: 240
    Name of the initiative owner.
  • Value that uniquely identifies the owner of the initiative.
  • Title: Internal survey
    Maximum Length: 1
    Default Value: false
    Contains one of the following values: true or false. If true, the initiative is of type survey and allows responses from multiple internal responders to be used for evaluation of the qualification. If false, the initiative allows responses from a single responder. The default value is false.
  • Title: Initiative Type
    Maximum Length: 80
    Value that identifies the type of initiative.
  • Maximum Length: 30
    Abbreviation that identifies the type of initiative. A list of accepted values is defined in the lookup type POQ_INITIATIVE_TYPE. Review the values for this attribute using the Setup and Maintenance work area, and the Manage Standard Lookups task.
  • Title: Internal Note
    Maximum Length: 4000
    Internal notes for the initiative entered by the user.
  • Title: Last Overdue Reminder Date
    Date and time when an overdue reminder notification was last sent to an internal response that was overdue for the initiative.
  • Title: Last Supplier Overdue Reminder Date
    Date and time when an overdue reminder notification was last sent to an external response that was overdue for the initiative.
  • Title: Launch Date
    Date and time when the initiative was launched.
  • Links
  • Title: Procurement BU
    Maximum Length: 240
    Name of the procurement business unit associated with initiative.
  • Value that uniquely identifies the procurement business unit associated with the initiative.
  • Qualification Areas
    Title: Qualification Areas
    The Qualification Areas resource gets the qualification areas on an initiative.
  • Title: Qualification Model
    Maximum Length: 80
    Name of the qualification model for assessment initiative.
  • Value that uniquely identifies the qualification model for assessment initiative.
  • Title: Qualification Model Revision
    Read Only: true
    Default Value: 0
    Revision of the qualification model for assessment initiative.
  • Title: Qualification Model Status
    Read Only: true
    Maximum Length: 80
    Status of the qualification model for assessment initiative.
  • Title: Qualification Model Status Code
    Read Only: true
    Maximum Length: 30
    Default Value: DRAFT
    Abbreviation that identifies the status of the qualification model. A list of accepted values is defined in the lookup type POQ_QUAL_MODEL_STATUS. Review the values for this attribute using the Setup and Maintenance work area, and the Manage Standard Lookups task.
  • Title: Reuse Active Qualification
    Maximum Length: 1
    Value that indicates if existing active qualifications can be reused for the assessment type of initiative. The assessment type of initiative contains the following values: true or false. If true and if a valid reusable active qualification exists, then the qualification should be used in initiative. If true and if no valid reusable qualification exists, then the initiative will create a draft qualification. If false, then qualifications will be created for the qualification area. This attribute does not have a default value. The qualification type of initiative contains a null value.
  • Title: Initiative Status
    Read Only: true
    Maximum Length: 80
    Status of the initiative.
  • Maximum Length: 30
    Abbreviation that identifies the status of the initiative. A list of accepted values is defined in the lookup type POQ_INITIATIVE_STATUS. Review the values for this attribute using the Setup and Maintenance work area, and the Manage Standard Lookups task.
  • Suppliers
    Title: Suppliers
    The Suppliers resource gets the suppliers on an initiative.
  • Title: Title
    Maximum Length: 80
    Title of the initiative entered by the user.
Nested Schema : Attachments
Type: array
Title: Attachments
The Attachments resource manages the attachments.
Show Source
Nested Schema : Flexfields for Initiatives
Type: array
Title: Flexfields for Initiatives
The Flexfields for Initiatives resource gets the initiative descriptive flexfields.
Show Source
Nested Schema : Evaluation Team Members
Type: array
Title: Evaluation Team Members
The Evaluation Team Members resource gets the evaluation team members on an initiative.
Show Source
Nested Schema : Qualification Areas
Type: array
Title: Qualification Areas
The Qualification Areas resource gets the qualification areas on an initiative.
Show Source
Nested Schema : Suppliers
Type: array
Title: Suppliers
The Suppliers resource gets the suppliers on an initiative.
Show Source
Nested Schema : supplierInitiatives-attachments-item-response
Type: object
Show Source
Nested Schema : supplierInitiatives-DFF-item-response
Type: object
Show Source
Nested Schema : supplierInitiatives-evaluationTeamMembers-item-response
Type: object
Show Source
Nested Schema : supplierInitiatives-qualificationAreas-item-response
Type: object
Show Source
Nested Schema : supplierInitiatives-suppliers-item-response
Type: object
Show Source
  • Value that uniquely identifies the supplier.
  • Title: Internal Responder
    Maximum Length: 240
    Name of the internal responder.
  • Value that uniquely identifies the internal responder.
  • Links
  • Title: Response Pulled
    Maximum Length: 1
    Value that indicates whether the response has been pulled for this supplier as part of initiative or not. Contains one of the following values: true or false. If true, then data is pulled from the profile into repository. If false, then data is not pulled from the profile into repository. This attribute does not have a default value.
  • Title: Send Internal Questionnaire
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then questionnaire is sent to the internal responder. If false, then questionnaire is not sent to the internal responder. The default value is true if the response to any of the required questions in the internal questionnaire is missing in the response repository. Else, the default value is false. This attribute is used for both qualification and assessment type of initiatives.
  • Title: Send Supplier Questionnaire
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then questionnaire is sent to the supplier contact. If false, then questionnaire is not sent to the supplier contact. The default value is true if the response to any of the required questions in the supplier questionnaire is missing in the response repository. Else, the default value is false. This attribute is used for both qualification and assessment type of initiatives.
  • Title: Supplier
    Maximum Length: 360
    Name of the supplier.
  • Title: Supplier Contact
    Maximum Length: 255
    Name of the supplier contact.
  • Value that uniquely identifies the supplier contact.
  • Value that uniquely identifies the supplier.
  • Title: Supplier Number
    Maximum Length: 30
    Number that identifies the supplier.
  • Title: Supplier Site
    Maximum Length: 240
    Name of the supplier site.
  • Value that uniquely identifies the supplier site.
Back to Top

Examples

This example describes how to get one initiative.

Example cURL Command

Use the following cURL command to submit a request on the REST resource:

curl -u username:password "https://servername/fscmRestApi/resources/version/supplierInitiatives/InitiativeId"

For example, the following command gets one initiative:

curl -u username:password "https://servername/fscmRestApi/resources/version/supplierInitiatives/300100194001265"

Example Response Body

The following shows an example of the response body in JSON format.

{
	"items": [
	{
		"InitiativeId": 300100194001265,
		"Initiative": "451",
		"Title": "Identify Suppliers for new manufacturing Plant",
		"Description": "This Initiative is to identify qualified suppliers for new manufacturing plant.",
		"StatusCode": "IN_PROGRESS",
		"Status": "In progress",
		"InitiativeTypeCode": "QUALIFICATION",
		"InitiativeType": "Qualification",
		"ProcurementBUId": 204,
		"ProcurementBU": "Vision Operations",
		"InitiativeOwnerId": 100010026863783,
		"InitiativeOwner": "James,Clare",
		"InternalNote": null,
		"QualificationModelId": null,
		"QualificationModel": null,
		"QualificationModelStatusCode": null,
		"QualificationModelStatus": null,
		"QualificationModelRevision": null,
		"AssessmentOwnerId": null,
		"AssessmentOwner": null,
		"AssessmentEvaluationDueDate": null,
		"ReuseActiveQualificationFlag": false,
		"LaunchDate": "2020-02-10T20:34:30.580+00:00",
		"InitiativeCompletionDate": null,
		"InitiativeCancellationDate": null,
		"CanceledById": null,
		"CanceledBy": null,
		"CanceledReason": null,
		"CreationDate": "2020-02-10T20:28:52+00:00",
		"CreationSourceCode": "MANUAL",
		"CreationSource": "Manual",
		"AutoAcceptResponsesFlag": false,
		"AutoPopulateResponsesFlag": true,
		"LastOverdueReminderDate": null,
		"links": [
		{
			"rel": "self",
			"href": "https://servername/fscmRestApi/resources/version/supplierInitiatives/300100194001265",
			"name": "supplierInitiatives",
			"kind": "item",
			"properties": {
				"changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A657870000000017704000000017372001B6F7261636C652E6A626F2E646F6D61696E2E4E756C6C56616C75655899C1C58DAABEEB02000149000A6D53514C54797065496478700000000C78"
			}
		},
		{
			"rel": "canonical",
			"href": "https://servername/fscmRestApi/resources/version/supplierInitiatives/300100194001265",
			"name": "supplierInitiatives",
			"kind": "item"
		},
		{
			"rel": "child",
			"href": "https://servername/fscmRestApi/resources/version/supplierInitiatives/300100194001265/child/evaluationTeamMembers",
			"name": "evaluationTeamMembers",
			"kind": "collection"
		},
		{
			"rel": "child",
			"href": "https://servername/fscmRestApi/resources/version/supplierInitiatives/300100194001265/child/qualificationAreas",
			"name": "qualificationAreas",
			"kind": "collection"
		},
		{
			"rel": "child",
			"href": "https://servername/fscmRestApi/resources/version/supplierInitiatives/300100194001265/child/suppliers",
			"name": "suppliers",
			"kind": "collection"
		}
		]
	}
	],
	"count": 1,
	"hasMore": false,
	"limit": 25,
	"offset": 0,
	"links": [
	{
		"rel": "self",
		"href": "https://servername/fscmRestApi/resources/version/supplierInitiatives",
		"name": "supplierInitiatives",
		"kind": "collection"
	}
	]
}
Back to Top