お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の
英語版を参照してください。
ルックアップ
ルックアップは、項目、テーブル、Webhook APIレスポンス、データベースクエリーのレスポンスで利用可能な値から、一部の選択肢を取得するための項目です。組織内の既存データは、ルックアップを使用して再利用できます。通常、ルックアップは複数の選択肢を返し、それらはドロップダウンまたは複数選択項目を使用してエンドユーザーに表示されます。
ルックアップを使用すると、組織はすべてのタブでデータの一貫性を維持できます。ルックアップはすでに利用可能なデータを再利用するため、組織内のデータの関連付けや管理が容易になります。
ルックアップのメリット
- さまざまなタブのデータを集約して再利用
- 利用可能なデータの一貫性を維持
- 値を動的に入力
- データ入力の改善
- ストレージ容量の削減
Qntrlでのルックアップの種類
Qntrlでは現在、4種類のルックアップをサポートしています。
- 項目ルックアップ
- APIルックアップ
- テーブルルックアップ
- データベースルックアップ
項目ルックアップは、フォーム内の異なるカードにある特定の項目の値を集約し、集約したデータをドロップダウンまたは複数選択項目に入力します。
APIルックアップは、Webhookレスポンスを生成し、データパスを使用してレスポンスを絞り込みます。取得された結果データは、ドロップダウンまたは複数選択項目に表示されます。
テーブルルックアップは、選択したテーブルから列全体のデータを取得し、そのデータをドロップダウンまたは複数選択項目に入力します。
データベースルックアップは、リモートデータベースからデータを取得し、Qntrlに一覧表示します。
1つの組織につき、ルックアップと関連項目は合計5件まで使用できます。
項目ルックアップ
項目ルックアップを使用すると、フォーム内の異なるカードにある項目値を、ドロップダウンまたは複数選択項目に入力できます。たとえば、新しい従業員が入社するたびに、従業員オンボーディングフォームにカードが作成され、氏名、役職、経験などの従業員詳細データが記録されます。異なるカードで利用可能なこのような値は、項目ルックアップを使用して集約し、共通のドロップダウンまたは複数選択項目として一覧表示できます。
- [ボード]に移動し、左パネルで任意のボードにカーソルを合わせて
をクリックし、[ボードの管理]を選択します。(または)
に移動して、ボードを選択します。詳細はこちら。
- [ステップ1:フォームの作成]が表示されます。
- [新しい項目]トレイから[項目ルックアップ]を右パネルにドラッグ&ドロップします。
- [項目名]を入力します。この項目は必須です。
- 項目に関する追加情報を表示するには、[情報の追加]チェックボックスをクリックし、表示されたボックスにテキストを入力します。情報はツールチップとして表示されます。[プレビュー]をクリックすると、フォームでの情報の表示を確認できます。
-
ルックアップの詳細を設定します。
- [ボード]:項目を一覧表示するボードを選択します。
- [項目]:ルックアップ値の取得元となる項目を選択します。
- メモ:選択した項目の値は、必要な権限がないユーザーにも表示されます。
- [表示形式]:ルックアップ値をドロップダウンまたは複数選択項目の形式で表示できます。
- 項目レベルの検証を設定します。
- [必須]:[はい]に切り替えると、この項目を必須にできます。
- [表示設定]:[はい]に切り替えると、カード作成時にこの項目を表示できます。
-
項目ルックアップ、APIルックアップ、関連項目は最大10件まで作成できます。
-
項目ルックアップの選択肢は、異なる項目値を持つ新しいカードが作成されるたびに更新されます。
-
項目ルックアップにリンクされている項目に値がない場合、ルックアップの選択肢は空で表示されます。
-
項目ルックアップのプロパティでフォームまたは項目を変更しても、既存のカードですでに選択されている項目ルックアップの値は変更されません。ただし、新しく入力されたルックアップ値を使用して手動で変更できます。
-
単一行、ドロップダウン、ユーザードロップダウン、日時、小数、整数、メールアドレスの項目のみ、項目ルックアップに設定できます。
APIルックアップ
APIルックアップを使用すると、大量のAPIレスポンスデータの中から特定の情報を検索できます。APIルックアップでは、既存のWebhookを実行し、任意の形式(JSON/XML/テキスト)でレスポンスデータを取得して、データパスでレスポンスを絞り込み、必要な結果データのみを取得できます。
たとえば、サードパーティのWebサイトからリアルタイムの天気情報を取得するWebhookを設定している場合、APIレスポンスデータには、日付、時刻、場所、摂氏の気温、華氏の気温など、多くのパラメーターが含まれます。これらすべての詳細の中から、1つの詳細情報(たとえば摂氏の気温)のみを取得したい場合は、データパスを使用して絞り込み、APIルックアップを使用してエンドユーザー向けのドロップダウンまたは複数選択項目として一覧表示できます。
- [ボード]に移動し、左パネルで任意のボードにカーソルを合わせて
をクリックし、[ボードの管理]を選択します。(または)
に移動して、ボードを選択します。詳細はこちら。
- [ステップ1:フォームの作成]が表示されます。
- [新しい項目]トレイから[APIルックアップ]を右パネルにドラッグ&ドロップします。
- [項目名]を入力します。この項目は必須であり、各フォーム内で一意である必要があります。
- 項目に関する追加情報を表示するには、[情報の追加]チェックボックスをクリックし、表示されたボックスにテキストを入力します。情報はツールチップとして表示されます。[プレビュー]をクリックすると、フォームでの情報の表示を確認できます。
- ルックアップの詳細を設定します。
- [Webhook]:既存のWebhookをドロップダウンから選択します。
- [レスポンスデータ形式]:利用可能な選択肢(JSON、XML、テキスト)からレスポンス形式を選択し、[適用]をクリックします。
- [データパス]:レスポンスを絞り込むデータパスを入力し、[確認]をクリックします。これはJSONおよびXMLのレスポンス形式にのみ適用されます。入力するデータパスの詳細をご確認ください。
- [結果データ]:データパスを確認すると、この項目には絞り込まれたデータが自動入力されます。ドロップダウンから結果データを選択します。
- [表示形式]:ルックアップ値をドロップダウンまたは複数選択項目の形式で表示できます。
- ドロップダウンを選択した場合、各選択肢は200文字までに切り詰めて表示されます。
- 項目レベルの検証を設定します。
- [必須]:[はい]に切り替えると、この項目を必須にできます。
- [表示設定]:[はい]に切り替えると、カード作成時にこの項目を表示できます。
- [OK]をクリックします。
- 項目ルックアップ、APIルックアップ、関連項目は10件までしか作成できません。
- APIルックアップに関連付けられているWebhookが削除または無効化されると、ルックアップには値が表示されません。
Webhookから取得したレスポンスがJSONまたはXML形式の場合、取得したレスポンスデータを絞り込むにはデータパスを含める必要があります。データパスにより、結果のドロップダウン内で類似する値を識別し、グループ化できます。
一般的なデータパスの形式
JSONレスポンスの場合:$.<JSONArrayName>[].<JSONObejctName>.key
XMLレスポンスの場合:/RootElement/Element/@Attribute/Type
例
サンプルレスポンスと対応するデータパスを以下にまとめました。
JSONレスポンス1
{
'id': 1,
'name': 'Leanne Graham',
'username': 'Bret',
'address': {
'city': 'Gwenborough'
},
'phone': '1-770-736-8031',
'Webサイト': 'hildegard.org'
}
データパス
こちらの'$'はレスポンス全体(ルート)を表します。
名前を取得するには、$.nameを使用します。
結果データ:Leanne Graham
市区町村を取得するには、$.address.cityを使用します。
結果データ:Gwenborough
住所を取得するには、$.addressを使用します(文字列を返します)。
結果データ:{ 'city' : 'Gwenborough' }
JSONレスポンス2
[
{
'userId': 1,
'name': 'Leanne',
'title': 'quidem molestiae enim'
},
{
'userId': 2,
'name': 'Ervin',
'title': 'sunt qui excepturi placeat culpa'
},
{
'userId': 3,
'name': 'Clementine',
'title': 'omnis laborum odio'
},
{
'userId': 4,
'name': 'Patricia',
'title': 'eaque aut omnis a'
}
]
データパス
こちらの'$[*]'はレスポンス全体(ルート)を表し、インデックスは0から始まります。
すべての名前を取得するには、$[*].nameを使用します。
結果データ:[Leanne , Ervin , Clementine, Patricia]
2番目の名前を取得するには、$[1].nameを使用します。
結果データ:Ervin
最初の3人のユーザーを取得するには、$[0-2].nameまたは$[-2].nameを使用します。
結果データ:[Leanne , Ervin , Clementine]
最後の3人のユーザーを取得するには、$[1-].nameを使用します。
結果データ:[Ervin , Clementine, Patricia]
XMLレスポンス
<?xml version='1.0' encoding='UTF-8' standalone='yes'?>
<employees>
<employee id='1'>
<firstName>Lokesh</firstName>
<lastName>Gupta</lastName>
<department>
<id>101</id>
<name>IT</name>
</department>
</employee>
<employee id='2'>
<firstName>Brian</firstName>
<lastName>Schultz</lastName>
<department>
<id>102</id>
<name>HR</name>
</department>
</employee>
<employee id='3'>
<firstName>Alex</firstName>
<lastName>Kolenchisky</lastName>
<department>
<id>103</id>
<name>FINANCE</name>
</department>
</employee>
<employee id='4'>
<firstName>Amit</firstName>
<lastName>Jain</lastName>
<department>
<id>104</id>
<name>HR</name>
</department>
</employee>
<employee id='5'>
<firstName>David</firstName>
<lastName>Beckham</lastName>
<department>
<id>105</id>
<name>DEVOPS</name>
</department>
</employee>
</employees>
データパス
すべての従業員名を取得するには、/employees/employee/firstName/text()を使用します。
結果データ:[Lokesh, Brian, Alex, Amit, David]
すべての従業員IDを取得するには、/employees/employee/@idを使用します。
結果データ:[1,2,3,4,5]
トラブルシューティング手順
- [適用]をクリックして、Webhookレスポンスを生成できるか確認します。
- [確認]をクリックして、データパスに結果データが表示されるか確認します。
- データパスがレスポンスデータとその形式に対応しているか確認します。
テーブルルックアップ
Qntrlのテーブルでは、データを見やすい表形式で保存、整理できます。テーブルルックアップは、テーブルの列からデータを取得し、エンドユーザー向けのドロップダウンまたは複数選択項目に表示します。
たとえば、従業員の詳細を保存するテーブルがある場合、各列には従業員ID、従業員名、年齢、給与などの情報が含まれます。すべての従業員名の一覧を取得するには、テーブルルックアップを使用して列全体の詳細を取得できます。
- [ボード]に移動し、左側のパネルで任意のボードにカーソルを合わせ、
をクリックして[ボードの管理]を選択します。(または)
からボードを選択します。 詳細はこちら。
- ステップ1:フォームの作成が表示されます。
-
[新しい項目]トレイから右側のパネルに[テーブルルックアップ]をドラッグ&ドロップします。
-
[項目名]を入力します。この項目は必須で、各フォーム内で一意である必要があります。
-
項目に関する追加情報を表示するには、[情報の追加]チェックボックスをクリックし、表示されるボックスにテキストを入力します。情報はツールチップとして表示されます。[プレビュー]で、フォームでの情報の表示方法を確認できます。
-
ルックアップの詳細を設定します。
-
[テーブル]:データをルックアップするテーブルを選択します。
-
[列]:テーブルから列を選択します。
-
[表示形式]:ルックアップ値は、ドロップダウンまたは複数選択項目の形式で表示できます。
-
ドロップダウンを選択した場合、各選択肢は最大200文字で表示されます。
-
項目レベルの検証を設定します。
-
[必須]:項目を必須にするには、[はい]に切り替えます。
-
[表示設定]:カードの作成時に項目を表示するには、[はい]に切り替えます。
メモ。
- 作成できるルックアップ項目と関連項目は最大5件です。
- ルックアップに関連付けられているテーブルが削除されると、ルックアップには値が表示されません。
DBルックアップ
DBルックアップを使用すると、組織はリモートデータベースからデータを取得し、Qntrlに一覧表示できます。DBルックアップでは、ブリッジとコネクターを使用して外部データベースとの安全な接続を確立し、クエリーを実行して応答を取得します。
DBルックアップは、外部データベースの読み取りにのみ使用できます。更新や削除などの操作は許可されません。これにより、顧客の外部データベースの安全性と整合性が常に保たれます。
たとえば、顧客がすべての仕入先の詳細を保存するためにリモートデータベースを管理しているとします。データを再度複製せずに、このデータをQntrlに入力したい場合は、DBルックアップを使用できます。DBルックアップは顧客のデータベースに接続し、データベースにクエリーを実行して、その応答をQntrlのドロップダウンまたは複数選択項目に一覧表示します。
- [ボード]に移動し、左側のパネルで任意のボードにカーソルを合わせ、
をクリックして[ボードの管理]を選択します。(または)
からボードを選択します。詳細はこちら。
- ステップ1:フォームの作成が表示されます。
- [新しい項目]トレイから右側のパネルに[DBルックアップ]をドラッグ&ドロップします。
- [項目名]を入力します。この項目は必須で、各フォーム内で一意である必要があります。
- 項目に関する追加情報を表示するには、[情報の追加]チェックボックスをクリックし、表示されるボックスにテキストを入力します。情報はツールチップとして表示されます。[プレビュー]で、フォームでの情報の表示方法を確認できます。
- ルックアップの詳細を設定します。
- [コネクター]:データベース用に既存のコネクターを選択するか、新しく作成します。
- [ブリッジ]:既存のブリッジを選択するか、新しく作成します。
- [ブリッジ/クラスター]:ドロップダウンからブリッジまたは負荷分散用のクラスターを選択します。
- [表示形式]:ルックアップ値は、ドロップダウンまたは複数選択項目の形式で表示できます。
- ドロップダウンを選択した場合、各選択肢は最大200文字で表示されます。
- [データベースクエリー]:データベースにクエリーを実行するコマンドを入力します。
- クエリーで上限が指定されていない場合、20件の結果のみ表示されます。
- 項目レベルの検証を設定します。
- [必須]:項目を必須にするには、[はい]に切り替えます。
- [表示設定]:カードの作成時に項目を表示するには、[はい]に切り替えます。
データベースクエリーで上限が指定されていない場合、DBルックアップには一度に20件の結果のみ表示されます。
関連項目
関連項目を使用すると、Qntrlで同じボードまたは異なるボードのカード間に関連付けを作成できます。
異なるブループリントのカードをリンクする場合、関係は次のいずれかになります。
- 依存カード - 1つのワークフローが別のワークフローにつながり、プロセスを完了します。
- リンクされたカード - 1つのワークフローから別のワークフローに情報を取り込み、カードをより有用にします。
- 親子カード - メインのワークフローをサブフローに分割し、プロセスを完了するためにこれらのサブフローがメインのワークフローに戻ります。
新しい関連項目を作成するには、
- [ボード]に移動し、左パネルで任意のボードにカーソルを合わせ、
をクリックして[ボードの管理]を選択します。(または)
に移動してボードを選択します。詳細はこちら。
- ステップ1:フォームの作成が表示されます。
- [新しい項目]トレイから[関連項目]を右パネルにドラッグ&ドロップします。
- [項目タイトル]を入力します。この項目は必須で、各フォーム内で一意である必要があります。
項目に関する追加情報を表示するには、[情報の追加]のチェックボックスをクリックし、表示されるボックスにテキストを入力します。情報はツールチップとして表示されます。フォームでの情報の表示方法を[プレビュー]できます。
- 関連の詳細を設定します。
- [フォーム]:カードを一覧表示するフォームを選択します。
- [関連タイトル]:関連のタイトルを入力します。
- [表示形式]:カードをドロップダウンまたは複数選択項目の形式で表示できます。
- 項目レベルの検証を設定します。
- [必須]:項目を必須にするには、[YES]に切り替えます。
- [表示設定]:カードの作成時に項目を表示するには、[YES]に切り替えます。
上記で使用したボードで新しいカードを作成します。関連を設定するには、関連項目でカードを選択します。
次に、選択したカードを開き、関連カードの表を表示します。カードの詳細ページで、関連項目内のカード名をクリックして、関連カードに移動することもできます。
-
項目ルックアップ、APIルックアップ、関連項目は最大10件まで作成できます。
-
関連項目を使用して関連付けられたカードは、関連カードに表示されます。
-
フォームを削除すると、他のフォームとの関連項目の対応付けも削除されます。
-
関連項目は、Qntrlのモバイルアプリではまだサポートされていません。
関連項目を使用して関連付けられたカードは、関連カードに表示されます。
メモ項目
フォームに読み取り専用のメモを表示し、ユーザーがフォームに入力する際の手順やメッセージの一部を提示できます。メモには、書式なしテキストまたは書式ありテキストを追加でき、書式、リンク、HTMLコードも使用できます。
- [ボード]に移動し、左パネルで任意のボードにカーソルを合わせ、
をクリックして[ボードの管理]を選択します。(または)
に移動してボードを選択します。詳細はこちら。
- ステップ1:フォームの作成が表示されます。
- [新しい項目]トレイから[メモ]項目を右パネルにドラッグ&ドロップします。
- [項目タイトル]を入力します。この項目は必須で、各フォーム内で一意である必要があります。
- カードでメモと一緒に項目タイトルを表示するには、チェックボックスをオンにします。
- テキストボックスにメモを入力します。最大10,000文字まで入力できます。
- 項目レベルの検証を設定します。
- [表示設定]:カードの作成時にユーザーに項目を表示しないようにするには、[No]に切り替えます。
Smart Parse
ファイルやドキュメントは、組織がデータを整理し、連絡先を作成し、請求書を生成し、社内ポリシーを従業員に共有するうえで重要な役割を果たします。これらのファイル、シート、請求書には、抽出してワークフローで使用できる有用な情報が含まれている場合があります。
Smart Parseでは、ファイルからフォーム項目にデータを直接抽出し、手動操作なしで重要な情報をワークフローに取り込めます。Smart ParseはAI抽出技術を使用して、ファイル内のデータを動的に解析して項目に取り込みます。ファイルから抽出するデータの参照情報を指定し、配置先の正確な項目を選択できます。
Smart Parseの使用例
- 請求書から詳細情報を取得し、経費精算カードに自動入力する。
- カバーレターから応募者の詳細情報を抽出し、採用カードに入力する。
- 経費表から支出を特定し、詳細を監査カードに入力する。
- 1つのボードで作成できるSmart Parse項目は5件までです。
- Smart Parseでサポートされる項目の種類は、1行、複数行、メール、整数、小数、日付、日時、電話番号、通貨、チェックボックス、ドロップダウン、ユーザードロップダウン、複数選択、複数ユーザー、リンク、ラジオボタン、明細です。
- ファイルから対応付けるデータが、適切な項目の種類と一致していることを確認してください。たとえば、整数項目にはファイル内の整数値のみを対応付けることができ、ドロップダウン項目にはファイル内の複数の値をリストとして対応付ける必要があります。
- [ボード]に移動し、左パネルで特定のボードにカーソルを合わせ、[...]をクリックして[ボードの管理]を選択します。(または)
- [設定]に移動してボードを選択します。詳細はこちら
- [ステップ1:フォームの作成]画面が表示されます。
- [新しい項目]トレイからSmart Parse項目を右パネルにドラッグ&ドロップします。
- [項目のタイトル]を入力します。この項目は必須で、各フォーム内で一意である必要があります。
- 項目に関する追加情報を表示するには、[情報の追加]チェックボックスを選択し、表示されるボックスにテキストを入力します。情報はツールチップとして表示されます。[プレビュー]で、フォームでの情報の表示を確認できます。

