표준 데이터 모델 사이트를 향상된 데이터 모델로 마이그레이션(프리뷰)

[이 항목은 시험판 문서이며 변경될 수 있습니다.]

이 문서에서는 기존 표준 데이터 모델 사이트를 향상된 데이터 모델로 마이그레이션하는 방법을 알아봅니다.

전제 조건

• 사이트를 향상된 데이터 모델로 마이그레이션하려면 버전 1.31.6 이상의 Microsoft Power Platform CLI을 설치해야 합니다. 추가 정보: 최신 Power Platform CLI 설치
• Dataverse 기본 포털 패키지 9.3.2307.x 이상. 
• Power Pages 코어 패키지 1.0.2309.63 이상. 추가 정보: Power Pages 솔루션 업데이트
• 마이그레이션 단계를 완료하려면 Power Pages의 Power Platform CLI를 사용하는 방법을 이해해야 합니다. Power Pages의 Power Platform CLI에 익숙하지 않은 경우 이 Power Platform CLI 자습서를 검토하고 Power Pages 작업을 위한 5PAC CLI 명령을 참조할 수 있습니다.
• 관리 모드로 설정된 환경의 경우 백그라운드 작업을 사용하도록 설정합니다.

1단계. 기존 표준 사이트 메타데이터에 대한 사용자 지정 다운로드 및 확인

1. 명령 프롬프트가 엽니다.

2. 마이그레이션을 위한 웹 사이트 기록을 다운로드하려면 다음 명령을 사용하여 Power Platform 환경에 대해 Dataverse 조직을 인증하세요.

   pac auth create -u [Dataverse URL]

   예

   pac auth create -u https://contoso-org.crm.dynamics.com

   추가 정보: pac 인증 만들기

3. 현재 조직의 웹 사이트 목록을 생성하려면 다음 명령을 사용하세요.

   pac pages list

   추가 정보: pac 페이지 목록

4. 사용자 지정 보고서를 다운로드하려면 다음 명령을 사용하십시오.

   pac pages migrate-datamodel --webSiteId [WebSiteId-GUID] --siteCustomizationReportPath [PATH]

   예

   pac pages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --siteCustomizationReportPath "c:\\pac-powerpages\\downloads"

다운로드한 보고서에서 사용자 지정을 발견한 경우 보고서의 지침에 따라 향상된 데이터 모델로 마이그레이션한 후 수정하세요. 추가 정보: 표준 데이터 모델에서 고급 데이터 모델로 사이트를 마이그레이션할 때 사이트 사용자 지정에 대한 고려 사항

2단계. 사이트 데이터를 표준에서 향상된 데이터 모델로 마이그레이션

다음 명령을 사용하여 사이트 데이터를 향상된 데이터 모델로 마이그레이션합니다.

pac pages migrate-datamodel --webSiteId [WebSiteId-GUID] –-mode [type-of-data]

모드에는 3가지 값이 있을 수 있습니다.

• configurationData: 웹 사이트의 메타데이터를 마이그레이션합니다. 추가 정보: 구성 데이터를 저장할 테이블 목록

• configurationDataReferences: 웹 사이트의 거래 데이터를 마이그레이션합니다. 추가 정보: 비구성 데이터를 저장할 테이블 목록

• 모두: 두 가지 유형의 데이터를 모두 마이그레이션합니다.

예

pac pages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e –-mode all

마이그레이션 도구는 솔루션을 확인합니다. 언급된 템플릿에 대한 각각의 향상된 데이터 모델 솔루션 없이 표준 데이터 모델 솔루션이 있는 경우 Found template <template-name>. One of the prerequisite for migrate needs Enchanged data model template 경고가 표시됩니다.

마이그레이션된 웹 사이트가 제대로 작동하는지 확인하기 위해 향상된 데이터 모델 패키지와 일치해야 하는 프로그램 등록, 회의 예약 및 관리와 같은 특정 템플릿이 있습니다. 이러한 향상된 데이터 모델 패키지를 얻으려면 해당 템플릿에 대한 새 사이트를 생성하여(향상된 데이터 모델에 대해 환경을 활성화해야 함) 마이그레이션을 위한 향상된 데이터 모델 호환 솔루션을 제공해야 합니다.

