De eigenschappen SourceExpr en DestExpr gebruiken
In de vorige sectie hebben we besproken hoe je tabelinstanties toevoegt aan een mapping. In dit gedeelte bekijken we hoe we toegang krijgen tot de gegevens van velden in een tabel. En hoe je constante waarden en filters gebruikt.
Met de module kun je gegevens lezen van velden uit tabellen, wanneer er een SourceExpr (bron expressie) eigenschap is. De SourceExpr kan ook worden gebruikt om constante waarden op te geven of om functies aan te roepen. U vindt deze eigenschap op de gegevensregels van mapping van het opmaaktype NAV en op de gegevensregels van exportkoppelingen. Maar deze eigenschap is ook beschikbaar voor parameters van aangepaste functies en om foutmeldingen uit te breiden. Er zijn meer opties, die we later in dit hoofdstuk zullen bespreken.
Om gegevens naar tabelvelden te schrijven is er nog een eigenschap die DestExpr (destination expression) heet. Met deze eigenschap kun je gegevens ook controleren aan de hand van een opgegeven filter, in plaats van ze op te slaan. We zullen zo meteen ingaan op de details. Het is belangrijk om te weten dat je gegevens kunt schrijven naar elk veld van een tabelinstantie, zelfs als de Mode is ingesteld op Read. Schrijven naar een tabel in leesmodus roept de validatielogica van NAV op, maar we wijzigen het record niet. Op onze buffertabellen kun je dit gebruiken om een waarde voor een bepaalde tijd op te slaan in de mapping. Bij andere tabellen hangt het van de validatielogica af of het veilig is om een tabel in leesmodus te gebruiken om gegevens tijdelijk op te slaan.
De eigenschap SourceExpr
Het brontype specificeert wat voor soort gegevens je wilt lezen. De toegestane waarden zijn:
Een constante waarde die wordt ingevoerd in de mapping.
Een veld uit een instantie van een tabel, dat een van de parent mapping is van deze mapping. Als je een somveld wilt lezen, moet je buiten de tabelinstantie zijn, maar eronder.
Je wilt gegevens lezen van een ingebouwde of een aangepaste functie.
Deze eigenschap is toegevoegd in Anvaigo EDI Connect 4.00.
Deze eigenschap is alleen beschikbaar als het SrcType is ingesteld op Const Deze eigenschap specificeert het gegevenstype van de constante waarde. Je moet het gegevenstype selecteren om fouten te voorkomen door verschillende locales die worden gebruikt tijdens de installatie en runtime. In oudere versies moest je ervoor zorgen dat de locale tijdens het instellen dezelfde was als tijdens runtime om te voorkomen dat bijvoorbeeld getallen anders werden geïnterpreteerd.
Je kunt kiezen uit de volgende gegevenstypes:
Een constante tekstwaarde.
Een tekst die speciale tekens kan bevatten, zoals een carriage return<CR>. Er is een lijst met alle ondersteunde speciale tekens.
Een booleaanse waarde, zoals True of False.
Een optiewaarde. Je moet de gehele waarde van de optie in de database gebruiken.
Een geheel getal (32 bits).
Een decimale waarde.
Een groot geheel getal (64 bits).
De waarde bevat een duur.
De waarde is een Dynamics-codewaarde (alleen hoofdletters, niet alle tekens zijn toegestaan).
Geeft een datumwaarde weer.
Geeft een tijdswaarde weer.
Geeft een gecombineerde datum- en tijdwaarde weer.
Een datumformule.
Een globaal uniek ID (GUID).
Deze eigenschap is alleen beschikbaar als het SrcType is ingesteld op Const Vertegenwoordigt de constante waarde die je wilt gebruiken.
Deze eigenschap is alleen beschikbaar als het SrcType is ingesteld op Function. Je kunt de AssistEdit gebruiken om het object en de functie te specificeren. Als de functie parameters vereist, worden deze ook SourceExpr, maar het nesten van functies wordt niet ondersteund.
Deze eigenschap is alleen beschikbaar als het SrcType is ingesteld op Field. Selecteer de instantie van de tabel om de gegevens uit te lezen. De tabel moet één van de ouders zijn van de huidige mapping, om de gegevens van één record te lezen. Als je somvelden wilt lezen, moet je onder de instantie van de tabel zijn, maar geen child ervan.
Deze eigenschap is alleen beschikbaar als het SrcType is ingesteld op Field. Selecteert de kolom/het veld waarvan je wilt lezen.
Je kunt een waardevertaling opgeven om de geselecteerde waarde te wijzigen in een andere doelwaarde. Er is een sectie over het instellen van waardevertalingen.
De code van de waardevertaling die moet worden gebruikt.
Wat er moet gebeuren als de waarde niet wordt gevonden in de waardevertaling.
De module doet niets als de vertaling ontbreekt. Het gebruikt de originele waarde zonder vertaling.
Voer een lege waarde uit.
Voeg een informatielogboekvermelding toe en gebruik de oorspronkelijke waarde.
Voeg een waarschuwingslogboekvermelding toe en gebruik de oorspronkelijke waarde.
Breek de mapping onmiddellijk af en log een fout.
Maak een foutlogboekvermelding en voltooi de mapping niet met succes, maar ga door met de verwerking om ook andere fouten te vinden.
Deze eigenschap is standaard verborgen. Je kunt een lijst met toegestane waarden opgeven en fouten maken als je een andere waarde probeert te exporteren.
De lijst met toegestane waarden. Je kunt AssistEdit gebruiken of de termen kommagescheiden invoeren.
Wat moet er gebeuren als de bronwaarde niet in de lijst met toegestane waarden staat?
Gebruik de geavanceerde validatie niet en negeer alle waarden in de lijst.
Maak een informatielogboekvermelding.
Een waarschuwingslogboekvermelding maken.
Breek de mapping onmiddellijk af met een foutmelding.
Geef een fout terug bij het uitvoeren van mapping, maar ga door met het verwerken van de mapping om ook andere fouten te vinden.
De eigenschap DestExpr
Selecteer het doel voor een waarde. De volgende waarden zijn geldig:
Leeg betekent dat de waarde wordt genegeerd. Je kunt dit gebruiken om velden over te slaan bij import of om bijvoorbeeld een functie-retourwaarde te negeren.
De waarde moet worden gecontroleerd met een Dynamics filter. Als het filter niet overeenkomt, wordt de waarde niet geaccepteerd. Afhankelijk van de converter zal dit resulteren in een foutmelding of in het overslaan van een deel van de mapping. Meer informatie over het gebruik van filters voor specifieke converters vind je in de documentatie van elke converter.
De waarde moet worden weggeschreven naar een veld van een instantie van een tabel in deze mapping.
Deze eigenschap is alleen beschikbaar als het DestType is ingesteld op Filter. Het Dynamics filter waarop de waarde wordt gecontroleerd. De waarde wordt geïnterpreteerd als een tekstwaarde voor het toepassen van het filter. Een typisch voorbeeld is “BY|IV”, om de waarden “BY” en “IV” toe te staan.
Deze eigenschap is alleen beschikbaar als het DestType is ingesteld op Field. Selecteert de tabelinstantie waar de waarde naartoe geschreven moet worden. De tabelinstantie moet een van de ouders zijn van de huidige mapping.
Deze eigenschap is alleen beschikbaar als het DestType is ingesteld op Field. De veldnaam/kolomnaam van het doelveld in de tabel.
Deze eigenschap is alleen beschikbaar als het DestType is ingesteld op Field. Deze eigenschap is alleen beschikbaar als geavanceerde eigenschap. Als deze eigenschap op False wordt ingesteld, wordt de Microsoft Dynamics NAV 2009R2 RTC-validatietrigger voor dat veld overgeslagen.
Wees erg voorzichtig bij het gebruik van False. Je moet de validatie alleen uitschakelen na overleg met een programmeur. U moet het niet deactiveren op een van de standaard Dynamics tabellen, tenzij u echt weet wat u doet. Je kunt Microsoft Dynamics NAV 2009R2 RTC onbruikbaar maken door de validatiecode over te slaan.
Deze eigenschap is alleen beschikbaar als het DestType is ingesteld op Field en je de CHECK / NAV / PREPARE / PROCESS converter gebruikt. Je kunt meer informatie vinden op de converterpagina.