Codeunit diACF Management
Utilizzando l’codeunit ACF Management avete la possibilità di richiamare le principali funzioni di controllo dell’Anveo Client Suite e di utilizzarle nel loro codice.
I servizi web utilizzati per la comunicazione con Dynamics non consentono alcuna interazione con l’utente dell’Anveo Web Portal per motivi tecnici. Di conseguenza, le funzioni Dynamics MESSAGE, CONFIRM, STRMENU e DIALOG non vengono automaticamente identificate e visualizzate nel client. D’altra parte, questi vincoli predefiniti stipulati dai servizi web possono essere aggirati con poco sforzo trasferendo queste invocazioni all’codeunit ACF Management. L’codeunit fa automaticamente la differenziazione del caso tra Dynamics Client e Anveo Client Suite ed elabora il caso di conseguenza.
I messaggi di errore causati da ERROR non devono essere adattati, il servizio web può gestirli.
La funzione MESSAGE equivale alla stessa funzione del Dynamics. È possibile utilizzare messaggi in cui si sostituisce il codice:
MESSAGE('Hello World!');
MESSAGE('Hello %1!', anyVariable);
con questo codice:
ACFManagement.MESSAGE('Hello World!');
ACFManagement.MESSAGE1('Hello %1!', anyVariable);
La funzione MESSAGE1 significa che contiene un parametro che è incorporato nel testo della casella di messaggio. Attivando le funzioni MESSAGE …MESSAGE10 è possibile specificare fino a 10 parametri.
Nel caso in cui si richieda l’interazione con l’utente tramite un messaggio CONFIRM, è possibile sostituire il codice:
IF CONFIRM('Are you sure?') THEN doSomething();
IF CONFIRM('Do you want to delete %1?',anyVariable) THEN
doSomething();
con questo codice:
IF ACFManagement.CONFIRM('Are you sure?',TRUE) THEN
doSomething();
IF ACFManagement.CONFIRM1('Do you want to delete %1?',FALSE,
anyVariable) THEN
doSomething();
Analogamente ai messaggi, attivando CONFIRM ... CONFIRM10 è possibile specificare fino a 10 parametri. Si noti che è necessario specificare il parametro Default, che può essere omesso nel CONFIRM del Dynamics.
Come per la versione di default del Dynamics, con una CONFIRM si deve fare attenzione che nessuna tabella sia stata bloccata in anticipo con INSERT, MODIFY, DELETE o LOCKTABLE, perché la tabella non viene rilasciata fino a quando l’utente non si registra nuovamente. Questo, a sua volta, significa che un blocco molto lungo limiterà il lavoro di altri utenti di applicazioni. Se un tale caso è inevitabilmente necessario e si è quindi verificato deliberatamente o accidentalmente, una sessione utente in Web User Setup permette di resettarla in modo che l’elaborazione venga interrotta.
Nel caso in cui un “Yes” o un “No” non sia sufficiente come interazione con un messaggio CONFIRM, è possibile sostituire il codice:
Selection := Dialog.STRMENU('Yes,No,Cancel',2,'Save?');
con questo codice:
Selection := ACFManagement.STRMENU('Yes,No,Cancel',2,'Save?');
Le funzioni dell’codeunit ACF Management sono analoghe alle stesse funzioni del Dynamics e vengono utilizzate per avere lo stato di processi lunghi (es. messaggi) mostrato. Un esempio di utilizzo delle finestre di dialogo si trova nell’codeunit ACF Events Admin/Examples, funzione
OnAction_EXAMPLE(), action code EXAMPLE:PROGRESSW.
Equivalente alla funzione HYPERLINK da Dynamics.
Apre una Anveo Page con il contenuto dell’URL specificato.
Apre una Anveo Page con il contenuto dell’URL specificato che consente un URL molto più lungo della funzione OpenURLExtended (per maggiori informazioni, clicca qui).
Apre una pagina web che mostra una mappa Google-maps all’indirizzo specificato. Per un esempio vedere il codice azione CONTACT:OPENGM nell’codeunit
ACF Events Sales & Marketing
Apre una Anveo Page specifica nel client web.
Apre una Anveo Page specifica nel client web per l’inserimento di un nuovo record. Una volta che la Anveo Page è aperta, il record viene creato.
Chiude la Anveo Page corrente nel client web.
Crea un nuovo record nella Anveo Page corrente. Questa funzione equivale all’azione NEW_RECORD() dell’codeunit ACF Events (vedi più informazioniqui).
Ricarica la Anveo Page corrente nel client web.
Ricarica tutte le Anveo Pages aperte che si riferiscono alla tabella con il numero indicato. Il secondo parametro di questa funzione definisce il campo di applicazione: 0 = all card, 1 = all lists, 2 = all cards and lists.
Apre una finestra di dialogo per il download di file o per la visualizzazione diretta di documenti PDF, a condizione che sia installato un appropriato plug-in per il browser.
Apre una finestra di dialogo per il download di file, indipendentemente dal fatto che possa essere visualizzato direttamente nel plugin del browser o meno.
Apre una finestra di dialogo per caricare i file. Il primo parametro della funzione restituisce il nome del file (senza percorso), dove è stato memorizzato il file caricato. Il file si trova dopo il caricamento nella directory di trasferimento dell’Anveo Client Suite come configurato nell’Anveo Setup nel campo Web Service File Transfer Folder.
Restituisce l’ID della sessione corrente dell’utente Anveo.
Restituisce il codice Anveo User o la variabile globale USERID di Dynamics a seconda del codice C/AL che è stato chiamato da Anveo Client Suite o da Dynamics.
Restituisce il codice Anveo User, a condizione che venga richiamato all’interno di Anveo Client Suite. Altrimenti viene restituito un valore vuoto.
Restituisce se il codice C/AL viene richiamato dall’Anveo Client Framework in modo che possano essere messi in atto diversi tipi di comportamento. Comparabile a ISSERVICETIER o GUIALLOWLOWED in Dynamics.
Restituisce se il codice C/AL viene richiamato dall’Anveo Mobile App in modo che possano essere messi in atto diversi tipi di comportamento. Comparabile a ISSERVICETIER o GUIALLOWLOWED in Dynamics.
Scrive una voce di registro per una determinata funzione insieme a un testo di accompagnamento. È possibile eseguire il debug del codice C/AL utilizzando il protocollo attivato di tutti gli ingressi utente.
Poiché xRec non è disponibile ovunque (vedi qui), è possibile impostarlo utilizzando la funzione SetxRec. L’impostazione xRec ha già luogo nell’codeunit ACF Events.
Poiché xRec non è disponibile ovunque (vedi qui), è possibile ottenerlo utilizzando la funzione GetxRec. L’ottenimento di xRec avviene già nell’codeunit ACF Events.
Crea un file temporaneo sul server dove è in esecuzione il servizio web di Dynamics e restituisce il suo nome.
All’apertura delle Anveo Pages, la tabella sorgente e il codice di relazione vengono consegnati come parametro invece che come tabella di destinazione (come nel caso dello standard Dynamics). Poiché la tabella delle destinazioni si trova nella relazione specificata e tutti i filtri (compreso il filtro di sicurezza) vi sono impostati, le Anveo Pages devono essere aperte in questo modo per motivi di sicurezza.