다음을 통해 공유

앱, 흐름, 코드 또는 다른 함수에서 함수 호출(프리뷰)

[이 항목은 시험판 설명서이므로 변경될 수 있습니다.]

캔버스 앱, 모델 기반 앱의 사용자 지정 페이지, 흐름, 코드 또는 다른 함수에서 Dataverse의 함수를 호출할 수 있습니다.

중요

  • 이는 프리뷰 기능입니다.
  • 프리뷰 기능은 생산용으로 만들어진 것이 아니므로 기능이 제한될 수 있습니다. 이런 기능은 공식 릴리스 전에 사용할 수 있으므로 고객이 조기에 액세스하고 피드백을 제공할 수 있습니다.

캔버스 앱 또는 사용자 지정 페이지에서 함수 호출

  1. Power Apps(make.powerapps.com)의 함수 영역에서 캔버스 앱이나 사용자 지정 페이지에서 호출하려는 함수를 선택합니다.
  2. 명령 모음에서 코드 조각 복사를 선택합니다.
  3. 복사한 수식을 텍스트 편집기, 메모장 또는 쉽게 참조할 수 있는 위치에 붙여넣고 저장합니다.
  4. Power Apps Studio의 경우:
    1. Power Apps Studio에서 캔버스 앱 또는 사용자 지정 페이지를 만들거나 편집합니다.
    2. 왼쪽 탐색 창에서 데이터 원본 탭에서 데이터 추가를 선택하고, Dataverse 커넥터에서 환경 옵션을 검색하여 선택합니다.
    3. 캔버스에 다음 구성 요소를 삽입합니다.
      • 각 매개 변수의 데이터 형식에 해당하는 입력 컨트롤(예: 숫자 입력)을 추가합니다.
      • 버튼를 추가하여 함수를 호출합니다.
      • 매개 변수의 데이터 형식(예: 숫자 입력)에 해당하는 출력 컨트롤을 추가합니다.
  5. 만든 버튼을 선택하고 OnSelect 속성에 Environment.new_calculatesum과 같은 함수를 입력합니다.
  6. 각 입력 매개 변수 Value를 매핑하여 해당 입력 컨트롤을 참조합니다.
    • 함수가 Environment.new_CalculateSum({ X: Value, Y: Value });라면, Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value });와 같이 다시 작성할 수 있습니다.
    • 함수 'result' 출력을 설정하려면 수식을 'Set(result, Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value }))'로 업데이트합니다.
  7. 출력 컨트롤을 선택하고 수식 'result.z'를 사용하여 'Value' 속성을 설정합니다.

앱을 미리 보고, 입력 1 및 2 값을 입력하고, 버튼를 선택합니다. 결과가 출력 필드에 표시되어야 합니다.

Power Automate 클라우드 흐름에서 함수 호출

  1. 클라우드 흐름에서는 Microsoft Dataverse 커넥터에서 새 작업을 추가합니다.
  2. Select the action called 바인딩되지 않은 작업 수행이라는 작업 선택
  3. 함수를 선택합니다. 함수에는 접두사가 있는 고유한 이름이 있습니다.
  4. 모든 입력 매개 변수(있는 경우)에 대한 값을 제공합니다.

Dataverse 웹 API에서 함수 호출

웹 API에서 사용자 지정 API 호출 문서의 바인딩되지 않은 작업 섹션에 대한 단계를 따르세요(플러그 인의 적절한 범위에 따라 다름).

새 함수 내에서 기존 함수 호출

새 함수 내에서 기존 함수를 호출하려면 Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN}) 구문을 사용합니다

출력은 항상 레코드이므로 점 표기법을 사용하여 출력 매개 변수에 액세스합니다. 예를 들어, 함수 "ExistingFunction"에 out1 및 out2로 정의된 두 개의 출력 매개 변수가 있는 경우 다음 두 가지 방법 중 하나로 액세스할 수 있습니다.

  • Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN}).out1
  • Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN}).out2

Dataverse에서의 함수에 대한 제한 사항

  • 기존 캔버스 앱 내의 새 기능에 액세스하려면 환경 언어 개체를 다시 추가해야 합니다. 기존 캔버스 앱에 환경 테이블 데이터 원본을 추가한 후 만든 모든 함수의 경우 Power Fx 환경 언어 개체를 제거했다가 다시 추가해야 합니다. 그러면 업데이트된 함수 목록이 작업으로 표시됩니다.
  • 중첩 지원. 함수는 Power Fx 식에서 Microsoft가 게시한 Microsoft 작업만 호출할 수 있습니다.
  • 일부 Collect 시나리오에는 Patch가 필요합니다. Collect()이 작동하지 않는 몇 가지 시나리오가 있습니다. 해결 방법은 여기에 있는 관련 열 채우기 예제에 표시된 대로 Patch()를 사용하는 것입니다.
Patch(Faxes,
       Collect(Faxes, {  Subject : "Sub1" } ),
       { Regarding : First(Accounts) }
    )

함수에 대한 디버그 및 도움말 보기

함수를 만들거나 실행하는 데 문제가 발생하면 trace() 함수를 사용하여 디버깅하거나 Dataverse 함수의 제한 사항에서 발생할 수 있는 일반적인 문제를 확인하세요.

trace() 함수를 사용하여 디버깅

  1. Trace 함수를 사용하여 디버깅하려면 플러그 인 및 사용자 지정 워크플로 활동 추적을 사용하도록 설정해야 합니다.
  2. Power Apps(make.powerapps.com)로 이동하여 오른쪽 상단에 있는 설정 기어 아이콘을 선택한 다음, 고급 설정을 선택합니다.
  3. 설정 > 감사 > 전역 감사 설정을 선택합니다.
  4. 사용자 지정 탭에서 플러그인 추적 로그에 로깅 사용이 모두에게 활성화되어 있는지 확인합니다.

추적을 활성화하면 trace() 함수를 사용하여 Power Fx 수식을 디버그할 수 있습니다. Power Fx 식: Trace 함수 - Power Platform 내에서 trace() 함수를 사용하는 방법에 대해 자세히 알아보세요.

도움말 + 지원 문의

Microsoft Dataverse 로우코드 플러그 인 팁에 포함되지 않은 기능 관련 문제나 문서화되지 않은 오류 수신 등 알려진 문제의 경우 도움말 + 지원 환경을 사용하고 다음 정보를 포함하세요.

  • 문제 유형- Dataverse 웹 API 및 SDK.
  • 문제 하위 유형.

예제 함수

Microsoft Dataverse에서 함수 만들기 및 사용

  • Last updated on