Custom-Felder integrieren

Custom-Feld hinzufügen

In Elements kannst du beliebige Felder zu folgenden Entitäten hinzufügen, die dann in die Suchindizes als auch die Oberfläche von Elements aufgenommen werden:

• Angebot
• Angebotsposition
• Artikel
• Bestellposition
• Bestellung
• Kunde
• Warenkorb
• Warenkorbposition

Möchtest du ein Feld hinzufügen, klicke bitte auf „+ Hinzufügen“ am Ende der Tabelle. Zum Bearbeiten wähle ein Feld in der Tabelle aus.

Sobald du ein Feld zu einer der Entitäten hinzugefügt hast, solltest du den entsprechenden Suchindex neu erstellen (s. Basiskonfiguration > Suche >Suchindex) und in den Benutzergruppen die Berechtigungen auf das Feld anpassen. Dann kann sich jeder Benutzer gemäß seiner Berechtigung die jeweilige Spalte in der Listenansicht anzeigen lassen.

Custom-Feld entfernen

Wenn du ein Custo-Feld nicht mehr verwendest oder benötigst, kannst du es mit einem Rechtsklick mit der Maus auch endgültig entfernen.

Sobald du ein Custom-Feld aus einer der Entitäten entfernt hast, solltest du den entsprechenden Suchindex neu erstellen (s. Basiskonfiguration > Suche >Suchindex). Benutzern, die das Feld in einer ihrer Ansichten eingebunden haben, wird das Feld nicht mehr angezeigt.

Technische Angaben vornehmen

Entität

In diesem Feld wählst du aus, in welcher Entität in Elements das zusätzliche Feld genutzt werden soll.

Standard-Userfeld

Ist dieses Feld aktiv, so kannst Du nachfolgend ein benutzerdefiniertes Feld aus den der gewählten Entität hinterlegten Tabellen auswählen. Andernfalls kannst du eine beliebige Tabelle und jedes beliebige Feld aus der ERP-Datenbank auswählen.

Name Datenbanktabelle

Ist das Feld „Standard-Userfeld“ deaktiviert, so musst du bitte die Tabelle auswählen, die das gewünschte Feld beinhaltet. Danach kannst du im Feld „ERP-Feld“ das gewünschte Feld auswählen.

Sobald du eine Tabelle ausgewählt hast, musst du diese bitte mit den Schlüsselfeldern in der Tabelle verknüpfen, die unterhalb des Feldes „Datentyp“ angezeigt wird. Es müssen alle Felder in der ausgewählten Tabelle enthalten und entsprechend verknüpft sein.

Das Schlüsselfeld „AuspraegungId“ ist optional, so dass du auch variantenunabhängige Artikeldaten einbinden kannst.

Mit einem Klick auf die Schaltfläche „Konfiguration und Daten prüfen“ wird geprüft, ob die Verknüpfung korrekt ist und ob es pro Verknüpfung nur einen Datensatz in der ausgewählten Tabelle gibt.

Du möchtest ein Feld hinzufügen, das zusätzliche Artikelinformationen enthält. Dazu wählst du eine Tabelle aus, in der das Feld enthalten ist. Dieses enthält Informationen zum Mandant, zur Artikelnummer und optional zur internen Ausprägungsnummer und es gibt für diese Kombination nur einen Eintrag in der Tabelle.

ERP-Feld

Die Auswahl basiert in Abhängigkeit der Auswahl im Feld „Standard-Userfeld“ auf deiner Auswahl im Feld „Entität“ oder der ausgewählten Tabelle im Feld „Name Datenbanktabelle“.

Im ersten Fall handelt es sich um alle benutzerdefinierten Felder in der Tabelle, die über den Sage 100 Administrator angelegt worden sind und mit „USER_“ beginnen:

• Angebot & Bestellung, Warenkorb: KHKVKBelege
• Angebots-, Bestell- & Warenkorbposition: KHKVKBelegePositionen
• Artikel: KHKArtikel
• Kunde: KHKAdressen, KHKKontokorrent

Du siehst hier allerdings die Bezeichnung der Felder.

Schaue im Sage 100 Administrator nach, wie die Felder intern heißen und welche Bezeichnung sie haben.

Im zweiten Fall kannst du jedes Feld aus der ausgewählten Tabelle hinzufügen.

