Anvaigo EDI Connect / Config / Business Transactions / EDI Business Transaction Type
Dit is een automatische vertaling. De originele post is beschikbaar in Engels.

EDI Business Transaction Type

Het zakelijke transactietype definieert een mogelijke algemene business case. Dit kan bijvoorbeeld een uitgaande factuur of inkomende bestellingen zijn.

Deze gegevensstructuur wordt ook gebruikt om automatische gegevensverzameling te definiëren, bijvoorbeeld om alle nieuwe facturen in het systeem te vinden en EDI-acties te activeren. Het bedrijfstype bepaalt ook hoe de EDI-partner wordt bepaald op basis van de bedrijfsgegevens.

Elke transactiestroom is samengesteld uit een of meer bedrijfstransactietypen, met verschillende procesingangen, die bepalen hoe gegevens in elke fase worden verwerkt. Het begrijpen van deze verschillende typen van de EDI Business Transaction Type-structuur is essentieel voor het opzetten van efficiënte en betrouwbare EDI-processen.

Process Entry Point

Incoming Transmission

Dit type wordt gebruikt voor het ontvangen en importeren van gegevens uit externe systemen in Dynamics 365 Business Central. Het is meestal de eerste stap in een transactie en is verantwoordelijk voor het parsen van het invoerbestand (bijv. EDIFACT, XML, CSV) en het importeren van de gegevens in een interne bufferstructuur.

  • Voorbeeld Use Case: Inkooporders of facturen ontvangen van handelspartners.

Data Collection

Dit type wordt gebruikt om gegevens te extraheren uit Dynamics 365 Business Central. Het verzamelt de nodige records van tabellen zoals verkooporders, facturen of verzendingen en bereidt ze voor op export.

  • Voorbeeld Use Case: Het verzamelen van open verkooporders die moeten worden geëxporteerd als orderreacties of bevestigingen.

Sub-Process

Het type Subproces wordt voornamelijk gebruikt voor het werken met bufferstructuren, zoals het EDI-document of gerelateerde buffertabellen. In tegenstelling tot de andere types die direct werken op een enkel bestand (Inkomende gegevens) of een bronrecord in Business Central (Gegevensverzameling), werken Subprocesactiviteiten meestal op de tussenliggende buffergegevens.

Dit type is essentieel voor het structureren en regelen van de stroom van verwerkingslogica in zowel import- als exportscenario’s.

Belangrijkste gebruikssituaties

  • Buffertransformatie: In importeerscenario’s wordt een binnenkomend bestand eerst in kaart gebracht in een bufferstructuur. Een Subproces neemt het dan over om die buffer verder te verwerken. Dit kan een 1:1 verwerking van de buffer zijn of een 1:n scenario waarbij één inkomend record meerdere bufferaantekeningen genereert.
  • Batchverwerking met fouttolerantie: Wanneer een enkel bestand meerdere bedrijfsdocumenten bevat (bijv. meerdere orders), kan elke bufferrecord worden verwerkt in zijn eigen Subproces. Dit zorgt ervoor dat een storing in één document de verwerking van de andere documenten niet blokkeert.
  • Export Mapping Voorbereiding: In exportstromen verzamelt het type Gegevensverzameling records zoals verkoopfacturen of zendingen en bereidt ze voor in bufferstructuren. Vervolgens wordt een Subproces gebruikt om deze buffer te verwerken, waarbij de gegevens worden getransformeerd of mapping voordat ze worden uitgevoerd als XML, EDIFACT of een ander vereist formaat.

Vanuit de mapping is het bijbehorende record van de zakelijke transactie (bijv. een EDI-document) altijd toegankelijk, dus wanneer we het hoofdrecord voor verdere verwerking willen wijzigen, kunnen we daarvoor een subproces gebruiken.

Conventies voor naamgeving

Hoewel je vrij bent om elke code te gebruiken, raden we je aan om consistente naamgevingsconventies te gebruiken. Hieronder staan onze conventies, die helpen om onmiddellijk het doel van de transactie en haar rol binnen de verwerkingsketen te identificeren.

