Datensatzfeld-Schnittstelle

Ein Lookup-Feld ist kein spezifischer Feldtyp. Sie können jeden Feldtyp aus einer verknüpften Base nachschlagen. Der Typ eines Lookup-Felds wird durch das ursprüngliche Feld in der verknüpften Base bestimmt und verfügt über die Eigenschaft isLookup. Lookup-Felder können nicht bearbeitet werden.

Alle Feldrückgabewerte können in bestimmten Fällen isMultipleCellValue: true enthalten:

Dies tritt auf, wenn das Feld ein Lookup-Feld ist. Wenn der verknüpfte Wert Mehrfachauswahl zulässt, ist der Lookup-Feldwert zwangsläufig ein Array.
Felder können konfiguriert werden – Benutzerfelder und Verknüpfungsfelder können beispielsweise als Einzel- oder Mehrfachauswahl konfiguriert werden. In Ihrem Code können Sie mit field.isMultipleCellValue feststellen, ob ein Feld mehrere Werte akzeptiert.

Verwenden Sie nicht den Feldtyp, um Schreibberechtigungen zu bestimmen. Verwenden Sie stattdessen die Eigenschaft isComputed des Felds.

1. Zahlenfeld

type: number
Schreibtyp: number
Rückgabetyp:
- isMultipleCellValue: false: number
- isMultipleCellValue: true: number[]

Beispiel:

// Schreibwert
42

// Rückgabewert (isMultipleCellValue: false)
42

// Rückgabewert (isMultipleCellValue: true)
[42, 17, 99]

2. Einzeiliges Textfeld

type: singleLineText
Schreibtyp: string
Rückgabetyp:
- isMultipleCellValue: false: string
- isMultipleCellValue: true: string[]

Beispiel:

// Schreibwert
"Hello, Teable!"

// Rückgabewert (isMultipleCellValue: false)
"Hello, Teable!"

// Rückgabewert (isMultipleCellValue: true)
["Hello, Teable!", "Welcome", "Good day"]

3. Langtextfeld

type: longText
Schreibtyp: string
Rückgabetyp:
- isMultipleCellValue: false: string
- isMultipleCellValue: true: string[]

Beispiel:

// Schreibwert
"Dies ist ein Langtextfeld, das mehrere Absätze enthalten kann..."

// Rückgabewert (isMultipleCellValue: false)
"Dies ist ein Langtextfeld, das mehrere Absätze enthalten kann..."

// Rückgabewert (isMultipleCellValue: true)
["Dies ist ein langer Text...", "Ein weiterer langer Text...", "Noch ein langer Text..."]

4. Einzelauswahlfeld

type: singleSelect
Schreibtyp: string (Optionswert)
Rückgabetyp:
- isMultipleCellValue: false: string
- isMultipleCellValue: true: string[]

Beispiel:

// Schreibwert
"Option A"

// Rückgabewert (isMultipleCellValue: false)
"Option A"

// Rückgabewert (isMultipleCellValue: true)
["Option A", "Option B", "Option C"]

5. Mehrfachauswahlfeld

type: multipleSelect
Schreibtyp: string[] (Array von Optionswerten)
Rückgabetyp: string[]

Beispiel:

// Schreibwert
["Red", "Blue", "Green"]

// Rückgabewert
["Red", "Blue", "Green"]

6. Verknüpfungsfeld

type: link
Schreibtyp:
- isMultipleCellValue: false: { id: string }
- isMultipleCellValue: true: { id: string }[]
Rückgabetyp:
- isMultipleCellValue: false: { id: string, title?: string }
- isMultipleCellValue: true: { id: string, title?: string }[]

Beispiel:

// Schreibwert (isMultipleCellValue: false)
{ id: "rec123456" }

// Schreibwert (isMultipleCellValue: true)
[{ id: "rec123456" }, { id: "rec789012" }]

// Rückgabewert (isMultipleCellValue: false)
{ id: "rec123456", title: "Related Record 1" }

// Rückgabewert (isMultipleCellValue: true)
[
  { id: "rec123456", title: "Related Record 1" },
  { id: "rec789012", title: "Related Record 2" }
]

7. Formelfeld

type: formula
Schreibtyp: Kann nicht direkt beschrieben werden
Rückgabetyp: Hängt vom Formelergebnis ab; kann string | number | boolean oder deren Array-Formen sein

Beispiel:

// Rückgabewert (isMultipleCellValue: false)
42 // or "Result" or true

// Rückgabewert (isMultipleCellValue: true)
[42, 17, 99] // or ["Result1", "Result2"] or [true, false, true]

8. Anhangsfeld

Um einen Anhang in ein Anhangsfeld hochzuladen, verwenden Sie die dafür vorgesehene API. Details finden Sie im Abschnitt Anhang hochladen.

