Condividi tramite

Usare il Starter-Kit per iniziare a funzionare

Utilizza questa guida introduttiva per eseguire il workload HelloWorld e attivarlo in Fabric. Si basa sulle procedure consigliate e semplifica i passaggi per ottenere rapidamente la codifica.

Importante

Assicurarsi di avere accesso a un Fabric workspace e che il tenant permetta le funzionalità per sviluppatori. Abilita la Modalità sviluppatore Fabric prima di eseguire il test.

1. Clonare il repository

Per iniziare, creare una copia tramite fork del repository Starter-Kit e quindi clonarla nel computer locale.

git clone https://github.com/<your-account>/fabric-extensibility-toolkit.git
cd fabric-extensibility-toolkit

2. Eseguire lo script di installazione

Lo script di installazione automatizza la maggior parte della configurazione (registrazione dell'app, impostazioni predefinite e così via).

# From the repo root
pwsh ./scripts/Setup/Setup.ps1 -WorkloadName "Org.MyWorkload"
  • WorkloadName deve seguire il modello Organization.WorkloadName. Per lo sviluppo, utilizzare Org.[YourWorkloadName].
  • Se si riutilizza un'applicazione Microsoft Entra esistente, assicurarsi che gli URI di reindirizzamento SPA siano configurati come descritto nella guida alla configurazione manuale dei repository.
  • In macOS/Linux usare pwsh per eseguire script.

3. Avviare l'ambiente di sviluppo

Eseguire il server di sviluppo (front-end + API) e registrare l'istanza locale con Fabric tramite DevGateway.

# Terminal 1: start local dev server
pwsh ./scripts/Run/StartDevServer.ps1

# Terminal 2: start DevGateway to register your local instance with Fabric
pwsh ./scripts/Run/StartDevGateway.ps1

4. Abilitare le funzionalità per sviluppatori in Fabric

Nel portale Fabric

  • Nel portale di amministrazione verificare che le impostazioni per gli sviluppatori tenant richieste dal toolkit siano abilitate.
  • In Impostazioni sviluppatore, attivare la modalità sviluppatore Fabric per l'account.

5. Testare l'elemento HelloWorld

È possibile accedere al carico di lavoro dall'hub del carico di lavoro (cercare il nome del carico di lavoro) o spostarsi direttamente. Creare quindi un elemento Hello World.

Passaggi:

  1. Aprire l'hub del carico di lavoro Fabric, individuare il carico di lavoro, ad esempio Org.MyWorkload.
  2. Selezionare il tipo di elemento Hello World e scegliere l'area di lavoro di sviluppo.
  3. Verrà aperto l'editor; verificare che l'elemento funzioni come previsto.

6. Iniziare a scrivere codice

Modificare l'elemento HelloWorld o crearne uno nuovo:

  • Aggiornare l'editor: Workload/app/items/HelloWorldItem/HelloWorldItemEditor.tsx
  • In alternativa, scaffoldare un nuovo elemento con lo script: ./scripts/Setup/CreateNewItem.ps1

Risoluzione dei problemi

  • Criteri di PowerShell: ridurre temporaneamente i criteri di esecuzione se gli script non vengono avviati.
  • PowerShell più recente: installare/aggiornare PowerShell se vengono visualizzati errori di installazione.
  • Sbloccare gli script: se richiesto, consentire l'esecuzione di file .ps1.
  • App Microsoft Entra esistente: configurare gli URI di reindirizzamento SPA in base alla Guida Manuale nel repository.
  • macOS/Linux: usare pwsh per eseguire gli script.
  • Last updated on