표준에서 향상된 데이터 모델 마이그레이션 개요

Microsoft Power Platform CLI 마이그레이션 유틸리티는 기존 Power Pages 사이트의 지원되는 구성 및 관련 레코드를 표준 데이터 모델에서 향상된 데이터 모델로 이동한 다음 마이그레이션된 구성을 사용하도록 사이트를 전환합니다.

표준 데이터 모델은 adx_ 접두사를 사용하는 테이블에 Power Pages 사이트 구성을 저장합니다. 향상된 데이터 모델은 사이트 구성 요소 테이블(powerpagecomponent)에 사이트 구성을 저장하고 구성 요소 유형별로 각 구성 요소를 식별합니다. 마이그레이션 유틸리티의 작동 방식, 지원하는 템플릿 및 자동으로 업데이트되지 않는 사용자 지정을 이해하면 사이트를 이동하는 시기와 방법을 결정하는 데 도움이 됩니다.

향상된 데이터 모델 이점을 검토하면 사이트 마이그레이션을 고려할 수 있는 이유가 설명됩니다.

모든 adx_* 테이블이 powerpagecomponent로 이동하는 것은 아니라는 점에 유의해야 합니다. 사이트의 구조 및 작성 화면(예: adx_webpage, adx_webtemplate, adx_contentsnippet, adx_weblinkadx_pagetemplateadx_entityformadx_sitesettingadx_entitylist , 및 )을 설명하는 메타데이터 adx_* 테이블만 통합 powerpagecomponent 됩니다(행별 속성이 콘텐츠 JSON 열로 이동됨).

트랜잭션/런타임 adx_* 테이블, 즉 adx_invitation, adx_externalidentity, adx_inviteredemption, adx_portalcomment와 엔터티 양식/고급 양식 제출 및 로그 테이블처럼 런타임에 최종 사용자 활동을 캡처하는 테이블은 powerpagecomponent로 마이그레이션되지 않으며, 기존 스키마에 그대로 남아 이전과 동일하게 런타임 데이터를 계속 저장합니다. 이러한 트랜잭션 테이블의 변경 사항은 참조 마이그레이션 중에 메타데이터 레코드에 대한 조회가 다시 연결되어 레거시 메타데이터 adx_* 행 대신 새 powerpagecomponent 행을 가리킨다는 것입니다.

표준 데이터 모델에 대해 작성된 기존 사이트는 adx_* 테이블에서 계속 실행되므로 향상된 데이터 모델의 이점을 활용하려면 각 사이트를 마이그레이션해야 합니다. 마이그레이션은 사이트의 구성 메타데이터를 향상된 데이터 모델 powerpagecomponent 셰이프로 이동하고, 트랜잭션 참조를 새 메타데이터 레코드로 다시 연결하고, 향상된 데이터 모델에서 제공하도록 사이트 레코드를 대칭 이동합니다. 또한 이곳은 사용자 지정 adx_* 열, adx_* 특성을 읽는 Liquid, adx_* 테이블에 대한 FetchXML, 플러그인 및 워크플로와 같은 사용자 지정이 드러나고 해결되는 곳이기도 합니다. 이러한 사용자 지정은 자동으로 이관되지 않으므로, 향상된 데이터 모델에서 작동하도록 다시 작성하거나 재구성해야 합니다.

Prerequisites

Microsoft Power Platform CLI버전 2.11.2 이상으로, 사이트 다운로드, 마이그레이션, 상태, 활성화 및 롤백 명령을 실행합니다. 자세한 내용은 최신 Power Platform CLI 설치를 참조하세요.
필요한 기본 포털 구성 요소를 제공하는 Dataverse 기본 포털 패키지 CDSBasePortal9.3.2607.x 이상.
Power Pages Core 패키지 PowerPages_Core1.0.2605.x 이상- 필요한 Power Pages 런타임 구성 요소를 제공합니다. Power Pages 솔루션을 업데이트합니다.
활성 데이터 모델을 전환하거나 되돌리는 데 필요한 시스템 관리자, Dynamics 365 관리자 또는 Power Platform 관리자 역할입니다.
Power Pages 위한 Power Platform CLI에 대한 숙지
환경이 관리 모드인 경우 백그라운드 작업이 사용하도록 설정됩니다.

마이그레이션 유틸리티 기능

마이그레이션 유틸리티는 지원되는 사이트 구성 및 관련 레코드를 향상된 데이터 모델에 복사합니다. 마이그레이션이 완료되면 활성 사이트가 향상된 데이터 모델로 전환되고 정상 사용으로 돌아오기 전에 유효성이 검사됩니다.

마이그레이션 유틸리티:

