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

Unterschiede anzeigen Seitenhistorie anzeigen

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

Releases

VersionDatumHinweiseKompatibilität
1.0.012.03.2021Erste veröffentlichte Fassungab Nuclos 4.46.1

Überblick

Dieses Nuclet ist eine Sammlung vieler häufig benötigter Java-Methoden, Datenquellen und Resourcen, die die Nuclet-Entwicklung unterstützen und das Nuclet-Verhalten vereinheitlichen.

Beschreibung der Utils-Klassen 

Sämtliche hier vorgestellten Methoden sind statisch.

Manche Methoden verwenden Konstanten, wie zum Beispiel das Format-Pattern 'HH:mm:ss' für die Formatierung der Uhrzeit. Die meisten dieser Konstanten sind Nuclet-Parameter und können entsprechend angepasst werden. Nach der Anpassung der Nucletparameter muss der Job NucletUtils initialisieren einmal 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, Konstanten.Land.DEUTSCHLAND)
  • getOrCreateBusinessObjectByName(Land.class, Konstanten.Land.DEUTSCHLAND, Land.IsoCode, "DE")
  • setBusinessObjectAttribute(Auftrag.class, Auftrag.Dringend, Boolean.TRUE)
  • getResource("Word-Vorlage")
  • saveBusinessObjectWithoutRules(auftrag)
  • getStateList("Auftrag")
  • getLink(auftrag) = "http://localhost:80/nuclos/rest/bos/org_nuclet_test_Auftrag/109194126"
  • 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(30) = "AD"
  • 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

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

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