Database Functoids
Functoid database mengekstrak data dari database untuk digunakan dalam pesan instans output.
Gambaran Umum
Berikut ini adalah daftar functoid Database dan bagaimana Anda bisa menggunakannya:
Pencarian Database. Gunakan functoid Pencarian Database untuk mengekstrak informasi dari database dan menyimpannya sebagai kumpulan rekaman Microsoft ActiveX Data Objects .NET (ADO.NET). Functoid ini memerlukan empat parameter input dalam urutan berikut:
Nilai pencarian
database string koneksi
Nama tabel
Nama kolom untuk nilai pencarian.
Kesalahan Kembali. Gunakan functoid Pengembalian Kesalahan untuk menangkap informasi kesalahan, seperti kegagalan koneksi database, yang terjadi selama durasi. Functoid ini memerlukan satu parameter input: tautan dari functoid Pencarian Database .
Format Pesan. Mengembalikan string yang diformat dan dilokalkan menggunakan substitusi argumen dan, berpotensi, ID dan referensi silang nilai.
Dapatkan ID Aplikasi. Mengambil pengidentifikasi untuk objek aplikasi.
Dapatkan Nilai Aplikasi. Mengambil nilai aplikasi.
Dapatkan ID Umum. Mengambil pengidentifikasi untuk objek umum.
Dapatkan Nilai Umum. Mengambil nilai umum.
Hapus ID Aplikasi. Menghapus nilai aplikasi.
Atur ID Umum. Mengatur dan mengembalikan pengidentifikasi untuk objek umum.
Ekstraktor Nilai. Gunakan functoid Ekstraktor Nilai untuk mengekstrak data dari kolom yang ditentukan dalam kumpulan rekaman yang dikembalikan oleh functoid Pencarian Database . Functoid ini memerlukan dua parameter input: tautan ke functoid Pencarian Database dan nama kolom.
Tujuh functoid Database — Format Pesan, Dapatkan ID Aplikasi, Dapatkan Nilai Aplikasi, Dapatkan ID Umum, Dapatkan Nilai Umum, Hapus ID Aplikasi, dan Atur ID Umum—adalah functoid CrossReferencing . Functoid ini menerjemahkan ID dan nilai dari pesan input ke dalam ID dan nilai yang diperlukan dalam pesan output. Untuk informasi selengkapnya, lihat Referensi Functoids Database dalam panduan UI dan referensi namespace LAYANAN API pengembang.
Contoh
Contoh berikut menggunakan beberapa functoid Database . Pertimbangkan produsen ritel besar dengan toko yang tersebar di area geografis yang besar. Untuk melacak toko, kantor pusat menetapkan setiap penyimpanan kode unik yang disebut StoreID. Selain itu, kantor pusat mengaitkan informasi berikut dengan setiap StoreID:
StoreName
StoreAddress
Kota
KodePos
StorePhoneNumber
StoreManager
Informasi ini disimpan dalam database dan didistribusikan kepada mitra dagang secara teratur. Untuk produsen, semua pembelian dilakukan oleh kantor pusat, bukan toko. Ketika kantor pusat mengirim pesanan pembelian ke mitra dagang, adalah umum bagi beberapa toko untuk menerima barang yang dipesan melalui satu pesanan pembelian. Alih-alih mengirim informasi nama dan alamat untuk setiap toko yang akan menerima barang dagangan, kantor pusat hanya mengirim StoreID. Untuk memasukkan informasi nama dan alamat ke dalam pemberitahuan pengiriman lanjutan, mitra dagang menggunakan functoid Database untuk secara otomatis memasukkan informasi ini ke dalam pesan instans output. Gambar berikut menunjukkan bagaimana mitra dagang dapat menerapkan penggantian StoreID dalam peta.
Dalam gambar, skema sumber mewakili pesanan pembelian yang masuk; skema tujuan mewakili pemberitahuan pengiriman lanjutan. Functoid Pencarian Database menemukan rekaman yang sesuai dari tabel database yang sesuai. Functoid Ekstraktor Nilai mengekstrak kolom yang sesuai dari rekaman pencarian. Functoid Pengembalian Kesalahan menghasilkan string yang berisi informasi kesalahan jika ada kesalahan (seperti kegagalan koneksi) pada durasi.
Dalam contoh sebelumnya, parameter input pertama diambil dari bidang StoreID dari pesanan pembelian masuk, dan tiga parameter input yang tersisa adalah konstanta yang dikonfigurasi dalam kotak dialog Konfigurasi <Functoid> Functoid untuk functoid Pencarian Database . Dimungkinkan untuk membuat tautan dari skema sumber untuk menyediakan nilai untuk keempat parameter input.
Catatan
Anda tidak dapat menggunakan beberapa jenis data Microsoft SQL Server, seperti teks, ntext, dan gambar, sebagai nilai pencarian untuk functoid Pencarian Database. Functoid memerlukan jenis data yang dapat direpresentasikan sebagai string teks.
Jika ada lebih dari satu rekaman yang cocok dengan parameter input functoid Pencarian Database , functoid Ekstraktor Nilai mengekstrak data hanya dari rekaman pertama.
Gunakan autentikasi NT dalam string koneksi untuk melindungi kata sandi dengan enkripsi.
Functoid yang tersedia
Functoid Database adalah:
- Pencarian Database
- Pengembalian Kesalahan
- Format Pesan
- Dapatkan ID Aplikasi
- Dapatkan Nilai Aplikasi
- Dapatkan ID Umum
- Dapatkan Nilai Umum
- Hapus ID Aplikasi
- Atur ID Umum
- Ekstraktor Nilai
Untuk detail selengkapnya tentang functiod ini, lihat Referensi Functoid dalam panduan UI dan referensi namespace LAYANAN API pengembang.
Lihat juga
- Cara Menambahkan Functoid Dasar ke Peta
- Referensi Functoids Database dalam panduan UI dan referensi namespace LAYANAN API pengembang