Sambungkan ke koneksi Office 365 Users dari Power Apps

Office 365 Users memungkinkan Anda untuk mengakses profil pengguna di organisasi Anda menggunakan akun Office 365 Anda. Anda dapat melakukan berbagai tindakan seperti memberikan, profil pengguna, manajer pengguna atau bawahan langsung pada profil Anda.

Anda dapat menampilkan informasi ini pada label di aplikasi Anda. Anda dapat menampilkan satu fungsi, beberapa fungsi, atau bahkan menggabungkan beberapa fungsi yang berbeda. Misalnya, Anda dapat membuat sebuah ekspresi yang menggabungkan Nama Pengguna dan Nomor Telepon, lalu menampilkan informasi ini di aplikasi Anda.

Artikel ini menunjukkan cara menambahkan pengguna Office 365 sebagai sambungan, menambahkan pengguna Office 365 sebagai sumber data ke aplikasi, dan menggunakan data tabel dalam kontrol galeri.

Prasyarat

• Mengakses Power Apps
• Menambahkan sambungan
• Membuat aplikasi dari template, dari data, atau dari awal

Tambah sambungan

1. Tambahkan sambungan data dan pilih Office 365 Users:

   

2. Pilih Sambungkan, dan jika diminta untuk masuk, masukkan akun kerja Anda.

Koneksi Office 365 Users telah dibuat dan ditambahkan ke aplikasi Anda. Sekarang, koneksi sudah siap digunakan.

Gunakan koneksi di aplikasi Anda

Tunjukkan informasi tentang pengguna saat ini

1. Pada menu Sisipkan, pilih Label

2. Pada bilah fungsi, atur properti Teksnya ke salah satu rumus berikut:

   Office365Users.MyProfile().City
Office365Users.MyProfile().CompanyName
Office365Users.MyProfile().Country
Office365Users.MyProfile().Department
Office365Users.MyProfile().DisplayName
Office365Users.MyProfile().GivenName
Office365Users.MyProfile().Id
Office365Users.MyProfile().JobTitle
Office365Users.MyProfile().Mail
Office365Users.MyProfile().MailNickname
Office365Users.MyProfile().mobilePhone
Office365Users.MyProfile().OfficeLocation
Office365Users.MyProfile().PostalCode
Office365Users.MyProfile().Surname
Office365Users.MyProfile().TelephoneNumber
Office365Users.MyProfile().UserPrincipalName
Office365Users.MyProfile().AccountEnabled

Label menampilkan informasi yang Anda masukkan mengenai pengguna saat ini.

Tunjukkan informasi tentang pengguna lain.

1. Pada menu Sisipkan, pilih Teks, lalu pilih Input teks. Ubah namanya infoabout:

   

2. Pada InfoAbout, ketikkan atau tempel alamat email seorang pengguna dalam organisasi Anda. Misalnya, ketikkan yourName@yourCompany.com.

3. Tambahkan Label (menu Sisipkan), dan atur properti Teksnya ke salah satu rumus berikut:

   • Untuk menunjukkan informasi tentang pengguna lain.

     Office365Users.UserProfile(InfoAbout.Text).City
Office365Users.UserProfile(InfoAbout.Text).CompanyName
Office365Users.UserProfile(InfoAbout.Text).Country
Office365Users.UserProfile(InfoAbout.Text).Department
Office365Users.UserProfile(InfoAbout.Text).DisplayName
Office365Users.UserProfile(InfoAbout.Text).GivenName
Office365Users.UserProfile(InfoAbout.Text).Id
Office365Users.UserProfile(InfoAbout.Text).JobTitle
Office365Users.UserProfile(InfoAbout.Text).Mail
Office365Users.UserProfile(InfoAbout.Text).MailNickname
Office365Users.UserProfile(InfoAbout.Text).mobilePhone
Office365Users.UserProfile(InfoAbout.Text).OfficeLocation
Office365Users.UserProfile(InfoAbout.Text).PostalCode
Office365Users.UserProfile(InfoAbout.Text).Surname
Office365Users.UserProfile(InfoAbout.Text).TelephoneNumber
Office365Users.UserProfile(InfoAbout.Text).UserPrincipalName
Office365Users.UserProfile(InfoAbout.Text).AccountEnabled
Office365Users.UserProfile(InfoAbout.Text).BusinessPhones

   • Untuk menunjukkan informasi tentang manajer pengguna.

     Office365Users.Manager(InfoAbout.Text).City
Office365Users.Manager(InfoAbout.Text).CompanyName
Office365Users.Manager(InfoAbout.Text).Country
Office365Users.Manager(InfoAbout.Text).Department
Office365Users.Manager(InfoAbout.Text).DisplayName
Office365Users.Manager(InfoAbout.Text).GivenName
Office365Users.Manager(InfoAbout.Text).Id
Office365Users.Manager(InfoAbout.Text).JobTitle
Office365Users.Manager(InfoAbout.Text).Mail
Office365Users.Manager(InfoAbout.Text).MailNickname
Office365Users.Manager(InfoAbout.Text).mobilePhone
Office365Users.Manager(InfoAbout.Text).OfficeLocation
Office365Users.Manager(InfoAbout.Text).PostalCode
Office365Users.Manager(InfoAbout.Text).Surname
Office365Users.Manager(InfoAbout.Text).TelephoneNumber
Office365Users.Manager(InfoAbout.Text).UserPrincipalName
Office365Users.Manager(InfoAbout.Text).AccountEnabled
Office365Users.Manager(InfoAbout.Text).BusinessPhones

