Terhubung ke koneksi Pengguna Office 365 dari Power Apps

Office 365 pengguna.

Pengguna Office 365 memungkinkan Anda 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 kepada Anda cara menambahkan pengguna Office 365 sebagai koneksi, menambahkan pengguna Office 365 sebagai sumber data ke aplikasi Anda, dan menggunakan data tabel dalam kontrol galeri.

Prasyarat

Tambah sambungan

  1. Menambahkan koneksi data dan pilih pengguna Office 365:

    Terhubung ke Office 365.

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

Koneksi pengguna Office 365 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:

    Ubah nama kontrol.

  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 di 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 > Teks), dan ganti namanya menjadi SearchTerm. Masukkan nama yang akan dicari Misalnya, masukkan nama depan Anda.

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

    Office365Users.SearchUserV2({searchTerm: SearchTerm.Text})

    Galeri menunjukkan pengguna yang memiliki teks pencarian yang Anda masukkan.

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

  3. Pada daftar kedua, pilih Surat. Pada daftar ketiga, pilih DisplayName.

    Label kedua dan ketiga di galeri telah diperbarui.

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