Jaa

Tietoja SharePoint-lomakkeiden integroinnista

  • Artikkeli

Voit nyt helposti mukauttaa minkä tahansa Microsoft-luettelot- tai -SharePoint-kirjastolomakkeen Power Appsissa. Näissä ohjeissa neuvomme vaiheittain, miten nämä lomakkeet toimivat ja miten niitä voi mukauttaa lisää.

Jos olet mukauttanut lomakkeen luetteloa varten, huomasit luultavasti, että oletuslomake toimii kaikissa toiminnoissa, kuten kohteen luomisessa, näyttämisessä ja muokkaamisessa. Tämä saavutetaan luotujen kaavojen ja SharePointIntegration-ohjausobjektin avulla.

Oletuslomake

Oletuslomake muodostuu seuraavista ohjausobjekteista ja niiden oletusarvoista:

  • FormScreen1 – Lomakkeen sisältävä näyttö.

  • SharePointForm1 – Luettelokohteen luontiin, näyttämiseen ja muokkaukseen käytetty lomake.

    • Data Source – Luettelo, jota varten lomake on mukautettu.

    • Item – Luettelosta valittu kohde. Tämän oletusarvona on First(), joka valitsee luettelon ensimmäisen kohteen Power Apps Studiossa.

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

      Vihje

      Yllä oleva kaavamalli (käyttäen ... SharePointDatasourceName.Selected) toimii lomakkeen Item-ominaisuudessa. Alla olevasta osasta löytyy kaavamalli SharePoint-tietueen arvon määrittämistä varten.

  • OnSuccess – Kun kohteen luominen tai tallentaminen onnistuu, lomake nollataan ja SharePoint piilottaa lomakkeen.

    ResetForm(SharePointForm1); RequestHide()

  • SharePointIntegration – Ohjausobjekti, joka vastaa käyttäjien toimiin liittyvästä tiedonsiirrosta SharePointin ja Power Appsin välillä.

    • Data Source – Luettelo, jota varten lomake on mukautettu.

      'YourListName'

    • OnNew – Asettaa SharePointForm1-lomakkeen Uusi-tilaan.

      NewForm(SharePointForm1)

    • OnView – Asettaa SharePointForm1-lomakkeen tarkastelutilaan.

      ViewForm(SharePointForm1)

    • OnEdit – Asettaa SharePointForm1-lomakkeen muokkaustilaan.

      EditForm(SharePointForm1)

    • OnSave – Lähettää SharePointForm1-lomakkeen muutokset. Kun lomakkeen lähetys onnistuu, suoritetaan kaava SharePointForm1.OnSuccess.

      SubmitForm(SharePointForm1)

    • OnCancel – Nollaa SharePointForm1-lomakkeen muutokset. SharePoint piilottaa lomakkeen aina, kun käyttäjä valitsee Peruuta SharePointissa.

      ResetForm(SharePointForm1)

Nämä oletusarvot varmistavat, että SharePointissa suoritettava lomake toimii. Ne muuttavat Power Apps -lomakkeen tilan, kun käyttäjä käyttää lomaketta SharePointissa. Lisäksi ne varmistavat, että muutokset lähetetään SharePointiin.

SharePointIntegration-ohjausobjekti

SharePointIntegration -ohjausobjekti vastaa käyttäjien toimiin liittyvästä tiedonsiirrosta SharePointin ja Power Appsin välillä.

SharePoint-integroinnin objekti.

Huomautus

SharePointIntegration-ohjausobjektin ominaisuudet ovat käytettävissä vain, kun lomake suoritetaan SharePointissa. Niitä ei voi käyttää, kun lomaketta mukautetaan Power Apps Studiossa. Nämä ominaisuudet eivät ole ehkä käytettävissä kohteissa OnStart tai OnVisible.

SharePointIntegration-ohjausobjektin ominaisuudet:

Valittu - luettelosta valittu kohde.

OnNew - Suoritettavat toiminnot, kun käyttäjä valitsee Uusi-painikkeen tai avaa Luo kohde-lomakkeen SharePointissa.

OnView - Suoritettavat toiminnot, kun käyttäjä valitsee kohteen tai avaa Kohteen tiedot-lomakkeen SharePointissa.

OnEdit - Suoritettavat toiminnot, kun käyttäjä valitsee Muokkaa kaikkia-painikkeen tai avaa Muokkaa kohdetta -lomakkeen SharePointissa.

