ch.elexis.data
Class Kontakt

java.lang.Object
  ch.elexis.data.PersistentObject
      ch.elexis.data.Kontakt

All Implemented Interfaces:

IPersistentObject, ISelectable

Direct Known Subclasses:

Organisation, Person, Rechnungssteller

public class Kontakt
extends PersistentObject

Ein Kontakt ist der kleinste gemeinsame Nenner anller Arten von Menschen und Institutionen und somit die Basisklasse für alle Kontakte. Ein Kontakt hat eine Anschrift und beliebig viele zusätzliche Bezugsadressen, sowie Telefon, E-Mail und Website. Zu einem Kontakt können ausserdem Reminders erstellt werden. Schliesslich hat jeder Kontakt noch einen "Infostore", einen im Prinzip unbegrenzt grossen Speicher für beliebig viele parameter=wert - Paare, wo Informationen aller Art abgelegt werden können. Jedem Element des Infostores können Zugriffsrechte zugeteilt werden, die definieren, wer dieses Element lesen und Schreiben darf.

Nested Class Summary

static class

Kontakt.statL

Nested classes/interfaces inherited from class ch.elexis.data.PersistentObject

PersistentObject.FieldType

Field Summary

static java.lang.String[]	DEFAULT_SORT
static java.lang.String	FLD_ANSCHRIFT
static java.lang.String	FLD_COUNTRY
static java.lang.String	FLD_E_MAIL
static java.lang.String	FLD_FAX
static java.lang.String	FLD_IS_LAB
static java.lang.String	FLD_IS_MANDATOR
static java.lang.String	FLD_IS_ORGANIZATION
static java.lang.String	FLD_IS_PATIENT
static java.lang.String	FLD_IS_PERSON
static java.lang.String	FLD_IS_USER
static java.lang.String	FLD_MOBILEPHONE
static java.lang.String	FLD_NAME1
static java.lang.String	FLD_NAME2
static java.lang.String	FLD_NAME3
static java.lang.String	FLD_PHONE1
static java.lang.String	FLD_PHONE2
static java.lang.String	FLD_PLACE
static java.lang.String	FLD_REMARK
static java.lang.String	FLD_SHORT_LABEL
static java.lang.String	FLD_STREET
static java.lang.String	FLD_WEBSITE
static java.lang.String	FLD_ZIP
protected static java.lang.String	TABLENAME

Fields inherited from class ch.elexis.data.PersistentObject

CACHE_DEFAULT_LIFETIME, CACHE_MIN_LIFETIME, CFG_CONNECTSTRING, CFG_DRIVER, CFG_FOLDED_CONNECTION, CFG_PWD, CFG_TYPE, CFG_USER, DATE_COMPOUND, default_lifetime, DELETED, EXISTS, FLD_DATE, FLD_DELETED, FLD_EXTINFO, FLD_LASTUPDATE, INEXISTENT, INVALID_ID, log, MAPPING_ERROR_MARKER, MATCH_AUTO, MATCH_CONTAINS, MATCH_EXACT, MATCH_REGEXP, MATCH_START

Fields inherited from interface ch.elexis.core.data.IPersistentObject

FLD_ID, STATE_EXISTING, STATE_INEXISTENT, STATE_INVALID_ID

Constructor Summary

protected	Kontakt()
protected	Kontakt(java.lang.String id)

Method Summary

