Condividi tramite

Pagina Unified Interface (controllo ospitato)

Utilizza il tipo di controllo ospitato Unified Interface Page per caricare un URL o una pagina dalle app Unified Interface nelle app basate su modello. Quando una pagina dell'app basata su modello viene caricata all'interno di un controllo ospitato di questo tipo, analizza automaticamente la pagina alla ricerca di dati dall'entità e popola automaticamente i parametri di sostituzione.

Questo tipo di controllo ospitato espone molte azioni ed eventi UII predefiniti che sono univoci per la gestione delle app basate su modello Windows, tra cui l'azione di modifica dell'elenco e un'azione di ricerca per la visualizzazione di una pagina di ricerca rapida o avanzata.

Creare un controllo ospitato della pagina Unified Interface

Durante la creazione di un nuovo controllo ospitato, i campi nella schermata Nuovo controllo ospitato variano in base al tipo di controllo ospitato che si desidera creare. In questa sezione vengono fornite informazioni sui campi specifici univoci per il tipo di controllo ospitato della pagina Unified Interface.

Nella schermata Nuovo controllo ospitato :

  • Nell'area Unified Service Desk , seleziona Pagina Unified Interface dall'elenco a discesa Tipo di componente Unified Service Desk .

  • Seleziona Prelettura dati per caricare le informazioni correlate per un record di entità nel contesto insieme alla pagina del record di entità, senza dover attendere il caricamento della pagina Web completa dell'entità nell'applicazione client. Le informazioni sull'entità recuperate vengono popolate nel contesto di Unified Service Desk, consentendo così a qualsiasi controllo ospitato di visualizzare rapidamente le informazioni sull'entità rilevanti nell'applicazione client. Questo può aiutare gli agenti ad agire istantaneamente o ad avviare discussioni con i clienti, risparmiando tempo cruciale per l'interazione.

  • Dall'elenco a discesa Consenti più pagine , seleziona No (impostazione predefinita) per sostituire la pagina dell'app basata su modello attualmente visualizzata e aggiornare la cronologia del browser quando Unified Service Desk riceve un invito all'azione di navigazione o una pagina viene indirizzata alla scheda. Selezionare Sì per creare automaticamente un elenco a discesa quando viene chiamato un secondo URL o quando una regola di navigazione della finestra indirizza una pagina alla scheda. In questo modo l'utente può cercare rapidamente tra le pagine dell'app basata su modello associate a questo controllo. Inoltre, quando si seleziona Sì, diventa disponibile un campo aggiuntivo, Numero massimo di browser, in cui è possibile specificare il numero massimo di pagine da visualizzare nell'elenco a discesa.

  • Nell'area Proprietà comuni selezionare la casella di controllo L'applicazione è globale per impostare il controllo ospitato come globale. I controlli ospitati globali possono essere visualizzati al di fuori di una sessione del cliente. Controlli come il dashboard, la bacheca o la ricerca dell'agente sono usi comuni per i controlli ospitati globali. I controlli ospitati globali non hanno uno stato specifico della sessione, quindi quando si modificano le sessioni, questi stessi controlli ospitati globali rimangono. Se questa casella di controllo non è selezionata, il controllo ospitato diventa basato sulla sessione. I controlli basati sulla sessione esistono nel contesto della sessione del cliente. Se l'utente passa a un'altra sessione, tutte le pagine della sessione precedente vengono nascoste.

  • Nel campo Gruppo di visualizzazione viene visualizzato il pannello in cui viene visualizzato il controllo ospitato. MainPanel è la scelta più comune per questo tipo di controllo ospitato.

Ulteriori informazioni: Creare o modificare un controllo ospitato

Azioni UII predefinite

Di seguito sono riportate le azioni predefinite per questo tipo di controllo ospitato.

AssociatedView

Questa azione carica una vista associata specifica. In genere è possibile accedere a queste visualizzazioni espandendo il nome del record dell'entità nella barra di spostamento e selezionando le entità associate.

