Orbion Yönetici KılavuzuOrbion Admin Guide

Giriş ve MimariIntroduction & Architecture

Orbion, mevcut veritabanlarınızın üzerine kod yazmadan uygulama, form, pano ve iş akışı kurmanızı sağlayan bir low-code platformudur. Veri kaynağı bağlarsınız, formlar ve komponentler tasarlarsınız, bunları menüler/portal altında uygulamalara dönüştürürsünüz; iş akışları ve entegrasyonlarla otomatikleştirirsiniz. Orbion is a low-code platform for building apps, forms, dashboards and workflows on top of your existing databases — without writing code. You connect data sources, design forms and components, expose them as apps under menus/portal, then automate with workflows and integrations.

Ana kavramlarCore concepts

Yapılandırma sırasıConfiguration order

Modüller birbirine dayanır; bu sırayla ilerleyin:Modules depend on each other; proceed in this order:

1. Connections → veri kaynağı (temel).data sources (foundation).
2. Identity → kullanıcı, grup, organizasyon, güvenlik.users, groups, organizations, security.
3. Global Variables → ortak parametreler.shared parameters.
4. Apps & Menus → uygulama ve navigasyon.application & navigation.
5. Forms & Components → ekran tasarımı.screen design.
6. Workflows / Integrations / Email → otomasyon ve işletim.automation & operations.

1 · Erişim ve İlk KurulumAccess & First Setup

AmaçPurpose

Yönetim arayüzüne giriş yapıp güvenli bir yönetici hesabıyla başlamak.Sign in to the admin interface and start from a secure administrator account.

AdımlarSteps

1. Giriş ekranında (login.html) yönetici kullanıcı adı/şifresiyle oturum açın.Sign in on the login screen (login.html) with the administrator credentials.
2. İlk girişte şifrenizi Change Password ekranından değiştirin.On first login, change your password from the Change Password screen.
3. Designer (yönetim) arayüzü index.html üzerinden açılır; soldaki bölümler (Connections, Users, Apps…) yönetim modülleridir.The Designer (admin) interface opens at index.html; the left-hand sections (Connections, Users, Apps…) are the admin modules.

2 · Veri Yönetimi (Data Management)Data Management

Orbion yalnız var olan veritabanlarına bağlanmakla kalmaz; tablo/kolon oluşturup veri de tutabilir. Bu bölüm üç parçadır: Connections (bağlantılar), Veri editörü (tablo/kolon/satır yönetimi) ve Orbion Types (kolonların anlamsal tipleri).Orbion doesn't just connect to existing databases; it can also create tables/columns and store data. This section has three parts: Connections, the Data editor (manage tables/columns/rows), and Orbion Types (the semantic types of columns).

2.1 · Connections (Bağlantılar)2.1 · Connections

Orbion'un veri okuyup yazacağı veritabanlarını tanımlar — tüm sistemin temelidir; form, komponent ve iş akışları bu bağlantılar üzerinden çalışır.Defines the databases Orbion reads from and writes to — the foundation of the whole system; forms, components and workflows all run through these connections.

Desteklenen motorlarSupported engines

PostgreSQL SQLite

Alan referansıField reference

AdımlarSteps

1. Connections bölümünü açın → New.Open Connections → New.
2. Motoru ve bağlantı bilgilerini girin.Pick the engine and enter connection details.
3. Test ile doğrulayın; başarılıysa Save.Validate with Test; on success Save.
4. Şema/tablo keşfi otomatik yapılır; artık formlarda bu bağlantıyı seçebilirsiniz.Schema/table discovery runs automatically; the connection is now selectable in forms.

2.2 · Veri editörü (tablo · kolon · veri)2.2 · Data editor (tables · columns · data)

Bağlandıktan sonra Orbion'un yerleşik veri editörüyle veritabanını doğrudan yönetebilirsiniz: soldaki ağaçta Bağlantı › Şema › Tablo gezinir, ortada bir tablonun kolon yapısını ve verisini (satırları) görürsünüz. Tüm DDL ve CRUD işlemleri buradan yapılır — ayrı bir SQL aracına gerek yoktur.Once connected, Orbion's built-in data editor manages the database directly: browse Connection › Schema › Table in the left tree, and view a table's column structure and data (rows) in the middle. All DDL and CRUD is done here — no separate SQL tool needed.

2.3 · Orbion Types (anlamsal kolon tipleri)2.3 · Orbion Types (semantic column types)

Orbion Type, bir kolonun fiziksel veritabanı tipinin üzerine konan anlamsal tiptir. Veritabanı varchar, int, timestamp bilir; Orbion ise o kolonun ne ifade ettiğini bilmek ister — bir kullanıcı mı, bir tarih mi, bir açılır seçenek mi? Orbion Type bunu söyler ve kolonun tüm formlarda nasıl render edileceğini ve davranacağını belirler. Her kolona fiziksel tipinden otomatik bir varsayılan atanır; siz bunu override edebilirsiniz (yalnız değişiklik saklanır, varsayılan yeniden hesaplanır).Orbion Type is the semantic type layered on top of a column's physical database type. The database knows varchar, int, timestamp; Orbion wants to know what the column means — a user, a date, a dropdown option? Orbion Type says so, and drives how the column renders and behaves across all forms. Each column gets an auto-derived default from its physical type, which you can override (only the override is stored; the default is recomputed).

2.4 · Option tipi ↔ Global Variable eşleştirme2.4 · Option type ↔ Global Variable matching

Bir kolonun Orbion Type'ı Option yapıldığında, yanında bir Global Variable seçici belirir. Seçtiğiniz GV o kolonun açılır liste kaynağı olur: kolon, bu GV'nin key/label değerleriyle her formda otomatik bir dropdown olarak görünür — alanı tek tek her formda yapılandırmanıza gerek kalmaz. Böylece veri katmanındaki anlam (Option + GV) doğrudan arayüze taşınır.When a column's Orbion Type is set to Option, a Global Variable picker appears next to it. The GV you choose becomes the column's dropdown source: the column shows up as an automatic dropdown in every form using this GV's key/label — no need to configure the field per form. The meaning defined at the data layer (Option + GV) flows straight to the UI.

AdımlarSteps

1. Connections'ta bir PostgreSQL veya SQLite bağlantısı açın (Test → Save).Create a PostgreSQL or SQLite connection in Connections (Test → Save).
2. Veri editöründe tabloyu oluşturun/kolonları ekleyin ve verinizi girin.In the Data editor create the table/add columns and enter your data.
3. Her kolona doğru Orbion Type'ı verin (User/Date/Option…).Set the right Orbion Type per column (User/Date/Option…).
4. Option kolonlarını bir Global Variable'a bağlayın (Bölüm 4); artık o alan tüm formlarda dropdown olarak gelir.Link Option columns to a Global Variable (Section 4); the field now appears as a dropdown across all forms.

3 · Kimlik ve YetkiIdentity & Access

Amaç ve erişim modeliPurpose & access model

Bu modül kimlerin giriş yapacağını, hangi gruplara/organizasyonlara ait olduklarını ve neyi görüp düzenleyebileceklerini belirler. Üç ana ekran vardır: Users (kullanıcılar), Groups (gruplar) ve Companies (organizasyon/şirket). Erişim bu üçünün birleşiminden doğar:This module defines who can sign in, which groups/organizations they belong to, and what they can see and edit. There are three main screens: Users, Groups and Companies (organization). Access emerges from the combination of all three:

Kullanıcılar (Users)Users

