Como juntar ficheiros PDF num só documento

Antes de começar a combinação

Combinar ficheiros PDF num documento único facilita a reunião de um relatório, dos seus anexos e de outros documentos relacionados numa sequência contínua. A ferramenta trabalha com pelo menos dois ficheiros PDF fornecidos como valores codificados em Base64 e acrescenta as páginas ao documento combinado pela ordem recebida.

A ordem deve ser decidida antes do processamento. Se o relatório principal vier primeiro e os anexos depois, essa disposição será refletida no resultado. Dentro de cada ficheiro, as páginas também permanecem na sequência em que aparecem no PDF de origem. Assim, a ferramenta não escolhe uma organização por assunto nem corrige uma lista colocada na ordem errada.

Esta abordagem é adequada quando já dispõe dos valores Base64 correspondentes aos PDFs que pretende reunir. Cada valor precisa de ser descodificado e lido como PDF para que as respetivas páginas possam ser acrescentadas ao documento final.

Passos para reunir os PDFs

1. Separe pelo menos dois ficheiros PDF que queira reunir e obtenha o valor Base64 correspondente a cada um. Confirme também que cada valor representa um PDF válido, porque a leitura do conteúdo ocorre durante o processamento.
2. Abra o controlo destinado à combinação de PDFs e prepare a lista de ficheiros de entrada.
3. Adicione os valores Base64 à lista, colocando-os na sequência pretendida para o documento final. Por exemplo, coloque o contrato antes dos anexos se essa for a ordem necessária.
4. Reveja a lista e confirme que contém dois ou mais valores utilizáveis. Verifique ainda se não trocou a posição de dois ficheiros e se cada valor pertence ao PDF certo.
5. Inicie o processamento e aguarde pelo resultado da operação.
6. Quando houver sucesso, recolha o PDF combinado devolvido em Base64. Para o utilizar como ficheiro, descodifique esse valor de acordo com o procedimento do seu ambiente.

A revisão da lista é particularmente importante quando os documentos têm muitas páginas. Uma alteração na posição de um valor muda a posição do PDF correspondente no resultado, embora não altere a sequência interna das páginas desse ficheiro. O mesmo princípio permite colocar um documento principal, vários anexos e, por fim, outro documento suplementar, desde que todos os valores sejam adicionados nessa ordem.

Leitura do resultado e das falhas

Num resultado bem-sucedido, recebe um valor Base64 que representa o PDF combinado. O resultado inclui também contagens relativas aos ficheiros combinados e às páginas processadas, o que ajuda a comparar o processamento com a lista fornecida.

Para verificar a sequência, associe cada grupo de páginas ao ficheiro que lhe deu origem. O primeiro grupo deve corresponder ao primeiro valor da lista, o grupo seguinte ao segundo valor, e assim por diante; dentro de cada grupo, a ordem original das páginas é mantida. Esta verificação confirma a disposição dos ficheiros, mas não substitui a validação do conteúdo dos documentos de origem.

A operação não produz uma combinação bem-sucedida quando não existe uma lista utilizável ou quando são fornecidos menos de dois ficheiros. Também pode indicar falha se a leitura de um PDF não for possível, se a dependência necessária para processar PDFs não estiver disponível ou se ocorrer uma exceção. Perante uma falha, reveja a quantidade de valores, a correspondência entre cada valor e o PDF e a validade dos ficheiros antes de tentar novamente.

Exemplo prático

Uma pessoa precisa de obter um documento em que o relatório apareça antes dos anexos.

Uma pessoa coloca primeiro o valor Base64 de um relatório e depois o valor Base64 dos respetivos anexos, iniciando a combinação após verificar que ambos correspondem a PDFs válidos.

O resultado tem a forma de um PDF combinado codificado em Base64, acompanhado pelas contagens dos ficheiros combinados e das páginas processadas.

Limitações

• A combinação requer pelo menos dois valores que possam ser descodificados e lidos como PDFs; uma falha de leitura ou de processamento impede o resultado bem-sucedido.

Erros comuns

• Causa: a lista tem menos de dois valores utilizáveis ou inclui um valor que não pode ser lido como PDF. Correção: forneça pelo menos dois valores Base64 e confirme a correspondência e a validade de cada PDF antes de iniciar.

Perguntas frequentes

Posso juntar apenas um ficheiro PDF?

A operação indica falha quando só existe um ficheiro disponível ou quando a lista não contém pelo menos dois valores utilizáveis. Para prosseguir, forneça dois ou mais valores Base64 que possam ser lidos como PDFs.

A ordem das páginas é preservada?

A disposição segue a ordem dos valores na lista, enquanto as páginas de cada PDF mantêm a sequência interna de origem. Por isso, coloque primeiro o documento que deve abrir o resultado e confirme a posição dos restantes.

O que recebo quando a combinação termina com sucesso?

Quando o processamento termina com sucesso, é devolvido o PDF combinado em Base64, juntamente com contagens dos ficheiros combinados e das páginas processadas. O valor pode depois ser descodificado para utilização como PDF.