BezugsKontakt	addBezugsKontakt(Kontakt adr, java.lang.String sBezug) Eine neue Zusatzadresse zu diesem Kontakt zufügen
java.lang.String	createStdAnschrift()
boolean	delete() Ein Objekt und ggf. dessen XID's aus der Datenbank löschen the object is not deleted but rather marked as deleted.
static Kontakt	findKontaktfromInfoStore(java.lang.Class clazz, java.lang.String field, java.lang.String value) Einen Kontakt finden, der einen bestimmten Eintrag im Infostore enthält.
void	flushInfoStore(java.util.Map store) Den mit getInfoStore geholten Infostore wieder zurückschreiben.
Anschrift	getAnschrift() Die Anschrift dieses Kontakts holen
java.lang.String	getBemerkung()
java.util.List<BezugsKontakt>	getBezugsKontakte() Ein Array mit allen zu diesem Kontakt definierten Bezugskontakten holen
java.lang.Object	getInfoElement(java.lang.String elem) Ein Element aus dem Infostore auslesen Der Rückgabewert ist ein Object oder Null.
java.util.Map	getInfoStore() Den gesamten Infostore holen.
java.lang.String	getInfoString(java.lang.String elem) Convenience-Methode und einen String aus dem Infostore auszulesen.
java.lang.String	getKuerzel()
java.lang.String	getLabel() Returns a label describing this Kontakt.
java.lang.String	getLabel(boolean shortLabel) Returns a label describing this Kontakt.
java.lang.String	getMailAddress()
MFUList<java.lang.String>	getMFU(java.lang.String typ)
java.lang.String	getPostAnschrift(boolean multiline)
java.lang.String	getPostAnschriftPhoneFaxEmail(boolean multiline, boolean including_phone) Synthesize the address lines to output from the entries in Kontakt k.
Reminder[]	getRelatedReminders() Die Reminders zu diesem Kontakt holen
java.util.List<java.lang.String>	getStatForItem(java.lang.String typ) Statistik für einen bestimmten Objekttyp holen
java.util.List<java.lang.String>	getStatForString(java.lang.String typ)
protected java.lang.String	getTableName() Jede abgeleitete Klasse muss deklarieren, in welcher Tabelle sie gespeichert werden will.
boolean	istOrganisation()
boolean	istPatient()
boolean	istPerson()
boolean	isValid() Angeben, ob dieses Objekt gültig ist.
static Kontakt	load(java.lang.String id) Kontakt mit gegebener Id aus der Datanbank einlesen
void	setAnschrift(Anschrift adr) Die Anschrift dieses Kontakts setzen
void	setBemerkung(java.lang.String b)
void	setInfoElement(java.lang.String elem, java.lang.Object val) Ein Element in den Infostore schreiben.
void	setMFU(java.lang.String typ, MFUList<java.lang.String> mfu)
void	statForItem(PersistentObject lst) Eine Statistik für ein bestimmtes Objekt anlegen.
void	statForString(java.lang.String typ, java.lang.String toStat)

Methods inherited from class ch.elexis.data.PersistentObject

addChangeListener, addMapping, addSticker, addToList, addXid, begin, checkNull, checkZero, checkZeroDouble, clearCache, connect, connect, create, createOrModifyTable, deleteList, disconnect, equals, executeScript, executeSQLScript, exists, exportData, flatten, fold, get, get, getBinary, getCacheTime, getConnection, getConstraint, getDefaultCacheLifetime, getExportFields, getExportUIDValue, getExportUIDVersion, getFieldType, getId, getInt, getLastUpdate, getList, getList, getMap, getSticker, getStickers, getVersionedResource, getWrappedId, getXid, getXid, getXids, hashCode, isAvailable, isDeleted, isDragOK, isMatching, isMatching, isMatching, isMatching, lock, map, removeChangeListener, removeFromList, removeFromList, removeSticker, removeTable, resetCache, set, set, setBinary, setConstraint, setDefaultCacheLifetime, setInt, setMap, setTrace, setVersionedResource, state, storeToString, tableExists, ts, undelete, unlock

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

FLD_E_MAIL

public static final java.lang.String FLD_E_MAIL

See Also:

Constant Field Values

FLD_WEBSITE

public static final java.lang.String FLD_WEBSITE

See Also:

Constant Field Values

FLD_MOBILEPHONE

public static final java.lang.String FLD_MOBILEPHONE

See Also:

Constant Field Values

FLD_FAX

public static final java.lang.String FLD_FAX

See Also:

Constant Field Values

FLD_IS_LAB

public static final java.lang.String FLD_IS_LAB

See Also:

Constant Field Values

FLD_IS_MANDATOR

public static final java.lang.String FLD_IS_MANDATOR

See Also:

Constant Field Values

FLD_IS_USER

public static final java.lang.String FLD_IS_USER

See Also:

Constant Field Values

FLD_SHORT_LABEL

public static final java.lang.String FLD_SHORT_LABEL

See Also:

Constant Field Values

FLD_IS_ORGANIZATION

public static final java.lang.String FLD_IS_ORGANIZATION

See Also:

Constant Field Values

FLD_IS_PATIENT

public static final java.lang.String FLD_IS_PATIENT

See Also:

Constant Field Values

FLD_IS_PERSON

public static final java.lang.String FLD_IS_PERSON

See Also:

Constant Field Values

FLD_ANSCHRIFT

public static final java.lang.String FLD_ANSCHRIFT

See Also:

Constant Field Values

FLD_COUNTRY

public static final java.lang.String FLD_COUNTRY

See Also:

Constant Field Values

FLD_PLACE

public static final java.lang.String FLD_PLACE

See Also:

Constant Field Values

FLD_ZIP

public static final java.lang.String FLD_ZIP

See Also:

Constant Field Values

FLD_STREET

public static final java.lang.String FLD_STREET

See Also:

Constant Field Values

FLD_PHONE2

public static final java.lang.String FLD_PHONE2

See Also:

Constant Field Values

FLD_PHONE1

public static final java.lang.String FLD_PHONE1

See Also:

Constant Field Values

FLD_REMARK

public static final java.lang.String FLD_REMARK

See Also:

Constant Field Values

FLD_NAME3

