포털 구성 마이그레이션

아티클
03/16/2023

참고

2022년 10월 12일부터 Power Apps 포털이 Power Pages가 됩니다. 추가 정보: Microsoft Power Pages는 이제 일반적으로 사용할 수 있습니다(블로그)
곧 Power Apps 포털 설명서를 마이그레이션하고 Power Pages 설명서와 병합할 예정입니다.

포탈 개발에는 포탈 최종 사용자에게 원하는 환경을 구현하기 위한 몇 가지 구성과 사용자 정의가 포함됩니다.

포털 인스턴스의 개발이나 구성을 완료한 후 개발에서 테스트 또는 프로덕션 환경으로 최신 포털 구성 데이터를 마이그레이션할 수 있습니다.

마이그레이션은 원본 Microsoft Dataverse 환경에서 기존 구성을 내보낸 다음 대상 Dataverse 환경으로 가져오는 것을 포함합니다.

대상 환경 준비

참고

대상 환경을 준비하는 것은 일회성 프로세스입니다. Dataverse에서 관리 포털 솔루션을 설치하려면 새 포털을 프로비저닝하고 포털 웹 애플리케이션을 구성해야 합니다. 이 프로세스는 또한 원본 환경의 포털 메타데이터로 대체될 기본 포털 메타데이터를 설치합니다.
대상 환경의 최대 첨부 파일 크기가 소스 환경과 같거나 더 큰 크기로 설정되어 있는지 확인하십시오.
파일의 최대 크기는 환경 시스템 설정 대화 상자의 시스템 설정 이메일 탭에서 최대 파일 크기 설정에 의해 결정됩니다.

대상 환경에서 새 포털을 프로비저닝합니다. 소스 환경에서 프로비저닝한 것과 같은 포털 템플릿을 사용합니다. 예를 들어 원본 환경에서 Dynamics 365 고객 셀프 서비스 포털을 프로비저닝한 경우 대상 환경에서 Dynamics 365 고객 셀프 서비스 포털을 프로비저닝합니다.
대상 환경에서 포털 관리 앱을 사용하여 새로 생성된 웹사이트 기록을 삭제합니다. 그러면 대상 환경에서 기본 포털 구성 데이터가 제거됩니다.
대상 환경에서 포털 앱을 삭제합니다. 이렇게 하면 현재 기본 포털을 렌더링하도록 구성된 포털 앱이 제거됩니다.

참고

포털 관리 앱을 삭제하지 마세요!
Power Platform CLI 또는 구성 마이그레이션 도구를 사용하여 원본 환경에서 포털 메타데이터를 전송합니다.
대상 환경에서 기존 포털 웹 사이트 옵션을 사용하여 새 포털을 프로비저닝합니다. 이 프로세스는 원본 환경에서 전송한 포털 구성을 사용하여 포털을 구성합니다.
소스 환경의 포털 업데이트는 이 새 대상 환경에 반영되어야 합니다. 앞으로는 포털 구성 데이터를 전송하여 원본에서 대상 환경으로 구성을 전송할 수 있어야 합니다.

참고

Power Platform CLI를 사용하여 포털 구성 전송

Microsoft Power Platform CLI는 특히 포털을 위한 많은 기능을 제공합니다. 이러한 명령을 사용하면 원본 환경에서 포털 구성을 다운로드하고 대상 환경으로 전송할 수 있습니다. 이러한 명령을 ALM 프로세스에 통합할 수도 있습니다.

Power Platform CLI 인증 프로필을 만들어 원본 및 대상 환경 모두에 연결합니다. 대상 및 원본 환경을 쉽게 식별할 수 있도록 이름을 지정할 수 있습니다.
```
pac auth create --name [name] --url [environment url]
```
예제
```
pac auth create --name PORTALDEV --url https://contoso-org.crm.dynamics.com
```
인증 프로필이 생성되면 list 명령을 사용하여 확인할 수 있는 관련 인덱스가 생성됩니다.
```
pac auth list
```
원본 환경에 연결된 Power Platform CLI 인증 프로필을 선택합니다.
```
pac auth select --index [source environment index]
```
예제
```
pac auth select --index 1
```
소스 포털의 웹 사이트 ID를 결정합니다.
```
pac paportal list
```
포털 구성 데이터를 로컬 워크스테이션에 다운로드합니다. 이전에 동일한 경로에 포털 구성을 다운로드한 경우 --overwrite 옵션을 참으로 설정합니다.
```
pac paportal download --path [path] --webSiteId [website id]
```
예제
```
pac paportal download --path c:\paportals\ --webSiteId db9db518-ea5c-ec11-8f8f-00224804e6cd
```
대상 환경에 연결된 Power Platform CLI 인증 프로필을 선택합니다.
```
pac auth select --index [target environment index]
```
예제
```
pac auth select --index 2
```

