Skip to main content

Building pipelines with Microsoft Dynamics 365 Business Central Reader

You can read data from Microsoft Dynamics 365 Business Central using the Microsoft Dynamics 365 Business Central Reader and write to any target supported by Striim.

We recommend that you create a single Striim application using the Reader in Automated mode. In this mode, the Reader performs an initial load of existing data and automatically transitions to continuous incremental replication after the initial load has completed. For foundational concepts about pipeline phases, see Pipelines.

Reader modes

The Microsoft Dynamics 365 Business Central Reader supports three modes.

Mode

Description

When to use

Wizard

Flow Designer, TQL, API

Automated (recommended)

Performs an initial load of the selected entities and then automatically transitions to continuous incremental replication without requiring manual intervention.

Use this mode for most pipelines, especially when you are building a new pipeline.

Yes

Yes

Initial Load

Performs a one-time snapshot of the selected entities and does not continue with continuous incremental replication after completion.

Use this mode when you need to run the initial load separately from incremental replication or to perform an ad hoc resynchronization of the source data.

No

Yes

Incremental Load

Continuously replicates new or updated records using a configured watermark field and polling interval.

Use this mode if the initial load has already been completed and you want to replicate only new or updated data going forward.

No

Yes

Two ways to build a Microsoft Dynamics 365 Business Central pipeline

Before creating a pipeline, complete the required setup and configuration steps in Microsoft Dynamics 365 Business Central as described in Initial setup.

You can build pipelines in one of two ways: using the pipeline wizard (recommended), or manually using Flow Designer, TQL, or the REST API.

Using the pipeline wizard (recommended)

If you are building near-real-time pipelines from Microsoft Dynamics 365 Business Central to supported targets, we recommend using a wizard from the Create App page to build an application that reads from Microsoft Dynamics 365 Business Central. The wizard automatically:

  1. Creates a single application using the Reader in Automated mode.

  2. Configures both initial load and continuous incremental replication.

  3. Creates the target schema and tables that match the selected entities.

  4. Copies existing data during the initial load phase.

  5. Automatically transitions to incremental replication when the initial load completes.

  6. Configures watermark tracking and polling intervals.

The wizard simplifies setup, promotes best practices, and reduces configuration errors.

Creating a pipeline manually

If your use case or organizational policies do not allow the use of the pipeline wizard (for example, you are using a CI/CD system to move configurations to production) or if the wizards do not support your target, you can manually create and configure an application using Flow Designer, TQL, or the Striim REST API.

When creating a pipeline manually, set the Reader's Mode property to Automated. This allows a single application to handle both initial load and continuous replication without requiring changes between phases. You may also use the Reader in Initial Load or Incremental Load mode when your architecture requires separate applications for each phase.

Configuration guidelines

When configuring the Microsoft Dynamics 365 Business Central Reader, follow these best practices.

  1. Set the Reader mode. Choose the mode that aligns with your use case. We recommend that you start with Automated mode.

  2. Identify the Incremental Load Marker. Before performing the initial load, identify a stable, monotonically increasing field for each entity (for example, a last-modified timestamp or an auto-incrementing ID). Enter the entity name and Incremental Load Marker combination in this field. If all entities have the same field as the Incremental Load Marker, you can specify it as %.<field name>. This field is used as the watermark for incremental replication. If an entity does not have such a field, the entire table is copied every time the entity is queried for an incremental sync.

  3. Configure schema creation. You can either enable Migrate Schema to automatically create target tables, or pre-create target tables using native or third-party utilities.

  4. Configure continuous replication. Set the Incremental Load Marker field and the Polling Interval. Configure the target for upsert semantics using appropriate key columns.

  5. Set Start Position (optional). If you need to resume replication from a specific point, provide the last successful watermark value as the Start Position.

Create a Dynamics 365 Business Central Reader application using the Flow Designer

This procedure outlines how to use Striim's Flow Designer to build and configure data pipelines. Flow Designer enables you to visually create applications with minimal or no coding.

  1. Go to the Apps page in the Striim UI and click Start from scratch.

  2. Provide a name and namespace for the application. The namespace helps organize related apps.

  3. In the component section, expand Sources, and enter a keyword such as Dynamics 365 Business Central Reader in the search field to filter available sources.

  4. Select the desired source (Microsoft Dynamics 365 Business Central Reader).

  5. In the properties panel, configure the reader properties.

    ms-dynamics-365-bus-cntl-reader.png
  6. In Flow Designer, you can drag and drop processors, enrichers, and targets to complete your pipeline logic.

  7. Once done, deploy and start the application to begin data flow.

Create a Dynamics 365 Business Central Reader application using TQL

The following sample TQL uses Striim's Dynamics 365 Business Central Reader to read from the Sales Edition. Note that Mode is set to Automated, which performs initial load and then automatically transitions to incremental replication.

    CREATE SOURCE SourceName USING Global.MicrosoftDynamics365BusinessCentralReader (
      PollingInterval: '5m',
      ClientSecret: '<ClientSecret>',
      RefreshToken: '<RefreshToken>',
      TenantId: 'TenantID',
      startPosition: '%=-1',
      Company: 'Company',
      OrganizationUrl: 'URL',
      Tables: '%',
      ClientId: 'ClientId',
      ConnectionPoolSize: 20,
      connectionProfileName: '',
      FetchSize: 5000,
      ConnectionTimeout: '300',
      Edition: 'Sales',
      Mode: 'Automated',
      useConnectionProfile: false,
      IncrementalLoadMarker: 'ModifiedOn',
      MigrateSchema: true,
      ThreadPoolCount: 10
    )
    OUTPUT TO DataStream;