Sie zeigen eine alte Version dieser Seite an. Zeigen Sie die aktuelle Version an.

Unterschiede anzeigen Seitenhistorie anzeigen

« Vorherige Version anzeigen Version 5 Nächste Version anzeigen »

Releases

VersionDatumHinweiseKompatibilität
1.0.012.03.2021Erste veröffentlichte Fassungab Nuclos 4.46.1

Überblick

Das Nuclet "NucletUtils" ist eine Sammlung vieler hilfreicher Java-Methoden, Datenquellen und Resourcen, die die Nuclet-Entwicklung unterstützen und das Nuclet-Verhalten vereinheitlichen.

Version 1.0.0

Beschreibung der Utils-Klassen in Version 1.0.0

Sämtliche hier vorgestellten Methoden sind statisch.

Manche Methoden verwenden Konstanten, wie zum Beispiel das Format-Pattern 'dd.MM.yyyy' für die Formatierung von Daten. Die meisten Konstanten sind Nuclet-Parameter und können entsprechend geändert werden. Nach der Änderung der Nucletparameter muss der Job NucletUtils initialisieren ausgeführt werden, da die Änderungen sonst ggf. erst nach dem nächsten Serverstart greifen.


KlasseBeschreibung
Deactivatable
Deactivatable ist ein Interface, welches das Attribut ACTIVE bereitstellt. BO-Regeln, die in den NucletBOUtils deaktiviert werden sollen (um ein BO ohne Regelausführung zu speichern), müssen dieses Interface implementieren.
NucletBOUtils

Diese Klasse enthält hilfreiche Methoden rund um Business-Objekte, z.B.

  • getBusinessObjectByName(Land.class, "Deutschland")
  • getOrCreateBusinessObjectByName(Land.class, "Deutschland", Land.IsoCode, "DE")
  • setBusinessObjectAttribute(Auftrag.class, Auftrag.Dringend, Boolean.TRUE)
  • getResource("Word-Vorlage")
  • saveBusinessObjectWithoutRules(auftrag)
  • getStateList("Auftrag")
  • areDifferent(auftrag1.getKundeId(), auftrag2.getKundeId()
NucletDateUtils

Diese Klasse enthält hilfreiche Datums-Funktionen, z.B.

  • getDate(year, month, day)
  • getYear(date)
  • getDaysBetweenDates(date1, date2)
  • addToDate(date, Calendar.MONTH, -1)
  • isSameDay(date1, date2)
  • isGeneralHoliday(date)
  • isWorkday(date)
  • max(date1, date2)
NucletDialogUtils

Diese Klasse enthält hilfreiche Datums-Funktionen, z.B.

  • dialogYesNo("Keine Versandkosten", "Der Auftrag hat keine Versandkosten. Weiter?", "org.nuclet.firma.Auftrag", String "Aktion abgebrochen")
  • dialogOkCancel(title, message, contextIdentifier, cancelMessage) 
  • dialogGetInput(title, message, contextIdentifier) {
  • dialogGetSelection(title, message, contextIdentifier, options)
NucletExcelUtils

Diese Klasse enthält hilfreiche Methoden zur Arbeit mit Excel-Listen, z.B.

  • getCellName(row, column)
  • getCellValue(row, column)
  • writeCellValue(sheet, rownumber, columnnumber, value)
  • writeCellValue(cell, value)
  • getWorkbookTemplate(template)
  • writeCellFormula(row, firstrow, columnnumber, getColumnSum(row, column_start, column_end))
NucletFileUtils

Diese Klasse enthält hilfreiche Methoden zum File-Handling, z.B.

  • writeArrayToNuclosFile(filename, content)
  • writeStringToNuclosFile(filename, string)
  • writeNuclosFileToFile(nuclosFile)
NucletFormatUtils
Diese Klasse enthält hilfreiche Methoden zu Formatierungsaufgaben, z.B.
  • format(date) = "01.03.2021"
  • format(date, "yy-MM-dd") = "21-03-01"
  • formatTime(date) = "12:20:44"
  • formatWeek(date) = "KW 13"
  • formatDateTime(date) = "01.03.2021 12:20:44"
  • formatDateForFile(date) = "2021-03-01"
  • formatCurrency(bdValue) = "2.412,37 €" 
  • formatRoman(2021) = "MMXXI"
  • formatExcelColumnName(27) = "B1"
  • isInteger(string)
  • getInteger(string)
NucletImageUtils
Diese Klasse enthält hilfreiche Methoden für Bilder, z.B.
  • getThumbnail(image, width, height)
NucletLoggingUtils
Diese Klasse enthält hilfreiche Methoden für das Logging, z.B.
  • log(message)
NucletNumberUtils
Diese Klasse enthält hilfreiche mathematische Methoden. Viele davon liefern keinen Fehler, wenn ein BigDecimal-Argument == null ist, sondern liefern dann null zurück.
  • min(BigDecimal a, BigDecimal b)
  • sum(BigDecimal a, BigDecimal b)
  • quotient(BigDecimal a, BigDecimal b)
  • areAlmostEqual(BigDecimal a, BigDecimal b)
  • getDiscountedAmount(BigDecimal amount, BigDecimal discount)
  • getOriginalAmount(BigDecimal amount, BigDecimal discount)
NucletParameterUtils

Diese Klasse enthält hilfreiche Methoden für Nucletparameter, z.B.

  • getNucletParameterAsInteger(uid)
  • getNucletParameterAsPositiveInteger(uid)
  • getNucletParameterAsBigDecimal(uid)
  • getNucletParameterAsBoolean(uid)
NucletStringUtils

Diese Klasse enthält hilfreiche Methoden für Strings, z.B.

  • leftpad("12", 4) = "0012"
  • shorten("123456789", 7) = "1234..."
  • createPassword(8) = "F62hpN1c"
NucletUserUtils
Diese Klasse enthält hilfreiche Methoden für Benutzer und Benutzergruppen, z.B.
  • confirmUserhasRole(user, role)
  • getUser(String benutzernuclos)
NucletUtilsInitialisieren
Job-Regel, die aktualisierte Nucletparameter für die Regeln aktiviert. Ansonsten greifen die geänderten Parameter ggf. erst nach dem nächsten Server-Neustart.

Beschreibung der Datenquellen in Version 1.0.0

DatenquelleBeschreibung
EntityRules
Liefert alle Insert-, InsertFinal-, Update- und UpdateFinal-Regeln, die bei einem angegebenen BO ausgeführt werden
Nucletparameter
Liefert den Namen eines Nucletparameters zu dessen uid
Resource
Liefert die Resource (Content) zum angegebenen Namen
StatesForModel
Liefert alle Status, die zum angegebenen Statusmodel (name) gehören
ModelForState
Liefert den Namen des Statusmodels, zu dem ein angegebener Status (uid) gehört
Transitions
Liefert alle ein- und ausgehenden Statusübergänge zu einem bestimmten Status (model, numeral)
Usage in Datasources
Liefert zu einem gegebenen Datenbankfeld alle Verwendungen in Nuclos-Datenquellen und Datenbankobjekten zurück.
Dies ist sehr hilfreich, wenn man ein solches Feld umbenennen oder löschen will

Beschreibung der Datenbank-Objekte in Version 1.0.0

DatenbankobjektBeschreibung
LB20_CA_AMPEL
Liefert für die Argumente 'G'(reen), 'Y'(ellow) und 'R'(ed) eine entsprechend farbige Ampel zurück, für alle anderen Werte eine graue Ampel
  • Keine Stichwörter