Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Sv translation
languageen

/api/dataSets/dataSources/:id/executions/:exid

Note

The execution result (number of rows and duration) is returned only for executions scheduled without parameter repeateInterval (executions executed only once).

Returns detailed information about the data source execution.

Resource Information

Resource URL

https://service.belladati.com/api/dataSets/dataSources/:id/executions/:exid

HTTP Method

GET

Request Parameters

Parameters

Detail

Example

id

ID of the data source to fetch. You can find the ID in the response to /api/dataSets/:id/dataSources.

123
exidID of the execution. You can get the execution ID as the response to /api/dataSets/dataSources/:id/schedule 456

Response Structure

JSON response contains an object with the following definition:

NameDescription
idID of the execution
status

Result of the import (SUCCESS, SUCCESS_INCOMPLETE, ERROR, CANCELED, etc.)

If the import has not been executed yet, the status is UNKNOWN

createdByIdentifier of user that created execution.
importDurationDuration of the import in seconds (only for status SUCCESS)
executedWhen

Date and time of the execution

importRecordsCountNumber of imported rows (only for status SUCCESS)
repeateInterval(Optional) Period of import execution - please see list of supported values. If this element is not specified then import will be performed only once.
repeateIntervalCustomMandatory only if "repeateInterval" has value "CUSTOM". Specifies custom repeat interval in minutes.
overwritingPolicy

(Optional) Action description to perform with existing data. If this element is not specified then existing data remains unchanged and new data rows will be appended.

NameDescription
attributes(Optional) Array containing codes of attributes that should be overwritten.
attributesAllBoolean flag indicating if data in for attributes should be overwritten.
dateAttribute(Optional) Code of attribute that should be used for date compare.
dateFrom(Optional) Date specifying start date of data rows to overwrite. Format: "yyyy-MM-dd"
dateTo(Optional) Date specifying end date of data rows to overwrite. Format: "yyyy-MM-dd"
policyOverwrite action to perform with existing data - please see list of supported values.


Sample Request / Response

Using curl:

Code Block
curl -H "Authorization: OAuth realm=\"https://service.belladati.com/\", oauth_consumer_key=\"myConsumer\", oauth_token=\"mh7an9dkrg59\", oauth_timestamp=\"135131231\", oauth_nonce=\"randomString\"" https://service.belladati.com/api/dataSets/dataSources/3435/execution/1223

The JSON format response:

Code Block
javascript
javascript
{
  "execution": {
    "importDuration": "10",
    "executedWhen": "Thu, 25 Jun 2020 14:15:16 GMT",
    "createdBy": "3",
    "importRecordsCount": "4248",
    "id": "1139714",
    "status": "SUCCESS"
  }
}


Sv translation
languageja

/api/dataSets/dataSources/:id/executions

指定されたIDを持つデータソースの実行データソースをリストします。

リソース情報

リクエストパラメータ

パラメーター

詳細

id

データソースのIDをフェッチします。/api/dataSets/:id/dataSourcesに応答して、IDを見つけることができます。

123

レスポンスの構造

Code Block
javascript
javascript
{
  "executions" : [ ]
}

JSONレスポンスは、次の定義で複数のデータソースの実行を含む「処刑」配列を含んでいます。

説明
id実行識別子
when実行必要にする最初インポートの日付と時間
createdBy実行を作成したユーザーの識別子
overwritingPolicy

(任意)アクションは、既存のデータを使用して実行する  -  サポートされる値のリストをご参照してください。この要素が指定されていない場合、データは変更されないまま既存および新規のデータ行が追加される。

repeateInterval

(任意)インポートの実行期間  -  サポートされる値のリストをご参照してください。この要素が指定されていない場合、インポートは1回だけ実行されます

repeateIntervalCustomrepeateInterval」が「CUSTOM」値を持っている場合のみ必須。カスタムリピート間隔を分単位で指定します。

サンプルリクエスト/レスポンス

Curl使用:

Code Block
curl -H "Authorization: OAuth realm=\"https://service.belladati.com/\", oauth_consumer_key=\"myConsumer\", oauth_token=\"mh7an9dkrg59\", oauth_timestamp=\"135131231\", oauth_nonce=\"randomString\"" https://service.belladati.com/api/dataSets/dataSources/3435/executions

JSONフォーマットの応答:

Code Block
javascript
javascript
{
  "executions" : [
    {
      "id" : 54354564,
      "when" : "Mon, 16 Apr 2012 10:17:26 GMT",
      "createdBy" : "123",
      "overwrittingPolicy" : "DELETE_ALL",
      "repeateInterval" : "CUSTOM",
      "repeateIntervalCustom" : 30
    }
  ]
}