Domande generali
Domanda: Dove posso trovare tutte le informazioni relative ai servizi web?
Risposta:
- Documentazione sui Web Services
- Documentazione dei moduli universali (elenco dei tipi di servizi Web e altro)
- Pagina generale per gli sviluppatori (nel caso in cui il servizio Web debba accedere alla nostra API o costruire URL di DocuWare).
- Pagina per gli sviluppatori per i Web Services SOAP
Domanda: Come si registra un Web Service in DocuWare?
Risposta: Controllare KBA-36514.
Domanda: Cosa è necessario per collegare un servizio Web a DocuWare Cloud?
Risposta: Il servizio Web deve avere un IP disponibile pubblicamente. Inoltre, deve avere un FQDN pubblico e HTTPS (TLS 1.2).
Inoltre, DocuWare Cloud deve essere sbloccato nel firewall del servizio Web.
Per ulteriori informazioni, consultare KBA-36612.
Domanda: Come posso sbloccare DocuWare Cloud dal firewall dei servizi Web?
Risposta: Controllare KBA-36612.
Domanda: Come abilitare una connessione HTTPS funzionante?
Risposta: Controllare KBA-36222.
Domanda: Come posso testare l'accesso all'API senza rendere pubblico il servizio web?
Risposta: Utilizzate le nostre macchine virtuali di presentazione, disponibili per i partner e per la spedizione di un sistema DocuWare OnPremise (Demo).
Domanda: Come posso inviare un file al servizio Web?
Risposta: Modificare il servizio Web in modo che abbia un parametro per l'ID del documento. Una volta ricevuto il DocID, deve accedere all'API di DocuWare e scaricare il documento. Non è possibile caricare un file nel servizio Web direttamente tramite il flusso di lavoro.
Se si ha bisogno solo del documento come file, si può pensare di inviarlo tramite un'attività di posta elettronica.
Domanda: Quali tipi di servizi Web supporta Workflow?
Risposta: Supporta servizi web di tipo REST e SOAP. Per entrambi, è necessario soddisfare alcuni requisiti, in modo che il servizio Web sia compatibile.
Per ulteriori informazioni, consultare KBA-36669.
Domande relative a REST
Domanda: Come si crea un servizio Web REST?
Risposta: Prima di tutto è necessario disporre di almeno DocuWare 7.5. Esistono diversi framework e modelli per questo scopo. Non esiste un esempio da DocuWare, ma assicuratevi che Support supporti tutte le caratteristiche obbligatorie del servizio (vedi sotto).
Domanda: Quali caratteristiche offre il supporto dell'attività del servizio Web REST?
Risposta: Può inviare una richiesta HTTP con JSON o XML, è possibile modificare i metodi HTTP GET, PUT, POST e DELETE.
È inoltre possibile impostare il percorso dell'URL, i parametri della query, le intestazioni HTTP, popolare il corpo della richiesta HTTP con variabili e campi indice, assegnare il corpo della risposta HTTP a variabili e campi indice.
Ha un'opzione per scegliere liberamente i codici HTTP (oltre a 200/OK) che si qualificano come risposta OK e assegnarli anche alle variabili.
Non è in grado di salvare cookie e altre intestazioni di risposta, pertanto non è supportato per chiamare l'API di DocuWare direttamente tramite l'attività.
Se si desidera utilizzare REST per accedere all'API di DocuWare, è necessario creare un proprio servizio Web e chiamare l'API nel suo codice o utilizzare i connettori iPaaS.
Per ulteriori informazioni, consultare KBA-36968.
Domande relative a SOAP
Domanda: Quale tipo o esempio devo utilizzare per SOAP?
Risposta: Si consiglia vivamente di utilizzare lo stesso tipo di progetto dei nostri esempi, poiché non tutti i servizi SOAP sono compatibili.
Se si desidera creare tale servizio in Visual Studio, creare un nuovo progetto di tipo "ASP.NET Web Application", aggiungere > nuovo elemento (scegliere servizio web (ASMX)). Nel file ...asmx.cs ogni metodo web deve avere il tag [WebMethod].
Per ulteriori informazioni, consultare la pagina dello sviluppatore per i Web Services SOAP.
Domanda: Qual è la differenza tra i Web Services SOAP e i Web Services REST in DocuWare?
Risposta: Invece di formattare e codificare il payload XML o JSON del servizio web, è possibile assegnare variabili utilizzando elenchi a discesa per ogni parametro.
Non è flessibile come REST, ma è più facile da implementare nel flusso di lavoro in quanto visualizza meno opzioni da configurare. Per ulteriori informazioni, consultare la pagina degli sviluppatori per i servizi Web SOAP.
Domanda: Quali tipi di variabili sono consentiti per i serviziWeb SOAP ?
Risposta: Utilizzare come parametri solo i tipi di variabile supportati: bool, int, string, DateTime e decimal.
Per il ritorno, utilizzare una variabile con tipi supportati o una classe con proprietà di tipi supportati. In questo caso, può essere utile controllare il ritorno del metodo [WebMethod] CurrentDocuWareVersion() dal nostro servizio web di esempio. Per ulteriori informazioni, consultare KBA-36451.
Domanda: Come pubblicare un servizio Web SOAP su IIS?
Risposta: Controllare KBA-36232 e la pagina degli sviluppatori per i servizi Web SOAP (cercare istruzioni per la pubblicazione di Web Services).
Domanda: Come utilizzare l'autenticazione per il mio servizio Web SOAP?
Risposta: Controllare KBA-36262.
KBA è applicabile sia alle organizzazioni cloud che a quelle on-premise.
Si prega di notare: Questo articolo è una traduzione dall'inglese. Le informazioni contenute in questo articolo si basano sulla versione originale in inglese del/i prodotto/i. Potrebbero esserci piccoli errori, ad esempio nella grammatica utilizzata nella versione tradotta dei nostri articoli. Sebbene non possiamo garantire la completa accuratezza della traduzione, nella maggior parte dei casi la troverete sufficientemente informativa. In caso di dubbi, si prega di fare riferimento alla versione inglese di questo articolo.