Bagikan melalui

Cara menyinkronkan atribut untuk alur kerja Siklus Hidup

Alur kerja berisi tugas tertentu yang dapat berjalan secara otomatis terhadap pengguna berdasarkan kondisi eksekusi yang ditentukan. Penjadwalan alur kerja otomatis didukung berdasarkan atribut pengguna employeeHireDate dan employeeLeaveDateTime di ID Microsoft Entra.

Provisi pengguna harus diotomatisasi dan penjadwalan atribut yang relevan harus disinkronkan agar dapat memanfaatkan Alur Kerja Siklus Hidup sepenuhnya.

Menjadwalkan atribut yang relevan

Tabel berikut menunjukkan atribut yang relevan dengan penjadwalan (pemicu) dan metode sinkronisasi yang didukung.

Atribut Jenis Didukung dalam Penyediaan HR Inbound Didukung dalam sinkronisasi cloud Microsoft Entra Connect Didukung di Sinkronisasi Microsoft Entra Connect
tanggalPerekrutanKaryawan Pengaturan Waktu & Tanggal Ya Ya Ya
TanggalWaktuCutiKaryawan Pengaturan Waktu & Tanggal Ya Ya Ya

Catatan

Mengatur employeeLeaveDateTime secara manual untuk pengguna khusus cloud memerlukan izin khusus. Untuk informasi selengkapnya, lihat: Mengonfigurasi properti employeeLeaveDateTime untuk pengguna

Dokumen ini menjelaskan cara menyiapkan sinkronisasi dari sinkronisasi cloud Microsoft Entra Connect yang lokal atau Microsoft Entra Connect untuk atribut yang diperlukan.

Catatan

Tidak ada atribut EmployeeHireDate atau EmployeeLeaveDateTime yang sesuai di Active Directory. Jika Anda menyinkronkan dari AD lokal, Anda harus mengidentifikasi atribut di AD yang dapat digunakan. Atribut ini harus berupa string.

Memahami pemformatan EmployeeHireDate dan EmployeeLeaveDateTime

EmployeeHireDate dan EmployeeLeaveDateTime berisi tanggal dan waktu yang harus diformat dengan cara tertentu. Ini berarti Bahwa Anda mungkin perlu menggunakan ekspresi untuk mengonversi nilai atribut sumber Anda ke format yang diterima EmployeeHireDate atau EmployeeLeaveDateTime. Tabel berikut menguraikan format yang diharapkan dan menyediakan ekspresi contoh tentang cara mengonversi nilai.

Skenario Ekspresi/Format Sasaran Informasi Selengkapnya
Workday untuk Penyediaan Pengguna Active Directory FormatDateTime([StatusHireDate], ,"yyyy-MM-ddzzz", "yyyyMMddHHmmss.fZ") Atribut string AD lokal Pemetaan atribut untuk Workday
SuccessFactors untuk Penyediaan Pengguna Active Directory FormatDateTime([endDate], ,"M/d/yyyy hh:mm:ss tt","yyyyMMddHHmmss.fZ") Atribut string AD lokal Pemetaan atribut untuk Faktor Keberhasilan SAP
Impor kustom ke Active Directory Harus dalam format "yyyyMMddHHmmss.fZ" Atribut string AD lokal Pemetaan atribut untuk sistem rekaman lainnya
API Pengguna Microsoft Graph Harus dalam format "YYYY-MM-DDThh:mm:ssZ" TanggalMulaiKerjaKaryawan dan TanggalBerhentiKerjaKaryawan
Pemfasilitasian pengguna Workday ke Microsoft Entra Dapat menggunakan pemetaan langsung. Tidak ada ekspresi yang diperlukan tetapi dapat digunakan untuk menyesuaikan bagian waktu EmployeeHireDate dan EmployeeLeaveDateTime TanggalMulaiKerjaKaryawan dan TanggalBerhentiKerjaKaryawan
SuccessFactors ke penyediaan pengguna Microsoft Entra Dapat menggunakan pemetaan langsung. Tidak ada ekspresi yang diperlukan tetapi dapat digunakan untuk menyesuaikan bagian waktu EmployeeHireDate dan EmployeeLeaveDateTime TanggalMulaiKerjaKaryawan dan TanggalBerhentiKerjaKaryawan

