Integrazione con le applicazioni Citrix

Data di pubblicazione: novembre 2016

Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

Puoi integrare le tue applicazioni Citrix con Unified Service Desk ospitandole in Unified Service Desk. In questo modo, gli agenti del servizio clienti possono interagire con le applicazioni Citrix dall'interno del client Unified Service Desk mentre lavorano sui dati dei clienti in Microsoft Dynamics 365. È possibile configurare un'applicazione Windows come applicazione virtuale in Citrix XenApp 7.6 eseguita come applicazione ospitata in Unified Service Desk. Ulteriori informazioni: TechNet: Requisiti software per la virtualizzazione delle applicazioni Citrix XenApp

L'applicazione Citrix ospitata nel client Unified Service Desk utilizza il protocollo ICA (Independent Computing Architecture) per comunicare in remoto con l'applicazione su un server Citrix. Il file .ica Citrix contiene informazioni per la connessione al server remoto, quali l'indirizzo del server, le proprietà della sessione e le informazioni di autenticazione.

Per ulteriori informazioni sull'integrazione di Unified Service Desk con Citrix, vedi Blog: Citrix e Unified Service Desk (in inglese)

Questo argomento fornisce informazioni sulla configurazione dei componenti lato server e lato client per l'integrazione di Unified Service Desk con le applicazioni Citrix, adattatori Citrix di esempio e alcune procedure consigliate.

In questo argomento

Configurare il componente lato server per l'integrazione di Citrix

Configurare il componente lato client per l'integrazione di Citrix

Integrazione di Citrix: funzionamento

Adapter Citrix di esempio

Integrazione di Citrix: procedure consigliate

Configurare il componente lato server per l'integrazione di Citrix

Il componente lato server viene implementato come eseguibile (Microsoft.Uii.Csr.CitrixIntegration.exe) ed è configurato come programma di avvio che viene avviato automaticamente quando si avvia un'applicazione Citrix. L'eseguibile termina automaticamente subito se l'applicazione Citrix non è stata richiamata da un client Unified Service Desk. Il componente lato server deve essere configurato in ciascun server Citrix.

1. Scaricare il pacchetto SDK di User Interface Integration (UII).

2. Fare doppio clic sul file di pacchetto per estrarre il contenuto.

3. Passare alla cartella <ExtractedFolder>\UII\Bin\UII\Citrix Server Component, quindi copiare tutti i file presenti in questa cartella in una cartella (ad esempio, ServerSideComponent) nel server Citrix.

4. Nella cartella ServerSideComponent del server Citrix, modificare il file RegPatch Install StartupPrograms on Citrix Server.reg utilizzando il Blocco note in modo da impostare il valore del parametro "StartupPrograms" sul percorso file completo del file eseguibile Microsoft.Uii.Csr.CitrixIntegration.exe.

5. Applicare la patch di registro nel server Citrix eseguendo il file RegPatch Install StartupPrograms on Citrix Server.reg. Questa patch designa un eseguibile come programma di avvio che sarà lanciato insieme a un'applicazione Citrix.

Configurare il componente lato client per l'integrazione di Citrix

La configurazione lato client per l'integrazione di Citrix implica due cose:

• Configura un'istanza di un'applicazione ospitata di UII (Remote Hosted Application) nell'istanza Dynamics 365 che possa essere utilizzata direttamente senza codice personalizzato o che possa essere estesa in base alle esigenze. Le azioni attivate nelle istanze delle applicazioni ospitate di UII vengono trasmesse al componente lato server utilizzando un file .ica, il quale viene inviato agli eventuali adattatori di applicazioni configurati. Per ulteriori informazioni sulle applicazioni ospitate di UII, vedere Applicazioni ospitate di UII

• Copiare l'eseguibile dell'applicazione Citrix e gli altri assembly necessari nella directory di installazione del client Unified Service Desk, applicare la patch di registro lato client e aggiungere le impostazioni specifiche di Citrix nel file di configurazione dell'applicazione client Unified Service Desk. Questo passaggio deve essere eseguito in ciascun computer nel quale è installata l'applicazione client Unified Service Desk.

Configurare un'applicazione ospitata remota

1. Accedere a Microsoft Dynamics 365.

2. Passa a Impostazioni > Unified Service Desk.

3. Fare clic su Controlli ospitati, quindi su Nuovo.

4. Nell'area Generale della pagina Nuovo controllo ospitato specificare un nome, un ordinamento e un nome visualizzato per l'applicazione ospitata. Ogni applicazione ospitata deve avere un nome univoco. L'ordinamento specifica l'ordine in cui le applicazioni ospitate vengono recuperate e visualizzate in Unified Service Desk.

