Compartir a través de


Fulcrum (versión preliminar)

Fulcrum es una solución de primer campo que permite a los expertos de GIS y a los miembros del equipo que no son GIS capturar y compartir fácilmente datos geoespaciales. Este conector permite la integración con Fulcrum para administrar datos de campo, fotos, vídeos, etc.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Premium Todas las regiones Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps excepto las siguientes:
     - regiones de Azure Government
     - Azure regiones de China
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Premium Todas las regiones Power Apps excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Power Automate Premium Todas las regiones Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Contacto
Nombre Compatibilidad con Fulcrum
URL https://www.fulcrumapp.com/support
Correo Electrónico support@fulcrumapp.com
Metadatos del conector
Publicador Spatial Networks, Inc.
Sitio web https://www.fulcrumapp.com
Directiva de privacidad https://www.fulcrumapp.com/privacy
Categorías Productividad; Datos

Fulcro

Fulcrum es una solución de primer campo que permite a los expertos de GIS y a los miembros del equipo que no son GIS capturar y compartir fácilmente datos geoespaciales. Este conector permite la integración con Fulcrum para administrar datos de campo, fotos, vídeos, etc.

Publicador

Fulcro

Prerrequisitos

  • Suscripción de Fulcrum activa con el acceso de API habilitado

Operaciones admitidas

Desencadenadores

Cuando se produce un evento Fulcrum

Se desencadena cuando se crea, actualiza o elimina un recurso de Fulcrum. Admite eventos para registros, formularios, listas de opciones y conjuntos de clasificación. Configure el webhook en la organización de Fulcrum para especificar qué eventos supervisar.

Acciones

Obtener una lista de metadatos adjuntos

Recuperar una lista de datos adjuntos.

Obtener datos adjuntos

Recupere los metadatos de un solo archivo adjunto.

Obtener una lista de metadatos de audio

Recupere los metadatos de una lista de archivos de audio.

Obtener un archivo original de audio

Descargue el archivo de audio original.

Obtener una lista de metadatos de fotos

Recupere los metadatos de una lista de fotos.

Obtener un archivo original de fotos

Descargue el archivo de fotos original.

Obtención de metadatos de fotos

Recupere los metadatos de una sola foto.

Realización de una solicitud POST de consulta

Ejecute una solicitud de API de consulta mediante HTTP POST. Proporcione una consulta sql como para consultar los datos de la organización.

Obtener una lista de registros

Obtenga una lista de registros de la organización que pueden filtrarse por dimensiones como formulario, proyecto, conjunto de cambios, rectángulo de límite y intervalos de fechas.

Crear un registro

Cree un nuevo registro en el formulario especificado con los valores de formulario proporcionados, la información de ubicación y los metadatos asociados.

Eliminar un registro

Elimine un registro de su organización.

Obtener un registro

Recupere información detallada sobre un registro específico por su identificador. Esto incluye todos los valores de campo de formulario, datos de ubicación, marcas de tiempo y metadatos asociados.

Actualizar parcialmente un registro

Actualice campos específicos de un registro existente sin requerir el objeto de registro completo. Solo se modificarán los campos incluidos en el cuerpo de la solicitud, mientras que todos los demás campos permanecen sin cambios. Esto es útil para actualizar los valores de campo individuales o los metadatos.

Actualizar un registro

Actualice un registro con un objeto de registro proporcionado. Se espera que el objeto de registro sea la representación completa del registro. Se supone que los campos que no están incluidos son NULL.

Obtener el historial de un registro

Recupere el historial de versiones completo de un registro.

Creación de un informe

Genere un nuevo informe para un registro específico, opcionalmente mediante una plantilla de informe.

Obtener un archivo de informe

Descargue el archivo de informe PDF generado.

Obtener una lista de metadatos de firma

Recupere los metadatos de una lista de firmas.

Obtención de metadatos de firma

Recupere los metadatos de una sola firma.

Obtener un archivo original de firma

Descargue el archivo de firma original.

Obtener una lista de metadatos de boceto

Recupere los metadatos de una lista de bocetos.

Obtener un archivo original de boceto

Descargue el archivo de boceto original.

Obtención de metadatos de boceto

Recuperar metadatos para un solo croquis.

Obtener una lista de metadatos de vídeo

Recupere los metadatos de una lista de vídeos.

Obtener un archivo original de vídeo

Descargue el archivo de vídeo original.

Obtención de credenciales

Para usar el conector de Fulcrum, necesita un token de API de Fulcrum:

  1. Inicie sesión en su cuenta de Fulcrum en https://web.fulcrumapp.com
  2. Vaya a Configuración > API
  3. Generación de un nuevo token de API o uso de uno existente
  4. Copie el token y úselo al crear una conexión

Introducción

Cree una nueva conexión y escriba el token de API de Fulcrum cuando se le solicite.

Direcciones URL de host personalizadas

De forma predeterminada, el conector usa la API de Fulcrum de producción en api.fulcrumapp.com. Para otras regiones, puede especificar una dirección URL de host diferente al crear la conexión.

