Libreria dei componenti

Importante

Questa funzionalità è ancora in anteprima pubblica. Per altre informazioni, vedi Funzionalità sperimentali e in anteprima.

Nell'articolo si panoramica per la creazione di componenti, vengono introdotti i componenti dell'app canvas. Quando crei i componenti all'interno di un'app, puoi anche creare una libreria di componenti che possono essere riutilizzati. Creando una libreria di componenti, i creatori di app condividono e aggiornano facilmente uno o più componenti con altri creatori.

Le librerie dei componenti sono contenitori di definizioni dei componenti che semplificano:

  • L'individuazione e la ricerca dei componenti.
  • La pubblicazione degli aggiornamenti.
  • La notifica ai creatori di app degli aggiornamenti dei componenti disponibili.

Nota

Le librerie dei componenti sono il modo consigliato per riutilizzare i componenti nelle app. Quando si utilizza una libreria di componenti, un'app mantiene le dipendenze sui componenti che utilizza. Il creatore dell'app verrà avvisato quando saranno disponibili gli aggiornamenti per i componenti dipendenti. Pertanto, tutti i nuovi componenti riutilizzabili devono essere creati all'interno delle librerie dei componenti. Una precedente funzionalità di Power Apps che consentiva l'importazione di componenti da un'app canvas all'altra sarà deprecata.

Differenza tra un'app e una libreria di componenti

Una libreria di componenti fornisce un repository centralizzato e gestito di componenti per il riutilizzo.

Il riquadro Inserisci di navigazione a sinistra per impostazione predefinita visualizza a una scheda di componenti se crei una libreria di componenti. Quando crei un'app, questa visualizzazione mostra le schermate anziché i componenti.

Le schermate all'interno di una libreria di componenti sono disponibili solo per il test. Fornisce ai creatori di librerie un modo per testare rapidamente i componenti creati su una schermata reale e anche per convalidare il comportamento di aggiornamento in quanto i componenti vengono migliorati nel tempo. Per utilizzare i componenti dalla libreria dei componenti, è necessario creare un'app che utilizza la libreria dei componenti.

Puoi visualizzare l'anteprima dei componenti della libreria utilizzando le schermate all'interno della libreria con l'opzione di riproduzione. Quando selezioni la scheda dei componenti, l'opzione di riproduzione è disabilitata. La libreria dei componenti non viene visualizzata durante l'utilizzo Power Apps per dispositivi mobili.

Nota

La libreria dei componenti discussa in questo articolo è diversa da Power Apps component framework che consente a sviluppatori e creatori di creare componenti di codice per app basate su modelli e canvas. Per ulteriori informazioni, visita Panoramica di Power Apps component framework.

Utilizzo della libreria dei componenti

Puoi creare una nuova libreria di componenti o modificare una libreria di componenti esistente dalla stessa interfaccia. Accedi a make.powerapps.com, seleziona App, quindi Librerie dei componenti:

Crea o modifica la libreria dei componenti

Creare una libreria di componenti di esempio

I passaggi per creare componenti all'interno di una libreria di componenti sono uguali a quelli della creazione di componenti all'interno di un'app. Creerai una libreria di componenti e poi riutilizzerai i passaggi per la creazione di componenti dell'esempio di panoramica dei componenti. Quindi utilizzerai la libreria dei componenti per fornire i componenti riutilizzabili in una nuova app.

  1. Accedi a make.powerapps.com.

  2. Seleziona App nella barra di spostamento a sinistra, seleziona Librerie dei componenti, quindi seleziona Nuova libreria dei componenti.

  3. Assegna un nome alla libreria dei componenti ad esempio Componenti del menu, ma puoi anche fornire un nome diverso a tua scelta.

  4. Segui i passaggi per creare i componenti dell'esempio di panoramica dei componenti. Non devi aprire Power Apps Studio o creare una nuova app vuota perché hai già creato una nuova libreria dei componenti. Inizia con il passaggio 2.

    Dopo aver seguito i passaggi per creare i componenti, segui anche il prossimo set di passaggi per aggiungere i componenti a una schermata e i passaggi per creare la proprietà di output.

  5. Dopo aver completato la creazione e il test dei componenti, salva la libreria dei componenti selezionando il menu File e quindi selezionando Salva.

    Hai anche un'opzione per salvare una nota sulla versione. Una nota sulla versione è utile per recuperare le versioni di una libreria dei componenti e per aggiornare i componenti utilizzati nelle app da questa libreria dei componenti.

    Nota sulla versione durante il salvataggio della libreria dei componenti

    Suggerimento

    Una nota sulla versione è utile durante la revisione delle versioni di una libreria dei componenti e per i creatori di app che utilizzano la libreria dei componenti per rivedere le modifiche e aggiornare le app che utilizzano questi componenti secondo necessità. Vai ad aggiorna una libreria dei componenti per ulteriori dettagli.

  6. È possibile pubblicare una libreria di componenti salvata. Sono disponibili solo gli aggiornamenti della libreria dei componenti pubblicati per le app che utilizzano una libreria dei componenti. Seleziona Pubblica per pubblicare la versione della libreria dei componenti:

    Pubblica la versione della libreria dei componenti

