Mendesain model konektivitas data bisnis

Anda dapat mengembangkan model untuk layanan Konektivitas Data Bisnis (BDC) dengan menambahkan entitas dan metode ke file model. Entitas menjelaskan kumpulan bidang data. Misalnya, entitas dapat mewakili tabel dalam database. Metode melakukan tugas seperti menambah, menghapus, atau memperbarui data yang diwakili oleh entitas. Untuk informasi selengkapnya, lihat Mengintegrasikan data bisnis ke dalam SharePoint.

Menambahkan entitas

Anda dapat menambahkan entitas dengan menyeret atau menyalin Entitas dari Kotak Alat Visual Studio ke Perancang BDC. Untuk informasi selengkapnya, lihat Cara: Menambahkan entitas ke model.

Tentukan bidang entitas di kelas . Misalnya, Anda dapat menambahkan bidang bernama Address ke kelas Customer. Anda dapat menambahkan kelas baru ke proyek atau menggunakan kelas yang sudah ada yang dibuat menggunakan alat lain seperti Object Relational Designer (O/R Designer). Nama entitas dan nama kelas yang mewakili entitas tidak harus sama. Anda menghubungkan kelas ke entitas saat Anda menentukan metode dalam model Anda.

Menambahkan metode

Layanan BDC memanggil metode dalam model Anda saat pengguna menampilkan, menambah, memperbarui, atau menghapus informasi dalam daftar atau Komponen Web yang didasarkan pada model Anda. Anda harus menambahkan metode ke model untuk setiap tugas yang dapat dilakukan pengguna. Buat metode dengan memilih salah satu dari lima jenis metode dasar dari jendela Detail Metode BDC. Tabel berikut ini menjelaskan lima metode dasar model BDC.

Metode	Deskripsi
Finder	Mengembalikan kumpulan instans entitas. Dipanggil saat pengguna membuka daftar atau Komponen Web. Untuk informasi selengkapnya, lihat Cara: Menambahkan metode Finder.
Finder Tertentu	Mengembalikan instans entitas tertentu. Dipanggil saat pengguna melihat detail item tertentu dalam daftar. Untuk informasi selengkapnya, lihat Cara: Menambahkan metode Finder tertentu.
Pembuat	Menambahkan data baru ke sumber data entitas. Dipanggil saat pengguna memilih tombol Item Baru pada Pita daftar yang didasarkan pada model. Untuk informasi selengkapnya, lihat Cara: Menambahkan metode Pembuat.
Updater	Memodifikasi data dalam daftar. Dipanggil saat pengguna memperbarui informasi dalam daftar. Untuk informasi selengkapnya, lihat Cara: Menambahkan metode Updater.
Deleter	Menghapus data. Dipanggil saat pengguna menghapus item dari daftar. Untuk informasi selengkapnya, lihat Cara: Menambahkan metode Deleter.

Menentukan parameter metode

Saat Anda membuat metode, Visual Studio menambahkan parameter input dan output yang sesuai untuk jenis metode. Parameter ini hanyalah tempat penampung. Dalam kebanyakan kasus, Anda harus memodifikasi parameter sehingga parameter meneruskan atau mengembalikan jenis data yang benar. Misalnya, secara default, metode Finder mengembalikan string. Dalam kebanyakan kasus, Anda ingin memodifikasi parameter pengembalian metode Finder sehingga mengembalikan kumpulan entitas. Anda dapat melakukannya dengan memodifikasi pendeskripsi tipe parameter. Deskriptor tipe adalah kumpulan atribut yang menjelaskan jenis data parameter. Untuk informasi selengkapnya, lihat Cara: Menentukan pendeskripsi tipe parameter.

Visual Studio memungkinkan Anda menyalin pendeskripsi tipe antar parameter dalam model. Misalnya, Anda dapat menentukan pendeskripsi tipe bernama CustomerTD untuk parameter pengembalian metode GetCustomer. Anda dapat menyalin pendeskripsi tipe CustomerTD di BDC Explorer, lalu menempelkan pendeskripsi tipe tersebut ke parameter input metode CreateCustomer. Ini mencegah Anda dari keharusan menentukan pendeskripsi tipe yang sama lebih dari sekali.