Puntos de conexión regionales:

  • United States (valor predeterminado): api.fulcrumapp.com
  • Canadá: api.fulcrumapp-ca.com
  • Australia: api.fulcrumapp-au.com
  • Europa: api.fulcrumapp-eu.com

Formato: Escriba solo el nombre de host sin protocolo o ruta de acceso. El conector usará automáticamente HTTPS y la ruta de acceso de API correcta.

Solución de problemas:

  • Asegúrese de que el host personalizado sea accesible desde la red.
  • Compruebe que el nombre de host es correcto (sin errores tipográficos)
  • Confirmación de que el token de API es válido para el host especificado

Problemas conocidos y limitaciones

  • La limitación de velocidad se aplica en función del plan de Fulcrum

Instrucciones de implementación

Use las instrucciones para implementar este conector como conector personalizado en Microsoft Power Automate y Power Apps.

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Predeterminado Parámetros para crear una conexión. Todas las regiones No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre Tipo Descripción Obligatorio
Token API securestring El token de API de Fulcrum para la autenticación Cierto
URL del host cuerda / cadena Host de API para la instancia de Fulcrum

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos

Acciones

Actualizar parcialmente un registro

Actualice campos específicos de un registro existente sin requerir el objeto de registro completo. Solo se modificarán los campos incluidos en el cuerpo de la solicitud, mientras que todos los demás campos permanecen sin cambios. Esto es útil para actualizar los valores de campo individuales o los metadatos.

Actualizar un registro

Actualice un registro con un objeto de registro proporcionado. Se espera que el objeto de registro sea la representación completa del registro. Se supone que los campos que no están incluidos son NULL.

Creación de un informe

Genere un nuevo informe para un registro específico, opcionalmente mediante una plantilla de informe.

Crear un registro

Cree un nuevo registro en el formulario especificado con los valores de formulario proporcionados, la información de ubicación y los metadatos asociados.

Eliminar un registro

Elimine un registro de su organización.

Obtención de metadatos de boceto

Recuperar metadatos para un solo croquis.

Obtención de metadatos de firma

Recupere los metadatos de una sola firma.

Obtención de metadatos de fotos

Recupere los metadatos de una sola foto.

Obtener datos adjuntos

Recupere los metadatos de un solo archivo adjunto.

Obtener el historial de un registro

Recupere el historial de versiones completo de un registro.

Obtener un archivo de informe

Descargue el archivo de informe PDF generado.

Obtener un archivo original de audio

Descargue el archivo de audio original.

Obtener un archivo original de boceto

Descargue el archivo de boceto original.

Obtener un archivo original de firma

Descargue el archivo de firma original.

Obtener un archivo original de fotos

Descargue el archivo de fotos original.

Obtener un archivo original de vídeo

Descargue el archivo de vídeo original.

Obtener un registro

Recupere información detallada sobre un registro específico por su identificador. Esto incluye todos los valores de campo de formulario, datos de ubicación, marcas de tiempo y metadatos asociados.

Obtener una lista de metadatos adjuntos

Recuperar una lista de datos adjuntos.

Obtener una lista de metadatos de audio

Recupere los metadatos de una lista de archivos de audio.

Obtener una lista de metadatos de boceto

Recupere los metadatos de una lista de bocetos.

Obtener una lista de metadatos de firma

Recupere los metadatos de una lista de firmas.

Obtener una lista de metadatos de fotos

Recupere los metadatos de una lista de fotos.

Obtener una lista de metadatos de vídeo

Recupere los metadatos de una lista de vídeos.

Obtener una lista de registros

Obtenga una lista de registros de la organización que pueden filtrarse por dimensiones como formulario, proyecto, conjunto de cambios, rectángulo de límite y intervalos de fechas.

Realización de una solicitud POST de consulta

Ejecute una solicitud de API de consulta mediante HTTP POST. Proporcione una consulta sql como para consultar los datos de la organización.

Actualizar parcialmente un registro

Actualice campos específicos de un registro existente sin requerir el objeto de registro completo. Solo se modificarán los campos incluidos en el cuerpo de la solicitud, mientras que todos los demás campos permanecen sin cambios. Esto es útil para actualizar los valores de campo individuales o los metadatos.

Parámetros

Nombre Clave Requerido Tipo Description
Tipo de contenido
Content-Type string

Tipo de contenido

Id. de registro
record_id True string

Identificador de registro

X Skipworkflows
X-SkipWorkflows boolean

Omite todos los flujos de trabajo de la aplicación.

X Skipwebhooks
X-SkipWebhooks boolean

Omite todos los webhooks de la aplicación

assigned_to_id
assigned_to_id string

Identificador del usuario asignado a este registro

form_values
form_values object

Valores de campo con clave de campo

coordenadas
coordinates True

Coordenadas de la geometría. El formato varía según el tipo: los puntos usan [longitud, latitud], LineString usa matriz de posiciones, Polygon usa matriz de anillos lineales (primero es exterior, rest son agujeros), los tipos Multi* usan matrices de sus respectivas estructuras de coordenadas.

tipo
type True string

Tipo de geometría GeoJSON

latitud
latitude number

Coordenada de latitud

longitud
longitude number

Coordenada de longitud

project_id
project_id string

Id. del proyecto

estado
status string

