Fulcrum (anteprima)

Fulcrum è una soluzione di primo campo che consente agli esperti GIS e ai membri del team non GIS di acquisire e condividere facilmente i dati geospaziali. Questo connettore consente l'integrazione con Fulcrum per la gestione di dati sul campo, foto, video e altro ancora.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Service	Classe	Regioni
Copilot Studio	Premium	Tutte le aree Power Automate ad eccezione delle seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)
App per la logica	Standard	Tutte le aree di App per la logica , ad eccezione delle seguenti:      - aree Azure Government      - Azure cina      - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps	Premium	Tutte le aree Power Apps ad eccezione delle seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Automate	Premium	Tutte le aree Power Automate ad eccezione delle seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)

Contatto
Nome	Supporto fulcrum
URL	https://www.fulcrumapp.com/support
Email	support@fulcrumapp.com

Metadati del connettore
Editore	Spatial Networks, Inc.
Sito web	https://www.fulcrumapp.com
Informativa sulla privacy	https://www.fulcrumapp.com/privacy
Categorie	Produttività; Dati

Fulcro

Fulcrum è una soluzione di primo campo che consente agli esperti GIS e ai membri del team non GIS di acquisire e condividere facilmente i dati geospaziali. Questo connettore consente l'integrazione con Fulcrum per la gestione di dati sul campo, foto, video e altro ancora.

Editore

Fulcro

Prerequisiti

• Sottoscrizione di Fulcrum attiva con accesso all'API abilitato

Operazioni supportate

Attivatori

Quando si verifica un evento Fulcrum

Attiva quando viene creata, aggiornata o eliminata una risorsa Fulcrum. Supporta eventi per record, moduli, elenchi di scelte e set di classificazione. Configurare il webhook nell'organizzazione Fulcrum per specificare gli eventi da monitorare.

Azioni

Ottenere un elenco di metadati degli allegati

Recuperare un elenco di allegati.

Ottenere un allegato

Recuperare i metadati per un singolo allegato.

Ottenere un elenco di metadati audio

Recuperare i metadati per un elenco di file audio.

Ottenere un file originale audio

Scaricare il file audio originale.

Ottenere un elenco di metadati delle foto

Recuperare i metadati per un elenco di foto.

Ottenere un file originale di foto

Scarica il file fotografico originale.

Ottenere i metadati delle foto

Recuperare i metadati per una singola foto.

Effettuare una richiesta POST di query

Eseguire una richiesta api query usando HTTP POST. Fornire una query SQL come per eseguire query sui dati dell'organizzazione.

Ottenere un elenco di record

Ottenere un elenco di record dall'organizzazione che possono essere filtrati in base a dimensioni quali maschera, progetto, set di modifiche, rettangolo delimitatore e intervalli di date.

Creare un record

Creare un nuovo record nel modulo specificato usando i valori del modulo specificati, le informazioni sulla posizione e tutti i metadati associati.

Eliminare un record

Eliminare un record dall'organizzazione.

Ottenere un record

Recuperare informazioni dettagliate su un record specifico in base al relativo ID. Sono inclusi tutti i valori dei campi modulo, i dati sulla posizione, i timestamp e i metadati associati.

Aggiornare parzialmente un record

Aggiornare campi specifici di un record esistente senza richiedere l'oggetto record completo. Verranno modificati solo i campi inclusi nel corpo della richiesta, mentre tutti gli altri campi rimangono invariati. Ciò è utile per aggiornare singoli valori di campo o metadati.

Aggiornare un record

Aggiornare un record con un oggetto record specificato. L'oggetto record deve essere la rappresentazione completa del record. Tutti i campi non inclusi vengono considerati Null.

Ottenere la cronologia di un record

Recuperare la cronologia delle versioni completa di un record.

Creazione di un report

Generare un nuovo report per un record specifico, facoltativamente usando un modello di report.

Ottenere un file di report

Scaricare il file di report PDF generato.

Ottenere un elenco di metadati della firma

Recuperare i metadati per un elenco di firme.

Ottenere i metadati della firma

Recuperare i metadati per una singola firma.

Ottenere un file originale della firma

Scaricare il file di firma originale.

Ottenere un elenco di metadati di schizzo

Recuperare i metadati per un elenco di schizzi.

Ottenere un file originale di schizzo

Scaricare il file di schizzo originale.

Ottenere i metadati dello schizzo

Recuperare i metadati per un singolo schizzo.

Ottenere un elenco di metadati video

Recuperare i metadati per un elenco di video.

Ottenere un file originale del video

Scaricare il file video originale.

Recupero delle credenziali

Per usare il connettore Fulcrum, è necessario un token API Fulcrum:

1. Accedere all'account Fulcrum all'indirizzo https://web.fulcrumapp.com
2. Passare all'API Impostazioni >
3. Generare un nuovo token API o usarne uno esistente
4. Copiare il token e usarlo durante la creazione di una connessione

Come iniziare

Creare una nuova connessione e immettere il token API Fulcrum quando richiesto.

URL host personalizzati

Per impostazione predefinita, il connettore usa l'API Fulcrum di produzione in api.fulcrumapp.com. Per altre aree, è possibile specificare un URL host diverso durante la creazione della connessione.

Endpoint a livello di area:

• United States (impostazione predefinita): api.fulcrumapp.com
• Canada: api.fulcrumapp-ca.com
• Australia: api.fulcrumapp-au.com
• Europa: api.fulcrumapp-eu.com

Formato: Immettere solo il nome host senza protocollo o percorso. Il connettore userà automaticamente HTTPS e il percorso API corretto.