Instans metode

Saat Anda membuat metode, Visual Studio menambahkan instans metode default. Instans metode adalah referensi ke metode, ditambah nilai default untuk parameter. Satu metode dapat memiliki beberapa instans metode. Setiap instans adalah kombinasi dari tanda tangan metode dan sekumpulan nilai default. Untuk informasi selengkapnya, lihat Cara: Menentukan pendeskripsi tipe parameter.

Saat Anda menjalankan proyek, contoh metode muncul dalam daftar drop-down di atas daftar SharePoint. Pengguna dapat memilih instans metode untuk melihat data.

Untuk menambahkan nilai default ke instans metode, Anda harus memodifikasi XML model secara langsung. Untuk informasi selengkapnya, lihat DefaultValue.

Menambahkan pendeskripsi filter

Konsumen model mungkin ingin mengambil contoh entitas yang cocok dengan beberapa kriteria. Untuk mengaktifkan fungsionalitas ini, Anda dapat menambahkan pendeskripsi filter ke metode. Pendeskripsi filter memungkinkan konsumen model untuk memfilter kumpulan hasil metode dengan meneruskan nilai ke metode sebelum dijalankan. Untuk informasi selengkapnya, lihat Cara: Menambahkan Parameter Filter ke Operasi untuk Membatasi Instans dari Sistem Eksternal.

SharePoint menyediakan beberapa fitur yang memungkinkan pengguna memberikan nilai filter. Misalnya, Komponen Web Data Bisnis menyediakan kotak teks filter. Pengguna dapat membatasi data dalam daftar dengan memasukkan nilai dalam kotak teks. Untuk informasi selengkapnya tentang cara menambahkan pendeskripsi filter ke metode, lihat Cara: Menambahkan pendeskripsi filter ke metode Finder.

Properti pendeskripsi filter

Anda harus mengatur nilai properti Pendeskripsi Tipe Terkait, Nama, dan Jenis pendeskripsi filter. Semua properti bersifat opsional.

Properti Pendeskripsi Tipe Terkait menghubungkan pendeskripsi filter dengan parameter input. Saat pengguna memberikan nilai filter, layanan BDC meneruskan nilai tersebut ke metode dengan menggunakan parameter input.

Properti Jenis menjelaskan pola pemfilteran yang ingin Anda gunakan. Di SharePoint, pola pemfilteran yang Anda pilih memengaruhi teks yang muncul di Antarmuka Pengguna (UI). Misalnya, untuk pola pemfilteran Pembanding, teks sama dengan muncul sebagai kontrol di atas Komponen Web Data Bisnis. Untuk informasi selengkapnya tentang setiap pola pemfilteran, lihat Jenis Filter yang Didukung oleh BDC.

Untuk informasi selengkapnya tentang properti pendeskripsi filter, lihat FilterDescriptor.

Memberikan nilai default

Dalam beberapa kasus, pengguna mungkin tidak memberikan nilai filter. Anda dapat memberikan nilai default dengan menambahkan nilai default ke instans metode, atau dengan mengatur nilai default dalam kode metode Anda. Untuk informasi selengkapnya tentang cara menambahkan nilai default ke instans metode, lihat MethodInstance. Untuk contoh cara mengatur nilai default parameter input dalam kode metode Anda, lihat Cara: Menambahkan pendeskripsi filter ke metode Finder.

Memvalidasi model

Anda dapat memvalidasi model selama pengembangan. Visual Studio mengidentifikasi masalah yang dapat mencegah model Anda berperilaku seperti yang diharapkan. Masalah ini muncul di Daftar Kesalahan Visual Studio.

