Udostępnij za pośrednictwem

Opis funkcji integracji formularzy programu SharePoint

Możesz dostosować formularz dla listy SharePoint podczas integracji listy z Power Apps. W tym artykule zobaczysz, jak działają te formularze i jak można je dostosować.

Po dostosowaniu formularza dla listy widać, że domyślnie wygenerowany formularz działa dla wszystkich operacji, takich jak tworzenie, wyświetlanie lub edytowanie produktu. Ta funkcjonalność wykorzystuje wygenerowane formuły i SharePointIntegration.

Notatka

Podczas tworzenia lub wyświetlania listy w SharePoint następuje automatyczne przekierowanie do Microsoft Lists. Listę można zawsze znaleźć zarówno w Microsoft Lists, jak i SharePoint. Dowiedz się więcej w temacie Co to jest lista Microsoft 365?

Omówienie domyślnie wygenerowanego formularza

Domyślnie wygenerowany formularz zawiera następujące kontrolki i ich odpowiednie wartości domyślne. Formuły są generowane automatycznie w ramach wartości domyślnych.

  • FormScreen1 — ekran zawierający formularz.

  • SharePointForm1 — formularz umożliwiający utworzenie, wyświetlenie lub edytowanie elementu listy.

    • Data Source — lista, dla której dostosowano formularz. Na przykład lista SharePoint działa jako źródło danych.

    • Item — wybrany element listy. Ten element jest ustawiony na First() produkt na liście dla wygody użytkownika, podczas pracy w trybie Power Apps Studio.

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

      Wskazówka

      Powyższy wzorzec formuły (przy użyciu ... SharePointDatasourceName.Selected) działa dla właściwości formularza Item. Zobacz Typowe problemy z obiektem SharePointIntegration dla wzorca formuły, aby ustawić wartość rekordu SharePoint.

  • OnSuccess — po pomyślnym utworzeniu lub zapisaniu elementu następuje zresetowanie formularza i ukrycie go w programie SharePoint.

    ResetForm(SharePointForm1); RequestHide()

  • Kontrolka SharePointIntegration służy do przekazywania informacji o akcjach użytkownika między programem SharePoint i usługą Power Apps.

    Właściwości Podpis Przykład
    Źródło danych Lista, dla której jest dostosowywany formularz. YourListName
    OnNew Ustawia SharePointForm1 w nowym trybie. NewForm(SharePointForm1)
    OnView Ustawia dla elementu SharePointForm1 tryb wyświetlania. ViewForm(SharePointForm1)
    OnEdit Ustawia dla elementu SharePointForm1 tryb edytowania. EditForm(SharePointForm1)
    PrzyZapisie Przesyła zmiany do elementu SharePointForm1. Formuła SharePointForm1.OnSuccess jest wykonywana po pomyślnym przesłaniu formularza. SubmitForm(SharePointForm1)
    OnCancel Resetuje zmiany w elemencie SharePointForm1. SharePoint zawsze ukrywa formularz, gdy użytkownik wybierze opcję Anuluj w SharePoint. ResetForm(SharePointForm1)

Te ustawienia domyślne pozwalają zagwarantować, że formularz działa w programie SharePoint. Umożliwiają one zmianę trybu formularza usługi Power Apps w przypadku interakcji użytkownika z formularzem w programie SharePoint oraz pozwalają zagwarantować, że zmiany są przesyłane do programu SharePoint.

Notatka

Podczas gdy można ręcznie skopiować formularz z jednego środowiska do drugiego, w Power Apps nie ma obecnie zautomatyzowanej metody kopiowania formularza z jednego środowiska do drugiego.

Omówienie kontrolki SharePointIntegration

Kontrolka SharePointIntegration służy do przekazywania informacji o akcjach użytkownika między programem SharePoint i usługą Power Apps.

Zrzut ekranu obiektu integracji SharePoint widzianego w aplikacji Power Apps.

Notatka

Dostęp do właściwości kontrolki SharePointIntegration można uzyskać tylko wtedy, gdy formularz działa w programie SharePoint, a nie podczas dostosowywania formularza w programie Power Apps Studio. Te właściwości mogą być niedostępne w formułach OnStart lub OnVisible.

