Object Explorer の URL を生成する

Object View の開発時や、Object View を Slate アプリケーションまたは外部システムに統合する際に、特定のオブジェクトへのリンクやオブジェクトの検索用の URL を生成する必要が生じることがあります。

特定の Object View にリンクする URL の作成方法については、Object View のドキュメントの Object View の URL を生成するを参照してください。

キーワードのみの検索を生成する

テキストに特殊文字や空白が含まれる場合は、エンコードする必要があります。

encodeURIComponent("hello world");

URL を作成します。

<BASEURL>/hubble/external/keyword/v0/<MY_ENCODED_TEXT>

探索にリンクする

Object Explorer では、特定のオブジェクトタイプ、保存済みの探索、または URL に記述されたフィルターを使用する新しい検索へのリンクを開けます。どの種類のリンクも、集計結果を示すチャートが表示されるデフォルトの探索ビューで開けます。また、リンク URL の末尾にパラメーター perspectiveId=results を追加すると、表形式の結果ビューで開けます。

探索用にオブジェクトタイプを開く

objectTypeId URL パラメーターを使用すると、特定のオブジェクトタイプの探索を開けます。例：

/workspace/hubble/exploration?objectTypeId=aircraft。

結果ビューで開くには、perspectiveId=results パラメーターを追加します。

/workspace/hubble/exploration?objectTypeId=aircraft&perspectiveId=results

保存済みの探索またはオブジェクトセットを読み込む

保存済みの探索またはオブジェクトセットを開くには、saved ルートを使用します。

/workspace/hubble/exploration/saved/ri.object-set.main.versioned-object-set.4b117663-06d7-4bd1-a2be-8e1ba20998cb

別の Foundry アプリケーションで作成されたオブジェクトセットを読み込むには、external/objectSet ルートを使用します。

/workspace/hubble/external/objectSet/v0/ri.object-set.main.object-set.f6916120-5b52-4312-8be4-9f5764983907

[高度な機能] 複雑な検索を生成する

次のような形式でフィルターを生成します。

Copied!
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
{
  "keyword": "",
  "objectTypes": [
    "google-reviews"
  ],
  "filters": [
    {
      "type": "propertyFilter",
      "objectType": "google-reviews",
      "propertyType": "Description",
      "value": {
          "type": "textFilter",
          "text": "hello"
      }
    },
    {
      "type": "propertyFilter",
      "objectType": "google-reviews",
      "propertyType": "rating",
      "value": {
          "type": "valuesFilter",
          "values": ["3", "4"]
      }
    },
    {
      "type": "propertyFilter",
      "objectType": "google-reviews",
      "propertyType": "creation-date",
      "value": {
          "type": "dateRangeFilter",
          "dateRangeFilter": {
              "start": "2000-01-10",
              "end": "2000-01-11"
          }
      }
    },
    {
      "type": "linkFilter",
      "objectType": "google-reviews",
      "linkType": "restaurant-to-review",
      "value": {
          "type": "presenceFilter",
          "matchType": "MUST_HAVE"
      }
    }
  ]
}

上記の例は古くなっている可能性があります。最新の形式を確認するには、以下の手順に従ってください。

ほかにも、次のような種類のフィルターを利用できます。

• numberRangeFilter: min（任意の数値）、max（任意の数値）
• relativeDateFilter: sinceDaysAgo（任意の数値）、untilDaysAgo（任意の数値）
• timestampRangeFilter: startMillis（任意の数値）、endMillis（任意の数値）
• relativeTimestampFilter: sinceMillisAgo（任意の数値）、untilMillisAgo（任意の数値）

値のデータ型は、Object Explorer でそのプロパティに対してデフォルトで表示されるウィジェットの種類と一致する必要があります。たとえば、ヒストグラムウィジェットには valuesFilter、テキストボックスには textFilter を使用します。

これらのフィルターを生成するには、次の方法を推奨します。

1. Object Explorer を開き、生成するすべてのフィルターにサンプル値を選択して、検索の例を作成します。

2. Chrome コンソールを開きます（右クリック -> 要素を検証）。単に Chrome コンソールを開くのではなく、検索結果の件数など、Object Explorer が表示する要素を検証してください。

3. コンソールで await hubble_get_current_search() を実行します。

これにより、現在のフィルターの JSON が返されます。この JSON を使用して正しい形式を確認し、値を置き換える処理を追加できます。

4. URL エンコードします。

encodeURIComponent(<MY_FILTERS>);

5. URL を作成します。

<BASEURL>/hubble/external/search/v2/{<ENCODED-URL-FROM-ABOVE>}