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, SQL Prosedur tersimpan 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 bersifat dinamis." sebagai nilai pengembalian.

Untuk informasi selengkapnya tentang cara bekerja dengan skema dinamis di Power Apps, lihat Bekerja dengan Objek Tak Bertipe dan Dinamis untuk ikhtisarnya dan Menghubungkan ke Azure DevOps dari Power Apps untuk contoh terperinci.

Konektor populer

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

Microsoft Dataverse	Penyimpanan awan **
Dinamika AX	Unggul
Microsoft Penerjemah	Office 365 Pandangan
Office 365 Pengguna	Peramal
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 terhubung ke jenis sumber data lain, seperti layanan yang Anda buat, lihat Mendaftar dan menggunakan konektor kustom.

Semua konektor standar

Konektor standar tidak memerlukan lisensi khusus. Untuk informasi lebih lanjut, lihat Power Apps Rencana.

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

Keamanan dan jenis autentikasi

Saat Anda membuat aplikasi dan membuat koneksi ke sumber data, Anda mungkin melihat bahwa pilihan konektor Anda memungkinkan Anda menggunakan berbagai cara untuk mengautentikasi. Misalnya, konektor Server SQL memungkinkan Anda menggunakan Microsoft Entra Autentikasi Server SQL Terintegrasi 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 basis data relasional (seperti Microsoft SQL Server, atau Oracle) sebagai sumber data untuk aplikasi, lihat Gunakan Microsoft SQL Server secara aman dengan Power Apps.
• Power Apps tidak mendukung identitas anggota Eksternal. Untuk informasi selengkapnya, lihat Properti Microsoft Entra pengguna kolaborasi B2B.

Microsoft Entra ID

Otentikasi ini adalah jenis koneksi yang aman. Misalnya, SharePoint menggunakan jenis autentikasi ini. SQL Server juga memungkinkan jenis autentikasi ini. Saat Anda terhubung, layanan Microsoft Entra mengidentifikasi Anda secara terpisah untuk SharePoint atas 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 bagian belakang, pengguna Anda hanya dapat melihat apa yang mereka diizinkan untuk lihat berdasarkan kredensial mereka. Jenis keamanan ini memungkinkan Anda mengubah hak untuk pengguna aplikasi tertentu di back-end sumber data 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 diberikan oleh Power Apps pembuat saat sumber data dibuat dalam aplikasi. Otentikasi 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 kata sandi, tetapi koneksi akan tersedia bagi mereka. Namun, setelah Januari 2024, semua koneksi bersama yang baru dibuat akan diamankan. Perhatikan bahwa aplikasi lama harus diterbitkan ulang agar aman. Koneksi tidak lagi dibagikan dengan pengguna akhir. Power App yang diterbitkan berbicara dengan proksi koneksi. Proksi koneksi hanya berkomunikasi dengan Power App spesifik yang ditautkannya. Proksi koneksi membatasi tindakan yang dikirim ke koneksi ke tindakan yang ada di Power App {Dapatkan, Taruh/Patch, Hapus} untuk sumber data tertentu. Jika Anda memiliki aplikasi yang menggunakan koneksi yang diterbitkan sebelum Januari 2024, Anda harus menerbitkan ulang aplikasi Anda dan membatalkan pembagian koneksi apa pun dengan pengguna akhir yang seharusnya tidak memilikinya.

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

Pemberitahuan untuk memperbarui aplikasi Anda (koneksi implisit yang aman)

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

Pilih tautkan dan panel samping akan terbuka yang mencantumkan semua aplikasi yang memerlukan perhatian.

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 dan terbuka untuk diedit dengan koneksi yang dibagikan secara implisit yang sudah diterbitkan:

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

Tidak 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 berfungsi dengan benar, bagikan aplikasi dengan pengguna lain yang bukan pemilik. Setelah Anda membagikan aplikasi, periksa daftar Koneksi di Dataverse tab di Power Apps untuk pengguna tersebut. Verifikasi bahwa pengguna tidak memiliki koneksi yang tersedia.

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

  

Gunakan aplikasi dengan koneksi implisit aman yang baru

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

Pembatasan

