Launch 및 Param 함수

아티클
10/16/2024

적용 대상: Canvas 앱

웹 페이지 또는 캔버스 앱을 시작하고 시작 매개 변수에 대한 액세스를 제공합니다.

Launch

웹 페이지 또는 캔버스 앱을 시작합니다. 이 함수는 다음을 지원합니다.

주소 (필수), 캔버스 앱 웹페이지의 URL입니다.
매개변수 (선택 사항), 웹페이지나 캔버스 앱에 전달할 명명된 값입니다. 캔버스 앱에서 매개 변수는 Param 함수로 읽을 수 있습니다.
대상 (선택 사항), 웹페이지나 캔버스 앱을 시작할 브라우저 탭입니다.

Launch 는 동작 수식에서만 사용할 수 있습니다.

참고

Launch 수식을 사용하여 Power Apps을 열고 앱이 최종 사용자에게 표시되지 않는 경우 앱이 브라우저 팝업 차단기에 의해 차단되었는지 또는 브라우저가 새 화면으로 이동할지 여부를 묻는 대화 상자에 대한 사용자의 응답을 기다리고 있는지 확인하는 것이 좋습니다.

주소

웹 페이지는 URL 주소를 통해 시작됩니다. 예:

Launch( "https://bing.com" )

웹 링크 또는 앱 URI(/providers/Microsoft.PowerApps/apps/가 앞에 붙은 앱 ID)를 사용하여 캔버스 앱을 시작할 수 있습니다. 앱에서 이 값을 찾으려면:

Power Apps(으)로 이동합니다.
왼쪽 탐색 창에서 앱을 선택합니다.
앱을 선택합니다.
상단 메뉴에서 세부 정보를 선택합니다.
... (추가 명령) 을 선택한 다음 드롭다운 메뉴에서 세부 정보를 선택할 수도 있습니다.
웹 링크를 복사합니다.

웹 링크는 모든 웹 페이지에서 사용할 수 있으며 캔버스 앱을 시작합니다. 또한 Launch로 시작될 수 있습니다. 예:

Launch( "https://apps.powerapps.com/e/{environment id}/a/{app id}?tenantId={tenantId}" )

디바이스에서 기본 앱은 직접 시작될 수 없습니다. 특정 플랫폼에서 사용 가능한 간접 옵션이 있을 수 있습니다(예: 사용자 지정 URL 스키마를 설치하거나 특정 웹 사이트에 대한 옵션을 제공하기 위해 웹 브라우저에 등록하는 기본 앱).

매개 변수

Launch 는 웹페이지나 캔버스 앱에 매개변수를 전달할 수 있습니다. 매개 변수는 다음 두 가지 방법으로 제공될 수 있습니다.

이름 값 쌍의 인수 목록 예:

Launch( "https://bing.com/search", "q", "Power Apps", "count", 1 )

필드 값의 레코드. 예:
```
Launch( "https://bing.com/search", { q: "Power Apps", count: 1 } )
```
이 양식을 사용하면 이름과 값의 연관성이 명확해지므로 보다 쉽게 작업할 수 있습니다. LaunchTarget 인수 옵션을 지원하는 유일한 양식입니다.

EncodeUrl 함수가 각각에 사용된 것처럼 영숫자가 아닌 특정 문자를 % 및 16 진수로 대체하기 위해 전달 전, 주소와 매개 변수가 URL로 인코딩됩니다.

웹 페이지를 시작할 때 매개 변수의 쿼리 문자열은 URL 주소 끝에 포함될 수 있습니다. Launch에 제공되는 추가 매개 변수는 쿼리 문자열 끝에 추가됩니다. 캔버스 앱을 시작할 때 쿼리 문자열이 작동하지 않습니다.

해당 앱이 이미 실행 중인 모바일 디바이스에서 앱을 시작하면 실행 중인 앱에서 매개 변수가 새로 고쳐지지 않습니다. 매개 변수를 새로 고치려면 앱을 다시 로드해야 합니다.