Bir kullanıcının düzenleyicisi üç sekmeden oluşur: General, Security, Custom Fields. Üstte avatar, ad, @loginName, rol rozeti ve durum görünür.A user's editor has three tabs: General, Security, Custom Fields. The header shows the avatar, name, @loginName, a role badge and the status.

General sekmesi — kimlik alanlarıGeneral tab — identity fields

Custom FieldsCustom Fields

Yöneticinin tanımladığı ek kullanıcı alanları (text/number/date/select/boolean). Manage Definitions ile alanlar tanımlanır; her kullanıcıda doldurulur.Admin-defined extra user fields (text/number/date/select/boolean). Define them via Manage Definitions; fill them per user.

Self-Registration (Public Signup)Self-Registration (Public Signup)

Kullanıcıların kendi kendine kayıt olabileceği herkese açık bir kayıt komponentidir; web sayfasına gömülebilir ve kaydı tamamlayınca Orbion'da bir kullanıcı oluşturur. Yeni kullanıcının organizasyonu, grubu ve başlangıç durumu Designer'da sabitlenir ve sunucuda zorlanır. Kayıt sonrası davranış form Rules ile yönetilir: onSaveSuccess / onSaveError (yönlendirme, mesaj, e-posta).A public registration component where users sign themselves up; embeddable on a web page, it creates a user in Orbion on completion. The new user's organization, group and initial status are configured in the Designer and enforced server-side. Post-signup behavior is handled by form Rules: onSaveSuccess / onSaveError (redirect, message, email).

Gruplar ve App AtamasıGroups & app assignment

Grup, kullanıcıları toplayan ve onlara hem yetenek hem uygulama erişimi dağıtan birimdir. Dört sekmesi vardır: General (ad, renk, açıklama), Members (üye ekle/çıkar), Capabilities (üyelerin otomatik miras aldığı yetenekler) ve Portal Apps (üyelerin portalda göreceği uygulamalar).A group gathers users and distributes both capabilities and app access to them. It has four tabs: General (name, color, description), Members (add/remove users), Capabilities (caps members inherit automatically), and Portal Apps (the apps members see in the portal).

Yetenekler (Capabilities)Capabilities

Yetenekler, izinleri etiketleyen serbest anahtarlardır (ör. isadmin, premium, reports). Kullanıcıya doğrudan verilebilir ya da bir grup üzerinden miras alınır; ikisinin birleşimi Effective (etkin) yeteneklerdir. Kurallar, sorgular ve görünürlük koşullarında "kullanıcının şu yeteneği var mı?" diye sınanır (Bölüm 6.11–6.12).Capabilities are free permission tags (e.g. isadmin, premium, reports). They can be granted directly to a user or inherited via a group; their union is the Effective set. Rules, queries and visibility conditions test "does the user have this capability?" (Sections 6.11–6.12).

Organizasyon (Companies)Organization (Companies)

Companies ekranı şirket ve departman hiyerarşisini tutar. Her kullanıcı bir şirket + departman'a ve bir yöneticiye bağlanır; bu, organizasyon şemasını ve veri kapsamını oluşturur.The Companies screen holds the company and department hierarchy. Each user is linked to a company + department and a manager; this builds the org chart and data scope.

• Company — ad, kısa ad (shortName), vergi no, logo vb.Company — name, short name, tax id, logo, etc.
• Department — şirket içinde alt birimler; iç içe (parent) olabilir. Kullanıcı şirketi seçilince departman listesi süzülür.Department — sub-units within a company; can be nested (parent). Selecting a user's company filters the department list.
• Manager — kullanıcının üstü; onay akışlarında {{user.manager}} olarak da kullanılır.Manager — the user's superior; also used as {{user.manager}} in approval flows.

Şifre & güvenlik işlemleriPassword & security operations

Kurulum sırasıSetup order

1. Companies: şirket ve departman yapısını oluşturun.Companies: build the company and department structure.
2. Groups: rol/ekip gruplarını açın; Capabilities ve Portal Apps'i atayın.Groups: create role/team groups; assign Capabilities and Portal Apps.
3. Users: hesapları açın (rol, durum, parola), şirket/departman/yönetici ve grup üyeliklerini verin.Users: create accounts (role, status, password), set company/department/manager and group memberships.
4. App içindeki menü/form erişimini allowedGroups ile inceltin (Bölüm 5–6).Refine menu/form access inside apps via allowedGroups (Sections 5–6).

4 · Global DeğişkenlerGlobal Variables

Global Variable nedir?What is a Global Variable?

Bir Global Variable, bir veritabanı kolonunun değerlerini tüm formlar ve filtreler arasında paylaşılan, önbelleğe alınmış (cached) bir listeye dönüştürür. Açılır listeleri (combobox/filtre) tek bir merkezi kaynaktan beslersiniz: kolonu bir kez tanımlarsınız, her formda tekrar tekrar sorgu yazmazsınız. Üst çubuktaki ⚡ Global Variables düğmesinden yönetilir.A Global Variable turns the values of a database column into a shared, cached list across all forms and filters. You feed dropdowns (combobox/filter) from one central source: define the column once instead of rewriting queries in every form. Managed from the ⚡ Global Variables button in the top bar.

Key / Value (saklanan vs görünen)Key / Value (stored vs shown)

İki kolon ayrımı kritiktir:The two-column distinction is key:

Önbellekleme (Caching)Caching

Global Variable'lar form başına değil, veri-kaynağı seviyesinde (connection · schema · table · column) önbelleğe alınır — aynı kolonu kullanan tüm filtreler tek bir önbellek girdisini paylaşır. Bu, açılır listeleri her açılışta yeniden sorgulamadan hızlı tutar.Global Variables are cached at the data-source level (connection · schema · table · column), not per form — all filters using the same column share one cache entry. This keeps dropdowns fast without re-querying on every open.

Bağımlı (Cascading) listelerCascading (dependent) lists

Bir Global Variable'a Parent Column (FK) verirseniz, onu kullanan alan/filtre başka bir alanın seçimine göre süzülebilir. Tüketim tarafında alt liste, üst seçime Depends On ile bağlanır. Klasik örnek: Ülke → Şehir → İlçe.If you give a Global Variable a Parent Column (FK), a field/filter using it can be filtered by another field's selection. On the consuming side, the child list is bound to the parent via Depends On. Classic example: Country → City → District.

Kullanım — bir GV'yi alana bağlamakUsage — binding a GV to a field

• Combobox / List alanı: alanın veri kaynağını (dataLink) Variable yapın ve listeden Global Variable'ı seçin. Seçeneklerin key/label'ı GV'den gelir (Bölüm 6.2).Combobox / List field: set the field's data source (dataLink) to Variable and pick the Global Variable. The options' key/label come from the GV (Section 6.2).
• Filtre: filtre değerini bir GV'den seçtirin; bağımlıysa Depends On ile üst filtreye bağlayın.Filter: source the filter value from a GV; if dependent, bind it to the parent filter via Depends On.

AdımlarSteps

1. ⚡ Global Variables → + Add Variable; ad verin.⚡ Global Variables → + Add Variable; name it.
2. Connection → Schema → Table → Column seçin; gerekiyorsa Label Column ve Parent Column ekleyin.Pick Connection → Schema → Table → Column; add Label Column and Parent Column if needed.
3. Fetch Mode (Cached/Live) ve TTL'i ayarlayıp Enabled ile kaydedin.Set Fetch Mode (Cached/Live) and TTL, keep it Enabled, and save.
4. Bir combobox alanında kaynağı Variable seçip bu GV'yi bağlayın; cascade için Depends On verin. Değişiklik sonrası ↻ Refresh ile önbelleği tazeleyin.On a combobox field, set source to Variable and bind this GV; add Depends On for cascade. After changes, ↻ Refresh the cache.

