Condividi tramite

Pagina CRM (controllo ospitato)

 

Data di pubblicazione: novembre 2016

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

Utilizza il tipo di controllo ospitato Pagina CRM per caricare un URL o una pagina da Dynamics 365. Quando una pagina Dynamics 365 viene caricata in un controllo ospitato di questo tipo, viene automaticamente eseguita la scansione della pagina per i dati dall'entità e vengono automaticamente popolati i parametri sostitutivi.

Questo tipo di controllo ospitato espone una serie di eventi e di azioni di UII predefiniti che sono univoci per la gestione delle finestre Dynamics 365, tra cui le azioni di modifica di elenchi e l'azione di ricerca per la visualizzazione di ricerche rapide o la pagina di ricerca avanzata

In questo argomento

Creare un controllo ospitato Pagina CRM

Azioni UII predefinite

Eventi predefiniti

Creare un controllo ospitato Pagina CRM

Durante la creazione di un nuovo controllo ospitato, i campi della 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 che sono univoci per il tipo di controllo ospitato Pagina CRM. Per informazioni dettagliate sulla creazione di un controllo ospitato, vedere Creare o modificare un controllo ospitato.

Controllo ospitato della pagina Dynamics 365

Nella schermata Nuovo controllo ospitato :

  • Nell'area Unified Service Desk selezionare Pagina CRM nell'elenco a discesa Tipo componente USD.

  • Dall'elenco a discesa Consenti più pagine, seleziona No (valore predefinito) per sostituire la pagina Dynamics 365 al momento visualizzata, e aggiorna la cronologia del browser quando Unified Service Desk riceve un invito all'azione di spostamento o una pagina viene indirizzata alla scheda. Seleziona Sì per creare automaticamente un elenco a discesa quando viene chiamato un secondo URL o una regola di spostamento finestre indirizza una pagina alla scheda. In questo modo l'utente può cercare rapidamente tra le pagine di Dynamics 365 associate al controllo. Inoltre, quando selezioni Sì, diventa disponibile un altro campo Numero max browser in cui sarà possibile specificare il numero massimo di pagine da visualizzare nell'elenco a discesa.

  • Nell'elenco a discesa Tipo di hosting viene specificata la modalità di hosting di questo controllo. Puoi scegliere Processo IE (impostazione predefinita) o WPF interno . Per ulteriori informazioni, vedere Selezionare un metodo di hosting per i controlli.

  • 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 all'esterno di una sessione cliente. I controlli quali il dashboard, la bacheca o la ricerca degli agenti sono utilizzi comuni dei controlli ospitati globali. I controlli ospitati globali non hanno uno stato specifico della sessione, pertanto quando si modificano le sessioni, questi stessi controlli ospitati globali vengono mantenuti. Se la casella di controllo non è selezionata, il controllo ospitato diventa basato sulla sessione. I controlli basati sulla sessione esistono nel contesto della sessione cliente. Se l'utente passa a un'altra sessione, tutte le pagine della sessione precedente vengono nascoste.

  • Il campo Gruppo di visualizzazione visualizza il pannello in cui viene visualizzato il controllo ospitato.MainPanel è il pannello più comune per questo tipo di controllo ospitato. Per informazioni sui vari pannelli disponibili in Unified Service Desk, vedere Pannelli, tipi di pannello e layout dei pannelli in Unified Service Desk.

Per informazioni su altri campi Generale, vedere Creare o modificare un controllo ospitato.

Azioni UII predefinite

Si tratta delle azioni predefinite per il tipo di controllo ospitato.

AssociatedView

L'azione carica una visualizzazione associata specifica di Dynamics 365. Queste visualizzazioni in genere sono accessibili facendo clic sulla freccia in giù accanto al nome del record dell'entità nella barra di spostamento e selezionando entità collegate.

Parametro

Descrizione

navItemName

L'entità associata che si desidera visualizzare. Esempio: casi

ID

ID del record dell'entità principale per il quale visualizzare i record di entità associati.

tabset

L'area in Dynamics 365. Esempi: areaSales o areaService.

Per ulteriori informazioni sull'uso di questa azione, vedere il passaggio 5 in Procedura dettagliata 7: configurare lo scripting dell'agente nell'applicazione dell'agente.

Chiusura