Target

LaunchTarget 인수를 사용해 웹 페이지 또는 앱을 열 브라우저 창을 지정합니다. LaunchTarget 열거 값 중 하나를 사용하거나 사용자 지정 창 이름을 제공합니다.

LaunchTarget 열거형	설명
새로운	웹 페이지 또는 앱이 새 창 또는 탭에서 열립니다.
바꾸다	웹 페이지 또는 앱이 현재 창 또는 탭을 대체합니다.
이름	열거 값 대신 고유한 텍스트 문자열을 사용하여 창 또는 탭 이름을 지정합니다. Self는 Launch 함수 내부에서만 사용되는 이름입니다. 사용자에게 표시되는 창의 제목에는 영향을 주지 않으며 창 제목과 일치하지 않습니다. 주어진 창이나 탭이 이름이 이미 존재하는 경우 내용이 교체됩니다. 그렇지 않으면 새 창이나 탭이 만들어집니다. 이름은 밑줄 문자 "_"로 시작할 수 없습니다.

웹 브라우저에서 바꾸기 및 이름 옵션을 사용하여 실행할 경우 새로 만들기가 기본 열거형입니다. 모바일 플레이어에서 신규는 이름 사용 가능한 옵션으로 이름이 있는 웹 페이지의 기본값입니다. 현재 캔버스 앱은 항상 다른 캔버스 앱으로 대체됩니다.

노트

포함된 시나리오(예: Power BI 또는 SharePoint)에서 LaunchTarget을 신규가 아닌 다른 값으로 사용하는 것은 지원되지 않으며 예기치 않은 동작이 발생할 수 있습니다. 나중에 이 동작이 변경되거나 오류가 발생할 수 있습니다.

Param

Param 함수는 앱이 시작될 때 해당 앱에 전달된 매개 변수를 검색합니다. 명명된 매개 변수가 전달되지 않은 경우 Param에서 공백을 반환합니다.

다른 캔버스 앱에서 캔버스 앱을 시작할 때 Launch 함수에 매개 변수 인수를 사용합니다. 매개 변수 이름과 값은 자동으로 URL 인코딩됩니다.
웹 페이지에서 캔버스 앱을 시작할 때 매개 변수를 캔버스 앱 웹 링크의 쿼리 문자열에 추가합니다. 여기에는 &parametername=parametervalue 추가가 포함되며 tenantId에 대한 쿼리 문자열이 이미 시작되었다고 가정합니다. 예를 들어 &First%20Name=Vicki&category=3 추가는 두 개의 매개 변수를 전달합니다. First Name을 "Vicki"의 값으로, category를 "3"의 값으로(값 유형은 텍스트). EncodeURL 함수와 비슷하게 매개 변수 이름과 값은 공백이나 특수 문자가 포함된 경우 URL을 사용하여 URL 인코딩해야 합니다.
Param 이름은 대/소문자를 구분합니다.
Param 이름과 값은 앱에서 사용하기 위해 자동으로 URL 디코딩됩니다.
앱을 다시 로드하지 않는 한 매개 변수 값은 변경되지 않습니다. 앱이 이미 실행 중인 모바일 디바이스에서 실행을 사용하면 매개 변수가 새로 고쳐지지 않습니다.
매개 변수에 숫자가 포함된 경우에도 Param에 의해 반환되는 형식은 항상 텍스트 문자열입니다. 다른 형식으로의 변환은 자동으로 발생하거나 Value 함수와 같이 명시적 전환을 사용해 분명하게 숫자로 변환합니다.

노트

사용자 지정 페이지의 경우 페이지에서 허용되는 유일한 매개 변수는 RecordId 및 엔터티 이름입니다.

구문

( 주소 [, 매개변수 이름1, 매개변수 값1, ... ])를 시작합니다.