De naam van elk bedrijfstransactietype volgt meestal dit formaat:

[DOCUMENT_TYPE]_[ROLE]

Waar:

  • [DOCUMENT_TYPE] beschrijft het bedrijfsdocument dat wordt verwerkt (bijv. ORDERS, INVOIC, DESADV).
  • [ROLE] geeft de functie van het subtype binnen de transactie aan.

Aanbevolen achtervoegsels voor rollen

AchtervoegselSubtypeBeschrijving
_INCOMINGIncoming TransmissionBehandelt inkomende bestanden (bijv. XML, EDIFACT) voor import.
_COLLECTData CollectionVerzamelt gegevens van Business Central (bijv. facturen).
_PROCESSINGSub-ProcessVerwerkt buffergegevens (bijv. importeren van transformatie).
_OUTGOINGSub-ProcessDefinitieve buffertransformatie en mapping voor export.

Voorbeeld van naamgevingspatronen:

  • ORDERS_INCOMING
    Gebruikt om inkomende inkooporderbestanden te importeren in de buffertabellen.
  • ORDERS_PROCESSING
    Bereid de gegevens voor en maak verkooporders vanuit de bufferrecord die is aangemaakt met de transactie ORDERS_INCOMING.
  • INVOIC_COLLECT
    Verzamelt geboekte verkoopfacturen en aangemaakte bufferrecords.
  • INVOIC_OUTGOING
    Zet de verzamelde factuurbuffer om in een uitgaand EDI-formaat.

Velden

Code

Dit veld maakt deel uit van de primaire sleutel. Je kunt elke code gebruiken die je maar wilt. We raden een beschrijvende code aan, zoals INVOICE_OUT, ORDERS_IN, enz.

Transaction Data Table

Afhankelijk van het Process Entry Point bepaalt dit veld welke tabel wordt gebruikt voor de registraties van bedrijfstransacties.

Transaction Data Table ID

In dit veld wordt de tabel-ID van Transaction Data Table opgeslagen.

Reference No. Field

Dit veld definieert het veld dat wordt gebruikt als referentienummer in de bedrijfstransactietabel. Dit veld heeft geen invloed op de verwerkingslogica, maar is het belangrijkste zoekveld om het document te vinden vanuit het perspectief van de eindgebruiker.

Reference No. Field No.

Dit is het technische veldnummer voor het veld Reference No. Field

Find Communication Partner by

Of je dit veld kunt gebruiken hangt af van het Process Entry Point.

Field

Definieert dat de communicatiepartner voor dit EDI Business Transaction Type afhankelijk is van een waarde uit de Transaction Data Table.

Constant

De communicatiepartner is één voor dit EDI Business Transaction Type.

Relation Field Name

Definieert het veld dat wordt gebruikt om de communicatiepartner te vinden.

Relation Field No.

Technisch veldnr. voor het veld Relation Field Name.

Process Entry Point

Dit veld definieert het ingangspunt van het proces. Het ingangspunt van het proces bepaalt veel van de andere opties die beschikbaar zijn.

Data Collection

Het proces heeft bestaande gegevens in Microsoft Dynamics 365 Business Central als invoerpunt. Met deze optie kun je automatische ophaaltaken definiëren.
(De gehele waarde van deze optie in de database is 0)

Incoming Transmission

Het proces begint met een transmissie van een communicatiekanaal.
(De gehele waarde van deze optie in de database is 1)

Sub-Process

Het proces is een subonderdeel van een ander proces. De Transaction Data Table hoeft niet hetzelfde te zijn. Deze optie definieert dat dit type bedrijfstransactie alleen kan worden aangeroepen als subproces van een ander type.
(De gehele waarde van deze optie in de database is 2)

Automatic Data Collection

Legt vast of je automatisch verzamelen van gegevens wilt inschakelen. Houd er rekening mee dat je ook een taak moet definiëren die het automatisch ophalen start. Met deze optie kun je bepalen welk veldtype wordt gebruikt om nieuwe records te detecteren.

