# Creare azioneCreazione di azioni e tipi di dati con Creare azione

Creare azione è uno strumento che consente di creare:

- Un'azione per l'avvio di un'applicazione

- Uno o più tipi di dati per i file di dati di un'applicazione

- Azioni per aprire e stampare i file di dati di un'applicazione

Permette inoltre di creare azioni semplici che eseguano comandi del sistema operativo o script delle shell.

sag.dtcra.mkr.2
sag.dtcra.mkr.3
sag.dtcra.mkr.4

Per maggiori informazioni, vedere la pagina di spiegazioni `dtcreate(1X)`.

## Funzioni di Creare azioni

Creare azioni comprende una finestra principale e un insieme di riquadri di dialogo con cui creare le azioni e i tipi di dati associati.

Creare azioni opera come segue:

- Crea la definizione di un'azione che esegue un comando.

- Crea un file di nome DirectoryIniziale`/.dt/types/`nome_azione`.dt`, in cui memorizza le definizioni delle azioni e dei tipi di dati create per l'applicazione.

- Crea un
  file dell'azione nella directory iniziale dell'utente. Il file dell'azione è un eseguibile con lo stesso
  nome dell'azione.

  La rappresentazione del file dell'azione nella Gestione di file viene detta
  icona dell'applicazione, poiché facendovi doppio clic viene avviata l'applicazione.

  Opzionalmente, è possibile rendere l'icona dell'azione una zona di rilascio, specificando nella sua definizione uno o più tipi di dati che supportano la funzione di trascinamento e rilascio.

- Crea uno o più tipi di dati per i file creati dall'applicazione (opzionale).

- Crea un'azione Aprire per ciascun tipo di dati.

- Crea un'azione Stampare per ciascun tipo di dati (opzionale).

- Ricarica il database delle azioni e dei tipi di dati. In questo modo, le definizioni delle azioni e dei tipi di dati hanno effetto immediatamente.

## Limitazioni di Creare azione

Creare azione permette essenzialmente di creare azioni e tipi di dati per l'avvio delle applicazioni. Oltre a queste funzioni base, le azioni e i tipi di dati possono includere molte altre funzionalità, che tuttavia possono essere implementate solo creando le definizioni manualmente.

Per maggiori informazioni, vedere:

- sag.cract.mkr.1

- sag.crdt.mkr.1

### Limitazioni relative alle azioni

Creare azione non può essere usato per creare l'azione di avvio di un'applicazione quando si verificano una o più delle seguenti condizioni:

- La riga comandi richiede un argomento
  diverso da un file (parametro).

  Ad esempio, non si potrà usare Creare azione per scrivere un'azione che esegua il comando:

       lp -ddispositivo nomefile

  dove l'utente deve specificare il dispositivo ad ogni esecuzione del comando.

- L'icona dell'applicazione deve avere un'etichetta differente dal nome dell'azione.

  Ad esempio, non si potrà usare Creare azione per creare una versione in lingua locale di un'azione esistente.

- L'azione richiede una delle funzioni avanzate del database delle azioni.

  Si definiscono funzioni avanzate le azioni che:

  - Avviano comandi su sistemi remoti rispetto alla definizione dell'azione

  - Richiamano altre azioni

  - Devono essere eseguite con un nome utente diverso (ad esempio come superutente)

  - Fanno largo uso della funzione di “mappatura”

  - Si comportano in modi diversi a seconda del numero di file specificati come argomenti

###
Limitazioni relative ai tipi di dati

Creare azione non può essere usato per creare il tipo di dati per i file di un'applicazione quando si verificano una o più delle seguenti condizioni:

- Il tipo di dati deve essere associato ad altre azioni oltre ad Aprire e Stampare.

- L'azione Aprire per il tipo di dati non coincide con il comando dell'azione.

  Ad esempio, Creare azione non potrà essere usato per creare un tipo di dati che assegni un'icona unica alla directory che rappresenta il gruppo di applicazioni di una determinata applicazione.

## Creazione di un'azione e di un tipo di dati per un'applicazione con Creare azione

Prima di avviare Creare azione è necessario procurarsi le seguenti informazioni sull'applicazione.

