Pular para o conteúdo

Expressões de Exportação

Uma expressão de exportação informa ao NAHPU quais campos do registro gravar, qual texto fixo colocar ao redor e como lidar com valores ausentes ou condicionais. Expressões funcionam em dois lugares:

A mesma expressão produz o mesmo resultado em ambos. Por exemplo, [taxonomy::genus] [taxonomy::specificEpithet] C imprime Rattus rattus na etiqueta e grava Rattus rattus em uma célula de planilha.

Coloque qualquer chave de campo entre colchetes como [tabela::campo]. Tudo fora dos colchetes sai literalmente:

Field no. [specimen::fieldNumber]

gera Field no. 156. Três modificadores cobrem quase todas as necessidades:

AdicionarParaExemploResultado
??textoAlternativa quando o campo está vazio[taxonomy::specificEpithet??sp.]sp. quando não há epíteto
#labelGravar o rótulo de um campo codificado em vez do código[mammalAttribute::testisPosition#label]Scrotal em vez de 0
[[if]…]]Gravar texto apenas quando condições são atendidas[[if][coordinate::elevationInMeter!=""]=>"m"]]m somente quando há elevação

Você raramente precisa digitar chaves à mão: use Inserir campo no editor de modelos ou o botão de adicionar campo em um campo personalizado.

Copie estas expressões em um elemento de texto de modelo ou em uma coluna tabular conforme indicado. Todos os exemplos usam campos de espécime.

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

Gera Rattus rattus. Para espécimes identificados apenas até gênero, adicione uma alternativa para obter Rattus sp.:

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

Para o nome científico completo incluindo subespécie, use [specimen::scientificName]. Em uma predefinição tabular, coloque a expressão em uma coluna de campo personalizado.

Une os campos geográficos em uma única cadeia ignorando os vazios, evitando vírgulas duplicadas quando falta um nível como município ou condado:

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

Cada | separa partes; o separador impresso vem da configuração de lista:

  • Modelo de documento: defina o tipo de texto como lista de valores e escolha o formato com vírgula.
  • Predefinição de exportação tabular: defina o tipo de mapeamento como campo de lista, saída em uma coluna e separador por vírgula. Cole a expressão na expressão de origem bruta em Avançado e informe um nome de coluna (obrigatório para cabeçalhos Darwin Core e namespace NAHPU).

Um registro completo gera Indonesia, West Java, Bogor, Cibodas; um sem condado gera Indonesia, West Java, Cibodas. Remova, adicione ou reordene partes conforme necessário.

Grava comprimento x largura apenas quando o testículo é escrotal e ambas as medidas existem; nos demais casos não grava nada:

[[if][mammalAttribute::testisPosition=="0"&&mammalAttribute::testisLength!=""&&mammalAttribute::testisWidth!=""]=>"[mammalAttribute::testisLength] x [mammalAttribute::testisWidth]"]]
RegistroSaída
Escrotal, 10 mm por 6.5 mm10 x 6.5
Escrotal, largura ausenteNada
AbdominalNada
FêmeaNada

"0" é o código armazenado para escrotal. Adicione mm dentro das aspas para incluir a unidade, ou |"not scrotal" antes de ]] para uma alternativa. Veja Texto condicional. Em uma predefinição tabular, use uma coluna de campo personalizado.

[mammalAttribute::testisPosition#label]

Gera Scrotal em vez do código armazenado 0. Funciona em qualquer tipo de texto, incluindo colunas de campo personalizado. Veja Decodificar um campo codificado.

SímboloSignificadoExemplo
[ ]Marcador de campo[fieldNumber]
::Separa tabela e campo em uma chave completa[specimen::fieldNumber]
??Alternativa quando o campo está vazio[specimen::preparator??N/A]
#labelGrava o rótulo de um campo codificado em vez do código[mammalAttribute::testisPosition#label]
-imgDesenha um campo .sex como ícone em vez de texto[mammal.sex]-img
[[ ]]Expressão condicional[[specimen::condition][…]]
[[if] … ]]Texto condicional gravado apenas quando condições correspondem[[if][…]=>" mm"]]

Um marcador aceita a chave completa tabela::campo ou apenas o nome do campo:

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

Use a chave completa sempre que duas tabelas tiverem um campo com o mesmo nome. O seletor exibe apenas campos disponíveis para o tipo de registro ativo.

?? define o que imprimir quando um campo está vazio. O controle Marcador sem conteúdo gera essa sintaxe automaticamente:

