追加コンポーネントの設定

追加コンポーネントの設定

お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。
早期アクセス
Qntrl StudioのCircuitテンプレートは、すべてのユーザーには有効になっていません。お試しになりたい場合は、早期アクセスについてサポートチームにメールでお問い合わせください。

Webhook

Webhookを使用すると、ビジネス要件に基づいて、組織内でユーザーが事前定義された操作を実行した際に、サードパーティアプリケーションへ自動HTTP通知を送信できます。

Webhookの作成

新しいWebhookを作成するには、以下の手順を実行します。
  1. 左ペインの［Webhook］をクリックし、［新しいWebhook］をクリックします。
  2. 次の詳細を入力します。
    1. ［種類］：スタンドアロン（Circuitでサポートされている唯一の種類）を選択します。
    2. ［名前］：Webhookの名前を入力します。
    3. ［URL］：サードパーティまたはZohoアプリケーションのAPI URLを指定します。
    4. ［メソッド］：APIメソッドの種類（POST／GET）を選択します。初期設定はPOSTです。
    5. ［プレビュー］：サードパーティアプリケーションに送信される完全なWebhook URLを確認します（編集不可）。
    6. ［カスタムパラメーターの追加］：
      1. Webhookのパラメーター名と対応する値を指定します。
      2. このキー／値のペアは、主に認証トークン、APIキー、セキュリティトークンなどの送信に使用します。
    • ［カスタムヘッダー］：
      • Webhookのヘッダー名と対応する値を指定します。
      • Cookie、User-Agent、Referrerなどの送信に使用できます。
  1. ［保存］をクリックします。

作成したWebhookは、関連コンポーネント（Webhookセクション内）に表示されます。


詳細な設定手順については、QntrlのWebhookヘルプページをご参照ください。

Notes
Circuitテンプレートをインポートする際は、関連付けられているWebhookのみがインポートされます。

Webhookの編集

Webhookを編集するには、以下の手順を実行します。
  1. 左ペインの［Webhook］セクションをクリックします。
  2. 一覧から、編集するWebhookの名前をクリックします。
  3. 変更を行い、［保存］をクリックします。

Webhookの削除

Webhookを削除するには、以下の手順を実行します。
  1. 左ペインの［Webhook］セクションをクリックします。
  2. Webhook名にカーソルを合わせ、［操作］メニューをクリックし、［削除］を選択します。
  3. 確認画面で、削除操作を確認します。


関数

関数を使用すると、ユーザーは一連の処理を定義して実行でき、プロセスの自動化やZohoおよびサードパーティアプリケーションとの連携が可能になります。詳細はこちらから、Qntrlの関数についてご確認ください。

関数の作成

  1. 新しい関数の作成：

    • 左ペインの［関数］セクションをクリックし、［関数を追加］をクリックします。

    • 関数の詳細を入力します。

      • ［名前］：関数の名前を入力します。

      • ［言語］：必要なプログラミング言語をドロップダウンから選択します。初期設定では「Zoho Deluge」が選択されています。

      • ［説明］：関数の目的について簡単な説明を入力します。

    • 続行するには、［保存］をクリックします。

  1. 関数スクリプトの作成
    • 選択した言語に対応するクラウドIDEまたはエディターが開き、関数スクリプトを作成できます。
    • 関数の作成についての詳細は、こちらをご覧ください。
  2. 関数のテストとデプロイ
    • サンプル入力で関数をテストするには、［保存して実行］をクリックします。
    • 関数をCircuitに組み込めるようにするには、［デプロイ］をクリックします。



  • デプロイ後、関数は関連コンポーネントセクション（［関数］タブ内）に表示されます。

Notes

  • 関数は、Circuitで使用する前にデプロイする必要があります。

  • Circuitテンプレートのインポート時には、関連付けられている関数のみがインポートされます。

 

既存の関数の管理   

  1. 左側のペインで［関数］をクリックします。

  2. 関数名にカーソルを合わせ、アクションメニューをクリックします。

  3. 次のオプションから選択します。

    1. ［編集］：関数コードを変更し、再デプロイします。Circuitでは、デプロイ済みのバージョンのみが実行されます。

    2. ［プレビュー］：変更せずに関数スクリプトを表示します。

    3. ［削除］：関数を削除します。


接続

