Uso di oggetti JavaScript di Acrobat in Designer

In Designer, è possibile creare script a fronte di determinati oggetti JavaScript di Acrobat utilizzando la sintassi di scripting di Acrobat. Di conseguenza, le proprietà e i metodi di tali oggetti possono essere utilizzati sul modulo. Ad esempio, per visualizzare un messaggio nella console di JavaScript da Acrobat, è possibile aggiungere lo script seguente all'evento di un oggetto struttura del modulo in Designer:

    console.println("Questo messaggio è visualizzato nella console JavaScript.");

È anche possibile che il modulo venga inviato automaticamente per e-mail aggiungendo il seguente script all'evento click di un pulsante:

    var myDoc = event.target; 
    myDoc.mailDoc(true);
Nota: In Designer, è necessario assicurarsi che il linguaggio di scripting per l'evento sia impostato su JavaScript in modo che lo script venga eseguito correttamente in fase di esecuzione.

Nella sintassi di riferimento è anche possibile utilizzare riferimenti agli oggetti JavaScript in Acrobat. Ad esempio, il seguente script ottiene lo stato di firma di un campo firma ed esegue un'azione in base allo stato:

    // Proceed if the current field is not signed. 
    var oState = 
        event.target.getField("form1[0].#subform[0].SignatureField1[0]") 
            .signatureValidate(); //Get the field's signed state. 
 
if (oState == 0) { 
... 
}
Nota: In questo esempio viene utilizzata una sintassi dei riferimenti completamente qualificata per fare riferimento al testo. Per ulteriori informazioni sui riferimenti agli oggetti di una struttura del modulo, vedere Riferimento a valori e proprietà dell'oggetto.

Durante l'utilizzo di JavaScript da Acrobat in Designer, tenere presente quanto segue:

  • In Designer, utilizzare event.target per accedere all'oggetto JavaScript Doc di Acrobat. In Acrobat, l'oggetto this viene utilizzato per fare riferimento all'oggetto Doc; in Designer, invece, l'oggetto this si riferisce all'oggetto struttura del modulo a cui è allegato lo script.

  • L'Editor di script non offre alcuna opzione di completamento istruzioni per gli oggetti JavaScript di Acrobat. Vedere il documento di riferimento a JavaScript per le API di Acrobat.

  • Il metodo Doc event.target.importTextData("file.txt") non è supportato dai moduli XFA dinamici certificati.

    Per ulteriori informazioni sulla conversione degli script da Acrobat a Designer, consultare l'articolo relativo alla conversione di JavaScript di Acrobat utilizzabili nei moduli di Designer disponibile nel Developer Center.