OpçãoSintaxeSaída quando vazio
Em branco[specimen::preparator]Nada
table::field[specimen::preparator??specimen::preparator]A chave do campo como lembrete visível
N/A[specimen::preparator??N/A]N/A
None[specimen::preparator??None]None
Personalizado[specimen::preparator??not recorded]Seu texto personalizado

O texto após ?? é impresso literalmente. Marcadores terminados em -img não aceitam alternativa.

Dois marcadores desenham imagens em vez de texto e devem ficar sozinhos no seu elemento de texto:

  • [mammal.sex]-img desenha o ícone de sexo (a chave deve terminar em .sex; defina o tamanho com largura e altura).
  • [media::media] com tipo de texto imagem exibe em grade as imagens anexadas ao registro.

Um campo personalizado combina marcadores com texto fixo, ou contém apenas texto fixo. Em um modelo de documento, todo elemento de texto funciona assim (Inserir campo mais texto digitado). Em uma predefinição tabular, selecione Adicionar campo personalizado ou altere o tipo de mapeamento da coluna.

O editor monta a expressão segmento por segmento:

ControleO que faz
Adicionar campoInsere um campo do seletor.
Adicionar texto BInsere texto fixo ou separador.
Adicionar texto condicionalInsere texto condicional.
Mostrar rótuloAdiciona #label em um campo codificado para exibir o rótulo.
Editar texto condicionalReabre um segmento condicional para edição.
Mover segmento acima / abaixoReordena segmentos (gravados da esquerda para a direita).
Remover segmentoExclui um segmento.
ExpressãoExibe a expressão final que será salva.
Nome da colunaDefine o cabeçalho da coluna de saída.

Exemplos completos:

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

NAHPU grava esse texto fixo em todas as linhas (útil para código de instituição). Um campo personalizado com nome de coluna e sem segmentos grava uma coluna em branco para alinhar com uma planilha externa.

Informe sempre um nome de coluna (obrigatório para cabeçalhos Darwin Core e namespace NAHPU). Com table::fieldName ou fieldName, um campo sem nome usa seu primeiro campo ou seu texto fixo.

Colunas de campo personalizado geram texto simples. Quando precisar de texto codificado, formato de data, colchetes condicionais ou listas indexadas, use uma coluna de campo único ou campo de lista.

Uma expressão condicional verifica um ou mais campos antes de decidir o que gravar. No editor de modelos, use Saída condicional na barra de texto. Em uma predefinição tabular, escolha um formato de valor condicional em uma coluna de campo único (seu próprio campo é o alvo).

Se você quiser…TipoExemplo de resultado
Colocar um valor entre colchetes conforme outro campoColchetes condicionais[82.5] quando o peso foi estimado
Substituir um valor conforme outro campoCampo condicional? no lugar do epíteto quando a ID é incerta
Substituir um valor com base nele mesmoValor condicionalNot recorded quando o valor é 0
Gravar texto independente (como unidade) condicionalmenteTexto condicional mm apenas após uma largura registrada

No diálogo:

  1. Escolha o tipo condicional.
  2. Escolha o campo alvo (o valor a cercar ou substituir). Texto condicional não tem alvo e é anexado ao fim do elemento.
  3. Adicione uma ou mais condições (campo controlador, comparação e valor). Valor condicional testa o próprio alvo, então o seletor de campo fica oculto.
  4. Para múltiplas condições, defina lógica OR (qualquer) ou AND (todas).
  5. Informe o texto de substituição (ou texto quando corresponde e alternativa opcional para texto condicional). Deixe a substituição vazia para ocultar o valor quando corresponder.

Texto condicional grava texto conforme condições em vez de modificar um campo — ideal para unidades ou rótulos acompanhantes:

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

Uma largura de 6.5 imprime 6.5 mm; se ausente, nada é impresso.

Adicione | e uma segunda cadeia entre aspas para o ramo alternativo:

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

Textos entre aspas podem conter marcadores, alternativas ?? e #label:

[[if][mammalAttribute::testisLength!=""&&mammalAttribute::testisWidth!=""]=>"[mammalAttribute::testisPosition#label], [mammalAttribute::testisLength] x [mammalAttribute::testisWidth] mm"]]
  • Coloque cada texto entre aspas duplas; escape aspas literais como \". Um | dentro de aspas é texto comum.
  • Sem ramo alternativo, nada é gravado se as condições falharem.
  • Condicionais aninhados dentro das aspas não são avaliados.
  • if deve estar em minúsculas.

