Condividi tramite

Usare il controllo Git version per modificare le app canvas (sperimentale)

  • Articolo

[Questo articolo fa parte della documentazione non definitiva, pertanto è soggetto a modifiche.]

Importante

  • Questa funzionalità è in fase di implementazione e, a seconda della regione, potrebbe non essere ancora disponibile per il tenant. Controlla l'opzione sperimentale descritta in Abilitare il controllo della versione Git per sapere se la funzionalità è disponibile nel tenant.
  • Questa è una funzionalità sperimentale. È disabilitata per impostazione predefinita e deve essere abilitata prima dell'uso.
  • Le funzionalità sperimentali non sono destinate ad essere utilizzate per la produzione e sono soggette a restrizioni. Queste funzionalità sono disponibili prima di una versione ufficiale di modo che i clienti possano ottenere un accesso prioritario e fornire dei commenti.

Puoi utilizzare la funzionalità sperimentale del controllo della versione Git per consentire a più di una persona di modificare un'app canvas contemporaneamente. Con questa funzionalità, gli altri non verranno bloccati dall'app mentre una persona la sta modificando. Man mano che le modifiche vengono apportate e sincronizzate, vengono automaticamente unite ad altre modifiche e rese disponibili a tutti gli utenti che modificano l'app.

Git viene utilizzato come archivio di supporto per questa funzionalità. Dopo la configurazione iniziale con la connessione a Git, qualsiasi utente può utilizzare questa funzionalità senza ulteriori passaggi di configurazione se non per l'autenticazione con Git.

Qualsiasi provider Git può essere utilizzato con Power Apps Studio—come GitHub o Azure DevOps. Utilizza gli strumenti Git esistenti per visualizzare la cronologia delle versioni, creare e gestire richieste pull ed eseguire altre attività di controllo della versione.

Nota

  • Prima di iniziare, assicurati di leggere le limitazioni note di questa funzionalità. L'uso di Git si sta evolvendo e potrebbe cambiare il funzionamento di questa funzionalità. Per aggiornamenti e per condividere il tuo feedback su questa funzionalità, visita il Forum della community di Power Apps.
  • Il controllo della versione di Git è gestito in base all'app. Ogni app deve essere aggiunta singolarmente al controllo della versione di Git.
  • Una volta abilitato il controllo della versione git, il salvataggio automatico della tua app sarà disabilitato. Dovrai salvare o sincronizzare manualmente le modifiche.

Abilitare il controllo della versione di Git

Segui questi passaggi per abilitare il controllo della versione di Git nella tua app.

  1. Crea una nuova app o apri un'app esistente che desideri aggiungere al controllo della versione di Git.

  2. Seleziona Impostazioni in Power Apps Studio.

  3. Seleziona Funzionalità future.

  4. Seleziona Sperimentale.

  5. Scorri verso il basso fino a Mostra l'impostazione di controllo della versione di Git e imposta Attivato.

  6. Vedrai un nuovo elemento Controllo della versione di Git sul lato sinistro del riquadro delle impostazioni.

    Opzione per abilitare il controllo della versione di Git.

    Suggerimento

    Per qualsiasi altro problema con questa funzionalità, visita il Forum della community di Power Apps.

Connettere un'app a Git

Segui questi passaggi per connettere l'app a Git.

  1. Seleziona Impostazioni in Power Apps Studio.

  2. Seleziona Controllo della versione Git.

    Pulsante per avviare una connessione a git per questa app.

  3. Seleziona Connetti e inserisci le informazioni di connessione Git per questa app.

    Caselle di input di testo per fornire informazioni sulla connessione git.

    • URL del repository Git: l'URL che useresti normalmente con gli strumenti Git. Per Azure DevOps, assicurati di includere la parte /_git/repo dell'URL, come https://contoso.visualstudio.com/_git/repo.
    • Ramo: il nome del ramo da utilizzare.
    • Directory: la directory all'interno del ramo da utilizzare. Non puoi archiviare un'app canvas nella radice del ramo.

    Ti verrà chiesto di creare il ramo o la directory se non esiste. Se il ramo e la directory contengono già un'app canvas, l'app corrente verrà chiusa e l'app esistente verrà caricata da Git.

    Una volta connessa, verranno visualizzate le informazioni sulla connessione.

Autenticazione con Git

Power Apps richiede di utilizzare un token di accesso personale invece della password dell'account del provider di controllo della versione.

Nota

Un token di accesso personale non è uguale alla tua password, neanche per Power Apps o per il tuo provider Git. Devi creare un token di accesso personale per utilizzare questa funzionalità.

Diversi provider di controllo della versione hanno metodi diversi per generare i token di accesso personali. Segui le istruzioni di seguito per ottenere un token di accesso personale.

Durante la modifica delle app connesse a Git, ti vengono richiesti nome utente e password. Inserisci il tuo nome utente e il token di accesso in questa finestra di dialogo per autenticarti con Git.

La finestra di dialogo richiede il nome utente Git e il token di accesso (come password).

Nota

Le credenziali Git non vengono archiviate da Power Apps tra le sessioni. Se lo desideri, puoi utilizzare le impostazioni del browser per salvare le informazioni del modulo per il riutilizzo ed evitare di inserire frequentemente le credenziali.