Risoluzione dei problemi:

• Verificare che l'host personalizzato sia accessibile dalla rete
• Verificare che il nome host sia corretto (nessun errore di digitazione)
• Verificare che il token API sia valido per l'host specificato

Problemi noti e limitazioni

• La limitazione della frequenza si applica in base al piano Fulcrum

Istruzioni per la distribuzione

Usare le istruzioni per distribuire questo connettore come connettore personalizzato in Microsoft Power Automate e Power Apps.

Creazione di una connessione

Il connettore supporta i tipi di autenticazione seguenti:

Predefinita	Parametri per la creazione della connessione.	Tutte le aree geografiche	Non condivisibile

Predefinito

Applicabile: tutte le aree

Parametri per la creazione della connessione.

Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Nome	TIPO	Descrizione	Obbligatorio
API Token	securestring	Token API Fulcrum per l'autenticazione	Vero
URL dell'host	string	Host API per l'istanza fulcrum

Limiti per la limitazione delle richieste

Nome	Chiamate	Periodo di rinnovo
Chiamate API per connessione	100	60 secondi

Azioni

Aggiornare parzialmente un record	Aggiornare campi specifici di un record esistente senza richiedere l'oggetto record completo. Verranno modificati solo i campi inclusi nel corpo della richiesta, mentre tutti gli altri campi rimangono invariati. Ciò è utile per aggiornare singoli valori di campo o metadati.
Aggiornare un record	Aggiornare un record con un oggetto record specificato. L'oggetto record deve essere la rappresentazione completa del record. Tutti i campi non inclusi vengono considerati Null.
Creare un record	Creare un nuovo record nel modulo specificato usando i valori del modulo specificati, le informazioni sulla posizione e tutti i metadati associati.
Creazione di un report	Generare un nuovo report per un record specifico, facoltativamente usando un modello di report.
Effettuare una richiesta POST di query	Eseguire una richiesta api query usando HTTP POST. Fornire una query SQL come per eseguire query sui dati dell'organizzazione.
Eliminare un record	Eliminare un record dall'organizzazione.
Ottenere i metadati della firma	Recuperare i metadati per una singola firma.
Ottenere i metadati delle foto	Recuperare i metadati per una singola foto.
Ottenere i metadati dello schizzo	Recuperare i metadati per un singolo schizzo.
Ottenere la cronologia di un record	Recuperare la cronologia delle versioni completa di un record.
Ottenere un allegato	Recuperare i metadati per un singolo allegato.
Ottenere un elenco di metadati audio	Recuperare i metadati per un elenco di file audio.
Ottenere un elenco di metadati degli allegati	Recuperare un elenco di allegati.
Ottenere un elenco di metadati della firma	Recuperare i metadati per un elenco di firme.
Ottenere un elenco di metadati delle foto	Recuperare i metadati per un elenco di foto.
Ottenere un elenco di metadati di schizzo	Recuperare i metadati per un elenco di schizzi.
Ottenere un elenco di metadati video	Recuperare i metadati per un elenco di video.
Ottenere un elenco di record	Ottenere un elenco di record dall'organizzazione che possono essere filtrati in base a dimensioni quali maschera, progetto, set di modifiche, rettangolo delimitatore e intervalli di date.
Ottenere un file di report	Scaricare il file di report PDF generato.
Ottenere un file originale audio	Scaricare il file audio originale.
Ottenere un file originale del video	Scaricare il file video originale.
Ottenere un file originale della firma	Scaricare il file di firma originale.
Ottenere un file originale di foto	Scarica il file fotografico originale.
Ottenere un file originale di schizzo	Scaricare il file di schizzo originale.
Ottenere un record	Recuperare informazioni dettagliate su un record specifico in base al relativo ID. Sono inclusi tutti i valori dei campi modulo, i dati sulla posizione, i timestamp e i metadati associati.

Aggiornare parzialmente un record

ID operazione:

Records-partial-update

Aggiornare campi specifici di un record esistente senza richiedere l'oggetto record completo. Verranno modificati solo i campi inclusi nel corpo della richiesta, mentre tutti gli altri campi rimangono invariati. Ciò è utile per aggiornare singoli valori di campo o metadati.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Tipo di contenuto	Content-Type		string	Tipo di contenuto
Record Id	record_id	True	string	ID record
X Skipworkflows	X-SkipWorkflows		boolean	Ignora tutti i flussi di lavoro delle app
X Skipwebhook	X-SkipWebhooks		boolean	Ignora tutti i webhook dell'app
assigned_to_id	assigned_to_id		string	ID dell'utente assegnato a questo record
form_values	form_values		object	Valori dei campi con chiave di campo
Coordinate	coordinates	True		Coordinate per la geometria. Il formato varia in base al tipo: il punto usa [longitudine, latitudine], LineString usa la matrice di posizioni, Polygon usa la matrice di anelli lineari (prima è esterno, sono fori), i tipi Multi* usano matrici delle rispettive strutture di coordinate.
tipo	type	True	string	Tipo di geometria GeoJSON
latitude	latitude		number	Coordinata della latitudine
longitudine	longitude		number	Coordinata longitudine
project_id	project_id		string	ID del progetto
stato	status		string	Stato del record

Restituisce

Corpo

SingleRecordResponse

Aggiornare un record

ID operazione:

Records-update

