Panduan alur kerja Konektor Layanan Web untuk SOAP
Artikel ini menjelaskan cara membuat proyek baru untuk sumber data Anda di Alat Konfigurasi Layanan Web. Ikuti langkah-langkah ini untuk membuat proyek.
Buka Alat Konfigurasi Layanan Web. Ini membuka proyek kosong.
Pilih Proyek SOAP lalu pilih Tambahkan.
Pada halaman berikutnya, berikan informasi berikut, lalu pilih Berikutnya:
- Nama layanan web baru
- Alamat (jalur WSDL) untuk mengambil layanan, titik akhir, dan operasi yang diekspos
- Ruang nama
- Mode keamanan (jenis autentikasi)
Dalam sampel ini, halaman Kredensial ditampilkan dengan persyaratan untuk mode keamanan Dasar (mode yang dipilih pada langkah sebelumnya). Jika "Tidak Ada" ditentukan untuk mode keamanan, halaman Kredensial tidak akan ditampilkan. Pilih Selanjutnya.
Jalur WSDL sedang diakses untuk mengambil informasi layanan dan daftar fungsi yang diekspos ditampilkan. Jika jalur WSDL yang dimasukkan salah, maka alat konfigurasi gagal mengambil informasi layanan dan melemparkan kesalahan.
Setelah penemuan dilakukan, maka akan mencantumkan titik akhir dan operasi yang ditemukan. Pilih Selesai.
Kompilasi dilakukan. Kompilasi adalah proses kompilasi perakitan kontrak data, yang dapat menjadi operasi yang memakan waktu. Pengguna diberi tahu tentang kesalahan kompilasi apa pun. Setelah penemuan dilakukan, alat menampilkan halaman berikut:
Memperluas proyek SOAP dan memilih titik akhir yang diekspos yang disediakan di bawah layar. Layar ini mencantumkan operasi yang dideklarasikan di bawah titik akhir.
Memperluas titik akhir menampilkan daftar operasi. Operasi adalah fungsi yang dideklarasikan oleh Titik Akhir. Setiap operasi membahas jenis tugas yang dapat dilakukan dalam layanan. Layar ini mencantumkan argumen yang dideklarasikan untuk operasi. Argumen ini kemudian ditentukan ketika operasi digunakan dalam mengonfigurasi alur kerja.
Langkah selanjutnya adalah menentukan skema ruang konektor, yang dicapai dengan membuat Jenis Objek dan menentukan jenis objeknya. Pilih Jenis Objek lalu pilih Tambahkan. Di jendela baru, tambahkan jenis objek baru dan berikan nama. PilihOK.
Menambahkan tipe objek menyediakan layar di bawah ini.
Panel kanan yang sesuai dengan jenis objek memungkinkan Anda mempertahankan atribut dan propertinya untuk jenis objek yang dipilih. Pilih Tambahkan. Jendela baru dibuka untuk menambahkan atribut:
Layar berikut muncul setelah menambahkan semua atribut yang diperlukan:
Jenis objek dan atribut setelah dibuat, menyediakan alur kerja kosong yang memenuhi operasi yang dilakukan di Microsoft Identity Manager 2016 (MIM).
Mengonfigurasi alur kerja di Alat Konfigurasi Layanan Web
Langkah selanjutnya adalah mengonfigurasi alur kerja untuk jenis objek Anda. File alur kerja adalah serangkaian aktivitas yang digunakan oleh Konektor Layanan Web pada durasi. Alur kerja digunakan untuk mengimplementasikan operasi MIM yang sesuai. Alat konfigurasi Layanan Web membantu Anda membuat empat alur kerja yang berbeda:
Impor: Impor data dari sumber data untuk dua jenis alur kerja berikut:
- Impor penuh: Impor penuh yang dapat dikonfigurasi.
- Impor Delta: Tidak didukung oleh Alat Konfigurasi Layanan Web.
Ekspor: Ekspor data dari MIM ke sumber data yang tersambung. Tiga tindakan berikut didukung untuk operasi. Anda dapat mengonfigurasi tindakan ini berdasarkan kebutuhan Anda.
- Menambahkan
- Hapus
- Ganti
Kata sandi: Lakukan manajemen kata sandi untuk pengguna (jenis objek). Dua tindakan tersedia untuk operasi ini:
- Mengatur kata sandi
- Ubah kata sandi
Uji Koneksi: Konfigurasikan alur kerja untuk memeriksa apakah koneksi dengan server sumber data berhasil dibuat.
Catatan
Anda dapat mengonfigurasi alur kerja ini untuk proyek Anda atau mengunduh proyek default dari Pusat Unduhan Microsoft.
Perancang Alur Kerja
Alur Kerja Designer membuka area kerja untuk mengonfigurasi alur kerja sesuai persyaratan. Untuk setiap jenis objek (baru /yang sudah ada), alat konfigurasi menyediakan simpul untuk alur kerja yang didukung oleh alat.
Designer Alur Kerja terdiri dari elemen UI berikut:
Simpul di panel kiri: Ini membantu Anda memilih alur kerja mana yang ingin Anda desain.
Designer Alur Kerja Pusat: Di sini Anda dapat menghilangkan aktivitas untuk mengonfigurasi alur kerja. Untuk menyelesaikan berbagai operasi MIM (Ekspor, Impor, Manajemen kata sandi), Anda dapat menggunakan aktivitas alur kerja standar dan kustom .NET Workflow Framework 4. Alat Konfigurasi Layanan Web menggunakan aktivitas alur kerja standar dan kustom. Untuk informasi selengkapnya tentang aktivitas standar, lihat Menggunakan perancang aktivitas.
Dalam Designer Alur Kerja Pusat, lingkaran merah dengan tanda seru di samping aktivitas apa pun menunjukkan bahwa operasi dihilangkan dan tidak didefinisikan dengan benar dan sepenuhnya. Arahkan mouse ke atas lingkaran merah untuk mengetahui kesalahan yang tepat. Setelah aktivitas ditentukan dengan benar, lingkaran merah berubah menjadi tanda informasi kuning.
Di Designer Alur Kerja Pusat, tanda informasi segitiga kuning di samping aktivitas apa pun menunjukkan bahwa aktivitas ditentukan, tetapi ada lebih banyak yang dapat Anda lakukan untuk menyelesaikan aktivitas. Arahkan mouse ke atas segitiga kuning untuk melihat informasi selengkapnya.
Kotak Alat: Mengemas semua alat termasuk aktivitas sistem dan kustom dan pernyataan yang telah ditentukan sebelumnya untuk merancang alur kerja. Untuk mengetahui informasi selengkapnya, lihat Kotak alat.
Bagian Kotak Alat: Kotak Alat memiliki bagian dan kategori berikut:
Deskripsi: Header Kotak Alat. Satu tab mengakses Kotak Alat dan properti aktivitas alur kerja yang dipilih.
Impor alur kerja: Aktivitas kustom untuk mengonfigurasi alur kerja impor.
Ekspor alur kerja: Aktivitas kustom untuk mengonfigurasi alur kerja ekspor.
Umum: Aktivitas kustom untuk mengonfigurasi alur kerja apa pun.
Debug: Aktivitas alur kerja sistem untuk penelusuran kesalahan yang ditentukan dalam Alur Kerja 4. Aktivitas ini memungkinkan pelacakan masalah untuk alur kerja.
Pernyataan: Aktivitas alur kerja sistem yang ditentukan dalam Alur Kerja 4. Untuk informasi selengkapnya, lihat Menggunakan perancang aktivitas.
Properti: Tab properti menampilkan properti aktivitas alur kerja tertentu yang dihilangkan di area perancang dan dipilih. Gambar di sebelah kiri menunjukkan properti Tetapkan aktivitas. Untuk setiap aktivitas, properti berbeda dan digunakan saat mengonfigurasi alur kerja kustom. Tab ini memungkinkan Anda menentukan atribut alat yang dipilih yang telah dijatuhkan ke perancang alur kerja pusat. Untuk informasi selengkapnya, lihat Properti.
Bilah Tugas: Bilah tugas mencakup tiga elemen: Variabel, Argumen, dan Impor. Elemen-elemen ini digunakan bersama dengan aktivitas alur kerja. Untuk informasi selengkapnya, lihat Pengenalan pengembang untuk Windows Workflow Foundation (WF) di .NET 4.
Mengonfigurasi alur kerja impor penuh di Alat Konfigurasi Layanan Web
Langkah-langkah berikut menunjukkan cara mengonfigurasi alur kerja impor penuh untuk SOAP dengan menggunakan Alat Konfigurasi Layanan Web.Peringatan
Sampel ini hanya membuat alur kerja. Modifikasi pada alur kerja, seperti menggunakan logika kustom di API, mungkin diperlukan.
Pilih alur kerja Impor Penuh untuk dikonfigurasi. Argumen dan Impor sudah ditentukan dan khusus untuk aktivitas. Lihat layar berikut untuk informasi selengkapnya.
Setelah konfigurasi ulang panggilan, ubah nama atribut yang berubah, tambahkan atau ubah namespace menjadi variabel yang merujuk ke struktur pengembalian API dan jenis objek yang mengacu pada namespace layanan lama. Kotak alat di panel kanan menyimpan semua aktivitas khusus alur kerja kustom yang Anda perlukan untuk konfigurasi. Tetapkan nilai ke variabel yang akan Anda gunakan untuk logika Anda. Buka bagian bawah perancang alur kerja pusat dan deklarasikan variabel. Variabel dideklarasikan pada langkah berikutnya.
Tambahkan aktivitas Urutan. Seret perancang aktivitas Urutan dari Kotak Alat dan letakkan ke permukaan Designer Alur Kerja Windows. Lihat layar berikut. Aktivitas Urutan berisi kumpulan aktivitas anak yang diurutkan yang dijalankannya secara berurutan.
Untuk menambahkan variabel, temukan Buat Variabel. Ketik wsResponse untuk Nama, pilih menu drop-down Jenis variabel , lalu pilih Telusuri Jenis. Dialog ditampilkan. PilihResponsdefault>yang dihasilkan>. Biarkan nilai Cakupan dan Default tidak dipilih. Atau, atur nilai-nilai ini dengan menggunakan tampilan Properti .
Sekarang tambahkan semua variabel lain dan di bawah ini adalah layar akhir.
Seret satu perancang aktivitas Urutan lagi dari Kotak Alat dalam aktivitas Urutan yang sudah ditambahkan.
Seret WebServiceCallActivity yang disajikan di bawah Umum. Aktivitas ini digunakan untuk memanggil operasi layanan Web yang tersedia setelah Penemuan. Ini adalah aktivitas kustom dan umum dalam skenario operasi yang berbeda.
Untuk menggunakan operasi layanan Web, atur properti berikut:
Nama Layanan: Masukkan nama untuk layanan web.
Nama Titik Akhir: Tentukan nama titik akhir untuk layanan yang dipilih.
Nama Operasi: Tentukan operasi masing-masing untuk layanan.
Argumen: Pilih Argumen. Dalam dialog berikutnya, tetapkan nilai argumen, seperti yang diperlihatkan dalam gambar berikut:
Penting
Jangan ubah Nama, Arah, atau Tipe untuk argumen dengan menggunakan dialog ini. Jika salah satu nilai ini diubah, aktivitas menjadi tidak valid. Hanya atur Nilai untuk argumen . Seperti yang ditunjukkan pada gambar ini, nilai wsResponse diatur.
Tambahkan aktivitas ForEach tepat di bawah WebServiceCallActivity. Aktivitas ini digunakan untuk melakukan iterasi di atas semua atribut (jangkar dan non-jangkar) dari jenis objek. Saat menyeret aktivitas ini ke permukaan Designer Alur Kerja Anda, aktivitas ini secara otomatis menghitung semua nama atribut untuk objek Anda. Atur nilai yang diperlukan sesuai layar berikut:
Seret aktivitas CreateCSEntryChangeScope dalam isi ForEach . Aktivitas ini digunakan untuk membuat instans objek CSEntryChange di domain alur kerja untuk setiap rekaman masing-masing sambil mengambil data dari sumber data target. Menyeret aktivitas ini menyediakan layar di bawah ini. Aktivitas CreateAnchorAttribute secara otomatis diwariskan.
Atur nilai ekspresi DN sebagai
‘string.Concat ("Employee",item.EmployeeID)’
. Atur AnchorValue untuk EmployeeID ke 'Convert.tostring(item. IdPegawai)'. Atur ObjectTypeName sebagai Karyawan. Setelah melakukan modifikasi ini, Anda akan melihat layar berikut:Catatan
Nilai jangkar dan nama objek bervariasi sesuai dengan layanan web yang diekspos. Gambar menunjukkan contoh.
Seret aktivitas CreateAttributeChange di bawah aktivitas CreateAnchorAttribute . Jumlah aktivitas yang akan diseret sama dengan jumlah atribut non-jangkar. Lihat gambar berikut untuk referensi.
Seret CreateValueChangeActivity dalam aktivitas CreateAttributeChange dan atur nilai atribut sesuai layar di bawah ini.
Catatan
Untuk menggunakan aktivitas ini, pilih dan tetapkan bidang masing-masing dari menu drop-down dan tetapkan nilai. Untuk atribut multinilai, hilangkan beberapa aktivitas CreateValueChangeActivity di dalam aktivitas CreateAttributeChangeActivity .
Untuk menambahkan kondisi untuk atribut, tambahkan aktivitas If seperti yang ditunjukkan pada gambar berikut:
Terakhir, tambahkan aktivitas Tetapkan dan atur ekspresi, seperti yang diperlihatkan dalam gambar berikut:
Simpan proyek ini di lokasi
%FIM_INSTALL_FOLDER%\Synchronization Service\Extensions
.Proyek default harus diunduh dan disimpan di lokasi
%FIM_INSTALL_DIR\2010\Synchronization Service\Extensions
pada sistem target. Proyek kemudian terlihat di wizard konektor layanan web.Saat menjalankan file yang dapat dieksekusi, Anda diminta untuk menentukan lokasi penginstalan. Masukkan lokasi penyimpanan.
Penting
File proyek dapat disimpan dan dibuka dari lokasi mana pun (dengan hak akses yang sesuai dari pelaksananya). Hanya file proyek yang disimpan ke
Synchronization Service\Extension
folder yang dapat dipilih dalam wizard konektor Layanan Web yang diakses melalui UI Sinkronisasi MIM.Pengguna yang menjalankan alat Konfigurasi Layanan Web memerlukan hak istimewa berikut:
- Kontrol Penuh ke folder Ekstensi Layanan Sinkronisasi.
- Akses baca ke kunci
HKLM\System\CurrentControlSet\Services\FIMSynchronizationService\Parameters
registri di mana, jalur folder Ekstensi berada.
Mengonfigurasi alur kerja ekspor di Alat Konfigurasi Layanan Web
Bagian berikut menunjukkan cara mengekspor alur kerja Anda dengan menggunakan Alat Konfigurasi Layanan Web.
Menambahkan alur kerja
Tambahkan alur kerja ekspor dengan mengikuti langkah-langkah ini di Alat Konfigurasi Layanan Web.Pilih alur kerja ekspor untuk dikonfigurasi. Di bawah Ekspor, pilih Tambahkan. Argumen dan Impor sudah ditentukan dan khusus untuk aktivitas. Lihat layar berikut untuk referensi.
Tambahkan aktivitas Urutan . Seret perancang aktivitas Urutan dari Kotak Alat dan letakkan ke permukaan Designer Alur Kerja Windows. Aktivitas Urutan berisi kumpulan aktivitas anak yang diurutkan yang dijalankannya secara berurutan. Pilih Buat Variabel. Tetapkan nilai ke variabel yang akan Anda gunakan untuk logika Anda.
Catatan
Langkah-langkah untuk menambahkan variabel dijelaskan di bagian untuk membuat alur kerja impor penuh.
Seret aktivitas ForEach dalam aktivitas Urutan yang sudah ditambahkan untuk mengulangi nilai atribut jangkar.
Pilih Properti dan atur Nilai sesuai layar di bawah ini. Di sini objectToExport adalah argumen.
Atur DisplayName sebagai ForEach<AnchorAttribute>
Atur TypeArgument sebagai
Microsoft.MetadirectoryServices.AnchorAttribute
.Tambahkan aktivitas Switch dalam isi ForEachanchorAttribute.
Tambahkan ekspresi sesuai layar di bawah ini.
Pilih Tambahkan kasus baru dan masukkan nilai untuk EmployeeId. Seret aktivitas Urutan dan di dalamnya tambahkan aktivitas Tetapkan .
Tetapkan properti Kepada dan Nilai untuk aktivitas Tetapkan .
Aktivitas ForEach digunakan untuk nilai jangkar. Tambahkan aktivitas ForEach lain untuk menetapkan nilai non-jangkar. Dalam contoh ini, jangkar AttributeChange digunakan.
Tambahkan aktivitas Switch dalam isi ForEach dari jangkar AttributeChange .
Tambahkan ekspresi sesuai layar di bawah ini.
Pilih Tambahkan kasus baru dan masukkan nilai untuk FirstName. Seret aktivitas Urutan dan di dalamnya tambahkan aktivitas Tetapkan . Tetapkan properti Kepada dan Nilai untuk aktivitas Tetapkan .
Tambahkan nilai untuk atribut yang diperlukan seperti LastName, Email, dan sebagainya.
Di bawah Umum, seret WebServiceCallActivity dan atur Nilai untuk Argumennya.
Penting
Jangan ubah Nama, Arah, atau Tipe untuk argumen dengan menggunakan dialog ini. Jika salah satu nilai ini diubah, aktivitas menjadi tidak valid. Hanya atur Nilai untuk argumen . Seperti yang ditunjukkan pada gambar ini, nilai wsResponse diatur.
Terakhir, tambahkan aktivitas If untuk memeriksa respons yang dikembalikan dari operasi layanan web.
Pembuatan alur kerja ekspor dengan operasi Tambahkan selesai:
Simpan proyek ini di lokasi %FIM_INSTALL_FOLDER%\Synchronization Service\Extensions
.
Menghapus alur kerja
Hapus alur kerja ekspor dengan mengikuti langkah-langkah ini di Alat Konfigurasi Layanan Web.
Pilih alur kerja ekspor untuk dikonfigurasi. Di bawah Ekspor, pilih Hapus. Argumen dan Impor sudah ditentukan dan khusus untuk aktivitas. Lihat layar berikut untuk referensi.
Tambahkan aktivitas Urutan . Pilih Buat Variabel. Tetapkan nilai ke variabel yang akan Anda gunakan untuk logika Anda.
Catatan
Langkah-langkah untuk menambahkan variabel dijelaskan di bagian untuk membuat alur kerja impor penuh.
Seret aktivitas ForEach dalam aktivitas Urutan yang sudah ditambahkan untuk mengulangi nilai atribut jangkar.
Pilih Properti dan atur Nilai per layar di bawah ini. Di sini objectToExport adalah argumen.
Atur DisplayName sebagai
ForEach\<AnchorAttribute\>
:Atur TypeArgument sebagai
Microsoft.MetadirectoryServices.AnchorAttribute
:Tambahkan aktivitas Switch dalam isi ForEachanchorAttribute.
Tambahkan ekspresi sesuai layar di bawah ini.
Pilih Tambahkan kasus baru dan masukkan nilai untuk EmployeeId. Seret aktivitas Urutan dan di dalamnya tambahkan aktivitas Tetapkan .
Tetapkan properti Kepada dan Nilai untuk aktivitas Tetapkan .
Di bawah Umum, seret WebServiceCallActivity dan atur Nilai untuk Argumennya.
Penting
Jangan ubah Nama, Arah, atau Tipe untuk argumen dengan menggunakan dialog ini. Jika salah satu nilai ini diubah, aktivitas menjadi tidak valid. Hanya atur Nilai untuk argumen . Seperti yang ditunjukkan pada gambar ini, nilai employeeID ditetapkan.
Terakhir, tambahkan aktivitas If untuk memeriksa respons yang dikembalikan dari operasi layanan web.
Penghapusan alur kerja ekspor dengan operasi Hapus selesai:
Simpan proyek ini di lokasi %FIM_INSTALL_FOLDER%\Synchronization Service\Extensions
.
Mengganti alur kerja
Ganti alur kerja ekspor dengan mengikuti langkah-langkah ini di Alat Konfigurasi Layanan Web.
Pilih alur kerja ekspor untuk dikonfigurasi. Di bawah Ekspor, pilih Ganti. Argumen dan Impor sudah ditentukan dan khusus untuk aktivitas. Lihat layar di bawah ini untuk referensi.
Tambahkan aktivitas Urutan .
Seret aktivitas ForEach untuk <AnchorAttribute>.
Tambahkan aktivitas ForEach<AttributeChange> lain untuk menetapkan nilai non-jangkar.
Terakhir, layar terlihat seperti gambar berikut. Instruksi untuk mengonfigurasi aktivitas ini disediakan di bagian untuk menambahkan alur kerja ekspor.
Di bawah Umum, seret WebServiceCallActivity dan atur Nilai untuk Argumennya.
Penting
Jangan ubah Nama, Arah, atau Tipe untuk argumen dengan menggunakan dialog ini. Jika salah satu nilai ini diubah, aktivitas menjadi tidak valid. Hanya atur Nilai untuk argumen . Seperti yang ditunjukkan pada gambar ini, nilai karyawan ditetapkan.
Terakhir, tambahkan aktivitas If untuk memeriksa respons yang dikembalikan dari operasi layanan web.
Penggantian alur kerja ekspor dengan operasi Ganti selesai:
Simpan proyek ini di lokasi %FIM_INSTALL_FOLDER%\Synchronization Service\Extensions
.
Aktivitas debug
Aktivitas kustom berikut ini tersedia untuk membantu men-debug templat alur kerja.
Aktivitas log
Aktivitas Log digunakan untuk menulis pesan teks ke file log. Untuk informasi selengkapnya, lihat Pengelogan.
Catatan
Jika Anda tidak dapat dengan mudah men-debug alur kerja Anda, coba debug alur kerja di lingkungan produksi.
Untuk menggunakan aktivitas Log , atur properti berikut. Properti terlihat saat Anda memilih aktivitas di alur kerja Designer dan melihat Properti untuk aktivitas tersebut.
Aktivitas WriteLine
Aktivitas WriteLine digunakan untuk menulis pesan teks ke penulis penyedia. Jika tidak ada penulis yang tersedia, aktivitas WriteLine menulis teks ke jendela konsol.
Dalam kotak teks, tulis pesan yang ingin Anda lihat di target penulis.
Penting
Jendela konsol tidak dapat digunakan untuk aktivitas ini. Gunakan penulis output jendela lain untuk tugas ini.
Untuk menggunakan aktivitas WriteLine , atur properti berikut. Properti terlihat saat Anda memilih aktivitas di alur kerja Designer dan melihat Properti untuk aktivitas tersebut.
Tingkat Log: Menentukan jumlah konten yang akan ditulis dalam nilai log. Nilai yang mungkin adalah:
- Tinggi: Tulis pesan LogText ke file log jika tingkat keparahan log diatur ke Tinggi.
- Verbose: Tulis pesan LogText ke file log jika tingkat keparahan log diatur ke Verbose.
- Dinonaktifkan: Jangan tulis dalam file log.
LogText: Menentukan konten teks yang akan ditulis dalam log.
Tag: Menambahkan tag ke teks untuk mengidentifikasi jenis konten yang sedang ditulis dalam log. Nilai yang mungkin adalah: Kesalahan, Pelacakan, atau Peringatan.