Selecione um modo de conformidade via Connect

Fronteira. Definir um modo de conformidade configura as entradas de catálogo e os metadados exigidos pelo padrão correspondente. Isso faz o mecanismo produzir uma saída com a intenção de estar em conformidade com esse padrão. Isso não torna o documento “conforme”. Um validador, como o veraPDF, determina a conformidade. Leia cada afirmação de “conformidade” nesta página como “com a intenção de estar em conformidade; o validador determina o resultado”.

Visão geral

Um documento carrega exatamente um discriminador de conformidade: modo simples, modo marcado/PDF-UA ou modo PDF/A. Esse discriminador informa ao gravador quais ligações de catálogo, estrutura e metadados devem ser emitidas. Use esta receita para definir o discriminador por meio dos transportes do Connect. O configurador de modo marcado faz parte do core. O configurador de modo PDF/A-4 é permanentemente da camada Premium (ADR-011) e só é registrado quando o nextpdf/premium está instalado junto com o servidor.

Se você chamar os dois configuradores, as duas pilhas de recursos ficam sobrepostas. O discriminador de valor único ainda colapsa para a regra em que o último valor vence, e o mecanismo emite um aviso de sobrescrita para que as ferramentas possam observar a substituição.

Instalação

composer require nextpdf/server

Confirme se o configurador de modo PDF/A está presente com uma chamada tools/list. Consulte /connect/tool-catalog/.

Visão conceitual

O marcador de conformidade declara a conformidade pretendida. Um validador determina a conformidade real (PDF/A-4 §6.7.3). A conformidade é determinada com base nos requisitos do padrão; ela não é afirmada pelo software produtor (PDF/A-4 §6.7.3). O modo marcado conecta a árvore de estrutura e as entradas de catálogo de mark-info (ISO 32000-2 §14.7).

Uma troca de modo é uma operação de ligação. Ela prepara o documento para verificação em relação ao padrão. Por si só, não é um resultado de conformidade.

Superfície da API

Os nomes das ferramentas são verificados contra o registro em execução via tools/list. O catálogo de referência está em /connect/tool-catalog/. Esta receita não repete a contagem de ferramentas. Selecione o discriminador antes da primeira chamada de conteúdo. O gravador congela o modo quando a primeira página é emitida.

Exemplo de código — Início rápido

Crie um documento e depois mude-o para o modo marcado/PDF-UA:

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "enable_tagged_pdf",
    "arguments": { "document_id": "<id>", "language": "en" }
  }
}

A resposta informa os predicados de modo ativos (marcado / acessibilidade / arquivamento) que o gravador verifica em cada ponto de emissão. Ela também informa as ligações de catálogo adicionadas. Os predicados mostram o que o gravador vai emitir; eles não afirmam que o resultado está em conformidade.

Exemplo de código — Produção

Mude para PDF/A-4 (camada Premium) e depois execute a verificação. Trate um status sem sucesso como um resultado normal a ser inspecionado:

{
  "jsonrpc": "2.0",
  "id": 7,
  "method": "tools/call",
  "params": {
    "name": "enable_pdf_a",
    "arguments": { "document_id": "<id>", "version": "PdfA4" }
  }
}

Se você chamar os dois configuradores, o discriminador colapsa para a regra em que o último valor vence e o mecanismo emite um aviso de sobrescrita. Execute a verificação de padrões para cada variante cuja pilha de recursos permaneça conectada, porque as ligações são aditivas, ainda que o discriminador único não seja.

Casos extremos e armadilhas

Modo definido após a primeira página é rejeitado com um erro de modo congelado. Defina o modo imediatamente após criar o documento.
Configurador PDF/A sem o Premium falha — ele é permanentemente da camada Premium (ADR-011). Um documento PDF 2.0 simples não precisa de modo PDF/A.
Caso de enum desconhecido é rejeitado. O caso de arquivamento suportado é o PDF/A-4 (perfis PDF/A legados foram descontinuados).
Operação proibida pelo modo de arquivamento (por exemplo, JavaScript incorporado) é rejeitada enquanto o predicado de arquivamento está ativo.
Incompatibilidade de variante/modo na verificação retorna uma constatação de marcador não conforme. Passe a variante correspondente ao modo ativo ou ambas quando as duas pilhas estiverem conectadas.

Desempenho

O orçamento do frontmatter é um limite de documentação. As ligações de modo não adicionam nenhuma fase separada mensurável.

Notas de segurança

Nada aplicável além da orientação geral de transporte do Connect.

Conformidade

Afirmação	Cláusula	reference_id
O marcador de conformidade declara a conformidade pretendida; um validador determina	PDF/A-4 §6.7.3
Conformidade determinada com base nos requisitos, não afirmada pelo produtor	PDF/A-4 §6.7.3
O modo marcado conecta a árvore de estrutura e as entradas de mark-info	ISO 32000-2 §14.7

Selecionar um modo de conformidade faz o mecanismo produzir uma saída com a intenção de estar em conformidade. Isso não é uma certificação de conformidade. Um validador determina o resultado.

Contexto comercial

O configurador de modo PDF/A-4 é permanentemente da camada Premium (ADR-011) e só é registrado quando o nextpdf/premium está instalado junto com o servidor. O configurador de modo marcado é um recurso do core.

Especificidades do Connect

Disponibilidade de transporte (MCP / REST / gRPC)

Os configuradores de modo e a verificação são invocados da mesma forma pelo MCP tools/call, pelo endpoint de ferramenta REST e pelo serviço gRPC, por meio do executor de ferramentas compartilhado.

Camada de risco HITL

Os configuradores de modo têm nível de cautela. A verificação é somente leitura. Nenhum deles é approval_required por padrão. Uma substituição do operador só pode elevar o risco. Consulte /connect/hitl-risk-tiers/.

Envelope JSON do portão de confirmação

Essas ferramentas não acionam o portão, a menos que uma substituição do operador eleve uma delas a approval_required. O contrato do envelope e do token de uso único está em /connect/hitl-risk-tiers/.

Veja também

/cookbook/connect/compliance-check/ — valide contra o padrão ativo.
/cookbook/connect/tagged-pdf-tutorial/ — tutorial completo, de ponta a ponta, de PDF marcado.
/connect/tool-catalog/ — cálculo do conjunto de ferramentas por camada.
/connect/hitl-risk-tiers/ — o modelo de risco e o portão.