Aggiornare un record con un oggetto record specificato. L'oggetto record deve essere la rappresentazione completa del record. Tutti i campi non inclusi vengono considerati Null.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Tipo di contenuto	Content-Type		string	Tipo di contenuto
Record Id	record_id	True	string	ID record
X Skipworkflows	X-SkipWorkflows		boolean	Ignora tutti i flussi di lavoro delle app
X Skipwebhook	X-SkipWebhooks		boolean	Ignora tutti i webhook dell'app
assigned_to_id	assigned_to_id		string	ID dell'utente assegnato a questo record
form_id	form_id	True	string	ID del modulo a cui appartiene il record
form_values	form_values		object	Valori dei campi con chiave di campo
Coordinate	coordinates	True		Coordinate per la geometria. Il formato varia in base al tipo: il punto usa [longitudine, latitudine], LineString usa la matrice di posizioni, Polygon usa la matrice di anelli lineari (prima è esterno, sono fori), i tipi Multi* usano matrici delle rispettive strutture di coordinate.
tipo	type	True	string	Tipo di geometria GeoJSON
latitude	latitude		number	Coordinata della latitudine
longitudine	longitude		number	Coordinata longitudine
project_id	project_id		string	ID del progetto
stato	status		string	Stato del record

Creare un record

ID operazione:

Records-create

Creare un nuovo record nel modulo specificato usando i valori del modulo specificati, le informazioni sulla posizione e tutti i metadati associati.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Tipo di contenuto	Content-Type		string	Tipo di contenuto
X Skipworkflows	X-SkipWorkflows		boolean	Ignora tutti i flussi di lavoro delle app
X Skipwebhook	X-SkipWebhooks		boolean	Ignora tutti i webhook dell'app
assigned_to_id	assigned_to_id		string	ID dell'utente assegnato a questo record
form_id	form_id	True	string	ID del modulo a cui appartiene il record
form_values	form_values		object	Valori dei campi con chiave di campo
Coordinate	coordinates	True		Coordinate per la geometria. Il formato varia in base al tipo: il punto usa [longitudine, latitudine], LineString usa la matrice di posizioni, Polygon usa la matrice di anelli lineari (prima è esterno, sono fori), i tipi Multi* usano matrici delle rispettive strutture di coordinate.
tipo	type	True	string	Tipo di geometria GeoJSON
latitude	latitude		number	Coordinata della latitudine
longitudine	longitude		number	Coordinata longitudine
project_id	project_id		string	ID del progetto
stato	status		string	Stato del record

Restituisce

Corpo

SingleRecordResponse

Creazione di un report

ID operazione:

Reports-create

Generare un nuovo report per un record specifico, facoltativamente usando un modello di report.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
record_id	record_id	True	uuid	ID del record per cui generare un report
template_id	template_id		uuid	ID del modello di report da usare (facoltativo)

Restituisce

Corpo

ReportResponse

Effettuare una richiesta POST di query

ID operazione:

Query-post

Eseguire una richiesta api query usando HTTP POST. Fornire una query SQL come per eseguire query sui dati dell'organizzazione.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Pagina	page		integer	Numero di pagina richiesto.
Per pagina	per_page		integer	Numero di elementi da restituire per pagina.
format	format		string	Formato della risposta
q	q	True	string	Query SQL da eseguire
nome_tabella	table_name		string	Nome della tabella su cui eseguire una query

Eliminare un record

ID operazione:

Records-delete

Eliminare un record dall'organizzazione.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Record Id	record_id	True	string	Identificatore univoco del record da eliminare.
X Skipworkflows	X-SkipWorkflows		boolean	Ignora tutti i flussi di lavoro delle app
X Skipwebhook	X-SkipWebhooks		boolean	Ignora tutti i webhook dell'app

Restituisce

Corpo

SingleRecordResponse

Ottenere i metadati della firma

ID operazione:

Signatures-get-single-metadata

Recuperare i metadati per una singola firma.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID firma	signature_id	True	string	Identificatore univoco della firma.

Restituisce

Corpo

SingleSignatureResponse

Ottenere i metadati delle foto

ID operazione:

Photos-get-single-metadata

Recuperare i metadati per una singola foto.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID foto	photo_id	True	string	Identificatore univoco della foto.

Restituisce

Corpo

SinglePhotoResponse

Ottenere i metadati dello schizzo

ID operazione:

Sketches-get-single-metadata

Recuperare i metadati per un singolo schizzo.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID schizzo	sketch_id	True	string	ID schizzo

Restituisce

Corpo

SingleSketchResponse

Ottenere la cronologia di un record

ID operazione:

Records-get-history

Recuperare la cronologia delle versioni completa di un record.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Record Id	record_id	True	string	Identificatore univoco del record di cui si desidera recuperare la cronologia.

Restituisce

Corpo

RecordHistoryResponse

Ottenere un allegato

ID operazione:

Get-single-attachment

Recuperare i metadati per un singolo allegato.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID allegato	attachment_id	True	string	Identificatore univoco dell'allegato.

Restituisce

Corpo

Attachment

Ottenere un elenco di metadati audio

ID operazione:

Audio-get-all

Recuperare i metadati per un elenco di file audio.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Record Id	record_id		string	ID del record a cui è associato il file audio.
ID modulo	form_id		string	ID del modulo a cui è associato il file audio. Se si lascia vuoto, verrà eseguita una query su tutti i file audio.
Primo più recente	newest_first		boolean	Se presente, i file audio verranno ordinati in base updated_at data.
Elaborato	processed		boolean	Filtra i file audio che sono stati completamente elaborati.
Archiviato	stored		boolean	Filtra i file audio che sono stati archiviati completamente.
Caricato	uploaded		boolean	Filtra i file audio che sono stati caricati completamente.
Pagina	page		integer	Numero di pagina richiesto.
Per pagina	per_page		integer	Numero di elementi da restituire per pagina.

