Kontakteliste DiPlanCockpit Basis

Relevanz der Kontakteliste

Im Reiter Konfiguration des Admin-Bereichs besteht die Möglichkeit, die Kontakteliste in Form einer XML-Datei herunterzuladen und hochzuladen. Beim Hochladen werden ältere Kontatktangaben überschrieben.

Die Kontakteliste hinterlegt global, das heißt für alle Verfahren, Kontakte im DiPlanCockpit. Darin aufgeführte Kontakte können über Platzhalter in Mustervorlagen und Export-Templates eingesetzt werden.

Anleitung zur Anpassung der Kontakteliste

Die folgende XML ist eine mögliche Default-Kontakteliste mit zwei Beispieleinträgen "EMusterfrau" und "MMustermann". Die beiden Einträge "xbeteiligung-nachrichtenkopf-autor" und "xbeteiligung-nachrichtenkopf-leser" sind technisch notwendig für die Kommunikation des DiPlanCockpit Pro mit xBeteiligung. Die Werte der Einträge können angepasst werden.

Anhand der vorhandenen Einträge in der kontakte.xml lässt sich die Struktur erkennen und es folgt eine Erläuterung, wie die Datei angepasst werden kann.

Beispiel XML

<kontakte>
 <kontakt id="xbeteiligung-nachrichtenkopf-autor">
        <uuid>3b978825-6d14-49df-b6ee-a7faca643212</uuid>
        <praefix>xyz</praefix>
        <kennung>0001</kennung>
        <behoerdenname>behoerde1</behoerdenname>
        <telefon>+49 30 123456</telefon>
        <email>hans.mustermann@example.com</email>
  </kontakt>
  <kontakt id="xbeteiligung-nachrichtenkopf-leser">
        <uuid>e1e208b5-96c2-4288-8b2b-62ad15684e89</uuid>
        <praefix>xyz</praefix>
        <kennung>0002</kennung>
        <behoerdenname>behoerde2</behoerdenname>
        <telefon>+49 30 123456</telefon>
        <email>hans.mustermann@example.com</email>
  </kontakt>
  <kontakt id="EMusterfrau">
    <uuid>0001</uuid>
    <name>Erika Musterfrau</name>
    <telefon>+49 30 123456</telefon>
    <fax>+49 30 234567</fax>
    <zustellung/>
    <strasse>Beispiel Straße 1a</strasse>
    <ort>Musterort</ort>
    <plz>34512</plz>
    <land>DEU</land>
    <email>erika.musterfrau@example.com</email>
    <link>https://example.com/</link>
  </kontakt>
  <kontakt id="MMustermann">
    <uuid>0002</uuid>
    <name>Max Mustermann</name>
    <telefon>+49 30 654321</telefon>
    <fax>+49 30 765432</fax>
    <zustellung/>
    <strasse>Musterstraße 99</strasse>
    <ort>Beispielstadt</ort>
    <plz>10243</plz>
    <land>DEU</land>
    <email>max.mustermann@example.com</email>
    <link>https://example.com/</link>
  </kontakt>
</kontakte>

Erläuterung der Struktur

Die Datei enthält das übergreifende Element "kontakte", darin sind nacheinander die einzelnen Kontakte als "kontakt" aufgeführt.

Jedes "kontakt"-Element muss über eine eindeutige "uuid" verfügen, da diese ID zur Bestimmung eines Kontaktes dient. Was als uuid dient ist beliebig, es kann z.B. ein Personen- oder Abteilungskürzel sein.

Anpassung der XML

Es können eigene Elemente, z.B. eine zweite Telefonnummer, ergänzt werden, da es keine XSD gibt, die eine Struktur vorgeben würde. Nur eine weitere Verschachtelung ist nicht möglich, das heißt es darf keine weitere Ebene eingerückt werden. Vorhanden sein müssen nur die eindeutige uuid und der Name.

Bearbeitung oder Löschung eines vorhandenen Kontakts

Ein vorhandener Kontakt lässt sich durch Änderung der Werte in der XML aktualisieren. Wenn sich beispielsweise eine Adresse geändert hat, so können die entsprechenden Einträge in der XML (strasse, ort, plz, land) angepasst werden.

Wird ein vorhandener Kontakt nicht mehr benötigt, kann der entsprechende Eintrag aus der XML gelöscht werden. Die beiden Einträge "xbeteiligung-nachrichtenkopf-autor" und "xbeteiligung-nachrichtenkopf-leser" dürfen angepasst aber NICHT gelöscht werden.

Hinzufügen eines neuen Kontakts

Ein neuer Kontakt lässt sich als ein neuer Eintrag in der XML hinzufügen. Am einfachsten ist es, einen alten Eintrag zu kopieren, erneut einzufügen und anschließend die neuen Kontaktdaten einzutragen. Dabei ist es wichtig eine neue id und uuid zu vergeben sowie einen Wert für name einzutragen. Die übrigen Angaben müssen nicht zwingend ausgefüllt sein.

Soll eine neue Kontaktinformation enthalten sein, beispielsweise eine zweite Telefonnummer, so kann diese in einer eigenen Zeile im kontakt ergänzt werden, beispielsweise in der Form <telefon2>+49 6543 890123</telefon2>.