5 · Uygulamalar ve Menüler (Apps)Apps & Menus

Amaç — her şeyin birleştiği yerPurpose — where it all comes together

Bir App (uygulama), tüm yapı taşlarını — formlar, sorgu presetleri, gruplar — son kullanıcının kullandığı tek bir ürüne dönüştürdüğünüz yerdir. Buraya kadar tasarladığınız formları menüler altında düzenler, her menü öğesine bir form + (opsiyonel) preset bağlar, erişimi gruplara açar, görünümü (ikon/renk/tema/menü konumu) belirler ve portal üzerinden yayınlarsınız. Yapı üç katmanlıdır: App → Module → Menu item.An App is where you turn all the building blocks — forms, query presets, groups — into one product the end user actually uses. You arrange the forms you designed under menus, link each menu item to a form + (optional) preset, open access to groups, set the look (icon/color/theme/menu position) and publish via the portal. The structure is three layers: App → Module → Menu item.

5.1 · Uygulama oluşturma5.1 · Creating an app

＋ New App ile bir uygulama açarsınız. Ayarlar uygulamanın kimliğini ve portaldaki görünümünü belirler:＋ New App creates an application. Its settings define the app's identity and portal look:

5.2 · Modüller (menü grupları)5.2 · Modules (menu groups)

Modüller, menü öğelerini gruplayan başlıklardır (portal menüsünde bölüm başlığı gibi). ＋ Add Module ile eklenir.Modules are headings that group menu items (like a section header in the portal menu). Add via ＋ Add Module.

5.3 · Menü öğeleri (form bağlama)5.3 · Menu items (linking forms)

Her menü öğesi bir form tasarımını menüye getirir. ＋ Add Form ile eklenir; formu, başlığını, presetini ve erişimini burada belirlersiniz.Each menu item brings a form design into the menu. Add via ＋ Add Form; here you set the form, its title, preset and access.

5.4 · Sıralama, erişim ve portal sonucu5.4 · Ordering, access & the portal result

Modülleri ve menü öğelerini ↑↓ ile sıralarsınız; bu sıra portalda birebir görünür. Erişim iki katmanlıdır: uygulamaya girme grubun Portal Apps'inden (Bölüm 3), uygulama içindeki her modül/öğenin görünmesi Group Access (allowedGroups)'tan gelir. Sonuç, son kullanıcının gördüğü portaldır:You order modules and menu items with ↑↓; that order shows verbatim in the portal. Access is two layers: reaching the app comes from the group's Portal Apps (Section 3), and each module/item's visibility comes from Group Access (allowedGroups). The result is the portal the end user sees:

AdımlarSteps

1. Apps → ＋ New App: ikon/renk/ad, tema, public access ve menü konumunu ayarlayın.Apps → ＋ New App: set icon/color/name, theme, public access and menu position.
2. ＋ Add Module ile menü gruplarını oluşturun (biri DEFAULT).Create menu groups with ＋ Add Module (one DEFAULT).
3. Her modüle ＋ Add Form ile menü öğeleri ekleyin: form + (preset) + başlık + grup erişimi. Aynı formu farklı presetlerle çoğaltın.Add menu items to each module via ＋ Add Form: form + (preset) + title + group access. Reuse a form with different presets.
4. ↑↓ ile sırayı ve DEFAULT açılış ekranını ayarlayın.Set order with ↑↓ and the DEFAULT landing screen.
5. Grubun Portal Apps'ine ekleyip (Bölüm 3) Launch URL'den portalı test edin.Add it to a group's Portal Apps (Section 3) and test the portal from the Launch URL.

5.5 · App Export / Import (Taşınabilirlik)App Export / Import (Portability)

