# Crear Acción Creación de acciones y de tipos de datos utilizando Crear Acción

Crear Acción es una herramienta para crear:

- Una acción para iniciar una aplicación

- Uno o más tipos de datos para los archivos de datos de una aplicación

- Acciones para abrir e imprimir los archivos de datos de la aplicación

Crear Acción también es útil para crear acciones simples para ejecutar mandatos del sistema operativo y scripts del shell.

SAG.dtCrA.mkr.2
SAG.dtCrA.mkr.3
SAG.dtCrA.mkr.4

Para obtener información de consulta, vea la página de manual `dtcreate(1X)`.

## Qué hace Crear Acción

Crear Acción incluye una ventana principal y un conjunto de cuadros de diálogo para crear una acción y los tipos de datos asociados.

Crear Acción realiza lo siguiente:

- Crea una definición de acción que ejecuta un mandato.

- Crea un archivo DirectorioInicio`/.dt/types/`nombre_acción`.dt.` Este archivo almacena las definiciones de acción y de tipo de datos creadas para la aplicación.

- Crea un
  archivo de acción en el directorio de inicio del usuario. El archivo de acción es un archivo ejecutable con el mismo
  nombre que la acción.

  La representación del archivo de acción en el Gestor de archivos se denomina
  icono de aplicación porque, si se pulsa dos veces, se inicia la aplicación.

  Opcionalmente se puede hacer que el icono de acción sea una zona de soltar, especificando, al crear la acción, tipos de datos que se puedan soltar.

- Crea uno o más tipos de datos para los archivos de datos de la aplicación (opcional).

- Crea una acción Abrir para cada tipo de datos.

- Crea una acción Imprimir para cada tipo de datos (opcional).

- Vuelve a cargar la base de datos de acciones y de tipos de datos. Esto hace que las acciones y los tipos de datos entren en vigor inmediatamente.

## Limitaciones de Crear Acción

Crear Acción está diseñado para crear acciones y tipos de datos para ejecutar aplicaciones. Sin embargo, las acciones y los tipos de datos son muy flexibles e incluyen funciones adicionales a las que sólo se puede acceder si se crean las definiciones manualmente.

Para obtener más información, consulte:

- El SAG.CrAct.mkr.1”

- El SAG.CrDT.mkr.1

### Limitaciones de las acciones

Crear Acción no se puede utilizar para crear la acción para una aplicación si no se cumple ninguna de las siguientes condiciones:

- La línea de mandatos necesita un
  argumento (parámetro) que no sea de archivo.

  Por ejemplo, Crear Acción no se puede utilizar para escribir una acción para el mandato:

`lp -ddispositivo nombre de archivo`

donde el usuario tiene que proporcionar dispositivo cada vez que se ejecuta el mandato.

- El icono de aplicación debe tener una etiqueta diferente del nombre de acción.

  Por ejemplo, no se puede utilizar Crear Acción para proporcionar una versión en idioma local de una acción existente.

- La acción necesita cualquiera de las características avanzadas de la base de datos de acciones.

  Son ejemplos de estas características avanzadas acciones que:

  - Ejecutan mandatos en sistemas ajenos a la definición de acción

  - Invocan otras acciones

  - Deben ejecutarse como si se tratara de un usuario diferente (por ejemplo, como superusuario)

  - Utilizan con frecuencia la característica de ''establecer correspondencia''

  - Tienen comportamientos muy diferentes, en función del número de argumentos de archivo proporcionados a la acción

###
Limitaciones de los tipos de datos

Crear Acción no se puede utilizar para crear el tipo de datos para una aplicación si no se cumple ninguna de las siguientes condiciones:

- El tipo de datos deben tener acciones adicionales asociadas a él distintas de Abrir e Imprimir.

- La acción Abrir para el tipo de datos no es el mandato de la acción.

  Por ejemplo, no se puede utilizar Crear Acción para crear el tipo de datos que proporciona un icono exclusivo para el directorio que representa el grupo de aplicaciones de la aplicación.

## Creación de una acción y de un tipo de datos para una aplicación con Crear Acción

Existen algunos aspectos relacionados con la aplicación que debe conocer antes de ejecutar Crear Acción.

