Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Removed translated content for 'zh'
Sv translation
languageen

/api/dataSets/:id/replace

Deletes data based on a filter and then updates existing row or inserts new row in data set specified by ID.

Resource Information

Resource URL

https://service.belladati.com/api/dataSets/:id/replace

HTTP Method

POST

Consumesapplication/json

Request Parameters

Parameters

Detail

Example
id
ID of the data set to modify data in. You can find the ID in the response to /api/dataSets.123

dataRows

One data row in JSON format with following definition:

NameDescription
L_*Attribute value. To keep original value while updating row, don't include attribute name in the request. To set empty value, provide either empty string or null as value.
M_*Indicator value. To keep original value while updating row, don't include indicator name in the request. To set empty value, provide either empty string or null as value.


[{
  "L_COUNTRY""Great Britain",
  "M_REVENUE": "1234.5678"
}]

filter

Filter used to delete data.

Prefix (PT) can be used when join contains columns with the same names.

See the complete list of Filter operation types.

conditionType (optional) is used to define condition operator between conditions. Available values:

  • AND (default)
  • OR

Searching part of String: use '%' wildcard to search selected String in data set values. E.g. "value": "%al%"

{"drilldown":{"L_COUNTRY":{"op":"EQ","value":"USA"}}}


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\", Content-Type=\"application/json\"" -d "{dataRows:[\"L_COUNTRY\":\"Great Britain\",\"M_REVENUE\":\"1234.5678\"}],filter:{\"drilldown\":{\"L_COUNTRY\":{\"op\":\"EQ\",\"value\":\"USA\"}}}}" https://service.belladati.com/api/dataSets/123/replace

When data has been deleted and new rows added successfully, the response has the HTTP status code 200 and the content "OK".


Sv translation
languageja

/api/dataSets/:id/replace

フィルタに基づいてデータを削除してから、既存の行を更新するか、IDで指定されたデータセットに新しい行を挿入します。

リソース情報

リソースURL

https://service.belladati.com/api/dataSets/:id/replace

HTTPメソッド

POST

Consumesapplication/json

リクエストパラメーター

パラメーター

詳細

id

データを変更するデータセットのID。IDは/api/dataSetsへのレスポンスで確認できます。

123

dataRows

次の定義を持つJSON形式の1つのデータ行:

詳細
L_*

属性値。行の更新中に元の値を保持するには、リクエストに属性名を含めないでください。空の値を設定するには、値として空の文字列またはnullを指定します。

M_*

インジケータ値。行の更新中に元の値を保持するには、リクエストにインジケータ名を含めないでください。空の値を設定するには、値として空の文字列またはnullを指定します。


[{
  "L_COUNTRY""Great Britain",
  "M_REVENUE": "1234.5678"
}]

filter

データの削除に使用されるフィルター。

プレフィックス (PT) は、結合に同じ名前の列が含まれている場合に使用できます。

Filter operation typesのリストをご覧ください。

conditionType (オプション) は、条件間の条件演算子を定義するために使用されます。利用可能な値:

  • AND (デフォルト)
  • OR

文字列の一部を検索する: ワイルドカード '%' を使用して、データセット値で選択した文字列を検索します。例: "value": "%al%"

{"drilldown":{"L_COUNTRY":{"op":"EQ","value":"USA"}}}


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

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\", Content-Type=\"application/json\"" -d "{dataRows:[\"L_COUNTRY\":\"Great Britain\",\"M_REVENUE\":\"1234.5678\"}],filter:{\"drilldown\":{\"L_COUNTRY\":{\"op\":\"EQ\",\"value\":\"USA\"}}}}" https://service.belladati.com/api/dataSets/123/replace

データが削除され、新しい行が正常に追加されると、レスポンスのHTTPステータスコードは200になり、コンテンツは"OK"になります。