Parametro Descrizione
Etn Nome dell'entità per la quale si desidera caricare l'elenco dei record dell'entità associata. Si tratta di un parametro obbligatorio.
id L'ID del record dell'entità principale per il quale visualizzare i record dell'entità associati.
navItemId L'ID dell'elemento di navigazione corrispondente all'entità associata. Maggiori informazioni: formContext.ui.navigation
hideCommandBar Se questo parametro viene specificato e False, la pagina verrà visualizzata insieme alla barra dei comandi dell'app basata su modello.
hideNavigationBar Se questo parametro è specificato e False, la pagina viene visualizzata insieme alla barra di spostamento dell'app basata su modello.

Chiudi

Questa azione viene utilizzata per chiudere il controllo ospitato. A differenza dell'azione ChiudiAttivo , se questa scheda (controllo ospitato) visualizza più di una pagina, questa azione chiude tutte le pagine visualizzate nella scheda dell'applicazione agente.

ChiudiAttivo

Questa azione viene utilizzata per chiudere la finestra attiva all'interno di questo controllo ospitato. Se la finestra attiva è l'unica finestra visualizzata nel controllo ospitato, il controllo ospitato stesso verrà chiuso. Per i controlli ospitati della pagina Unified Interface che non consentono più pagine (Consenti più pagine = No), questa azione equivale all'azione Chiudi .

ChiudiEChiedi

Questa azione chiude il controllo ospitato, ma richiede all'utente di salvare o abbandonare le modifiche prima della chiusura.

Trova

Passare alla visualizzazione elenco di ricerca rapida dell'entità specificata.

Parametro Descrizione
Vedi descrizione Il parametro data deve specificare il nome logico dell'entità della visualizzazione elenco di ricerca rapida da visualizzare. Ci sono alcuni valori speciali per le maiuscole:
- Utilizzare il caso o l'incidente per visualizzare la visualizzazione dell'elenco di ricerca rapida per i casi.
- Utilizza le attività o le attività per visualizzare la visualizzazione dell'elenco di ricerca rapida per le attività.
hideNavigationBar Impostare su True per nascondere la barra di navigazione, altrimenti su False.
hideCommandBar Impostare su True per nascondere la barra dei comandi, altrimenti su False.

Evento di fuoco

Genera un evento definito dall'utente da questo controllo ospitato.

Parametro Descrizione
nome Nome dell'evento definito dall'utente.

Tutte le coppie nome/valore successive diventano i parametri dell'evento. Ulteriori informazioni: Creare un evento definito dall'utente

GetSelectedIds

Questa azione viene utilizzata per recuperare gli ID selezionati dagli elenchi.

Parametro Descrizione
Vedi descrizione Il parametro data deve specificare il nome dell'elenco da cui acquisire gli ID selezionati.

Il valore restituito contiene un elenco di ID delimitato da punto e virgola contenente gli elementi selezionati.

GetSelectedCount

Questa azione recupera il numero di elementi selezionati. Utilizza l'azione GetSelectedIds per ottenere l'elenco effettivo di ID per l'entità.

Parametro Descrizione
Vedi descrizione Il parametro data deve specificare il nome dell'elenco da cui recuperare gli ID selezionati.

Il valore di ritorno contiene un numero che rappresenta la quantità di articoli selezionati.

Vai a casa

Questa azione passa all'URL iniziale specificato per questa istanza del browser.

Goback

Questa azione equivale a selezionare il pulsante Indietro nell'istanza del browser.

Vai avanti

Questa azione equivale a selezionare il pulsante Avanti nell'istanza del browser.

Sposta su Panel

Questa azione sposta un controllo ospitato della pagina di Unified Interface in un pannello diverso in fase di esecuzione.

Parametro Descrizione
Vedi descrizione Il parametro data deve specificare il nome del pannello di destinazione in cui spostare il controllo ospitato (ad esempio, FloatingPanel).

Questa azione viene usata per passare all'URL di un'app basata su modello. L'ID app per l'app selezionata dalla finestra Seleziona modulo app viene aggiunto automaticamente.

