Monitoraggio delle dipendenze dei componenti della soluzione

Le soluzioni sono costituite da componenti della soluzione. Usare l'area Soluzioni in Microsoft Dataverse per creare o aggiungere componenti della soluzione. È possibile eseguire queste azioni a livello di programmazione utilizzando il messaggio AddSolutionComponentRequest o qualsiasi messaggio che crea o aggiorna componenti di soluzione che includano un parametro SolutionUniqueName.

I componenti di soluzione dipendono spesso da altri componenti di soluzione. Non è possibile eliminare alcun componente di soluzione che dipende da un altro componente di soluzione. Ad esempio, una barra multifunzione personalizzata in genere richiede risorse Web di immagine o di script per visualizzare le icone ed eseguire le azioni tramite gli script. Fintanto che la barra multifunzione personalizzata è nella soluzione, le specifiche risorse Web che essa utilizza sono obbligatorie. Prima di poter eliminare le risorse Web è necessario rimuovere i riferimenti ad esse nella barra multifunzione personalizzata. È possibile visualizzare queste dipendenze dei componenti della soluzione nell'applicazione selezionando Mostra dipendenze.

In questo articolo vengono descritti i tipi di componenti di soluzione che è possibile includere nelle soluzioni e le dipendenze esistenti tra loro.

Tutti i componenti della soluzione

La colonna di scelta globale del sistema componenttype contiene l'elenco completo dei tipi di componenti della soluzione disponibili. È possibile visualizzare l'intervallo di valori supportato per questa proprietà includendo il file OptionSets.cs o OptionSets.vb nel progetto. Tuttavia, molti dei tipi di componenti della soluzione elencati sono disponibili solo per uso interno e l'elenco non fornisce informazioni sulle relazioni tra i componenti della soluzione.

Dipendenze dei componenti della soluzione

Le dipendenze dei componenti della soluzione garantiscono un'esperienza affidabile quando si lavora con le soluzioni. impediscono che azioni che si svolgono normalmente possano rovinare involontariamente alcune personalizzazioni definite in una soluzione. Le dipendenze consentono di installare e disinstallare una soluzione gestita semplicemente importando o eliminando una soluzione.

Il framework delle soluzioni tiene automaticamente traccia delle dipendenze per i componenti della soluzione. Ogni operazione su un componente di soluzione calcola automaticamente tutte le dipendenze con altri componenti nel sistema. Il sistema usa le informazioni sulle dipendenze per mantenere l'integrità e impedire operazioni che potrebbero causare uno stato incoerente.

In seguito al rilevamento delle dipendenze, vengono applicati i comportamenti seguenti:

L'eliminazione di un componente è impedita se un altro componente del sistema dipende da esso.
L'esportazione di una soluzione avvisa se sono presenti componenti mancanti che potrebbero causare errori durante l'importazione di tale soluzione in un altro ambiente.

È possibile ignorare gli avvisi durante l'esportazione se si prevede che la soluzione venga installata solo in un ambiente in cui si prevede che esistano componenti dipendenti. Ad esempio, quando si crea una soluzione progettata per essere installata sopra una soluzione "base" preinstallata.
L'importazione di una soluzione non riesce se la soluzione non include tutti i componenti necessari e l'ambiente di destinazione non li ha già.
Quando si importa una soluzione gestita, tutti i componenti necessari devono corrispondere al tipo di pacchetto della soluzione. Un componente in una soluzione gestita può dipendere solo da un altro componente gestito.

Vi sono tre tipi di dipendenza dei componenti di una soluzione:

Soluzione interna. Dataverse gestisce le dipendenze interne. Queste dipendenze esistono quando un determinato componente della soluzione non può esistere senza un altro componente della soluzione.
Pubblicato. Dataverse crea dipendenze pubblicate quando due componenti della soluzione sono correlati tra loro e vengono poi pubblicati. Per rimuovere questo tipo di dipendenza, è necessario rimuovere l'associazione e pubblicare di nuovo le tabelle.
Non pubblicato. Le dipendenze non pubblicate si applicano alla versione non pubblicata di un componente di soluzione pubblicabile che viene aggiornato. Dopo aver pubblicato il componente della soluzione, diventa una dipendenza pubblicata.

Le dipendenze interne della soluzione sono dipendenze in cui le azioni con un componente di soluzione richiedono un'azione per un altro componente di soluzione. Ad esempio, se si elimina una tabella, si prevede che tutti gli attributi della tabella vengano eliminati con essa. Il sistema elimina anche eventuali relazioni di tabella con altre tabelle.

