Condividi tramite

pac canvas

Funzionamento con i file msapp di Power Apps

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

Importante

Commands

Command Description
pac canvas create Generare un'app canvas da un connettore personalizzato
download pac canvas Scaricare l'app canvas come file msapp
pac canvas list Elencare le app canvas
pac canvas pack (Anteprima) Comprimere le origini in un file msapp
pac canvas decomprimere (Anteprima) Estrarre un file msapp in origini
pac canvas validate (Anteprima) Convalidare l'origine .pa.yaml per un file msapp decompresso

pac canvas create

Generare un'app canvas da un connettore personalizzato

Questo comando genererà un'app .msapp canvas basata sulla definizione OpenAPI di un connettore personalizzato esistente. L'app conterrà schermate, layout di controllo e codice Power Fx generato in base alla definizione delle azioni del connettore personalizzato, con un aspetto predefinito. L'app può essere usata per esercitare direttamente le azioni definite nel connettore personalizzato.

Gli autori possono importare l'oggetto generato .msapp in Power Apps Studio per riprodurre l'app o per apportare modifiche e apportare ulteriori personalizzazioni. Importare l'app generata in Power Apps Studio passando a Esplora file>>all'interno di Studio.

Esempi

Negli esempi seguenti viene illustrato l'uso del pac canvas create comando .

Creare un'app canvas basata su una definizione open API in base al nome visualizzato

Questo esempio crea un'app canvas (come file *.msapp) basata su una definizione open API usando il nome visualizzato del connettore.

pac canvas create --msapp HelloWorld.msapp --connector-display-name "My Custom Connector"

Creare un'app canvas basata su una definizione api aperta in base all'ID

Questo esempio crea un'app canvas (come file *.msapp) in base a una definizione open API usando l'ID del connettore.

pac canvas create --msapp HelloWorld.msapp --connector-id 00000000-0000-0000-0000-000000000000

connector-display-name O connector-id sono obbligatori.

Parametri obbligatori per la creazione di canvas

--msapp

Percorso del file msapp da generare

Parametri facoltativi per la creazione di canvas

--connector-display-name

Nome visualizzato del connettore da cui generare Power App.

--connector-id

ID del connettore da cui generare Power App.

--environment

ID o URL dell'ambiente di destinazione. Il valore predefinito è l'ambiente del profilo di autenticazione di Dataverse attualmente attivo.

Osservazioni:

Considerazioni e limitazioni:

  • Il connettore personalizzato a cui si fa riferimento con i connector-display-name parametri o connector-id deve far parte di una soluzione.
  • Dopo l'importazione dell'app in Studio, non sarà presente alcuna associazione al connettore personalizzato. L'autore deve aggiungere manualmente un riferimento al connettore personalizzato da cui è stata generata l'app prima che l'app possa essere riprodotta. Per la procedura, vedere Aggiungere connessioni dati alle app canvas . Fino a quando non si esegue questa operazione, è possibile che vengano visualizzati errori di formula nell'app che verranno risolti dopo l'aggiunta del riferimento al connettore. Il nome del connettore personalizzato aggiunto all'app deve corrispondere al nome visualizzato del connettore personalizzato a cui si fa riferimento nel canvas create comando .
  • L'app conterrà una schermata per ogni POST azione e GET definita dal connettore.
    • Altri verbi disponibili nei connettori personalizzati non sono supportati.
  • I controlli di cui viene eseguito il rendering sullo schermo di ogni azione vengono generati dinamicamente in base alla modalità di definizione dei tipi di input e output di ogni azione. Alcuni tipi di input e output definiti nel connettore personalizzato non sono supportati da canvas create. Il comando genererà avvisi nella console quando vengono rilevati. Casi specifici:
    • Le matrici di oggetti e matrici di matrici non sono supportate come input
    • I controlli non vengono generati per oggetti o matrici annidate oltre una profondità di 20
    • I tipi "File" e "formato binario" non sono supportati per l'input o l'output.

download pac canvas

Scaricare l'app canvas come file msapp

Parametri obbligatori per il download canvas

--name -n

App canvas esatta, nome parziale o ID app

Parametri facoltativi per il download di canvas

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

--extract-to-directory -d

Nome della directory in cui estrarre l'app canvas

--file-name -f

Nome file (in genere con estensione msapp). Se il file non specificato viene salvato nella directory corrente con 'nomeapp'.msapp

--overwrite -o

Consenti sovrascrittura file

Questo parametro non richiede alcun valore. È un cambio.

pac canvas list

Elencare le app canvas

Parametri facoltativi per l'elenco canvas

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

pac canvas pack

(Anteprima) Comprimere le origini in un file msapp

Example