Estado del registro

Devoluciones

Actualizar un registro

Actualice un registro con un objeto de registro proporcionado. Se espera que el objeto de registro sea la representación completa del registro. Se supone que los campos que no están incluidos son NULL.

Parámetros

Nombre Clave Requerido Tipo Description
Tipo de contenido
Content-Type string

Tipo de contenido

Id. de registro
record_id True string

Identificador de registro

X Skipworkflows
X-SkipWorkflows boolean

Omite todos los flujos de trabajo de la aplicación.

X Skipwebhooks
X-SkipWebhooks boolean

Omite todos los webhooks de la aplicación

assigned_to_id
assigned_to_id string

Identificador del usuario asignado a este registro

form_id
form_id True string

Identificador del formulario al que pertenece este registro

form_values
form_values object

Valores de campo con clave de campo

coordenadas
coordinates True

Coordenadas de la geometría. El formato varía según el tipo: los puntos usan [longitud, latitud], LineString usa matriz de posiciones, Polygon usa matriz de anillos lineales (primero es exterior, rest son agujeros), los tipos Multi* usan matrices de sus respectivas estructuras de coordenadas.

tipo
type True string

Tipo de geometría GeoJSON

latitud
latitude number

Coordenada de latitud

longitud
longitude number

Coordenada de longitud

project_id
project_id string

Id. del proyecto

estado
status string

Estado del registro

Creación de un informe

Genere un nuevo informe para un registro específico, opcionalmente mediante una plantilla de informe.

Parámetros

Nombre Clave Requerido Tipo Description
record_id
record_id True uuid

Identificador del registro para el que se va a generar un informe

template_id
template_id uuid

Identificador de la plantilla de informe que se va a usar (opcional)

Devoluciones

Crear un registro

Cree un nuevo registro en el formulario especificado con los valores de formulario proporcionados, la información de ubicación y los metadatos asociados.

Parámetros

Nombre Clave Requerido Tipo Description
Tipo de contenido
Content-Type string

Tipo de contenido

X Skipworkflows
X-SkipWorkflows boolean

Omite todos los flujos de trabajo de la aplicación.

X Skipwebhooks
X-SkipWebhooks boolean

Omite todos los webhooks de la aplicación

assigned_to_id
assigned_to_id string

Identificador del usuario asignado a este registro

form_id
form_id True string

Identificador del formulario al que pertenece este registro

form_values
form_values object

Valores de campo con clave de campo

coordenadas
coordinates True

Coordenadas de la geometría. El formato varía según el tipo: los puntos usan [longitud, latitud], LineString usa matriz de posiciones, Polygon usa matriz de anillos lineales (primero es exterior, rest son agujeros), los tipos Multi* usan matrices de sus respectivas estructuras de coordenadas.

tipo
type True string

Tipo de geometría GeoJSON

latitud
latitude number

Coordenada de latitud

longitud
longitude number

Coordenada de longitud

project_id
project_id string

Id. del proyecto

estado
status string

Estado del registro

Devoluciones

Eliminar un registro

Elimine un registro de su organización.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de registro
record_id True string

Identificador único del registro que se va a eliminar.

X Skipworkflows
X-SkipWorkflows boolean

Omite todos los flujos de trabajo de la aplicación.

X Skipwebhooks
X-SkipWebhooks boolean

Omite todos los webhooks de la aplicación

Devoluciones

Obtención de metadatos de boceto

Recuperar metadatos para un solo croquis.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de croquis
sketch_id True string

Id. de croquis

Devoluciones

Obtención de metadatos de firma

Recupere los metadatos de una sola firma.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de firma
signature_id True string

Identificador único de la firma.

Devoluciones

Obtención de metadatos de fotos

Recupere los metadatos de una sola foto.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de foto
photo_id True string

Identificador único de la foto.

Devoluciones

Obtener datos adjuntos

Recupere los metadatos de un solo archivo adjunto.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de datos adjuntos
attachment_id True string

Identificador único de los datos adjuntos.

Devoluciones

Body
Attachment

Obtener el historial de un registro

Recupere el historial de versiones completo de un registro.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de registro
record_id True string

Identificador único del registro cuyo historial desea recuperar.

Devoluciones

Obtener un archivo de informe

Descargue el archivo de informe PDF generado.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de informe
report_id True uuid

Identificador único del informe.

Devoluciones

response
binary

Obtener un archivo original de audio

Descargue el archivo de audio original.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de audio
audio_id True string

Identificador único del archivo de audio.

Devoluciones

response
binary

Obtener un archivo original de boceto

Descargue el archivo de boceto original.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de croquis
sketch_id True string

Id. de croquis

Devoluciones

response
binary

Obtener un archivo original de firma

Descargue el archivo de firma original.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de firma
signature_id True string

Identificador único de la firma.

Devoluciones

response
binary

Obtener un archivo original de fotos

Descargue el archivo de fotos original.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de foto
photo_id True string

Identificador único de la foto.

Devoluciones

response
binary

Obtener un archivo original de vídeo

Descargue el archivo de vídeo original.

Parámetros

Nombre Clave Requerido Tipo Description
Id. del vídeo
video_id True string

