Power Apps 모바일 앱으로 딥 링크 사용

딥 링크를 통해 사용자는 컴퓨터와 모바일 장치에서 한 애플리케이션에서 다른 애플리케이션으로 이동할 수 있습니다. 간단한 예로는 로그인을 위해 Facebook에 딥 링킹하는 모바일 앱, 메시지를 작성하기 위해 메일 앱에 딥 링킹하는 이메일 주소, 관련 모바일 앱을 다운로드하기 위해 앱 스토어에 딥 링킹하는 웹 사이트가 있습니다.

Power Apps 모바일 앱에서 지원되는 딥 링크

다른 앱의 딥 링크 URL을 사용하여 Power Apps 모바일 앱에서 entityrecord 또는 entitylist 보기를 열 수 있습니다. 외부 앱의 링크를 따라 가면 Power Apps 모바일에서 대상 요소가 열립니다

앱에서 이미 인스턴스에 로그인한 경우 외부 앱에서 링크를 따라갈 때 대상 레코드가 표시됩니다. 그렇지 않으면 모바일 앱에서 인스턴스에 로그인하라는 메시지가 표시되며 로그인하면 대상 요소가 표시됩니다. 이 기능을 사용하려면 Power Apps 모바일 앱이 모바일 장치에 설치되어 있어야 합니다.

모델 기반 앱에 지원되는 URL 매개 변수

다음 애플리케이션 처리기 및 쿼리 문자열 매개 변수를 사용하여 URL을 작성하십시오.

Power Apps 모바일 앱의 딥 링크는 다음으로 시작해야 합니다.

ms-apps://<org-url>_<app-id>?tenantId=<tenant-id>&environmentId=<environment-id>&appLogicalName=<appLogicalName>&appType=AppModule&openApp=true&restartApp=true&forceOfflineDataSync=true

중요

조직 URL에는 https://를 포함할 수 없습니다. 다음은 모델 기반 앱 딥 링크의 예입니다.
ms-apps://contoso.onmicrosoft.com_e6429eba-2204-40e8-b9dd-fc74791ff2c2?tenantId=aaaabbbb-0000-cccc-1111-dddd2222eeee&environmentId=g67tfyufhkjfg&appLogicalName=cr12_e567

매개 변수	설명	필수 항목
<특정 앱>	ms-dynamicsxrm -> 휴대폰용 Dynamics 365 ms-apps-fs -> 필드 서비스 ms-apps -> Power Apps ms-mobile-apps -> 래핑된 기본 모바일 앱	예
<org-url>	올바른 조직 URL에 연결합니다.	예
<앱 ID>	올바른 앱 모듈을 엽니다.	예
tenantId=<tenant-id>	올바른 테넌트에 연결합니다.	예
*environmentId=<environment-id>	테넌트 내에서 환경을 고유하게 식별합니다.	예
*appLogicalName=<app-logical-name>	앱의 고유 이름입니다. 최신 스튜디오에서 앱의 고유한 이름을 찾는 방법에 대한 자세한 내용은 앱 디자이너에서 모델 기반 앱 설정 관리를 참조하고 클래식 편집기의 경우 앱 디자이너(클래식)에서 모델 기반 앱 속성 관리를 참조하세요.	예
appType=AppModule	대상 앱이 모델 기반 앱임을 나타냅니다.	네
restartApp=true	모델 기반 앱을 다시 시작합니다. 앱이 이미 열려 있을 때 매개 변수가 전달되도록 하는 데 필요합니다.	아니요
autoLoginUpn=<전자 메일>	이메일을 자동으로 채우고 로그인을 트리거합니다. 참고: 사용자가 앱에 이미 로그인한 경우 이 매개 변수는 무시됩니다.	아니요
forceOfflineDataSync=true	모든 최신 데이터를 사용할 수 있도록 데이터 동기화가 트리거되도록 합니다.	아니요

* 고려 사항

• 환경 ID 및 appLogicalName은 모든 새 딥 링크에 필수입니다.
• 환경 ID 또는 appLogicalName이 없는 기존 딥 링크는 2025년 12월까지 성능이 저하되며 그 후에는 지원되지 않습니다.
• 성능 향상 및 대기 시간 단축을 위해 환경 ID 및 appLogicalName을 포함하도록 기존의 모든 딥 링크를 업데이트합니다.

