式のヒントとベスト プラクティス

エクスプレッションエディターを使ってオーディオシーケンスやタスクのエクスプレッションを作成する際には、以下のヒントとベストプラクティスを参考にしてください。

式で NOT_SET をチェックします。

パラメーターなど、関数呼び出しや演算子に渡される式で NOT_SET を適切に確認してください +、-、/、>、> =、などなど。

文字列を追加する

あなたが文字列を追加するとき、それはこのような式を書くことが可能ですが:

"Hello " + Flow.CustomerFirstName+", welcome to your personal menu where you can review information about your account"

上記の式が次のようになるように、代わりにAppend関数を使用することをお勧めします。

Append("Hello ", Flow.CustomerFirstName, ", welcome to your personal menu where you can review information about your account")

Append は NOT_SET パラメーター値を受け入れますが、+ 演算子は受け入れません。 [追加] ではまた追加するすべてのアイテムが 1 つの関数呼び出しで提出されるため、ランタイムでの実行のオーバーヘッドがやや少なくなります。一方、最初の例では各呼び出し + 別の追加呼び出し + 中間結果のストレージとなります。 要約すると、“Hello “+Flow.CustomerFirstName の評価が最初に行われ、その結果が一時場所に保存されて、次に加算演算子が実行されます。

エラーメッセージの詳細を探す

式にエラーが含まれていると、Architectはエディタの下にメッセージを返します。 エラーに関する詳細を表示するには、メッセージをクリックし、以下の機能に注意してください。

  1. エラーに関数名(たとえばMakeDuration)が含まれていると、その関数名は青で表示されます。 特定の関数にフォーカスして、その関数名をクリックすると、[式のヘルプ] ダイアログボックスが開きます。
  2. エラーメッセージの残りの部分は赤で表示されます。 赤色のエラー メッセージをクリックして、式エディターにフォーカスを当て、入力キャレットをスクロールしてエラーの場所に移動します。

カスタム式からシーケンスビルダーへのトラブルシューティング時に式を保持する

オーディオシーケンスを作成するときに、シーケンスビルダーからカスタムエクスプレッションビルダーに切り替えると、オーディオエクスプレッションが生成されます。 一方、カスタム式ビルダーで式を作成またはレビューしてシーケンス ビルダーに切り替えして戻した場合には、シーケンス ビルダーはシーケンスを再構成し、カスタム式のテキストは解釈しません。 この場合、シーケンス ビルダーを切り替えると、カスタム式で加えた変更はすべて破棄されます。

ただし、シーケンスビルダーで作成したシーケンスにエラーが含まれている場合は、シーケンスモードで表示すると、シーケンスダイアログの内部エラーのトラブルシューティングに役立ちます。 エラーのリンクをクリックして、[式を編集] ダイアログで式を編集します。 このプロセスではシーケンスは再構成されません。