Label menunjukkan informasi yang Anda masukkan tentang pengguna yang Anda tentukan atau manajer dari pengguna tersebut.

Catatan

Jika Anda mengembangkan aplikasi berdasarkan tabel dalam Microsoft Dataverse, Anda dapat menentukan pengguna berdasarkan ID, bukan alamat email.

Misalnya, Anda dapat membuat aplikasi secara otomatis, menambahkan layar yang berisi kontrol Label, dan mengatur properti Teks kontrol ke rumus ini:
Office365Users.UserProfile(BrowseGallery1.Selected.CreatedByUser).DisplayName

Jika Anda membuat sebuah kontak dan memilih kontak tersebut di layar penelusuran pada aplikasi, kontrol Label akan menunjukkan nama tampilan Anda.

Menampilkan bawahan langsung pengguna lain

1. Tambahkan kontrol Input teks (menu Sisipkan > Teks), dan ganti namanya menjadi InfoAbout.

2. Pada InfoAbout, masukkan alamat email seorang pengguna dalam organisasi Anda. Misalnya, masukkan yourManagersName@yourCompany.com

3. Tambahkan galeri dengan teks (menu Sisipkan > Galeri), dan atur properti itemnya ke rumus berikut:

   Office365Users.DirectReports(InfoAbout.Text)

   Galeri menunjukkan informasi mengenai bawahan langsung dari pengguna yang Anda masukkan.

   Dengan dipilihnya galeri, panel kanan akan menampilkan pilihan untuk galeri tersebut.

4. Pada daftar kedua, pilih JobTitle. Pada daftar ketiga, pilih DisplayName. Galeri telah diperbarui untuk menampilkan nilai ini.

Catatan

Kotak pertama sebenarnya merupakan sebuah kontrol gambar. Jika Anda tidak memiliki gambar, Anda dapat menghapus kontrol gambar, lalu menggantinya dengan label. Tambahkan dan konfigurasikan kontrol adalah sumber daya yang baik.

Mencari pengguna

1. Tambahkan kontrol Input teks (menu Sisipkan > Input Teks).

2. Pilih Sisipkan > Galeri vertikal.

3. Ubah tata letak galeri Vertikal ke Judul, Subjudul, dan isi.

4. Pilih ikon panah dari baris pertama di dalam galeri dan hapus.

5. Perbarui rumus galeri vertikal ke berikut.

   Office365Users.SearchUserV2({searchTerm:TextInput1.Text,top:5}).value
   

   Pada rumus di atas, istilah pencarian merujuk teks yang dimasukkan dalam kontrol input teks ("TextInput1" pada contoh ini); dan hasil pencarian terbatas ke 5 teratas.

6. Perbarui bidang galeri vertikal untuk menampilkan DisplayName dalam jdj galeri, JobTitle dalam sub-judul, dan Departement dalam isi.

   

7. Jalankan aplikasi, lalu masukkan teks di dalam kotak input teks. Saat Anda memasukkan teks, hasil berubah berdasarkan perubahan string input.

   

Tampilkan fungsi yang tersedia

Koneksi ini mencakup fungsi berikut:

Nama Fungsi	KETERANGAN
DirectReports	Menampilkan bawahan langsung untuk pengguna yang ditentukan.
Manajer	Menampilkan profil pengguna untuk manajer dari pengguna yang ditentukan.
MyProfile	Menampilkan profil untuk pengguna saat ini.
SearchUser	Menampilkan hasil pencarian profil pengguna.
UserProfile	Menampilkan profil pengguna tertentu.

MyProfile

Tampilkan profil saya: Menampilkan profil untuk pengguna saat ini.

Properti input

Tidak ada.

Properti output

Nama Properti	Jenis	KETERANGAN
Kota	string	Kota pengguna.
CompanyName	string	Perusahaan pengguna.
Negara	string	Negara pengguna.
Departemen	string	Departemen pengguna.
DisplayName	string	Nama tampilan pengguna.
GivenName	string	Nama depan pengguna.
Id	string	Id pengguna.
JobTitle	string	Jabatan pengguna.
Surat	string	Id email pengguna.
MailNickname	string	Nama panggilan pengguna.
mobilePhone	string	Ponsel pengguna.
OfficeLocation	string	Lokasi kantor pengguna.
PostalCode	string	Kode pos pengguna.
Surname	string	Nama belakang pengguna.
TelephoneNumber	string	Nomor telepon pengguna.
UserPrincipalName	string	Nama Utama Pengguna.
AccountEnabled	boolean	Bendera aktif akun.
BusinessPhones	string	Nomor telepon perusahaan pengguna.

UserProfile

Tampilkan profil pengguna: Menampilkan profil pengguna tertentu.