Restituisce

Corpo

AudiosResponse

Ottenere un elenco di metadati degli allegati

ID operazione:

Get-all-attachments

Recuperare un elenco di allegati.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Record Id	record_id		string	ID del record a cui è associato l'allegato. Questa operazione è necessaria quando si elencano gli allegati dei record.
ID modulo	form_id		string	ID del modulo a cui è associato l'allegato. Questo parametro consentirà di ottenere tutti i file di riferimento all'interno di un modulo, NON tutti gli allegati di record in un modulo
Tipo proprietario	owner_type		string	Tipo di allegato per cui eseguire una query. Deve essere form o record.
Ordinamento	sort		string	Campo per cui ordinare i risultati.
Direzione ordinamento	sort_direction		string	Direzione di ordinamento(asc, desc). Il valore predefinito è asc.

Restituisce

Corpo

AttachmentsResponse

Ottenere un elenco di metadati della firma

ID operazione:

Signatures-get-all

Recuperare i metadati per un elenco di firme.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Record Id	record_id		string	ID del record a cui è associata la foto.
ID modulo	form_id		string	ID del modulo a cui è associata la foto. Lasciare questo vuoto eseguirà una query su tutte le tue foto.
Primo più recente	newest_first		boolean	Se presente, le foto verranno ordinate in base updated_at data.
Elaborato	processed		boolean	Filtrare le firme che sono state elaborate completamente.
Archiviato	stored		boolean	Filtrare le firme archiviate completamente.
Caricato	uploaded		boolean	Filtrare le firme che sono state caricate completamente.
Pagina	page		integer	Numero di pagina richiesto.
Per pagina	per_page		integer	Numero di elementi da restituire per pagina.

Restituisce

Corpo

SignaturesResponse

Ottenere un elenco di metadati delle foto

ID operazione:

Photos-get-all-metadata

Recuperare i metadati per un elenco di foto.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Record Id	record_id		string	ID del record a cui è associata la foto.
ID modulo	form_id		string	ID del modulo a cui è associata la foto. Lasciare questo vuoto eseguirà una query su tutte le tue foto.
Primo più recente	newest_first		boolean	Se presente, le foto verranno ordinate in base updated_at data.
Elaborato	processed		boolean	Filtra le foto che sono state completamente elaborate.
Archiviato	stored		boolean	Filtra le foto che sono state completamente archiviate.
Caricato	uploaded		boolean	Filtra le foto che sono state caricate completamente.
Pagina	page		integer	Numero di pagina richiesto.
Per pagina	per_page		integer	Numero di elementi da restituire per pagina.

Restituisce

Corpo

PhotosResponse

Ottenere un elenco di metadati di schizzo

ID operazione:

Sketches-get-all-metadata

Recuperare i metadati per un elenco di schizzi.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Record Id	record_id		string	ID del record a cui è associato lo schizzo.
ID modulo	form_id		string	ID del form a cui è associato lo schizzo. Se si lascia vuoto, verrà eseguita una query su tutti gli schizzi.
Primo più recente	newest_first		boolean	Se presente, gli schizzi verranno ordinati in base updated_at data.
Elaborato	processed		boolean	Sketch è stato completamente elaborato.
Archiviato	stored		boolean	Sketch è stato completamente archiviato.
Caricato	uploaded		boolean	Sketch è stato completamente caricato.
Pagina	page		integer	Numero di pagina richiesto
Per pagina	per_page		integer	Numero di elementi per pagina

Restituisce

Corpo

SketchesResponse

Ottenere un elenco di metadati video

ID operazione:

Videos-get-all

Recuperare i metadati per un elenco di video.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Record Id	record_id		string	ID del record a cui è associato il video.
ID modulo	form_id		string	ID del modulo a cui è associato il video. Se si lascia vuoto, verrà eseguita una query su tutti i video.
Primo più recente	newest_first		boolean	Se presente, i video verranno ordinati in base updated_at data.
Elaborato	processed		boolean	Filtra i video che sono stati completamente elaborati.
Archiviato	stored		boolean	Filtra i video che sono stati completamente archiviati.
Caricato	uploaded		boolean	Filtra i video che sono stati caricati completamente.
Pagina	page		integer	Numero di pagina richiesto.
Per pagina	per_page		integer	Numero di elementi da restituire per pagina.

Restituisce

Corpo

VideosResponse

Ottenere un elenco di record

ID operazione:

Records-get-all

Ottenere un elenco di record dall'organizzazione che possono essere filtrati in base a dimensioni quali maschera, progetto, set di modifiche, rettangolo delimitatore e intervalli di date.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Primo più recente	newest_first		boolean	Se presente, i record verranno ordinati in base updated_at data.
Riquadro	bounding_box		string	Rettangolo di selezione dei record richiesti. Il formato deve essere: lat,long,lat,long (bottom, left, top, right).
ID set di modifiche	changeset_id		string	ID del set di modifiche associato al record.
ID modulo	form_id		string	ID della maschera a cui è associato il record. Se si lascia vuoto, verrà eseguita una query su tutti i record.
ID progetto	project_id		string	ID del progetto a cui è associato il record. Se si lascia vuoto, verrà eseguita una query su tutti i record.
Client creato prima	client_created_before		date-time	Restituisce solo i record creati dal client (dispositivo) prima del tempo specificato.
Client creato da	client_created_since		date-time	Restituisce solo i record creati dal client (dispositivo) dopo il tempo specificato.
Client aggiornato prima	client_updated_before		date-time	Restituisce solo i record aggiornati dal client (dispositivo) prima del tempo specificato.
Client aggiornato da	client_updated_since		date-time	Restituisce solo i record aggiornati dal client (dispositivo) dopo il tempo specificato.
Creato prima	created_before		date-time	Restituisce solo i record creati (nel server) prima dell'ora specificata.
Creato da	created_since		date-time	Restituisce solo i record creati (nel server) dopo il tempo specificato.
Aggiornato prima	updated_before		date-time	Restituisce solo i record aggiornati (nel server) prima dell'ora specificata.
Aggiornato da quando	updated_since		date-time	Restituisce solo i record aggiornati (nel server) dopo il tempo specificato.
Pagina	page		integer	Numero di pagina richiesto
Per pagina	per_page		integer	Numero di elementi per pagina