수동 변경이 필요할 수 있는 사용자 지정 보고서를 생성합니다.
지원되는 사이트 구성 및 관련 레코드를 마이그레이션합니다.
활성 데이터 모델을 전환하기 전에 마이그레이션 상태를 확인할 수 있습니다.
유효성 검사에서 중요한 문제를 식별하는 경우 사이트를 표준 데이터 모델로 되돌릴 수 있습니다.

Important

마이그레이션 유틸리티는 표준 데이터 모델 테이블에 직접 의존하는 모든 사용자 지정을 자동으로 업데이트하지 않습니다. 프로덕션을 사용하기 전에 사용자 지정 보고서를 검토하고 영향을 받는 사용자 지정 코드를 수정하고 마이그레이션된 사이트를 테스트합니다.

지원되는 템플릿

다음 템플릿에서 만든 기존 표준 데이터 모델 사이트를 마이그레이션할 수 있습니다.

스타터 레이아웃 1-5
애플리케이션 처리 중
빈 페이지
프로그램 등록
모임 예약 및 관리
FAQ
커뮤니티 포털(Dynamics 365)
고객 Self-Service 포털(Dynamics 365)
Employee Self-Service Portal(Dynamics 365)
파트너 포털(Dynamics 365)

메모

향상된 데이터 모델을 사용하여 새 사이트를 만들고 기존 사이트를 마이그레이션하는 것은 별도의 기능입니다. 사이트의 원래 서식 파일이 여기에 나열되지 않은 경우 해당 사이트에 대한 마이그레이션 유틸리티를 실행하지 마세요.

시작하기 전 주의 사항:

추가 계획 고려 사항:

향상된 데이터 모델 환경 설정으로 전환하면 새 사이트에 사용되는 데이터 모델이 제어됩니다. 설정을 켜면 기존 사이트가 마이그레이션되지 않습니다.
먼저 프로덕션 환경의 전체 복사본에서 마이그레이션을 실행합니다. 마이그레이션하기 전에 사용자 지정 수정 및 유효성 검사를 완료합니다.
조직의 표준 백업 및 복원 프로세스를 사용하여 프로덕션 환경을 백업합니다.
최종 프로덕션 스위치 및 유효성 검사에 대한 유지 관리 기간을 계획합니다.
웹 사이트 ID, 포털 ID, 환경 URL, CLI 버전, 패키지 버전, 마이그레이션 시작 시간 및 명령 출력 양식을 마이그레이션 레코드의 일부로 기록합니다.

환경 시퀀스 계획

마이그레이션은 각 환경에 대해 서로 다른 모드를 사용하여 다양한 환경을 지원합니다.

환경	권장 모드	수행할 일
개발	`configurationData`	구성을 마이그레이션하고, 사용자 지정 보고서를 검토하고, 사용자 지정을 수정하고, 유효성을 검사하고, 솔루션에서 구성을 캡처합니다.
테스트 또는 UAT	`configurationDataReferences`	개발에서 테스트된 솔루션을 가져오고, 지원되는 관련 레코드를 마이그레이션하고, 향상된 데이터 모델을 활성화하고, 유효성을 검사합니다.
프로덕션	`configurationDataReferences`	유효성이 검사된 관리 솔루션을 가져오고, 지원되는 관련 레코드를 마이그레이션하고, 유지 관리 기간 동안 활성화하고, 프로덕션 유효성 검사를 완료합니다.
단일 환경 또는 단순 사이트	`all`	사용자 지정 영향을 이해하고 다중 환경 솔루션 경로를 사용하지 않는 경우에만 구성 및 관련 레코드를 한 작업으로 마이그레이션합니다.

작업 폴더 만들기

빈 작업 폴더를 사용하여 보고서, 다운로드한 사이트 원본 및 비교 파일을 보관합니다. 다음 예제에서는 이 위치에 사용합니다 \<OUTPUT\> .

mkdir C:\PowerPagesMigration\<site-name>
cd C:\PowerPagesMigration\<site-name>

마이그레이션 단계

마이그레이션 프로세스는 다음 네 단계로 구성됩니다.

사전 검사 — 사이트, ID, CLI, 패키지, 템플릿 솔루션 및 마이그레이션 상태를 확인합니다.
구성 - 개발에서 구성을 마이그레이션하거나 다운스트림 환경에서 테스트된 구성을 가져옵니다.
마이그레이션 및 활성화 - 관련 레코드를 마이그레이션하고, 완료를 확인하고, 모델을 전환하고, 다시 시작합니다.
검증 — 동작, 권한, 사용자 지정 코드 및 템플릿 여정을 테스트합니다.

