Oracle Fusion Cloud ProcurementのREST API

1つの値を取得

get

/fscmRestApi/resources/11.13.18.05/supplierNegotiations/{supplierNegotiationsUniqID}/child/sections/{SectionId}/child/requirements/{RequirementId}/child/acceptableResponseScoreValues/{ScoreId}

リクエスト

パス・パラメータ

RequirementId(required): integer(int64)

要件を一意に識別する値。
ScoreId(required): integer(int64)

このパラメータの値は、リソース品目を一意に識別するために使用されるキーのハッシュである可能性があります。クライアントはハッシュ・キー値を生成しないでください。かわりに、クライアントはフィルタを使用してコレクション・リソースを問い合せ、特定のリソース品目にナビゲートする必要があります。たとえば: products?q=InventoryItemId=
SectionId(required): integer(int64)

セクションを一意に識別する値。
supplierNegotiationsUniqID(required): string

これは、サプライヤ・ネゴシエーション・リソースの複合キーを構成し、サプライヤ・ネゴシエーションのインスタンスを一意に識別するために使用される属性のハッシュ・キーです。クライアントはハッシュ・キー値を生成しないでください。かわりに、クライアントは、ハッシュ・キーを取得するためにサプライヤ・ネゴシエーションの特定のインスタンスにナビゲートするために、サプライヤ・ネゴシエーション収集リソースを問い合せる必要があります。

問合せパラメータ

dependency: string

このパラメータは、レスポンスの生成後に設定およびロールバックされるフィールドである依存関係を指定します。通常、これらは属性変更の影響をプレビューするために使用されます。このパラメータで指定されたフィールドは、常に問題のリソース・インスタンスで設定されます。子リソース・コレクションがリクエストされ、パラメータが設定されると、リソース・コレクション・ペイロードを生成する前に、親リソース・インスタンスにフィールドが設定されます。この問合せパラメータの値は、依存性フィールドのセットです。例: dependency=ProductId=2

フォーマット: <attr1>=<val1>,<attr2>=<value2>
expand: string

このパラメータを指定すると、指定した子がリソース・ペイロードに含まれます(リンクのみでなく)。この問合せパラメータの値は"all"または""です。カンマをセパレータとして使用して、複数の子を指定できます。例: ?expand=Employees,Localizations. ネストされた子は、"Child.NestedChild"の書式に従って指定することもできます(例): ?expand=Employees.Managers). ネストされた子が指定されている場合(例): Employees.Managers)。欠落している子は暗黙的に処理されます。たとえば、"?expand=Employees.Managers"は"?expand=Employees、Employees.Managers"と同じです(これにより、従業員とマネージャが展開されます)。
fields: string

このパラメータは、リソース・フィールドをフィルタします。指定されたフィールドのみが返されます。つまり、フィールドが指定されていない場合、フィールドは返されません(リンクのみを取得する場合に便利です)。間接子リソースが指定されている場合(例): Employees.Managers)。欠落している子は暗黙的に処理されます。たとえば、"?fields=Employees.Managers:Empname"は"?fields=;Employees:;Employees.Managers:Empname" (これはマネージャの"Empname"フィールドのみを返す)と同じです。この問合せパラメータの値は、リソース・フィールドのリストです。属性は直接にすることができます(例): 従業員または間接(例): Employees.Managers) child. 拡張問合せパラメータと組み合せることはできません。両方を指定した場合、フィールドのみが考慮されます。

フォーマット : ?fields=Attribute1,Attribute2

子リソースのフィールドの書式 : ?fields=Accessor1:Attribute1,Attribute2
links: string

このパラメータは、単一のリソースまたはリソース・コレクションへのアクセス中に特定のリンクのみを表示するために使用できます。パラメータ値書式は、次のカンマ区切りリストです : <link_relation>

例:
self,canonical
onlyData: boolean

データのみを含めるために(リンク・セクションなしなど)、リソース品目ペイロードがフィルタ処理されます。

ヘッダー・パラメータ

Metadata-Context:

REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。たとえば: Metadata-Context:sandbox="TrackEmployeeFeature".
REST-Framework-Version:

RESTクライアントとサービスの間のプロトコル・バージョン。クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。

この操作にはリクエスト本文がありません。

トップに戻る

レスポンス

サポートされているメディア・タイプ

application/json

デフォルトのレスポンス

次の表では、このタスクに対するデフォルトのレスポンスについて説明します。

ヘッダー

Metadata-Context(required):

REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。たとえば: Metadata-Context:sandbox="TrackEmployeeFeature".
REST-Framework-Version(required):

RESTクライアントとサービスの間のプロトコル・バージョン。クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。