Importare da una libreria di componenti

Dopo aver creato e pubblicato una libreria dei componenti, le app possono utilizzare i componenti di questa libreria importando la libreria. Puoi anche condividere una libreria dei componenti.

Per importare da una libreria di componenti, modifica un'app esistente o crea una nuova app. Dopo l'apertura dell'app canvas in Studio, seleziona Inserisci o il + sulla barra di spostamento a sinistra. Quindi seleziona Ottieni altri componenti per elencare le librerie dei componenti disponibili nell'ambiente corrente:

Ottieni altri componenti

Vedrai l'elenco delle librerie dei componenti disponibili nell'ambiente corrente sul lato destro dello schermo. Seleziona un singolo componente da una libreria dei componenti. In alternativa usa Seleziona tutto per importare tutti i componenti dalla libreria contemporaneamente:

Importa i componenti

Nota

Se un creatore non vede la libreria dei componenti elencata nella sezione di importazione, assicurati che la libreria dei componenti sia condivisa con il creatore. Per ulteriori dettagli vai ad autorizzazioni della libreria dei componenti.

Tieni presente che puoi selezionare e importare più di un componente e tra librerie di componenti diverse.

I componenti disponibili all'interno dell'app sono elencati sotto la categoria Personalizzato nell'elenco dei componenti nel riquadro Inserisci. I componenti disponibili dalle librerie dei componenti importati sono elencati sotto la categoria Componenti della libreria:

Inserisci i componenti nell'app

Aggiornare una libreria dei componenti

Puoi modificare una libreria dei componenti esistente e salvare eventuali modifiche con note aggiuntive sulla versione. Tuttavia, la versione aggiornata della libreria dei componenti deve essere pubblicata per l'utilizzo nelle app esistenti che usano la libreria dei componenti. I passaggi per la libreria dei componenti di esempio precedenti spiegano come pubblicare una libreria dei componenti dopo averla salvata.

I creatori di altre app vengono informati della disponibilità dei componenti aggiornati. La notifica appare quando i creatori modificano le app canvas in Studio. Possono scegliere di aggiornare i componenti:

Aggiornamento disponibile

Seleziona Revisione e vedrai l'opzione per aggiornare il componente:

Aggiorna componente

Tieni presente che la nota sulla versione aggiunta durante la pubblicazione della versione della libreria dei componenti viene visualizzata qui.

Seleziona Aggiorna per aggiornare i componenti.

Autorizzazioni della libreria dei componenti

La condivisione di una libreria dei componenti funziona nello stesso modo in cui condividi un'app canvas. Quando condividi una libreria dei componenti, consenti ad altri di riutilizzare la libreria dei componenti. Una volta condivisa, altri possono modificare la libreria dei componenti e importare componenti da questa libreria dei componenti condivisa per creare e modificare le app. Se condivisa come comproprietario, un utente può utilizzare, modificare e condividere una libreria dei componenti ma non eliminare o cambiare il proprietario.

Limiti noti

  • Le limitazioni note applicabili ai componenti si applicano anche alle librerie dei componenti.

  • Non è possibile importare componenti utilizzando una libreria dei componenti da file di librerie dei componenti salvati localmente. Se tenti di importare una libreria dei componenti salvata localmente utilizzando File > Salva come > Questo computer e scaricando il file della libreria dei componenti come app, viene visualizzato il seguente messaggio di errore:

    Importa un file di libreria dei componenti

  • Non è possibile aggiungere librerie dei componenti esistenti a una soluzione. Tuttavia, puoi creare nuove librerie dei componenti per soluzioni utilizzando il flusso di aggiunta di librerie dei componenti.

  • Se importi un componente da una libreria di componenti, non puoi modificarlo all'interno dell'app che lo utilizza. Se selezioni Modifica componente, vedrai un'opzione per creare una copia del componente all'interno dell'app corrente per consentirti di apportare modifiche:

    Modifica libreria dei componenti

    Se selezioni Crea una copia, il componente viene copiato nell'app locale. La copia locale del componente appare sotto la categoria Personalizzato nel riquadro Inserisci. Questa copia locale del componente non riceverà aggiornamenti se una nuova versione della libreria del componente di origine verrà pubblicata in un secondo momento.

  • Quando un componente viene aggiunto a un'app dalla libreria dei componenti e il tema dell'app viene aggiornato, il componente diventa un componente dell'app locale e non è più associato al componente principale nella libreria dei componenti.

Passaggi successivi

Informazioni sulle formule di comportamento per le app canvas.

Vedi anche

Panoramica dei componenti dell'app canvas e lavorare con i componenti in un'app.