Eseguire script Python dentro la tua applicazione

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 esegue il codice Python dentro la tua applicazione.

In alcuni scenari, il Designer deve eseguire delle operazioni complesse che gli strumenti predefiniti di eLegere non coprono. In questi casi, i Designer possono configurare uno script Python come Custom Action. Quando lanciata, una Custom Action Invoke Python Script esegue le operazioni che il Designer ha codifica in linguaggio Python.

Warning

L'amministratore della tua installazione eLegere decide se installare Python e abilitare le Custom Action Invoke Python Script. Verifica con il tuo amministratore se le Custom Action Invoke Python Script sono permesse sulla tua installazione corrente di eLegere.

In caso l'amministratore abbia abilitato le Custom Action Invoke Python Script, avrà preparato una cartella dedicata per conservare gli script da lanciare.

Se Python è abilitato, la versione del linguaggio Python dipende dalla versione che l'amministratore ha scelto di installare con eLegere.

Esiste la possiblità di eseguire un ambiente virtuale separato per Python nella tua installazione eLegere. Consulta il documento Configurare un ambiente virtuale per Python in eLegere per imparare come. È caldamente consigliato per evitare conflitti fra diversi insiemi di pacchetti.

Note

Questo documento assume la conoscenza del linguaggio di programmazione Python. Il documento spiega solo come configurare una Custom Action che esegue uno script Python dentro un'applicazione.

Segui i passi sotto per creare una Custom Action Invoke Python Script.

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 Python Script dalla lista dei tipi di Custom Action. L'azione crea una Custom Action Invoke Python Script.

   

   Quest'azione crea la Custom Action Invoke Python Script da configurare.

   

5. Inserire nella sezione Info le informazioni richieste.

   

   • (1) Name Inserire un nome per la Custom Action Invoke Python Script.
   • (2) Description opzionale Inserire una descrizione per la Custom Action Invoke Python Script.
   • (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 Python Script.

   

   • (1) Inserire il percorso al Python script nella cartella che l'amministratore ha preparato.
   • (2) Cliccare su New per definire un valore (value) e una chiave (key) nell'Invoke Python Script.
   • (3) Cliccare sul pulsante Reset per cancellare tutti i valori (value) e le chiavi (key) dalla sezione Parameters.

   Cliccare su New inserisce una coppia di valore (value) e chiave (key). Inserisci nella riga un chiave (key) e un valore (value) dall'applicazione da passare alla Invoke Python Script.

   

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

   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 Python Script.

   

Success

Hai configurato una Invoke Python Script come Custom Action nella tua applicazione.

Tip

Se vuoi disabilitare la Custom Action Invoke Python Script 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 Python Script, 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.