Una dipendenza interna, tuttavia, potrebbe portare a una dipendenza pubblicata e richiedere quindi interventi manuali. Ad esempio, se si include un campo di ricerca in un modulo di tabella e quindi si elimina la tabella primaria nella relazione, non è possibile completare l'eliminazione finché non si rimuove la colonna di ricerca dal modulo della tabella correlata e quindi si pubblica il modulo.

Quando si eseguono azioni a livello di codice con le soluzioni, usare i messaggi correlati alla Dependency tabella. Vai a Dependency Entity per i messaggi utilizzabili per identificare le dipendenze che possono esistere prima di eliminare un componente o disinstallare una soluzione.

Componenti di soluzione comuni

Questi componenti della soluzione vengono visualizzati nell'applicazione. Li usi direttamente quando aggiungi o rimuovi componenti della soluzione tramite la pagina della soluzione. Ognuno degli altri tipi di componenti della soluzione dipende da uno o più di questi componenti della soluzione.

Barre multifunzione dell'applicazione
Entità
Report
Modello di articolo
Profilo di sicurezza delle colonne
Passaggio di elaborazione messaggi SDK
Ruolo di connessione
Modello di stampa unione
Ruolo di sicurezza
Modello di contratto
set di opzioni
Endpoint di servizio
Dashboard o modulo entità
Assemblaggio del plug-in
Mappa del sito
Modello e-mail
Process
Risorsa Web

Barre multifunzione applicazione (RibbonCustomization)

Personalizzazioni del Ribbon dell'applicazione e modelli del Ribbon della tabella. Le barre multifunzione dell'applicazione non includono le definizioni delle barre multifunzione a livello di tabella o modulo.

Le ribbon personalizzate dell'applicazione spesso dispongono di dipendenze pubblicate nelle risorse web. Usare le risorse Web per definire le icone dei pulsanti della barra multifunzione e le funzioni JavaScript che controllano quando vengono visualizzati gli elementi della barra multifunzione o quali azioni vengono eseguite quando viene usato un particolare controllo della barra multifunzione. Le dipendenze vengono create solo quando le definizioni della barra multifunzione usano la $webresource: direttiva per associare la risorsa Web alla barra multifunzione. Per altre informazioni, vedere $webresource directive.

Modello di articolo (KBArticleTemplate)

Modello che contiene gli attributi standard di un articolo. Esiste sempre una dipendenza interna tra il modello di articolo e la tabella KbArticle.

Ruolo di connessione (ConnectionRole)

Ruolo che descrive una relazione tra due record. Ogni ruolo di connessione definisce i tipi di record di entità che possono essere collegati usando il ruolo di connessione. Questo ruolo crea una dipendenza pubblicata tra il ruolo di connessione e la tabella.

Modello di contratto (ContractTemplate)

Modello che contiene gli attributi standard di un contratto. Esiste sempre una dipendenza interna tra il modello di contratto e la tabella contratto.

Modulo entità o dashboard (SystemForm)

Usare i record della tabella dei moduli di sistema per definire dashboard e moduli di tabella. Quando si usa un oggetto SystemForm come modulo tabella, esiste una dipendenza interna dalla tabella. Quando si usa SystemForm come dashboard, non sono presenti dipendenze interne. I moduli di tabella e i dashboard di solito dispongono di dipendenze pubblicate correlate al contenuto. Un modulo di tabella può avere colonne di ricerca che dipendono da una relazione di tabella. I dashboard e i moduli di tabella possono contenere grafici o sottogriglie che creano una dipendenza pubblicata da una visualizzazione, che quindi ha una dipendenza interna su una tabella. Una dipendenza pubblicata da risorse Web può essere creata a causa del contenuto visualizzato nel dashboard o nel modulo o quando un modulo contiene le librerie JavaScript. I moduli di tabella hanno dipendenze pubblicate relative a qualsiasi attributo visualizzato come colonne nel modulo.

Modello di email (EmailTemplate)

Modello contenente gli attributi standard di un messaggio di posta elettronica. Un modello di email in genere include colonne che inseriscono dati da attributi di tabella specificati. È possibile collegare un modello di posta elettronica a una tabella specifica al momento della creazione, quindi può esserci una dipendenza interna dalla tabella. Un modello di posta elettronica globale non è associato a una tabella specifica, ma potrebbe avere dipendenze pubblicate sugli attributi della tabella usati per fornire dati. Un processo (flusso di lavoro) viene spesso configurato per inviare un messaggio di posta elettronica usando un modello di posta elettronica, creando una dipendenza pubblicata con il flusso di lavoro.