Bir uygulamayı tüm bağımlılıklarıyla (formlar, query'ler, global değişkenler, menü yapısı) tek bir paket olarak dışa aktarıp başka bir ortama (örn. Geliştirme → Üretim) taşıyabilirsiniz.Export an app with all its dependencies (forms, queries, global variables, menu structure) as a single package and move it to another environment (e.g., Dev → Prod).

Neden gerekli — mantığı. Bir uygulama tek bir nesne değildir; birbirine iç id'lerle bağlı bir nesne ağıdır (form → query → global değişken → menü). Tek bir formu elle kopyalamak bağımlılıklarını geride bırakır ve id'ler ortamdan ortama farklı olduğu için referanslar kırılır. Export/Import bu sorunu dört adımda çözer:Why it matters — the logic. An app is not a single object; it is a graph of objects linked by internal ids (form → query → global variable → menu). Copying one form by hand leaves its dependencies behind, and because ids differ between environments the references break. Export/Import solves this in four steps:

1. Kapanış (closure) toplama — uygulamadan erişilen tüm formlar, query'ler ve GV'ler bir JSON ağacında toplanır; hiçbir bağımlılık dışarıda kalmaz.Collect the closure — every form, query and GV reachable from the app is gathered into one JSON tree; no dependency is left out.
2. Origin damgası — her nesne kaynak kimliğiyle (originId) damgalanır; böylece "aynı mantıksal nesne" iki ortamda da tanınır.Origin stamp — each object is stamped with its source identity (originId), so the "same logical object" is recognized in both environments.
3. Referans yeniden yazımı — import'ta iç id referansları hedef ortamın yeni id'lerine yeniden bağlanır; ağ kırılmadan kurulur.Reference rewrite — on import, internal id references are rebound to the target's new ids; the graph is rebuilt intact.
4. Idempotent yükleme — ikinci import aynı originId'leri günceller, yeni nesneleri ekler. Yani Dev → Prod terfisi tekrarlanabilirdir.Idempotent load — a second import updates the same originIds and adds new objects. So Dev → Prod promotion is repeatable.

5.6 · App erişim linkleri & gömülü LoginApp access links & embedded Login

Bir uygulamaya portalı atlayarak doğrudan erişen token'lı bağlantılar üretebilirsiniz. Token geçerliyse kullanıcı doğrudan uygulamada açılır; değilse uygulamanın içine gömülü Login Form komponenti devreye girer.Generate token-based links that open an app directly, bypassing the portal. If the token is valid the user lands straight in the app; otherwise the embedded Login Form component takes over.

Nedir, neden — mantığı. Normalde kullanıcı bir uygulamaya portal üzerinden, merkezi girişten sonra ulaşır. Bazen ise bir kişiye (çoğu kez dış kullanıcıya) tüm portalı açmadan tek bir uygulamaya doğrudan bağlantı vermek istersiniz: bir başvuru formu, bir müşteri portalı vb. Erişim linki bunu bir token ile yapar. Mantık şudur: link açıldığında token geçerliyse kullanıcı doğrudan o uygulamaya düşer; değilse (süresi dolmuş ya da yok) merkezi giriş sayfasına yönlendirmek yerine, uygulamanın içindeki gömülü Login Form kimlik bilgisini toplar. Her iki durumda da oturum o tek uygulamaya sabitlenir (App Scope); kullanıcı başka uygulamalara geçemez. Yetki (token + grup izinleri) sunucuda doğrulanır; çıkışta (logout) scope temizlenir ve gömülü girişe dönülür.What it is, why — the logic. Normally a user reaches an app through the portal after a central sign-in. Sometimes you want to give someone (often an external user) a direct link to a single app — an application form, a customer portal — without exposing the whole portal. An access link does this with a token. The logic: when the link opens, if the token is valid the user drops straight into that app; if not (expired or none), instead of redirecting to the central login page, the embedded Login Form inside the app collects credentials. In both cases the session is hard-scoped to that one app (App Scope); the user cannot reach other apps. Authorization (token + group permissions) is verified server-side; on logout the scope is cleared and the user returns to the embedded login.

6 · Formlar ve DesignerForms & Designer

AmaçPurpose

Veriyi gösteren ve düzenleten ekranlar tasarlamak. Designer; sol palet (komponentler), orta tuval (yerleşim) ve sağ özellik panelinden oluşur.Design the screens that display and edit data. The Designer has a left palette (components), a center canvas (layout) and a right properties panel.

Form temelleriForm basics

• Data source — formun ana bağlantı + tablosu. Komponentler bunu miras alır.the form's connection + table. Components inherit it.
• Layout — 12 kolonluk ızgara; her komponentin width ve order'ı vardır.a 12-column grid; each component has a width and order.
• Rules & buttons — koşullu görünürlük, validasyon ve aksiyon butonları.conditional visibility, validation, and action buttons.

Design ve Live modlarıDesign & Live modes

Designer'ın üst çubuğunda iki mod düğmesi vardır: ◳ Design ve ▶ Live. Aynı formu iki açıdan görürsünüz — biri kurguladığınız, diğeri son kullanıcının gördüğü hâl.The Designer's top bar has two mode buttons: ◳ Design and ▶ Live. You see the same form from two angles — the one you build, and the one your end user sees.

• ◳ Design — kurgu tuvali. Komponentleri sürükler, 12-kolon ızgaraya yerleştirir, sağ panelden veri/görünüm/link, kural ve butonlarını ayarlarsınız. Tabloyu, grafiği, takvimi burada temsilî yer-tutucu (placeholder) olarak görürsünüz — gerçek veri çekilmez, yalnızca yerleşim ve yapı.the design canvas. You drag components onto the 12-column grid and configure their data/appearance/link, rules and buttons from the right panel. Data components (table, chart, calendar) appear as placeholders here — no real data is queried, only layout and structure.
• ▶ Live — canlı önizleme. Kaydedilmiş formu, portalda son kullanıcının gördüğüyle birebir aynı şekilde gömülü bir çerçevede render eder: gerçek veri, gerçek komponentler, tıklanabilir/çalışır hâlde. Yaptığınız tasarımı yayına almadan burada görürsünüz.the live preview. It renders the saved form in an embedded frame exactly as the end user sees it in the portal: real data, real components, fully interactive. You see your design as it will actually run — before publishing.

6.1 · Komponent listesi (özet)Component overview

Sürükle-bırak yerleştirme. Designer'da komponentler sürükle-bırak ile yerleştirilip yeniden sıralanır: paletten canvas'a bırakma, mevcut komponentleri yeniden sıralama, bir paneli içine/dışına taşıma; seçili komponenti Delete ile silme, Ctrl+D ile çoğaltma.Drag-and-drop placement. In the Designer, components are placed and reordered by drag-and-drop: drop from the palette onto the canvas, reorder existing components, move into/out of a panel; delete the selected component with Delete, duplicate with Ctrl+D.

6.2 · Alan komponentleri (Fields)Field components

Amaç: Tekil veri girişi/gösterimi. Her alanın Field Name'i formun tablosundaki bir kolona karşılık gelir; kaydedince o kolona yazılır.Purpose: Single value entry/display. Each field's Field Name maps to a column in the form's table and is written back on save.

Her alanda ortak özelliklerProperties common to all fields

Alan tipleriField types

Açılır liste seçenek kaynağı (Combobox / List)Dropdown option source (Combobox / List)

Bir açılır listenin seçenekleri üç kaynaktan gelebilir. Ayrıca iki arama modu vardır:A dropdown's options can come from three sources. There are also two search modes:

• Enable Search — yüklenmiş seçenekler arasında yerel filtre kutusu.a local filter box over the already-loaded options.
• Live Search — kullanıcı yazdıkça DB'den sorgular; binlerce kayıtlı alanlar için. Seçilen değer metin olarak gösterilir.queries the DB as the user types; for fields with thousands of records. The selected value shows as text.

Bağlı (cascading) alanlarDependent (cascading) fields

Bir açılır listeyi başka bir alanın değerine göre süzmek için Cascade — Parent field ayarını kullanın: üst alan değişince alt listenin seçenekleri yeniden filtrelenir.To filter a dropdown by another field's value, use Cascade — Parent field: when the parent field changes, the child list's options re-filter.

User / Group / Organization seçicileriUser / Group / Organization pickers

Bu alanlar bir kişi, grup veya organizasyon seçtirir. Field Name kolonuna seçilenin ID'si yazılır; ekranda ad (ve kullanıcıda avatar) gösterilir. Hepsinde Enable Search / Live Search ve Placeholder vardır.These fields let the user pick a person, group or organization. The selected ID is written to the Field Name column; the name (and avatar for users) is shown. All support Enable Search / Live Search and a Placeholder.

Tipe özel özelliklerType-specific properties

Picture / Avatar alanı. Formlara fotoğraf/avatar alanı eklenebilir: dosya yükleme veya cihaz kamerasından çekim. Profil resmi ve kayıt görselleri için kullanılır.Picture / Avatar field. Forms can include a photo/avatar field: upload a file or capture from the device camera — used for profile pictures and record images.

6.3 · Table

Amaç: Bir tablonun satırlarını liste olarak göstermek; arama, sıralama, sayfalama, satır seçimi, hücre linkleri ve değere göre renklendirme. Dört sekmesi vardır: Data · Columns · Appearance · Behavior.Purpose: Show a table's rows as a list; search, sort, paging, row selection, cell links and value-based coloring. It has four tabs: Data · Columns · Appearance · Behavior.

Data

• Table — bu tablonun kaynağı. Boş bırakılırsa formun tablosu kullanılır; farklı bir tablo seçilirse bağımsız (child) tablo olur.Table — this table's source. If blank, the form's table is used; if a different table is chosen it becomes a standalone (child) table.
• Link Parameters — bağımsız tabloyu ana satıra bağla (Parent→Child); master-detay (Bölüm 6.10).Link Parameters — bind a standalone table to the master row (Parent→Child); master-detail (Section 6.10).

Columns — kolon özellikleriColumns — per-column properties

Koşullu biçimlendirme (hücre kuralları)Conditional formatting (cell rules)

Bir kolonun hücrelerini değerine göre renklendirir. Önce bir Stil seçilir, sonra kural listesi tanımlanır. İlk eşleşen kural kazanır.Colors a column's cells by value. First pick a Style, then define a list of rules. The first matching rule wins.

Her kural = Operatör + Değer + Arka plan rengi + Yazı rengi. Operatörler: = · ≠ · > · < · ≥ · ≤ · contains · empty · not empty. (empty/not empty değer almaz.)Each rule = Operator + Value + Background + Text color. Operators: = · ≠ · > · < · ≥ · ≤ · contains · empty · not empty. (empty/not empty take no value.)

Satır renklendirme (Row Coloring)Row coloring (Row rules)

Appearance sekmesinde: tüm satırı bir değere göre renklendirir. Her kural Alan + Operatör + Değer → Satır rengi. Yine ilk eşleşen kazanır.On the Appearance tab: colors the whole row by a value. Each rule is Field + Operator + Value → Row color. Again, first match wins.

Hücre linki (Cell link)Cell link

Bir kolonu tıklanır yapar. Type: Navigate / Open Window · Form (açılacak) · pencere için başlık, konum (Center/Left/Right/Absolute), genişlik/yükseklik · Parameters: kaynak kolon → p_paramName (değer hedef forma aktarılır).Makes a column clickable. Type: Navigate / Open Window · Form to open · for windows: title, position (Center/Left/Right/Absolute), width/height · Parameters: source column → p_paramName (value passed to the target form).

Behavior

Mobil görünüm (Appearance). Tablolar için bir mobil mod ayarı vardır. Cards seçildiğinde dar ekranlarda her satır "Etiket : değer" şeklinde kaydırılabilir bir karta dönüşür; boş hücreler hizalı bir "—" ile gösterilir. Scroll (varsayılan) ise kolonları okunaklı genişlikte tutup tabloyu yana kaydırır.Mobile layout (Appearance). Tables have a mobile mode. With Cards, on narrow screens each row becomes a swipeable "Label : value" card; empty cells show an aligned "—". Scroll (default) keeps columns readable and scrolls the table sideways.

6.4 · Grafikler (Charts)Charts

Tipler: Bar · Line · Area · Pie · Donut · Number (tek KPI değeri) · Gantt. Her grafik bir tabloyu toplulaştırarak (group-by + aggregate) çizer.Types: Bar · Line · Area · Pie · Donut · Number (single KPI value) · Gantt. Each chart aggregates a table (group-by + aggregate).

İki kurgu yöntemiTwo ways to define data

Boyutlar (Dimensions) ve Ölçüler (Measures)Dimensions & Measures

• Boyut · rol = Axis → X ekseni (gruplama). rol = Series → renkli kırılım.Dimension · role = Axis → X axis (grouping). role = Series → colored breakdown.
• Ölçü = Aggregation (COUNT, SUM, AVG, MIN, MAX) + alan + etiket + eksen (sol/sağ).Measure = Aggregation (COUNT, SUM, AVG, MIN, MAX) + field + label + axis (left/right).
• Seri sayısı = (Series-boyutları) × (Ölçüler); her ölçü ayrı bir stack'tir.Series = (Series dimensions) × (Measures); each measure is a separate stack.

Diğer ayarlarOther settings

Drill-through

Bir çubuğa/dilime tıklayınca, o değere filtreli bir form açar (pencere veya yönlendirme). Tıklanan grup değeri (ve tarih gruplamada sayısal anahtar) hedef forma parametre olarak geçer — böylece "Haziran" çubuğuna tıklayan kullanıcı yalnız Haziran kayıtlarını görür.Clicking a bar/slice opens a form filtered to that value (window or navigate). The clicked group value (and the numeric key for date grouping) is passed as a parameter to the target form — so a user clicking the "June" bar sees only June records.

Link Parameters & Custom SQL

• Link Parameters — ana satır seçilince grafiği o satıra göre süz (Parent→Child; Bölüm 6.10).filter the chart by the selected master row (Parent→Child; Section 6.10).
• Custom SQL — ileri seviye: doğrudan SQL yazın; sonuç kolonlarını AS label, AS value olarak verin; drill için AS grpkey ekleyin. Link/filtre WHERE'leri otomatik enjekte edilir.advanced: write raw SQL; expose result columns as AS label, AS value; add AS grpkey for drill-through. Link/filter WHEREs are injected automatically.

6.5 · Board (Kanban)Board (Kanban)

Amaç: Kayıtları durum kolonlarında kart olarak göstermek; bir kartı başka kolona sürükleyip bırakınca durum alanı DB'de güncellenir. Dört sekme: Data · Cards · Appearance · Behavior.Purpose: Show records as cards in status columns; dragging a card to another column updates the status field in the DB. Four tabs: Data · Cards · Appearance · Behavior.

6.6 · Calendar

Amaç: Bir tablonun tarih alanlarına göre kayıtları takvimde göstermek. Çok günlük kayıtlar tek bir spanning bar olarak çizilir; uçlarından sürükleyerek tarih değiştirilebilir.Purpose: Show table rows on a calendar by their date fields. Multi-day records render as one spanning bar; drag the edges to change dates.

Data

Appearance

Language (ay/gün adları, Today/Month/Week/Day — 7 dil + Auto), varsayılan görünüm, hafta başlangıcı, saat aralığı, yükseklik, kategori renkleri.Language (month/day names and Today/Month/Week/Day — 7 languages + Auto), default view, week start, hour range, height, category colors.

Link

Kimliğe tıklayınca form açma (pencere/yönlendirme), pencere konumu ve tıklanan satırdan ek parametreler geçme.Open a form on id click (window/navigate), window position, and pass extra parameters from the clicked row.

6.7 · Tree

Amaç: Kendine-referanslı bir tablodaki (satırda id ve parentId) hiyerarşiyi ağaç olarak göstermek — kategori, bölge, organizasyon şeması, BOM.Purpose: Render the hierarchy of a self-referencing table (each row has id and parentId) as a tree — categories, regions, org charts, BOM.

Data

Appearance

Load mode: Full (tüm satırlar — anında aç/kapa) veya Lazy (çocuklar açılınca yüklenir — devasa ağaçlar). Default expand, Allow drag re-parent (sürükle-bırakla parentId güncelle), dil, yükseklik, kategori renkleri.Load mode: Full (all rows — instant expand) or Lazy (children loaded on expand — huge trees). Default expand, Allow drag re-parent (drag-drop to update parentId), language, height, category colors.

Link & SüzmeFiltering

Calendar ile aynı: node tıklayınca form aç + parametreler; Link Parameters (filter) ile ağacı süz.Same as Calendar: open a form on node click + parameters; filter the tree via Link Parameters (filter).

6.8 · Viewer

Amaç: Dosya/içerik gösterimi: PDF · Word · Excel · CSV · Görsel · Video · Audio · Markdown · HTML · Code.Purpose: Display file/content: PDF · Word · Excel · CSV · Image · Video · Audio · Markdown · HTML · Code.

• Kaynak: yüklenen dosya veya bir dış URL (URL önceliklidir; izole iframe'de açılır).Source: an uploaded file or an external URL (URL takes priority; shown in an isolated iframe).
• Not: Hedef site X-Frame-Options/CSP ile çerçevelemeyi engelliyorsa tarayıcı bloklar (bu uzak sitenin ayarıdır).Note: If the target site forbids framing via X-Frame-Options/CSP, the browser blocks it (that is the remote site's setting).

6.9 · Panel ve TabPanel & Tab

Amaç: Diğer komponentleri gruplayan kapsayıcılar. İçlerine alan, tablo, grafik, board, calendar ve tree koyulabilir.Purpose: Containers that group other components. They can hold fields, tables, charts, boards, calendars and trees.

6.10 · Filtre, Link ve ReloadFilters, Links & Reload

Filter paneliFilter panel

Form üzerindeki Filter paneli; tablo, grafik, board, calendar ve tree komponentlerini birlikte süzer. Komponent farklı bir datasource kullanıyorsa filtre alanı Link Parameters (Parent → Child) ile doğru kolona çevrilir.The form's Filter panel filters table, chart, board, calendar and tree together. If a component uses a different datasource, the filter field is mapped to the right column via Link Parameters (Parent → Child).

Master-detayMaster-detail

Ana tabloda bir satır seçilince, ona Link Parameters ile bağlı komponentler o satıra göre yeniden sorgulanır.When a row is selected in the master table, components linked via Link Parameters re-query for that row.

Tıklayınca form açmaOpen-on-click

Link sekmesi: pencere (konumlandırılabilir, küçültülebilir) veya yönlendirme. Tıklanan satırdan ek parametreler hedef forma aktarılır.Link tab: window (positionable, minimizable) or navigate. Extra parameters from the clicked row are passed to the target form.

Arama alanları (Search Fields). Bir alan isSearchField olarak işaretlenebilir; kullanıcı bu alanlara değer girip Search ile tabloyu filtreler, Clear Search ile sıfırlar. Değerler WHERE kurallarına çevrilir. Tablolar iki yoldan yüklenebildiği için (ana tablo ve alt/ilişkili tablo) filtre her ikisini de kapsar.Search fields. A field can be marked isSearchField; the user fills these, then filters the table with Search and resets with Clear Search. Values become WHERE rules. Since tables can load via two paths (main and child/related), the filter covers both.

6.11 · Rules (Kurallar)(Rules)

Amaç: Form üzerinde koşullu otomasyon. Bir kural üç parçadan oluşur: Tetikleyici → Koşullar → Aksiyonlar. Form sekmelerinden Rules ile yönetilir.Purpose: Conditional automation on a form. A rule has three parts: Trigger → Conditions → Actions. Managed from the Rules form tab.

1 · Tetikleyici (When)Trigger (When)

Kuralı neyin çalıştıracağını seçer:Selects what runs the rule:

2 · Koşullar — iki blokConditions — two blocks

Aksiyonlar yalnız koşullar sağlanınca çalışır. İki bağımsız blok birlikte değerlendirilir:Actions run only when conditions hold. Two independent blocks are evaluated together:

a) User koşullarıa) User conditions — kuralı kime uygulayacağınızı belirler (yetki/rol kapısı). AND/OR ile çoklu.gate the rule by who the user is (a permission/role gate). Multiple, AND/OR.

b) Field koşullarıb) Field conditions — Alan + Operatör + Değer. Operatörler: = ≠ > < ≥ ≤ contains between in empty/notEmpty. AND/OR. Hiç koşul yoksa kural her zaman çalışır.Field + Operator + Value. Operators: = ≠ > < ≥ ≤ contains between in empty/notEmpty. AND/OR. With no conditions the rule always runs.

