Integrare l'applicazione con un software di terze parti

Permessi Richiesti

Questa sezione richiede il permesso Application Designer dal tuo amministratore di Dominio.

Consulta Quali sono i compiti di Design? per saperne di più riguardo ai permessi per lavorare con il Design Mode e altri strumenti.

Impara come creare una Custom Action che permette a un'applicazione di interagire con un software di terze parti tramite API.

Question

L'API di un software è un sistema intermediario che abilita la comunicazione fra due software per scambiare darti o richiedere l'esecuzione di un'operazione.

Note

Questo documento spiega solo come configurare una Custom Action di tipo Invoke API Remote in eLegere. _Ciascun software ha la propria API che differisce dalle altre. Verifica la documentazione del software di terze parti per imparare come funziona la sua API.

Se non sei uno sviluppatore, consultati col tuo amministratore per i valori dei parametri da inserire nella Custom Action.

  1. In Design Mode, cliccare sull'icona nell'angolo in alto a destra di qualunque pannello.

    L'azione porta al pannello Custom Actions.

  2. Cliccare sull'interruttore Enable Module per attivare le Custom Action nella tua applicazione.

  3. Cliccare sul menù a tendina New Action.

  4. Scegliere il tipo Invoke API Remote dalla lista dei tipi di Custom Action. L'azione crea una Custom Action Invoke AWS Lambda.

    Quest'azione crea la Custom Action Invoke API Remote da configurare.

  5. Inserire nella sezione Info le informazioni richieste.

    • (1) Name Inserire un nome per la Custom Action Invoke AWS Lambda.
    • (2) Description opzionale Inserire una descrizione per la Custom Action Invoke API Remote.
    • (3) Manual Se abilitato, gli utenti lanciano questa Custom Action manualmente. Se disabilitata, scegli a (4) Event una condizione d'innesco per lanciare la Custom Action. (L'interruttore è abilitato in maniera predefinita.)
    • (4) Event Se (3) Manual è disabilitato, scegli una delle condizioni di innesco dal menù a tendina.
    Event - Condizioni di innesco

    Per le opzioni Event, quando l'interruttore Manual è disabilitato, scegli un momento in cui la Custom Action deve avviarsi.

    PRE ROW INSERT Prima dell'inserimento della riga.

    POST ROW INSERT Dopo l'inserimento della riga

    PRE ROW UPDATE Prima che si applichi un qualunque cambiamento alla riga.

    POST ROW UPDATE Dopo aver modificato la riga.

    PRE ROW DELETE Prima della cancellazione della riga.

    POST ROW DELETE Dopo aver cancellato la riga.

    PRE ATTACHMENT INSERT Prima di caricare un allegato su una riga.

    POST ATTACHMENT INSERT Dopo aver caricato un allegato su una riga.

    POST MASTER INSERT Dopo aver inserito una riga sulla tabella di Master.

    POST MASTER UPDATE Dopo aver modificato un riga della tabella di Master.

    POST MASTER DELETE Dopo aver cancellato una riga dalla tabella di Master.

    • (5) Async Abilita l'esecuzione della Custom Action in background invece di attendere per il suo completamento per usare l'applicazione. (L'interruttore Async è abilitato in modo predefinito quando (3) Manual è abilitato. Altrimenti, l'interruttore è disabilitato.)
    • (6) Execution opzionale Click to open the Formula Editor. Inserisci una Formula per definire le condizioni per eseguire la Custom Action.
    • (7) Visibility opzionale Clicca per aprire il Formula Editor. Inserisci una Formula per definire le condizioni per mostrare la Custom Action nell'applicazione.
    • (8) Refresh opzionale Se abilitata, l'applicazione aggiorna i dati in tabella quando la Custom Action finisce l'esecuzione.
    • (9) Icon opzionale Scegli un'icona per la Custom Action.
    • (10) Context Specifica se la Custom Action si lancia dal menù a tendina Custom Actions nell'applicazione o dalle opzioni della riga (). Disabilitato se (3) Manual è disabilitato.
    • (11) Table Decidi su quale tabella la Custom Action deve essere eseguita.

  6. Nella sezione Parametri, scegli le impostazioni per la Invoke AWS Lambda.

    Note

    I valori dei parametri dipendono dall'API dello specifico software di terze parti. Controlla la sua documentazione o contatta il tuo amministratore per recuperare i valori di cui hai bisogno.

    • (1) L'URL per la richiesta HTTP che innesca l'azione dall'API.
    • (2) Il metodo della richiesta: GET o POST.
    • (3) Se l'interruttore Use Context è abilitato, la Custom Action passerà il contesto della riga con i suoi valori alla richiesta.
    • (4) Fornire l'Authentication: tutte le chiavi e valori che l'API richiede per l'accesso. (Cliccare su New per definire un valore (value) e una chiave (key). Cliccare sul pulsante Reset per cancellare tutti i valori (value) e le chiavi (key) dalla sezione.)
    • (5) Fornisci gli Headers: tutte le chiavi e valori con i metadati richiesti per eseguire l'azione. (Cliccare su New per definire un valore (value) e una chiave (key). Cliccare sul pulsante Reset per cancellare tutti i valori (value) e le chiavi (key) dalla sezione.)
    • (6) Fornisci il Body: tutte le chiavi e valori richiesti per eseguire l'azione desiderata. (Cliccare su New per definire un valore (value) e una chiave (key). Cliccare sul pulsante Reset per cancellare tutti i valori (value) e le chiavi (key) dalla sezione.)

  7. Questo passaggio è opzionale Segui questo passaggio se vuoi bloccare l'uso di un'applicazione durante l'esecuzione della Custom Action Invoke Remote API.

    Nell'Application Lock, cliccare sull'interruttore Enabled per abilitare il blocco per quell'applicazione. (Enabled è disabilitato in modo predefinito.)

    Scegliere un'applicazione dal menù a tendina da bloccare durante l'esecuzione della Custom Action.

  8. Quando hai completato la configurazione, cliccare sul pulsante Save () nell'angolo in alto a sinistra per salvare la Custom Action Invoke AWS Lambda.

Success

Hai configurato una funzione Azure come Custom Action nella tua applicazione.

Tip

Se vuoi disabilitare la Custom Action Invoke API Remote senza cancellarla dall'applicazione, clicca sull'interruttore accanto al nome della Custom Action per nasconderla dagli utenti.

Tip

Se vuoi cancellare una Custom Action Invoke API Remote, clicca su Remove nella sezione Info.

Una finestra chiederà conferma. Clicca su Yes per confermare la cancellazione. (Clicca su No per annullare la cancellazione.)

Cliccare sul pulsante Save () nell'angolo in alto a sinistra per salvare la cancellazione.