5. Nell'area Unified Service Desk, selezionare Applicazione ospitata di CCA dall'elenco Tipo componente USD.

6. Nell'area Tipo di app ospitata, selezionare Applicazione ospitata remota dall'elenco Applicazione ospitata.

7. Nella sezione Configurazione adapter, è possibile scegliere tra tre configurazioni dell'adapter dall'elenco a discesa Adapter:

   1. Non usare alcun adapter: specifica che l'applicazione ospitata non richiede alcuna automazione.

   2. Usa adapter di automazione (HAT): specifica la configurazione predefinita utilizzata per il software factory del toolkit dell'applicazione ospitata (HAT). Se l'applicazione ospitata utilizza un adapter di automazione (HAT), specificare le informazioni di binding dell'applicazione ospitata nel campo XML automazione dell'area Automazione. Per ulteriori informazioni sui binding, vedere Utilizzare il controllo UII per creare binding per l'applicazione ospitata.

   3. Usa adapter: specifica che l'applicazione ospitata utilizza un adapter personalizzato.

   Per informazioni sull'utilizzo di adapter per l'integrazione di Citrix, vedere Adapter Citrix di esempio

8. Nell'area Impostazioni applicazione Citrix, specificare i seguenti valori:

   • Nome file ICA: specificare il percorso completo al file .ica richiesto per il lancio dell'applicazione Citrix. Il file .ica Citrix contiene informazioni per la connessione al server remoto, quali l'indirizzo del server, le proprietà della sessione e le informazioni di autenticazione.

   • Tentativi di acquisizione processo: specificare il numero di volte in cui il file eseguibile lato server dovrebbe analizzare la tabella dei processi alla ricerca del processo che esegue l'applicazione Citrix lanciata. Il processo dell'applicazione Citrix potrebbe richiedere qualche minuto prima di apparire nella tabella dei processi.

   • Ritardo di acquisizione processo: specificare il ritardo in millisecondi tra ciascuna analisi della tabella dei processi.

   • Nome file di acquisizione processo: specificare il percorso completo al nome file dell'applicazione Citrix. Questo valore viene utilizzato dal file eseguibile lato server per confrontare con i nomi file dei processi in esecuzione alla ricerca di una corrispondenza.

9. Salvare il controllo ospitato.

Copiare l'eseguibile, applicare la patch di registro e aggiungere le impostazioni di configurazione di Citrix

Questo passaggio deve essere eseguito in ciascun computer nel quale è installata l'applicazione client Unified Service Desk.

1. Passare alla cartella <ExtractedFolder>\UII\Bin\UII\Citrix Server Component, dove <ExtractedFolder> è la posizione nella quale hai estratto il file di pacchetto SDK di UII scaricato nella sezione Configurare il componente lato server per l'integrazione di Citrix precedente.

2. Copiare i seguenti file dalla cartella <ExtractedFolder>\UII\Bin\UII\Citrix Server Component nella cartella del client Unified Service Desk (in genere C:\Program Files\Microsoft Dynamics CRM USD\USD):

   • Microsoft.Uii.Csr.CitrixIntegration.exe

   • AxWFICALib.dll

   • WFICALib.dll

3. Applicare la patch di registro nel computer client Unified Service Desk per abilitare l'utilizzo di canali virtuali personalizzati eseguendo i seguenti file disponibili nella cartella <ExtractedFolder>\UII\Bin\UII\Citrix Server Component:

   • Per il client x86: RegPatch Allow Custom Virtual Channels in ICAClient.reg

   • Per il client x64: RegPatch Allow Custom Virtual Channels in ICAClient x64 Client.reg

   Nota

   Se non viene applicata questa patch di registro, non sarà possibile ottenere la comunicazione tra client e server.