1단계(사이트 검색 및 사전 검사) 및 4단계(마이그레이션 후 유효성 검사)는 모든 사이트에 대해 동일한 방식으로 실행됩니다.

2단계와 3단계는 트랙에 따라 분기되며, 그 형태는 환경 유형으로부터 트랙을 도출하는 마이그레이션 모드에 따라 달라집니다.

제작 트랙(모드 configurationData 또는all)은 개발 및 단일 환경 설정에 사용됩니다. 메타데이터 자체는 로컬로 마이그레이션되고 트랜잭션 참조가 이동하기 전에 표준 데이터 모델 원본에 대해 사용자 지정을 검사하고 수정합니다.

다운스트림 트랙(모드configurationDataReferences)은 Dev에서 ALM 솔루션 가져오기를 통해 구성 메타데이터가 도착한 것으로 간주되는 테스트, UAT 및 프로덕션 환경에 사용됩니다. 트랜잭션 참조만 이 트랙에서 마이그레이션됩니다. 모든 사용자 지정 결과는 로컬에서 수행해야 하는 작업이 아닌 업스트림 ALM 간격을 나타냅니다.

1단계: 사전 검사

pac --version을 사용하여 Power Platform CLI 버전을 확인하세요. 버전이 필요한 버전보다 이전인 경우 계속하기 전에 Microsoft Power Platform CLI를 설치하거나 업데이트합니다.
대상 환경에 인증합니다.
1. pac auth list을 실행합니다.
2. pac auth who을 실행합니다.
활성 인증 프로필이 사이트가 포함된 환경을 가리키는지 확인합니다. 다른 프로필을 선택하거나 프로필을 만들려면 사용 pac auth select 하거나 pac auth create -u "https://contoso.crm.dynamics.com".
다음 방법 중 하나를 사용하여 템플릿에 대한 고급 데이터 모델 솔루션을 설치합니다.
1. 관리 센터에서 EDM(고급 데이터 모델) 플래그를 사용하도록 설정된 템플릿 사이트를 프로비전합니다.
2. CLI를 사용하여 명령으로 설치 pac application install --application-name "PowerPages_PartnerPortal_V2"
사이트를 찾아서 식별자를 pac pages list -v기록합니다.

다음 표에 표시된 값을 기록합니다.

값	사용 용도
웹 사이트 ID	모든 `migrate-datamodel` 명령.
포털 ID	향상된 데이터 모델로 전환하고 표준 데이터 모델로 되돌려 줍니다.
표시 이름 및 URL	관리 센터에서 올바른 사이트를 선택했는지 확인합니다.
데이터 모델 버전	표준이어야 합니다. 이미 고급인 경우 마이그레이션이 필요하지 않습니다.

Important

포털 ID는 Power Pages 앱 ID가 아닙니다. CLI에 포털 ID가 표시되지 않으면 Power Platform 관리 센터의 리소스>Power Pages 사이트>에서 확인할 수 있으며, 또는 필요한 웹 사이트 액세스 권한이 있는 계정으로 로그인한 상태에서 사이트 URL에 /_services/about를 추가하면 됩니다.

다음 명령을 사용하여 이전 또는 진행 중인 마이그레이션을 확인합니다.

pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus

Status	의미	조치
NotStarted 또는 추적기 없음	마이그레이션이 시작되지 않았습니다.	패키지 검사를 계속합니다.
되돌림	이전 마이그레이션이 롤백되었습니다.	되돌려진 이유를 검토한 다음 준비가 되면 계속합니다.
완료됨	마이그레이션이 완료되었지만 사이트가 전환되지 않았을 수 있습니다.	활성 데이터 모델을 확인합니다. 여전히 Standard이면 정품 인증을 계속 진행하세요.
실행 중	마이그레이션은 여전히 처리 중입니다.	상태를 계속 확인합니다. 동일한 사이트에 대해 다른 마이그레이션을 시작하지 마세요.
실패	마이그레이션에 오류가 발생했습니다.	명령 출력 및 환경 세부 정보를 수집하고, 원인을 수정하고, 오류를 이해한 후에만 다시 시도합니다.

메모

마이그레이션이 예상보다 오래 실행되는 경우 Microsoft 지원에 문의하기 전에 웹 사이트 ID, 환경 ID, CLI 버전, 패키지 버전, 명령 출력 및 마이그레이션 시작 시간이 필요합니다. 지원 또는 승인된 Runbook이 지시하지 않는 한 활성 마이그레이션을 다시 설정하면 안 됩니다.