- La línea de mandatos para iniciar la aplicación.

  Deberá saber si la línea de mandatos incluye un argumento de archivo necesario, un argumento de archivo opcional o no incluye ningún argumento de archivo.

  Si la aplicación necesita un argumento que no sea de archivo, no podrá utilizar Crear Acción para crear la acción.

- Los tipos de archivos de datos que puede aceptar una aplicación.

  Algunas aplicaciones sólo pueden aceptar un tipo de datos. Otras (por ejemplo, un editor ASCII o un editor de gráficos) pueden aceptar varios tipos de datos.

- El modo en que la aplicación identifica sus archivos de datos.

  Esto puede ser un convenio de denominación (por ejemplo, nombres de archivo que terminen por`.doc`), y/o puede depender del contenido del archivo. Si la aplicación no utiliza ningún convenio de nombres de archivo, puede definir uno para el icono de acción.

- Opcional: La línea de mandatos para imprimir los archivos

### Crear una acción para una aplicación

1. Pulse dos veces
   Crear Acción en el grupo de aplicaciones Apls_Escritorio.

   #### Icono de Crear Acción del Gestor de aplicaciones

   Se muestra la ventana principal Crear Acción.

   #### Ventana principal Crear Acción

2. Escriba el nombre que etiquetará el icono de acción en el
   campo de texto Nombre de Acción.

3. Utilice los
   controles Iconos de Acción para especificar el icono para la aplicación. Inicialmente se muestra el icono predeterminado.

   - Para elegir un icono existente diferente, pulse Buscar Conjunto para mostrar el cuadro de diálogo Buscar Conjunto. Consulte la sección sag.dtcra.mkr.7.

   - Para crear iconos nuevos, elija Editar Icono para ejecutar el Editor de iconos.

4. En el campo de texto Mandato cuando se abra la acción, escriba el mandato para iniciar la aplicación.

   Utilice la sintaxis `$`n para un argumento de archivo; por ejemplo:

       emacs
       bitmap $1
       diff $1 $2
       lp -oraw $1

   Si la línea de mandatos incluye un argumento de archivo (`$`n), el icono de acción será una zona de soltar para los archivos.

   Las líneas de mandatos no se pasan a un shell a no ser que se especifique explícitamente el uso de un shell. Por ejemplo, estas líneas utilizan el proceso de shell:

       /bin/sh -c 'ps | lp'
       /bin/sh -c 'spell $1 | more'

5. Escriba el texto de ayuda sobre el tema para el icono de acción en el campo de texto “Texto de Ayuda para Icono de Acción”.

   El texto se acomodará automáticamente en el campo de texto. Sin embargo, las divisiones de línea no se conservan en línea. Si desea especificar una división de línea forzada, utilice ``.

6. Elija el soporte de ventanas necesario para la acción en el menú de opciones Tipo de ventana.

   Gráfica (Ventana de X) | La aplicación crea su propia ventana
   Terminal (Cierre automático) | La aplicación se ejecutará en una ventana de emulador de terminal que se cerrará automáticamente cuando el usuario salga de la aplicación
   Terminal (Cierre manual) | La aplicación se ejecutará en una ventana de emulador de terminal que permanecerá abierta hasta que el usuario la cierre explícitamente
   Sin Salida | La aplicación no produce salida en la pantalla

7. Proceda del siguiente modo:

   - Si la aplicación tiene archivos de datos y desea crear uno o más tipos de datos para ellos, consulte la siguiente sección, sag.dtcra.mkr.6.

   - Si no necesita crear un tipo de datos, guarde la acción eligiendo Guardar en el menú Archivo. A continuación, pruebe la nueva acción pulsando dos veces su icono en el directorio de inicio.

### Crear uno o más tipos de datos para una aplicación

1. Defina la acción para la aplicación utilizando el procedimiento de la sección anterior, sag.dtcra.mkr.5.

2. Pulse el botón Avanzada en la ventana Crear Acción para ampliar la ventana.

   #### Características avanzadas de la ventana principal Crear Acción