Untuk informasi selengkapnya tentang ekspresi, lihat Referensi untuk menulis ekspresi untuk pemetaan atribut di ID Microsoft Entra.

Contoh ekspresi dalam tabel menggunakan endDate untuk SAP dan StatusHireDate untuk Workday. Namun, Anda dapat memilih untuk menggunakan atribut yang berbeda.

Misalnya, Anda dapat menggunakan StatusContinuousFirstDayOfWork alih-alih StatusHireDate untuk Workday. Dalam hal ini, ekspresi Anda adalah:

FormatDateTime([StatusContinuousFirstDayOfWork], , "yyyy-MM-ddzzz", "yyyyMMddHHmmss.fZ")

Tabel berikut ini memiliki daftar atribut yang disarankan beserta rekomendasi skenarionya.

Atribut HR Sistem HR Skenario Atribut Microsoft Entra
TanggalStatusPerekrutan Hari Kerja Penggabung TanggalRekrutKaryawan
StatusBerlanjutHariPertamaKerja Hari Kerja Penggabung TanggalRekrutKaryawan
StatusTanggalMasukKerja Hari Kerja Penggabung TanggalRekrutKaryawan
StatusTanggalPerekrutanAsli Hari Kerja Penggabung TanggalRekrutKaryawan
TanggalAkhirStatusKerja Hari Kerja Pemain yang keluar TanggalWaktuCutiKaryawan
TanggalPengunduranDiriStatus Hari Kerja Pemain yang keluar TanggalWaktuCutiKaryawan
TanggalPensiunStatus Hari Kerja Pemain yang keluar TanggalWaktuCutiKaryawan
TanggalPengakhiranStatus Hari Kerja Pemain yang keluar TanggalWaktuCutiKaryawan
tanggalMulai SAP SF Penggabung TanggalRekrutKaryawan
tanggal pertama bekerja SAP SF Penggabung TanggalRekrutKaryawan
tanggal terakhir bekerja SAP SF Pemain yang keluar TanggalWaktuCutiKaryawan
tanggalAkhir SAP SF Pemain yang keluar TanggalWaktuCutiKaryawan

Untuk atribut lainnya, lihat referensi atribut Workday dan referensi atribut SAP SuccessFactors.

Pentingnya waktu

Untuk memastikan akurasi waktu alur kerja terjadwal sangat penting untuk dipertimbangkan:

  • Bagian waktu atribut harus diatur dengan sesuai, misalnya employeeHireDate harus memiliki waktu di awal hari seperti pukul 01.00 atau 05.00 dan employeeLeaveDateTime harus memiliki waktu pada akhir hari seperti pukul 21.00 atau 23.00
  • Alur Kerja tidak akan berjalan lebih awal dari waktu yang ditentukan dalam atribut, namun jadwal penyewa (default 3h) dapat menunda eksekusi alur kerja. Misalnya, jika Anda mengatur employeeHireDate ke 08.00 tetapi jadwal penyewa tidak berjalan hingga jam 09.00, alur kerja tidak akan diproses sampai jam tersebut. Jika seorang karyawan baru mulai pukul 08.00, Anda ingin mengatur waktu agar selaras dengan jadwal penyewa untuk memastikan proses tersebut berjalan sebelum karyawan tersebut tiba.
  • Jika Anda menggunakan kode akses sementara (TAP), disarankan untuk mengatur masa pakai maksimum menjadi 24 jam. Melakukan ini akan membantu memastikan bahwa TAP belum kedaluwarsa setelah dikirim ke karyawan yang mungkin berada di zona waktu yang berbeda. Untuk informasi selengkapnya, lihat Mengonfigurasi Kode Akses Sementara di ID Microsoft Entra untuk mendaftarkan metode autentikasi Tanpa Kata Sandi.
  • Saat mengimpor data, Anda harus memahami apakah dan bagaimana sumber memberikan informasi zona waktu bagi pengguna Anda untuk kemungkinan melakukan penyesuaian guna memastikan akurasi waktu.