ルート・スキーマ : supplierNegotiations-sections-requirements-acceptableResponseScoreValues-item-response

タイプ: object

ソースを表示

AttachmentsFromSuppliers: string

タイトル: Attachments from Suppliers

最大長: 80

各サプライヤ添付の要件。値には、不許可、オプションまたは必須があります。使用可能な値のリストは、参照タイプPON_REQ_ALLOW_ATTACHMENTで定義されます。
AttachmentsFromSuppliersCode: string

タイトル: Attachments from Suppliers Code

最大長: 30

各サプライヤ添付の要件を一意に識別する略称です。値には、不許可、オプションまたは必須があります。使用可能な値のリストは、参照タイプPON_REQ_ALLOW_ATTACHMENTで定義されます。
CreatedBy: string

読取り専用: true

最大長: 64

受理可能なレスポンス・スコア値を作成したユーザー。
CreationDate: string (date-time)

読取り専用: true

ユーザーが受理可能なレスポンス・スコア値を作成した日時。
DateFromRange: string (date)

タイトル: Date from Range

値の範囲内の開始日。日付属性に適用されます。
DateTimeFromRange: string (date-time)

タイトル: Date Time from Range

値の範囲内の開始日時。日付と時間の属性に適用されます。
DateTimeToRange: string (date-time)

タイトル: Date Time to Range

値の範囲の終了日時。日付と時間の属性に適用されます。
DateToRange: string (date)

タイトル: Date to Range

値の範囲の終了日。日付属性に適用されます。
LastUpdateDate: string (date-time)

読取り専用: true

ユーザーが受理可能なレスポンス・スコア値を最後に更新した日時。
LastUpdatedBy: string

読取り専用: true

最大長: 64

受理可能なレスポンス・スコア値を最後に更新したユーザー。
links: array Links

タイトル: Links

リソース・インスタンスに関連付けられたリンク関係。
NoResponseFlag: boolean

読取り専用: true

最大長: 1

次のいずれかの値が含まれます: trueまたはfalse。 trueの場合、オプション要件に応答しない各サプライヤにスコアを割り当てることを許可します。 falseの場合、許可しません。デフォルト値はfalseです。
NumberFromRange: number

タイトル: Number from Range

値の範囲内の最小数。数値属性に適用されます。
NumberToRange: number

タイトル: Number to Range

値の範囲内の最大値。数値属性に適用されます。
RequirementId: integer (int64)

読取り専用: true

要件を一意に識別する値。
Score: number

タイトル: Score

アプリケーションが各属性レスポンスに割り当てるスコア。
ScoreDisplayNumber: string

読取り専用: true

最大長: 80

スコア表示を一意に識別する値。この値は、単一選択での複数選択または複数選択による複数選択を使用する要件ごとに設定されます。また、数値、日付または日時要件に応答するレスポンスごとにこの値を設定します。
ScoreId: integer (int64)

読取り専用: true

スコアを一意に識別する値。
Section: string

タイトル: Section

読取り専用: true

要件セクションの名前。
SectionId: integer (int64)

読取り専用: true

セクションを一意に識別する値。
TargetFlag: boolean

最大長: 1

次のいずれかの値が含まれます: trueまたはfalse。 trueの場合、アプリケーションが要件のターゲット・レスポンス値として受け入れられる値を設定します。 falseの場合、設定しません。デフォルト値はfalseです。
TextValue: string

タイトル: Text Response Value

最大長: 1000

ユーザーが入力した値。この値はテキスト値に適用できます。

