Pelacakan dependensi untuk komponen solusi

Solusi terdiri dari komponen solusi. Gunakan area Solusi di Microsoft Dataverse untuk membuat atau menambahkan komponen solusi. Anda dapat melakukan tindakan ini secara terprogram menggunakan pesan AddSolutionComponentRequest atau pesan yang membuat atau memperbarui komponen solusi yang mencakup parameter SolutionUniqueName.

Komponen solusi sering tergantung pada komponen solusi lainnya. Anda tidak dapat menghapus komponen solusi yang memiliki dependensi pada komponen solusi lain. Misalnya, ribbon yang disesuaikan biasanya memerlukan sumber daya web gambar atau skrip untuk menampilkan ikon dan melakukan tindakan menggunakan skrip. Selama pita kustom ada dalam solusi, sumber daya web tertentu yang digunakannya diperlukan. Sebelum Anda dapat menghapus sumber daya web, Anda harus menghapus referensi ke sumber daya tersebut di pita yang disesuaikan. Anda dapat melihat dependensi komponen solusi ini dalam aplikasi dengan memilih Tampilkan Dependensi.

Artikel ini menjelaskan jenis komponen solusi yang dapat Anda sertakan dalam solusi Anda dan bagaimana mereka bergantung satu sama lain.

Semua Komponen Solusi

Kolom pilihan global sistem componenttype berisi daftar lengkap jenis komponen solusi yang tersedia. Anda dapat melihat rentang nilai yang didukung untuk properti ini dengan menyertakan file OptionSets.cs atau OptionSets.vb dalam proyek Anda. Namun, banyak dari jenis komponen solusi yang tercantum hanya ada untuk penggunaan internal, dan daftar tidak memberikan informasi tentang hubungan antar komponen solusi.

Dependensi komponen solusi

Dependensi komponen solusi memastikan Anda memiliki pengalaman yang andal bekerja dengan solusi. Hal ini mencegah tindakan yang biasanya Anda lakukan agar tidak sengaja merusak penyesuaian yang ditentukan dalam solusi. Dependensi ini adalah yang memungkinkan solusi terkelola untuk diinstal dan dicopot hanya dengan mengimpor atau menghapus solusi.

Kerangka solusi secara otomatis melacak dependensi untuk komponen solusi. Setiap operasi pada komponen solusi secara otomatis menghitung dependensi ke komponen lain dalam sistem. Sistem menggunakan informasi dependensi untuk mempertahankan integritasnya dan mencegah operasi yang dapat menyebabkan status yang tidak konsisten.

Sebagai hasil dari pelacakan dependensi, perilaku berikut diterapkan:

Penghapusan komponen dicegah jika komponen lain dalam sistem tergantung padanya.
Pengeksporan sebuah solusi memperingatkan Anda jika ada komponen yang hilang yang dapat menyebabkan kegagalan saat mengimpor solusi tersebut di lingkungan lain.

Anda dapat mengabaikan peringatan selama ekspor jika Anda berniat untuk menginstal solusi hanya di lingkungan di mana komponen dependen diharapkan ada. Misalnya, ketika Anda membuat solusi yang dirancang untuk diinstal di atas solusi "dasar" yang telah diinstal sebelumnya.
Impor solusi gagal jika solusi tidak menyertakan semua komponen yang diperlukan dan lingkungan target belum memilikinya.
Saat Anda mengimpor solusi terkelola, semua komponen yang diperlukan harus sesuai dengan jenis paket solusi. Komponen dalam solusi terkelola hanya dapat bergantung pada komponen terkelola lain.

Ada tiga jenis dependensi komponen solusi:

Solusi internal. Dataverse mengelola dependensi internal. Dependensi ini ada ketika komponen solusi tertentu tidak dapat ada tanpa komponen solusi lain.
Diterbitkan. Dataverse membuat dependensi yang dipublikasikan saat dua komponen solusi saling terkait dan kemudian dipublikasikan. Untuk menghapus jenis dependensi ini, Anda harus menghapus asosiasi dan menerbitkan tabel lagi.
Tidak diterbitkan. Dependensi yang tidak diterbitkan berlaku untuk versi yang tidak diterbitkan dari komponen solusi yang dapat diterbitkan yang sedang diperbarui. Setelah Anda menerbitkan komponen solusi, komponen tersebut menjadi dependensi yang diterbitkan.

Dependensi internal solusi adalah dependensi bila tindakan dengan komponen solusi memerlukan tindakan untuk komponen solusi lainnya. Misalnya, jika Anda menghapus tabel, Anda mengharapkan bahwa semua atribut tabel dihapus dengan tabel tersebut. Sistem juga menghapus hubungan tabel apa pun dengan tabel lain.