Properti input

Nama	Jenis Data	Diperlukan	KETERANGAN
Id	string	ya	Nama utama atau id email pengguna.

Properti output

Nama Properti	Jenis	KETERANGAN
Kota	string	Kota pengguna.
CompanyName	string	Perusahaan pengguna.
Negara	string	Negara pengguna.
Departemen	string	Departemen pengguna.
DisplayName	string	Nama tampilan pengguna.
GivenName	string	Nama depan pengguna.
Id	string	Id pengguna.
JobTitle	string	Jabatan pengguna.
Surat	string	Id email pengguna.
MailNickname	string	Nama panggilan pengguna.
Nama belakang	string	Nama belakang pengguna.
TelephoneNumber	string	Nomor telepon pengguna.
UserPrincipalName	string	Nama Utama Pengguna.
AccountEnabled	boolean	Bendera aktif akun.
BusinessPhones	string	Nomor telepon perusahaan pengguna.

Manajer

Tampilkan manajer: Menampilkan profil pengguna untuk manajer dari pengguna yang ditentukan.

Properti input

Nama	Jenis Data	Diperlukan	KETERANGAN
Id	string	ya	Nama utama atau id email pengguna.

Properti output

Nama Properti	Jenis	KETERANGAN
Kota	string	Kota pengguna.
CompanyName	string	Perusahaan pengguna.
Negara	string	Negara pengguna.
Departemen	string	Departemen pengguna.
DisplayName	string	Nama tampilan pengguna.
GivenName	string	Nama depan pengguna.
Id	string	Id pengguna.
JobTitle	string	Jabatan pengguna.
Surat	string	Id email pengguna.
MailNickname	string	Nama panggilan pengguna.
mobilePhone	string	Ponsel pengguna.
OfficeLocation	string	Lokasi kantor pengguna.
PostalCode	string	Kode pos pengguna.
Surname	string	Nama belakang pengguna.
TelephoneNumber	string	Nomor telepon pengguna.
UserPrincipalName	string	Nama Utama Pengguna.
AccountEnabled	boolean	Bendera aktif akun.
BusinessPhones	string	Nomor telepon perusahaan pengguna.

DirectReports

Tampilkan bawahan langsung: Menampilkan laporan langsung.

Properti input

Nama	Jenis Data	Diperlukan	KETERANGAN
Id	string	ya	Nama utama atau id email pengguna.

Properti output

Nama Properti	Jenis	KETERANGAN
Kota	string	Kota pengguna.
CompanyName	string	Perusahaan pengguna.
Negara	string	Negara pengguna.
Departemen	string	Departemen pengguna.
DisplayName	string	Nama tampilan pengguna.
GivenName	string	Nama depan pengguna.
Id	string	Id pengguna.
JobTitle	string	Jabatan pengguna.
Surat	string	Id email pengguna.
MailNickname	string	Nama panggilan pengguna.
mobilePhone	string	Ponsel pengguna.
OfficeLocation	string	Lokasi kantor pengguna.
PostalCode	string	Kode pos pengguna.
Surname	string	Nama belakang pengguna.
TelephoneNumber	string	Nomor telepon pengguna.
UserPrincipalName	string	Nama Utama Pengguna.
AccountEnabled	boolean	Bendera aktif akun.
BusinessPhones	string	Nomor telepon perusahaan pengguna.

SearchUser

Pencarian pengguna: Menampilkan hasil pencarian profil pengguna.

Properti input

Nama	Jenis Data	Diperlukan	KETERANGAN
searchTerm	string	tidak	Cari string. Berlaku untuk: nama tampilan, nama panggilan, nama belakang, surat, nama panggilan surat, dan nama utama pengguna.

Properti output

Nama Properti	Jenis	KETERANGAN
Kota	string	Kota pengguna.
CompanyName	string	Perusahaan pengguna.
Negara	string	Negara pengguna.
Departemen	string	Departemen pengguna.
DisplayName	string	Nama tampilan pengguna.
GivenName	string	Nama depan pengguna.
Id	string	Id pengguna.
JobTitle	string	Jabatan pengguna.
Surat	string	Id email pengguna.
MailNickname	string	Nama panggilan pengguna.
mobilePhone	string	Ponsel pengguna.
OfficeLocation	string	Lokasi kantor pengguna.
PostalCode	string	Kode pos pengguna.
Surname	string	Nama belakang pengguna.
TelephoneNumber	string	Nomor telepon pengguna.
UserPrincipalName	string	Nama Utama Pengguna.
AccountEnabled	boolean	Bendera aktif akun.
BusinessPhones	string	Nomor telepon perusahaan pengguna.

Lihat juga

• Lihat semua koneksi yang tersedia.
• Pelajari cara menambahkan koneksi ke aplikasi Anda.

Catatan

Apa bahasa dokumentasi yang Anda inginkan? Lakukan survei singkat. (perlu diketahui bahwa survei ini dalam bahasa Inggris)

Survei akan berlangsung kurang lebih selama tujuh menit. Tidak ada data pribadi yang dikumpulkan (pernyataan privasi).