3. Si desea que el icono de aplicación solicite un argumento de archivo cuando se pulsa dos veces el icono, escriba el texto del indicador de solicitud en el campo de texto ''Cuando se abra la acción, solicitar a los usuarios''.

   Utilice estas directrices para este campo de texto:

   - Debe utilizar este campo si la línea de mandatos de la aplicación tiene un argumento de archivo necesario.

   - Debe dejar en blanco este campo si la línea de mandatos no incluye ningún argumento de archivo.

   - Si el argumento de archivo de la línea de mandatos de la aplicación es opcional, tiene dos posibilidades. Si proporciona el texto del indicador de solicitud, el icono de acción solicitará el archivo cuando se pulse dos veces. Si no proporciona el texto del indicador de solicitud, la acción se ejecutará con una cadena nula como argumento de archivo.

4. Especifique los tipos de archivos que la acción aceptará como argumentos:

   - Si la acción puede aceptar cualquier tipo de datos, seleccione Todos los tipos de datos.

   - Si la acción sólo puede aceptar los tipos de datos creados para la aplicación, seleccione Sólo la lista anterior.

     Inicialmente, la
     lista Tipos de datos que usan esta acción estará vacía. A medida que vaya creando tipos de datos para la aplicación, éstos se añadirán a la lista.

5. Pulse Añadir, que se encuentra junto al cuadro de lista “Tipos de datos que usan esta acción” para mostrar el cuadro de diálogo Añadir Tipo de Datos.

   #### Cuadro de diálogo Añadir Tipo de Datos de Crear Acción

6. Opcional: Si no desea utilizar el nombre de tipo de datos predeterminado, escriba un nuevo nombre para el tipo de datos en el
   campo de texto Nombre de la Familia de Tipos de Datos.

   El nombre no puede incluir espacios. Los usuarios de la aplicación no ven el nombre del tipo de datos; éste se utiliza en la base de datos de acciones o tipos de datos para identificar la definición del tipo de datos.

7. Pulse el botón Editar situado junto al
   cuadro Características de Identificación para mostrar el cuadro de diálogo Características de Identificación.

   #### Cuadro de diálogo Características de Identificación de Crear Acciones

   Las características de un tipo de datos son los criterios utilizados para diferenciar el tipo de datos de los demás. Puede elegir uno o más de los siguientes criterios:

   Archivos o Carpetas | El tipo de datos se aplica sólo a archivos o sólo a carpetas
   Patrón de nombre | Tipos de datos basados en el nombre de archivo
   Patrón de Permiso | Permisos de lectura, escritura y ejecución
   Contenido | Contenido de una parte especificada del archivo

8. Seleccione si el tipo de datos representa un archivo o una carpeta.

   #### Especificación de una característica de archivo o de directorio para un tipo de datos.

9. Si el tipo de datos depende del nombre, seleccione la casilla de verificación Patrón de Nombre y rellene el campo de texto.

   #### Especificación de la característica de nombre de archivo para un tipo de datos

   Se puede utilizar * y ? como caracteres comodín:

   * | Coincide con cualquier secuencia de caracteres
   ? | Coincide con cualquier carácter individual

10. Si el tipo de datos depende de los permisos, seleccione la casilla de verificación Patrón de Permiso y seleccione los permisos para el tipo de datos.

    #### Especificación de las características de permiso para un tipo de datos

    Activar | El archivo debe tener el permiso especificado
    Desactivar | El archivo debe carecer del permiso especificado
    Cualquiera | No importa el permiso especificado

11. Si el tipo de datos depende del contenido, seleccione la casilla de verificación Contenido y proporcione la información solicitada: Patrón a buscar y Tipo de contenido. Opcionalmente puede proporcionar la ubicación del byte en la que debe iniciarse la busqueda.

    #### Especificación de las características del contenido para un tipo de datos

    La utilización de tipo de datos basado en el contenido puede afectar al rendimiento del sistema.

12. Pulse OK para cerrar el cuadro de diálogo Características de Identificación.

    Las características se mostrarán en el
    campo Características de Identificación utilizando esta codificación:

    d | Un directorio
    r | El archivo tiene permiso de lectura
    w | El archivo tiene permiso de escritura
    x | El archivo tiene permiso de ejecución
    ! | Operador lógico NOT
    & | Operador lógico AND

