Checklisten
Checklisten in InLoox ermöglichen die strukturierte Erfassung tabellarischer Daten innerhalb eines Projekts. Jede Checkliste besteht aus Spalten (Felddefinitionen), Datenzeilen und zugehörigen Werten. Vorlagen erlauben die Wiederverwendung von Checklistenstrukturen.
Checklisten sind stets einem Projekt zugeordnet. Verwenden Sie ProjectId beim Filtern, um nur Checklisten eines bestimmten Projekts abzurufen.
CheckList
Die CheckList-Entität repräsentiert eine einzelne Checkliste innerhalb eines Projekts.
Eigenschaften
| Property | Type | Description |
|---|---|---|
CheckListId | Edm.Guid | Eindeutige ID der Checkliste. |
ProjectId | Edm.Guid | ID des zugehörigen Projekts. |
OrdinalPosition | Edm.Int32 | Sortierposition der Checkliste im Projekt. |
Name | Edm.String | Name der Checkliste. |
InitialColumnNames | Collection(Edm.String) | Initiale Spaltennamen beim Erstellen (optional). |
Endpunkte
/odata/CheckListAlle Checklisten abrufen
Unterstützt OData-Abfrageoptionen. Filtern Sie nach Projekt:
GET /odata/CheckList?$filter=ProjectId eq 3fa85f64-5717-4562-b3fc-2c963f66afa6&$orderby=OrdinalPosition
/odata/CheckList({key})Eine Checkliste nach ID abrufen
| Parameter | Type | Required | Description |
|---|---|---|---|
key | Edm.Guid | ✅ | Die CheckListId. |
/odata/CheckListEine neue Checkliste erstellen
{
"ProjectId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"Name": "Qualitätsprüfung",
"OrdinalPosition": 1,
"InitialColumnNames": ["Kriterium", "Status", "Bemerkung"]
}
Verwenden Sie InitialColumnNames, um beim Erstellen direkt Spalten anzulegen. Andernfalls können Sie Spalten nachträglich über den CheckListColumn-Endpunkt hinzufügen.
/odata/CheckList({key})Eine bestehende Checkliste aktualisieren
| Parameter | Type | Required | Description |
|---|---|---|---|
key | Edm.Guid | ✅ | Die CheckListId. |
{
"Name": "Qualitätsprüfung – Version 2"
}
/odata/CheckList({key})Eine Checkliste löschen
| Parameter | Type | Required | Description |
|---|---|---|---|
key | Edm.Guid | ✅ | Die CheckListId. |
Das Löschen einer Checkliste entfernt auch alle zugehörigen Spalten, Zeilen und Werte. Diese Aktion kann nicht rückgängig gemacht werden.
Gibt 204 No Content bei Erfolg zurück.
/odata/CheckList/$countAnzahl der Checklisten abrufen
Gibt eine Ganzzahl zurück. Unterstützt $filter.
/odata/CheckList({key})/AddRelationEine Verknüpfung zur Checkliste hinzufügen
| Parameter | Type | Required | Description |
|---|---|---|---|
key | Edm.Guid | ✅ | Die CheckListId. |
/odata/CheckList({key})/RemoveRelationEine Verknüpfung von der Checkliste entfernen
| Parameter | Type | Required | Description |
|---|---|---|---|
key | Edm.Guid | ✅ | Die CheckListId. |
CheckListColumn
Die CheckListColumn-Entität definiert die Spalten (Felder) einer Checkliste.
Eigenschaften
| Property | Type | Description |
|---|---|---|
CheckListColumnId | Edm.Guid | Eindeutige ID der Spalte. |
CheckListId | Edm.Guid | ID der zugehörigen Checkliste. |
OrdinalPosition | Edm.Int32 | Sortierposition der Spalte. |
Name | Edm.String | Spaltenname. |
ColumnType | Edm.Int32 | Spaltentyp (z. B. Text, Zahl, Checkbox). |
Endpunkte
/odata/CheckListColumnAlle Checklistenspalten abrufen
GET /odata/CheckListColumn?$filter=CheckListId eq 3fa85f64-5717-4562-b3fc-2c963f66afa6&$orderby=OrdinalPosition
/odata/CheckListColumn({key})Eine Spalte nach ID abrufen
| Parameter | Type | Required | Description |
|---|---|---|---|
key | Edm.Guid | ✅ | Die CheckListColumnId. |
/odata/CheckListColumnEine neue Spalte erstellen
{
"CheckListId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"Name": "Verantwortlich",
"OrdinalPosition": 3,
"ColumnType": 0
}
/odata/CheckListColumn({key})Eine Spalte aktualisieren
| Parameter | Type | Required | Description |
|---|---|---|---|
key | Edm.Guid | ✅ | Die CheckListColumnId. |
{
"Name": "Zuständiger Mitarbeiter"
}
/odata/CheckListColumn({key})Eine Spalte löschen
| Parameter | Type | Required | Description |
|---|---|---|---|
key | Edm.Guid | ✅ | Die CheckListColumnId. |
Gibt 204 No Content bei Erfolg zurück.
/odata/CheckListColumn/$countAnzahl der Spalten abrufen
Gibt eine Ganzzahl zurück.
CheckListDataRow
Die CheckListDataRow-Entität repräsentiert eine Datenzeile in einer Checkliste. Die eigentlichen Werte werden über CheckListValue gespeichert.
Eigenschaften
| Property | Type | Description |
|---|---|---|
RowId | Edm.Guid | Eindeutige ID der Zeile. |
CheckListId | Edm.Guid | ID der zugehörigen Checkliste. |
OrdinalPosition | Edm.Int32 | Sortierposition der Zeile. |
Endpunkte
/odata/CheckListDataRowAlle Datenzeilen abrufen
GET /odata/CheckListDataRow?$filter=CheckListId eq 3fa85f64-5717-4562-b3fc-2c963f66afa6&$orderby=OrdinalPosition
/odata/CheckListDataRow({key})Eine Datenzeile nach ID abrufen
| Parameter | Type | Required | Description |
|---|---|---|---|
key | Edm.Guid | ✅ | Die RowId. |
/odata/CheckListDataRowEine neue Datenzeile erstellen
{
"CheckListId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"OrdinalPosition": 0
}
/odata/CheckListDataRow({key})Eine Datenzeile aktualisieren
| Parameter | Type | Required | Description |
|---|---|---|---|
key | Edm.Guid | ✅ | Die RowId. |
{
"OrdinalPosition": 5
}
/odata/CheckListDataRow({key})Eine Datenzeile löschen
| Parameter | Type | Required | Description |
|---|---|---|---|
key | Edm.Guid | ✅ | Die RowId. |
Gibt 204 No Content bei Erfolg zurück.
/odata/CheckListDataRow/$countAnzahl der Datenzeilen abrufen
Gibt eine Ganzzahl zurück.
CheckListTemplate
Die CheckListTemplate-Entität ermöglicht das Speichern und Laden von Checklistenvorlagen. Vorlagen können aus bestehenden Checklisten erstellt und in andere Projekte geladen werden.
Eigenschaften
| Property | Type | Description |
|---|---|---|
CheckListTemplateId | Edm.Guid | Eindeutige ID der Vorlage. |
Name | Edm.String | Name der Vorlage. |
Endpunkte
CRUD-Operationen
/odata/CheckListTemplateAlle Checklistenvorlagen abrufen
Unterstützt OData-Abfrageoptionen.
GET /odata/CheckListTemplate?$orderby=Name
/odata/CheckListTemplate({key})Eine Vorlage nach ID abrufen
| Parameter | Type | Required | Description |
|---|---|---|---|
key | Edm.Guid | ✅ | Die CheckListTemplateId. |
/odata/CheckListTemplateEine neue Vorlage erstellen
{
"Name": "Standard-Qualitätsprüfung"
}
/odata/CheckListTemplate({key})Eine Vorlage aktualisieren
| Parameter | Type | Required | Description |
|---|---|---|---|
key | Edm.Guid | ✅ | Die CheckListTemplateId. |
{
"Name": "Qualitätsprüfung v2"
}
/odata/CheckListTemplate({key})Eine Vorlage löschen
| Parameter | Type | Required | Description |
|---|---|---|---|
key | Edm.Guid | ✅ | Die CheckListTemplateId. |
Gibt 204 No Content bei Erfolg zurück.
/odata/CheckListTemplate/$countAnzahl der Vorlagen abrufen
Gibt eine Ganzzahl zurück.
Vorlagenverwaltung
/odata/CheckListTemplate/SaveTemplateForCheckListEine Vorlage aus einer bestehenden Checkliste speichern
Speichert die Struktur einer vorhandenen Checkliste als wiederverwendbare Vorlage.
{
"CheckListId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"Name": "Vorlage aus Qualitätsprüfung"
}
/odata/CheckListTemplate({key})/LoadTemplateForProjectEine Vorlage in ein Projekt laden
| Parameter | Type | Required | Description |
|---|---|---|---|
key | Edm.Guid | ✅ | Die CheckListTemplateId. |
Erstellt eine neue Checkliste im angegebenen Projekt basierend auf der Vorlage.
{
"ProjectId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
/odata/CheckListTemplate({key})/DownloadTemplate()Eine Vorlage herunterladen
| Parameter | Type | Required | Description |
|---|---|---|---|
key | Edm.Guid | ✅ | Die CheckListTemplateId. |
Gibt die Vorlagendaten als Download zurück.
/odata/CheckListTemplate({key})/DownloadCheckListTemplate()Eine Checklistenvorlage herunterladen (alternativ)
| Parameter | Type | Required | Description |
|---|---|---|---|
key | Edm.Guid | ✅ | Die CheckListTemplateId. |
Alternativer Download-Endpunkt für Checklistenvorlagen.
CheckListValue
Die CheckListValue-Entität speichert den Wert einer einzelnen Zelle (Zeile × Spalte) in einer Checkliste.
Eigenschaften
| Property | Type | Description |
|---|---|---|
RowId | Edm.Guid | ID der zugehörigen Datenzeile. |
FieldName | Edm.Guid | ID der Spalte (CheckListColumnId). |
Value | any | Der gespeicherte Wert (Typ variiert je nach Spaltentyp). |
Endpunkte
/odata/CheckListValueEinen Zellenwert erstellen oder aktualisieren
Erstellt oder aktualisiert den Wert einer einzelnen Zelle in einer Checkliste.
{
"RowId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"FieldName": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"Value": "Bestanden"
}
Der Value-Typ muss zum Spaltentyp (ColumnType) passen. Für Checkbox-Spalten verwenden Sie true/false, für Zahlenspalten einen numerischen Wert.