ハードコード化された参照の更新

よくある質問 (全般)

1.ハードコード化された参照 (インスタンス固有の参照) とは何ですか?

ハードコード化された参照とは、インスタンス名が含まれる URL です (na1.salesforce.com など)。ハードコード化された参照は、インスタンス固有でない汎用の URL または相対 URL (<mydomain>.my.salesforce.com など) に置き換えてください。

たとえば、次のようなハードコード化された参照「https://na1.salesforce.com/{Case.Id}」があるとします。
これを相対参照にするには「na1.salesforce.com」を削除して「/{Case.Id}」にします。

注意: Salesforce では相対参照をクリックすると、自動的に適切なレコードに転送されます。外部要求は汎用エンドポイント (https://na1.salesforce.com ではなく、<mydomain>.my.salesforce.comなど) に送信する必要があります。
 

2.ハードコード化された参照を見つける方法は?

Salesforce Extensions for Visual Studio Code でハードコード化された参照を検索する:
Salesforce Extensions for Visual Studio Code はハードコード化された参照を見つけるのに利用できる開発者ツールです。記事「Creating a Salesforce Project in Visual Studio Code and Searching for Hard-Coded Reference (Visual Studio Code での Salesforce プロジェクトの作成とハードコード化された参照の検索)」の手順に従って、組織のハードコード化された参照*および組織のメタデータ (設定コードまたはカスタムコード) を更新します。

3.インテグレーション内のハードコード化された参照を更新するにはどうすればよいですか?

Salesforce 製品または Force.com へのインテグレーションには、Force.com API の login() 要求を開始点として使用します。login() 要求は汎用エンドポイント (https://<mydomain>.my.salesforce.com/services/Soap/u/26.0 など) に送信する必要があります。
login() コールにより、Force.com セッションが確立され、ログインサーバ URL が返されます。このサーバ URL をその後の API 要求のターゲットサーバとして設定し、返されたセッション ID を SOAP ヘッダー内に設定すると、その後の API 要求のサーバ認証が提供されます。

FAQ - インスタンスリフレッシュ & 組織の移行関連
新しいインスタンスへの移行準備中には、ハードコード化された参照に関する質問が生じる可能性があります。

4.ハードコード化された参照のうち、新しいインスタンスへの移動後に Salesforce サーバがリダイレクトできるのはどれですか?

インスタンスリフレッシュや組織移行の後にすべてのハードコード化された参照がリダイクレトされるわけではないため、移行前に「私のドメイン」を実装し、ハードコード化された参照をすべて削除しておくことを強く推奨します。Salesforce サーバがリダイレクトできる項目のリストは次のとおりです。ただし、新しいインスタンスに移動した後にこれらのオブジェクトを使用すると、パフォーマンスが低下する可能性があります。 

i. ブラウザリンク
ii.ブラウザのブックマーク URL
iii.カスタムボタン
iv.コンテンツ URL
v.Chatter 投稿
vi.セルフサービスログイン URL (sserv/login.jsp?orgid)
vii.インテグレーション

注: Sandbox でのハードコード化された参照は、新しいインスタンスへの移動後、リダレクトされなくなりました。
Sandbox 以外の本番インスタンスでは、ハードコードされた参照のリダイレクトは、Winter '25 リリースまでは引き続き機能します。ただし、InstanceName.salesforce.com / InstanceName-api.salesforce.com は、新しいインスタンスに移行した後、リダイレクトされなくなります。

5. 新しいインスタンスに移動する前に更新する (リダイレクトされないようにする) 必要のあるハードコード化された参照はどれですか?

[私のドメイン] が有効になっていない場合、メールテンプレートおよびナレッジ記事のハードコード化された参照を更新する必要があります。
[私のドメイン] が有効になっているかどうかに関係なく、Web アドレスではなくコンピュータのナレッジ記事とメールテンプレート内のすべての画像がアップロードされていることを確認し、メンテナンスの後も引き続き表示されるようにする必要があります。

i. Web アドレス経由で挿入した画像がある場合、画像をコンピュータにダウンロードし、ナレッジ記事またはメールテンプレートに画像を挿入するときに [画像をアップロード] オプションを選択して画像を再アップロードする必要があります。

注意: コンピュータからアップロードされなかったために、画像がメンテナンス後に破損している場合、画像 URL の古いインスタンス名を新しいインスタンス名に置き換える必要があります。 次に、今後のメンテナンスの後に画像が破損しないように、画像をコンピュータにダウンロードしてコンピュータから画像を再アップロードする必要があります。

6.ナレッジ記事とメールテンプレート内のすべての画像が Web アドレスではなくコンピュータからアップロードされていることを確認するにはどうすればよいですか?

画像がローカルマシンからアップロードされている場合、画像 URL は「https://[HOST-OR-MY-DOMAIN]/servlet/rtaImage…」のようになります。

画像が Web アドレス (または [ドキュメント] タブ) からリンクされている場合、画像 URL は「https://[HOST-OR-MY-DOMAIN]/servlet/servlet.ImageServer...」または「https://[HOST-OR-MY-DOMAIN]/servlet/servlet.FileDownload…」のようになります。

7.新しいインスタンスに移動する場合、CTI インテグレーション内のハードコード化された参照を更新する必要はありますか?

Open CTI を使用していて、コールセンター定義の CTI アダプタ URL に Salesforce インスタンスがハードコード化されている場合 (https://c.na6-visual.force.com/apex/Softphone など)、CTI インテグレーションに影響があります。
新しいインスタンスへの移動後に CTI インテグレーションを引き続き動作させるには、このハードコード化された参照を相対 URL (/apex/Softphone など) に変更してください。これを更新するには、[設定] > [コールセンター] でコールセンターオブジェクトの特定のクリックパスに移動します。

Salesforce Desktop CTI Integration Toolkit を使用している場合、ハードコード化された参照を使用できないため、このメンテナンスによる CTI インテグレーションへの影響はありません。

8.新しいインスタンスに移動する場合、 メールスレッドを更新する 必要はありますか?

カスタムスレッド ID を作成している場合、新しいインスタンスへの移行後に影響を受ける可能性があります。そうでない場合は、Salesforce によって生成された既存のメールスレッド ID を (移行後にインスタンス名がまだ参照されていても) 新しいインスタンスへの移行時に更新する必要はありません。

カスタム生成したメールスレッド ID を修正する手順は次のとおりです。
i.カスタム数式を更新して、次の形式にします: ref:_00D[XX][yyyyy]._500[AA][bbbbb]:ref
ii.ここで、yyyyy と bbbbb は先行ゼロが除去された 10 文字の ID です。
iii.Salesforce のシステムコードで解析可能なメールスレッド ID の形式は、次のとおりです (yyyyy および bbbbb は先行ゼロのないレコード ID)。

注意: ref:00DXyyyyy.500Abbbbb:ref は、使用されなくなった以前の形式です。

Salesforce はいずれ形式を変更する可能性があるため、お客様が独自のスレッド ID を生成することはお勧めしません。カスタマイズされたスレッド ID の場合、オンデマンドのメール-to-ケース (E2C) で、新しいケースが作成され、返信が含まれる元のケースに添付されないという問題が発生することがあります。カスタムスレッド ID 形式は作成しないようにしてください。ケーススレッド ID のカスタム数式は公式にサポートされていないため、Salesforce で生成される標準のスレッド ID 数式を使用することをお勧めします。カスタム作成を避けるべき理由についての詳細は、記事「メール-to-ケースでのカスタムスレッド ID の使用」を参照してください。

9.新しいインスタンスへの移動後に、顧客は古いインスタンス URL からパートナーポータルに引き続きアクセスできますか?

新しいインスタンスへの移動後約 30 日間は、古いインスタンス URL を使用してお客様のパートナーポータルにアクセスできます。この 30 日の期間後は、古いインスタンスログイン URL は廃止されます。新しいインスタンスに移動する前に、組織のパートナーポータルにある [システムメンテナンス] メッセージにカスタムメモを追加することをお勧めします。これにより、顧客は新しいインスタンスへの移動以降、新しいパートナーポータル URL を使用するようになります。また、システム管理者は、新しいパートナーポータル URL でログインブックマークを更新するように顧客に勧めることもできます。

10.新しいインスタンスへの移動後、Web-to-リード/ケース (W2X) に影響はありますか?

W2X にハードコード化された参照がある場合は、新しいインスタンスに移動する前に、それらの参照を相対 URL に更新する必要があります。ハードコード化された参照を更新しないと、メンテナンス後に W2X に意図しないサービス中断が発生する可能性があります。W2X は、メンテナンスが完了すると、キューに入れられて処理されます。

11.新しいインスタンスへの移動後に、リモートサイト名を更新する必要がありますか?

はい。[私のドメイン] を使用していない場合、リモートサイト名のハードコード化された参照は、メンテナンス直後に新しいインスタンス名で更新する必要があります。
メンテナンス後にリモートサイト名のハードコード化された参照を更新しないと、リモートサイトに意図しないサービス中断が発生する可能性があります。

12.新しいインスタンスへの移動は Salesforce Mobile SDK に影響を与えますか?

新しいインスタンスへの移動は、ユーザが最新のバージョンを所持していない場合、Salesforce Mobile SDK で作成したアプリケーションのデータに影響が及びます。メンテナンスの前に、Salesforce Mobile SDK で作成したすべてのアプリケーションを更新して、組織のすべてのユーザに更新を転送することをお勧めします。
Salesforce Mobile SDK で作成したすべてのアプリケーションが最新バージョンである場合は、新しいインスタンスへの移動によってアプリケーション内のデータに影響が及ぶことはありません。

​​13.Live Agent または SOS の実装がある場合はどうすれば良いですか?

Web ページまたは証明書に Live Agent エンドポイント URL へのハードコード化された参照が含まれる場合は、インスタンスリフレッシュ、組織移行、またはサイト切り替えにより、Live Agent/SOS 機能に影響が生じる可能性があります。影響を最小限にとどめるには、ベストプラクティスに従って、エンドポイントへのハードコード化された参照を回避し、[設定] の [リリース] ページからコピーしたリリースコードのエンドポイント URL を必ず更新してください。提供されるリリースコードには、新しく割り当てられたサーバへのリダイレクト機能が含まれていますが、リフレッシュの完了後すぐにエンドポイントを更新する必要があります。 

Live Agent エンドポイントについての詳細、およびハードコード化された エンドポイントの意味については、記事「Live Agent サーバ (エンドポイント URL) が変更された後、Live Agent チャットが機能しない」を参照してください。

14.Apex Web サービスで生成された WSDL には、どのような作業を実施する必要がありますか?

WSDL を使用してコードを生成する場合、ハードコード化された参照がないか、コードを使用したすべての領域をチェックする必要があります。すべてのハードコード化された参照は、[私のドメイン] のURL に更新する必要があります。新しいインスタンスに移動する前に [私のドメイン] を実装することをお勧めします。これにより、すべてのハードコード化された参照を新しい [私のドメイン] のURLを参照するように修正すれば、この作業を再度実行する必要がなくなります。