13. Escriba el texto de ayuda para los archivos de datos en el campo de texto Texto de Ayuda.

14. Utilice los controles Iconos de Tipo de Datos para especificar el icono para la aplicación. Inicialmente se muestra el icono predeterminado.

    - Para elegir un icono existente diferente, pulse Buscar conjunto para mostrar el cuadro de diálogo Buscar Conjunto. Consulte la sección sag.dtcra.mkr.7.

    - Para crear iconos nuevos, pulse Editar Icono para ejecutar el Editor de iconos.

15. Verifique el mandato del campo de texto Mandato para Abrir este Tipo de Datos. Éste es el mandato que se ejecutará cuando el usuario pulse dos veces un archivo de datos.

16. Opcional: Si la aplicación proporciona un mandato de impresión para imprimir archivos de datos desde la línea de mandatos, escriba el mandato en el campo de texto Mandato para Imprimir este Tipo de Datos, utilizando la sintaxis `$`n para un argumento de archivo.

17. Para guardar la definición del tipo de datos, realice una de estas acciones:

    - Pulse OK para guardar el tipo de datos y cerrar el cuadro de diálogo Añadir Tipo de Datos.

    - Pulse Aplicar para guardar el tipo de datos sin cerrar el cuadro de diálogo Añadir Tipo de Datos. Esto le permite continuar definiendo inmediatamente otro tipo de datos para la acción.

### Utilización del cuadro de diálogo Buscar Conjunto para especificar un
icono

El cuadro de diálogo Buscar conjunto se muestra al pulsar Buscar conjunto en la ventana principal Crear Acciones o en la ventana Añadir Tipo de Datos. Utilice el cuadro de diálogo para especificar el icono que se utilizará para la acción o el tipo de datos.

#### Cuadro de diálogo Buscar Conjunto

El cuadro de diálogo Buscar Conjunto le permite especificar un conjunto de archivos de imágenes de iconos ubicados:

- En un directorio de la ruta de búsqueda de iconos. La lista Carpetas de Iconos incluye todos los directorios de la ruta de búsqueda de iconos.

- En un paquete de registro que se integrará con el escritorio utilizando `dtappintegrate`. Estos iconos todavía no están ubicados en un directorio de la ruta de búsqueda de iconos, pero `dtappintegrate` los colocará allí.

Las definiciones de acciones y de tipos de datos creadas utilizando Crear Acción escriben el nombre base de los archivos de iconos (el nombre de archivo menos los sufijos de nombre de archivo para el tamaño y el tipo). Los iconos para las acciones y los tipos de datos creados con Crear Acción deben ponerse finalmente en directorios de la ruta de búsqueda de iconos.

#### Especificar un conjunto de iconos ubicados en la ruta de búsqueda de iconos

1. En la lista Carpetas de Iconos del cuadro de diálogo Buscar Conjunto, pulse dos veces la ruta de carpeta que contiene el icono.

   La lista Archivos de Iconos mostrará todos los archivos de iconos de dicha carpeta.

2. En la lista Archivos de Iconos, pulse el icono que desea utilizar.

   Esta acción pone el nombre base del archivo de iconos en el campo de texto Entre el nombre del archivo de iconos.

3. Pulse OK.

#### Especificar un icono en un paquete de registro

Si es usted administrador del sistema o programador y está creando un paquete de registro, los archivos de imágenes de iconos se ubican inicialmente en un directorio del paquete de registro:

    apl_raíz/dt/appconfig/icons/idioma

Después del registro con `dtappintegrate`, los archivos de iconos se copiarán en `/etc/dt/appconfig/icons/`idioma, que se encuentra en la ruta de búsqueda de iconos.

Utilice este procedimiento para especificar iconos que forman parte de un paquete de registro:

1. En el campo de texto Entre el nombre del archivo de iconos del cuadro de diálogo Buscar Conjunto, escriba el nombre base del archivo de iconos.

2. Pulse OK.

   Crear Acción muestra un cuadro de diálogo para informarle que no se han encontrado los iconos en los directorios de la ruta de búsqueda de directorio.

3. En el cuadro de diálogo de información que aparece, elija Sin cambio.