Trabalhando com JavaScript

Adicionando JavaScript (DOM)

O que é Acrobat JavaScript?

Acrobat JavaScript é uma linguagem baseada no núcleo da versão 1.5 do JavaScript do ISO-16262, anteriormente conhecido como ECMAScript, uma linguagem de script orientada a objetos desenvolvida pela Netscape Communications. O JavaScript foi criado para descarregar o processamento de páginas da Web de um servidor para um cliente em aplicações baseadas na Web. O Acrobat JavaScript implementa extensões, na forma de novos objetos e seus métodos e propriedades acompanhantes, à linguagem JavaScript. Esses objetos específicos do Acrobat permitem que um desenvolvedor gerencie a segurança do documento, comunique-se com um banco de dados, manipule anexos de arquivos, manipule um arquivo PDF para que se comporte como um formulário interativo habilitado para a web, e assim por diante. Como os objetos específicos do Acrobat são adicionados ao núcleo do JavaScript, você ainda tem acesso às suas classes padrão, incluindo Math, String, Date, Array e RegExp.

Acrobat JavaScript vs HTML (Web) JavaScript

Os documentos PDF têm grande versatilidade, pois podem ser exibidos tanto dentro do software Acrobat quanto em um navegador da Web. Portanto, é importante estar ciente das diferenças entre o Acrobat JavaScript e o JavaScript usado em um navegador da Web, também conhecido como HTML JavaScript:

O Acrobat JavaScript não tem acesso a objetos dentro de uma página HTML. Da mesma forma, o HTML JavaScript não pode acessar objetos dentro de um arquivo PDF.
O HTML JavaScript é capaz de manipular objetos como Window. O Acrobat JavaScript não pode acessar esse objeto específico, mas pode manipular objetos específicos do PDF.

Você pode adicionar JavaScript em níveis de documento e página usando Aspose.PDF for .NET. Para adicionar JavaScript:

Adicionando JavaScript à Ação do Documento ou Página

Declare e instancie um objeto JavascriptAction com a declaração JavaScript desejada como argumento do construtor.
Atribua o objeto JavascriptAction à ação desejada do documento ou página PDF.

O exemplo abaixo aplica o OpenAction a um documento específico.

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void AddJavaScript()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Open PDF document
    using (var document = new Aspose.Pdf.Document(dataDir + "input.pdf"))
    {
        // Adding JavaScript at Document Level
        // Instantiate JavascriptAction with desired JavaScript statement
        var javaScript = new JavascriptAction("this.print({bUI:true,bSilent:false,bShrinkToFit:true});");

        // Assign JavascriptAction object to desired action of Document
        document.OpenAction = javaScript;

        // Adding JavaScript at Page Level
        document.Pages[2].Actions.OnOpen = new JavascriptAction("app.alert('page 1 opened')");
        document.Pages[2].Actions.OnClose = new JavascriptAction("app.alert('page 1 closed')");

        // Save PDF Document
        document.Save(dataDir + "JavaScriptAdded_out.pdf");
    }
}

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void AddJavaScript()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Open PDF document
    using var document = new Aspose.Pdf.Document(dataDir + "input.pdf");

    // Adding JavaScript at Document Level
    // Instantiate JavascriptAction with desired JavaScript statement
    var javaScript = new JavascriptAction("this.print({bUI:true,bSilent:false,bShrinkToFit:true});");

    // Assign JavascriptAction object to desired action of Document
    document.OpenAction = javaScript;

    // Adding JavaScript at Page Level
    document.Pages[2].Actions.OnOpen = new JavascriptAction("app.alert('page 1 opened')");
    document.Pages[2].Actions.OnClose = new JavascriptAction("app.alert('page 1 closed')");

    // Save PDF Document
    document.Save(dataDir + "JavaScriptAdded_out.pdf");
}

Adicionando/Removendo JavaScript em Nível de Documento

Uma nova propriedade chamada JavaScript foi adicionada na classe Document, que possui tipo de coleção JavaScript e fornece acesso a cenários JavaScript por sua chave. Esta propriedade é usada para adicionar JavaScript em nível de documento. A coleção JavaScript possui as seguintes propriedades e métodos:

string this(string key)– Obtém ou define JavaScript pelo seu nome.
IList Keys – fornece uma lista de chaves existentes na coleção JavaScript.
bool Remove(string key) – remove JavaScript pela sua chave.

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void AddJavaScript()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Create PDF document
    using (var document = new Aspose.Pdf.Document())
    {
        document.Pages.Add();
        document.JavaScript["func1"] = "function func1() { hello(); }";
        document.JavaScript["func2"] = "function func2() { hello(); }";
        document.Save(dataDir + "AddJavascript.pdf");
    }

    // Remove Document level JavaScript
    using (var document1 = new Aspose.Pdf.Document(dataDir + "AddJavascript.pdf"))
    {
        var keys = (IList)document1.JavaScript.Keys;

        Console.WriteLine("=============================== ");

        foreach (string key in keys)
        {
            Console.WriteLine(key + " ==> " + document1.JavaScript[key]);
        }

        document1.JavaScript.Remove("func1");

        Console.WriteLine("Key 'func1' removed ");
        Console.WriteLine("=============================== ");
    }
}

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void AddJavaScript()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Create PDF document
    using var document = new Aspose.Pdf.Document();
    document.Pages.Add();
    document.JavaScript["func1"] = "function func1() { hello(); }";
    document.JavaScript["func2"] = "function func2() { hello(); }";
    document.Save(dataDir + "AddJavascript.pdf");

    // Remove Document level JavaScript
    using var document1 = new Aspose.Pdf.Document(dataDir + "AddJavascript.pdf");
    IList keys = (IList)document1.JavaScript.Keys;

    Console.WriteLine("=============================== ");

    foreach (string key in keys)
    {
        Console.WriteLine(key + " ==> " + document1.JavaScript[key]);
    }

    document1.JavaScript.Remove("func1");

    Console.WriteLine("Key 'func1' removed ");
    Console.WriteLine("=============================== ");
}