Identificador único del vídeo.

Devoluciones

response
binary

Obtener un registro

Recupere información detallada sobre un registro específico por su identificador. Esto incluye todos los valores de campo de formulario, datos de ubicación, marcas de tiempo y metadatos asociados.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de registro
record_id True string

Identificador único del registro que se va a recuperar.

Devoluciones

Obtener una lista de metadatos adjuntos

Recuperar una lista de datos adjuntos.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de registro
record_id string

Identificador del registro con el que está asociado el archivo adjunto. Esto es necesario al enumerar los datos adjuntos del registro.

Identificador del formulario
form_id string

Identificador del formulario con el que está asociado el archivo adjunto. Este parámetro le permitirá obtener todos los archivos de referencia dentro de un formulario, NO todos los datos adjuntos de registro en un formulario.

Tipo de propietario
owner_type string

Tipo de datos adjuntos para el que se va a consultar. Debe ser form o record.

Ordenar
sort string

Campo por el que se van a ordenar los resultados.

Dirección de ordenación
sort_direction string

Dirección de ordenación(asc, desc). El valor predeterminado es asc.

Devoluciones

Obtener una lista de metadatos de audio

Recupere los metadatos de una lista de archivos de audio.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de registro
record_id string

Identificador del registro con el que está asociado el archivo de audio.

Identificador del formulario
form_id string

Identificador del formulario con el que está asociado el archivo de audio. Si deja este espacio en blanco, se consultará en todos los archivos de audio.

Primero más reciente
newest_first boolean

Si está presente, los archivos de audio se ordenarán por updated_at fecha.

Procesado
processed boolean

Filtre los archivos de audio que se han procesado por completo.

STORED
stored boolean

Filtre los archivos de audio que se han almacenado completamente.

Subido
uploaded boolean

Filtre los archivos de audio que se han cargado por completo.

Página
page integer

Número de página solicitado.

Por página
per_page integer

Número de elementos que se van a devolver por página.

Devoluciones

Obtener una lista de metadatos de boceto

Recupere los metadatos de una lista de bocetos.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de registro
record_id string

Identificador del registro con el que está asociado el croquis.

Identificador del formulario
form_id string

Identificador del formulario con el que está asociado el croquis. Si deja este espacio en blanco, se consultarán todos los bocetos.

Primero más reciente
newest_first boolean

Si está presente, los bocetos se ordenarán por updated_at fecha.

Procesado
processed boolean

El croquis se ha procesado completamente.

STORED
stored boolean

El croquis se ha almacenado completamente.

Subido
uploaded boolean

Sketch se ha cargado completamente.

Página
page integer

Número de página solicitado

Por página
per_page integer

Número de elementos por página

Devoluciones

Obtener una lista de metadatos de firma

Recupere los metadatos de una lista de firmas.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de registro
record_id string

Identificador del registro con el que está asociada la foto.

Identificador del formulario
form_id string

Identificador del formulario con el que está asociada la foto. Dejar este espacio en blanco consultará en todas sus fotos.

Primero más reciente
newest_first boolean

Si está presente, las fotos se ordenarán por updated_at fecha.

Procesado
processed boolean

Filtre las firmas que se han procesado completamente.

STORED
stored boolean

Filtre las firmas que se han almacenado completamente.

Subido
uploaded boolean

Filtre las firmas que se han cargado por completo.

Página
page integer

Número de página solicitado.

Por página
per_page integer

Número de elementos que se van a devolver por página.

Devoluciones

Obtener una lista de metadatos de fotos

Recupere los metadatos de una lista de fotos.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de registro
record_id string

Identificador del registro con el que está asociada la foto.

Identificador del formulario
form_id string

Identificador del formulario con el que está asociada la foto. Dejar este espacio en blanco consultará en todas sus fotos.

Primero más reciente
newest_first boolean

Si está presente, las fotos se ordenarán por updated_at fecha.

Procesado
processed boolean

Filtre las fotos que se han procesado completamente.

STORED
stored boolean

Filtre las fotos que se han almacenado completamente.

Subido
uploaded boolean

Filtre las fotos que se han cargado por completo.

Página
page integer

Número de página solicitado.

Por página
per_page integer

Número de elementos que se van a devolver por página.

Devoluciones

Obtener una lista de metadatos de vídeo

Recupere los metadatos de una lista de vídeos.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de registro
record_id string

Identificador del registro con el que está asociado el vídeo.

Identificador del formulario
form_id string

Identificador del formulario con el que está asociado el vídeo. Si deja este espacio en blanco, se consultará en todos los vídeos.

Primero más reciente
newest_first boolean

Si está presente, los vídeos se ordenarán por updated_at fecha.

Procesado
processed boolean

Filtre los vídeos que se han procesado por completo.

STORED
stored boolean

Filtre los vídeos que se han almacenado completamente.

Subido
uploaded boolean

Filtre los vídeos que se han cargado por completo.

Página
page integer

Número de página solicitado.

Por página
per_page integer

Número de elementos que se van a devolver por página.

Devoluciones

Obtener una lista de registros

Obtenga una lista de registros de la organización que pueden filtrarse por dimensiones como formulario, proyecto, conjunto de cambios, rectángulo de límite y intervalos de fechas.

