Indicate

このヘルプページはStudio向けです。 この情報は、Desktop Studio用にも提供されています。

カスタム機能（エージェントがカスタム機能を開始するためにクリックするアイコン）によって、エージェントインターフェイスを拡張します。 エージェントインターフェイスのこれらのアイコンは、スクリプトを実行や通知したり、URLを開いたり、基本的なWebベースのフォームを作成してデータを処理したりするために使用できます。

依存関係

  • インジケーターもスクリプトでオフにする必要があります。オフにしないと、連絡先が終了した後もエージェントインターフェイスに表示され続けます。 通常は、ボタンをオンにするアクションとオフにするアクションの2つのIndicateアクションを使用します。
  • Indicateアクションは非常に柔軟であるため、プログラミングには十分注意し、徹底的にテストしてください。
  • Image Fileプロパティで使用されているリンクが有効であることを確認してください。 リンクが壊れていると、お使いのCXone Mpowerサーバーのパフォーマンスに深刻な問題が発生する可能性があります。

  • MAXは、Action Typeに基づいて、すべてのインジケーターに事前定義された画像のセットを使用します。 Image Fileプロパティで画像を指定しても、エージェントに表示される画像は変更されません。MAX

サポートされているスクリプトタイプ

その四角から分岐した線が、他の3つにつながっている四角。

一般

 Eメール チャット 電話 ボイスメール ワークアイテム SMS デジタル

類似アクションの比較

以下のアクションには同様の機能がありますが、いくつかの重要な相違点があります。

  • Runapp：スクリプトからカスタム機能を開始します。具体的には、フォーム、ウェブページ、またはアプリケーションを起動します。
  • PopURL：ウェブページのURLを開き、ウェブページをポップするパネルの場所とスタイルのオプションを提供します。
  • Indicate：カスタム機能(エージェントがクリックしてカスタム機能を開始するアイコン)によって、エージェントインターフェイスを拡張します。 これは、Runappでは、エージェントではなくスクリプトによってIndicateが開始される点を除き、Action Typeに似ています。

入力プロパティ

これらのプロパティは、アクションが実行時に使用するデータを定義します。 このアクションのすべてのプロパティは、変数置換を受け入れます。 そのためには、プロパティフィールドに変数を入力します。 変数を中括弧（{ }）で囲みます。

このアクションのプロパティ名の一部は、設定に応じて動的に変更されます。 たとえば、エージェントをターゲットとして選択すると、次のフィールドはコンタクトIDからエージェントIDに変更されます。

プロパティ

説明

Add Caption

スクリプト内でこのアクションを一意に識別できる、短いフレーズを入力します。 アクションアイコンにカーソルを合わせるとキャプションが表示されます。

Target

ドロップダウンから受信者タイプを選択します。Agents、Team、Skill、Everyone、またはContact。 デフォルトはContactです。 Everyoneオプションは廃止されました。 選択しないでください。

Contact ID, Agent ID, Team, Skill, Name

エージェントIDなどのターゲットのID。このプロパティの名前は、選択したTargetによって異なります。
Name

このプロパティは、値を識別するために使用される名前またはキーです。 これは、任意の名前または番号にすることができます。 名前は大文字と小文字が区別されません。複数のIndicateアクションを使用している場合、この名前は、どのIndicateアクションがオンまたはオフになっているかを追跡するために使用されます。
State

インジケーターを表示するかどうかを決定するOnまたはOffのドロップダウンリスト。 通常、同じ名前の2つのindicate アクションが必要です。1つはボタンを有効にし、もう1つはボタンを無効にするものです。
Image File

事業単位テナントCXone Mpowerディレクトリにある画像ファイルのURL。 これは、エージェントがクリックする画像です。 ファイルはGIF、JPG、またはPNGで、サイズは16x16ピクセルである必要があります。このプロパティは、Salesforce AgentまたはSalesforce Agent LightningでIndicate アクションを使用する際に必須です。

警告：Image Fileのリンクが壊れていると、関連するテナントに重大なパフォーマンス問題を引き起こす可能性があります。 カスタムアイコンを使用する場合は、リンクが正確であることを確認することが重要です。
Tool Tip

マウスカーソルがインジケーターアイコンまたはテキストの上に置かれたときに表示されるテキスト。
Action Type
  • Run Exe：ローカル実行可能ファイルを実行します。 このオプションは、Internet Explorerでのみ動作するJavaプラグインを使用しており、CXone Mpowerはサポートしていません。このオプションを選択しないでください。 URLフィールドに実行可能ファイルへのパスを入力します。
  • Open URL：URLフィールドに指定されたURLをデフォルトのWebブラウザーで開きます。
  • Spawn Script：Script Nameフィールドで指定されたスクリプトを生成し、指定されたSkill #とParametersを渡します。
  • Signal Script：Contact IDフィールドのIDで指定されたスクリプトに信号を送り、Parametersを渡します。
  • Show Custom Form：カスタムHTMLフォームを起動します。 フォームのHTMLコードをHTMLプロパティに貼り付けます。 カスタムフォームからキャプチャされたデータは、スクリプト内のONDATAイベントアクションをトリガーします。
URL

開くURLを指定します。 このプロパティは、Open URLまたはRun ExeをAction Typeとして選択した場合にのみ表示されます。