Namun, ketergantungan internal dapat menyebabkan ketergantungan yang dipublikasikan dan masih memerlukan intervensi manual. Misalnya, jika Anda menyertakan bidang pencarian pada formulir tabel lalu menghapus tabel utama dalam hubungan, Anda tidak dapat menyelesaikan penghapusan tersebut hingga Anda menghapus kolom pencarian dari formulir tabel terkait lalu menerbitkan formulir.

Bila Anda melakukan tindakan yang terprogram dengan solusi, gunakan pesan yang terkait dengan tabel Dependency. Buka entitas dependensi untuk pesan yang dapat Anda gunakan untuk mengidentifikasi dependensi yang mungkin ada sebelum Anda menghapus komponen atau menghapus instalan solusi.

Komponen solusi umum

Komponen solusi ini muncul di aplikasi. Anda bekerja dengan mereka secara langsung saat menambahkan atau menghapus komponen solusi melalui halaman solusi. Masing-masing jenis komponen solusi lainnya bergantung pada satu atau beberapa komponen solusi ini.

Pita aplikasi
Entitas
Laporan
Template artikel
Profil keamanan kolom
Langkah pemrosesan pesan SDK
Peran koneksi
Templat gabungan surat
Peran keamanan
Template kontrak
Set opsi
Titik akhir layanan
Dasbor atau formulir entitas
Perakitan plug-in
Peta situs
Template email
Proses
Sumber daya web

Ribbon aplikasi (RibbonCustomization)

Kustomisasi Ribbon untuk Ribbon aplikasi dan template Ribbon tabel. Ribbon aplikasi tidak menyertakan definisi ribbon di tingkat tabel atau formulir.

Pita aplikasi kustom sering telah memublikasikan dependensi pada sumber daya web. Gunakan sumber daya web digunakan untuk mendefinisikan ikon tombol pita dan fungsi JavaScript yang mengontrol kapan elemen pita ditampilkan atau tindakan apa yang dilakukan saat kontrol pita tertentu digunakan. Dependensi hanya dibuat ketika definisi ribbon menggunakan direktif $webresource: untuk mengaitkan sumber daya web dengan ribbon. Untuk informasi selengkapnya, lihat $webresource direktif.

Template Artikel (KBArticleTemplate)

Template yang berisi atribut standar artikel. Selalu ada ketergantungan internal antara templat artikel dan tabel KbArticle.

Peran koneksi (ConnectionRole)

Peran yang menjelaskan relasi antara dua data. Setiap peran koneksi menentukan jenis catatan entitas yang dapat ditautkan menggunakan peran koneksi tersebut. Peran ini membuat ketergantungan yang dipublikasikan antara peran koneksi dan tabel.

template kontrak (ContractTemplate)

Template yang berisi atribut standar kontrak. Selalu ada dependensi internal antara templat kontrak dan tabel kontrak.

Dasbor atau formulir entitas (SystemForm)

Gunakan rekaman tabel formulir sistem digunakan untuk menentukan dasbor dan formulir tabel. Saat Anda menggunakan SystemForm sebagai formulir tabel, ada dependensi internal terhadap tabel. Saat Anda menggunakan SystemForm sebagai dasbor, tidak ada dependensi internal. Baik formulir tabel maupun dasbor umumnya memiliki dependensi yang diterbitkan terkait dengan kontennya. Formulir tabel mungkin memiliki kolom lookup yang bergantung pada hubungan tabel. Dashboard dan formulir tabel dapat berisi bagan atau subgrid yang membuat dependensi yang dipublikasikan pada tampilan, yang kemudian memiliki dependensi internal pada tabel. Dependensi yang dipublikasikan pada sumber daya web dapat dibuat karena konten yang ditampilkan di dalam dasbor atau formulir, atau ketika formulir berisi pustaka JavaScript. Formulir tabel memiliki dependensi yang dipublikasikan pada atribut apa pun yang ditampilkan sebagai kolom dalam formulir.

Template email (EmailTemplate)

Template yang berisi atribut standar pesan email. Templat email biasanya menyertakan kolom yang menyisipkan data dari atribut tabel tertentu. Anda dapat menautkan templat email ke tabel tertentu saat membuatnya, sehingga mungkin ada dependensi internal pada tabel. Templat email global tidak terkait dengan tabel tertentu, tetapi mungkin telah menerbitkan dependensi pada atribut tabel yang digunakan untuk menyediakan data. Proses (alur kerja) sering dikonfigurasi untuk mengirim email menggunakan template email yang membuat dependensi yang dipublikasikan dengan alur kerja.

Entitas (Entity)