4. Aggiungere le seguenti impostazioni dell'applicazione nel file UnifiedServiceDesk.exe.config disponibile nella cartella di installazione del client Unified Service Desk. Queste impostazioni dell'applicazione devono essere aggiunte sotto il nodo radice <configuration>:

   <appSettings>
       <add key="CitrixIntegration.VirtualChannelNamePrefix" value="CTXUII"/>
       <add key="CitrixIntegration.XmitFragmentSize" value="200"/>
       <add key="CitrixIntegration.RecvTimeoutInMilliseconds" value="2000"/>
       <add key="CitrixIntegration.HeartbeatMaxWaitInMilliseconds" value="60000"/>
       <add key="CitrixIntegration.ClientOnly.HeartbeatIntervalInMilliseconds" value="15000"/>
   </appSettings>
   

   Nota

   Queste impostazioni sono inoltre disponibili nel componente lato server nel file Microsoft.Uii.Csr.CitrixIntegration.exe.config.

   Di seguito viene descritta ciascuna chiave:

   Legenda	Descrizione
   CitrixIntegration.VirtualChannelNamePrefix	Per ogni applicazione Citrix lanciata vengono creati due canali virtuali con nome distinti e con un prefisso in comune. Questa impostazione espone il prefisso alla personalizzazione, sebbene normalmente non sia necessario. Questa impostazione deve essere identica sia sul lato client che sul lato server.
   CitrixIntegration.XmitFragmentSize	Le trasmissioni sui canali virtuali sono frammentate al limite specificato qui. La chiave sarà limitata internamente qualora eccedesse i limiti interni (i messaggi di traccia devono segnalare quando si verificano queste situazioni). Questa impostazione può differire tra il lato client e il lato server.
   CitrixIntegration.RecvTimeoutInMilliseconds	Come con tutte le comunicazioni di rete, i timeout sono necessari per aiutare a decidere quando il peer in una comunicazione non è disponibile. La comunicazione dell'integrazione Citrix è orientata alla richiesta/risposta e questa impostazione specifica quando tempo il sistema impiega a restituire la risposta prima di smettere di attenderla. Questa impostazione può differire tra il lato client e il lato server.
   CitrixIntegration.HeartbeatMaxWaitInMilliseconds	Ogni attiva di comunicazione su canale virtuale viene conteggiata come "heartbeat". Questa impostazione specifica il tempo massimo che può trascorre senza intervento nella comunicazione. Dopo tale periodo, uno dei lati dei canali di comunicazione (client o server) conclude che il peer opposto non è disponibile. Per l'eseguibile lato server (Microsoft.Uii.Csr.CitrixIntegration.exe), termina l'esecuzione dopo aver raggiunto questa conclusione. Per l'istanza del controllo ospitato lato client, termina il timer di ping di heartbeat interno. Questa impostazione può differire tra il lato client e il lato server.
   CitrixIntegration.ClientOnly.HeartbeatIntervalInMilliseconds	Specifica il periodo di un timer che attiva messaggi PING all'eseguibile lato server (Microsoft.Uii.Csr.CitrixIntegration.exe), che a sua volta risponde con messaggi PONG rispondenti. In questo modo si evita che i componenti client e server concludano la comunicazione erroneamente. Questa impostazione è applicabile solo per il lato client.

Integrazione di Citrix: funzionamento

Adesso che sai come configurare l'integrazione di Citrix in Unified Service Desk, ti spieghiamo il funzionamento dell'integrazione di Citrix da quando l'agente avvia il controllo ospitato nel client Unified Service Desk a quando il controllo ospitato viene chiuso.

1. L'agente del servizio clienti avvia il controllo ospitato Citrix dal client Unified Service Desk, il quale lancia l'applicazione Citrix nel server Citrix utilizzando il nome file ICA configurato per il controllo ospitato.

2. L'eseguibile lato server (Microsoft.Uii.Csr.CitrixIntegration.exe) viene avviato automaticamente e richiede le impostazioni dell'applicazione Citrix configurate per il controllo ospitato dal client Unified Service Desk. Hai configurato queste informazioni nel passaggio 8 nella sezione Configurare un'applicazione ospitata remota

3. Se la richiesta di impostazioni dell'applicazione scade in base al valore specificato nell'impostazione dell'applicazione CitrixIntegration.RecvTimeoutInMilliseconds, l'eseguibile lato server (Microsoft.Uii.Csr.CitrixIntegration.exe) conclude che l'istanza dell'applicazione Citrix non è un'applicazione ospitata di UII e termina l'esecuzione.

   Se la richiesta di impostazioni dell'applicazione non scade, procedere al passaggio successivo.

4. Utilizzando le impostazioni dell'applicazione del controllo ospitato Citrix, l'eseguibile lato server (Microsoft.Uii.Csr.CitrixIntegration.exe) procede con l'identificazione del processo dell'applicazione Citrix.

   • Se non è stato possibile identificare il processo dell'applicazione Citrix, l'eseguibile lato server rimane in esecuzione e invia un messaggio al client. Puoi visualizzare il messaggio se hai attivato l'analisi della traccia.

   • Se il processo dell'applicazione Citrix viene identificato, l'eseguibile lato server acquisisce il processo e procede con l'identificazione della finestra di primo livello designata per l'applicazione. L'eseguibile lato server fa riferimento alla configurazione generalmente utilizzata per le applicazioni esterne, la quale può essere sfruttata per selezionare una finestra di primo livello non predefinita. Se non è stato possibile trovare la finestra di primo livello, l'eseguibile lato server rimane in esecuzione e invia un messaggio informativo al client. Tale messaggio è visibile se è stata attivata l'analisi della traccia.

