Runapp

スクリプトからカスタム機能を開始します。具体的には、フォーム、ウェブページ、またはアプリケーションを起動します。連絡先パネルを対象とするURLは、iframeに表示できるように構成する必要があります。エージェントは、Panelsの設定をMAXでOnに設定する必要があります。Salesforce AgentとSalesforce Agent Lightningはこのアクションをサポートします。

このアクションは、Ondataブランチを通じて情報を送信します。

Runappの一般的な使用法は、ONANSWERイベント（Onanswerアクションで管理）を持つエージェントの標準フォームまたはカスタムURLをポップすることです。

PAGEactionを使用して、シンプルなHTMLページをエージェントにポップできます。Pageは、別々のブランチに続く一連のアイテムを作成するのに役立ちますが、Runappで情報を送信するときはいつでも、情報はOndataブランチを通過します。

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


一般	Eメール	チャット	電話	ワークアイテム	SMS

類似アクションの比較

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

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

入力プロパティ

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

プロパティ	説明
を追加	スクリプト内でこのアクションを一意に識別できる、短いフレーズを入力します。アクションアイコンにカーソルを合わせるとキャプションが表示されます。The default is the action name.
AgentID	エージェントID。このフィールドには{agentId}などの変数を使用できます。アウトバウンドスキルにはカスタムスクリプトが割り当てられているため、Runappが発信カスタムスクリプトで起動すると、エージェント（発信通話を発信するエージェント）がすでに「認識」されているのでBeginアクションが使用されます。したがって、スクリーンポップは、変数名として{__agentID}が使用されている場合にのみ機能します。インバウンドスクリプトの場合、スクリプトは、エージェントID変数をAGENTIDに設定するOnanswerが起動するまで、エージェントが誰であるかを「認識」しません。 RunAppプロパティエディターを使用して、アクションをダブルクリックすることにより、このプロパティを構成できます。
ActionType	RunExe：CXoneはサポートしていません。これには、WindowsパスまたはActionValueフィールドに入力されたフルパスを持つローカル実行可能ファイルが必要です。ファイルパスのパスには、二重のバックスラッシュ（\\）を含める必要があります。たとえば、C:\\Program Files\\CXone\\studio.exeとします。最近のほとんどのブラウザは、実行可能プログラムの実行をサポートしていません。このタイプを使用する場合は、エージェントが互換性のあるブラウザを使用していることを確認してください。 OpenURL：ActionValueフィールドで指定されたURLで、デフォルトのウェブブラウザを開きます。 ShowCustomForm：Studioで作成されたカスタムのHTMLフォームを起動します。カスタムフォームからキャプチャされたデータは、スクリプトのONDATA イベントをトリガーします。 RunApp Propertyエディターを使用して、アクションをダブルクリックすることにより、このプロパティを構成できます。
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インターフェースにポップアップするタブのタイトルをカスタマイズできます。 ShowCustomForm：このフィールドは、カスタムHTMLフォームを作成する機能を提供します。入力、テキストエリア、パスワード、チェックボックス、ラジオ、選択、ボタン、送信など、標準のフォーム入力フィールドを使用できます。<form>タグを含めないでください。各入力フィールドには名前が含まれている必要があります。名前のないフィールドは無視されます。例：<input type = "text" name = "phone">。カスタムフォームが機能するには、スクリプトに次のいずれかが含まれている必要があります。 Ondataアクション：名前と値は、このアクションを使用して変数としてスクリプトに返されます。 WaitForSubmit プロパティ：インクルードしてTrueに設定すると、フィールド名がスクリプトの変数になります。フィールド値は変数の内容になります。チェックボックスや選択など、複数の値をサポートするフォームフィールドには、カンマ区切りの配列が含まれます。同じ名前または異なる名前を使用して複数の送信ボタンを使用できますが、どの送信ボタンでもデータを送信してウィンドウを閉じます。送信しないボタンが必要な場合は、送信ではなくボタンを使用してください。リンクされたスタイルシートはサポートされていません。インラインスタイルを使用できます。例えば、 <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)"> RunApp Property Editorを使用して、アクションをダブルクリックすることにより、このプロパティを構成できます。
WaitForSubmit	TrueまたはFalse。Trueは、システムがエージェントによる送信アクションを待機することを意味します。さらに、フィールド名はスクリプト内の変数になり、フィールド値が変数の内容になります。WaitForSubmitは、Action TypeがShowCustomFormの場合のみ適用されます。これはWaitTimeoutと連動します。WaitForSubmitがFalseに設定されている場合、スクリプトにOndataアクションを含める必要があります。これにより、フィールド名と値が変数としてスクリプトに返されます。システムがエージェントによる送信アクションを待機するかどうかを決定します。有効にすると、システムはエージェントの送信アクションを待機します。フィールド名はスクリプト内の変数になり、フィールド値が変数の値になります。有効にした場合、スクリプトにOndataアクションを含める必要があります。これにより、フィールド名と値が変数としてスクリプトに返されます。Trueに設定すると有効になり、Falseに設定すると無効になります。このオプションは、Action TypeがShowCustomFormの場合のみ利用できます。これはWaitTimeoutと連動します。
WaitTimeout	Action TypeがShowCustomFormの場合にOnTimeoutブランチをトリガーする秒数。

結果ブランチ条件

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

条件	説明
Default	スクリプトが他のブランチのいずれかを取る必要がある条件を満たさない限り、パスが取られます。他のブランチが定義されていない場合にも使用されます。
Submit	WaitForSubmitが真に設定されている場合に取られるパス。
Timeout	指定された秒数の間応答がない場合に取られるパス。
OnError	アクションが正しく実行されなかったときにとられるパス。これは例えば、接続不良、構文エラーなど予期しない問題が発生した場合などです。_ERR変数に1つのアンダースコア文字がある場合、問題の簡潔な説明を入力する必要があります。

Runappウィザード

アクションのプロパティでアクションを直接構成することもできます。

Runappアクションをダブルクリックして、RunApp Property Editorウィザードを開きます。
画像の表示
Runappアクションを受け取るエージェントのエージェントIDを入力します。アウトバウンドスクリプトの場合、変数名として{__agentID}を使用します。他のすべてのスクリプトの場合、{AGENTID}を使用します。

アクションタイプを選択します。

フィールド	説明
Run an executable program	ローカル実行ファイルを実行します。このオプションは、InternetExplorerでのみ機能するJavaプラグインを使用します。 CXoneはサポートしていません。これには、WindowsパスまたはActionValueフィールドに入力されたフルパスを持つローカル実行可能ファイルが必要です。ファイルパスのパスには、二重のバックスラッシュ（\\）を含める必要があります。たとえば、C:\\Program Files\\CXone\\studio.exeとします。最近のほとんどのブラウザは、実行可能プログラムの実行をサポートしていません。このタイプを使用する場合は、エージェントが互換性のあるブラウザを使用していることを確認してください。
Pop open a web page	ウェブページの完全なURLをAction Commandフィールドに入力します。エージェントのローカルコンピュータのデフォルトのブラウザでページが開きます。
Prompt the user with a web page like form	HTMLコードを入力して、Action Commandフィールドにフォームを生成します。<form>の開始タグと終了タグを含める必要はありません。 Previewをクリックしてフォームを表示します。

OKをクリックします。