接続を使用すると、Qntrlと外部サービスを連携できます。事前設定済みサービスとカスタムサービスの両方に対して接続を作成できます。接続の詳細はこちら。

接続の作成   

  1. 左側のペインの［接続］セクションに移動します。

  2. ［接続を作成］ボタンをクリックします。

  3. サービスを選択します。

    1. ［デフォルトサービス］：提供されているよく使うサービスから選択します。

    2. ［カスタムサービス］：カスタムサービスのオプションを選択して、独自のサービスを作成します。

デフォルトサービスとの接続

よく使うオプションの一覧から、事前設定済みサービスを選択します。

  1. ［デフォルトサービス］タブで、外部サービスまたはZohoの内部サービスを選択します。

  2. 次のセクションで、必要なサービス情報を入力し、［作成して接続］をクリックします。

  1. 接続を認証するため、サービスページにリダイレクトされます。



  1. 認証が完了すると、サービスを使用できるようになります。



カスタムサービスとの接続

提供されている事前設定済みサービスに加えて、カスタム接続を作成することで、他の外部サービスにも接続できます。

  1. ［カスタムサービス］タブに移動し、［サービスを作成］をクリックします。

  2. 新しいサービスを設定するために必要な接続情報と認証情報を入力します。

  3. ［サービスを作成］をクリックします。

認証が完了すると、サービスを使用できるようになります。


カスタムサービスとの接続に関する詳細は、こちらをご覧ください。


接続の編集／削除 

対象の接続にカーソルを合わせると、既存の接続を編集または削除できます。

  • 編集するには：編集アイコンをクリックし、必要な変更を行ってから、［更新］をクリックします。

  • 削除するには：削除アイコンをクリックし、接続を削除する操作を確認します。


接続の取り消し  

連携を停止するには、関連付けられている接続を取り消します。

  1. 左ペインで［自分の接続］をクリックします。

  2. 取り消す接続にカーソルを合わせます。

  3. ［取り消し］オプションを選択します。

Notes接続を取り消すと認可は解除されますが、接続データは削除されません。サービスは引き続き［接続］ページに表示されます。接続はいつでも再設定できます。


テーブル 

テーブルは、Qntrlで参照データを構造化形式で保存し、テーブル検索を使用してカードに関連データを表示できます。

テーブルの作成   

  1. 左ペインの［テーブル］セクションに移動し、［テーブルを作成］をクリックします。
  2. テーブル構造を定義します。
    1. ［テーブル名］：テーブルを表す名前を入力します。
    2. ［説明］：テーブルの目的について簡単な説明を追加します。
    3. 列：
      1. ［列名］：列の名前を入力します。
      2. ［項目の種類］：ドロップダウンメニューから項目の種類を選択します。サポートされている項目の種類は、1行テキスト、複数行テキスト、日時、小数、数値、メールアドレス、リンクです。
      3. 列の追加または削除：列の横にある+または-アイコンをクリックして、列を追加または削除します。
      4. 列の設定：設定アイコンをクリックし、列の設定（必須、初期値、最小値／最大値）を行います。
  1. テーブルを作成するには、［保存］をクリックします。作成後、データを手動で入力するか、テーブルにインポートできます。

テーブルの作成と管理の詳細については、テーブルのヘルプページを参照してください。





テーブルの編集／削除 

既存のテーブルは変更または削除できます。
  • 編集するには：テーブルにカーソルを合わせ、編集アイコンをクリックします。変更を行い、［更新］をクリックします。
  • 削除するには：テーブルにカーソルを合わせ、削除アイコンをクリックします。操作を確認します。


スケジュール 

Qntrlのスケジュール機能では、設定した間隔でカスタム関数を実行できます。更新の自動化、週次アラートの送信、月次レポートの生成に適しています。

スケジュールの作成   

  1. 左ペインの［スケジュール］セクションに移動し、［新しいスケジュール］ボタンをクリックします。
  2. スケジュールの詳細を定義します。
    1. ［名前］：スケジュールに適した名前を入力します。
    2. ［頻度］：スケジュールを実行する頻度（例：毎週）を選択します。
    3. ［実行日］：関数を実行する曜日を指定します。
    4. ［開始日時］：スケジュール実行の初回開始日時を設定します。
    5. ［有効期限］：スケジュールを期限切れにする条件を選択します。
      1. ［実行回数の上限設定］：期限切れになるまでにスケジュールを実行する回数を指定します。
      2. ［有効期限日の設定］：スケジュールを期限切れにする具体的な日付を選択します。
      3. ［なし］：スケジュールを無期限に実行できるようにします。
    • ［コールバックの種類］：スケジュールで［関数］または［Circuit］のどちらをトリガーするかを選択します。
    • 選択すると、使用可能な関数またはCircuitがドロップダウンに表示されます。一覧から適切なものを選択します。
  1. スケジュールを作成するには、［保存］をクリックします。