3 · Aksiyonlar (Then)Actions (Then)

Koşullar sağlanınca çalışacak bir veya daha fazla aksiyon. Her aksiyonun bir hedefi (alan/komponent) vardır:One or more actions that run when conditions are met. Each action has a target (field/component):

Aksiyon ayrıntıları (her aksiyonun ayarları)Action details (settings of each action)

• Show message — Tip (Normal · Info · Success · Warning · Error) + Başlık + zengin Gövde. İkisinde de {{Alan}} değişkeni.Type (Normal · Info · Success · Warning · Error) + Title + rich Body. Both accept {{Field}}.
• Navigate to — Hedef: Form veya Menu Item. Open in Window (başlık · konum Center/Left/Right/Absolute · genişlik/yükseklik). Parametreler: hedef alan ← Fixed (sabit) veya Field (kaynak alan).Target: Form or Menu Item. Open in Window (title · position Center/Left/Right/Absolute · width/height). Parameters: target field ← Fixed or Field (source).
• Send email — To / CC / BCC (Enter ile çoklu adres) + Subject + zengin Body; {{Alan}} destekli.To / CC / BCC (multiple, Enter to add) + Subject + rich Body; supports {{Field}}.
• Write to table — Connection → Schema → Table + Field Mappings: hedef kolon ← Field / Static / Built-in (Now, Current User…).Connection → Schema → Table + Field Mappings: target column ← Field / Static / Built-in (Now, Current User…).
• Trigger workflow — Listeden bir workflow seç; mevcut kayıt bağlamı akışa geçer.Pick a workflow from the list; the current record context is passed.
• Limit field options / Limit values — Bir alanın kabul ettiği değerleri sınırla: Fixed / Now / Current User·… veya tarih ifadeleri (now+5d).Restrict the values a field accepts: Fixed / Now / Current User·… or date expressions (now+5d).

