Ikhtisar konektor untuk aplikasi kanvas

Data adalah inti dari sebagian besar aplikasi, termasuk data yang Anda buat di Power Apps. Data disimpan dalam sumber data, dan Anda membawa data tersebut ke dalam aplikasi dengan membuat koneksi. Koneksi menggunakan konektor tertentu untuk berbicara dengan sumber data. Power Apps memiliki konektor untuk banyak layanan populer dan sumber data lokal, termasuk SharePoint, SQL Server, Office 365, Salesforce, dan Twitter. Untuk mulai menambahkan data ke aplikasi kanvas, lihat Menambahkan koneksi data di Power Apps.

Konektor mungkin menyediakan tabel data atau tindakan. Beberapa konektor hanya menyediakan tabel, beberapa hanya menyediakan tindakan, dan beberapa menyediakan keduanya. Selain itu, konektor Anda mungkin konektor standar atau kustom.

Catatan

Disarankan untuk menjaga jumlah konektor dalam aplikasi kanvas hingga maksimum 10 dan referensi koneksi tidak lebih dari 20. Melampaui batas ini dapat menyebabkan waktu pemuatan yang lebih lama bagi pengguna saat meluncurkan aplikasi dan dapat menyebabkan masalah saat menyimpan aplikasi.

Tabel

Jika konektor Anda menyediakan tabel, Anda menambahkan sumber data, lalu pilih tabel di sumber data yang ingin Anda kelola. Power Apps keduanya mengambil data tabel ke dalam aplikasi Anda dan memperbarui data di sumber data secara otomatis untuk Anda. Misalnya, Anda dapat menambahkan sumber data yang berisi tabel bernama Lessons lalu mengatur properti Item kontrol, seperti galeri atau formulir, ke nilai ini di bilah rumus:

Anda dapat menentukan data yang diambil aplikasi Anda dengan menyesuaikan properti Item kontrol yang menampilkan data Anda. Melanjutkan contoh sebelumnya, Anda dapat mengurutkan atau memfilter data dalam tabel Pelajaran dengan menggunakan nama tersebut sebagai argumen untuk fungsi Search dan SortByColumn . Dalam grafik ini, rumus yang properti Item diatur menentukan bahwa data diurutkan dan difilter berdasarkan teks di TextSearchBox1.

Untuk informasi lebih lanjut tentang cara menyesuaikan rumus Anda dengan tabel, lihat artikel ini:

Memahami sumber data di Power Apps
Menghasilkan aplikasi dari data Excel
Membuat aplikasi dari awal
Memahami tabel dan rekaman di Power Apps

Catatan

Untuk terhubung ke data di buku kerja Excel, file tersebut harus di-host di layanan penyimpanan cloud, seperti OneDrive. Untuk informasi selengkapnya, lihat Menyambungkan ke penyimpanan cloud dari Power Apps.

Tindakan

Jika konektor Anda memberikan tindakan, Anda harus tetap memilih sumber data seperti sebelumnya. Namun, alih-alih memilih tabel sebagai langkah berikutnya, Anda secara manual menyambungkan kontrol ke tindakan dengan mengedit properti Item kontrol yang akan menampilkan data Anda. Rumus tempat Anda mengatur properti Item menentukan tindakan yang mengambil data. Misalnya, aplikasi tidak mengambil data apa pun jika Anda tersambung ke Yammer dan kemudian mengatur properti Item ke nama sumber data. Untuk mengisi kontrol dengan data, tentukan tindakan seperti GetMessagesInGroup(5033622).messages.

Jika Anda perlu menangani pembaruan data kustom untuk konektor tindakan, buat rumus yang menyertakan fungsi Patch . Dalam rumus, identifikasi tindakan dan bidang yang mengikat ke tindakan.

Catatan

Untuk konektor berbasis tindakan, galeri dan kontrol lainnya tidak memasukkan lebih banyak data secara otomatis dengan cara yang sama seperti yang dilakukan untuk konektor tabel. Misalnya, jika Anda mengikat sumber data tabular ke galeri maka itu akan mengambil kumpulan atau halaman pertama rekaman (misalnya, 100 catatan.) Dan, kemudian akan memasukkan lebih banyak data saat kontrol memintanya. Namun, untuk konektor berbasis tindakan, konektor akan mengambil "halaman" data. Tetapi jika data yang diminta melebihi ukuran untuk halaman data, kontrol tidak akan secara otomatis mengambil halaman berikutnya.

