Versions Compared

Old Version 4

changes.mady.by.user Ritchie Piessens

Saved on

compared with

New Version Current

changes.mady.by.user Ritchie Piessens

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
English

With Replica 365 you can replicate Business Central (“BC”) tables to Azure Table Storage (“ATS”). In ATS you can store large amounts of data. You can use ATS to query on this set of data using applications like Excel and PowerBI. ATS scales it’s tables automatically as your demand increases.

Replicating your BC tables to ATS will lower the impact on your BC environment, so that your BC environment is not experiencing a significant load when a lot of data is requested for reports. Because the BC data is already available in ATS, reports will also be loaded faster. From ATS you can also use the data as a source for your BI environment, for example in Azure SQL or in your Data Warehouse.

Use the Replica 365 page to configure the tables that you want to be replicated.

Dutch

Met Replica 365 kun je Business Central (“BC”) tabellen repliceren naar Azure Table Storage (“ATS”). In ATS kun je grote hoeveelheden gegevens opslaan. Je kunt ATS gebruiken om deze set gegevens op te vragen met behulp van toepassingen als Excel en PowerBI. ATS schaalt zijn tafels automatisch naarmate de vraag toeneemt.

Het repliceren van de BC-tabellen naar ATS verlaagt de impact op de BC-omgeving, zodat de BC-omgeving geen grote belasting ondervindt wanneer er veel gegevens worden opgevraagd voor rapporten. Omdat de BC-data al beschikbaar is in ATS, zullen rapporten ook sneller worden geladen. Vanuit ATS kun je de data ook gebruiken als bron voor uw BI-omgeving, bijvoorbeeld in Azure SQL of in een Data Warehouse.

Gebruik de Replica 365 pagina om de tabellen te configureren die gerepliceerd dienen te worden.

English

