Collegamento a Ivanti Process Manager mediante un servizio Web

Vi sono due metodi utilizzabili per comunicare con Ivanti Process Manager:

• utilizzo di un servizio Web
• utilizzo del comportamento Generatore eventi

Il primo metodo è quello preferenziale e verrà descritto in questa sezione. L'utilizzo del comportamento Generatore eventi è meno efficiente, ma può essere utilizzato con altri strumenti esterni che non forniscono un'interfaccia del servizio Web. Per informazioni sul metodo Generatore eventi, vedere Invio di informazioni senza utilizzare un servizio Web.

Il primo passo nella configurazione di questa integrazione consiste nel creare un listener del servizio Web in LPM quindi, all'interno del processo di creazione listener, fornire un file XML per definire il carico. Un file XML di carico di esempio (LPMWSSample.xml) è presente nella cartella Console della propria installazione Service Desk o Asset Manager, modificabile su richiesta. Si carica questo stesso file XML nella finestra di dialogo Servizi Web nella Console e si mappano gli attributi Service Desk o Asset Manager agli attributi di carico come descritto in basso.

Al fine di configurare l'integrazione tra Service Desk o Asset Manager e LPM, è necessario un oggetto appropriato che inizializzerà la richiesta di servizio. Per fornire l'adempimento della richiesta all'interno di un processo, l'oggetto deve essere correlato all'oggetto di livello superiore per il modulo e presentare il comportamento Servizio Web. Ogni volta in cui viene creata, aggiornata o eliminata un'istanza di un oggetto con il comportamento Servizio Web ha luogo una chiamata al servizio Web, leggibile da LPM.

Per mappare gli attributi di Service Desk o Asset Manager ai parametri del carico utile LPM:

1. Creare un listener del servizio Web LPM usando LPMWSSample.xml.

Consultare la documentazione LPM per informazioni su come compiere tale operazione.

2. Aprire l'oggetto con cui si desidera utilizzare il servizio Web in Progettazione oggetti.
3. Creare gli attributi stringa che si desidera mappare ai parametri nel servizio Web.
4. Selezionare l'oggetto in cima all'albero Attributi, quindi nella griglia Proprietà fare clic su accanto a Comportamenti.
   
   Verrà visualizzata la finestra di dialogo Selezione comportamento.
   
   
5. Fare clic su Servizio Web nell'elenco Elementi disponibili, quindi fare clic su .
   
   Servizio Web si sposta nell'elenco Elementi selezionati.
6. Fare clic su OK.
   La finestra Selezione comportamento si chiude e un nuovo elemento, Servizi Web, appare nella griglia Proprietà.
7. Nella griglia Proprietà, fare clic su accanto a Servizi Web.
   Verrà visualizzata la finestra di dialogo Servizi Web.
   
8. Selezionare la scheda Creazione, Aggiornamento o Eliminazione in base al fatto che si preferisca richiamare il servizio Web quando si crea, si aggiorna o si elimina un'istanza dell'oggetto business.
9. Nell'elenco Tipo autenticazione, selezionare il tipo di autenticazione richiesto dal Sito Web che ospita il servizio Web: Nessuno, Windows o Base.
10. Digitare l'URL per il servizio Web che si desidera utilizzare nella casella Indirizzo descrizione servizio Web, quindi fare clic su Vai.
    L'URL ha la seguente forma https://<lpmserver>/ServiceManagement/WebServiceListener.asmx?wsdl.
    L'elenco Metodi si aggiorna per mostrare il metodo contenuto in WebServiceListener.
11. Nell'elenco Metodi, fare clic su ProcessExternalMessage sotto WebServiceListener.
    L'elenco Parametri si aggiorna per mostrare i parametri ProcessExternalMessage.
12. Mappare il parametro connectorName all'attributo contenente il nome del listener del servizio Web che si desidera utilizzare in LPM.
    In Service Desk o Asset Manager, è possibile popolare tale attributo automaticamente utilizzando un valore, un calcolo o un valore dati istanza azione automatica predefinito, in alternativa gli utenti dovranno immettere tale valore sulla finestra corrispondente.
13. Fare clic con il pulsante destro del mouse sul parametro fieldContext, quindi fare clic su Carica modello LPM sul menu dei collegamenti.
    Apparirà la finestra di dialogo Apri.

14. Scorrere e aprire LPMWSSample.xml dalla cartella Console.
    
    Vengono caricati i contesti dei campi per i parametri LPM.
    
    
15. Mappare gli elementi sotto fieldContext denominati parameter## agli attributi in base alle proprie esigenze, quindi fare clic su OK e salvare le modifiche all'oggetto.
    I valori dei parametri che vengono mappati corrispondono a quelli inviati all'LPM, i quali vengono quindi utilizzati in LPM all'interno del proprio processo LPM. Per ulteriori informazioni sulla progettazione di processi in LPM, consultare la documentazione fornita con LPM.

Non è possibile mappare ModuleName, ModuleGuid, ClassName, ClassGuid, ObjectGuid o ProcessGuid dall'elenco Parametri, in quanto tali elementi vengono utilizzati internamente.

È possibile mappare il parametro fieldContext di livello superiore a un attributo. Tale parametro contiene il carico utile xml generato da tutti i contesti di campi mappati, che verrà inviato a LPM. Potrebbe risultare utile per il debug.

ReturnParameter restituisce un valore Vero o Falso, in base alla riuscita o meno della comunicazione con LPM.