Entità (Entità)

Le tabelle, precedentemente note come entità, sono la struttura principale utilizzata per modellare e gestire i dati in Dataverse. A causa delle dipendenze interne tra di esse, quando si elimina una tabella, si eliminano anche grafici, moduli, relazioni tra tabelle, viste e attributi associati a tale tabella. Le tabelle spesso hanno dipendenze pubblicate con processi, dashboard e modelli di email.

Profilo di sicurezza colonne (FieldSecurityProfile)

Profilo che definisce il livello di accesso per gli attributi protetti.

Modello di stampa unione (MailMergeTemplate)

Modello contenente gli attributi standard di un documento di stampa unione. Un modello di stampa unione dispone di una dipendenza dichiarata sulla tabella a cui è associato.

Set di opzioni (OptionSet)

Una colonna di scelta, precedentemente nota come set di opzioni, definisce un set di opzioni. Un attributo picklist utilizza una scelta multipla per definire le opzioni fornite. Alcuni attributi di elenco a discesa potrebbero utilizzare un'opzione globale affinché le opzioni fornite siano sempre le stesse e possano essere gestite in un'unica posizione. Una dipendenza pubblicata si verifica quando un attributo elenco di selezione fa riferimento a un'opzione globale. Non è possibile eliminare una scelta globale utilizzato da un attributo di elenco a discesa.

Assembly del plug-in (PluginAssembly)

Assembly contenente uno o più tipi di plug-in. I plug-in vengono registrati per gli eventi che normalmente sono associati a una tabella. Questa registrazione crea una dipendenza pubblicata.

Processo (flusso di lavoro)

Set di regole logiche che definiscono i passaggi necessari per automatizzare un processo aziendale specifico, un'attività o un set di azioni da eseguire. I processi forniscono un'ampia gamma di azioni che consentono di creare dipendenze pubblicate su qualsiasi altro componente della soluzione a cui fa riferimento il processo. Ogni processo inoltre dispone di una dipendenza pubblicata sulla tabella a cui è associato.

Report (Report)

Riepilogo dei dati in un layout di semplice lettura. Un report ha pubblicato dipendenze sui dati di attributo o sulle tabelle incluse nel report. Ogni report deve anche essere associato a una categoria di report, creando una dipendenza interna da un componente della soluzione denominato Categoria correlata al report (ReportCategory). È possibile configurare i report come sottoreport, creando una dipendenza pubblicata con il report padre.

Passaggio di elaborazione del messaggio SDK (SDKMessageProcessingStep)

Fase della pipeline di esecuzione in cui un plug-in deve essere eseguito.

Ruolo di sicurezza (Ruolo)

Raggruppamento dei privilegi di sicurezza. Assegnare ruoli di sicurezza agli utenti per autorizzare l'accesso al sistema Dataverse. Associare moduli tabella a ruoli di sicurezza specifici per controllare chi può visualizzare il modulo. Questa associazione crea una dipendenza pubblicata tra il ruolo di sicurezza e il form.

Nota

È possibile aggiungere ruoli di sicurezza solo dalla business unit dell'ambiente a una soluzione. Solo un utente con l'accesso in lettura ai ruoli di sicurezza può aggiungerli a una soluzione.

Endpoint di servizio (ServiceEndpoint)

Endpoint di servizio che è possibile contattare.

Mappa del sito (SiteMap)

Dati XML utilizzati per controllare il riquadro di navigazione dell'applicazione. È possibile collegare la mappa del sito per visualizzare una risorsa Web HTML oppure un'icona nella mappa del sito potrebbe usare una risorsa Web immagine. Quando si usa la $webresource: direttiva per stabilire queste associazioni, si crea una dipendenza pubblicata. Per altre informazioni, vedere $webresource directive.

Risorsa Web (WebResource)

Dati equivalenti ai file utilizzati per estendere un app basata su modello o nello sviluppo web. Le risorse Web forniscono componenti lato client utilizzati per fornire elementi di interfaccia utente personalizzati. Le risorse Web potrebbero disporre di dipendenze pubblicate con moduli di tabella, barre multifunzione e mappa del sito. Quando si usa la $webresource: direttiva per stabilire associazioni in una barra multifunzione o nella mappa del sito, si crea una dipendenza pubblicata. Per altre informazioni, vedere $webresource directive.