Types avances

ADDRESS

Adresse structuree. Type composite : cree 7 colonnes SQL dont une colonne calculee.

Schema SQL : pour un champ address, sept colonnes sont creees :

La colonne formatted est une colonne calculee (GENERATED ALWAYS AS ... STORED) qui concatene automatiquement les composants non vides, separes par des virgules. Elle est utilisee pour la recherche full-text.

JSON

Donnees JSON libres stockees en JSONB PostgreSQL.

Operateurs de filtre : is_null, is_not_null

COLOR

Couleur hexadecimale avec selecteur visuel.

RATING

Note sur 5 (affichee en etoiles).

Operateurs de filtre : equals, not_equals, greater_than, less_than, greater_equal, less_equal, between, is_null, is_not_null

Fonctions d'agregation : COUNT, COUNT_DISTINCT, PERCENT_FILLED, PERCENT_EMPTY, SUM, AVG, MEDIAN, MIN, MAX, RANGE, STDDEV, VARIANCE, MODE, ANTI_MODE

IMAGE

URL d'image avec apercu visuel.

Operateurs de filtre : is_null, is_not_null

DOCUMENTS

Pieces jointes / fichiers. Stocke un tableau de metadonnees en JSONB.

Operateurs de filtre : is_null, is_not_null

Structure de chaque document :

{
  "url": "https://...",
  "fileName": "facture.pdf",
  "fileType": "application/pdf",
  "fileSize": 245000,
  "storagePath": "org/documents/...",
  "uploadedAt": "2026-04-15T10:30:00Z"
}

Types de fichiers autorises : PDF, Word, Excel, CSV, PowerPoint, images. Taille max : 10 Mo par fichier.

CALCULATED

Colonne calculee cote base de donnees via une expression SQL.

Le type SQL de la colonne depend du resultType configure (ex : NUMBER → DOUBLE PRECISION, TEXT → TEXT).

Configuration :

{
  computedExpression: "first_name || ' ' || last_name",  // Expression SQL
  resultType: 'TEXT'                                      // Type du resultat
}

Exemple de colonne generee :

"full_name" TEXT GENERATED ALWAYS AS (first_name || ' ' || last_name) STORED

ROLLUP

Champ calcule qui agrege des donnees d'objets lies. Virtuel : pas de colonne en base, calcul au runtime.

{
  sourceRelationField: 'contacts',    // Champ relation source
  targetField: 'amount',              // Champ a agreger sur l'objet cible
  targetFieldType: 'CURRENCY',        // Type du champ cible
  rollupFunction: 'SUM'               // Fonction d'agregation
}

Fonctions d'agregation ROLLUP

Fonctions generales (tous les types de champs) :

Fonctions numeriques (NUMBER, INTEGER, DECIMAL, CURRENCY, PERCENT, RATING) :

Fonctions date (DATE, DATETIME) :

Fonctions booleennes (BOOLEAN) :

Fonctions M2M :

Disponibilite par type de relation

EXTERNAL_LOOKUP

Lookup en temps reel vers une base de donnees externe via un connecteur. Permet d'afficher des donnees d'un Supabase ou PostgreSQL externe directement dans Kasar.

Deux modes :

• BELONGS_TO_ONE : stocke un identifiant externe unique (TEXT)
• HAS_MANY : stocke plusieurs identifiants externes (TEXT[], max configurable, defaut 25)

Configuration :

{
  connectorId: 'cred_xxx',              // ID du connecteur externe
  externalSchema: 'public',             // Schema de la table externe
  externalTable: 'stripe_invoices',     // Table externe
  externalPrimaryKey: 'id',             // Cle primaire de la table externe
  localLookupField: 'email',            // Champ local utilise pour la jointure
  externalLookupField: 'customer_email', // Champ externe utilise pour la jointure
  columns: [                            // Colonnes a afficher
    {
      externalColumn: 'amount',
      localAlias: 'Montant facture',
      displayType: 'CURRENCY',
      aggregation: 'SUM'               // Pour HAS_MANY : agregation
    },
    {
      externalColumn: 'created_at',
      localAlias: 'Derniere facture',
      displayType: 'DATE',
      aggregation: 'LATEST_DATE'
    }
  ],
  staticFilter: {                       // Filtre optionnel sur la table externe
    field: 'status',
    operator: 'eq',
    value: 'paid'
  },
  sortBy: {                             // Tri optionnel
    field: 'created_at',
    direction: 'desc'
  }
}

Chaque colonne configuree cree un champ enfant virtuel en lecture seule, affiche dans le detail de l'enregistrement.