ルックアップ テーブル

このページは機械翻訳により提供されています。翻訳内容と英語版に相違がある場合は、英語版が優先されます。

ルックアップ テーブルを使用すると、レシピは相互参照テーブルに似たエントリ行と値列のテーブルを使用して、頻繁に使用するデータを効率的に保存、参照、管理できます。

ルックアップ テーブルページでは、テーブルを手動で作成、削除、更新、解析できます。

ルックアップ テーブル by Workatoコネクターを使用すると、エントリ行に関する情報を追加、更新、削除、取得し、テーブルを削除するレシピを作成できます。

機能の提供状況

ルックアップ テーブル機能は、特定の料金プランのお客様が利用できます。 詳細については、ご利用の料金プランおよび契約を参照してください。

ルックアップ テーブルページにアクセスするには、次のいずれかが必要です。

ルックアップ テーブルページへのアクセス権を持たないコラボレーターでも、レシピがテーブルのスコープ内にある場合は、ルックアップ テーブル by Workatoコネクターを通じてルックアップ テーブルを操作できます。

タイムゾーン、時刻、オフセットを含むルックアップ テーブルタイムゾーン、時刻、オフセットを含むルックアップ テーブル

利用状況のヒント

ルックアップ テーブルのユースケースの例は次のとおりです。

  • 市区町村名を使用して郵便番号を検索します。
  • ダウンストリームアプリ用にメートル法の測定値をヤードポンド法に変換します。
  • ビジネスプロセスなどの一時的な情報のキャッシュを作成します。
  • 頻繁に使用する静的データを保存して、API GETリクエストのコストを削減します。
  • 低速またはパフォーマンスの低いGETAPIから頻繁に使用する静的データを保存します。

互換性のないユースケース

ルックアップ テーブルは、次のユースケース向けには設計されていません。

  • リレーショナルデータベースソリューション: ルックアップ テーブルには適用される制限があるため、長期的な大規模リレーショナルデータベースとしては機能しません。
  • 単一セル内の大きなデータ: 単一のルックアップ テーブルセルに10キロバイトを超える値を保存しないでください。

ルックアップ テーブルの制限

ルックアップ テーブルには次の制限があります。

説明制限メモ
ワークスペース内のルックアップ テーブルの最大数100NA
ルックアップ テーブル内の列の最大数10NA
ルックアップ テーブル内の行の最大数100,000
  • ルックアップ テーブルコネクターのすべてのエントリを取得アクションは、最初の10,000件のエントリのみを取得します。
  • 50,000件を超えるエントリを含むテーブルは、CSVファイルとしてダウンロードできません。
最大行サイズ128 KBNA
レシピライフサイクルマネジメントのインポートおよびエクスポートにおけるルックアップ テーブル内の行の最大数10,000NA
レシピライフサイクルマネジメントでインポートされるルックアップ テーブルの最大ファイルサイズ10 MBこの制限は行数制限とは独立して適用されます。行に大きな値が含まれる場合、ルックアップ テーブルは10,000行未満でも10 MBを超えることがあります。この制限を超えるインポートは、差分画面が表示される前にブロックされます。
ルックアップ テーブルコネクタアクションの最大バッチサイズ10,000この制限は、次のコネクターアクションに適用されます:
  • エントリを追加(バッチ)アクション
  • すべてのエントリを取得(バッチ)アクション

ルックアップ テーブルへのアクセスの制御

次の方法を使用して、ワークスペースのルックアップ テーブルへのアクセスを制御します。

ルックアップ テーブルのロールベースのアクセス制御

ロールベースのアクセス制御を使用して、ルックアップ テーブルページへのアクセスを管理できます。

コラボレーターロールのルックアップ テーブル権限を変更するには、次の手順を実行します。

1

ワークスペース管理者>アクセス制御>Environmentロールに移動します。

2

変更するロールを選択するか、+ Add environment roleをクリックします。

3

プラットフォーム ツール > データストレージに移動します。

4

ルックアップ テーブル行で、ロールに割り当てる権限を選択します。 データストレージの権限ルックアップ テーブル権限

5

変更を保存をクリックします。 ロールへの変更を保存ロールへの変更を保存

ルックアップ テーブル権限のスコープ

