Seitenhistorie
| Inhalt | ||
|---|---|---|
|
Definition
Menüaufruf: (Administration) - (Management Console)
...
Für die Administration von Nuclos existiert eine Konsolenapplikation, die Hilfsmittel für systemnahe und zeitintensive Administrationsaufgaben zur Verfügung stellt. Sie kann über ein Startskript auf der Kommandozeile oder (entsprechende Berechtigungen vorausgesetzt) aus dem Administrationsmenü des Nuclos-Client gestartet werden.
Generell gelten folgende Aufruf-Konventionen:
Von der Kommandozeile:
| Codeblock |
|---|
run-console <Loginname> <Passwort> <Servername> -<Option> <weitere Parameter>, ... |
Aus dem Client:
Option aus der Combobox auswählen, unter "Argumente" <weitere Parameter>, ... eintragen, und dann Aktion starten auswählen.Ob und welche weiteren Parameter angegeben werden müssen, bestimmt sich aus der ausgewählten Option. Eine Liste der verfügbaren Optionen gibt die Konsole bei einem Aufruf ohne Option (oder bei einer fehlerhaften Option oder fehlenden Parametern) aus.
Verfügbare
...
Aktion
developer
Zeigt eine Auswahl von Optionen an, die nur während der Entwicklung relevant sind.
invalidateattributecache
Sorgt dafür, dass alle Attributdefinitionen erneut eingelesen werden, falls sie z.B. extern verändert worden sind.
invalidatemasterdatametacache
Sorgt dafür, dass alle Definitionen von Stammdatenbusinessobjekten neu eingelesen bzw. erzeugt werden.
refreshviews
Erstellt alle automatisch erzeugten Views (V_GO_...) neu anhand der Informationen über die Verwendung von Attributen pro Businessobjekt aus den aktuell verwendeten Layouts.
schedulereportjob <reportname> -hour <hh> -minute <mm>
Trägt den spezifizierten Report zu der angegebenen Zeit in den Scheduler zur automatischen Ausführung ein. Falls keine Zeit spezifiziert wird, wird als Default 16.00 Uhr angenommen.
unschedulejob <reportname>
Löscht den angegebenen Report aus dem Scheduler.
showjobs
Zeigt alle im Scheduler vermerkten automatisch auszuführenden Reports an.
showreports
Zeigt alle in Nuclos definierten Reports an.
migrateJasperReports -patch -forceAll -removeDeprecatedPdfFonts -overwriteReportFonts <"replacementFontInQuotes">
Gibt Informationen über die Jasperversionen aller Reports aus. Kann durch zusätzliche Parameter Reporte auf die aktuelle JasperVersion aktualisieren, veraltete pdfFontName-Tags entfernen oder sämtliche Fonts durch einen einheitlichen Font austauschen. Eine ausführliche Beschreibung und beispielhafte Anwendung des Befehls finden sie hier: Migration zu JasperReports library 6.17.0.
checkattributevalues <filename>
Prüft alle Attribute in allen Businessobjekten darauf, ob deren Wert mit der Definition des Attributs konform ist, also Datentyp, Eingabeformat, Datenlänge, Minimal- und Maximalwert etc. übereinstimmen. Fehlerhafte Attribute werden in eine CSV-Datei protokolliert, deren Name spezifiziert werden kann. Default ist „attribute.csv".
assignattributetovaluelist <filename>
Erzeugt ein SQL-Script, welches Attributewerte der korrespondierenden Attributwerteliste zuweist. Dieses Script behebt dann den „Rote Einträge in Auswahllisten"-Fehler. Das Script wird in einer Datei gespeichert, deren Name spezifiziert werden kann; Default ist „assignValueListIds.sql".
checkattributeassignment <filename> <mode>
Erstellt einen Report über Attribute mit Werten, die nicht in dem verwendeten Layout angezeigt werden, also auf die der Benutzer über den Client keinen Zugriff mehr hat. <mode> kann zwei Werte haben; entweder show (default), dann wird nur der Report erstellt, oder delete, dann werden die fehlerhaften Attribute in den Entitatsobjekten nach Erstellung des Reports gelöscht.
importgenericobjectlayouts <directory>
Importiert alle Layouts (Dateien mit der Endung *.layoutml) aus dem spezifizierten Verzeichnis und weist ihnen die entsprechende Verwendung zu, falls das Layout unter diesem Namen bereits im System existiert. Ansonsten wird es neu ohne Verwendung angelegt.
exportgenericobjectlayouts <directory>
Exportiert alle Businessobjekt-Layouts (also nicht Stammdaten-Layouts) in das spezifizierte Verzeichnis in Dateien unter deren Namen mit der Endung *.layoutml.
importmasterdatalayouts <directory>
Importiert alle Stammdaten-Layouts (Dateien mit der Endung *.layoutml) aus dem spezifizierten Verzeichnis und weist ihnen die entsprechende Verwendung zu, falls das Layout unter diesem Namen bereits im System existiert. Ansonsten wird es neu ohne Verwendung angelegt.
exportmasterdatalayouts <directory>
Exportiert alle Stammdaten-Layouts (also nicht-Businessobjekt-Layouts) in das spezifizierte Verzeichnis in Dateien unter deren Namen mit der Endung *.layoutml.
importrules <directory>
Importiert alle Geschäftsregeln aus dem spezifizierten Verzeichnis (Dateien mit der Endung *.txt) und kompiliert sie. Verwendungen und Aktivzustand werden beibehalten, falls die Regel unter dem Dateinamen bereits existiert, ansonsten wird sie inaktiv ohne Verwendung neu angelegt.
exportrules <directory>
Exportiert alle in Nuclos definierten Geschäftsregeln in das spezifizierte Verzeichnis. Dabei wird der Regelname als Dateiname verwendet und die Endung *.txt angehängt. Das Ausgabeverzeichnis muss dafür leer sein.
scheduletimelimitjob <hour> <minute>
Legt einen Zeitpunkt fest, an dem Geschäftsregeln mit dem Verwendungstyp „Frist" ausgeführt werden sollen. Die Stunde muss angegeben werden, als Default für die Minute ist 0 vorgegeben.
executerule <rulename>
Führt die Regel mit dem angegebenen Namen sofort aus. Dies ist nur möglich für Regeln mit dem Verwendungstyp „Frist".
setuserpreferences <username> <filename>
Importiert die spezifizierte XML-Datei und setzt sie als benutzerdefinierte Einstellungen für den angegebenen Benutzer.
resetuserpreferences <username>
Löscht die benutzerdefinierten Einstellungen für den spezifizierten Benutzer und setzt sie auf Standardwerte zurück.
validateobjectgenerations
Überprüft und korrigiert die Verwendung zu übertragender Attribute in Objektgenerierungen, d.h. ob spezifizierte Attribute sowohl in Quell- als auch Ziellayout der Objekte vorhanden sind. Ist dies nicht der Fall, werden diese Attribute aus der Objektgenerierung gelöscht.
compiledbobjects
Kompiliert ungültige Views, Functions und Procedures in der Datenbank.
compileallrules
Kompiliert alle Geschäftsregeln neu.
checkmasterdatavalues <filename>
Überprüft für alle Felder aller StammdatenBusinessobjekte, ob ihre Inhalte zu den Definitionen konform sind, d.h. ob Datentyp, Feldlänge, Minimal- und Maximalwerte etc. gültig sind. Alle Verstöße gegen die Definitionen werden in der spezifizierten Datei protokolliert. Default-Dateiname ist „masterdata.csv".
checkattributeusage <filename>
Prüft, ob definierte Attribute in Layouts verwendet werden. Nicht verwendete Attribute werden in die Datei mit dem spezifizierten Namen protokolliert; Default ist „attributeusage.csv".
compiledbobjects
| Aktion | Argumente | Beschreibung |
Manuelle Eingabe | ||
checkDataSources | Prüft Datenquellen und Datenbankobjektequelltext. Es ist zu beachten, dass nur aktive Datenbankobjektequelltext SQL überprüft werden. Es verwendet nämlich dieselbe Routine, wie beim Speichern über den Richclient. | |
checkDocumentAttachments | Der Konsolenbefehl überprüft die Dokumentenanhänge. Es werden a.) alle Datensätze in der DB dahingehend überprüft, ob die referenzierte Datei auch im definierten Dokumentenablage Ordner existiert. b.) nicht verwendete Dateien im Dokumentenablage Ordner ebenfalls aufgelistet. | |
cleanupDuplicateDocuments | sucht Dokumente die mehrmals vorhanden sind. | |
clearUserPreference | Setzt alle nutzerspezifischen Einstellungen zurück (Tabellen-, Suchfilter-, Aufgabenlisteneinstellungen, Arbeitsumgebungen, Preferences in T_MD_USER ) | |
compileDBObjects | Kompiliert alle kompilierbaren Datenbankobjekte im Nuclos-Schema (Views, Functions, Procedures, Packages); |
sendmessage -user <Loginname> -priority{hoch oder normal oder niedrig} -message
<Nachricht> -author <Absender>
Sendet eine Nachricht an einen angemeldeten Benutzer. Die Nachricht erscheint in dem Meldungsfenster aller Clients die der Benutzer geöffnet hat.
killsession -user <Loginname>
Beendet die Sitzung eines Benutzers. Der Client wird sauber heruntergefahren. Das heißt die Benutzereinstellungen werden gespeichert.
changePassword -user <Loginname> -password <neues Passwort>
Beendet die Sitzung eines Benutzers. Der Client wird sauber heruntergefahren. Das heißt die Benutzereinstellungen werden gespeichert.
rebuildluceneindex
Verwirft den aktuellen Lucene index und bau einen neuen im Hintergrund auf.
...
dropConstraints | Entfernt alle von Nuclos angelegten Constraints aus der Datenbank (Fremdschlüsselbeziehungen etc) | |||||||||
fixRecordGrantPkAlias | Bereinigt Datensatzfreigaben indem die Quotierung um die Primärschlüsselspalte (
| |||||||||
freeDalMemory | Gibt den Speicher des D(ata) A(ccess) L(ayers) frei. I.A. ist der Aufruf vor invalidateAllCaches notwendig um die Daten der Systementitäten erneut aus der DB zu lesen. | |||||||||
generateBOUidList | Ertzeugt eine Liste aller BusinessObjekte inklusive Ihrer UIDs | |||||||||
getConstraints | Erzeugt eine Liste aller Constraints aller Tabellen. | |||||||||
invalideAllCaches | Funktion die alle serverseitigen Caches aktualisiert. Diese Funktion wird benötigt, wenn Daten direkt in Datenbanktabellen geändert wurden. Bei Veränderung von Daten in der Tabelle T_AD_PARAMETER ist ein Neustart des Servers erforderlich. Die Caches auf Client Seite und das Hauptmenu können vom Client direkt über den Menupunkt "Datei/Daten im Cache aktualisieren ..." neu geladen werden. | |||||||||
killSession | -user <Loginname> | Beendet die Sitzung eines Benutzers. Der Client wird sauber heruntergefahren. Das heißt die Benutzereinstellungen werden gespeichert. | ||||||||
migrateDocumentAttachmentsIntoSubdirectories |
...
Migriert (verschiebt) Dokumentanhänge in Unterverzeichnisse, siehe auch Systemparameter DOCUMENTS_GUIDELINE_FOR_TOTAL_NUMBER_OF_FILES_PER_DIR. Bereits migrierte Anhänge werden ignoriert. Die Größe der gleichzeitig zu verarbeitenden Anhänge kann mit -chunkSize eingestellt werden. Zusätzlich kann die Migration mit -maxChunksToMigrate auf eine bestimmte Anzahl von Chunks begrenzt werden, um die Last auf mehrere Läufe zu verteilen. | ||
migrateJasperReports | -patch -forceAll -removeDeprecatedPdfFonts-overwriteReportFonts <"replacementFontInQuotes"> | Gibt Informationen über die Jasperversionen aller Reports aus. Kann durch zusätzliche Parameter Reporte auf die aktuelle JasperVersion aktualisieren, veraltete pdfFontName-Tags entfernen oder sämtliche Fonts durch einen einheitlichen Font austauschen. Eine ausführliche Beschreibung und beispielhafte Anwendung des Befehls finden sie hier: Migration zu JasperReports library 6.17.0. |
migrateSubformToDeleteCascadeConstraint | Abhängige Daten werden nicht mehr implizit über durch eine Unterformularbeziehung im Layout gelöscht. Wenn abhängige Daten automatisch beim Entfernen des referenzierten Datensatzes entfernt werden sollen, kann ausschließlich das Flag "Kaskadierend löschen" in der Attributdefinition verwendet werden. Zur Migration kann die Funktion "migrateSubformToOnDeleteCascadeConstraint" in der Management Console verwendet werden. Diese setzt das Flag "kaskadierend Löschen" in jeder in einem Unterformular (im Layout) verwendeten Fremdschlüsselbeziehung. | |
queryDalMemoryLoad | GIbt den aktuellen Speicherverbrauch des D(ata) A(ccess) L(ayers) aus. | |
rebuildClasses | Verwirft die aktuellen Classes und baut neue Classes im Hintergrund auf. | |
rebuildConstraints | Verwirft den aktuellen Constraints und baut einen neuen Constraints im Hintergrund auf. | |
rebuildConstraintsAndIndexes | Verwirft den aktuellen Index und Constraints und baut einen neuen Index und Constraints im Hintergrund auf. | |
rebuildIndexes | Verwirft den aktuellen Index und baut einen neuen Index im Hintergrund auf. | |
rebuildLuceneIndex | Verwirft den aktuellen Lucene Index und baut einen neuen im Hintergrund auf. | |
sendMessage | -user <Loginname> -priority{hoch oder normal oder niedrig} -message | Sendet eine Nachricht an einen angemeldeten Benutzer. Die Nachricht erscheint in dem Meldungsfenster aller Clients die der Benutzer geöffnet hat. |
setMandatorLevel | -level <mandator level (1, 2, ...)> | Hiermit kann das Mandantenlevel in mehreren BOs gleichzeitig gesetzt werden. |
setSideViewMenuWidth | <width> [-s | -p | -l <list of preferences uids>] | Hiermit kann die Breite der Leiste auf der linken Seite im Webclient gesetzt werden.
|
showMaintenance | zeigt ob sich Nuclos im Wartungsmodus befindet. | |
startMaintenance | startet den Wartungsmodus | |
stopMaintenance | stoppt den Wartungsmodus |
Überblick
Inhalte