Das Dokument beschreibt das Problem „verwaister“ Suchressourcen und Such-Apps in VS Search, die keiner VS Web App zugeordnet sind, etwa durch Änderungen an Web Maps oder fehlgeschlagene Kopiervorgänge. Die Lösung besteht darin, diese Ressourcen entweder direkt über die Löschen-Schaltfläche zu entfernen oder, falls verknüpft, über die VS Search API mittels DELETE-Endpunkten für Apps oder Subindices zu löschen.
Problem
Es gibt eine Suchressourcenkonfiguration (Typ: VertiGIS Studio Web) in VS Search, die in keiner VS Web App erscheint – eine sogenannte „verwaiste“ Suchressource.
Ebenso kann es eine Such-App-Konfiguration (Typ: VertiGIS Studio Web) in VS Search geben, die keiner VS Web App zugeordnet ist – eine sogenannte „verwaiste“ Such-App.
Dies kann in mehreren Szenarien auftreten:
- Ein Layer-Feld wird in der Web Map aktualisiert (z. B. umbenannt oder gelöscht), während die entsprechende VS Search-Konfiguration nicht vorher entfernt wird (also nicht auf die Standard Esri-Suchkonfiguration zurückgesetzt wird).
- Die Web Map wird in einer VS Web App ersetzt, aber die zugehörigen VS Search-Konfigurationen werden nicht vorher gelöscht.
- VS Search ist für einen Feature-Layer in einer VS Web App konfiguriert, aber die Änderungen werden nicht gespeichert, bevor die Seite neu geladen oder geschlossen wird.
- Eine Kopie einer VS Web App wird mit Speichern unter erstellt, aber der Kopiervorgang schlägt aus irgendeinem Grund fehl.
- Eine VS Web App wird in mehreren Umgebungen bereitgestellt (z. B. im Rahmen eines Entwicklung → Test → Staging → Produktion-Workflows), was zu Suchkonfigurationen führt, die keiner bestehenden App mehr zugeordnet sind.
Lösung
Wenn Sie eine verwaiste konfigurierte Ressource (Subindex) oder eine verwaiste Such-App in VS Search haben, versuchen Sie zunächst, diese mit der Löschen-Schaltfläche (Papierkorb-Symbol) zu entfernen. Wenn die Löschung erfolgreich ist, sind keine weiteren Maßnahmen erforderlich.
Wenn keine VS Web-App mit der betreffenden VS Search-App verknüpft ist, sollte die Löschung problemlos funktionieren.
Falls doch eine verknüpft ist, sehen Sie normalerweise folgende Meldung, wenn Sie versuchen, die Suche über den Papierkorb zu löschen:
„App vom Typ 'VertiGIS Studio Web' kann nur innerhalb des VertiGIS Studio Web Designers gelöscht werden.“
In diesem Fall sollten Sie versuchen, die verwaiste App über den entsprechenden VS Search API-Endpunkt zu löschen – entweder für die VS Search App [A] oder die Ressource (Subindex) [B].
[A] So löschen Sie verwaiste Apps mit der VS Search API
- Kopieren Sie die VS Search App-Kennung (UUID) in die Zwischenablage:
- Öffnen Sie die VS Search API. Sie können darauf zugreifen über:
Search Designer → Info → Engine Settings → „Explore the API“ (Swagger UI). - In Swagger UI:
- Erweitern Sie den Abschnitt apps (1)
- Erweitern Sie den Endpunkt DELETE /api/apps/{appUuid} (2)
- Klicken Sie auf Try it out
- Fügen Sie die zuvor kopierte App-Kennung in das Feld appUuid ein und klicken Sie dann auf Execute (3)
- Überprüfen Sie die Antwort, um zu bestätigen, dass die App erfolgreich gelöscht wurde (HTTP-Statuscode 200)
[B] So löschen Sie verwaiste Ressourcen (Subindices) mit der VS Search API
- Kopieren (oder notieren) Sie die VS Search Ressourcenkennung (UUID) in die Zwischenablage.Sie können die Kennung auch im internen Resource Config Viewer finden (drücken Sie Strg + Umschalt + E auf der Seite der Ressourcenkonfiguration):
- Öffnen Sie die VS Search API. Sie können darauf zugreifen über:
Search Designer → Info → Engine Settings → „Explore the API“ (Swagger UI). - In Swagger UI:
- Erweitern Sie den Abschnitt subindices - delete (1)
- Erweitern Sie den Endpunkt DELETE /api/subindices/{subindexUuid} (2)
- Klicken Sie auf Try it out
- Fügen Sie die zuvor kopierte Ressourcen-(Subindex-)Kennung in das Feld subindexUuid ein und klicken Sie dann auf Execute (3)
- Überprüfen Sie die Antwort, um zu bestätigen, dass die Ressource (Subindex) erfolgreich gelöscht wurde (HTTP-Statuscode 200)
Kommentare
0 Kommentare
Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.