OmniStudio の一般的なエラーと解決策

1. システム管理者としてログインします。
2. [設定] から、[OmniStudio] を見つけて選択します。
3. 組織の「OmniStudio」権限を有効にします。

オプションが表示されない場合は、組織に OmniStudio ライセンスがあることを確認してください。ライセンスが必要な場合は、Salesforce アカウントエグゼクティブにお問い合わせください。

ヒント OmniStudio 権限を有効にした後、変更が組織全体に反映されるまで数分かかる場合があります。このエラーが続く場合は、ログアウトしてから再度ログインしてください。

• 有効な OmniScript を削除しようとしている
• 有効な OmniScript の構造項目を更新しようとしている
• 有効な OmniScript で種別、サブ種別、言語を変更しようとすると

1. アプリケーションランチャーで、[Omniscripts] を見つけて選択します。
2. 変更または削除する OmniScript を見つけます。
3. 現在のバージョンをメモし、今後の無効化についてユーザーに警告します。
4. [有効] チェックボックスをオフにして、OmniScript を無効にし、変更を保存します。
5. これで、必要な変更を加えたり、OmniScript を削除したりできます。
6. 変更を行った場合は、［Active］ チェックボックスを再度オンにして再アクティブ化できます。

警告 OmniScript を無効化すると、その OmniScript を現在使用しているすべてのユーザーとプロセスがすぐに影響を受けます。サービスの継続性を維持する必要がある場合は、有効なバージョンを変更するのではなく、新しいバージョンを作成することを検討してください。

• 同じ種別、サブ種別、言語を持つ別の OmniScript がすでに有効になっている
• 以前のバージョンを無効化せずに新しいバージョンを作成する
• 複数のバージョンが作成され、複数のバージョンを有効化しようとしている

OmniScript レコードを編集し、次のタスクを実行する権限があることを確認します。

1. アプリケーションランチャーで、[Omniscripts] を見つけて選択します。
2. 検索条件を使用するか、[種別] と [サブ種別] が一致する OmniScript を検索します。
3. 同じ種別/サブ種別/言語で現在有効な OmniScript を特定します。
4. 両方のバージョンを確認して、どちらのバージョンを有効にするかを決定します。
5. 無効化する OmniScript を開きます。
6. ［Active］ チェックボックスをオフにして、変更を保存します。
7. 新しいバージョンに戻って有効化します。

警告 新しいバージョンを有効化する前に、プレビューまたは Sandbox 環境で徹底的にテストします。リリースの準備ができたら、古いバージョンを無効化し、すぐに新しいバージョンを有効化してダウンタイムを最小限に抑えます。

• 種別項目が空または null です
• サブ種別項目が空または null
• [言語] 項目が選択されていない
• すべての必須項目が入力されていない状態で新しい OmniScript を保存しようとしている

OmniScript レコードを編集し、次のタスクを実行する権限があることを確認します。

1. アプリケーションランチャーで、[Omniscripts] を見つけて選択します。
2. OmniScript プロパティパネルで、[種別] 項目を見つけます。
3. CustomerOnboarding や ClaimSubmission など、わかりやすい種別名を入力します。
4. [サブ種別] フィールドを見つけて、[住宅] や [商業] などの特定のサブ種別名を入力します。
5. ドロップダウンから [言語] を選択します。
6. 3 つの項目がすべて入力されていることを確認し、変更を保存します。
7. 新しいバージョンに戻って有効化します。

ヒント OmniScript の目的を明確に示す意味のある Type と SubType の名前を選択します。これらの値はアプリケーションでの OmniScript の参照方法の一部となり、作成後に簡単に変更することはできません。

• [種別] または [サブ種別] 項目にスペースが含まれている
• [種別] または [サブ種別] 項目にアンダースコアが含まれている
• [種別] 項目または [サブ種別] 項目にサポートされていない特殊文字が含まれています: !@#$%^&* など。
• [種別] 項目または [サブ種別] 項目にハイフンやその他の句読点が含まれている

1. [種別] と [サブ種別] の値を確認します。
2. スペースを削除 - 代わりに UpperCamelCase (または PascalCase) を使用します。たとえば、CustomerOnboarding です。
3. アンダースコアを削除し、UpperCamelCase (または PascalCase) に置き換えます。
4. 特殊文字を削除します。
5. 文字 (A ～ Z、a ～ z) と数字 (0 ～ 9) のみが使用されていることを確認します。
6. 変更内容を保存します。

