Kopīgot, izmantojot

SharePoint veidlapu integrācijas skaidrojums

  • Raksts

Tagad varat viegli pielāgot jebkuru Microsoft Lists vai SharePoint bibliotēkas veidlapu risinājumā Power Apps. Šajā rakstā mēs izskaidrosim detalizēti, kā darbojas šīs veidlapas un kā pielāgot tās.

Ja esat pielāgojis veidlapu sarakstam, noteikti esat pamanījis, ka pēc noklusējuma ģenerētā veidlapa darbojas visām operācijām, piemēram, elementa izveidei, rādīšanai vai rediģēšanai. To var paveikt, izmantojot ģenerētās formulas un SharePointIntegration vadīklu.

Pēc noklusējuma ģenerētās veidlapas skaidrojums

Pēc noklusējuma ģenerētā veidlapa sastāv no tālāk norādītajām vadīklām un attiecīgajiem noklusējuma iestatījumiem:

  • FormScreen1 — tas ir ekrāns, kurā ir veidlapa.

  • SharePointForm1 — šī ir veidlapa, kas tiek izmantota, lai izveidotu, rādītu vai rediģētu saraksta elementu.

    • Datu avots — saraksts, kuram veidlapa ir pielāgota.

    • Elements — sarakstā atlasītais elements. Jūsu ērtībai tas sarakstā ir iestatīts uz elementu First(), strādājot programmā Power Apps Studio.

      If( IsBlank(SharePointIntegration.Selected) || IsEmpty(SharePointIntegration.Selected),
    First('*YourListName*'),
    SharePointIntegration.Selected )

      Padoms

      Iepriekš minētās formulas shēma (izmantojot ... SharePointDatasourceName.Selected) darbojas tikai veidlapas rekvizītā Elements. Skatiet tālāko sadaļu par formulas shēmu, lai iestatītu SharePoint ieraksta vērtību.

  • OnSuccess — kad elements ir sekmīgi izveidots vai saglabāts, veidlapa tiek atiestatīta, un SharePoint to paslēpj.

    ResetForm(SharePointForm1); RequestHide()

  • SharePointIntegration — vadīkla, kas atbildīga par lietotāja darbību paziņošanu starp SharePoint un Power Apps.

    • Datu avots — saraksts, kuram veidlapa ir pielāgota.

      'YourListName'

    • OnNew — iestata SharePointForm1 jaunā režīmā.

      NewForm(SharePointForm1)

    • OnView — iestata SharePointForm1 skatīšanas režīmā.

      ViewForm(SharePointForm1)

    • OnEdit — iestata SharePointForm1 rediģēšanas režīmā.

      EditForm(SharePointForm1)

    • OnSave — iesniedz izmaiņas veidlapā SharePointForm1. Pēc sekmīgas veidlapas iesniegšanas tiek izpildīta formula SharePointForm1.OnSuccess.

      SubmitForm(SharePointForm1)

    • OnCancel — atiestata izmaiņas veidlapā SharePointForm1. SharePoint vienmēr slēpj veidlapu, ja lietotājs atlasa SharePoint vienumu Atcelt.

      ResetForm(SharePointForm1)

Šie noklusējuma iestatījumi nodrošina, ka veidlapa darbojas, veicot darbību programmā SharePoint — tās maina Power Apps veidlapas režīmu, lietotājam ar veidlapu mijiedarbojas programmā SharePoint, un nodrošina izmaiņu iesniegšanu programmā SharePoint.

Informācija par vadīklu SharePointIntegration

Vadīkla SharePointIntegration paziņo par lietotāja darbībām starp SharePoint un Power Apps.

SharePoint integrācijas objekts.

Piezīme

Vadīklas SharePointIntegration rekvizītiem var piekļūt tikai tad, kad veidlapa darbojas programmā SharePoint, nevis tās pielāgošanas laikā programmā Power Apps Studio. Šie rekvizīti var nebūt pieejami OnStart vai OnVisible.

Vadīklai SharePointIntegration ir tālāk norādītie rekvizīti.

Selected — sarakstā atlasītais elements.

OnNew - veicamās darbības, kad lietotājs atlasa pogu Jauns vai atver veidlapu Izveidot elementu programmā SharePoint.

OnView - veicamās darbības, kad lietotājs atlasa pogu elements vai atver veidlapu Detalizēta informācija par elementu programmā SharePoint.

