Partager via


Fulcrum (préversion)

Fulcrum est une solution de premier plan qui permet aux experts SIG et aux membres de l’équipe non-GIS de capturer et partager facilement des données géospatiales. Ce connecteur permet l’intégration à Fulcrum pour la gestion des données de champ, des photos, des vidéos, etc.

Ce connecteur est disponible dans les produits et régions suivants :

Service classe Régions
Copilot Studio Premium Toutes les régions Power Automate à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Applications logiques Norme Toutes les régions Logic Apps , à l’exception des suivantes :
     - régions Azure Government
     - régions de chine Azure
     - Us Department of Defense (DoD)
Power Apps Premium Toutes les régions Power Apps à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Toutes les régions Power Automate à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Contact
Nom Prise en charge de Fulcrum
URL https://www.fulcrumapp.com/support
Messagerie électronique support@fulcrumapp.com
Métadonnées du connecteur
Éditeur Spatial Networks, Inc.
Site web https://www.fulcrumapp.com
Politique de confidentialité https://www.fulcrumapp.com/privacy
Catégories Productivité; Données

Fulcrum

Fulcrum est une solution de premier plan qui permet aux experts SIG et aux membres de l’équipe non-GIS de capturer et partager facilement des données géospatiales. Ce connecteur permet l’intégration à Fulcrum pour la gestion des données de champ, des photos, des vidéos, etc.

Éditeur

Fulcrum

Prerequisites

  • Abonnement Fulcrum actif avec accès à l’API activé

Opérations prises en charge

Triggers

Lorsqu’un événement Fulcrum se produit

Se déclenche lorsqu’une ressource Fulcrum est créée, mise à jour ou supprimée. Prend en charge les événements pour les enregistrements, les formulaires, les listes de choix et les jeux de classification. Configurez le webhook dans votre organisation Fulcrum pour spécifier les événements à surveiller.

Actions

Obtenir la liste des métadonnées de pièce jointe

Récupérez une liste de pièces jointes.

Obtenir une pièce jointe

Récupérez les métadonnées d’une pièce jointe unique.

Obtenir la liste des métadonnées audio

Récupérez les métadonnées d’une liste de fichiers audio.

Obtenir un fichier d’origine audio

Téléchargez le fichier audio d’origine.

Obtenir la liste des métadonnées de photo

Récupérer les métadonnées d’une liste de photos.

Obtenir un fichier d’origine photo

Téléchargez le fichier photo d’origine.

Obtenir des métadonnées de photo

Récupérer les métadonnées d’une seule photo.

Effectuer une requête POST de requête

Exécutez une requête d’API de requête à l’aide de HTTP POST. Fournissez un sql comme une requête à interroger sur les données de votre organisation.

Obtenir la liste des enregistrements

Obtenez la liste des enregistrements de votre organisation qui peuvent être filtrés par dimensions telles que le formulaire, le projet, le jeu de modifications, la zone englobante et les plages de dates.

Créer un enregistrement

Créez un enregistrement dans le formulaire spécifié à l’aide des valeurs de formulaire fournies, des informations d’emplacement et des métadonnées associées.

Supprimer un enregistrement

Supprimez un enregistrement de votre organisation.

Obtenir un enregistrement

Récupérez des informations détaillées sur un enregistrement spécifique par son ID. Cela inclut toutes les valeurs de champ de formulaire, les données d’emplacement, les horodatages et les métadonnées associées.

Mettre à jour partiellement un enregistrement

Mettez à jour des champs spécifiques d’un enregistrement existant sans nécessiter l’objet d’enregistrement complet. Seuls les champs inclus dans le corps de la demande seront modifiés, tandis que tous les autres champs restent inchangés. Cela est utile pour mettre à jour des valeurs de champ ou des métadonnées individuelles.

Mettre à jour un enregistrement

Mettez à jour un enregistrement avec un objet d’enregistrement fourni. L’objet d’enregistrement est censé être la représentation complète de l’enregistrement. Tous les champs non inclus sont supposés null.

Obtenir l’historique d’un enregistrement

Récupérez l’historique de version complet d’un enregistrement.

Créer un rapport

Générez un nouveau rapport pour un enregistrement spécifique, éventuellement à l’aide d’un modèle de rapport.

Obtenir un fichier de rapport

Téléchargez le fichier de rapport PDF généré.

Obtenir la liste des métadonnées de signature

Récupérez les métadonnées d’une liste de signatures.

Obtenir les métadonnées de signature

Récupérez les métadonnées d’une seule signature.

Obtenir un fichier d’origine de signature

Téléchargez le fichier de signature d’origine.

Obtenir la liste des métadonnées de croquis

Récupérez les métadonnées d’une liste de croquis.

Obtenir un fichier d’origine de croquis

Téléchargez le fichier de croquis d’origine.

Obtenir des métadonnées de croquis

Récupérez les métadonnées d’un croquis unique.

Obtenir la liste des métadonnées vidéo

Récupérer les métadonnées d’une liste de vidéos.

Obtenir un fichier d’origine vidéo

Téléchargez le fichier vidéo d’origine.

Obtention des informations d’identification

Pour utiliser le connecteur Fulcrum, vous avez besoin d’un jeton d’API Fulcrum :

  1. Connectez-vous à votre compte Fulcrum à l’adresse https://web.fulcrumapp.com
  2. Accéder à l’API Paramètres >
  3. Générer un nouveau jeton d’API ou utiliser un jeton existant
  4. Copiez le jeton et utilisez-le lors de la création d’une connexion

Getting Started

Créez une connexion et entrez votre jeton d’API Fulcrum lorsque vous y êtes invité.

URL d’hôte personnalisées

