# PRE-ED-01A – OpenRefine Property Suggest ## Status completed --- ## Testergebnis nach Umsetzung OpenRefine konnte die Property https://reconcilix.vocnet.org/context/0001 der Spalte TEI zuordnen. Der Reconciliation Request enthielt anschließend: ```json "properties": [ { "pid": "https://reconcilix.vocnet.org/context/0001", "v": "1Skulptur" } ] ``` --- # Ziel OpenRefine soll zusätzliche Kontextspalten standardkonform als Properties an Reconcilix übertragen können. Hierfür wird zunächst die Unterstützung der Property-Suggestion gemäß Reconciliation API implementiert und mit einem minimalen statischen Vokabular getestet. Dieses Arbeitspaket schafft die technische Grundlage für die spätere Einführung von ContextItems innerhalb des SourceDelivery-Modells. --- # Ausgangssituation Reconcilix unterstützt derzeit: - Manifest - Reconciliation - Type Suggest - Preview OpenRefine bietet zusätzlich die Möglichkeit, weitere Spalten als Kontextinformationen an den Reconciliation Service zu übertragen. Diese Funktion setzt einen Property-Suggest-Service voraus. Derzeit werden zusätzliche Spalten deshalb noch nicht an Reconcilix übertragen. --- # Ziele Nach Abschluss dieses Arbeitspakets soll OpenRefine - Context Properties anzeigen, - diese einer Spalte zuordnen können, - die ausgewählten Properties im Reconciliation Request übertragen. Eine Persistierung der ContextItems erfolgt in diesem Arbeitspaket ausdrücklich noch nicht. --- # Arbeitsschritte ## PRE-ED-01A-001 Manifest erweitern. Das Manifest erhält einen zusätzlichen Property-Suggest-Service entsprechend der Reconciliation API. Ergebnis OpenRefine erkennt, dass der Service Property Suggestions unterstützt. --- ## PRE-ED-01A-002 Property-Suggest-Endpunkt implementieren. Endpoint GET /suggest/property Für den ersten Implementierungsschritt genügt ein statisches Ergebnis. Beispiel - TEI Context - LIDO Context --- ## PRE-ED-01A-003 OpenRefine-Konfiguration testen. Im Reconciliation Dialog "Also use relevant details from other columns" wird die Spalte TEI dem Property TEI Context zugeordnet. --- ## PRE-ED-01A-004 HTTP Request analysieren. Prüfen, ob OpenRefine Context Properties entsprechend der Reconciliation API an Reconcilix sendet. Zu dokumentieren sind insbesondere - Aufbau des properties-Arrays - Property Identifier - Übertragene Werte - Unterschiede zwischen Einzel- und Batch-Reconciliation --- # Nicht Bestandteil Dieses Arbeitspaket umfasst ausdrücklich nicht - Persistierung von ContextItems - SourceDelivery-Erweiterungen - Interpretation Properties - Data Extension - Property-spezifische Validierungen - EntityType-abhängige Context Types Diese Themen werden in den nachfolgenden Engineering-Arbeitspaketen behandelt. --- # Ergebnisse Nach erfolgreichem Abschluss besitzt Reconcilix erstmals einen standardkonformen Property-Suggest-Service. OpenRefine kann zusätzliche Kontextinformationen als Bestandteil eines Reconciliation Requests an Reconcilix übertragen. Damit ist die technische Grundlage für das SourceDelivery-Modell gemäß ADR002 geschaffen. --- # Betroffene Dokumente ADR002_SOURCE_DELIVERY_MODEL TR001_Transport_Namespace VOC001_Context_Types Manifest OpenRefine Adapter --- # Roadmap PRE-ED-01A ↓ ED-01 SourceDelivery Context Mapping ↓ ED-02 ContextItem Persistence ↓ ED-03 Context-aware Candidate Discovery --- # Implementierungsstand Umgesetzt: - Manifest-Eintrag `suggest.property` - Endpoint `GET /suggest/property` - statische Properties `TEI Context` und `LIDO Context` - Präfixsuche über Label und URI - automatisierter Test `tests/OpenRefine/PropertySuggestTest.php` Noch offen: - Integrationstest im OpenRefine-Dialog - Prüfung und Dokumentation des übertragenen `properties`-Arrays Die Persistierung als `ContextItem` bleibt außerhalb dieses Arbeitspakets.