機械翻訳について

すべてのファイル・インポート・アクティビティの取得

get

/crmRestApi/resources/11.13.18.05/importActivities

リクエスト

問合せパラメータ
  • このパラメータを指定すると、指定した子がリソース・ペイロードに含まれます(リンクのみでなく)。 この問合せパラメータの値は"all"または""です。 カンマをセパレータとして使用して、複数の子を指定できます。 例: ?expand=Employees,Localizations. ネストされた子は、"Child.NestedChild"の書式に従って指定することもできます(例): ?expand=Employees.Managers). ネストされた子が指定されている場合(例): Employees.Managers)。欠落している子は暗黙的に処理されます。 たとえば、"?expand=Employees.Managers"は"?expand=Employees,Employees.Managers"と同じです(これにより、従業員とマネージャが展開されます)。
  • このパラメータは、リソース・フィールドをフィルタします。 指定されたフィールドのみが返されます。つまり、フィールドが指定されていない場合、フィールドは返されません(リンクのみを取得する場合に便利です)。 間接子リソースが指定されている場合(例): Employees.Managers)。欠落している子は暗黙的に処理されます。 たとえば、"?fields=Employees.Managers:Empname"は"?fields=;Employees:;Employees.Managers:Empname" (これはマネージャの"Empname"フィールドのみを返す)と同じです。この問合せパラメータの値は、リソース・フィールドのリストです。 属性は直接にすることができます(例): 従業員または間接(例): Employees.Managers) child. 拡張問合せパラメータと組み合せることはできません。 両方を指定した場合、フィールドのみが考慮されます。

    フォーマット : ?fields=Attribute1,Attribute2

    子リソースのフィールドの書式 : ?fields=Accessor1:Attribute1,Attribute2
  • コレクションを検索するための事前定義済ファインダとして使用されます。

    フォーマット : ?finder=<finderName>;<variableName>=<variableValue>,<variableName2>=<variableValue2>

    使用可能なファインダ名および対応するファインダ変数を次に示します:

    • FileImportObjectActivityFinder : 指定したオブジェクト名のファイル・インポート・アクティビティを検索します。
      ファインダ変数:
      • ObjectCode; string;ファイル・インポート・オブジェクトの一意のオブジェクト・コード。
    • ImportActivityFinder : 指定したインポート・アクティビティIDのファイル・インポート・アクティビティを検索します。
      ファインダ変数:
      • PrimaryKey : 主キーImportActivityIdでインポート・アクティビティを検索します。
        ファインダ変数:
        • ImportActivityId; integer;インポート・アクティビティを識別する一意の値。
    • このパラメータは、リソース・コレクション内で返されるリソースの数を制限します。 制限がリソース数を超えると、フレームワークは使用可能なリソースのみを返します。
    • このパラメータは、単一のリソースまたはリソース・コレクションへのアクセス中に特定のリンクのみを表示するために使用できます。 パラメータ値書式は、次のカンマ区切りリストです : <link_relation>

      例:
      self,canonical
    • リソース・コレクションの開始位置を定義するために使用します。 オフセットがリソース数を超えると、リソースは返されません。 デフォルト値は0です。
    • リソース・アイテム・ペイロードは、データのみを含めるようにフィルタされます(リンク・セクションなどは含まれません)。
    • このパラメータは、指定されたフィールドに基づいてリソース・コレクションを順序付けます。 パラメータ値は、属性名のカンマ区切りの文字列で、それぞれオプションでコロンと「asc」または「desc」が続きます。 昇順の場合は「asc」、降順の場合は「desc」を指定します。 デフォルト値は「asc」です。 たとえば、?orderBy=field1:asc,field2:descです
    • この問合せパラメータは、where句を定義します。 リソース・コレクションは、指定された式を使用して問い合せられます。 この問合せパラメータの値は、1つ以上の式です。 例 : ?q=部門番号>=10および<= 30;Loc!=NY

      フォーマット : ?q=expression1;expression2

      次の問合せ可能属性を使用して、q問合せパラメータを使用してこの収集リソースをフィルタできます:
      • Activate; string;ジョブをアクティブ化するかどうかを示します。 可能な値ははいおよびいいえです。値がはいの場合、インポート・ジョブがアクティブ化され、ログ・ファイルが作成されます。 値がいいえの場合、インポート・ジョブは保存されますがアクティブ化されません。
      • AttachmentObjectCode;文字列;添付するオブジェクトを示すコード(取引先、担当者、商談など)。
      • 取消、文字列。この属性は、RESTを使用してインポート・ジョブを取り消すためのものです
      • CreatedBy; string; レコードを作成したユーザー。
      • CreationDate; string; レコードが作成された日時。
      • DateFormat; string; ソース・ファイルで使用される日付書式。
      • DecimalSeparator; string; ソース・ファイル内の数値フィールドに対する小数点記号として使用される文字。
      • デリミタ、文字列。ソース・ファイル内のレコードのデータ・セパレータとして使用されるデリミタ。
      • 説明、文字列。インポート・ジョブの説明。
      • EnableCustomBusinessLogic; string; アプリケーション・コンポーザを使用して定義されたカスタム・ビジネス・ロジックを実行できます。
      • FileEncoding; string; インポート・アクティビティに適用されるファイル・エンコーディング形式。
      • HighVolume; string; インポート・アクティビティが大量インポートとして分類されるかどうかを示します。
      • ImportActivityId; integer; インポート・アクティビティを表す一意の識別子。
      • ImportMapping; string;以前に定義された属性マッピングのマッピング番号。 マッピング番号またはオブジェクト・コードのいずれかが必要です。
      • ImportMode; string;インポートのモード。 有効な値は、新規レコードを作成、既存のレコードを更新または既存のレコードを削除です。 値は、CREATE_ONLY (レコードの作成)、CREATE_RECORD (作成および更新)、DELETE_RECORD (削除)です。
      • LastUpdateDate; string; レコードが最後に更新された日時。
      • LastUpdateLogin; string; レコードを最後に更新したユーザーのログイン。
      • LastUpdatedBy; string; レコードを最後に更新したユーザー。
      • 名前、文字列。インポート・ジョブの名前。
      • NoteObjectCode; string; アカウント、担当者、商談など、ノートが追加されるオブジェクトを示すコード。
      • NotificationEmail; string; インポート・エラーしきい値を超えた場合に通知する必要がある管理者の電子メール。
      • ObjectCode;文字列。インポートされるオブジェクトを示すコード(取引先、担当者、商談など)。
      • RestNotification; string; インポート・ジョブの完了後に通知が送信されるRESTリソース名を指定
      • Schedule; string;インポート・ジョブのスケジュール・セット。ただちに実行するか、将来の日付で実行するかを決定します。
      • ScheduleTime; string; インポート・アクティビティ・ジョブがスケジュールされる日付。
      • TimestampFormat; string;インポート・アクティビティのタイムスタンプ書式。
    • "?totalResults=true"の場合、リソース・コレクション表現には"推定行数"が含まれます。それ以外の場合、カウントは含まれません。 デフォルト値はfalseです。
    ヘッダー・パラメータ
    • REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。 次に例を示します : Metadata-Context:sandbox="TrackEmployeeFeature".
    • RESTクライアントとサービスの間のプロトコル・バージョン。 クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。

    この操作にはリクエスト本文がありません。

    トップに戻る

    応答

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

    デフォルトのレスポンス

    次の表では、このタスクに対するデフォルトのレスポンスについて説明します。
    ヘッダー
    • REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。 次に例を示します : Metadata-Context:sandbox="TrackEmployeeFeature".
    • RESTクライアントとサービスの間のプロトコル・バージョン。 クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。
    本文( )
    ルート・スキーマ : importActivities
    タイプ: object
    ソースを表示
    ネストされたスキーマ : アイテム
    タイプ: array
    タイトル: Items
    コレクション内のアイテム。
    ソースを表示
    ネストされたスキーマ : importActivities-item-response
    タイプ: object
    ソースを表示
    • タイトル: Activate Import Job
      デフォルト値: NO
      ジョブをアクティブ化する必要があるかどうかを示します。 可能な値ははいおよびいいえです。値がはいの場合、インポート・ジョブがアクティブ化され、ログ・ファイルが作成されます。 値がいいえの場合、インポート・ジョブは保存されますがアクティブ化されません。
    • タイトル: Attachment Object Code
      アカウント、担当者、商談など、添付するオブジェクトを示すコード。
    • この属性は、RESTを使用したインポート・ジョブの取消用です
    • タイトル: Created By
      読取り専用: true
      最大長: 64
      レコードを作成したユーザー。
    • タイトル: Creation Date
      読取り専用: true
      レコードが作成された日時。
    • Import Activity Data Files
      タイトル: Import Activity Data Files
      インポート・アクティビティ・データ・ファイル・リソースは、インポートされる情報を含むデータ・ファイルを表示および作成するために使用します。
    • タイトル: Date Format
      最大長: 120
      デフォルト値: ORA_ZCA_US_FORMAT
      ソース・ファイルで使用される日付書式。
    • タイトル: Decimal Separator
      最大長: 120
      デフォルト値: .
      ソース・ファイルの数値フィールドに対する小数点区切りとして使用される文字。
    • タイトル: Delimiter
      最大長: 30
      デフォルト値: COMMA_DELIMITER
      ソース・ファイル内のレコードのデータ・セパレータとして使用されるデリミタ。
    • タイトル: Description
      最大長: 250
      インポート・ジョブの説明。
    • タイトル: Enable Custom Business Logic
      デフォルト値: NO
      アプリケーション・コンポーザを使用して定義されたカスタム・ビジネス・ロジックの実行を有効にします。
    • タイトル: File Encoding
      最大長: 30
      デフォルト値: ORA_ZCA_UTF8_ENCODING
      インポート・アクティビティに適用されるファイル・エンコーディング形式。
    • タイトル: High Volume
      デフォルト値: NO
      インポート・アクティビティが大量インポートとして分類されるかどうかを示します。
    • タイトル: Import Activity Identifier
      インポート・アクティビティを表す一意の識別子。
    • タイトル: Mapping Number
      以前に定義した属性マッピングのマッピング番号。 マッピング番号またはオブジェクト・コードのいずれかが必要です。
    • タイトル: Import Mode
      最大長: 30
      デフォルト値: CREATE_RECORD
      インポートのモード。 有効な値は、新規レコードを作成、既存のレコードを更新または既存のレコードを削除です。 値は、CREATE_ONLY (レコードの作成)、CREATE_RECORD (作成および更新)、DELETE_RECORD (削除)です。
    • タイトル: Last Update Date
      読取り専用: true
      レコードが最後に更新された日時。
    • タイトル: Last Updated By
      読取り専用: true
      最大長: 64
      レコードを最後に更新したユーザー。
    • 読取り専用: true
      最大長: 32
      レコードを最後に更新したユーザーのログイン。
    • Links
    • タイトル: Name
      最大長: 100
      インポート・ジョブの名前。
    • タイトル: Note Object
      アカウント、担当者、商談など、ノートが追加されるオブジェクトを示すコード。
    • タイトル: Notification Email
      最大長: 500
      インポート・エラーしきい値を超えた場合に通知する必要がある管理者のEメール。
    • タイトル: Object Code
      最大長: 100
      インポートするオブジェクト(アカウント、担当者、商談など)を示すコード。
    • インポート・ジョブの完了後に通知が送信されるRESTリソース名を指定
    • タイトル: Schedule
      最大長: 30
      デフォルト値: ONE_TIME_IMMEDIATE
      インポート・ジョブのスケジュール・セットで、即時に実行するか、将来の日付で実行するかを決定します。
    • タイトル: Start Time
      インポート・アクティビティ・ジョブがスケジュールされた日付。
    • タイトル: Time Stamp Format
      最大長: 120
      デフォルト値: ORA_ZCA_US_FORMAT
      インポート・アクティビティのタイム・スタンプ書式。
    ネストされたスキーマ : アクティビティ・データ・ファイルのインポート
    タイプ: array
    タイトル: Import Activity Data Files
    インポート・アクティビティ・データ・ファイル・リソースは、インポートされる情報を含むデータ・ファイルを表示および作成するために使用します。
    ソースを表示
    ネストされたスキーマ : importActivities-DataFiles-item-response
    タイプ: object
    ソースを表示
    • 読取り専用: true
      インポート・ジョブを取り消したユーザーを示します。
    • タイトル: Created By
      読取り専用: true
      最大長: 64
      レコードを作成したユーザー。
    • タイトル: Creation Date
      読取り専用: true
      レコードが作成された日時。
    • タイトル: Description
      読取り専用: true
      インポート・ジョブの説明。
    • タイトル: End Time
      読取り専用: true
      ソース・データファイルの処理が終了する日時。
    • タイトル: Error File Content ID
      読取り専用: true
      エラー・レポート・ファイルの一意の識別子。
    • タイトル: Records with Errors
      読取り専用: true
      最大長: 150
      ソースCSVファイルから読み取られたインポート・レコードの数。
    • タイトル: Estimated Completion Time
      読取り専用: true
      最大長: 150
      ソースCSVファイルのインポートの処理にかかるおおよその時間。
    • タイトル: Exception File Content ID
      読取り専用: true
      例外レポート・ファイルの一意の識別子。
    • タイトル: File Name
      最大長: 150
      ソースCSVファイルの名前。
    • タイトル: Source File Content ID
      最大長: 150
      ソースCSVファイルの一意のUCMコンテンツ識別子。
    • タイトル: Last Update Date
      読取り専用: true
      レコードが最後に更新された日時。
    • タイトル: Last Updated By
      読取り専用: true
      最大長: 64
      レコードを最後に更新したユーザー。
    • タイトル: Last Updated
      読取り専用: true
      最大長: 32
      レコードを最後に更新したユーザーのログイン。
    • Links
    • タイトル: Successfully Loaded
      読取り専用: true
      最大長: 150
      ソースCSVファイルから正常にロードされたインポート・レコードの数。
    • 最大長: 100
      インポート・ジョブに関連するメッセージ・コードを示します。
    • タイトル: Total Records
      読取り専用: true
      最大長: 150
      ソースCSVファイルから読み取られたインポート・レコードの数。
    • タイトル: File Size
      読取り専用: true
      ソースCSVファイルのファイル・サイズ。
    • タイトル: Start Time
      読取り専用: true
      ソース・データ・ファイルの処理が開始される日時。
    • タイトル: Status
      読取り専用: true
      ソースCSVファイル・インポート処理の現在のステータス。
    • タイトル: Success File Content ID
      読取り専用: true
      インポートが正常に完了したときに生成される成功レポート・ファイルの一意の識別子。
    • タイトル: Title
      読取り専用: true
      ソースCSVファイルのファイル名タイトル。
    • 読取り専用: true
      このフィールドには、取消されたジョブの未処理レコード数が表示されます
    • タイトル: Records with Warnings
      読取り専用: true
      最大長: 150
      ソースCSVファイルから処理されたインポート・レコードの数で、警告が発生しました。
    トップに戻る

    例:

    次の例は、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/importActivities

    レスポンス本文の例

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

    {
     "items" : [ 
    	{
        "ImportActivityId" : 300100123779027,
        "Name" : "Acc_MAT_delay_WarningLink",
        "Description" : null,
        "ObjectCode" : "Account",
        "AttachmentObjectCode" : null,
        "DecimalSeparator" : ".",
        "DateFormat" : "ORA_ZCA_US_FORMAT",
        "ImportMode" : "CREATE_RECORD",
        "TimestampFormat" : "ORA_ZCA_US_FORMAT",
        "FileEncoding" : "ORA_ZCA_UTF8_ENCODING",
        "Delimiter" : "COMMA_DELIMITER",
        "NotificationEmail" : null,
        "ImportMapping" : "300100123779030",
        "Schedule" : "ONE_TIME_IMMEDIATE",
        "ScheduleTime" : null,
        "Activate" : "YES",
        "CreatedBy" : "MHoope",
        "CreationDate" : "2017-11-02T14:30:43+00:00",
        "LastUpdateDate" : "2017-11-02T14:34:27+00:00",
        "LastUpdatedBy" : "MHoope",
        "LastUpdateLogin" : "5D00FDB705986AC0E053768DF50A8B0F",
        "HighVolume" : "NO",
        "links" : 
    	...
    	},
    	{
     	 "ImportActivityId" : 300100123779003,
        "Name" : "Sales team Member import 3",
        "Description" : null,
        "ObjectCode" : "SalesTeamMember",
        "AttachmentObjectCode" : null,
        "DecimalSeparator" : ".",
        "DateFormat" : "ORA_ZCA_US_FORMAT",
        "ImportMode" : "CREATE_RECORD",
        "TimestampFormat" : "ORA_ZCA_US_FORMAT",
        "FileEncoding" : "ORA_ZCA_UTF8_ENCODING",
        "Delimiter" : "COMMA_DELIMITER",
        "NotificationEmail" : null,
        "ImportMapping" : "300100123779010",
        "Schedule" : "ONE_TIME_IMMEDIATE",
        "ScheduleTime" : null,
        "Activate" : "YES",
        "CreatedBy" : "MHoope",
        "CreationDate" : "2017-11-02T14:28:18+00:00",
        "LastUpdateDate" : "2017-11-02T14:31:40+00:00",
        "LastUpdatedBy" : "MHoope",
        "LastUpdateLogin" : "5D00FDB705936AC0E053768DF50A8B0F",
        "HighVolume" : "NO",
    	  "links" :
    	...
    	}
    	],
      "count": 2,
      "hasMore": false,
      "limit": 25,
      "offset": 0,
      "links": 
      ...
      }
    「トップに戻る」