Questa azione viene utilizzata per chiudere il controllo ospitato. A differenza dell'azione CloseActive, se in questa scheda (controllo ospitato) viene visualizzata più di una pagina, tutte le pagine visualizzate nella scheda verranno chiuse nell'applicazione dell'agente.

CloseActive

Questa azione è utilizzata per chiudere la finestra attiva nel controllo ospitato. Se la finestra attiva è l'unica finestra visualizzata nel controllo ospitato, viene chiuso il controllo stesso. Per il tipo Pagina CRM dei controlli ospitati che non consentono più pagine (Consenti più pagine = No), questa azione è equivalente a un'azione Chiudi.

CloseAndPrompt

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

DisableToolbarButton

Questa azione disabilita il pulsante della barra degli strumenti specificato nell'applicazione dell'agente.

Parametro

Descrizione

Nome del pulsante della barra degli strumenti da disabilitare.

EnableToolbarButton

Questa azione abilita il pulsante della barra degli strumenti specificato nell'applicazione dell'agente.

Parametro

Descrizione

Nome del pulsante della barra degli strumenti da abilitare.

Trova

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

Parametro

Descrizione

Il parametro dati deve specificare il nome logico dell'entità della visualizzazione elenco di ricerca rapida da visualizzare. Esistono alcuni valori di caso speciali:

  • Utilizzare caso o incidente per visualizzare la visualizzazione a elenco di ricerca rapida per i casi.

  • Utilizzare advfind per la visualizzazione della ricerca avanzata.

  • Utilizzare attività o caso per la visualizzazione elenco della ricerca rapida per le attività.

FireEvent

Genera un evento definito dall'utente dal controllo ospitato.

Parametro

Descrizione

nome

Nome dell'evento definito dall'utente.

Tutte di coppie successive di name=value diventano i parametri dell'evento. Per ulteriori informazioni sulla creazione di un evento definito dall'utente, vedere Creare un evento definito dall'utente.

GetSelectedIds

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

Parametro

Descrizione

Il parametro dati deve specificare il nome dell'elenco per acquisire gli ID selezionati.

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

GetSelectedCount

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

Parametro

Descrizione

Il parametro dati deve specificare il nome dell'elenco per richiamare gli ID selezionati.

Il valore restituito contiene un numero che rappresenta la quantità di elementi selezionati.

GoHome

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

GoBack

Questa azione è equivalente a fare clic sul pulsante Indietro nell'istanza del browser.

GoForward

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

LoadArea

Questa azione carica un'area specifica da Dynamics 365. Questo equivale a selezionare un'area nel riquadro di navigazione (ad esempio Vendite, servizi e marketing). L'unico parametro è il nome dell'area da selezionare. Ad esempio: areaService.

Parametro

Descrizione

frame

Il nome del frame da applicare. Se non viene specificato un nome, verrà automaticamente destinato al primo frame disponibile nella pagina.

LookupInfo

Visualizza una finestra di informazioni di ricerca Dynamics 365 per consentire a un utente di selezionare un'entità da un elenco.

Parametro

Descrizione

AllowFilterOff

"0 " o "1 " per consentire all'utente di disattivare il filtro

DefaultType

Nome logico della visualizzazione predefinita. Deve essere uno di valori numerici specificati nel parametro objecttypes.

DefaultViewId

"0 " o "1 " per visualizzare la visualizzazione predefinita

DisableQuickFind

"0 " o "1 " per visualizzare il campo di ricerca rapida

DisableViewPicker

"0 " o "1 " per visualizzare il selettore di visualizzazione

LookupStyle

Singolo o multiplo

ShowNewButton

"0 " o "1 " per visualizzare il pulsante nuovo

ShowPropButton

"0 " o "1 " per visualizzare il pulsante delle proprietà

Esplora

"0 " o "1 " se utilizzare la modalità di esplorazione. Il seguente è con questo impostato su "1".

Currentid

GUID per il valore corrente

objecttypes

Elenco di tipi di oggetto da visualizzare. Questi sono i tipi etc da Dynamics 365. Esempio: "1,2" per visualizzare account e contatti.

MoveToPanel

Questa azione sposta un controllo ospitato di una pagina CRM in un pannello diverso in fase di esecuzione.

Parametro

Descrizione

Il parametro dati deve specificare il nome del pannello di destinazione in cui spostare il controllo ospitato. Ad esempio: FloatingPanel.

Spostamento