1. Semua jenis koneksi yang dibagikan secara implisit berfungsi seperti tindakan dan tabular.
2. Nama server dan basis data disembunyikan dalam jejak jaringan tetapi terlihat dalam dialog persetujuan. Nama kolom tidak disembunyikan.
3. Untuk konektor tabular, kami hanya membatasi tindakan CRUD seperti Get, Post, Put, atau Delete. Bila Anda mempunyai izin untuk Menaruh, maka Anda mempunyai akses untuk Memposting.
4. Konektor berbasis tindakan dibatasi berdasarkan API spesifik yang digunakan dalam aplikasi.
5. Peringatan masih diaktifkan dalam berbagi. Peringatan seputar koneksi yang dibagikan secara implisit masih memperingatkan saat berada di pratinjau. Namun, koneksi Anda dengan fitur ini aman – meskipun ada peringatan.
6. Penerbitan ke seluruh penyewa, bukan ke grup atau individu tertentu, tidak didukung.
7. Ada masalah yang diketahui saat mengimpor koneksi aman yang dibagikan secara implisit melalui referensi koneksi. Keamanan tidak diatur dengan benar di lingkungan target.
8. Ada masalah yang diketahui saat mengimpor solusi menggunakan prinsipal layanan, yang menyebabkan kegagalan impor. Solusinya adalah dengan berbagi koneksi dengan prinsipal layanan.

Autentikasi Windows

Jenis sambungan ini tidak aman karena tidak mengandalkan autentikasi pengguna akhir. Gunakan autentikasi Windows saat Anda perlu terhubung 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 tersebut. Jenis koneksi ini mungkin valid jika 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 suatu solusi, referensi koneksi dan variabel lingkungan mungkin dibuat untuk menyimpan informasi tentang sumber data. Proses ini memastikan sumber data dapat diubah atau dibangun kembali saat solusi dimigrasikan ke lingkungan yang berbeda.

Mengganti nama sumber data di aplikasi

Untuk mempelajari tentang penggantian nama sumber data dalam aplikasi, dan perbedaan antara sumber data tabular dan berbasis tindakan, buka Ganti nama Power Apps sumber data berbasis tindakan.

Dialog Persetujuan koneksi

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

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

2. Untuk menguraikan tindakan yang mungkin dilakukan atau tidak dilakukan oleh konektor dalam suatu aplikasi. Misalnya, untuk aplikasi yang menggunakan konektor Office 365 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 saat sumber data melakukan pra-otorisasi terhadap prinsipal layanan koneksi API Microsoft's Azure, yang memberinya izin untuk melakukan masuk tunggal bagi pengguna saat koneksi dibuat. Untuk informasi lebih lanjut tentang single sign-on, lihat Apa itu single sign-on (SSO)?

Perhatikan bahwa untuk aplikasi berbasis model yang menggunakan halaman kustom, bila ada beberapa halaman kustom dalam satu aplikasi, dialog persetujuan akan meminta izin data untuk semua konektor di semua halaman kustom meskipun halaman tersebut 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 yang dialog persetujuannya mungkin ditolak untuk suatu 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 masuk tunggal (seperti SharePoint, Office 365 pengguna)	Ya	Power Apps perintah admin
Konektor mengakses layanan mitra non-Microsoft, seperti Salesforce	No	Tidak berlaku
Konektor khusus menggunakan OAuth dengan Microsoft Entra ID sebagai penyedia identitas. Konektor khusus ini dibuat oleh organisasi, dan hanya dapat diakses oleh pengguna dalam organisasi tersebut (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 melakukan pra-otorisasi terhadap prinsipal layanan koneksi API Microsoft's Azure untuk mengaktifkan akses masuk tunggal.
3. Admin mengkonfigurasi aplikasi untuk menekan persetujuan sambungan sebelumnya.

Prinsipal layanan koneksi API Microsoft's Azure pra-otorisasi tersedia 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 penekanan persetujuan berdasarkan per aplikasi (dibandingkan dengan basis konektor), sehingga penekanan dikelola pada tingkat pengalaman aplikasi yang paling terperinci—tingkat ketelitian ini mencegah penekanan persetujuan untuk "aplikasi yang disetujui" suatu organisasi agar tidak secara tidak sengaja menekan persetujuan untuk aplikasi yang tidak disetujui atau ditinjau.