5. Infine, viene creata un'istanza dell'adapter applicazione per il controllo ospitato. Il processo acquisito e la finestra di primo livello vengono forniti all'adapter e tutte le operazioni dell'adapter vengono indirizzate tra il client e il server a questo punto.

   Nota

   Se non è stato possibile trovare il processo, il valore è null. Se non è stato possibile trovare la finestra, il valore è 0. Se non è stato possibile avviare un'istanza dell'adapter, l'eseguibile lato server rimane in esecuzione e invia un messaggio informativo al client. Tale messaggio è visibile se è stata attivata l'analisi della traccia.

6. Quando l'agente del servizio clienti chiude il controllo ospitato Citrix nel client Unified Service Desk, viene terminato anche l'eseguibile lato server.

Adapter Citrix di esempio

Ecco alcuni adapter Citrix di esempio da esaminare e provare.

Adapter applicazione di esempio

Un adapter applicazione di esempio per Citrix è disponibile nel pacchetto di download dell'SDK di UII. Per esaminare/provare questo adapter:

1. Scaricare il pacchetto SDK di User Interface Integration (UII).

2. Fare doppio clic sul file di pacchetto per estrarre il contenuto.

3. Passare alla cartella <ExtractedFolder>\UII\SampleCode\UII\Citrix\ApplicationAdapter. Il file README.txt nella cartella include informazioni su questo adapter.

Adapter basati sui dati di esempio

Per agevolare l'utilizzo di adapter basati sui dati (DDA) senza la necessità di sviluppare un adapter personalizzato, Unified Service Desk fornisce il seguente adapter per utilizzare il tag DataDrivenAdapterBindings per avviare l'istanza del DDA e per tradurre le azioni DDA in chiamate al DDA avviato: Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.dll. Per impostazione predefinita, questo assembly è disponibile nella directory di installazione del client Unified Service Desk.

Per utilizzare l'adapter DDA di esempio con il controllo ospitato Citrix, aggiornare la definizione del controllo ospitato per specificare i seguenti valori nell'area Configurazione adapter del controllo ospitato:

Integrazione di Citrix: procedure consigliate

Ecco alcuni aspetti da tenere presente quando configuri l'integrazione con le applicazioni Citrix.

• Assicurati che l'applicazione Citrix che vuoi ospitare in Unified Service Desk possa essere avviata autonomamente avviandola in modo esplicito.

• Utilizza l'analisi per identificare e risolvere i problemi. I messaggi di analisi aiutano a identificare e a risolvere eventuali problemi. Per impostazione predefinita, l'analisi Verbose è attivata nel file Microsoft.Uii.Csr.CitrixIntegration.exe.config per la registrazione nel log dei messaggi di esecuzione nel server:

  <add name="Microsoft.Uii.Common.Logging" value="Verbose"/>
  

  Puoi quindi utilizzare uno dei provider di registrazione User Interface Integration (UII) standard, ad esempio il provider di registrazione file, per scrivere i log di analisi in un file. Le analisi compariranno in qualsiasi debugger collegato. Le stesse impostazioni sul lato client (file UnifiedServiceDesk.exe.config) attiveranno l'analisi sul lato client.

• In Windows, più processi che eseguono lo stesso programma condividono le pagine di memoria che contengono il codice eseguibile. La natura dei programmi .NET prevedere che il compilatore JIT (just-in-time) compili il linguaggio intermedio (IL) nelle istruzioni macchina (codice eseguibile) in fase di runtime quando l'applicazione viene avviata. La compilazione in runtime evita la condivisione di pagine di codice altrimenti identiche. In questo modo, viene evitata l'ottimizzazione della condivisione delle pagine di codice. Dal momento che l'eseguibile lato server (Microsoft.Uii.Csr.CitrixIntegration.exe) è un programma .NET dove più istanze possono essere in esecuzione nello stesso computer, sarà utile sfruttare lo strumento Ngen.exe (Native Image Generator) per creare immagini native degli assembly dipendenti per l'eseguibile lato server e installarle nella cache di immagine nativa nel computer locale. L'utilizzo delle risorse del server risulterà migliorato grazie all'utilizzo delle immagini native dalla cache anziché all'utilizzo del compilatore JIT per compilare l'assembly originale.

Vedere anche

Applicazioni ospitate di UII
Creare e gestire le applicazioni ospitate UII
Estendere Unified Service Desk

Unified Service Desk 2.0

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright