【Salesforce】Service Consoleのマクロで困った時の本番反映前の切り分け

Service Consoleのマクロは、標準機能だけでは実現が難しい自動化を可能にする便利な機能です。しかし、本番環境に反映する前に、意図通り動作しないケースや、権限不足によって利用できない場面に遭遇することがあります。この記事では、本番反映前にトラブルを切り分ける具体的な方法を解説します。設定ミスや権限の問題を早期に発見し、スムーズな本番移行を支援します。特にSandboxと本番環境の差異に着目し、効率的な確認手順を紹介します。

マクロが動作しない原因の代表的な切り分けポイント

マクロが期待通りに動かない場合、原因は大きく分けて「マクロ設定の不備」「権限不足」「環境差分」の三つです。ここではそれぞれを具体的に解説します。

権限設定の問題

マクロを使用するユーザーに適切な権限が付与されていないと、マクロが表示されなかったり、実行時にエラーが発生したりします。特に確認すべきはプロファイルまたは権限セットで「マクロ」関連の権限が有効になっているか、です。また、マクロが操作するオブジェクト(例:取引先、ケース)に対する読み取り・編集権限も必要です。例えば、ケースを更新するマクロであれば、ケースオブジェクトの編集権限がないと動作しません。Sandboxで動作しても本番で権限設定が異なるケースが多いので、必ず本番環境の権限を見直してください。

マクロ条件の誤り

マクロには実行条件を指定できます。条件が厳しすぎると、対象レコードが存在せずマクロが動作しないことがあります。例えば「ステータスが’新規’かつ優先度が’高’」という条件の場合、該当レコードがなければマクロの選択肢自体が表示されません。このような場合は、条件を緩めてテストするか、マクロが適用されるレコードが正しく存在するか確認してください。

割り当てルールの不一致

マクロは割り当てルールと組み合わせて使用されることが多いです。割り当てルールが本番環境とSandboxで異なると、マクロの対象レコードが変わってしまいます。例えば、Sandboxでは特定のキューに割り当てられる設定が本番では別のキューになっている場合、マクロが動作しないことがあります。割り当てルールは環境ごとに設定を確認し、本番に合わせる必要があります。

マクロの設定を確認する手順

本番反映前に、以下の手順でマクロ設定を確認してください。各ステップで問題がないかチェックすることで、トラブルを未然に防げます。

1. マクロ定義の確認: 設定画面から該当マクロを開き、実行条件、割り当てルール、更新フィールドの値が意図通りかを確認します。特に対象オブジェクトとフィールドのAPI名が正しいか注意してください。
2. 実行ユーザーの権限確認: プロファイルまたは権限セットで「マクロ」タブの表示権限と「マクロの実行」権限が有効かを確認します。本人以外のユーザーでテストする場合は、そのユーザーの権限も合わせて確認します。
3. 関連オブジェクトの権限確認: マクロが参照・更新するオブジェクトの読み取り権限、編集権限、フィールドレベルセキュリティが適切か確認します。特に更新する項目に権限がないとエラーになります。
4. 割り当てルールの設定確認: マクロがキューやユーザーに割り当てるよう設定されている場合、割り当てルールが本番環境で正しく定義されているか確認します。Sandboxと本番でルール名や条件が同じである必要があります。
5. サービスコンソールのアプリケーション設定確認: マクロを使用するにはサービスコンソールが適切に構成されている必要があります。アプリケーション設定で「マクロ」が有効になっているか、マクロを表示する場所(サイドバーなど)が正しく設定されているか確認します。
6. テストレコードでの動作確認: 実際にマクロを実行するレコードを用意し、Sandboxで動作テストを行います。成功したら同じ手順を本番のSandbox(またはFull Sandbox)でも再現し、結果を比較します。

本番反映前のテスト環境と本番環境の比較表

以下の表は、Sandbox(テスト環境)と本番環境で確認すべき項目と、差異がマクロに与える影響を示しています。この表を参考に、環境間の差分を洗い出しましょう。

確認項目	Sandbox	本番環境	差異の影響
マクロ定義(条件・アクション)	作成・編集可能	変更が必要な場合はSandboxからデプロイ	定義が異なると動作が変わります。
プロファイル/権限セット	テストユーザーに権限付与済み	本番ユーザーに権限がないと使用不可	権限不足でマクロが表示されない。
割り当てルール	Sandbox用のルールが存在	本番用のルールが存在(異なる可能性あり)	ルールが一致しないとマクロの割り当てが失敗。
データレコード(例:ケース)	テスト用データ	実データ(ステータス、所有者など)	条件に合うレコードがないとマクロが発動しない。
ロケール・言語設定	Sandbox標準設定	ユーザーごとに異なる	翻訳や日付形式の違いが影響する場合あり。

よくある失敗パターンとその対処