Prerequisites

  1. Replica 365 is succesfully configured in Business Central, using the “Replica 365 Setup page”

  2. Azure Table Storage (“ATS”) is configured (more information can be found in this article https://briteblue.atlassian.net/servicedesk/customer/kb/view/3604482 the article describing how to setup Replica 365.

Business Central Setup

  1. Sign in to Business Central

  2. Search for the page “Replica 365” and open this page to start entering the tables you want to replicate.

image-20240328-091938.pngImage Added

  1. Start by entering the first Table you want to replicate. You can either search by name or table number.

image-20240328-095413.pngImage Added

Search by name or table number.
Note

Do not include special characters in the “External Name” of the Table, as these cannot be handled by Azure Table Storage. Only use letters and numbers.

  1. Select the appropiate table. Once the table is selected, a couple of informative fields is shown and options to configure the behaviour of the replicate action

Field

Explanation

a

No. of Records

Number of records (rows) in the table

b

Fields

Number of selected fields in the table. Click on the field to open the Field Selector.

Replica supports up to 250 fields for each destination table, due to limitations of ATS. ATS supports a maximum of 255 fields, 5 are needed for system properties. When your table contains more than 250 fields you need to make a subselection within the existing columns or replicate the table in multiple parts.

image-20240328-125550.pngImage Added

c

Exclude Flowfields

When flow fields ("calculated fields") are excluded, a replication action will be faster. For large tables, you can choose to replicate the table in multiple parts, each with part of the flow fields.

d

Replication Type

Choose between [Full] and [Changes].

[Full] will replicate the table in full for each replication round.

[Changes] will only replicate the changed records compared to the previous replication. This is determined using the attribute "Last Modified Date Time" of the selected table.

Note

Warning: when you change the Replication Type from [Changes] to [Full], this will result in an entire new copy of the table “as is” at that moment. This results in losing history in ATS, handle this with care

image-20240328-125409.pngImage Added

e

Full Sync Required

When you change the selected fields, for example (de)select Fields, this will trigger a Full Sync the next replication round. This is necessary to keep the number of fields per row in ATS consistent.

Note

Warning: This results in losing history in ATS. All records that do not longer exist in BC, will no longer be available in ATS. Handle this with care.

f

Track Deletes

Check this field when you want Records that are deleted in BC to be marked “as deleted” in ATS.

If this option is not checked, deleted Records in BC will be deleted in ATS as well.

When this field is checked, the field “DeletedAt” in ATS will be updated with the DateTime of the actual Deletion in BC (not the DateTIme of updating the record in ATS).

Info

When [Track Deletes] is combined with [Replication Type] = “Full”, this will result in retaining deleted Records in ATS. So even though the Record has been deleted in BC, it will continue to exist in ATS. However, the attribute "DeletedAt" is updated in ATS to mark the Record as being deleted.

g

No. of Deleted Records

Shows the No. of Deleted Records that need to be processed.

For each Table that is configured in Replica 365, a log is kept with deleted records in BC. So that these deletes can be implemented in ATS.

h

Status

Shows the Status (“Finished”, “Processing”, “Error”) when the manual Export is triggered.

i

Start

Date/Time of Start of the last Export

j

Duration

Duration of the last Export.

k

Unprocessed Messages

Exports are being processed to ATS in batches. This shows the number of Unprocessed batches.

l

No. of Errors

Number of Errors that occured during the last Export. Click on the number to show more details.

image-20240328-143317.pngImage Added
Configuration of Replica 365

Select fields

For each Table you can select the desired fields you want to Replicate.

  1. Use the “Select All” button to select Fields. Replica supports up to 250 fields for each destination table, due to limitations of ATS. ATS supports a maximum of 255 fields, 5 are needed for system properties. When your table contains more than 250 fields you need to make a subselection within the existing columns or replicate the table in multiple parts. Warning: selecting more than 250 fields will result in an Error during Processing to ATS.

  2. Use the “Deselect All” button, to unselect all Fields.

  3. Use the “Update Fields” button to reload the available Fields. This is necessary when fields have been added to a table, for example after installing a new Extension. New fields are not included by default.

image-20240328-150130.pngImage Added
image-20240328-145908.pngImage Added
Do not select more than 250 columns for each Table to prevent Errors
Dutch

Voorwaarden

  1. Replica 365 is succesfully configured in Business Central, using the “Replica 365 Setup page”

  2. Azure Table Storage (“ATS”) is configured (more information can be found in the article describing how to setup Replica 365.

Business Central Setup

  1. Meld je aan bij Business Central

  2. Zoek naar de pagina “Replica 365” en open deze pagina om de tabellen in te voeren die je wilt repliceren.

image-20240328-091938.pngImage Modified

  1. Begin met het invoeren van de eerste tabel die je wilt repliceren. Je kunt zoeken op tabelnaam of op tabelnummer.

image-20240328-095413.pngImage Added
Zoek op naam of tabelnummer
Note

Gebruik geen speciale karakters in de “External name” van de tabel, hier kan Azure table storage niet mee omgaan. Gebruik alleen letters en cijfers.

  1. Selecteer de juiste tabel uit de zoekresultaten. Zodra de tabel is geselecteerd, worden een aantal informatieve velden weergegeven en opties om het gedrag van de replicatieactie te configureren

Field

Explanation

a

No. of Records

Aantal records (rijen) in de tabel

b

Velden

Aantal geselecteerde velden in de tabel. Klik op het veld om de veldkiezer te openen.

Replica ondersteunt maximaal 250 velden voor elke doeltabel, vanwege beperkingen van ATS. ATS ondersteunt maximaal 255 velden per tabel, waarvan er 5 velden nodig zijn voor systeemeigenschappen. Wanneer je tabel meer dan 250 velden bevat, moet je een subselectie maken binnen de bestaande kolommen of de tabel in meerdere delen repliceren.

image-20240328-125550.pngImage Added

c

Flowfields uitsluiten

Wanneer flowfields ("berekende velden") worden uitgesloten, zal een replicatieactie sneller verlopen. Voor grote tabellen kun je ervoor kiezen om de tabel in meerdere delen te repliceren, elk met een deel van de stroomvelden.

d

Repliceertype

Kies tussen [Volledig] en [Wijzigingen].

Met [Volledig] wordt de tabel voor elke replicatieronde volledig gerepliceerd.

[Wijzigingen] repliceert alleen de gewijzigde records in vergelijking met de vorige replicatie. Dit wordt bepaald met behulp van het attribuut "Last Modified Date Time" van de geselecteerde tabel.

Note

Waarschuwing: wanneer je het Replicatietype wijzigt van [Wijzigingen] naar [Volledig], resulteert dit in een geheel nieuwe kopie van de tabel “zoals deze op dat moment is”. Dit resulteert in het verlies van de geschiedenis in ATS, ga hier voorzichtig mee om.

image-20240405-114913.pngImage Added

image-20240405-114907.pngImage Added e

Volledige synchronisatie vereist

Wanneer u de geselecteerde velden wijzigt, bijvoorbeeld Velden (de)selecteert, activeert dit een Volledige synchronisatie in de volgende replicatieronde. Dit is nodig om het aantal velden per rij in ATS consistent te houden.

Note

Waarschuwing: hierdoor gaat de geschiedenis in ATS verloren. Alle records die niet meer bestaan in BC, zullen niet langer beschikbaar zijn in ATS. Ga hier zorgvuldig mee om.

f

Verwijderingen markeren

Vink dit veld aan als je wilt dat records die in BC zijn verwijderd, in ATS als “verwijderd” worden gemarkeerd.

Als deze optie niet is aangevinkt, worden verwijderde records in BC ook verwijderd in ATS.

Wanneer dit veld is aangevinkt, wordt het veld “DeletedAt” in ATS bijgewerkt met de DateTime van de daadwerkelijke verwijdering in BC (niet de DateTIme van het bijwerken van het record in ATS).

Info

Wanneer [Track Deletes] wordt gecombineerd met [Replication Type] = “Full”, resulteert dit in het behouden van verwijderde records in ATS. Dus ook al is het record in BC verwijderd, het blijft bestaan in ATS. Het attribuut "DeletedAt" wordt echter bijgewerkt in ATS om de record als verwijderd te markeren.

g

Aantal verwijderde records

Toont het aantal verwijderde records dat moet worden verwerkt.

Voor elke tabel die in Replica 365 is geconfigureerd, wordt een logboek bijgehouden met verwijderde records in BC. Zodat deze verwijderingen in ATS kunnen worden geïmplementeerd..

h

Status

Toont de status (“Voltooid”, “In verwerking”, “Error”) wanneer de handmatige export wordt geactiveerd.

i

Start

Datum/tijd van start van de laatste export.

j

Duur

Duur van de laatste export.

k

Onverwerkte berichten

Een export wordt batchgewijs naar ATS verwerkt. Hier wordt het aantal onverwerkte batches weergegeven.

l

Aantal foutmeldingen

Aantal fouten dat is opgetreden tijdens de laatste export. Klik op het nummer om meer details weer te geven.

image-20240328-143317.pngImage Added
Configuratie van Replica 365

Veld Selectie

Voor elke tabel kun je de gewenste velden selecteren die je wilt repliceren.

  1. Gebruik de knop “Selecteer alles” om Velden te selecteren. Replica ondersteunt maximaal 250 velden voor elke doeltabel, vanwege beperkingen van ATS. ATS ondersteunt maximaal 255 velden, waarvan er 5 nodig zijn voor systeemeigenschappen. Wanneer je tabel meer dan 250 velden bevat, moet je een subselectie maken binnen de bestaande kolommen of de tabel in meerdere delen repliceren. Waarschuwing: het selecteren van meer dan 250 velden zal resulteren in een fout tijdens de verwerking naar ATS.

  2. Gebruik de knop “Deselecteer alles” om alle velden te deselecteren.

  3. Gebruik de knop “Velden bijwerken” om de beschikbare velden opnieuw te laden. Dit is nodig als er velden aan een tabel zijn toegevoegd, bijvoorbeeld na het installeren van een nieuwe extensie. Nieuwe velden worden standaard niet opgenomen.

image-20240405-120138.pngImage Added
image-20240328-145908.pngImage Added
Selecteer niet meer dan 250 kolommen per tabel om fouten in de export te voorkomen.
English

Schedule Exports

To automatically schedule Exports from BC to ATS, you can use BC’s Job Queue.

  1. Search for the page “Job Queue Entries”

image-20240328-151747.pngImage Added
Look for the page “Job Queue Entries”

  1. Create a new entry:

    1. Object Type to Run: “Codeunit”

    2. Object ID To Run: 11295613 (bbs_ReplicaSyncTables)

    3. Choose the earliest Start Date/Time, when you want Replica to start exporting to ATS

    4. Choose the Recurrence days

    5. Choose the “No. of Minutes between each Recurrence” (example: 1440 minutes / 60 = every 24 hours)

image-20240809-103658.pngImage Added
Codeunit to schedule Exports from BC to ATS

  1. Click on “Set Status to Ready” to schedule the Job Queue for exporting

image-20240328-162454.pngImage Added
Set Status to Ready

Best practices

Some suggestions and best practices regarding the configuration of Replica 365:

  1. Will you use the data to be replicated in a follow-up process? For example, for integration into a webshop or a PIM?
    Then it can be useful to replicate all fields in the item card once a day. And several times a day only the item number and inventory. A table can be included multiple times in Replica 365, as long as the External name is unique.

image-20240328-201527.pngImage Added

  1. Business Central has tables with a lot of records. For example, "G/L Entries" or the "Item Ledger Entries" table. It is advisable to initially load these Tables completely justonce. And then only load the Changes on a daily base.

Dutch

Exports inplannen

Om automatisch exporten van BC naar ATS te plannen, kunt u de Taakwachtrijposten van BC gebruiken.

  1. Zoek naar de pagina “Taakwachtrijposten”

image-20240328-151747.pngImage Added
Look for the page “Job Queue Entries”

  1. Voeg een nieuwe rij toe:

    1. Objecttype om uit te voeren: "Codeunit"

    2. Object-ID om uit te voeren: 11295613 (bbs_ReplicaSyncTables)

    3. Kies de vroegste startdatum/-tijd waarop u wilt dat Replica begint met exporteren naar ATS

    4. Kies de herhalingsdagen

    5. Kies het "Aantal minuten tussen elke herhaling" (voorbeeld: 1440 minuten / 60 = elke 24 uur)

image-20240809-103642.pngImage Added
Codeunit 11295613 voor het exporteren van BC naar ATS

  1. Klik op "Status instellen op Gereed" om de taakwachtrij te plannen voor export

image-20240328-162454.pngImage Added
Set Status to Ready

Best practices

Enkele suggesties en best practices met betrekking tot de configuratie van Replica 365:

  1. Gebruikt u de te repliceren data in een vervolgtraject? Bijvoorbeeld voor integratie in een webshop of een PIM?
    Dan kan het handig zijn om alle velden in de artikelkaart één keer per dag te repliceren. En meerdere keren per dag alleen het artikelnummer en de inventaris. Een tabel kan meerdere keren in Replica 365 worden opgenomen, zolang de externe naam uniek is.

image-20240328-201527.pngImage Added

  1. Business Central heeft tabellen met veel records. Bijvoorbeeld de tabel "G/L Entries" of de tabel "Item Ledger Entries". Het is raadzaam om deze tabellen in eerste instantie volledig één keer te laden. En dan alleen de wijzigingen op dagelijkse basis te laden.