Integrazioni: Impostare Power BI

Panoramica

La gestione di più progetti di costruzione in diverse località rappresenta una sfida unica. I project manager di solito utilizzano più applicazioni per seguire i loro progetti, rendendo particolarmente difficile ottenere una chiara visione d'insieme. Con la creazione del nostro connettore Power BI, disponibile in self-service per tutti i nostri utenti API su Business e Business Plus, il nostro obiettivo è offrire una soluzione efficace.

Ecco alcune funzionalità che potrai sfruttare:

• Monitorare il programma di una persona su più progetti in Fieldwire

• Integrare diverse applicazioni di project management in un’unica dashboard

• Tenere traccia del completamento delle checklist di attività in Fieldwire

In breve, il programma Power BI Connector consente di estrarre facilmente i dati da Fieldwire nell'applicazione desktop Power BI e di combinarli con i propri dati personalizzati per ulteriori analisi.

Nota: Per domande di base e risoluzione di bug relativi a Power BI, ti invitiamo a contattare il team Microsoft, poiché il nostro connettore sarà approvato e distribuito tramite Microsoft.
Il team di supporto Fieldwire è disponibile per aiutarti con problemi di installazione del connettore, ma questa funzionalità è da considerarsi principalmente self-service (fatta eccezione per la sezione di risoluzione dei problemi riportata più avanti).

 

Sommario

• Requisiti per l'utilizzo dell'integrazione Power BI
• Come iniziare
• Aggiornamento delle impostazioni di sicurezza
• Utilizzo del connettore
• Utilizzo del modello predefinito
• Video tutorial
• Configurazione di un gateway dati Power BI locale 
• Prerequisiti
  • Fase 1: Power BI Desktop – Sviluppo e pubblicazione del report
  • Fase 2: Installazione e verifica del connettore personalizzato sul gateway
  • Fase 3: Creazione/configurazione della connessione alla fonte dati corrispondente sul gateway
  • Fase 4: Configurazione del modello semantico nel servizio Power BI
  • Fase 5: Test del refresh dei dati
• Domande frequenti

 

Requisiti per l'utilizzo dell'integrazione Power BI

Per utilizzare il connettore Power BI di Fieldwire, è necessario disporre di quanto segue:

