Preparazione per l'invio di uno stato a un servizio Web SOAP
- Reperire informazioni sui requisiti di comunicazione con il servizio Web SOAP per
l'applicazione:
- I valori per potersi autenticare con l'applicazione
- I valori per poter richiedere i dati dal servizio Web SOAP
- Il formato dei dati forniti nella risposta
Fare riferimento alla documentazione dell'applicazione o consultare la compagnia che ospita l'applicazione.
- Per preparare RICOH ProcessDirector a comunicare con l'applicazione, eseguire le seguenti attività:
- Se l'applicazione richiede un certificato di sicurezza, installare il certificato sul RICOH ProcessDirector computer principale.
- Se l'ambiente richiede un server proxy per comunicare con i servizi Web, impostare il sistema in modo da poterlo utilizzare.
- Importare i file WSDL per tutti i servizi Web chiamati.
RICOH ProcessDirector crea oggetti di richiesta SOAP dalle operazioni SOAP nel file WSDL. Specificare un prefisso che RICOH ProcessDirector possa aggiungere ai nomi delle operazioni SOAP quando crea gli oggetti. L'oggetto richiesta SOAP consente a RICOH ProcessDirector di identificare la versione SOAP e le altre informazioni richieste per effettuare la chiamata al servizio Web correttamente.
Per maggiori informazioni, vedere le attività correlate.
- Eseguire un test manuale che si autentichi con l'applicazione e che richieda una risposta
dal servizio Web SOAP. Verificare che il servizio Web restituisca la risposta desiderata.Molti browser dispongono di plugin, ad esempio Boomerang per Google Chrome, che testano le chiamate del servizio Web ai clienti SOAP.
- Decidere l'evento per cui si desidera attivare la notifica e le condizioni che determinano
il momento in cui la notifica chiama il servizio Web.Se si vuole inviare una notifica per un evento che si verifica solo quando uno specifico flusso di lavoro elabora un lavoro, specificare il flusso di lavoro come condizione.
- Definire una notifica del servizio Web SOAP:
- Fare clic sulla scheda Amministrazione .
- Nel riquadro a sinistra, fare clic su .
- Fare clic su .
- Sulla scheda Generale, inserire un nome per la notifica.
- Sulla scheda Richiesta:
- Impostare la proprietà URL richiesta con l'URL del servizio Web che si desidera notificare.
- Per il valore della proprietà Payload richiesta, specificare il corpo della richiesta dei servizi Web che la notifica trasmette all'applicazione.In questo esempio, il payload contiene due elementi XML: <Token> e <OrderNumber>.
<Token>${WS.Notification.WebService.Credential}</Token> <OrderNumber>${Job.Info.Attr1}</OrderNumber>
Il valore per ciascun elemento è un simbolo RICOH ProcessDirector che contiene una proprietà. Se si sta utilizzando un servizio Web per autenticarsi con l'applicazione, includere la proprietà WSNotifica.WebService.Credenziali in un simbolo. Sostituite l'altro elemento e la proprietà con gli elementi e le proprietà che si desidera inviare all'applicazione. La notifica risolve i simboli quando invia lo stato al servizio Web SOAP.
- Impostare la proprietà Richiesta SOAP con la richiesta SOAP che RICOH ProcessDirector ha creato al momento dell'importazione del file WSDL.Ad esempio, si vuole utilizzare la richiesta SOAP CloseoutOrderByNumber. È stato anteposto PrintShop ai nomi delle richieste SOAP quando importate. Selezionare PrintShop-CloseoutOrderByNumber.
- Se l'ambiente richiede un server proxy per comunicare con i servizi Web, impostare la proprietà Usare il proxy con il server proxy corretto.
- Sulla scheda Autenticazione, specificare i valori richiesti per autenticarsi con l'applicazione.Per maggiori informazioni, vedere l'attività correlata inerente all'autenticazione con un servizio Web SOAP.
Se l'applicazione non richiede l'autenticazione, lasciare tutte le proprietà Autenticazione vuote.
- Nella scheda Evento:
- Scegliere il tipo di oggetto da monitorare.
- Selezionare la proprietà, l'azione e il valore da monitorare.
- Per definire un altro evento, fare clic sul simbolo + situato a destra dell'evento.
- Per eliminare un evento, fare clic sul simbolo - a destra dell'evento da eliminare.
Ad esempio, per inviare una notifica quando lo stato di un lavoro cambia in Conservato, selezionare Stato lavoro attuale, Cambia in e Conservato. - Nella scheda Condizioni:
- Selezionare la proprietà e il valore da rispettare prima dell'invio di qualsiasi notifica.
- Per definire un'altra condizione, fare clic sul simbolo + situato a destra dell'evento.Per specificare come sono associate le condizioni, selezionare Qualsiasi, Tutte o Personalizzazione.
- Per eliminare una condizione, fare clic su - a destra della condizione da eliminare.
Ad esempio, per inviare una notifica solo quando un lavoro secondario è nel flusso di lavoro ElaboraOrdiniWeb, specificare due condizioni:- Flusso di lavoro = ProcessWebOrders
- Numero lavoro come*.*
Per applicare le condizioni solo quando un lavoro le rispetta entrambe, selezionare Tutte.
- Al termine, fare clic su OK.
Una volta terminata l'impostazione di dispositivi di input, notifiche e flussi di lavoro, testare lo scambio di dati tra RICOH ProcessDirector e l'applicazione.
La notifica del servizio Web REST RestfulWebServiceSampleNorify fornita è simile alla notifica del servizio Web SOAP. La funzione MarcomCentral Connect include una notifica del servizio Web SOAP fornita.