コネクター

このページの内容は、限定リリース(CR)中の製品または機能に関するものです。 CRグループに参加していない場合で、詳細情報を知りたい方は、アカウント担当者にお問い合わせください。

コネクター、お客様はNiCEエコシステムの外部にある外部アプリケーションをワークフローにリンクできます。これにより、組織はフロントオフィスとバックオフィスの両方のシステムからデータを統合することが容易になります。これにより、スムーズなエンドツーエンドの操作が可能になります。これをサポートするために、NiCE は、多くの人気のあるアプリにすぐに使用できるコネクタを提供する OEM パートナーである Tray と提携しています。ユーザーが Tray がサポートしていないアプリケーションを使用している場合でも、カスタムコネクタを使用してそのアプリケーションをワークフローに接続できます。これらのコネクターは一般的な認証方法をサポートしており、ユーザーはビジネス・ニーズに基づいてデータを取得または更新するためのAPIをセットアップできます。

資格

トレイ付き外部コネクター
- トレイの内蔵コネクタを使用して、サポートされているサードパーティ製アプリケーションを統合します。

カスタムコネクター
- サポートされていないアプリケーションや独自のアプリケーションの統合を可能にします。
- 主要な認証タイプをサポート:
  - 認証なし
  - ベアラートークン
  - OAuth 2.0
  - APIキー
  - OAuth 1.0 (モック)/SAMLモック
- カスタムAPIの設定を可能にします。

コネクターの表示と管理

コネクタを管理するには:

アプリセレクターをクリックし、[Orchestrator]を選択します。
左側のナビゲーションパネルで、コネクター管理タブをクリックします。
コネクターページには、設定されているすべてのコネクターのリストが表示されます。ユーザーは以下を切り替えることができます。
- リストビュー:コネクタを表形式で表示し、メタデータの列を表示します。
- タイルビュー:コネクタを個々のカードとして表示し、重要な詳細を表示します。
タイルビューは視覚的な概要に使用し、リストビューは複数のコネクタ間で詳細な比較に使用します。

コネクタごとに次の主要なメタデータが表示されます。

メタデータ	説明
コネクター名	コネクタの識別子または名前。
説明	コネクタの目的に関するオプションのメモ。
ステータス	コネクターがアクティブか非アクティブかを示します。 (コネクターが公開されたワークフローで使用されている場合、ステータスは「アクティブ」それ以外の「非アクティブ」と表示されます。
アクティブワークフロー	現在コネクタを使用しているワークフローの数。
最終変更	コネクタの最新の更新のタイムスタンプ。

アクティブなワークフローがない、または説明が欠落しているコネクターは、まだ有効である可能性がありますが、現在は使用されていません。検索バーを使用して、名前または説明でコネクタを検索します。基準に一致するコネクタがない場合は、図と次のテキストを含むメッセージが表示されます。
1. 新しいコネクターを追加
  
  構成したコネクターをOrchestratorワークフローで使用して、アクションの実行、タスクのリンク、ビジネスの調整を行うことができます。
2. ユーザーが新しいコネクタを作成できるように、次の 2 つのボタンが用意されています。
  - + 外部コネクター: サードパーティまたは外部システムとの統合用。
  - + カスタムAPI コネクター:カスタムAPIエンドポイントを使用してコネクタを定義します。
新規コネクターの作成セクションで説明されている手順に従って、セットアップを完了します。

新規コネクターの作成

新しいコネクタを作成するには:

アプリセレクターをクリックし、[Orchestrator]を選択します。
左側のナビゲーションパネルで、コネクター管理タブをクリックします。
コネクターページの右上隅にある新規コネクターボタンをクリックします。
外部アプリをクリックして、サードパーティまたは外部システムと統合します。
1. コネクター情報セクションで、次の操作を行います。
  - アプリケーション:ドロップダウンリストから接続する外部アプリケーションを選択します。 (必須)
  - コネクター名:コネクタの一意の名前を入力します。 (必須)
  - コネクターの説明: コネクタの目的または機能について簡単に説明します。
2. 次へをクリックして、操作セクションに進みます。ここでは、コネクタがサポートする API メソッドを定義する必要があります。各操作には次のものが含まれます。
  - メソッド:HTTPメソッド(例:POST、PUT、DELETE、GET、PATCH)を選択します。
  - オペレーション名:操作のわかりやすい名前を指定します(例:クライアントレコードの作成、取得クライアントリスト)。
  - 説明:操作の機能と、外部アプリケーションとの相互作用について説明します。
  - テストオペレーション: テストオペレーションリンクをクリックして、APIコールを検証し、期待どおりに機能することを確認します。
3. すべての操作が定義され、テストされたら、コネクターを保存をクリックして構成を保存します。コネクタがコネクターリストに表示され、ワークフローで使用できるようになります。
OpenAPI仕様を使用してカスタムコネクタを作成するにはカスタムAPIをクリックします。コネクター情報セクションで、次の操作を行います。
- コネクター名:コネクタの一意の名前を入力します。 (必須)
- ロゴアップロード:コネクタを視覚的に識別するためのロゴを追加します。
- コネクターの説明: コネクタの目的または機能について簡単に説明します。
次へをクリックして、認証タイプセクションに進みます。ドロップダウンリストから、APIに適した認証方法を選択します。
- 認証なし:オープン/パブリックAPIの場合。
- ベアラートークン:トークン文字列が必要です。
- OAuth 2.0: 次のものが必要です。
  - クライアントID
  - クライアントシークレット
  - 認証URL
  - トークンURL
  - 範囲
- APIキー : 必要条件:
  - ヘッダー名
  - APIキー値
- OAuth 1.0 (Mock)/SAML Mock: 必要条件:
  - 詳細フィールド入力
次へをクリックして、操作セクションに進みます。ここでは、コネクターがサポートする 1 つ以上の操作を定義する必要があります。
1. オペレーションを追加をクリックします。
2. 次のフィールドに入力します。
  - オペレーション名:API関数のわかりやすい名前。 (必須)
  - オペレーションメソッド: HTTP メソッド (例: POST、PUT、DELETE、GET、PATCH) を選択します。
  - オペレーション説明:操作の機能を説明する。
  - URL:エンドポイントのURLを入力します。
  - ヘッダー(JSON):ヘッダーをJSON形式で提供します。
  - 本文 (JSON): リクエスト本文のコンテンツを JSON 形式で提供します (該当する場合)。
3. 追加とテストをクリックして、API呼び出しを検証し、期待どおりに機能することを確認します。結果が満足のいくものでない場合は、[オペレーションを設定をクリックして設定を調整します。操作が正常にテストされたら、リストに戻るをクリックします。
4. コネクターを保存をクリックして設定を完了します。
コネクターがコネクターリストに表示され、ワークフローで使用できるようになります。