Anda dapat memvalidasi model dengan membuka menu pintasan untuk Perancang BDC lalu memilih Validasi. Jika model berisi kesalahan apa pun, kesalahan tersebut akan muncul di Daftar Kesalahan. Anda dapat dengan cepat memindahkan kursor ke kode yang berisi kesalahan dengan mengeklik dua kali kesalahan dalam daftar. Sebagai alternatif, Anda dapat memilih tombol F8 atau Shift+F8 berulang kali untuk melangkah maju atau mundur melalui kesalahan dalam daftar.

Kesalahan validasi dapat terjadi ketika aturan model dilanggar dalam beberapa cara. Misalnya, jika properti IsCollection dari pendeskripsi tipe diatur ke true, tetapi tidak ada pendeskripsi tipe turunan, kesalahan validasi akan muncul. Anda mungkin harus merujuk ke aturan model BDC untuk memahami beberapa kesalahan yang muncul di Daftar Kesalahan Visual Studio. Untuk informasi selengkapnya tentang aturan model BDC, lihat Skema BDCMetadata.

Men-debug solusi yang berisi model

Anda dapat men-debug kode Anda seperti halnya men-debug kode apa pun di Visual Studio. Untuk men-debug kode Anda, atur titik henti di mana pun dalam kode Anda, lalu mulai debugger. Visual Studio membuka situs SharePoint. Di SharePoint, buat daftar atau Komponen Web yang menggunakan data bisnis Anda. Kemudian, Anda dapat menelusuri kode Anda. Untuk informasi selengkapnya tentang penelusuran kesalahan proyek SharePoint, lihat Memecahkan masalah solusi SharePoint.

Anda juga dapat men-debug kode dalam rakitan kustom yang Anda tambahkan ke proyek. Namun, untuk men-debug kode di rakitan kustom, Anda harus menambahkan rakitan ke paket solusi. Untuk informasi selengkapnya, lihat Cara: Menambahkan dan menghapus rakitan tambahan.

Untuk informasi selengkapnya tentang menambahkan rakitan kustom ke proyek Anda, lihat Cara: Menyertakan rakitan kustom dalam fitur BDC.

Mengonfigurasi keamanan BDC

Anda mungkin harus memodifikasi pengaturan keamanan Anda di SharePoint sebelum Anda dapat men-debug solusi Anda. Untuk memodifikasi pengaturan ini, buka Aplikasi Layanan Konektivitas Data Bisnis di situs Web Administrasi Pusat SharePoint 2010. Di kotak dialog Atur Izin Penyimpanan Metadata, tambahkan akun pengguna Anda, lalu pilih salah satu opsi berikut:

Tugas	Opsi
Untuk menyebarkan model ke layanan BDC.	Edit
Untuk membuat daftar dan Komponen Web menggunakan jenis konten eksternal (entitas) dalam model Anda.	Dapat dipilih di Klien
Untuk membuat, membaca, memperbarui, dan menghapus data entitas.	Jalankan

Untuk informasi selengkapnya tentang pengaturan ini, lihat Manajemen layanan Konektivitas Data Bisnis.

Anda juga dapat mengatur izin keamanan untuk model individual atau jenis konten eksternal. Untuk informasi selengkapnya tentang cara mengatur izin keamanan model, lihat Manajemen model BDC. Untuk informasi selengkapnya tentang cara mengatur izin keamanan jenis konten eksternal, lihat Manajemen jenis konten eksternal.

Catatan

Gunakan pengaturan ini untuk men-debug solusi di server SharePoint lokal Anda. Untuk informasi selengkapnya tentang cara mengonfigurasi pengaturan keamanan terkait BDC di server SharePoint produksi, lihat Ringkasan keamanan Layanan Konektivitas Data Bisnis.

Mencabut model yang menjadi rusak

Pertama kali Anda memulai debugger, Visual Studio menyebarkan seluruh model ke SharePoint. Untuk setiap kali setelahnya, Visual Studio memperbarui model di SharePoint dengan perubahan apa pun yang Anda buat antar penyebaran.

