Lightning Web Runtime(LWR)으로 Aura 사이트를 마이그레이션하기 전 고려 사항

일반

• 특정 사이트 기능에 대한 특정 구성 요소가 포함된 Aura 템플릿과 달리 LWR 템플릿은 데이터 바인딩과 같은 개념을 사용하여 같은 목표를 달성하는 더 일반적인 구성 요소를 제공하며 더 빠르고 동적입니다.

사용자 정의 Aura 구성 요소

• 사이트의 사용자 정의 Aura 구성 요소를 식별하고 Lightning 웹 구성 요소(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 사이트의 기존 사이트 페이지를 미러링하는 동일한 기본 URL을 LWR 사이트에서 사용하는 것이 좋습니다. 예를 들어, www.company.com/s/my-custom-page와 같은 기존 Builder 페이지가 있는 경우, LWR 사이트의 기본 URL로 /my-custom-page를 사용합니다.
• 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에 주제를 가져옵니다.
  • 주제 할당을 주제 할당이 EntityId와 연결된 새 Topic__c 레코드와 연결하여 새 사용자 정의 개체 Topic_Assignment__c로 주제 할당을 가져옵니다.
• 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 Analytics 및 기타 헤드 마크업 스크립트 및 스타일 시트

• Google Analytics
  • Google Analytics 표준 통합을 사용하는 경우 LWR에서 재구성해야 합니다. LWR 사이트가 Aura 사이트의 도메인 이름을 사용하는 경우 동일한 Google Analytics 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): Knowledge 기사 redirect./s/contact/(contactId), /contact/(contactId): 개체 세부 사항 페이지 리디렉션입니다. (여기에서는 연락처가 예로 사용되지만 모든 표준 또는 사용자 정의 개체에 동일한 구조를 적용할 수 있습니다.)
• 외부 URL 리디렉션은 지원되지 않습니다. 외부 URL 리디렉션이 필요한 경우 Visualforce 페이지로 리디렉션되어 외부로 리디렉션되는 솔루션을 설정합니다.

다국어 사이트

• 새 LWR 언어 URL 구조는 Aura에서와 마찬가지로 쿼리 매개 변수가 아닌 경로입니다. 다국어 LWR 사이트 만들기를 참조하십시오.

Visualforce 페이지

• 사용자 정의 robots.txt 파일, 사용자 정의 사이트 맵 또는 기타 사용자 정의 Visualforce 페이지 등 Visualforce 페이지를 Aura 사이트에서 실행하는 경우 Visualforce 페이지를 실행할 수 있도록 Aura와 LWR 간 URL 구조의 차이점을 기록합니다.
• Aura에서 사이트는 /s 경로 뒤에서 제공되며 Visualforce 페이지는 한 수준 더 높게 제공됩니다.
  • 예: 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 앱에서 앱을 테스트하는 것이 좋습니다.

노트 이 기능은 베타 서비스입니다. 고객은 자유 재량에 따라 해당 베타 서비스를 사용해 볼 수 있습니다. 베타 서비스 사용은 협약 및 조건에서 제공된 베타 서비스 조건이 적용됩니다.