Informació sobre la integració de formularis del SharePoint

Ara podeu personalitzar fàcilment qualsevol formulari de llista de SharePoint a Power Apps. En aquest article us expliquem els detalls sobre com funcionen aquests formularis i com els podeu personalitzar.

Si heu personalitzat un formulari per a una llista de SharePoint, és probable que hàgiu notat que el formulari generat per defecte funciona per a totes les operacions, com ara crear, mostrar o editar un element. Això es duu a terme amb l'ajuda de fórmules generades i el control SharePointIntegration.

Informació sobre el formulari generat per defecte

El formulari generat per defecte consisteix en els controls següents i els seus valors per defecte corresponents:

  • FormScreen1: aquesta és la pantalla que conté el formulari.

  • SharePointForm1: aquest és el formulari que s'utilitza per crear, mostrar o editar l'element de la llista.

    • Font de dades: la llista per a la qual s'ha personalitzat el formulari.

    • Element: l'element seleccionat de la llista. Aquest element s'estableix en primer element de la llista per a la vostra comoditat quan treballeu a Power Apps Studio.

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

      Suggeriment

      El patró de la fórmula anterior (amb ... SharePointDatasourceName.Selected) funciona per a la propietat Item d'un formulari. Vegeu la secció següent per obtenir un patró de fórmula per definir el valor d'un registre SharePoint.

  • OnSuccess : Un cop l'element es crea o es desa correctament, el formulari es reinicialitza i SharePoint amaga el formulari.

    ResetForm(SharePointForm1); RequestHide()
    
  • SharePointIntegration és el control responsable de comunicar les accions de l'usuari entre SharePoint i Power Apps.

    • Font de dades: la llista per a la qual s'ha personalitzat el formulari.

      'YourListName'

    • OnNew: defineix SharePointForm1 en el mode nou.

      NewForm(SharePointForm1)

    • OnView: defineix SharePointForm1 en el mode de visualització.

      ViewForm(SharePointForm1)

    • OnEdit: defineix SharePointForm1 en el mode d'edició.

      EditForm(SharePointForm1)

    • OnSave: envia els canvis a SharePointForm1. Després de l'enviament correcte del formulari, s'executa la fórmula SharePointForm1.OnSuccess.

      SubmitForm(SharePointForm1)

    • OnCancel: restableix els canvis a SharePointForm1. SharePoint sempre amaga el formulari quan un usuari selecciona Cancel·la-ho en SharePoint.

      ResetForm(SharePointForm1)

Aquests valors predeterminats asseguren que el formulari funcioni quan s'executa dins de SharePoint: canvien el mode de formulari Power Apps a mesura que l'usuari interactua amb ell en SharePoint i s'asseguren que els canvis s'enviïn a SharePoint.

Informació sobre el control SharePointIntegration

El control SharePointIntegració comunica les accions de l'usuari entre SharePoint i Power Apps.

SharePoint objecte d'integració.

Nota

Només podeu accedir a les propietats del controlIntegració del SharePoint quan el formulari s'estigui executant a SharePoint, no quan esteu personalitzant el formulari a Power Apps Studio. Pot ser que aquestes propietats no estiguin disponibles a OnStart o OnVisible.

El control SharePointIntegration té les propietats següents:

Seleccionat: l'element seleccionat de la llista de SharePoint.

OnNew : accions a realitzar quan un usuari selecciona el botó Crea o obre el formulari Crea un element a SharePoint.

OnView: accions a realitzar quan un usuari selecciona un element o obre el formulari De detall de l'element a SharePoint.

OnEdit: accions a realitzar quan un usuari selecciona el botó Edita-ho tot o obre el formulari Edita l'element a SharePoint.

OnSave: accions a realitzar quan un usuari selecciona el botó Desa a SharePoint.

OnCancel - Accions a realitzar quan un usuari selecciona el botó Cancel·la a SharePoint.

SelectedListItemID : identificador d'element per a l'element seleccionat d'una llista de SharePoint.

Data Source: la llista que conté el registre que el formulari mostrarà, editarà o crearà. Si canvieu aquesta propietat, les propietats Selected i SelectedItemID poden deixar de funcionar.

Personalitzar el formulari per defecte

Ara que enteneu millor el formulari generat per defecte i el control SharePointIntegration, podeu canviar les fórmules per personalitzar encara més els formularis. Aquestes són algunes de les coses que heu de tenir en compte quan personalitzeu els formularis:

  • Utilitzeu la fórmula OnSave del controlIntegració del SharePoint per personalitzar el que passa quan un usuari selecciona Desa el SharePoint. Si teniu diversos formularis, assegureu-vos d'enviar els canvis només per al formulari que s'estigui utilitzant.

    Suggeriment

    Definiu valors diferents per a una variable a les fórmules OnNew, OnView i OnEdit. Podeu utilitzar aquesta variable a la fórmula OnSave per determinar quin formulari s'està utilitzant.

  • Assegureu-vos d'incloure RequestHide() a la fórmula OnSuccess de tots els formularis. Si ho oblideu, SharePoint no sabrà quan amagar el formulari.

  • No podeu controlar l'ocultació d'un formulari quan un usuari selecciona Cancel·lar a SharePoint, així que assegureu-vos de restablir els formularis a la fórmula OnCancel del control d'integració del SharePoint.

  • Pot ser que les propietats del control SharePointIntegration no estiguin disponibles a OnStart o OnVisible i que aquestes incidències només s'executin una vegada mentre la llista es carrega. Podeu utilitzar les fórmules OnNew, OnView o OnEdit per executar lògica abans que es mostri el formulari a l'usuari cada vegada.

Problemes habituals amb l'objecte SharePointIntegration

  • Quan el valor de SharepointIntegration.Selected està definit en una col·lecció de la propietat OnView, no mostra el valor més recent. La manera recomanada per corregir aquest problema és utilitzar SharepointIntegration.SelectedListItemID i, a continuació, fer una cerca a la taula per obtenir el fitxer SelectedRecord.

    Per exemple, per a la propietat OnView:

    • En lloc de:

      Set( selectedItem,
          SharePointIntegration.Selected );
      
    • Utilitzeu:

      Set( selectedLookupItem,
          LookUp( YourSharepointIntegrationObject, 
                  ID=SharePointIntegration.SelectedListItemID ) );
      
  • Les variables de col·lecció no es restableixen en tancar el formulari Power Apps i l'estat es manté durant tota la sessió. Per això, si hi han casos d'ús en què s'han de restablir les variables, desactiveu les variables a la propietat OnView de l'objecte SharePointIntegration.

Consulteu també