Aura サイトを Lightning Web Runtime (LWR) に移行する前に検討すべき事項

全般

• 特定のサイト機能の特定のコンポーネントが含まれる Aura テンプレートとは異なり、LWR テンプレートではより一般的なコンポーネントが提供され、データバインドなどの概念を使用して同じ目標をより迅速かつより動的に達成できます。

カスタム Aura コンポーネント

• サイト上のカスタム Aura コンポーネントを確認し、Lightning Web コンポーネント (LWC) に置き換えます。
  • LWC を作成するときは、@slot、応答型プロパティ、カスタムプロパティエディターなどの新しい LWC 機能を使用します。
  • 可能であれば、ワイヤーや Apex コントローラーではなく、データバインドを使用して、サイト上の CRM データと CMS コンテンツを表示します。
• 参考として使用できる LWC については、「Experience Cloud について」と「Github」を参照してください。

オブジェクトページとサイトページ

• Aura サイトの既存のオブジェクトページをミラーリングした、LWR サイトのオブジェクトページには、同じベース URL を使用することをお勧めします。たとえば、Aura サイトに www.company.com/s/account/123456789/account-name という既存のページがある場合、LWR のオブジェクトページのベース URL には /account を使用することをお勧めします。同じベース URL を使用すると、後でリダイレクトを設定しやすくなります。
• Aura サイトの既存のサイトページをミラーリングした LWR サイトでは、同じベース URL を使用することをお勧めします。たとえば、www.company.com/s/my-custom-page などの既存のビルダーページがある場合、/my-custom-page を LWR サイトのベース URL として使用します。
• Aura ページのレイアウトは、LWR の柔軟なページレイアウトに置き換えます。

カスタムドメインおよびカスタム URL

Aura サイトの URL で www.company.com/s のようなカスタムドメインや company.my.site.com/s/ のような Salesforce ドメインが使用されており、同じドメインで新しい LWR サイトが提供されていますが、/s/ は使用されていないものとします。

• /s/ がない LWR サイトを作成します。
• 稼働開始前に、company.my.site.com/path を使用するように LWR サイトを設定し、リダイレクトをテストできるようにします。
• 稼働開始時に Aura サイトのカスタム URL を削除します。[設定] で、カスタムドメインを使用する新しい LWR サイトのカスタム URL を作成します。
  • LWR ではまだ表示できないコンテンツを古い Aura サイトで提供するには、/archive などのパスを使用して、Aura サイトの新しいカスタム URL を追加します。

トピック

• Aura サイトでトピックやトピックの割り当てがカスタムオブジェクトレコードと共に使用されている場合は、それらを Topic__c や Topic_Assignment__c などのカスタムオブジェクトに置き換えます。
  • 共有を促進するには、Topic_Assignment__c とトピック間に主従関係を設定し、トピックの割り当て用の他のオブジェクトへの参照関係を設定することを検討します。
• 必要であれば、サイトユーザーとの共有を促進するために、Topic__c オブジェクトに [サイト識別子] 選択リスト項目などのカスタム項目を追加することを検討してください。
• LWR サイトのゲストユーザー用に Topic__c オブジェクトと Topic_Assignment__c オブジェクトに適切なオブジェクト権限を付与します。
• Topic__c レコードをゲストユーザーのレコードと共有するためのゲスト共有ルールを作成します。Topic_Assignment__c レコードに Topic__c に対する主従関係がある場合は、Topic_Assignment__c レコードも表示されます。

レコードデータの抽出、変換、読み込み (ETL)

• トピックとトピックの割り当て
  • Aura サイトで現在使用されているオブジェクトのトピックとトピックの割り当てをすべてエクスポートします。
  • トピックを新しいカスタムオブジェクト Topic__c にインポートします。
  • トピックの割り当てを新しいカスタムオブジェクト Topic_Assignment__c にインポートします。新しい Topic__c レコードは、トピックの割り当てが関連付けられた EntityId に関連付けます。
• URL 項目を含むレコード
  • URL 項目を含むレコードをエクスポートします。
  • URL 項目の値を新しいサイト URL でローカルに更新します。 ファイルを組織にインポートしてレコードを更新します。

ユーザー共有と権限

• ゲストユーザー
  • LWR サイトを作成すると、新しいゲストユーザーが自動的に作成されます。Aura サイトのゲストユーザーのプロファイル権限と権限セットの割り当てを確認し、必要な設定を LWR サイトのゲストユーザーに引き継ぎます。
  • Aura サイトのゲストユーザー用のゲストユーザー共有ルールがすでに存在しており、それが依然として必要である場合は、そのルールを LWR サイトのゲストユーザー用に複製します。
• 認証済みユーザー
  • 認証済みユーザーの既存の共有メカニズムは、Aura サイトから LWR サイトに引き継がれます。
  • 新しい LWR サイト用に作成した新しいカスタムオブジェクトまたはコンポーネントの共有メカニズムを作成します。
  • 既存のプロファイル、権限セット、および権限セットの割り当ては、Aura サイトから LWR サイトに引き継がれます。

CSS

• Aura の標準マークアップを対象とする CSS の上書きは、LWR のマークアップには適用されません。CSS スタイルシートを更新する必要があります。
• LWR サイトには、サイトレベルの専用の CSS エディターはありません。CSS はヘッドマークアップに直接追加します。LWR サイトのコンポーネントでは、[スタイル] タブに [CSS クラス] セクションがあります。このセクションで CSS クラスをコンポーネントレベルで追加できます。
• スタイルシートがアーカイブ (.zip) に含まれているファイルの場合、マークアップは次のようになります。

  • <link type="text/css" rel="stylesheet" href="{ basePath }/resource/<apiName>/<stylesheetFileName>.css?{ versionKey }" />

