Microsoft Power Platform CLI용 포털 지원
참고
2022년 10월 12일부터 Power Apps 포털이 Power Pages가 됩니다. 추가 정보: Microsoft Power Pages는 이제 일반적으로 사용할 수 있습니다(블로그)
곧 Power Apps 포털 설명서를 마이그레이션하고 Power Pages 설명서와 병합할 예정입니다.
Microsoft Power Platform CLI(명령줄 인터페이스)는 개발자와 앱 제작자가 코드 구성 요소를 만들 수 있도록 지원하는 간단한 단일 중지 개발자 명령줄 인터페이스입니다.
Microsoft Power Platform CLI 도구는 엔터프라이즈 개발자와 ISV가 확장 및 사용자 지정을 빠르고 효율적으로 생성, 빌드, 디버그 및 게시할 수 있는 포괄적인 응용 프로그램 수명 주기 관리(ALM) 스토리를 향한 첫 번째 단계입니다. 자세한 정보는 Microsoft Power Platform CLI란 무엇인가?를 참조하세요
이 기능을 통해 Microsoft Power Apps 포털은 포털 구성의 CI/CD(지속적인 통합/지속적인 배포)를 활성화하기 위해 Microsoft Power Platform CLI를 지원합니다. 이제 Microsoft Power Platform CLI를 사용하여 포털 구성을 소스 제어에 체크인하고 포털 구성을 모든 환경으로 이동할 수 있습니다.
참고
이 기능은 Power Platform CLI 버전 1.9.8부터 정식 출시되었습니다. 최신 버전 설치에 대한 자세한 내용은 Microsoft Power Platform CLI 설치를 참고하세요.
포털 개발에 Microsoft Power Platform CLI를 사용하는 이유는 무엇입니까?
Microsoft Power Platform CLI에 대한 포털 지원을 통해 이제 포털 콘텐츠를 변경하여 포털 사용자 지정에 대해 오프라인과 유사한 기능을 사용할 수 있습니다. 모든 사용자 지정 또는 변경 사항이 저장되면 포털에 업로드합니다. Microsoft Power Platform CLI를 사용하여 포털 콘텐츠를 다운로드하면 콘텐츠가 YAML 및 HTML 형식으로 구조화되어 쉽게 사용자 지정할 수 있으므로 프로 개발 경험이 가능합니다.
다음은 Microsoft Power Platform CLI 지원으로 포털에서 이점을 얻을 수 있는 기능 목록입니다.
사용이 용이함
로컬 파일 시스템과의 포털 데이터 다운로드/업로드 지원
기존 Microsoft Power Platform CLI 도구로 빌드.
응용 프로그램 수명 주기 관리(ALM)
조직 내 포털 구성 변경 사항 추적
조직 또는 테넌트 간 구성 파일 이동
전문가 개발 및 기업 지원
"git" 같은 모든 원본 제어 도구와 원활한 통합
CI/CD 파이프라인을 쉽게 설정
Microsoft Power Platform CLI 설치
단계별 지침은 Microsoft Power Platform CLI 설치를 참조하세요.
지원되는 테이블
Microsoft Power Platform CLI에 대한 포털 지원은 아래 나열된 표로 제한됩니다.
adx_ad
adx_adplacement
adx_adplacement
adx_blogpost
adx_botconsumer
adx_communityforum
adx_communityforumaccesspermission
adx_contentsnippet
adx_entityform
adx_entityformmetadata
adx_entitylist
adx_entitypermission
adx_forumthreadtype
adx_pagetemplate
adx_poll
adx_polloption
adx_pollplacement
adx_portallanguage
adx_publishingstate
adx_redirect
adx_shortcut
adx_sitemarker
adx_sitesetting
adx_tag
adx_urlhistory
adx_webfile
adx_webform
adx_webformmetadata
adx_webformstep
adx_weblink
adx_weblinkset
adx_webpage
adx_webpageaccesscontrolrule
adx_webrole
adx_website
adx_websiteaccess
adx_websitebinding(다운로드 전용)
adx_websitelanguage
adx_webtemplate
주석
중요
- Microsoft Power Platform CLI를 사용한 사용자 지정에 대해 사용자 지정 테이블 및 포털 템플릿별 테이블(예: 블로그, 커뮤니티 또는 아이디어 포털)이 지원되지 않습니다.
- 광고(adx_ad) 레코드에 대한 이미지 파일 첨부는 Power Platform CLI를 사용하여 다운로드되지 않습니다. 이 문제를 해결하려면 이미지 URL 필드를 사용하거나 복사 필드의 HTML 참조를 이미지 파일이 포함된 웹 파일 레코드에 추가하세요.
포털용 Microsoft Power Platform CLI 설치 및 확인
Microsoft Power Platform CLI 설치에 대해 알아보려면 Microsoft Power Platform CLI 설치로 이동합니다.
Microsoft Power Platform CLI를 설치한 후 명령 프롬프트를 열고 pac를 실행하여 출력에 Power Apps 포털에 대한 명령인 "paportal"이 포함되어 있는지 확인합니다.
합니다.
포털에 대한 Microsoft Power Platform CLI 명령
포털에 대한 Microsoft Power Platform CLI 명령은 "paportal" 입니다.
다음 섹션에서는 "paportal" 명령의 다양한 속성에 대해 자세히 설명합니다.
매개 변수
| 속성 이름 | Description | 예 |
|---|---|---|
| 목록 | 현재 Dataverse 환경의 모든 포털 웹 사이트 나열 | pac paportal list |
| 다운로드 | 현재 Dataverse 환경에서 포털 웹 사이트 콘텐츠 다운로드 다음 매개 변수가 있습니다. - path: 웹 사이트 콘텐츠를 다운로드할 경로(별칭: -p) - webSiteId: 다운로드할 포털 웹 사이트 ID(별칭: -id) - overwrite: (선택 사항) true - 기존 콘텐츠를 덮어씁니다. false - 폴더에 이미 웹 사이트 콘텐츠가 있는 경우 실패합니다(별칭: -o) |
pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 |
| 업로드 | 현재 Dataverse 환경에 포털 웹 사이트 콘텐츠를 업로드합니다. 다음 매개 변수가 있습니다. - path: 웹 사이트 콘텐츠가 저장된 경로(alias: -p) -deploymentProfile: deployment-profiles/[profile-name].deployment.yaml 파일의 프로필 변수를 통해 정의된 환경 세부 정보로 포털 데이터 업로드 |
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" |
배포 프로필 사용
deploymentProfile 스위치를 사용하면 환경에 대한 변수 집합을 YAML 형식으로 정의할 수 있습니다. 예를 들어 프로필에 다른 스키마 세부 정보가 정의된 다른 배포 프로필(예: dev, test, prod)이 있을 수 있습니다.
테스트 프로필을 생성하는 경우 deployment-profiles 아래에 "test.deployment.yml"이라는 이름의 파일을 생성할 수 있습니다(즉, <profileTag>.deployment.yml). 그리고 태그(<profileTag>)와 함께 명령을 실행하여 다음 프로필을 사용할 수 있습니다.
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile test
이 파일에는 deploymentProfile 매개 변수를 사용하여 포털 구성을 업로드하는 동안 재정의하려는 테이블 ID, 속성 목록 및 값이 포함된 테이블(엔터티) 이름을 가질 수 있습니다.
또한 OS 변수를 사용하여 운영 체제의 환경 변수에 액세스할 수 있습니다.
다음은 고유한 스키마 세부 정보가 있는 "test.deployment.yml" 프로필 YAML 파일의 예입니다.
adx_sitesetting:
- adx_sitesettingid: 4ad86900-b5d7-43ac-1234-482529724970
adx_value: ${OS.FacebookAppId}
adx_name: Authentication/OpenAuth/Facebook/AppId
- adx_sitesettingid: 5ad86900-b5d7-43ac-8359-482529724979
adx_value: contoso_sample
adx_name: Authentication/OpenAuth/Facebook/Secret
adx_contentsnippet:
- adx_contentsnippetid: b0a1bc03-0df1-4688-86e8-c67b34476510
adx_name: PowerBI/contoso/sales
adx_value: https://powerbi.com/group/contoso/sales
참고
포털 외에 CLI에서 사용되는 모든 명령에 대해 알아 보려면 Microsoft Power Platform CLI의 공통 명령으로 이동하십시오.
매니페스트 파일
pac paportal download CLI 명령을 사용하여 웹사이트 콘텐츠를 다운로드하고 사이트 콘텐츠를 다운로드하면 두 개의 매니페스트 파일도 생성됩니다.
- 환경 매니페스트 파일(org-url-manifest.yml)
- 추적 매니페스트 파일(manifest.yml) 삭제
환경 매니페스트 파일(org-url-manifest.yml)
환경 매니페스트 파일은 pac paportal download 명령이 실행될 때마다 생성됩니다.
다운로드할 때마다 PAC CLI 도구는 기존 환경 매니페스트 파일을 읽고 환경에서 삭제된 항목을 업데이트하거나 환경 매니페스트 파일이 없는 경우 생성합니다.
pac paportal upload 명령을 실행하여 포털 웹사이트 콘텐츠를 업로드하는 경우입니다. 환경 매니페스트 파일을 읽고 마지막 다운로드 이후 변경 사항을 식별하고 업데이트된 콘텐츠만 업로드합니다. 이렇게 하면 모든 업로드 명령에서 모든 콘텐츠를 업로드하는 대신 업데이트된 웹사이트 콘텐츠만 업로드되므로 업로드 프로세스를 최적화하는 데 도움이 됩니다.
환경 매니페스트 파일은 우발적인 변경을 방지하기 위해 동일한 환경(환경 URL이 파일 이름과 일치)에 연결할 때 읽기 전용이 됩니다.
추적 매니페스트 파일(manifest.yml) 삭제
이 파일은 환경에서 삭제된 레코드를 추적하는 데 사용됩니다.
pac paportal download 명령으로 웹사이트 콘텐츠를 다운로드 하면 환경 매니페스트 파일(org-url-manifest.yml)에서 삭제된 레코드가 manifest.yml 파일에 추가됩니다. 따라서 pac paportal upload 명령을 사용하여 웹 사이트 콘텐츠를 업로드하면 환경(다른 환경에서도)에서 파일이 삭제됩니다. 이 파일은 삭제되지 않으며 연결 환경에 관계없이 사용됩니다.
참고
PAC CLI를 사용하여 한 환경에서 사이트 콘텐츠 기록을 삭제하고 다른 환경에서도 동일한 콘텐츠 기록을 삭제하려면 웹사이트 기록 콘텐츠를 삭제하기 전과 후에 pac paportal download 명령을 실행해야 합니다. manifest.yml은 이러한 변경 사항을 추적하고 pac paportal upload 명령이 실행될 때 대상 환경에서 해당 레코드를 제거합니다.
Visual Studio Code 확장 사용
또한 VS Code 확장 Power Platform VS Code 확장을 사용하여 IntelliSense, 코드 완성 지원, 힌트 제공 및 VS Code 통합 터미널을 사용하여 Microsoft Power Platform CLI와 상호 작용하는 내장 Liquid 언어를 활용할 수 있습니다. 추가 정보: Visual Studio Code 확장 사용(프리뷰)
추가 고려 사항
- 파일 경로가 최대 경로 길이 제한을 초과하면 오류가 보고됩니다. 추가 정보: Windows의 최대 경로 길이 제한
- 중복된 웹 페이지 이름과 같은 중복 레코드의 경우 Microsoft Power Platform CLI는 웹 페이지 이름이 있는 두 개의 다른 폴더 —를 생성하고 다른 하나는 해시 코드가 접두사로 붙은 동일한 이름을 사용합니다. 예: "마이 페이지" 및 "마이 페이지-해시 코드".
다음 단계
자습서: 포털이 있는 Microsoft Power Platform CLI 사용