スケジュールと複数の頻度での設定の詳細については、スケジュールのヘルプページを参照してください。

スケジュールの 管理

Studioポータルで、左ペインの［Circuit］を選択し、目的のテンプレートを選択します。左ペインで［スケジュール］をクリックします。
  • ［編集］：左ペインの一覧から目的のパラメーターを選択し、必要な変更を行って、［保存］をクリックします。
  • ［削除］：スケジュール名にカーソルを合わせ、削除アイコンをクリックし、確認画面で削除操作を確定します。

グループ 

Qntrlでは、［グループ］タブでConfigStoreのパラメーターを整理できます。グループを作成、管理することで、分類とアクセスをより効率化できます。グループの詳細。

新しいグループの作成 

  1. 左ペインの［グループ］セクションに移動し、［新しいグループ］をクリックします。
  2. グループの詳細を入力します。
    1. ［グループ名］：グループの内容が分かる名前を入力します。
    2. ［説明］：グループの目的を簡潔に入力します。
  1. ［保存］をクリックします。

既存グループの管理 

  1. 左ペインの［グループ］をクリックします。

  2. グループ名にカーソルを合わせ、操作メニューをクリックします。

  3. 次のオプションから選択します。

    1. ［編集］：グループ名と説明を編集し、［保存］をクリックします。

    2. ［削除］：［削除］を選択してグループを削除します。


ConfigStore

ConfigStoreでは、パラメーターを定義し、タブや環境をまたいで動的にアクセスできるため、Qntrlの設定データを一元的かつ安全に管理できます。QntrlのConfigStoreの詳細。
ConfigStoreでのパラメーターの追加   
  1. 左ペインの［ConfigStore］に移動し、［パラメーターを追加］をクリックします。
  2. パラメーターの詳細を入力します。
    1. ［パラメーター名］：パラメーターに一意の名前を指定します。
    2. ［値］：テスト用のパラメーター値を入力します。この値はエクスポートされません。
    3. ［初期値］：失敗を防ぐために初期値を指定します。なお、顧客組織にエクスポートされるのは初期値のみです。
    4. ［種類］：データベースでのパラメーター値の保存方法を選択します。
      1. ［デフォルト文字列］- 文字列値は書式なしテキストとして保存されます。
      2. ［暗号化文字列］- 文字列値は暗号化されて保存されます。
    • ［グループ］：パラメーターを分類するには、ドロップダウンリストから既存のグループを選択します。
  1. 新しいパラメーターを保存するには、［保存］をクリックします。
  2. 作成したパラメーターは、作成後に左ペインに一覧表示されます。
    1. ［すべて］：すべてのパラメーターが一覧表示されます
    2. ［グループ別］：パラメーターがカテゴリー別に一覧表示されます。


パラメーターの関連付け

