Come incorporare script Powershell nella 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 incastonare le Script Powershells nella tua applicazione eLegere come Custom Action.

Warning

Questa sezione presuppone che tu sappia cosa sia la shell Powershell e il relativo linguaggio di scripting.

Info

Questa sezione spiega solo come configurare una Custom Action Powershell Script, non i dettagli riguardo a come gli script Powershell funzionano in eLegere. Per maggiori informazioni su come lo scripting Powershell funziona in eLegere, consulta Script Powershell nella Guida Sviluppatore.

In certi scenari, il Designer deve eseguire alcune operazioni complesse che gli strumenti predefiniti di eLegere non coprono. In questi casi, i Designer possono configurare uno Script Powershell come Custom Action. Quando sono lanciate, le Custom Action Script Powershell eseguono operazioni sui dati di eLegere.

Segui i passi sotto per creare una Custom Action Script Powershell.

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

   

   Quest'azione crea la Custom Action Script Powershell da configurare.

   

5. Inserire nella sezione Info le informazioni richieste.

   

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

   

   • (1) Inserire il nome della Script Powershell sul database.
   • (2) Cliccare su New per definire un valore (value) e una chiave (key) nello Script Powershell.
   • (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 Script Powershell.

   

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

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

   

Success

Hai configurato una Script Powershell come Custom Action nella tua applicazione.

Tip

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

Tip

Se vuoi cancellare una Custom Action Script Powershell, 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.