Un servizio Web, come definito dal documento del WSDL (Web Service Definition Language), comporta una serie di operazioni. Per ogni operazione, il file WSDL può definire un messaggio di input, un messaggio di output oppure entrambi. I messaggi di input sono inviati al server. Il server può quindi rispondere con un messaggio di output. È possibile creare e collegare tramite binding i campi di una struttura del modulo ad uno o più servizi Web. Il file WSDL fornisce la descrizione dei dati, che viene utilizzata per generare la connessione dati WSDL.
La connessione dati WSDL a un servizio Web è diversa dagli altri tipi di connessioni dati. Un'operazione di un servizio Web è simile a una chiamata a una funzione con parametri di input o output o con entrambi. Uno o più specifici campi possono essere l'origine del messaggio di input e la destinazione del messaggio di output.
Con Designer e una connessione dati WSDL è possibile effettuare le operazioni seguenti:
Eseguire un binding di una o più operazioni all'interno di uno o più servizi Web.
Associare campi, sottomoduli e gruppi di esclusione all'esecuzione di un'operazione di un servizio Web tramite un evento click di un pulsante.
Eseguire un'operazione di servizio Web da qualsiasi evento tramite uno script.
Abilitare l'accesso via script a tutti gli elementi restituiti di un servizio Web, indipendentemente dal fatto che gli elementi siano associati ai campi o meno.
Utilizzare la comunicazione stile SOAP 1.1 (binding SOAP e trasporto HTTP/HTTPS).
Scambiare dati con un servizio Web utilizzando il formato di scambio doc/literal.
Scrivere script sul lato client mediante Acrobat SOAP JavaScript Object (che supporta la codifica RPC).
Le seguenti funzionalità non sono supportate:
Alcune funzionalità dello schema XML
Protocolli come SMTP, FTP ed altri, come il trasporto sottostante per SOAP
Elementi di tipo extensibility
Individuazione del servizio Web tramite UDDI
Messaggi SOAP codificati RPC (Remote Procedure Call)
Uso dei binding HTTP POST e GET WSDL
È possibile creare una connessione dati tramite un documento WSDL su un server Web, che richiede l'autenticazione client HTTP/HTTPS per controllare l'accesso, l'autenticazione a livello di messaggio per richiedere un servizio Web o entrambe.
L'autenticazione HTTP/HTTPS avviene a livello di trasporto, dove è richiesta la verifica del client per accedere al documento WSDL e per connettersi a un servizio Web protetto. L'autenticazione HTTP/HTTPS accetta nome utente e password, digest di nome utente e password e certificati client:
L'autenticazione tramite nome utente e password fornisce una verifica di base dell'accesso, che prevede la visualizzazione di una finestra di dialogo di accesso per l'utente. Prima dell'invio al server non viene eseguito alcun hashing di nome utente e password, che vengono trasmessi come testo non cifrato.
L'autenticazione tramite digest di nome utente e password fornisce una verifica più avanzata dell'accesso, che prevede la visualizzazione di una finestra di dialogo di accesso per l'utente. In questo caso, prima dell'invio delle credenziali al server viene eseguito l'hashing di nome utente e password.
Nota: Nella finestra di dialogo di accesso sono indicati il nome del server e l'area di autenticazione a cui ci si desidera connettere. Poiché su un determinato server possono essere configurate più aree di autenticazione, la conoscenza di tali informazioni può aiutare l'utente a identificare le credenziali appropriate per l'accesso.
L'autenticazione client basata sui certificati esegue una verifica tramite ID digitale. Viene visualizzata una finestra di dialogo in cui sono elencati gli ID digitali disponibili, da cui l'utente deve selezionare quello corretto da inviare al server per l'autenticazione.
Nota: Per utilizzare l'autenticazione client basata sui certificati, è necessario disporre di un ID digitale nell'archivio certificati di Windows o nell'archivio dei file di ID digitale di Designer, dove può essere selezionato al momento della creazione della connessione dati WSDL. Vedere
Importazione di ID digitali.
L'autenticazione a livello di messaggio viene eseguita al livello di messaggio SOAP (Simple Object Access Protocol), in cui per la verifica del client è richiesto un token di protezione (incluso nell'intestazione SOAP del messaggio) per la connessione a un servizio Web protetto. Al livello di messaggio viene accettata l'autenticazione tramite nome utente e password, che prevede la visualizzazione di una finestra di dialogo di accesso per l'utente. Acrobat 9.0 o versione successiva supporta l'autenticazione tramite nome utente e password a livello di messaggio.
Durante la creazione di una connessione dati WSDL protetta è facoltativamente possibile specificare il tipo di credenziali da accettare per l'autenticazione HTTP/HTTPS e a livello di messaggio. Le credenziali per l'autenticazione HTTP/HTTPS vengono inviate nell'ambito dell'intestazione del protocollo HTTP/HTTPS. Le credenziali per l'autenticazione a livello di messaggio (SOAP) vengono utilizzate per creare un token di protezione, incluso nell'intestazione SOAP del messaggio. Ricordare che è necessario specificare il tipo di credenziali da accettare quando si utilizza un flusso di lavoro server in cui il server deve fornire credenziali senza richiedere l'interazione dell'utente.
Nota: Durante il tentativo di stabilire una connessione a un file WSDL contenuto nell'archivio di Workbench, potrebbe essere visualizzato un messaggio d'errore che informa l'utente dell'impossibilità di eseguire il caricamento. È necessario aprire il file WSDL in Workbench prima di creare la connessione dati.
