at.finkzeit.zsw.server.ws

Class WSAttachedDocument

java.lang.Object

at.finkzeit.zsw.server.ws.WSAttachedDocument

public class WSAttachedDocument
extends java.lang.Object

Repräsentiert einen Anhang oder ein Verzeichnis von Anhängen.

Bilder zu einer Buchung bzw. zu einem Auftrag werden oft als Bildverzeichnis verspeichert (siehe isDirectory()), da oft mehrere Bilder an einer Buchung angehängt werden. Einzelne Dokumente (z.B. PDFs) werden üblicherweise direkt verspeichert.

Um Dateianhänge zu laden muss die Download-URL über getDownloadURL() abgerufen werden, solange die Webservice-Sitzung noch offen ist.

Constructor Summary

Constructors

Constructor and Description
WSAttachedDocument(at.finkzeit.zsw.server.spi.runtime.IFileDataPersistence.IEntry wrappedObj)

Method Summary

Modifier and Type	Method and Description
static WSAttachedDocument	build(java.lang.String session, java.lang.String publicId, at.finkzeit.zsw.server.globalfiledata.IGlobalFileDataPersistence fileDataPersistence, int recursionLimit)
java.lang.String	getDownloadURL() URL für den Download der Datei (ohne den Server-Teil).
java.lang.String	getId()
java.util.List<WSKeyValue>	getProperties() Meta-Daten zu diesem Anhang.
java.util.List<WSAttachedDocument>	getSubEntries() Liste von Einträgen in einem Verzeichnis.
boolean	isDirectory() Gibt an ob es sich um ein Verzeichnis mit Untereinträgen handelt oder nicht.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

WSAttachedDocument

public WSAttachedDocument(at.finkzeit.zsw.server.spi.runtime.IFileDataPersistence.IEntry wrappedObj)

Method Detail

getProperties

public java.util.List<WSKeyValue> getProperties()

Meta-Daten zu diesem Anhang.

Jede Datei hat eine Liste von Properties, die Meta-Daten über diese Datei enthalten. Der Umfang dieser Metadaten variiert, enthält aber immer die folgenden Einträge:

• fileType (z.B. application/pdf): der MIME-Type der Datei
• timestamp (z.B. 1398348242122): der Zeitpunkt, zu dem diese Datei in ZSW angelegt wurde (in Millisekunden seit 1970)

Die Metadaten einer Bestätigung enthalten weiters maschinenlesbare Informationen über die Daten, die in dieser Bestätigung enthalten sind. Das sind:

• Buchungspaare (approval.booking.NR) mit Dauern, Buchungen, Ebenen und Sonderfeldern. NR entspricht der Nummer des Buchungspaares
  • approval.booking.NR.duration: Dauer des Buchungspaares (in ms)
  • approval.booking.NR.from.id und approval.booking.NR.from.ts: ID und Zeitstempel der Beginn-Buchung dieses Buchungspaares
  • approval.booking.NR.to.id und approval.booking.NR.to.ts: ID und Zeitstempel der Ende-Buchung dieses Buchungspaares
  • approval.booking.NR.level.#.code, approval.booking.NR.level.#.id, approval.booking.NR.level.#.text: Code, ID und Beschreibung der Buchungsebene, # entspricht dabei der Ebenen-Nummer
  • Properties, ID entspricht der ID des jeweiligen BDE Sonderfeldes:
    • approval.booking.NR.property.ID.text: Text dieses Sonderfeld, sofern vorhanden
    • approval.booking.NR.property.ID.ts: Zeitstempel (in ms seit 1970) der Erstellung dieses Sonderfeldes
    • approval.booking.NR.property.ID.format: Formatierungs-String für dieses Sonderfeld, sofern vorhanden
    • approval.booking.NR.property.ID.numvalue: Numerischer Wert des Sonderfeldes, sofern vorhanden
    • approval.booking.NR.property.ID.divisor: Divisor bei numerischen Sonderfeldern (normalerweise 1)
• Die Gesamtdauer (approval.duration), die Bestätigt wurde (muss nicht unbedingt der Summe der Dauern aller Buchungspaare entsprechen)
• Die Summe über einzelne Sonderfelder, sofern vorhanden (approval.sum.ID.name,approval.sum.ID.unit, approval.sum.ID.value), ID entspricht dabei der ID des jeweiligen BDE Sonderfeldes. Diese Summe muss nicht unbedingt der Summe über alle Einzelwerte der in dieser Bestätigung enthaldenen Sondefelder entsprechen
• Die Person, die diese Bestätigung erstellte (approval.person.id, approval.person.name, approval.person.personid)

