SQLite-Datenstruktur¶

Diese Beschreibung der Datenstruktur v8 soll beim Erstellen von SQL-Abfragen helfen. Sie beschreibt die von QualCoder 3.2 verwendete Struktur. Ältere Datenbanken werden beim Öffnen an das entsprechende Format angepasst. Die folgende Übersicht entspricht dem Stand der englischen Dokumentation.

Die Tabellen sind zunächst alphabetisch aufgeführt. Tabellen- und Feldnamen bleiben unverändert. Die Datentypen integer, real und text bezeichnen Ganzzahlen, Fließkommazahlen und Text. NULL steht für einen nicht gesetzten Wert.

Tabelle: annotation¶

Feld	Typ	Bedeutung
`anid`	integer	Eindeutige, automatisch vergebene Nummer
`fid`	integer	Verweis auf `source.id` zur Identifikation der Textdatei; Annotierungen beziehen sich nur auf Textdateien
`pos0`	integer	Zeichenposition des Beginns in der Textdatei
`pos1`	integer	Zeichenposition des Endes in der Textdatei
`memo`	text	Inhalt der Annotierung
`owner`	text	Coder:in, die den Eintrag erstellt hat
`date`	text	Erstellungsdatum und -zeit im Format `yyyy-mm-dd hh:mm:ss`

Tabelle: attribute¶

Feld	Typ	Bedeutung
`attrid`	integer	Eindeutige, automatisch vergebene Nummer
`name`	text	Attributname, passend zum Namen in `attribute_type`
`attr_type`	text	`case` oder `file`
`value`	text	Attributwert, auch bei numerischen Attributen als Text gespeichert; gegebenenfalls ist `cast(value as real)` erforderlich
`id`	integer	ID der Datei oder des Falls
`owner`	text	Coder:in, die den Eintrag erstellt hat
`date`	text	Erstellungsdatum und -zeit im Format `yyyy-mm-dd hh:mm:ss`

Tabelle: attribute_type¶

Feld	Typ	Bedeutung
`name`	text	Eindeutiger Attributname
`owner`	text	Coder:in, die den Eintrag erstellt hat
`date`	text	Erstellungsdatum und -zeit im Format `yyyy-mm-dd hh:mm:ss`
`memo`	text	Memo zum Attributtyp
`caseOrFile`	text	`case` oder `file`
`valuetype`	text	`character` oder `numeric`

Tabelle: case_text¶

Feld	Typ	Bedeutung
`id`	integer	Eindeutige, automatisch vergebene Nummer
`caseid`	integer	Verweis auf `cases.caseid`
`fid`	integer	Verweis auf `source.id` zur Zuordnung der Textdatei
`pos0`	integer	Zeichenposition des Beginns; `NULL`, wenn keine Textdatei vorliegt
`pos1`	integer	Zeichenposition des Endes; `NULL`, wenn keine Textdatei vorliegt
`memo`	text	Memo
`owner`	text	Coder:in, die den Eintrag erstellt hat
`date`	text	Erstellungsdatum und -zeit im Format `yyyy-mm-dd hh:mm:ss`

Tabelle: cases¶

Feld	Typ	Bedeutung
`caseid`	integer	Eindeutige, automatisch vergebene Nummer
`name`	text	Fallname
`memo`	text	Memo
`owner`	text	Coder:in, die den Eintrag erstellt hat
`date`	text	Erstellungsdatum und -zeit im Format `yyyy-mm-dd hh:mm:ss`

Tabelle: code_av¶

Feld	Typ	Bedeutung
`avid`	integer	Eindeutige, automatisch vergebene Nummer
`id`	integer	Verweis auf `source.id` zur Identifikation der Audio/Video-Datei
`pos0`	integer	Startposition in Millisekunden
`pos1`	integer	Endposition in Millisekunden
`cid`	integer	ID aus `code_name` zur Identifikation des Codes
`memo`	text	Memo
`owner`	text	Coder:in, die den Eintrag erstellt hat
`date`	text	Erstellungsdatum und -zeit im Format `yyyy-mm-dd hh:mm:ss`
`important`	integer	`1` kennzeichnet eine wichtige Codierung

Tabelle: code_cat¶

Feld	Typ	Bedeutung
`catid`	integer	Eindeutige, automatisch vergebene Nummer
`name`	text	Kategoriename
`memo`	text	Memo
`owner`	text	Coder:in, die den Eintrag erstellt hat
`date`	text	Erstellungsdatum und -zeit im Format `yyyy-mm-dd hh:mm:ss`
`supercatid`	integer	ID der übergeordneten Kategorie; `NULL` bei einer Kategorie der obersten Ebene

Tabelle: code_image¶

