ACF Management
Met behulp van de codeunit ACF Management heeft u de mogelijkheid om de belangrijkste besturingsfuncties van de Anveo Client Suite op te roepen en te gebruiken in hun code.
De voor de communicatie met de Dynamics gebruikte webservices staan om technische redenen geen interactie met de gebruiker in de Anveo Web Portal toe. Hierdoor worden de Dynamics-functies MESSAGE, CONFIRM, STRMENU en DIALOG niet automatisch geïdentificeerd en weergegeven in de client. Anderzijds kunnen deze vooraf bepaalde beperkingen die door de webservices worden opgelegd, met weinig moeite worden omzeild door deze aanroepen over te dragen aan de codeunit ACF Management. De codeunit maakt automatisch een onderscheid tussen Dynamics-client en Anveo Client Suite en verwerkt de koffer automatisch.
Foutmeldingen veroorzaakt door ERROR hoeven niet te worden aangepast, de webdienst kan deze afhandelen.
De functie MESSAGE is gelijk aan dezelfde functie in de Dynamics. U kunt berichten gebruiken, waarin u de code vervangt:
MESSAGE('Hello World!');
MESSAGE('Hello %1!', anyVariable);
met deze code:
ACFManagement.MESSAGE('Hello World!');
ACFManagement.MESSAGE1('Hello %1!', anyVariable);
De functie MESSAGE1 betekent dat deze een parameter bevat die in de tekst van het berichtvenster is ingebed. Door het activeren van de functies MESSAGE …MESSAGE10 kunt u maximaal 10 parameters vastleggen.
Indien u interactie met de gebruiker nodig heeft via een CONFIRM bericht, dan kunt u de code vervangen:
IF CONFIRM('Are you sure?') THEN doSomething();
IF CONFIRM('Do you want to delete %1?',anyVariable) THEN
doSomething();
met deze code:
IF ACFManagement.CONFIRM('Are you sure?',TRUE) THEN
doSomething();
IF ACFManagement.CONFIRM1('Do you want to delete %1?',FALSE,
anyVariable) THEN
doSomething();
Analoog aan de berichten, kunt u door het activeren van CONFIRM ... CONFIRM10 maximaal 10 parameters instellen. Houd er rekening mee dat u de parameter Default moet specificeren, deze parameter kan worden weggelaten in de CONFIRM van de Dynamics.
Net als bij de Dynamics standaard versie, moet er bij een CONFIRM op worden gelet dat er vooraf geen tabel is geblokkeerd met INSERT, MODIFY, DELETE of LOCKTABLE, omdat de tabel pas wordt vrijgegeven als de gebruiker zich opnieuw registreert. Dit betekent op zijn beurt dat een zeer lange blokkering het werk van andere gebruikers van de applicatie zal beperken. Als een dergelijk geval onvermijdelijk noodzakelijk is en dus opzettelijk of per ongeluk is gebeurd, kan een gebruikerssessie in de Web User Setup het opnieuw worden ingesteld zodat de verwerking wordt afgebroken.
In het geval dat een “Yes” of “No” niet voldoende is als interactie met een CONFIRM bericht, kunt u de code vervangen:
Selection := Dialog.STRMENU('Yes,No,Cancel',2,'Save?');
met deze code:
Selection := ACFManagement.STRMENU('Yes,No,Cancel',2,'Save?');
De functies van de codeunit ACF Management zijn analoog aan dezelfde functies in de Dynamics en worden gebruikt om de status van lange processen te verkrijgen (bijv. berichten) getoond. Een voorbeeld voor het gebruik van dialoogvensters is te vinden in de codeunit ACF Events Admin/Examples, functie
OnAction_EXAMPLE(), actiecode EXAMPLE:PROGRESSW.
Gelijkwaardig aan de functie HYPERLINK van Dynamics.
Opent een Anveo Page met de inhoud van de opgegeven URL.
Opent een Anveo Page met de inhoud van de opgegeven URL die een veel langere URL toestaat dan de functie OpenURLExtended (meer informatie vindt u hier).
Opent een webpagina met een Google-maps kaart op het opgegeven adres. Voor een voorbeeld zie actiecode CONTACT:OPENGM in de codeunit
ACF Events Sales & Marketing
Opent een specifieke Anveo Page in de webclient.
Opent een gespecificeerde Anveo Page in de webclient voor het invoegen van een nieuw record. Zodra de Anveo Page geopend is, wordt het record aangemaakt.
Sluit de huidige Anveo Page in de webclient.
Maakt een nieuw record aan op de huidige Anveo Page. Deze functie komt overeen met de actie NEW_RECORD() van de codeunit ACF Events (zie meer informatie hier).
Herladen van de huidige Anveo Page in de webclient.
Herladen van alle geopende Anveo Pages die verwijzen naar de tabel met het aangegeven nummer. De tweede parameter van deze functie stelt de scope in: 0 = all card, 1 = all lists, 2 = all cards and lists.
Opent een dialoogvenster voor het downloaden van bestanden of voor het direct bekijken van PDF-documenten, mits een geschikte browser plug-in is geïnstalleerd.
Opent een dialoogvenster voor het downloaden van bestanden, ongeacht of het direct in de browserplugin kan worden weergegeven of niet.
Opent een dialoogvenster om bestanden te uploaden. De eerste parameter van de functie geeft de bestandsnaam terug (zonder pad), waar het geüploade bestand is opgeslagen. Het bestand bevindt zich na het uploaden in de overdrachtmap van de Anveo Client Suite zoals ingesteld in de Anveo Setup in het veld Web Service File Transfer Folder.
Geeft de huidige sessie-ID van de Anveo-gebruiker terug.
Geeft ofwel de Anveo User Code of de globale variabele USERID van de Dynamics, afhankelijk van de C/AL code, die door Anveo Client Suite of door de Dynamics wordt opgeroepen.
Retourneert de Anveo User-gebruikerscode, mits deze in de Anveo Client Suite wordt gebruikt. Anders wordt een blanco waarde teruggegeven.
Geeft aan of de C/AL code wordt aangeroepen uit het Anveo Client Framework zodat verschillende soorten gedrag kunnen worden vastgesteld. Vergelijkbaar met ISSERVICETIER of GUIALLOWED in Dynamics.
Geeft aan of de C/AL code wordt aangeroepen vanuit de Anveo Mobile App zodat verschillende soorten gedrag kunnen worden vastgesteld. Vergelijkbaar met ISSERVICETIER of GUIALLOWED in Dynamics.
Schrijft een logboekvermelding voor een bepaalde functie met een begeleidende tekst. U kunt uw C/AL-code debuggen met behulp van de geactiveerde protocollering van alle gebruikersingangen.
Omdat xRec niet overal beschikbaar is (zie hier), kunt u het instellen met de functie SetxRec. Het instellen van xRec vindt al plaats in de codeunit ACF Events.
Omdat xRec niet overal beschikbaar is (zie hier), kunt u het verkrijgen met de functie GetxRec. Het ophalen van xRec vindt al plaats in de codeunit ACF Events.
Maakt een tijdelijk bestand aan op de server waarop de webservice van Dynamics draait en geeft zijn naam terug.
Bij het openen van Anveo Pages worden de brontabel en de relatiecode als parameter in plaats van de bestemmingstabel (zoals het geval is in de Dynamics-norm) overhandigd. Aangezien de bestemmingstabel zich in de gespecificeerde relatie bevindt en alle filters (inclusief het beveiligingsfilter) daar zijn ingesteld, moeten de Anveo Pages om veiligheidsredenen op deze manier worden geopend.