Restituisce

Corpo

RecordsResponse

Ottenere un file di report

ID operazione:

Reports-file

Scaricare il file di report PDF generato.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Report Id	report_id	True	uuid	Identificatore univoco del report.

Restituisce

response

binary

Ottenere un file originale audio

ID operazione:

Audio-get-original-file

Scaricare il file audio originale.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Audio Id	audio_id	True	string	Identificatore univoco del file audio.

Restituisce

response

binary

Ottenere un file originale del video

ID operazione:

Videos-get-original-file

Scaricare il file video originale.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID del video	video_id	True	string	Identificatore univoco del video.

Restituisce

response

binary

Ottenere un file originale della firma

ID operazione:

Signatures-get-single-file

Scaricare il file di firma originale.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID firma	signature_id	True	string	Identificatore univoco della firma.

Restituisce

response

binary

Ottenere un file originale di foto

ID operazione:

Photos-get-single-file

Scarica il file fotografico originale.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID foto	photo_id	True	string	Identificatore univoco della foto.

Restituisce

response

binary

Ottenere un file originale di schizzo

ID operazione:

Sketches-get-single-file

Scaricare il file di schizzo originale.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID schizzo	sketch_id	True	string	ID schizzo

Restituisce

response

binary

Ottenere un record

ID operazione:

Records-get-single

Recuperare informazioni dettagliate su un record specifico in base al relativo ID. Sono inclusi tutti i valori dei campi modulo, i dati sulla posizione, i timestamp e i metadati associati.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Record Id	record_id	True	string	Identificatore univoco del record da recuperare.

Restituisce

Corpo

SingleRecordResponse

Trigger

Quando si verifica un evento Fulcrum

Attiva quando viene creata, aggiornata o eliminata una risorsa Fulcrum. Supporta eventi per record, moduli, elenchi di scelte e set di classificazione. Configurare il webhook nell'organizzazione Fulcrum per specificare gli eventi da monitorare.

Quando si verifica un evento Fulcrum

ID operazione:

OnFulcrumEvent

Attiva quando viene creata, aggiornata o eliminata una risorsa Fulcrum. Supporta eventi per record, moduli, elenchi di scelte e set di classificazione. Configurare il webhook nell'organizzazione Fulcrum per specificare gli eventi da monitorare.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Tipo di contenuto	Content-Type		string	Tipo di contenuto
attivo	active		boolean	Indica se il webhook è abilitato
Nome webhook	name	True	string	Nome visualizzato per il webhook
run_for_bulk_actions	run_for_bulk_actions		boolean	Indica se il webhook viene eseguito per le azioni di record bulk

Restituisce

Payload dell'evento webhook da Fulcrum

Corpo

FulcrumWebhookPayload

Definizioni

Attachment

Nome	Percorso	Tipo	Descrizione
attached_to_id	attached_to_id	string	ID della risorsa a cui è associato questo allegato
attached_to_type	attached_to_type	string	Tipo di risorsa a cui è associato questo allegato
completo	complete	boolean	Indica se il caricamento degli allegati è stato completato
file_size	file_size	integer	Dimensioni del file allegato in byte
id	id	string	Identificatore univoco per l'allegato
nome	name	string	Nome file dell'allegato
Proprietari	owners	array of object	Elenco di riferimenti al proprietario per l'allegato
id	owners.id	string	ID del proprietario
tipo	owners.type	string	Tipo di proprietario (ad esempio, 'record' o 'form')
stato	status	string	Stato dell'allegato
uploaded_at	uploaded_at	date-time	Timestamp del caricamento dell'allegato
url	url	uri	URL per accedere all'allegato

AttachmentsResponse

Nome	Percorso	Tipo	Descrizione
allegati	attachments	array of Attachment
totale	total	integer	Numero totale di allegati restituiti
total_count	total_count	integer	Numero totale di allegati disponibili

Audio

Nome	Percorso	Tipo	Descrizione
access_key	access_key	string	Identificatore univoco per la risorsa audio
content_type	content_type	string	Tipo MIME del file audio
creato_il	created_at	date-time	Timestamp al momento della creazione dell'audio
creato_da	created_by	string	Nome visualizzato dell'utente che ha creato l'audio
created_by_id	created_by_id	string	ID dell'utente che ha creato l'audio
deleted_at	deleted_at	date-time	Timestamp quando l'audio è stato eliminato
file_size	file_size	integer	Dimensioni del file audio in byte
form_id	form_id	string	ID del modulo associato
medium	medium	uri	URL a versione media dell'audio (se elaborato)
metadata	metadata	object	Metadati audio (ad esempio, durata, dettagli del formato)
originale	original	uri	URL del file audio originale (se archiviato)
Elaborato	processed	boolean	Indica se l'audio è stato elaborato
record_id	record_id	string	ID del record associato
piccolo	small	uri	URL di una versione ridotta dell'audio (se elaborato)
stato	status	string	Stato di elaborazione dell'audio
Memorizzati	stored	boolean	Indica se l'audio è stato archiviato
track	track	uri	URL per accedere alla traccia audio (se disponibile)
updated_at	updated_at	date-time	Timestamp dell'ultimo aggiornamento dell'audio
updated_by	updated_by	string	Nome visualizzato dell'utente che ha aggiornato l'audio
updated_by_id	updated_by_id	string	ID dell'utente che ha aggiornato l'audio per l'ultima volta
Caricato	uploaded	boolean	Indica se l'audio è stato caricato
url	url	uri	URL per accedere alla risorsa audio