포털 구성 데이터를 대상 환경에 업로드합니다.

pac paportal upload --path [path]

예제

pac paportal upload --path "C:\paportals\portaldev"

참고

Power Platform CLI 도구는 테이블 또는 테이블 스키마를 마이그레이션하지 않습니다. 구성 데이터가 선택한 스키마와 일치하지 않으면 테이블 및 필드와 같은 요소가 누락되어 마이그레이션이 실패할 수 있습니다. 가져 오는 동안 대상 환경에 솔루션으로 별도로 가져온 테이블, 필드, 양식 또는 보기와 같은 추가 사용자 정의와 함께 이미 설치된 동일한 포털 유형이 포함되어 있는지 확인하세요.

참고

구성 마이그레이션 도구를 사용하여 포털 구성 전송

참고

선호하는 방법은 Power Platform CLI를 사용하여 포털 메타데이터를 전송합니다.

구성 데이터를 내보내려면 구성 마이그레이션 도구와 포털별 구성 스키마 파일을 사용해야 합니다. 이 도구에 대한 자세한 내용은 구성 데이터 관리를 참조하십시오.

참고

최신 버전의 구성 마이그레이션 도구를 사용하는 것이 좋습니다. 구성 마이그레이션 도구는 NuGet에서 다운로드할 수 있습니다. 도구 다운로드에 대한 자세한 내용 : NuGet에서 도구 다운로드.
구성 마이그레이션을 위한 스키마 파일에서 지원하는 포털의 최소 솔루션 버전은 8.4.0.275입니다. 그러나 최신 솔루션 버전을 사용하는 것이 좋습니다.
마이그레이션이 성공적으로 작동하려면 원본 및 대상 조직의 기본 언어가 동일해야 합니다.

스키마 파일은 다음 포털 유형에 사용할 수 있습니다.

Dataverse가 있는 환경에서 만든 포털
- 사용자 지정 포털(빈 포털)
- 사용자 지정 포털(빈 포털) (버전 9.2.2103.x용)
- 사용자 지정 포털(빈 포털) (버전 9.3.2201.x 이상용)
Customer Engagement 앱(예: Dynamics 365 Sales 및 Dynamics 365 Customer Service)이 포함된 환경에서 생성된 포털
- 사용자 지정 포털(빈 포털)
- 사용자 지정 포털(빈 포털) (버전 9.2.2103.x용)
- 사용자 지정 포털(빈 포털) (버전 9.3.2201.x 이상용)
- 커뮤니티 포털
- 고객 셀프 서비스 포털
- 파트너 포털
- 직원 셀프 서비스 포털

기본 스키마 파일에는 포털 테이블, 관계 및 각 엔터티에 대한 고유성 정의에 대한 정보가 포함되어 있습니다. 추가 정보: 포털 구성 데이터 내보내기

구성 데이터를 내보낸 후에는 대상 환경으로 가져와야 합니다. 추가 정보: 포털 구성 데이터 가져오기

참고

구성 마이그레이션 도구는 스키마를 사용하여 구성 데이터를 내보내고 가져옵니다. 이 도구는 테이블 또는 테이블 스키마를 마이그레이션하지 않습니다. 구성 데이터가 선택한 스키마와 일치하지 않으면 테이블 및 필드와 같은 요소가 누락되어 마이그레이션이 실패할 수 있습니다.

내보내는 동안 소스 환경에 구성 마이그레이션 도구 스키마 파일에 지정된 포털 테이블이 포함되어 있는지 확인하세요. 여전히 스키마 파일을 테이블, 특성 등을 추가, 제거, 수정하여 구성 데이터의 하위 집합을 마이그레이션할 수 있습니다.

가져 오는 동안 대상 환경에 솔루션으로 별도로 가져온 테이블, 필드, 양식 또는 보기와 같은 추가 사용자 정의와 함께 이미 설치된 동일한 포털 유형이 포함되어 있는지 확인하세요.

포털 구성 데이터 내보내기

포털별 구성 스키마 파일을 사용하여 소스 시스템에서 포털 구성 데이터를 내보낼 수 있습니다.

