Firmen anlegen und verwalten

Die interaktive Verwaltung von Firmen/Mandanten stützt sich per Standard auf eine kombinierte Ansicht (listDetailsWindow), die über den Menüeintrag Firmen/Mandanten im Hauptmenü geöffnet werden kann.

Der folgende Screenshot zeigt das Standard-Ribbon (für eine Rolle mit allen relevanten Berechtigungen), darunter die Standard-Erfassungsmaske mit den Details der im Listenbereich (ganz unten) ausgewählten Firma.

images/download/attachments/201678187/image-2025-5-21_15-15-22-version-1-modificationdate-1747833322601-api-v2.png

Besonderheiten im Ribbon

Neben den generischen Ribbon Buttons (Neu, Löschen, usw.) enthält die im Screenshot sichtbare Hauptkategorie ("Allgemein") auch zwei spezifische Ribbon Buttons für Firmen/Mandanten:

Unterkategorie

Ribbon Button

Beschreibung

Beispiel

Details

images/download/attachments/201678187/image-2025-5-21_15-26-53-version-1-modificationdate-1747834013523-api-v2.png

Der Ribbon Button Integration Einstellungen öffnet einen modalen Dialog mit spezifischen Einstellungen für "Mandanten" (Lobster Data Platform / Integration).


Übersicht

images/download/attachments/201678187/image-2025-5-21_15-27-21-version-1-modificationdate-1747834041039-api-v2.png

Der Ribbon Button Integration Einstellungen öffnet eine modale View, die die Firmenhierarchie ausgehend von einer ausgewählten Firma visualisiert.

Das Beispiel rechts zeigt eine sehr einfache Firmenhierarchie, in der die Firma "F_UTILITY B.V." der Firma "ZWORX Ltd." untergeordnet ist.


images/download/attachments/201678187/image-2025-5-21_15-21-43-version-1-modificationdate-1747833703464-api-v2.png


Inhalte der Standard-Erfassungsmaske

Die per Standard für Firmen/Mandanten angebotene Erfassungsmaske bildet nur eine Auswahl der insgesamt verfügbaren Inhalte der Datenstruktur für Firmen/Mandanten über Formularelemente ab.

Diese erscheinen auf drei Tab-Reiter verteilt:

Tab-Reiter "Firmenkonto"

Objekt

Feld

Datenfeldpfad

Beispielwert

Inhalt

"Firmenkonto"
(CompanyAccount)

Metatyp

metaType

"Firma" (COMPANY)

Einfachauswahl für den Firmen-Metatyp der Firma, z. B. "Firma" (COMPANY) oder "Gruppe" (GROUP).

Sprache

locale

"Deutsch" (de)

Einfachauswahl, die eine bestimmte Sprache mit der Firma verknüpft.

Stylename

styleName

"XFLOW"

Einfachauswahl, die einen von ggf. mehreren verfügbaren Styles mit der Firma verknüpft.

Übergeordnete Firmen

parentCompanies

"ZWORX Ltd."

Mehrfachauswahl von Firmen/Mandanten, die der Firma hierarchisch direkt übergeordnet sein sollen.

Firmentypen

types

"Rechnungsempfänger" (INV)
"Ablieferadresse" (DDA)
"Auftraggeber" (AAL)

Mehrfachauswahl für Firmentyp-Werte, die das "Profil" einer Firma charakterisiert und ggf. deren Beteiligung an modellierten Prozessen steuern hilft.

"Adresse"
(Address)
s. Adressen

Anrede

address.salutation 

"Firma" (COMPANY)

Einfachauswahl für die Anrede in der Firmenadresse.

Name

address.name1

"F_UTILITY B. V."

Freitext, der die Firma möglichst eindeutig kennzeichnen sollte, da er bevorzugt für Beschriftungen herangezogen wird (s. "Graph" oben).

Name 2

address.name2

"ZWORX Group"

Freitext, der nachrangigen Text für die Benennung der Firma festlegt.
HINWEIS◄ Bei Bedarf steht auch noch das Feld "Name 3" (address.name3) zur Verfügung.

Straße

address.street1 

"Dingshoflaan"

Freitext für die Straße in der Postadresse
HINWEIS◄ Bei Bedarf steht auch noch das Feld "Straße 2" (address.street2) zur Verfügung.

Hausnummer

address.streetNo

"57"

Freitext für Hausnummer(n) in der Postadresse

Kontonummer

address.accNumber

"002-101"

Freitext, der z. B. genutzt werden kann, um eine Kennung für die Firma in anderen Systemen anzugeben.

Land*

address.countryCode

"Niederlande" (NL)

Einfachauswahl für das Land in der Postadresse

Postleitzahl*

address.zipcode

"8043"

Freitext für die Postleitzahl in der Postadresse

Stadt*

address.city

"Zwolle"

Freitext für den Namen der Stadt in der Postadresse

*) Interaktive Änderungen an den Feldern Land, Postleitzahl und Stadt lösen ggf. ein Nachschlagen von Daten für Orte aus. Beim Übernehmen eines Treffers im automatisch eingeblendeten Dropdown werden ggf. auch Adressfelder mit für Orte hinterlegten Daten befüllt bzw. überschrieben, die die Standard-Erfassungsmaske für Firmen/Mandanten nicht anzeigt.

Tab-Reiter "Kommunikationsinformationen"

images/download/attachments/201678187/image-2025-5-21_16-38-18-version-1-modificationdate-1747838298197-api-v2.png

Der Screenshot zeigt das in der Standard-Erfassungsmaske für Firmen/Mandanten verwendete Format für die Eingabe von Kommunikationsinformationen.

  • Kommunikationsinformationen werden als Plurale Attribute des Typs "Kommunikationsinformation" (AddressCommunicationInfo) für die Firmenadresse gespeichert.

  • Im Feld Typ kann eine Kommunikationstyp ausgewählt werden. Einer Adresse können mehrere Einträge für denselben Typ zugeordnet werden.

  • Im Feld Kontext kann ein Textschlüssel angegeben werden, der den Verwendungszweck für die betreffende Kommunikationsinformation charakterisiert.

  • Im Feld Wert sollte die Schlüsselinformation für die Kommunikationsinformation (z. B. eine E-Mail-Adresse oder eine Telefonnummer) eingetragen werden.


images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/warning.svg ACHTUNGimages/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/warning.svg Für Plurale Attribute gilt die Restriktion, dass es beim Speichern keine komplette Redundanz zwischen zwei Instanzen des Attributs geben darf. Enthält die Liste der Kommunikationsinformationen mindestens zwei Einträge, die in Typ, Kontext und Wert komplett übereinstimmen, tritt beim Speichern ein Fehler auf.


HINWEIS◄ Besonders häufig werden Kommunikationsinformationen mit dem Typ E-Mail genutzt, um Daten für die Adressierung bei einem automatischen E-Mail-Versand zu hinterlegen. Für Firmen/Mandanten kann z. B. der Mailadresse Firma-Wertauflöser genutzt werden, um hinterlegte E-Mail-Adressen für einen bestimmten Kontext direkt nachzuschlagen, ohne diesen Lesezugriff auf die Attributstruktur der Adresse ausführlich konfigurieren zu müssen. Allerdings setzt der vereinfachte Zugriff über Mailversand (Wertauflöser) voraus, dass im Attribut ein Kontext hinterlegt ist.


ANMERKUNG◄ Auch wenn sich Kommunikationsinformationen auf einen Kommunikationstyp beziehen, handelt es sich formal nicht etwa um Typisierte Attribute sondern um Plurale Attribute (s. a. Geschäftsobjekte und Attribute). Dies muss beim Konfigurieren von Zugriffen (s. Attribut (Wertauflöser) bzw. Projektionen) berücksichtigt werden.

Tab-Reiter "Kontakte"

images/download/attachments/201678187/image-2025-5-21_17-47-44-version-1-modificationdate-1747842464995-api-v2.png

Der Screenshot zeigt das in der Standard-Erfassungsmaske für Firmen/Mandanten verwendete Format für die Eingabe von Kontakten.

  • Kontakte werden als Typisierte Attribute des Typs "Adresskontakt" (AddressContact) für die Firmenadresse gespeichert.

  • Jedes "Adresskontakt" (AddressContact)-Attribut referenziert über sein contactAddress-Feld eine vollwertige "Adresse" (Address)-Entität.

  • Die Standard-Erfassungsmaske beinhaltet neben dem Auswahlfeld/Combobox-Element für den Kontakttyp (s. Kontakttyp) nur eine sehr überschaubare Auswahl von Adressfeldern (Anrede, Name, Name 2). Sie kann bei Bedarf beliebig erweitert werden.


images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/warning.svg ACHTUNGimages/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/warning.svg Die Definition für die Aufzählung Kontakttyp verwendet das Kennzeichen "Plurales Attribut" (pluralAttribute) um Typen zu kennzeichnen, die demselben Attributbesitzer (hier: Adresse) mehrfach zugeordnet werden können. Innerhalb der Erfassungsmaske wird allerdings nicht schon bei der Eingabe geprüft, ob für einen nicht-pluralen Kontakttyp mehr als ein Eintrag angelegt wurde. Ist dies der Fall, tritt beim Speichern des Firmenkontos allerdings nicht etwa eine Fehlermeldung auf, sondern es wird nur der "letzte" Eintrag für den betreffenden Subtyp wirklich gespeichert. Wäre der Kontakttyp "Location" im Beispiel nicht als "Plurales Attribut" qualifiziert, dann ginge der vorletzte Kontakte-Eintrag ("Terminal 1") beim Speichern ohne Meldung einfach "verloren".

Dieser Effekt ist aber nur relevant, wenn die Erfassungsmaske - wie im Standard der Fall - Kontakte aller Typen über ein gemeinsames Wiederholendes Element ("Kontakte") verwaltet. Falls stattdessen individuelle Formularelemente je Typ eingerichtet werden, wird jeder Kontakttyp (ob plural oder singulär) "passend" repräsentiert.