作成したパラメーターをCircuit内で関連付けるには、${parameter's_link_name} の形式を使用します。



パラメーターの管理 

パラメーターの編集

  1. 左ペインの［ConfigStore］をクリックします。
  2. 左ペインの一覧から目的のパラメーターを選択します。
  3. 必要な変更を行います。
  4. ［保存］をクリックします。

パラメーターの削除

  1. 左ペインの［ConfigStore］をクリックします。
  2. パラメーター名にカーソルを合わせます。
  3. パラメーター名の横にある削除アイコンをクリックします。
  4. 確認画面で削除操作を確定します。


Bridge

Bridgeは、ローカルネットワーク上で独立して実行される、インストール可能な軽量エージェントです。32ビットおよび64ビットのWindowsとLinuxの両方に対応しています。Bridgeの詳細。

Bridgeの作成 

新しいBridgeを作成するには、次の手順を実行します。

  1. 回路テンプレートの左ペインで［Bridge］をクリックし、［新しいBridge］をクリックします。
  2. Bridgeの詳細を入力します。
    • ［名前］：Bridgeの一意の名前を入力します。
    • ［タブ］：ドロップダウンリストからいずれかのタブを選択します。このメッセージでは、選択したタブに関連するタスクのみが実行されます。Bridgeの作成時には、［Task Engine］タブと［DB Engine］タブがデフォルトで関連付けられます。
      • ［Task Engine］ - サードパーティ製アプリまたは社内でホストされているアプリでAPIタスクを実行するため
      • ［DB Engine］ - 閉域ネットワークでホストされているデータベースでSQLクエリーを実行するため
      • ［SSH Engine］ -リモートのLinux／Unixマシンに接続し、必要なコマンドを実行するため
      • ［PowerShell Engine］ - リモートのWindowsマシンに接続し、必要なコマンドを実行するため
      • ［ファイル管理］ -ある場所から別の場所へファイルを転送するため
      • ［AD Engine］ - Active Directoryに接続し、セキュリティで保護された操作を実行するため
    • ［説明］：Bridgeの目的について詳しく入力します。
  1. ［保存］をクリックします。 

      

設定手順の詳細については、QntrlのBridgeのヘルプページを参照してください。

Notes

  • コネクターまたは認証情報の作成時にBridgeが関連付けられない場合は、コンポーネントで設定されている該当するタブが選択されていることを確認してください。

  • 作成したBridgeはエクスポートできず、テンプレート作成のみを目的としています。

  • テンプレートのインストール後、新規または既存のBridgeを手動で関連付ける必要があります。

Bridgeの編集

Bridgeを編集するには、次の手順を実行します。

  1. 左ペインの［Bridge］セクションをクリックします。

  2. 一覧から、編集するBridgeの名前をクリックします。

  3. 変更を加え、［保存］をクリックします。

Bridgeの削除

Bridgeを削除するには、次の手順を実行します。

  1. 左ペインの［Bridge］セクションをクリックします。

  2. Bridge名にカーソルを合わせ、アクションメニューをクリックして、［削除］を選択します。

  3. 確認画面で削除操作を確定します。


スクリプト 

スクリプトを使用すると、大規模で複雑な一連のコマンドをファイルとして保存して実行できるため、マシン上で複数のタスクを簡単に実行できます。

スクリプトの作成 

  1. 回路テンプレートの左ペインで［スクリプト］セクションに移動し、［新しいスクリプト］をクリックします。
  2. 新しいスクリプトの詳細を入力します。
    1. ［名前］：スクリプトを識別できるように、ファイル拡張子を含む名前を入力します（例：display.sh／display.ps1）。
    2. ［説明］：後で参照できるように説明を入力します。
    3. ［スクリプトの種類］：スクリプトの種類を選択します。
      1. ［Shellスクリプト］ - UNIX OS用
      2. ［PowerShellスクリプト］ - Windows OS用
    4. ［スクリプトファイル］：スクリプトがローカルファイルにある場合は、この項目に添付できます。添付したスクリプトはメッセージ内で実行されます。
    5. ［内容］：または、この項目に実行するコマンドを直接入力できます。
  3. ［保存］をクリックします。新しいスクリプトが作成されます。

スクリプトの作成と管理の詳細については、スクリプトのヘルプページを参照してください。 

スクリプトの編集 

既存のスクリプトを編集するには、次の手順を実行します。

  1. 回路テンプレートの左ペインで［スクリプト］セクションに移動します。

  2. 編集するスクリプト名をクリックします。

  3. 必要な変更を加え、［保存］をクリックします。

スクリプトの削除   

スクリプトを削除するには、次の手順を実行します。

  1. 使用中のCircuitテンプレートで、左ペインの［スクリプト］セクションに移動します。

  2. 削除するスクリプト名にカーソルを合わせ、操作メニュー をクリックし、［削除］をクリックします。

  3. 削除操作を確定します。

 

コネクター 

コネクターでは、ブリッジを社内データベースに安全に接続するために必要なパラメーターを保存、整理できます。

コネクターの作成

新しいコネクターの作成手順

  1. 左ペインの［コネクター］をクリックし、［新しいコネクター］をクリックします。
  2. 新しいコネクターの詳細を入力します。
    • ［名前］：コネクターの一意の名前を入力します。
    • ［種類］：接続の種類を選択します。現在、QntrlでサポートされているのはJDBCのみです。
    • ［認証情報］：対象のデータベースへの接続に使用する認証情報名を選択します。
    • ［SQLの種類］：SQLデータベースの種類を選択します。
      • ［SQL Server］
      • ［MySQL］
      • ［PostgreSQL］
      • ［Oracle］
    • ［接続タイムアウト］：接続が期限切れになるまでの最大タイムアウト時間を指定します。
    • ［クエリータイムアウト］：クエリーの実行が中断されるまでの最大タイムアウト時間を指定します。
    • ［ホスト名］：データベースがホストされているホスト名を入力します。
    • ［ポート］：データベースが実行されているポート番号を入力します。
    • ［データベース名］：接続するデータベース名を入力します。
    • ［インスタンス］：この項目は、［SQLの種類］が［SQL Server］の場合に表示されます。DBインスタンス名を入力します。
  1. ［保存］をクリックします。

      

詳細な設定手順については、Qntrlのコネクターのヘルプページを参照してください。

コネクターの編集   

コネクターを編集するには、次の手順を実行します。

  1. 左ペインの［コネクター］セクションをクリックします。

  2. 一覧で、編集するコネクター名をクリックします。

  3. 変更を加え、［保存］をクリックします。

コネクターの削除 

コネクターを削除するには、次の手順を実行します。

  1. 左ペインの［コネクター］セクションをクリックします。

  2. コネクター名にカーソルを合わせ、操作メニューをクリックして、［削除］を選択します。

  3. 確認ウィンドウで、削除操作を確定します。

 

認証情報 

［認証情報］タブでは、データベース、リモートマシン、アプリケーションサーバーの認証詳細を安全に保存および管理できるため、繰り返し入力を避け、セキュリティリスクを軽減できます。

認証情報の作成 

新しい認証情報を作成するには、次の手順を実行します。

  1. 左ペインの［認証情報］をクリックし、［新しい認証情報］をクリックします。
  2. 新しい認証情報の詳細を入力します。
    • ［名前］：認証情報を識別する一意の名前を入力します。
    • ［種類］：認証情報の種類を選択します。
      • ［APIキー］：認証情報の種類がAPIキーの場合は、APIトークンを指定します。
        • ［追加先］：認証情報を追加する［パラメーター］または［ヘッダー］を選択します。
        • ［パラメーター］または［ヘッダー名］：パラメーターまたはヘッダーの名前を入力します。
      • ［JDBC］：JDBC認証情報の種類では、ユーザー名とパスワードを入力する必要があります。
      • ［OAuth 2.0］：認証情報の種類がOAuth 2.0の場合は、既存のDRE接続を選択します。
      • ［SSH］：Shellスクリプトを実行するマシンのユーザー名とパスワードを入力します。
      • ［Powershell］：Powershellスクリプトを実行するマシンのユーザー名とパスワードを入力します。
      • ［Active Directory］：Active DirectoryのUser DNとパスワードを指定します。
    • ［ブリッジの認証情報を使用］：ブリッジに認証情報を保存済みの場合は、これを選択します。
      • ［ブリッジ内の認証情報名］：保存済みの認証情報名を指定します。
  1. ［保存］をクリックします。

      

詳細な設定手順については、Qntrlの認証情報のヘルプページを参照してください。

Notes
セキュリティ上の理由により、ユーザー名、トークン、パスワードなどの一部のプロパティはエクスポートできません。これらの機密項目は、コンポーネントのインポート後に対象環境で手動で再設定する必要があります。

認証情報の編集   

認証情報を編集するには、次の手順を実行します。

  1. 左側のペインで［認証情報］セクションをクリックします。

  2. 一覧から、編集する認証情報の名前をクリックします。

  3. 変更を加えて、［保存］をクリックします。

認証情報の削除

認証情報を削除するには、次の手順を実行します。

  1. 左側のペインで［認証情報］セクションをクリックします。

  2. 対象の認証情報名にカーソルを合わせ、操作メニューをクリックして、［削除］を選択します。

  3. 確認画面で、削除操作を確定します。

 


    • Related Articles

    • Qntrl StudioでのCircuitテンプレートの作成と共有

      お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 早期アクセス Qntrl StudioのCircuitテンプレートは、すべてのユーザーに対して有効になっているわけではありません。お試しをご希望の場合は、メールでサポートチームにお問い合わせいただき、早期アクセスをご依頼ください。 ...