Launch 및 Param 함수

적용 대상: 캔버스 앱

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

Launch

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

• 주소(필수), 웹페이지의 URL 또는 캔버스 앱의 앱 URI(접두사가 /providers/Microsoft.PowerApps/apps/인 앱 ID)입니다.
• Parameters (선택 사항) 웹 페이지 또는 캔버스 앱에 전달할 명명된 값입니다. 캔버스 앱에서 매개 변수는 Param 함수로 읽을 수 있습니다.
• Target (선택 사항), 웹 페이지 또는 캔버스 앱을 실행할 브라우저 탭입니다.

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

주소

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

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

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

1. Power Apps(으)로 이동합니다.

2. 왼쪽 탐색 창에서 앱을 선택합니다.

3. 앱을 선택합니다.

4. 상단 메뉴에서 세부 정보를 선택합니다.
   ... (추가 명령) 을 선택한 다음 드롭다운 메뉴에서 세부 정보를 선택할 수도 있습니다.

   

5. 웹 링크 또는 앱 ID를 복사합니다.

   

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

앱 ID는 Launch 함수와 함께 사용할 수 있지만 /providers/Microsoft.PowerApps/apps/ 접두사가 필요합니다. 예:

Launch( "/providers/Microsoft.PowerApps/apps/f342faaf-5f82-4ace-a64b-7c1b01499231" )

디바이스에서 기본 앱은 직접 시작될 수 없습니다. 특정 플랫폼에서 사용 가능한 간접 옵션이 있을 수 있습니다(예: 사용자 지정 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 열거 값 중 하나를 사용하거나 사용자 지정 창 이름을 제공합니다.

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

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 함수와 같이 명시적 전환을 사용해 분명하게 숫자로 변환합니다.

구문

Launch( Address [, ParameterName1, ParameterValue1, ... ] )

• Address – 필수 항목입니다. 시작할 웹 페이지의 주소 또는 앱의 ID입니다.
• ParameterName(s) – 선택 항목입니다. 매개 변수 이름입니다.
• ParameterValue(s) – 선택 항목입니다. 앱 또는 웹 페이지에 전달할 매개 변수 값입니다.

Launch( Address, { [ ParameterName1: ParameterValue1, ... ] } [, LaunchTarget ] )

• Address – 필수 항목입니다. 시작할 웹 페이지의 주소 또는 앱의 ID입니다.
• ParameterName(s) – 선택 항목입니다. 매개 변수 이름입니다.
• ParameterValue(s) – 선택 항목입니다. 앱 또는 웹 페이지에 전달할 매개 변수 값입니다.
• LaunchTarget – Optional. LaunchTarget열거 값 또는 사용자 지정 이름.

Param( ParameterName )

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

예약된 매개변수

다음 키워드는 내부용으로 예약되어 있으며(대소문자에 관계없이) 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

예

간단한 시작

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

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

앱 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 함수에 대한 간단한 예제를 보여줍니다.

Launch 및 Param에 대한 단계별 예제

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

예제 - Launch

1. Power Apps(으)로 이동합니다.

2. 왼쪽 탐색 창에서 앱을 선택합니다.

3. 앱을 선택한 다음 편집을 선택합니다.

4. 메뉴에서 삽입을 선택한 다음 레이블을 선택합니다.

5. 레이블을 화면 하단 오른쪽으로 이동합니다.

6. 오른쪽의 속성 창에서 색상을 하얀색으로 선택하고 테두리 두께를 1로 설정합니다.

7. 오른쪽에서 Text 속성을 선택하고 Surface tablets in news와 같은 문자를 입력합니다.

8. 왼쪽 상단의 속성 목록에서 OnSelect를 선택합니다.

9. Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets")로 수식을 입력합니다. 또한 원하는 다른 URL, 매개 변수, 키워드를 사용할 수 있습니다.

   

10. 저장 및 앱을 게시합니다.

11. 앱을 실행합니다.

12. Surface tablets in news 레이블을 선택해 Microsoft Surface 태블릿이라는 키워드로 뉴스 검색을 실행합니다.

예제 - Param

1. Power Apps(으)로 이동합니다.

2. 왼쪽 탐색 창에서 앱을 선택합니다.

3. 앱을 선택한 다음 편집을 선택합니다.

4. 메뉴에서 삽입을 선택한 다음 레이블을 선택합니다.

5. 레이블을 화면 하단 오른쪽으로 이동합니다.

6. 상단 왼쪽에서 레이블의 Text 속성을 선택합니다.

7. Param("browser")로 수식을 입력합니다. 또한 원하는 매개 변수를 사용할 수 있습니다.

   

8. 저장 및 앱을 게시합니다.

9. Power Apps에서 앱에 대한 웹 링크를 복사합니다.

10. 새 브라우저에서 열기.

11. 브라우저에 앱 웹 링크를 붙여 넣고 끝에 &browser=Microsoft%20Edge 를 추가합니다.

    

12. 앱이 시작되면 레이블에 전달된 매개 변수 값이 표시됩니다.

    

13. 앱 플레이어를 닫고 앱을 편집합니다.

14. 왼쪽 탐색의 트리 뷰에서 앱을 선택합니다.

15. 상단 왼쪽의 StartScreen 속성을 선택합니다.

16. If( Param("screen") = "techspecs", TechSpecs ) 수식을 입력합니다.

    

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

    노트

    제품 쇼케이스 앱 템플릿을 사용하지 않는 경우 If 함수의 TechSpecs 컨트롤 이름을 자체 앱의 screen 컨트롤 이름으로 바꿉니다.

17. 저장 및 앱 게시.

18. 새 브라우저에서 열기.

19. 브라우저에 앱 웹 링크를 붙여 넣고 끝에 &screen=techspecs 를 추가합니다.

    

20. 앱이 시작 화면으로 TechSpecs과 함께 바로 실행됩니다.

참조 항목

캔버스 앱 수식 참조