式詳細の作成
post
/fscmRestApi/resources/11.13.18.05/incentiveCompensationExpressions/{incentiveCompensationExpressionsUniqID}/child/ExpressionDetails
リクエスト
パス・パラメータ
- incentiveCompensationExpressionsUniqID(required): string
これは、インセンティブ報酬式リソースのコンポジット・キー(OrgIdおよびExpressionId)を構成する属性のハッシュ・キーで、インセンティブ報酬式のインスタンスを一意に識別するために使用されます。 クライアントはハッシュ・キー値を生成しないでください。 かわりに、クライアントは、インセンティブ報酬式の特定のインスタンスにナビゲートするために、主キー値に対するフィルタを使用してインセンティブ報酬式コレクション・リソースを問い合せる必要があります。
次に例を示します: incentiveCompensationExpressions?q=OrgId=<value1>;ExpressionId=<value2>
ヘッダー・パラメータ
- Metadata-Context:
REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。 次に例を示します : Metadata-Context:sandbox="TrackEmployeeFeature".
- REST-Framework-Version:
RESTクライアントとサービスの間のプロトコル・バージョン。 クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。
- Upsert-Mode:
次のいずれかの値が含まれます: trueまたはfalse。 trueの場合、サーバーは作成操作ではなくアップサート操作を実行します。 アップサート操作中、サーバーはペイロードに一致する既存のリソースを検索しようとします。 一致が見つかった場合、サーバーは、新しいリソースを作成するのではなく、既存のリソースを更新します。 見つからないかfalse (デフォルト)の場合、サーバーは作成操作を実行します。 アップサート操作は、有効日RESTリソースではサポートされていないことに注意してください。
サポートされるメディア・タイプ
- application/json
次の表では、このタスクのリクエストの本文パラメータについて説明します。
ルート・スキーマ : スキーマ
タイプ:
ソースを表示
object
-
BasicAttributeName: string
式詳細で使用されるプライマリ・オブジェクト属性の名前。 これは、「基本属性グループ」フィールドとともに使用されます。 BasicAttributeNameVOを使用して、使用可能な値のリストを取得します。
-
BasicAttributesGroup: string
使用される参加者、クレジット、プラン・コンポーネント、メジャーまたはプランなどのプライマリ・オブジェクトを表すカテゴリです。 このフィールドを使用する前に、ExpressionDetailType属性をプライマリ・オブジェクト属性にする必要があります。 受理可能な値のリストは、参照CN_EXPR_ATTR_MENUで定義されます。 設定およびメンテナンスのインセンティブ報酬参照の管理タスクを使用して、この属性の値をレビューおよび更新します。
-
ConstantValue: string
式で使用される定数の値。 定数には数値または文字列を指定できます。 このフィールドを使用する前に、式の詳細タイプ属性を定数にする必要があります。
-
ExpressionDetailId: integer (int64)
式詳細レコードの一意の識別子。
-
ExpressionDetailType: string
ユーザー定義問合せ、プライマリ・オブジェクト属性、レート表レート、SQL式関数、定数、メジャー結果、プラン・コンポーネント結果、ユーザー定義関数および算術演算子などのwebサービス式のタイプ。 受理可能な値のリストは、参照タイプORA_CN_EXPRESSION_DETAIL_TYPEの参照値の意味で定義されます。 設定およびメンテナンスのインセンティブ報酬参照の管理タスクを使用して、この属性の値をレビューおよび更新できます。
-
ExpressionId: integer (int64)
式レコードの一意の識別子。
-
ExpressionOperator: string
タイトル:
Operator
式で使用される算術演算子。 このフィールドを使用する前に、式の詳細タイプ属性を算術演算子にする必要があります。 ExpressionOperatorVOを使用して、使用可能な値のリストを取得します。 -
FunctionName: string
式で使用されるSQL関数。 FunctionsGroup属性の値に応じて、異なる参照を使用して、許容可能な値のリストを取得できます。 これは、FunctionsGroupフィールドとともに使用されます。 許容可能な値のリストは、参照CN_ADV_FUNCTIONS、CN_AGGR_FUNCTIONS、ORA_CN_VAL_ST_AGGRGN_FUNCTIONS、CN_COMP_FUNCTIONS、CN_NULL_FUNCTIONS、CN_NUMB_FUNCTIONS、ORA_CN_TEXT_FUNCTIONS、ORA_CN_DATE_FUNCTIONSおよびORA_CN_LOGICAL_OPERATIONSで定義されます。 設定およびメンテナンスのインセンティブ報酬参照の管理タスクを使用して、この属性の値をレビューおよび更新できます。
-
FunctionsGroup: string
拡張関数、集計関数、値セット集計関数、比較関数、Null関数、数値関数、テキスト関数、日付関数、論理演算など、式で使用されるSQL関数のタイプ。 このフィールドを使用する前に、式詳細タイプの属性値はSQL式関数である必要があります。 受理可能な値のリストは、参照CN_FUNCTION_TYPESで定義されます。 設定およびメンテナンスのインセンティブ報酬参照の管理タスクを使用して、この属性の値をレビューおよび更新できます。
-
ItemLabel: string
タイトル:
Label
最大長:500
ラベルは式の一部に与えられ、その特定の部分が何を行うかを記述します。 ラベルは、式の様々な部分と式全体を解読しやすくするコメントのように動作します。 -
MeasureName: string
タイトル:
Measure
式で結果が使用されるパフォーマンス・メジャーの名前。 このフィールドを使用する前に、式の詳細タイプ属性をメジャー結果にする必要があります。 MeasureNameVOを使用して、使用可能な値のリストを取得します。 -
MeasureResultAttribute: string
式で使用されるパフォーマンス・メジャーの結果の本質。 これは、MeasureNameフィールドとともに使用されます。 MeasureResultAttributeVOを使用して、使用可能な値のリストを取得します。
-
PlanComponentMeasureName: string
式でメジャー結果が使用されるプラン・コンポーネントの名前。 このフィールドを使用する前に、PlanComponentResultAttribute属性をPlanComponentsMeasureにする必要があります。 PlanComponentMeasureNameVOを使用して、使用可能な値のリストを取得します。
-
PlanComponentMeasureResultAttribute: string
式で使用されるプラン・コンポーネントのメジャー結果の性質。 これは、PlanComponentMeasureNameフィールドとともに使用されます。 PlanComponentMeasureResultAttributeVOを使用して、使用可能な値のリストを取得します。
-
PlanComponentName: string
タイトル:
Plan Component
式で結果が使用されるプラン・コンポーネントの名前。 このフィールドを使用する前に、式の詳細タイプ属性をプラン・コンポーネント結果にする必要があります。 PlanComponentNameVOを使用して、使用可能な値のリストを取得します。 -
PlanComponentResultAttribute: string
式で使用されるプラン・コンポーネントの結果の性質。 これは、PlanComponentNameフィールドとともに使用されます。 PlanComponentResultAttributeVOを使用して、使用可能な値のリストを取得します。
-
順序: 整数(int32)
タイトル:
Sequence
式内の式詳細レコードの順序。 これは、作成時にのみユーザーによって提供されます。 これは、式を左から右に読み取るように順次提供されるようにしてください。そうしないと、式の意味が異なります。 -
UserDefinedFunctionName: string
式で使用されるユーザー定義関数の名前。 式詳細タイプ属性は、このフィールドを使用する前にユーザー定義関数である必要があります。 受理可能な値のリストは、参照CN_USER_FUNCTIONSで定義されます。 設定およびメンテナンスのインセンティブ報酬参照の管理タスクを使用して、この属性の値をレビューおよび更新します。
-
UserDefinedQueryName: string
式で使用されるユーザー定義問合せの値セット・コードまたは参照コード。 このフィールドを使用する前に、式詳細タイプ属性値をユーザー定義問合せにする必要があります。 許容可能な値のリストは、参照ORA_CN_USR_DEFN_EXPRSN_VLE_SETで定義されます。 設定およびメンテナンスのインセンティブ報酬参照の管理タスクを使用して、この属性の値をレビューおよび更新できます。
応答
サポートされるメディア・タイプ
- application/json
デフォルトのレスポンス
次の表では、このタスクに対するデフォルトのレスポンスについて説明します。
ヘッダー
- Metadata-Context(required):
REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。 次に例を示します : Metadata-Context:sandbox="TrackEmployeeFeature".
- REST-Framework-Version(required):
RESTクライアントとサービスの間のプロトコル・バージョン。 クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。
ルート・スキーマ : incentiveCompensationExpressions-ExpressionDetails-item-response
タイプ:
ソースを表示
object
-
BasicAttributeName: string
式詳細で使用されるプライマリ・オブジェクト属性の名前。 これは、「基本属性グループ」フィールドとともに使用されます。 BasicAttributeNameVOを使用して、使用可能な値のリストを取得します。
-
BasicAttributesGroup: string
使用される参加者、クレジット、プラン・コンポーネント、メジャーまたはプランなどのプライマリ・オブジェクトを表すカテゴリです。 このフィールドを使用する前に、ExpressionDetailType属性をプライマリ・オブジェクト属性にする必要があります。 受理可能な値のリストは、参照CN_EXPR_ATTR_MENUで定義されます。 設定およびメンテナンスのインセンティブ報酬参照の管理タスクを使用して、この属性の値をレビューおよび更新します。
-
ConstantValue: string
式で使用される定数の値。 定数には数値または文字列を指定できます。 このフィールドを使用する前に、式の詳細タイプ属性を定数にする必要があります。
-
CreatedBy: string
タイトル:
Created By
読取り専用:true
最大長:255
レコードを作成したユーザー。 -
CreationDate: string (date-time)
タイトル:
Creation Date
読取り専用:true
レコードが作成された日時。 -
DisplayValue: string
タイトル:
Display Value
読取り専用:true
最大長:160
式詳細レコードの表示値。 -
ExpressionDetailId: integer (int64)
式詳細レコードの一意の識別子。
-
ExpressionDetailType: string
ユーザー定義問合せ、プライマリ・オブジェクト属性、レート表レート、SQL式関数、定数、メジャー結果、プラン・コンポーネント結果、ユーザー定義関数および算術演算子などのwebサービス式のタイプ。 受理可能な値のリストは、参照タイプORA_CN_EXPRESSION_DETAIL_TYPEの参照値の意味で定義されます。 設定およびメンテナンスのインセンティブ報酬参照の管理タスクを使用して、この属性の値をレビューおよび更新できます。
-
ExpressionId: integer (int64)
式レコードの一意の識別子。
-
ExpressionOperator: string
タイトル:
Operator
式で使用される算術演算子。 このフィールドを使用する前に、式の詳細タイプ属性を算術演算子にする必要があります。 ExpressionOperatorVOを使用して、使用可能な値のリストを取得します。 -
FunctionName: string
式で使用されるSQL関数。 FunctionsGroup属性の値に応じて、異なる参照を使用して、許容可能な値のリストを取得できます。 これは、FunctionsGroupフィールドとともに使用されます。 許容可能な値のリストは、参照CN_ADV_FUNCTIONS、CN_AGGR_FUNCTIONS、ORA_CN_VAL_ST_AGGRGN_FUNCTIONS、CN_COMP_FUNCTIONS、CN_NULL_FUNCTIONS、CN_NUMB_FUNCTIONS、ORA_CN_TEXT_FUNCTIONS、ORA_CN_DATE_FUNCTIONSおよびORA_CN_LOGICAL_OPERATIONSで定義されます。 設定およびメンテナンスのインセンティブ報酬参照の管理タスクを使用して、この属性の値をレビューおよび更新できます。
-
FunctionsGroup: string
拡張関数、集計関数、値セット集計関数、比較関数、Null関数、数値関数、テキスト関数、日付関数、論理演算など、式で使用されるSQL関数のタイプ。 このフィールドを使用する前に、式詳細タイプの属性値はSQL式関数である必要があります。 受理可能な値のリストは、参照CN_FUNCTION_TYPESで定義されます。 設定およびメンテナンスのインセンティブ報酬参照の管理タスクを使用して、この属性の値をレビューおよび更新できます。
-
ItemLabel: string
タイトル:
Label
最大長:500
ラベルは式の一部に与えられ、その特定の部分が何を行うかを記述します。 ラベルは、式の様々な部分と式全体を解読しやすくするコメントのように動作します。 -
LastUpdateDate: string (date-time)
タイトル:
Last Updated Date
読取り専用:true
レコードが最後に更新された日時。 -
LastUpdatedBy: string
タイトル:
Last Updated By
読取り専用:true
最大長:255
レコードを最後に更新したユーザー。 -
LastUpdateLogin: string
タイトル:
Last Update Login
読取り専用:true
最大長:32
レコードを最後に更新したユーザーのセッション・ログイン。 -
links: array Links
タイトル:
Links
リソース・インスタンスに関連付けられたリンク関係。 -
MeasureName: string
タイトル:
Measure
式で結果が使用されるパフォーマンス・メジャーの名前。 このフィールドを使用する前に、式の詳細タイプ属性をメジャー結果にする必要があります。 MeasureNameVOを使用して、使用可能な値のリストを取得します。 -
MeasureResultAttribute: string
式で使用されるパフォーマンス・メジャーの結果の本質。 これは、MeasureNameフィールドとともに使用されます。 MeasureResultAttributeVOを使用して、使用可能な値のリストを取得します。
-
PlanComponentMeasureName: string
式でメジャー結果が使用されるプラン・コンポーネントの名前。 このフィールドを使用する前に、PlanComponentResultAttribute属性をPlanComponentsMeasureにする必要があります。 PlanComponentMeasureNameVOを使用して、使用可能な値のリストを取得します。
-
PlanComponentMeasureResultAttribute: string
式で使用されるプラン・コンポーネントのメジャー結果の性質。 これは、PlanComponentMeasureNameフィールドとともに使用されます。 PlanComponentMeasureResultAttributeVOを使用して、使用可能な値のリストを取得します。
-
PlanComponentName: string
タイトル:
Plan Component
式で結果が使用されるプラン・コンポーネントの名前。 このフィールドを使用する前に、式の詳細タイプ属性をプラン・コンポーネント結果にする必要があります。 PlanComponentNameVOを使用して、使用可能な値のリストを取得します。 -
PlanComponentResultAttribute: string
式で使用されるプラン・コンポーネントの結果の性質。 これは、PlanComponentNameフィールドとともに使用されます。 PlanComponentResultAttributeVOを使用して、使用可能な値のリストを取得します。
-
順序: 整数(int32)
タイトル:
Sequence
式内の式詳細レコードの順序。 これは、作成時にのみユーザーによって提供されます。 これは、式を左から右に読み取るように順次提供されるようにしてください。そうしないと、式の意味が異なります。 -
UserDefinedFunctionName: string
式で使用されるユーザー定義関数の名前。 式詳細タイプ属性は、このフィールドを使用する前にユーザー定義関数である必要があります。 受理可能な値のリストは、参照CN_USER_FUNCTIONSで定義されます。 設定およびメンテナンスのインセンティブ報酬参照の管理タスクを使用して、この属性の値をレビューおよび更新します。
-
UserDefinedQueryName: string
式で使用されるユーザー定義問合せの値セット・コードまたは参照コード。 このフィールドを使用する前に、式詳細タイプ属性値をユーザー定義問合せにする必要があります。 許容可能な値のリストは、参照ORA_CN_USR_DEFN_EXPRSN_VLE_SETで定義されます。 設定およびメンテナンスのインセンティブ報酬参照の管理タスクを使用して、この属性の値をレビューおよび更新できます。
ネストされたスキーマ : リンク
タイプ:
ソースを表示
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.
ネストされたスキーマ : properties
タイプ:
ソースを表示
object
-
changeIndicator: string
リソース・インスタンスのインジケータまたはETag値を変更します。
リンク
- ExpressionDetailTypeVO
-
各webサービス式コンポーネントのタイプを含む値リスト。 たとえば、プライマリ・オブジェクト属性、定数、レート表レート、シード済関数またはユーザー定義関数、プラン・コンポーネントまたはメジャー、名前、演算子などがあります。
LOVリンク関連では、次のプロパティが定義されます:
- ソース属性: ExpressionDetailType;ターゲット属性: ExpressionDetailType
- 表示属性: ExpressionDetailType, OrgId
例:
次の例は、cURLを使用してRESTリソースに対してPOSTリクエストを発行することによって、式の詳細を作成する方法を示しています。
cURLコマンド
curl -u <username:password> \ -X POST -d @example_request_payload.json https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/incentiveCompensationExpressions/00020000000EACED0005770800000000000000CC0000000EACED00057708000110F07F4E24E6/child/ExpressionDetails
リクエスト本文の例
次の例は、JSON形式のリクエスト本文のコンテンツを示しています。
{ "Sequence" : 1, "ExpressionDetailType": "Rate table rate", "BasicAttributesGroup": null, "BasicAttributeName" : null }
レスポンス本文の例
次の例は、JSON形式のレスポンス本文のコンテンツを示しています。
{ "items": [ { "ExpressionDetailId": 300100090733799, "ExpressionId": 300100090733798, "CreationDate": "2017-08-17T01:11:18.733-07:00", "LastUpdateLogin": "56EF70736CD64C5CE0532DD6F00A2F6B", "LastUpdateDate": "2017-08-17T01:12:16.362-07:00", "CreatedBy": "OIC_PLAN_ADMIN_OPERATIONS", "LastUpdatedBy": "OIC_PLAN_ADMIN_OPERATIONS", "ExpressionDetailType": "Rate table rate", "BasicAttributesGroup": null, "BasicAttributeName": null, "FunctionsGroup": null, "FunctionName": null, "ExpressionOperator": null, "ConstantValue": null, "MeasureName": null, "MeasureResultAttribute": null, "PlanComponentName": null, "PlanComponentResultAttribute": null, "PlanComponentMeasureName": null, "PlanComponentMeasureResultAttribute": null, "UserDefinedFunctionName": null, "Sequence": 1, "DisplayValue": "Rate Table Rate", "links": [ { .... } ] }