SharePoint 양식 통합 이해

아티클
03/16/2023

이제 Power Apps에서 Microsoft Lists 또는 SharePoint 라이브러리 양식 사용자 지정을 쉽게 할 수 있습니다. 이 문서에서는 이러한 양식의 작업 방식과 사용자 지정하는 방법을 설명합니다.

목록의 양식을 사용자 지정해 본 경험이 있다면 기본 생성 양식에서 항목 생성, 표시 또는 편집과 같은 모든 작업이 가능하다는 것을 알고 있을 것입니다. 이러한 작업은 생성된 수식과 SharePointIntegration 컨트롤의 도움으로 수행됩니다.

기본 생성 양식 이해

기본 생성 양식은 다음과 같은 컨트롤 및 그에 해당하는 기본값으로 구성됩니다.

FormScreen1 - 양식을 포함하는 화면입니다.
SharePointForm1 - 목록 항목을 작성, 표시 또는 편집하는 데 사용되는 양식입니다.
- 데이터 원본 - 양식이 사용자 지정된 목록입니다.
- 항목 - 목록에서 선택한 항목입니다. Power Apps Studio에서 작업할 때 편의를 위해 목록의 First() 항목으로 설정됩니다.
```
If( IsBlank(SharePointIntegration.Selected) || IsEmpty(SharePointIntegration.Selected),
    First('*YourListName*'),
    SharePointIntegration.Selected )
```
  팁
  
  위의 수식 패턴(... SharePointDatasourceName.Selected 사용)은 양식의 Item 속성에 작동합니다. SharePoint 레코드의 값을 설정하는 수식 패턴은 아래 섹션을 참조하세요.
OnSuccess - 항목 만들기나 저장이 완료되면 양식이 다시 설정되고 SharePoint에서 양식이 숨겨집니다.
```
ResetForm(SharePointForm1); RequestHide()
```
SharePointIntegration - SharePoint와 Power Apps 사이에서 사용자 작업의 전달을 담당하는 컨트롤입니다.
- 데이터 원본 - 양식이 사용자 지정된 목록입니다.
  
  'YourListName'
- OnNew - SharePointForm1을 새로 만들기 모드로 설정합니다.
  
  NewForm(SharePointForm1)
- OnView - SharePointForm1을 보기 모드로 설정합니다.
  
  ViewForm(SharePointForm1)
- OnEdit - SharePointForm1을 편집 모드로 설정합니다.
  
  EditForm(SharePointForm1)
- OnSave - 변경 내용을 SharePointForm1에 제출합니다. 양식 제출이 완료되면 SharePointForm1.OnSuccess 수식이 실행됩니다.
  
  SubmitForm(SharePointForm1)
- OnCancel - SharePointForm1에 대한 변경 내용을 다시 설정합니다. SharePoint는 사용자가 SharePoint에서 취소를 선택하면 항상 양식을 숨깁니다.
  
  ResetForm(SharePointForm1)

이 기본값은 SharePoint 내에서 실행 중일 때 양식이 작동되도록 합니다. 즉, SharePoint에서 사용자가 상호 작용할 때 Power Apps 양식 모드를 변경하고 변경 내용이 SharePoint에 제출되도록 합니다.

SharePointIntegration 컨트롤 이해

SharePointIntegration 컨트롤은 SharePoint와 Power Apps 사이에서 사용자 작업의 커뮤니케이션을 담당합니다.

SharePoint 통합 개체.

참고

SharePoint에서 양식을 실행하는 경우에만 SharePointIntegration 컨트롤의 속성에 액세스할 수 있으며 Power Apps Studio에서 양식을 사용자 지정할 때는 액세스할 수 없습니다. 이러한 속성은 OnStart 또는 OnVisible에서 확인할 수 있습니다.

SharePointIntegration 컨트롤에는 다음과 같은 속성이 있습니다.

Selected - 목록에서 선택한 항목입니다.

OnNew - 사용자가 신규 단추를 선택하거나 SharePoint에서 항목 만들기 양식을 열 때 실행할 작업.

OnView - 사용자가 항목 단추를 선택하거나 SharePoint에서 항목 세부 정보 양식을 열 때 실행할 작업.

OnEdit - 사용자가 모두 편집 단추를 선택하거나 SharePoint에서 항목 편집 양식을 열 때 실행할 작업.