Parámetros

Nombre Clave Requerido Tipo Description
Primero más reciente
newest_first boolean

Si está presente, los registros se ordenarán por updated_at fecha.

Cuadro delimitador
bounding_box string

Rectángulo de límite de los registros solicitados. El formato debe ser: lat,long,lat,long (inferior, izquierda, superior, derecha).

Identificador del conjunto de cambios
changeset_id string

Identificador del conjunto de cambios asociado al registro.

Identificador del formulario
form_id string

Identificador del formulario con el que está asociado el registro. Si deja este espacio en blanco, se consultará en todos los registros.

Identificación del proyecto
project_id string

Identificador del proyecto con el que está asociado el registro. Si deja este espacio en blanco, se consultará en todos los registros.

Cliente creado antes
client_created_before date-time

Devuelve solo los registros creados por el cliente (dispositivo) antes de la hora especificada.

Cliente creado desde
client_created_since date-time

Devuelve solo los registros creados por el cliente (dispositivo) después del tiempo especificado.

Cliente actualizado antes
client_updated_before date-time

Devuelve solo los registros que el cliente (dispositivo) actualizó antes de la hora especificada.

Cliente actualizado desde
client_updated_since date-time

Devuelve solo los registros que el cliente (dispositivo) actualizó después del tiempo especificado.

Creado antes
created_before date-time

Devuelve solo los registros que se crearon (en el servidor) antes de la hora especificada.

Creado desde
created_since date-time

Devuelve solo los registros que se crearon (en el servidor) después del tiempo especificado.

Actualizado antes
updated_before date-time

Devuelve solo los registros que se actualizaron (en el servidor) antes de la hora especificada.

Actualizado desde
updated_since date-time

Devuelve solo los registros que se actualizaron (en el servidor) después del tiempo especificado.

Página
page integer

Número de página solicitado

Por página
per_page integer

Número de elementos por página

Devoluciones

Realización de una solicitud POST de consulta

Ejecute una solicitud de API de consulta mediante HTTP POST. Proporcione una consulta sql como para consultar los datos de la organización.

Parámetros

Nombre Clave Requerido Tipo Description
Página
page integer

Número de página solicitado.

Por página
per_page integer

Número de elementos que se van a devolver por página.

format
format string

Formato de respuesta

q
q True string

Consulta SQL que se va a ejecutar

nombre_de_tabla
table_name string

Nombre de la tabla que se va a consultar

Desencadenadores

Cuando se produce un evento Fulcrum

Se desencadena cuando se crea, actualiza o elimina un recurso de Fulcrum. Admite eventos para registros, formularios, listas de opciones y conjuntos de clasificación. Configure el webhook en la organización de Fulcrum para especificar qué eventos supervisar.

Cuando se produce un evento Fulcrum

Se desencadena cuando se crea, actualiza o elimina un recurso de Fulcrum. Admite eventos para registros, formularios, listas de opciones y conjuntos de clasificación. Configure el webhook en la organización de Fulcrum para especificar qué eventos supervisar.

Parámetros

Nombre Clave Requerido Tipo Description
Tipo de contenido
Content-Type string

Tipo de contenido

activo
active boolean

Si el webhook está habilitado

Nombre del webhook
name True string

Nombre para mostrar del webhook

run_for_bulk_actions
run_for_bulk_actions boolean

Si el webhook se ejecuta para acciones de registro masivas

Devoluciones

Carga de eventos de webhook de Fulcrum

Definiciones

Datos adjuntos

Nombre Ruta de acceso Tipo Description
attached_to_id
attached_to_id string

Identificador del recurso al que se adjuntan estos datos adjuntos

attached_to_type
attached_to_type string

Tipo de recurso al que se adjuntan estos datos adjuntos

complete
complete boolean

Si la carga de datos adjuntos está completa

file_size
file_size integer

Tamaño del archivo adjunto en bytes

id
id string

Identificador único para los datos adjuntos

nombre
name string

Nombre de archivo de los datos adjuntos

owners
owners array of object

Lista de referencias de propietario para los datos adjuntos

id
owners.id string

Identificador del propietario

tipo
owners.type string

Tipo de propietario (por ejemplo, "registro" o "formulario")

estado
status string

Estado de los datos adjuntos

uploaded_at
uploaded_at date-time

Marca de tiempo cuando se cargó el archivo adjunto

URL
url uri

Dirección URL para acceder a los datos adjuntos

AttachmentsResponse

Nombre Ruta de acceso Tipo Description
datos adjuntos
attachments array of Attachment
total
total integer

Número total de datos adjuntos devueltos

total_count
total_count integer

Recuento total de datos adjuntos disponibles

Sonido

Nombre Ruta de acceso Tipo Description
access_key
access_key string

Identificador único del recurso de audio

content_type
content_type string

Tipo MIME del archivo de audio

fecha_de_creación
created_at date-time

Marca de tiempo cuando se creó el audio

created_by
created_by string

Nombre para mostrar del usuario que creó el audio

created_by_id
created_by_id string

Identificador del usuario que creó el audio

deleted_at
deleted_at date-time

