Tablolar
Tablolar, Arketic içindeki kendi yapılandırılmış veri deponuzdur — iş akışlarının ve yapay zekâ ajanlarının okuyup yazabildiği, basit ve türü belirli tablolar.
Bir iş akışının çalıştırmalar arasında bir şeyi hatırlaması gerektiğinde tablo kullanın: bir formdan toplanan potansiyel müşteriler, incelemeyi bekleyen talepler, sonra bakacağınız bir durum bilgisi ya da ajanınızın arayabilmesi gereken bir liste. Her tablonun adlandırılmış sütunları vardır, her sütunun bir türü vardır ve her değer kaydedilmeden önce bu türe göre denetlenir.
Tablolar nerede
İş Akışları → Tablolar'ı açın.
Ekran ikiye ayrılır:
| Alan | Ne gösterir |
|---|---|
| Sol şerit | Tablolarınızın listesi ve her birinin satır sayısı |
| Ana alan | Seçili tablonun veri ızgarası — sütunları ve satırları |
Bir tabloyu açmak için sol şeritten üzerine tıklayın. Siz bir seçim yapmadan önce ana alanda yalnızca Bir tablo seçin — ya da başlamak için bir tane oluşturun yazar.
Aktif ve arşiv
Listenin üstünde iki küçük sekme bulunur: Aktif ve Arşiv.
- Aktif — iş akışlarınızın günlük olarak kullandığı tablolar. Yeni düğmesi yalnızca burada bulunur.
- Arşiv — kaldırdığınız tablolar. Satırları korunur, ancak tablo salt okunurdur.
İkisi arasında geçiş yapmak seçili tablonuzu temizler; böylece yeni görünüme her zaman sıfırdan başlarsınız.
Bir görünüm boşsa Henüz tablo yok (Aktif) veya Arşivlenmiş tablo yok (Arşiv) yazısını görürsünüz.
Tablo bulma
Bir görünümde beşten fazla tablo olduğunda listenin üstünde bir arama kutusu belirir (Tablolarda ara...). Listeyi daraltmak için adın bir kısmını yazın. Uyan bir şey yoksa “…” ile eşleşen tablo yok. yazısını görürsünüz — tüm listeye dönmek için kutuyu temizleyin.
Tablo oluşturma
- Aktif sekmesinde olduğunuzdan emin olun.
- Yeni'ye tıklayın. Ana alanda Yeni tablo formu açılır.
- Bir Ad yazın (örneğin
leads). - Sütunlar'ı tanımlayın.
- Tablo oluştur'a tıklayın.
Adlandırma kuralları
Tablo ve sütun adları aynı kurala uyar:
- Bir harf veya alt çizgi ile başlamalı
- Yalnızca harf, rakam ve alt çizgi içermeli — boşluk, tire veya noktalama işareti olmaz
- En fazla 50 karakter olmalı
Ad kurala uymuyorsa form nedenini söyler ve Tablo oluştur devre dışı kalır:
Ad bir harf veya alt çizgiyle başlamalı ve yalnızca harf, rakam ve alt çizgi içermeli.
Tabloları içerdikleri kayıt türüne göre adlandırın — leads, tickets, invoices. Bir iş akışı bloğunu tabloya yönlendirirken tabloyu adıyla seçersiniz; net adlar iş akışlarını çok daha okunur kılar.
Sütunlar
Her yeni tablo title adlı tek bir sütunla başlar (türü string, zorunlu). Daha fazlasını + Sütun ekle ile ekleyin.
Her sütun satırı üç parçadan oluşur:
| Parça | Ne yapar |
|---|---|
| Ad | Sütun adı (yer tutucu sutun_adi). Tabloyla aynı adlandırma kuralı geçerlidir. |
| Tür | Bir açılır liste — aşağıdaki türlere bakın. |
| Sil (çöp kutusu simgesi) | Sütunu kaldırır. Yalnızca bir sütun kaldığında devre dışıdır — bir tabloda her zaman en az bir sütun olmalıdır. |
Bir tabloda en fazla 50 sütun olabilir. Bir sütun adı eksikse veya kurala uymuyorsa ya da iki sütun aynı adı taşıyorsa form bunu size söyler:
Her sütunun geçerli bir adı olmalı (harf, rakam, alt çizgi; rakamla başlamamalı).
Sütun adları benzersiz olmalı.
Sütun türleri
| Tür | Ne için kullanılır | Bir değer şu durumda kabul edilir… |
|---|---|---|
| string | Metin — adlar, notlar, durumlar, kimlikler | Her şey |
| number | Tutarlar, puanlar, sayımlar | Bir sayıysa |
| boolean | Evet/hayır işaretleri | true veya false ise |
| date | Tarihler ve zaman damgaları | Tanınabilir bir tarihse, örn. 2026-07-23 |
| json | Yapılandırılmış veri — bir nesne, bir liste, iç içe alanlar | Geçerli bir JSON ise |
Türler süs değildir. Bir değer her yazıldığında — ızgaradan, bir iş akışı bloğundan veya bir ajandan — zorunlu olarak uygulanır. Doğru türü baştan seçmek, tabloyu aylar sonra da temiz tutan şeydir.
Tablo oluşturulamazsa şunu görürsünüz:
Tablo oluşturulamadı (ad zaten kullanılıyor olabilir).
Tablo adları benzersiz olmalıdır; başka bir ad deneyin.
Satırlarla çalışma
Veri ızgarasını görmek için bir tabloyu açın. Başlıkta tablo adı, satır sayısı ve bu tablonun iş akışlarınızda kullanılabildiğini hatırlatan bir not yer alır. Sütun başlıkları sütun adını ve yanında küçük büyük harflerle türünü gösterir.
Sayfalama
Izgara sayfa başına 100 satır gösterir. Izgaranın altındaki satır nerede olduğunuzu söyler — örneğin 250 satırdan 1–100 — ve tabloda bir sayfaya sığandan fazla satır olduğunda Önceki ve Sonraki düğmeleri sayfalar arasında geçiş yapar.
Satırlarda arama
Tablo başlığındaki büyüteç düğmesi (Satırlarda ara) ızgaranın üstünde bir arama kutusu açar. En az bir string, date veya number sütunu olan her tabloda bulunur — arşivlenmiş tablolar dahil. Kutunun yer tutucusu hangi sütunlara baktığını söyler, örneğin title, amount, due_date içinde ara….
| Sütun türü | Nasıl aranır |
|---|---|
| string, date | Değeri, yazdığınız metni içeren satırlar. 2026-08, tarihi Ağustos 2026 olan her satırı bulur |
| number | Değeri, yazdığınız sayıya tam olarak eşit olan satırlar. Yalnızca yazdığınız şey bir sayıysa kullanılır |
| boolean, json | Aranmaz |
Arama yalnızca bulunduğunuz sayfayı değil, tablonun tamamını kapsar. Arama etkinken ızgaranın altındaki satır eşleşmeleri sayar — 3 eşleşen satırdan 1–3 — uyan bir şey yoksa “…” ile eşleşen satır yok. yazısını görürsünüz.
Aramayı kutunun yanındaki × ile, büyüteç düğmesiyle veya Escape ile kapatın. Kapatmak yazdığınızı temizler; ızgara yeniden tüm satırları gösterir.
Satır ekleme
Satır ekle'ye tıklayın. Yeni bir satır hemen belirir; zorunlu sütunlara uygun başlangıç değerleri önceden doldurulur, böylece satır var olduğu andan itibaren geçerlidir. Ardından hücrelere tıklayıp bu değerleri kendi değerlerinizle değiştirin.
Tabloda henüz satır yoksa ızgara, İlk satırı ekle düğmesiyle birlikte Henüz satır yok yazısını gösterir.
Hücre düzenleme
Yerinde düzenlemek için herhangi bir hücreye tıklayın.
| Tuş | Ne olur |
|---|---|
| Enter | Değeri kaydeder |
| Escape | İptal eder ve hücreyi değiştirmeden bırakır |
| Başka bir yere tıklamak | Değeri kaydeder |
Boş hücreler bir tire (—) gösterir. Bir hücreyi temizleyip kaydetmek, boş bir değer saklamak yerine o değeri satırdan kaldırır.
Izgarayı yalnızca okurken bir değerin nasıl göründüğü sütun türüne bağlıdır:
| Sütun türü | Nasıl gösterilir |
|---|---|
| string, number | Değerin kendisi |
| boolean | true için bir onay işareti, false için bir çarpı |
| date | Tarih ve saat, arayüz dilinizin biçiminde |
| json | Kısa bir özet — üç alanlı bir nesne için { } 3, beş öğeli bir liste için [ ] 5. Değerin tamamını görmek için hücrenin üzerine gelin |
Hücreye tıkladığınızda değeri saklandığı biçimde görürsünüz — true, yazıldığı haliyle tarih veya JSON metninin tamamı — düzenlemeye hazır olarak.
Her düzenlemede tür denetimi
Bir değer kaydedilmeden önce sütunun türüne dönüştürülür. Uymuyorsa düzenleme reddedilir ve sütunu ve sorunu belirten kısa bir mesaj alırsınız:
| Sütun türü | Değer uymadığında mesaj |
|---|---|
| number | sayı olmalı |
| boolean | true veya false olmalı |
| date | tarih olmalı |
| json | geçersiz JSON |
Kaydetme başka bir nedenle reddedilirse şunu görürsünüz:
Kaydedilemedi — zorunlu bir değer eksik veya türü hatalı olabilir.
Bu genellikle zorunlu bir sütunun boş bırakıldığı anlamına gelir.
Satır silme
Satırın sonundaki çöp kutusu simgesine tıklayın. Satır hemen kaldırılır — onay istenmez. Kaldırılamazsa Satır silinemedi. yazısını görürsünüz.
Sütun ekleme
Bir tabloya, içinde satırlar olsa bile istediğiniz zaman sütun ekleyebilirsiniz.
- Tabloyu açın ve başlıktaki Sütun ekle'ye tıklayın. Izgaranın üstünde bir Yeni sütun çubuğu açılır.
- Sütun adını yazın ve türünü seçin.
- Ekle'ye tıklayın veya Enter'a basın. İptal veya Escape çubuğu kapatır.
“{sütun}” sütunu eklendi yazısını görürsünüz. Yeni sütun var olan her satırda boştur ve isteğe bağlıdır.
Çubuk, Ekle'nin neden devre dışı olduğunu söyler:
| Mesaj | Ne anlama gelir |
|---|---|
| Ad bir harf veya alt çizgiyle başlamalı ve yalnızca harf, rakam ve alt çizgi içermeli. | Ad, adlandırma kuralına uymuyor |
| Bir sütun adı en fazla 50 karakter olabilir (bu 62 karakter). | Ad çok uzun |
| Bu tabloda “…” adlı bir sütun zaten var. | Sütun adları benzersiz olmalıdır. Büyük-küçük harf farkı sayılmaz |
| Bu tabloda zaten en fazla sayıda (50) sütun var. | Tablo dolu — önce ihtiyacınız olmayan bir sütunu kaldırın |
Çubuk, alanların altında bir şey eklemeden önce okumaya değer bir hatırlatma taşır:
Yeni sütunlar boş ve isteğe bağlı başlar. Hiçbir satır değer taşımadığı sürece bir sütun kaldırılabilir — ama bir satır değer taşımaya başladığında artık yeniden adlandırılamaz, türü değiştirilemez ve kaldırılamaz.
Çubuk açıkken tabloyu başka biri değiştirdiyse Bu tabloyu başka biri değiştirdi — liste yenilendi. Sütununuzu tekrar ekleyin. yazısını görürsünüz.
Sütun kaldırma
Her sütun başlığında, tür rozetinin yanında küçük bir × bulunur. O sütunu tablodan kaldırmak için tıklayın.
Bir tabloda her zaman en az bir sütun olmalıdır; bu yüzden son sütun kaldığında simge devre dışıdır ve Bir tabloda en az bir sütun olmalı ipucunu gösterir.
Onay iletişim kutusu tam olarak ne olacağını açıkça belirtir:
“{sütun}” sütunu kaldırılsın mı?
“{sütun}”, “{tablo}” tablosunun her satırından kaldırılır. Bu işlem yalnızca hiçbir satır bu sütunda değer taşımıyorsa gerçekleşir — taşıyan varsa hiçbir şey değişmez ve size hangisi olduğu söylenir.
Onaylamak için Sütunu kaldır'a, vazgeçmek için İptal'e tıklayın. Başarılı olduğunda “{sütun}” sütunu kaldırıldı yazısını görürsünüz.
Güvenlik kuralı
Bir sütun yalnızca hiçbir satır o sütun için bir değer tutmuyorsa kaldırılabilir — bu, tablo tablo değil, sütun sütun denetlenir. Bir tabloda çok sayıda satır olsa bile, o sütun her birinde boş olduğu sürece kaldırılabilir.
Herhangi bir satırda hâlâ bir değer varsa hiçbir şey kaldırılmaz ve engelleyen sütunun hangisi olduğu ile kaç satırın etkilendiği size bildirilir. Bu mesaj İngilizce gösterilir:
"{column}" still holds a value in {n} row(s). Clear those cells first, or keep the column.
Bir sütunu kaldırılabilir hale getirmek için önce her satırdaki değerini temizleyin — boşaltılan bir hücre boş bir değer saklamak yerine değeri tamamen kaldırır; bu denetimin gerektirdiği tam olarak budur. Hâlâ değer tutan satırları bulmak için satır aramasını kullanabilirsiniz.
Kaldırma başka bir nedenle başarısız olursa Sütun kaldırılamadı. yazısını görürsünüz. Bu arada tabloyu başka biri değiştirdiyse: Bu tabloyu başka biri değiştirdi — liste yenilendi. Sütunu kaldırmayı tekrar deneyin.
Bir sütunu yeniden adlandırmanın veya türünü değiştirmenin bir yolu yoktur. Farklı bir şeye ihtiyacınız varsa sütunu — boşaldıktan sonra — kaldırın ve yerine yenisini ekleyin.
Bir iş akışı bloğu kaldırdığınız sütuna hâlâ yazıyorsa — örneğin Satır verisinde o sütun bulunan bir Tablo — Satır Ekle veya Tablo — Satır Güncelle bloğu — o bloğun bir sonraki yazma işlemi reddedilir. Önce o blokları güncelleyin.
Tabloyu yeniden adlandırma
Izgara başlığında tablo adının yanındaki kalem simgesine tıklayın, yeni adı yazın, ardından kaydetmek için Enter'a veya iptal etmek için Escape'e basın. Başka bir yere tıklamak da kaydeder.
Aynı adlandırma kuralı geçerlidir ve adlar benzersiz kalmalıdır — aksi halde:
Yeniden adlandırılamadı — bu ad zaten kullanılıyor olabilir.
Arşivleme ve geri yükleme
Arşivleme, hiçbir şeyi kaybetmeden bir tabloyu çalışma listenizden çıkarır.
Arşivleme
- Tabloyu açın.
- Arşivle'ye tıklayın.
- Tablo arşivlensin mi? iletişim kutusunda onaylayın.
Onay mesajı tam olarak ne olacağını açıkça belirtir:
Arşivlenecek tablo: "{ad}". Aktif listeden çıkar ama {n} satırı korunur — Arşiv görünümünden istediğiniz zaman geri yükleyebilirsiniz.
Tablo arşivlendi yazısını görürsünüz ve tablo Arşiv sekmesine taşınır.
Bir tablo arşivlendiğinde neler değişir
- Yeniden adlandırma kalemi yerine bir Arşivlenmiş rozeti gösterir
- Hücreler artık düzenlenemez
- Satır ekle, Sütun ekle, satır silme ve sütun kaldırma kullanılamaz
- Sayfalar arasında gezinmeye ve satırlarında aramaya devam edebilirsiniz
- Boş bir arşivlenmiş tabloda Bu tablo arşivlenmiş yazar
Geri yükleme
Arşiv sekmesine geçin, tabloyu açın ve Geri yükle'ye tıklayın. Tablo geri yüklendi yazısını görürsünüz ve tablo, yeniden tamamen düzenlenebilir olarak aktif listeye döner.
Arşivleme, artık kullanmadığınız bir tabloyu devreden çıkarmanın güvenli yoludur. Arşivlemeden önce herhangi bir iş akışı bloğunun hâlâ ona işaret edip etmediğini kontrol edin — o adımlar artık tabloya yazamaz.
Tabloyu bir iş akışında kullanma
Tablolar, bir iş akışı onları okuyup yazdığında işe yarar hale gelir. Tam olarak bunu dört blok yapar. Bunları blok paletinde Veri kategorisi altında bulursunuz — bkz. Bloklar.
| Blok | Ne yapar |
|---|---|
| Tablo — Satır Ekle | Yeni bir satır ekler |
| Tablo — Satır Sorgula | Bir filtreyle eşleşen satırları bulur |
| Tablo — Satır Getir | Belirli bir satırı getirir |
| Tablo — Satır Güncelle | Var olan bir satırı değiştirir |
Bunların her birinde tablo, tablolarınızı ada göre listeleyen bir Tablo açılır listesinden seçilir — bir kimliği asla elle yazmazsınız. Henüz tablonuz yoksa açılır listede Henüz tablo yok — önce Tablolar bölümünden bir tane oluşturun. yazar.
Tablo — Satır Ekle
| Alan | İçine ne yazılır |
|---|---|
| Tablo | Yazılacak tablo |
| Satır verisi | { columnName: value } biçiminde satır — her değer sütununun türüyle eşleşmelidir |
Çıktı: oluşturulan satır (row).
Tablo — Satır Sorgula
Filtre, Sıralama, Sınır ve Atlama, Ek alanları göster'in arkasındadır.
| Alan | İçine ne yazılır |
|---|---|
| Tablo | Aranacak tablo |
| Filtre | Hangi satırların eşleşeceği — tam eşleşme için { field: value }, karşılaştırma için { field: { $gte: 18 } } |
| Sıralama | Sıralama düzeni, örn. { createdAt: "desc" } |
| Sınır | Kaç satır döndürüleceği, 1 ile 1000 arasında (varsayılan 100) |
| Atlama | Kaç satırın atlanacağı — büyük bir sonuç kümesinde sayfalama yapmak için kullanın |
Çıktılar: eşleşen satırlar (rows) ve eşleşmelerin toplam sayısı (total).
Kullanabileceğiniz filtre karşılaştırmaları:
| Operatör | Anlamı |
|---|---|
$eq / $ne | Eşittir / eşit değildir |
$gt / $gte | Büyüktür / büyük veya eşittir |
$lt / $lte | Küçüktür / küçük veya eşittir |
$in / $nin | Bir listedekilerden biridir / hiçbiri değildir |
$contains | Verilen değeri içerir |
Birden fazla koşulu $or ve $and ile birleştirin.
Bir tabloyu sorgulamak, "benzer bir şey" araması değil, tam eşleşmedir. Bir satır yalnızca filtreyle gerçekten eşleştiğinde geri döner. Bunun yerine şirket içeriğinizde anlam tabanlı arama istiyorsanız, o iş Bilgi ve arama bloklarının işidir — bkz. Bloklar.
Tablo — Satır Getir
| Alan | İçine ne yazılır |
|---|---|
| Tablo | Okunacak tablo |
| Satır kimliği | İstediğiniz satırın kimliği |
Çıktı: satır (row).
Tablo — Satır Güncelle
| Alan | İçine ne yazılır |
|---|---|
| Tablo | Yazılacak tablo |
| Satır kimliği | Değiştirilecek satırın kimliği |
| Satır verisi | { columnName: value } biçiminde yeni değerler; sütun türleriyle eşleştirilir |
Çıktı: güncellenen satır (row).
Tablo verisini sonraki adıma aktarma
Bloklar birbirlerinin sonuçlarını referanslar aracılığıyla yeniden kullanır. Sonraki bir blok, önceki bir bloğun çıktısını <blockName.field> olarak okur — yani bir Satır Sorgula bloğunun sonuçları <blockName.rows>, eşleşme sayısı ise <blockName.total> olarak kullanılabilir.
Bir satır kendi id değerini ve data altında sütun değerlerini taşır. Yani az önce eklediğiniz bir satırın kimliği <blockName.row.id> olur — sonraki bir Tablo — Satır Güncelle veya Tablo — Satır Getir bloğunun Satır kimliği olarak ihtiyaç duyduğu değer — sütunlarından biri ise <blockName.row.data.columnName> olur.
Tetikleyiciden gelen veriye <input.NAME>, iş akışı değişkenlerine <variable.NAME> olarak başvurulur. Bütün resim için Değişkenler sayfasına bakın.
Tipik bir yapı şöyledir:
- Bir tetikleyici çalıştırmayı gelen bir veriyle başlatır
- Tablo — Satır Sorgula eşleşen bir kayıt arar
- Bir Koşul bloğu herhangi bir şey dönüp dönmediğini kontrol eder
- Tablo — Satır Ekle veya Tablo — Satır Güncelle sonucu yazar
Ajan aracı olarak tablolar
Tablolarınız yapay zekâ ajanları için de kullanılabilir. Bir iş akışındaki Ajan bloğu, bir isteği yanıtlarken tablolarınızı kendi başına listeleyebilir ve kayıtlara bakabilir — her aramayı tuvalde elle bağlamanıza gerek kalmaz. Bir satır yazmak için Tablo — Satır Ekle veya Tablo — Satır Güncelle bloğunu kullanın.
Bu da tabloyu, bir ajanın sohbetler ve çalıştırmalar boyunca tutarlı kalması için ihtiyaç duyduğu bilgileri saklamaya uygun bir yer yapar.
Sütunlara bir ajanın yorumlayabileceği adlar verin — col1 veya f2 yerine status, owner_email, due_date. Ajan hangi sütunu kullanacağına bu adları okuyarak karar verir.
Sorun giderme
| Ne görüyorsunuz | Genellikle ne anlama gelir |
|---|---|
| Tablo oluşturulamadı (ad zaten kullanılıyor olabilir). | Başka bir tablo zaten bu adı kullanıyor — farklı bir ad seçin |
| Yeniden adlandırılamadı — bu ad zaten kullanılıyor olabilir. | Aynı neden, yeniden adlandırmada |
| {sütun}: sayı olmalı (veya true veya false olmalı / tarih olmalı / geçersiz JSON) | Değer sütunun türüyle eşleşmiyor — değeri düzeltin veya sütun türünü yeniden düşünün |
| Kaydedilemedi — zorunlu bir değer eksik veya türü hatalı olabilir. | Zorunlu bir sütun boş kaldı |
| Satır eklenemedi. | Satır oluşturulamadı — tekrar deneyin |
| "{column}" still holds a value in {n} row(s)… | Kaldırmaya çalıştığınız sütun boş değil — önce o hücreleri temizleyin |
| Bu tabloyu başka biri değiştirdi — liste yenilendi. | Siz sütunlarını düzenlerken tablo başka bir yerde değiştirildi — yaptığınız işlemi tekrarlayın |
| “…” ile eşleşen satır yok. | Satır araması bir şey bulamadı. number sütunlarının tam sayıyı istediğini, boolean / json sütunlarının ise aranmadığını unutmayın |
| Beklediğiniz bir satır ekranda yok | Başka bir sayfada olabilir — Sonraki'yi kullanın veya arayın |
| Hücreler tıklamalara yanıt vermiyor | Tablo arşivlenmiş — önce geri yükleyin |
| Tablolar yüklenemedi. / Satırlar yüklenemedi. | Geçici bir yükleme sorunu — Tekrar Dene'yi kullanın |
| Bir iş akışı adımı tabloyu bulamıyor | Bloğun Tablo açılır listesinin hâlâ doğru tabloyu gösterdiğini ve tablonun arşivlenmediğini doğrulayın |
İyi alışkanlıklar
- Her kayıt türü için tek bir tablo. Bir
leadstablosu ile birticketstablosu, ikisini birden olmaya çalışan tek bir tablodan daha iyidir. - Türleri bilinçli seçin. Bir
numbersütunu hatalı bir değeri bir ay sonra değil, yazıldığı anda yakalar. Değer tutan bir sütunun türü de değiştirilemez; yani ilk seçim kalıcıdır. - Tarihler için
datekullanın. Tarihleri metin olarak saklamak sıralamayı ve karşılaştırmayı güvenilmez hale getirir. - Zorunlu bir
titletutun. Izgaradaki her satıra insan tarafından okunabilir bir etiket verir. - Bırakmayın, arşivleyin. Bir tabloyu arşiv görünümüne almak, aktif listeyi kalabalıklaştırmadan geçmişini korur.