Modul:Entity/Store/doc
Weitere Optionen
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 einmw.smw.askmitformat=countserverseitig.resolve,needsKindundquerysind 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.batchLimitals Batch-Größe (Standard 500) und folgt Continuation-Offsets. Er spiegelt den Bucket-Fehlervertrag:selfUuid/selfValuedegradieren zu nil undresolvePageszu leerem Beitrag, wenn die SMW-Abfrageschicht versagt, während die eigenen Validierungsfehler und das lautequery/resolveUuidsweiter 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_speedin 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. imagewird normalisiert: der SMW-Schreiber speichertDatei:<name>, der Leser strippt das Präfix zurück zum nackten Dateinamen.