- La riga comandi richiesta per l'avvio dell'applicazione.

  Occorrerà sapere se la riga comandi richiede o meno l'indicazione di un file come argomento, e se tale argomento è necessario o opzionale.

  Se l'applicazione richiede un argomento diverso da un file, l'azione non potrà essere creata usando Creare azione.

- I tipi di dati che l'applicazione può accettare.

  Alcune applicazioni accettano un solo tipo di dati, mentre altre (ad esempio gli editor di testo ASCII o gli editor grafici) possono accettare dati di diversi tipi.

- Il modo in cui l'applicazione identifica i suoi file di dati.

  Il metodo di identificazione può essere basato sul nome (ad esempio sulla presenza del suffisso `.doc`) e/o sul contenuto del file. Se l'applicazione non usa un metodo basato sul nome del file, sarà possibile definire una convenzione per l'icona dell'azione.

- Opzionalmente: La riga comandi richiesta per la stampa dei file

### Come creare un'azione per un'applicazione

1. Fare doppio clic
   su Creare azione nel gruppo di applicazioni Strumenti_desktop.

   #### L'icona di Creare azione nella Gestione di applicazioni

   Verrà aperta la finestra principale di Creare azione.

   #### La finestra principale di Creare azione

2. Inserire il nome da assegnare all'icona dell'azione nel campo di testo
   “Nome dell'azione”.

3. Usare i controlli
   della sezione “Icone dell'azione” per specificare l'icona da associare all'applicazione. Inizialmente comparirà l'icona predefinita.

   - Per selezionare un'altra icona esistente, fare clic su “Ricercare icone” per aprire il riquadro di dialogo per la ricerca. Vedere sag.dtcra.mkr.7.

   - Per creare una nuova icona, scegliere “Editare icona” per avviare l'Editor delle icone.

4. Nel campo di testo “Comando da eseguire al doppio clic sull'icona”, digitare il comando richiesto per l'avvio dell'applicazione.

   Usare la sintassi `$`n per specificare l'uso di un file come argomento; ad esempio:

   `emacs`

   `bitmap $1`

   `diff $1 $2`

   `lp -oraw $1`

   Se la riga comandi include un argomento `$`n, l'icona dell'azione fungerà da zona di rilascio per i file.

   Nell'impostazione predefinita, le righe comandi non vengono inviate a una shell. Gli esempi seguenti mostrano due righe comandi personalizzate in cui viene specificato l'uso di una shell:

   `/bin/sh -c 'ps | lp'`

   `/bin/sh -c 'spell $1 | more'`

5. Digitare il testo di aiuto relativo all'icona dell'azione nel campo “Testo di aiuto per l'azione”.

   Il testo digitato andrà a capo automaticamente. Tuttavia, questi ritorni a capo non saranno mantenuti nella visualizzazione dell'aiuto online. Per specificare un ritorno a capo forzato, usare la sintassi ``.

6. Scegliere il tipo di finestra da usare per l'azione dal menu “Tipo di finestra”.

   Grafica (finestra X) | L'applicazione verrà avviata in una propria finestra
   Terminale (chiusura automatica) | L'applicazione verrà eseguita in una finestra di emulazione di terminale che si chiuderà automaticamente all'uscita dall'applicazione
   Terminale (chiusura manuale) | L'applicazione verrà eseguita in una finestra di emulazione di terminale che resterà aperta fino a un comando di chiusura esplicito
   Nessun output | L'applicazione non produrrà alcun output sul video

7. Procedere come segue:

   - Se l'applicazione possiede file di dati, e si desidera creare uno o più tipi di dati per questi file, vedere la sezione seguente sag.dtcra.mkr.6.

   - Se non si desidera creare uno speciale tipo di dati, salvare l'azione scegliendo Salvare dal menu File. Provare quindi la nuova azione facendo doppio clic sulla sua icona nella propria directory iniziale.

### Come creare uno o più tipi di dati per un'applicazione

1. Definire l'azione per l'applicazione seguendo la procedura descritta in sag.dtcra.mkr.5.

2. Fare clic sul pulsante “Funzioni avanzate” per espandere la finestra di Creare azione.

   #### La sezione “Funzioni avanzate” nella finestra principale di Creare azione

