Fahami integrasi borang SharePoint

Artikel
03/14/2023

Anda kini boleh menyesuaikan mana-mana Senarai Microsoft atau borang pustaka SharePoint dalam Power Apps dengan mudah. Dalam artikel ini, kami akan berjalan melalui butiran cara borang ini berfungsi dan cara anda boleh menyuaikannya.

Jika anda telah menyesuaikan borang untuk senarai, anda mungkin perasan bahawa borang yang dijana lalai untuk semua operasi, seperti mencipta, menunjukkan atau mengedit item. Ini dilaksanakan dengan bantuan formula yang dijana dan kawalan SharePointIntegration.

Fahami borang lalai yang dijana

Borang yang dijana lalai terdiri daripada kawalan berikut dan lalai yang berkaitannya:

FormScreen1 - Ini adalah skrin yang mengandungi borang.
SharePointForm1 - Ini adalah borang yang digunakan untuk mencipta, menunjukkan atau mengedit item senarai.
- Sumber Data - Senarai yang borang telah disuaikan.
- Item - item yang dipilih dari borang ini. Ini ditetapkan untuk Pertama () item dalam senarai untuk kemudahan anda apabila bekerja dalam Power Apps Studio.
```
If( IsBlank(SharePointIntegration.Selected) || IsEmpty(SharePointIntegration.Selected),
    First('*YourListName*'),
    SharePointIntegration.Selected )
```
  Petua
  
  Corak formula di atas (menggunakan ... SharePointDatasourceName.Selected) berfungsi untuk sifat Item borang. Lihat bahagian di bawah untuk corak formula untuk menetapkan nilai rekod SharePoint.
OnSuccess - Sebaik sahaja item dicipta atau disimpan dengan jayanya, borang ini akan diset semula dan SharePoint menyembunyikan borang.
```
ResetForm(SharePointForm1); RequestHide()
```
SharePointIntegration - Kawalan yang bertanggungjawab untuk berkomunikasi tindakan pengguna antara SharePoint dan Power Apps.
- Sumber Data - Senarai yang borang telah disuaikan.
  
  'YourListName'
- OnNew - Tetapkan SharePointForm1 dalam mod baharu.
  
  NewForm(SharePointForm1)
- OnView - Tetapkan SharePointForm1 dalam mod baharu.
  
  ViewForm(SharePointForm1)
- OnEdit - Tetapkan SharePointForm1 dalam mod edit.
  
  EditForm(SharePointForm1)
- OnSave -Hantarkan perubahan kepada SharePointForm1. Apabila berjaya menyerahkan borang, formula SharePointForm1.OnSuccess dilaksanakan.
  
  SubmitForm(SharePointForm1)
- OnCancel - Tetapkan semula perubahan kepada SharePointForm1. SharePoint sentiasa sembunyi borang apabila pengguna memilih Batal dalam SharePoint.
  
  ResetForm(SharePointForm1)

Lalai ini memastikan borang berfungsi apabila berjalan dalam SharePoint - ia mengubah mod borang Power Apps apabila pengguna berinteraksi dengannya dalam SharePoint, dan mereka memastikan bahawa perubahan diserahkan kepadanya SharePoint.

Memahami kawalan SharePointIntegration

Kawalan SharePointIntegration mengkomunikasikan tindakan pengguna antara SharePoint dan Power Apps.

Objek integrasi SharePoint.

Nota

Anda boleh mengakses sifat untuk kawalan SharePointIntegration hanya apabila borang sedang berjalan dalam SharePoint, tidak apabila anda menyesuaikan borang Power Apps Studio. Sifat ini mungkin tidak tersedia dalam OnStart atau OnVisible.

Kwalan SharePointIntegration mempunyai sifat berikut:

Dipilih - Item yang dipilih daripada senarai.

OnNew - Tindakan untuk melakukan apabila pengguna memilih butang Baharu atau membuka borang Cipta item dalam SharePoint.

OnView - Tindakan untuk melakukan apabila pengguna memilih item atau membuka borang Butiran item dalam SharePoint.

OnEdit - Tindakan untuk melakukan apabila pengguna memilih butang Edit semua atau membuka borang Edit item dalam SharePoint.

OnSave - Tindakan untuk melakukan apabila pengguna memilih butang Simpan dalam SharePoint.