Name Datenbankspalte

Damit du auch sicher sein kannst, dass du das richtige Feld einbindest, wird dir der Name des Feldes in der Datenbank angezeigt. Dieser setzt sich zusammen aus der Sage-Klasse und dem Spaltennamen des (USER-)Feldes in der ERP-Datenbank.

Technischer Name

Der technische Name wird von Elements vergeben und kann bei Anpassungen über Schnittstellen genutzt werden. Zum jetzigen Stand gibt es noch keine Schnittstellen, die auf den technischen Namen zugreifen.

Datentyp, Anzeigetyp, Anzeigeoption

Der Daten- und Anzeigetyp sowie die Anzeigeoption ergeben sich aus dem „Typ“ des Feldes in der Sage 100.

Datentypen

• keyValue: Das Feld enthält eine Auswahl, die du im Sage 100 Administrator in Form eines Gruppenkennzeichens oder einer Werteliste hinterlegt hast. In Verbindung mit diesem Datentyp kann nur der Anzeigetyp „enumeration“ ausgewählt werden.
• bool: In der Datenbank kann nur ein „ja“- oder „nein“-Wert hinterlegt werden.
• short/int: In der Datenbank kann nur ein Zahlenwert ohne Nachkommastellen hinterlegt werden.
• decimal: In der Datenbank kann nur Zahlenwert mit Nachkommastellen hinterlegt werden.
• calendarDay: Der Zeitanteil in einem Datum wird in der Datenbank verworfen, z. B. beim Belegdatum. Es wird also nur das Datum ohne Uhrzeit in die Datenbank geschrieben.
• dateTime: In die Datenbank wird sowohl das Datum als auch die Uhrzeit geschrieben.

Wenn hinter dem Datentyp ein „?“ steht, so bedeutet das, dass in dem Datenbankfeld der Eintrag NULL zugelassen ist. Es kann also ohne Inhalt hinterlegt werden.

Anzeigetypen

• enumeration: Der Benutzer kann einen Wert aus der ihm zur Verfügung stehenden Auswahlliste auswählen.
• password: Im Feld werden die Zeichen nur als Sternchen angezeigt. Zudem kann der Browser den Inhalt nicht erkennen.
• text: Im Feld kann sowohl eine Zeichenkette als auch nur ein numerischer Wert stehen.
• textarea: Im Feld kann eine Zeichenkette mit Zeilenumbrüchen stehen. Das Feld ist in der Größe vom Benutzer anpassbar.
• toggle: Der Benutzer sieht einen Schieberegler, dessen Status er verändern kann. Dahinter stehen die Werte „ja“ oder „nein“.
• calendarDay: Der Zeitanteil in einem Datum wird in der Datenbank verworfen, z. B. beim Belegdatum. Es wird also nur das Datum ohne Uhrzeit in die Datenbank geschrieben.
• dateTime: In die Datenbank wird sowohl das Datum als auch die Uhrzeit geschrieben.

Anzeigeoptionen

• number: Der Benutzer kann nur einen Zahlenwert (mit oder ohne Nachkommastellen) im Feld eintragen.
• triState: Der Schieberegler kann auf der Mittelposition verbleiben. Das entspricht in der Datenbank dem Wert NULL. Es gibt also keinen klaren „ja“- oder „nein“-Wert.
• date: Es wird nur der Datumsanteil angezeigt. Die Uhrzeit kann der Benutzer nicht sehen und auch nicht eintragen.
• dateTime: Es wird das volle Datum mit Uhrzeit angezeigt. Der Benutzer kann alles bearbeiten.

Bitte benutze Kombinationen aus einem Zahlenwert und einem Text nicht ohne die Anzeigeoption „number“ – auch wenn du sie technisch einrichten kannst.

Wähle also beim Datentyp „short(?)“, „int(?)“ und „decimal(?)“ in Kombination mit dem Anzeigetyp „text“ immer die Anzeigeoption „number“ aus.

Wähle bei Verwendung des Datentyps „dateTime(?)“ bitte immer eine Anzeigeoption aus.

Wenn du ein Feld mit der Kombination Datentyp „bool““ und Anzeigetyp „toggle“ wählst, ohne die Anzeigeoption „triState“ zu wählen, wird der Wert auf „nein“ gesetzt, wenn der Benutzer nichts angibt, da NULL-Werte nicht zugelassen sind.