주소 – 필수. 시작할 웹 페이지의 주소 또는 앱의 ID입니다.
매개변수 이름 – 선택 사항. 매개 변수 이름입니다.
ParameterValues – 선택 사항. 앱 또는 웹 페이지에 전달할 매개 변수 값입니다.

시작( 주소, { [ 매개변수 이름1: 매개변수 값1, ... ] } [, 시작 대상 ])

주소 – 필수. 시작할 웹 페이지의 주소 또는 앱의 ID입니다.
매개변수 이름 – 선택 사항. 매개 변수 이름입니다.
ParameterValues – 선택 사항. 앱 또는 웹 페이지에 전달할 매개 변수 값입니다.
LaunchTarget – 선택 사항. LaunchTarget열거 값 또는 사용자 지정 이름.

매개변수( 매개변수 이름 )

ParameterName - 필수. 앱에 전달된 매개 변수 이름입니다.

예약된 매개변수

다음 키워드는 내부용으로 예약되어 있으며(대소문자에 관계없이) Param() 함수에서 사용자 지정 매개 변수로 사용되어서는 안 됩니다.

amp%3Bauthmode
amp%3Benableonbehalfof
amp%3Bhidenavbar
amp%3Blocale
appmetadataversion
authmode
channeltype
cordovapath
correlationid
디버그
delegatelaunchurl
delegatelaunchurl
disablepreviewredirect
embedderorigin
enableonbehalfof
groupid
hideappsplash
hidenavbar
hint
hostclienttype
hostmode
iframecontainerid
isfullscreen
ispreviewmode
로더
loaderType
locale
위치
packagekind
packageproperties
playerresourcespath
playersessionid
powerappslanguage
screencolor
sdkversion
사이트
skipappmetadata
skipiframecreation
skiplaunchappcache
원본
sourcetime
standaloneconsent
teamid
teamtype
tenantId
theme
uselocalpackagehostresources
userteamrole

예

간단한 시작

캔버스 앱에서 웹 페이지로:

수식	Description
( "http://bing.com/search", 시작 "q", "Power Apps", "count", 1 )	https://bing.com/search?q=Power%20Apps&count=1 웹 페이지를 엽니다. 새로운 창 또는 탭이 열립니다.
시작( "http://bing.com/search", { q: "Power Apps", count: 1 } )	동등한 레코드 표기법을 사용하는 이전 예제와 동일합니다. 새로운 창 또는 탭이 열립니다.
시작( "http://bing.com/search", { q: "Power Apps", count: 1 }, LaunchTarget.Replace )	웹 브라우저에서 실행 중인 경우 현재 창 또는 탭을 결과로 대체하는 이전 예제와 동일합니다.
시작( "http://bing.com/search", { q: "Power Apps", count: 1 }, "Search Results" )	이전 예제와 동일하게 이름이 검색 결과로 지정된 창 또는 탭의 내용을 작성하거나 바꿉니다.

캔버스 앱에서 캔버스 앱으로

앱 ID, 화면 이름 및 레코드 번호를 적절하게 업데이트합니다.

Launch( "/providers/Microsoft.PowerApps/apps/YOUR-APP-ID",
        { Navigate: "Second Screen", Record: 34 }
)

웹 페이지에서 웹 페이지로:

앱 ID, 테넌트 ID, 화면 이름 및 레코드 번호를 적절하게 업데이트합니다.

<html>
  <body>
    <a
      href="https://apps.powerapps.com/play/e/YOUR-APP-ENVIRONMENT-ID/a/YOUR-APP-ID?tenantId=YOUR-TENANT-ID&Navigate=Second%20Screen&Record=34"
    >
      Launch canvas app
    </a>
  </body>
</html>

간단한 Param

웹 페이지에서 또는 다른 캔버스 앱에서 캔버스 앱을 시작하기 위한 위의 간단한 launch 예제는 Param 함수에 대한 간단한 예제를 보여줍니다.

