Kendi widget’larınız

Yerleşik widget’ların yanı sıra kuruluşunuz kendi widget’larını da tutabilir. En basit yol, yapılandırdığınız bir kartı widget olarak kaydetmektir. Yöneticiler ayrıca bir HTML şablonundan, kendi ayar formu ve veri yuvalarıyla widget’lar oluşturabilir ve bunların sürümlerini yayımlayabilir. Widget’lar widget kütüphanesinde bulunur.

Widget kütüphanesi

Menüde (Configuration altında) Widgets öğesini açın. “Bir panoya yerleştirilebilen her şey.”

Raf	İçerik
Sistem	Yerleşik widget’lar ve modüllerin eklediği widget’lar (“Modüller etkinleştirildikçe widget katkısı sağlar.”)
Kiracı	Tüm kuruluşla paylaşılan widget’lar
Widget’larım	Size özel widget’larınız (“Oluşturduğunuz widget’lar bu rafta görünür.”)
Favoriler	Herhangi bir raftan yıldızladığınız widget’lar

Tabloda Ad, Kategori ve Kullanan (kaç kartın kullandığı) gösterilir; ayrıca Tür filtresi vardır: Yerleşik, HTML şablonu, Eklenti çerçevesi. Düzenle, değiştirmenize izin verilen bir widget’ı açar.

Kim	Yapabilir
Her üye (Kendi özel widget’larınızı oluşturun ve düzenleyin)	Kendileri için özel widget’lar oluşturabilir
Yöneticiler (Widget oluşturma ve düzenleme, Widget sürümlerini yayımlama)	Herkes için widget oluşturabilir, düzenleyebilir ve yayımlayabilir

Planınız, kuruluşunuzun sahip olabileceği paylaşılan özel widget sayısını belirler. Her üyenin özel widget’ları aynı sınır altında kendi kotasından düşer; dolayısıyla özel widget’lar paylaşılan olanların hakkını tüketmez.

Bir kartı widget olarak kaydetme

Bir panodaki kartı istediğiniz gibi yapılandırın.
Kartın ayarlarında Save as widget… öğesini seçin (“Bu kartın mevcut ayarlarını ve verilerini kütüphanenizde yeniden kullanılabilir bir widget olarak kaydeder.”).
Widget, Widget’larım altında görünür: “Kütüphanenizde widget olarak kaydedildi.” Bunu Widget ekle > Widget’larım yolundan herhangi bir panoya yerleştirebilirsiniz.

Widget oluşturma

Widget kütüphanesinde New widget öğesini seçin.
Nasıl başlayacağınızı seçin: Hazır bir grafikten (varsayılanlarınızla yerleşik bir grafik) veya Bir HTML şablonundan.
Bir Ad ve bir Kategori girin, ardından Yalnızca ben veya Herkes (yalnızca yönetici) seçeneğini belirleyin.
Create öğesini seçin. Widget düzenleyicisi açılır.

Widget düzenleyicisi

Düzenleyici solda bir Canlı önizleme, sağda Ayarlar formunu gösterir. Önizleme, bir panonun kullandığı aynı sandbox çerçevesiyle çizilir; yani gördüğünüz, panoların alacağı şeydir. Sekmeler:

Sekme	İçerik
Şablon	Bir HTML şablonu widget’ının HTML’i. Yerleşik veya eklenti widget’ı için “bizim sağladığımız kodla oluşturulur, bu nedenle burada düzenlenecek bir şablon yoktur” yazar.
Şema	Ayar alanları: Key, Label, Type. “Buraya eklediğiniz her alan sağdaki panelde ve operatörün bir yerleşimde açtığı çekmecede görünür.” Bir alanı kaldırmak varsayılanını da kaldırır.
Veri	En fazla 6 veri yuvası: Slot key, Label, Shape (scalar, series, table, record), Required. “Bir yuva, widget’ın neye İHTİYAÇ duyduğunu söyler (bir scalar, bir series), asla nereden geldiğini değil.” Kaynağı her kart seçer.
Eylemler	Salt okunur: eylemler kart başına, panonun ayar çekmecesinde belirlenir.