Par défaut, le connecteur utilise l’API Fulcrum de production sur api.fulcrumapp.com. Pour d’autres régions, vous pouvez spécifier une URL hôte différente lors de la création de votre connexion.

Points de terminaison régionaux :

  • United States (valeur par défaut) : api.fulcrumapp.com
  • Canada :api.fulcrumapp-ca.com
  • Australie: api.fulcrumapp-au.com
  • Europe: api.fulcrumapp-eu.com

Format: Entrez uniquement le nom d’hôte sans protocole ou chemin d’accès. Le connecteur utilise automatiquement HTTPS et le chemin d’accès d’API approprié.

Résolution des problèmes :

  • Vérifiez que votre hôte personnalisé est accessible à partir de votre réseau
  • Vérifiez que le nom d’hôte est correct (aucune faute de frappe)
  • Vérifiez que votre jeton d’API est valide pour l’hôte spécifié

Problèmes connus et limitations

  • La limitation de débit s’applique en fonction de votre plan Fulcrum

Instructions de déploiement

Utilisez les instructions these pour déployer ce connecteur en tant que connecteur personnalisé dans Microsoft Power Automate et Power Apps.

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :

Par défaut Paramètres de création de connexion. Toutes les régions Non partageable

Faire défaut

Applicable : Toutes les régions

Paramètres de création de connexion.

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Nom Type Description Obligatoire
Jeton d'API securestring Votre jeton d’API Fulcrum pour l’authentification Vrai
URL de l’hôte ficelle Hôte d’API pour votre instance Fulcrum

Limitations

Nom Appels Période de renouvellement
Appels d’API par connexion 100 60 secondes

Actions

Créer un enregistrement

Créez un enregistrement dans le formulaire spécifié à l’aide des valeurs de formulaire fournies, des informations d’emplacement et des métadonnées associées.

Créer un rapport

Générez un nouveau rapport pour un enregistrement spécifique, éventuellement à l’aide d’un modèle de rapport.

Effectuer une requête POST de requête

Exécutez une requête d’API de requête à l’aide de HTTP POST. Fournissez un sql comme une requête à interroger sur les données de votre organisation.

Mettre à jour partiellement un enregistrement

Mettez à jour des champs spécifiques d’un enregistrement existant sans nécessiter l’objet d’enregistrement complet. Seuls les champs inclus dans le corps de la demande seront modifiés, tandis que tous les autres champs restent inchangés. Cela est utile pour mettre à jour des valeurs de champ ou des métadonnées individuelles.

Mettre à jour un enregistrement

Mettez à jour un enregistrement avec un objet d’enregistrement fourni. L’objet d’enregistrement est censé être la représentation complète de l’enregistrement. Tous les champs non inclus sont supposés null.

Obtenir des métadonnées de croquis

Récupérez les métadonnées d’un croquis unique.

Obtenir des métadonnées de photo

Récupérer les métadonnées d’une seule photo.

Obtenir la liste des enregistrements

Obtenez la liste des enregistrements de votre organisation qui peuvent être filtrés par dimensions telles que le formulaire, le projet, le jeu de modifications, la zone englobante et les plages de dates.

Obtenir la liste des métadonnées audio

Récupérez les métadonnées d’une liste de fichiers audio.

Obtenir la liste des métadonnées de croquis

Récupérez les métadonnées d’une liste de croquis.

Obtenir la liste des métadonnées de photo

Récupérer les métadonnées d’une liste de photos.

Obtenir la liste des métadonnées de pièce jointe

Récupérez une liste de pièces jointes.

Obtenir la liste des métadonnées de signature

Récupérez les métadonnées d’une liste de signatures.

Obtenir la liste des métadonnées vidéo

Récupérer les métadonnées d’une liste de vidéos.

Obtenir les métadonnées de signature

Récupérez les métadonnées d’une seule signature.

Obtenir l’historique d’un enregistrement

Récupérez l’historique de version complet d’un enregistrement.

Obtenir un enregistrement

Récupérez des informations détaillées sur un enregistrement spécifique par son ID. Cela inclut toutes les valeurs de champ de formulaire, les données d’emplacement, les horodatages et les métadonnées associées.

Obtenir un fichier de rapport

Téléchargez le fichier de rapport PDF généré.

Obtenir un fichier d’origine audio

Téléchargez le fichier audio d’origine.

Obtenir un fichier d’origine de croquis

Téléchargez le fichier de croquis d’origine.

Obtenir un fichier d’origine de signature

Téléchargez le fichier de signature d’origine.

Obtenir un fichier d’origine photo

Téléchargez le fichier photo d’origine.

Obtenir un fichier d’origine vidéo

Téléchargez le fichier vidéo d’origine.

Obtenir une pièce jointe

Récupérez les métadonnées d’une pièce jointe unique.

Supprimer un enregistrement

Supprimez un enregistrement de votre organisation.

Créer un enregistrement

Créez un enregistrement dans le formulaire spécifié à l’aide des valeurs de formulaire fournies, des informations d’emplacement et des métadonnées associées.

Paramètres

Nom Clé Obligatoire Type Description
Type de contenu
Content-Type string

Type de contenu

X Skipworkflows
X-SkipWorkflows boolean

Ignore tous les flux de travail d’application

X Skipwebhooks
X-SkipWebhooks boolean

Ignore tous les webhooks d’application

assigned_to_id
assigned_to_id string

ID de l’utilisateur affecté à cet enregistrement

form_id
form_id True string

ID du formulaire auquel appartient cet enregistrement

form_values
form_values object

Valeurs de champ clé par clé de champ

coordinates
coordinates True

