データを検証してエラーを処理する

学習の目的

この単元を完了すると、次のことができるようになります。

• ユーザーの間違いを防ぐことがなぜ重要なのか説明する。
  
• 管理パッケージ用 Omnistudio で Set Values 要素を使用して間違いを防ぐ。
  
• Set Errors 要素でデータを完全にする。
  

ユーザーの間違いを防ぐ 2 種類の要素

このモジュールでは、ユーザーが Salesforce で取引先の主な取引先責任者情報を変更する方法を示すサンプルのインタラクションの作成を中心に説明してきました。ユーザーの視点を念頭に、Omniscript を作成しています。一方で、データベースの整合性を維持するようにインタラクションを構築することも必要不可欠です。 

そのためには、Omniscript の使用時に、ユーザーがどのような間違いをする可能性があるかも考慮します。さらに、それらの間違いを防げるように、設定した方がよいエラーチェックの種類を考えます。間違いを防ぐことはエンドユーザーの役に立ちますが、それ以上に、データの整合性を維持できるという点があります。

必須項目を設定したときに簡単なデータ検証を設定しました。これにより項目が空の場合、Omniscript はユーザーが先に進むことを許可しません。

ここでは、エラーを防ぐためのさらに 2 つのツールについて説明します。

• Set Values 要素は、ユーザーが何かを実行していない場合は先に進めないようにします。
  
• Set Errors 要素は、間違いがあった場合にユーザーを前のステップに戻します。 
  

これら 2 つの便利な要素を詳しく確認しましょう。

Set Values 要素を設定して間違いを防ぐ方法

Set Values 要素は、Omniscript でさまざまなことに利用できます。たとえば、次のことを実行できます。 

• 差し込み項目を使用してデータ JSON にアクセスして名前を変更する。
  
• 要素に値を供給する。
  
• 値を連結する、つまり、2 つの値を 1 つの結合した値にまとめる。
  
• 応答またはパラメーターからデータ JSON に送信する値を定義する。
  
• Omniscript 関数とサポートされている数式演算子によって決定される値を作成する。
  

Set Values 要素と関数を使用して、エンドユーザーの間違いを防ぐ方法を説明しましょう。 

サンプルの Omniscript では、3 つの分岐の重要な項目が null (空) の場合に JSON に Not OK (OK でない) と表示し、少なくとも分岐のいずれかにデータがある場合に OK と表示する IF 関数を用いて、Set Values 要素を使用することにします。

これでユーザー入力で null が生成された場合、つまり、ユーザーが主取引先責任者データを変更しなかった場合に、JSON で間違いを識別できました。いいですね。では間違いを直すには、どのようにしてエンドユーザーをリダイレクトするのでしょうか? ここで登場するのが Set Errors 要素です。 

Set Errors 要素で完全なデータにする

Set Errors 要素は、完了していないステップにエンドユーザーを戻し、修正を手助けすることができます。このため、データが完全なものになります。UI における必須項目と関数によるメッセージは、進行中のステップにしか効果がありません。一方で Set Errors 要素は、その先のステップのために機能します。

別の例を考えてみます。携帯電話サービスにサインアップするユーザーをサポートする 4 つのステップのインタラクションを作成したとします。ステップ 1 で、ユーザーは主連絡先データを入力します。ステップ 4 でユーザーは、データ使用量が 80% に到達したときにテキストメッセージを受け取るというチェックボックスを選択します。もしチェックボックスを選択したのにステップ 1 で携帯電話番号が入力されていなかった場合、どうなるでしょうか? Set Errors 要素によってユーザーはステップ 1 に戻り、携帯電話番号の項目を入力できるようになります。 

では、この例の主取引先責任者 Omniscript に戻りましょう。ここには 1 つの Step 要素しかありません。各分岐の重要な項目が null の場合、どうしますか? また、そもそも主取引先責任者がいなかった場合は? Set Errors 要素を使用すれば、ユーザーの画面でエラーを強調表示し、修正を促せます。では、その方法を見ていきましょう。

まず、Set Errors 要素が動作するには、次の 3 種類のプロパティが必要です。

Omniscript で、次の Set Errors プロパティを設定します。 

• Element Error Map (要素エラーマップ): [Radio Buttons (ラジオボタン)] 要素。
  
• Value (値) 項目: 主取引先責任者を変更するか、新しい主取引先責任者を作成する必要があることをエンドユーザーに伝えます。
  
• Conditional View (条件付きビュー): 主取引先責任者がいないときに説明テキストを表示するように Conditional View (条件付きビュー) を設定します。
  

この設定が済んだら完了です。つまり、エンドユーザーを元のページに戻すことができます。

ユーザーの間違いを防げる気がしませんか? 次の単元では、Omniscript で外部データを表示する方法について学習します。

リソース

• Salesforce ヘルプ: Set Values in an Omniscript (Omniscript の Set Values) (管理パッケージ用 Omnistudio)
• Salesforce ヘルプ: Set Errors In an Omniscript (Omniscript の Set Errors) (管理パッケージ用 Omnistudio)