OnSave - 사용자가 SharePoint에서 저장 단추를 선택할 때 실행할 작업.

OnCancel - 사용자가 SharePoint에서 취소 단추를 선택할 때 실행할 작업.

SelectedListItemID - 목록에서 선택한 항목의 항목 ID입니다.

데이터 원본 – 양식이 표시, 편집 또는 작성할 레코드가 포함된 목록입니다. 이 속성을 변경하면 Selected 및 SelectedItemID 속성이 작동을 중지할 수 있습니다.

기본 양식 사용자 지정

기본 생성 양식과 SharePointIntegration 컨트롤에 대한 이해를 바탕으로 수식을 변경하여 양식을 사용자 지정할 수 있습니다. 다음은 양식을 사용자 지정할 때 유의할 사항입니다.

SharePointIntegration 컨트롤의 OnSave 수식을 사용하여 사용자가 SharePoint에서 저장을 선택할 때 수행할 작업을 사용자 지정합니다. 양식이 여러 개 있는 경우 현재 사용 중인 양식에 대해서만 변경 내용을 제출해야 합니다.

팁

OnNew, OnView 및 OnEdit 수식의 변수에 다른 값을 설정합니다. OnSave 수식에 이 변수를 사용하면 어떤 양식을 사용 중인지 확인할 수 있습니다.
모든 양식의 OnSuccess 수식에 RequestHide() 를 포함해야 합니다. 이 작업을 잊으면 SharePoint는 양식을 언제 숨길지 알 수 없게 됩니다. 또한 RequestHide() 를 호출한 후 중요한 코드를 실행하지 마십시오. 그러면 양식이 계속 표시되고 로직을 실행할 수 있는 동안 모든 코드가 실행됩니다.
사용자가 SharePoint에서 취소를 선택할 때 양식 숨기기를 제어할 수 없으므로, SharePointIntegration 컨트롤의 OnCancel 수식에서 양식을 다시 설정해야 합니다.
SharePointIntegration 컨트롤의 속성은 OnStart 또는 OnVisible에서 지원되지 않을 수 있습니다. 또한 해당 이벤트는 목록을 로드할 때 한 번만 실행합니다. OnNew, OnView 또는 OnEdit 수식을 사용하여 양식이 매번 사용자에게 표시되기 전에 논리를 실행할 수 있습니다.

SharePointIntegration 개체의 일반적인 문제

SharepointIntegration.Selected 값이 OnView 속성의 컬렉션으로 설정되면 최신 값을 표시하지 않습니다. 이 문제를 해결하는 권장 방법은 SharepointIntegration.SelectedListItemID를 사용한 다음 테이블을 조회하여 selectedRecord를 가져오는 것입니다.

예를 들어 OnView 속성의 경우:
- 다음 대신:
```
Set( selectedItem,
    SharePointIntegration.Selected );
```
- 다음 사용:
```
Set( selectedLookupItem,
    LookUp( YourSharepointIntegrationObject, 
            ID=SharePointIntegration.SelectedListItemID ) );
```
Power Apps 양식을 닫을 때 컬렉션 변수가 재설정되지 않으며 상태가 전체 세션 동안 지속됩니다. 그렇기 때문에 변수를 재설정해야 하는 사용 사례가 있는 경우 SharePointIntegration 개체의 OnView 속성의 변수를 지워야 합니다.
SharePointIntegration 속성(예: OnNew 및 OnView)에서 Launch() 와 같은 명령형 함수를 사용하지 마십시오. 이 사용은 SharePointIntegration 수명 주기 이벤트(예: 선택 변경)가 양식이 표시되지 않는 경우에도 백그라운드에서 트리거될 수 있으므로 예기치 않은 동작을 유발할 수 있습니다.

참조 항목

EditForm, NewForm, SubmitForm, ResetForm, ViewForm 함수 - Power Apps의 양식 함수
RequestHide 함수
SharePoint 통합 시나리오

참고

귀사의 설명서 언어 기본 설정에 대해 말씀해 주시겠습니까? 간단한 설문 조사에 응해주세요. (이 설문 조사는 영어로 되어 있습니다.)

이 설문 조사는 약 7분 정도 걸립니다. 개인 데이터는 수집되지 않습니다(개인정보처리방침).