Abrir PDF
Abre um arquivo PDF. Adicione páginas usando etapas de script, como Anexar PDF, feche e salve o arquivo usando a etapa de script Fechar PDF.
Consulte também
Opções
-
De é como a localização do arquivo PDF é especificada:
-
Arquivo especifica um caminho de arquivo PDF. Quando selecionado, a opção Arquivo de origem fica disponível.
-
Origem especifica um arquivo PDF em um campo de container ou variável. Quando selecionado, a opção Origem fica disponível.
-
-
Arquivo de origem define uma lista de um ou mais caminhos e nomes de arquivo para o arquivo PDF quando De é Arquivo. A etapa de script pesquisa a lista e usa o primeiro arquivo PDF localizado com sucesso. Os caminhos devem usar um dos prefixos de caminho
de imagem. Consulte Criação de caminhos de arquivo. -
Origem especifica o campo de container ou variável que armazena o arquivo PDF quando De é Origem.
-
Senha é uma expressão de texto para a senha necessária para abrir um arquivo PDF criptografado. Se o arquivo PDF não estiver criptografado, esta opção será ignorada.
Compatibilidade
| Produto | Compatível |
| FileMaker Pro | Sim |
| FileMaker Go | Sim |
| FileMaker WebDirect | Parcial |
| FileMaker Server | Sim |
| FileMaker Cloud | Sim |
| FileMaker Data API | Sim |
| Publicação na Web personalizada | Sim |
Originada na versão
26.0
Descrição
Esta etapa de script abre um arquivo PDF existente que você pode modificar usando outras etapas de script de arquivo PDF. O arquivo PDF permanece aberto na memória até que você o feche com a etapa de script Etapa de script Fechar PDFFechar PDF ou Etapa de script Cancelar PDF.
Depois que um arquivo PDF é aberto, você pode:
-
Adicionar conteúdo usando a etapa de script Etapa de script Anexar PDF
-
Adicionar registros gerados usando a etapa de script Etapa de script Salvar registros como PDF com a opção "PDF aberto atualmente"
-
Salvar o PDF final usando a etapa de script Etapa de script Fechar PDF
Este fluxo de trabalho é útil para criar documentos PDF complexos que combinam páginas de várias fontes, como uma página de capa, dados de relatório e apêndices, todos reunidos em um único arquivo PDF.
Notas
-
Apenas um arquivo PDF pode ser aberto por vez. Se um arquivo PDF já estiver aberto, esta etapa de script retornará o código de erro 833 ("O arquivo PDF já está aberto").
-
O arquivo PDF original não é modificado a menos que você salve as alterações no mesmo local usando a etapa de script Etapa de script Fechar PDF.
-
Para arquivos PDF criptografados, se a senha estiver ausente ou incorreta, esta etapa de script retornará o código de erro 831 ("Senha de PDF inválida").
-
O arquivo PDF aberto e quaisquer alterações não salvas serão perdidos se um dos seguintes ocorrer:
-
A sessão atual do cliente FileMaker for encerrada
-
O arquivo FileMaker Pro cujo script abriu o arquivo PDF fechar sem fechar o arquivo PDF aberto
-
-
No FileMaker WebDirect, a opção Do: Arquivo não é suportada.
Exemplo 1 - Abrir e modificar um arquivo PDF existente
Abre um arquivo PDF existente no diretório atual usando um caminho e nome de arquivo de image:ExistingReport.pdf, adiciona o registro atual e salva a versão modificada em image:UpdatedReport.pdf.
Abrir PDF [ De: Arquivo ; Arquivo de origem: "ExistingReport.pdf" ]
Salvar registros como PDF [ Restaurar ; Salvar em: PDF atualmente aberto ; Registro atual ]
Fechar PDF [ Salvar em: Arquivo ; "UpdatedReport.pdf" ; Criar pastas: Desativado]
Exemplo 2 - Abrir um arquivo PDF criptografado com senha
Abre um arquivo PDF protegido por senha armazenado em um campo de container, anexa as páginas de outro arquivo PDF e salva o resultado em uma variável global com o nome de arquivo UpdatedContract.pdf.
Ir para layout [ "Contratos" (Contratos) ; Animação: Nenhum ]
Abrir PDF [ De: Origem ; Origem: Contratos::ContratoPDF ; Senha: •••••••• ]
Anexar PDF [ De: Arquivo ; Arquivo de origem: "Appendix.pdf" ]
Fechar PDF [ Salvar em: Destino ; Destino: $$modifiedPDF ; Nome de arquivo: "UpdatedContract.pdf" ]
Exemplo 3 - Abrir arquivo PDF com tratamento de erros
Abre um arquivo PDF e lida com os erros usando um cálculo para mapear códigos de erro a mensagens fáceis de usar e a etapa de script Etapa de script Cancelar PDF para fechar o PDF aberto sem salvá-lo.
Definir captura de erro [ Ativado ]
Ir para layout [ "Contratos" (Contratos) ; Animação: Nenhum ]
Definir variável [ $pdfFilePath ; Valor: "image:Contract.pdf" ]
Abrir PDF [ De: Arquivo ; Arquivo de origem: $pdfFilePath ; Senha: ••••••• ]
Definir variável [ $errorCode ; Valor: Get(LastError) ]
Definir variável [ $errorMessage ; Valor:
Case (
$Código de erro = 0 ; "" ;
$errorCode = 5 ; "Operações de arquivo não são suportadas no FileMaker WebDirect. Use um campo de container ou variável." ;
$errorCode = 830 ; "Arquivo PDF não encontrado ou tem um formato inválido." ;
$errorCode = 831 ; "Senha incorreta para arquivo PDF criptografado." ;
$errorCode = 832 ; "As configurações de segurança do arquivo PDF impedem a modificação." ;
$errorCode = 833 ; "Outro arquivo PDF já está aberto. Feche-o primeiro.” ;
"Erro desconhecido ao abrir PDF: " & $errorCode
)
]
If [ $errorCode ≠ 0 ]
Cancelar PDF
Mostrar caixa de diálogo personalizada [ "Erro de PDF" ; $errorMessage ]
Sair do script [Resultado de texto: "Falhou"]
End If
Anexar PDF [ De: Origem ; Origem: Contratos::ContratoPDF ]
Fechar PDF [ Salvar em: Arquivo ; $pdfFilePath ]