Tablolar

Tablolar, Arketic içindeki kendi yapılandırılmış veri deponuzdur — workflow'ların ve yapay zekâ ajanlarının okuyup yazabildiği, basit ve tip tanımlı tablolar.

Bir workflow'un çalışmalar 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ış kolonları vardır, her kolonun bir tipi vardır ve her değer kaydedilmeden önce bu tipe göre denetlenir.

Tables sekmesi

Tablolar nerede

Workflows → Tables'ı 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ı — kolonları 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 Select a table yazar.

Aktif ve arşivlenmiş

Listenin üstünde iki küçük sekme bulunur: active ve archived.

active — workflow'larınızın günlük olarak kullandığı tablolar. New düğmesi yalnızca burada bulunur.
archived — 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 kapsam boşsa No tables yet (aktif) veya No archived tables (arşiv) yazısını görürsünüz.

Tablo oluşturma

active sekmesinde olduğunuzdan emin olun.
New'e tıklayın. Ana alanda New table formu açılır.
Bir Name yazın (örneğin leads).
Columns (kolonlarınızı) tanımlayın.
Create table'a tıklayın.

Adlandırma kuralları

Tablo ve kolon 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

Ad kurala uymuyorsa form nedenini söyler ve Create table devre dışı kalır:

Name must start with a letter or underscore and use only letters, numbers, and underscores.

ipucu

Tabloları içerdikleri kayıt türüne göre adlandırın — leads, tickets, invoices. Bir workflow block'unu tabloya yönlendirirken bu adları göreceksiniz; net adlar workflow'ları çok daha okunur kılar.

Kolonlar

Her yeni tablo title adlı bir kolonla başlar (tip string, zorunlu). Daha fazlasını + Add column ile ekleyin.

Her kolon satırının üç parçası vardır:

Parça	Ne yapar
Name	Kolon adı (yer tutucu `column_name`). Tabloyla aynı adlandırma kuralı geçerlidir.
Type	Bir açılır liste — tipler aşağıda.
Delete (çöp kutusu simgesi)	Kolonu kaldırır. Yalnızca tek kolon kaldığında devre dışıdır — bir tabloda en az bir kolon bulunmalıdır.

Kolon adları tablo içinde benzersiz de olmalıdır. İki kolon aynı adı taşıyorsa form sizi uyarır:

Column names must be unique.

Kolon tipleri

Tip	Ne için kullanılır	Değer ne zaman kabul edilir
string	Metin — adlar, notlar, durumlar, kimlikler	Her şey
number	Tutarlar, puanlar, sayılar	Bir sayı olduğunda
boolean	Evet/hayır işaretleri	`true` veya `false` olduğunda
date	Tarihler ve zaman damgaları	Tanınabilir bir tarih olduğunda, ör. `2026-07-23`
json	Yapılandırılmış veri — bir nesne, bir liste, iç içe alanlar	Geçerli JSON olduğunda

bilgi

Tipler süs değildir. Bir değer her yazıldığında uygulanırlar — ızgaradan, bir workflow block'undan veya bir ajandan. Doğru tipi baştan seçmek, tablonun aylar sonra da temiz kalmasını sağlar.

Tablo oluşturulamazsa şunu görürsünüz:

Could not create the table (name may be taken).

Tablo adları benzersiz olmalıdır; başka bir ad deneyin.

Satırlarla çalışma

Veri ızgarasını görmek için bir tablo açın. Başlıkta tablonun adı, satır sayısı ve bu tablonun workflow'larınıza açık olduğunu hatırlatan bir satır bulunur. Kolon başlıkları kolon adını, yanında küçük büyük harflerle tipini gösterir.

Izgara her seferinde en fazla 200 satır yükler.

Satır ekleme

Add row'a tıklayın. Yeni satır hemen belirir; zorunlu kolonlara, satırın var olduğu andan itibaren geçerli olmasını sağlayan mantıklı başlangıç değerleri önceden doldurulur. Ardından hücrelere tıklayıp bu değerleri kendi verinizle değiştirin.