Tabel, sebelumnya dikenal sebagai entitas, adalah struktur utama yang digunakan untuk memodelkan dan mengelola data Dataverse. Karena dependensi internal di antaranya, saat Anda menghapus tabel, Anda juga menghapus bagan, formulir, hubungan tabel, tampilan, dan atribut yang terkait dengan tabel tersebut. Tabel sering kali memiliki dependensi yang dipublikasikan dengan proses, dasbor, dan templat email.

Profil keamanan kolom (FieldSecurityProfile)

Profil yang mendefinisikan tingkat akses untuk atribut yang diamankan.

Template gabungan surat (MailMergeTemplate)

Template yang berisi atribut standar dokumen penggabungan email. Templat gabungan surat memiliki dependensi yang diterbitkan pada tabel yang terkait dengannya.

Rangkaian pilihan (OptionSet)

Kolom pilihan, sebelumnya dikenal sebagai kumpulan opsi, mendefinisikan sekumpulan opsi. Atribut daftar pilihan menggunakan pilihan untuk menentukan opsi yang disediakan. Beberapa atribut daftar pilihan mungkin menggunakan pilihan global sehingga opsi yang mereka berikan selalu sama dan dapat dipertahankan di satu tempat. Dependensi yang dipublikasikan terjadi ketika atribut daftar pilihan mereferensikan pilihan global. Anda tidak dapat menghapus pilihan global yang digunakan oleh atribut daftar pilihan.

assembly plug-in (PluginAssembly)

Asembli yang berisi satu atau beberapa jenis plug-in. Plug-in didaftarkan ke aktivitas yang biasanya terkait dengan tabel. Pendaftaran ini membuat dependensi yang dipublikasikan.

Proses (Workflow)

Seperangkat aturan logika yang mendefinisikan langkah-langkah yang diperlukan untuk mengotomatisasi proses bisnis, tugas, atau rangkaian tindakan spesifik yang akan dilakukan. Proses menyediakan berbagai tindakan yang membuat dependensi yang dipublikasikan pada komponen solusi lainnya yang dirujuk oleh proses. Setiap proses juga memiliki dependensi yang dipublikasikan pada tabel yang terkait dengannya.

Laporan (Laporan)

Ringkasan data dalam tata letak yang mudah dibaca. Sebuah laporan memiliki dependensi yang dipublikasikan pada tabel atau data atribut yang tercakup dalam laporan itu. Setiap laporan juga harus dikaitkan dengan kategori laporan, yang membuat ketergantungan internal pada komponen solusi yang disebut Kategori Terkait Laporan (ReportCategory). Anda dapat mengonfigurasi laporan untuk menjadi sublaporan, yang membuat dependensi yang dipublikasikan dengan laporan induk.

Langkah pemrosesan pesan SDK (SDKMessageProcessingStep)

Tahap dalam alur eksekusi tempat plug-in akan dijalankan.

Peran keamanan (Role)

Pengelompokan hak istimewa keamanan. Tetapkan peran keamanan kepada pengguna untuk mengotorisasi akses mereka ke sistem Dataverse. Kaitkan formulir tabel dengan peran keamanan tertentu untuk mengontrol siapa yang dapat melihat formulir. Asosiasi ini membuat dependensi yang diterbitkan antara peran keamanan dan formulir.

Catatan

Anda hanya dapat menambahkan peran keamanan dari unit bisnis lingkungan ke solusi. Hanya pengguna dengan akses baca ke peran keamanan tersebut yang dapat menambahkannya ke solusi.

Endpoint layanan (ServiceEndpoint)

Endpoint layanan yang dapat Anda hubungi.

Peta situs (SiteMap)

Data XML yang digunakan untuk mengontrol panel navigasi aplikasi. Anda mungkin menautkan peta situs untuk menampilkan sumber daya web HTML, atau ikon di peta situs mungkin menggunakan sumber daya web gambar. Saat Anda menggunakan arahan $webresource: untuk membuat asosiasi ini, Anda membuat dependensi yang diterbitkan. Untuk informasi selengkapnya, lihat $webresource direktif.

Sumber daya web (WebResource)

Data yang setara dengan file yang digunakan untuk memperluas aplikasi yang diarahkan model atau dalam pengembangan web. Sumber daya web memberikan komponen sisi klien yang digunakan untuk menyediakan elemen antarmuka pengguna kustom. Sumber daya web mungkin telah menerbitkan dependensi dengan formulir tabel, pita, dan peta situs. Saat Anda menggunakan petunjuk $webresource: untuk membuat asosiasi dalam pita atau peta situs, Anda membuat dependensi yang dipublikasikan. Untuk informasi selengkapnya, lihat $webresource direktif.