Marca de tiempo cuando se eliminó el audio

file_size
file_size integer

Tamaño del archivo de audio en bytes

form_id
form_id string

Identificador del formulario asociado

medio
medium uri

Dirección URL a la versión media del audio (si se procesa)

metadata
metadata object

Metadatos de audio (por ejemplo, duración, detalles de formato)

original
original uri

Dirección URL al archivo de audio original (si se almacena)

Procesado
processed boolean

Si se ha procesado el audio

record_id
record_id string

Identificador del registro asociado

pequeño
small uri

Dirección URL a una versión pequeña del audio (si se procesa)

estado
status string

Estado de procesamiento del audio

almacenado
stored boolean

Si el audio se ha almacenado

track
track uri

Dirección URL para acceder a la pista de audio (si está disponible)

updated_at
updated_at date-time

Marca de tiempo cuando se actualizó por última vez el audio

updated_by
updated_by string

Nombre para mostrar del usuario que actualizó por última vez el audio

updated_by_id
updated_by_id string

Identificador del usuario que actualizó por última vez el audio

Subido
uploaded boolean

Si se ha cargado el audio

URL
url uri

Dirección URL para acceder al recurso de audio

AudiosResponse

Nombre Ruta de acceso Tipo 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

Metadatos de ubicación capturados durante la creación o la hora de actualización.

Nombre Ruta de acceso Tipo Description
altitud
altitude double

Altitud en metros.

horizontal_accuracy
horizontal_accuracy double

Precisión horizontal en metros.

latitud
latitude double

Coordenada de latitud.

longitud
longitude double

Coordenada de longitud.

Geometría

Nombre Ruta de acceso Tipo Description
coordenadas
coordinates

Coordenadas de la geometría. El formato varía según el tipo: los puntos usan [longitud, latitud], LineString usa matriz de posiciones, Polygon usa matriz de anillos lineales (primero es exterior, rest son agujeros), los tipos Multi* usan matrices de sus respectivas estructuras de coordenadas.

tipo
type string

Tipo de geometría GeoJSON

Foto

Nombre Ruta de acceso Tipo Description
access_key
access_key string

Identificador único de la foto

content_type
content_type string

Tipo MIME de la foto

fecha_de_creación
created_at date-time

Cuando se creó la foto

created_by
created_by string

Nombre para mostrar del usuario que creó la foto

created_by_id
created_by_id string

Identificador del usuario que creó la foto

deleted_at
deleted_at date-time

Cuando se eliminó la foto

exif
exif object

Metadatos EXIF de la foto

file_size
file_size integer

Tamaño del archivo de fotos en bytes

form_id
form_id string

Identificador del formulario asociado

large
large uri

Dirección URL a la versión grande de la foto

latitud
latitude double

Coordenada de latitud donde se tomó la foto

longitud
longitude double

Coordenada de longitud donde se tomó la foto

original
original uri

Dirección URL a la versión original de la foto

Procesado
processed boolean

Si la foto se ha procesado

record_id
record_id string

Identificador del registro asociado

almacenado
stored boolean

Si la foto se ha almacenado

miniatura
thumbnail uri

Dirección URL a la versión en miniatura de la foto

updated_at
updated_at date-time

Cuando la foto se actualizó por última vez

updated_by
updated_by string

Nombre para mostrar del usuario que actualizó la foto por última vez

updated_by_id
updated_by_id string

Identificador del usuario que actualizó la foto por última vez

Subido
uploaded boolean

Si la foto se ha cargado

URL
url uri

Dirección URL de API para este recurso de foto

FotosResponse

Nombre Ruta de acceso Tipo 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

Grabar

Nombre Ruta de acceso Tipo Description
altitud
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
curso
course number
fecha_de_creación
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

Metadatos de ubicación capturados durante la creación o la hora de actualización.

edited_duration
edited_duration number
form_id
form_id string
form_values
form_values object

Valores de campo con clave de campo: los valores pueden ser cadenas, objetos o matrices en función del tipo de campo.

geometría
geometry Geometry
horizontal_accuracy
horizontal_accuracy number
id
id string
latitud
latitude number
longitud
longitude number
project_id
project_id string
record_series_id
record_series_id string
speed
speed number
estado
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

Metadatos de ubicación capturados durante la creación o la hora de actualización.

version
version integer
vertical_accuracy
vertical_accuracy number

RecordHistoryItem

Nombre Ruta de acceso Tipo Description
altitud
altitude double

Registrar la altitud de la ubicación en metros

assigned_to
assigned_to string

Nombre para mostrar del usuario asignado

assigned_to_id
assigned_to_id string

Identificador del usuario asignado

changeset_id
changeset_id string

Id. del conjunto de cambios

client_created_at
client_created_at date-time

Marca de tiempo de creación del lado cliente

client_updated_at
client_updated_at date-time

Marca de tiempo de actualización del lado cliente

curso
course double

Curso/título en grados

fecha_de_creación
created_at date-time

Marca de tiempo de creación de registros

created_by
created_by string

Nombre para mostrar del usuario que creó el registro

created_by_id
created_by_id string

Identificador del usuario que creó el registro