Questa azione è utilizzata per passare a un URL di Dynamics 365.

Parametro

Descrizione

URL

URL a cui passare. Questo parametro è obbligatorio.

Noscan

Se questo parametro è specificato ed impostato su Vero, i parametri dati non verranno acquisiti dalla pagina.

HideCommandBar

Se questo parametro è specificato e impostato su Vero, verrà visualizzato il modulo interno senza caricare la barra dei comandi di Dynamics 365.

HideNavigationBar

Se questo parametro è specificato e impostato su Vero, verrà visualizzato il modulo interno senza caricare la barra di navigazione di Dynamics 365.

Frame

Se esiste un frame nella pagina, il parametro specifica il nome del modulo a cui passare anziché passare alla finestra principale.

postdata

Dati inviati al server come parte di una transazione HTTPPOST. Una transazione POST viene utilizzata in genere per l'invio di dati raccolti da una pagina HTML. In Unified Service Desk, questi dati possono essere ricevuti da qualsiasi evento attivato utilizzando "http://event/?". Esempio: [[postdata]+]

In alternativa, i dati possono essere passati come stringa codificata con il tipo di intestazione nel formato richiesto.

header

Valore di stringa che contiene le intestazioni HTTP aggiuntive da inviare al server. Quando il parametro postdata è utilizzato nell'azione Navigate, puoi specificare anche il valore appropriato per il parametro header. Esempio: Content-Type:application/x-www-form-urlencoded

Se un evento POST di Unified Service Desk avvia l'azione Navigate, il valore predefinito del parametro deve essere header=[[header]+]

New_CRM_Page

Crea una pagina per la creazione di un nuovo record di Dynamics 365 dell'entità specificata e la considera come una pagina di popup dal controllo ospitato specificato. Le regole di spostamento finestre sono valutate per determinare la posizione in cui viene visualizzata la pagina per creare il record dell'entità.

Parametro

Descrizione

LogicalName

Nome logico dell'entità per creare una nuova istanza.

Nota

Il resto dei parametri deve essere costituito da coppie name=value. Sono i valori aggiuntivi già popolati nel modulo per la creazione di un nuovo record per l'entità specificata. Per ulteriori informazioni sull'uso di questa azione, vedere il passaggio 4 in Procedura dettagliata 7: configurare lo scripting dell'agente nell'applicazione dell'agente.

Open_CRM_Page

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

Parametro

Descrizione

LogicalName

Nome logico dell'entità da aprire.

ID

ID del record dell'entità da aprire.

Visualizza un URL dal controllo ospitato ed esegue le regole di spostamento finestre su di esso per indirizzare il popup nella posizione appropriata.

Parametro

Descrizione

URL

Indirizza un popup da questo controllo ospitato utilizzando questo URL come se fosse un popup richiesto dal controllo visualizzato.

frame

Frame da cui ha avuto origine il popup.

RealignWindow

Visualizza il controllo ospitato nella posizione specificata su un monitor. Puoi visualizzare un controllo ospitato su un massimo di due monitor. Questa azione è applicabile per le istanze di controlli ospitati configurate per essere posizionate in un tipo di pannello USDFloatingPanel o USDFloatingToolPanel.

Parametro

Descrizione

screen

Specifica lo schermo su cui visualizzare il controllo ospitato. I valori validi sono 1 o 2. Se non specifichi questo parametro, per impostazione predefinita viene passato il valore 1.

left

Specifica la posizione, in percentuale, dalla sinistra dello schermo al monitor di destinazione in cui deve essere visualizzato il controllo ospitato. I valori validi sono compresi tra 0 e 100. Se non specifichi questo parametro, per impostazione predefinita viene passato il valore 0.

top

Specifica la posizione, in percentuale, dalla parte superiore dello schermo al monitor di destinazione in cui deve essere visualizzato il controllo ospitato. I valori validi sono compresi tra 0 e 100. Se non specifichi questo parametro, per impostazione predefinita viene passato il valore 0.

width

Specifica la larghezza, in percentuale, della finestra del controllo ospitato sul monitor di destinazione. I valori validi sono compresi tra 1 e 100. Se non specifichi questo parametro, per impostazione predefinita viene passato il valore 100.

height

Specifica l'altezza, in percentuale, della finestra del controllo ospitato sul monitor di destinazione. I valori validi sono compresi tra 1 e 100. Se non specifichi questo parametro, per impostazione predefinita viene passato il valore 100.

