Indicate

This help page is for Desktop Studio. This information is also available for Studio.

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

Double-click the action to open a configuration wizard.

依存関係

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

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

The icon for a Generic script type - a rectangle with < and > symbols inside it.

The icon for the Email script type - a large @ symbol in a diamond.

The icon for the Chat script type - a chat bubble with an ellipsis inside (...), in a diamond shape.

The icon for the Phone script type - an old-style phone handset with curved lines indicating sound coming out of it.

The icon for the Voicemail script type - a symbol that looks like a cassette tape - two circles sitting on a horizontal line.

The icon for the Work Item script type-a piece of paper with one corner folded down and a bullet list on it.

The icon for the SMS script type - a smart phone with a chat bubble coming out of it.

The icon for the Digital script type - a computer monitor with a smartphone next to it.

一般

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

類似アクションの比較

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

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

入力プロパティ

これらのプロパティは、アクションが実行時に使用するデータを定義します。

プロパティ

説明

Target

ドロップダウンから受信者タイプを選択します。AgentsTeamSkillEveryoneContactEveryoneオプションは廃止されました。

TargetIDs

エージェントIDやスキルIDなどのターゲットのID。

Name

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

ImageFile

事業単位テナントCXone Mpowerディレクトリにある画像ファイルのURL。 これは、エージェントがクリックする画像です。 ファイルはGIF、JPG、またはPNGで、サイズは16x16ピクセルである必要があります。

Indicate アクションをSalesforce AgentまたはSalesforce Agent Lightningで使用する場合、このプロパティは必須です。

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

Tooltip

マウスカーソルがインジケーターアイコンまたはテキストの上に置かれたときに表示されるテキスト。

State

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

ActionType
  • RunExe: Runs a local executable. This option uses a Java plugin that only works with Internet Explorer, which CXone Mpower does not support: do not select this option. This requires a local executable that resides in the Windows path or with the full path entered in the ActionValue field. The file path must include double back slashes (\\) in the path. For example, C:\\Program Files\\CXone Mpower\\studio.exe. Most modern browsers do not support running executable programs. If you want to use this type, ensure that your agents use a compatible browser.
  • OpenURL: Opens a default web browser to the URL specified in the ActionValue field.
  • SpawnScript: Spawns a script specified in the ActionValue field and passes parameters.
  • SignalScript: Signals a script specified in the ActionValue field and passes parameters.
  • ShowCustomForm: Launches a custom HTML form created in Studio. The captured data from the custom form will trigger the ONDATA event in the script.
ActionValue

指定されたActionTypeで必要な値。 このプロパティでは、変数を波括弧({ })で囲むことでサポートされます。

  • RunExe:Windows実行可能ファイルの名前またはパス。 ファイルパスのパスには、二重のバックスラッシュ(\\)を含める必要があります。 例えば、 C:\\Program Files\\MyCompany\\myApp.exe -h {ANI}
  • OpenURL :完全修飾ドメイン名とURLである必要があります。 クエリー文字列パラメーターがサポートされています。 たとえば、http://www.example.com/file.asp?ANI={ANI}icAgentPanelTitle=パラメーターをURLに追加することで、MAXインターフェースにポップアップするタブのタイトルをカスタマイズできます。
  • SpawnScript :スポーンするスクリプトの名前。 名前は、(実行中のスクリプトの現在のディレクトリからの)スクリプトへの絶対パスでなければなりません。 スクリプトのスポーンパラメーターSkillIDは必須です。 スクリプトは、ACDスキルIDなしでスポーンすることはできません。
  • SignalScript :通知する実行中のスクリプトのID。 通常の場合、関連するスクリプトをスポーンするので、{ContactID}を使用して現在のスクリプトに通知できます。 {MasterID}を使用して親スクリプトに通知するか、{SpawnID}のようにして子スクリプトに通知します。
  • ShowCustomForm :このフィールドにより、カスタムHTMLフォームを作成することができます。 最新のブラウザがサポートできるHTMLとCSSを使用できます。 Input、TextareaPasswordCheckboxRadioSelectButtonSubmitを含む任意の標準フォーム入力フィールドを使用できます。 <form> タグを含めないでください。
    • 各入力フィールドには名前が含まれている必要があります。 例えば、 <input type="text" name="phone"> 。 名前のないフィールドは無視されます。 名前と値は、Ondataアクションを使用して変数としてスクリプトに返されます。 スクリプトにOndataアクションがない場合、フォームは役に立たなくなります。 Checkbox Selectなどの複数の値をサポートするフォームフィールドには、コンマ区切りの配列が含まれます。
    • 同じ名前または異なる名前を使用して複数の送信ボタンを使用できますが、どの送信ボタンでもデータを送信してウィンドウを閉じます。 送信しないボタンが必要な場合は、送信ではなくボタンを使用してください。
    • リンクされたスタイルシートはサポートされていませんが、インラインスタイルはサポートされています。 例えば、 <div style="position: absolute: left: 10px: top: 100px:">
    • Javascriptは外部の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)">

    • Some characters used in HTML and CSS are interpreted as code, such as double quotes. To get around this, use the .char() function to add the character where it belongs. For example:

      //The double quotes in the HREF tag cause a problem:
      ASSIGN html = "ASSIGN html = "<a href="https://www.w3schools.com">Visit W3Schools</a>""
      //To get around that, replace those double quotes with the char equivalent:
      ASSIGN html = "ASSIGN html = "<a href={char(34)}https://www.w3schools.com{char(34)}>Visit W3Schools</a>"

結果分岐条件

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

条件

説明

Default

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

OnError

アクションが正しく実行されなかったときにとられるパス。 これは例えば、接続不良、構文エラーなど予期しない問題が発生した場合などです。 _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ファイルに含まれています。

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