AudiosResponse

Nome	Percorso	Tipo	Descrizione
audio	audio	array of Audio
current_page	current_page	integer
per_page	per_page	integer
total_count	total_count	integer
total_pages	total_pages	integer

AuditLocation

Metadati della posizione acquisiti al momento della creazione o dell'aggiornamento.

Nome	Percorso	Tipo	Descrizione
altitudine	altitude	double	Altitudine in metri.
horizontal_accuracy	horizontal_accuracy	double	Accuratezza orizzontale in metri.
latitude	latitude	double	Coordinata della latitudine.
longitudine	longitude	double	Coordinata della longitudine.

Geometria

Nome	Percorso	Tipo	Descrizione
Coordinate	coordinates		Coordinate per la geometria. Il formato varia in base al tipo: il punto usa [longitudine, latitudine], LineString usa la matrice di posizioni, Polygon usa la matrice di anelli lineari (prima è esterno, sono fori), i tipi Multi* usano matrici delle rispettive strutture di coordinate.
tipo	type	string	Tipo di geometria GeoJSON

Foto

Nome	Percorso	Tipo	Descrizione
access_key	access_key	string	Identificatore univoco per la foto
content_type	content_type	string	Tipo MIME della foto
creato_il	created_at	date-time	Quando è stata creata la foto
creato_da	created_by	string	Nome visualizzato dell'utente che ha creato la foto
created_by_id	created_by_id	string	ID dell'utente che ha creato la foto
deleted_at	deleted_at	date-time	Quando la foto è stata eliminata
exif	exif	object	Metadati EXIF dalla foto
file_size	file_size	integer	Dimensioni del file di foto in byte
form_id	form_id	string	ID del modulo associato
grande	large	uri	URL della versione di grandi dimensioni della foto
latitude	latitude	double	Coordinata della latitudine in cui è stata scattata la foto
longitudine	longitude	double	Coordinata di longitudine in cui è stata scattata la foto
originale	original	uri	URL della versione originale della foto
Elaborato	processed	boolean	Indica se la foto è stata elaborata
record_id	record_id	string	ID del record associato
Memorizzati	stored	boolean	Indica se la foto è stata archiviata
anteprima	thumbnail	uri	URL della versione di anteprima della foto
updated_at	updated_at	date-time	Data dell'ultimo aggiornamento della foto
updated_by	updated_by	string	Nome visualizzato dell'utente che ha aggiornato l'ultima foto
updated_by_id	updated_by_id	string	ID dell'utente che ha aggiornato l'ultima foto
Caricato	uploaded	boolean	Indica se la foto è stata caricata
url	url	uri	URL API per questa risorsa foto

PhotosResponse

Nome	Percorso	Tipo	Descrizione
current_page	current_page	integer
per_page	per_page	integer
Foto	photos	array of Photo
total_count	total_count	integer
total_pages	total_pages	integer

Registra

Nome	Percorso	Tipo	Descrizione
altitudine	altitude	number
assigned_to	assigned_to	string
assigned_to_id	assigned_to_id	string
client_created_at	client_created_at	date-time
client_updated_at	client_updated_at	date-time
corso	course	number
creato_il	created_at	date-time
creato_da	created_by	string
created_by_id	created_by_id	string
created_duration	created_duration	number
created_location	created_location	AuditLocation	Metadati della posizione acquisiti al momento della creazione o dell'aggiornamento.
edited_duration	edited_duration	number
form_id	form_id	string
form_values	form_values	object	Valori dei campi chiave per chiave di campo: i valori possono essere stringhe, oggetti o matrici a seconda del tipo di campo
geometria	geometry	Geometry
horizontal_accuracy	horizontal_accuracy	number
id	id	string
latitude	latitude	number
longitudine	longitude	number
project_id	project_id	string
record_series_id	record_series_id	string
speed	speed	number
stato	status	string
system_status	system_status	string
updated_at	updated_at	date-time
updated_by	updated_by	string
updated_by_id	updated_by_id	string
updated_duration	updated_duration	number
updated_location	updated_location	AuditLocation	Metadati della posizione acquisiti al momento della creazione o dell'aggiornamento.
version	version	integer
vertical_accuracy	vertical_accuracy	number

RecordHistoryItem