Definindo Data de Expiração de um Documento PDF Usando Ações JavaScript

Aspose.PDF permite que você defina uma data de expiração para um documento PDF incorporando Ações JavaScript. Essa funcionalidade garante que o PDF se torne inacessível após uma data e hora especificadas, aumentando a segurança e o controle do documento. Ao aproveitar as Ações JavaScript, você pode definir condições de expiração precisas até o segundo, garantindo que a acessibilidade do documento seja rigidamente regulada.

Você pode alcançar isso seguindo estas etapas

Inicializar Documento: Crie um novo documento PDF e adicione uma página em branco ou abra um documento PDF existente.
Definir Data e Hora de Expiração: Defina a data e a hora após as quais o documento expirará.
Preparar Código JavaScript:
- Recupere a data e hora atuais.
- Defina a data e hora exatas de expiração, considerando que os meses são baseados em zero no JavaScript.
- Compare a data e hora atuais com a data e hora de expiração.
- Se a data e hora atuais excederem a data e hora de expiração, exiba um alerta e feche o documento.
Definir Ação de Abertura: Associe a ação JavaScript à ação de abertura do documento.
Salvar Documento: Salve o PDF com o JavaScript incorporado que impõe a condição de expiração.

Abaixo estão trechos de código demonstrando essa funcionalidade em C# (.NET) e Java.

O seguinte trecho de código C# demonstra como definir uma data e hora de expiração para um documento PDF usando Ações JavaScript com Aspose.PDF:

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void CreateDocumentWithExpiryDate()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Create PDF document
    using (var document = new Aspose.Pdf.Document())
    {
        document.Pages.Add();

        // Define the expiry date and time (e.g., April 1, 2025, 12:00:00 PM)
        DateTime expiryDateTime = new DateTime(2025, 4, 1, 12, 0, 0);

        // Create JavaScript code to enforce the expiry date and time
        string jsCode =
            // Get the current date and time
            "var rightNow = new Date();\n" +
            // Set the expiry date and time
            "var endDate = new Date(" +
            $"{expiryDateTime.Year}," +
            $"{expiryDateTime.Month - 1}," + // Months are zero-based in JavaScript
            $"{expiryDateTime.Day}," +
            $"{expiryDateTime.Hour}," +
            $"{expiryDateTime.Minute}," +
            $"{expiryDateTime.Second}" +
            ");\n" +
            "if(rightNow > endDate)\n" +
            "{\n" +
            "    app.alert(\"This Document has Expired as of \" + endDate.toLocaleString() + \".\");\n" +
            "    this.closeDoc();\n" +
            "}";

        // Create a JavascriptAction with the defined JavaScript code
        var javaScript = new Aspose.Pdf.Annotations.JavascriptAction(jsCode);

        // Set the JavaScript action to execute when the document is opened
        document.OpenAction = javaScript;

        // Save PDF document
        document.Save(dataDir + "PDFExpiry_out.pdf");
    }
}

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void CreateDocumentWithExpiryDate()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Create PDF document
    using var document = new Aspose.Pdf.Document();
    document.Pages.Add();

    // Define the expiry date and time (e.g., April 1, 2025, 12:00:00 PM)
    var expiryDateTime = new DateTime(2025, 4, 1, 12, 0, 0);

    // Create JavaScript code to enforce the expiry date and time
    string jsCode =
        // Get the current date and time
        "var rightNow = new Date();\n" +
        // Set the expiry date and time
        "var endDate = new Date(" +
        $"{expiryDateTime.Year}," +
        $"{expiryDateTime.Month - 1}," + // Months are zero-based in JavaScript
        $"{expiryDateTime.Day}," +
        $"{expiryDateTime.Hour}," +
        $"{expiryDateTime.Minute}," +
        $"{expiryDateTime.Second}" +
        ");\n" +
        "if(rightNow > endDate)\n" +
        "{\n" +
        "    app.alert(\"This Document has Expired as of \" + endDate.toLocaleString() + \".\");\n" +
        "    this.closeDoc();\n" +
        "}";

    // Create a JavascriptAction with the defined JavaScript code
    var javaScript = new Aspose.Pdf.Annotations.JavascriptAction(jsCode);

    // Set the JavaScript action to execute when the document is opened
    document.OpenAction = javaScript;

    // Save PDF document
    document.Save(dataDir + "PDFExpiry_out.pdf");
}

Objeto Date do JavaScript: No JavaScript, o índice do mês começa em 0 para janeiro e termina em 11 para dezembro. Certifique-se de que o valor do mês seja ajustado adequadamente ao definir a data e hora de expiração.
Considerações de Segurança: Embora as ações JavaScript possam controlar o comportamento de um documento PDF, elas dependem do suporte do visualizador de PDF para JavaScript. Nem todos os visualizadores de PDF podem honrar esses scripts, e os usuários podem ter a execução de JavaScript desativada por motivos de segurança.
Personalização: Modifique o código JavaScript para realizar ações adicionais após a expiração, como desabilitar certos recursos, redirecionar para uma página específica ou registrar o evento. Além disso, se necessário, você pode verificar apenas a data de expiração sem especificar a hora.

Trabalhando com ZUGFeRD Comparar documentos PDF