Kontrolka SharePointIntegration zawiera następujące właściwości:

Właściwości Efekt lub opis
Selected Wybrany produkt z listy.
OnNew Aktywuje się, gdy użytkownik wybierze przycisk Nowy lub otworzy formularz Utwórz produkt w SharePoint.
OnView Aktywuje się, gdy użytkownik wybierze produkt lub otworzy formularz Szczegóły produktu w SharePoint.
OnEdit Aktywuje się, gdy użytkownik wybierze przycisk Edytuj wszystko lub otworzy formularz Edytuj produkt w SharePoint.
PrzyZapisie Aktywuje się, gdy użytkownik wybierze przycisk Zapisz w aplikacji SharePoint.
OnCancel Aktywuje się, gdy użytkownik wybierze przycisk Anuluj w aplikacji SharePoint.
SelectedListItemID Identyfikator wybranego produktu na liście.
Źródło danych Lista zawierająca rekord, który formularz wyświetla, edytuje lub tworzy. Jeśli zmienisz tę właściwość, właściwości Selected i SelectedItemID mogą przestać działać.

Dostosowywanie formularza domyślnego

Formuły można zmieniać, aby jeszcze bardziej dostosować formularze.

Rozważ te taktyki podczas dostosowywania formularzy:

  • Użyj formuły OnSave w kontrolce SharePointIntegration, aby dostosować zachowanie w przypadku kliknięcia lub naciśnięcia przez użytkownika przycisku Zapisz w programie SharePoint. Jeśli masz wiele formularzy, upewnij się, że przesłano zmiany tylko obecnie używanego formularza.

    Wskazówka

    Ustaw różne wartości zmiennej w formułach OnNew, OnView i OnEdit. Możesz użyć tej zmiennej w formule OnSave, aby określić używany formularz.

  • Dołącz element RequestHide() do formuły OnSuccess we wszystkich formularzach. Bez tej funkcji SharePoint nie wie, kiedy ukryć formularz. Unikaj uruchamiania ważnego kodu po wywołaniu metody RequestHide(). Kod powinien być uruchamiany, gdy formularz jest nadal widoczny i może uruchamiać logikę.

  • Nie można kontrolować ukrywania formularza, gdy użytkownik wybierze opcję Anuluj w SharePoint. Zawsze resetuj formularze w formule OnCancel kontrolki SharePointIntegration.

  • Właściwości kontrolki SharePointIntegration mogą nie być dostępne w OnStart lub OnVisible. Te zdarzenia są wykonywane tylko raz podczas ładowania listy. Formuł OnNew, OnView lub OnEdit można użyć do uruchamiania przed wyświetleniem formularza dla użytkownika.

Typowe problemy dotyczące obiektu SharePointIntegration

  • Gdy wartość SharepointIntegration.Selected jest ustawiona na kolekcję w właściwości OnView, nie jest pokazywana najnowsza wartość. Zalecanym sposobem rozwiązania tego problemu jest użycie funkcji SharepointIntegration.SelectedListItemID, a następnie wykonanie wyszukiwania w tabeli w celu uzyskania wybranego rekordu.

    Na przykład dla właściwości OnView:

    • Zamiast:

      Set( selectedItem,
SharePointIntegration.Selected );

    • Użyj:

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

  • Zmienne kolekcji nie są resetowane podczas zamykania formularza Power Apps, a stan jest utrwalany dla całej sesji. Dlatego w przypadku użycia spraw, które wymagają zresetowania zmiennych, wyczyść zmienne w właściwości OnView obiektu SharePointIntegration.

  • Nie używaj funkcji imperatywnych, takich jak Launch() we właściwościach SharePointIntegration (takich jak OnNew i OnView). Takie użycie może powodować nieoczekiwane zachowanie, ponieważ zdarzenia cyklu życia SharePointIntegration (takie jak zmiana selekcji) mogą być wyzwalane w tle, nawet gdy formularz nie jest widoczny.