Package de.elo.client.scripting.interfaces

Class UtilsAdapter

Object
UtilsAdapter
public class UtilsAdapter extends Object

Überschrift: UtilsAdapter

Beschreibung: Hilftmethoden für Skripte im Client. Im Scripting verfügbar als "utils".

Copyright: Copyright (c) ELO Digital Office GmbH 2011-2016

Since:
8.00.000

  • Constructor Details

    • UtilsAdapter

      public UtilsAdapter(Workspace workspace)
      Interner Konstruktor.
      Parameters:
      workspace - Aktueller Arbeitsbereich

  • Method Details

    • transferByClipboard

      public String transferByClipboard(boolean withDoubleClick, boolean withCtrlC) throws Exception
      Führt (optional) einen Doppelklick und ein STRG-C aus und liest anschließend das Windows Clipboard ein.
      Parameters:
      withDoubleClick - Simuliert einen Doppelklick auf die aktuelle Mausposition
      withCtrlC - Simuliert den Tastendruck STRG-C
      Returns:
      Textinhalt des Clipboards
      Throws:
      Exception - Wenn nicht auf das Clipboard zugegriffen werden kann, oder der Inhalt nicht als Text verfügbar ist.

    • findByMd5

      public Sord findByMd5(File searchForFile) throws Exception
      Prüft nach, ob es zu einer Datei eine Dublette im Archiv gibt. Wenn ja, wird die (erste) Dublette zurück geliefert.
      Parameters:
      searchForFile - Datei
      Returns:
      Dublette oder null
      Throws:
      Exception - Wenn der Serverzugriff fehlschlägt.
      Since:
      10.00.000

    • findListByMd5

      public List<Sord> findListByMd5(File searchForFile) throws Exception
      Prüft nach, ob es zu einer Datei Dubletten im Archiv gibt. Wenn ja, wird die Liste der Dublette zurück geliefert.
      Parameters:
      searchForFile - Datei
      Returns:
      Liste der Dubletten oder null
      Throws:
      Exception - Wenn der Serverzugriff fehlschlägt.
      Since:
      21.02.005

    • getMD5

      public String getMD5(File file) throws IOException
      Ermittelt den MD5 Hash Wert zum Inhalt einer Datei.
      Parameters:
      file - Zu prüfende Datei
      Returns:
      MD5 Wert als Hex-String
      Throws:
      IOException - Wenn die Datei nicht gelesen werden kann oder der MD5 Wert nicht errechnet werden kann.
      Since:
      10.00.000

    • addToClipboard

      public void addToClipboard(String htmlText, String plainText)
      Fügt einen Eintrag als Text und HTML Eintrag in das Windows Clipboard ein.
      Parameters:
      htmlText - HTML formatierte Version des Textes
      plainText - Unformatierte Version des Textes
      Since:
      9.03.000

    • mergeTiff

      public void mergeTiff(File[] fileNames, File destination) throws Exception
      Fasst mehrere Tiff Dateien zu einer Datei zusammen.
      Parameters:
      fileNames - Array mit den Quelldateien
      destination - Zieldatei
      Throws:
      Exception - Wenn die Dateien nicht zusammengefasst werden konnten.
      Since:
      9.00.028

    • mergePdf

      public void mergePdf(File[] fileNames, File destination) throws Exception
      Fasst mehrere PDF Dateien zu einer Datei zusammen.
      Parameters:
      fileNames - Array mit den Quelldateien
      destination - Zieldatei
      Throws:
      Exception - Wenn die Dateien nicht zusammengefasst werden konnten.
      Since:
      9.00.028

    • splitPdf

      public List<File> splitPdf(File source) throws Exception
      Trennt eine mehrseitige TIFF-Datei in Einzelseiten auf.
      Parameters:
      source - Quelldatei
      Returns:
      Liste der erzeugten Dateien
      Throws:
      Exception - Wenn die Seiten nicht getrennt werden konnten.
      Since:
      12.00.000

    • splitTiff

      public List<File> splitTiff(File source) throws Exception
      Trennt eine mehrseitige TIFF-Datei in Einzelseiten auf.
      Parameters:
      source - Quelldatei
      Returns:
      Liste der erzeugten Dateien
      Throws:
      Exception - Wenn die Seiten nicht getrennt werden konnten.
      Since:
      12.00.000

    • editFile

      public void editFile(File file)
      Öffnet die Datei mit dem vom Betriebssystem dafür vorgesehenen Programm zur Bearbeitung.
      Parameters:
      file - Zu öffnende Datei
      Since:
      8.00.000

    • getFileNameWithOption

      public String getFileNameWithOption(Sord sord)
      Liefert den Dateinamen des angegebenen Archiveintrags unter Beachtung der ensprechenden Client-Option. Bei ungültiger Parameterangabe wird null zurückgeliefert.
      Parameters:
      sord - Archiveintrag
      Returns:
      Dateiname
      Since:
      8.00.000

    • getDocMaskFromOpts

      public int getDocMaskFromOpts(String fileName, int parentId) throws RemoteException
      Liefert die MaskId der Dokumentenmaske zurück, die zu einer Dateiendung zugeordnet wurde. Falls für den angegebenen Dateityp keine Maske definiert ist, wird die MaskId der Default-Maske zurückgegeben.
      Parameters:
      fileName - Dateiname (null, für: Ordner)
      parentId - ID des Elternelements (-1, für: noch nicht bekannt, keine Einschränkung durch beschränkte Maskenverwendung aus Parent)
      Returns:
      MaskId ID der Dokumentenmaske
      Throws:
      RemoteException
      Since:
      12.16.000, 20.12.000, 21.03.000

    • getUniqueFile

      public File getUniqueFile(File directory, String fileNameWithExtension)
      Liefert eine eindeutige Datei für den angegebenen Dateinamen in dem angegebenen Verzeichnis. Bei ungültiger Parameterangabe wird null zurückgeliefert.
      Parameters:
      directory - Verzeichnis, in dem die Datei erzeugt wird
      fileNameWithExtension - Dateiname mit Dateiendung
      Returns:
      Eindeutige Datei oder null bei einem Fehler
      Since:
      8.00.000

    • copyFile

      public boolean copyFile(File sourceFile, File targetFile)
      Kopiert die angegebene Quelldatei in die angegebene Zieldatei und meldet das Ergebnis zurück. Bei ungültigen Parameterangaben wird false zurückgegeben.
      Parameters:
      sourceFile - Quelldatei
      targetFile - Zieldatei
      Returns:
      Kopierergebnis: True wenn kopiert wurden, False bei einem Fehler
      Since:
      8.00.000

    • getFileExtension

      public String getFileExtension(File file)
      Liefert die Dateiendung der angegebenen Datei zurück. Bei ungültiger Parameterangabe wird null zurückgeliefert.
      Parameters:
      file - Datei
      Returns:
      Dateiendung oder null bei einem Fehler
      Since:
      8.00.000

    • getFileNameWithoutExtension

      public String getFileNameWithoutExtension(File file)
      Liefert den Dateinamen ohne die Dateiendung zurück. Bei ungültiger Parameterangabe wird null zurückgeliefert.
      Parameters:
      file - Datei
      Returns:
      Dateiname ohne Dateiendung oder null bei einem Fehler
      Since:
      8.00.000

    • changeFileExtension

      public File changeFileExtension(File file, String newFileExt)
      Liefert eine Datei mit der neuen Dateiendung zurück. Die Dateiendung muss mindestens ein Zeichen lang sein. Bei ungültigen Paramterangaben wird null zurückgeliefert.
      Parameters:
      file - Datei, deren Dateiendung geändert wird
      newFileExt - Neue Dateiendung
      Returns:
      Neue Datei oder null bei einem Fehler
      Since:
      8.00.000

    • dateFromIso

      public Date dateFromIso(String isoDate)
      Konvertiert das angegebene Iso-Datum zu einem Java-Datum. Bei ungültigen Parameterangaben wird null zurückgeliefert.
      Parameters:
      isoDate - Datum in ISO Schreibweise YYYYMMDDHHMMSS
      Returns:
      Java-Datum oder null bei einem Fehler
      Since:
      8.00.000

    • dateFromString

      public Date dateFromString(String date)
      Konvertiert den Eingabestring in ein Date Objekt in Abhängigkeit der aktuellen Einstellungen.
      Parameters:
      date - Datumsangabe
      Returns:
      Erkanntes Datum
      Since:
      10.00.000

    • displayDateFromIso

      public String displayDateFromIso(String isoDate)
      Formatiert den angegebenen ISO-Datumsstring in eine Datumsanzeige um. Dabei wird die übliche Formatierung M/D/Y oder T.M.J berücksichtigt. Falls das Datum auch eine Uhrzeit enthält, wird diese ignoriert. Bei null wir ein leerer String zurückgegeben.
      Parameters:
      isoDate - Datum in ISO Schreibweise YYYYMMDDHHMMSS
      Returns:
      Formatierte Datumsanzeige
      Since:
      8.00.000

    • displayDateFromIsoWithTime

      public String displayDateFromIsoWithTime(String isoDate)
      Formatiert einen ISO Datumsstring in eine Datumsanzeige um. Dabei wird die übliche Formatierung M/D/Y oder T.M.J berücksichtigt. Falls das Datum auch eine Uhrzeit enthält, wird diese ebenfalls formatiert. Bei null wir ein leerer String zurückgegeben.
      Parameters:
      isoDate - Datum in ISO Schreibweise YYYYMMDD oder YYYYMMDDHHMMSS
      Returns:
      Formatierte Datumsanzeige
      Since:
      8.00.000

    • isoFromDate

      public String isoFromDate(Date date)
      Konvertiert das angegebene Java-Datum nach einem Iso-Datum. Bei ungültigen Paramterangaben wird null zurückgeliefert.
      Parameters:
      date - Java-Datum
      Returns:
      Datum in ISO Schreibweise YYYYMMDDHHMMSS
      Since:
      8.00.000

    • eloDateFromJavaDate

      public int eloDateFromJavaDate(Date date)
      Erzeugt aus dem angegebene Java-Datum ein ELO-Datum. Das interne Java Datum läuft in Millisekunden vom 1.1.1970, das ELO Datum in Minuten vom 1.1.1900
      Parameters:
      date - Java-Datum
      Returns:
      ELO-Datum
      Since:
      8.00.000

    • eloDateFromJavaDate

      public int eloDateFromJavaDate(long date)
      Erzeugt aus dem angegebene Java-Datum ein ELO-Datum. Das interne Java Datum läuft in Millisekunden vom 1.1.1970, das ELO Datum in Minuten vom 1.1.1900
      Parameters:
      date - Java-Datum
      Returns:
      ELO-Datum
      Since:
      8.00.000

    • getDateWithoutTime

      public Date getDateWithoutTime(Date date)
      Liefert das übergebene Datum ohne Uhrzeit zurück (0:00:00.000).
      Parameters:
      date - Java-Datum
      Returns:
      Java-Datum ohne Uhrzeit
      Since:
      8.00.000

    • getNow

      public Date getNow(int offsetMinutes)
      Liefert ein Datum mit der aktuellen Uhrzeit und die addierten angegebenen Minuten zurück.
      Parameters:
      offsetMinutes - Anzahl der Minuten, die zur aktuellen Zeit addiert werden
      Returns:
      Datum
      Since:
      8.00.000

    • getToday

      public Date getToday()
      Liefert das Datum / Zeit des heutigen Tages zurück.
      Returns:
      Datum
      Since:
      8.00.000

    • getYesterday

      public Date getYesterday()
      Liefert das Datum des gestrigen Tages zurück.
      Returns:
      Datum
      Since:
      8.00.000

    • getTomorrow

      public Date getTomorrow()
      Liefert das Datum des nächsten Tages zurück.
      Returns:
      Datum
      Since:
      8.00.000

    • isValidIsoDate

      public boolean isValidIsoDate(String isoDate)
      Meldet zurück, ob das angegebene Iso-Datum gültig ist.
      Parameters:
      isoDate - Iso-Datum
      Returns:
      Gültiges Iso-Datum
      Since:
      8.00.000

    • isNewerThan

      public boolean isNewerThan(Date firstDate, Date secondDate)
      Meldet zurück, ob das erste Datum nach dem zweiten Datum liegt.
      Parameters:
      firstDate - Erstes Datum
      secondDate - Zweites Datum
      Returns:
      Bei true liegt das erste Datum nach dem zweiten Datum
      Since:
      8.00.000

    • dateDiff

      public Date dateDiff(Date firstDate, int daysOffset)
      Deprecated.
      UNDER CONSTRUCTION, do not use this function, it may change.
      Addiert eine Anzahl von Tagen zu einem Datum.
      Parameters:
      firstDate - Startdatum
      daysOffset - Anzahl der Tage um die das Datum verschoben wird.
      Returns:
      Datum
      Since:
      8.01.000

    • setObjKeyValue

      public void setObjKeyValue(Sord sord, int no, String value) throws Exception
      Setzt den Wert des angegebenen Indexfelds.
      Parameters:
      sord - Verschlagwortung
      no - Nummer des Indexfelds, ACHTUNG: Zählung beginnt hier bei 0
      value - Der zu setzende Wert des Indexfelds. Um einen Spaltenindes zu verwenden, müssen die Werte durch ein Pilcrow (¶) getrennt sein.
      Throws:
      Exception - Wenn das Indexfeld nicht gefunden wird.
      Since:
      8.01.004

    • setObjKeyValue

      public void setObjKeyValue(Sord sord, String name, String value) throws Exception
      Setzt den Wert des angegebenen Indexfelds.
      Parameters:
      sord - Verschlagwortung
      name - Gruppen-Name des Indexfelds, ACHTUNG: Diese Auswahl ist nicht eindeutig, bei mehreren Indexfeldern mit diesem Namen wird die erste benutzt.
      value - Der zu setzende Wert des Indexfelds. Um einen Spaltenindes zu verwenden, müssen die Werte durch ein Pilcrow (¶) getrennt sein.
      Throws:
      Exception - Wenn das Indexfeld nicht gefunden wird.
      Since:
      8.01.004

    • getObjKeyValue

      public String getObjKeyValue(Sord sord, int no) throws Exception
      Liefert den Wert des angegeben Indexfelds zurück.
      Parameters:
      sord - Verschlagwortung
      no - Nummer des Indexfelds, ACHTUNG: Zählung beginnt hier bei 0
      Returns:
      Wert des Indexfelds. Falls ein Spaltenindex vorhanden ist, sind die Werte durch ein Pilcrow (¶) getrennt.
      Throws:
      Exception - Wenn das Indexfeld nicht gefunden wird.
      Since:
      8.01.004

    • getObjKeyValue

      public String getObjKeyValue(Sord sord, String name) throws Exception
      Liefert den Wert des angegebenen Indexfelds zurück.
      Parameters:
      sord - Verschlagwortung
      name - Gruppen-Name des Indexfelds, ACHTUNG: Diese Auswahl ist nicht eindeutig, bei mehreren Indexfeldern mit diesem Namen wird die erste benutzt.
      Returns:
      Wert des Indexfelds. Falls ein Spaltenindex vorhanden ist, sind die Werte durch ein Pilcrow (¶) getrennt.
      Throws:
      Exception - Wenn das Indexfeld nicht gefunden wird.
      Since:
      8.01.004

    • getResource

      public String getResource(String bundleName, String resourceName, String locale)
      Liefert einen Text aus einem Resource Bundle zurück. Dabei kann optional ein locale Name angegeben werden. Wenn die null oder ein Leerstring ist, wird die default-Locale des Clients verwendet. Aufgrund der verwendeten internen Struktur ist die englische Übersetzung nicht über eine locale Einstellung erreichbar.
      Parameters:
      bundleName - Resource Bundle welches nach dem Text durchsucht werden soll.
      resourceName - Name der Text Resource
      locale - Optional, Name der Zielsprache, wenn null oder leer - default Sprache
      Returns:
      gesuchter Text
      Since:
      8.03.000

    • getText

      public String getText(String ressourceName, String textID)
      Liefert einen Eintrag aus einer Text-Ressource-Datei für die aktuelle Sprache.
      Parameters:
      ressourceName - Bezeichnung der Ressource mit den Texten
      textID - Begriff
      Returns:
      Text-Eintrag oder textID, falls kein passender Eintrag gefunden wurde.
      Since:
      8.03.000

    • createPdf

      public File createPdf(File file) throws Exception
      Erstellt eine PDF-Datei aus der angegebenen TIFF-Datei im temporären Java Client Verzeichnis.
      Parameters:
      file - TIFF-Datei
      Returns:
      File PDF-Datei oder null
      Throws:
      Exception - Wenn die Datei nicht konvertiert werden konnte.
      Since:
      8.04.000

    • createHtmlUrl

      public File createHtmlUrl(String url, String title, String screenshot, boolean directLink) throws Exception
      Erstellt eine Html-Datei zur Ablage einer Url im temporären Java Client Verzeichnis.
      Parameters:
      url - Komplette URL, welche abgelegt werden soll
      title - Webseitentitel oder null für automatischen Titel
      screenshot - Pfad zu einem Screenshot oder data String eines Bildes oder null
      directLink - true überspringt Übersichtsseite bei der Vorschau und wechselt direkt auf die Webseite
      Returns:
      File Html-Datei oder null
      Throws:
      Exception - Wenn die Datei nicht erstellt werden konnte.
      Since:
      12.00.000

    • joinFiles

      public File joinFiles(File firstFile, File secondFile) throws Exception
      Fügt zwei Dokumentendateien zusammen und gibt das Ergebnis in einer temporären Datei zurück.
      Parameters:
      firstFile - Erster Teil
      secondFile - Zweiter Teil
      Returns:
      Zieldatei im Temp-Ordner
      Throws:
      Exception - Wenn die Dateien nicht zusammengefasst werden konnten.
      Since:
      8.05.000 Es werden nur TIFF Dokumente akzeptiert. Bei allen anderen Dateitypen gibt es ein undefiniertes Ergebnis., 9.01.000 geht jetzt auch mit PDF Files

    • readMail

      public MailItem readMail(File file)
      Liest eine E-Mail im MSG oder EML Format ein und gibt ein MailItem zurück
      Parameters:
      file - lokal gepeicherte E-Mail im MSG oder EML Format
      Returns:
      MailItem
      Since:
      9.02.000

    • getExifTag

      public String getExifTag(File sourceFile, String tagName) throws Exception
      Liefert den Wert eines Exif Tags zurück.
      Parameters:
      sourceFile - Zu analysierende Tiff/ JPEG Datei
      tagName - Name des Exif Tags
      Returns:
      Wert des Exif Tags
      Throws:
      Exception - Wenn das Dokument nicht gelesen werden kann.
      Since:
      10.00.000

    • getExifTagNames

      public Enumeration<String> getExifTagNames(File sourceFile) throws Exception
      Liefert die Liste Exif Tags zurück.
      Parameters:
      sourceFile - Zu analysierende Tiff/ JPEG Datei
      Returns:
      Enumeration der Exif Tag Namen
      Throws:
      Exception - Wenn das Dokument nicht gelesen werden kann.
      Since:
      10.01.000

    • convertX400toSmtp

      public String convertX400toSmtp(String x400Address) throws Exception
      Wandelt eine X400 Adresse in eine SMTP Adresse um. Vorausgesetzt Outlook ist installiert und hat Zugriff auf den entsprechenden Exchange Server
      Parameters:
      x400Address - X400 Adresse
      Returns:
      SMTP Adresse
      Throws:
      Exception - Wenn nicht auf Outlook zugegriffen werden konnte oder die Adresse nicht aufgelöst werden kann.
      Since:
      9.02.000

    • isValidEMailAddress

      public static boolean isValidEMailAddress(String mailAddress)
      Rudimentärer Test ob E-Mail Adresse gültig ist
      Parameters:
      mailAddress - Zu testende E-Mail Adresse
      Returns:
      ob E-Mail Adresse gültig ist
      Since:
      9.02.000

    • createHtmlMail

      public boolean createHtmlMail(String recipient, String subject, String addToBody, File[] attachmentFiles)
      Erzeugt eine Mail für den Versand mit Empfänger (optional), Subject und html body Text sowie einer Dateiliste für die Attachments.
      Parameters:
      recipient - Empfänger
      subject - Betreff
      addToBody - Text, welcher an den Anfang des Mail-Bodys eingefügt wird.
      attachmentFiles - Anhänge
      Returns:
      true
      Since:
      11.00.000

    • resolve

      public String resolve(String sourceTemplate, Sord sourceData, Map<String,String> extraData, boolean escapeHtml)
      Löst die Platzhalter in einem vorgegebenen String gegen die Werte in dem übergebenen Sord Objekt oder der Map auf. Die Werte der Map haben Priorität über das Sord Objekt.
      Parameters:
      sourceTemplate - Text mit Platzhaltern
      sourceData - Sord
      extraData - Zusätzliche Daten, welche Platzhalter ersetzten.
      escapeHtml - Flag HTML escapen
      Returns:
      Text mit den ersetzten Werten

    • splitParams

      public Map<String,String> splitParams(String params)
      Löst den Parameter-String von der Dropzone in einzelne Map Einträge auf.
      Parameters:
      params - Parameter-String
      Returns:
      Key-Value Paare der Parameter
      Since:
      11.00.000