ヒント Type と SubType の値には PascalCase (UpperCamelCase とも呼ばれる) を使用します。これにより、スペースやアンダースコアを使用せずに読みやすくなります。

• 種別の値が長すぎます。
• サブ種別の値が長すぎます。
• [種別 + サブ種別 + 言語] の組み合わせが文字制限を超えています。

1. エラーメッセージを確認して、最大許容長を確認します。
2. [種別] または [サブ種別] の値を短くします。
3. 変更内容を保存します。

ヒント 必要に応じて略語を使用します。冗長な単語を削除します。短い命名規則を使用します。

[種別] または [サブ種別] 項目で予約キーワードが使用されている。一般的な制限キーワードには、in、out、exc、cb、kt、vt、v、x785f、x5f などがあります。

エラーメッセージで提案されているように、 restricted キーワードを別の値に置き換えます。詳細は、「OmniStudio 命名規則」ページの「予約語」を参照してください。

• 有効な OmniScript に新しい要素を追加しようとしています。
• 有効な OmniScript で既存の要素を変更しようとしています。
• 有効な OmniScript から要素を削除しようとしています。
• OmniScript が有効で使用中です。

OmniScript レコードを編集し、次のタスクを実行する権限があることを確認します。

1. OmniScript が現在有効かどうかを確認します。
2. 有効なバージョンを変更するのではなく、新しいバージョンを作成することを検討してください。
3. 新しいバージョンを作成するには、OmniScript で [コピー] をクリックします。
4. 既存の を変更するには、[有効] チェックボックスをオフにして無効化し、変更を保存します。
5. 要素を追加、更新、削除できるようになりました。
6. 変更をテストします。
7. 使用する準備ができたら、OmniScript を有効化します。

警告 重要な変更がある場合は、有効なバージョンを無効化して変更するのではなく、新しいバージョンを作成することをお勧めします。これにより、リリース前に徹底的にテストでき、問題が発生した場合に簡単にロールバックできます。

• 同じ OmniScript 内の別の要素の名前が同じである。
• 異なるステップの要素間の名前の衝突。
• 要素がコピーされ、名前は変更されていません。

1. OmniScript のすべての要素を確認します。
2. 名前が競合する要素を特定します。
3. 名前を保持する要素を決定します。
4. 他の要素の名前を一意の名前に変更します。
5. step1_firstName、step2_firstName など、ステップまたはセクションを示すプレフィックスを使用することを検討してください。
6. 名前を変更した要素を参照する数式またはデータマッピングを更新して、変更を保存します。

• OmniScript が管理パッケージから取得されており、変更または削除する権限がない。
• パッケージ名前空間外からパッケージ化された OmniScript を更新しようとしています。

1. OmniScript が管理パッケージから取得されているかどうかを確認します。
2. OmniScript をカスタマイズする必要がある場合は、代わりにコピーします。
3. コピーしたバージョンの名前を独自の種別/サブ種別/言語の組み合わせに変更します。
4. コピーしたバージョンに目的の変更を加え、OmniScript を保存して有効化します。
5. 名前を変更した要素を参照する数式またはデータマッピングを更新して、変更を保存します。

ヒント パッケージ化されたコンポーネントを変更する必要がある場合は、パッケージプロバイダーまたは Salesforce システム管理者にお問い合わせください。パッケージ化された OmniScript を直接変更する必要のない設定オプションや拡張ポイントを提供する場合があります。

• OmniScript は再利用できます。
• OmniScript には OmniScript 要素 (埋め込み OmniScript) が含まれます。
• 埋め込み OmniScript を追加した後に OmniScript を再利用可能にしようとしている

1. この OmniScript を再利用可能にするか、埋め込み OmniScript を含めるかを決定します。
2. オプション 1: 再利用を維持する - すべての埋め込み OmniScript 要素を削除する
3. オプション 2: [埋め込みを許可]: [再利用可能] チェックボックスをオフにします。
4. 埋め込み OmniScript を削除する場合は、代わりに Integration Procedure を使用することを検討してください。ロジックを OmniScript からコールできる Integration Procedure にリファクタリングできます。

ヒント 共有ビジネスロジックには、再利用可能な OmniScript をネストする代わりに Integration Procedure を使用します。これにより、よりクリーンなアーキテクチャが作成され、OmniScript 連動関係の複雑さが回避されます。

• 同じ名前の別の FlexCard がすでに有効になっています。
• 古いバージョンを無効化せずに新しいバージョンを有効化しようとしています。

