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
| Achtervoegsel | Subtype | Beschrijving |
|---|---|---|
| _INCOMING | Incoming Transmission | Behandelt inkomende bestanden (bijv. XML, EDIFACT) voor import. |
| _COLLECT | Data Collection | Verzamelt gegevens van Business Central (bijv. facturen). |
| _PROCESSING | Sub-Process | Verwerkt buffergegevens (bijv. importeren van transformatie). |
| _OUTGOING | Sub-Process | Definitieve 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
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.
Afhankelijk van het Process Entry Point bepaalt dit veld welke tabel wordt gebruikt voor de registraties van bedrijfstransacties.
In dit veld wordt de tabel-ID van Transaction Data Table opgeslagen.
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.
Dit is het technische veldnummer voor het veld Reference No. Field
Of je dit veld kunt gebruiken hangt af van het Process Entry Point.
Definieert dat de communicatiepartner voor dit EDI Business Transaction Type afhankelijk is van een waarde uit de Transaction Data Table.
De communicatiepartner is één voor dit EDI Business Transaction Type.
Definieert het veld dat wordt gebruikt om de communicatiepartner te vinden.
Technisch veldnr. voor het veld Relation Field Name.
Dit veld definieert het ingangspunt van het proces. Het ingangspunt van het proces bepaalt veel van de andere opties die beschikbaar zijn.
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)
Het proces begint met een transmissie van een communicatiekanaal.
(De gehele waarde van deze optie in de database is 1)
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)
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.
U wilt het automatisch verzamelen van gegevens niet inschakelen.
(De gehele waarde van deze optie in de database is 0)
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)
Je wilt een datumveld gebruiken.
(De gehele waarde van deze optie in de database is 2)
Je wilt een codeveld gebruiken.
(De gehele waarde van deze optie in de database is 3)
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)
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)
Met deze optie kunt u alle items exporteren die zich in een opgegeven tijdspanne bevinden, berekend ten opzichte van de laatste taakrun (niet de huidige datum). Als je bijvoorbeeld “30 dagen” opgeeft en “Boekingsdatum” als filterveld gebruikt, zal de module rekening houden met boekingen die binnen 30 dagen voor de laatste run zijn geboekt, zoals vastgelegd in het veld “Laatste datum/tijdswaarde”.
De export wordt zo gefilterd dat alleen vermeldingen worden opgenomen waarbij het geselecteerde datumveld groter is dan de “Laatste datum/tijd-waarde” minus de gesepareerde tijdspanne. Er is geen filter om het exporteren van entried met een datum groter dan vandaag te voorkomen.
Als “Duplicaten negeren” is ingeschakeld in de actiegroep, controleert de module de hele tijdspanne op items en exporteert alleen die items die nog niet eerder zijn geëxporteerd.
(De gehele waarde van deze optie in de database is 6)
Specificeert hoe om te gaan met vermeldingen waarbij de communicatiepartner niet kan worden gevonden.
Maak items en markeer ze.
(De gehele waarde van deze optie in de database is 0)
Maak geen items aan in de bedrijfstransactietabel.
(De gehele waarde van deze optie in de database is 1)
Definieert het veld dat wordt gebruikt om nieuwe items te vinden.
Het technische veldnummer voor het veld Change Detection Field Name.
Definieert een tabelweergave die aanvullend wordt toegepast op de criteria voor automatische gegevensverzameling.
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.
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.
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.
Slaat de aanmaakdatum/-tijd van deze tabel op.
Slaat de wijzigingsdatum/-tijd van deze record op.