すべてのファイル・インポートおよびエクスポート・オブジェクトの取得
get
/crmRestApi/resources/11.13.18.05/importExportObjectMetadata
リクエスト
問合せパラメータ
- 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>
使用可能なファインダ名および対応するファインダ変数を次に示します:- attachmentObjectRowFinder : 指定されたキーを持つオブジェクト行を検索します。
ファインダ変数:- ObjectCode; string;オブジェクトの言語独立コード。
- exportObjectFinder : 指定されたキーを持つエクスポート・オブジェクトを検索します。
ファインダ変数: - noteObjectRowFinder : 指定されたキーを持つノート・オブジェクト行を検索します。
ファインダ変数:- ObjectCode; string;オブジェクトの言語独立コード。
- objectRowFinder : 指定したオブジェクト名を持つインポート・エクスポート・オブジェクトを検索します。
ファインダ変数:- ObjectCode; string;オブジェクトの言語独立コード。
- attachmentObjectRowFinder : 指定されたキーを持つオブジェクト行を検索します。
- 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問合せパラメータを使用してこの収集リソースをフィルタできます:
- CreatedBy; string; レコードを作成したユーザー。
- CreationDate; string; レコードが作成された日時。
- CustomFlag; boolean;オブジェクトがカスタム・オブジェクトかどうかを示します。
- 説明;文字列;オブジェクトの説明。
- DisplayName; string;オブジェクトの表示名。
- DownloadTemplate; string;オブジェクト・テンプレートをダウンロードするためのリンク。
- ExportSupport; string; オブジェクトに対してエクスポート・アクティビティがサポートされているかどうかを示します。 値がYの場合、エクスポートがサポートされます。
- ImportSupport; string; インポート・アクティビティがオブジェクトに対してサポートされているかどうかを示します。 値がYの場合、インポートがサポートされます。
- KeyAttributes; string;カンマ区切りのリストにあるオブジェクトの主キー属性。
- LastUpdateDate; string; レコードが最後に更新された日時。
- LastUpdateLogin; string; レコードを最後に更新したユーザーのログイン。
- LastUpdatedBy; string; レコードを最後に更新したユーザー。
- ObjectCode; string;オブジェクトの言語独立コード。
- ParentKeyAttributes; string;カンマ区切りのリストにある、オブジェクトの親外部キー属性。
- ParentObjectCode; string;親オブジェクトの言語独立コード。
- PrimaryVoCount; integer;オブジェクトのプライマリ・ビュー・オブジェクトの数。
- PuidAttribute; string;オブジェクトの公開一意識別子。
- RequiredFields; string;オブジェクトの必須属性。
- SupportAttachmentImport; string; 添付のインポートがサポートされているかどうかを示します。
- SupportHighVolume; string; オブジェクトで大量インポートがサポートされるかどうかを示します。
- SupportNoteImport; string; ノート・インポートがサポートされているかどうかを示します。
- UcmAccount; string; ファイルをアップロードできるUCMアカウント。
- 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
タイプ:
ソースを表示
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-item-response
タイプ:
ソースを表示
object-
CreatedBy: string
タイトル:
Created By読取り専用:true最大長:64レコードを作成したユーザー。 -
CreationDate: string (date-time)
タイトル:
Creation Date読取り専用:trueレコードが作成された日時。 -
CustomFlag: boolean
タイトル:
Custom Object最大長:1デフォルト値:falseオブジェクトがカスタム・オブジェクトかどうかを示します。 -
Description: string
タイトル:
Descriptionオブジェクトの説明。 -
DisplayName: string
タイトル:
Display Nameオブジェクトの表示名。 -
DownloadTemplate: 文字列(バイト)
タイトル:
Download読取り専用:trueオブジェクト・テンプレートをダウンロードするためのリンク。 -
ExportSupport: string
エクスポート・アクティビティがオブジェクトに対してサポートされているかどうかを示します。 値がYの場合、エクスポートがサポートされます。
-
ImportSupport: string
インポート・アクティビティがオブジェクトに対してサポートされているかどうかを示します。 値がYの場合、インポートがサポートされます。
-
KeyAttributes: string
タイトル:
User Keys読取り専用:trueオブジェクトの主キー属性(カンマ区切りリスト)。 -
LastUpdateDate: string (date-time)
タイトル:
Last Update Date読取り専用:trueレコードが最後に更新された日時。 -
LastUpdatedBy: string
タイトル:
Last Updated By読取り専用:true最大長:64レコードを最後に更新したユーザー。 -
LastUpdateLogin: string
タイトル:
Last Updated読取り専用:true最大長:32レコードを最後に更新したユーザーのログイン。 -
links: array Links
タイトル:
Linksリソース・インスタンスに関連付けられたリンク関係。 -
ObjectAttributes: array Import Export Object Attributes
タイトル:
Import Export Object Attributesインポート・エクスポート・オブジェクト属性リソースは、ファイルベースのインポートおよびエクスポートをサポートする特定のオブジェクトの属性を表示するために使用されます。 -
ObjectCode: string
タイトル:
Object最大長:128オブジェクトの言語独立コード。 -
ParentKeyAttributes: string
タイトル:
Parent Object Key Attributes読取り専用:trueオブジェクトの親外部キー属性(カンマ区切りリスト)。 -
ParentObjectCode: string
タイトル:
Parent Object最大長:2000親オブジェクトの言語非依存コード。 -
PrimaryVoCount: 整数(int32)
オブジェクトのプライマリ・ビュー・オブジェクトの数。
-
PuidAttribute: string
タイトル:
Primary Alternate Key最大長:100オブジェクトの公開一意識別子。 -
RequiredFields: string
タイトル:
Required Fieldsオブジェクトの必須属性。 -
SupportAttachmentImport: string
読取り専用:
true最大長:255添付のインポートがサポートされているかどうかを示します。 -
SupportHighVolume: string
タイトル:
Support High Volume最大長:1オブジェクトが大量インポートをサポートするかどうかを示します。 -
SupportNoteImport: string
読取り専用:
true最大長:255ノート・インポートがサポートされているかどうかを示します。 -
UcmAccount: string
タイトル:
Account最大長:120ファイルをアップロードできるUCMアカウント。
ネストされたスキーマ : エクスポート・オブジェクト属性のインポート
タイプ:
arrayタイトル:
Import Export Object Attributesインポート・エクスポート・オブジェクト属性リソースは、ファイルベースのインポートおよびエクスポートをサポートする特定のオブジェクトの属性を表示するために使用されます。
ソースを表示
ネストされたスキーマ : リンク
タイプ:
ソースを表示
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値を変更します。
ネストされたスキーマ : 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オブジェクト属性を更新できるかどうかを示します。
例:
次の例は、cURLを使用してRESTリソースに対するGETリクエストを発行することによって、すべてのファイル・インポートおよびエクスポート・オブジェクトを取得する方法を示しています。
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
レスポンス本文の例
次に、JSON形式のレスポンス本文の例を示します。
{
"items" : [
{
"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" :
...
},
{
"DisplayName" : "Activity Assignee",
"Description" : "Activity Assignee",
"ObjectCode" : "ActivityAssignee",
"ParentObjectCode" : "Activity",
"CustomFlag" : false,
"SupportHighVolume" : "N",
"PuidAttribute" : null,
"KeyAttributes" : "ActivityIdAssigneeId",
"ParentKeyAttributes" : "ActivityId",
"RequiredFields" : "Activity ID:Assignee ID:Activity Number",
"CreatedBy" : "MHoope",
"CreationDate" : "2017-10-30T22:58:31.632+00:00",
"LastUpdatedBy" : "MHoope",
"LastUpdateDate" : "2017-10-30T22:58:33.812+00:00",
"LastUpdateLogin" : "5CCC8D7CD19B420BE053768DF50A9BFD",
"UcmAccount" : null,
"links" :
...
}
],
"count": 2,
"hasMore": false,
"limit": 25,
"offset": 0,
"links":
...
}