1つの属性の取得
get
/fscmRestApi/resources/11.13.18.05/supplierNegotiationResponses/{supplierNegotiationResponsesUniqID}/child/lines/{LineId}/child/lineAttributeGroups/{GroupId}/child/lineAttributes/{AttributeId}
リクエスト
パス・パラメータ
- AttributeId(required): integer
このパラメータの値は、リソース品目を一意に識別するために使用されるキーのハッシュである可能性があります。 クライアントはハッシュ・キー値を生成しないでください。 かわりに、クライアントはフィルタを使用してコレクション・リソースを問い合せ、特定のリソース品目にナビゲートする必要があります。 たとえば: products?q=InventoryItemId=
- GroupId(required): integer(int64)
このパラメータの値は、リソース品目を一意に識別するために使用されるキーのハッシュである可能性があります。 クライアントはハッシュ・キー値を生成しないでください。 かわりに、クライアントはフィルタを使用してコレクション・リソースを問い合せ、特定のリソース品目にナビゲートする必要があります。 たとえば: products?q=InventoryItemId=
- LineId(required): number
このパラメータの値は、リソース品目を一意に識別するために使用されるキーのハッシュである可能性があります。 クライアントはハッシュ・キー値を生成しないでください。 かわりに、クライアントはフィルタを使用してコレクション・リソースを問い合せ、特定のリソース品目にナビゲートする必要があります。 たとえば: products?q=InventoryItemId=
- supplierNegotiationResponsesUniqID(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のデフォルト・バージョンを選択します。
ルート・スキーマ : supplierNegotiationResponses-lines-lineAttributeGroups-lineAttributes-item-response
タイプ:
ソースを表示
object
-
AttributeId: integer
タイトル:
Attribute ID
属性を識別する値。 -
AttributeName: string
タイトル:
Attribute
読取り専用:true
最大長:4000
属性の説明。 -
CreatedBy: string
読取り専用:
true
最大長:64
行を作成したユーザーを識別します。 -
CreationDate: string (date-time)
読取り専用:
true
行の作成のタイムスタンプ。 -
GroupId: integer (int64)
タイトル:
Group ID
読取り専用:true
明細属性グループを一意に識別する値。 -
GroupName: string
タイトル:
Group Name
読取り専用:true
最大長:240
属性グループの名前。 -
LastUpdateDate: string (date-time)
読取り専用:
true
行の最終更新のタイムスタンプ。 -
LastUpdatedBy: string
読取り専用:
true
最大長:64
行を最後に更新したユーザーを識別します。 -
Line: string
タイトル:
Line
読取り専用:true
最大長:25
ネゴシエーション明細を識別する番号。 -
LineDescription: string
タイトル:
Description
読取り専用:true
最大長:2500
明細品目の摘要。 -
LineId: integer
タイトル:
Line ID
ネゴシエーション明細を識別する値です。 -
links: array Links
タイトル:
Links
リソース・インスタンスに関連付けられたリンク関係。 -
ResponseDateValue: string (date)
タイトル:
Response Date Value
明細属性のレスポンス値。 この値は日付です。 -
ResponseNumber: integer (int64)
タイトル:
Response Number
サプライヤの内部トラッキングに使用される識別番号。 -
ResponseNumberValue: number
タイトル:
Response Number Value
明細属性のレスポンス値。 この値は数値データ型です。 -
ResponseTextValue: string
タイトル:
Response Text Value
最大長:4000
明細属性のレスポンス値。 この値はテキスト・データ型です。 -
ResponseType: string
タイトル:
Response Type
読取り専用:true
最大長:80
明細属性のレスポンスが必須かどうかを指定します。 値には、必須、オプションまたは不要が含まれます。 使用可能な値のリストは、参照タイプPON_ATTRIBUTE_RESPONSE_TYPEで定義されます。 -
ResponseTypeCode: string
タイトル:
Response Type Code
読取り専用:true
最大長:30
明細属性のレスポンスが必須かどうかを識別する略称です。 有効な値は、REQUIRED、OPTIONALおよびDISPLAY_ONLYです。 使用可能な値のリストは、参照タイプPON_ATTRIBUTE_RESPONSE_TYPEで定義されます。 -
Score: number
タイトル:
Score
明細グループ、属性グループまたは明細属性に対するサプライヤのレスポンスに割り当てられたスコアを識別する値。 -
Supplier: string
タイトル:
Supplier
読取り専用:true
最大長:255
ネゴシエーションに応答するサプライヤの名前。 -
SupplierId: integer (int64)
タイトル:
Supplier ID
読取り専用:true
サプライヤを一意に識別する値。 -
TargetDateValue: string (date)
タイトル:
Target Date Value
読取り専用:true
属性のターゲット値。 この値は日付に適用できます。 -
TargetNumberValue: number
タイトル:
Target Number Value
読取り専用:true
属性のターゲット値。 この値は数値に適用できます。 -
TargetTextValue: string
タイトル:
Target Text Value
読取り専用:true
最大長:4000
属性のターゲット・テキストまたはURL値。 -
ValueType: string
タイトル:
Value Type
読取り専用:true
最大長:80
属性レスポンスのデータ型の表示名。 たとえば、テキスト、数値、日付、URL (Uniform Resource Locator)などです。 使用可能な値のリストは、参照タイプ属性値タイプで定義されます。 -
ValueTypeCode: string
タイトル:
Value Type Code
読取り専用:true
最大長:3
属性レスポンスの値のタイプを識別する略称です。 有効な値は、TXT、NUM、DATおよびURLです。 使用可能な値のリストは、参照タイプPON_AUCTION_ATTRIBUTE_TYPEで定義されます。 -
Weight: number
タイトル:
Weight
読取り専用:true
バイヤーが特定の属性グループに指定したプリファレンスを識別する値。 -
WeightedScore: number
タイトル:
Weighted Score
加重に対するスコアを計算して属性のレスポンスの値。 加重スコアは、そのスコアを重みで乗算して100で除算して計算されます。
ネストされたスキーマ : リンク
タイプ:
ソースを表示
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.
例
この例では、レスポンスIDと明細ID、グループID、明細属性IDを使用して、ネゴシエーション・レスポンス明細の1つの明細属性を取得する方法を説明します。
cURLコマンドの例
次のcURLコマンドを使用して、RESTリソースに対するリクエストを送信します:
curl -u username:password "https://servername/fscmRestApi/resources/version/supplierNegotiationResponses/supplierNegotiationResponsesUniqID/child/lines/LineId/child/lineAttributeGroups/GroupId/child/lineAttributes/AttributeId"
たとえば:
curl -u username:password "https://servername/fscmRestApi/resources/version/supplierNegotiationResponses/175333/child/lines/1/child/lineAttributeGroups/300100581415178/child/lineAttributes/10"
レスポンス本文の例
次の例には、レスポンス本文の内容がJSON形式で含まれます:
{ "ResponseNumber": 175333, "LineId": 1, "Line": "1", "LineDescription": "Laptop X800", "GroupId": 300100581415178, "GroupName": "Additional Details", "AttributeId": 10, "AttributeName": "Laptop Color<br/>", "SupplierId": 300100036697924, "Supplier": "PONSupplier06", "ResponseTypeCode": "REQUIRED", "ResponseType": "Required", "ValueTypeCode": "TXT", "ValueType": "Text", "TargetDateValue": null, "TargetNumberValue": null, "TargetTextValue": null, "ResponseDateValue": null, "ResponseNumberValue": null, "ResponseTextValue": "Silver", "Weight": 50, "Score": 1, "WeightedScore": 0.5, "CreatedBy": "PONSupplier06", "CreationDate": "2023-04-17T13:21:33+00:00", "LastUpdatedBy": "PONSupplier06", "LastUpdateDate": "2023-04-17T13:54:55.513+00:00", "links": [ { "rel": "self", "href": "https://servername/fscmRestApi/resources/version/supplierNegotiationResponses/175333/child/lines/1/child/lineAttributeGroups/300100581415178/child/lineAttributes/10", "name": "lineAttributes", "kind": "item", "properties": { "changeIndicator": ". . ." } }, { "rel": "canonical", "href": "https://servername/fscmRestApi/resources/version/supplierNegotiationResponses/175333/child/lines/1/child/lineAttributeGroups/300100581415178/child/lineAttributes/10", "name": "lineAttributes", "kind": "item" }, { "rel": "parent", "href": "https://servername/fscmRestApi/resources/version/supplierNegotiationResponses/175333/child/lines/1/child/lineAttributeGroups/300100581415178", "name": "lineAttributeGroups", "kind": "item" } ] }