Die Jobverwaltung ist eine Sammlung eigenständiger Programme, die zum größten Teil dem Laden wichtiger Grunddaten aus dem Anzeigensystem in die WebDB dient. (Anwendung: siehe Punkt 3 - Grunddaten laden)

2.1 Einrichtung

(TODO)

2.2 Übersicht und Anwendung

Im "bin"-Verzeichnis der Jobs finden Sie die Datei "runjob.bat". Wenn Sie diese ausführen, gelangen Sie in das Hauptmenü der Jobverwaltung:

1 Stammdaten laden
2 Rubrikwochentage laden
3 Erscheintermine laden
4 Chiffregebuehren laden
5 Doppeltermin-Infos laden
6 Muster laden
7 Zielaufloesung fuer Bildflaechen in 7029 setzen
8 Zuordnung von Rubriken zu Webkombis durchfuehren
9 nicht uebernommene Auftraege pruefen
10 BLZ-Tabelle aus Backend-DB in die WebDB laden
11 Kollektive laden
-------------------------------------------------
99 automatische Joblaeufe anzeigen/einrichten
-------------------------------------------------
e+Nummer = Job-XML-Datei editieren (z.B. e1)
eapp = app.properties bearbeiten
t = jobs.log mit Tail.exe beobachten
x Batchablauf verlassen

Um eine dieser Grunddaten aus dem Anzeigensystem in die WebDB zu laden, geben Sie einfach die entsprechende Nummer vor der Bezeichnung ein und drücken anschließend Enter.
Zum Laden der "Stammdaten" ist es ggfs. notwendig die Job-Datei zuvor mittels "e1" zu editieren, da hier unterschiedliche Grunddaten geladen werden können. Beachten Sie dazu den nachfolgenden Unterpunkt "Stammdaten laden".

2.2.1 Stammdaten laden

(Inhalt der Job-Datei "LoadBaseData.xml" / Bearbeiten mittels "e1" über das Hauptmenü der Jobverwaltung)