구성 마이그레이션 도구를 다운로드하고 원하는 폴더로 압축을 풉니다.
포털 유형에 대해 위에 제공된 링크를 사용하여 포털 구성 스키마 파일을 다운로드합니다.
<your_folder>\Tools\ConfigurationMigration 폴더에서 DataMigrationUtility.exe 파일을 두 번 클릭하여 구성 마이그레이션 도구를 실행하고 주 화면에서 데이터 내보내기를 선택한 다음 계속을 선택합니다.
로그인 화면에서 인증 정보를 제공하여 데이터를 내보낼 Dataverse 환경에 연결합니다. 데이터를 내보낼 Dataverse 환경에 여러 조직이 있는 경우 사용 가능한 조직 목록 표시 확인란을 선택한 다음 로그인을 선택합니다.
여러 조직이 있어서 이전 단계에서 사용 가능한 조직 목록 표시 확인란을 선택한 경우 다음 화면에서 연결할 조직을 선택할 수 있습니다. 연결할 Dataverse 환경을 선택합니다.

참고

여러 조직이 없는 경우 이 화면이 표시되지 않습니다.
스키마 파일에서 데이터 내보내기에 사용할 포털별 구성 스키마 파일을 찾아 선택합니다.
데이터 파일에 저장에서 내보낼 데이터 파일의 이름과 위치를 지정합니다.
데이터 내보내기를 선택합니다. 내보내기가 완료되면 내보내기 진행 상태와 내보낸 파일의 위치가 화면 아래쪽에 표시됩니다.
끝내기를 선택하여 도구를 닫습니다.

포털 구성 데이터 가져오기

구성 마이그레이션 도구를 실행하고 기본 화면에서 데이터 가져오기를 선택한 다음 계속을 선택합니다.
로그인 화면에서 인증 정보를 제공하여 데이터를 내보낼 Dataverse 환경에 연결합니다. 데이터를 내보낼 Dataverse 환경에 여러 조직이 있는 경우 사용 가능한 조직 목록 표시 확인란을 선택한 다음 로그인을 선택합니다.
여러 조직이 있어서 이전 단계에서 사용 가능한 조직 목록 표시 확인란을 선택한 경우 다음 화면에서 연결할 조직을 선택할 수 있습니다. 연결할 Dataverse 환경을 선택합니다.
참고
- 여러 조직이 없는 경우 이 화면이 표시되지 않습니다.
- 구성을 가져올 계획인 조직에 대해 포털 솔루션이 이미 설치되어 있는지 확인합니다.
다음 화면을 사용하면 가져올 데이터 파일(.zip)을 제공할 수 있습니다. 데이터 파일을 찾아 선택한 후 데이터 가져오기를 선택합니다.
다음 화면에 레코드의 가져오기 상태가 표시됩니다. 데이터 가져오기는 여러 단계로 수행되는데, 종속 데이터가 대기하고 있는 동안 먼저 기초 데이터를 가져온 후 이후 단계에서 종속 데이터를 가져와 데이터 종속성 또는 연결을 처리합니다. 그러면 깔끔하고 일관되게 데이터를 가져올 수 있습니다.
끝내기를 선택하여 도구를 닫습니다.

마이그레이션된 데이터를 사용하여 새 포털 생성

마이그레이션 프로세스가 기존 포털을 업데이트하는 경우 이제 업데이트가 대상 환경에서 표시되어야 합니다. 새 포털에 마이그레이션하는 경우 이제 기존 웹 사이트 레코드의 데이터 사용 옵션을 사용하여 가져온 웹 사이트 레코드에 대한 새 포털을 만들 수 있습니다. 자세한 정보: 포털 만들기.

테넌트 간 마이그레이션

Power Apps 포털은 테넌트에서 테넌트 마이그레이션을 지원하지 않습니다. 한 테넌트에서 다른 테넌트로 포털을 마이그레이션하려면 다음 단계를 수행해야 합니다.

원본 테넌트의 포털을 재설정합니다.
Dataverse 포함 환경 또는 고객 참여 앱을 포함한 환경에 새 포털을 프로비저닝합니다.
이 기사의 앞부분에서 설명한 단계를 사용하여 포털 구성 및 사용자 정의를 마이그레이션합니다.

참고 항목:

Power Apps 포털 구성으로의 변경 사항을 추적합니다.
Microsoft Power Platform CLI용 포털 지원.
테넌트를 Power Platform 환경의 테넌트로 마이그레이션.
테넌트를 Sales, Customer Service, Marketing, Field Service 및 Project Service Automation과 같은 Dynamics 365의 모델 기반 앱의 테넌트로 마이그레이션.

참고

귀사의 설명서 언어 기본 설정에 대해 말씀해 주시겠습니까? 간단한 설문 조사에 응해주세요. (이 설문 조사는 영어로 되어 있습니다.)

이 설문 조사는 약 7분 정도 걸립니다. 개인 데이터는 수집되지 않습니다(개인정보처리방침).

다음을 통해 공유