pac solution list --includeSystemSolutions를 사용하여 필요한 자체 패키지를 확인하세요.
1. CDSBasePortal PowerPages_Core사이트 템플릿에 대한 EDM 솔루션이 필요한 버전에 설치되어 있는지 확인합니다.
패키지가 누락되었거나 오래된 경우 Power Platform 관리 센터에서 업데이트합니다.
1. 대상 환경을 엽니다.
2. Resources>Dynamics 365 앱로 이동합니다.
3. 필요한 패키지를 찾습니다.
4. 설치 또는 업그레이드를 선택합니다.
5. 작업이 완료되기를 기다린 다음 다시 실행 pac solution list --includeSystemSolutions 합니다.
메모

템플릿 EDM 솔루션을 직접 설치할 수 없는 경우 동일한 템플릿을 사용하여 동일한 환경에서 임시로 향상된 데이터 모델 사이트를 만들면 일치하는 EDM 솔루션이 설치됩니다. 솔루션이 확인되면 임시 사이트를 삭제할 수 있습니다.
pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --siteCustomizationReportPath "<OUTPUT>"를 사용하여 사용자 지정 보고서를 생성하세요. 보고서를 생성해도 사이트가 변경되지 않습니다.

생성된 CSV 파일을 열고 표준 데이터 모델 테이블을 참조하는 각 항목을 검토합니다. 프로덕션 마이그레이션 전에 필요한 모든 수정에 대한 소유자 및 유효성 검사 단계를 할당합니다.

사용자 지정 범주	Plan
adx_ 메타데이터 테이블의 사용자 지정 열	사용자 지정 데이터를 powerpagecomponent와 관련된 지원되는 사용자 지정 테이블로 이동합니다.
adx_ 메타데이터 테이블에 대한 관계	지원되는 향상된 데이터 모델 테이블에 대한 관계를 다시 만듭니다.
adx_ 테이블에 대한 Liquid 또는 FetchXML 참조	지원되는 Liquid 개체, 가상 테이블 또는 powerpagecomponent를 사용하도록 코드를 업데이트합니다.
adx_ 테이블의 워크플로 및 플러그 인	지원되는 향상된 데이터 모델 테이블에 대해 논리를 리팩터링하고 등록합니다.

메모

사용자 지정 보고서는 마이그레이션 후 모든 사이트 동작이 작동한다는 것을 증명하지는 않습니다. 유효성 검사는 여전히 필요합니다.

마이그레이션 모드를 선택하여 단일 작업에서 유틸리티가 마이그레이션하는 내용을 결정합니다.

Mode	마이그레이션하는 내용	사용하는 경우
구성 데이터	지원되는 사이트 구성 메타데이터(예: 페이지, 웹 서식 파일, 코드 조각, 설정, 양식, 목록, 웹 역할 및 테이블 권한).	개발: 구성을 수정하고 이를 솔루션으로 이동합니다.
구성 데이터 참조	마이그레이션된 사이트 구성을 참조하는 지원되는 레코드입니다.	솔루션 가져오기를 통해 사이트 구성이 적용된 후의 테스트, UAT 및 프로덕션 환경
모두	구성 및 지원되는 관련 레코드 모두.	단일 환경 또는 솔루션 기반 환경 시퀀스를 사용하지 않는 간단한 마이그레이션입니다.

2단계: 사이트 구성

저작 트랙: 개발 환경 또는 단일 환경

pac pages download --webSiteId "<WEBSITE_ID>" --modelVersion 1 --path "<OUTPUT>\site-sdm"를 실행하여 SDM 기준선을 다운로드합니다. 이 명령은 사이트의 이름이 지정된 자식 폴더를 만듭니다. 를 직접 포함하는 폴더를 기록합니다.website.yml
pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --mode configurationData를 실행하여 사이트 구성을 마이그레이션합니다. 단일 작업 경로를 원하는 경우 configurationData를 all로 바꾸세요.
를 실행 pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus하여 마이그레이션 상태를 확인합니다. 다음 PowerShell 루프를 사용하여 최대 30분 동안 분당 한 번씩 상태를 확인합니다.
```
$webSiteId = "<WEBSITE_ID>"
for ($i = 1; $i -le 30; $i++) {
    $output = pac pages migrate-datamodel `
        --webSiteId $webSiteId `
        --checkMigrationStatus 2>&1 | Out-String
    if ($output -match "Completed|Failed|Reverted") {
        Write-Host $output
        break
    }
    Write-Host "Attempt $i/30 - migration is still running."
    Start-Sleep -Seconds 60
}
```
상태가 여전히 Running인 상태에서 루프가 종료되면, 확인은 --checkMigrationStatus부터 계속됩니다. 장기 실행 작업이 반드시 실패한 작업은 아닙니다.
사용자 지정 보고서와 이 문서의 지침을 사용하여 보고된 사용자 지정을 수정하여 영향을 받는 FetchXML, Liquid, 사용자 지정 열, 관계, 워크플로 및 플러그 인을 업데이트합니다. 변경된 각 구성 요소를 다시 테스트합니다. 다운로드한 소스를 업데이트한 경우 website.yml을 실행하여 pac pages upload --path "<OUTPUT>\site-sdm\<site-slug>" --modelVersion 1가 직접 들어 있는 사이트 폴더를 업로드하세요.

