Cara XQuery Untuk Mengambil Data Dari Layanan Web – Freeform SQL Editor dapat digunakan untuk terhubung ke layanan web pihak ketiga untuk mengambil dan melaporkan data. Namun, Anda tidak dapat menggunakan SQL untuk melaporkan layanan web. Sebagai gantinya, Anda harus menggunakan pernyataan XQuery.
Cara XQuery Untuk Mengambil Data Dari Layanan Web
zorba-xquery – XQuery adalah bahasa yang digunakan untuk mengambil data dari dokumen atau sumber data yang dapat dilihat sebagai XML. Karena Anda membuat pernyataan XQuery Anda sendiri untuk membuat laporan dengan Freeform SQL Editor, pemahaman tentang cara membuat dan menggunakan pernyataan XQuery sangatlah penting. Beberapa teknik dasar cara membuat pernyataan XQuery disediakan di bawah ini.
Anda juga dapat menggunakan Editor dan Generator XQuery (XEG) untuk menghasilkan pernyataan XQuery untuk mengkueri sumber data tertentu. Untuk langkah-langkah menggunakan XEG, lihat Membuat Pernyataan XQuery dengan XQuery Editor and Generator (XEG) .
Pernyataan XQuery, yang digunakan untuk membuat laporan di MicroStrategy untuk melaporkan data yang diambil dari layanan web, dapat dipisahkan menjadi dua bagian logis. Kedua bagian logis ini memisahkan tugas menghubungkan ke data dan mengembalikan data sehingga dapat diintegrasikan ke dalam MicroStrategy.
Baca Juga : Memahami Alat Bantu XQuery Untuk Pengarsip
Menghubungkan ke layanan web dan meminta data: Bagian pertama dari pernyataan XQuery mencakup semua definisi dan informasi yang diperlukan untuk terhubung ke layanan web.
Ini termasuk menentukan fungsi apa pun yang diperlukan untuk pernyataan XQuery, menentukan apakah akan menggunakan arsitektur REST atau protokol SOAP, membuat permintaan untuk mengambil data dari layanan web, dan seterusnya. Definisi ini disorot dengan kotak merah dengan batas tegas pada contoh pernyataan XQuery di atas.
Definisi yang diperlukan di bagian XQuery ini bergantung pada layanan web yang Anda akses dan data yang ingin Anda ambil.
Anda juga dapat menggunakan fungsi REST atau SOAP yang disediakan oleh vendor pihak ketiga lainnya seperti Zorba. Namun, MicroStrategy hanya secara aktif menguji dan mendukung fungsi MicroStrategy yang tercantum di atas.
Menerapkan keamanan: Dalam contoh pernyataan XQuery yang ditunjukkan di atas, tidak diperlukan informasi login untuk mengakses layanan web. Namun, layanan web dapat memerlukan berbagai jenis informasi login dan protokol keamanan untuk mengakses data. Untuk informasi tentang penerapan keamanan dalam pernyataan XQuery dan bagaimana hal ini dapat mengubah sintaks permintaan XQuery, lihat Menerapkan Keamanan Dalam Pernyataan XQuery .
Mengembalikan data dari layanan web agar dapat diintegrasikan ke dalam Strategi Mikro: Bagian kedua dari pernyataan XQuery menentukan cara mengembalikan data yang diambil dari layanan web agar dapat diintegrasikan ke dalam Strategi Mikro. Definisi ini disorot dengan kotak biru dengan batas putus-putus pada contoh pernyataan XQuery di atas.
Anda harus mengembalikan data dalam format tabel, itulah sebabnya pernyataan XQuery yang ditampilkan di atas dimulai dengan return
. Ini memastikan bahwa data dalam format yang dapat dipahami dalam MicroStrategy.Bagian pernyataan menentukan kolom data yang disertakan dalam tabel. Pernyataan XQuery yang ditunjukkan di atas membuat kolom untuk data kota, negara bagian, kode pos, kode area, dan zona waktu. Kolom ini menjadi atribut dan metrik laporan MicroStrategy.Data untuk kolom ini kemudian diambil di bagian pernyataan. Cara Anda membuat pernyataan XQuery untuk mengembalikan data bergantung pada struktur layanan web pihak ketiga, serta apakah Anda berencana untuk memanipulasi data menggunakan XQuery sebelum mengintegrasikannya ke dalam MicroStrategy.Menerapkan Keamanan Dalam Pernyataan XQueryLayanan web dapat memiliki berbagai persyaratan keamanan untuk mengakses data yang disediakan oleh layanan web. Dukungan MicroStrategy untuk pengambilan data dari layanan web menggunakan pernyataan XQuery mendukung sebagian besar mekanisme keamanan layanan web yang tersedia. Layanan web dapat memerlukan autentikasi HTTP, Keamanan Layanan Web, atau persyaratan keamanan nama pengguna dan kata sandi standar, yang semuanya dijelaskan di bawah ini:Otentikasi HTTP menyediakan otentikasi menggunakan salah satu dari beberapa mode otentikasi. MicroStrategy mendukung penggunaan autentikasi HTTP dasar dan intisari untuk fungsi REST, dan hanya autentikasi HTTP dasar untuk fungsi SOAP. Nama pengguna dan kata sandi yang Anda berikan sebagai bagian dari login database secara otomatis digunakan oleh MicroStrategy untuk menyelesaikan autentikasi HTTP apa pun yang diperlukan oleh layanan web.Membuat login database adalah bagian dari langkah-langkah yang diperlukan untuk membuat instans database untuk mengakses layanan web, yang dijelaskan dalam Mengizinkan Koneksi ke Layanan Web di Proyek. Login database default dikaitkan dengan layanan web yang Anda sambungkan. Anda juga dapat menggunakan pemetaan koneksi untuk menentukan login database yang digunakan untuk setiap pengguna MicroStrategy. Untuk informasi tentang mengonfigurasi pemetaan koneksi, lihat Bantuan Administrasi Sistem . Jika layanan web menggunakan autentikasi HTTP, Anda tidak dapat menggunakan autentikasi Keamanan Layanan Web, yang dijelaskan di bawah ini.Contoh yang diberikan dalam Using XQuery to Retrieve Data from a Web Service adalah contoh penggunaan fungsi REST dengan parameter URI. Dalam contoh tersebut, parameter URImenyediakan URL untuk mengakses layanan web serta menentukan data yang akan dikembalikan. Parameter ini mendukung autentikasi HTTP dasar dan intisari.