Apportare modifiche all'app

Dopo che un'app è connessa a Git, tutto ciò che devi fare è autenticarti con le credenziali Git per aprire e modificare l'app. Non è necessario esaminare i concetti di Git quando si utilizza questa funzionalità per caricare, modificare, salvare, pubblicare e condividere l'app.

Usa il nuovo pulsante di sincronizzazione nella parte superiore della schermata di Studio (tra i pulsanti Controllo app e Annulla) per unire eventuali modifiche correnti con ciò che è in Git e portare il risultato in Studio per ulteriori modifiche.

Pulsante per sincronizzare le modifiche con il repository Git.

Importante

L'app dovrà essere caricata ogni volta che viene eseguita un'unione. Se l'app è di grandi dimensioni, questo caricamento potrebbe richiedere del tempo.

Una volta connessi a Git, le modifiche vengono memorizzate in Git anziché in Power Apps. Le versioni non pubblicate non appariranno in Maker Portal Power Apps.

Unire i risultati

Al momento non è disponibile alcuna opzione per risolvere i conflitti di unione. Studio tenterà di unire e correggere automaticamente i conflitti attraverso la conoscenza semantica dell'app (ad esempio, i tipi di oggetti e altre modifiche all'app). Poiché tutte le modifiche sono archiviate in Git, puoi sempre recuperare le modifiche all'app per riapplicarle se l'unione automatica non soddisfa i requisiti aziendali.

Pubblicazione dell'app

Le app connesse a Git continuano a funzionare normalmente per la pubblicazione e l'esperienza utente senza modifiche a questo processo. Quando pubblichi un'app, la versione dell'app viene memorizzata in Power Apps perché Power Apps necessita di una copia eseguibile dell'app da condividere con gli utenti.

Richieste pull, cronologia di visualizzazione, segnalazione errori e altre funzionalità di Git

L'utilizzo delle richieste pull o di qualsiasi altra operazione Git deve essere eseguita tramite gli altri strumenti Git, incluso il sito Web del provider Git. Non è disponibile alcuna opzione per eseguire tali operazioni Git per eseguire il pull o il push dei commit.

Ogni salvataggio o sincronizzazione che include modifiche risulterà in un commit in Git. Se si sono verificate altre modifiche in Git, ad esempio da altri autori, verranno effettuati ulteriori commit per unire i risultati di tutte le modifiche. Nessuna modifica andrà persa, anche se un'unione sovrascrivesse una modifica. Le modifiche di ciascun autore vengono archiviate in Git tramite commit.

Limitazioni note

Poiché questa funzionalità è sperimentale, il tuo feedback è molto importante per noi. Si applicano le seguenti limitazioni note. Abbiamo in programma di rimuovere la maggior parte di queste limitazioni nelle versioni future.

  • Questa funzionalità non è compatibile con i componenti di codice. Non utilizzare questa funzionalità con app che utilizzano componenti di codice.
  • Questa funzionalità non è compatibile con i repository Git locali. Il repository Git deve essere ospitato sul Web e accessibile con nome utente e token di accesso personale.
  • Le modifiche alla stessa proprietà sullo stesso controllo non vengono unite. Viene applicata l'ultima modifica effettuata.
  • Non puoi ripristinare un'app canvas a una versione precedente utilizzando i passaggi descritti nell'articolo Ripristina un'app. Invece, dovrai usare Git per ripristinare l'app a una versione precedente. Per ulteriori informazioni, vedi le seguenti risorse:
  • Il collegamento di più app alla stessa directory git può causare problemi. Ciò include la creazione di copie della tua app, l'esportazione e l'importazione.
  • Eventuali file esistenti nel repository con nomi che superano i 180 caratteri possono causare problemi durante la connessione. Ti consigliamo di utilizzare un repository dedicato per le app connesse a Git.
  • Selezionando Chiudi nel menu File potrebbe apparentemente eliminare le personalizzazioni nell'app. Tuttavia, le personalizzazioni non vengono eliminate. Aggiorna la pagina per vedere di nuovo tutte le personalizzazioni.
  • Se apri un'app connessa non git (ad esempio App A) da un'app git connected (ad esempio App B) (File > Apri) e provi a connettere App A a un repository, i parametri di controllo della versione git di App A saranno gli stessi di App B . Quando ciò accade, aggiorna la tua pagina e quindi prova a connettere App A di nuovo al repository.
  • Questa funzionalità non supporta la ridenominazione dei componenti personalizzati.
  • Se vedi un messaggio sull'apertura dell'app per la modifica da parte di un altro utente, chiedi all'utente di riferimento di aggiornare l'app. Successivamente, aggiorna l'app per rimuovere il blocco.
  • Questa funzione non è compatibile con test di Test Studio e con le pagine personalizzate per app basate su modello
  • Questa funzionalità non supporta l'uso di token di accesso personali autorizzati per l'uso con SAML Single Sign-On.

Feedback al forum della community

Facci sapere cosa ne pensi. Questa funzionalità è il primo passo di un lungo percorso per consentire un'ottima esperienza di sviluppo del team. Visita il Forum della community di Power Apps per aggiornamenti e per fornire il tuo feedback.