Bunları varsayılan yap, ekrandaki ayarları widget’ın varsayılanlarına yazar.

HTML şablonu yazma

Bir ayar alanı bir token’dır: title alanı {{title}} olur.
main scalar veri yuvası {{data_main}} olur. Daha zengin şekiller, şablonun kendi betiği için window.WIDGET_DATA.<slot> içindedir.
Bir şeyi tıklanabilir yapmak için window.widgetAction() çağırın veya bir öğeye data-widget-action verin. Kart daha sonra panonun yapılandırdığı eylemleri çalıştırır; şablon hiçbir zaman bir hedef belirtmez.

<div style="font: 600 32px system-ui">{{data_main}} {{unit}}</div>
<div style="color: #666">{{caption}}</div>
<button data-widget-action>Details</button>

Şablon, Hermetry’ye, oturumunuza veya diğer kartlara erişimi olmayan bir çerçevede, kendi içerik güvenlik politikası altında çalışır. Şablon widget’ları ekran panolarında gösterilir.

Taslaklar, sürümler ve yayımlama

Bir widget’ın durumu şunlardan biridir: Taslak, Yayımlandı veya Arşivlendi. Düzenlemeleriniz taslağa gider ve yazarken kaydedilir (ayrıca Ctrl+S); üst bilgide önce “kaydedilmedi…”, sonra Kaydedildi yazar. Düzenlerken geri al ve yinele (Ctrl+Z, Ctrl+Shift+Z) çalışır. Panolar yalnızca yayımlanmış sürümleri görür, dolayısıyla bir taslak hiçbir panoyu değiştirmez.

Eylem	Etki
Yayımla	Taslağı yeni bir sürüm yapar (Taslak veya Yayımlandı durumundan). Panolardaki kartlar onu izler.
Yayından kaldır	Yayımlanmış bir widget’ı tekrar Taslak durumuna getirir.
Arşivle	Bir taslak veya yayımlanmış widget’ı kullanımdan kaldırır (Arşivlendi).
Geri yükle	Arşivlenmiş bir widget’ı Taslak olarak geri getirir.

Düzenleyici yalnızca widget’ın durumunun izin verdiği geçişleri sunar.

Bir yayımlama, kartların zaten kullandığı ayarları değiştirdiğinde Son yayımdan bu yana ayar değişiklikleri iletişim kutusu bunları listeler: yeniden adlandırılan, kaldırılan, türü değişen, daraltılan veya kullanımdan kaldırılan alanlar. Yeni bir alan kaldırılanın yerini alıyorsa bu belirtilir (“caption artık …”) ve değerler ona taşınır. Panolardaki kartlar eski varsayılanları korur açıkken mevcut kartlar şimdiki görünümlerini korur; kapalıyken hiç değer ayarlamamış kartlar yeni varsayılanı izler.

İki kişi aynı widget’ı düzenlerse ikinci kayıt, ilkinin üzerine sessizce yazmak yerine reddedilir.

Sistem widget’ları

Sistem widget’ı platformla birlikte gelir. Birini düzenlemek “Bu bir sistem widget’ıdır. Platformla birlikte gelir, bu nedenle buradaki düzenlemeler bir yükseltmenin koruyacağı şeyler değildir.” mesajını gösterir. Kendi paylaşılan widget’ınız, bir platform widget’ının tür adını alamaz.

Widget’ları taşıma

Bir pano dosyası, kartlarının kullandığı widget’ların adlarını belirtir ancak tanımlarını taşımaz. Kendi widget’larınızı kullanan bir panoyu başka bir kuruluşa içe aktarmadan önce bu widget’ları orada yeniden oluşturun. Bkz. Pano şablonları ve pano dosyaları.