수식	설명	결과
Param( "탐색")	Navigate 매개 변수가 앱이 시작되고 반환될 때 제공됩니다.	"두 번째 화면"
Param( "레코드" )	Record 매개 변수가 앱이 시작되고 반환될 때 제공됩니다. 숫자로 Launch 함수로 전달되었지만 Param의 결과는 묵시적 또는 명시적으로 다른 형식으로 변환될 수 있는 텍스트 문자열입니다.	"34"
Param( "사용자" )	User 매개 변수가 제공되지 않았습니다. IsBlank 함수로 테스트될 수 있는 공백 값이 반환됩니다.	공백

Launch 및 Param에 대한 단계별 예제

제품 쇼케이스 태블릿 레이아웃 템플릿은 다음 예제에 사용되었습니다. 이 템플릿으로 앱을 만들려면 앱 만들기 문서의 단계를 따르고 제품 쇼케이스 템플릿을 선택합니다. 또한 소유한 앱을 사용해도 됩니다.

예제 - Launch

Power Apps(으)로 이동합니다.
왼쪽 탐색 창에서 앱을 선택합니다.
앱을 선택한 다음 편집을 선택합니다.
메뉴에서 삽입을 선택한 다음 레이블을 선택합니다.
레이블을 화면 하단 오른쪽으로 이동합니다.
오른쪽의 속성 창에서 색상을 하얀색으로 선택하고 테두리 두께를 1로 설정합니다.
오른쪽에서 Text 속성을 선택하고 Surface tablets in news와 같은 문자를 입력합니다.
왼쪽 상단의 속성 목록에서 OnSelect를 선택합니다.
Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets")로 수식을 입력합니다. 또한 원하는 다른 URL, 매개 변수, 키워드를 사용할 수 있습니다.
저장 및 앱을 게시합니다.
앱을 실행합니다.
키워드로 뉴스 검색을 시작하려면 뉴스의 Surface 태블릿 레이블을 선택하세요 Microsoft Surface 태블릿.

팁

확장성을 위해 Launch 함수에서 수동으로 입력한 키워드를 변수로 바꿉니다.

예제 - Param

Power Apps(으)로 이동합니다.
왼쪽 탐색 창에서 앱을 선택합니다.
앱을 선택한 다음 편집을 선택합니다.
메뉴에서 삽입을 선택한 다음 레이블을 선택합니다.
레이블을 화면 하단 오른쪽으로 이동합니다.
상단 왼쪽에서 레이블의 Text 속성을 선택합니다.
Param("browser")로 수식을 입력합니다. 또한 원하는 매개 변수를 사용할 수 있습니다.
저장 및 앱을 게시합니다.
Power Apps에서 앱에 대한 웹 링크를 복사합니다.
새 브라우저에서 열기.
브라우저에 앱 웹 링크를 붙여 넣고 끝에 &browser=Microsoft%20Edge 를 추가합니다.
앱이 시작되면 레이블에 전달된 매개 변수 값이 표시됩니다.
앱 플레이어를 닫고 앱을 편집합니다.
왼쪽 탐색의 트리 뷰에서 앱을 선택합니다.
상단 왼쪽의 StartScreen 속성을 선택합니다.
If( Param("screen") = "techspecs", TechSpecs ) 수식을 입력합니다.

StartScreen 속성 의 함수가 매개변수가 특정 값과 같은지 확인하는 경우, 이 경우에는 techspecs값입니다. 일치하면 TechSpecs screen 컨트롤을 StartScreen 속성으로 반환합니다.

노트

제품 쇼케이스 앱 템플릿을 사용하지 않는 경우 If 함수의 TechSpecs 컨트롤 이름을 자체 앱의 screen 컨트롤 이름으로 바꿉니다.
저장 및 앱 게시.
새 브라우저에서 열기.
브라우저에 앱 웹 링크를 붙여 넣고 끝에 &screen=techspecs 를 추가합니다.
앱이 시작 화면으로 TechSpecs과 함께 바로 실행됩니다.