Ir al contenido

Expresiones de exportación

Una expresión de exportación indica a NAHPU qué campos del registro escribir, qué texto fijo añadir alrededor y cómo tratar valores vacíos o condicionales. Se utiliza en dos lugares:

La misma expresión produce el mismo resultado en ambos sitios. Por ejemplo, [taxonomy::genus] [taxonomy::specificEpithet] C imprime Rattus rattus en una etiqueta y escribe Rattus rattus en una celda.

Encierre cualquier clave de campo entre corchetes como [tabla::campo]. Todo lo que queda fuera de los corchetes se escribe literalmente:

Field no. [specimen::fieldNumber]

produce Field no. 156. Tres modificadores cubren la mayoría de los casos:

AñadirParaEjemploResultado
??textoValor alternativo si el campo está vacío[taxonomy::specificEpithet??sp.]sp. cuando no hay epíteto
#labelMostrar la etiqueta de un campo codificado en vez de su código[mammalAttribute::testisPosition#label]Scrotal en vez de 0
[[if]…]]Escribir texto solo cuando se cumplen condiciones[[if][coordinate::elevationInMeter!=""]=>"m"]]m solo si existe elevación

Casi nunca necesita escribir claves a mano: use Insertar campo en el editor de plantillas o el botón de añadir campo en un campo personalizado.

Copie estas expresiones en un elemento de texto de una plantilla o en una columna tabular según se indica. Todos los ejemplos usan campos de espécimen.

[taxonomy::genus] [taxonomy::specificEpithet]

Imprime Rattus rattus. Para especímenes identificados solo a género, añada un valor alternativo para obtener Rattus sp.:

[taxonomy::genus] [taxonomy::specificEpithet??sp.]

Para el nombre completo con subespecie, use [specimen::scientificName]. En un ajuste tabular, coloque cualquiera de estas expresiones en una columna de campo personalizado.

Une los campos geográficos en una sola cadena omitiendo los vacíos, evitando comas dobles cuando falta un nivel como el condado:

[geography::country]|[geography::islandGroup]|[geography::stateProvince]|[geography::county]|[geography::municipality]|[geography::locality]

Cada | separa dos partes; el separador impreso proviene del ajuste de lista:

  • Plantilla de documento: configure el tipo de texto como lista de valores y elija el separador por coma.
  • Ajuste de exportación tabular: configure el tipo de asignación como campo de lista, salida en una columna y separador de coma. Pegue la expresión en la expresión de origen sin procesar bajo Avanzado y defina un nombre de columna (obligatorio para encabezados Darwin Core y espacio de nombres NAHPU).

Un registro completo escribe Indonesia, West Java, Bogor, Cibodas; uno sin condado escribe Indonesia, West Java, Cibodas. Quite, agregue o reordene partes según necesite.

Escribe largo x ancho solo cuando el testículo es escrotal y existen ambas medidas; en cualquier otro caso no escribe nada:

[[if][mammalAttribute::testisPosition=="0"&&mammalAttribute::testisLength!=""&&mammalAttribute::testisWidth!=""]=>"[mammalAttribute::testisLength] x [mammalAttribute::testisWidth]"]]
RegistroSalida
Escrotal, 10 mm por 6.5 mm10 x 6.5
Escrotal, falta el anchoNada
AbdominalNada
HembraNada

"0" es el código guardado para escrotal. Añada mm dentro de las comillas para incluir la unidad, o |"not scrotal" antes de ]] para definir una alternativa. Consulte Texto condicional. En un ajuste tabular, use una columna de campo personalizado.

[mammalAttribute::testisPosition#label]

Escribe Scrotal en lugar del código guardado 0. Funciona en cualquier tipo de texto, incluidas las columnas de campo personalizado. Consulte Decodificar un campo codificado.

SímboloSignificadoEjemplo
[ ]Marcador de campo[fieldNumber]
::Separa la tabla del campo en una clave completa[specimen::fieldNumber]
??Valor alternativo cuando el campo está vacío[specimen::preparator??N/A]
#labelEscribe la etiqueta de un campo codificado en vez de su código[mammalAttribute::testisPosition#label]
-imgDibuja un campo .sex como icono en vez de texto[mammal.sex]-img
[[ ]]Expresión condicional[[specimen::condition][…]]
[[if] … ]]Texto condicional escrito solo si coinciden las condiciones[[if][…]=>" mm"]]

