Batchfähige Administrationsrequests |
  
|
Batchfähige Administrationsrequests |
|
Administrationsrequests ermöglichen ein einfaches Administrieren über eine Skript- bzw. Batch-Datei. Dabei können über den Parameter '&action=' in der URL http://<server>:<port>/<WebOfficeApplikation>/synadmin?client=adminbatch&password=<passwort_unverschlüsselt>&action= Befehle angestoßen werden.
Der Parameter 'action' kann dabei folgende Inhalte annehmen:
•action=restart
ermöglicht ein 'Neuladen' der Applikation
•action=reload_resources
ermöglicht ein 'Ressourcen neu laden' eines bestimmten Projektes (in Verbindung mit Parameter '&project=')
•action=recreate_fts_index&subindex=...
ermöglicht eine Neuberechnung eines bestimmten Indizes. Angabe der kompletten Subindex-Bezeichnung erforderlich. Beispiel:
http://<server>:<port>/<WebOfficeApplikation>/synadmin?client=adminbatch&action=recreate_fts_index&subindex=agslocal|w-ws-furrer|Testprojekte_JF/JF_lucy_testdata_Graz//Graz//adressen
Die Bezeichnung thematischer Subindizes setzt sich aus Projektname_externeKennung zusammen. Beispiel:
http://<server>:<port>/<WebOfficeApplikation>/synadmin?client=adminbatch&action=recreate_fts_index&subindex=WebOffice_SampleProject_AIR
Durch die Angabe von &subindex=ALL werden alle Subindizes neuberechnet. Beispiel:
http://<server>:<port>/<WebOfficeApplikation>/synadmin?client=adminbatch&action=recreate_fts_index&subindex=ALL
Hinweis: Die komplette URL zur Neuberechnung eines bestimmten Subindex finden Sie im SynAdmin im Reiter Volltextsuche in den Details eines bestimmten Layers (URL für Indexerstellung). Die URL kann zusätzlich mit dem Parameter '&password=' für das Passwort der Administrationsseite (SynAdmin) ergänzt werden. Dieses Passwort muss im Klartext übergeben werden. Wenn sich Sonderzeichen im Passwort befinden (zB #), müssen diese korrekt enkodiert werden (zB %23).
Hinweis: Die Index-Erstellung kann/soll mittels Batch-Files automatisiert werden, wobei die Batch-Files über die Windows Aufgabenplanung (Scheduler) stündlich/täglich ausgeführt werden können. Während der Index neu generiert wird, kann im Projekt normal gesucht, etc. werden, da die Neuberechnung komplett im Hintergrund läuft.
Wenn Sie den Befehl chcp 1252 am Anfang des Batch-Files anhängen, müssen Sie sich um eine Enkodierung der Sonderzeichen keine Gedanken mehr machen. Beispiel:
date /t
time /t
@ECHO OFF
chcp 1252
echo.
start http://<host-name>/<WebOffice-Applikation>/synadmin?client=adminbatch"&"action=recreate_fts_index"&"subindex=ALL"&"password=öäüß
•action=status_fts_index&subindex=...
gibt Auskunft über den aktuellen Zustand eines bestimmten Subindex. Angabe der kompletten Subindex-Bezeichnung erforderlich. Beispiel:
http://<server>:<port>/<WebOfficeApplikation>/synadmin?client=adminbatch&action=status_fts_index&subindex=agslocal|w-ws-furrer|Testprojekte_JF/JF_lucy_testdata_Graz//Graz//adressen
Die Bezeichnung thematischer Subindizes setzt sich aus Projektname_externeKennung zusammen. Beispiel:
http://<server>:<port>/<WebOfficeApplikation>/synadmin?client=adminbatch&action=recreate_fts_index&subindex=WebOffice_SampleProject_AIR
Durch die Angabe von &subindex=ALL wird der Zustand aller Subindizes angezeigt. Beispiel:
http://<server>:<port>/<WebOfficeApplikation>/synadmin?client=adminbatch&action=status_fts_index&subindex=ALL
Hinweis: Der Status eines FTS Subindex kann folgende Werte aufweisen:
▪SCHEDULED
▪CREATING
▪CREATED
▪UNNEEDED
▪MISSING
▪FAILED
▪ABORTING
▪OUT_OF_DATE
Der Wert UNKNOWN_SUBINDEX_NAME wird retourniert, wenn der Subindex nicht existiert.
Wichtiger Hinweis: Denken Sie daran, dass Windows .bat Dateien eine spezielle Syntax benötigen und in einer URL die Sonderzeichen & und | innerhalb von Anführungszeichen stehen müssen. Ein Beispiel, wie eine Batch-Datei aussehen könnte, wäre:
Start http://w-vpc-sw-w7-e:8080/WebOffice_LatestBuild/synadmin?client=adminbatch"&"action=recreate_fts_index"&"subindex=agslocal"|"w-vpc-sw-w7-e"|"LowerAustriaEdit//Eisenbahn//Bahnhoefe"&"password=xxx
Ein Beispiel für ein Batch-Skript zum Neu-Berechnen des kompletten FTS-Index können Sie hier downloaden. In diesem Beispiel müssen Sie noch den
•Host-Namen,
•Namen der WebOffice-Applikation und
•Passwort des SynAdmin
anpassen.