Standardwert

Du kannst angeben, welcher Wert im Custom-Feld vorbelegt wird. Wenn Du das nicht machst, wird der Standardwert aus der Datenbank des ERP-Systems übernommen.

Wenn der Benutzer eine neue Entität (Kunde, Angebot, Bestellung) oder einen neuen Warenkorb in Elements anlegt oder eine neue Position hinzufügt, wird der Standardwert des Feldes übernommen. Dabei greift dieses Regelwerk:

Wird über Elements eine neue Entität im ERP-System angelegt, so werden alle Custom-Felder dieser Entität mit den übernommenen Standardwerten angelegt, insofern der Benutzer die Inhalte nicht selbst über die Oberfläche geändert hat.

Darstellung einrichten

Die Regeln, die du im Bereich „Darstellung“ hinterlegst greifen nur, wenn du das Feld in ein eigenes Register in der Detailansicht der jeweiligen Entität platzierst.

Wenn du „Ausblenden, wenn“ aktivierst, erscheinen drei weitere Felder:

• Im „Feld“ wählst du bitte das Feld aus, von dem die Darstellung des Custom-Feldes abhängt. Zur Auswahl stehen dir alle Felder in der gleichen Tabelle, in der sich auch das Feld befindet.
• Als „Operator“ stehen dir aktuell nur „ist gleich“ oder „ist nicht gleich“ zur Verfügung.
• Abschließend gib bitte den Vergleichswert im Feld „Wert“ an.

Der eingetragene Wert muss der technische Wert sein. Bei einer Artikelnummer hat dieser zum Beispiel folgenden Aufbau: {Artikelnummer};{AuspraegungId} (z. B. 1000547;0).

Hast Du ein Feld in der Entität „Warenkorb“ ausgewählt, so wird dir eine Tabelle mit der Überschrift „Ausgeblendet bei“ angezeigt. Dort kannst du festlegen, ob das Feld in bestimmten Warenkörben nicht angezeigt wird. Trägst du in der Tabelle nichts ein, so wird das Feld in allen Warenkörben angezeigt.

Du möchtest ein Feld nur im Warenkorb des B2B-Portals anzeigen. Dann musst du in der Tabelle alle anderen Warenkorbtypen angeben.

Anzeige

Bitte beachte, dass du nach dem Anlegen eines neuen Custom-Feldes die Administration in einem neuen Arbeitsbereich aufrufst, um das Feld platzieren zu können.

Im Register „Anzeige“ kannst du die Custom-Felder, die du in Elements eingebunden hast, in den Details der jeweiligen Bereiche anzeigen lassen. Wenn du ein Custom-Feld nicht platzierst, steht es nur als Spalte in der jeweiligen Listenansicht zur Verfügung.

Die Custom-Felder werden in Abhängigkeit der Entität platziert.

In den Entitäten Artikel, Angebot, Bestellung und Kunde werden die Felder immer im Register „Custom“ in der Detailansicht des jeweiligen Bereichs angezeigt. Dort kannst du die Felder in drei Karten platzieren – rechts, mittig oder links.

In den Entitäten Angebots- und Bestellpositionen werden die Felder in der Detailansicht der Positionen unterhalb der Textfelder in der rechten Karte angezeigt. Der Benutzer erreicht die Details über einen Doppelklick auf eine Position.

In der Entität Warenkorb werden die Custom-Felder im Bereich „Warenkorbdetails“ unterhalb der Standardfelder angezeigt.

In der Entität Warenkorbposition werden die Felder unterhalb der Artikeldetails angezeigt.

Wähle zum Hinzufügen das Custom-Feld bitte in der Tabelle in der gewünschten Karte aus. Danach kannst du das Feld verschieben, indem du es mit der rechten Maustaste „hältst“ und per Drag and Drop an die gewünschte Stelle innerhalb der Tabelle verschiebst.

Die Inhalte der Custom-Felder werden immer in die nachfolgende Entität übernommen. So werden diese z. B. von einem Warenkorb in ein Angebot oder eine Bestellung übernommen.

Bereits im ERP-System gespeicherte Daten werden nicht in Elements verändert. So werden die Inhalte der Custom-Felder bei der Übernahme eines Angebots in eine Bestellung nicht verändert.