created_duration
created_duration integer

Duración de la creación de registros en segundos

created_location
created_location AuditLocation

Metadatos de ubicación capturados durante la creación o la hora de actualización.

edited_duration
edited_duration integer

Duración total de edición en segundos

form_id
form_id string

Id. de formulario

form_values
form_values object

Valores de campo de formulario (procesados)

form_version
form_version integer

Versión del formulario en el momento de la creación o actualización del registro

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

Tipo de cambio (c=create, u=update, d=delete)

history_changed_by
history_changed_by string

Nombre para mostrar del usuario que realizó este cambio

history_changed_by_id
history_changed_by_id string

Identificador del usuario que realizó este cambio

history_created_at
history_created_at date-time

Marca de tiempo en la que se creó esta entrada de historial

history_id
history_id string

Identificador de entrada del historial

horizontal_accuracy
horizontal_accuracy double

Precisión horizontal en metros

id
id string

Identificador de registro

latitud
latitude double

Latitud de ubicación del registro

longitud
longitude double

Longitud de la ubicación del registro

project_id
project_id string

Id. de proyecto

record_key
record_key string

Tecla de registro opcional

record_sequence
record_sequence integer

Número de secuencia de registro opcional

secuencia
sequence integer

Número de secuencia (cuando se usa la paginación basada en secuencia)

speed
speed double

Velocidad en el momento de la creación de registros en m/s

estado
status string

Estado del registro

updated_at
updated_at date-time

Registrar la última marca de tiempo de actualización

updated_by
updated_by string

Nombre para mostrar del usuario que actualizó el registro por última vez

updated_by_id
updated_by_id string

Identificador del usuario que actualizó el registro por última vez

updated_duration
updated_duration integer

Duración de la actualización de registros en segundos

updated_location
updated_location AuditLocation

Metadatos de ubicación capturados durante la creación o la hora de actualización.

version
version integer

Número de versión del registro

vertical_accuracy
vertical_accuracy double

Precisión vertical en medidores

RecordHistoryResponse

Nombre Ruta de acceso Tipo Description
current_page
current_page integer

Número de página actual (al usar la paginación)

next_sequence
next_sequence integer

Número de secuencia siguiente (cuando se usa la paginación basada en secuencia)

per_page
per_page integer

Número de registros por página (cuando se usa la paginación)

archivo
records array of RecordHistoryItem
total_count
total_count integer

Número total de registros (al usar la paginación)

total_pages
total_pages integer

Número total de páginas (cuando se usa la paginación)

RecordsResponse

Nombre Ruta de acceso Tipo Description
current_page
current_page integer
per_page
per_page integer
archivo
records array of Record
total_count
total_count integer
total_pages
total_pages integer

ReportResponse

Nombre Ruta de acceso Tipo Description
completado_en
report.completed_at date-time

Marca de tiempo cuando se completó la generación de informes

fecha_de_creación
report.created_at date-time

Marca de tiempo cuando se creó el informe

failed_at
report.failed_at date-time

Marca de tiempo cuando se produjo un error en la generación de informes (null si se ejecuta correctamente)

id
report.id uuid

Identificador único del informe

record_id
report.record_id uuid

El identificador del registro para el que se generó el informe

started_at
report.started_at date-time

Marca de tiempo cuando se inició la generación de informes

estado
report.state string

Estado del informe

template_id
report.template_id uuid

Identificador de la plantilla usada para generar el informe

updated_at
report.updated_at date-time

Marca de tiempo cuando se actualizó por última vez el informe

URL
report.url uri

Dirección URL para descargar el informe generado

Signature

Nombre Ruta de acceso Tipo Description
access_key
access_key string

Identificador único de la firma

content_type
content_type string

Tipo MIME del archivo de firma

fecha_de_creación
created_at date-time

Marca de tiempo cuando se creó la firma

created_by
created_by string

Nombre para mostrar del usuario que creó la firma

created_by_id
created_by_id string

Identificador del usuario que creó la firma

deleted_at
deleted_at date-time

Marca de tiempo cuando se eliminó la firma

file_size
file_size integer

Tamaño del archivo de firma en bytes

form_id
form_id string

Identificador del formulario asociado

large
large uri

Dirección URL a la versión grande de la firma

original
original uri

Dirección URL al archivo de firma original

Procesado
processed boolean

Si se ha procesado la firma

record_id
record_id string

Identificador del registro asociado

almacenado
stored boolean

Si la firma se ha almacenado

miniatura
thumbnail uri

Dirección URL a la versión en miniatura de la firma

updated_at
updated_at date-time

Marca de tiempo en la que se actualizó por última vez la firma

updated_by
updated_by string

Nombre para mostrar del usuario que actualizó la firma por última vez

updated_by_id
updated_by_id string

Identificador del usuario que actualizó la firma por última vez

Subido
uploaded boolean

Si se ha cargado la firma

URL
url uri

Dirección URL de API para recuperar esta firma

SignaturesResponse

Nombre Ruta de acceso Tipo Description
current_page
current_page integer
per_page
per_page integer
Firmas
signatures array of Signature
total_count
total_count integer
total_pages
total_pages integer

SinglePhotoResponse

