Condividi tramite


Metodi Microsoft.CIFramework (informazioni di riferimento sull'API JavaScript di Dynamics 365 Channel Integration Framework 1.0)

Microsoft CIFramework fornisce metodi per utilizzare l'API JavaScript per gestire il pannello di comunicazione, i record e i moduli nell'app basata su modello Dynamics 365.

Importante

  • Il gestore eventi CIFInitDone deve essere richiamato prima di chiamare le altre API.
  • Il limite di timeout per le API è di 10 secondi. Se le API non vengono eseguite entro 10 secondi, devono essere eseguite di nuovo con i parametri o l'ambito modificati.

API di gestione del pannello di comunicazione

Il pannello di comunicazione è il luogo in cui tu, in qualità di agente, interagisci con il cliente. I widget partner creati utilizzando Channel Integration Framework 1.0 vengono caricati in questo pannello. Il widget in questa versione viene visualizzato a destra dello schermo e supporta le modalità Ancorato e Ridotto a icona.

Utilizza le seguenti API per gestire lo stato del pannello di comunicazione (widget).

Methods Description
setWidth Imposta la larghezza del pannello per tutte le sessioni.
getWidth Ottiene la larghezza del pannello in pixel.
setMode Imposta lo stato del pannello.
getMode Imposta lo stato del pannello.

API per le operazioni CRUD

Utilizzare le API seguenti per eseguire operazioni CRUD sui record di entità.

Methods Description
creareRecord Crea un record di entità.
recuperareRecord Recupera un record di entità.
updateRecord Aggiorna un record di entità.
deleteRecord Elimina un record di entità.

Metodi vari

Methods Description
getEntityMetadata Restituisce i metadati dell'entità specificata.
setClickToAct Imposta un valore booleano per abilitare o disabilitare la comunicazione in uscita (ClickToAct).
getClickToAct Restituisce un valore booleano per indicare se la comunicazione in uscita (ClickToAct) è abilitata o meno.
cercaEApri record Il metodo cerca il record dal widget di comunicazione durante la comunicazione in entrata e apre il record.
getEnvironment Ottiene l'app Unified Interface corrente e i dettagli della pagina. I dettagli includono l'ID applicazione (appid), pageType (pageType), l'ID record (id), l'area geografica dell'organizzazione (orgGeo) e il tipo di navigazione della sessione (navigationType).
openForm Apre un modulo dell'entità o un modulo di creazione rapida.
renderSearchPage Consente di eseguire ricerche tra i record di un particolare tipo di entità. Questa API apre la pagina dell'entità Unified Interface con il campo di ricerca precompilato con la stringa di ricerca passata come parametro.
addHandler Aggiunge il sottoscrittore agli eventi.

Annotazioni

Questa API può essere utilizzata sia nel widget che nella pagina Unified Interface.

removeHandler Rimuove il sottoscrittore dagli eventi.

Annotazioni

Questa API può essere utilizzata sia nel widget che nella pagina Unified Interface.

raiseEvent Richiama il sottoscrittore associato per l'evento.

Annotazioni

Se sono stati creati eventi personalizzati utilizzando il metodo addHandler, è possibile generare tali eventi passando il nome dell'evento come parametro in questo metodo.

updateContext Questo metodo consente di impostare il dizionario di automazione.

Novità del framework di integrazione del canale di Dynamics 365
Requisiti di sistema di Dynamics 365 Channel Integration Framework 1.0