Membuat aturan sinkronisasi kustom di sinkronisasi cloud Microsoft Entra Connect untuk EmployeeHireDate

Langkah-langkah berikut memandu Anda membuat aturan sinkronisasi menggunakan sinkronisasi cloud.

  1. Di pusat admin Microsoft Entra, telusuri >manajemen Hibrid>Microsoft Entra Connect.
  2. Pilih Kelola sinkronisasi cloud Microsoft Entra Connect.
  3. Di bawah Konfigurasi, pilih konfigurasi Anda.
  4. Pilih Klik untuk mengedit pemetaan. Tautan ini membuka layar Pemetaan atribut .
  5. Pilih Tambahkan atribut.
  6. Isi informasi berikut:
    • Jenis Pemetaan: Langsung
    • Atribut sumber: msDS-cloudExtensionAttribute1
    • Nilai default: Biarkan kosong
    • Atribut target: tanggalRekrutKaryawan
    • Terapkan pemetaan ini: Selalu Cuplikan layar pemetaan atribut cloud.
  7. Pilih Terapkan.
  8. Kembali ke layar Pemetaan atribut , Anda akan melihat pemetaan atribut baru Anda.
  9. Pilih Simpan skema.

Untuk informasi selengkapnya tentang atribut, lihat Pemetaan atribut di sinkronisasi cloud Microsoft Entra Connect.

Cara membuat aturan sinkronisasi kustom di Microsoft Entra Connect untuk EmployeeHireDate

Contoh berikut membimbing Anda menyiapkan aturan sinkronisasi kustom yang menyinkronkan atribut Active Directory ke atribut employeeHireDate di Microsoft Entra ID.

  1. Buka jendela PowerShell sebagai administrator dan jalankan Set-ADSyncScheduler -SyncCycleEnabled $false untuk menonaktifkan penjadwal.
  2. Buka Start\Microsoft Entra Connect\ dan buka Editor Aturan Sinkronisasi
  3. Pastikan arah di bagian atas diatur ke Masuk.
  4. Pilih Tambahkan Aturan.
  5. Pada layar Buat aturan sinkronisasi masuk , masukkan informasi berikut dan pilih Berikutnya.
    • Nama: Masuk dari AD - TanggalMulaiKerjaKaryawan
    • Sistem Tersambung: contoso.com
    • Jenis Objek Sistem Tersambung: pengguna
    • Jenis Objek Metaverse: orang
    • Prioritas: 20 Cuplikan layar membuat dasar-dasar aturan sinkronisasi masuk.
  6. Pada layar Filter cakupan, pilih Berikutnya.
  7. Pada layar Gabungkan aturan , pilih Berikutnya.
  8. Pada layar Transformasi , di bawah Tambahkan transformasi, masukkan informasi berikut.
    • Jenis Aliran: Langsung
    • Atribut Target: tanggalPerekrutanKaryawan
    • Sumber: msDS-cloudExtensionAttribute1 Cuplikan layar pembuatan transformasi aturan sinkronisasi masuk.
  9. Pilih Tambahkan.
  10. Di Editor Aturan Sinkronisasi, pastikan arah di bagian atas diatur ke Keluar.
  11. Pilih Tambahkan Aturan.
  12. Pada layar Buat aturan sinkronisasi keluar , masukkan informasi berikut dan pilih Berikutnya.
    • Nama: Out to Microsoft Entra ID - TanggalPerekrutanKaryawan
    • Sistem Tersambung: <penyewa Anda>
    • Jenis Objek Sistem Tersambung: pengguna
    • Jenis Objek Metaverse: orang
    • Precedensi: 21
  13. Pada layar Filter cakupan, pilih Berikutnya.
  14. Pada layar Gabungkan aturan , pilih Berikutnya.
  15. Pada layar Transformasi , di bawah Tambahkan transformasi, masukkan informasi berikut.
    • Jenis Aliran: Langsung
    • Atribut Target: tanggalPerekrutanKaryawan
    • Sumber: employeeHireDate Cuplikan layar pembuatan transformasi aturan sinkronisasi keluar.
  16. Pilih Tambahkan.
  17. Tutup Editor Aturan Sinkronisasi
  18. Aktifkan penjadwal lagi dengan menjalankan Set-ADSyncScheduler -SyncCycleEnabled $true.