Coordonnées pour la géométrie. Le format varie selon le type : les points utilisent [longitude, latitude], LineString utilise un tableau de positions, Polygon utilise un tableau d’anneaux linéaires (tout d’abord est extérieur, les restes sont des trous), les types Multi* utilisent des tableaux de leurs structures de coordonnées respectives.

type
type True string

Type de géométrie GeoJSON

latitude
latitude number

Coordonnée de latitude

longitude
longitude number

Coordonnée de longitude

project_id
project_id string

ID du projet

status
status string

État de l’enregistrement

Retours

Créer un rapport

Générez un nouveau rapport pour un enregistrement spécifique, éventuellement à l’aide d’un modèle de rapport.

Paramètres

Nom Clé Obligatoire Type Description
record_id
record_id True uuid

ID de l’enregistrement pour lequel générer un rapport

template_id
template_id uuid

ID du modèle de rapport à utiliser (facultatif)

Retours

Effectuer une requête POST de requête

Exécutez une requête d’API de requête à l’aide de HTTP POST. Fournissez un sql comme une requête à interroger sur les données de votre organisation.

Paramètres

Nom Clé Obligatoire Type Description
Page
page integer

Numéro de page demandé.

Par page
per_page integer

Nombre d’éléments à retourner par page.

format
format string

Format de la réponse

q
q True string

Requête SQL à exécuter

nom_de_table
table_name string

Nom de la table à interroger

Mettre à jour partiellement un enregistrement

Mettez à jour des champs spécifiques d’un enregistrement existant sans nécessiter l’objet d’enregistrement complet. Seuls les champs inclus dans le corps de la demande seront modifiés, tandis que tous les autres champs restent inchangés. Cela est utile pour mettre à jour des valeurs de champ ou des métadonnées individuelles.

Paramètres

Nom Clé Obligatoire Type Description
Type de contenu
Content-Type string

Type de contenu

ID d’enregistrement
record_id True string

ID enregistrement

X Skipworkflows
X-SkipWorkflows boolean

Ignore tous les flux de travail d’application

X Skipwebhooks
X-SkipWebhooks boolean

Ignore tous les webhooks d’application

assigned_to_id
assigned_to_id string

ID de l’utilisateur affecté à cet enregistrement

form_values
form_values object

Valeurs de champ clé par clé de champ

coordinates
coordinates True

Coordonnées pour la géométrie. Le format varie selon le type : les points utilisent [longitude, latitude], LineString utilise un tableau de positions, Polygon utilise un tableau d’anneaux linéaires (tout d’abord est extérieur, les restes sont des trous), les types Multi* utilisent des tableaux de leurs structures de coordonnées respectives.

type
type True string

Type de géométrie GeoJSON

latitude
latitude number

Coordonnée de latitude

longitude
longitude number

Coordonnée de longitude

project_id
project_id string

ID du projet

status
status string

État de l’enregistrement

Retours

Mettre à jour un enregistrement

Mettez à jour un enregistrement avec un objet d’enregistrement fourni. L’objet d’enregistrement est censé être la représentation complète de l’enregistrement. Tous les champs non inclus sont supposés null.

Paramètres

Nom Clé Obligatoire Type Description
Type de contenu
Content-Type string

Type de contenu

ID d’enregistrement
record_id True string

ID enregistrement

X Skipworkflows
X-SkipWorkflows boolean

Ignore tous les flux de travail d’application

X Skipwebhooks
X-SkipWebhooks boolean

Ignore tous les webhooks d’application

assigned_to_id
assigned_to_id string

ID de l’utilisateur affecté à cet enregistrement

form_id
form_id True string

ID du formulaire auquel appartient cet enregistrement

form_values
form_values object

Valeurs de champ clé par clé de champ

coordinates
coordinates True

Coordonnées pour la géométrie. Le format varie selon le type : les points utilisent [longitude, latitude], LineString utilise un tableau de positions, Polygon utilise un tableau d’anneaux linéaires (tout d’abord est extérieur, les restes sont des trous), les types Multi* utilisent des tableaux de leurs structures de coordonnées respectives.

type
type True string

Type de géométrie GeoJSON

latitude
latitude number

Coordonnée de latitude

longitude
longitude number

Coordonnée de longitude

project_id
project_id string

ID du projet

status
status string

État de l’enregistrement

Obtenir des métadonnées de croquis

Récupérez les métadonnées d’un croquis unique.

Paramètres

Nom Clé Obligatoire Type Description
ID de croquis
sketch_id True string

ID de croquis

Retours

Obtenir des métadonnées de photo

Récupérer les métadonnées d’une seule photo.

Paramètres

Nom Clé Obligatoire Type Description
Photo Id
photo_id True string

Identificateur unique de la photo.

Retours

Obtenir la liste des enregistrements

Obtenez la liste des enregistrements de votre organisation qui peuvent être filtrés par dimensions telles que le formulaire, le projet, le jeu de modifications, la zone englobante et les plages de dates.

Paramètres

Nom Clé Obligatoire Type Description
Premier le plus récent
newest_first boolean

S’il est présent, les enregistrements sont triés par date updated_at.

Cadre englobant
bounding_box string

Zone englobante des enregistrements demandés. Le format doit être : lat,long,lat,long (bas, gauche, haut, droite).

Id de l’ensemble de modifications
changeset_id string

ID du jeu de modifications associé à l’enregistrement.

ID de formulaire
form_id string

ID du formulaire auquel l’enregistrement est associé. Si vous laissez ce champ vide, vous allez interroger tous vos enregistrements.

ID de projet
project_id string

ID du projet auquel l’enregistrement est associé. Si vous laissez ce champ vide, vous allez interroger tous vos enregistrements.

Client créé avant
client_created_before date-time