type: attachment

Schreibtyp:

{
  id: string;
  name: string;
  path: string;
  token: string; // Unique identifier
  size: number; // File size in bytes
  mimetype: string; // File type
  presignedUrl?: string; // File preview/download URL
  width?: number; // Image width
  height?: number; // Image height
}[]

Rückgabetyp:

{
  id: string;
  name: string;
  path: string;
  token: string; // Unique identifier
  size: number; // File size in bytes
  mimetype: string; // File type
  presignedUrl?: string; // File preview/download URL
  width?: number; // Image width
  height?: number; // Image height
}[]

Beispiel:

// Schreibwert
[
  {
    name: "document.pdf",
    type: "application/pdf",
    token: "abc123",
    size: 1024000
  }
]

// Rückgabewert
[
  {
    id: "att123",
    name: "document.pdf",
    path: "/uploads/document.pdf",
    token: "abc123",
    size: 1024000,
    mimetype: "application/pdf",
    presignedUrl: "https://app.teable.ai/preview/document.pdf",
  },
  {
    id: "att456",
    name: "image.jpg",
    path: "/uploads/image.jpg",
    token: "def456",
    size: 2048000,
    mimetype: "image/jpeg",
    presignedUrl: "https://app.teable.ai/preview/image.jpg",
    width: 1920,
    height: 1080
  }
]

9. Datumsfeld

type: date
Schreibtyp: string (ISO-8601-Format)
Rückgabetyp:
- isMultipleCellValue: false: string (ISO-8601-Format)
- isMultipleCellValue: true: string[] (ISO-8601-Format) Sie können new Date().toISOString() verwenden, um die Uhrzeit im ISO-8601-Format abzurufen.

Beispiel:

// Schreibwert
"2024-09-02T02:51:03.875Z"

// Rückgabewert (isMultipleCellValue: false)
"2024-09-02T02:51:03.875Z"

// Rückgabewert (isMultipleCellValue: true)
["2024-09-02T02:51:03.875Z", "2024-09-02T02:51:03.875Z"]

10. Erstellungszeitfeld

type: createdTime
Schreibtyp: Kann nicht direkt beschrieben werden
Rückgabetyp:
- isMultipleCellValue: false: string (ISO-8601-Format)
- isMultipleCellValue: true: string[] (ISO-8601-Format)

Beispiel:

// Rückgabewert (isMultipleCellValue: false)
"2024-09-02T02:51:03.875Z"

// Rückgabewert (isMultipleCellValue: true)
["2024-09-02T02:51:03.875Z", "2024-09-02T02:51:03.875Z"]

11. Feld für letzte Änderung

type: lastModifiedTime
Schreibtyp: Kann nicht direkt beschrieben werden
Rückgabetyp:
- isMultipleCellValue: false: string (ISO-8601-Format)
- isMultipleCellValue: true: string[] (ISO-8601-Format)

Beispiel:

// Rückgabewert (isMultipleCellValue: false)
"2023-04-15T10:30:00Z"

// Rückgabewert (isMultipleCellValue: true)
["2023-04-15T10:30:00Z", "2023-04-16T14:45:00Z"]

12. Kontrollkästchenfeld

type: checkbox
Schreibtyp: boolean
Rückgabetyp:
- isMultipleCellValue: false: boolean
- isMultipleCellValue: true: boolean[]

Beispiel:

// Schreibwert
true

// Rückgabewert (isMultipleCellValue: false)
true

// Rückgabewert (isMultipleCellValue: true)
[true, false, true]

13. Rollup-Feld

type: rollup
Schreibtyp: Kann nicht direkt beschrieben werden
Rückgabetyp: Hängt von der Rollup-Konfiguration ab; kann number | string oder deren Array-Formen sein

Beispiel:

// Rückgabewert (isMultipleCellValue: false)
42 // or "Summary Result"

// Rückgabewert (isMultipleCellValue: true)
[42, 17, 99] // or ["Summary 1", "Summary 2"]

14. Bewertungsfeld

type: rating
Schreibtyp: number
Rückgabetyp:
- isMultipleCellValue: false: number
- isMultipleCellValue: true: number[]

Beispiel:

// Schreibwert
4

// Rückgabewert (isMultipleCellValue: false)
4

// Rückgabewert (isMultipleCellValue: true)
[4, 3, 5]

15. Automatische Nummerierung

type: autoNumber
Schreibtyp: Kann nicht direkt beschrieben werden
Rückgabetyp:
- isMultipleCellValue: false: number
- isMultipleCellValue: true: number[]

Beispiel:

// Rückgabewert (isMultipleCellValue: false)
42

// Rückgabewert (isMultipleCellValue: true)
[42, 43, 44]

16. Benutzerfeld