Mungkin ada situasi saat Anda ingin Visual Studio mencabut model dari SharePoint sepenuhnya. Misalnya, model mungkin menjadi rusak. Untuk menyebarkan ulang model Anda ke SharePoint, atur properti Pembaruan Bertambah Bertahap model ke False, lalu mulai debugger. Properti Pembaruan Bertambah Bertahap muncul di jendela Properti saat Anda memilih node yang mewakili model di BDC Explorer. Secara default, nama modelnya adalah BdcModel1.

Mengubah nama pengidentifikasi entitas dalam model

Jika Anda mengubah nama pengidentifikasi setelah menyebarkan model, Anda mungkin menerima kesalahan penyebaran. Anda tidak dapat mengatasi kesalahan ini dengan mengatur properti Pembaruan Bertambah Bertahap model ke False. Anda harus mencabut model secara manual, lalu menyebarkan solusi lagi. Untuk informasi selengkapnya, lihat Memecahkan masalah solusi SharePoint. Anda dapat menghindari kesalahan ini dengan mengatur properti Pembaruan Bertambah Bertahap ke False sebelum Anda menyebarkan model untuk pertama kali.

Menemukan dokumentasi untuk elemen model BDC

Visual Studio menambahkan elemen XML ke model untuk setiap entitas, metode, atau item lain yang Anda buat. Atribut elemen muncul sebagai properti di jendela Properti. Untuk informasi tentang elemen dan atribut yang dihasilkan Visual Studio saat Anda merancang model, lihat Skema BDCMetadata.

Topik terkait

Judul	Deskripsi
Ringkasan alat desain model BDC	Menjelaskan alat yang dapat Anda gunakan untuk merancang model BDC secara visual.
Cara: Menambahkan Entitas ke Model	Menunjukkan cara menambahkan jenis konten eksternal, atau entitas, ke model.
Cara: Menambahkan metode Finder	Menunjukkan cara menambahkan metode yang memungkinkan pengguna menampilkan daftar entitas dalam daftar atau Komponen Web.
Cara: Menambahkan metode Finder tertentu	Menunjukkan kepada Anda cara menambahkan metode yang memungkinkan pengguna melihat detail entitas tertentu.
Cara: Menambahkan metode Creator	Menunjukkan cara menambahkan metode yang memungkinkan pengguna menambahkan rekaman ke sumber data secara langsung dari daftar atau Komponen Web.
Cara: Menambahkan metode Deleter	Menunjukkan cara menambahkan metode yang memungkinkan pengguna menghapus data dari sumber data menggunakan opsi di Antarmuka Pengguna (UI) daftar atau Komponen Web.
Cara: Menambahkan metode Updater	Menunjukkan cara menambahkan metode yang memungkinkan pengguna mengubah rekaman data di sumber data langsung dari daftar atau Komponen Web.
Petunjuk: Menambahkan parameter ke metode	Menunjukkan cara menggunakan Jendela Detail Metode di Visual Studio untuk menambahkan parameter input dan pengembalian ke metode.
Cara: Menentukan pendeskripsi tipe parameter	Menunjukkan cara menentukan jenis data parameter dalam model.
Petunjuk: Menentukan instans metode	Menunjukkan cara membuat instans dari metode yang dijalankan BDC.
Cara: Menambahkan pendeskripsi filter ke metode Finder	Menunjukkan cara mengaktifkan pengguna untuk membatasi jumlah instans yang dikembalikan oleh metode Finder.
Membuat Asosiasi Antar Entitas	Menjelaskan bagaimana Anda dapat menentukan hubungan antar entitas dalam model. Komponen Web Data Bisnis, Daftar Eksternal, dan aplikasi kustom dapat menampilkan hubungan data ini di antarmuka pengguna (UI).
Cara: Membuat asosiasi antar entitas	Menunjukkan cara menentukan hubungan antar entitas dalam model.
Panduan: Membuat daftar eksternal di SharePoint dengan menggunakan data bisnis	Menyediakan petunjuk langkah demi langkah yang menunjukkan cara membuat dan menguji model yang menampilkan kontak dalam daftar eksternal SharePoint.
Mengintegrasikan data bisnis ke dalam SharePoint	Memberikan ringkasan tentang pembuatan dan perancangan model untuk layanan BDC.