AdımlarSteps

1. Form → Rules sekmesi → kural ekle.Form → Rules tab → add a rule.
2. Tetikleyiciyi seçin, koşulları (When) girin, AND/OR belirleyin.Pick the trigger, add conditions (When), set AND/OR.
3. Bir veya daha fazla aksiyon (Then) ekleyin; her birine hedef ve değer verin.Add one or more actions (Then); give each a target and value.
4. Kaydedin; kurallar yukarıdan aşağıya değerlendirilir (sürükleyerek sıralayın).Save; rules evaluate top to bottom (drag to reorder).

Koşul — "Record Exists". Bir kural koşulu olarak veritabanında kayıt sayısı (count) sorgulanabilir. Tipik kullanım: kaydetmeden önce (Before-Save) mükerrer kontrolü — aynı değere sahip kayıt varsa kaydı engelle. Koşul bir sorgu tipindedir ve prefetch-cache ile asenkron değerlendirilir.Condition — "Record Exists". A rule condition can query a record count in the database. Typical use: a before-save duplicate guard — block the save if a record with the same value exists. The condition is a query type, evaluated asynchronously via a prefetch cache.

Aksiyon — Uygulama-içi mesaj. Bir kural aksiyonu olarak kullanıcıya veya gruba uygulama-içi mesaj (bildirim) gönderilebilir; e-posta gönderme editörünün bir benzeri kullanılır. Alıcı bir grupsa mesaj üyelerine açılır.Action — In-app message. As a rule action, an in-app message (notification) can be sent to a user or group, using an editor similar to send-email. If the recipient is a group, the message expands to its members.

6.12 · Queries (Sorgular)(Queries)

Amaç: Bir formun verisinin önceden filtrelenmiş görünümleri (Query Presets). Adlandırılmış bir sorgu, bir menü öğesine Query Preset olarak bağlanır (Bölüm 5); o menüden açılınca form yalnız filtreye uyan kayıtları gösterir. Aynı form farklı menülerde farklı sorgularla görünebilir: "Açık Çağrılar", "Benim Kayıtlarım", "Bekleyen Onaylar"…Purpose: Pre-filtered views of a form's data (Query Presets). A named query is attached to a menu item as a Query Preset (Section 5); opening the form from that menu shows only the matching rows. The same form can appear under different menus with different queries: "Open Issues", "My Records", "Pending Approvals"…

Koşul anatomisiCondition anatomy

Her koşul = Alan + Operatör + Değer kaynağı + Değer, AND/OR ile birleşir. Koşul yoksa sorgu tüm satırları gösterir.Each condition = Field + Operator + Value source + Value, combined with AND/OR. With no conditions the query shows all rows.

OperatörlerOperators

Değer kaynağıValue source

Approval State (onay durumu)Approval State

Onay-etkin formlarda özel bir koşul: kayıtları onay durumuna göre süz — Waiting Approvals (bekleyen) · Approved Records · Rejected Records · All Approvals.On approval-enabled forms, a special condition that filters by approval state — Waiting Approvals · Approved Records · Rejected Records · All Approvals.

Bir preset'i kullanmakUsing a preset

AdımlarSteps

1. Form → Queries sekmesi → + Add Query; bir ad verin.Form → Queries tab → + Add Query; name it.
2. Koşulları ekleyin (Alan/Operatör/Değer kaynağı/Değer), AND/OR seçin.Add conditions (Field/Operator/Value source/Value), choose AND/OR.
3. Kaydedin; Apps'te bir menü öğesine Query Preset olarak atayın (Bölüm 5).Save; assign it as a Query Preset on a menu item in Apps (Section 5).

Preset'ten kayıt yükleme (tablosuz form). Bir tabloya bağlı olmayan kayıt formu, bir Query preset üzerinden tek kayıt yükleyebilir — örneğin oturum açan kullanıcının kendi profilini CurrentUser.username gibi değer tipleriyle getirme.Preset record load (table-less form). A record form not bound to a table can load a single record via a Query preset — e.g., fetching the signed-in user's own profile using value types like CurrentUser.username.