OnSave - Suoritettavat toiminnot, kun käyttäjä valitsee Tallenna-painikkeen SharePointissa.

OnCancel - Suoritettavat toiminnot, kun käyttäjä valitsee Peruuta-painikkeen SharePointissa.

SelectedListItemID – -luettelosta valitun kohteen kohdetunnus.

Data Source – Luettelo, joka sisältää lomakkeen näyttämän, muokkaaman tai luoman tietueen. Jos käytät tätä ominaisuutta, Selected- ja SelectedItemID-ominaisuudet eivät välttämättä enää toimi.

Oletuslomakkeen mukautus

Nyt kun tunnet oletuslomakkeen ja SharePointIntegration-ohjausobjektin toimintaperiaatteen, voit muuttaa kaavoja ja siten mukauttaa lomakkeita edelleen. Lomakkeita mukautettaessa kannattaa huomioida seuraavat asiat:

  • Käytä OnSave-kaavaa SharePointIntegration-ohjausobjektissa mukauttaaksesi, mitä tapahtuu, kun käyttäjä valitsee Tallenna SharePointissa. Jos sinulla on useita lomakkeita, muista lähettää vain sillä hetkellä käytössä olevan lomakkeen muutokset.

    Vihje

    Määritä OnNew-, OnView- ja OnEdit-kaavojen muuttujille eri arvot. Voit käyttää tätä muuttujaa OnSave-kaavassa sen määrittämiseen, mikä lomake on käytössä.

  • Muista liittää RequestHide() kaikkien lomakkeidesi OnSuccess-kaavaan. Ilman sitä SharePoint ei tiedä, milloin lomake pitäisi piilottaa. Tärkeää koodia ei myöskään kannattaa suorittaa RequestHide()-kutsun jälkeen, sillä silloin koko koodi suoritetaan, kun lomake on edelleen näkyvissä ja logiikka voidaan suorittaa.

  • Et voi piilottaa lomaketta, kun käyttäjä valitsee Peruuta SharePointissa, joten varmista, että nollaat lomakkeet OnCancel-kaavassa SharePointIntegration-ohjausobjektissa.

  • SharePointIntegration-ohjausobjektin ominaisuudet eivät ole ehkä käytettävissä kohteissa OnStart tai OnVisible, ja nämä tapahtumat suoritetaan vain kerran, kun luettelo on ladattu. Voit käyttää OnNew, OnView, tai OnEdit suorittaa logiikka, ennen kuin lomake näytetään käyttäjälle aina, kun kaavoja.

SharePointIntegration-objektin yleiset ongelmat

  • Kun SharepointIntegration.Selected-arvo on määritetty OnView-ominaisuuden kokoelmaan, se ei näytä uusinta arvoa. Suositeltava tapa korjata tämä ongelma on käyttää kohdetta SharepointIntegration.SelectedListItemID ja tehdä sitten haku taulukossa, jotta selectedRecord saadaan.

    Esimerkiksi OnView-ominaisuudessa:

    • Sen sijaan:

      Set( selectedItem,
    SharePointIntegration.Selected );

    • Käyttö:

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

  • Kokoelman muuttujia ei nollata Power Apps-lomakkeen sulkemisen yhteydessä, ja tila säilyy koko istunnon ajan. Tämän takia, jos on käyttötapauksia, joissa muuttujat on nollattava, tyhjennä muuttujat SharePointIntegration-objektin OnView -ominaisuudessa.

  • Älä käytä SharePointIntegration-ominaisuuksissa (kuten OnNew- ja OnView-ominaisuuksissa) tärkeää toimintoa, kuten Launch()-toimintoa. Tämä voi aiheuttaa odottamatonta toimintaa, koska SharePointIntegration-elinkaaritapahtumat (kuten valinnat muuttuvat) voivat käynnistyä taustalla, vaikka lomake ei olisi näkyvissä.

Katso myös

Huomautus

Voitko kertoa meille dokumentaatiota koskevan kielimäärityksesi? Vastaa lyhyeen kyselyyn. (Huomaa, että tämä kysely on englanninkielinen.)

Kyselyyn vastaaminen kestää noin seitsemän minuuttia. Henkilökohtaisia tietoja ei kerätä (tietosuojatiedot).