다운스트림 트랙: 테스트, UAT 또는 프로덕션

마이그레이션 및 수정된 사이트 구성이 포함된 솔루션을 가져옵니다. Power Platform 관리 센터 또는 설정된 배포 파이프라인을 사용합니다.
```
pac solution import --path "<PATH_TO_SOLUTION_ZIP>" --activate-plugins true --publish-changes true
```
대상 환경에서 Power Pages 관리 앱을 열어 사이트 구성이 있는지 확인합니다. 관련 레코드를 마이그레이션하기 전에 사이트 레코드 및 예상 구성이 있어야 합니다.

지원되는 관련 레코드를 마이그레이션합니다. 이미 사용한 --mode all경우 이 단계를 건너뜁니다. 완료된 것으로 보고될 때까지 상태를 확인 합니다.
```
pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --mode configurationDataReferences
pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus
```
마이그레이션 상태가 성공적으로 완료되었다고 보고되면 활성 사이트를 향상된 데이터 모델로 전환합니다. 표준 데이터 모델 웹 사이트 레코드가 비활성화되고 해당 향상된 데이터 모델 웹 사이트 레코드가 활성화됩니다.
```
pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --updateDatamodelVersion --portalId "<PORTAL_ID>"
```
사이트를 다시 시작합니다.
1. Power Platform 관리 센터를 엽니다.
2. 환경으로 이동한 다음 리소스Power Pages 사이트를선택합니다>.
3. 사이트를 선택합니다.
4. 다시 시작을 선택합니다. 다시 시작을 사용할 수 없는 경우 사이트를 비활성화한 다음 활성화합니다.
5. 유효성 검사 전에 작업이 완료되기를 기다립니다.
다음 방법 중 하나 이상을 사용하여 활성 데이터 모델을 확인합니다.
1. Power Platform 관리 센터에서 사이트를 선택하고 데이터 모델에고급이 표시되는지 확인합니다.
2. Power Pages 디자인 스튜디오에서 사이트의 설치 작업 영역을 열고 표시된 데이터 모델을 확인합니다.
3. Power Pages 관리 앱에서 고급 구성이 열리는지 확인합니다.
4. 데이터 모델 버전을 실행하고 pac pages list -v 확인합니다.
팁 (조언)

사이트 URL 및 시각적 디자인은 활성 데이터 모델이 변경되었기 때문에 변경되지 않습니다. 마이그레이션을 확인하려면 사이트의 모양이 아닌 이러한 검사를 사용합니다.

4단계: 마이그레이션된 사이트의 유효성 검사

사용자에게 프로덕션 사이트를 다시 열기 전에 유효성 검사를 완료합니다. 각 중요한 사용자 유형 및 웹 역할에 대해 테스트 계정을 사용하고 모든 중요한 테스트의 결과를 기록합니다.

영역	유효성을 검사할 내용
페이지 및 콘텐츠	홈페이지, 대표 콘텐츠 페이지, 웹 서식 파일, 콘텐츠 조각, 웹 파일, 탐색, 리디렉션 및 다국어 콘텐츠.
Authentication	로그인, 로그아웃, 등록, 초대, 외부 ID 공급자 및 액세스 거부 환경.
Authorization	웹 역할, 테이블 사용 권한, 열 사용 권한 및 페이지 액세스 규칙은 예상된 작업을 허용하고 거부합니다.
양식 및 목록	기본 양식, 다중 단계 양식, 목록, 양식 메타데이터, 제출, 관련 레코드 및 사이트에서 사용하는 웹 양식 세션입니다.
Dynamics 365 템플릿 경험	템플릿별 페이지 및 액세스 패턴을 포함하여 구현에서 사용하는 주요 고객, 직원, 커뮤니티 또는 파트너 경험입니다.
사용자 지정 코드	사용자 지정 보고서에서 식별된 Liquid, FetchXML, JavaScript, 플러그 인, 워크플로 및 통합입니다.
사이트 설정 및 파일	사이트 설정, 이미지, 첨부 파일, SVG 파일 및 기타 웹 파일이 올바르게 로드됩니다.
데이터 및 참조	중요한 레코드 수 및 지원되는 관련 레코드는 올바른 마이그레이션된 사이트 구성 요소를 가리킵니다.
관리 및 ALM	사이트는 Power Pages 관리에서 열리며 솔루션에 추가, 내보내기 및 솔루션에서 예상대로 가져올 수 있습니다.