1. [名前] 項目が同じ Flexcard を検索します。
2. これらを確認して、有効にしておく必要があるものを決定します。
3. 無効化する FlexCard を開きます。
4. [有効] チェックボックスをオフにして FlexCard を無効化し、変更を保存します。

警告 FlexCard を無効化すると、現在使用しているすべてのユーザーとプロセスがすぐに影響を受けます。サービスの継続性を維持する必要がある場合は、有効なバージョンを変更するのではなく、新しいバージョンを作成することを検討してください。

1. FlexCard が管理パッケージに含まれているかどうかを確認します。
2. 使用から削除する必要がある場合は、削除ではなく無効化します。
3. これを行うには、FlexCard を開き、[有効] チェックボックスをオフにします。
4. FlexCard のカスタマイズバージョンが必要な場合は、代わりにコピーします。

ヒント パッケージ化されたコンポーネントを変更する必要がある場合は、パッケージプロバイダーまたは Salesforce システム管理者にお問い合わせください。パッケージ化された FlexCard を直接変更する必要のない設定オプションや拡張ポイントを提供する場合があります。

• 子 Flexcard の名前のスペルが間違っている。
• 子 Flexcard は存在しますが、有効ではありません。
• 子 Flexcard が削除されました。
• 子の Flexcard が別の名前空間にある。

1. アプリケーションランチャーで、[エラーメッセージから子 Flexcard 名をメモ] を見つけて選択します。
2. 子 Flexcard を名前で検索します。
3. 見つかったが無効な場合は、有効化します。
4. 見つからない場合は、正しい名前を確認します。
5. name が正しくない場合は、親 Flexcard 設定を更新します。
6. 親 Flexcard で、子 Flexcard 参照を見つけます。
7. 既存の有効な FlexCard と一致するように名前を修正し、親 FlexCard を保存します。

メモ 子 FlexCard は、親 FlexCard が参照する前に有効化する必要があります。最初に子 FlexCard を作成してテストし、親 FlexCard を設定して使用します。

• OmniScript の Type/SubType/Language が正しくありません。
• OmniScript は存在しますが、有効ではありません。
• OmniScript が削除されました。
• OmniScript の Type/SubType/Language が変更された。

1. エラーメッセージの [種別]、[サブ種別]、[言語] をメモします。
2. [種別] と [サブ種別] が一致する OmniScript を検索します。
3. [言語] が一致することを確認します。
4. 見つかったが無効な場合は、OmniScript を有効化します。
5. 見つからない場合は、正しい Type/SubType/Language 値を確認します。
6. FlexCard に戻り、OmniScript 参照を正しい値で更新します。
7. 変更内容を保存します。

ヒント FlexCard を有効化する前に、参照される OmniScript が有効になっていることを確認します。両方を同時にリリースする場合は、最初に OmniScript を有効化します。

• データマッパーの名前のスペルが間違っている。
• データマッパーは存在しますが、有効ではありません。
• データマッパーが削除されました。
• データマッパーの名前が変更されました。

1. エラーメッセージのデータマッパー名をメモします。
2. データマッパーを名前で検索します。
3. 見つかったが無効な場合は、有効化します。
4. 見つからない場合は、正しい名前を確認します。
5. FlexCard に戻り、データマッパー参照を正しい名前で更新して、変更を保存します。

ヒント データマッパーを参照する FlexCard を有効化する前に、データマッパーを有効化します。データマッパーを個別にテストして、期待されるデータ構造が返されることを確認します。

• Integration Procedure の名前が正しくありません。
• データマッパーは存在しますが、有効ではありません。
• データマッパーが削除されました。
• 間違った命名形式を使用している (Type_SubType 形式を使用する必要がある)。

1. エラーメッセージの Integration Procedure 名をメモします。
2. Integration Procedure を検索します。
3. 存在することを確認し、[種別] と [サブ種別] をメモします。
4. 見つかったが無効な場合は、有効化します。
5. FlexCard に戻ります。
6. Type_SubType 形式を使用して Integration Procedure リファレンスを更新し、変更を保存します。

警告 Integration Procedure は、Type_SubType 形式に従う OmniProcessKey を使用して参照されます。FlexCard を設定するときに、正しい形式を使用していることを確認します。

• 既存の FlexCard の名前を変更しようとしています。
• 既存の Flexcard の著者を変更しようとしています。
• UniqueName は他のコンポーネントによって使用され、変更できません。

1. 別の名前または著者が必要な場合は、代わりに FlexCard をコピーします。
2. FlexCard を見つけてコピーします。
3. 新しい名前または著者を入力します。
4. コピーしたバージョンに他の必要な変更を加え、新しい FlexCard を有効化します。
5. 古い FlexCard を参照しているコンポーネントを更新して、新しい FlexCard を使用します。
6. すべての参照が更新されたら、古い FlexCard を無効化します。

