Gestione del ciclo di vita delle applicazioni (ALM) della libreria dei componenti

Una libreria dei componenti è un tipo speciale di app canvas che può contenere uno o più componenti canvas. Questi componenti della libreria possono quindi essere usati da tutte le altre app canvas nell'ambiente. Questa funzionalità consente di creare componenti condivisi riutilizzabili in tutte le app in un ambiente, a differenza dei componenti a livello di app che sono limitati a un'app.

Per utilizzare un componente da una libreria di componenti, devi prima importare il componente nell'app canvas. Una volta importato, puoi quindi aggiungere il componente a qualsiasi schermata dell'app. Qualsiasi aggiornamento nella definizione del componente dalla libreria dei componenti richiederà di rivedere e incorporare la modifica su richiesta o quando l'app viene aperta per la modifica. Le librerie dei componenti e le app dipendenti possono anche essere spostate in un altro ambiente utilizzando le soluzioni Microsoft Dataverse standard.

Quando un componente da una libreria di componenti viene importato in un'app canvas, la definizione di quel componente viene copiata nella definizione dell'app canvas. Una volta che una definizione di componente è stata importata, l'app è "autonoma" per quanto riguarda la definizione di componente. Il creatore di app può scegliere di modificare il componente e creare istanze locali del componente all'interno dell'app. A questo punto non esiste un collegamento diretto alla libreria dei componenti da cui ha avuto origine il componente. Questa caratteristica di autocontenimento si applica anche se l'app canvas viene quindi migrata in un ambiente diverso in cui la libreria dei componenti non è presente. Puoi continuare a creare istanze della definizione del componente importato all'interno delle app nell'ambiente di destinazione e le app possono ancora essere pubblicate e riprodotte. In questo caso non verranno richiesti o ricevuti nuovi aggiornamenti nell'app di consumo.

Per mantenere la relazione tra l'app e la libreria dei componenti, assicurati di utilizzare la libreria dei componenti per apportare modifiche al componente, invece di modificare il componente all'interno dell'app di consumo.

Supporto per le app Canvas e le librerie dei componenti

Coerentemente con le altre dipendenze dell'oggetto della soluzione, se un'app canvas importa un componente canvas da una libreria di componenti, avrà una dipendenza da tale libreria di componenti. Per spostare un'app nel nuovo ambiente, dovrai creare un pacchetto della libreria dei componenti all'interno della stessa soluzione o installarla come prerequisito. La dipendenza dall'app alla libreria dei componenti viene mantenuta nell'ambiente di destinazione. In un secondo momento, quando una libreria di componenti con il componente aggiornato viene importata utilizzando una soluzione nell'ambiente di destinazione, le app esistenti otterranno le nuove definizioni dei componenti utilizzando il normale flusso di aggiornamento dei componenti.

Creazione ed esportazione della libreria dei componenti in una soluzione

È possibile creare una libreria di componenti direttamente dall'interno della soluzione o aggiungerla a una soluzione esistente.

Quando una libreria dei componenti viene salvata in un ambiente che ha Dataverse disponibile, la libreria dei componenti viene aggiunta automaticamente alla soluzione predefinita. Viene generato un nome logico univoco per la libreria dei componenti con il prefisso Editore CDS predefinito. Questo comportamento serve a garantire che il sistema della soluzione sia a conoscenza della sua presenza e possa collegare le dipendenze dalle app che usano il nome logico della libreria dei componenti.

Le librerie di componenti all'interno di una soluzione supportano anche le proprietà gestite Consenti personalizzazioni che regolano il comportamento della libreria dei componenti nell'ambiente di destinazione.

Se disattivi questa impostazione ed esporti la soluzione in un ambiente di destinazione, non potrai modificare la libreria dei componenti.

Dipendenze della libreria dei componenti

Le app che utilizzano componenti della libreria dei componenti verranno contrassegnate come dipendenti nell'infrastruttura delle soluzioni. Questo comportamento si applica a tutte le app aggiunte a qualsiasi soluzione Dataverse in un dato ambiente. Puoi comunque creare app al di fuori delle soluzioni, ma tali app non avranno alcuna dipendenza dalla soluzione. In seguito puoi aggiungere queste app alle soluzioni per renderle parte della soluzione ALM.