ロールベースのアクセス制御では、ルックアップ テーブルページへのアクセスのみを管理します。 コラボレーターは、ルックアップ テーブル by Workatoコネクターを通じて、アクセス権を持つプロジェクトにスコープ設定されたルックアップ テーブルを引き続き操作できます。

ルックアップ テーブルを特定のプロジェクトに割り当てる

デフォルトでは、ルックアップ テーブルはすべてのプロジェクトからアクセスできます。 スコープを制限して、ルックアップ テーブルを特定のプロジェクト内でのみアクセス可能にできます。 スコープ設定後、テーブルはそのプロジェクトへのアクセス権を持つコラボレーターにのみ表示されます。

ルックアップ テーブルを特定のプロジェクトに制限するには、次の手順を実行します。

1

ツール > ルックアップ テーブルに移動します。

2

スコープを設定するルックアップ テーブルを選択します。

3

Available inをクリックして、Update availabilityダイアログを開きます。 ルックアップ テーブルのスコープを更新ルックアップ テーブルのスコープを更新

4

Choose a projectドロップダウンメニューを使用して、ルックアップ テーブルのアクセスを特定のプロジェクトに制限します。

5

Update availabilityをクリックします。

6

ロールベースのプロジェクトアクセスを使用して、プロジェクトにアクセスできるコラボレーターを制限します。

スコープを変更すると実行中のレシピに影響する可能性があります

ルックアップ テーブルのスコープを変更すると、現在実行中のレシピ内での可用性に影響する可能性があります。

コネクターを使用してユーザーがアクセスできるルックアップ テーブルを表示する方法
1

確認するコラボレーターロールを持つユーザーとしてWorkatoにサインインします。

2

プロジェクトを開きます。

3

新しいレシピを作成します。 開始点としてRun on a scheduleを選択できます。

4

+ Add stepをクリックし、Action in appを選択します。

5

アプリを選択検索ボックスでLookup tables by Workatoを検索して選択します。

6

任意のアクションを選択します。

7

Lookup tableドロップダウンメニューを選択して、ユーザーがコネクターを使用してアクセスできるルックアップ テーブルを確認します。 利用可能なルックアップ テーブル利用可能なルックアップ テーブル


ルックアップ テーブルを設定する

新しいルックアップ テーブルを作成するには、次の手順を実行します。

1

ツール > ルックアップ テーブル に移動します。

2

+ New tableをクリックします。

3

Edit(鉛筆アイコン)をクリックしてルックアップ テーブルの名前を入力し、✓ Saveをクリックして変更を保存します。

4

Import CSVをクリックして、ルックアップ テーブルの列名と構造を定義するヘッダー行を含むCSVファイルをアップロードするか、Add entries manuallyをクリックしてエントリを直接追加します。

5

完了したら✓ Saveをクリックします。

ルックアップ テーブルエントリで強調表示された保存ボタン


ルックアップ テーブルデータの追加と更新

次の方法を使用して、ルックアップ テーブルのエントリを追加および編集できます。

CSVファイルをインポートする

CSVファイルをルックアップ テーブルにインポートするには、次の手順を実行します。

1

ツール > ルックアップ テーブルに移動し、+ New tableをクリックします。

2

Import CSVをクリックします。

3

Specify actionセクションで、次のいずれかのオプションを選択します。

  • Add row entries: WorkatoはCSV行を新しいエントリとして追加します。 既存のエントリは影響を受けません。
  • Replace existing data: Workatoは既存のエントリを新しいCSVファイルの行で上書きします。

CSVインポートウィンドウCSVインポートウィンドウ

4

CSVファイルをSelect CSV fileフィールドにドラッグアンドドロップするか、upload from deviceをクリックしてCSVファイルを選択します。

5

CSVの最初の行をインポートしない場合は、最初の行(ヘッダー)をインポートしないチェックボックスを選択します。

6

Import CSVをクリックします。

エントリを手動で追加または編集する

レシピアクションを使用する

エントリを自動的に追加および更新するには、ルックアップ テーブル by Workatoコネクターのエントリを追加複数のエントリを追加、およびエントリを更新レシピアクションを使用します。


プロジェクト別にルックアップ テーブルをフィルターする

Workatoは、異なるプロジェクトに関連付けられたルックアップ テーブルをすばやく見つけるための検索フィルターをサポートしています。

フィルターを使用してルックアップ テーブルを検索するには、次の手順を実行します。

