Jump to content
Menü aufrufen
Toggle preferences menu
Persönliches Menü aufrufen
Nicht angemeldet
Ihre IP-Adresse wird öffentlich sichtbar sein, wenn Sie Änderungen vornehmen.

Dies ist die Dokumentationsseite für Modul:Entity/Store

Function list
L 23 — bucketLib
L 65 — rowFor
L 92 — selfRow
L 99 — p.selfUuid
L 115 — p.selfValue
L 138 — p.selfValues
L 164 — p.pageValue
L 197 — p.resolveUuids
L 230 — p.resolvePages
L 261 — p.count

Entitys eigene Leseschicht für gespeicherte Entity-Daten: die UUID der aktuellen Seite, ein gespeicherter Wert der aktuellen Seite sowie die UUID-zu-Seite- und Seite-zu-Zusammenfassung-Lookups, die die Entity-Renderer brauchen. Reads folgen der Backend-Wahl von Modul:Entity/StructuredData: Modul:Entity/Store/Smw für SMW, das hier installierte Standard.

Die generische Schicht — welche Tabelle und Spalte eine Eigenschaft beherbergt und wie eine Abfrage aus Eigenschaftsnamen gebaut wird — liegt in Modul:BucketQuery.

Für Modul-Editoren

API

  • selfUuid(): die für die aktuelle Seite gespeicherte UUID, nil bis zum ersten Link-Update.
  • selfValue(displayName, kind): der eigene gespeicherte Wert einer Eigenschaft der aktuellen Seite.
  • resolveUuids(list): UUID zu { page, image }, in 50er-Batches.
  • resolvePages(list): Seitentitel zu { name, manufacturer, role, image }, in 50er-Batches; ein Batch-Fehler ist im Inneren enthalten (leere Map für den Batch).
  • count({ filters, kind }): die Anzahl der passenden Zeilen, nil beim fehlgeschlagenen Read. Auf SMW antwortet ein mw.smw.ask mit format=count serverseitig.
  • resolve, needsKind und query sind aus Modul:BucketQuery re-exportiert.

Erweitern

Ein Verbraucher, der kein Entity-Code ist, sollte Modul:BucketQuery direkt requiren statt in diesen Namensraum zu greifen. Die Re-Exports existieren für Entitys eigene Module. Modul:RentalVehicleGrid ist der eine Nicht-Entity-Verbraucher, der hierher gehört, weil er resolvePages für eine Entity-Fahrzeugzusammenfassung ruft.

Stolperfallen

  • Der SMW-Leser nutzt Module:Entity/Store/Smw.batchLimit als Batch-Größe (Standard 500) und folgt Continuation-Offsets. Er spiegelt den Bucket-Fehlervertrag: selfUuid/selfValue degradieren zu nil und resolvePages zu leerem Beitrag, wenn die SMW-Abfrageschicht versagt, während die eigenen Validierungsfehler und das laute query/resolveUuids weiter werfen.
  • SMW-Filter unterstützen Gleichheit, Präsenz, Kategorien, ODER-Listen von Kategorien und ODER-Listen von Gleichheits-Alternativen auf einer Eigenschaft; jedes andere ODER-Shape scheitert laut statt unvollständig zurückzukehren.
  • Mengenprintouts kommen als Wert/Einheit-Tabellen zurück und werden nur für die sondegesicherten Paare konvertiert (u. a. quantum_speed in m/s, Treibstoffkapazitäten in SCU).
  • Jeder Read hier ist auf den Hauptnamensraum bewacht; ohne sie griffe eine gleichbetitelte Vorlage:-Seite die Zeile der Hauptnamensraum-Entität.
  • image wird normalisiert: der SMW-Schreiber speichert Datei:<name>, der Leser strippt das Präfix zurück zum nackten Dateinamen.
Cookies helfen uns bei der Bereitstellung dieses Wikis. Durch die Nutzung des Star Citizen Wiki erklärst du dich damit einverstanden, dass wir Cookies speichern.