本番反映前に陥りやすい失敗パターンをいくつか紹介します。これらの事例を知っておくことで、原因特定が早まります。

パターン1: 権限不足でマクロが表示されない

マクロタブ自体が表示されず、サービスコンソールのサイドバーにマクロの選択肢が出てこない場合、多くの原因は権限不足です。プロファイル設定で「マクロ」の表示権限が有効になっているか、権限セットが割り当てられているかを確認します。また、マクロの共有設定でユーザーがアクセスできるようになっている必要があります。例えば、マクロの所有者が別のユーザーで共有設定が「参照のみ」になっている場合、実行できません。

パターン2: マクロの条件が厳しすぎて対象レコードがない

マクロの実行条件に日付やステータスなどの動的条件を含む場合、本番のデータ状況によっては対象が0件になることがあります。Sandboxではダミーデータで動作しても、本番では該当レコードが存在しないためにマクロの実行ボタンが表示されないのです。この場合は条件を確認し、必要に応じて条件を緩めるか、データが存在するか確認してください。

パターン3: 割り当てルールが本番と異なりエラーになる

マクロでレコードの所有者を変更する場合、割り当てルールが正しく設定されていないとエラーになります。例えば、Sandboxでは存在するキューが本番では削除されている、または名前が異なるといったケースです。割り当てルールはメタデータとしてデプロイされるため、Sandboxと本番で完全に一致しているか確認が必要です。もしルールが異なる場合は、マクロの割り当て設定を見直すか、ルールを本番に合わせて更新します。

管理者に確認すべき設定項目

マクロのトラブルシューティングでは、一般ユーザーでは変更できない設定が原因となることも多いです。以下の項目は管理者に確認を依頼しましょう。

• マクロの有効化とアクセス権: システム管理者が「マクロ」機能自体を組織で有効にしているか確認します。また、ユーザーに割り当てるプロファイルや権限セットでマクロ関連の権限が有効になっているかを確認します。
• サービスコンソールのカスタマイズ: マクロを表示するためのコンポーネント(サイドバー、アクションなど)が正しく設定されているか確認します。特にコンソールアプリケーションの設定でマクロを表示する場所が定義されている必要があります。
• キューとグループの設定: マクロがキューに割り当てる場合、そのキューが本番環境で正しく定義されているか、メンバーが適切に追加されているか確認します。
• フィールドレベルのセキュリティ: マクロが更新するフィールドに対して、ユーザーのプロファイルで編集権限が付与されているか確認します。特にカスタム項目で権限が漏れているケースが多いです。

よくある質問

Q1: Sandboxではマクロが動くのに本番で動かない原因は?

最も多い原因は権限設定の差異です。Sandboxでテストしたユーザーと本番環境のユーザーでプロファイルや権限セットが異なることがあります。また、データ状態や割り当てルールの違いも影響します。本番環境と同じ条件でテストユーザーを作り、Sandbox内で再現テストを行うとよいでしょう。

Q2: マクロの実行ボタンが表示されない場合の確認手順は?

まず、サービスコンソールのカスタマイズでマクロコンポーネントが配置されているか確認します。次に、ユーザーのプロファイルで「マクロ」タブが表示可能か、権限セットが正しく割り当てられているか確認します。最後に、マクロの共有設定で該当ユーザーがアクセス権を持っているか確認します。

Q3: マクロ実行時にエラーが発生する場合、どこを確認すればよいですか?

エラーメッセージの詳細を確認します。「権限が不足しています」というエラーなら権限設定を、「割り当てルールが見つかりません」というエラーなら割り当てルールの設定を確認します。また、マクロのアクションで指定したフィールドが存在するか、API名が間違っていないかもチェックします。

Q4: マクロを本番にデプロイする前に必ず確認すべきことは?

Sandboxと本番環境のメタデータの差分を確認します。特に、マクロ定義、割り当てルール、プロファイル権限の三つは必ず一致させます。また、本番環境のデータを使ってマクロが正しく動作するか、Sandboxで実データをインポートしてテストすることをお勧めします。

Q5: マクロが動作しない場合のログの確認方法は?

Salesforceではデバッグログを使用してマクロの実行をトレースできます。設定 > デバッグログからユーザーを追加し、マクロを実行した後にログを確認します。マクロに関連するフローや割り当てルールの実行状況も確認できます。

まとめ

Service Consoleのマクロが本番環境で期待通り動作しない場合、権限設定や環境差分が主な原因です。Sandboxでテストする際、本番と同じ権限とデータ状態を再現することが重要です。また、割り当てルールや共有設定の差異も見落としがちなので、比較表を活用して漏れなく確認しましょう。トラブルが発生した場合は、まず権限と条件から切り分け、管理者に必要な設定変更を依頼してください。事前の徹底した確認が、本番移行後のトラブルを大幅に減らします。