entityrecord 양식을 열거나 새 entityrecord를 작성하는 경우 다음 매개 변수를 사용하십시오.

매개 변수	설명	필수 항목
etn=<entity-logical-name>	이동할 테이블을 지정합니다.	네
pagetype=entityrecord	대상이 양식임을 나타냅니다.	예
id=<record-id>	특정 이동할 레코드를 지정합니다. 지정하지 않으면, 해당 테이블에 대해 생성된 양식이 열립니다.	예
extraqs=<form-id>	entityrecord에 대해 열 양식을 지정합니다. 지정하지 않으면 기본 양식이 열립니다. extraqs 매개 변수는 기본 필드 값에도 사용할 수 있습니다.	아니요

링크가 entitylist 보기로 이동하는 경우 다음 매개 변수를 추가하십시오.

매개 변수	설명	필수 항목
etn=<entity-logical-name>	이동할 테이블을 지정합니다.	네
pagetype=entitylist	보기로 이동할 것임을 나타냅니다.	예
viewid=<view-id>	열려는 보기를 지정합니다.	아니요
시스템 보기일 경우 Viewtype= <1039, 개인 보기일 경우 4230>	대상 보기가 시스템 보기인지 개인 보기인지를 나타냅니다.	아니요

캔버스 앱에 지원되는 URL 매개 변수

ms-apps:///providers/Microsoft.PowerApps/apps/<appID>?tenantId=<tenantId>&environmentId=<environment-id>&restartApp=true

매개 변수	설명	필수 항목
<app-id>	올바른 앱 모듈을 엽니다.	예
tenantId=<tenantId>	올바른 테넌트에 연결합니다.	예
*environmentId=<environment-id>	테넌트 내에서 환경을 고유하게 식별합니다.	예
restartApp=true	Canvas 앱을 다시 시작합니다. 앱이 이미 열려 있을 때 매개 변수가 전달되도록 하는 데 필요합니다.	아니요
autoLoginUpn=<전자 메일>	이메일을 자동으로 채우고 로그인을 트리거합니다. 참고: 사용자가 앱에 이미 로그인한 경우 이 매개 변수는 무시됩니다.	아니요

* 고려 사항

• 환경 ID는 모든 새 딥 링크에 필수입니다.

• 환경 ID가 없는 기존 딥 링크는 2025년 12월까지 성능이 저하되며 그 후에는 지원되지 않습니다.

• 성능을 향상시키고 대기 시간을 줄이기 위해 환경 ID를 포함하도록 모든 기존 딥 링크를 업데이트합니다.

  래핑된 기본 모바일 앱에 대해 지원되는 Url 매개변수

ms-mobile-apps:///providers/Microsoft.PowerApps/apps/<appID>?tenantId=<tenantId>&restartApp=true

중요

래핑된 앱의 딥 링크 URL은 래핑된 앱 하나가 모바일 디바이스에 설치된 경우에만 작동합니다. 둘 이상의 래핑된 앱이 설치된 경우에는 작동하지 않습니다.

매개 변수	설명	필수 항목
<앱 ID>	올바른 앱 모듈을 엽니다.	예
tenantId=<tenantId>	올바른 테넌트에 연결합니다.	예
restartApp=true	모델 기반 앱을 다시 시작합니다. 앱이 이미 열려 있을 때 매개 변수가 전달되도록 하는 데 필요합니다.	아니요
autoLoginUpn=<전자 메일>	이메일을 자동으로 채우고 로그인을 트리거합니다. 참고: 사용자가 앱에 이미 로그인한 경우 이 매개 변수는 무시됩니다.	아니요

문제 해결

딥 링크는 회사의 조직 정책 및 사용자의 디바이스 설정에 따라 브라우저에서 열 수 있습니다. MDM(모바일 디바이스 관리) 도구 및 디바이스 운영 체제에는 딥 링크 처리 방식에 영향을 주는 다양한 옵션과 설정이 있습니다. Power Apps 모바일이 아닌 브라우저에서 딥 링크가 열리는 경우 MDM 정책 및 디바이스 설정이 적절하게 구성되었는지 확인합니다.

예를 들어 일부 Android 디바이스에서 기본적으로 설정>앱>Power Apps>열기 로 이동하고 apps.powerapps.com 추가하여 Power Apps 모바일에서 직접 딥 링크를 엽니다.

참고하십시오

캔버스 앱에서 예정된 중요한 변경 내용(사용 중단)