Parametro Descrizione
URL L'URL a cui accedere. Si tratta di un parametro obbligatorio.
NascondiBarra dei comandi Se questo parametro viene specificato e True, il frame interno viene visualizzato senza caricare la barra dei comandi dell'app basata su modello.
HideNavigationBar Se questo parametro viene specificato e True, il modulo viene visualizzato senza caricare la barra di spostamento dell'app basata su modello.
Cornice Quando nella pagina sono presenti frame, questo parametro specifica il nome del frame in cui navigare, anziché spostarsi nella finestra principale.
dati postali Dati inviati al server come parte di una transazione HTTP POST. Una transazione POST viene in genere utilizzata per inviare i dati raccolti da una pagina HTML. In Unified Service Desk, questi dati possono essere ricevuti da qualsiasi evento attivato utilizzando "'https://event/?'". Esempio: [[postdata]+]

In alternativa, i dati possono essere passati come stringa codificata con il tipo di intestazione nel formato previsto.
intestazione Un valore stringa che contiene intestazioni HTTP aggiuntive da inviare al server. Quando il parametro postdata viene utilizzato nell'azione Naviga , è necessario specificare anche un valore appropriato per il parametro di intestazione, ad esempio Content-Type: application/x-www-form-urlencoded

Se un evento POST di Unified Service Desk attiva l'azione Naviga , il valore predefinito di questo parametro deve essere header=[[header]+]

Per aggiungere più intestazioni, il valore di questo parametro deve essere:

header=$Multiline(intestazioni separate da nuova riga)

Esempio: header=$Multiline(accessToken;dummyAccessToken==

refreshToken;dummyRefreshToken===)

New_CRM_Page

Crea una pagina per la creazione di un nuovo record dell'entità specificata e considera la pagina come una finestra popup dal controllo ospitato specificato. Le regole di navigazione della finestra vengono valutate per determinare la posizione in cui viene visualizzata la pagina per creare il record dell'entità.

Parametro Descrizione
NomeLogico Nome logico dell'entità per la creazione di una nuova istanza.

Annotazioni

Il resto dei parametri deve essere costituito da coppie nome/valore. Questi sono i valori precompilati aggiuntivi nel modulo per la creazione di un nuovo record per l'entità specificata.

Open_CRM_Page

Apre un'istanza esistente dell'entità specificata e identificata dall'ID e considera la pagina come una finestra popup del controllo ospitato specificato. Le regole di navigazione della finestra vengono valutate per determinare la posizione in cui deve essere visualizzata la finestra popup.

Parametro Descrizione
NomeLogico Nome logico dell'entità da aprire.
Id L'ID del record dell'entità da aprire.

"Popup" un URL dal controllo ospitato ed esegue le regole di navigazione della finestra su di esso per instradare la finestra popup alla posizione appropriata.

Parametro Descrizione
URL Instrada una finestra popup da questo controllo ospitato utilizzando questo URL come se si trattasse di una finestra popup richiesta dal controllo visualizzato.
cornice Il frame da cui ha avuto origine questa finestra popup.

RiallineaFinestra

Visualizza il controllo ospitato nella posizione specificata su un monitor. È possibile visualizzare i controlli ospitati su un massimo di due monitor. Questa azione è applicabile alle istanze di controllo ospitato configurate per essere inserite in un tipo di pannello USDFloatingPanel o USDFloatingToolPanel.

Parametro Descrizione
schermo Specifica la schermata in cui visualizzare il controllo ospitato. I valori validi sono 1 o 2. Se non si specifica questo parametro, per impostazione predefinita viene passato 1.
sinistra Specifica la posizione, in percentuale, a partire dalla sinistra dello schermo sul monitor di destinazione in cui deve essere visualizzato il controllo ospitato. I valori validi sono compresi tra 0 e 100. Se non si specifica questo parametro, per impostazione predefinita viene passato 0.
In alto Specifica la posizione, in percentuale, dalla parte superiore dello schermo sul monitor di destinazione in cui deve essere visualizzato il controllo ospitato. I valori validi sono compresi tra 0 e 100. Se non si specifica questo parametro, per impostazione predefinita viene passato 0.
Larghezza Specifica la larghezza, in percentuale, della finestra di controllo ospitata sul monitor di destinazione. I valori validi sono compresi tra 1 e 100. Se non si specifica questo parametro, per impostazione predefinita viene passato 100.
altezza Specifica l'altezza, in percentuale, della finestra di controllo ospitata sul monitor di destinazione. I valori validi sono compresi tra 1 e 100. Se non si specifica questo parametro, per impostazione predefinita viene passato 100.