public static final java.lang.String FLD_NAME3

See Also:

Constant Field Values

FLD_NAME2

public static final java.lang.String FLD_NAME2

See Also:

Constant Field Values

FLD_NAME1

public static final java.lang.String FLD_NAME1

See Also:

Constant Field Values

TABLENAME

protected static final java.lang.String TABLENAME

See Also:

Constant Field Values

DEFAULT_SORT

public static final java.lang.String[] DEFAULT_SORT

Constructor Detail

Kontakt

protected Kontakt(java.lang.String id)

Kontakt

protected Kontakt()

Method Detail

getTableName

protected java.lang.String getTableName()

Description copied from class: PersistentObject

Jede abgeleitete Klasse muss deklarieren, in welcher Tabelle sie gespeichert werden will.

Specified by:

getTableName in class PersistentObject

Returns:

Der Name einer bereits existierenden Tabelle der Datenbank

getLabel

public java.lang.String getLabel()

Returns a label describing this Kontakt. The default implementation returns the short label, i. e. label(false) Sublcasses should overwrite getLabel(boolean short) for defining their own labels.

Specified by:

getLabel in interface IPersistentObject

Specified by:

getLabel in class PersistentObject

Returns:

a string describing this Kontakt.

getLabel

public java.lang.String getLabel(boolean shortLabel)

Returns a label describing this Kontakt. The default implementation returns "Bezeichnung1" for the short label, and "Bezeichnung1", "Bezeichnung2", "Strasse", "Plz" and "Ort", separated with a comma, for the long label. Subclasses can overwrite this method and define their own label(s). If short is true, they should return a short label suitable for addresses. If short is false, they should return a long label describing all important properties of this Kontakt for unique identification by the user.

Parameters:

shortLabel - return a short label for true, and a long label otherwise

Returns:

a string describing this Kontakt.

isValid

public boolean isValid()

Description copied from class: PersistentObject

Angeben, ob dieses Objekt gültig ist.

Specified by:

isValid in interface IPersistentObject

Overrides:

isValid in class PersistentObject

Returns:

true wenn die Daten gültig (nicht notwendigerweise korrekt) sind

getBezugsKontakte

public java.util.List<BezugsKontakt> getBezugsKontakte()

Ein Array mit allen zu diesem Kontakt definierten Bezugskontakten holen

Returns:

Ein Adress-Array, das auch die Länge null haben kann

getAnschrift

public Anschrift getAnschrift()

Die Anschrift dieses Kontakts holen

setAnschrift

public void setAnschrift(Anschrift adr)

Die Anschrift dieses Kontakts setzen

getPostAnschrift

public java.lang.String getPostAnschrift(boolean multiline)

createStdAnschrift

public java.lang.String createStdAnschrift()

getPostAnschriftPhoneFaxEmail

public java.lang.String getPostAnschriftPhoneFaxEmail(boolean multiline,
                                                      boolean including_phone)