{
    "type":"object",
    "properties":{
        "LastUpdatedBy":{
            "maxLength":64,
            "type":"string",
            "description":"User who most recently updated the acceptable response score value.",
            "nullable":false,
            "readOnly":true,
            "x-queryable":false
        },
        "CreationDate":{
            "type":"string",
            "description":"Date and time when the user created the acceptable response score value.",
            "format":"date-time",
            "nullable":false,
            "readOnly":true,
            "x-queryable":false
        },
        "ScoreDisplayNumber":{
            "maxLength":80,
            "type":"string",
            "description":"Value that uniquely identifies the score display. The application sets this value for each requirement that uses Multiple Choice With Single Selection or Multiple Choice With Multiple Selections. It also sets this value for each response that replies to a number, date, or date time requirement.",
            "nullable":true,
            "readOnly":true,
            "x-queryable":false
        },
        "CreatedBy":{
            "maxLength":64,
            "type":"string",
            "description":"User who created the acceptable response score value.",
            "nullable":false,
            "readOnly":true,
            "x-queryable":false
        },
        "DateToRange":{
            "title":"Date to Range",
            "type":"string",
            "description":"End Date in the range of values. Applies for date attributes.",
            "format":"date",
            "nullable":true,
            "x-queryable":false
        },
        "AttachmentsFromSuppliers":{
            "title":"Attachments from Suppliers",
            "maxLength":80,
            "type":"string",
            "description":"Requirement for each supplier attachment. Values include Not Allowed, Optional, or Required. A list of accepted values is defined in the lookup type PON_REQ_ALLOW_ATTACHMENT.",
            "nullable":true,
            "x-queryable":false,
            "x-hints":{
                "controlType":"choice"
            }
        },
        "ScoreId":{
            "type":"integer",
            "description":"Value that uniquely identifies the score.",
            "format":"int64",
            "nullable":false,
            "readOnly":true,
            "x-hints":{
                "precision":18,
                "fnd:GLOBALLY_UNIQUE":"true"
            },
            "x-queryable":true
        },
        "Section":{
            "title":"Section",
            "type":"string",
            "description":"Name of the requirement section.",
            "nullable":true,
            "readOnly":true,
            "x-queryable":false
        },
        "TargetFlag":{
            "maxLength":1,
            "type":"boolean",
            "description":"Contains one of the following values: true or false. If true, then set the value that the application is willing to accept as the target response value for the requirement. If false, then do not set. The default value is false.",
            "nullable":true,
            "x-queryable":false
        },
        "Score":{
            "title":"Score",
            "type":"number",
            "description":"Score that the application assigns to each attribute response.",
            "nullable":true,
            "x-queryable":false
        },
        "TextValue":{
            "title":"Text Response Value",
            "maxLength":1000,
            "type":"string",
            "description":"Value that the user entered. This value is applicable for text values.",
            "nullable":true,
            "x-queryable":false
        },
        "DateTimeToRange":{
            "title":"Date Time to Range",
            "type":"string",
            "description":"End date and time in the range of values. Applies for date and time attributes.",
            "format":"date-time",
            "nullable":true,
            "x-queryable":false
        },
        "NumberFromRange":{
            "title":"Number from Range",
            "type":"number",
            "description":"Lowest number in a range of values. Applies for number attributes.",
            "nullable":true,
            "x-queryable":false
        },
        "links":{
            "title":"Links",
            "type":"array",
            "description":"The link relations associated with the resource instance.",
            "items":{
                "$ref":"#/components/schemas/link"
            }
        },
        "RequirementId":{
            "type":"integer",
            "description":"Value that uniquely identifies the requirement.",
            "format":"int64",
            "nullable":false,
            "readOnly":true,
            "x-queryable":false,
            "x-hints":{
                "precision":18
            }
        },
        "DateFromRange":{
            "title":"Date from Range",
            "type":"string",
            "description":"Start date in the range of values. Applies for date attributes.",
            "format":"date",
            "nullable":true,
            "x-queryable":false
        },
        "SectionId":{
            "type":"integer",
            "description":"Value that uniquely identifies the section.",
            "format":"int64",
            "nullable":false,
            "readOnly":true,
            "x-hints":{
                "precision":18
            },
            "x-queryable":true
        },
        "AttachmentsFromSuppliersCode":{
            "title":"Attachments from Suppliers Code",
            "maxLength":30,
            "type":"string",
            "description":"Abbreviation that uniquely identifies the requirement for each supplier attachment. Values include Not Allowed, Optional, or Required. A list of accepted values is defined in the lookup type PON_REQ_ALLOW_ATTACHMENT.",
            "nullable":true,
            "x-queryable":false
        },
        "DateTimeFromRange":{
            "title":"Date Time from Range",
            "type":"string",
            "description":"Start date and time in the range of values. Applies for date and time attributes.",
            "format":"date-time",
            "nullable":true,
            "x-queryable":false
        },
        "NoResponseFlag":{
            "maxLength":1,
            "type":"boolean",
            "description":"Contains one of the following values: true or false. If true, then allow the application to assign a score to each supplier who does not respond to an optional requirement. If false, then do not allow. The default value is false.",
            "nullable":true,
            "readOnly":true,
            "x-queryable":false
        },
        "LastUpdateDate":{
            "type":"string",
            "description":"Date and time when the user most recently updated the acceptable response score value.",
            "format":"date-time",
            "nullable":false,
            "readOnly":true,
            "x-queryable":false
        },
        "NumberToRange":{
            "title":"Number to Range",
            "type":"number",
            "description":"Highest number in a range of values. Applies for number attributes.",
            "nullable":true,
            "x-queryable":false
        }
    }
}

ネストされたスキーマ : リンク