Feld	Typ	Bedeutung
`imgid`	integer	Eindeutige, automatisch vergebene Nummer
`id`	integer	Verweis auf `source.id` zur Identifikation der Bilddatei
`x1`	real	Linke x-Position in Pixeln, als Dezimalwert gespeichert
`y1`	real	Obere y-Position in Pixeln, als Dezimalwert gespeichert
`width`	real	Breite in Pixeln, als Dezimalwert gespeichert
`height`	real	Höhe in Pixeln, als Dezimalwert gespeichert
`cid`	integer	ID aus `code_name` zur Identifikation des Codes
`memo`	text	Memo
`owner`	text	Coder:in, die den Eintrag erstellt hat
`date`	text	Erstellungsdatum und -zeit im Format `yyyy-mm-dd hh:mm:ss`
`important`	integer	`1` kennzeichnet eine wichtige Codierung
`pdf_page`	integer	PDF-Seitennummer oder `NULL`

Tabelle: code_name¶

Feld	Typ	Bedeutung
`cid`	integer	Eindeutige, automatisch vergebene Nummer
`catid`	integer	Verweis auf `code_cat.catid`, falls der Code zu einer Kategorie gehört; sonst `NULL`
`name`	text	Eindeutiger Codename
`memo`	text	Memo
`owner`	text	Coder:in, die den Eintrag erstellt hat
`date`	text	Erstellungsdatum und -zeit im Format `yyyy-mm-dd hh:mm:ss`
`color`	text	Hexadezimaler Farbwert zwischen `#000000` und `#FFFFFF`; QualCoder erkennt 120 Farben, um darüber helle oder dunkle Schrift darzustellen

Tabelle: code_text¶

Feld	Typ	Bedeutung
`ctid`	integer	Eindeutige, automatisch vergebene Nummer; seit Datenbankversion v3
`cid`	integer	Verweis auf die Code-ID in `code_name`
`fid`	integer	Verweis auf die Datei-ID in `source`
`seltext`	text	Kopie des codierten Textsegments
`pos0`	integer	Zeichenposition des Beginns; `NULL`, wenn keine Textdatei vorliegt
`pos1`	integer	Zeichenposition des Endes; `NULL`, wenn keine Textdatei vorliegt
`memo`	text	Memo
`owner`	text	Coder:in, die den Eintrag erstellt hat
`date`	text	Erstellungsdatum und -zeit im Format `yyyy-mm-dd hh:mm:ss`
`avid`	integer	Verknüpfung zur Zeitposition eines codierten Audio/Video-Segments in `code_av`
`important`	integer	`1` kennzeichnet eine wichtige Codierung

Tabelle: journal¶

Feld	Typ	Bedeutung
`jid`	integer	Eindeutige, automatisch vergebene Nummer
`name`	text	Name des Notizbuchs
`jentry`	text	Text des Notizbuchs
`owner`	text	Coder:in, die den Eintrag erstellt hat
`date`	text	Erstellungsdatum und -zeit im Format `yyyy-mm-dd hh:mm:ss`

Tabelle: project¶

Diese Tabelle sollte genau eine Zeile enthalten.

Feld	Typ	Bedeutung
`databaseversion`	text	Datenbankversion, in der zugrunde liegenden Beschreibung v1, v2 oder v3; QualCoder aktualisiert sie auf die neueste Version und ergänzt dabei Tabellenspalten
`date`	text	Erstellungsdatum und -zeit im Format `yyyy-mm-dd hh:mm:ss`
`memo`	text	Memo zum Gesamtprojekt
`about`	text	Verwendete QualCoder-Version, etwa `QualCoder 2.5`
`bookmarkfile`	integer	ID der Textdatei für das Lesezeichen
`bookmarkpos`	integer	Zeichenposition des Lesezeichens in der Textdatei
`codername`	text	Name der aktuellen Coder:in
`recently_used_codes`	text	IDs zuletzt verwendeter Textcodes, durch Leerzeichen getrennt

Tabelle: source¶

Feld	Typ	Bedeutung
`id`	integer	Eindeutige, automatisch vergebene Nummer
`name`	text	Dateiname mit Endung zur Erkennung von Text, Bild oder Audio/Video; das Suffix `.transcribed` kennzeichnet in dieser Struktur die Zuordnung zur passenden Audio/Video-Datei
`fulltext`	text	Vollständiger Text in UTF-8; bei Bildern und Audio/Video `NULL`
`memo`	text	Memo
`owner`	text	Coder:in, die den Eintrag erstellt hat
`date`	text	Erstellungsdatum und -zeit im Format `yyyy-mm-dd hh:mm:ss`
`mediapath`	text	Medienpfad; Formate siehe unten
`av_text_id`	integer	Verknüpfung einer Audio/Video-Datei mit ihrem Texttranskript

Ein leerer mediapath kennzeichnet einen intern gespeicherten Text. Bei einem Pfad mit docs: wird auf ein externes Textdokument verwiesen; der Text wird dennoch zur Bearbeitung in fulltext gespeichert.

