Alan anahtarları olmasaydı, bir otomasyonun sorularınızı kimse için bir anlam ifade etmeyen dahili kimliklerle adreslemesi gerekirdi — ve bir webhook gövdesi bunlarla dolu gelirdi. Alan anahtarlarıyla her iki taraf da aynı şekilde okur:
``` { "company_name": "Acme", "employees": 120, "contacts": [{ "name": "Ada" }] } ```
Alan anahtarları iki yerde kullanılır: bir istek oluşturulurken prefill, context ve readonly; ve
her geri çağırmadaki ve her webhook gövdesindeki answers ve display haritaları.
Formun yayınladığı her anahtar tek bir yerde yaşar, Anahtarlar tablosunda: her alan, bir seçim sorusunun altında her
seçenek, bir matrisin altında her satır ve sütun. Tablo, geri çağırmanızın taşıyacağı answers nesnesinin, sizin
anahtarlarınızla dolu bir önizlemesiyle sona erer.
Her seçeneğin ipucu satırı — düzenlediğiniz seçeneğin altındaki gri satır — anahtarını bir chip olarak sonlandırır. Anahtarı yerinde düzenlemek için chip'e tıklayın, bitirince Enter veya Escape tuşuna basın. Bir matris, etiketini düzenlediğiniz satır veya sütun için chip'i gösterir. Form yayındaysa ve yazdığınız anahtar otomasyonların zaten kullandığı anahtarı taşıyacaksa chip turuncuya döner.
Aynı tablo, bir entegrasyon bağlarken salt okunur olarak görünür: webhook'un alan eşlemesinin altında ve Paylaş panelinin İstekler
kartındaki istek parçacıklarının altında. Tüm anahtarları aynı anda fields.list ile de okuyabilirsiniz.
Hiçbir şey ayarlamanız gerekmez. Siz düzenleyene kadar bir anahtar, sorunun başlığından türetilir: aksanlar kaldırılır ve ø, æ, ß gibi harfler o, ae ve ss olur, her şey küçük harfe çevrilir, harf veya rakam olmayan her ardışık dizi tek bir alt çizgiye dönüşür, baştaki ve sondaki alt çizgiler kaldırılır ve sonuç 64 karaktere kısaltılır.
Yalnızca Arapça, İbranice, Kiril, Yunanca, Çince veya Japonca gibi Latin dışı bir yazıyla yazılmış bir başlıkta kaldırılacak bir şey
olmaz; bu yüzden anahtarı field_ artı konumudur, bir seçeneğinki ise option_ artı konumudur. Bu anahtarlar
yayınlandıktan sonra diğerleri kadar kararlıdır, ancak soru hakkında hiçbir şey söylemez. Bir otomasyon yanıtları okuyorsa, Anahtarlar
tablosunda okunaklı bir anahtarı kendiniz ayarlayın.
İki alan aynı anahtarla sonuçlanacaksa, Formstep _2, _3 gibi ekler ekleyerek belge sırasına göre çakışmayı
çözer. Kendi belirlediğiniz bir anahtar her zaman iddiasını kazanır, türetilen anahtar geri çekilir.
Türetilen anahtarın yerine geçmesi için Alan anahtarı girişine bir ad yazın. Girişi temizlemek türetilen anahtara geri döner. İzin verilen
karakterler harfler, rakamlar, _, . ve -’dir, en fazla 64 karakter — başka her şey{' '}
"Sadece harf, rakam ve _ . - kullanın (en fazla 64 karakter)." ile reddedilir. Siz yazarken boşluklar alt çizgiye dönüştürülür,
böylece "contact name" contact_name olur.
Anahtarlar büyük/küçük harfe duyarlıdır ve bir form içinde benzersiz olmalıdır. Başka bir soru, tekrarlayan grup, gizli alan veya hesaplanan alan tarafından zaten kullanılan bir anahtarı yeniden kullanmak "Bu anahtarı başka bir alan zaten kullanıyor." ile reddedilir.
> Yayınlanmış bir formda Alan anahtarı girişi, formun yayında olduğu ve geçerli anahtarı kullanan otomasyonların bozulacağı konusunda sizi > uyarır. Hiçbir şey sizi durdurmaz, ama o anahtarı önceden dolduran veya okuyan her workflow, değişikliği yayınladığınız anda eşleşmeyi > bırakır. Otomasyonu aynı oturumda güncelleyin. Yayın, değişiklik yürürlüğe girmeden önce sizi yeniden uyarır (bkz.{' '} > kaldırılacak anahtarlar bölümü). >
İlk yayınladığınızda, her alanın anahtarı o yayınlanmış sürüme yazılır. Sonraki her yayın aynı anahtarları taşır, bunun anlamı şudur:
company_name olarak kalır. Otomasyonlarınız çalışmaya devam eder; yalnızca sayfadaki kelimeler değişir.
_2’ye yeniden anahtarlanır; türetilen anahtarlar yayında benzersiz hale getirilir.
Yinelenenlerin yakalandığı yer de yayındır ve ikisi de bir alanı sessizce yeniden adlandırmak yerine yayını durdurur:
İkisi de Yayınla düğmesinin yanında, diğer her ön kontrol bulgusuyla birlikte görünür — bkz.{' '} Yayın kontrolleri.
Bir anahtar, yayınlandığı alana aittir, başlığına değil. Bu yüzden istemeden bir anahtarı kaybetmenin iki yolu vardır: yayınlanmış bir alana farklı bir anahtar yazmak, ya da bir soruyu silip yerine yeni bir tane eklemek. Yeni soru yeni bir alandır — kendi başlığından türetilmiş yepyeni bir anahtar alır ve eski anahtar yok olur.
Bu gerçekleştiğinde Formstep tarafında hiçbir şey başarısız olmaz. Webhook yine tetiklenir ve geri çağırma yine gelir, yalnızca o yanıt
olmadan; ve requests.create, eski anahtarı UNKNOWN_FIELD_KEY ile reddetmeye başlar. Bu yüzden yayın önce bunu
kontrol eder. Canlı sürümün yayınladığı bir anahtar bir sonraki sürümde bulunmayacaksa, yayın iletişim kutusu ve Yayınla düğmesinin
yanındaki sorun göstergesi bir uyarı gösterir:
form_publish’i
üzerinden yayınlamak aynı mesajları warnings içinde döndürür.
Bir tekrarlayan grubun kendi anahtarı vardır, içindeki her alanın da öyle. Otomasyonlar grubu bir bütün olarak adresler ve üyeleri iç içe yerleştirir:
``` { "contacts": [{ "name": "Ada", "email": "ada@acme.com" }, { "name": "Grace", "email": "grace@acme.com" }] } ```
Bir grubun içindeki bir alana yalnızca kendi grubu üzerinden ulaşılabilir — burada üst düzeyde bir name yoktur, yalnızca{' '}
contacts[0].name vardır. Grubun anahtarını yeniden adlandırırsanız tüm dizi taşınır; bir üyenin anahtarını yeniden
adlandırırsanız yalnızca her nesnenin içindeki o ad değişir.
Bir gizli alanın parametre adı, onun alan anahtarıdır. Bir istek oluştururken{' '}
context içine koyduğunuz anahtar budur ve genel bir bağlantıda bir URL parametresinde kullanacağınız isimle aynıdır.
Bir hesaplanan alanın adı onun alan anahtarıdır ve formun geri kalanıyla paylaştığı tek
anahtar kümesinin bir parçasıdır. Salt okunurdur: formun kendisi değerini hesaplar, bu yüzden siz asla bir değer gönderemezsiniz —{' '}
fields.list onu calculated: true ile listeler ve requests.create, prefill ve{' '}
context içinde onu reddeder. Ama geri okuyabilirsiniz: answers içinde kendi adı altında (
answers.total) gelir. Yayınlanmış bir hesaplanan alanı yeniden adlandırmak, diğer her alanla aynı yayın uyarısıyla, onun
anahtarını da yeniden adlandırır.
Bir yanıtın adlandırdığı sorunun parçaları da anahtar alır. Bir radyo, açılır liste, onay kutusu, görsel seçim veya sıralama sorusunun her seçeneği, ve bir matrisin her satırı ve sütunu, bir seçenek anahtarına sahiptir: bir alan anahtarının bir başlıktan türetildiği şekilde etiketinden türetilir, düzenlenebilir ve yayında donar. Böylece bir yanıt her iki tarafta da bir ad olarak okunur:
``` { "plan": "pro", "interests": ["billing", "api"], "satisfaction": { "delivery_speed": "very_good" } } ```
Bir workflow, yanıtlayan hangi dilde yanıt verirse versin answers.plan == "pro" üzerinde dallanır ve bir istek bir seçimi{' '}
{'{ "plan": "pro" }'} ile önceden doldurur. Anahtarlar, her alanın options'ı altında ya da bir matrisin{' '}
rows ve columns'ı altında fields.list tarafından listelenir ve{' '}
Anahtarlar tablosunda ya da seçeneğin chip'inde düzenlenir. Her sorunun seçenekleri kendi ad alanına sahiptir, bu
yüzden iki soru aynı anda bir yes'e sahip olabilir ve bir matrisin bir satırı ile bir sütunu aynı anahtarı paylaşabilir. Aynı
anahtarı türetecek bir sorunun iki seçeneği, alanlarda olduğu gibi _2 ile birbirinden ayrılır.
Karar sorusu, üç seçeneği approve, decline ve{' '}
changes anahtarlarını taşıyan sıradan bir radyo sorusudur; bir isteğin outcome'unu kapalı bir küme yapan da
budur.