Prévia e exportação PDF

A saída parte do documento atual

Editor, prévia paginada e PDF compartilham a árvore de documento e o motor de renderização. A exportação não reconstrói o relatório a partir de um template paralelo.

Habilite a capacidade por escopo

Inclua export:pdf na emissão do token somente em telas onde o usuário pode realmente exportar. Sem o escopo efetivo, a ação não deve ser apresentada como disponível.

const token = await reports.issueEditorToken({
  userId: user.id,
  reports: [
    {
      reportType: "acme.relatorio-mensal",
      scopes: ["editor:read", "export:pdf"],
    },
  ],
})

Trate avisos do preflight

A política do relatório pode classificar campos internos como sensíveis. O fluxo de preflight exige reconhecimento explícito quando esses valores fazem parte da saída; texto livre do modelo não altera essa política.

Falhas são recuperáveis

• AUTH_REQUIRED: renove o token pelo backend do host.
• RATE_LIMITED: aplique espera e evite cliques repetidos.
• CONFLICT: recrie a prévia a partir da revisão atual.
• PRIMITIVES_UNSUPPORTED: atualize o SDK antes de tentar outra saída.
• INTERNAL: preserve o requestId quando disponível e ofereça nova tentativa.

Consulte a referência de erros para a taxonomia completa.