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:

  • Adresse / Interessent
  • Angebot
  • Angebotsposition
  • Ansprechpartner
  • Artikel
  • Bestellposition
  • Bestellung
  • Kunde
  • Lieferant
  • 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.

Wichtig
WICHTIG

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.

Wichtig
WICHTIG

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.

Wichtig
WICHTIG

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.

Beispiel
BEISPIEL

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:

  • Adresse / interessent: KHKAdressen
  • Angebot & Bestellung, Warenkorb: KHKVKBelege
  • Angebots-, Bestell- & Warenkorbposition: KHKVKBelegePositionen
  • Ansprechpartner: KHKAdressen, KHKAnsprechpartner
  • Artikel: KHKArtikel
  • Kunde, Lieferant: KHKAdressen, KHKKontokorrent

Du siehst hier allerdings die Bezeichnung der Felder.

Tipp
TIPP

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.

Typ (Sage 100)Datentyp(en)AnzeigetypAnzeigeoptionen
TextkeyValue, password, stringenumeration, password, text, textareanumber
Ja/Neinbool, bool?toogletristate
Zahl (Integer) 16Bit-ZahlenkeyValue, short, short?enumeration, textnumber
Zahl (Long)
32Bit-Zahlen
keyValue, int, int?enumeration, textnumber
Währungdecimal, decimal?textnumber
DatumcalendarDay, calendarDay?, dateTime, dateTime?calendarDay, dateTimedate, dateTime

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.
Wichtig
WICHTIG

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.
Wichtig
WICHTIG

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.

Wichtig
WICHTIG

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

Tipp
TIPP

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.

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

Wichtig
WICHTIG

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.
Wichtig
WICHTIG

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.

Beispiel
BEISPIEL

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

Anzeige

Tipp
TIPP

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 Kontakt 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.

Wichtig
WICHTIG

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.

Regeln bei der Übernahme von Inhalten

In Elements werden bei der Erstellung und Übernahme neuer Entitäten die Inhalte der Custom-Felder (Elements) als auch der (benutzerdefinierten) USER-Felder (Sage 100) nach festgelegten Regeln übernommen, überschrieben oder belassen.

Übernahme einer Entität in eine andere Entität

Wird ein Warenkorb in ein Angebot/eine Bestellung oder ein Angebot in eine Bestellung übernommen, so wird der Inhalt

  • aus der Ursprungs-Entität in die Ziel-Entität übernommen, wenn ein Custom-Feld in der Ursprungs-Entität vorhanden ist und
    • gleichzeitig auch in der Ziel-Entität vorhanden ist oder
    • ein USER-Feld ist (Schalter „Standard-Userfeld“ ist aktiv) oder
  • nicht in die Ziel-Entität übernommen, wenn
    • ein in der Ursprungs-Entität enthaltenes Custom-Feld weder ein USER-Feld (Schalter „Standard-Userfeld“ ist nicht aktiv) noch in der Ziel-Entität enthalten ist oder
  • gemäß des Regelwerks der Sage 100 ermittelt, wenn
    • kein Custom-Feld in der Ursprungs-Entität vorhanden ist, jedoch ein USER-Feld (, das nicht in Elements angezeigt wird).

Übernahme von Stammdaten

Wird ein Kontakt einem Angebot, einer Bestellung oder einem Warenkorb zugeordnet und weisen sowohl der Kontakt als auch eine der genannten Entitäten ein gleichnamiges Custom- oder USER-Feld auf, so wird der Inhalt aus den Stammdaten des Kontakts übernommen.

Das gleiche passiert auch, wenn ein Artikel als Position aufgenommen wird. Auch hier wird das gleichnamige Custom- oder USER-Feld mit dem in den Stammdaten des Artikels hinterlegten Inhalt überschrieben.

Wichtig
WICHTIG

Der Inhalt des Ursprungsfeldes wird unabhängig davon übernommen, ob wirklich ein Inhalt enthalten ist. Ist also im Ursprungsfeld kein Inhalt hinterlegt, so wird auch das Zielfeld ohne Inhalt überschrieben – es ist also „leer“.

Übernahme von Standardwerten

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 (Kontakt, 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:

Ermittlung des Standardwertes
Inhaltsverzeichnis
    Demo Buchen
    Melden Sie sich jetzt für eine kostenfreie Web-Präsentation an und lernen Sie Elements aus erster Hand kennen!
    Reibungsloser Workflow durch intelligente Datenverknüpfungen am Point-Of-Sale.
    Bieten Sie Ihren Kunden ein umfangreiches Shopping-Erlebnis mit Ihrem Elements B2B-Shop.
    Smarte und aufeinander abgestimmte Features ermöglichen eine grenzenlose Skalierung Ihres Geschäfts.
    Diese Kunden bauen bereits auf Elements:

    *“ zeigt erforderliche Felder an

    Dieses Feld dient zur Validierung und sollte nicht verändert werden.
    Partner werden
    Erweitern Sie ihr Portfolio um ein innovatives, zukunftsorientiertes Produkt und werden Sie teil unseres Eco-Systems.
    Direkte und persönliche Betreuung durch einen unserer Partner-Manager
    Weitgehende Unterstützung in Ihren Werbemaßnahmen durch Werbematerial und Events
    Together we are strong - Partner-Events, Webinare & vieles mehr
    Diese und weitere Partner zählen bereits auf uns:

    Partner Werden

    Kontakt aufnehmen
    Sie möchten mehr erfahren und mit uns sprechen?
    Wir freuen uns auf den Kontakt und helfen Ihnen bei aufkommenden Fragen gerne weiter!
    Diese Kunden bauen bereits auf Elements:

    *“ zeigt erforderliche Felder an

    Dieses Feld dient zur Validierung und sollte nicht verändert werden.
    Webinar anmelden
    Sie möchten sich für ein Webinar anmelden?
    Wir freuen uns auf die Anmeldung und helfen Ihnen bei aufkommenden Fragen gerne weiter!

    *“ zeigt erforderliche Felder an

    Webinar*
    Dieses Feld dient zur Validierung und sollte nicht verändert werden.