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

よくある質問 (全般)

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

ハードコード化された参照とは、Salesforce のインスタンス名が含まれる URL またはホスト名です（na1.salesforce.com など）。これらのハードコード化された参照は、相対 URL、「私のドメイン」のログインホスト名、または動的に生成されたホスト名を含む URL に置き換えてください。

たとえば、次のようなハードコード化された参照「https://na1.salesforce.com/{Case.Id}」があるとします。
これを相対参照にするには「na1.salesforce.com」を削除して「/{Case.Id}」にします。
ハードコード化された参照は、コード、API コール、および機能の設定内にも存在する可能性があります。その場合は、「私のドメイン」のログイン URL または動的に生成されたホスト名を使用することをお勧めします。
たとえば、https://na1.salesforce.com/services/Soap/c/65.0 の代わりに、https://{myDomainName}.my.salesforce.com/services/Soap/c/65.0 を使用します。詳細については、「コードを使用した Salesforce へのログイン」を参照してください。

注意:

• 組織が Hyperforce 上にある場合、インスタンス化された URL の形式は異なります（例: swe54.sfdc-cehfhs.salesforce.com）。また、上記の例のようなコールでその URL を使用することはできません。
• Salesforce 内では、相対参照によって適切なレコードに自動的に転送されます。外部要求は、https://na1.salesforce.com ではなく、<myDomainName>.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 製品またはサイトへのインテグレーションには、対応する「私のドメイン」のホスト名を使用してください。
例 :

• Salesforce 組織へのログイン: https://{myDomainName}.my.salesforce.com/services/Soap/u/65.0
• デジタルエクスペリエンスサイト経由のログイン: https://{myDomainName}.my.site.com/services/Soap/u/65.0
• Salesforce サイト経由のログイン: https://{myDomainName}.my.salesforce-sites.com/path-prefix/services/Soap/u/65.0

login() コールによりセッションが確立され、ログインサーバーの 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 以外の本番インスタンスでは、ハードコードされた参照のリダイレクトは、引き続き機能しますが、Summer '26 リリース (2026 年後半) より段階的に廃止され、Winter '27 リリースをもって完全に停止される予定です。新しいインスタンスに移行した後は、InstanceName.salesforce.com / InstanceName-api.salesforce.com はリダイレクトされなくなります。

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

Spring '26 (2026 年 1 月より開始) では、インスタンス名を含む「私のドメイン」ホスト名のリダイレクトが停止し、不適切なインスタンス化されたホスト名を使用する API トラフィックもリダイレクトされなくなります。

特別な注意が必要な以下の項目を含め、すべての参照を必ず更新してください。

• API コールおよびインテグレーション
• Apex Web サービスで生成された WSDL
• CTI インテグレーション
• サードパーティ（サードパーティのホスト、CDN、WAF など）によって提供されるカスタムドメイン
• カスタムメールスレッド ID
• カスタムアプリケーション
• カスタム Visualforce ページ
• ナレッジ記事およびメールテンプレート内の画像（これらの画像が Web アドレスからではなく、コンピュータからアップロードされていることを確認してください）
• パートナーポータル
• リモートサイト名
• Salesforce チャット（旧名: Live Agent または SOS）
• Salesforce Mobile SDK
• Web-to-リード/ケース (W2X)

組織のインスタンス化された URL への参照を、相対 URL および動的に生成されたホスト名に置き換えてください。画像については、コンピュータにダウンロードしてから直接再アップロードしてください。

関連記事:

• Salesforce ヘルプ: [Enhanced Domains Timeline (拡張ドメインのスケジュール)]
• Salesforce ヘルプ: [Prepare for the End of Redirections for Non-Enhanced Domains (非拡張ドメインのリダイレクト終了への準備)]
• Winter '26 リリースノート: [API トラフィック内のインスタンス化 URL を更新 (リリース更新)]
• Winter '26 リリースノート: [レガシーホスト名への参照を更新 (リリース更新)]

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.Web アドレスを使用しているナレッジ記事やメールテンプレート内の画像を更新するにはどうすればよいですか?

画像をコンピュータにダウンロードした後に、再度アップロードしてください。ナレッジ記事やメールテンプレートに画像を挿入する際に、[画像をアップロード] オプションを選択します。
注意: Web アドレスを使用しているためにメンテナンス後に画像が破損した場合は、次の手順を実行します。

1. 画像にアクセスするために、画像 URL 内の古いインスタンス名を新しいインスタンス名に置き換えます。
2. 画像をコンピュータにダウンロードします。
3. コンピュータから画像を再アップロードします。
4. 画像が期待通りに表示されることを確認します。

8. Hyperforce または新しいインスタンスに移行する場合、カスタムドメインに変更を加える必要がありますか? 

カスタムドメインは、お客様が所有するドメイン（https://www.example.com など）でデジタルエクスペリエンスまたは Salesforce サイトを提供します。

カスタムドメインで「サードパーティサービスまたは CDN を使用してドメインを配信する」ドメイン設定オプションを使用している場合、これらのイベント中にそのドメインに必要な設定が変更されます。

• インスタンス名が変更されたときに、組織が Salesforce Edge Network を使用している場合（組織が Hyperforce 上にあるかどうかは問いません）
• Hyperforce にアップグレードする場合
• 組織が Salesforce Edge Network に移行するか、または Salesforce Edge Network の使用を停止する場合

これらのイベントの計画の一環として、変更の直後にドメインのターゲットホスト名を更新するよう、サードパーティプロバイダーと連携してください。更新しない場合、カスタムドメインが機能しなくなります。

その設定オプションを使用するカスタムドメインがあるかどうかを確認するには、[設定] の [ドメイン] ページに移動します。
組織が Salesforce Edge Network 上にあるかどうかを確認するには、[設定] の [私のドメイン] ページに移動します。

サードパーティサービスまたは CDN によって提供されるカスタムドメインのターゲットホスト名を設定する手順については、「サードパーティサービスまたは CDN を使用するカスタムドメインの前提条件」の「ターゲットホスト名を使用したカスタムドメインの組織への指定」セクションを参照してください。

9.新しいインスタンスに移動する場合、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 インテグレーションへの影響はありません。

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

カスタムスレッド 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 の使用」を参照してください。

11.新しいインスタンスに移行した後も、お客様は古いインスタンス URL からパートナー ポータルにアクセスできますか?

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

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

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

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

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

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

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

​​15.Salesforce Chat (旧Live AgentまたはSOS) の実装がある場合はどうすれば良いですか?

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

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

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

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