Nombre Ruta de acceso Tipo Description
photo
photo Photo

SingleRecordResponse

Nombre Ruta de acceso Tipo Description
registro
record Record

SingleSignatureResponse

Nombre Ruta de acceso Tipo Description
firma
signature Signature

SingleSketchResponse

Nombre Ruta de acceso Tipo Description
croquis
sketch Sketch

Boceto

Nombre Ruta de acceso Tipo Description
access_key
access_key string

Identificador único del croquis

content_type
content_type string

Tipo MIME del archivo de croquis

fecha_de_creación
created_at date-time

Marca de tiempo cuando se creó el boceto

created_by
created_by string

Nombre para mostrar del usuario que creó el boceto

created_by_id
created_by_id string

Identificador del usuario que creó el boceto

exif
exif object

Metadatos EXIF del croquis

file_size
file_size integer

Tamaño del archivo de boceto en bytes

form_id
form_id string

Identificador del formulario asociado

large
large uri

Dirección URL a una versión grande del croquis

medio
medium uri

Dirección URL a la versión media del boceto

original
original uri

Dirección URL a la versión original del boceto

Procesado
processed boolean

Si se ha procesado el boceto

record_id
record_id string

Identificador del registro asociado

pequeño
small uri

Dirección URL a una versión pequeña del croquis

almacenado
stored boolean

Si el croquis se ha almacenado

miniatura
thumbnail uri

Dirección URL a la versión en miniatura del boceto

updated_at
updated_at date-time

Marca de tiempo en la que se actualizó por última vez el boceto

updated_by
updated_by string

Nombre para mostrar del usuario que actualizó por última vez el boceto

updated_by_id
updated_by_id string

Identificador del usuario que actualizó por última vez el boceto

Subido
uploaded boolean

Si se ha cargado el boceto

URL
url uri

Dirección URL de LA API para acceder a este recurso de boceto

SketchesResponse

Nombre Ruta de acceso Tipo Description
current_page
current_page integer
per_page
per_page integer
bocetos
sketches array of Sketch
total_count
total_count integer
total_pages
total_pages integer

Video

Nombre Ruta de acceso Tipo Description
access_key
access_key string

Identificador único del vídeo

content_type
content_type string

Tipo MIME del archivo de vídeo

fecha_de_creación
created_at date-time

Marca de tiempo cuando se creó el vídeo

created_by
created_by string

Nombre para mostrar del usuario que creó el vídeo

created_by_id
created_by_id string

Identificador del usuario que creó el vídeo

deleted_at
deleted_at date-time

Marca de tiempo cuando se eliminó el vídeo

file_size
file_size integer

Tamaño del archivo de vídeo en bytes

form_id
form_id string

Identificador del formulario asociado

medio
medium uri

Dirección URL a la versión media del vídeo

metadata
metadata object

Metadatos adicionales sobre el vídeo

original
original uri

Dirección URL al archivo de vídeo original

Procesado
processed boolean

Si el vídeo se ha procesado

record_id
record_id string

Identificador del registro asociado

pequeño
small uri

Dirección URL a una versión pequeña del vídeo

estado
status string

Estado de procesamiento del vídeo

almacenado
stored boolean

Si el vídeo se ha almacenado

thumbnail_huge
thumbnail_huge uri

Dirección URL a una imagen en miniatura enorme

thumbnail_huge_square
thumbnail_huge_square uri

Dirección URL a una imagen en miniatura cuadrada enorme

thumbnail_large
thumbnail_large uri

Dirección URL a una imagen en miniatura grande

thumbnail_large_square
thumbnail_large_square uri

Dirección URL a una imagen en miniatura cuadrada grande

thumbnail_medium
thumbnail_medium uri

Dirección URL a imagen en miniatura media

thumbnail_medium_square
thumbnail_medium_square uri

Dirección URL a imagen de miniatura cuadrada media

thumbnail_small
thumbnail_small uri

Dirección URL a una imagen en miniatura pequeña

thumbnail_small_square
thumbnail_small_square uri

Dirección URL a una imagen en miniatura cuadrada pequeña

track
track uri

Dirección URL a los datos de pista de vídeo en formato JSON, si está disponible

updated_at
updated_at date-time

Marca de tiempo en la que se actualizó por última vez el vídeo

updated_by
updated_by string

Nombre para mostrar del usuario que actualizó el vídeo por última vez

updated_by_id
updated_by_id string

Identificador del usuario que actualizó el vídeo por última vez

Subido
uploaded boolean

Si se ha cargado el vídeo

URL
url uri

Dirección URL de API para acceder a este recurso de vídeo

VídeosResponse

Nombre Ruta de acceso Tipo 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

Carga de eventos de webhook de Fulcrum

Nombre Ruta de acceso Tipo Description
Id. del evento
id string

Identificador único del evento

Tipo de evento
type string

El tipo de evento (por ejemplo, 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. del propietario
owner_id string

El identificador de la organización que posee este webhook

Datos de eventos
data object

Los datos de registro o recurso asociados al evento

Creado en
created_at date-time

Marca de tiempo cuando se produjo el evento

binario

Este es el tipo de datos básico "binary".