pac canvas pack --sources MyHelloWorldFiles --msapp HelloWorld.msapp

Parametri obbligatori per il pacchetto canvas

--msapp

Percorso del file msapp

--sources

Directory alle origini da inserire

Osservazioni:

Crea un .msapp file dai file di origine decompressi in precedenza. Il risultato può essere aperto in Power Apps Studio passando a Esplora file>>.

Dopo essere stati decompressi, i file di origine possono essere modificati e gestiti con strumenti esterni, ad esempio Visual Studio Code e GitHub.

pac canvas decomprimere

(Anteprima) Estrarre un file msapp in origini

Example

pac canvas unpack --msapp HelloWorld.msapp --sources MyHelloWorldFiles

pac canvas unpack --msapp HelloWorld.msapp

Decomprime la directory predefinita HelloWorld_src .

Parametri obbligatori per la decompressione canvas

--msapp

Percorso del file msapp

Parametri facoltativi per la decompressione canvas

--sources

Directory in origini da decomprimere

Osservazioni:

Decomprime il .msapp file di origine.

Scaricare il .msapp file da Power Apps Studio passando aFile Save as> (Salva file> come computer).

Se il parametro sources non viene specificato, viene usata una directory con lo stesso nome e posizione del .msapp file con _src suffisso.

Struttura di cartelle

Per decomprimere e comprimere le proprietà, usare la struttura di cartelle seguente:

  • \src - File di controllo e componenti. Contiene le origini.
    • *.fx.yaml : le formule estratte dal control.json file.

      Annotazioni

      Questa è la posizione in cui modificare le formule.

    • CanvasManifest.json : file manifesto che contiene le informazioni normalmente presenti nell'intestazione, nelle proprietà e in publishInfo.
    • *.json - File non elaborato control.json .
    • \EditorState*.editorstate.json - Informazioni memorizzate nella cache per Power Apps Studio da usare.
  • \DataSources : tutte le origini dati usate dall'app.
  • \Connections - Istanze di connessione salvate con l'app e usate durante il ricaricamento in Power Apps Studio.
  • \Assets : file multimediali incorporati nell'app.
  • \pkgs : copia scaricata di riferimenti esterni, ad esempio modelli, file di definizione API e librerie dei componenti. Si tratta di riferimenti simili a NuGet/NPM.
  • \other - Tutti i file esterni necessari per ricreare l'oggetto .msapp.
    • entropy.json : gli elementi volatili (ad esempio i timestamp) vengono estratti in questo file. Ciò consente di ridurre le differenze rumorose in altri file garantendo al tempo stesso che possiamo comunque eseguire il round trip.
    • Contiene altri file dall'app msapp, ad esempio ciò che si trova in \rriferimenti.

Formato del file

I .fx.yaml file usano un subset di YAML. Analogamente a Excel, tutte le espressioni devono iniziare con un segno =di uguale . Altre informazioni: Grammatica della formula YAML di Power Fx

Unione di modifiche con Power Apps Studio

Quando si uniscono le modifiche apportate in due diverse sessioni di Power Apps Studio:

  • Assicurarsi che tutti i nomi dei controlli siano univoci. Ad esempio, l'inserimento di un pulsante in due sessioni diverse può comportare due Button1 controlli. È consigliabile denominare i controlli subito dopo averli creati. Lo strumento non accetta due controlli con lo stesso nome.
  • Per questi file, unirli come di consueto:
    • \src*.fx.yaml
  • In caso di conflitti o errori, è possibile eliminare questi file:
    • \src\editorstate*.json: questi file contengono informazioni facoltative in Power Apps Studio.
    • \other\entropy.jssu
  • Per eventuali conflitti in questi file, è possibile accettare la versione più recente:
    • \checksum.jssu
  • Se sono presenti conflitti di unione in questi percorsi, non è possibile eseguire il merge. Fateci sapere se questo accade spesso; microsoft lavorerà sulla ristrutturazione del formato di file per evitare conflitti.
    • \Connessioni*
    • \DataSources*
    • \pkgs*
    • CanvasManifest.json

Open source

I comandi canvas nell'interfaccia della riga di comando di Microsoft Power Platform sono open source. Discutere i miglioramenti, generare problemi e accedere al codice dal repository degli strumenti del linguaggio di Power Apps.

pac canvas validate

(Anteprima) Convalidare l'origine .pa.yaml per un file msapp decompresso

Parametri obbligatori per la convalida canvas

--directory -d

Percorso della directory msapp estratta contenente i file con estensione pa.yaml da convalidare

Vedere anche

Gruppi di comandi dell'interfaccia della riga di comando di Microsoft Power Platform
Panoramica dell'interfaccia della riga di comando di Microsoft Power Platform

  • Last updated on