Se importi una soluzione che ha solo un'app che utilizza un componente da una libreria dei componenti, ma esclude la libreria dei componenti, vedrai il seguente messaggio:

"Importazione non riuscita a causa di dipendenze mancanti <app name>".

In questo caso, puoi scegliere di installare prima la soluzione della libreria dei componenti o raggruppare la libreria dei componenti con la soluzione che contiene l'app canvas. Uno dei passaggi assicura che l'app disponga della dipendenza creata nell'ambiente di destinazione.

Quando la libreria viene aggiornata e una versione del componente più recente viene importata tramite le soluzioni, l'app riceverà una notifica e riceverà gli aggiornamenti quando l'app viene aperta per la modifica.

Le dipendenze vengono calcolate in base all'ultimo stato pubblicato di un'app. Se ripristini una versione precedente dell'app che non usa un componente della libreria, la dipendenza verrà rimossa dall'app e dalla soluzione. L'importazione di un componente in un'app da una libreria di componenti senza effettivamente utilizzarla crea anche una dipendenza poiché il componente della libreria inutilizzato rimane disponibile all'interno dell'app per un uso futuro.

Procedure consigliate e risoluzione dei problemi

• Limita il numero di componenti in una libreria a 20 per ottenere prestazioni ottimali. Pianifica e crea in anticipo più librerie di componenti poiché è probabile che il numero di componenti in esse aumenterà nel tempo. Questo approccio ridurrà anche il payload della soluzione man mano che le app vengono spostate nell'ambiente.

• C'è un ritardo da quando la libreria dei componenti viene pubblicata a quando è disponibile per l'applicazione e può richiedere fino a 5 minuti.

• Se l'app non è in grado di ricevere l'aggiornamento dal componente della libreria nell'ambiente di destinazione in cui è installata la soluzione, verifica utilizzando le azioni seguenti:

  • Le modifiche apportate a una libreria di componenti in un ambiente di destinazione risiedono nel livello superiore di un componente. Successivamente, queste personalizzazioni definiscono il comportamento di runtime del componente. Per rimuovere queste personalizzazioni non gestite, vedi Rimuovere un livello non gestito.
  • Determinare il nome logico della libreria dei componenti dalla visualizzazione della soluzione. Utilizza la soluzione predefinita se la libreria non è stata aggiunta in modo esplicito alla soluzione.
  • Scarica l'app utilizzando il componente della libreria sul computer locale utilizzando File > Salva con nome > Questo computer. Rinomina il file scaricato in modo che abbia un'estensione .zip e decomprimi il pacchetto. Apri il file Proprietà.json, quindi cerca la parola chiave "LibraryDependencies". Dovresti vedere un nome logico della libreria corrispondente.
  • Se stai utilizzando la soluzione, controlla che l'app canvas abbia identificato correttamente le librerie dei componenti come dipendenze della soluzione. Se la soluzione non identifica correttamente le librerie dei componenti come dipendenze della soluzione, significa che la dipendenza dell'app al collegamento della libreria dei componenti non è stata creata correttamente. In tal caso, verificare con il fornitore della soluzione per risolvere il problema.
  • Se sei l'autore di soluzioni, controlla che le librerie dei componenti siano salvate con il nome logico della libreria nella soluzione e che sia uguale a quella a cui si fa riferimento nel pacchetto .msapp della libreria dei componenti.

• L'esportazione della soluzione esporta sempre l'ultima versione della libreria dei componenti. Quindi, aggiorna sempre le app con l'ultima versione del componente prima di esportarle tramite le soluzioni. Questa azione garantisce che le app abbiano la stessa versione del componente disponibile nell'ultima versione della libreria dei componenti. Le app e la libreria sono considerate sincronizzate tra loro quando vengono spostate per la prima volta in un ambiente di destinazione; e quindi, non viene richiesto alcun aggiornamento disponibile durante la modifica dell'app.

Vedi anche

• Componenti canvas
• Libreria dei componenti
• Mappare i campi di input di un componente
• Aggiungere contenuti multimediali a un componente
• Formule di comportamento per i componenti
• Power Apps component framework
• Aggiungere componenti canvas a una pagina personalizzata in un'app basata su modello