OnCancel - Tindakan untuk melakukan apabila pengguna memilih butang Batal dalam SharePoint.

SelectedListItemID - ID item untuk item yang dipilih dalam senarai.

Sumber Data - Senarai yang mengandungi rekod yang borang akan ditunjukkan, edit atau cipta. Jika anda menukar sifat ini, sifat Selected dan SelectedItemID mungkin berhenti berfungsi.

Sesuaikan borang lalai

Sekarang anda mempunyai pemahaman yang lebih baik daripada borang lalai yang dijana dan kawalan SharePointIntegration, anda boleh mengubah formula untuk sesuaikan lebih lanjut borang. Berikut ialah beberapa perkara perlu diingati apabila anda sesuaikan borang:

Gunakan formula OnSave bagi kawalan SharePointIntegration untuk sesuaikan perkara yang berlaku apabila pengguna memilih Simpan dalam SharePoint. Jika anda mempunyai berbilang borang, pastikan anda menyerahkan perubahan hanya untuk borang yang sedang digunakan.

Petua

Tetapkan nilai berbeza untuk pemboleh ubah dalam formula OnNew, OnView dan OnEdit. Anda boleh menggunakan pemboleh ubah ini dalam formula OnSave untuk menentukan borang yang sedang digunakan.
Pastikan anda memasukkan RequestHide() dalam formula OnSuccess bagi semua borang anda. Jika anda terlupa ini, SharePoint tidak akan tahu bila hendak menyembunyikan borang. Selain itu, elakkan menjalankan kod penting selepas memanggil RequestHide(), supaya semua kod berjalan semasa borang masih kelihatan dan boleh menjalankan logik.
Anda tidak boleh mengawal penyembunyian borang apabila pengguna memilih Batal dalam SharePoint, jadi pastikan anda menetapkan semula borang anda dalam formula OnCancel bagi kawalan SharePointIntegration.
Sifat untuk kawalan SharePointIntegration mungkin tidak tersedia dalam OnStart atau OnVisible, dan peristiwa itu dilaksanakan hanya sekali sementara senarai itu dimuatkan. Anda boleh menggunakan formula OnNew, OnViewatau OnEdit untuk menjalankan logik sebelum borang ditunjukkan kepada pengguna setiap kali.

Isu lazim dengan objek SharePointIntegration

Apabila nilai SharepointIntegration.Selected ditetapkan pada koleksi pada sifat OnView, ia tidak menunjukkan nilai terkini. Cara yang disyorkan untuk menyelesaikan masalah ini adalah untuk menggunakan SharepointIntegration.SelectedListItemID dan kemudian lakukan carian pada jadual untuk mendapatkan selectedRecord.

Contohnya, untuk sifat OnView:
- Daripada:
```
Set( selectedItem,
    SharePointIntegration.Selected );
```
- Gunakan:
```
Set( selectedLookupItem,
    LookUp( YourSharepointIntegrationObject, 
            ID=SharePointIntegration.SelectedListItemID ) );
```
Pemboleh ubah koleksi tidak akan ditetapkan semula pada penutupan borang Power Apps dan keadaan akan berterusan untuk keseluruhan sesi. Sebab itu, jika ada mana-mana kes kegunaan yang mana pemboleh ubah perlu ditetapkan semula, kosongkan pemboleh ubah dalam sifat OnView objek SharePointIntegration.
Jangan gunakan fungsi imperatif seperti Lancarkan() dalam sifat SharePointIntegration (seperti OnNew dan OnView). Penggunaan ini boleh menyebabkan tingkah laku yang tidak dijangka memandangkan peristiwa kitar hayat SharePointIntegration (seperti perubahan pemilihan) boleh cetus di latar belakang walaupun semasa borang tidak boleh dilihat.

Lihat juga

Fungsi EditForm, NewForm, SubmitForm, ResetForm, dan ViewForm - fungsi borang dalam Power Apps
Fungsi RequestHide
Senario penyepaduan SharePoint

Nota

Adakah anda boleh memberitahu kami tentang keutamaan bahasa dokumentasi anda? Jawab tinjauan pendek. (harap maklum bahawa tinjauan ini dalam bahasa Inggeris)

Tinjauan akan mengambil masa lebih kurang tujuh minit. Tiada data peribadi akan dikumpulkan (pernyataan privasi).

Kongsi melalui