Tabloda henüz satır yoksa ızgarada No rows yet yazısı ve bir Add first row düğmesi görünür.

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, hücreyi değiştirmeden bırakır
Dışarı tıklamak	Değeri kaydeder

Boş hücreler bir tire (—) gösterir. Bir hücreyi temizleyip kaydetmek, boş bir değer saklamak yerine o alanı satırdan çıkarır.

Her düzenlemede tip denetimi

Bir değer kaydedilmeden önce kolonun tipine dönüştürülür. Uymuyorsa düzenleme reddedilir ve kolonu ve sorunu belirten kısa bir mesaj alırsınız:

Kolon tipi	Değer uymadığında görünen mesaj
number	must be a number
boolean	must be true or false
date	must be a date
json	invalid JSON

Kayıt başka bir nedenle reddedilirse şunu görürsünüz:

Could not save — a required value may be missing or mistyped.

Bu genellikle zorunlu bir kolonun boş bırakıldığı anlamına gelir.

not

json kolonundaki değerler JSON metni olarak gösterilir; yani hücrede gördüğünüz şey, tam olarak düzenleyip geri kaydedebileceğiniz şeydir.

Satır silme

Satırın sonundaki çöp kutusu simgesine tıklayın. Kaldırılamazsa Could not delete the row. mesajını görürsünüz.

Kolon kaldırma

Her kolon başlığı, tip rozetinin yanında küçük bir × taşır. O kolonu tablodan kaldırmak için tıklayın.

Bir tabloda her zaman en az bir kolon olmalıdır; bu yüzden son kolon kaldığında simge — nedenini açıklayan bir ipucuyla birlikte — devre dışıdır.

Onay penceresi tam olarak ne olacağını açıklar:

Remove column "{column}"?

"{column}" is removed from "{table}" for every row. This only goes through while no row holds a value for it — if any row does, nothing is changed and you are told which.

Onaylamak için Remove column'a, vazgeçmek için Cancel'a tıklayın. Başarılı olduğunda Column "{column}" removed yazısını görürsünüz.

Güvenlik kuralı

Bir kolon yalnızca hiçbir satırda değeri yokken kaldırılabilir — bu, tablo bazında değil kolon bazında kontrol edilir. Bir tablonun bolca satırı olsa bile, belirli bir kolon her satırda boşsa o kolonu kaldırabilirsiniz.

Herhangi bir satırda hâlâ bir değer varsa hiçbir şey kaldırılmaz ve tam olarak hangi kolonun buna engel olduğu ile kaç satırın etkilendiği söylenir:

"{column}" still holds a value in {n} row(s). Clear those cells first, or keep the column.

Bir kolonu kaldırılabilir hale getirmek için önce değerini her satırda temizleyin — boşaltılan bir hücre değeri tamamen kaldırır, boş bir değer saklamaz; bu kontrolün aradığı tam olarak budur.

Kaldırma başka bir nedenle başarısız olursa Could not remove the column. mesajını görürsünüz.

Bir kolonun adı veya tipi oluşturulduktan sonra değiştirilemez. Farklı bir şeye ihtiyacınız varsa — boşaldıktan sonra — kolonu kaldırıp yerine yenisini ekleyin.

uyarı

Kaldırdığınız bir kolona hâlâ yazan bir workflow bloğu varsa — örneğin Row data içinde o kolonu kullanan bir Table — Insert Row veya Table — Update Row bloğu — o bloğun bir sonraki yazması 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, iptal etmek için Escape'e basın. Dışarı tıklamak da kaydeder.

Aynı adlandırma kuralı geçerlidir ve adlar benzersiz kalmalıdır; aksi hâlde:

Could not rename — the name may already be taken.

Arşivleme ve geri alma