Untuk informasi lebih lanjut tentang cara menyesuaikan rumus Anda untuk pembaruan kustom, lihat artikel ini:

Patch
Mengumpulkan
Pemutakhiran

Skema dinamis adalah jenis hasil umum untuk konektor berbasis tindakan. Skema dinamis mengacu pada kemungkinan bahwa tindakan yang sama mungkin mengembalikan tabel dengan kolom yang berbeda tergantung pada cara pemanggilannya. Kondisi yang dapat menyebabkan kolom dalam tabel berbeda antara lain parameter input, pengguna/peran yang menjalankan tindakan, dan grup tempat pengguna bekerja. Misalnya, prosedur tersimpan SQL Server mungkin mengembalikan kolom yang berbeda jika dijalankan dengan input yang berbeda, atau instans Azure DevOps mungkin menggunakan bidang kustom yang tidak tersedia secara default.

Catatan

Dokumentasi konektor menunjukkan hasil skema dinamis dengan pesan ini"Output dari operasi ini dinamis." sebagai nilai pengembalian.

Untuk informasi selengkapnya tentang cara bekerja dengan skema Power Apps dinamis, lihat Bekerja dengan objek yang Tidak Diketik dan Dinamis untuk gambaran umum dan Sambungkan dari Azure DevOps untuk Power Apps contoh terperinci.

Konektor populer

Tabel ini memiliki tautan ke informasi lebih lanjut tentang konektor kami yang paling populer. Untuk daftar lengkap konektor, lihat Semua konektor.

Microsoft Dataverse	Penyimpanan cloud **
Dinamika AX	Melampaui
Penerjemah Microsoft	Office 365 Outlook
Office 365 Pengguna	Oracle
Power BI	SharePoint
SQL Server	Twitter

** Berlaku untuk Azure Blob, Box, Dropbox, Google Drive, OneDrive dan OneDrive untuk Bisnis

Konektor standar dan kustom

Power Apps menyediakan konektor standar untuk banyak sumber data yang umum digunakan. Jika Power Apps memiliki konektor standar untuk jenis sumber data yang ingin Akan digunakan, Anda harus menggunakan konektor tersebut. Jika Anda ingin menyambungkan ke jenis sumber data lain, seperti layanan yang Anda buat, lihat Mendaftarkan dan menggunakan konektor kustom.

Semua konektor standar

Konektor standar tidak memerlukan lisensi khusus. Untuk informasi selengkapnya, lihat Power Apps Paket.

Anda dapat mengajukan pertanyaan tentang konektor tertentu di Power Apps forum, dan Anda dapat menyarankan konektor yang ingin Anda tambahkan atau peningkatan lain untuk dilakukan di Power Apps Ide.

Keamanan dan jenis autentikasi

Saat Anda menulis aplikasi dan membuat koneksi ke sumber data, Anda mungkin melihat bahwa pilihan konektor memungkinkan Anda menggunakan berbagai cara untuk mengautentikasi. Misalnya, konektor SQL Server memungkinkan Anda menggunakan Microsoft Entra Terintegrasi, Autentikasi SQL Server, dan Autentikasi Windows. Setiap jenis autentikasi memiliki tingkat keamanan berbeda yang terkait dengannya. Penting untuk memahami informasi dan hak apa saja yang Anda bagikan dengan pengguna yang menggunakan aplikasi Anda. Contoh utama dalam artikel ini adalah SQL Server, namun prinsipnya berlaku untuk semua jenis koneksi.

Catatan

• Untuk informasi terperinci tentang pertimbangan keamanan saat menggunakan server database relasional (seperti Microsoft SQL Server, atau Oracle) sebagai sumber data untuk aplikasi, lihat Menggunakan Microsoft SQL Server dengan aman dengan Power Apps.
• Power Apps tidak mendukung identitas anggota eksternal. Untuk informasi selengkapnya, lihat Properti pengguna Microsoft Entra kolaborasi B2B.

Microsoft Entra ID

