CodeunitACF Management
En utilisant le codeunit ACF Management, vous avez la possibilité d’invoquer les principales fonctions de contrôle d’Anveo Client Suite et de les utiliser dans leur code.
Les services web utilisés pour la communication avec Microsoft Dynamics NAV 2017 ne permettent aucune interaction avec l’utilisateur dans l’Anveo Web Portal pour des raisons techniques. Par conséquent, les fonctions Microsoft Dynamics NAV 2017 MESSAGE, CONFIRM, STRMENU et DIALOG ne sont pas automatiquement identifiées et affichées dans le client. D’autre part, ces contraintes prédéfinies stipulées par les services web peuvent être contournées avec peu d’efforts en transférant ces invocations à la ACF Managementcodeunit ACF Management. L’codeunit différencie automatiquement le cas entre Microsoft Dynamics NAV 2017 Client et Anveo Client Suite et traite le cas en conséquence.
Les messages d’erreur causés par ERROR ne doivent pas être adaptés, le service web peut les gérer.
La fonction MESSAGE est équivalente à la même fonction dans Microsoft Dynamics NAV 2017. Vous pouvez utiliser des messages dans lesquels vous remplacez le code :
MESSAGE('Hello World!');
MESSAGE('Hello %1!', anyVariable);
avec ce code :
ACFManagement.MESSAGE('Hello World!');
ACFManagement.MESSAGE1('Hello %1!', anyVariable);
La fonction MESSAGE1 signifie qu’elle contient un paramètre qui est intégré dans le texte de la boîte de message. En activant les fonctions MESSAGE …MESSAGE10, vous pouvez spécifier jusqu’à 10 paramètres.
Si vous avez besoin d’une interaction avec l’utilisateur via un message CONFIRM, vous pouvez alors remplacer le code :
IF CONFIRM('Are you sure?') THEN doSomething();
IF CONFIRM('Do you want to delete %1?',anyVariable) THEN
doSomething();
avec ce code :
IF ACFManagement.CONFIRM('Are you sure?',TRUE) THEN
doSomething();
IF ACFManagement.CONFIRM1('Do you want to delete %1?',FALSE,
anyVariable) THEN
doSomething();
Comme pour les messages, en activant CONFIRM ... CONFIRM10, vous pouvez spécifier jusqu’à 10 paramètres. Veuillez noter que vous devez spécifier le paramètre Default, ce paramètre peut être omis dans la CONFIRM de la Microsoft Dynamics NAV 2017.
Comme pour la version Microsoft Dynamics NAV 2017 par défaut, en cas de CONFIRM, il faut s’assurer qu’aucune table n’a été bloquée à l’avance avec INSERT, MODIFY, DELETE ou LOCKTABLE, car la table n’est libérée que lorsque l’utilisateur s’inscrit à nouveau. Ceci, à son tour, signifie qu’un blocage très long va restreindre le travail des autres utilisateurs de l’application. Si un tel cas est inévitablement nécessaire et s’est donc produit délibérément ou accidentellement, une session utilisateur dans le Web User Setup permet de le réinitialiser afin que le traitement soit interrompu.
Dans le cas où un “Yes” ou un “No” ne suffit pas comme interaction avec un message CONFIRM, vous pouvez remplacer le code :
Selection := Dialog.STRMENU('Yes,No,Cancel',2,'Save?');
avec ce code :
Selection := ACFManagement.STRMENU('Yes,No,Cancel',2,'Save?');
Les fonctions de codeunit ACF Management sont analogues aux mêmes fonctions dans Microsoft Dynamics NAV 2017 et sont utilisées pour avoir le statut de processus longs (par ex. ) affichées. Un exemple d’utilisation des dialogues se trouve dans l’codeunit ACF Events Admin/Examples, fonction
OnAction_EXAMPLE(), action code EXEMPLE:PROGRESSW.
Equivalent à la fonction HYPERLINK de Microsoft Dynamics NAV 2017.
Ouvre une Anveo Page avec le contenu de l’URL spécifiée.
Ouvre une Anveo Page avec le contenu de l’URL spécifiée qui permet uneURL beaucoup plus longue que la fonction OpenURLExtended (pour plus d’informations, cliquez ici).
Ouvre une page Web affichant une carte Google-maps à l’adresse spécifiée. Pour un exemple, voir le code d’action CONTACT:OPENGM dans l’codeunit
ACF Events Sales & Marketing
Ouvre une Anveo Page spécifiée dans le client Web.
Ouvre une Anveo Page spécifiée dans le client Web pour insérer un nouvel enregistrement. Une fois la Anveo Page ouverte, l’enregistrement est créé.
Ferme la Anveo Page en cours dans le client Web.
Crée un nouvel enregistrement dans la Anveo Page courante. Cette fonction équivaut à l’action NEW_RECORD() de codeunit ACF Events (voir plus d’informations ici).
Recharge la Anveo Page en cours dans le client Web.
Recharge toutes les Anveo Pages ouvertes qui se réfèrent au tableau portant le numéro indiqué. Le deuxième paramètre de cette fonction définit la portée : 0 = all card, 1 = all lists, 2 = all cards and lists.
Ouvre une boîte de dialogue permettant de télécharger des fichiers ou de visualiser directement des documents PDF, à condition qu’un plug-in de navigateur approprié soit installé.
Ouvre une boîte de dialogue pour télécharger des fichiers, qu’ils puissent ou non être affichés directement dans le plugin du navigateur.
Ouvre une boîte de dialogue pour télécharger des fichiers. Le premier paramètre de la fonction retourne le nom du fichier (sans chemin), où le fichier téléchargé a été stocké. Le fichier se trouve après le téléchargement dans le répertoire de transfert d’Anveo Client Suite, tel qu’il a été configuré dans la Anveo Setup dans le champ Web Service File Transfer Folder.
Renvoie l’ID de session actuelle de l’utilisateur Anveo.
Renvoie soit le code Anveo User, soit la variable globale USERID de la Microsoft Dynamics NAV 2017 en fonction du code C/AL a été appelé par Anveo Client Suite ou par Microsoft Dynamics NAV 2017.
Renvoie le code Anveo User, à condition qu’il soit invoqué dans Anveo Client Suite. Sinon, une valeur à blanc est retournée.
Renvoie si le code C/AL est invoqué à partir de l’Anveo Client Framework afin que différents types de comportement puissent être adoptés. Comparable à ISSERVICETIER ou GUIALLOWED en Microsoft Dynamics NAV 2017.
Renvoie si le code C/AL est invoqué à partir de l’Anveo Mobile App afin que différents types de comportement puissent être adoptés. Comparable à ISSERVICETIER ou GUIALLOWED en Microsoft Dynamics NAV 2017.
Rédige une entrée de journal pour une fonction donnée ainsi qu’un texte d’accompagnement. Vous pouvez déboguer votre code C/AL en utilisant le protocole activé de toutes les entrées utilisateur.
Comme xRec n’est pas disponible partout (voir ici), vous pouvez le définir à l’aide de la fonction SetxRec. Le réglage xRec a déjà lieu dans les ACF Events l’codeunit.
Puisque xRec n’est pas disponible partout (voir ici), vous pouvez l’obtenir en utilisant la fonction GetxRec. L’obtention de xRec a déjà lieu dans les ACF Events l’codeunit.
Crée un fichier temporaire sur le serveur sur lequel le service web de Microsoft Dynamics NAV 2017 s’exécute et renvoie son nom.
Lors de l’ouverture de Anveo Pages, la table source et le code de relation sont transmis comme paramètre au lieu de la table de destination (comme c’est le cas dans Microsoft Dynamics NAV 2017 Standard). Puisque la table de destination est située dans la relation spécifiée et que tous les filtres (y compris le filtre de sécurité) y sont placés, les Anveo Pages doivent être ouvertes de cette façon pour des raisons de sécurité.