마이그레이션에 지원되는 템플릿

다음 템플릿이 있는 사이트는 마이그레이션이 지원됩니다.

• 스타터 레이아웃 1-5
• 애플리케이션 처리 중
• 빈 페이지
• 프로그램 등록
• 모임 예약 및 관리

3단계. 마이그레이션 상태 확인

사이트의 마이그레이션 상태를 확인하려면 다음 명령을 사용하십시오.

pac pages migrate-datamodel --webSiteId [WebSiteId-GUID] --checkMigrationStatus

예

pac pages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --checkMigrationStatus

4단계. 성공적인 데이터 마이그레이션 후 사이트 데이터 모델 버전 업데이트

다음 명령 업데이트 사이트 데이터 모델 버전을 사용하십시오.

pac pages migrate-datamodel --webSiteId [WebSiteId-GUID] --updateDatamodelVersion --portalId [Portal-GUID]

예

pac pages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --updateDatamodelVersion --portalId 04435d71-c45a-4a05-9702-8f127559e48e

마이그레이션된 사이트를 고급 데이터 모델에서 표준 데이터 모델로 되돌리기

마이그레이션 후 표준 데이터 모델 사이트를 고급 데이터 모델로 되돌리려면 다음 명령을 사용합니다.

pac pages migrate-datamodel --webSiteId [WebSiteId-GUID] --revertToStandardDataModel --portalId [Portal-GUID]

예

pac pages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --revertToStandardDataModel --portalId 07f35d71-c45a-4a05-9702-8f127559e48e

프로덕션 사이트를 표준에서 향상된 데이터 모델로 마이그레이션

프로덕션 사이트를 마이그레이션하기 전에 프로덕션 사이트의 전체 복사본을 만드는 것이 좋습니다. 또한 업무 시간 외 시간에 프로덕션 사이트 마이그레이션을 수행하는 것이 좋습니다.

다음 단계를 사용하여 프로덕션 사이트를 향상된 데이터 모델로 마이그레이션합니다.

1. PAC CLI migrate-datamodel 명령을 사용하여 복사된 환경의 사이트에서 마이그레이션을 시도해 보세요.
2. 관리형 솔루션에 사이트 구성 데이터를 추가하고 프로덕션 환경으로 가져옵니다.
3. PAC CLI 명령을 사용하여 비구성 데이터를 마이그레이션하고 프로덕션용 데이터 모델 버전을 업데이트하여 완료합니다.

표준 데이터 모델에서 고급 데이터 모델로 사이트를 마이그레이션할 때 사이트 사용자 지정에 대한 고려 사항

이 섹션에서는 표준 데이터 모델에서 고급 데이터 모델로의 사이트 마이그레이션에 대한 사용자 지정 수정 지침을 제공합니다.

adx 메타데이터 테이블에는 5가지 유형의 사이트 사용자 지정이 있습니다.

• adx 메타데이터 테이블의 사용자 지정 열
• 사용자 지정 테이블과 adx 테이블 간의 관계
• Liquid 코드 조각의 adx 테이블 참조
• 가져오기 XML의 adx 테이블 참조
• adx 테이블의 사용자 지정 워크플로 및 플러그인

adx 메타데이터 테이블의 사용자 지정 열

향상된 데이터 모델에서 이 사용자 지정을 수정하려면 시스템 테이블과 새 사용자 지정 테이블 간의 관계를 생성하고 데이터를 새 테이블로 마이그레이션합니다.

표준 데이터 모델:adx_webpage 테이블에는 contoso_pagetype과 같은 사용자 지정 열이 포함되어 있습니다.