Synthesize the address lines to output from the entries in Kontakt k. added to implement the output format desired for the copyAddressToClipboard() buttons. We might synthesize our own "Anschrift" for each Kontakt, completely according to our own requirements, OR use any of the methods defined for Kontakt like: getLabel...(), getPostAnschrift, createStandardAnschrift, List... - The declaration of Kontakt with field definitions is available in Kontakt.java, please look therein for additional details. Click-Right -> declaration on Kontakt in Eclipse works. You can also look above to see the fields that printList would use. getPostAnschrift() does NOT use the System.getProperty("line.separator"); which I use bwlow after the Fax number (and also in the calling code, before a possibly succeeding addresses. getPostAnschrift() instead replaces all line separators by either \\n or space at the end of its run; and I keep that code, +-multiline support herein as well to maintain similar usage of both methods. On a Win2K system, `that has the following effects when pasting the address(es) into various targets: notepad: All elements of an address in one line, box characters instead of the newline (or cr?) character. textpad: New line after each line within an address and between addresses. winword 97: "new paragraph" after each line within an address, and before a succeeding address. openoffice 2.0.3: "new line" after each line within an address; "new paragraph" after the Fax number and before a succeeding address. I could replace it via "line.separator", but as the above findings show, this is not urgently required. And actually, it may eben be useful to have two separators (and even the "correct" behaviour, in openoffice, at least...).

addBezugsKontakt

public BezugsKontakt addBezugsKontakt(Kontakt adr,
                                      java.lang.String sBezug)

Eine neue Zusatzadresse zu diesem Kontakt zufügen

Parameters:

adr - die Adresse

sBezug - ein Text, der die Beziehung dieser Adresse zum Kontakt definiert (z.B. "Geschäftlich" oder "Orthopäde" oder so)

load

public static Kontakt load(java.lang.String id)

Kontakt mit gegebener Id aus der Datanbank einlesen

getMailAddress

public java.lang.String getMailAddress()

getRelatedReminders

public Reminder[] getRelatedReminders()

Die Reminders zu diesem Kontakt holen

delete

public boolean delete()

Description copied from class: PersistentObject

Ein Objekt und ggf. dessen XID's aus der Datenbank löschen the object is not deleted but rather marked as deleted. A purge must be applied to remove the object really

Overrides:

delete in class PersistentObject

Returns:

true on success

getInfoElement

public java.lang.Object getInfoElement(java.lang.String elem)

Ein Element aus dem Infostore auslesen Der Rückgabewert ist ein Object oder Null. Wenn die Rechte des aktuellen Anwenders zum Lesen dieses Elements nicht ausreichen, wird ebenfalls Null zurückgeliefert. 2.9.2007 We remove the checks. they are useless at this moment better check permissions on inout fields. gw

getInfoString

public java.lang.String getInfoString(java.lang.String elem)

Convenience-Methode und einen String aus dem Infostore auszulesen.

Parameters:

elem - Name des Elements

Returns:

Wert oder "" wenn das Element nicht vorhanden ist oder die Rechte nicht zum Lesen ausreichen

setInfoElement

public void setInfoElement(java.lang.String elem,
                           java.lang.Object val)

Ein Element in den Infostore schreiben. Wenn ein Element mit demselben Namen schon existiert, wird es überschrieben. Wenn die Rechte des angemeldeten Anwenders nicht für das Schreiben dieses Elements ausreichen, wird die Funktion still ignoriert.

Parameters:

elem - Name des Elements

val - Inhalt des Elements 2.9.2007 emoved the checks g. weirich

getInfoStore

public java.util.Map getInfoStore()

Den gesamten Infostore holen. Dies ist sinnvoll, wenn kurz nacheinander mehrere Werte gelesen oder geschrieben werden sollen, da damit das wiederholte entpacken/packen gespart wird. Nach Änderungen muss der Store mit flushInfoStore() explizit gesichert werden. ACHTUNG: Nicht Thread-Safe. Konkurriende Schreiboperationen, während ein Thread den store hält, werden verlorengehen.

Returns:

eine Hashtable, die die parameter-wert-paare enthält.

flushInfoStore

public void flushInfoStore(java.util.Map store)

Den mit getInfoStore geholten Infostore wieder zurückschreiben. Dies muss immer dann geschehen, wenn nach getInfoStore() schreiboperationen durchgeführt wurden.

Parameters:

store - die zuvor mit getInfoStore() erhaltene Hashtable.

findKontaktfromInfoStore

public static Kontakt findKontaktfromInfoStore(java.lang.Class clazz,
                                               java.lang.String field,
                                               java.lang.String value)

Einen Kontakt finden, der einen bestimmten Eintrag im Infostore enthält. Falls mehrere passende Kontakte vorhanden sind, wird nur der erste zurückgeliefert.

Parameters:

clazz - Unterklasse von Kontakt, nach der gesucht werden soll

field - Name des gesuchten Infostore-Eintrags

value - gesuchter Wert dieses Eintrags

Returns:

Ein Objekt der Klasse clazz, welches einen Infostore-Eintrag field mit dem Inhalt value enthält, oder null wenn kein solches Objekt existiert.

getStatForItem

public java.util.List<java.lang.String> getStatForItem(java.lang.String typ)

Statistik für einen bestimmten Objekttyp holen

Parameters:

typ - Der Typ (getClass().getName()) des Objekts.

Returns:

eine Liste mit Objektbezeichnern, die zwischen 0 und 30 nach Häufigkeit sortierte Elemente enthält.

statForItem

public void statForItem(PersistentObject lst)

Eine Statistik für ein bestimmtes Objekt anlegen. Es wird gezählt, wie oft diese Funktion für dieses Objekt schon aufgerufen wurde, und Objekte desselben Typs aber unterschiedlicher Identität werden in einer Rangliste aufgelistet. Diese Rangliste kann mit getStatForItem() angerufen werden. Die Rangliste enthält maximal 40 Einträge.

Parameters:

lst - Das Objekt, das gezählt werden soll.

statForString

public void statForString(java.lang.String typ,
                          java.lang.String toStat)

getStatForString

public java.util.List<java.lang.String> getStatForString(java.lang.String typ)

getMFU

public MFUList<java.lang.String> getMFU(java.lang.String typ)

setMFU

public void setMFU(java.lang.String typ,
                   MFUList<java.lang.String> mfu)

getKuerzel

public java.lang.String getKuerzel()

getBemerkung

public java.lang.String getBemerkung()

setBemerkung

public void setBemerkung(java.lang.String b)

istPerson

public boolean istPerson()

istPatient

public boolean istPatient()

istOrganisation

public boolean istOrganisation()