Open URLの場合は、完全修飾ドメイン名とURLを使用する必要があります。 クエリー文字列パラメーターがサポートされています。 たとえば、http://www.example.com/file.asp?ANI={ANI}。 icAgentPanelTitle=パラメーターをURLに追加することで、MAXインターフェースにポップアップするタブのタイトルをカスタマイズできます。

Run Exeの場合、Windowsパスにあるローカルの実行可能ファイル、またはURLフィールドに入力されたフルパスを使用する必要があります。 ファイルパスのパスには、二重のバックスラッシュ（\\）を含める必要があります。 たとえば、C:\\Program Files\\CXone Mpower\\studio.exeとします。 最近のほとんどのブラウザは、実行可能プログラムの実行をサポートしていません。 このタイプを使用する場合は、エージェントが互換性のあるブラウザを使用していることを確認してください。
Script Name

生成するスクリプトの完全なパスと名前を入力します。 このプロパティは、Spawn scriptをAction Typeとして選択した場合にのみ表示されます。

パスは、現在のスクリプトが配置されているフォルダーから始まる相対パスである必要があります。 たとえば、スクリプトが同じフォルダーにある場合は、スクリプト名を入力します。 スクリプトが現在のスクリプトの場所のサブフォルダーにある場合は、パスとスクリプト名を指定します。 たとえば、/サブフォルダー/スクリプト名などです。

Skill#も指定する必要があります。 これは生成されたスクリプトに渡されます。 生成されたスクリプトに渡したい追加のParametersを指定できます。
Skill#

生成されたスクリプトに渡すACDスキルの番号を入力します。 このプロパティは、Spawn scriptをAction Typeとして選択した場合にのみ表示されます。

生成するScript Nameも指定する必要があります。 スクリプトに渡したい追加Parametersを指定できます。
Contact ID

通知するスクリプトのIDを入力します。 このプロパティは、Signal scriptをAction Typeとして選択した場合にのみ表示されます。

デフォルトでは、このプロパティは{contactId}変数を使用します。 {masterID}を使用して親スクリプトに通知するか、{spawnID}のようなものを使用して子スクリプトに通知することもできます。
Parameters

生成されたスクリプトまたは通知されたスクリプトに渡す追加のパラメーターを指定します。 このプロパティは、Spawn scriptまたはSignal scriptをアクションタイプとして選択した場合にのみ表示されます。

パラメーターの追加はオプションです。
Html

起動するカスタムフォームのHTMLを入力します。 このプロパティは、Show Custom FormをAction Typeとして選択した場合にのみ表示されます。

Input、Textarea、Password、Checkbox、Radio、Select、Button、Submitなどの標準フォーム入力フィールドを使用できます。 ただし、<form>タグは含めないでください。 フィールドを追加する場合：

  • 各入力フィールドには名前が含まれている必要があります。 名前のないフィールドは無視されます。 例えば、 <input type="text" name="phone"> 。 名前と値は、Ondataアクションを使用して変数としてスクリプトに返されます。 スクリプトにOndataアクションがない場合、フォームは役に立たなくなります。 CheckboxやSelectなどの複数の値をサポートするフォームフィールドには、コンマ区切りの配列が含まれます。
  • 同じ名前または異なる名前を使用して複数の送信ボタンを使用できますが、どの送信ボタンでもデータを送信してウィンドウを閉じます。 送信しないボタンが必要な場合は、送信ではなくボタンを使用してください。
  • リンクされたスタイルシートはサポートされていませんが、インラインスタイルはサポートされています。 例えば、 <div style="position: absolute; left: 10px; top: 100px;"> 。

  • JavaScriptは外部スクリプトにリンクされている場合でも機能しますが、エラーを回避するにはコンテンツをHTTPSにする必要があります。 例：

    <script type="text/javascript" src="https://www.example.com/test.js"></script> <INPUT TYPE="button" NAME="button" Value="Click" onClick="MyFunction(this.form)">

結果分岐条件

結果の分岐条件を使用すると、アクションが実行されたときにさまざまな結果を処理できるように、スクリプトにブランチを作成できます。

条件

説明

Default

スクリプトが他のブランチのいずれかを取る必要がある条件を満たさない限り、パスが取られます。 他のブランチが未定義の場合にも使用されます。

Error

アクションが正しく実行されなかったときにとられるパス。 これは例えば、接続不良、構文エラーなど予期しない問題が発生した場合などです。 _ERR変数に1つのアンダースコア文字がある場合、問題の簡潔な説明を入力する必要があります。

ヒントとコツ

フィールドセットと凡例は、フォームをより読みやすい形式でレイアウトするためにサポートされています。 インラインスタイルは、HTMLエンティティに適用できます。 例：

<fieldset>
	<legend>Gender:</legend>
	<input type="radio" name="gender" value="male"/>Male
	<input type="radio" name="gender" value="female"/>Female<br/>
</fieldset>

スクリプトの例

これは、このアクションをスクリプトでどのように使用できるかを示す例です。 完全なスクリプトではありません。 追加のスクリプト作成が必要な場合があります。

この例では、スクリプトにIndicateアクションを組み込む方法を示しています。 さまざまな種類のデータを派生スクリプトに渡す方法の例も含まれています。 派生スクリプトの例は、ダウンロード可能なZIPファイルに含まれています。 これは、このアクションをスクリプトでどのように使用できるかを示す例です。 完全なスクリプトではありません。 追加のスクリプト作成が必要な場合があります。

このスクリプトをダウンロードします。