Ocultar um valor salvo se outro campo estiver preenchido

Seção intitulada “Ocultar um valor salvo se outro campo estiver preenchido”

Use teste de vazio com substituição vazia. Isso imprime o comprimento testicular apenas quando a posição foi registrada:

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

Um condicional oculta apenas seu alvo; texto ao redor (como unidade ou x) continua aparecendo, salvo se usar texto condicional:

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

Veja Tamanho dos testículos para o padrão completo.

Colocar peso estimado entre colchetes. A nota de precisão de mamíferos indica medições estimadas:

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

Pesos marcados saem como [82.5]; precisos saem como 82.5. Em mammalAttribute::accuracy, ~= verifica se essa medida está marcada.

Marcar identificação incerta. A confiança da identificação é armazenada como 0 (baixa), 1 (média) ou 2 (alta):

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

Alta confiança gera Rattus rattus; menor gera Rattus ?. Como a substituição troca todo o alvo, para acrescentar texto depois do valor siga o campo com texto condicional.

!="2" não corresponde a um campo vazio. Inclua registros vazios acrescentando =="" com ||:

[[taxonomy::specificEpithet][specimen::iDConfidence=="0"||specimen::iDConfidence=="1"||specimen::iDConfidence==""]=>"?"]]
  • Comparam valores armazenados, não rótulos: teste os códigos (specimen::iDConfidence!="2", mammalAttribute::testisPosition=="0"), não os rótulos exibidos.
  • Diferenciam maiúsculas e minúsculas e ignoram espaços nas extremidades.
  • Campos vazios nunca correspondem a operadores comuns (incluindo !=). Use =="" (vazio) ou !="" (não vazio).
  • Um único conector por expressão: só && ou só ||, nunca misturados.
  • Alvo vazio: usa Marcador sem conteúdo, não o texto de substituição.
  • Substituição total: substitui o valor inteiro; vazia oculta o valor.
  • Erros de sintaxe imprimem literalmente: sempre teste um registro que corresponde e outro que não corresponde.

O diálogo gera esta sintaxe automaticamente; use a tabela ao ler ou editar à mão:

SímboloNomeFunção
[[ … ]]DelimitadoresAbrem e fecham uma expressão condicional.
][Separador de alvoSepara o campo alvo das condições.
==IgualCorresponde ao valor exato.
!=DiferenteCorresponde a qualquer valor não vazio diferente.
~=ContémCorresponde se o trecho ocorrer em qualquer parte do valor.
!=""Não vazioCorresponde quando há algum valor.
==""VazioCorresponde quando o campo está em branco ou ausente.
&&Todas (AND)Todas as condições devem corresponder.
||Qualquer (OR)Pelo menos uma condição deve corresponder.
" … "Aspas de valorEnvolvem cada valor de comparação (vazias nos testes de vazio).
\", \\EscapesAspas ou barra invertida literal dentro do valor.
]=>Marcador de substituiçãoEncerra condições e inicia texto de substituição ou saída.
ifPalavra-chave condicionalOcupa o lugar do alvo para emitir texto.
|Separador elseInicia o texto exibido quando as condições não correspondem.

Três formas válidas (todas terminam em ]]; |"otherwise" é opcional; ~="" é inválido):

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

Em modelos de documentos, tipo de texto e Formato definem a aparência. Em predefinições tabulares, uma coluna de campo único oferece os mesmos formatos.

Tipo de textoOpções de formato
Texto normalNormal, maiúsculas, minúsculas, capitalizar
ImagemDimensionada por largura e altura em vez de formato
MarkdownNormal; renderiza texto rico como narrativas
CoordenadasDecimal, decimal cardinal, DMS, DDM
Lista de valoresBarra vertical, vírgula, ponto e vírgula, barra, nova linha, marcadores, separador personalizado
Lista aninhadaTabela (adiciona opção de capitalização do cabeçalho) ou lista de cartões
DatasYYYY-MM-DD, DD-MM-YYYY, MM-DD-YYYY, DD/MM/YYYY, MM/DD/YYYY, Month DD, YYYY, DD Month YYYY, DD Mon YYYY
Data e hora17 combinações dos formatos acima com 24h, 12h, ISO e somente hora
Hora24h, 24h segundos, 12h, 12h com zero à esquerda
SexoFormato e ausente, descritos abaixo
NúmeroOriginal, ou 0, 1, 2 ou 3 casas decimais
Texto codificadoMapeamento padrão ou mapeamento personalizado

