データパス

に保存されたデータは、 / ヘルプ/データマネージャー/">データマネージャー データパスと呼ばれる式を使用して取得できます。 これは、現在の Api 呼び出しのデータを取得するためにも使用できます。

可能な場所

  • 熱 意/ヘルプ/ zest -仕様ファイル/構造/プロパティ/導入/#path">パス - 熱 意/ヘルプ/ zest -指定ファイル/条件/">条件

データパスの構文

copy

<resource_name>:<path> <!-- to access different resources -->
 <variable_name>:<path> <!-- to access current API call -->

リソース名と変数名

別のリソースにアクセスするには、データパスに アクセスしようとしているデータのリソース名. ただし、現在の Api 呼び出しにアクセスするには、ケースに応じて次の 2 つの変数のいずれかを指定する必要があります。

  • リクエスト: Url、パラメーター、ヘッダー、本文などのリクエストの詳細が含まれています。

  • 応答: ヘッダーや本文などの応答の詳細が含まれています。


注:
  • 現在の Api 呼び出しのデータは、その特定のテスト ケースの検証までのみ使用できます。
  • で すべての条件 の属性 熱 意/ヘルプ/ zest -仕様ファイル/構造/プロパティ/導入/"> 、変数リクエスト/応答を指定する必要はありません。 なぜなら、データパスの条件は両方の変数に適用されるからです。

パス

これは、jsonやxMLパスに似ています。 のため 現在の Api 呼び出しのデータへのアクセス, 以下は、目的のキーに移動するのに役立ついくつかのパス変数です。

  • リクエスト: url、ヘッダー、パラメーター、本文

  • 応答: ヘッダー、本文 以下は、Zspecで使用できるパス式のリストです。

    表現 説明
    $ あなたのパスのルートオブジェクト。
    .プロパティ 期間 (.) の後に指定されたプロパティを選択します。同じ式を追加し続けることができます。 これにより、指定された親プロパティの子要素に移動するのに役立ちます。
    {条件} この式で指定された条件は、前の.プロパティに適用されます。 条件の前に指定されたプロパティがない場合は、すべての応答データに適用されます。
    [n] インデックス ’n’ のプロパティを選択するのに役立ちます。 ’n’ の可能な値は整数であり、0 から始まります。
    [開始インデックス - n] これは、指定されたインデックス範囲からデータの「n」数を選択するのに役立ちます。 つまり、この式では [0-4] は、0 番目のインデックスから始まる 4 つのレコードを取得します。 結果は0、1、2、3になります。

注:

{条件} 式内で動的データを使用するには、データ抽出パスから移動する必要はありません。 {条件} 式の外で使用される相対パスを指定するだけです。

サンプル

リソースにアクセスするためのデータパス

現在のリソースのいずれかで旅行リソースのデータを使用したいと想像してみてください。 以下は、旅行リソースの応答を取得します。

  • リソース名: 旅行

  • データ抽出パス: $.旅行

  • 主な道: $.トリップ_Id

copy

{
 "trips": [
 {
 "trip_name": "London - Emily Jones",
 "trip_id": "5545984000000006873",
 "no_of_days": 10,
 "travelers": [
 {
 "traveler_name":[
 "Ms",
 "Emily",
 "Jones"
 ],
 "traveler_email": "emily@qke.com"
 }
 ]
 },
 {
 "trip_name": "Sidney - John Smith",
 "trip_id": "5545974000000006871",
 "no_of_days": 2,
 "travelers": [
 {
 "traveler_name":[
 "Mr",
 "John",
 "Smith"
 ],
 "traveler_email": "johnsmith@abc.com"
 },
 {
 "traveler_name":[
 "Mr",
 "Patrick",
 "Robinson"
 ],
 "traveler_email": "patrobinson@abc.com"
 }
 ]
 }
 ]
 }

次に、現在のリソースのこのデータにアクセスするためのいくつかのデータパスサンプルを見てみましょう。

データパス 結果
旅行:$.日なし の値 日数なし 2つのレコードで。



結果:

  [10,2]  
旅行:$.旅行者.旅行者_電子メール キーの値 旅行者メール 旅行者 json オブジェクト

結果:

copy

[
 "emily@qke.com"
 "johnsmith@abc.com",
 "patrobinson@abc.com"
 ]
旅行:${旅行者.旅行者_名前!=空}.旅行_名前 レコードのトリップ名で、 旅行者メール トラベラー json オブジェクトのキーは **無効ではない**.

結果:

copy

[
 "London - Emily Jones",
 "Sidney - John Smith"
 ]
旅行:$[1].旅行_名前 最初のインデックスレコードの名前。

結果 ロンドン - エミリー・ジョーンズ

旅行:$[1-2].旅行_Id インデックス 1 から 2 までのレコードのトリップ Id。



結果:

copy

[
 "5545984000000006873",
 "5545974000000006871"
 ]

変数にアクセスするためのデータパス

次に、旅行リソースのZspecを作成していて、現在のapi呼び出しから旅行リソースのデータにアクセスする必要があることを考慮してください。

リクエストデータ

トリップ リソースの現在の Api 呼び出しのリクエストの詳細は次のように利用できます。リクエスト:

copy

{
 "url": {
 "module": "trips"
 },
 "params":
 {
 "ids": "5545974000000006871,5545974000003954574,5545974000000002599"
 },
 "headers": {
 "Authorization":"Zoho-oauthtoken 1000.9b67d20xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx0f0f6c9"
 },
 "body": null
 }

この Api 呼び出しのリクエストの詳細にアクセスする方法を見てみましょう。

データパス 結果
リクエスト:$.url.モジュール Url のモジュール名。


結果: 「旅行」

リクエスト:$.パラメーター. Id Url パラメーターで提供される id。


結果: 「5545974000000006871,5545974000003954574,5545974000000002599」

リクエスト:$.ヘッダー。承認 の詳細 ヘッダー リクエストで。


結果: 「1000.9b67d20xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx0f0f6c9」

応答データ

この Api 呼び出しの応答の詳細は、以下のようにアクセスできます。応答:

copy

{
 "headers": {
 "Content-Language":"en-US",
 "Content-Type":"application/json;charset=UTF-8"
 },
 "body": {
 "trips": [
 {
 "trip_name": "Bali - John Smith",
 "trip_id": "5545974000000006871",
 "no_of_days": 2
 },
 {
 "trip_name": "London - Emily Jones",
 "trip_id": "5545974000000006873",
 "no_of_days": 10
 },
 {
 "trip_name": "Sidney - Patrick Robinson",
 "trip_id": "5545974000000006875",
 "no_of_days": 5
 }
 ]
 }
 }

次に、この応答データを取得するために使用できるいくつかのデータパスサンプルを見てみましょう。

データパス 結果
応答:$.ヘッダー.コンテンツタイプ の値 コンテンツタイプ 応答ヘッダーに



結果: “アプリケーション/json;文字セット=UTF-8”

応答:$.ボディ.旅行[2] の 2 番目のインデックス値 旅行 応答ボディで。


結果:

copy

{
 "trip_name": "London - Emily Jones",
 "trip_id": "5545974000000006873",
 "no_of_days": 10
 }
応答:$.ボディ.旅行[1].旅行_Id 応答本文の 1 番目のインデックスのレコードのトリップ Id。

結果: 「554597400000000006873」

Last Updated 2026-02-06 15:55:45 +0530 IST