1

ツール > ルックアップ テーブルに移動します。

2

プロジェクトフィルターのドロップダウンメニューを見つけます。

プロジェクトフィルタープロジェクトフィルターのドロップダウンメニュー

3

ルックアップ テーブルのフィルター条件にするプロジェクトを選択します。

プロジェクトをフィルターフィルターするプロジェクトを選択

4

Applyをクリックします。


ルックアップ テーブルコネクターの使用

ルックアップ テーブル by Workatoコネクターでは、次のレシピアクションを使用してルックアップ テーブルを操作できます:

Add entryアクション

Add entryアクションは、既存のルックアップ テーブルに新しいエントリを追加します。

入力

フィールド説明
ルックアップ テーブルエントリを作成するルックアップ テーブルを選択します。
エントリフィールドこのフィールドには、ルックアップ テーブルの各列に対応するサブフィールドが含まれています。 新しいエントリの内容を各列に入力します。

出力

出力説明
エントリID新しいエントリのID。
エントリこのオブジェクトには、新しいエントリの内容を指定するルックアップ テーブルの各列の文字列が含まれています。

Add entriesアクション(バッチ)

Add entriesアクションは、新しいエントリをバッチでルックアップ テーブルに追加します。

入力

フィールド説明
ルックアップ テーブル新しいエントリを作成するルックアップ テーブルを選択します。
エントリソースリストエントリの作成元にするリストデータピルを指定します。
エントリフィールドこのフィールドには、ルックアップ テーブルの各列に対応するサブフィールドが含まれています。 新しいエントリ行の各列に使用するリスト内のデータピルを指定します。

出力

出力説明
件数ルックアップ テーブルに追加された新しいエントリの数。

Lookup entryアクション

Lookup entryアクションは、列の値でルックアップ テーブルのエントリを検索し、検索条件に一致する最初のエントリを返します。

Workatoがエントリを見つけられない場合、レシピはUnable to find an entry matching search parametersエラーを返します。

検索条件に一致するエントリが1つだけであると想定される場合は、Lookup entryアクションを使用します。 一致するエントリのリストを取得する、または特定の値がルックアップ テーブルに存在するかを確認するには、代わりにエントリの検索アクションを使用します。

入力

フィールド説明
ルックアップ テーブルエントリをルックアップするルックアップ テーブルを選択します。
検索基準このフィールドには、ルックアップ テーブルの各列に対応するサブフィールドが含まれています。 各列で検索する条件を指定します。

複数条件による検索

1回の操作で複数の条件により列を検索するには、Search byフィールドをFormulaモードに切り替え、JSON形式で文字列の配列を入力します。 この操作は、いずれかの文字列に一致する最初のエントリを返します。

出力

出力説明
エントリID見つかったエントリのID。
エントリこのオブジェクトには、見つかったエントリの内容を指定するルックアップ テーブルの各列の文字列が含まれています。

Search entriesアクション(バッチ)

Search entriesアクションは、列の値でルックアップ テーブルのエントリを検索し、検索条件に一致するすべてのエントリのリストを返します。

ルックアップ テーブルから複数のエントリが返されると想定される場合、または特定の値がルックアップ テーブルに存在するかどうかを確認する必要がある場合は、Search entriesアクションを使用します。

入力

フィールド説明
ルックアップ テーブルエントリを検索するルックアップ テーブルを選択します。
検索基準このフィールドには、ルックアップ テーブルの各列に対応するサブフィールドが含まれています。 各列で検索する条件を指定します。

複数条件による検索

1回の操作で複数の条件により列を検索するには、Search byフィールドをFormulaモードに切り替え、JSON形式で文字列の配列を入力します。 この操作は、いずれかの文字列に一致するエントリのリストを返します。

出力

出力説明
エントリID見つかったエントリのID。
エントリこのオブジェクトには、見つかったエントリの内容を指定するルックアップ テーブルの各列の文字列が含まれています。
リストサイズ見つかったエントリの数。

Get all entriesアクション(バッチ)

Get all entriesアクションは、ルックアップ テーブルからすべてのエントリを返します。

制限事項

Get all entriesアクションは、最大10,000件のエントリを返します。

入力

フィールド説明
ルックアップ テーブルすべてのエントリを返すルックアップ テーブルを選択します。

出力

