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

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

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

중요

• 이 기능은 프리뷰 기능입니다.
• 프리뷰 기능은 생산용으로 만들어진 것이 아니므로 기능이 제한될 수 있습니다. 이런 기능은 공식 릴리스 전에 사용할 수 있으므로 고객이 조기에 액세스하고 피드백을 제공할 수 있습니다.

전제 조건

• 사이트를 향상된 데이터 모델로 마이그레이션하려면 버전 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 powerpages list

   추가 정보: pac Power Pages 목록

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

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

   예

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

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

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

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

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

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

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

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

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

예

pac powerpages 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 powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --checkMigrationStatus

예

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

참고

사이트 마이그레이션이 예상보다 오래 걸리는 경우 데이터 양이 원인일 수 있습니다. 명령 프롬프트가 닫히면 새 명령 프롬프트를 열고 이 단계의 명령을 사용하여 사이트 상태를 확인하세요.

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

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

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

참고

• 웹사이트 URL에 '/_services/about'이 추가된 웹 사이트로 이동하면 포털 ID를 찾을 수 있습니다. 이러한 옵션을 보려면 사용자에게 모든 웹사이트 액세스 권한이 할당된 웹 역할이 있어야 합니다.
• 사이트 데이터 모델 버전이 업데이트되면 표준 데이터 모델에 연결된 웹 사이트 레코드가 비활성화됩니다. 대신 이제 사이트는 향상된 데이터 모델과 관련된 웹사이트 레코드를 참조하게 됩니다.
• updateDatamodelVersion 또는 revertToStandardDataModel 인수를 사용하여 마이그레이션 명령을 실행하려면 사용자에게 다음 역할 중 하나가 있어야 합니다. 이는 데이터 모델을 향상시키거나 그 반대로 사이트를 전환하는 관리 작업을 수행합니다.
  • 시스템 관리자
  • Dynamics 365 관리자
  • Power Platform 관리자

예

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

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

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

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

참고

마이그레이션된 사이트를 향상된 데이터 모델에서 표준 데이터 모델로 다시 전환하면 향상된 데이터 모델과 연결된 웹 사이트 레코드가 비활성화되고 표준 데이터 모델에 대한 웹 사이트 레코드가 다시 활성화됩니다.

예

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

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

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

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

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

참고

마이그레이션의 경우 소스 및 프로덕션 웹 사이트 ID가 동일합니다.

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

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

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

• adx 메타데이터 테이블의 사용자 정의 열
• 사용자 정의 테이블과 adx 테이블 간의 관계
• liquid 코드 코드 조각의 Adx 테이블 참조
• Fetch 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 참조로 바꾸세요. 또는 구성 요소 유형(논리 이름 powerpagecomponenttype) 특성과 함께 사이트 구성 요소(논리 이름 powerpagecomponent) 테이블을 사용하여 해당 참조를 검색할 수 있습니다.

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

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

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

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

표준 데이터 모델: 테이블 이름 adx_webrole 은 fetch 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 %}

사이트 구성 요소 유형 및 값

구성 요소 유형	값
게시 상태	6
웹 페이지	2
웹 파일	3
웹 링크 설정	4
웹 링크	5
페이지 템플릿	6
콘텐츠 조각	7
웹 템플릿	8
사이트 설정	9
웹 페이지 Access Control 규칙	10
웹 역할	11
웹 사이트 액세스	12
사이트 마커	13
기본 양식	15
기본 양식 메타데이터	16
List	17
테이블 권한	18
고급 양식	19
고급 양식 단계	20
고급 양식 메타데이터	21
설문 조사 배치	24
광고 배치	26
봇 소비자	27
열 권한 프로필	28
열 권한	29
리디렉션	30
게시 상태 전환 규칙	31
바로 가기	32
클라우드 흐름	33
UX 구성 요소	34

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

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

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

알려진 문제점

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