브라우저 진단 확인

대표 페이지를 테스트하는 동안 브라우저 개발자 도구를 엽니다. 조사:

adx\_, 엔터티, Liquid 또는 FetchXML을 언급하는 콘솔 오류
사용 권한 또는 웹 역할 문제를 나타낼 수 있는 HTTP 401 또는 403 응답입니다 \_api.
LIQUID, FetchXML, 플러그 인 또는 통합 실패를 나타낼 수 있는 HTTP 500 응답입니다.

마이그레이션 완료 조건

사이트에 향상된 데이터 모델이 표시되고, 핵심 비즈니스 흐름이 모두 통과하며, 예상된 보안 동작이 확인되고, 영향도가 큰 모든 사용자 지정 관련 발견 사항이 해결되거나 수용된 경우에만 마이그레이션이 완료된 것으로 간주합니다.

프로덕션 마이그레이션 시퀀스

다음 프로덕션 시퀀스를 사용하여 마이그레이션 위험을 줄입니다.

리허설을 위해 프로덕션 환경의 전체 복사본을 만듭니다.
복사된 환경에서 CLI, 패키지 및 템플릿 솔루션 필수 구성 요소를 확인합니다.
사용자 지정 보고서를 생성하고 검토합니다.
복사된 개발 환경에서 구성을 마이그레이션합니다.
관리되는 솔루션에서 사용자 지정을 수정하고 유효성이 검사된 사이트 구성을 캡처합니다.
솔루션을 리허설 환경으로 가져오고, 지원되는 관련 레코드를 마이그레이션하고, 향상된 데이터 모델을 활성화하고, 전체 유효성 검사 목록을 완료합니다.
모든 중요한 테스트가 통과될 때까지 수정 및 리허설을 반복합니다.
프로덕션 유지 관리 기간을 예약하고, 유효성 검사 및 롤백 결정 지점을 전달하고, 프로덕션을 백업합니다.
프로덕션 패키지 및 템플릿 솔루션 필수 구성 요소를 다시 확인합니다.
유효성이 검사된 관리 솔루션을 프로덕션으로 가져옵니다.
실행하고 configurationDataReferences, 마이그레이션 상태를 확인하고, 활성 데이터 모델을 전환하고, 사이트를 다시 시작합니다.
프로덕션 유효성 검사 목록을 실행하고 중요한 테스트가 통과한 후에만 사이트를 정상적으로 사용하도록 반환합니다.

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

유효성 검사가 활성화 후 중요한 문제를 식별하는 경우 다음 명령을 사용하여 표준 데이터 모델 웹 사이트 레코드를 다시 활성화합니다.

pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --revertToStandardDataModel --portalId "<PORTAL_ID>"

명령이 완료되면 다음을 수행합니다.

Power Platform 관리 센터에서 사이트를 다시 시작합니다.
사이트에 표준 이 활성 데이터 모델로 표시되는지 확인합니다.
사이트의 중요한 유효성 검사 테스트를 다시 실행합니다.
다른 마이그레이션을 시도하기 전에 마이그레이션 보고서, 오류 세부 정보 및 수정 정보를 유지합니다.

Important

프로덕션 마이그레이션 전에 롤백 결정을 계획합니다. 표준 및 향상된 웹 사이트 레코드는 별도의 레코드이므로 되돌리기 전에 향상된 데이터 모델 전환 후 변경 내용을 검토합니다.

Troubleshooting