Nome	Percorso	Tipo	Descrizione
altitudine	altitude	double	Registrare l'altitudine della posizione in metri
assigned_to	assigned_to	string	Nome visualizzato dell'utente assegnato
assigned_to_id	assigned_to_id	string	ID dell'utente assegnato
changeset_id	changeset_id	string	ID set di modifiche
client_created_at	client_created_at	date-time	Timestamp di creazione sul lato client
client_updated_at	client_updated_at	date-time	Timestamp dell'aggiornamento lato client
corso	course	double	Corso/titolo in gradi
creato_il	created_at	date-time	Timestamp di creazione dei record
creato_da	created_by	string	Nome visualizzato dell'utente che ha creato il record
created_by_id	created_by_id	string	ID dell'utente che ha creato il record
created_duration	created_duration	integer	Durata della creazione di record in secondi
created_location	created_location	AuditLocation	Metadati della posizione acquisiti al momento della creazione o dell'aggiornamento.
edited_duration	edited_duration	integer	Durata totale della modifica in secondi
form_id	form_id	string	ID modulo
form_values	form_values	object	Valori dei campi modulo (elaborati)
form_version	form_version	integer	Versione del modulo al momento della creazione/aggiornamento dei record
Coordinate	geometry.coordinates	array of number
tipo	geometry.type	string
history_change_type	history_change_type	string	Tipo di modifica (c=create, u=update, d=delete)
history_changed_by	history_changed_by	string	Nome visualizzato dell'utente che ha apportato questa modifica
history_changed_by_id	history_changed_by_id	string	ID dell'utente che ha apportato questa modifica
history_created_at	history_created_at	date-time	Timestamp quando è stata creata questa voce di cronologia
history_id	history_id	string	ID voce cronologia
horizontal_accuracy	horizontal_accuracy	double	Accuratezza orizzontale in metri
id	id	string	ID record
latitude	latitude	double	Registrare la latitudine della posizione
longitudine	longitude	double	Longitudine della posizione del record
project_id	project_id	string	ID del progetto
record_key	record_key	string	Chiave record facoltativa
record_sequence	record_sequence	integer	Numero di sequenza record facoltativo
sequenza	sequence	integer	Numero di sequenza (quando si usa la paginazione basata su sequenza)
speed	speed	double	Velocità al momento della creazione di record in m/s
stato	status	string	Stato del record
updated_at	updated_at	date-time	Record last update timestamp
updated_by	updated_by	string	Nome visualizzato dell'utente che ha aggiornato l'ultimo record
updated_by_id	updated_by_id	string	ID dell'utente che ha aggiornato l'ultimo record
updated_duration	updated_duration	integer	Durata dell'aggiornamento dei record in secondi
updated_location	updated_location	AuditLocation	Metadati della posizione acquisiti al momento della creazione o dell'aggiornamento.
version	version	integer	Numero di versione del record
vertical_accuracy	vertical_accuracy	double	Accuratezza verticale in metri

RecordHistoryResponse

Nome	Percorso	Tipo	Descrizione
current_page	current_page	integer	Numero di pagina corrente (quando si usa la paginazione)
next_sequence	next_sequence	integer	Numero di sequenza successivo (quando si usa la paginazione basata su sequenza)
per_page	per_page	integer	Numero di record per pagina (quando si usa la paginazione)
archivio	records	array of RecordHistoryItem
total_count	total_count	integer	Numero totale di record (quando si usa la paginazione)
total_pages	total_pages	integer	Numero totale di pagine (quando si usa la paginazione)

RecordsResponse

Nome	Percorso	Tipo	Descrizione
current_page	current_page	integer
per_page	per_page	integer
archivio	records	array of Record
total_count	total_count	integer
total_pages	total_pages	integer

ReportResponse

Nome	Percorso	Tipo	Descrizione
completed_at	report.completed_at	date-time	Timestamp al termine della generazione del report
creato_il	report.created_at	date-time	Timestamp di creazione del report
failed_at	report.failed_at	date-time	Timestamp quando la generazione del report ha avuto esito negativo (null se ha esito positivo)
id	report.id	uuid	Identificatore univoco per il report
record_id	report.record_id	uuid	ID del record per cui è stato generato il report
started_at	report.started_at	date-time	Timestamp all'avvio della generazione del report
state	report.state	string	Stato del report
template_id	report.template_id	uuid	ID del modello utilizzato per generare il report
updated_at	report.updated_at	date-time	Timestamp dell'ultimo aggiornamento del report
url	report.url	uri	URL per scaricare il report generato

Signature

Nome	Percorso	Tipo	Descrizione
access_key	access_key	string	Identificatore univoco per la firma
content_type	content_type	string	Tipo MIME del file di firma
creato_il	created_at	date-time	Timestamp al momento della creazione della firma
creato_da	created_by	string	Nome visualizzato dell'utente che ha creato la firma
created_by_id	created_by_id	string	ID dell'utente che ha creato la firma
deleted_at	deleted_at	date-time	Timestamp quando la firma è stata eliminata
file_size	file_size	integer	Dimensioni del file di firma in byte
form_id	form_id	string	ID del modulo associato
grande	large	uri	URL della versione di grandi dimensioni della firma
originale	original	uri	URL del file di firma originale
Elaborato	processed	boolean	Indica se la firma è stata elaborata
record_id	record_id	string	ID del record associato
Memorizzati	stored	boolean	Indica se la firma è stata archiviata
anteprima	thumbnail	uri	URL della versione di anteprima della firma
updated_at	updated_at	date-time	Timestamp dell'ultimo aggiornamento della firma
updated_by	updated_by	string	Nome visualizzato dell'ultimo utente che ha aggiornato la firma
updated_by_id	updated_by_id	string	ID dell'utente che ha aggiornato l'ultima firma
Caricato	uploaded	boolean	Indica se la firma è stata caricata
url	url	uri	URL DELL'API per recuperare questa firma

SignaturesResponse

Nome	Percorso	Tipo	Descrizione
current_page	current_page	integer
per_page	per_page	integer
Firme	signatures	array of Signature
total_count	total_count	integer
total_pages	total_pages	integer

