tickte-system/WSID_ATTRIBUTE_SETUP.md

WSID Attribut Hinzufügen

Diese Anleitung zeigt dir, wie du das WSID (Work Sheet ID) Attribut zur workorders Collection hinzufügst.

Was ist WSID?

• WSID = Work Sheet ID
• Format: 6-stellige Nummer (100000-999999)
• Funktion: Sequentielle ID ähnlich wie WOID, aber mit 6 Stellen
• Beispiele: 100000, 100001, 100002, etc.

Schritt-für-Schritt Anleitung

1. Appwrite Dashboard öffnen

1. Gehe zu https://appwrite.webklar.com (oder deine Appwrite-Instanz)
2. Logge dich ein
3. Öffne dein Projekt woms

2. Zur workorders Collection navigieren

1. Klicke auf Databases im linken Menü
2. Wähle die Datenbank woms-database (ID: 6943bf0e0003291f8c35)
3. Klicke auf die Collection workorders (ID: 6943bf7d001901baa60c)

3. WSID Attribut erstellen

1. Klicke auf den Tab Attributes
2. Klicke auf Create Attribute
3. Wähle String als Typ
4. Fülle die Felder wie folgt aus:

Attribut-Konfiguration:

• Attribute ID: wsid
• Attribute Name: wsid
• Size: 10 (für 6-stellige Zahlen + Reserve)
• Required: ❌ Nein (nicht required, damit alte Tickets ohne WSID weiter funktionieren)
• Array: ❌ Nein
• Default Value: Leer lassen

5. Klicke auf Create

4. Index für WSID erstellen (Optional, aber empfohlen)

Ein Index verbessert die Performance beim Suchen und Filtern:

1. Klicke auf den Tab Indexes
2. Klicke auf Create Index
3. Fülle die Felder wie folgt aus:

Index-Konfiguration:

• Key: wsid
• Type: key
• Attributes: Wähle wsid
• Order: ASC (aufsteigend)

4. Klicke auf Create

5. Fertig! ✅

Das WSID-Attribut ist jetzt in deiner Collection verfügbar. Die Anwendung wird automatisch:

• Für neue Tickets eine sequentielle WSID generieren (startend bei 100000)
• Die WSID in der Ticket-Liste anzeigen
• Die WSID im Detail-View anzeigen

Hinweise

Sequentielle Generierung

Die WSID wird ähnlich wie WOID automatisch generiert:

// Beispiel:
Erstes Ticket:  WSID = 100000
Zweites Ticket: WSID = 100001
Drittes Ticket: WSID = 100002
// etc.

Unterschied WOID vs WSID

Feld	Stellen	Start	Format	Beispiel
WOID	5	10000	String	"10000"
WSID	6	100000	String	"100000"

Alte Tickets

Tickets, die vor dem Hinzufügen des WSID-Attributs erstellt wurden, haben keine WSID. In der UI wird dann "-" angezeigt.

Troubleshooting

Problem: Attribut kann nicht erstellt werden

Lösung:

• Überprüfe, ob das Attribut wsid nicht bereits existiert
• Stelle sicher, dass du die richtigen Berechtigungen hast (Admin)

Problem: WSID wird nicht angezeigt

Lösung:

1. Überprüfe, ob das Attribut erfolgreich erstellt wurde
2. Lade die Seite neu (Strg+F5 / Cmd+Shift+R)
3. Erstelle ein neues Ticket zum Testen

Problem: WSID startet nicht bei 100000

Lösung:

• Das ist normal, wenn bereits Tickets mit WSID existieren
• Die WSID wird immer sequentiell von der höchsten bestehenden WSID weitergezählt

Support

Bei Fragen oder Problemen:

1. Überprüfe die Appwrite Logs
2. Schaue in die Browser Console (F12)
3. Überprüfe, ob alle Berechtigungen korrekt gesetzt sind