Pfade mit /images/, /audio/ oder /video/ kennzeichnen Dateien im Projektordner. Präfixe images:, audio: und video: kennzeichnen dagegen externe Verknüpfungen mit vollständigem Dateipfad.

Tabelle: stored_sql¶

Feld	Typ	Bedeutung
`title`	text	Titel der SQL-Abfrage
`description`	text	Ausführliche Beschreibung der Funktion
`grouper`	text	Mögliche Gruppierung von Abfragen
`ssql`	text	Von Benutzer:innen erstellte SQL-Anweisung

Tabelle: ris¶

Diese Tabelle enthält Daten aus RIS-Literaturverzeichnissen.

Feld	Typ	Bedeutung
`risid`	integer	Kennung des Literatureintrags
`tag`	text	Kurzes RIS-Feldkennzeichen
`longtag`	text	Ausführliche Bezeichnung des RIS-Felds
`value`	text	Textwert des Felds

Tabellen für die Graphdarstellung¶

Die folgenden Tabellen speichern Graphen und die darin enthaltenen Elemente. Nicht näher erläuterte Felder werden mit ihrem dokumentierten Datentyp aufgeführt.

Tabelle: graph¶

Feld	Typ	Bedeutung
`grid`	integer	Eindeutige Kennung
`name`	text	Eindeutiger Graphname
`description`	text	Beschreibung
`date`	text	Erstellungsdatum
`scene_width`	integer	Breite der Zeichenfläche beim Laden
`scene_height`	integer	Höhe der Zeichenfläche beim Laden

Tabelle: gr_av_item¶

Stellt ein Pfeilsymbol für ein abspielbares codiertes Audio/Video-Segment dar.

Feld	Typ
`gr_avid`	integer, Primärschlüssel
`grid`	integer
`avid`	integer
`x`	integer
`y`	integer
`pos0`	integer
`pos1`	integer
`filepath`	text
`tooltip`	text
`color`	text

Tabelle: gr_case_text_item¶

Stellt Fallinformationen mit Formatierungsparametern dar. grid verweist auf graph.

Feld	Typ
`gcaseid`	integer, Primärschlüssel
`grid`	integer
`x`	integer
`y`	integer
`caseid`	integer
`font_size`	integer
`bold`	integer
`color`	text
`displaytext`	text

Tabelle: gr_cdct_line_item¶

Stellt Verbindungslinien zwischen Codes und Kategorien dar.

Feld	Typ
`glineid`	integer, Primärschlüssel
`grid`	integer
`fromcatid`	integer
`fromcid`	integer
`tocatid`	integer
`tocid`	integer
`color`	text
`linewidth`	real
`linetype`	text
`isvisible`	integer

Tabelle: gr_cdct_text_item¶

Stellt codierten Text mit Formatierungsparametern dar. grid verweist auf graph.

Feld	Typ
`gtextid`	integer, Primärschlüssel
`grid`	integer
`x`	integer
`y`	integer
`supercatid`	integer
`catid`	integer
`cid`	integer
`font_size`	integer
`bold`	integer
`isvisible`	integer
`displaytext`	text

Tabelle: gr_file_text_item¶

Stellt Dateiinformationen mit Formatierungsparametern dar. fid verweist auf source.

Feld	Typ
`gfileid`	integer, Primärschlüssel
`grid`	integer
`x`	integer
`y`	integer
`fid`	integer
`font_size`	integer
`bold`	integer
`color`	text
`displaytext`	text

Tabelle: gr_free_line_item¶

Stellt von Benutzer:innen angelegte Verbindungslinien zwischen Objekten dar.

Feld	Typ
`glineid`	integer, Primärschlüssel
`grid`	integer
`fromcatid`	integer
`fromcid`	integer
`tocatid`	integer
`tocid`	integer
`color`	text
`linewidth`	real
`linetype`	text
`isvisible`	integer

Tabelle: gr_free_text_item¶

Stellt freien Text oder Memos mit Formatierungsparametern dar.

Feld	Typ
`gfreeid`	integer, Primärschlüssel
`grid`	integer
`freetextid`	integer
`x`	integer
`y`	integer
`free_text`	text
`font_size`	integer
`bold`	integer
`color`	text
`tooltip`	text
`ctid`	integer
`memo_ctid`	integer
`memo_imid`	integer
`memo_avid`	integer

Tabelle: gr_pix_item¶

Stellt ein codiertes Bild dar.

Feld	Typ	Bedeutung
`grpixid`	integer	Primärschlüssel
`grid`	integer
`imid`	integer
`x`	integer
`y`	integer
`px`	integer	x-Position im Originalbild
`py`	integer	y-Position im Originalbild
`w`	integer	Breite im Originalbild
`h`	integer	Höhe im Originalbild
`filepath`	text
`tooltip`	text
`pdf_page`	integer	Seite, falls es sich um das Bild einer PDF-Seite handelt