Autentikasi ini adalah jenis koneksi yang aman. Misalnya, SharePoint menggunakan jenis autentikasi ini. SQL Server juga memungkinkan jenis autentikasi ini. Saat Anda terhubung, layanan mengidentifikasi Microsoft Entra Anda secara terpisah atas SharePoint nama Anda. Anda tidak perlu menyediakan nama pengguna atau kata sandi. Sebagai penulis, Anda dapat membuat dan bekerja dengan sumber data dengan kredensial Anda. Saat Anda menerbitkan aplikasi Anda dan pengguna aplikasi Anda masuk, mereka akan melakukannya dengan kredensial mereka. Jika data diamankan dengan tepat di back-end, pengguna Anda hanya dapat melihat apa yang mereka izinkan untuk melihat berdasarkan kredensial mereka. Jenis keamanan ini memungkinkan Anda mengubah hak untuk pengguna aplikasi tertentu pada sumber data back-end setelah aplikasi diterbitkan. Misalnya, Anda dapat memberikan akses, menolak akses, atau menyaring pengguna atau kumpulan pengguna yang dapat melihat semua di sumber data back-end.

Otorisasi standar terbuka (OAuth)

Ini adalah jenis koneksi yang aman juga. Misalnya, Twitter menggunakan jenis autentikasi ini. Saat Anda terhubung, Anda harus memberikan nama pengguna dan kata sandi Anda. Sebagai penulis, Anda dapat membuat dan bekerja dengan sumber data dengan kredensial Anda. Saat Anda menerbitkan aplikasi Anda dan pengguna aplikasi Anda masuk, mereka juga harus memberikan kredensial mereka. Oleh karena itu, jenis koneksi ini aman, karena pengguna harus menggunakan kredensial mereka sendiri untuk mengakses layanan sumber data.

Koneksi bersama / Koneksi Implisit Aman

Dalam koneksi bersama, nama pengguna dan kata sandi untuk koneksi disediakan oleh Power Apps penulis pada saat sumber data dibuat di aplikasi. Autentikasi koneksi ke sumber data kemudian Dibagikan secara Implisit dengan pengguna akhir. Setelah aplikasi diterbitkan, koneksi diterbitkan juga dan menjadi tersedia untuk pengguna Anda.

Sebelum Januari 2024, pengguna akhir Anda dapat mengambil koneksi yang dibagikan dengan mereka dan membuat aplikasi baru yang terpisah. Pengguna Anda tidak dapat melihat nama pengguna atau sandi, tetapi koneksi akan tersedia untuk mereka. Namun, setelah Januari 2024, semua koneksi bersama yang baru dibuat diamankan. Perhatikan bahwa aplikasi lama harus dipublikasikan ulang agar aman. Koneksi tidak lagi dibagikan dengan pengguna akhir. Power App yang diterbitkan berbicara dengan proksi koneksi. Proksi koneksi hanya berbicara dengan Power App tertentu yang ditautkan. Proksi koneksi membatasi tindakan yang dikirim ke koneksi ke yang ada di Power App {Dapatkan, Masukkan/Tambalan, Hapus untuk} sumber data tertentu. Jika Anda memiliki aplikasi yang menggunakan koneksi yang dipublikasikan sebelum Januari 2024, Anda harus memublikasikan ulang aplikasi Anda dan membatalkan berbagi koneksi apa pun dengan pengguna akhir yang seharusnya tidak memilikinya.

Di SQL Server, contoh jenis koneksi ini adalah Autentikasi SQL Server. Banyak sumber data database lain memberikan kemampuan yang serupa. Saat mempublikasikan aplikasi, pengguna tidak perlu menyediakan nama pengguna dan kata sandi unik.

Notifikasi untuk memperbarui aplikasi Anda (koneksi implisit aman)

Jika Anda memiliki aplikasi yang mungkin ditingkatkan untuk menggunakan fitur ini, Anda akan melihat pesan di halaman Aplikasi. Ini menunjukkan jumlah aplikasi yang membutuhkan perhatian Anda.

Pilih tautan dan itu akan membuka panel samping yang mencantumkan semua aplikasi yang perlu diperhatikan.

Pilih ikon buka di sebelah kanan nama aplikasi untuk membuka dan menerbitkannya kembali. Lanjutkan dengan petunjuk berikut.

Aktifkan koneksi implisit yang aman untuk aplikasi yang ada

Buka aplikasi yang sudah ada yang terbuka untuk diedit dengan koneksi yang dibagikan secara implisit yang sudah dipublikasikan:

1. Pada bilah perintah, pilih Pengaturan dan cari "Aman".
2. Perbarui sakelar fitur dengan tepat untuk mengaktifkan koneksi implisit yang aman.
3. Simpan dan publikasikan aplikasi.

Berhenti berbagi