Retourne uniquement les enregistrements créés par le client (appareil) avant l’heure donnée.

Client créé depuis
client_created_since date-time

Retourne uniquement les enregistrements créés par le client (appareil) après l’heure donnée.

Client mis à jour avant
client_updated_before date-time

Retourne uniquement les enregistrements qui ont été mis à jour par le client (appareil) avant l’heure donnée.

Client mis à jour depuis
client_updated_since date-time

Retourne uniquement les enregistrements qui ont été mis à jour par le client (appareil) après l’heure donnée.

Créé avant
created_before date-time

Retourne uniquement les enregistrements créés (sur le serveur) avant l’heure donnée.

Créé depuis
created_since date-time

Retourne uniquement les enregistrements créés (sur le serveur) après l’heure donnée.

Mise à jour avant
updated_before date-time

Retourne uniquement les enregistrements qui ont été mis à jour (sur le serveur) avant l’heure donnée.

Mise à jour depuis
updated_since date-time

Retourne uniquement les enregistrements qui ont été mis à jour (sur le serveur) après l’heure donnée.

Page
page integer

Numéro de page demandé

Par page
per_page integer

Nombre d’éléments par page

Retours

Obtenir la liste des métadonnées audio

Récupérez les métadonnées d’une liste de fichiers audio.

Paramètres

Nom Clé Obligatoire Type Description
ID d’enregistrement
record_id string

ID de l’enregistrement auquel le fichier audio est associé.

ID de formulaire
form_id string

ID du formulaire auquel le fichier audio est associé. En laissant ce champ vide, vous allez interroger tous vos fichiers audio.

Premier le plus récent
newest_first boolean

S’il est présent, les fichiers audio sont triés par date updated_at.

Traité
processed boolean

Filtrez les fichiers audio qui ont été complètement traités.

Stocké
stored boolean

Filtrez les fichiers audio qui ont été entièrement stockés.

Téléchargé
uploaded boolean

Filtrez les fichiers audio qui ont été entièrement chargés.

Page
page integer

Numéro de page demandé.

Par page
per_page integer

Nombre d’éléments à retourner par page.

Retours

Obtenir la liste des métadonnées de croquis

Récupérez les métadonnées d’une liste de croquis.

Paramètres

Nom Clé Obligatoire Type Description
ID d’enregistrement
record_id string

ID de l’enregistrement auquel l’croquis est associé.

ID de formulaire
form_id string

ID du formulaire auquel l’croquis est associé. Laissant cette valeur vide interrogera toutes vos croquis.

Premier le plus récent
newest_first boolean

Si elles sont présentes, les croquis sont triés par updated_at date.

Traité
processed boolean

Croquis a été complètement traité.

Stocké
stored boolean

Croquis a été entièrement stocké.

Téléchargé
uploaded boolean

Sketch a été entièrement chargé.

Page
page integer

Numéro de page demandé

Par page
per_page integer

Nombre d’éléments par page

Retours

Obtenir la liste des métadonnées de photo

Récupérer les métadonnées d’une liste de photos.

Paramètres

Nom Clé Obligatoire Type Description
ID d’enregistrement
record_id string

ID de l’enregistrement auquel la photo est associée.

ID de formulaire
form_id string

ID du formulaire auquel la photo est associée. Laisser ce vide interrogera sur toutes vos photos.

Premier le plus récent
newest_first boolean

Si elles sont présentes, les photos seront triées par updated_at date.

Traité
processed boolean

Filtrez les photos qui ont été entièrement traitées.

Stocké
stored boolean

Filtrez les photos qui ont été entièrement stockées.

Téléchargé
uploaded boolean

Filtrez les photos qui ont été entièrement chargées.

Page
page integer

Numéro de page demandé.

Par page
per_page integer

Nombre d’éléments à retourner par page.

Retours

Obtenir la liste des métadonnées de pièce jointe

Récupérez une liste de pièces jointes.

Paramètres

Nom Clé Obligatoire Type Description
ID d’enregistrement
record_id string

ID de l’enregistrement auquel la pièce jointe est associée. Cela est nécessaire lors de la liste des pièces jointes d’enregistrement.

ID de formulaire
form_id string

ID du formulaire auquel la pièce jointe est associée. Ce paramètre vous permet d’obtenir tous les fichiers de référence dans un formulaire, PAS tous les pièces jointes d’enregistrement dans un formulaire

Type de propriétaire
owner_type string

Type de pièce jointe à rechercher. Doit être soit form soit soit record.

Trier
sort string

Champ par lequel trier les résultats.

Direction du tri
sort_direction string

Direction de tri(asc, desc). La valeur par défaut est asc.

Retours

Obtenir la liste des métadonnées de signature

Récupérez les métadonnées d’une liste de signatures.

Paramètres

Nom Clé Obligatoire Type Description
ID d’enregistrement
record_id string

ID de l’enregistrement auquel la photo est associée.

ID de formulaire
form_id string

ID du formulaire auquel la photo est associée. Laisser ce vide interrogera sur toutes vos photos.

Premier le plus récent
newest_first boolean

Si elles sont présentes, les photos seront triées par updated_at date.

Traité
processed boolean

Filtrez les signatures qui ont été entièrement traitées.

Stocké
stored boolean

Filtrez les signatures qui ont été entièrement stockées.

Téléchargé
uploaded boolean

Filtrez les signatures qui ont été entièrement chargées.

Page
page integer

Numéro de page demandé.

Par page
per_page integer

Nombre d’éléments à retourner par page.

Retours

Obtenir la liste des métadonnées vidéo

Récupérer les métadonnées d’une liste de vidéos.

Paramètres

Nom Clé Obligatoire Type Description
ID d’enregistrement
record_id string