Lista aninhada serve para registros relacionados (partes, pessoal, métodos de coleta) e costuma exigir dimensionamento dinâmico.

Alguns campos armazenam códigos numéricos. O mapeamento padrão compara o final da chave do campo (assim tanto mammalAttribute::testisPosition quanto testisPosition decodificam):

A chave termina emCó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

Estes campos booleanos decodificam 1 como Yes e 0 como No: ::broodPatch, ::hasBursa, ::wingIsMolt, ::tailIsMolt, ::showBatFields e ::showEchoFields.

Chaves fora da tabela, valores não inteiros ou códigos fora do intervalo saem inalterados. Use mapeamento personalizado para outros campos. Para símbolos ou letras de sexo use o tipo de texto sexo; para ícones use […sex]-img.

O marcador permanece igual; o tipo texto codificado ou #label faz a tradução:

  • Modelo de documento: defina o tipo de texto como texto codificado; cada marcador do elemento decodifica conforme seu próprio campo:
    Testes: [mammalAttribute::testisPosition]
    [mammalAttribute::age], [mammalAttribute::testisPosition]
  • Predefinição tabular: use texto codificado em um campo único, ou adicione #label (ou ative mostrar rótulo) em um campo personalizado:
    [mammalAttribute::testisPosition#label], [mammalAttribute::mammaeCondition#label]
  • Inline com #label: decodifica um único marcador em qualquer tipo de texto. Escreva #label antes de qualquer alternativa: [mammalAttribute::sex#label??Unknown].
  • Rótulos próprios: no editor de modelos escolha mapeamento personalizado e mapeie os valores (começa preenchido com os padrões). Em uma predefinição tabular, informe custom_map: na opção de formato bruta em Avançado:
    custom_map:0=Scrotal,1=Abdominal
    Separe cada par código=rótulo por vírgulas (sem , ou = nos rótulos). O mapeamento personalizado aplica-se a todos os marcadores do elemento, então use um elemento separado por campo.

A decodificação muda apenas a exibição; condições continuam testando códigos armazenados e valores vazios usam Marcador sem conteúdo.

ControleOpções
FormatoSímbolo (♂/♀), Letra (M/F), Texto (Male/Female)
AusenteUnknown, N/A, None

Determinações incertas mantêm o ponto de interrogação em todo formato: Female?, F?, ♀? e Male?, M?, ♂?.

SintomaO que verificar
Condicional sai como texto puroErro de sintaxe: verifique ]] ausente, valor sem aspas ou mistura de && e ||.
Alternativa imprime [table::field]Marcador sem conteúdo está como table::field; mude para vazio, N/A, None ou texto próprio.
Ícone de sexo sai como textoO elemento deve conter apenas […sex]-img, com chave terminada em .sex.
Imagens do registro não aparecemO elemento deve conter apenas [media::media] com tipo de texto imagem.
Cabeçalho inesperado em campo personalizadoDefina o nome da coluna; sem ele, usa-se o primeiro campo ou o texto fixo.
Campo codificado imprime númeroUse texto codificado ou #label e confirme que o código está no mapeamento.
Condição nunca correspondeCondições comparam códigos armazenados diferenciando maiúsculas; campo vazio só corresponde a =="".
Texto condicional não imprime nadaSem ramo |, nada é escrito se não corresponder. Verifique se if está em minúsculas.

As opções abaixo aplicam-se apenas ao editor de modelos E; predefinições tabulares não as utilizam.

Tamanhos na tela estão em milímetros (mm). Espessuras de traço, tamanhos de fonte e espaçamentos estão em pontos PDF (pt, 1 pt = 1/72 polegada). Cores são armazenadas como 0xAARRGGBB e escolhidas no seletor de cores.