Aggiorna

Questa azione aggiorna la pagina corrente.

ReRoute

L'azione invia l'URL al momento visualizzato attraverso le regole di spostamento finestre dal controllo ospitato corrente come finestra di popup.

RunScript

Questa azione inserisce JavaScript nel frame principale dell'applicazione. È consigliabile evitare di utilizzare le chiamate SDK del client di Dynamics 365 con questa azione; bensì, utilizzare l'azione RunXrmCommand.

Parametro

Descrizione

Il parametro dati è il codice JavaScript che verrà inserito nel modulo.

Nota

I parametri sostitutivi possono essere utilizzati nello script e verranno sostituiti prima dell'esecuzione dello script.

RunXrmCommand

Questa azione viene utilizzata per inserire Javascript di Dynamics 365 SDK nel modulo Dynamics 365.

Parametro

Descrizione

Il parametro dati è il codice JavaScript che verrà inserito nel modulo.

Nota

I parametri sostitutivi possono essere utilizzati nello script e verranno sostituiti prima dell'esecuzione dello script.

SetSize

Questa azione imposta in modo esplicito la larghezza e l'altezza del controllo ospitato. È particolarmente utile quando si utilizza "auto" nei layout pannello.

Parametro

Descrizione

width

Larghezza del controllo ospitato.

height

Altezza del controllo ospitato.

SaveAndClose

Questa azione salva i dati modificati nel modulo Dynamics 365 e chiude il controllo ospitato.

Saveall

Questa azione salva tutti i moduli nel controllo ospitato e ciò 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), si tratta di un'azione equivalente a Salva.

Salva

Questa azione salva la pagina CRM corrente.

ToggleRibbon

Questa azione comprime o espande la barra multifunzione. Se si nasconde la barra multifunzione nell'azione Naviga, questa non verrà visualizzata e l'azione non funzionerà. Questa azione funzionerà solo se inizialmente è stata caricata la barra multifunzione.

ToggleNavigation

Questa azione comprime o espande il riquadro di spostamento nel pannello di sinistra della finestra Dynamics 365. Affinché questa azioni funzioni, lo spostamento deve contenere un riquadro di spostamento.

Eventi predefiniti

Gli eventi predefiniti seguenti sono associati a questo tipo di controllo ospitato.

ActiveClosed

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.

BrowserDocumentComplete

Si verifica al completamento del caricamento della pagina. In un tipo Pagina CRM del controllo ospitato, questo evento si verifica dopo che i dati sono stati salvati nell'elenco del parametro sostitutivo. Questo evento si verifica una sola volta, anche se più frame avranno eventi di BrowserDocumentComplete generati automaticamente.

Parametro

Descrizione

URL

L'URL della pagina che ha completato il caricamento.

PageLoadComplete

Si verifica in qualsiasi momento durante il completamento del caricamento del frame. Questo evento si può verificare più volte per caricamento della pagina quando un iFrame o un frame viene utilizzato nella pagina. Questo evento corrisponde a singoli eventi BrowserDocumentComplete nel codice.

Parametro

Descrizione

frame

Il nome del frame che ha completato il caricamento, se disponibile.

URL

L'URL del frame che ha completato il caricamento.

PopupRouted

Si verifica dopo l'indirizzamento di un popup dal sistema.

Parametro

Descrizione

URL

L'URL della finestra popup che è stato indirizzato.

RefreshRequested

Si verifica quando è necessario un aggiornamento della pagina corrente. L'aggiornamento potrebbe essere necessario premendo il tasto F5 o richiamando l'azione Aggiorna da parte dell'applicazione.

Parametro

Descrizione

URL

L'URL visualizzato quando è necessario un aggiornamento.

Salvato

Si verifica dopo il salvataggio di un record della pagina Dynamics 365.

Parametro

Descrizione

newId

L'ID assegnato al record appena creato.

Vedere anche

Interazione CRM (controllo ospitato)
Azioni di UII
Eventi
Procedura dettagliata 3: visualizzare record di Microsoft Dynamics 365 nell'applicazione agente
Tipi di controllo ospitato e riferimento ad azioni o eventi
Guida all'amministrazione di Unified Service Desk per Microsoft Dynamics CRM

Unified Service Desk 2.0

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright

  • Last updated on