• スタイルシートが静的リソースとして直接アップロードされた唯一のファイルで、アーカイブ (.zip) に含まれていない場合、マークアップは次のようになります。

  • <link type="text/css" rel="stylesheet" href="{ basePath }/resource/<apiName>?{ versionKey }" />

• LWC の CSS が正しく機能することをテストして確認します。
• LWR サイトの設計トークンは Aura サイトとは異なります。コンポーネントとスタイルシートで使用されるトークンを更新するには、–dxp スタイルフックのドキュメントを参照してください。

Google アナリティクスとその他のヘッドマークアップスクリプトおよびスタイルシート

• Google アナリティクス
  • Google アナリティクスの標準インテグレーションを使用している場合は、LWR で再設定が必要になります。LWR サイトで Aura サイトのドメイン名が使用されている限り、同じ Google アナリティクス ID を使用できます。
  • ヘッドマークアップでスクリプトを使用している場合は、そのスクリプトを LWR サイトに貼り付けます。LWR サイトで Aura サイトのドメイン名が使用されている限り、スクリプトは機能します。
• スタイルシートとその他の静的リソース
  • LWR サイトのヘッドマークアップにスタイルシート、JavaScript ファイル、その他の静的リソースを含めます。

サイトマップとスナップショットの生成

• サイトマップとスナップショットは my.site.com ドメインで生成されます。つまり、それらをテストしてから、カスタムドメインを Aura から LWR サイトに移行できます。SEO への影響を最小限に抑えるために、サイトマップとスナップショットが正しく入力されていることを確認します。
• /s/sitemap.xml から /sitemap.xml にリダイレクトすることを検討します。これにより、サイトマップの至る所を更新しなくても、サイトマップの送信を新しいサイトマップにリダイレクトできます。

ファイルアセットの画像

• ファイルアセットを /file-asset/<fileAssetAPIName> として参照している場合は、/sfsites/c/file-asset/<fileAssetAPIName> に更新する必要があります。

CMS

• Winter ’24 では、すべての CMS ワークスペースのコンテンツを LWR サイトに公開できます。
• LWR サイトに CMS コンポーネントはありません。LWR サイトで CMS コンテンツを表示するには、データバインドを使用します。

リダイレクト

次のリダイレクトを追加することを検討します (CSV 形式)。

• /s、/ および /s/、/: Aura ホームページの URL を LWR ホームページの URL にリダイレクトします。
• /s/sitemap.xml、/sitemap.xml: 検索エンジンクローラーに再送信する代わりに、Aura サイトマップの URL を LWR サイトマップの URL にリダイレクトします。 
• /s/(customPage)、/(customPage): すべてのページをキャッチして 1 レベルのページをそれに対応する LWR 内の 1 レベルのページにリダイレクトします。
• /s/article/(articleAlias)、/article/(articleAlias): ナレッジ記事のリダイレクト。/s/contact/(contactId)、/contact/(contactId): オブジェクト詳細ページのリダイレクト。(contact は例として使用されていますが、どの標準オブジェクトやカスタムオブジェクトにも同じ構造を適用できます。)
• 外部 URL リダイレクトはサポートされていません。外部 URL リダイレクトが必要な場合は、まず Visualforce ページにリダイレクトし、そこから外部にリダイレクトするソリューションを設定します。

マルチ言語サイト

• 新しい LWR 言語の URL 構造は、Aura のようにクエリパラメーターではなく、パスとなっています。「Create a Multilingual LWR Site (マルチ言語 LWR サイトの作成)」を参照してください。

Visualforce ページ

• Aura サイトで Visualforce ページ (カスタム robots.txt ファイル、カスタムサイトマップ、その他のカスタム Visualforce ページなど) を実行する場合、Aura と LWR では、Visualforce ページを実行するときの URL 構造が違うことに注意してください。
• Aura では、サイトは /s パスの背後で提供され、Visualforce ページは 1 つ上のレベルで提供されます。
  • 例: mycompany.my.site.com/helpcenter/s/のAuraサイトでは、mycompany.my.site.com/helpcenter/apex/myVisualforcePageのVisualforceページを提供します。
  • 例: helpcenter.mycompany.com/s/のAuraサイトでは、helpcenter.mycompany.com/apex/myVisualforcePageのVisualforceページを提供します。
• LWR サイトはサイトパスの直後のルートで提供され (ある場合)、Visualforce ページはそのサイトのデフォルトとして自動的に作成されたパスから提供されます。Visualforce ページの自動作成されたパスは、サイトのパス + 「vforcesite」の組み合わせで構成されます。このパスは、[設定] の [カスタム URL] セクションから、必要に応じてカスタマイズしたり変更したりできます。
  • 例: mycompany.my.site.com/helpcenter/ の LWR サイトでは、mycompany.my.site.com/helpcenter/helpcentervforcesite から Visualforce ページを提供します。
  • 例: helpcenter.mycompany.com の LWR サイトでは、helpcenter.mycompany.com/vforcesite から Visualforce ページを提供します。

Mobile Publisher アプリケーション

• Mobile Publisher では、LWR サイトのベータサポートが提供されています。
  • Playground アプリケーションでは、「/s」の有無に関係なく LWR サイトが許可されます。
  • 「LWR (ベータ) の制限事項」を確認してください。 
• ベータアプリケーションの作成や要求を行う前に、アプリケーションを Playground アプリケーションでテストすることを強くお勧めします。

メモ この機能はベータサービスです。ベータサービスはお客様独自の裁量で試行するものとします。ベータ機能の使用には、「Agreements and Terms」に記載されたベータサービス規約が適用されます。