- [マッピングの追加]をクリックして、ファイルから抽出する項目を設定します。
- 左パネルに一覧表示されている対応しているフォーム項目を選択します。
- ファイルからデータを正確に取得できるように、各項目にマッピング詳細を入力します。たとえば、経費表の「四半期の支出」列に支出詳細が記載されている場合、その項目にマッピングする参照名として「四半期の支出」を入力します。
- 項目レベルの検証を設定します。
- [必須]:[YES]に切り替えると、項目を必須にできます。
- [表示設定]:[YES]に切り替えると、カード作成時に項目を表示できます。
項目をフォームに追加したら、[保存して次へ]をクリックします。続けてブループリントを設計し、ボードを公開します。
ブループリントへのSmart Parse項目の追加
Smart Parse項目は、遷移の実行中セクションの一部として追加できます。
- ボードで[ステップ2:ブループリントの設計]に移動します。
- Smart Parse項目を設定する遷移を選択します。
- 遷移の[実行中]セクションに移動し、[+項目と明細項目]をクリックします。
- Smart Parseにマッピングする既存の項目を関連付けるか、新しい項目を作成します。
- [新規]をクリックして新しいSmart Parse項目を作成するか、ドロップダウンから既存のSmart Parse項目を関連付けます。
- [項目のタイトル]を入力します。この項目は必須で、各フォーム内で一意である必要があります。
- 項目に関する追加情報を表示するには、[情報の追加]チェックボックスを選択し、表示されるボックスにテキストを入力します。情報はツールチップとして表示されます。[プレビュー]で、フォームでの情報の表示を確認できます。