Setelah aplikasi diterbitkan, ikuti langkah-langkah berikut untuk memverifikasi bahwa berbagi berfungsi dengan benar:

• Periksa apakah koneksi dibagikan dengan pemilik bersama. Jika Anda tidak ingin pengguna akhir mendapatkan koneksi, hapus centang pada kotak centang Pemilik bersama .

  

• Untuk memverifikasi fitur ini berfungsi dengan benar, bagikan aplikasi dengan pengguna lain yang bukan pemilik. Setelah Anda membagikan aplikasi, periksa daftar Koneksi di Dataverse tab untuk Power Apps pengguna tersebut. Pastikan pengguna tidak memiliki koneksi yang tersedia.

• Buka panel Berbagi untuk mengubah hak pengguna akhir ke koneksi. Memilih X akan menghapus akses pengguna ke koneksi.

  

Menggunakan aplikasi dengan koneksi implisit baru yang aman

Saat aplikasi Anda dipublikasikan ulang dan dibagikan, pengguna akhir tidak memiliki akses ke koneksi tetapi bekerja dengan koneksi proxy tersembunyi. Pengguna tidak dapat membuat aplikasi baru berdasarkan koneksi asli Anda.

Pembatasan

1. Semua jenis koneksi yang dibagikan secara implisit berfungsi seperti tindakan dan tabel.
2. Nama server dan database disembunyikan dalam pelacakan jaringan tetapi terlihat di dialog persetujuan. Nama kolom tidak disembunyikan.
3. Untuk konektor tabel, kami hanya membatasi tindakan CRUD seperti Dapatkan, Posting, Put, atau Hapus. Jika Anda memiliki izin untuk Putuskan, maka Anda memiliki akses ke Posting.
4. Batas konektor berbasis tindakan berdasarkan API tertentu yang digunakan dalam aplikasi.
5. Peringatan masih diaktifkan saat berbagi. Peringatan seputar koneksi yang dibagikan secara implisit masih memperingatkan saat dalam pratinjau. Namun, koneksi Anda dengan fitur ini aman – meskipun ada peringatan.
6. Menerbitkan ke seluruh penyewa, sebagai lawan dari grup atau individu tertentu tidak didukung.
7. Ada masalah umum saat mengimpor koneksi aman yang dibagikan secara implisit melalui referensi koneksi. Keamanan tidak diatur dengan benar di lingkungan target.
8. Ada masalah umum saat mengimpor solusi menggunakan perwakilan layanan, yang menyebabkan kegagalan impor. Solusinya adalah berbagi koneksi dengan perwakilan layanan.

Autentikasi Windows

Jenis sambungan ini tidak aman karena tidak mengandalkan autentikasi pengguna akhir. Gunakan autentikasi Windows saat Anda perlu menyambungkan ke sumber data yang lokal. Contoh dari jenis koneksi ini ke server lokal yang memiliki SQL Server. Koneksi harus melalui gateway. Karena melewati gateway, konektor memiliki akses ke semua data pada sumber data tersebut. Akibatnya, setiap informasi yang dapat Anda akses dengan kredensial Windows yang Anda berikan tersedia untuk konektor. Dan setelah aplikasi diterbitkan, koneksi diterbitkan juga dan menjadi tersedia untuk pengguna Anda. Perilaku ini berarti bahwa pengguna akhir Anda juga dapat membuat aplikasi menggunakan sambungan yang sama dan mengakses data pada mesin tersebut. Koneksi ke sumber data juga Dibagikan secara Implisit dengan pengguna yang dibagikan aplikasi. Jenis koneksi ini mungkin valid ketika sumber data Anda hanya berada di server lokal dan data pada sumber tersebut dapat dibagikan secara bebas.

Sumber data dalam solusi

Solusi digunakan untuk manajemen siklus hidup aplikasi dan menyediakan kemampuan lain untuk mengelola siklus hidup sumber data. Jika aplikasi kanvas ada dalam solusi, referensi koneksi dan variabel lingkungan dapat dibuat untuk menyimpan informasi tentang sumber data. Proses ini memastikan sumber data dapat diubah atau dibuat kembali saat solusi dimigrasikan ke lingkungan yang berbeda.

Mengganti nama sumber data di aplikasi

Untuk mempelajari cara mengganti nama sumber data di aplikasi, dan perbedaan antara sumber data berbasis tabel dan tindakan, buka Mengganti nama sumber Power Apps data berbasis tindakan.