Aggiorna

Questa azione aggiorna la pagina corrente.

Esegui script

Questa azione inserisce JavaScript nel frame principale dell'applicazione. È consigliabile evitare di utilizzare le chiamate SDK client Microsoft Dataverse con questa azione; Usare invece l'azione RunXrmCommand .

Parametro Descrizione
Vedi descrizione Il parametro data è il codice JavaScript che viene inserito nel modulo. Nota: I parametri di sostituzione possono essere utilizzati nello script e vengono sostituiti prima dell'esecuzione dello script.
Cornice Quando nella pagina sono presenti frame, questo parametro specifica il nome del frame in cui inserire il codice JavaScript.

EseguiXrmComando

Questa azione viene utilizzata per eseguire il codice JavaScript che utilizza le informazioni di riferimento all'API client delle app basate su modello nelle pagine di Unified Interface (moduli di entità e griglie).

È necessario configurare lo script come funzione delle app basate su modello JavaScript webResource. Il primo parametro della funzione è un parametro di contesto (parametro riservato) che può avere uno dei seguenti valori:

  • FormContext nelle pagine del modulo dell'entità
  • GridContext nelle pagine della griglia di entità
  • undefined in altre pagine
Parametro Descrizione
webResourceName Il nome della risorsa web in cui è presente la funzione JavaScript che si desidera eseguire.
functionName Nome della funzione.

Gli altri parametri della funzione sono definiti dal cliente e possono essere utilizzati per passare i parametri di sostituzione di Unified Service Desk in fase di esecuzione. Questa azione accetta un elenco di parametri facoltativi senza chiavi. L'elenco dei parametri facoltativi viene passato come argomenti nello stesso ordine dalla seconda posizione dopo la sostituzione del contesto in fase di esecuzione.

Esempio

Si desidera eseguire l'azione RunXrmCommand per compilare gli attributi del modulo di un modulo dell'entità, in cui il modulo dell'entità è ospitato da un tipo di controllo ospitato di pagina Unified Interface. Il valore che si desidera inserire, dal punto di vista di Unified Service Desk, è un parametro di sostituzione.[[$Context.Key1]]

Per eseguire l'azione, è necessario scrivere una risorsa web di tipo JavaScript (ad esempio, webResource1) e quindi scrivere una funzione nella risorsa web.

function fillAttributeValue(context, attrValue)
{
 context.getAttribute(<attributeName>).setValue(attrValue);
}   

È necessario configurare i dati nell'invito all'azione come segue:

webResourceName = webResource1
functionName = fillAttributeValue
'[[$Context.Key1]]'

Annotazioni

Nell'esempio precedente, osservare le virgolette singole intorno al parametro di sostituzione, [[$Context.Key1]]. Unified Service Desk considera solo il valore del parametro (non il tipo di dati) e passa tutti i caratteri nel valore sostituito dal contesto alla funzione JavaScript. È necessario essere cauti e prestare attenzione al tipo di dati durante la configurazione.

SetSize

Questa azione imposta in modo esplicito la larghezza e l'altezza del controllo ospitato. Ciò è utile quando si utilizza "auto" nei layout dei pannelli.

Parametro Descrizione
Larghezza Larghezza del controllo ospitato.
altezza Altezza del controllo ospitato.

SalvaEChiudi

Questa azione salva i dati "dirty" nel modulo dell'app basata su modello e chiude il controllo ospitato.

SalvaTutto

Questa azione salva tutti i moduli in un controllo ospitato che consente la visualizzazione di più pagine (Consenti più pagine = Sì). Se il controllo ospitato consente la visualizzazione di una sola pagina (Consenti più pagine = No), ciò equivale all'azione Salva .

