Weitere Informationen
Bitte verwenden Sie immer mindestens die in "Allgemein Information" aufgeführte Version oder höher
Was passiert bei Karten hinzufügen/aktualisieren
- Das Programm liest welche Ebenen die Karte(n) verwendet
- Welche Datenbankverbindung eine Ebene verwendet
- Welche Tabelle/View die Ebene verwendet.
- Welche Spalten die Ebene verwendet.
- Für Ebenen die Tabellen verwenden werden Trigger angelegt.
- Für Ebenen die Views verwenden und wo nur eine einzige Tabelle im View verwendet wird, wird ein Trigger auf die Tabelle des Views angelegt.
- Für Ebenen die Views verwenden und wo mehrere Tabellen im View verwendet werden, werden keine Trigger angelegt.
Datenbanktechnisch können Trigger nur auf Tabellen aber nicht auf Views anlegen kann.
Was passiert beim Ausführen
-
Für alle Datenbanken, aller bei der Ausführung gewählten Karte(n), werden XML Dateien erzeugt. Diese XML Dateien enthalten die Koordinaten der geänderten Datensätze.
Auch für Karten die nicht an der Ausführung beteiligt sind aber eine dieser Datenbanken benutzen werden XML Dateien erzeugt. Die Dateien befinden sich Auf Ihrem MapEdit Server im VerzeichnisC:\inetpub\wwwroot\MumGeoData\TileUpdater\Invalidate -
Danach werden aus dem Änderungsprotokoll (Tabelle ME_TILEUPDATE_LOG) aller beteiligten Datenbanken die bearbeiteten Datensätze entfernt.
-
Dann werden alle XML Dateien der gewählten Karten an den Tile Server gesendet, dieser Rendert damit die betroffenen Kacheln neu. In Schritt 1 erzeugte XML Dateien von nicht gewählten Karten werden nicht zum Tile Server gesendet. Dies geschieht erst zum Zeitpunkt wenn diese Karte(n) ausgeführt werden.
Das Aktualisieren der Kacheln wird vom Tile Server durchgeführt nicht vom Tile Updater! Mit dem "Tile Server Manager" kann beobachtet werden, wann der Tile Server die Kacheln aktualisiert. D.h. nur weil nach der Tile Updater durchgelaufen ist und die UI wieder aktiv ist, bedeutet das nicht, dass alle Kacheln bereits neu gerendert wurden. Die Kacheln sind erst fertig gerendert, wenn der Tile Server diese fehlerfrei verarbeitet hat.
Option "Kacheln erzeugen"
Wird diese Option ausgeschalten dann werden beim ausführen keine Kacheln erzeugt. Diese Option kann z.B. verwendet werden wenn Sie manuell bereits alles neu gerendert haben und ein nochmaliges Rendern verhindern wollen.
Diese Option wird automatisch nach dem Ausführen wieder eingeschalten.
Wenn Sie die Kacheln hinterher doch erzeugen wollen führen Sie "Werkzeuge->Render Durchlauf wiederholen" aus.
Das Register "Kartenebenen"
Diese Übersicht zeigt für jede Datenbank, welche Tabellen und Spalten von welchen Kartenebenen und Karten verwendet werden.
Wenn Sie einen Datensatz umändern dann wird diese Änderung nur als solche erkannt wenn die Tabelle und Spalte in dieser Liste für die Karte aufgeführt ist und sich der Wert auch tatsächlich geändert hat. Eine Änderung auf den gleichen Wert ist keine Änderungen!
Beachten Sie das Änderungen an Views welche die Methode "NoTrigger" haben nicht im Änderungsprotokoll angezeigt werden. Solche Änderungen können erst beim Zeitpunkt des Ausführens ermittelt werden und sind nur in der XML Datei sichtbar.
Bei "Letzte Dauer" sehen Sie wie lange das lesen der Datensätze gedauert hat. Dies erscheint nur bei Views welche die Methode "NoTrigger" haben.
Bei "Base Tables" sehen Sie bei Views welche Tabellen an dem View beteiligt sind. Tabellen die mit einem Stern gekennzeichnet sind reine Attribut Tabellen die keine Geometrie haben.
In der Tabelle sehen Sie viele "..." Knöpfe.
Diese Knöpfe dienen nicht zur Konfiguration sondern diese öffnen die Datenstruktur Definition der jeweiligen Tabelle.
Dort können im Register Daten auch Datensätze Testweise geändert werden.
Wenn bei "Base Tables" mehrere Tabellen stehen wird die erste Tabelle der Liste geöffnet.
Das Register "Änderungsprotokoll"
Hier wird der Inhalt der Tabelle ME_TILEUPDATE_LOG angezeigt.
D.h. Hier können Sie sehen welche Datensätze sich geändert haben. Im oberen Bereich sehen Sie eine Zusammenfassung der Änderungen je Datenbank und Tabelle. Wenn Sie links '[ALL]" wählen sehen Sie alle Änderungen aller Datenbankverbindungen.
Hier werden nur Änderungen angezeigt die mittels Triggern protokolliert wurde.
Datensatzänderungen von Views/Tabellen welche die Methode "NoTrigger" haben werden hier nicht angezeigt!
Die hier Angezeigten Datensatzänderungen und Summen sind immer bezogen auf eine Karte oder Kartengruppen. D.h. wenn hier ein Datensatz mehrfach mit der gleichen Uhrzeit gelistet ist heißt das nicht, dass der Datensatz mehrfach geändert wurde sondern das er in mehreren Karten verwendet wurde. Das Protokoll ist nicht dazu gedacht zu sehen wie viele Änderungen es an Datensätzen gab sondern ein Werkzeug um dem Tile Updater zu sagen wo er was ändern muss.
In der Spalte KEY steht die FID oder Primär Schlüsselspalte. Es kann sein das bei Views bei KEY -1 steht. Das kann vorkommen, wenn der View keine FID/ID Spalte hat. Die spielt bei Views weiter keine Rolle da die Spalte im Fall von Views nur zur Information vorhanden ist.
Im Unterregister "Error Log" werden ggf fehlgeschlagene Triggerausführungen aus der Tabelle ME_TILEUPDATE_TRG_ERR angezeigt.
Die Tabelle beinhaltet maximal die 2000 Fehler, die jeweils Letzten Fehler werden hierbei überschrieben.
Hier aufgeführte Fehler deuten ggf auch auf eine Misskonfiguration der Relations Trigger hin.
Das Register "Statistik"
Hier sehen Sie für jede Datenbank wie viel Zeit der Tile Updater zum Ausführen gebraucht hat.
Dies Zeit enthält NICHT die Dauer die das Render der Kacheln benötigt hat.
Außerdem sehen Sie dort wie viele Datensätze geändert wurden.
Für spezifizierte Tabellen keine Trigger verwenden
Wenn es an einer Tabelle sehr sehr sehr viele Änderungen gibt kann die Methode "NoTrigger" in Sonderfällen Vorteile haben, auch wenn diese langsamer ist.
Durch "NoTrigger" wird die LOG Tabelle nicht gefüllt und die Änderungen erst zur Ausführungszeit des Tile Updaters ermittelt.
Tabellen/Views vom Tile Updater ausschliessen
Wenn Sie wollen das Tabellen/Views nicht vom Tile Updater verarbeitet werden sollen obwohl diese in der Grafik genutzt werden, dann drücken Sie den Knopf und wählen Sie die Tabellen/Views die Sie vom Tile Updater ausschliessen wollen. Nach der Bestätigung mit OK werden diese dann mit Methode = Exclude (ausgeschlossen) in der Tabelle angezeigt.
Für spezifizierte Tabellen Trigger erzwingen
Wenn Sie wollen das auf eine Tabelle immer ein Trigger angelegt wird auch wenn die Karte keinen Layer auf diese Tabelle hat, dann können Sie dies hiermit erzwingen.
Sie müssen hierbei festlegen zu welchen Karten die Tabelle gehört, in welchem Zoom Bereich und bei welchen Spalten der Trigger ausgelöst werden soll.
In der Tabelle werden diese dann als Methode "ForcedTrigger" (Forced = erzwungen) angezeigt.
Dies kann z.B. alternative zu einem Relation Trigger verwendet werden wenn es viele Views auf die gleiche Tabelle gibt. Schalten Sie dann ggf den an der Tabelle hängenden Views mit "Tabellen/Views vom Tile Updater ausschliessen" aus.
"Relation Trigger" hängen an Views und werden automatisch vom Programm deaktiviert wenn kein Layer mehr den View benutzt.
"Erzwungene Trigger (ForcedTrigger)" sind fix und das Programm weiß nicht, ob die zugehörige Tabelle von einem Layer benutzt wird ud wird deswegen nicht automatisch deaktiviert.
Log leeren
Löscht den Inhalt der Tabelle "ME_TILEUPDATE_LOG".
Durch das löschen werden die gelöschten Änderungen dann natürlich nicht ausgeführt und die betroffen Kacheln nicht erneuert.
Test SQL Scripte
Um das Programm mehrfach zu testen können Sie mit Test Script Änderungen via SQL simulieren.
Beispiel:
update BUS_ROUTE set ROUTE_COLOR='Test124' where FID=2543826; -- Setzen
update BUS_ROUTE set ROUTE_COLOR='Test123' where FID=2543826; -- Zurück setzen
update bus_stop set orientation = 99; -- Setzen
update bus_stop set orientation = 98; -- Zurück setzen
Diese SQL ändern jeweils ein Feld um und setzen es dann wieder zurück. Dadurch werden die Trigger ausgelöst und die Änderungen in die LOG Tabelle geschrieben.
Vergessen Sie nicht das zurück setzen der Werte, ansonsten wird der Trigger beim nochmaligen Ausführen nicht ausgelöst das dann keine Änderung passiert.
Den Knopf zum aufsetzen der SQLs finden Sie hier. Rechts daneben befindet sich ein Knopf zum ausführen.
Die aufgesetzten Scripts können optional auch mit dem Ausführen des Tile Updaters ausgeführt werden.
Werkzeuge -> Kacheln Rendern wiederholen
Hiermit können Render Vorgänge wiederholt werden.
Dies kann z.B. hilfreich sein wenn der Tile Server mitten im Render herunter gefahren wurde u.a.
Ein wiederholen ist nur möglich solange die XML Dateien noch vorhanden sind.
D.h. wenn die Option "Xmls nach x Tagen löschen" zu klein eingestellt ist sind diese ggf nicht mehr vorhanden.
Werkzeuge -> Kacheln löschen
Löscht alle Kacheln ausgewählter Karten.
Werkzeuge -> Datenbanken ohne Trigger
Wenn Sie für bestimmte Datenbanken keine Trigger verwenden wollen, z.B. weil dies Ihr Datenbank Admin nicht erlaubt, können Sie hier diese festlegen.
Die muss vor dem Hinzufügen der Karte geschehen welche die Datenbank(en) verwendet.
Werkzeuge -> Karte hinzufügen (Full Re-Render Mode)
Fügt Karten im Modus "Full Re-Render" hinzu.
Karten mit diesem Modus werden beim ausführen immer komplett neu gerendert.
Es werden dann keine Trigger etc angelegt.
Somit kann man die Zeitplanung des Tile Updaters auch für Karten benutzten die man einfach nur komplett neu rendern will.
Werkzeuge -> Alle TileUpdater Trigger entfernen Ver 25.2 und höher
Entfernt alle Tile Updater Trigger/Funktionen. Der TileUpdater wird damit jedoch nicht mehr funktionieren!
Nach dem löschen wird das Programm automatisch neu gestartet.
Durch "Karte aktualisieren" können die erforderlichen Trigger und Funktionen wieder angelegt werden.
Werkzeuge -> Alle TileUpdater Trigger entfernen Ver 25.1 und kleiner
Entfernt Tile Updater Trigger die durch alte Tile Updater Versionen entstanden sind.
Werkzeuge -> TileUpdater Token der MapEdit.Executor.ini hinzufügen
siehe Kapitel Konfiguration und Ausführen
Werkzeuge -> Konfiguration exportieren
Exportiert die im Register "Karten Ebenen" gemachten Einstellungen die dort für jede Datenbank gemacht wurden wie Relations Trigger Einstellungen, Tabellen ohne Trigger und Skripte.
Dies kann dazu genutzt werden Einstellungen für Kunden vorzubereiten oder um Einstellungen von einem Rechner auf einen anderen zu übertragen.
Einstellungen des Registers "Karten" werden nicht exportiert.
Werkzeuge -> Konfiguration importieren
Importiert die exportierten Einstellungen.
Hier kann gewählt werden für welche Datenbanken die Konfiguration importiert werden soll.
Vorhandene Einstellungen werden ggf überschrieben!
Nach dem Import wird der AppBuilder neu gestartet.
Danach muss der Anwender zwingend alle Karten aktualisieren damit die Einstellungen greifen.
Werkzeuge -> Konfiguration importieren (Einstellungen von Versionen 25.1 und kleiner)
Wir raten dringend davon ab alte Konfigurationen zu importieren und raten stattdessen dazu wie im Kapitel "Optimierung der Geschwindigkeit" vorzugehen.
Wenn Sie alte Konfigurationen übernehmen wollen dann halten Sie die linke STRG/CTRL Taste gedrückt während Sie auf den Menüpunkt "Konfiguration importieren" klicken.
Die liest die Einstellungen aus den "*.tileupdater" Dateien die bei Versionen 25.1. und kleiner im Repository verwendet wurden.
Diese werden mit 25.2. nicht mehr verwendet!
Beim import werden nur die Einstellungen der Methode "Launch" übernommen.
D.h. Views oder Tabellen die ein oder ausgeschaltet wurden, werden nicht übernommen da in Version 25.2. Views und Tabellen abhängig
von den verwendeten Layern automatisch ein oder ausgeschaltet werden.
Sie müssen, wenn Sie eigene Einstellungen gemacht haben diese sorgfältig prüfen.
Die original Konfigurationen die in 25.1. durchgeführt wurden werden in den "*.tileupdater" Dateien beibehalten aber nicht weiter verwendet oder geändert.
Gleiche Eintrage werden nicht übernommen auch wenn der Filter anders ist.
Nach dem Import muss zwingend die Funktion „Alle Karten aktualisieren“ ausgeführt werden, ansonsten greifen die Einstellungen nicht.
Werkzeuge -> Dateien für MuM Hotline erzeugen
Erzeugt eine Datei 'TileUpdater.SupportFiles.aktuelles datum.data' mit den aktuellen Einstellungen für die Hotline/Entwicklung
Werkzeuge -> Weitere Einstellungen
- Wie viel Tage die XML beibehalten werden sollen. Je länger der Zeitraum ist desto länger haben Sie die Möglichkeit ein Rendern zu wiederholen.
Das Löschen findet erst beim nächsten Ausführen des TileUpdaters statt. Der Tile Updater löscht dann alle Dateien, die zu diesem Zeitpunkt älter als X Tage sind. Wenn der Tile Updater nicht ausgeführt wird, werden die Dateien nicht gelöscht!
- Log Fids in XML
In den Invalidate XML Dateien sind die Informationen an welchen Stellen Geometrien geändert wurden. Bei Linie und Flächen Geometrien steht hier jeweils POLYGON und die Bounding Box (Min-Max Geometrie) des Features.
Wird der Schalter "Log Fids in XML" aktiviert dann werden weitere Informationen wie die FID als Kommentare in die XML geschrieben. Diese Informationen haben für das Programm keine Bedeutung und sind nur zur Fehleranalyse sinnvoll.
- Der Kommentar "old" ist die Geometrie Boundingbox vor der Änderung, also ein gelöschter Bereich.
- Der Kommentar "new" ist einen Geometrie Boundingbox nach der Änderung.
- Kein Kommentar bedeutet das die Boundingbox vor und nach der Änderung gleich ist. Das kann bedeuten das sich an der Geometrie des Features an der Stelle nichts geändert hat. Oder das sich die Geometrie nur innerhalb der Boundingbox geändert hat. Bedenken Sie das auch wenn sich nichts an der Geometrie ändert aber ein Attribut eines Features geändert wurde diese eine Auswirkung auf die Grafik haben kann. Beispiel ein Attribut bestimmt die Farbe eines Symbols.
Sie sollte diese Option immer nur im Fehlerfall und nur temporär einschalten um Fehler zu analysieren.
Wenn diese Option aktiviert wird dann werden die Dateien grösser und brauchen mehr Zeit zur Abarbeitung. Des Weiteren werden gleiche Geometriebereiche dann NICHT automatisch zusammengefasst, da ansonsten im XML nicht optisch gesehen werden kann woher die einzelnen Daten stammen.
Beispiel:
#ConnectionName=LASVEGAS
#TableName=BUS_STOP
Map=LasVegas_MapServer
SRID=26911
#133643
Point=666574.98;4007056.01
#133643
Point=666574.98;4007056.01
#133644
Point=666565.34;4006849.3
#133644
Point=666565.34;4006849.3
#TableName=BUS_ROUTE
#2543821 old
Polygon=657877.38;3987864.91;657877.38;4012872.94;659071.46;4012872.94;659071.46;3987864.91;657877.38;3987864.91
#2543821 new
Polygon=657877.38;3987864.91;657877.38;4012872.94;659071.46;4012872.94;659071.46;3987864.91;657877.38;3987864.91
#End