3. Se si desidera che, facendo doppio clic sull'icona, venga richiesto il nome di un file, digitare il testo della richiesta nel campo “All'avvio dell'azione, chiedere all'utente”.

   Per l'uso di questo campo, attenersi ai seguenti criteri:

   - Il campo deve essere usato se la riga comandi richiede obbligatoriamente l'indicazione di un file come argomento.

   - Il campo deve essere lasciato vuoto se la riga comandi non richiede l'indicazione di un file.

   - Se l'indicazione di un file come argomento è opzionale, si potrà scegliere se specificare o meno un testo per la richiesta. Nel primo caso, facendo doppio clic sull'icona dell'azione comparirà la richiesta del file. Nel secondo caso, l'azione verrà eseguita usando come argomento una stringa vuota.

4. Specificare i tipi di file che l'azione potrà accettare come argomenti:

   - Se l'azione accetta qualsiasi tipo di dati, selezionare “Tutti i tipi di dati”.

   - Se l'azione può accettare solo i tipi di dati creati per l'applicazione, selezionare “Solo i tipi nella lista”.

     Inizialmente, la lista
     “Tipi di dati che utilizzano l'azione” sarà vuota. Essa verrà riempita con i tipi di dati creati dall'utente per l'applicazione.

5. Fare clic sul pulsante Aggiungere vicino alla lista per aprire il riquadro di dialogo “Aggiunta di un tipo di dati”.

   #### Riquadro di dialogo “Aggiunta di un tipo di dati” di Creare azione

6. Opzionalmente: Se non si desidera usare il nome predefinito per il tipo di dati, digitare un nuovo nome nel campo
   “Nome del tipo di dati”.

   Il nome non può includere spazi vuoti. Il nome del tipo di dati non sarà visibile agli utenti dell'applicazione; esso sarà usato nel database delle azioni e dei tipi di dati per identificare la definizione di quel tipo di dati.

7. Fare clic sul pulsante Editare vicino al riquadro “Caratteristiche di identificazione” per aprire il riquadro di dialogo per la modifica delle caratteristiche
   .

   #### Riquadro di dialogo “Caratteristiche di identificazione” di Creare azione

   Le caratteristiche di un tipo di dati sono i criteri usati per distinguere quel tipo di dati dagli altri. Si possono scegliere uno o più dei seguenti criteri:

   File o Cartelle | Il tipo di dati sar&agrave; applicable solo ai file o solo alle cartelle
   Schema del nome | L'identificazione del tipo di date sar&agrave; basata sul nome del file
   Autorizzazioni | Autorizzazzione di lettura, scrittura ed esecuzione
   Contenuto | Contenuto dei una determinata porzione del file

8. Sceglie se il tipo di dati dovra rappresentare un file o una cartella

   #### Selezione della caratteristica File o Cartelle per un tipo di dati.

9. Se l'identificazione del tipo di dati è basata sul nome del file, selezionare la casella “Schema del nome” e specificare lo schema nel campo di testo.

   #### Indicazione del nome per l'identificazione del tipo di dati

   Si possono usare i caratteri speciali * e ?:

   `*` | Corrisponde a qualunque sequenza di caratteri
   `?` | Corrisponde a qualunque carattere singolo

10. Se l'identificatione del tipo di dati e basata sul nome del file, selezionare la casella “Schema del nome” e spezificare lo schema nel campo di testo.

    #### Indicazione delle autorizzazioni di identificazione per un tipo di dati

    Sì | Il file deve possedere le autorizzazioni specificate
    No | Il file non deve possedere le autorizzazioni specificate
    Opzionale | Le autorizzazioni specificate sono irrilevanti

11. Se l'identificazione del tipodi dati e basata sul contenuto del file, selezionare la casella Contenuto e inserire le informazioni richieste — lo Schema da ricercare e il Tipo di contenuto. Opzionalmente, si potra spezificare il byte da cui iniziare la ricerca.

    #### Indicazione del contenuto di identificazione per un tipo di dati

    L'identificazione del tipo di dati basata sul contenuto può rallentare le prestazioni del sistema.

12. Fare clic su OK per chiudere il riquadro di dialogo “Caratteristiche di identificazione”.

    Le caratteristiche specificate verranno visualizzate nel campo
    “Caratteristiche di identificazione” nella forma seguente:

    d | Directory
    r | Il file possiede l'autorizzazione di lettura
    w | Il file possiede l'autorizzazione di scrittura
    x | Il file possiede l'autorizzazione di esecuzione
    ! | Operatore logico NOT
    & | Operatore logico AND