- [マッピングの追加]をクリックして、ファイルから抽出する項目を設定します。
- この遷移に関連付けられている他の項目がこちらに表示されます。この遷移に項目がない場合は、項目を作成できます。
- 左パネルに一覧表示されている対応しているフォーム項目を選択します。
- ファイルからデータを正確に取得できるように、各項目にマッピング詳細を入力します。
- 項目レベルの検証を設定します。
- [必須]:[YES]に切り替えると、項目を必須にできます。
- [OK]をクリックします。
- ブループリントを[保存して検証]します。
- ボードを[公開]します。
Smart Parse項目が遷移に追加され、カードで遷移が実行されるとポップアップ表示されます。
カードのSmart Parse項目へのファイルの追加
公開済みのボードに追加されたSmart Parse項目は、新しいカードの作成時、既存カードの更新時、またはカードで遷移を実行したときに表示されます。
対応しているファイル形式:
ドキュメント:.doc, .docx, .pdf, .pptx, .xlsx, .odt, .msg
テキストとマークアップ:.txt, .md, .html, .htm
画像:.jpg, .jpeg, .png, .bmp, .gif, .tiff, .webp
新しいカードでのSmart Parse項目へのファイルの追加。
- ボードに移動し、[新しいカード]をクリックします。
- Smart Parse項目で[ファイルをアップロード]をクリックします。
- ファイルをドラッグ&ドロップするか、コンピューターを参照してファイルを選択します。
- ファイルを選択したら、[Smart Parse]をクリックします。
- 続けてその他のカード詳細を入力し、[保存]をクリックします。
ファイルが正常に解析されると、成功メッセージが表示されます。ファイルから解析された値は、カード項目に自動入力されます。ユーザーは項目値を確認してカードに保存できます。
既存カードでのSmart Parse項目へのファイルの追加。
- ボードに移動し、既存のカードを選択します。
- Smart Parse項目で[編集]ボタンをクリックします。
- ファイルをドラッグ&ドロップするか、コンピューターを参照してファイルを選択します。
- ファイルを選択したら、[Smart Parse]をクリックします。
ファイルが正常に解析されると、成功メッセージが表示されます。ファイルから解析された値は、カード項目に自動入力されます。
遷移中のSmart Parse項目へのファイルの追加。
- ボードに移動し、カードを選択します。
- Smart Parse項目に関連付けられている遷移を実行します。
- Smart Parse項目で[ファイルをアップロード]をクリックします。
- ファイルをドラッグ&ドロップするか、コンピューターを参照してファイルを選択します。
- ファイルを選択したら、[Smart Parse]をクリックします。
- ファイルが正常に解析されると、成功メッセージが表示されます。
- ファイルから解析された値は、カード項目に自動入力されます。
- [保存]をクリックします。