タイプ: array

タイトル: Links

リソース・インスタンスに関連付けられたリンク関係。

ソースを表示

Array of: object link

{
    "title":"Links",
    "type":"array",
    "description":"The link relations associated with the resource instance.",
    "items":{
        "$ref":"#/components/schemas/link"
    }
}

ネストされたスキーマ : リンク

タイプ: object

ソースを表示

href: string

タイトル: hyperlink reference

関連リソースへのURI。
kind: string

タイトル: kind

許可された値: [ "collection", "item", "describe", "other" ]

関連リソースの種類。
name: string

タイトル: name

関連リソースへのリンクの名前。
properties: object properties
rel: string

タイトル: relation

許可された値: [ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]

リソース・インスタンスとの関係の名前。例: self.

{
    "type":"object",
    "properties":{
        "kind":{
            "title":"kind",
            "type":"string",
            "description":"The kind of the related resource.",
            "enum":[
                "collection",
                "item",
                "describe",
                "other"
            ]
        },
        "rel":{
            "title":"relation",
            "type":"string",
            "description":"The name of the relation to the resource instance.  Example: self.",
            "enum":[
                "self",
                "lov",
                "parent",
                "canonical",
                "child",
                "enclosure",
                "action",
                "custom"
            ]
        },
        "name":{
            "title":"name",
            "type":"string",
            "description":"The name of the link to the related resource."
        },
        "href":{
            "title":"hyperlink reference",
            "type":"string",
            "description":"The URI to the related resource."
        },
        "properties":{
            "type":"object",
            "properties":{
                "changeIndicator":{
                    "type":"string",
                    "description":"Change indicator or the ETag value of the resource instance."
                }
            }
        }
    }
}

ネストされたスキーマ : プロパティ

タイプ: object

ソースを表示

changeIndicator: string

リソース・インスタンスのインジケータまたはETag値を変更します。

{
    "type":"object",
    "properties":{
        "changeIndicator":{
            "type":"string",
            "description":"Change indicator or the ETag value of the resource instance."
        }
    }
}

トップに戻る

例

この例では、1つの値を取得する方法を説明します。

cURLコマンドの例

次のcURLコマンドを使用して、RESTリソースに対するリクエストを送信します:

curl -u username:password "https://servername/fscmRestApi/resources/version/supplierNegotiations/{AuctionHeaderId}/child/sections/{SectionId}/child/requirements/{RequirementId}/child/acceptableResponseScoreValues/ScoreId"

たとえば、次のコマンドは、スコア識別子が9106である1つの値を取得します:

curl -u username:password "https://servername/fscmRestApi/resources/version/supplierNegotiations/300100152357495/child/sections/11275/child/requirements/24705/child/acceptableResponseScoreValues/9106"

レスポンス本文の例

JSON形式のレスポンス本文の例を次に示します。

{
    "RequirementId": 24705,
    "ScoreId": 9106,
    "ScoreDisplayNumber": "a.",
    "TextValue": "4 GB",
    "NumberFromRange": null,
    "NumberToRange": null,
    "DateFromRange": null,
    "DateToRange": null,
    "DateTimeFromRange": null,
    "DateTimeToRange": null,
    "AttachmentsFromSuppliers": "Not allowed",
    "AttachmentsFromSuppliersCode": "NOT_ALLOWED",
    "Score": null,
    "TargetFlag": false,
    "NoResponseFlag": false,
    "CreatedBy": "CVBUYER01",
    "CreationDate": "2018-06-28T10:46:24+00:00",
    "LastUpdateDate": "2018-06-28T11:27:25.687+00:00",
    "LastUpdatedBy": "CVBUYER01",
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version/supplierNegotiations/300100152357495/child/sections/11275/child/requirements/24705/child/acceptableResponseScoreValues/9106",
            "name": "acceptableResponseScoreValues",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A657870000000017704000000017372001B6F7261636C652E6A626F2E646F6D61696E2E4E756C6C56616C75655899C1C58DAABEEB02000149000A6D53514C54797065496478700000000C78"
            }
        },
        {
            "rel": "canonical",
            "href": "https://servername/fscmRestApi/resources/version/supplierNegotiations/300100152357495/child/sections/11275/child/requirements/24705/child/acceptableResponseScoreValues/9106",
            "name": "acceptableResponseScoreValues",
            "kind": "item"
        },
        {
            "rel": "parent",
            "href": "https://servername/fscmRestApi/resources/version/supplierNegotiations/300100152357495/child/sections/11275/child/requirements/24705",
            "name": "requirements",
            "kind": "item"
        }
    ]
}

「トップに戻る」