ID de l’enregistrement auquel la vidéo est associée.

ID de formulaire
form_id string

ID du formulaire auquel la vidéo est associée. Laisser ce champ vide interrogera toutes vos vidéos.

Premier le plus récent
newest_first boolean

Si elles sont présentes, les vidéos seront triées par date updated_at.

Traité
processed boolean

Filtrez les vidéos qui ont été entièrement traitées.

Stocké
stored boolean

Filtrez les vidéos qui ont été entièrement stockées.

Téléchargé
uploaded boolean

Filtrez les vidéos qui ont été entièrement chargées.

Page
page integer

Numéro de page demandé.

Par page
per_page integer

Nombre d’éléments à retourner par page.

Retours

Obtenir les métadonnées de signature

Récupérez les métadonnées d’une seule signature.

Paramètres

Nom Clé Obligatoire Type Description
Signature Id
signature_id True string

Identificateur unique de la signature.

Retours

Obtenir l’historique d’un enregistrement

Récupérez l’historique de version complet d’un enregistrement.

Paramètres

Nom Clé Obligatoire Type Description
ID d’enregistrement
record_id True string

Identificateur unique de l’enregistrement dont vous souhaitez récupérer l’historique.

Retours

Obtenir un enregistrement

Récupérez des informations détaillées sur un enregistrement spécifique par son ID. Cela inclut toutes les valeurs de champ de formulaire, les données d’emplacement, les horodatages et les métadonnées associées.

Paramètres

Nom Clé Obligatoire Type Description
ID d’enregistrement
record_id True string

Identificateur unique de l’enregistrement à récupérer.

Retours

Obtenir un fichier de rapport

Téléchargez le fichier de rapport PDF généré.

Paramètres

Nom Clé Obligatoire Type Description
ID de rapport
report_id True uuid

Identificateur unique du rapport.

Retours

response
binary

Obtenir un fichier d’origine audio

Téléchargez le fichier audio d’origine.

Paramètres

Nom Clé Obligatoire Type Description
Audio Id
audio_id True string

Identificateur unique du fichier audio.

Retours

response
binary

Obtenir un fichier d’origine de croquis

Téléchargez le fichier de croquis d’origine.

Paramètres

Nom Clé Obligatoire Type Description
ID de croquis
sketch_id True string

ID de croquis

Retours

response
binary

Obtenir un fichier d’origine de signature

Téléchargez le fichier de signature d’origine.

Paramètres

Nom Clé Obligatoire Type Description
Signature Id
signature_id True string

Identificateur unique de la signature.

Retours

response
binary

Obtenir un fichier d’origine photo

Téléchargez le fichier photo d’origine.

Paramètres

Nom Clé Obligatoire Type Description
Photo Id
photo_id True string

Identificateur unique de la photo.

Retours

response
binary

Obtenir un fichier d’origine vidéo

Téléchargez le fichier vidéo d’origine.

Paramètres

Nom Clé Obligatoire Type Description
ID de la vidéo
video_id True string

Identificateur unique de la vidéo.

Retours

response
binary

Obtenir une pièce jointe

Récupérez les métadonnées d’une pièce jointe unique.

Paramètres

Nom Clé Obligatoire Type Description
ID de pièce jointe
attachment_id True string

Identificateur unique de la pièce jointe.

Retours

Corps
Attachment

Supprimer un enregistrement

Supprimez un enregistrement de votre organisation.

Paramètres

Nom Clé Obligatoire Type Description
ID d’enregistrement
record_id True string

Identificateur unique de l’enregistrement à supprimer.

X Skipworkflows
X-SkipWorkflows boolean

Ignore tous les flux de travail d’application

X Skipwebhooks
X-SkipWebhooks boolean

Ignore tous les webhooks d’application

Retours

Déclencheurs

Lorsqu’un événement Fulcrum se produit

Se déclenche lorsqu’une ressource Fulcrum est créée, mise à jour ou supprimée. Prend en charge les événements pour les enregistrements, les formulaires, les listes de choix et les jeux de classification. Configurez le webhook dans votre organisation Fulcrum pour spécifier les événements à surveiller.

Lorsqu’un événement Fulcrum se produit

Se déclenche lorsqu’une ressource Fulcrum est créée, mise à jour ou supprimée. Prend en charge les événements pour les enregistrements, les formulaires, les listes de choix et les jeux de classification. Configurez le webhook dans votre organisation Fulcrum pour spécifier les événements à surveiller.

Paramètres

Nom Clé Obligatoire Type Description
Type de contenu
Content-Type string

Type de contenu

active
active boolean

Indique si le webhook est activé

Nom du webhook
name True string

Nom complet du webhook

run_for_bulk_actions
run_for_bulk_actions boolean

Indique si le webhook s’exécute pour les actions d’enregistrement en bloc

Retours

Charge utile de l’événement Webhook à partir de Fulcrum

Définitions

Pièce jointe

Nom Chemin d’accès Type Description
attached_to_id
attached_to_id string

ID de la ressource à laquelle cette pièce jointe est attachée

attached_to_type
attached_to_type string

Type de ressource auquel cette pièce jointe est attachée

Intégration
complete boolean

Indique si le chargement de la pièce jointe est terminé

file_size
file_size integer

Taille du fichier de pièce jointe en octets

pièce d'identité
id string

Identificateur unique de la pièce jointe

nom
name string

Nom de fichier de la pièce jointe

propriétaires
owners array of object

Liste des références de propriétaire pour la pièce jointe

pièce d'identité
owners.id string

ID du propriétaire

type
owners.type string

Type de propriétaire (par exemple, 'record' ou 'form')

status
status string

État de la pièce jointe