13. Nel campo “Testo di aiuto per il tipo di dati”, digitare le informazioni di aiuto appropriate per i file di dati del tipo specificato.

14. Usare i controlli della sezione “Icone del tipo di dati” per specificare l'icona da associare all'applicazione. Inizialmente comparirà l'icona predefinita.

    - Per selezionare un'altra icona esistente, fare clic su “Ricercare icone” per aprire il riquadro di dialogo per la ricerca. Vedere sag.dtcra.mkr.7.

    - Per creare una nuova icona, fare clic su “Editare icona” per avviare l'Editor delle icone.

15. Verificare il comando nel campo “Comando di apertura per il tipo di dati”. Questo è il comando che verrà eseguito facendo doppio clic su un file di dati del tipo specificato.

16. Opzionalmente: Se l'applicazione dispone di un comando per la stampa dei file di dati dalla riga comandi, digitare questo comando nel campo “Comando di stampa per il tipo di dati”, usando la sintassi `$`n per l'uso di un file come argomento.

17. Salvare la definizione del tipo di dati in uno dei modi seguenti:

    - Fare clic su OK per salvare il tipo di dati e chiudere il riquadro di dialogo “Aggiunta di un tipo di dati”.

    - Fare clic su Applicare per salvare il tipo di dati senza chiudere il riquadro di dialogo. In questo modo si potrà procedere direttamente alla definizione di un altro tipo di dati per l'azione.

### Uso del riquadro di dialogo per la ricerca delle icone

Il riquadro di dialogo “Ricerca di un set di icone” viene visualizzato facendo clic su “Ricercare icone” dalla finestra principale di Creare azione o dalla finestra “Aggiunta di un tipo di dati”. Esso permette di specificare l'icona da usare per l'azione o il tipo di dati definito.

#### Riquadro di dialogo “Ricerca di un set di icone”

Saranno disponibili per la selezione i set di icone che si trovano:

- In una directory del percorso di ricerca delle icone. La lista “Cartelle con icone” mostra tutte le directory incluse nel percorso di ricerca.

- In un pacchetto di registrazione che verrà integrato nel desktop usando `dtappintegrate`. Queste icone non si trovano ancora in una directory del percorso di ricerca delle icone, ma vi saranno incluse con l'esecuzione di `dtappintegrate`.

Le definizioni delle azioni e dei tipi di dati create con Creare azione indicheranno il nome base dei file delle icone (il nome del file esclusi i suffissi per tipo e dimensione). Le icone delle azioni e dei tipi di dati create con Creare azione dovranno essere collocate in una directory del percorso di ricerca.

#### Come specificare un set di icone situato nel percorso di ricerca

1. Nella lista “Cartelle delle icone” del riquadro di dialogo “Ricerca di un set di icone”, fare doppio clic sul percorso della directory in cui si trova l'icona.

   L'elenco “File delle icone” mostrerà tutti i file di quella cartella che contengono l'immagine di un'icona.

2. Nella lista “File delle icone”, fare clic sull'icona da selezionare.

   Il nome base del file verrà inserito nel campo “Nome del file dell'icona”.

3. Fare clic su OK.

#### Come specificare un'icona inclusa in un pacchetto di registrazione

Quando si crea un pacchetto di registrazione, i file grafici che contengono le icone si trovano inizialmente nella seguente directory del pacchetto:

radice_app`/dt/appconfig/icons/`lingua

Dopo la registrazione con `dtappintegrate`, i file delle icone vengono copiati nella directory `/etc/dt/appconfig/icons/`lingua, che è inclusa nel percorso di ricerca delle icone.

Per specificare le icone da includere in un pacchetto di registrazione, procedere come segue:

1. Nel campo “Nome del file dell'icona” del riquadro di dialogo “Ricerca di un set di icone”, inserire il nome base del file che contiene l'icona desiderata.

2. Fare clic su OK.

   Creare azione visualizzerà un riquadro di dialogo indicante che le icone non si trovano in una directory inclusa nel percorso di ricerca delle icone.

3. Nel riquadro di informazione, scegliere OK.