• Integration Procedure Name は FileBased で始まります。
• Integration Procedure Type はファイルベースで始まります。
• Integration Procedure SubType は FileBased で始まります。

1. Integration Procedure を開きます。
2. [名前]、[種別]、[サブ種別] 項目を確認します。
3. FileBased で始まる場合は、別のプレフィックスを選択します。
4. ファイル、ドキュメント、データ、組織名などのプレフィックスを使用することを検討してください。
5. エラーが発生しやすい項目を更新し、変更を保存します。

• JSON 入力スキーマに 10 レベルより深いネストされたオブジェクトがある。
• JSON 出力スキーマに 10 レベルより深いネストされたオブジェクトがある。

1. JSON スキーマ構造を確認します。
2. 深くネストされたセクションを識別する。
3. ネストレベルを減らして構造をフラットにします。
4. 深くネストされたデータを個別の Integration Procedure に移動することを検討してください。
5. 深くネストされた階層ではなく、フラットなオブジェクトが含まれる配列を使用します。
6. ネストを 10 レベル以下に維持するように再構築します。
7. 更新されたスキーマを保存します。

Integration Procedure JSON スキーマでは、構造全体で最大 500 キーの制限があります。これには、すべてのネストレベルのすべてのキーが含まれます。具体的には次のことを考慮します。

• JSON 入力スキーマに合計 500 個を超えるキーが含まれている。
• JSON 出力スキーマに合計 500 件を超えるキーが含まれている。
• スキーマには、ネストされた複数のオブジェクトにまたがる多数の項目が含まれています。

1. JSON スキーマを確認します。
2. すべてのレベルのキーの合計数を数えます。
3. キーが過剰なセクションを特定します。
4. Integration Procedure を複数の小さな手順に分割することを検討してください。
5. 未使用または冗長な鍵を削除します。
6. 番号付きキーではなく、配列を使用して繰り返し構造を表します。
7. 関連項目をサブオブジェクトに統合します。
8. 最適化されたスキーマを保存します。

ヒント 500 個を超える鍵が正当に必要な場合は、プロセスをチェーンできる複数のインテグレーション手順に分割することを検討してください。

• 選択した sObject は、データマッパー操作ではサポートされません。
• 選択した sObject は、クエリをサポートしていないシステムオブジェクトです。
• 選択した sObject に、データマッパーを操作するために必要な API サポートがありません。

1. 入力種別として選択した sObject を確認し、Salesforce ヘルプでサポートされるオブジェクトを確認します。
2. サポートされる別の関連オブジェクトを使用することを検討してください。
3. サポートされていないオブジェクトのデータが必要な場合は、代わりにカスタム Apex との Integration Procedure を使用してください。
4. サポートされているオブジェクトでデータマッパー設定を更新し、変更を保存します。

メモ ほとんどの標準オブジェクトとカスタムオブジェクトがサポートされています。サポートされていないオブジェクトが発生した場合は、サポートされている代替オブジェクトを使用するようにデータフローを再構築できるかどうかを検討してください。

• OmniAnalytics for OmniStudio が有効になっていない。
• 組織で OmniAnalytics が設定されていない。

1. システム管理者としてログインし、[設定] から [OmniStudio 設定] または [Omni Interaction Configurations] を検索します。
2. [OmniAnalytics for Core] 設定を見つけて有効にします。
3. 変更を保存し、変更が有効になるまで数分待ちます。
4. Analytics 追跡が機能するかどうかをテストします。

メモ Decision Explainer が適切に設定されていることを確認します。

• ID が 15 文字または 18 文字の有効な Salesforce ID 形式ではありません。
• この ID は OmniTrackingComponentDef オブジェクトに属していません。
• 追跡コンポーネント定義が削除されました。
• ID が null または不正です。

1. 使用しているコンポーネント定義 ID を確認します。
2. [設定] > [OmniStudio] > [Analytics 追跡] に移動して、正しい追跡コンポーネント定義を見つけます。
3. レコードから正しい ID をコピーします。
4. コードまたは設定を正しい ID で更新します。
5. 定義が削除されている場合は、新しい追跡コンポーネント定義を作成します。「追跡グループの作成と追跡するコンポーネントの追加」を参照してください。
6. 追跡を再度テストします。

メモ Decision Explainer が適切に設定されていることを確認します。