Ab dem Release 428 ist die Unterstützung für Anlagen-Labels verfügbar und kann getestet werden. Die Erweiterung besteht im wesentlichen aus 3 Teilen:
Neue Rechte für API-Keys
Ein API-Key kann jetzt auch Rechte tragen, mit denen Labels gelesen, geschrieben und gelöscht werden können. Diese Rechte beziehen sich auf den /labels Endpunkt und sind für die Verwaltung der Labels notwendig, aber nicht um ein Label an eine Anlage zu hängen.
Endpunkt zur Verwaltung von Labels
Der neue /labels-Endpunkt unterstützt GET (index), POST, DELETE nach dem gleichen Schema, das auch alle anderen Ressourcen verwenden. Die Labels-Datenstruktur sieht wie folgt aus:
"labels": [
{
name: "NAME",
description: "DESCRIPTION", // optional
text_color: "#A0A0A0", //optional
bg_color: "#B0B0B0", // optional
label_type: "installation" // bisher nur installation = Anlage
}
]
Labels werden beim Create/Update von Anlagen berücksichtigt
POST /installations unterstützt nun eine optionale Liste von Label-Ids. Die Liste wird immer als Gesamtliste der Labels verarbeitet, d.h. wenn Sie beim Update keine Änderung der Label möchten, lassen Sie den key label_ids komplett weg - wenn Sie stattdessen eine leere Liste schicken, werden alle Labels von der Anlage gelöscht.
Beispiel für eine Liste:
{
location_id: "70173b12-1732-4628-8d01-517296d3c0a1",
installation_type_id: "a211478b-d458-4ebc-81bc-636bdedb6b6a",
number: "Anlage-123",
label_ids: [
"227a5b92-9fdd-4f33-93a9-759cb8701d7f",
"b1d990c6-2f97-4d12-9605-49e7fd10831e"
]
}