6.13 · Buttons (Butonlar)(Buttons)

İki tür: Canvas butonu (forma yerleştirilen) ve Panel butonu (formun alt aksiyon çubuğundaki global butonlar — panelButtons; onay formlarında approvalPanelButtons). Her butonun üç sekmesi vardır.Two kinds: a Canvas button (placed on the form) and a Panel button (global buttons in the form's bottom action bar — panelButtons; approvalPanelButtons on approval forms). Each button has three tabs.

Aksiyon tipleriAction types

7 · İş Akışları ve OnaylarWorkflows & Approvals

AmaçPurpose

Workflow, olaylara (kayıt eklendi/değişti, buton, zamanlanmış tetik) bağlı çok adımlı otomasyonlar kurduğunuz görsel bir tasarımcıdır. Node'ları (kutuları) bir tuvale dizip oklarla bağlarsınız; akış yukarıdan aşağı çalışır: kayıt sorgular, döngü kurar, e-posta/bildirim gönderir, kayıt oluşturur/günceller, dış servis çağırır, onay bekler. Her bir node sağ panelden yapılandırılır; akış kaydedilir, test edilir ve loglardan izlenir.A Workflow is a visual designer where you build multi-step automations bound to events (record created/changed, button, scheduled trigger). You drop nodes (boxes) on a canvas and connect them with arrows; the flow runs top-to-bottom: query records, loop, send email/notification, create/update records, call an external service, wait for approval. Each node is configured from the right panel; the flow is saved, tested, and watched from the logs.

Toolbox — node tipleriToolbox — node types

Soldaki paletten node ekler, tuvalde dizer ve oklarla bağlarsınız. Her node'un kendi ayar paneli vardır.Add nodes from the left palette, arrange them on the canvas and wire them with arrows. Each node has its own settings panel.

Karmaşık node'lar (dallanan / bileşik)Compound & branching nodes

Çoğu node tek bir ▶ çıkışına sahiptir (sıradaki node'a bağlanır). Üç node ise birden çok çıkış portu taşır ve akışı dallandırır — bunlar workflow'un en güçlü ama en çok dikkat isteyen parçalarıdır.Most nodes have a single ▶ output (wired to the next node). Three nodes carry multiple output ports and branch the flow — these are the most powerful, and trickiest, parts of a workflow.

⟳ For Each — satır döngüsü⟳ For Each — row loop

Bir Query Records sonucundaki her satır için döngü gövdesindeki node'ları tekrar çalıştırır. En sık kafa karıştıran node budur; iki ayrı portu vardır.Re-runs the nodes in its loop body for each row of a Query Records result. This is the most commonly misunderstood node; it has two distinct ports.

⑂ Condition — koşullu dallanma⑂ Condition — conditional branch

Variable + Operator + Value değerlendirir; doğruysa ✓ Evet, değilse ✗ Hayır portundan devam eder. Operatörler: eq · neq · contains · > · < · >= · <=. Variable alanında {{...}} kullanılabilir (ör. {{row.Status}}).Evaluates Variable + Operator + Value; on true it continues from the ✓ Yes port, otherwise the ✗ No port. Operators: eq · neq · contains · > · < · >= · <=. The Variable can use {{...}} (e.g. {{row.Status}}).

◈ Approval — insan onayı◈ Approval — human approval

Akışı duraklatır, onaylayıcılara e-posta gönderir ve karar gelene kadar bekler; sonra ✓ Approved veya ✗ Rejected portundan dallanır.Pauses the flow, emails the approvers and waits for a decision; then branches from the ✓ Approved or ✗ Rejected port.

Veri & aksiyon node'larının ayarlarıData & action node settings

Nasıl tetiklenir? (Trigger kaynakları)How it's triggered (trigger sources)

Bir akış birden çok yolla başlayabilir; loglarda her çalışmanın kaynağı renkli bir rozetle gösterilir:A flow can start in several ways; in the logs each run shows its source as a coloured badge:

⏱ Schedule — zamanlanmış tetik⏱ Schedule — scheduled trigger

Araç çubuğundaki ⏱ Schedule akışı belirli aralıklarla otomatik çalıştırır. İki mod vardır:The toolbar's ⏱ Schedule runs the flow automatically on a recurring basis. Two modes:

≡ Execution Logs — çalışma kayıtları≡ Execution Logs

Araç çubuğundaki ≡ Logs her çalışmayı kaydeder (rozetteki sayı = toplam çalışma; ⚠ en az bir hata var demektir). Bir kaydı açınca adım adım zaman çizelgesi görünür — hangi node ne kadar sürdü, çıktısı ne, nerede hata oldu.The toolbar's ≡ Logs records every run (badge = total runs; ⚠ means at least one failure). Expanding an entry reveals a step-by-step timeline — which node ran, how long it took, its output, and where it failed.

Onaylar (Approval node)Approvals (Approval node)

Bir ◈ Approval node'u akışı duraklatır ve bir kullanıcı/gruba iş düşürür. Onaylayan Approval Inbox'tan karar verir; akış approval kaynağıyla kaldığı yerden sürer ve karara göre dallanır (onay → devam, ret → alternatif yol). Formların kendi onay akışı da vardır (panel butonları Approve/Reject/Cancel, Bölüm 6.13) — Approval State sorgularıyla (Bölüm 6.12) birlikte uçtan uca onay yönetimi sağlar.An ◈ Approval node pauses the flow and assigns a task to a user/group. The approver decides from the Approval Inbox; the flow resumes with the approval source and branches on the decision (approve → continue, reject → alternate path). Forms also have their own approval flow (Approve/Reject/Cancel panel buttons, Section 6.13) — together with Approval State queries (Section 6.12) this gives end-to-end approval management.

AdımlarSteps

1. Workflows → yeni akış; ad verin ve bir Linked app seçin.Workflows → new flow; name it and pick a Linked app.
2. Toolbox'tan node'ları ekleyip oklarla bağlayın; her node'u sağ panelden yapılandırın.Add nodes from the toolbox and wire them; configure each from the right panel.
3. Save → ▶ Test ile deneyin → ≡ Logs'tan sonucu doğrulayın.Save → try with ▶ Test → verify in ≡ Logs.
4. Gerekiyorsa ⏱ Schedule kurun; Active edip yayına alın. Form tarafında tetik için butona Workflow aksiyonu bağlayın (Bölüm 6.13).If needed set up ⏱ Schedule; switch Active on to go live. For a form trigger, bind a button's Workflow action (Section 6.13).

8 · EntegrasyonlarIntegrations

AmaçPurpose

Orbion'u dış sistemlerle bağlamak için kod yazmadan REST uç noktaları tanımlarsınız. Her entegrasyon bir bağlantı + tabloya bağlıdır, bir kimlik doğrulama ile korunur ve bir alan eşlemesi (mapping) ile JSON'u kolonlara çevirir. İki yön vardır:To connect Orbion with external systems you define REST endpoints without code. Each integration is bound to a connection + table, protected by an authentication, and translates JSON to columns via a field mapping. There are two directions:

🔒 Kimlik doğrulama ve güvenlik🔒 Authentication & security

Her uç nokta bir kimlik doğrulamayla korunur. İki tür desteklenir:Every endpoint is protected by an authentication. Two types are supported:

Alan eşlemesi (Field Mapping)Field mapping

Eşleme, gelen/giden JSON ile veritabanı kolonları arasındaki köprüdür. Mode iki türlüdür: Selective (yalnız listelenen alanlar işlenir; diğer JSON anahtarları yok sayılır) veya All (her alan aynı adlı kolona yazılır / her kolon dışa açılır).Mapping is the bridge between the JSON and database columns. Mode is either Selective (only the listed fields are processed; other JSON keys are ignored) or All (every field is written to a same-named column / every column is exposed).

Inbound — sıra (sequence) üretimiInbound — sequence generation

Bir hedef kolon, gelen JSON yerine sunucuda otomatik üretilebilir (anahtar/kod alanları için). Seq Type:A target column can be generated server-side instead of taken from the JSON (for key/code fields). Seq Type:

Outbound — satır filtresi (Row Filter)Outbound — row filter

Outbound'da hangi satırların dışa açılacağını denetler:On outbound, controls which rows are exposed:

• All rows — tüm tablo döner (varsa dinamik ?where='e tabi).returns the whole table (subject to any dynamic ?where=).
• Custom filter — her isteğe sabit bir SQL WHERE uygulanır (ör. "Status"='active' AND "Price">0; WHERE yazılmaz).a static SQL WHERE is applied to every request (e.g. "Status"='active' AND "Price">0; omit the WHERE keyword).
• Allow dynamic ?where= — açıkken çağıran istek anında ?where= ile ek filtre verebilir; bu, sabit filtreyle AND'lenir.when on, callers may pass a request-time ?where=; it is ANDed with the static filter.

Loglama ve Logs sekmesiLogging & the Logs tab

Her çağrı kaydedilir; nereye yazılacağını Storage belirler. Logs sekmesi kayıtları (UTC zaman, request id, durum…) listeler.Every call is logged; Storage decides where. The Logs tab lists entries (UTC time, request id, status…).

AdımlarSteps

1. Integrations → + New (inbound veya outbound); ad ve Status verin.Integrations → + New (inbound or outbound); set name and Status.
2. Authentication: API Key veya Basic seçin; anahtarı ⟳ Generate ile üretip kopyalayın.Authentication: pick API Key or Basic; ⟳ Generate the key and copy it.
3. Target/Source Table: bağlantı → şema → tablo seçin.Target/Source Table: pick connection → schema → table.
4. Field Mapping'i kurun (gerekiyorsa sequence/alias); outbound'da Row Filter'ı ayarlayın.Set up Field Mapping (sequence/alias if needed); configure the Row Filter on outbound.
5. Save → endpoint çubuğundaki URL ve API Docs ile test edin → Logs'tan doğrulayın.Save → test with the endpoint URL and API Docs → verify in Logs.

9 · E-posta ve BildirimlerEmail & Notifications

Amaç ve çalışma mantığıPurpose & how it works

Orbion e-postaları anında göndermez, bir kuyruğa alır. Arka planda çalışan bir gönderici servis kuyruğu belirli aralıklarla tarar ve SMTP üzerinden iletir; sonuç Sent (gönderildi) veya Failed (başarısız) klasörüne düşer. E-posta kaynakları üç tanedir: Workflow Notification/Approval node'ları (Bölüm 7), kullanıcı olayı şablonları (kullanıcı oluşturma, parola sıfırlama…) ve onay istekleri.Orbion does not send email instantly — it queues it. A background sender service scans the queue at a set interval and delivers via SMTP; results land in the Sent or Failed folder. Email comes from three sources: Workflow Notification/Approval nodes (Section 7), user-event templates (user create, password reset…), and approval requests.

Email Settings — SMTP yapılandırmasıEmail Settings — SMTP configuration

Kuyruk ve mesaj klasörleriQueue & message folders

Ayarlar sayfasında üç tıklanabilir sayaç vardır; her biri ilgili klasörü açar:The settings page shows three clickable counters; each opens its folder:

Email Templates — olay şablonlarıEmail Templates — event templates

Kullanıcı olaylarında otomatik gönderilen şablonlardır (kullanıcı oluşturma, parola sıfırlama vb.). Her şablonun bir Active/Inactive anahtarı vardır — pasif şablon hiç e-posta göndermez. Subject ve Body (HTML) düzenlenir; gövdeye değişken chip'leri eklersiniz.Templates sent automatically on user events (user create, password reset, etc.). Each has an Active/Inactive switch — an inactive template sends nothing. You edit the Subject and Body (HTML), inserting variable chips into the body.

AdımlarSteps

1. System → Email Settings: SMTP Host/Port/SSL, kullanıcı/parola, From Name/Email'i girin.System → Email Settings: enter SMTP Host/Port/SSL, credentials, From Name/Email.
2. Send Test Email ile doğrulayın; sonra Email Service'i açıp Save'leyin.Verify with Send Test Email; then turn on Email Service and Save.
3. Email Templates'te ilgili şablonları (Subject/Body) düzenleyip Active edin.In Email Templates edit the relevant templates (Subject/Body) and set them Active.
4. Bir olay tetikleyin (kullanıcı oluştur / workflow çalıştır) ve Sent/Failed klasörlerinden sonucu izleyin.Trigger an event (create a user / run a workflow) and watch the result in Sent/Failed.

10 · Lisans ve İşletimLicense & Operations

Orbion nasıl lisanslanır?How Orbion is licensed

Orbion, form adedi ve aktif kullanıcı adedi bazlı lisanslanır. Anahtar girmediğinizde sistem otomatik olarak Community Edition (Topluluk Sürümü) olarak çalışır ve lisansta belirtilen şartlar altında tamamen ücretsizdir: 10 form ve 25 aktif kullanıcıya kadar serbestçe kullanabilirsiniz — kurulum, üretim ortamı dahil işletim ve uygulamalarınızı son kullanıcılara sunma serbesttir.Orbion is licensed by form count and active-user count. With no key entered, the system runs automatically as Community Edition and is completely free under the license terms: you may use up to 10 forms and 25 active users freely — installation, operation (including production), and offering your apps to end users are all permitted.

Lisans SözleşmesiLicense Agreement

Orbion, Business Source License (BSL) 1.0 ile dağıtılır. Aşağıdaki butona tıklayarak sözleşmenin tam metnini açabilirsiniz:Orbion is distributed under the Business Source License (BSL) 1.0. Click the button below to open the full text:

📄 Lisans Sözleşmesini Aç (BSL 1.0)Open License Agreement (BSL 1.0)

İşletimOperations

• Files / Viewer — yüklenen dosyalar ve görüntüleyici ayarları.uploaded files and viewer settings.
• Loglar & sorun giderme — hata izleme ve tanılama.Logs & troubleshooting — error tracking and diagnostics.

Yedekleme & geri yüklemeBackup & restore

Sistem yöneticileri yapılandırma yedeklerini listeleyebilir, bir yedeği geri yükleyebilir veya silebilir.System administrators can list configuration backups, restore a backup, or delete one.

A · SSS ve Sorun GidermeFAQ & Troubleshooting

DestekSupport

Sorununuzu yukarıdaki tablo veya kılavuzla çözemezseniz, lisans türünüze göre iki destek kanalı vardır:If the table or guide above doesn't resolve your issue, there are two support channels depending on your license:

B · Terimler SözlüğüGlossary

Kılavuzda geçen terimlerin tümü, konuya göre gruplanmıştır.All terms used in this guide, grouped by topic.

Genel & UygulamaGeneral & App

Bağlantı & VeriConnection & Data

Form & DesignerForm & Designer

KomponentlerComponents

Kurallar & SorgularRules & Queries

ButonlarButtons

İş AkışlarıWorkflows

EntegrasyonlarIntegrations

E-postaEmail

Lisans & DestekLicense & Support