메시지 또는 증상	가능한 원인	조치
`pac powerpages migrate-datamodel` 인식되지 않음	이 명령은 잘못된 네임스페이스 또는 오래된 CLI를 사용합니다.	Power Platform CLI를 업데이트하고 사용합니다 `pac pages migrate-datamodel`.
`CDSBasePortal` 또는 `PowerPages_Core` 나열되지 않음	시스템 솔루션이 명령 출력에 포함되지 않았거나 패키지가 설치되지 않았습니다.	`pac solution list --includeSystemSolutions`을 실행합니다. Power Platform 관리 센터에서 누락된 패키지를 설치하거나 업그레이드합니다.
마이그레이션에 지원되지 않는 웹 사이트	원래 템플릿은 지원되지 않거나 패키지 버전이 부족하거나 일치하는 EDM 템플릿 솔루션이 없습니다.	템플릿 솔루션 참조에 나열된 템플릿 자격, 패키지 버전 및 EDM 솔루션을 확인합니다.
에 대해 알 수 없는 인수 `--webSiteId` 가 전달되었습니다. `pac pages upload`	업로드 명령은 웹 사이트 ID 인수를 허용하지 않습니다.	인수를 생략합니다. 사이트는 `website.yml`에서 식별됩니다.
업로드가 잘못된 사이트를 대상으로 하거나 사이트를 찾지 못함	경로는 사이트 폴더 대신 래퍼 폴더를 가리킵니다.	website.yml이 바로 들어 있는 하위 폴더를 사용하세요.
포털 ID에 `Unknown` 또는 `N/A`가 표시됨	사이트가 비활성 상태이거나 설치된 CLI가 값을 반환하지 않습니다.	Power Platform 관리 센터 또는 사이트의 `/_services/about` 페이지에서 포털 ID를 가져옵니다. 앱 ID를 사용하지 마세요.
마이그레이션 보고서에는 `Completed`로 표시되지만 사이트에는 여전히 `Standard`로 표시됩니다.	활성 데이터 모델이 전환되지 않았거나 잘못된 포털 ID가 사용되었습니다.	웹 사이트 ID와 올바른 포털 ID를 사용하여 활성화 명령을 실행한 다음 사이트를 다시 시작하고 확인합니다.
상태가 유지됩니다. `Running`	마이그레이션이 대량의 데이터를 처리하거나 차단됩니다.	상태를 계속 확인합니다. 지원에 문의하기 전에 환경, 패키지, CLI, 시작 시간 및 명령 세부 정보를 수집합니다. 두 번째 마이그레이션을 시작하지 마세요.
상태가 `Failed`	패키지, 템플릿, 사용자 지정, 데이터 또는 서비스 오류로 작업이 중지되었습니다.	전체 명령 출력을 저장하고, 식별된 원인을 수정하고, 실패한 마이그레이션 상태를 검토한 후에만 다시 시도합니다.
사이트가 열리지만 사용자는 예상 데이터에 액세스할 수 없습니다.	웹 역할, 테이블 사용 권한 또는 사용자 지정 쿼리는 마이그레이션 후 예상대로 동작하지 않습니다.	웹 역할, 테이블 사용 권한, 열 권한, FetchXML, Liquid 및 브라우저 네트워크 오류를 검토합니다.

사이트 사용자 지정에 대한 고려 사항

사용자 지정 보고서는 표준 데이터 모델 테이블에 대한 직접 종속성을 식별합니다. 프로덕션 환경에서 사용하기 전에 필요한 시정 조치를 완료하세요.

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

같은 adx_webpage 표준 데이터 모델 테이블에 사용자 지정 열이 포함된 경우 사용자 지정 테이블을 만들어 사용자 지정 데이터를 저장하고 조회를 추가합니다 powerpagecomponent. 사용자 지정 값을 새 테이블로 마이그레이션하고 열을 읽거나 쓰는 코드를 업데이트합니다.

사용자 지정 테이블과 메타데이터 테이블 간의 관계

adx_ 테이블을 가리키는 사용자 지정 관계가 적절한 향상된 데이터 모델 테이블(일반적으로 powerpagecomponent)을 가리키도록 재생성합니다. 종속 양식, 뷰, 플러그 인, 흐름 및 통합을 업데이트합니다.

메타데이터 테이블에 대한 Liquid 참조

지원되는 Liquid 객체가 있는 경우 entities['adx_*']에 직접 액세스하는 것을 해당 객체로 대체하세요. 예를 들어 weblinks 또는 관련 테이블을 직접 쿼리하는 대신 adx_weblinkset Liquid 개체를 사용합니다. 반환된 개체와 사용 가능한 특성이 다를 수 있으므로 각 사용을 검토합니다.

메타데이터 테이블에 대한 FetchXML 참조

직접 adx_ 엔터티 참조를 해당 가상 테이블 또는 쿼리 powerpagecomponent로 대체하고 powerpagecomponenttype로 필터링합니다.

표준 데이터 모델 예제:

<fetch>
  <entity name="adx_webpage">
    <attribute name="adx_name" />
    <filter>
      <condition attribute="adx_partialurl" operator="eq" value="home" />
    </filter>
  </entity>
</fetch>

향상된 데이터 모델 예제:

<fetch>
  <entity name="powerpagecomponent">
    <attribute name="name" />
    <filter type="and">
      <condition attribute="powerpagecomponenttype" operator="eq" value="2" />
      <condition attribute="partialurl" operator="eq" value="home" />
    </filter>
  </entity>
</fetch>

사용자 지정 워크플로 및 플러그 인