SinglePhotoResponse

Nome	Percorso	Tipo	Descrizione
foto	photo	Photo

SingleRecordResponse

Nome	Percorso	Tipo	Descrizione
registro	record	Record

SingleSignatureResponse

Nome	Percorso	Tipo	Descrizione
firma	signature	Signature

SingleSketchResponse

Nome	Percorso	Tipo	Descrizione
Schizzo	sketch	Sketch

Schizzo

Nome	Percorso	Tipo	Descrizione
access_key	access_key	string	Identificatore univoco per lo schizzo
content_type	content_type	string	Tipo MIME del file di schizzo
creato_il	created_at	date-time	Timestamp al momento della creazione dello schizzo
creato_da	created_by	string	Nome visualizzato dell'utente che ha creato lo schizzo
created_by_id	created_by_id	string	ID dell'utente che ha creato lo schizzo
exif	exif	object	Metadati EXIF dello schizzo
file_size	file_size	integer	Dimensioni del file di schizzo in byte
form_id	form_id	string	ID del modulo associato
grande	large	uri	URL della versione estesa dello schizzo
medium	medium	uri	URL della versione media dello schizzo
originale	original	uri	URL della versione originale dello schizzo
Elaborato	processed	boolean	Indica se lo schizzo è stato elaborato
record_id	record_id	string	ID del record associato
piccolo	small	uri	URL della versione ridotta dello schizzo
Memorizzati	stored	boolean	Indica se lo schizzo è stato archiviato
anteprima	thumbnail	uri	URL della versione di anteprima dello schizzo
updated_at	updated_at	date-time	Timestamp dell'ultimo aggiornamento dello schizzo
updated_by	updated_by	string	Nome visualizzato dell'utente che ha aggiornato l'ultimo schizzo
updated_by_id	updated_by_id	string	ID dell'utente che ha aggiornato l'ultimo schizzo
Caricato	uploaded	boolean	Indica se lo schizzo è stato caricato
url	url	uri	URL DELL'API per accedere a questa risorsa schizzo

SketchesResponse

Nome	Percorso	Tipo	Descrizione
current_page	current_page	integer
per_page	per_page	integer
Schizzi	sketches	array of Sketch
total_count	total_count	integer
total_pages	total_pages	integer

Video

Nome	Percorso	Tipo	Descrizione
access_key	access_key	string	Identificatore univoco per il video
content_type	content_type	string	Tipo MIME del file video
creato_il	created_at	date-time	Timestamp al momento della creazione del video
creato_da	created_by	string	Nome visualizzato dell'utente che ha creato il video
created_by_id	created_by_id	string	ID dell'utente che ha creato il video
deleted_at	deleted_at	date-time	Timestamp quando il video è stato eliminato
file_size	file_size	integer	Dimensioni del file video in byte
form_id	form_id	string	ID del modulo associato
medium	medium	uri	URL della versione media del video
metadata	metadata	object	Metadati aggiuntivi sul video
originale	original	uri	URL del file video originale
Elaborato	processed	boolean	Indica se il video è stato elaborato
record_id	record_id	string	ID del record associato
piccolo	small	uri	URL della versione ridotta del video
stato	status	string	Stato di elaborazione del video
Memorizzati	stored	boolean	Indica se il video è stato archiviato
thumbnail_huge	thumbnail_huge	uri	URL di un'immagine di anteprima enorme
thumbnail_huge_square	thumbnail_huge_square	uri	URL di un'immagine di anteprima quadrata enorme
thumbnail_large	thumbnail_large	uri	URL dell'immagine di anteprima di grandi dimensioni
thumbnail_large_square	thumbnail_large_square	uri	URL dell'immagine di anteprima quadrata di grandi dimensioni
thumbnail_medium	thumbnail_medium	uri	URL dell'immagine di anteprima media
thumbnail_medium_square	thumbnail_medium_square	uri	URL dell'immagine di anteprima quadrata media
thumbnail_small	thumbnail_small	uri	URL di un'immagine di anteprima piccola
thumbnail_small_square	thumbnail_small_square	uri	URL di un'immagine di anteprima quadrata piccola
track	track	uri	URL dei dati di traccia video in formato JSON, se disponibile
updated_at	updated_at	date-time	Timestamp dell'ultimo aggiornamento del video
updated_by	updated_by	string	Nome visualizzato dell'utente che ha aggiornato l'ultimo video
updated_by_id	updated_by_id	string	ID dell'utente che ha aggiornato l'ultimo video
Caricato	uploaded	boolean	Indica se il video è stato caricato
url	url	uri	URL API per accedere a questa risorsa video

VideosResponse

Nome	Percorso	Tipo	Descrizione
current_page	current_page	integer
per_page	per_page	integer
total_count	total_count	integer
total_pages	total_pages	integer
videos	videos	array of Video

FulcrumWebhookPayload

Payload dell'evento webhook da Fulcrum

Nome	Percorso	Tipo	Descrizione
ID evento	id	string	Identificatore univoco dell'evento
Tipo di evento	type	string	Tipo di evento,ad esempio record.create, record.update, record.delete, form.create, form.update, form.delete, choice_list.create, choice_list.update, choice_list.delete, classification_set.create, classification_set.update, classification_set.delete)
ID proprietario	owner_id	string	ID dell'organizzazione proprietaria di questo webhook
Dati evento	data	object	Dati del record o della risorsa associati all'evento
Creato all'indirizzo	created_at	date-time	Timestamp in cui si è verificato l'evento

binario

Questo è il tipo di dati di base 'binario'.