すべてのファイル・インポートおよびエクスポート・オブジェクト属性の取得
get
/crmRestApi/resources/11.13.18.05/importExportObjectMetadata/{ObjectCode}/child/ObjectAttributes
リクエスト
パス・パラメータ
- ObjectCode(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 - finder: string
コレクションを検索するための事前定義済ファインダとして使用されます。
フォーマット : ?finder=<finderName>;<variableName>=<variableValue>,<variableName2>=<variableValue2>
使用可能なファインダ名および対応するファインダ変数を次に示します:- ExportQueryableAttributeFinder : 指定されたキーを持つエクスポート問合せ属性を検索します。
ファインダ変数: - ObjectAttributeRowFinder : 指定されたオブジェクト属性名を持つインポート・エクスポート・オブジェクト属性を検索します。
ファインダ変数:- AttributeCode; string;オブジェクト属性の言語非依存コード。
- ExportQueryableAttributeFinder : 指定されたキーを持つエクスポート問合せ属性を検索します。
- limit: integer
このパラメータは、リソース・コレクション内で返されるリソースの数を制限します。 制限がリソース数を超えると、フレームワークは使用可能なリソースのみを返します。
- links: string
このパラメータは、単一のリソースまたはリソース・コレクションへのアクセス中に特定のリンクのみを表示するために使用できます。 パラメータ値書式は、次のカンマ区切りリストです : <link_relation>
例:
self,canonical
- offset: integer
リソース・コレクションの開始位置を定義するために使用します。 オフセットがリソース数を超えると、リソースは返されません。 デフォルト値は0です。
- onlyData: boolean
リソース・アイテム・ペイロードは、データのみを含めるようにフィルタされます(リンク・セクションなどは含まれません)。
- orderBy: string
このパラメータは、指定されたフィールドに基づいてリソース・コレクションを順序付けます。 パラメータ値は、属性名のカンマ区切りの文字列で、それぞれオプションでコロンと「asc」または「desc」が続きます。 昇順の場合は「asc」、降順の場合は「desc」を指定します。 デフォルト値は「asc」です。 たとえば、?orderBy=field1:asc,field2:descです
- q: string
この問合せパラメータは、where句を定義します。 リソース・コレクションは、指定された式を使用して問い合せられます。 この問合せパラメータの値は、1つ以上の式です。 例 : ?q=部門番号>=10および<= 30;Loc!=NY
フォーマット : ?q=expression1;expression2
次の問合せ可能属性を使用して、q問合せパラメータを使用してこの収集リソースをフィルタできます:
- AttributeCode; string;オブジェクト属性の名前。
- CreatedBy; string; レコードを作成したユーザー。
- CreationDate; string; レコードが作成された日時。
- CustomAttributeFlag; boolean。オブジェクト属性がカスタム属性であるかどうかを示します。
- 説明; string;オブジェクトの説明。
- DisplayName; string;オブジェクトの表示名。
- ImportExportMappable; string; 属性をインポートおよびエクスポートでマッピングできるかどうかを示します。
- KeyFlag; boolean。オブジェクト属性がオブジェクト主キーの一部であるかどうかを示します。
- KeyNumber; number;オブジェクトのコンポジット主キー属性内の属性の順序。
- LangIndependentCode; string; オブジェクト属性の言語非依存コードを示します。
- LastUpdateDate; string; レコードが最後に更新された日時。
- LastUpdateLogin; string; レコードを最後に更新したユーザーのログイン。
- LastUpdatedBy; string; レコードを最後に更新したユーザー。
- 長さ、数値、オブジェクト属性の長さ。
- ObjectName; string;オブジェクトの名前。
- ParentKeyFlag; boolean。オブジェクト属性がオブジェクトの親主キーの一部であるかどうかを示します。
- ParentKeyNumber; number;オブジェクトの親主キーの複合主キー属性内の属性の順序。
- ParentPuidFlag; boolean。オブジェクト属性が親のPUID属性であるかどうかを示します。
- 精度;数値;オブジェクト属性の精度。
- PuidFlag; boolean。オブジェクト属性がPUID属性であるかどうかを示します。
- QueryableFlag; boolean。属性がオブジェクトを検索できるかどうかを示します。
- RequiredFlag; boolean;オブジェクト属性が必須かどうかを示します。
- スケール、数値、オブジェクト属性のスケール。
- Type; string;オブジェクト属性のデータ型。
- UpdatableFlag; boolean;オブジェクト属性が更新可能であるかどうかを示します。
- totalResults: boolean
"?totalResults=true"の場合、リソース・コレクション表現には"推定行数"が含まれます。それ以外の場合、カウントは含まれません。 デフォルト値はfalseです。
ヘッダー・パラメータ
- 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のデフォルト・バージョンを選択します。
ルート・スキーマ : importExportObjectMetadata-ObjectAttributes
タイプ:
ソースを表示
object
-
count(required): integer
現在の範囲で返されたリソース・インスタンスの数。
-
hasMore(required): boolean
サーバーで使用可能なリソースが、レスポンスで返されたサブセットより多いかどうかを示します。 値がtrueの場合、サーバーから取得するリソースがさらにあります。 デフォルト値はfalseです。
-
items: array Items
タイトル:
Items
コレクション内のアイテム。 -
limit(required): integer
サーバーで使用される実際のページング・サイズ。
-
links(required): array Links
タイトル:
Links
リソース・インスタンスに関連付けられたリンク関係。 -
offset(required): integer
現在のページで使用されるオフセット値。
-
totalResults: integer
"?totalResults=true"の場合の推定行数。それ以外の場合、カウントは含まれません。
ネストされたスキーマ : importExportObjectMetadata-ObjectAttributes-item-response
タイプ:
ソースを表示
object
-
AttributeCode: string
タイトル:
Attribute Name
最大長:100
オブジェクト属性の名前。 -
CreatedBy: string
タイトル:
Created By
読取り専用:true
最大長:64
レコードを作成したユーザー。 -
CreationDate: string (date-time)
タイトル:
Creation Date
読取り専用:true
レコードが作成された日時。 -
CustomAttributeFlag: boolean
タイトル:
Custom Attribute
最大長:1
デフォルト値:false
オブジェクト属性がカスタム属性かどうかを示します。 -
Description: string
タイトル:
Description
オブジェクトの説明。 -
DisplayName: string
タイトル:
Display Name
オブジェクトの表示名。 -
ImportExportMappable: string
属性をインポートおよびエクスポートでマッピングできるかどうかを示します。
-
KeyFlag: boolean
タイトル:
Primary Key
最大長:1
デフォルト値:false
オブジェクト属性がオブジェクト主キーの一部であるかどうかを示します。 -
KeyNumber: number
タイトル:
Primary Key Number
オブジェクトの複合主キー属性内の属性の順序。 -
LangIndependentCode: string
最大長:
128
オブジェクト属性の言語非依存コードを示します。 -
LastUpdateDate: string (date-time)
タイトル:
Last Update Date
読取り専用:true
レコードが最後に更新された日時。 -
LastUpdatedBy: string
タイトル:
Last Updated By
読取り専用:true
最大長:64
レコードを最後に更新したユーザー。 -
LastUpdateLogin: string
タイトル:
Last Updated
読取り専用:true
最大長:32
レコードを最後に更新したユーザーのログイン。 -
長さ: number
タイトル:
Length
オブジェクト属性の長さ。 -
links: array Links
タイトル:
Links
リソース・インスタンスに関連付けられたリンク関係。 -
ObjectName: string
最大長:
255
オブジェクトの名前。 -
ParentKeyFlag: boolean
タイトル:
Primary Parent Key
最大長:1
デフォルト値:false
オブジェクト属性がオブジェクトの親主キーの一部であるかどうかを示します。 -
ParentKeyNumber: number
タイトル:
Parent Primary Key Number
オブジェクトの親主キーの複合主キー属性内の属性の順序。 -
ParentPuidFlag: boolean
タイトル:
Parent Primary Alternate Key
最大長:1
デフォルト値:false
オブジェクト属性が親のPUID属性であるかどうかを示します。 -
精度: number
タイトル:
Attribute Precision
オブジェクト属性の精度。 -
PuidFlag: boolean
タイトル:
Primary Alternate Key
最大長:1
デフォルト値:false
オブジェクト属性がPUID属性であるかどうかを示します。 -
QueryableFlag: boolean
タイトル:
Searchable
読取り専用:true
属性でオブジェクトを検索できるかどうかを示します。 -
RequiredFlag: boolean
タイトル:
Required
最大長:1
デフォルト値:false
オブジェクト属性が必須かどうかを示します。 -
スケール: number
タイトル:
Attribute Scale
オブジェクト属性のスケール。 -
Type: string
タイトル:
Type
読取り専用:true
オブジェクト属性のデータ型。 -
UpdatableFlag: boolean
タイトル:
Updatable
最大長:1
デフォルト値:false
オブジェクト属性を更新できるかどうかを示します。
ネストされたスキーマ : リンク
タイプ:
ソースを表示
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値を変更します。
例:
次の例は、cURLを使用してRESTリソースに対するGETリクエストを発行することによって、alファイル・インポートおよびエクスポート・オブジェクトを取得する方法を示しています。
cURLコマンド
curl -u <username:password> \ -X POST -d @example_request_payload.json https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/importExportObjectMetadata/Account
レスポンス本文の例
次に、JSON形式のレスポンス本文の例を示します。
{ "DisplayName" : "Account", "Description" : "An Organization Profile Includes Details About an Organization such as Organization Details, Additional Names, Additional Identifiers, Addresses, and Contact Points. Some Examples of Organizations are Customers, Sales Prospects, Competitors, and Partners.", "ObjectCode" : "Account", "ParentObjectCode" : null, "CustomFlag" : false, "SupportHighVolume" : "Y", "PuidAttribute" : "PartyNumber", "KeyAttributes" : "PartyId", "ParentKeyAttributes" : "", "RequiredFields" : "Party ID:Party Number:Organization ID:Name:Sales Account Number:Site Number:E-Mail:URL:Registry ID:Country", "CreatedBy" : "MHoope", "CreationDate" : "2017-10-30T22:58:29+00:00", "LastUpdatedBy" : "MHoope", "LastUpdateDate" : "2017-10-30T22:58:33.260+00:00", "LastUpdateLogin" : "5CCC8D7CD19B420BE053768DF50A9BFD", "UcmAccount" : "crm/simplifiedAccount/import/", "links": [ ... ] }