Arşivleme, bir tabloyu hiçbir şeyi kaybetmeden çalışma listenizden çıkarır.

Arşivleme

Tabloyu açın.
Archive'a tıklayın.
Onaylayın.

Onay penceresi ne olacağını açıkça yazar:

Archive "{name}"? It leaves the active list but its {n} row(s) are kept — restore it anytime from the Archived view.

Table archived mesajını görürsünüz ve tablo archived sekmesine taşınır.

Bir tablo arşivlendiğinde ne değişir

Yeniden adlandırma kalemi yerine bir Archived rozeti görünür
Hücreler artık düzenlenemez
Add row ve satır silme kullanılamaz
Boş bir arşivlenmiş tabloda This table is archived yazar

Geri alma

archived sekmesine geçin, tabloyu açın ve Restore'a tıklayın. Table restored mesajını görürsünüz ve tablo tümüyle düzenlenebilir şekilde aktif listeye döner.

uyarı

Arşivleme, artık kullanmadığınız bir tabloyu emekliye ayırmanın güvenli yoludur. Arşivlemeden önce herhangi bir workflow block'unun hâlâ bu tabloyu gösterip göstermediğini kontrol edin — o adımlar artık tabloya yazamayacaktır.

Bir workflow'da tablo kullanma

Tablolar, bir workflow onları okuyup yazdığında işe yarar. Bunu tam olarak dört block yapar. Bunları block paletinde Data kategorisi altında bulursunuz — bkz. Workflow Oluşturma.

Block	Ne yapar
Table — Insert Row	Yeni bir satır ekler
Table — Query Rows	Bir filtreye uyan satırları bulur
Table — Get Row	Belirli tek bir satırı getirir
Table — Update Row	Var olan bir satırı değiştirir

Bunların hepsinde tablo, tablolarınızı ada göre listeleyen bir Table açılır listesinden seçilir — hiçbir zaman elle bir kimlik yazmazsınız.

Table — Insert Row

Alan	Ne yazılır
Table	Yazılacak tablo
Row data	Satır, `{ columnName: value }` biçiminde — her değer kolonunun tipine uymalıdır

Çıktı: oluşturulan row (satır).

Table — Query Rows

Alan	Ne yazılır
Table	Aranacak tablo
Filter	Hangi satırların eşleşeceği — birebir eşleşme için `{ field: value }`, karşılaştırma için `{ field: { $gte: 18 } }`
Sort	Sıralama, ör. `{ createdAt: "desc" }`
Limit	Kaç satır döneceği, 1 ile 1000 arası (varsayılan 100)
Offset	Kaç satırın atlanacağı — büyük bir sonuç kümesinde sayfalamak için kullanın