Un marcador admite la clave completa tabla::campo o solo el nombre del campo:

Field number: [specimen::fieldNumber]
Scientific name: [taxonomy::scientificName]
Locality: [site::specificLocality]

Use la clave completa cuando dos tablas compartan nombre de campo. El selector solo ofrece campos disponibles para el tipo de registro activo.

?? define qué escribir si un campo está vacío. El control Marcador sin contenido lo genera automáticamente:

OpciónSintaxisSalida cuando está vacío
En blanco[specimen::preparator]Nada
table::field[specimen::preparator??specimen::preparator]La clave del campo como recordatorio visible
N/A[specimen::preparator??N/A]N/A
None[specimen::preparator??None]None
Personalizado[specimen::preparator??not recorded]Su texto personalizado

El texto tras ?? se imprime literalmente. Los marcadores terminados en -img no aceptan valor alternativo.

Dos marcadores dibujan imágenes en vez de texto y deben ir solos en su elemento de texto:

  • [mammal.sex]-img dibuja el icono de sexo (la clave debe terminar en .sex; configure el tamaño con ancho y alto).
  • [media::media] con tipo de texto imagen dibuja en cuadrícula las imágenes adjuntas al registro.

Un campo personalizado combina marcadores con texto propio, o contiene solo texto fijo. En una plantilla de documento, todo elemento de texto funciona así (Insertar campo más texto libre). En un ajuste de exportación tabular, use Agregar campo personalizado o cambie el tipo de asignación de la columna.

El editor construye la expresión segmento a segmento:

ControlFunción
Añadir campoInserta un campo del selector.
Agregar texto BInserta texto fijo o un separador.
Añadir texto condicionalInserta texto condicional.
Mostrar etiquetaAñade #label a un campo codificado para escribir la etiqueta en vez del código.
Editar texto condicionalReabre un segmento condicional para modificarlo.
Subir / bajar segmentoReordena los segmentos (se escriben de izquierda a derecha).
Quitar segmentoElimina un segmento.
ExpresiónMuestra la expresión resultante que se guardará.
Nombre de columnaDefine el encabezado de la columna de salida.

Ejemplos completos:

[personnel::initial]-[specimen::fieldNumber]
[taxonomy::genus] [taxonomy::specificEpithet]
NAHPU

NAHPU escribe ese texto fijo en todas las filas (útil para un código de institución). Un campo personalizado con nombre de columna y sin segmentos genera una columna vacía para alinear la tabla con una hoja externa.

Asigne siempre un nombre de columna (obligatorio para encabezados Darwin Core y NAHPU). Con table::fieldName o fieldName, un campo personalizado sin nombre usa su primer campo o su texto fijo.

Las columnas de campo personalizado salen como texto plano. Cuando necesite texto codificado, formato de fecha, corchetes condicionales o listas indexadas, use una columna de campo simple o campo de lista.

Una expresión condicional comprueba uno o más campos antes de decidir qué escribir. En el editor de plantillas, use Salida condicional en la barra de texto para crearla y editarla con diálogo. En un ajuste tabular, seleccione un formato de valor condicional en una columna de campo simple (su propio campo es el objetivo).

Si desea…TipoEjemplo de salida
Encerrar un valor entre corchetes según otro campoCorchetes condicionales[82.5] cuando el peso fue estimado
Reemplazar un valor según otro campoCampo condicional? en lugar del epíteto cuando la ID es incierta
Reemplazar un valor según su propio valorValor condicionalNot recorded cuando el valor es 0
Escribir texto independiente (como una unidad) según condicionesTexto condicional mm solo tras un ancho registrado

