Crear registros adicionales

Si necesita un registro que no está incluido por defecto en ediarum, puede crearlo en eXist-db en la aplicación ediarum.DB y luego vincularlo a Oxygen.

Primero, hay que crear el registro en la aplicación ediarum.DB de eXist-db.
  1. Seleccione el menú Verwaltung > Projekte (“Gestión → Proyectos”).
  2. Haga clic en el campo de su proyecto.
  3. Seleccione el menú Projektkonfiguration > Register (“Configuración de proyectos → Registros”).
  4. Asegúrese de que el registro que quiere crear no está ya incluido en la lista de registros mostrada.
  5. En el campo Neue Registeranbindung (Projekt) (“Nueva conexión de registro (proyecto)”), haga clic en Hinzufügen (“Añadir”).
  6. Especifique todos los parámetros en la ventana abierta.
    Figura 1. Ventana para introducir los parámetros del registro. (Para la traducción de los campos en alemán, véase la tabla de abajo. )


    Tabla 1. Valores de ejemplo, basados en un registro de unidades de medida
    Valor de ejemplo Explicación
    Estructura de una entrada de registro 
    <item xml:id="real_espanol">
<label>Real español</label>
</item>
    API-ID units El ID se puede elegir libremente, pero no debe contener espacios ni caracteres especiales. Se especifica con las variables de editor (“Editor Variables”).
    Bezeichnung (“Denominación”) Unidades de medida Nombre del registro, se puede seleccionar libremente
    Registerordner/ -datei (“Carpeta/archivo de registro”) Registros/Medidas.xml Registros/NOMBRE.xml
    Namespace tei:http://www.tei-c.org/ns/1.0 tei:http://www.tei-c.org/ns/1.0
    Node tei:item se basa en la estructura del registro
    XML-ID @xml:id @xml:id
    Span //tei:label se basa en la estructura del registro
  7. Haga clic en Speichern (“Guardar”). Si en algún momento quiere cancelar el proceso, puede hacer clic en Schließen (“Cerrar”).
    En la lista de registros ahora puede ver el nuevo registro. A través del bóton API-Links (“Enlaces de API”) se puede acceder a las URL para llamar al registro.

Crear variables de editor en Oxygen

Para utilizar las funciones específicas de los registros, deben definirse las correspondientes variables de editor (“Editor Variables”).

Basándose en los enlaces de API, ahora tiene que definir las variables de editor en su proyecto de Oxygen para poder crear botones específicos para el registro, por ejemplo para las acciones de inserción. Consejo: Utilice como guía las variables y acciones de editor ya incluidas en ediarum para los registros estándares.
  1. Asegúrese de que el archivo de proyecto correcto (.xpr) está abierto en Oxygen. (Es posible que tenga que seleccionar el archivo correcto a través de Project > Open Project....)
  2. Ahora seleccione Options > Preferences > Custom Editor Variables [P] (“Variables de editor definidas por el usuario”).
  3. Cree una nueva variable de editor con New.
    Figura 2. Ventana para la nueva entrada de una variable de editor definida por el usuario


    Tabla 2. Valores de la variable de editor definida por el usuario para la incorporación de un registro
    Valor de ejemplo Explicación
    Name ediarum_index_ID DE LA API DADO EN EDIARUM El nombre de la variable. Se utilizará más tarde en funciones u otras variables de editor, y por lo tanto debe ser comprensible y no contener espacios o caracteres especiales.
    Value /oxygen/ediarum.xql?index=ID DE LA API DADO EN EDIARUM El valor de la variable describe la URL (parcial) y, en su caso, otras variables de editor a las que se debe acceder. El acceso al registro se realiza a través de ediarum.xql. Como ID de API se debe indicar el ID de API que se ha definido previamente al crear una nueva conexión de registro.
    Description Aquí puede introducir una descripción opcional.
  4. Para que las funciones de registro estén disponibles en ediarum, se debe asignar al atributo @telota:doctype el valor register o un valor que termine en register en el documento que se va a editar.
  5. El registro ahora está configurado para el framework y se pueden definir las acciones para el trabajo editorial con el registro.