Opsi ekstensi adalah item konfigurasi yang ditentukan pengembang untuk suatu ekstensi. Pengguna dapat mengonfigurasi opsi tersebut untuk menyesuaikan perilaku ekstensi di ruang kerja yang berbeda. Misalnya, pengembang dapat membuat opsi yang memungkinkan pengguna mengatur panjang maksimum Pernyataan SQL, sehingga batas panjang yang berbeda dapat diterapkan di ruang kerja yang berbeda.
Informasi latar belakang
Pengembang menentukan opsi ekstensi saat pendaftaran. Pengguna kemudian dapat mengatur opsi tersebut untuk ekstensi dalam ruang kerja tertentu.
Untuk informasi selengkapnya tentang cara mendaftarkan ekstensi, lihat Mengembangkan dan menerapkan ekstensi: Layanan mandiri.
Sebelum mengaktifkan ekstensi di ruang kerja, pengguna dapat mengonfigurasi opsinya seperti yang ditunjukkan pada gambar berikut.
Pengembang dapat memanggil API GetOptionValueForProject untuk mengambil konfigurasi opsi yang ditetapkan oleh pengguna, seperti administrator ruang kerja, di ruang kerja tertentu.
Catatan penggunaan
Pengembang ekstensi menyediakan konfigurasi opsi dan teks terkait. Platform tidak bertanggung jawab atas ancaman keamanan apa pun yang ditimbulkan oleh konten tersebut.
Komponen yang didukung
Konfigurasi opsi mendukung tujuh jenis komponen: teks, kotak input satu baris, kotak input multi-baris, daftar tarik-turun pilihan tunggal, daftar tarik-turun pilihan ganda, kelompok kotak centang, dan kelompok tombol radio. Gambar berikut menunjukkan komponen-komponen tersebut.
Konfigurasi opsi
Saat mendaftarkan ekstensi, pengembang harus menentukan opsi sebagai string JSON di bidang Option Configuration.
{
"type": "object",
"properties": {
"Component name (must be unique)": {
"type": "string",
"title": "See the table below",
"x-decorator": "See the Parameter parsing table",
"x-component": "See the Parameter parsing table",
"x-decorator-props": {
"tooltip": "Description"
},
"x-component-props": {
"dataSource": "See the Parameter parsing table",
"mode": "multiple"
}
}
}
}Lihat sumber daya berikut untuk konfigurasi:
Untuk informasi selengkapnya tentang parameter komponen, lihat Penguraian parameter.
Untuk contoh konfigurasi, lihat Contoh konfigurasi: Menetapkan ambang batas sumber daya CU untuk tugas SQL dan Contoh konfigurasi: Menggunakan tujuh jenis komponen.
Untuk informasi selengkapnya tentang mendaftarkan dan mengelola ekstensi, lihat Mengembangkan dan menerapkan ekstensi: Layanan mandiri.
Penguraian Parameter
Bidang | Jenis Komponen | Nilai |
title | Teks | Teks |
Kotak input satu baris | Kotak input satu baris | |
Kotak input multi-baris | Kotak input multi-baris | |
Daftar tarik-turun pilihan tunggal | Daftar tarik-turun pilihan tunggal | |
Daftar tarik-turun pilihan ganda | Daftar tarik-turun pilihan ganda | |
Kelompok kotak centang | Kelompok kotak centang | |
Kelompok tombol radio | Pilihan tunggal | |
x-decorator | Teks | FormItem |
Kotak input satu baris | FormItem | |
Kotak input multi-baris | FormItem | |
Daftar tarik-turun pilihan tunggal | FormItem | |
Daftar tarik-turun pilihan ganda | FormItem | |
Kelompok kotak centang | FormItem | |
Kelompok tombol radio | FormItem | |
x-component | Teks | PreviewText.Input |
Kotak input satu baris | Input | |
Kotak input multi-baris | Input.TextArea | |
Daftar tarik-turun pilihan tunggal | Select | |
Daftar tarik-turun pilihan ganda | Select | |
Pilihan ganda | Checkbox.Group | |
Pilihan tunggal | Radio.Group | |
dataSource | Teks | Opsional |
Kotak input satu baris | Opsional | |
Kotak input multi-baris | Opsional | |
Daftar tarik-turun pilihan tunggal | Opsional. Konfigurasikan sesuai kebutuhan. Setiap objek dalam larik merupakan opsi unik. Nilai dan label tidak boleh duplikat. Label menentukan teks yang ditampilkan di UI. Nilai menentukan pengenal untuk teks tersebut, yang dapat Anda definisikan sendiri. Berikut ini contoh kodenya: | |
Daftar tarik-turun pilihan ganda | Opsional. Konfigurasikan sesuai kebutuhan. Setiap objek dalam larik merupakan opsi unik. Nilai dan label tidak boleh duplikat. Label menentukan teks yang ditampilkan di UI. Nilai menentukan pengenal untuk teks tersebut, yang dapat Anda definisikan sendiri. Berikut ini contoh kodenya: | |
Kelompok kotak centang | Opsional. Konfigurasikan sesuai kebutuhan. Setiap objek dalam larik merupakan opsi unik. Nilai dan label tidak boleh duplikat. Label menentukan teks yang ditampilkan di UI. Nilai menentukan pengenal untuk teks tersebut, yang dapat Anda definisikan sendiri. Berikut ini contoh kodenya: | |
Pilihan tunggal | Opsional. Konfigurasikan sesuai kebutuhan. Setiap objek dalam larik merupakan opsi unik. Nilai dan label tidak boleh duplikat. Label menentukan teks yang ditampilkan di UI. Nilai menentukan pengenal untuk teks tersebut, yang dapat Anda definisikan sendiri. Berikut ini contoh kodenya: |
Contoh konfigurasi: Menetapkan ambang batas sumber daya CU untuk tugas SQL
Gambar berikut menunjukkan contoh cara mengonfigurasi ambang batas konsumsi CU untuk tugas SQL, beserta hasilnya.
Kode berikut menunjukkan konfigurasi JSON untuk opsi tersebut.
{
"type": "object",
"properties": {
"cuNumber": {
"type": "string",
"title": "Ambang Batas CU",
"x-decorator": "FormItem",
"x-component": "Input",
"x-decorator-props": {
"tooltip": "Masukkan ambang batas konsumsi CU untuk tugas SQL."
}
}
}
}Contoh konfigurasi: Menggunakan tujuh jenis komponen
Gambar berikut menunjukkan contoh proses konfigurasi dan hasil penggunaan ketujuh jenis komponen tersebut.
Kode berikut menunjukkan konfigurasi JSON untuk opsi tersebut.
Untuk menggunakan ketujuh komponen sekaligus, Anda dapat menyalin JSON berikut dan memodifikasi datanya sesuai kebutuhan.
{
"type":"object",
"properties":{
"text":{
"type":"string",
"title":"Teks",
"x-decorator":"FormItem",
"x-component":"PreviewText.Input",
"x-decorator-props":{
"tooltip":"File deskripsi"
},
"default":"Ini adalah informasi teks"
},
"input":{
"type":"string",
"title":"Kotak input satu baris",
"x-decorator":"FormItem",
"x-component":"Input",
"x-decorator-props":{
"tooltip":"File deskripsi"
},
"x-component-props":{
},
"default":"Ini adalah nilai default"
},
"textarea":{
"type":"string",
"title":"Kotak input multi-baris",
"x-decorator":"FormItem",
"x-component":"Input.TextArea",
"x-decorator-props":{
"tooltip":"File deskripsi"
},
"x-component-props":{
},
"default":"Ini adalah nilai default"
},
"select":{
"type":"string",
"title":"Daftar tarik-turun pilihan tunggal",
"x-decorator":"FormItem",
"x-component":"Select",
"x-decorator-props":{
"tooltip":"File deskripsi"
},
"x-component-props":{
"dataSource":[
{
"value":"10001",
"label":"opt1"
},
{
"value":10002,
"label":"opt2"
},
{
"value":10003,
"label":"opt3",
"disabled":true
}
]
},
"default":"10001"
},
"selectmore":{
"type":"string",
"title":"Daftar tarik-turun pilihan ganda",
"x-decorator":"FormItem",
"x-component":"Select",
"x-decorator-props":{
"tooltip":"File deskripsi"
},
"x-component-props":{
"dataSource":[
{
"value":"10001",
"label":"opt1"
},
{
"value":10002,
"label":"opt2"
},
{
"value":10003,
"label":"opt3",
"disabled":true
}
],
"mode":"multiple"
},
"default":["10001","10002"]
},
"checkbox":{
"type":"array",
"title":"Kelompok kotak centang",
"x-decorator":"FormItem",
"x-component":"Checkbox.Group",
"x-decorator-props":{
"tooltip":"File deskripsi"
},
"x-component-props":{
"dataSource":[
{
"value":"10001",
"label":"opt1"
},
{
"value":10002,
"label":"opt2"
},
{
"value":10003,
"label":"opt3",
"disabled":true
}
],
"mode":"multiple"
},
"default":["10001","10002"]
},
"radio":{
"type":"number",
"title":"Kelompok tombol radio",
"x-decorator":"FormItem",
"x-component":"Radio.Group",
"x-decorator-props":{
"tooltip":"File deskripsi"
},
"x-component-props":{
"dataSource":[
{
"value":"10001",
"label":"opt1"
},
{
"value":10002,
"label":"opt2"
},
{
"value":10003,
"label":"opt3",
"disabled":true
}
],
"mode":"multiple"
},
"default":"10001"
}
}
}Untuk informasi selengkapnya, lihat Praktik terbaik: (Fitur lanjutan) Melarang penggunaan fungsi MAX_PT.