향상된 데이터 모델:contoso_webpage이라는 새 테이블을 만듭니다. 여기에는 contoso_pagetype이라는 열과 contoso_webpage_id과 연결된 조회 열 powerpagescomponent이 포함됩니다. 테이블 생성을 위해 데이터 작업 영역을 활용하세요.

사용자 지정 테이블과 adx 테이블 간의 관계

향상된 데이터 모델에서 이 사용자 지정을 수정하려면 사용자 지정 테이블과 시스템 테이블 간의 관계를 만듭니다.

표준 데이터 모델:adx_webpage 테이블에는 adx_webpage_contoso_pagelogs 테이블과 contoso_pagelogs라는 관계가 있습니다.

향상된 데이터 모델:powerpagecomponent_contoso_pagelogs 테이블을 사용하여 contoso_webpage라는 새 관계를 만듭니다. 테이블 생성을 위해 데이터 작업 영역을 활용하세요.

Liquid 코드 조각의 adx 테이블 참조

향상된 데이터 모델에서 이 사용자 지정을 수정하려면 유동 코드의 adx 테이블 참조를 향상된 데이터 모델 가상 테이블 mspp 참조로 바꾸세요. 또는 구성 요소 유형(논리 이름 powerpagecomponent) 특성과 함께 사이트 구성 요소(논리 이름 powerpagecomponenttype) 테이블을 사용하여 해당 참조를 검색할 수 있습니다.

표준 데이터 모델:entities Liquid 태그는 코드의 {% assign app_weblinks= entities['adx_weblinks'] %} 값에 액세스하는 데 사용됩니다.

향상된 데이터 모델:entities Liquid 태그를 통해 웹링크를 사용하는 대신 각각의 Liquid 개체를 사용하세요. entities[adx_weblinks] 직접. 이 경우 entities['adx_weblinks']는 weblinks Liquid 개체로 대체될 수 있습니다.

가져오기 XML의 adx 테이블 참조

향상된 데이터 모델에서 이 사용자 지정을 수정하려면 가져오기 xml의 adx 테이블 참조를 향상된 데이터 모델 가상 테이블 직접 참조로 바꿉니다. 또는 구성 요소 유형(논리 이름 powerpagecomponent) 특성과 함께 사이트 구성 요소(논리 이름 powerpagecomponenttype) 테이블을 사용하여 해당 참조를 검색할 수 있습니다.

표준 데이터 모델:adx_webrole 테이블 이름은 가져오기 xml 쿼리 내에서 사용됩니다.

{% fetchxml app_webroles %}
<fetch>
 <entity name='adx_webrole'>
  <attribute name='adx_name'/>
 <entity>
</fetch>
{% endfetchxml %}

향상된 데이터 모델: 해당 참조를 검색하려면 구성 요소 유형(논리 이름 powerpagecomponent) 특성과 함께 사이트 구성 요소(논리 이름 powerpagecomponenttype)를 사용하십시오.

{% fetchxml app_webroles %}
<fetch>
 <entity name='powerpagecomponent'>
  <attribute name='adx_name'/>
  <filter type='and'>
   <condition attribute ='powerpagecomponenttype' operator ='eq' value ='11'/>
  <entity>
</fetch>
{% endfetchxml %}

사이트 구성 요소 유형 및 값

adx 테이블의 사용자 지정 워크플로 및 플러그인

향상된 데이터 모델에서 이 사용자 지정을 수정하려면 워크플로 및 플러그인 논리를 리팩터링하고 사이트의 해당 테이블에 다시 등록해야 합니다.

예를 들어, 사용자가 워크플로우/플러그인을 표준 데이터 모델의 웹 페이지(논리 이름 ) 테이블로 adx_webpage에 등록한 경우 워크플로/플러그인 내의 코드를 사이트 구성 요소(논리 이름 powerpagecomponent) 테이블 및 향상된 데이터 모델에 대한 해당 특성으로 수정해야 합니다.

알려진 문제점

마이그레이션 명령은 표준 데이터 모델에서 고급 데이터 모델로의 5K 레코드 배치만 처리합니다.