uploaded_at
uploaded_at date-time

Horodatage lorsque la pièce jointe a été chargée

url
url uri

URL permettant d’accéder à la pièce jointe

AttachmentsResponse

Nom Chemin d’accès Type Description
attachments
attachments array of Attachment
total
total integer

Nombre total de pièces jointes retournées

total_count
total_count integer

Nombre total de pièces jointes disponibles

Audio

Nom Chemin d’accès Type Description
access_key
access_key string

Identificateur unique pour la ressource audio

content_type
content_type string

Type MIME du fichier audio

date_de_création
created_at date-time

Horodatage lors de la création de l’audio

created_by
created_by string

Nom complet de l’utilisateur qui a créé l’audio

created_by_id
created_by_id string

ID de l’utilisateur qui a créé l’audio

deleted_at
deleted_at date-time

Horodatage lorsque l’audio a été supprimé

file_size
file_size integer

Taille du fichier audio en octets

form_id
form_id string

ID du formulaire associé

moyenne
medium uri

URL vers une version moyenne de l’audio (en cas de traitement)

metadata
metadata object

Métadonnées audio (par exemple, durée, détails de format)

ressource d’origine
original uri

URL du fichier audio d’origine (si stockée)

Traitées
processed boolean

Indique si l’audio a été traité

record_id
record_id string

ID de l’enregistrement associé

petit
small uri

URL vers une petite version de l’audio (en cas de traitement)

status
status string

État de traitement de l’audio

Stockées
stored boolean

Indique si l’audio a été stocké

track
track uri

URL permettant d’accéder à la piste audio (le cas échéant)

updated_at
updated_at date-time

Horodatage de la dernière mise à jour de l’audio

updated_by
updated_by string

Nom complet de l’utilisateur qui a mis à jour l’audio pour la dernière fois

updated_by_id
updated_by_id string

ID de l’utilisateur qui a mis à jour l’audio pour la dernière fois

Téléchargé
uploaded boolean

Indique si l’audio a été chargé

url
url uri

URL permettant d’accéder à la ressource audio

AudiosResponse

Nom Chemin d’accès Type Description
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

Métadonnées d’emplacement capturées au moment de la création ou de la mise à jour.

Nom Chemin d’accès Type Description
altitude
altitude double

Altitude en mètres.

horizontal_accuracy
horizontal_accuracy double

Précision horizontale en mètres.

latitude
latitude double

Coordonnée de latitude.

longitude
longitude double

Coordonnée de longitude.

Geometry

Nom Chemin d’accès Type Description
coordinates
coordinates

Coordonnées pour la géométrie. Le format varie selon le type : les points utilisent [longitude, latitude], LineString utilise un tableau de positions, Polygon utilise un tableau d’anneaux linéaires (tout d’abord est extérieur, les restes sont des trous), les types Multi* utilisent des tableaux de leurs structures de coordonnées respectives.

type
type string

Type de géométrie GeoJSON

Photo

Nom Chemin d’accès Type Description
access_key
access_key string

Identificateur unique de la photo

content_type
content_type string

Type MIME de la photo

date_de_création
created_at date-time

Lorsque la photo a été créée

created_by
created_by string

Nom d’affichage de l’utilisateur qui a créé la photo

created_by_id
created_by_id string

ID de l’utilisateur qui a créé la photo

deleted_at
deleted_at date-time

Lorsque la photo a été supprimée

exif
exif object

Métadonnées EXIF de la photo

file_size
file_size integer

Taille du fichier photo en octets

form_id
form_id string

ID du formulaire associé

large
large uri

URL vers une version volumineuse de la photo

latitude
latitude double

Coordonnée de latitude où la photo a été prise

longitude
longitude double

Coordonnée de longitude où la photo a été prise

ressource d’origine
original uri

URL vers la version d’origine de la photo

Traitées
processed boolean

Indique si la photo a été traitée

record_id
record_id string

ID de l’enregistrement associé

Stockées
stored boolean

Indique si la photo a été stockée

Vignette
thumbnail uri

URL vers la version miniature de la photo

updated_at
updated_at date-time

Lorsque la photo a été mise à jour pour la dernière fois

updated_by
updated_by string

Nom complet de l’utilisateur qui a mis à jour la photo pour la dernière fois

updated_by_id
updated_by_id string

ID de l’utilisateur qui a mis à jour la photo pour la dernière fois

Téléchargé
uploaded boolean

Indique si la photo a été chargée

url
url uri

URL de l’API pour cette ressource photo

PhotosResponse

Nom Chemin d’accès Type Description
current_page
current_page integer
per_page
per_page integer
photos
photos array of Photo
total_count
total_count integer
total_pages
total_pages integer

Enregistrement

Nom Chemin d’accès Type Description
altitude
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
cours
course number
date_de_création
created_at date-time
created_by
created_by string
created_by_id
created_by_id string
created_duration
created_duration number
created_location
created_location AuditLocation

Métadonnées d’emplacement capturées au moment de la création ou de la mise à jour.

edited_duration
edited_duration number
form_id
form_id string
form_values
form_values object

Valeurs de champ clé par clé de champ : les valeurs peuvent être des chaînes, des objets ou des tableaux en fonction du type de champ

géométrie
geometry Geometry
horizontal_accuracy
horizontal_accuracy number
pièce d'identité
id string
latitude
latitude number
longitude
longitude number
project_id
project_id string
record_series_id
record_series_id string
speed
speed number
status
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

Métadonnées d’emplacement capturées au moment de la création ou de la mise à jour.

version
version integer
vertical_accuracy
vertical_accuracy number

RecordHistoryItem

Nom Chemin d’accès Type Description
altitude
altitude double