OnEdit - veicamās darbības, kad lietotājs atlasa pogu Rediģēt visu vai atver veidlapu Rediģēt elementu programmā SharePoint.

OnSave - veicamās darbības, kad lietotājs atlasa pogu Saglabāt programmā SharePoint.

OnCancel - veicamās darbības, kad lietotājs atlasa pogu Atcelt programmā SharePoint.

SelectedListItemID — elementa ID sarakstā atlasītajam elementam sarakstā.

Datu avots — saraksts, kurā iekļauts ieraksts, ko veidlapa rādīs, rediģēs vai izveidos. Ja maināt šo rekvizītu, rekvizīti Selected un SelectedItemID var beigt darboties.

Noklusējuma veidlapas pielāgošana

Tagad, kad jums ir labāka izpratne par noklusējuma ģenerēto veidlapu un vadīklu SharePointIntegration, varat mainīt formulas, lai vēl vairāk pielāgotu veidlapas. Tālāk ir norādītas dažas lietas, kas jāpatur prātā, pielāgojot formas.

  • Izmantojiet OnSave formulu SharePointIntegration vadīklā, lai pielāgotu, kas notiks, ja lietotājs atlasa pogu Saglabāt programmā SharePoint. Ja jums ir vairākas veidlapas, pārliecinieties, ka izmaiņas ir iesniegtas tikai pašlaik izmantotajai veidlapai.

    Padoms

    Iestatiet dažādas mainīgo vērtības formulām OnNew, OnView un OnEdit. Šo mainīgo var izmantot formulā OnSave, lai noteiktu, kura veidlapa tiek izmantota.

  • Pārliecinieties, vai visu jūsu veidlapu formulā OnSuccess ir iekļauts RequestHide(). Ja aizmirsīsiet šo, SharePoint nezinās, kad slēpt veidlapu. Tāpat izvairieties palaist svarīgu kodu pēc zvanīšanas uz RequestHide(), lai viss kods darbotos, kamēr veidlapa joprojām ir redzama un var palaist loģiku.

  • Jūs nevarat kontrolēt veidlapas slēpšanu, ja lietotājs atlasa pogu Atcelt programmā SharePoint, tādēļ pārliecinieties, ka atiestatāt savas veidlapas OnCancel formulā SharePointIntegration vadīklā.

  • Vadīklas SharePointIntegration rekvizīti var nebūt pieejami formulās OnStart vai OnVisible, un šie notikumi tiek izpildīti tikai vienreiz, kamēr saraksts tiek ielādēts. Varat izmantot formulas OnNew, OnView vai OnEdit loģikas palaišanai pirms veidlapa katru reizi tiek parādīta lietotājam.

Vispārējās problēmas ar SharePointIntegration objektu

  • Ja SharepointIntegration.Selected vērtība ir iestatīta uz OnView kolekcijas rekvizītu property, tā neatainos jaunāko vērtību. Ieteicamais veids, kā risināt šo problēmu, ir izmantot SharepointIntegration.SelectedListItemID un uzmeklēt tabulu, lai iegūtu atlasīto ierakstu.

    Piemēram, OnView rekvizītam:

    • Tā vietā:

      Set( selectedItem,
    SharePointIntegration.Selected );

    • Izmantot:

      Set( selectedLookupItem,
    LookUp( YourSharepointIntegrationObject, 
            ID=SharePointIntegration.SelectedListItemID ) );

  • Mainīgo kolekcija nav atiestatīta Power Apps veidlapas slēgšanai, un statuss saglabājas visu sesiju. Tādēļ, ja ir kādas situācijas, kurās ir jāatiestata mainīgie, noņemiet mainīgos rekvizītā OnView SharePointIntegration objektā.

  • Neizmantojiet pavēles funkcijas, piemēram, Launch(), SharePointIntegration rekvizītos (piemēram, OnNew un OnView). Šis lietojums var izraisīt neparedzētu darbību, jo SharePointIntegration dzīves cikla notikumi (piemēram, atlases izmaiņas) var aktivizēties fonā pat tad, ja veidlapa nav redzama.

Skatiet arī:

Piezīme

Kādas ir jūsu dokumentācijas valodas preferences? Aizpildiet īsu aptauju. (ņemiet vērā, ka aptauja ir angļu valodā)

Aptaujai būs nepieciešamas aptuveni septiņas minūtes. Nekādi personas dati netiks vākti (paziņojums par konfidencialitāti).