DataEngine Apps

In the DataEngine, you have access to various DataEngine apps provided by Marini. These apps expand the functionality of the DataEngine and can be downloaded and installed through the module loader. This section provides detailed descriptions of the available DataEngine apps.

The “Account-Based App” enables automatic assignment of contacts to companies based on their email domain. If a contact has an email address with a company’s domain, the contact is automatically associated with that company.

The “ActivitiesNotes” app is the standard Activities and Notes package. It enhances the DataEngine’s functionality with standard features for activities and notes.

All Dun & Bradstreet (D&B) apps require a contract with Dun & Bradstreet. You can find more information on their website at https://www.dnb.com/.

The “D&B Core” app adds D&B Company & Credentials modules and offers advanced search functions, including type selection, criteria, and identity resolution.

With the “D&B Research” app, customers can submit research requests for business companies. This module allows placing inquiries for research on specific companies.

The “D&B Services” app provides D&B services such as sanctions screening and Business Information Reports. It enhances the DataEngine with additional features for processing corporate data.

The “Name Workflow” allows the configuration of logic hooks to define the value of the name field for a record. This module provides flexibility in setting the name of a record based on specific criteria.

This app requires configuration. For more information, visit https://marini.systems/en/help-center/docs/custom-config/#NameWorkflow.

The “Postal Code Package” app adds a search function for cities and states based on postal codes. It allows searching for locations and states based on postal codes.

This app must be configured depending on the installed modules. For more information, visit https://marini.systems/en/help-center/docs/custom-config/#PostalCode.

The “SalesCloud_v2” app is the Core Sales Cloud Package Version 2 for B2B applications. It offers features for sales and customer management.

The “Sales_Inquiries” app is the Core Sales Inquiries Package. It extends the DataEngine’s functionality with features related to sales inquiries.

The “WebHook Integration” app allows the DataEngine to receive webhooks from external systems. This expands the DataEngine’s integration capabilities and enables communication with other systems via webhooks.

Installation

To use the Webhook app, follow these steps:

1. Create a module (or use an existing module) in the DataEngine. For optimal use of the Webhook app, it is recommended to create specific fields in this module:
   • rawjson (optional): This field contains the request content as a JSON string.
   • path: This field contains the path part (the xxx/xxx part) from the POST request.
   • The JSON request is parsed and looks for fields with the same names as properties in the JSON. For example, the JSON {"EventType":"aaa"} will set the userId field if it exists.
   • If the JSON contains objects/arrays, they can be accessed with an underscore in the field name. For example, {"Properties":{"ClientId":"aaa"}} can be accessed using the field name properties_clientid.
   • Field names in the bean can be in any case, and custom fields are also checked, so they can be, for example, properties_ClientId_c.
   • A field named properties can contain a JSON string, e.g., {"ClientId":"aaa".
   • Custom configurations can be used for long field names.
2. Visit /index.php?entryPoint=WebhookToken to obtain an access token.

Sender

The sender of the webhook can send POST requests to the following URL:

• http://web.dataengine.docker/entrypoint/Webhook
• OR
• http://web.dataengine.docker/entrypoint/Webhook/xxx/xxx (where xxx/xxx is the path)

You should use the following headers in your POST request:

• Content-Type: application/json
• Authorization: Bearer <Access Token> (replace <Access Token> with your received access token)
• X-Signature (optional): <HMAC-Hash of Content>

The webhook will always create a new bean in the DataEngine. The user created is the one defined when creating the access token, and the module of the bean is also the one defined when creating the access token. The fields of the bean are filled according to the rules described above.

By using the DataEngine Webhook app, you can easily integrate data from external services into the DataEngine, thereby enhancing the efficiency of your data processing.

This app must be configured depending on the installed modules. For more information, visit https://marini.systems/en/help-center/docs/custom-config/#WebHook.