En el diálogo:

  1. Elija el tipo condicional.
  2. Elija el campo objetivo (el valor a encerrar o reemplazar). El texto condicional no tiene objetivo y se añade al final del elemento.
  3. Añada una o más condiciones (campo de control, comparación y valor). El valor condicional evalúa al propio objetivo, por lo que no muestra selector de campo.
  4. Con varias condiciones, elija lógica OR (cualquiera) o AND (todas).
  5. Escriba el texto de reemplazo (o el texto cuando coincide y el opcional en caso contrario para texto condicional). Deje el reemplazo vacío para ocultar el valor al coincidir.

El texto condicional escribe texto según las condiciones en vez de alterar un campo; resulta ideal para unidades o etiquetas acompañantes:

[mammalAttribute::testisWidth][[if][mammalAttribute::testisWidth!=""]=>" mm"]]

Un ancho de 6.5 imprime 6.5 mm; si falta, no imprime nada.

Añada | y un segundo texto entre comillas para el caso contrario:

[[if][mammalAttribute::testisPosition=="0"]=>"scrotal"|"not scrotal"]]

Los textos entre comillas admiten marcadores, valores alternativos y #label:

[[if][mammalAttribute::testisLength!=""&&mammalAttribute::testisWidth!=""]=>"[mammalAttribute::testisPosition#label], [mammalAttribute::testisLength] x [mammalAttribute::testisWidth] mm"]]
  • Encierre cada texto entre comillas dobles; escriba una comilla literal como \". Una | dentro de comillas es texto normal.
  • Sin segundo texto, no se escribe nada si no hay coincidencia.
  • No se evalúan condicionales anidados dentro del texto de salida.
  • if debe ir en minúsculas.

Ocultar un valor salvo que se registre otro campo

Sección titulada «Ocultar un valor salvo que se registre otro campo»

Use «está vacío» con reemplazo vacío. Esto imprime el largo testicular solo cuando se registró la posición:

[[mammalAttribute::testisLength][mammalAttribute::testisPosition==""]=>""]]

Un condicional solo oculta su campo objetivo; el texto contiguo (como una unidad o x) sigue apareciendo salvo que use texto condicional:

[[mammalAttribute::testisLength][mammalAttribute::testisPosition==""]=>""]][[if][mammalAttribute::testisPosition!=""&&mammalAttribute::testisLength!=""]=>" mm"]]

Consulte Tamaño testicular para ver el patrón completo.

Encerrar un peso estimado entre corchetes. La nota de precisión de mamíferos enumera las medidas estimadas:

[[mammalAttribute::weight][mammalAttribute::accuracy~="weight"]]

Un peso marcado sale como [82.5]; uno exacto sale como 82.5. En mammalAttribute::accuracy, ~= comprueba si esa medida está marcada.

Marcar una identificación incierta. La confianza de identificación se guarda como 0 (baja), 1 (media) o 2 (alta):

[taxonomy::genus] [[taxonomy::specificEpithet][specimen::iDConfidence!="2"]=>"?"]]

Una identificación de alta confianza imprime Rattus rattus; una menor imprime Rattus ?. Como el reemplazo sustituye todo el objetivo, para añadir texto después del valor siga el campo con texto condicional.

!="2" no coincide con un campo de confianza vacío. Para incluir también los vacíos, añada =="" con ||:

[[taxonomy::specificEpithet][specimen::iDConfidence=="0"||specimen::iDConfidence=="1"||specimen::iDConfidence==""]=>"?"]]
  • Se comparan valores guardados, no etiquetas: use códigos (specimen::iDConfidence!="2", mammalAttribute::testisPosition=="0"), no las etiquetas visibles.
  • Distinguen mayúsculas y minúsculas e ignoran espacios al inicio o final.
  • Un campo vacío nunca coincide con operadores comunes (incluido !=). Use =="" (vacío) o !="" (no vacío).
  • Un solo conector por expresión: todo && o todo ||, nunca mezclados.
  • Objetivo vacío: usa su Marcador sin contenido, no el reemplazo.
  • Reemplazo completo: sustituye todo el valor; vacío lo oculta.
  • Errores de sintaxis salen literales: previsualice siempre un registro que coincida y otro que no.

El diálogo genera esta sintaxis automáticamente; úsela para leer o editar a mano:

