Script

Suggerimento: Per i tipi di dati Boolean e Null, consigliamo di importare JSON e utilizzare json.loads() per assicurarsi che i dati vengano caricati correttamente. Poiché tutti i dati del playbook sono in formato JSON e Python non supporta nativamente tutti i tipi di dati JSON.

Utilizzate l'azione nativa controllata dello Script e scrivete in Python per:

• manipolare dati e casi limite.
• ridurre la complessità utilizzando JSONata.
• utilizzare il linguaggio di programmazione più comune in sicurezza oggi per svolgere compiti semplici.

Durante la configurazione degli input, considerate l'uso del Chatbot Python, che utilizza ChatGPT's Open AI per aiutarvi a formulare trasformazioni e codice Python personalizzato.

Configurazione dell'azione nativa Script

È ora di iniziare la configurazione di base per l'azione nativa Script.

Avete già creato un playbook e siete pronti a manipolare i dati da una proprietà.

1. Dal vostro playbook, cliccate su Aggiungi un'azione.
2. Dal pannello AZIONE, cliccate sul menu a discesa Azione.
3. Selezionate Script e cliccate su Configura.

La finestra Script si apre.

La finestra Script ha tre schede: Script, Outputs e Test. La scheda Script ha il riquadro degli Input (sul lato sinistro) e il riquadro dello Script (sul lato destro).

Input dello Script

Con l'azione nativa Script, potete costruire e mappare input di dati statici e di proprietà del playbook per fare riferimento ai dati nello Script Python.

Le proprietà dei playbook che potete aggiungere sono:

• Stringa
• Numero
• Booleano
• Oggetto
• Array

Prima di poter effettuare il test, configurate i vostri input dello Script. Vediamo un rapido esempio su come configurare gli input e utilizzare il riquadro dello Script.

1. Dalla scheda Script, nel riquadro degli Input, cliccate su Aggiungi proprietà per definire gli input, inclusi eventuali sotto-input.
2. Cliccate sull'icona matita per modificare il nome della proprietà.
3. Scrivete il vostro codice nel pannello Script.

Test dello Script

Volete testare il vostro Script prima di continuare a costruire il playbook? Nell'azione Script, dalla scheda Test, potete ora vedere gli Input a sinistra e lo Script a destra.

Il riquadro Risultato nella parte inferiore mostra i risultati del test. I risultati variano, quindi oltre alla base dei tipi di proprietà, e a seconda degli input selezionati, gli output dell'azione possono restituire proprietà aggiuntive. Queste sono gli output scoperti, che potete promuovere e/o eliminare dalla scheda Outputs.

Allegato Script

Se avete bisogno di restituire un allegato o utilizzarlo come input nell'azione nativa Script, seguite le istruzioni seguenti:

Allegato in output

Nel vostro playbook, seguite le istruzioni seguenti per configurare un allegato in output:

1. Dal menu a discesa Azione, selezionate Script.

Chiamate questa azione Restituisci allegato e cliccate su Configura. Ci sono due modi per scrivere Python code per restituire un allegato. Vediamo entrambi!

1. Nella scheda Script, inserite il seguente codice:

```python
with action_inputs['file1'].open() as file1:
action_outputs['file1_text'] = file1.read()
action_outputs['file1_size'] = file1.size()
action_outputs['file1_mimetype'] = file1.mimetype()
action_outputs['file1_filename'] = file1.file_name

Potete ottenere la dimensione dell'allegato utilizzando il metodo .size(), e potete ottenere il tipo MIME dell'allegato utilizzando il metodo .mimetype(). Potete ottenere il nome dell'allegato utilizzando la proprietà .file_name. Tutto è mostrato nel codice sopra.

Potete anche scrivere il codice come segue:

pythonCopy code

file2 = action_inputs['file2'].open() action_outputs['file2_text'] = file2.read() file2.close()

1. Cliccate su Applica per salvare le modifiche.

Allegato in input

Potete utilizzare un allegato in input in uno script Python utilizzando un'azione nativa Script.

1. Dal menu a discesa Azione, selezionate Script.

Chiamate questa azione Allegato di input e cliccate su Configura.

1. Cliccate su Aggiungi proprietà e selezionate Allegato.

Cliccate sull'icona matita per modificare il nome. Ad esempio, potete cambiare il nome in file1.

1. Cliccate su Seleziona una proprietà e selezionate Proprietà del playbook.

Il cassetto delle proprietà del playbook si apre e in base all'esempio, selezionereste l'oggetto per first_file. Poi tornate a Inputs e ripetete i passaggi 4 e 5, ma aggiungete l'oggetto per second_file.

1. Nella scheda Script, inserite il seguente codice:

   pythonCopy code

   with action_inputs['file1'].open() as file1: action_outputs['file1_text'] = file1.read() action_outputs['file1_size'] = file1.size() action_outputs['file1_mimetype'] = file1.mimetype()

   Potete ottenere la dimensione dell'allegato utilizzando il metodo .size(), e potete ottenere il tipo MIME dell'allegato utilizzando il metodo .mimetype(). Entrambi sono mostrati nel codice sopra.

   Potete anche scrivere il codice come segue:

   pythonCopy code

   file2 = action_inputs['file2'].open() action_outputs['file2_text'] = file2.read() file2.close()

2. Cliccate su Applica per salvare le modifiche.

Ora entrambi i file sono mappati.