Разбиране на интеграцията на формуляри на SharePoint

Статия
03/15/2023

Сега можете лесно да персонализирате всеки формуляр на Microsoft Lists или библиотека в SharePoint в Power Apps. В тази статия ще разгледаме подробностите за това как работят тези формуляри и как можете да ги персонализирате.

Ако сте персонализирали формуляр за списък, вероятно сте забелязали, че генерираният по подразбиране формуляр работи за всички операции, като създаване, показване или редактиране на елемент. Това се осъществява с помощта на генерирани формули и контрола SharePointIntegration.

Разберете формата, генерирана по подразбиране

Генерираната по подразбиране форма се състои от следните контроли и съответните им по подразбиране:

FormScreen1 - Това е екран, който съдържа формуляра.
SharePointForm1 - Това е формуляра, който се използва за създаване, показване или редактиране на елемента от списъка.
- Източник на данни - Списъкът, за който формулярът е персонализиран.
- Елемент – Избраният елемент от списъка. Това е зададено на елемента First() в списъка за ваше удобство при работа в Power Apps Studio.
```
If( IsBlank(SharePointIntegration.Selected) || IsEmpty(SharePointIntegration.Selected),
    First('*YourListName*'),
    SharePointIntegration.Selected )
```
  Съвет
  
  Горната формула модел (използвайки ... SharePointDatasourceName.Selected) работи за Елемент свойство на форма. Вижте раздел по-долу за шаблон на формула, за да зададете стойността на 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 - те променят режима на формуляра на Power Apps, докато потребителят взаимодейства с него SharePoint и гарантира, че промените са изпратени на SharePoint.

Разберете контролата SharePointIntegration

Контролата SharePointIntegration комуникира действията на потребителите между SharePoint и Power Apps.

Обект за интеграция на SharePoint.

Бележка

Можете да получите достъп до свойствата за контролата SharePointIntegration само когато формулярът се изпълнява в SharePoint, а не когато персонализирате формуляра в Power Apps Studio. Тези свойства може да не са налични в OnStart или OnVisible.

Контролата SharePointIntegration има следните свойства:

Избрани – Избраният елемент от списъка.

OnNew - Действия за извършване, когато потребител избере бутон Ново или отваря Създайте артикул форма в SharePoint.

OnView - Действия за извършване, когато потребител избере елемент или отваря формуляр Подробности за елемент в SharePoint.

OnEdit - Действия за извършване, когато потребител избере бутон Редактиране на всички или отваря Редактиране на елемент форма в SharePoint.

OnSave - Действия за извършване, когато потребител избере бутон Записване в SharePoint.

OnCancel - Действия за извършване, когато потребител избере бутон Отмяна в SharePoint.

SelectedListItemID - ИД на избрания елемент в списък.

Източник на данни - Списъкът, който съдържа записа, който формулярът ще показва, редактира или създава. Ако промените това свойство, Избрано и SelectedItemID свойствата може да спрат да работят.

Персонализирайте формуляра по подразбиране

Сега, когато имате по-добро разбиране на генерираната по подразбиране форма и контролата SharePointIntegration, можете да промените формулите, за да персонализирате допълнително формулярите. Ето някои неща, които трябва да имате предвид, когато персонализирате формуляри:

Използвайте OnSave формула на контролата SharePointIntegration, за да персонализирате какво се случва, когато потребителят избере Записване в SharePoint. Ако имате няколко формуляра, не забравяйте да изпратите промените само за формуляра, който се използва в момента.

Съвет

Задайте различни стойности за променлива в OnNew, OnView и OnEdit формули. Можете да използвате тази променлива във формулата OnSave, за да определите коя форма се използва.
Не забравяйте да включите RequestHide() в OnSuccess формула на всичките ви формуляри. Ако забравите това, SharePoint няма да знае кога да скрие формуляра. Също така, избягвайте да изпълнявате важен код след извикване на RequestHide(), така че целият код да се изпълнява, докато формулярът все още е видим и може да изпълнява логика.
Не можете да контролирате скриването на формуляр, когато потребител избере Отмяна в SharePoint, така че се уверете, че сте нулирали формулярите си в OnCancel формула на SharePointIntegration контрола.
Свойствата за контролата 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 форма и състоянието се запазва за цялата сесия. Ето защо, ако има случаи на употреба, при които променливите трябва да бъдат нулирани, изчистете променливите в OnView свойство на обекта SharePointIntegration.
Не използвайте императивни функции като Launch() в свойствата на SharePointIntegration (като напр. OnNew и OnView). Тази употреба може да причини неочаквано поведение, тъй като събитията от жизнения цикъл на SharePointIntegration (като промяна на селекциите) могат да се задействат на заден план, дори когато формулярът не се вижда.

Вижте също

Функции EditForm, NewForm, SubmitForm, ResetForm и ViewForm – функции на формуляр в Power Apps
Функция RequestHide
Сценарии за интеграция на SharePoint

Бележка

Можете ли да ни споделите повече за езиковите си предпочитания за документацията? Попълнете кратко проучване. (имайте предвид, че това проучване е на английски език)

Проучването ще отнеме около седем минути. Не се събират лични данни (декларация за поверителност).

Споделяне чрез