Enregistrer l’altitude d’emplacement en mètres

assigned_to
assigned_to string

Nom complet de l’utilisateur affecté

assigned_to_id
assigned_to_id string

ID de l’utilisateur affecté

changeset_id
changeset_id string

ID de l’ensemble de modifications

client_created_at
client_created_at date-time

Horodatage de création côté client

client_updated_at
client_updated_at date-time

Horodatage de mise à jour côté client

cours
course double

Cours/titre en degrés

date_de_création
created_at date-time

Horodatage de création d’enregistrement

created_by
created_by string

Nom d’affichage de l’utilisateur qui a créé l’enregistrement

created_by_id
created_by_id string

ID de l’utilisateur qui a créé l’enregistrement

created_duration
created_duration integer

Durée de la création d’enregistrements en secondes

created_location
created_location AuditLocation

Métadonnées d’emplacement capturées au moment de la création ou de la mise à jour.

edited_duration
edited_duration integer

Durée totale de modification en secondes

form_id
form_id string

ID de formulaire

form_values
form_values object

Valeurs de champ de formulaire (traitées)

form_version
form_version integer

Version du formulaire au moment de la création/mise à jour de l’enregistrement

coordinates
geometry.coordinates array of number
type
geometry.type string
history_change_type
history_change_type string

Type de modification (c=create, u=update, d=delete)

history_changed_by
history_changed_by string

Nom complet de l’utilisateur qui a apporté cette modification

history_changed_by_id
history_changed_by_id string

ID de l’utilisateur qui a apporté cette modification

history_created_at
history_created_at date-time

Horodatage lors de la création de cette entrée d’historique

history_id
history_id string

ID d’entrée d’historique

horizontal_accuracy
horizontal_accuracy double

Précision horizontale en mètres

pièce d'identité
id string

ID enregistrement

latitude
latitude double

Latitude de l’emplacement de l’enregistrement

longitude
longitude double

Longitude de l’emplacement de l’enregistrement

project_id
project_id string

ID Projet

record_key
record_key string

Clé d’enregistrement facultative

record_sequence
record_sequence integer

Numéro de séquence d’enregistrement facultatif

séquence
sequence integer

Numéro de séquence (lors de l’utilisation de la pagination basée sur la séquence)

speed
speed double

Vitesse au moment de la création d’enregistrements en m/s

status
status string

État de l’enregistrement

updated_at
updated_at date-time

Enregistrer l’horodatage de la dernière mise à jour

updated_by
updated_by string

Nom complet de l’utilisateur qui a mis à jour l’enregistrement pour la dernière fois

updated_by_id
updated_by_id string

ID de l’utilisateur qui a mis à jour l’enregistrement pour la dernière fois

updated_duration
updated_duration integer

Durée de la mise à jour d’enregistrement en secondes

updated_location
updated_location AuditLocation

Métadonnées d’emplacement capturées au moment de la création ou de la mise à jour.

version
version integer

Numéro de version d’enregistrement

vertical_accuracy
vertical_accuracy double

Précision verticale en mètres

RecordHistoryResponse

Nom Chemin d’accès Type Description
current_page
current_page integer

Numéro de page actuel (lors de l’utilisation de la pagination)

next_sequence
next_sequence integer

Numéro de séquence suivant (lors de l’utilisation de la pagination basée sur la séquence)

per_page
per_page integer

Nombre d’enregistrements par page (lors de l’utilisation de la pagination)

archives
records array of RecordHistoryItem
total_count
total_count integer

Nombre total d’enregistrements (lors de l’utilisation de la pagination)

total_pages
total_pages integer

Nombre total de pages (lors de l’utilisation de la pagination)

RecordsResponse

Nom Chemin d’accès Type Description
current_page
current_page integer
per_page
per_page integer
archives
records array of Record
total_count
total_count integer
total_pages
total_pages integer

ReportResponse

Nom Chemin d’accès Type Description
terminé_à
report.completed_at date-time

Horodatage lorsque la génération de rapport est terminée

date_de_création
report.created_at date-time

Horodatage lors de la création du rapport

failed_at
report.failed_at date-time

Horodatage lors de l’échec de la génération de rapport (null en cas de réussite)

pièce d'identité
report.id uuid

Identificateur unique du rapport

record_id
report.record_id uuid

ID de l’enregistrement pour lequel le rapport a été généré

started_at
report.started_at date-time

Horodatage au démarrage de la génération de rapports

état
report.state string

État du rapport

template_id
report.template_id uuid

ID du modèle utilisé pour générer le rapport

updated_at
report.updated_at date-time

Horodatage de la dernière mise à jour du rapport

url
report.url uri

URL pour télécharger le rapport généré

Signature

Nom Chemin d’accès Type Description
access_key
access_key string

Identificateur unique de la signature

content_type
content_type string

Type MIME du fichier de signature

date_de_création
created_at date-time

Horodatage lors de la création de la signature

created_by
created_by string

Nom complet de l’utilisateur qui a créé la signature

created_by_id
created_by_id string

ID de l’utilisateur qui a créé la signature

deleted_at
deleted_at date-time

Horodatage lorsque la signature a été supprimée

file_size
file_size integer

Taille du fichier de signature en octets

form_id
form_id string

ID du formulaire associé

large
large uri

URL vers la version volumineuse de la signature

ressource d’origine
original uri

URL du fichier de signature d’origine

Traitées
processed boolean

Indique si la signature a été traitée

record_id
record_id string

ID de l’enregistrement associé

Stockées
stored boolean

Indique si la signature a été stockée

Vignette
thumbnail uri

URL vers la version miniature de la signature

updated_at
updated_at date-time

Horodatage de la dernière mise à jour de la signature