type: user
Schreibtyp:
- isMultipleCellValue: false: { id: string, title: string }
- isMultipleCellValue: true: { id: string, title: string }[]
Rückgabetyp:
- isMultipleCellValue: false: { id: string, title: string, email?: string, avatar?: string }
- isMultipleCellValue: true: { id: string, title: string, email?: string, avatar?: string }[]

Beispiel:

// Schreibwert (isMultipleCellValue: false)
{ id: "user123", title: "John Doe" }

// Schreibwert (isMultipleCellValue: true)
[
  { id: "user123", title: "John Doe" },
  { id: "user456", title: "Jane Smith" }
]

// Rückgabewert (isMultipleCellValue: false)
{
  id: "user123",
  title: "John Doe",
  email: "john@example.com",
  avatar: "https://example.com/avatar.jpg"
}

// Rückgabewert (isMultipleCellValue: true)
[
  {
    id: "user123",
    title: "John Doe",
    email: "john@example.com",
    avatar: "https://example.com/avatar1.jpg"
  },
  {
    id: "user456",
    title: "Jane Smith",
    email: "jane@example.com",
    avatar: "https://example.com/avatar2.jpg"
  }
]

17. Feld „Erstellt von“

Schreibtyp: Kann nicht direkt beschrieben werden
Rückgabetyp:
- isMultipleCellValue: false: { id: string, title: string, email?: string, avatar?: string }
- isMultipleCellValue: true: { id: string, title: string, email?: string, avatar?: string }[] Beispiel:

// Rückgabewert (isMultipleCellValue: false)
{
  id: "user123",
  title: "John Doe",
  email: "john@example.com",
  avatar: "https://example.com/avatar.jpg"
}

// Rückgabewert (isMultipleCellValue: true)
[
  {
    id: "user123",
    title: "John Doe",
    email: "john@example.com",
    avatar: "https://example.com/avatar1.jpg"
  },
  {
    id: "user456",
    title: "Jane Smith",
    email: "jane@example.com",
    avatar: "https://example.com/avatar2.jpg"
  }
]

18. Feld „Zuletzt geändert von“

Schreibtyp: Kann nicht direkt beschrieben werden
Rückgabetyp:
- isMultipleCellValue: false: { id: string, title: string, email?: string, avatar?: string }
- isMultipleCellValue: true: { id: string, title: string, email?: string, avatar?: string }[]

Beispiel:

// Rückgabewert (isMultipleCellValue: false)
{
  id: "user123",
  title: "John Doe",
  email: "john@example.com",
  avatar: "https://example.com/avatar.jpg"
}

// Rückgabewert (isMultipleCellValue: true)
[
  {
    id: "user123",
    title: "John Doe",
    email: "john@example.com",
    avatar: "https://example.com/avatar1.jpg"
  },
  {
    id: "user456",
    title: "Jane Smith",
    email: "jane@example.com",
    avatar: "https://example.com/avatar2.jpg"
  }
]

Erste Schritte

Datensätze

API-Referenz

Datensatzfeld-Schnittstelle

1. Zahlenfeld

2. Einzeiliges Textfeld

3. Langtextfeld

4. Einzelauswahlfeld

5. Mehrfachauswahlfeld

6. Verknüpfungsfeld

7. Formelfeld

8. Anhangsfeld

9. Datumsfeld

10. Erstellungszeitfeld

11. Feld für letzte Änderung

12. Kontrollkästchenfeld

13. Rollup-Feld

14. Bewertungsfeld

15. Automatische Nummerierung

16. Benutzerfeld

17. Feld „Erstellt von“

18. Feld „Zuletzt geändert von“

​1. Zahlenfeld

​2. Einzeiliges Textfeld

​3. Langtextfeld

​4. Einzelauswahlfeld

​5. Mehrfachauswahlfeld

​6. Verknüpfungsfeld

​7. Formelfeld

​8. Anhangsfeld

​9. Datumsfeld

​10. Erstellungszeitfeld

​11. Feld für letzte Änderung

​12. Kontrollkästchenfeld

​13. Rollup-Feld

​14. Bewertungsfeld

​15. Automatische Nummerierung

​16. Benutzerfeld

​17. Feld „Erstellt von“

​18. Feld „Zuletzt geändert von“

1. Zahlenfeld

2. Einzeiliges Textfeld

3. Langtextfeld

4. Einzelauswahlfeld

5. Mehrfachauswahlfeld

6. Verknüpfungsfeld

7. Formelfeld

8. Anhangsfeld

9. Datumsfeld

10. Erstellungszeitfeld

11. Feld für letzte Änderung

12. Kontrollkästchenfeld

13. Rollup-Feld

14. Bewertungsfeld

15. Automatische Nummerierung

16. Benutzerfeld

17. Feld „Erstellt von“

18. Feld „Zuletzt geändert von“