Catatan

  • msDS-cloudExtensionAttribute1 adalah contoh sumber.
  • Dimulai dengan Microsoft Entra Connect 2.0.3.0, employeeHireDate ditambahkan ke aturan default 'Out to Microsoft Entra ID', sehingga langkah 10-16 tidak diperlukan.
  • Dimulai dengan Microsoft Entra Connect 2.1.19.0, employeeLeaveDateTime ditambahkan ke aturan default 'Out to Microsoft Entra ID', sehingga langkah 10-16 tidak diperlukan.

Untuk informasi selengkapnya, lihat Cara mengkustomisasi aturan sinkronisasi dan Membuat perubahan pada konfigurasi default.

Mengedit pemetaan atribut di aplikasi provisi

Setelah menyiapkan aplikasi provisi, Anda dapat mengedit pemetaan atributnya. Saat aplikasi dibuat, Anda mendapatkan daftar pemetaan default antara HRM dan Direktori Aktif. Dari sana, Anda dapat mengedit pemetaan yang ada, atau menambahkan pemetaan baru.

Untuk memperbarui pemetaan ini, Anda akan melakukan langkah-langkah berikut:

  1. Masuk ke pusat admin Microsoft Entra sebagai setidaknya Administrator Aplikasi.

  2. Telusuri ke aplikasi Entra ID>Enterprise.

  3. Buka aplikasi yang disediakan.

  4. Pilih Provisioning lalu pilih Edit Pemetaan atribut.

  5. Pilih Perlihatkan opsi tingkat lanjut, lalu pilih Edit daftar Atribut untuk Direktori Aktif Lokal. Cuplikan layar pengeditan atribut lokal.

  6. Tambahkan atribut atau atribut sumber Anda yang dibuat sebagai Jenis String, dan pilih Kotak Centang untuk diperlukan. Cuplikan layar daftar API sumber.

    Catatan

    Jumlah, dan nama, atribut sumber yang ditambahkan akan bergantung pada atribut mana yang Anda sinkronkan dari Direktori Aktif.

  7. Pilih Simpan.

  8. Dari sana, Anda harus memetakan atribut HRM ke atribut Direktori Aktif yang ditambahkan. Untuk melakukan ini, Tambahkan Pemetaan Baru menggunakan Ekspresi.

  9. Ekspresi Anda harus cocok dengan pemformatan yang ditemukan di bagian Memahami pemformatan EmployeeHireDate dan EmployeeLeaveDateTime . Cuplikan layar pengaturan format atribut.

  10. Pilih ok.

Cara memverifikasi nilai atribut ini di ID Microsoft Entra

Untuk meninjau nilai yang diatur pada properti ini pada objek pengguna di MICROSOFT Entra ID, Anda dapat menggunakan Microsoft Graph PowerShell SDK. Contohnya:

# Import Module
Import-Module Microsoft.Graph.Users

# Define the necessary scopes
$Scopes =@("User.Read.All", "User-LifeCycleInfo.Read.All")

# Connect using the scopes defined and select the Beta API Version
Connect-MgGraph -Scopes $Scopes


# Query a user, using its user ID, and return the desired properties
$user = Get-MgUser -UserID "00aa00aa-bb11-cc22-dd33-44ee44ee44ee" -Property EmployeeLeaveDateTime
$User.EmployeeLeaveDateTime

Cuplikan layar hasilnya.

Langkah berikutnya