Dialog Persetujuan koneksi

Saat pengguna membuka aplikasi yang menggunakan konektor untuk pertama kalinya, mereka melihat dialog "persetujuan koneksi" untuk tujuan berikut.

1. Untuk menginformasikan pengguna tentang sumber data yang diakses oleh aplikasi.

2. Untuk menguraikan tindakan, konektor mungkin atau mungkin tidak berfungsi di aplikasi. Misalnya, untuk aplikasi yang menggunakan Office 365 konektor Pengguna :

   • Aplikasi ini mampu:
     • Membaca profil pengguna lengkap Anda
     • Membaca profil lengkap semua pengguna
   • Aplikasi tidak dapat:
     • Memodifikasi atau menghapus informasi profil pengguna

3. Untuk mendapatkan persetujuan pengguna akhir agar terhubung ke sumber data yang digunakan aplikasi.

4. Untuk memudahkan otentikasi pengguna akhir manual, bila diperlukan.

Untuk sambungan tertentu, Power Platform dapat secara otomatis mengautentikasi pengguna untuk mengakses sumber data. Namun, jika masuk otomatis gagal, dialog ini akan meminta pengguna untuk memperbaiki sambungan dengan masuk secara manual. Power Platform hanya dapat mencoba masuk otomatis untuk koneksi ketika sumber data mengotorisasi perwakilan layanan koneksi Azure API Microsoft, memberikannya izin untuk melakukan akses menyeluruh untuk pengguna saat koneksi dibuat. Untuk informasi selengkapnya tentang akses menyeluruh, lihat Apa itu akses menyeluruh (SSO)?

Perhatikan bahwa untuk aplikasi berdasarkan model yang menggunakan halaman kustom, ketika ada beberapa halaman kustom dalam aplikasi, dialog persetujuan meminta izin data untuk semua konektor di semua halaman kustom meskipun tidak dibuka.

Gambar berikut adalah contoh dialog persetujuan sambungan untuk aplikasi yang tersambung ke situs SharePoint.

Untuk konektor tertentu, admin dapat menekan dialog ini, dan persetujuan atas nama pengguna akhir untuk terhubung ke sumber data. Tabel berikut menjelaskan jenis konektor mana yang mungkin ditekan dialog persetujuan untuk aplikasi.

Catatan

Jika admin menekan dialog persetujuan tetapi platform tidak dapat melakukan akses terusan untuk pengguna akhir, dialog akan ditampilkan kepada pengguna saat mereka meluncurkan aplikasi.

Jenis Konektor	Apakah Dialog Persetujuan dapat ditekan?	Referensi
Konektor Microsoft yang mendukung akses menyeluruh (seperti,pengguna SharePoint Office 365 )	Ya	Power Apps cmdlet admin
Konektor yang mengakses layanan mitra non-Microsoft, seperti Salesforce	No	Tidak berlaku
Konektor kustom menggunakan OAuth dengan Microsoft Entra ID sebagai penyedia identitas. Konektor kustom ini dibuat oleh organisasi, dan hanya dapat diakses oleh pengguna dalam organisasi (misalnya, dibuat oleh Contoso hanya untuk pengguna Contoso)	Ya	Kelola Koneksi

Microsoft Power Platform hanya dapat menekan dialog persetujuan untuk sambungan ke sumber data di mana:

1. Tidak ada tanggung jawab hukum oleh sumber data untuk menunjukkan UI persetujuan eksplisit.
2. Sumber data mengotorisasi perwakilan layanan koneksi Azure API Microsoft untuk mengaktifkan akses menyeluruh.
3. Admin mengkonfigurasi aplikasi untuk menekan persetujuan sambungan sebelumnya.

Pra-otorisasi perwakilan layanan koneksi Azure API Microsoft ada untuk sumber data pihak pertama Microsoft, dan mungkin dikonfigurasi oleh aplikasi kustom yang terdaftar di Microsoft Entra penyewa yang digunakan oleh konektor kustom. Admin mengelola penindasan persetujuan berdasarkan per aplikasi (bukan berdasarkan konektor), sehingga penekanan dikelola pada tingkat pengalaman aplikasi yang paling terperinci—tingkat perincian ini mencegah penekanan persetujuan untuk "aplikasi yang disetujui" organisasi agar tidak secara tidak sengaja menekan persetujuan untuk aplikasi yang tidak disetujui atau ditinjau.