Oracle Fusion Cloud ProcurementのREST API

1つの値を更新

patch

/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

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

ヘッダー・パラメータ

Metadata-Context:

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

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

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

application/json

ルート・スキーマ : スキーマ

タイプ: object

ソースを表示

AttachmentsFromSuppliers: string

タイトル: Attachments from Suppliers

最大長: 80

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

タイトル: Attachments from Suppliers Code

最大長: 30

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

値の範囲の終了日。日付属性に適用されます。
NumberFromRange: number

タイトル: Number from Range

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

タイトル: Number to Range

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

タイトル: Score

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

最大長: 1

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

タイトル: Text Response Value

最大長: 1000

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

{
    "type":"object",
    "properties":{
        "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
        },
        "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
        },
        "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
        },
        "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"
            }
        },
        "NumberFromRange":{
            "title":"Number from Range",
            "type":"number",
            "description":"Lowest number in a range of values. Applies for number attributes.",
            "nullable":true,
            "x-queryable":false
        },
        "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
        },
        "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
        },
        "NumberToRange":{
            "title":"Number to Range",
            "type":"number",
            "description":"Highest number in a range of values. Applies for number attributes.",
            "nullable":true,
            "x-queryable":false
        }
    }
}

トップに戻る

レスポンス

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

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."
        }
    }
}

トップに戻る

例

この例では、受理可能なレスポンス値を更新する方法を説明します。

cURLコマンドの例

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

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

たとえば:

curl -u username:password "https://servername/fscmRestApi/resources/version/supplierNegotiations/300100543794976/child/sections/300100543793265/child/requirements/300100543793301/child/acceptableResponseScoreValues/300100543793303"

リクエスト本文の例

次に、JSON形式のリクエスト本文の例を示します

{
    "TextValue": "1 to 5 years",
   "AttachmentsFromSuppliers": "Required"
}

レスポンス本文の例

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

{
    "RequirementId": 300100543793301,
    "ScoreId": 300100543793303,
    "TargetFlag": false,
    "NoResponseFlag": false,
    "ScoreDisplayNumber": "a.",
    "TextValue": "1 to 5 years",
    "NumberFromRange": null,
    "NumberToRange": null,
    "DateFromRange": null,
    "DateToRange": null,
    "DateTimeFromRange": null,
    "DateTimeToRange": null,
    "AttachmentsFromSuppliersCode": "REQUIRED",
    "AttachmentsFromSuppliers": "Required",
    "Score": null,
    "CreatedBy": "CVBUYER01",
    "CreationDate": "2021-06-09T00:53:54+00:00",
    "LastUpdateDate": "2021-06-09T00:57:11+00:00",
    "LastUpdatedBy": "CVBUYER01",
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version/supplierNegotiations/300100543794976/child/sections/300100543793265/child/requirements/300100543793301/child/acceptableResponseScoreValues/300100543793303",
            "name": "acceptableResponseScoreValues",
            "kind": "item",
            ...
        },
        {
            "rel": "canonical",
            "href": "https://servername/fscmRestApi/resources/version/supplierNegotiations/300100543794976/child/sections/300100543793265/child/requirements/300100543793301/child/acceptableResponseScoreValues/300100543793303",
            "name": "acceptableResponseScoreValues",
            "kind": "item"
        },
        {
            "rel": "parent",
            "href": "https://servername/fscmRestApi/resources/version/supplierNegotiations/300100543794976/child/sections/300100543793265/child/requirements/300100543793301",
            "name": "requirements",
            "kind": "item"
        }
    ]
}

「トップに戻る」