• Accesso Admin ad un account Fieldwire (vedere Introduzione ai livelli di autorizzazione degli account: Admin, Utenti account e Utenti progetto per maggiori informazioni)
• Una chiave API Fieldwire o la possibilità di generare una chiave API (maggiori informazioni qui: Introduzione all'API Fieldwire)
• Power BI desktop per Windows (versione minima: aprile 2024 - 2.128.1177.0 32-bit)

Nota: consigliamo vivamente la versione desktop di Power BI. Le applicazioni dello store Microsoft non sono ufficialmente supportate, ma possono comunque funzionare per i vostri scopi.

Come iniziare

Oltre ai passaggi riportati di seguito, puoi consultare un video completo di installazione QUI.

1. Nel tuo account Fieldwire, vai alla scheda Integrazioni

2. Clicca su Microsoft Power BI

3. Se l’API Fieldwire è già abilitata per il tuo account, clicca su Scarica connettore

   Potrai scaricare un modello Power BI preconfigurato (.pbt) e un pacchetto zip.
   Il pacchetto zip contiene:

   • Il connettore personalizzato Fieldwire: Fieldwire-connector.pqx.

   • Un connettore .mez (opzionale). Questo file è utile solo se prevedi di creare un gateway dati locale 

4. Posiziona il file Fieldwire-connector.pqx nella cartella corretta:

   • Apri Esplora file e clicca sul collegamento Documenti (vedi immagine sotto)

   • Se non hai il collegamento Documenti, la cartella si trova generalmente in C:\Users\<nomeutente>\ oppure su OneDrive

   • Crea una cartella chiamata Power BI Desktop, e al suo interno una sottocartella chiamata Custom Connectors

   • Inserisci il file Fieldwire-connector.pqx nella cartella Custom Connectors

5. Una volta posizionato correttamente il connettore, puoi passare alla sezione successiva: Impostazioni di sicurezza.

Nota: Se questi passaggi non funzionano, è probabile che tu stia utilizzando la versione Microsoft Store dell’app, che non è pienamente supportata da Fieldwire (si consiglia vivamente la versione desktop). Se utilizzi l’app dello Store, dovrai modificare il nome della cartella come segue:

 

C:\Users\<nomeutente>\Documents\Microsoft Power BI Desktop\Custom Connectors

 

Aggiornamento delle impostazioni di sicurezza

Poiché il connettore è attualmente in fase beta, non è ancora stato certificato da Microsoft. È necessario autorizzare l'installazione nelle impostazioni di Power BI.

 

Processo autorizzazione

Aprire il desktop di Power BI e seguire i seguenti passaggi:

1. Andare su File → Opzioni e impostazioni → Opzioni → Sicurezza

2. Nella sezione Estensioni dati, selezionare
“(Non consigliato) Consenti il caricamento di qualsiasi estensione senza convalida o avviso”.

3. Selezionare OK

4. Chiudere il desktop di Power BI e riaprire

 

Utilizzo del connettore

Una volta completata la configurazione iniziale, è possibile iniziare a utilizzare il connettore per estrarre i dati dal proprio account Fieldwire.

1. Seleziona Ottieni dati → Altro... 



2. Cerca Fieldwire e Seleziona Fieldwire -> Connect.
Se non riesci a trovare il connettore, prova a utilizzare il collegamento alla scheda Documenti in Esplora file di Windows:

3. Una volta trovato il connettore, l’installazione è andata a buon fine.
Ti consigliamo di aprire il modello Power BI (.pbt) che hai scaricato facendo doppio clic su di esso.

4. Verrà visualizzato un nuovo prompt che ti chiederà di inserire l’URL di Fieldwire e l’ID del progetto.

Per ottenere l’ID del progetto, segui questi passaggi:

• Accedi a Fieldwire e apri il progetto corrispondente

• Copia l’ID del progetto dall’URL nella barra di navigazione
  
  

Nell'esempio l'ID del progetto è:"fccd93a5-ba9d-4cb5-91c3-7249994dbe1e".

5. Il connettore ti chiederà di inserire la tua chiave API. (Consulta questo articolo per maggiori informazioni: Introduzione all’API di Fieldwire).
6. Fare clic su OK: Il connettore dovrebbe iniziare a prelevare i dati dal progetto Fieldwire selezionato.

Una volta recuperati i dati, è possibile iniziare l'analisi.
Tutti i dati sono visualizzati a destra dello schermo.
È inoltre possibile fare clic su “Aggiorna” per ottenere le informazioni più aggiornate.

Ecco come dovrebbe apparire l'interfaccia:

 

Utilizzo del modello predefinito

Abbiamo fornito un modello preconfezionato con una serie iniziale di query e visualizzazioni per iniziare.
Per utilizzarlo, è necessario seguire i seguenti passaggi:

1. Nella barra superiore dell'interfaccia di Power BI, selezionare File -> Importa -> Importa modello.

2. Selezionare il modello decompresso dal pacchetto zip di Fieldwire. Il modello si chiama Fieldwire-Dashboard-Template.pbit.
3. Una volta caricato il modello, seguire i passaggi precedenti per inserire l'ID del progetto e la chiave API.
Se l'operazione è andata a buon fine, si vedrà il modello iniziare a caricarsi con i dati del progetto, creando un dashboard.

La dashboard contiene 4 pagine predefinite:

1. Attività – Panoramica del progetto Questa vista è focalizzata sul progetto e ti consente di identificare progetti e attività in ritardo rispetto alla pianificazione.

2. Compiti - Panoramica delle persone. Questa vista è incentrata sulle persone, con l'intento di garantire che il lavoro sia suddiviso equamente e che nessuno abbia troppo da fare nello stesso giorno. Inoltre, aiuta i manager a vedere chiaramente quando le persone lavorano su più cantieri.

3. Attività - Voci della lista di controllo. Questa vista è dedicata alle voci della lista di controllo delle attività. È flessibile per adattarsi a vari casi d'uso.



4. Panoramica dei moduli. Questa vista consente di tenere traccia del completamento dei moduli nei progetti.

Congratulazioni! Ora dovresti avere accesso ai tuoi dati Fieldwire all’interno di Power BI.
Tieni presente che non tutti i campi dati di Fieldwire sono attualmente disponibili tramite Power BI.

Per aiutarci a dare priorità ai campi da integrare per primi, ti invitiamo a condividere le tue opinioni con noi: puoi farlo contattando il nostro Team di Supporto: Come contattare il Supporto Fieldwire.

 

 

Video Tutorial

Installazione

Dashboard 

 

Come modificare i progetti visualizzati nel tuo dashboard

Nel video di questa sezione, ti mostriamo come modificare facilmente i progetti inclusi nel tuo dashboard senza doverlo ricreare da zero!
Questo aggiornamento è automatico per tutti i clienti che utilizzano Power BI, quindi non è necessario scaricare nuovi connettori o modelli.

Passaggi da seguire:

• Vai al tuo dashboard Power BI

• Clicca sul pulsante Trasforma dati nella barra degli strumenti

• Seleziona Modifica parametri

• Modifica il campo projectsIDs con le nuove informazioni

• Clicca su OK

• Seleziona Applica modifiche

Nota: Potrebbe essere necessario attendere il caricamento di tutti i campi rilevanti prima di visualizzare le nuove informazioni del progetto.

 

Configurazione di un gateway dati Power BI locale

L’obiettivo di questa sezione è mostrare come:

• Sviluppare un report Power BI utilizzando il connettore personalizzato "Fieldwire - v1.0.0", con parametri specifici:

  • Import full project list and users list

  • Project ID list
    
    

• Pubblicare il report

• Configurare correttamente il modello semantico affinché si aggiorni tramite il gateway "Fieldwire-Gateway", utilizzando una chiave API Fieldwire

• Verificare che tutti i parametri di connessione corrispondano

Questa configurazione consente di mantenere aggiornati i dati del report in modo automatico e sicuro, sfruttando il gateway locale per connettersi all’API Fieldwire.

 

Prerequisiti

Il tuo gateway dati locale — chiamato Fieldwire-Gateway in questo esempio — è installato in modalità Standard e correttamente in esecuzione.

- Hai a disposizione i tuoi file di connettore personalizzato:

• Fieldwire.pqx (per Power BI Desktop)

• Fieldwire.mez (per il gateway)

- Hai il tuo modello di report Fieldwire-Dashboard-Template.pbit (opzionale; puoi anche iniziare da un file vuoto di Power BI Desktop).

- Conosci i valori specifici dei parametri che utilizzerai per la connessione dati in Power BI Desktop.

Per questa guida, gli esempi basati sulle informazioni fornite sono:

• Parametro "Import full project list and users list": true

• Parametro "Project ID list (comma separated)": 3141de71-0cc4-47d0-9319-c6d40a4411a (Usa il tuo ID reale o un elenco separato da virgole se applicabile a più progetti)

- Hai una chiave API Fieldwire valida.

Power BI Desktop è installato.

 

Fase 1: Power BI Desktop – Sviluppo e pubblicazione del report

1. Installazione di Fieldwire.pqx per Power BI Desktop

• Copia il file Fieldwire.pqx nella cartella dei connettori personalizzati di Power BI Desktop. Il percorso tipico è: C:\Users\<NomeUtente>\Documents\Power BI Desktop\Custom Connectors

• Se la cartella Custom Connectors non esiste, creala manualmente.

2. Modifica delle impostazioni di sicurezza in Power BI Desktop

• Apri Power BI Desktop

• Vai su File > Opzioni e impostazioni > Opzioni

• Nella sezione Globale > Sicurezza, sotto Estensioni dati, seleziona: "(Non consigliato) Consenti il caricamento di qualsiasi estensione senza convalida o avviso"

• Clicca su OK

• Chiudi Power BI Desktop

3. Creazione/apertura del report

• Opzione A (Utilizzo del modello): Fai doppio clic sul file Fieldwire-Dashboard-Template.pbit per aprire Power BI Desktop con la struttura predefinita

• Opzione B (Da zero): Apri Power BI Desktop e inizia con un report vuoto

4. Connessione alla fonte dati Fieldwire

• In Power BI Desktop, clicca su Ottieni dati nella barra Home

• Cerca e seleziona il tuo connettore personalizzato, elencato come Fieldwire - v1.0.0

• Clicca su Connetti

• Apparirà la finestra dei parametri del connettore. Inserisci i valori specifici:

  • Import full project list and users list: true

  • Project ID list (separati da virgola): inserisci gli ID dei progetti desiderati

• Clicca su OK

• Quando richiesto, inserisci la tua chiave API Fieldwire secondo il meccanismo di autenticazione del connettore

Nota: La combinazione esatta dei parametri inseriti definisce il valore extensionDataSourcePath, che Power BI utilizza per identificare la connessione alla fonte dati. Questi valori devono essere replicati esattamente durante la configurazione della connessione corrispondente sul gateway.

5.Sviluppo del report

• Una volta caricati i dati, progetta le pagine del report, le visualizzazioni, le misure e le relazioni secondo le tue esigenze

6. Salvataggio del report

• Vai su File > Salva con nome

• Salva il report come file Power BI (.pbix), ad esempio: Fieldwire Project 3141de71 Report.pbix

7. Pubblicazione nel servizio Power BI

• Nella scheda Home di Power BI Desktop, clicca su Pubblica

• Seleziona lo spazio di lavoro desiderato nel servizio Power BI

• Clicca su Seleziona e attendi il completamento della pubblicazione

• Questa operazione pubblicherà sia il report (.pbix) sia il modello semantico associato nel servizio Power BI

 

Fase 2: Installazione e verifica del connettore personalizzato sul gateway

1. Installa Fieldwire.mez sulla macchina del gateway:

• Accedi al server/computer dove è installato il tuo gateway Fieldwire-Gateway

• Copia il file Fieldwire.mez nella cartella specifica dei connettori personalizzati del gateway. Il percorso standard è: C:\Windows\ServiceProfiles\PBIEgwService\Documents\Power BI Desktop\Custom Connectors

• Se le cartelle Power BI Desktop o Custom Connectors non esistono in questo percorso, creale manualmente

2. Riavvia il servizio del gateway:

• Apri Servizi di Windows (cerca services.msc)

• Trova il servizio On-premises data gateway service nell’elenco

• Fai clic destro sul servizio e seleziona Riavvia

3. Verifica il connettore nell’app del gateway:

• Sulla macchina del gateway, apri l’applicazione On-premises data gateway

• Accedi se richiesto

• Vai alla scheda Connettori

• Il tuo connettore personalizzato "Fieldwire - v1.0.0" dovrebbe apparire nell’elenco, indicando che il gateway lo ha caricato correttamente

 

Fase 3: Creazione/configurazione della connessione corrispondente alla fonte dati sul gateway

Questa fase configura il modo in cui il gateway si connetterà a Fieldwire, utilizzando gli stessi parametri e la stessa chiave API del report pubblicato.

1. Accedi alla gestione del gateway nel servizio Power BI:

• Nel servizio Power BI (app.powerbi.com), clicca sull’icona delle impostazioni in alto a destra

• Seleziona "Gestisci connessioni e gateway"

2. Crea una nuova connessione:

• Assicurati che la scheda "Connessioni" sia selezionata

• Clicca sul pulsante "+ Nuova" (di solito in alto a sinistra)

3. Configura i dettagli della nuova connessione:

• Nome del cluster gateway: seleziona "Fieldwire-Gateway" dal menu a tendina

• Nome della connessione: inserisci un nome descrittivo e specifico

• Tipo di connessione: nel menu "Tipo di fonte dati", seleziona il tuo connettore personalizzato, elencato come Fieldwire - v1.0.0

• Parametri specifici del connettore:

  • Import full project list and users list: true

  • Project ID list (separati da virgola): inserisci gli stessi ID usati in Power BI Desktop

• Chiave API / Credenziali: inserisci la tua chiave API Fieldwire

• Livello di privacy (opzionale): seleziona "Organizzativo" o "Privato" in base alle policy aziendali

• Clicca su "Crea"

4. Test della connessione:

• Dopo aver cliccato su "Crea", Power BI testerà automaticamente la connessione tramite il gateway

• La nuova connessione dovrebbe apparire con stato "Online"

• Se compare un errore, verifica i parametri o la chiave API prima di procedere

 

Fase 4: Configurazione del modello semantico nel servizio Power BI

1. Accedi alle impostazioni del modello semantico:

• Vai allo spazio di lavoro dove hai pubblicato il report

• Trova il modello semantico associato

• Clicca sui tre puntini accanto al nome e seleziona "Impostazioni"

2. Connessioni gateway e cloud:

• Scorri fino alla sezione "Gateway e connessioni cloud"

• Il toggle "Usa un gateway dati locale o VNet" sarà disattivato: è normale, poiché il connettore Fieldwire richiede un gateway

3. Mappa la fonte dati del modello semantico alla connessione del gateway:

• Nella sezione "Connessioni gateway", vedrai "Fieldwire-Gateway" elencato (potrebbe indicare “Non configurato correttamente”)

• Sotto "Fonti dati incluse in questo modello semantico", troverai la fonte Fieldwire con il suo extensionDataSourcePath

• Accanto a questa voce, clicca sul menu a tendina

• Seleziona la connessione gateway creata nella Fase 3

• Clicca su "Applica"

4. Verifica della configurazione:

• Dopo aver applicato, lo stato accanto a "Fieldwire-Gateway" dovrebbe aggiornarsi e non mostrare più "Non configurato correttamente"

• L’icona rossa di errore dovrebbe scomparire o diventare un indicatore di successo

 

Fase 5: Test dell’aggiornamento

1. Avvia un aggiornamento manuale:

• Nelle impostazioni del modello semantico, clicca su "Aggiorna ora"

• In alternativa, torna allo spazio di lavoro, passa il mouse sul modello semantico e clicca sull’icona di aggiornamento

2. Controlla la cronologia degli aggiornamenti:

• Nelle impostazioni, clicca su "Cronologia aggiornamenti"

• Monitora lo stato: dovrebbe passare da "In corso" a "Completato"

• In caso di errore, consulta il messaggio nella cronologia per ulteriori indicazioni

Seguendo attentamente queste fasi, replicando esattamente i parametri usati in Power BI Desktop e fornendo correttamente la chiave API Fieldwire, otterrai un report Power BI aggiornabile con successo tramite il tuo connettore personalizzato Fieldwire.

 

Domande frequenti

A che tipo di dati posso accedere con il connettore Fieldwire?
Di seguito un elenco degli attuali campi di dati del progetto Fieldwire con cui è possibile lavorare in Power BI. (Si noti che i messaggi delle attività, gli allegati delle attività, gli attributi personalizzati e il contenuto dei moduli non sono disponibili).

Se ci sono altri campi che desideri poter accedere, ti invitiamo a comunicarcelo scrivendo a support@fieldwire.com.

 

Il connettore Fieldwire Power BI funziona con la versione base gratuita di Power BI?
Sì! Il connettore funziona con tutti i livelli di Power BI. Tuttavia, per pubblicare i dashboard online ai propri compagni di squadra, è necessaria una licenza Pro. Ecco la struttura dei prezzi di Microsoft.

 

Con quale frequenza vengono aggiornati i dati in Power BI?
I dati vengono aggiornati solo quando si fa clic direttamente sul pulsante “Aggiorna” nell'applicazione Power BI.

 

Posso creare più dashboard?
Sì, tramite l'applicazione desktop Power BI.
Possono essere pubblicati online con una licenza Power BI Pro per consentire la visualizzazione dei dati del progetto ad altri membri del team.

 

Cosa posso fare se ho bisogno di dati specifici non disponibili tramite il connettore Fieldwire per Power BI?
Si consiglia di utilizzare l’API di Fieldwire per aggiungere queste informazioni direttamente in Power BI. È probabile che sia necessario il supporto di uno sviluppatore o esperto Power BI del tuo team. Ti invitiamo inoltre a comunicarci le tue esigenze scrivendo a support@fieldwire.com, in modo da registrare la richiesta come suggerimento per futuri aggiornamenti.

 

Come posso contribuire alla certificazione del connettore Fieldwire per Power BI?
La certificazione del connettore semplificherebbe l’installazione (circa 3 clic), ne abiliterebbe l’uso sul Web e permetterebbe l’aggiornamento automatico. Puoi contribuire in due modi:

• Se sei in contatto con un rappresentante Microsoft, informalo. Questo è il metodo principale con cui Microsoft stabilisce le priorità di certificazione.

• Puoi votare questa proposta sul Microsoft forum.

Quanti progetti possono essere inclusi in un singolo dashboard Power BI?
È possibile includere fino a 100 progetti per dashboard.

 

Maggiori informazioni

• Integrazioni: Impostazione di SharePoint e Google Drive
• Come visualizzare e analizzare le attività?