Panoramica
Fieldwire si integra con Holdpoint, una piattaforma che collega gli asset di un progetto alla relativa documentazione di test e ispezione. I moduli di ispezione completati e le attività verificate in Fieldwire possono essere importati in Holdpoint come evidenze e collegati agli asset a cui si riferiscono.
L'integrazione crea un flusso di lavoro connesso tra l'esecuzione sul campo in Fieldwire e la verifica degli asset in Holdpoint. Fieldwire rimane il sistema di riferimento per l'esecuzione sul campo, mentre Holdpoint utilizza la documentazione delle ispezioni e delle attività completate per mostrare cosa è stato verificato, cosa manca e cosa potrebbe bloccare l'attivazione o l'accettazione da parte del proprietario.
L'integrazione è unidirezionale. Holdpoint legge le informazioni idonee da Fieldwire, ma non crea né modifica nulla in Fieldwire.
Questo articolo spiega come collegare Fieldwire a Holdpoint, come collegare i progetti, come vengono importati i moduli di ispezione completati e le attività verificate, come vengono associati gli elementi di Fieldwire agli asset in Holdpoint e come vengono gestite le modifiche successive in Fieldwire.
Configurazione di una connessione a Holdpoint
Per collegare Holdpoint e Fieldwire, è necessario disporre di:
- Un account Holdpoint
- Accesso al progetto Fieldwire pertinente
- Un token API di Fieldwire
Per collegare Holdpoint e Fieldwire è necessario un token API di Fieldwire. Il token viene inserito in Holdpoint e consente a Holdpoint di accedere ai progetti Fieldwire disponibili per l'utente Fieldwire associato.
Generazione di un token API di Fieldwire
- Accedi a Fieldwire.
- Vai a Account > API > Gestisci token.
- Genera un token API.
- Copia il token API.
Nota: Come buona pratica, utilizza un utente Fieldwire dedicato che possa accedere solo ai progetti che devono essere trasferiti in Holdpoint.
Collegamento di Fieldwire in Holdpoint
- Accedi a Holdpoint.
- Vai a Impostazioni > Connessioni > Fieldwire.
- Fai clic su Connetti Fieldwire.
- Incolla il token API di Fieldwire.
Holdpoint rileva automaticamente se l'account Fieldwire connesso utilizza la regione Stati Uniti, UE o Canada.
Collegamento del progetto Fieldwire in Holdpoint
- In Holdpoint, seleziona il progetto Fieldwire che desideri collegare.
- Seleziona il progetto Holdpoint corrispondente.
- Collega i progetti.
Il progetto Fieldwire è ora collegato al progetto Holdpoint corrispondente.
Suggerimento: Aggiungi un campo Asset ID ai modelli dei moduli di ispezione Fieldwire, in modo che i moduli completati possano essere collegati all'asset corretto in Holdpoint.
Funzionamento dell'integrazione
Una volta collegati i progetti Fieldwire e Holdpoint, Holdpoint controlla Fieldwire circa ogni cinque minuti e recupera le modifiche dall'ultima sincronizzazione, nel rispetto dei limiti di frequenza di Fieldwire.
I moduli di ispezione completati e le attività verificate idonei vengono importati da Fieldwire in Holdpoint come evidenze e collegati agli asset a cui si riferiscono.
Moduli di ispezione completati
I moduli di ispezione Fieldwire completati vengono esportati come file PDF insieme alle foto allegate e importati in Holdpoint come evidenze.
Un modulo viene considerato completo quando raggiunge uno stato finale, come Sottomesso o Completato. Se un modello di modulo non dispone di uno stato finale, viene utilizzato il suo ultimo stato. Gli stati rifiutato o annullato non vengono considerati.
Attività verificate
Le attività Fieldwire con stato Verificate vengono esportate come PDF dei rapporti delle attività e importate in Holdpoint come evidenze.
Holdpoint utilizza l'ID asset nel nome dell'attività per collegare il rapporto dell'attività all'asset corrispondente.
Come vengono associati gli elementi di Fieldwire agli asset
Holdpoint utilizza gli identificativi degli asset nei moduli e nelle attività Fieldwire per determinare a quale asset Holdpoint collegare l'evidenza importata.
Associazione tramite un campo del modulo di ispezione
Holdpoint può utilizzare un identificativo asset inserito in un campo del modulo di ispezione Fieldwire. I nomi dei campi supportati includono:
- Asset ID
- Asset
- Asset Tag
- Equipment ID
- Cable ID
- Tag
Il campo utilizzato per l'associazione può essere configurato per ciascun collegamento del progetto. È possibile elencare più ID asset nel campo, separandoli con virgole.
Associazione tramite il nome del modulo o dell'attività
Holdpoint può anche associare un elemento quando nel nome del modulo o dell'attività compare un ID asset esatto. Ad esempio, un modulo o un'attività denominato Test Megger CAB-0012 può essere associato all'asset CAB-0012.
Elementi che non possono essere associati
Holdpoint non presume a quale asset appartenga un elemento. Un elemento viene inserito nell'elenco Needs review se non indica un asset noto o se l'ID asset identificato esiste in più di un pacchetto.
L'elemento mostra il motivo per cui è necessaria una revisione e può essere ritentato dopo la correzione del problema.
Dati sincronizzati tra Fieldwire e Holdpoint
Fieldwire → Holdpoint
Holdpoint legge o importa da Fieldwire le seguenti informazioni:
- Elenco dei progetti: utilizzato per selezionare e collegare un progetto Fieldwire a un progetto Holdpoint.
- Moduli di ispezione completati: importati come file PDF insieme alle foto allegate.
- Attività verificate: importate come PDF dei rapporti delle attività.
- Informazioni sullo stato dei moduli e delle attività: utilizzate per determinare se un elemento soddisfa i requisiti per l'importazione.
Le evidenze importate vengono collegate all'asset Holdpoint corrispondente quando viene trovato un identificativo asset corrispondente.
Holdpoint → Fieldwire
Nessun dato viene scritto da Holdpoint in Fieldwire.
La connessione Fieldwire è di sola lettura. Holdpoint non crea né modifica nulla in Fieldwire.
Gestione delle modifiche in Fieldwire
Le modifiche agli elementi Fieldwire importati in precedenza possono influire sulla gestione della relativa evidenza in Holdpoint.
Moduli riaperti o elementi eliminati
Se un modulo importato viene riaperto o se un modulo o un'attività importati vengono eliminati in Fieldwire, la relativa evidenza viene ritirata in Holdpoint.
Quando un'evidenza viene ritirata:
- Smette di essere conteggiata come evidenza
- I relativi collegamenti agli asset vengono rimossi
- Viene conservato un record di audit
- Il file importato rimane disponibile, ma viene contrassegnato come non conteggiato
Se un modulo riaperto viene completato nuovamente, viene importato di nuovo.
Moduli modificati dopo il completamento
Se un modulo completato viene modificato in Fieldwire, Holdpoint importa la nuova versione e sostituisce i collegamenti agli asset della versione precedente. Il file precedente rimane disponibile, ma viene contrassegnato come sostituito.
Origini dei file importati
Ogni file importato mostra la propria origine Fieldwire nel pannello degli asset di Holdpoint, nell'elenco delle evidenze e nei link di condivisione. Ciò identifica l'elemento Fieldwire di origine e le relative informazioni di aggiornamento.
Importazioni di grandi dimensioni e sincronizzazioni interrotte
Gli arretrati di grandi dimensioni vengono importati in batch. Se un errore di Fieldwire o di rete interrompe una sincronizzazione, Holdpoint riprende dal punto in cui si era interrotto. Gli elementi già importati non vengono importati due volte.
Archiviazione e sicurezza dei file
I file importati tramite l'integrazione vengono archiviati nel proprio SharePoint o Autodesk Construction Cloud del cliente.
Se è stato assegnato un appaltatore, il file importato viene archiviato nella cartella dell'appaltatore. In caso contrario, viene archiviato nella cartella Fieldwire imports dell'appaltatore principale, dove rimane collegato all'asset e viene conteggiato come evidenza.
Il token API di Fieldwire del cliente viene archiviato in forma crittografata utilizzando AES-256-GCM.
La disconnessione di Fieldwire da Holdpoint rimuove il token API archiviato e interrompe la sincronizzazione. I collegamenti ai progetti esistenti e la cronologia delle importazioni vengono conservati.
Limitazioni attuali
- L'integrazione è unidirezionale. Le informazioni passano da Fieldwire a Holdpoint, ma nulla viene scritto da Holdpoint in Fieldwire.
- Solo i moduli di ispezione completati e le attività con stato Verificate vengono importati come evidenze.
- Gli elementi che non possono essere associati a un asset noto vengono inseriti in Needs review anziché essere collegati automaticamente.
- Se un ID asset esiste in più di un pacchetto, l'elemento richiede una revisione prima di poter essere collegato all'asset corretto.
- I moduli riaperti e i moduli o le attività eliminati non vengono più conteggiati come evidenze in Holdpoint.
Domande frequenti
Che cos'è Holdpoint?
Holdpoint è una piattaforma che collega gli asset di un progetto alla relativa documentazione di test e ispezione, aiutando i team a identificare cosa è stato verificato, cosa manca e cosa potrebbe bloccare la fase successiva della costruzione.
Holdpoint crea o modifica qualcosa in Fieldwire?
No. L'integrazione è di sola lettura. Holdpoint legge le informazioni idonee da Fieldwire, ma non crea né modifica nulla in Fieldwire.
Quali moduli di ispezione Fieldwire vengono importati in Holdpoint?
Holdpoint importa i moduli che hanno raggiunto uno stato finale, come Chiuso, Approvato o Completo. Se il modello non dispone di uno stato finale, viene utilizzato il suo ultimo stato. Gli stati rifiutato o annullato non vengono considerati.
Quali attività Fieldwire vengono importate in Holdpoint?
Le attività Fieldwire con stato Verificate vengono esportate in Holdpoint come PDF dei rapporti delle attività.
Come fa Holdpoint a sapere a quale asset appartiene un'ispezione?
Holdpoint può utilizzare un campo identificativo dell'asset configurato nel modulo di ispezione, come Asset ID, Asset, Asset Tag, Equipment ID, Cable ID o Tag. È inoltre possibile utilizzare un ID asset esatto presente nel nome del modulo o dell'attività.
Cosa succede se Holdpoint non riesce ad associare un elemento a un asset?
Holdpoint non presume. L'elemento viene inserito nell'elenco Needs review con una motivazione. Dopo la correzione del problema, è possibile ritentare l'operazione.
Cosa succede se un modulo Fieldwire completato viene riaperto?
L'evidenza viene ritirata in Holdpoint, non viene più conteggiata e i relativi collegamenti agli asset vengono rimossi. Il file rimane disponibile, ma viene contrassegnato come non conteggiato. Se il modulo viene completato nuovamente, viene importato di nuovo.
Cosa succede se un modulo completato viene modificato?
Holdpoint importa la nuova versione e sostituisce i collegamenti agli asset della versione precedente. Il file precedente rimane disponibile, ma viene contrassegnato come sostituito.
Dove vengono archiviati i file importati da Fieldwire?
I file importati vengono archiviati nel proprio SharePoint o Autodesk Construction Cloud del cliente. La destinazione dipende dall'eventuale assegnazione di un appaltatore.
Con quale frequenza Holdpoint controlla la presenza di modifiche in Fieldwire?
Holdpoint controlla Fieldwire circa ogni cinque minuti e recupera le modifiche dall'ultima sincronizzazione, nel rispetto dei limiti di frequenza di Fieldwire.
Chi posso contattare per informazioni su questa integrazione?
Per ulteriore assistenza sull'integrazione Fieldwire, contatta Holdpoint all'indirizzo admin@holdpoint.com.