테이블에 등록된 adx_ 사용자 지정 워크플로 및 플러그 인 논리를 리팩터링합니다. 적절한 향상된 데이터 모델 테이블에 업데이트된 논리를 등록하고 향상된 스키마 및 특성을 사용합니다. 비프로덕션 환경에서 만들기, 업데이트, 삭제 및 보안 동작을 테스트합니다.

명령어 참조

Purpose	Command
CLI 버전 확인	`pac --version`
인증 프로필 나열	`pac auth list`
인증 프로필 만들기	`pac auth create -u "<ENV_URL>"`
사이트 및 식별자 나열	`pac pages list -v`
시스템 솔루션 나열	`pac solution list --includeSystemSolutions`
마이그레이션 상태 확인	`pac pages migrate-datamodel --webSiteId "<ID>" --checkMigrationStatus`
SDM 원본 다운로드	`pac pages download --webSiteId "<ID>" --modelVersion 1 --path "<OUT>\site-sdm"`
EDM 원본 다운로드	`pac pages download --webSiteId "<ID>" --modelVersion 2 --path "<OUT>\site-edm"`
사용자 지정 보고서 생성	`pac pages migrate-datamodel --webSiteId "<ID>" --siteCustomizationReportPath "<OUT>"`
구성 이전	`pac pages migrate-datamodel --webSiteId "<ID>" --mode configurationData`
관련 레코드 마이그레이션	`pac pages migrate-datamodel --webSiteId "<ID>" --mode configurationDataReferences`
두 범주 모두 이전	`pac pages migrate-datamodel --webSiteId "<ID>" --mode all`
사이트 원본 업로드	`pac pages upload --path "<SITE_ROOT>" --modelVersion 1`
EDM 활성화	`pac pages migrate-datamodel --webSiteId "<ID>" --updateDatamodelVersion --portalId "<PORTAL_ID>"`
SDM으로 되돌리기	`pac pages migrate-datamodel --webSiteId "<ID>" --revertToStandardDataModel --portalId "<PORTAL_ID>"`

사이트 구성 요소 형식 참조

쿼리 powerpagecomponent할 때 powerpagecomponenttype 필터에서 다음 값을 사용합니다.

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

EDM 템플릿 솔루션 참조

사이트 템플릿에 대한 향상된 데이터 모델 솔루션이 설치되어 있는지 확인하려면 실행 pac solution list --includeSystemSolutions 합니다.

템플릿	EDM 솔루션 고유 이름
시작 레이아웃 1	DefaultPortalTemplate_V2
스타터 레이아웃 2	PowerPages_BlankDesign002_V2
시작 레이아웃 3	PowerPages_BlankDesign003_V2
시작 레이아웃 4	PowerPages_BlankDesign004_V2
시작 레이아웃 5	PowerPages_BlankDesign005_V2
빈 페이지	PowerPages_BlankTemplate_V2
FAQ	PowerPages_FAQ_V2
애플리케이션 처리 중	PowerPages_BuildingPermit_V2
프로그램 등록	PowerPages_ProgramRegistration_V2
모임 예약 및 관리	PowerPages_BookMeeting_V2
커뮤니티 포털(Dynamics 365)	PowerPages_CommunityPortal_V2
고객 Self-Service 포털(Dynamics 365)	PowerPages_CustomerPortal_V2
Employee Self-Service Portal(Dynamics 365)	PowerPages_ESSPortal_V2
파트너 포털(Dynamics 365)	PowerPages_PartnerPortal_V2

피드백

이 페이지가 도움이 되었나요?

Last updated on 2026-09-01

표준에서 향상된 데이터 모델 마이그레이션 개요

Prerequisites

마이그레이션 유틸리티 기능

지원되는 템플릿

시작하기 전 주의 사항:

환경 시퀀스 계획

작업 폴더 만들기

마이그레이션 단계

1단계: 사전 검사

2단계: 사이트 구성

저작 트랙: 개발 환경 또는 단일 환경

다운스트림 트랙: 테스트, UAT 또는 프로덕션

3단계: 관련 레코드 및 활성화

4단계: 마이그레이션된 사이트의 유효성 검사

브라우저 진단 확인

마이그레이션 완료 조건

프로덕션 마이그레이션 시퀀스

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

Troubleshooting

사이트 사용자 지정에 대한 고려 사항

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

사용자 지정 테이블과 메타데이터 테이블 간의 관계

메타데이터 테이블에 대한 Liquid 참조

메타데이터 테이블에 대한 FetchXML 참조

사용자 지정 워크플로 및 플러그 인

명령어 참조

사이트 구성 요소 형식 참조

EDM 템플릿 솔루션 참조

관련 콘텐츠

피드백

추가 리소스