Kami sangat gembira dapat mengumumkan perubahan dan pembaharuan terbaru pada peringatan – pesan kini mendukung variabel. Anda dapat menggunakan harga, nilai indikator, waktu bar dan lain-lain sebagai variabelnya. Anda akan dapat melihat perubahan terbaru saat sebuah peringatan terpicu dan notifikasinya dikirimkan.
Penempatan khusus bagi variabel perlu untuk digunakan sehingga nilai yang terbaru lah yang digunakan. Ini dispesifikasikan pada dialog saat peringatan dibuat dan dimodifikasi, dalam bagian pesan yang mana dalam bagiannya mencakup nilai yang berkoresponden dengannya saat peringatan tersebut terpicu.
Sebagai contoh, anda dapat membuat sebuah peringatan bagi simbol ticker NASDAQ:AAPL dan memasukkan variabel berikut didalam pesannya:
{{exchange}}:{{ticker}}, Price = {{close}}, Volume = {{volume}}
Saat peringatan tersebut terpicu maka anda akan dapat melihat nilai-nilai tersebut sebagai ganti dari placeholder yang ditampilkan sebelumnya.
Berikut adalah daftar dari placeholder yang tersedia.
- {{ticker}} — menampilkan ticker (seperti AAPL atau BTCUSD).
- {{exchange}} — bursa dari simbolnya (seperti NASDAQ, NYSE atau AMEX). Data tertunda akan mencakup sebuah parameter DL atau DLY, cth. NYMEX_DL.
- {{close}}, {{open}}, {{high}}, {{low}}, {{time}}, {{volume}} — nilai yang berkoresponden dengan bar saat peringatannya terpicu. Peringatan untuk indikator, objek gambar dan tipe chart eksotis akan bergantung pada kerangka waktunya, sementara peringatan untuk harga akan selalu dikalkulasikan berdasarkan kerangka waktu 1-menit. {{time}} adalah waktu bar dalam UTC dengan format yyyy-MM-ddTHH: mm: ssZ. Contohnya, 2019-08-27T09: 56: 00Z. Nilay lainnya adalah angka-angka desimal tetap. Contohnya, 1245.25.
- {{timenow}} — waktu persis saat peringatan terpicu. Memiliki format yang sama dengan waktu bar {{time}}. Memiliki akurasi hingga hitungan detik tanpa dipengaruhi oleh kerangka waktunya.
- {{plot_0}}, {{plot_1}}, … {{plot_19}} — seri yang berkoresponden dari sebuah indikator yang digunakan untuk meletakkan peringatannya. Seri indikator adalah nilai yang anda lihat pada chart. Sebagai contoh, indikator Volume bawaan memiliki dua seri – Volume dan rata-rata Volume. Anda dapat membuat sebuah peringatan pada indikatornya dan memasukkan variabel berikut didalam pesannya:
Volume: {{plot_0}}, Volume average: {{plot_1}}
Anda akan melihat nilai-nilai yang berkoresponden dengannya saat peringatan tersebut terpicu.
Catatan: plot diurutkan dimulai dari nol.
Ketentuan tersebut berlaku pada skrip yang ditulis menggunakan Pine. Seri-Seri tersebut dihitung berdasarkan urutan pemanggilan didalam kodenya. Lihat daftar dari fungsi-fungsi dibawah ini. Seri-Serinya dapat digunakan dalam pesan notifikasi:
- plot;
- plotshape;
- plotchar;
- plotarrow;
- plotbar;
- plotcandle.
Jika argumen seri dari fungsi-fungsi tersebut mengandung nilai Boolean, 0 atau 1 akan ditukar dalam pesan notifikasinya. Harap diingat bahwa fungsi-fungsi tertentu – plotcandle dan plotbar — menampilkan 4 seri masing-masingnya dan keseluruhannya akan diperhitungkan dalam logika penomorannya.
Meski demikian, metode untuk mengakses plot ini tidak selalu praktis. Untuk mempermudahnya, kami telah menambahkan dukungan utnuk memanggil plot dengan menggunakan namanya. Untuk melakukannya, gunakan placeholder {{plot(“Name”)}}, dinama Name adalah nama dari serinya.
Untuk indikator-indikator bawaan, nama-nama yang didukung hanyalah yang digunakan dalam versi bahasa Inggris. Pada contoh indikator Volume untuk mengakses seri dengan menggunakan namanya, anda harus memasukkan variabel berikut didalam pesannya:
Volume: {{plot(“Volume”)}}, Volume average: {{plot(“Volume MA”)}}
Sama dengan sebelumnya, agar Skrip Pine dapat mengakses serinya, anda harus menspesifikasikan namanya dari judul argumen dari fungsi yang berkoresponden dengannya (mendukung seluruh fungsi-fungsi plot terkecuali plotcandle dan plotbar), dan bahasanya tidak lagi menjadi masalah. Jika anda tidak memiliki akses ke kodenya, namanya dapat dilihat pada pengaturan coraknya.
Sebagai contoh, untuk mengakses nilai dari skrip ini:
//@version=4
study(“My script”)
plot(close, title=”series”)
Masukkan {{plot(“series”)}} dalam pesan peringatannya.
Nama yang sama ditampilkan pada pengaturan skripnya:
Saat menggunakan beberapa indikator dalam satu peringatan, anda dapat mengacu pada nilai dari yang pertama – yang diindikasikan pada urutan pertama di daftar drop-down nya. Lihat contoh dibawah ini.
Saat sebuah peringatan mencakup pengaturan tersebut maka anda hanya dapat mengnacu pada nilai MA nya. Untuk mengakses nilai dari skrip “My script”, anda perlu untuk memilihnya pada daftar drop-down yang pertama.
Anda pun dapat menspesifikasikan placeholder baru di argumen pesan dari fungsi alertcondition. Sebagai contoh:
//@version=4
study(“My script”)
alertcondition(close>open, message=”price {{ticker}} = {{close}}”)
Pesan dari argumennya akan ditarik ke jendela pesan pada dialog pembuatan peringatan secara otomatis.
Harap dicatat bahwa saat membuat sebuah peringatan dengan sebuah kondisi dari fungsi alertcondition, substitusi nilainya hanya akan bekerja pada skrip v4 atau lebih tinggi.
Nilai dari peringatan yang terpicu dapat digunakan secara bersamaan dengan webhook dengan mengirimkan nilai-nilai variabel dari sebuah pesan ke alamat yang diinginkan. Ini dapat menciptakan berbagai kemungkinan lain bagi anda yang menggunakan fitur peringatan kami.