None

U wilt het automatisch verzamelen van gegevens niet inschakelen.
(De gehele waarde van deze optie in de database is 0)

SQL Timestamp

U volgt wijzigingen op basis van de SQL-tijdstempel. Dit is alleen mogelijk met Microsoft Dynamics 2013R2 en nieuwer. In BC 17 werd een nieuw systeemveld geïntroduceerd dat de laatste wijzigingsdatum/-tijd bevat. In plaats daarvan raden we het gebruik van de optie Date Field aan.
(De gehele waarde van deze optie in de database is 1)

Date Field

Je wilt een datumveld gebruiken.
(De gehele waarde van deze optie in de database is 2)

Code Field

Je wilt een codeveld gebruiken.
(De gehele waarde van deze optie in de database is 3)

Boolean Flag

Je wilt een booleaanse vlag gebruiken, false betekent dat de gegevens nog niet zijn geëxporteerd. Het veld wordt automatisch gewijzigd. Deze optie werkt niet op beschermde systeemtabellen, zoals factuurheaders.
(De gehele waarde van deze optie in de database is 4)

All records

Exporteer altijd alle records. Dit kan handig zijn om bijvoorbeeld alle openstaande orders te exporteren. De filters van de DataView worden nog steeds toegepast, wat je de mogelijkheid geeft om aangepaste velden of criteria te gebruiken.

(De gehele waarde van deze optie in de database is 5)

Timespan (Past)

Met deze optie kun je alle items exporteren die nieuwer zijn dan de opgegeven tijdspanne in het verleden. Als je bijvoorbeeld “30 dagen” opgeeft en de “Boekingsdatum” gebruikt, zal de module alle boekingen exporteren die nieuwer dan 30 dagen in het verleden zijn geboekt. Als je duplicaten negeert, kun je een hele tijdspanne controleren op nieuwe documenten en alleen de documenten exporteren die nog niet geëxporteerd zijn.

(De gehele waarde van deze optie in de database is 6)

Debug Options

Specificeert hoe om te gaan met vermeldingen waarbij de communicatiepartner niet kan worden gevonden.

Create Ignore Entries

Maak items en markeer ze.
(De gehele waarde van deze optie in de database is 0)

None

Maak geen items aan in de bedrijfstransactietabel.
(De gehele waarde van deze optie in de database is 1)

Change Detection Field Name

Definieert het veld dat wordt gebruikt om nieuwe items te vinden.

Change Detection Field No.

Het technische veldnummer voor het veld Change Detection Field Name.

Data Table View

Definieert een tabelweergave die aanvullend wordt toegepast op de criteria voor automatische gegevensverzameling.

Last Timestamp

Slaat de laatste tijdstempel op. Als Automatic Data Collection is ingesteld op
SQL Timestamp, wordt er een filter toegepast op de gegevenstabel, waarbij alleen wordt gezocht naar vermeldingen met een hogere waarde dan deze. Na het uitvoeren van de taak wordt de laatste waarde in dit veld opgeslagen.

Last Code Value

Slaat de laatste tijdstempel op. Als Automatic Data Collection is ingesteld op Code Field, wordt er een filter toegepast op de gegevenstabel, waarbij alleen wordt gezocht naar vermeldingen met een hogere waarde dan deze. Na het uitvoeren van de taak wordt de laatste waarde in dit veld opgeslagen.

Last Date/Time Value

Slaat de laatste tijdstempel op. Als Automatic Data Collection is ingesteld op Date Field, wordt er een filter toegepast op de gegevenstabel, waarbij alleen wordt gezocht naar vermeldingen met een hogere waarde dan deze. Na het uitvoeren van de taak wordt de laatste waarde in dit veld opgeslagen.

Created Date/Time

Slaat de aanmaakdatum/-tijd van deze tabel op.

Modified Date/Time

Slaat de wijzigingsdatum/-tijd van deze record op.