ControleO que faz
Adicionar textoColoca um elemento de texto na tela.
Adicionar imagemColoca uma imagem estática do dispositivo.
Adicionar linhaColoca uma linha reta.
Adicionar formaColoca retângulo, elipse, círculo, triângulo ou polígono.
Salvar modeloSalva o modelo (Salvar como… cria uma variação).
Desfazer / RefazerNavega pelo histórico de edição.
Borda do modeloConfigura a borda externa do modelo.
Mostrar / ocultar gradeAlterna a grade de alinhamento.
Ativar / desativar ajusteAlterna o encaixe na grade e em elementos.
Bloqueio da telaTrava o deslocamento ao arrastar.
Selecionar espécime de préviaEscolhe o registro de amostra que preenche marcadores.
Configurações do modelo DNome, descrição, número de faces e tamanho.
Modelo predefinido ACarrega um modelo inicial incluído.
Ampliar / ReduzirAjusta o zoom da tela sem mudar o tamanho no PDF.
1 face / Frente / VersoAlterna o modo de faces e a face em edição.
EspelharEspelha uma face para etiquetas dobráveis.
OpçãoValoresNotas
TextoTexto, marcadores, condicionaisConteúdo do elemento.
Tipo de textoVeja tabela acimaCategoria de formatação do valor.
FormatoDepende do tipo de textoFormato específico dentro do tipo.
Marcador sem conteúdoEm branco, table::field, N/A, None, personalizadoGera o fallback ??.
Saída condicionalColchetes, campo, valor, textoGera expressões [[ … ]] ou [[if] … ]].
Localizar e substituir—Edita o texto do elemento.
Regras de substituiçãoPadrão, substituição, tipo de correspondência, maiúsculasReescreve valores após a formatação.
Mapear valores codificadosPadrão ou personalizadoMapeia códigos para rótulos em texto codificado.
OpçãoValores
FonteFontes incluídas e instaladas (ausentes mostram (not installed))
Tamanho da fontePontos, com botões de aumento e redução
Negrito, itálico, sublinhado, tachadoLigado ou desligado
AlinhamentoEsquerda, centro, direita
CapitalizaçãoNormal, maiúsculas, minúsculas, capitalizar
Cor do textoSeletor de cor
OpçãoValoresNotas
PosiçãoX e Y em mmMedida a partir do canto superior esquerdo.
Largura máximammQuebra texto nessa largura (vazio = sem quebra).
AlturammLimita a altura da caixa.
Espaçamento internoptEspaço dentro da caixa ao redor do texto.
Rotação0–359°Graus inteiros.
Cor de fundoCor ou nenhuma—
Borda (cor, espessura, traço)Cor, pt, solid / dashed / dotted / double—
Raio de cantoptArredonda cantos da caixa.
Dimensionamento dinâmicoLigado ou desligadoPermite crescer com o conteúdo; combine com Preencher página automaticamente.
EmpilhamentoTrazer para frente, avançar, recuar, enviar para trás—
BloquearLigado ou desligadoImpede arrastar ou redimensionar.
VisívelLigado ou desligadoOcultos ficam salvos mas não são impressos.

Converte um elemento de texto em código QR escaneável:

OpçãoValores
Código QRLigado ou desligado
Tamanhomm
Cor de fundoSeletor de cor
FormaQuadrado ou círculo

O conteúdo do QR preserva o valor formatado bruto — incluindo .0 finais que o texto impresso omite — para que a leitura coincida exatamente com o valor armazenado.

OpçãoValores
Largura, alturamm

Apenas um elemento contendo somente [media::media] ou [media] renderiza imagens do registro; misturar com outro texto desativa a exibição de imagens.

Imagens estáticas, linhas e formas são decorativas e não carregam dados de registros:

ElementoOpções
ImagemCaminho da imagem, posição, largura, altura, rotação, empilhamento, bloqueio, visibilidade
LinhaPosição, comprimento, rotação, espessura (pt), cor, estilo de traço, empilhamento, bloqueio, visibilidade
FormaTipo (rect, ellipse, circle, triangle, polygon com número de lados), posição, largura, altura, rotação, espessura/cor/estilo do traço, preenchimento ou limpar preenchimento, empilhamento, bloqueio, visibilidade

Estilos de traço são solid, dashed, dotted e double. Elementos de imagem armazenam apenas o caminho; modelos transferidos para outro dispositivo pedem novamente a imagem lá.

OpçãoValoresNotas
Nome do modeloTextoDeve ser único; renomear atualiza todos os layouts que o utilizam.
DescriçãoTexto (até 80 caracteres)Opcional.
Tipo de registroEspécime, Partes do espécime, Simbiontes, Local, Evento de coleta, Narrativa, Sem registrosDefine campos e registros disponíveis.
Faces1 face ou 2 facesModo 1 face mantém o Verso salvo sem imprimi-lo.
Largura, alturammTamanho de um bloco, não da folha.
Borda do modelosolid, dashed, dotted, double line; espessura (pt); cor—

Opções de impressão salvas com um modelo cobrem frente e verso, espelhamento, tamanho da página, linhas/colunas e margens. Uma predefinição de layout de impressão substitui esses ajustes no PDF exportado; veja Criar um preset de layout de impressão.