出力説明
エントリIDルックアップ テーブルから返されたエントリのID。
エントリこのオブジェクトには、返されたエントリの内容を指定するルックアップ テーブルの各列の文字列が含まれています。
リストサイズルックアップ テーブルから返されたエントリの数。

Update entryアクション

Update entryアクションは、既存のエントリの内容を更新します。

入力

フィールド説明
ルックアップ テーブルエントリを更新するルックアップ テーブルを選択します。
エントリID更新するエントリのIDを指定します。
見つからない場合は無視指定されたIDのエントリが見つからない場合に、エラーでジョブを停止するかどうかを選択します。
エントリフィールドこのフィールドには、ルックアップ テーブルの各列に対応するサブフィールドが含まれています。 エントリの内容を各列に入力します。

出力

出力説明
エントリID更新されたエントリのID。
エントリこのオブジェクトには、更新されたエントリの内容を指定するルックアップ テーブルの各列の文字列が含まれています。

Delete entryアクション

Delete entryアクションは、ルックアップ テーブルから単一のエントリを削除します。

入力

フィールド説明
ルックアップ テーブルエントリを削除するルックアップ テーブルを選択します。
エントリID削除するエントリのIDを指定します。
見つからない場合は無視指定されたIDのエントリが見つからない場合に、エラーでジョブを停止するかどうかを選択します。

出力

出力説明
削除されたエントリID削除されたエントリのID。

Delete multiple entriesアクション(バッチ)

Delete multiple entriesアクションは、ルックアップ テーブルから複数のエントリを削除します。

入力

フィールド説明
ルックアップ テーブル複数のエントリを削除するルックアップ テーブルを選択します。
削除オプションIDまたは検索条件のどちらでエントリを削除するかを選択します。
エントリIDのリストソースリスト削除するエントリのEntry IDを含むリストデータピルを指定します。
エントリID削除するエントリのEntry IDを含むリスト内のデータピルを指定します。
エントリを削除このフィールドには、ルックアップ テーブルの各列に対応するサブフィールドが含まれています。 各列でエントリを削除する条件を指定します。

出力

出力説明
件数ルックアップ テーブルから削除されたエントリの数。

Truncate tableアクション

Truncate tableアクションは、ルックアップ テーブルのすべてのエントリを完全に削除します。

データ削除は永続的です

データの削除は、そのアクションがテストジョブ中に実行された場合でも、元に戻せません

入力

フィールド説明
ルックアップ テーブルすべてのエントリを削除するルックアップ テーブルを選択します。

出力

出力説明
件数ルックアップ テーブルから削除されたエントリの数。

Formulaを使用したエントリのルックアップ

lookup()Formulaを使用して、入力フィールド内でLookup entryアクションを実行できます。

次のテンプレートは、Formulaの使用方法を示しています。

ruby
lookup("TABLE_NAME", "REFERENCE_COLUMN": datapill)["LOOKUP_COLUMN"]

このテンプレートでは、次のようになります。

  • TABLE_NAMEは、エントリをルックアップするルックアップ テーブルの名前です。
  • REFERENCE_COLUMNは、一致する値を検索する列の名前です。
  • datapillは、FormulaがREFERENCE_COLUMNで検索する値です。
  • LOOKUP_COLUMNは、一致するエントリの行から値を返す列の名前です。

インメモリルックアップ テーブル

TABLE_NAMEの代わりに、Search entriesなどのアクションの出力を含むEntriesオブジェクトを使用して、インメモリルックアップ テーブルを作成します。 インメモリテーブルはエントリをより迅速に検索し、最初のアクションで取得された絞り込み済みのエントリリストのみを検索します。 これは、レシピが同じルックアップ テーブルに対してlookup関数を数千回呼び出す必要がある場合に、時間の節約に役立ちます。

次の例では、Account IDsテーブルを使用します。 指定されたSalesforce account IDに一致する最初のエントリのIntacct account IDをルックアップします。

ruby
lookup("Account IDs", "Salesforce account ID": datapill)["Intacct account ID"]

複数の列を検索するには、追加の参照列を括弧内に入力し、カンマで区切ります。

ruby
lookup("TABLE_NAME", "REFERENCE_COLUMN": datapill, "REFERENCE_COLUMN_2": datapill2)["LOOKUP_COLUMN"]

Last updated: