Nocións acerca da integración con formularios de SharePoint

Artigo
04/07/2022
2 minutos de lectura

Agora podes facilmente personalizar calquera lista de Microsoft ou SharePoint formulario de biblioteca en Power Apps. Neste artigo, explicaremos como funcionan estes formularios e como pode personalizalos.

Se personalizou un formulario para unha lista, probablemente teña notado que o formulario xerado predeterminado funciona para todas as operacións, como crear, mostrar ou editar un elemento. Isto faise coa axuda de fórmulas xeradas e o control SharePointIntegration.

Comprender o formulario xerado por defecto

O formulario xerado por defecto está composto polos seguintes controis e os seus valores por defecto:

FormScreen1: Esta é a pantalla que contén o formulario.
SharePointForm1: Este é o formulario que se usa para crear, amosar ou editar o elemento da lista.
- Orixe de datos: A lista para a que o formulario foi personalizado.
- Elemento: O elemento seleccionado da lista. Isto está definido como Primeiro() elemento da lista para facilitar a comodidade ao traballar en Power Apps Studio.
```
If( IsBlank(SharePointIntegration.Selected) || IsEmpty(SharePointIntegration.Selected),
    First('*YourListName*'),
    SharePointIntegration.Selected )
```
  Suxestión
  
  O padrón de fórmula anterior (usando ... SharePointDatasourceName.Selected) funciona para a propiedade Elemento dun formulario. Vexa a sección a continuación para obter un padrón de fórmula para establecer o valor dun rexistro de SharePoint.
OnSuccess: Unha vez que o elemento é creado ou gardado con éxito, o formulario é restablecido e SharePoint esconde o formulario.
```
ResetForm(SharePointForm1); RequestHide()
```
SharePointIntegration: O control responsable de comunicar as accións dos usuarios entre SharePoint e Power Apps.
- Orixe de datos: A lista para a que o formulario foi personalizado.
  
  'YourListName'
- OnNew: Establece SharePointForm1 en modo novo.
  
  NewForm(SharePointForm1)
- OnView: Establece SharePointForm1 en modo de visualización.
  
  ViewForm(SharePointForm1)
- OnView: Establece SharePointForm1 en modo de edición.
  
  EditForm(SharePointForm1)
- OnSave: Envía os cambios a SharePointForm1. Ao enviar o formulario con éxito, a fórmula SharePointForm1.OnSuccess é executada.
  
  SubmitForm(SharePointForm1)
- OnCancel: Restablece os cambios a SharePointForm1. SharePoint sempre oculta o formulario cando un usuario selecciona Cancelar en SharePoint.
  
  ResetForm(SharePointForm1)

Estes valores por defecto garanten que o formulario funciona cando se executa dentro de SharePoint; cambian o modo do formulario de Power Apps a medida que o usuario interactúa con el en SharePoint e aseguran que se envían os cambios a SharePoint.

Entender o control SharePointIntegration

O control SharePointIntegration comunica as accións dos usuarios entre SharePoint e Power Apps.

Obxecto de integración de SharePoint.

Nota

Pode acceder ás propiedadesdo control SharePointIntegration só cando se estea a executar o formulario en SharePoint, e non cando estea a personalizar o formulario en Power Apps Studio. É posible que estas propiedades non estean dispoñibles en OnStart ou OnVisible.

O control SharePointIntegration ten as seguintes propiedades:

Seleccionado - O elemento seleccionado da lista.

OnNew: Accións que se van realizar cando un usuario selecciona o botón Novo ou abre o formulario Crear elemento en SharePoint.

OnView: Accións que se van realizar cando un usuario selecciona un elemento ou abre o formulario Detalle do elemento en SharePoint.

OnEdit: Accións que se van realizar cando un usuario selecciona o botón Editar todo ou abre o formulario Editar elemento en SharePoint.

OnSave: Accións que se van realizar cando un usuario selecciona o botón Gardar en SharePoint.

OnCancel: Accións que se van realizar cando un usuario selecciona o botón Cancelar en SharePoint.

SelectedListItemID - ID de elemento para o elemento seleccionado nunha lista.

Orixe de datos: A lista que contén o rexistro que a orixe de datos amosará, editará ou creará. Se cambia esta propiedade, as propiedades Seleccionado e SelectedItemID poden deixar de funcionar.

Personalizar o formulario por defecto

Agora que comprende mellor o formulario xerado por defecto e o control SharePointIntegration, pode cambiar as fórmulas para personalizar aínda máis os formularios. Aquí ten algunhas cousas que hai que ter en conta ao personalizar formularios:

Use a fórmula OnSave do control SharePointIntegration para personalizar o que ocorre cando un usuario selecciona Gardar en SharePoint. Se ten varios formularios, asegúrese de enviar os cambios só para o formulario que se está usando actualmente.

Suxestión

Estableza diferentes valores para unha variable nas fórmulas OnNew, OnView e OnEdit. Pode usar esta variable na fórmula OnSave para determinar que formulario se está a usar.
Asegúrese de incluír RequestHide() na fórmula OnSuccess de todos os seus formularios. Se esquece isto, SharePoint non saberá cando ocultar o formulario.
Non pode controlar a ocultación dun formulario cando un usuario o selecciona Cancelar en SharePoint, así que asegúrese de restablecer os seus formularios na fórmula OnCancel do control SharePointIntegration.
As propiedades do control SharePointIntegration é posible que non estean dispoñibles en OnStart ou OnVisible e eses eventos execútanse só unha vez que se carga a lista. Pode usar as fórmulas OnNew, OnView ou OnEdit para executar a lóxica antes de que o formulario se mostre ao usuario cada vez.

Problemas comúns co obxecto SharePointIntegration

Cando o valor de SharepointIntegration.Selected está configurado nunha colección na propiedade OnView, non mostra o valor máis recente. A forma recomendada de solucionar este problema é usar SharepointIntegration.SelectedListItemID e despois facer unha busca na táboa para obter o selectedRecord.

Por exemplo, paraa propiedade OnView:
- En vez de:
```
Set( selectedItem,
    SharePointIntegration.Selected );
```
- Use:
```
Set( selectedLookupItem,
    LookUp( YourSharepointIntegrationObject, 
            ID=SharePointIntegration.SelectedListItemID ) );
```
As variables da colección non se restablecen ao pechar o formulario de Power Apps e o estado persiste durante toda a sesión. É por iso que, se hai casos de uso nos que se deban restablecer as variables, borre as variables na propiedade OnView do obxecto SharePointIntegration.

Consulte tamén

EditForm, NewForm, SubmitForm, ResetForm, and ViewForm functions: funcións de formulario en Power Apps
Función RequestHide
Escenarios de integración de SharePoint