DataEngine Apps

In der DataEngine stehen dir verschiedene DataEngine Apps zur Verfügung, die von Marini bereitgestellt werden. Diese Apps erweitern die Funktionalität der DataEngine und können über den Modul-Loader heruntergeladen und installiert werden. In diesem Abschnitt werden die verfügbaren DataEngine Apps detailliert beschrieben.

Die „Account-Based App“ App ermöglicht die automatische Zuordnung von Kontakten zu Unternehmen auf Basis ihrer E-Mail-Domäne. Wenn ein Kontakt eine E-Mail-Adresse mit der Domäne eines Unternehmens hat, wird der Kontakt automatisch diesem Unternehmen zugeordnet.

Das „ActivitiesNotes“ App ist das Standard Activities und Notes Package. Es erweitert die Funktionalität der DataEngine um Standardfunktionen für Aktivitäten und Notizen.

Alle Dun & Bradstreet (D&B) Apps setzen einen Vertrag mit Dun & Bradstreet voraus. Du kannst weitere Informationen auf deren Website unter https://www.dnb.com/ finden.

Das „D&B Core“ App fügt D&B Company & Credentials Module hinzu und bietet erweiterte Suchfunktionen, darunter Typen-Vorauswahl, Kriterien und Identitätsauflösung.

Mit dem „D&B Research“ App können Kunden Forschungsanfragen zu Geschäftsunternehmen stellen. Dieses Modul ermöglicht es, Anfragen für Recherchen zu bestimmten Unternehmen zu platzieren.

Das „D&B Services“ App bietet Dienstleistungen von D&B wie Sanktionsprüfung und Business Information Reports an. Es erweitert die DataEngine um zusätzliche Funktionen zur Verarbeitung von Unternehmensdaten.

Der „Name Workflow“ ermöglicht die Konfiguration von Logik-Hooks zur Definition des Werts des Namensfelds für einen Datensatz. Dieses Modul bietet die Flexibilität, den Namen eines Datensatzes basierend auf bestimmten Kriterien festzulegen.

Dieses App erfordert Konfiguration. Weitere Informationen findest du unter https://marini.systems/de/help-center/docs/custom-config/#NameWorkflow.

Das „Postal Code Package“ App fügt eine Suchfunktion für Stadt und Bundesland hinzu, die auf Postleitzahlen basiert. Es ermöglicht die Suche nach Orten und Bundesländern anhand von Postleitzahlen.

Diese App muss abhängig von den eingerichteten Modulen konfiguriert werden. Weitere Informationen findest du unter https://marini.systems/de/help-center/docs/custom-config/#PostalCode.

Das „SalesCloud_v2“ App ist das Core Sales Cloud Package Version 2 für B2B-Anwendungen. Es bietet Funktionen für den Vertrieb und das Kundenmanagement.

Das „Sales_Inquiries“ App ist das Core Sales Inquiries Package. Es erweitert die Funktionalität der DataEngine um Funktionen im Zusammenhang mit Vertriebsanfragen.

Die „WebHook Integration“ App ermöglicht der DataEngine, WebHooks von externen Systemen zu empfangen. Dies erweitert die Integrationsmöglichkeiten der DataEngine und ermöglicht die Kommunikation mit anderen Systemen über WebHooks.

Installation

Um die Webhook App zu verwenden, führe die folgenden Schritte aus:

1. Erstelle ein Modul (oder verwende ein bereits existierendes Modul) in der DataEngine. Für die optimale Verwendung der Webhook App wird empfohlen, bestimmte Felder in diesem Modul zu erstellen:
   • rawjson (optional): Dieses Feld enthält den Inhalt der Anfrage als JSON-String.
   • path: Dieses Feld enthält den Pfadteil (den xxx/xxx-Teil) aus dem POST-Request.
   • Die JSON-Anfrage wird analysiert und sucht nach Feldern mit denselben Namen wie den Eigenschaften im JSON. Zum Beispiel wird das JSON {"EventType":"aaa"} das Feld userId setzen, wenn es existiert.
   • Wenn das JSON Objekte/Arrays enthält, können diese mit einem Unterstrich im Feldnamen angesprochen werden. Zum Beispiel kann {"Properties":{"ClientId":"aaa"}} über den Feldnamen properties_clientid zugegriffen werden.
   • Die Feldnamen im Bean können in beliebiger Groß- und Kleinschreibung vorliegen. Auch benutzerdefinierte Felder werden überprüft, sodass sie beispielsweise auch properties_ClientId_c sein können.
   • Ein Feld namens properties kann einen JSON-String enthalten, z.B. {"ClientId":"aaa".
   • Benutzerdefinierte Konfigurationen können für lange Feldnamen verwendet werden.
2. Besuche /index.php?entryPoint=WebhookToken, um einen Zugriffstoken (Access Token) zu erhalten.

Absender (Sender)

Der Sender (Absender) des Webhooks kann POST-Anfragen an folgende URL senden:

• http://web.dataengine.docker/entrypoint/Webhook
• ODER
• http://web.dataengine.docker/entrypoint/Webhook/xxx/xxx (wobei xxx/xxx der Pfad ist)

Du solltest die folgenden Header in deiner POST-Anfrage verwenden:

• Content-Type: application/json
• Authorization: Bearer <Access Token> (ersetze <Access Token> durch deinen erhaltenen Zugriffstoken)
• X-Signature (optional): <HMAC-Hash des Inhalts>

Der Webhook wird immer eine neue Bean in der DataEngine erstellen. Dabei wird der Benutzer erstellt, der beim Erstellen des Zugriffstokens definiert wurde. Das Modul der Bean ist ebenfalls dasjenige, das beim Erstellen des Zugriffstokens definiert wurde. Die Felder der Bean werden gemäß den oben beschriebenen Regeln gefüllt.

Durch die Verwendung der DataEngine Webhook App kannst du problemlos Daten aus externen Diensten in die DataEngine integrieren und so die Effizienz deiner Datenverarbeitung steigern.

Diese App muss abhängig von den eingerichteten Modulen konfiguriert werden. Weitere Informationen findest du unter https://marini.systems/de/help-center/docs/custom-config/#WebHook.