SímboloNombreQué hace
[[ … ]]DelimitadoresAbren y cierran una expresión condicional.
][Separador de objetivoSepara el campo objetivo de las condiciones.
==IgualCoincide con el valor exacto.
!=DistintoCoincide con cualquier valor no vacío distinto.
~=ContieneCoincide si el texto aparece en cualquier parte del valor.
!=""No está vacíoCoincide si el campo tiene algún valor.
==""Está vacíoCoincide si el campo está vacío o ausente.
&&Todas (AND)Todas las condiciones deben cumplirse.
||Cualquiera (OR)Al menos una condición debe cumplirse.
" … "Comillas de valorEnvuelven cada valor de comparación (vacías para comprobar vacío).
\", \\EscapesComilla o barra invertida literal dentro de un valor.
]=>Marcador de reemplazoTermina las condiciones e inicia el texto de reemplazo o salida.
ifPalabra clave condicionalOcupa el lugar del objetivo para emitir texto.
|Separador elseInicia el texto escrito cuando las condiciones no coinciden.

Tres formas válidas (cada una termina en ]]; |"otherwise" es opcional; ~="" no es válido):

[[target][conditions]]
[[target][conditions]=>"replacement"]]
[[if][conditions]=>"text"|"otherwise"]]

En una plantilla de documento, el tipo de texto y Formato controlan la presentación. En un ajuste tabular, una columna de campo simple ofrece los mismos formatos.

Tipo de textoOpciones de formato
Texto normalNormal, mayúsculas, minúsculas, capitalizar
ImagenSe ajusta con ancho y alto en lugar de formato
MarkdownNormal; renderiza texto enriquecido como narrativas
CoordenadasDecimal, decimal cardinal, DMS, DDM
Lista de valoresBarra vertical, coma, punto y coma, diagonal, nueva línea, viñetas, separador personalizado
Lista anidadaTabla (añade opción de mayúsculas en encabezados) o lista de tarjetas
FechasYYYY-MM-DD, DD-MM-YYYY, MM-DD-YYYY, DD/MM/YYYY, MM/DD/YYYY, Month DD, YYYY, DD Month YYYY, DD Mon YYYY
Fecha y hora17 combinaciones de las fechas anteriores con 24 h, 12 h, ISO y solo hora
Hora24h, 24h segundos, 12h, 12h con cero inicial
SexoFormato y valor faltante, descritos abajo
NúmeroOriginal o 0, 1, 2 o 3 decimales
Texto codificadoAsignación predeterminada o asignación personalizada

La lista anidada sirve para registros relacionados (partes, personal, métodos de recolección) y suele requerir tamaño dinámico.

Algunos campos guardan un código numérico. La asignación predeterminada se empareja por el final de la clave del campo (así funcionan tanto mammalAttribute::testisPosition como testisPosition):

La clave termina enCódigo 0123456
::sexMaleFemaleUnknownGynandromorphHermaphroditeFemale?Male?
::iDConfidenceLowMediumHigh
mammalAttribute::ageAdultSubadultJuvenileUnknown
herpAttribute::ageAdultJuvenileNeonateMetamorphUnknown
::testisPositionScrotalAbdominal
::epididymisAppearanceTubularPartialNot Tubular
::vaginaOpeningImperforatePerforate
::pubicSymphysisCloseSmall OpenOpen
::reproductiveStageNulliparousPrimiparousMultiparous
::mammaeConditionSmallLargeLactating
::echolocationFMCFQCFNone
::ovaryAppearanceSmoothOva minuteAt least one ovum ≥ 1 mm dia.
::oviductAppearanceStraightConvoluted
::fatNoneTraceLightModerateHeavyExtremely Heavy
::bodyMoltNoneTraceLightModerateHeavy

Estos campos booleanos se decodifican como Yes (1) y No (0): ::broodPatch, ::hasBursa, ::wingIsMolt, ::tailIsMolt, ::showBatFields y ::showEchoFields.

Cualquier otro campo, valor no entero o código fuera de rango se escribe sin cambios. Use asignación personalizada para campos no cubiertos. Para símbolos o letras de sexo use el tipo de texto sexo; para iconos use […sex]-img.