updated_by
updated_by string

Nom complet de l’utilisateur qui a mis à jour la signature pour la dernière fois

updated_by_id
updated_by_id string

ID de l’utilisateur qui a mis à jour la signature pour la dernière fois

Téléchargé
uploaded boolean

Indique si la signature a été chargée

url
url uri

URL de l’API pour récupérer cette signature

SignaturesResponse

Nom Chemin d’accès Type Description
current_page
current_page integer
per_page
per_page integer
Signatures
signatures array of Signature
total_count
total_count integer
total_pages
total_pages integer

SinglePhotoResponse

Nom Chemin d’accès Type Description
Photo
photo Photo

SingleRecordResponse

Nom Chemin d’accès Type Description
enregistrement
record Record

SingleSignatureResponse

Nom Chemin d’accès Type Description
signature
signature Signature

SingleSketchResponse

Nom Chemin d’accès Type Description
dessin
sketch Sketch

Diagramme simplifié

Nom Chemin d’accès Type Description
access_key
access_key string

Identificateur unique pour l’croquis

content_type
content_type string

Type MIME du fichier de croquis

date_de_création
created_at date-time

Horodatage lors de la création de l’croquis

created_by
created_by string

Nom complet de l’utilisateur qui a créé l’croquis

created_by_id
created_by_id string

ID de l’utilisateur qui a créé l’croquis

exif
exif object

Métadonnées EXIF de l’croquis

file_size
file_size integer

Taille du fichier de croquis en octets

form_id
form_id string

ID du formulaire associé

large
large uri

URL vers une version volumineuse de l’croquis

moyenne
medium uri

URL vers une version moyenne de l’croquis

ressource d’origine
original uri

URL vers la version d’origine de l’croquis

Traitées
processed boolean

Indique si l’croquis a été traité

record_id
record_id string

ID de l’enregistrement associé

petit
small uri

URL vers la petite version de l’croquis

Stockées
stored boolean

Indique si l’croquis a été stocké

Vignette
thumbnail uri

URL vers la version miniature de l’croquis

updated_at
updated_at date-time

Horodatage de la dernière mise à jour de l’croquis

updated_by
updated_by string

Nom complet de l’utilisateur qui a mis à jour l’croquis pour la dernière fois

updated_by_id
updated_by_id string

ID de l’utilisateur qui a mis à jour l’croquis pour la dernière fois

Téléchargé
uploaded boolean

Indique si le croquis a été chargé

url
url uri

URL de l’API pour accéder à cette ressource de croquis

SketchesResponse

Nom Chemin d’accès Type Description
current_page
current_page integer
per_page
per_page integer
Croquis
sketches array of Sketch
total_count
total_count integer
total_pages
total_pages integer

Video

Nom Chemin d’accès Type Description
access_key
access_key string

Identificateur unique pour la vidéo

content_type
content_type string

Type MIME du fichier vidéo

date_de_création
created_at date-time

Horodatage lors de la création de la vidéo

created_by
created_by string

Nom complet de l’utilisateur qui a créé la vidéo

created_by_id
created_by_id string

ID de l’utilisateur qui a créé la vidéo

deleted_at
deleted_at date-time

Horodatage lorsque la vidéo a été supprimée

file_size
file_size integer

Taille du fichier vidéo en octets

form_id
form_id string

ID du formulaire associé

moyenne
medium uri

URL vers une version moyenne de la vidéo

metadata
metadata object

Métadonnées supplémentaires sur la vidéo

ressource d’origine
original uri

URL du fichier vidéo d’origine

Traitées
processed boolean

Indique si la vidéo a été traitée

record_id
record_id string

ID de l’enregistrement associé

petit
small uri

URL vers la petite version de la vidéo

status
status string

État de traitement de la vidéo

Stockées
stored boolean

Indique si la vidéo a été stockée

thumbnail_huge
thumbnail_huge uri

URL vers une image miniature énorme

thumbnail_huge_square
thumbnail_huge_square uri

URL vers une image miniature carrée énorme

thumbnail_large
thumbnail_large uri

URL vers une image miniature volumineuse

thumbnail_large_square
thumbnail_large_square uri

URL vers une image miniature carrée volumineuse

thumbnail_medium
thumbnail_medium uri

URL vers une image miniature moyenne

thumbnail_medium_square
thumbnail_medium_square uri

URL vers l’image miniature carrée moyenne

thumbnail_small
thumbnail_small uri

URL vers une petite image miniature

thumbnail_small_square
thumbnail_small_square uri

URL vers une petite image miniature carrée

track
track uri

URL du suivi vidéo des données au format JSON, le cas échéant

updated_at
updated_at date-time

Horodatage de la dernière mise à jour de la vidéo

updated_by
updated_by string

Nom complet de l’utilisateur qui a mis à jour la vidéo pour la dernière fois

updated_by_id
updated_by_id string

ID de l’utilisateur qui a mis à jour la vidéo pour la dernière fois

Téléchargé
uploaded boolean

Indique si la vidéo a été chargée

url
url uri

URL de l’API pour accéder à cette ressource vidéo

VideosResponse

Nom Chemin d’accès Type Description
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

Charge utile de l’événement Webhook à partir de Fulcrum

Nom Chemin d’accès Type Description
ID d'événement
id string

Identificateur unique de l’événement

Type d’événement
type string

Type d’événement (par exemple, 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 du propriétaire
owner_id string

ID de l’organisation propriétaire de ce webhook

Données d’événement
data object

Données d’enregistrement ou de ressource associées à l’événement

Créé à
created_at date-time

Horodatage lorsque l’événement s’est produit

binaire

Il s’agit du type de données de base "binaire".