Salvare

Questa azione salva la pagina Unified Interface corrente.

Eventi predefiniti

A questo tipo di controllo ospitato sono associati gli eventi predefiniti seguenti.

AttivoChiuso

Si verifica quando il controllo ospitato attivo viene chiuso utilizzando l'azione CloseActive .

Parametro Descrizione
URL L'URL visualizzato nel controllo ospitato quando è stato chiuso.

Pronto per i dati

Si verifica non appena le informazioni correlate per un record di entità vengono caricate nel contesto di Unified Service Desk. Questo evento si verifica prima dell'evento PageReadyFor . Se l'opzione Pre-Fetch Data è selezionata per l'istanza di controllo, questo evento si verifica non appena i dati dell'entità vengono recuperati in una chiamata parallela separata al server e non attende il completamento del caricamento dell'intera pagina. I dati dell'entità vengono preletti e l'evento DataReady viene generato anche per la navigazione inline.

Annotazioni

Per i dashboard, le risorse Web e le pagine di ricerca, l'evento DataReady non viene generato.

Aggiorna richiesto

Si verifica quando viene richiesto l'aggiornamento nella pagina corrente. L'aggiornamento può essere richiesto premendo il tasto F5 o chiamando l'azione Aggiorna dall'applicazione.

Parametro Descrizione
URL URL visualizzato quando è stato richiesto l'aggiornamento.

Salvato

Si verifica dopo il salvataggio di un record nella pagina dell'app basata su modello.

Parametro Descrizione
newId L'ID assegnato al record appena creato.

Si verifica quando la navigazione avviene all'interno delle app Unified Interface.

Parametro Descrizione
URL L'URL della pagina a cui si è accedi.

Pronto per la pagina

Si verifica al termine del caricamento della pagina. In un tipo di pagina Unified Interface di controllo ospitato, questo evento si verifica dopo che i dati sono stati salvati nell'elenco dei parametri di sostituzione.

Parametro Descrizione
URL L'URL della pagina che ha terminato il caricamento.

Annotazioni

Per i dashboard, le risorse Web e le pagine di ricerca, l'evento DataReady non viene generato.

BrowserWindowReady

L'evento BrowserWindowReady viene richiamato quando la finestra del browser è pronta all'interno dell'applicazione client Unified Service Desk. Utilizzare BrowserWindowReady per dashboard e risorse Web.

OnClickToAct

L'evento OnClickToAct viene richiamato quando l'utente seleziona il campo di comunicazione in uscita (ClickToAct) in un modulo.

È inoltre possibile scrivere controlli personalizzati per generare l'evento della finestra ClickToAct di Channel Integration Framework e passare qualsiasi eventData in conformità con i requisiti aziendali.

Maggiori informazioni: onclicktoact

OnSendKbArticolo

L'evento OnSendKbArticle viene richiamato quando l'utente seleziona Invia nel controllo della Knowledge Base. Gli eventData sono l'URL e il titolo dell'articolo della Knowledge Base che devi passare.

Maggiori informazioni: onsendkbarticle

Annotazioni

È consigliabile non utilizzare window.IsUSD i moduli dell'app basata su modello, ma PageReady o altri eventi elencati in questo argomento.

Vedere anche

Supporto per le app Unified Interface in Unified Service Desk
Procedure dettagliate per la configurazione di Unified Service Desk e Unified Interface
Procedura dettagliata 1: Creare una semplice applicazione agente per le app Unified Interface
Procedura dettagliata 2: Visualizzare una pagina Web esterna nell'applicazione agente
Procedura dettagliata 3: Visualizzare i record delle app Unified Interface nell'applicazione agente
Procedura dettagliata 4: Visualizzare un record di app Unified Interface in una sessione nell'applicazione agente
Procedura dettagliata 5: Visualizzare informazioni avanzate sulla sessione visualizzando il nome della sessione e i dati di panoramica
Procedura dettagliata 6: Configurare il controllo ospitato del debugger nell'applicazione agente
Procedura dettagliata 7: Configurare lo scripting dell'agente nell'applicazione agente