El marcador no cambia; el tipo de texto codificado o #label realiza la traducción:

  • Plantilla de documento: configure el tipo de texto como texto codificado; cada marcador del elemento se decodifica según su propio campo:
    Testes: [mammalAttribute::testisPosition]
    [mammalAttribute::age], [mammalAttribute::testisPosition]
  • Ajuste de exportación tabular: use texto codificado en un campo simple, o añada #label (o active mostrar etiqueta) en un campo personalizado:
    [mammalAttribute::testisPosition#label], [mammalAttribute::mammaeCondition#label]
  • En línea con #label: decodifica un marcador individual en cualquier tipo de texto. Escríbalo antes del valor alternativo: [mammalAttribute::sex#label??Unknown].
  • Etiquetas propias: en el editor de plantillas elija asignación personalizada y mapee los valores (parte de las etiquetas predeterminadas). En un ajuste tabular, escriba custom_map: en la opción de formato sin procesar bajo Avanzado:
    custom_map:0=Scrotal,1=Abdominal
    Separe cada par código=etiqueta con comas (sin comas ni signos = en las etiquetas). La asignación personalizada aplica a todos los marcadores del elemento, así que use un elemento propio por campo.

La decodificación solo afecta la salida: las condiciones siguen evaluando el código guardado y los campos vacíos usan Marcador sin contenido.

ControlOpciones
FormatoSímbolo (♂/♀), Letra (M/F), Texto (Male/Female)
FaltanteUnknown, N/A, None

Una determinación incierta conserva el signo de interrogación en todos los formatos: Female?, F?, ♀? y Male?, M?, ♂?.

SíntomaQué revisar
Un condicional sale como texto planoError de sintaxis: falta ]], valor sin comillas o mezcla de && y ||.
Un valor alternativo imprime [table::field]Marcador sin contenido está configurado como table::field; cámbielo a vacío, N/A, None o texto propio.
El icono de sexo se imprime como textoEl elemento debe contener únicamente […sex]-img y terminar en .sex.
No aparecen las imágenes del registroEl elemento debe contener únicamente [media::media] con tipo de texto imagen.
Encabezado inesperado en campo personalizadoDefina el nombre de columna; sin él se toma el primer campo o texto fijo.
Un campo codificado imprime un númeroUse texto codificado o #label y compruebe que el código exista en el mapeo.
Una condición nunca coincideSe comparan códigos guardados con distinción de mayúsculas; un campo vacío solo coincide con =="".
El texto condicional no imprime nadaSin rama |, no escribe nada si no coincide. Compruebe que if esté en minúsculas.

Las opciones siguientes pertenecen solo al editor de plantillas E; los ajustes de exportación tabular no las utilizan.

Los tamaños en el lienzo están en milímetros (mm). Los grosores de trazo, tamaños de fuente y rellenos están en puntos PDF (pt, 1 pt = 1/72 pulgada). Los colores se guardan como 0xAARRGGBB y se eligen con el selector de color.

ControlFunción
Agregar textoColoca un elemento de texto en el lienzo.
Agregar imagenColoca una imagen estática desde el dispositivo.
Agregar líneaColoca una línea recta.
Agregar formaColoca rectángulo, elipse, círculo, triángulo o polígono.
Guardar plantillaGuarda la plantilla (Guardar como… crea una copia).
Deshacer / RehacerRecorre el historial de cambios.
Borde de plantillaConfigura el borde exterior de la plantilla.
Mostrar / ocultar cuadrículaActiva o desactiva la cuadrícula de alineación.
Activar / desactivar ajusteActiva o desactiva el ajuste a la cuadrícula y elementos.
Bloqueo de lienzoCongela el desplazamiento del lienzo al arrastrar.
Seleccionar espécimen de vista previaElige el registro de muestra para rellenar marcadores.
Configuración de la plantilla DNombre, descripción, número de caras y tamaño.
Plantilla predefinida ACarga una plantilla base incorporada.
Acercar / AlejarEscala la vista del lienzo sin cambiar el PDF final.
1 cara / Anverso / ReversoCambia el modo de caras y la cara activa.
EspejarEspeja una cara para etiquetas dobladas.
OpciónValoresNotas
TextoTexto, marcadores, condicionalesContenido del elemento.
Tipo de textoVéase la tabla anteriorCategoría de formato del valor.
FormatoDepende del tipo de textoFormato concreto dentro del tipo.
Marcador sin contenidoEn blanco, table::field, N/A, None, personalizadoGenera el respaldo ??.
Salida condicionalCorchetes, campo, valor, textoGenera expresiones [[ … ]] o [[if] … ]].
Buscar y reemplazar—Edita el texto del elemento.
Reglas de reemplazoPatrón, reemplazo, tipo de coincidencia, mayúsculasReescribe valores tras el formato.
Mapear valores codificadosPredeterminado o personalizadoTraduce códigos a etiquetas para texto codificado.
OpciónValores
FuenteFuentes incorporadas e instaladas (las ausentes muestran (not installed))
Tamaño de fuentePuntos, con botones de incremento y decremento
Negrita, cursiva, subrayado, tachadoActivado o desactivado
AlineaciónIzquierda, centro, derecha
MayúsculasNormal, mayúsculas, minúsculas, capitalizar
Color de textoSelector de color
OpciónValoresNotas
PosiciónX e Y en mmMedido desde la esquina superior izquierda.
Ancho máximommAjusta líneas al ancho indicado (sin definir = sin ajuste).
AlturammLimita la altura del cuadro.
RellenoptEspacio interior alrededor del texto.
Rotación0–359°Grados enteros.
Color de fondoColor o ninguno—
Borde (color, grosor, trazo)Color, pt, solid / dashed / dotted / double—
Radio de esquinaptRedondea las esquinas.
Tamaño dinámicoActivado o desactivadoPermite crecer con el texto; combínelo con Rellenar página automáticamente.
ApilamientoTraer al frente, adelante, atrás, enviar al fondo—
BloquearActivado o desactivadoImpide arrastrar o redimensionar.
VisibleActivado o desactivadoOculto se conserva guardado pero no se imprime.

Convierte un elemento de texto en código QR escaneable:

OpciónValores
Código QRActivado o desactivado
Tamañomm
Color de fondoSelector de color
FormaCuadrado o círculo

El contenido del QR conserva el valor formateado sin recortar terminaciones .0, de modo que el escaneo coincide exactamente con el dato guardado.

OpciónValores
Ancho, altomm

Solo un elemento que contenga únicamente [media::media] o [media] muestra las imágenes del registro; mezclarlo con otro texto desactiva la imagen.

Las imágenes estáticas, líneas y formas son decorativas y no contienen datos de registros:

ElementoOpciones
ImagenRuta de imagen, posición, ancho, alto, rotación, apilamiento, bloqueo, visibilidad
LíneaPosición, longitud, rotación, grosor (pt), color, estilo de trazo, apilamiento, bloqueo, visibilidad
FormaTipo (rect, ellipse, circle, triangle, polygon con número de lados), posición, ancho, alto, rotación, grosor/color/estilo de borde, relleno o quitar relleno, apilamiento, bloqueo, visibilidad

Los estilos de trazo son solid, dashed, dotted y double. Un elemento de imagen guarda la ruta, no el archivo; al importar la plantilla en otro dispositivo deberá seleccionarse la imagen nuevamente.

OpciónValoresNotas
Nombre de plantillaTextoDebe ser único; renombrar actualiza todos los diseños que la usan.
DescripciónTexto (hasta 80 caracteres)Opcional.
Tipo de registroEspécimen, Partes del espécimen, Simbiontes, Sitio, Evento de recolección, Narrativa, Sin registrosDefine campos y registros disponibles.
Caras1 cara o 2 carasEn 1 cara, el reverso se conserva guardado sin imprimirse.
Ancho, altommTamaño de un bloque, no de la hoja.
Borde de plantillasolid, dashed, dotted, double line; grosor (pt); color—

Las opciones de impresión guardadas con una plantilla abarcan dúplex, espejado, tamaño de página, filas/columnas y márgenes. Un ajuste de diseño de impresión anula esos valores para el PDF final; consulte Crear un preset de diseño de impresión.