Çıktılar: eşleşen rows (satırlar) ve eşleşmelerin total (toplam) sayısı.

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`	Listedekilerden biridir / değildir
`$contains`	Verilen değeri içerir

Birden fazla koşulu $or ve $and ile birleştirin.

bilgi

Bir tabloyu sorgulamak birebir eşleştirmedir, "benzer bir şey" araması değil. Bir satır yalnızca filtreye gerçekten uyduğunda döner. Bunun yerine şirket içeriğinizde anlam temelli arama istiyorsanız, bu iş Knowledge ve arama block'larına aittir — bkz. Workflow Oluşturma.

Table — Get Row

Alan	Ne yazılır
Table	Okunacak tablo
Row ID	İstediğiniz satırın kimliği

Çıktı: row (satır).

Table — Update Row

Alan	Ne yazılır
Table	Yazılacak tablo
Row ID	Değiştirilecek satırın kimliği
Row data	Yeni değerler, `{ columnName: value }` biçiminde, kolon tiplerine göre denetlenir

Çıktı: güncellenen row (satır).

Tablo verisini bir sonraki adıma aktarma

Block'lar birbirinin sonuçlarını referanslar aracılığıyla yeniden kullanır. Sonraki bir block, önceki bir block'un çıktısını <blockName.field> olarak okur — böylece bir Query Rows block'unun sonuçları <blockName.rows> olarak, eşleşme sayısı da <blockName.total> olarak kullanılabilir hâle gelir.

Tetikleyiciden gelen veriye <input.NAME>, workflow değişkenlerine ise <variable.NAME> ile başvurulur. Tam resim için bkz. Değişkenler ve Workflow Oluşturma.

Tipik bir kurgu şöyle görünür:

Bir tetikleyici, çalışmayı gelen veriyle başlatır
Table — Query Rows eşleşen bir kayıt arar
Bir Condition block'u bir şey dönüp dönmediğini kontrol eder
Table — Insert Row veya Table — Update Row sonucu yazar

Ajan aracı olarak tablolar

Tablolarınız yapay zekâ ajanlarına araç olarak da açıktır. Bir workflow'daki ajan, bir isteği yanıtlarken kayıtları kendi başına arayabilir ve geri yazabilir — her aramayı tuvalde elle bağlamanıza gerek kalmadan.

Bu da tabloyu, bir ajanın konuşmalar ve çalışmalar boyunca tutarlı kalması için ihtiyaç duyduğu bilgileri saklamak açısından iyi bir yer yapar.

ipucu

Kolonlara bir ajanın yorumlayabileceği adlar verin — col1 veya f2 yerine status, owner_email, due_date gibi. Ajanın hangi kolonu kullanacağına karar verirken okuduğu şey bu adlardır.

Sorun giderme

Gördüğünüz	Genellikle ne anlama gelir
Could not create the table (name may be taken).	Bu adı başka bir tablo kullanıyor — farklı bir ad seçin
Could not rename — the name may already be taken.	Yeniden adlandırmada aynı neden
{column}: must be a number (ya da true or false / a date / invalid JSON)	Değer kolonun tipine uymuyor — değeri düzeltin veya kolon tipini gözden geçirin
Could not save — a required value may be missing or mistyped.	Zorunlu bir kolon boş kalmış
Hücreler tıklamalara yanıt vermiyor	Tablo arşivlenmiş — önce geri alın
Couldn't load tables. / Couldn't load rows.	Geçici bir yükleme sorunu — Try again'i kullanın
Bir workflow adımı tabloyu bulamıyor	Block'un Table 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 bir tablo. Bir leads tablosu ve bir tickets tablosu, ikisini birden olmaya çalışan tek bir tablodan iyidir.
Tipleri bilinçli seçin. number kolonu hatalı bir değeri bir ay sonra değil, yazıldığı anda yakalar.
Tarihler için date kullanın. Tarihleri metin olarak saklamak sıralama ve karşılaştırmayı güvenilmez kılar.
Zorunlu bir title bulundurun. Bu, ızgarada her satıra okunabilir bir etiket kazandırır.
Terk etmek yerine arşivleyin. Bir tabloyu arşiv görünümüne almak, geçmişini korurken aktif listeyi de sade tutar.

Tablolar nerede​

Aktif ve arşivlenmiş​

Tablo oluşturma​

Adlandırma kuralları​

Kolonlar​

Kolon tipleri​

Satırlarla çalışma​

Satır ekleme​

Hücre düzenleme​

Her düzenlemede tip denetimi​

Satır silme​

Kolon kaldırma​

Güvenlik kuralı​

Tabloyu yeniden adlandırma​

Arşivleme ve geri alma​

Arşivleme​

Bir tablo arşivlendiğinde ne değişir​

Geri alma​

Bir workflow'da tablo kullanma​

Table — Insert Row​

Table — Query Rows​

Table — Get Row​

Table — Update Row​

Tablo verisini bir sonraki adıma aktarma​

Ajan aracı olarak tablolar​

Sorun giderme​

İyi alışkanlıklar​

İlgili sayfalar​