Beispiel:

        approval.booking.0.duration = 4140000
        approval.booking.0.from.id = 538
        approval.booking.0.from.ts = 1398329280000
        approval.booking.0.level.1.code = 123
        approval.booking.0.level.1.id = 10
        approval.booking.0.level.1.text = DPD Dornbirn
        approval.booking.0.property.2.divisor = 1
        approval.booking.0.property.2.text = Test
        approval.booking.0.property.2.ts = 1398329317080
        approval.booking.0.property.3.divisor = 1
        approval.booking.0.property.3.format = %3.0f
        approval.booking.0.property.3.numvalue = 125.0
        approval.booking.0.property.3.ts = 1398329326607
        approval.booking.0.property.4.divisor = 1
        approval.booking.0.property.4.linkid = 3
        approval.booking.0.property.4.ts = 1398329336843
        approval.booking.0.to.id = 542
        approval.booking.0.to.ts = 1398333420000
        approval.booking.1.duration = 360000
        approval.booking.1.from.id = 542
        approval.booking.1.from.ts = 1398333420000
        approval.booking.1.level.1.code = 123
        approval.booking.1.level.1.id = 10
        approval.booking.1.level.1.text = DPD Dornbirn
        approval.booking.1.to.id = 545
        approval.booking.1.to.ts = 1398333780000
        approval.booking.2.duration = 60000
        approval.booking.2.from.id = 545
        approval.booking.2.from.ts = 1398333780000
        approval.booking.2.level.1.code = 123
        approval.booking.2.level.1.id = 10
        approval.booking.2.level.1.text = DPD Dornbirn
        approval.booking.2.to.id = 548
        approval.booking.2.to.ts = 1398333840000
        approval.booking.3.duration = 240000
        approval.booking.3.from.id = 548
        approval.booking.3.from.ts = 1398333840000
        approval.booking.3.level.1.code = 123
        approval.booking.3.level.1.id = 10
        approval.booking.3.level.1.text = DPD Dornbirn
        approval.booking.3.to.id = 568
        approval.booking.3.to.ts = 1398334080000
        approval.duration = 01:20
        approval.person.id = 3
        approval.person.name = Fräser Franz
        approval.person.personid = 2134
        approval.sum.3.name = Nägel
        approval.sum.3.unit = St.
        approval.sum.3.value = 125
        description = Bestätigung
        fileType = application/pdf
        timestamp = 1398348242122
 

Returns:

Liste von Key/Value Paaren.

getId

public java.lang.String getId()

getDownloadURL

public java.lang.String getDownloadURL()

URL für den Download der Datei (ohne den Server-Teil). Diese URL wird ungültig, wenn die Webservice-Sitzung geschlossen wird.

Verzeichnisse (siehe isDirectory()) können nicht vom Server geladen werden, stattdessen muss jeder Eintrag im Verzeichnis (siehe getSubEntries()) einzeln geladen werden..

Returns:

Download-URL ohne Serveranteil

isDirectory

public boolean isDirectory()

Gibt an ob es sich um ein Verzeichnis mit Untereinträgen handelt oder nicht.

Verzeichnisse (siehe isDirectory()) können nicht vom Server geladen werden, stattdessen muss jeder Eintrag im Verzeichnis (siehe getSubEntries()) einzeln geladen werden..

Returns:

true wenn es sich um ein Verzeichnis handelt

getSubEntries

public java.util.List<WSAttachedDocument> getSubEntries()

Liste von Einträgen in einem Verzeichnis.

Returns:

Liste von Einträgen in einem Verzeichnis

See Also:

isDirectory()

build

public static WSAttachedDocument build(java.lang.String session,
                                       java.lang.String publicId,
                                       at.finkzeit.zsw.server.globalfiledata.IGlobalFileDataPersistence fileDataPersistence,
                                       int recursionLimit)
                                throws at.finkzeit.zsw.server.common.ServerMessage,
                                       java.io.IOException

Throws:

at.finkzeit.zsw.server.common.ServerMessage

java.io.IOException