In dieser Datei finden Sie folgende Punkte, die für die Übertragung der Stammdaten konfiguriert werden müssen. (Prinzipiell werden bei der Variable "value" die Werte "0" und "1" oder "true" und "false" verwendet. Ausnahme: remotemandant

• Skipmainrubrics : wenn value="true" werden beim Laden der Rubriken (siehe nachfolgenden Punkt "Rubric") nur die geladen, die keine Rubriken mehr unter sich tragen
• remotemandant : hier muss die korrekte Remotemandant ID des Paradise Anzeigensystems angegeben werden, um einen remote Zugriff auf das Backend zu ermöglichen (nur Paradise; bei Anzeigen(VL) egal)
• LinkPublicationIssue : wird nicht mehr verwendet!
• PriceRubric : wenn value="1" werden die Preisrubriken und Default-Preisrubriken geladen. (siehe Nr. 316 - Preisrubriken und Nr. 686 - Default-Rubrik-Preisrubriken (beides nur Anzeigen(VL)))
• Anrede : wenn value="1" werden die Anredearten geladen. (siehe Nr. 69 - Anredearten)
• LKZ : wenn value="1" werden die Länderkennzeichen geladen. (siehe Nr. 82 - Länder)
• Adressart : wenn value="1" werden die Adressarten geladen. (siehe Nr. 65 - Adressarten)
• Publication : wenn value="1" werden die Publikationen geladen. (siehe Nr. 150 - Publikationen)
• Issue : wenn value="1" werden die Ausgaben und Kombis geladen. (siehe Nr. 2025 - Ausgaben, Nr. 80 Kombidefinition, Nr. 147 - Zuordnung Ausgaben zu Kombis)
• Rubric : wenn value="1" werden die Rubriken geladen. (siehe Nr. 103 - Rubriken)
• Payment : wenn value="1" werden die Zahlarten geladen. (siehe Nr. 7011 - Zahlarten) (müssen danach noch von Hand angepasst werden!)
• CreditCard : wenn value="1" werden die Kreditkarten-Arten geladen. (siehe Nr. 7010 - Kreditkarten)
• Chiffre : wenn value="1" werden die Chiffrearten geladen. (siehe Nr. 7004 - Chiffrearten)
• Nutzung : wenn value="1" werden die Nutzungsarten geladen. (siehe Nr. 7005 - Nutzungsarten) (müssen danach noch von Hand angepasst werden)
• SpecialPriceCode : wenn value="1" werden die Rabattgründe geladen. (siehe Nr. 95 Rabattgründe)
• OnlineAttribute : wenn value="1" wird die Verschlagwortung geladen. (siehe Nr. 752 - Onlineattribute - Textgen, Nr. 753 - Onlineattribute - Blöcke, Nr. 754 - Onlineattribute, Nr. 755 - Onlineattribute - Rubzuord., Nr. 759 - Onlineattr. Textgen. Stichwort, Nr. 761 - Onlineattr. Combobox-Werte)
• BusinessLocation : wenn value="1" werden die Geschäftsstellen (Abteilungen) geladen. (siehe Nr. 78 Geschäftsstellen)
• Emphasize : wenn value="1" werden die Auszeichnungsdefinitionen geladen. (siehe Nr. 7018 - Auszeichnungen - Deklar.)
• Measurement : wenn value="1" werden die Maßeinheiten geladen. (siehe Nr. 86 - Maßeinheiten)
• Paneinfo : wenn value="1" werden die Flächenbedeutungen geladen. (siehe Nr. 4014 - Flächenbedeutung)
• Format : wenn value="1" werden die Formate und deren Zuordnung zu Ausgaben geladen. (siehe Nr. 112 - Formate und Nr. 72 - Zuordnung Format zu Ausgabe)
• Rechnungsart : wenn value="1" werden die Rechnungsarten geladen. (siehe Nr. 92 - Rechnungsarten)
• PublicationWhiteList : wenn value="80010, 80011, 80020" werden alle Grunddaten, die einer konkreten Publikation zugeordnet sind, nur dann geladen, wenn sie einer dieser drei Publikationen zugeordnet sind. (damit lassen sich Grunddaten aussparen, die im Web nicht benötigt werden)
• IssueWhiteList : wenn value="26093, 26094, 26116" werden alle Grunddaten, die einer konkreten Ausgabe zugeordnet sind, nur dann geladen, wenn sie einer dieser drei Ausgaben zugeordnet sind. (damit lassen sich Grunddaten aussparen, die im Web nicht benötigt werden)

Alle anderen Werte dürfen nicht verändert werden!

2.2.2 Rubrikwochentage laden

(Inhalt der Job-Datei "LoadRubricDates.xml" / Bearbeiten mittels "e2" über das Hauptmenü der Jobverwaltung)

In dieser Datei finden Sie folgende Punkte, die für die Übertragung der Rubrikwochentage konfiguriert werden werden:

• remotemandant = hier muss die korrekte Remotemandant ID des Paradise Anzeigensystems angegeben werden, um einen remote Zugriff auf das Backend zu ermöglichen (nur Paradise; bei Anzeigen(VL) egal)
• defaultRubricStop = Der hinter "value" angegebene Wert definiert den Rubrikenschluss für alle aus dem Anzeigensystem übertragenen Rubriken. Der Wert definiert die Minuten, die vom Erscheintag um 24:00 Uhr zurückgerechnet werden. Bsp.: bei value="1440" würde der Schluss genau 1 Tag, also um 24:00 Uhr des Vortages stattfinden. Angabe optional.
• offsetRubricStop = Der hinter "value" angegebene Wert definiert die Minuten, die auf den aus dem Anzeigensystem mitgegebenen Rubrikenschluss dazugerechnet werden sollen. Bsp.: Ist der aus dem Anzeigensystem kommende Rubrikenschluss genau 12 Stunden und value="1440", so wird im Web der Rubrikenschluss genau 1 Tag und 12 Stunden vor 24:00 Uhr des Erscheintages sein.

Die "property name"-Werte dürfen nicht verändert werden!
Wie die Daten in der Tabelle BASEDATA abgelegt sind, erfahren Sie unter Nr. 7006 - Rubrikwochentage.

2.2.3 Erscheintermine laden

(Inhalt der Job-Datei "LoadETermine.xml" / Bearbeiten mittels "e3" über das Hauptmenü der Jobverwaltung)

In dieser Datei finden Sie folgende Punkte, die für die Übertragung der Erscheintermine konfiguriert werden müssen:

• remotemandant = hier muss die korrekte Remotemandant ID des Paradise Anzeigensystems angegeben werden, um einen remote Zugriff auf das Backend zu ermöglichen (nur Paradise; bei Anzeigen(VL) egal)
• days = legt die Anzahl der zu übertragenden Erscheintermine für alle Rubriken fest (Bsp.: Wenn value="30" so werden die nächsten 30 Tage ins Web übertragen (nur, wenn auch verfügbar))
• rsoffset = legt den Rubrikenschluss aller Termine an allen Ausgaben fest (nicht mit den Rubrikwochentagen (Nr. 7006) verwechseln).

Alle anderen Werte sollten nicht verändert werden.
Wie die Daten in der Tabelle BASEDATA abgelegt sind, erfahren Sie unter Nr. 7001 - Erscheintermine

2.2.4 Chiffregebuehren laden

(Inhalt der Job-Datei "LoadChiffreGebuehren.xml" / Bearbeiten mittels "e4" über das Hauptmenü der Jobverwaltung)

Dieser Job lädt in die Tabelle BASEDATA die Chiffregebühren. (siehe Nr. 7027 - Chiffregebühren)

2.2.5 Doppeltermin-Infos laden

(Inhalt der Job-Datei "LoadTwinDates.xml" / Bearbeiten mittels "e5" über das Hauptmenü der Jobverwaltung)

Dieser Job lädt in die Tabelle BASEDATA die Doppeltermin-Informationen aus dem VL-Anzeigensystem. (siehe Nr. 7032 - Doppeltermin-Rabatte)

2.2.6 Muster laden

(Inhalt der Job-Datei "LoadSamples.xml" / Bearbeiten mittels "e6" über das Hauptmenü der Jobverwaltung)

In dieser Datei finden Sie folgende Punkte, die für die Übertragung der Muster konfiguriert werden müssen:

• remotemandant = hier muss die korrekte Remotemandant ID des Paradise Anzeigensystems angegeben werden, um einen remote Zugriff auf das Backend zu ermöglichen (nur Paradise; bei Anzeigen(VL) egal)
• MaxImageSize = maximale Breite der Mustervorschauen in Pixeln; Vorschauen werden ggfs. verkleinert, damit diese im Musterauswahldialog eine gewisse Breite nicht übersteigen
• PublicationWhiteList = es werden nur die Muster und Musterzuordnungen in die WebDB geladen, die entweder den hier aufgeführten Publikationen (Kürzel) oder keiner konkreten zugeordnet sind.
• SampleWhiteList = es werden nur die Muster in die WebDB geladen, deren Musternamen hier aufgelistet sind

Alle anderen Werte sollten nicht verändert werden.

Der Job lädt die Muster- (siehe Nr. 7002 - Muster) und deren Flächeninformationen (siehe Nr. 7003 - Musterflächen) in die Tabelle BASEDATA. In der Tabelle ABLAGE werden die Mustervorschauen als JPG hinterlegt. Über VALUE15=1 in ID_SDV=7002 kann ein Muster von einer Aktualisierung durch den Job teilweise ausgeschlossen werden. Die Steuerung, welche Felder in so einem Fall noch aktualisiert werden sollen, muss in der LoadSamples.xml angepasst werden:

<!-- update white list -->
<property name="updateSample" value="4,5,6,7,8,11,12,17,21,22"/>
<property name="updateArea" value="2,3,4,5,6,8,11"/>

In "value" werden die Indizes aus der BASEDATA-Tabelle eingetragen. Für Muster (ID_SDV=7002) sind die Werte: 4,5,6,7,8,11,12,17,21,22 möglich (Bedeutung siehe Nr. 7002), für Flächen die Werte: 2,3,4,5,6,8,11 (siehe Nr. 7003) Wird vom Muster die Höhe aktualisiert, wird auch zusätzlich die Breite aktualisiert und umgekehrt. Soll von einer Fläche eine Positionen aktualisiert werden, so werden automatisch alle Positionen (VALUE3 bis VALUE6) aktualisiert.

2.2.7 Zielaufloesung für Bildflaechen in 7029 setzen

(Inhalt der Job-Datei "SetResolution7029.xml" / Bearbeiten mittels "e7" über das Hauptmenü der Jobverwaltung)

Dieser Job errechnet für alle Musterflächen, die für einen Bildupload eingerichtet wurden (siehe Fehler: Referenz nicht gefunden) die Mindestanzahl an Pixeln in Abhängigkeit der vom Anzeigensystem vorgegebenen Zielauflösung für Printimages. (Stammbea -> Satz/Technik, Bildübernahme -> Zielauflösung für Bildquellen aus pixelbasierten Quellen) Dieser errechnete Wert wird in VALUE5 aller Datensätze mit ID_SDV=7029 abgespeichert. (siehe Nr. 7029 Def. Muster für Bildupload)

2.2.8 Zuordnung von Rubriken zu Webkombis durchf hren

Job veraltet - wird nicht mehr benötigt. Jedwede Kombi muss im Anzeigensystem eingerichtet werden und mittels Job "Stammdaten laden" in die WebDB geladen werden.

2.2.9 nicht übernommene Aufträge prüfen

(Inhalt der Job-Datei "CheckForNewOrders.xml" / Bearbeiten mittels "e9" über das Hauptmenü der Jobverwaltung)

Dieser Job verschickt eine e-Mail in welcher die Anzahl der noch nicht übernommenen Aufträge hinterlegt ist. Das Template dieser Mail lässt sich über das Admintool im Bereich Mailtemplates (siehe Admintool-Handbuch) einrichten.

2.2.10 BLZ-Tabelle aus Backend-DB in die WebDB laden

(Inhalt der Job-Datei "LoadBLZFromBackEnd.xml" / Bearbeiten mittels "e10" über das Hauptmenü der Jobverwaltung)

Dieser Job liest die BLZ-Tabelle der Anzeigensystem-DB aus und erzeugt in Verbindung mit der Bankleitzahlen-XML-Datei der Bundeszentralbank ein SQL-Script, welches die BLZ-Tabelle der WebDB mit allen Banken aus der Anzeigen-DB bef llt. Die XML-Datei wird verwendet, um die Prüfziffern zu ergänzen, da diese derzeit im Anzeigensystem nicht verwaltet werden. Diesem Job muss der komplette Pfad auf die Bankleitzahlen-XLS-Datei der Deutschen Bundesbank mitgegeben werden. (Job-Datei editieren)
Außerdem muss darauf geachtet werden, dass in der app.properties der JDBC-Eintrag auf die Anzeigensystem-DB korrekt hinterlegt und aktiviert ist und der Rechner, von dem aus die Jobs ausgeführt werden, ein Direktzugriff auf die Anzeigensystem-DB erlaubt ist.

1. Datei "LoadBLZFromBackEnd.xml" editieren und folgende Pfade angeben:

   <property name="xlsfile" value="E:\module\hupwebanz\data\BLZ_20090309.xls"/> → „xslfile" muss auf BLZ-Datei (XLS) der Bundeszentralbank zeigen (kompletter Pfad)
   <property name="sqlfile" value="E:\module\hupwebanz\data\BLZ_20090309.sql"/> → „sqlfile" gibt den Namen des sql-Scripts an, welches geschrieben wird (kompletter Pfad)

2. Datei app.properties editieren und Daten für Direktzugriff auf Unique-DB angeben:
   (Dem Rechner muss der Direktzugriff möglich/erlaubt sein!)

   MSSQL

   Datasource.jdbc/hup-uniquevl.DriverClassName=com.microsoft.jdbc.sqlserver.SQLServerDriver
   Datasource.jdbc/hup-uniquevl.Url=jdbc:microsoft:sqlserver://DBSERVER:PORT;DatabaseName=DBNAME
   Datasource.jdbc/hup-uniquevl.Username=BENUTZER
   Datasource.jdbc/hup-uniquevl.Password=PASSOWRT
   Datasource.jdbc/hup-uniquevl.MaxIdle=1
   Datasource.jdbc/hup-uniquevl.ValidationQuery=SELECT 1

   Oracle

   Datasource.jdbc/hup-uniquevl.DriverClassName=oracle.jdbc.driver.OracleDriver
   Datasource.jdbc/hup-uniquevl.Url=jdbc:oracle:thin:@DBSERVER:PORT:DBNAME
   Datasource.jdbc/hup-uniquevl.Username=BENUTZER
   Datasource.jdbc/hup-uniquevl.Password=PASSWORT
   Datasource.jdbc/hup-uniquevl.MaxIdle=1
   Datasource.jdbc/hup-uniquevl.ValidationQuery=select 1 from dual

3. Prüfen der Daten für Zugriff auf WebDB (app.properties):

   Datasource.jdbc/hup-webanz.DriverClassName=com.mysql.jdbc.Driver
   Datasource.jdbc/hup-webanz.Url=jdbc:mysql://DBSERVER:PORT/DBNAME?zeroDateTimeBehavior=convertToNull
   Datasource.jdbc/hup-webanz.Username=BENUTZER
   Datasource.jdbc/hup-webanz.Password=PASSOWRT
   Datasource.jdbc/hup-webanz.MaxIdle=1
   Datasource.jdbc/hup-webanz.ValidationQuery=SELECT 1

4. Job ausführen (das generierte SQL-Script wird automatisch in die WebDB eingespielt)

2.2.11 Kollektive laden

(Inhalt der Job-Datei "LoadKollektive.xml" / Bearbeiten mittels "e11" über das Hauptmenü der Jobverwaltung)

Dieser Job lädt alle Kollektive des Anzeigensystems in die WebDB (siehe auch: Nr. 7039 - Kollektive und Nr. 7040 - Kollektivtermine).

2.2.12 automatische Jobläufe anzeigen/einrichten

In diesem kleinen Untermenü lassen sich sehr einfach Jobs automatisiert als geplanten Windows-Task einrichten, ändern und auch wieder entfernen.

2.3 Aktivieren neuer/geänderter Grunddaten in WebAnzeigen

2.4 Modul jrun.bat

Im bin-Verzeichnis findet sich zusätzlich zur Jobverwaltung das Modul "jrun.bat" zum ent- und verschlüsseln von Grunddaten.
Wenn Sie diese ausführen, erhalten Sie folgende Meldung:

Stammdaten:	jrun de.hup.advtools.SqlSData
Ablage:		jrun de.hup.advtools.SqlAblage
			jrun de.hup.advtools.UnPack
			jrun de.hup.advtools.CryptString
			jrun de.hup.advtools.CryptAdmPwd
			jrun de.hup.advtools.GetETermin

2.4.1 SqlSData

(TODO)

2.4.2 SqlAblage

(TODO)

2.4.3 UnPack

(TODO)

2.4.4 CryptString

Hiermit verschlüsseln Sie ein manuell angegebenes Passwort, welches die Weberfassung als Vergleichsobjekt erhalten muss. Beim Neuladen der Stammdaten per URL-Aufruf müssen Sie ein Passwort angeben (vgl. 2.4.5 CryptAdmPwd), welches mit dem hier erzeugten verglichen wird. Stimmen diese nicht überein, erfolgt keine Aktion.
Geben Sie diese Befehlszeile (jrun de.hup.advtools.CryptString) in die Konsole ein, gefolgt von einem Leerzeichen und einem Passwort, welches Sie zukünftig für das Neuladen der Stammdaten per URL-Aufruf verwenden wollen.

Beispiel:
jrun de.hup.advtools.CryptString test123

Nach der Eingabe der Befehlszeile erhalten Sie eine Zeichenkette aus Zahlen und Buchstaben, welches Ihr Passwort in verschlüsselter Form darstellt.

Beispiel:
5754BB1E78A4CB7373B9A1DE8721E1904B0F41ADB03CCE6E98850BAB759E6C1799BA403A6DC4B57E4E

Öffnen Sie nun die Datei app.properties Ihrer Weberfassung. Diese finden Sie in der Regel im Tomcat-Ordner unter webapps\webanz\WEB_INF. Suchen Sie in dieser Datei nach der Zeichenkette "hupwebanz.admpwd". Geben Sie hinter das Istgleich ihr verschlüsseltes Passwort ein.
Das Ergebnis sollte wie folgt aussehen:

hupwebanz.admpwd=5754BB1E78A4CB7373B9A1DE8721E1904B0F41ADB03CCE6E98850BAB759E6C1799BA403A6DC4B57

Speichern Sie Ihre Änderung ab und schließen Sie die Datei.

Lesen Sie nun weiter bei 2.4.5, wo Sie das Pendant zu diesem Passwort für den URL-Aufruf erzeugen.

2.4.5 CryptAdmPwd

Hiermit erzeugen Sie ebenfalls ein verschlüsseltes Passwort, welches jedoch zusätzlich mit dem aktuellen Datum und der Uhrzeit Ihres System versehen wird. Dieses Passwort benötigen Sie zum Neuladen der Stammdaten per URL-Aufruf über z.B. Ihren Browser.

Geben Sie diese Zeichenkette (jrun de.hup.advtools.CryptAdmPwd) in Ihre Konsole ein, gefolgt von Ihrem Passwort, welches Sie bereits unter Punkt 2.4.4 CryptString verwendet und verschlüsselt in die app.properties Ihrer Weberfassung eingespeichert haben.

Beispiel:
jrun de.hup.advtools.CryptAdmPwd test123

Sie erhalten wieder eine Zeichenkette aus Zahlen und Buchstaben. Diese beinhaltet jedoch neben Ihrem Passwort auch einen aktuellen Zeitstempel Ihres Systems. Der Zeitstempel dient der zusätzlichen Sicherheit, damit das hierbei erzeugte Passwort nur eine gewisse Zeit gültig ist. Der hierbei mit eingelesene Zeitstempel darf maximal nur 7,5 Minuten hinter oder vor der Systemzeit des Rechners liegen, auf dem Ihre Weberfassung läuft. Ist die Differenz größer, ist das Passwort ungültig.

Öffnen Sie nun Ihren Browser und geben Sie folgende Befehlszeile in die Adressleiste ein:
http(s)://<HOST>[:<PORT>]/webanz/mainNavigationAction.do?event=admin&mode=refresh&pwd=<PASSWORT>

Legende:
<HOST> - Hier muss der (Domain-)Name oder die IP-Adresse Ihres Systems, auf dem die Weberfassung läuft, angegeben werden
[<:PORT>] - Verwenden Sie einen anderen HTTP(S)-Port als 443 bzw. 80, so muss dieser hier angegeben werden
<PASSWORT> - Hier muss das eben generierte Passwort eingegeben werden

Bsp.:
https://webanzeigen.hup.de/webanz/mainNavigationAction.do?event=admin&mode=refresh&pwd=4554BB1E78A4CB7373B9A1DE8721E1904B0F41ADB0658A294997FC42478F96EFBE169DF83E7FB57E4E

Stimmen Ihre Eingaben und befinden Sie sich noch innerhalb des 15-minütigen Zeitfensters, so erhalten Sie folgende Meldung:

Die Stammdaten wurden aktualisiert! Https://webanzeigen.hup.de/webanz

War die Eingabe nicht korrekt, sehen Sie folgende Meldung:

Keine Aktion! Https://webanzeigen.hup.de/webanz

2.4.6 GetETermin

(TODO)