Sdílet prostřednictvím


Fulcrum (Preview)

Fulcrum je první řešení, které umožňuje odborníkům na GIS i členům týmu, kteří nejsou GIS, snadno zaznamenávat a sdílet geoprostorová data. Tento konektor umožňuje integraci s Fulcrum pro správu dat polí, fotek, videí a dalších.

Tento konektor je dostupný v následujících produktech a oblastech:

Service Class Regions
Copilot Studio Premium Všechny oblasti Power Automate kromě následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Logic Apps Standard Všechny oblasti Logic Apps s výjimkou následujících:
     – Azure Government oblastí
     – Azure oblasti Čína
     - Ministerstvo obrany USA (DoD)
Power Apps Premium Všechny oblasti Power Apps s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Power Automate Premium Všechny oblasti Power Automate kromě následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Kontakt
název Podpora Fulcrum
URL https://www.fulcrumapp.com/support
Email support@fulcrumapp.com
Metadata konektoru
Vydavatel Spatial Networks, Inc.
Internetová stránka https://www.fulcrumapp.com
Zásady ochrany osobních údajů https://www.fulcrumapp.com/privacy
Kategorie Produktivita; Data

Opěrný bod

Fulcrum je první řešení, které umožňuje odborníkům na GIS i členům týmu, kteří nejsou GIS, snadno zaznamenávat a sdílet geoprostorová data. Tento konektor umožňuje integraci s Fulcrum pro správu dat polí, fotek, videí a dalších.

Vydavatel

Opěrný bod

Předpoklady

  • Aktivní předplatné Fulcrum s povoleným přístupem k rozhraní API

Podporované operace

Triggers

Když dojde k události Fulcrum

Aktivuje se při vytvoření, aktualizaci nebo odstranění prostředku Fulcrum. Podporuje události pro záznamy, formuláře, seznamy voleb a sady klasifikace. Nakonfigurujte webhook ve vaší organizaci Fulcrum tak, aby určil, které události se mají monitorovat.

Akce

Získání seznamu metadat přílohy

Načte seznam příloh.

Získání přílohy

Načtěte metadata pro jednu přílohu.

Získání seznamu zvukových metadat

Načtěte metadata pro seznam zvukových souborů.

Získání zvukového původního souboru

Stáhněte si původní zvukový soubor.

Získání seznamu metadat fotek

Načtěte metadata pro seznam fotek.

Získání původního souboru fotky

Stáhněte si původní soubor fotky.

Získání metadat fotek

Načtěte metadata pro jednu fotku.

Vytvoření požadavku POST dotazu

Pomocí http POST spusťte požadavek rozhraní API pro dotazy. Zadejte dotaz SQL, jako je dotaz na data vaší organizace.

Získání seznamu záznamů

Získejte seznam záznamů z vaší organizace, které je možné filtrovat podle dimenzí, jako je formulář, projekt, sada změn, ohraničující pole a rozsahy kalendářních dat.

Vytvoření záznamu

Vytvořte nový záznam v zadaném formuláři pomocí zadaných hodnot formuláře, informací o poloze a všech přidružených metadat.

Odstranění záznamu

Odstraňte záznam z vaší organizace.

Získání záznamu

Načtěte podrobné informace o konkrétním záznamu podle jeho ID. To zahrnuje všechny hodnoty polí formuláře, údaje o poloze, časová razítka a přidružená metadata.

Částečné aktualizace záznamu

Aktualizujte konkrétní pole existujícího záznamu, aniž by bylo nutné dokončit objekt záznamu. Upraví se jenom pole zahrnutá v textu požadavku, zatímco všechna ostatní pole zůstanou beze změny. To je užitečné pro aktualizaci hodnot nebo metadat jednotlivých polí.

Aktualizace záznamu

Aktualizujte záznam pomocí zadaného objektu záznamu. Očekává se, že objekt záznamu bude kompletní reprezentací záznamu. U všech polí, která nejsou zahrnuta, se předpokládá hodnota null.

Získání historie záznamu

Načtěte kompletní historii verzí záznamu.

Vytvořte sestavu

Vygenerujte novou sestavu pro konkrétní záznam, volitelně pomocí šablony sestavy.

Získání souboru sestavy

Stáhněte si vygenerovaný soubor sestavy PDF.

Získání seznamu metadat podpisu

Načtěte metadata pro seznam podpisů.

Získání metadat podpisu

Načtěte metadata pro jeden podpis.

Získání původního souboru podpisu

Stáhněte si původní soubor podpisu.

Získání seznamu metadat skicy

Načtěte metadata pro seznam skic.

Získání původního souboru skicy

Stáhněte si původní soubor skicy.

Získání metadat skic

Načtěte metadata pro jednu skicu.

Získání seznamu metadat videa

Načtěte metadata pro seznam videí.

Získání původního souboru videa

Stáhněte si původní videosoubor.

Získání přihlašovacích údajů

Pokud chcete použít konektor Fulcrum, potřebujete token rozhraní Fulcrum API:

  1. Přihlaste se ke svému účtu Fulcrum na adrese https://web.fulcrumapp.com
  2. Přechod na rozhraní API pro nastavení >
  3. Vygenerování nového tokenu rozhraní API nebo použití existujícího tokenu
  4. Zkopírujte token a použijte ho při vytváření připojení.

Začínáme

Vytvořte nové připojení a po zobrazení výzvy zadejte token rozhraní API Fulcrum.

Vlastní adresy URL hostitele

Ve výchozím nastavení konektor používá produkční rozhraní Fulcrum API na adrese api.fulcrumapp.com. V jiných oblastech můžete při vytváření připojení zadat jinou adresu URL hostitele.

Regionální koncové body:

  • United States (výchozí): api.fulcrumapp.com
  • Kanada: api.fulcrumapp-ca.com
  • Austrálie: api.fulcrumapp-au.com
  • Evropa: api.fulcrumapp-eu.com

Formát: Zadejte pouze název hostitele bez protokolu nebo cesty. Konektor automaticky použije HTTPS a správnou cestu rozhraní API.

Řešení potíží:

  • Ujistěte se, že je váš vlastní hostitel přístupný z vaší sítě.
  • Ověřte správnost názvu hostitele (bez překlepů).
  • Ověřte platnost tokenu rozhraní API pro zadaného hostitele.

Známé problémy a omezení

  • Omezení rychlosti se vztahuje na základě vašeho plánu Fulcrum

Pokyny k nasazení

Pomocí pokynů nasaďte tento konektor jako vlastní konektor v Microsoft Power Automate a Power Apps.

Vytvoření připojení

Konektor podporuje následující typy ověřování:

výchozí Parametry pro vytvoření připojení Všechny oblasti Nesdílitelné

Výchozí

Použitelné: Všechny oblasti

Parametry pro vytvoření připojení

Toto není připojení ke sdílení. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.

název Typ Description Povinné
API token securestring Váš token rozhraní API Fulcrum pro ověřování Pravdivé
Adresa URL hostitele řetězec Hostitel rozhraní API pro vaši instanci Fulcrum

Limity omezování

Name Volání Období obnovení
Volání rozhraní API na připojení 100 60 sekund

Akce

Aktualizace záznamu

Aktualizujte záznam pomocí zadaného objektu záznamu. Očekává se, že objekt záznamu bude kompletní reprezentací záznamu. U všech polí, která nejsou zahrnuta, se předpokládá hodnota null.

Odstranění záznamu

Odstraňte záznam z vaší organizace.

Vytvoření požadavku POST dotazu

Pomocí http POST spusťte požadavek rozhraní API pro dotazy. Zadejte dotaz SQL, jako je dotaz na data vaší organizace.

Vytvoření záznamu

Vytvořte nový záznam v zadaném formuláři pomocí zadaných hodnot formuláře, informací o poloze a všech přidružených metadat.

Vytvořte sestavu

Vygenerujte novou sestavu pro konkrétní záznam, volitelně pomocí šablony sestavy.

Získání historie záznamu

Načtěte kompletní historii verzí záznamu.

Získání metadat fotek

Načtěte metadata pro jednu fotku.

Získání metadat podpisu

Načtěte metadata pro jeden podpis.

Získání metadat skic

Načtěte metadata pro jednu skicu.

Získání přílohy

Načtěte metadata pro jednu přílohu.

Získání původního souboru fotky

Stáhněte si původní soubor fotky.

Získání původního souboru podpisu

Stáhněte si původní soubor podpisu.

Získání původního souboru skicy

Stáhněte si původní soubor skicy.

Získání původního souboru videa

Stáhněte si původní videosoubor.

Získání seznamu metadat fotek

Načtěte metadata pro seznam fotek.

Získání seznamu metadat podpisu

Načtěte metadata pro seznam podpisů.

Získání seznamu metadat přílohy

Načte seznam příloh.

Získání seznamu metadat skicy

Načtěte metadata pro seznam skic.

Získání seznamu metadat videa

Načtěte metadata pro seznam videí.

Získání seznamu zvukových metadat

Načtěte metadata pro seznam zvukových souborů.

Získání seznamu záznamů

Získejte seznam záznamů z vaší organizace, které je možné filtrovat podle dimenzí, jako je formulář, projekt, sada změn, ohraničující pole a rozsahy kalendářních dat.

Získání souboru sestavy

Stáhněte si vygenerovaný soubor sestavy PDF.

Získání zvukového původního souboru

Stáhněte si původní zvukový soubor.

Získání záznamu

Načtěte podrobné informace o konkrétním záznamu podle jeho ID. To zahrnuje všechny hodnoty polí formuláře, údaje o poloze, časová razítka a přidružená metadata.

Částečné aktualizace záznamu

Aktualizujte konkrétní pole existujícího záznamu, aniž by bylo nutné dokončit objekt záznamu. Upraví se jenom pole zahrnutá v textu požadavku, zatímco všechna ostatní pole zůstanou beze změny. To je užitečné pro aktualizaci hodnot nebo metadat jednotlivých polí.

Aktualizace záznamu

Aktualizujte záznam pomocí zadaného objektu záznamu. Očekává se, že objekt záznamu bude kompletní reprezentací záznamu. U všech polí, která nejsou zahrnuta, se předpokládá hodnota null.

Parametry

Name Klíč Vyžadováno Typ Description
Typ obsahu
Content-Type string

Typ obsahu

ID záznamu
record_id True string

ID záznamu

X Skipworkflows
X-SkipWorkflows boolean

Přeskočí všechny pracovní postupy aplikací.

X Skipwebhooks
X-SkipWebhooks boolean

Přeskočí všechny webhooky aplikace.

assigned_to_id
assigned_to_id string

ID uživatele přiřazeného k tomuto záznamu

form_id
form_id True string

ID formuláře, do které tento záznam patří

form_values
form_values object

Hodnoty polí klíčené klíčem pole

souřadnice
coordinates True

Souřadnice pro geometrii. Formát se liší podle typu: Bod používá [zeměpisnou délku, zeměpisnou šířku], LineString používá pole pozic, Polygon používá pole lineárních kroužků (např. vnější, zbytek jsou díry), více* typy používají pole odpovídajících souřadnicových struktur.

typ
type True string

Typ geometrie GeoJSON

zeměpisná šířka
latitude number

Souřadnice zeměpisné šířky

zeměpisná délka
longitude number

Souřadnice délky

project_id
project_id string

ID projektu

stav
status string

Stav záznamu

Odstranění záznamu

Odstraňte záznam z vaší organizace.

Parametry

Name Klíč Vyžadováno Typ Description
ID záznamu
record_id True string

Jedinečný identifikátor záznamu, který chcete odstranit.

X Skipworkflows
X-SkipWorkflows boolean

Přeskočí všechny pracovní postupy aplikací.

X Skipwebhooks
X-SkipWebhooks boolean

Přeskočí všechny webhooky aplikace.

Návraty

Vytvoření požadavku POST dotazu

Pomocí http POST spusťte požadavek rozhraní API pro dotazy. Zadejte dotaz SQL, jako je dotaz na data vaší organizace.

Parametry

Name Klíč Vyžadováno Typ Description
Stránka
page integer

Požadované číslo stránky.

Na stránku
per_page integer

Počet položek, které se mají vrátit na stránku.

format
format string

Formát odpovědi

q
q True string

Dotaz SQL ke spuštění

název_tabulky
table_name string

Název tabulky, která se má dotazovat

Vytvoření záznamu

Vytvořte nový záznam v zadaném formuláři pomocí zadaných hodnot formuláře, informací o poloze a všech přidružených metadat.

Parametry

Name Klíč Vyžadováno Typ Description
Typ obsahu
Content-Type string

Typ obsahu

X Skipworkflows
X-SkipWorkflows boolean

Přeskočí všechny pracovní postupy aplikací.

X Skipwebhooks
X-SkipWebhooks boolean

Přeskočí všechny webhooky aplikace.

assigned_to_id
assigned_to_id string

ID uživatele přiřazeného k tomuto záznamu

form_id
form_id True string

ID formuláře, do které tento záznam patří

form_values
form_values object

Hodnoty polí klíčené klíčem pole

souřadnice
coordinates True

Souřadnice pro geometrii. Formát se liší podle typu: Bod používá [zeměpisnou délku, zeměpisnou šířku], LineString používá pole pozic, Polygon používá pole lineárních kroužků (např. vnější, zbytek jsou díry), více* typy používají pole odpovídajících souřadnicových struktur.

typ
type True string

Typ geometrie GeoJSON

zeměpisná šířka
latitude number

Souřadnice zeměpisné šířky

zeměpisná délka
longitude number

Souřadnice délky

project_id
project_id string

ID projektu

stav
status string

Stav záznamu

Návraty

Vytvořte sestavu

Vygenerujte novou sestavu pro konkrétní záznam, volitelně pomocí šablony sestavy.

Parametry

Name Klíč Vyžadováno Typ Description
record_id
record_id True uuid

ID záznamu pro vygenerování sestavy pro

ID šablony
template_id uuid

ID šablony sestavy, které se má použít (volitelné)

Návraty

Získání historie záznamu

Načtěte kompletní historii verzí záznamu.

Parametry

Name Klíč Vyžadováno Typ Description
ID záznamu
record_id True string

Jedinečný identifikátor záznamu, jehož historii chcete načíst.

Návraty

Získání metadat fotek

Načtěte metadata pro jednu fotku.

Parametry

Name Klíč Vyžadováno Typ Description
ID fotky
photo_id True string

Jedinečný identifikátor fotky.

Návraty

Získání metadat podpisu

Načtěte metadata pro jeden podpis.

Parametry

Name Klíč Vyžadováno Typ Description
ID podpisu
signature_id True string

Jedinečný identifikátor podpisu.

Návraty

Získání metadat skic

Načtěte metadata pro jednu skicu.

Parametry

Name Klíč Vyžadováno Typ Description
ID skicy
sketch_id True string

ID skicy

Návraty

Získání přílohy

Načtěte metadata pro jednu přílohu.

Parametry

Name Klíč Vyžadováno Typ Description
ID přílohy
attachment_id True string

Jedinečný identifikátor přílohy.

Návraty

Tělo
Attachment

Získání původního souboru fotky

Stáhněte si původní soubor fotky.

Parametry

Name Klíč Vyžadováno Typ Description
ID fotky
photo_id True string

Jedinečný identifikátor fotky.

Návraty

odpověď
binary

Získání původního souboru podpisu

Stáhněte si původní soubor podpisu.

Parametry

Name Klíč Vyžadováno Typ Description
ID podpisu
signature_id True string

Jedinečný identifikátor podpisu.

Návraty

odpověď
binary

Získání původního souboru skicy

Stáhněte si původní soubor skicy.

Parametry

Name Klíč Vyžadováno Typ Description
ID skicy
sketch_id True string

ID skicy

Návraty

odpověď
binary

Získání původního souboru videa

Stáhněte si původní videosoubor.

Parametry

Name Klíč Vyžadováno Typ Description
ID videa
video_id True string

Jedinečný identifikátor videa.

Návraty

odpověď
binary

Získání seznamu metadat fotek

Načtěte metadata pro seznam fotek.

Parametry

Name Klíč Vyžadováno Typ Description
ID záznamu
record_id string

ID záznamu, ke kterému je fotka přidružená.

ID formuláře
form_id string

ID formuláře, ke kterému je fotografie přidružená. Když necháte toto prázdné, zobrazí se dotaz na všechny vaše fotky.

Nejnovější první
newest_first boolean

Pokud jsou k dispozici, fotky se seřadí podle updated_at data.

Zpracované
processed boolean

Vyfiltrujte fotky, které byly kompletně zpracovány.

Uložený
stored boolean

Filtrujte fotky, které byly zcela uložené.

Nahrané
uploaded boolean

Vyfiltrujte fotky, které byly zcela nahrané.

Stránka
page integer

Požadované číslo stránky.

Na stránku
per_page integer

Počet položek, které se mají vrátit na stránku.

Návraty

Získání seznamu metadat podpisu

Načtěte metadata pro seznam podpisů.

Parametry

Name Klíč Vyžadováno Typ Description
ID záznamu
record_id string

ID záznamu, ke kterému je fotka přidružená.

ID formuláře
form_id string

ID formuláře, ke kterému je fotografie přidružená. Když necháte toto prázdné, zobrazí se dotaz na všechny vaše fotky.

Nejnovější první
newest_first boolean

Pokud jsou k dispozici, fotky se seřadí podle updated_at data.

Zpracované
processed boolean

Vyfiltrujte podpisy, které byly kompletně zpracovány.

Uložený
stored boolean

Vyfiltrujte podpisy, které byly zcela uloženy.

Nahrané
uploaded boolean

Vyfiltrujte podpisy, které byly zcela nahrané.

Stránka
page integer

Požadované číslo stránky.

Na stránku
per_page integer

Počet položek, které se mají vrátit na stránku.

Návraty

Získání seznamu metadat přílohy

Načte seznam příloh.

Parametry

Name Klíč Vyžadováno Typ Description
ID záznamu
record_id string

ID záznamu, ke kterému je příloha přidružena. To se vyžaduje při výpisu příloh záznamů.

ID formuláře
form_id string

ID formuláře, ke kterému je příloha přidružená. Tento parametr vám umožní získat všechny referenční soubory ve formuláři, NE všechny přílohy záznamů ve formuláři.

Typ vlastníka
owner_type string

Typ přílohy, pro která se má dotazovat. Musí být buď form nebo record.

Seřadit
sort string

Pole pro řazení výsledků.

Směr řazení
sort_direction string

Směr řazení(asc, desc). Výchozí hodnota je asc.

Návraty

Získání seznamu metadat skicy

Načtěte metadata pro seznam skic.

Parametry

Name Klíč Vyžadováno Typ Description
ID záznamu
record_id string

ID záznamu, ke kterému je skica přidružena.

ID formuláře
form_id string

ID formuláře, ke kterému je skica přidružena. Když toto pole necháte prázdné, zobrazí se dotaz na všechny vaše skicy.

Nejnovější první
newest_first boolean

Pokud jsou k dispozici, skici se seřadí podle updated_at data.

Zpracované
processed boolean

Skica byla kompletně zpracována.

Uložený
stored boolean

Skica byla zcela uložena.

Nahrané
uploaded boolean

Skica se úplně nahrála.

Stránka
page integer

Požadované číslo stránky

Na stránku
per_page integer

Počet položek na stránku

Návraty

Získání seznamu metadat videa

Načtěte metadata pro seznam videí.

Parametry

Name Klíč Vyžadováno Typ Description
ID záznamu
record_id string

ID záznamu, ke kterému je video přidružené.

ID formuláře
form_id string

ID formuláře, ke kterému je video přidružené. Když toto pole necháte prázdné, zobrazí se dotaz na všechna vaše videa.

Nejnovější první
newest_first boolean

Pokud jsou k dispozici, budou videa seřazena podle updated_at data.

Zpracované
processed boolean

Filtrujte videa, která byla kompletně zpracována.

Uložený
stored boolean

Vyfiltrujte videa, která jsou zcela uložená.

Nahrané
uploaded boolean

Vyfiltrujte videa, která byla zcela nahraná.

Stránka
page integer

Požadované číslo stránky.

Na stránku
per_page integer

Počet položek, které se mají vrátit na stránku.

Návraty

Získání seznamu zvukových metadat

Načtěte metadata pro seznam zvukových souborů.

Parametry

Name Klíč Vyžadováno Typ Description
ID záznamu
record_id string

ID záznamu, ke kterému je zvukový soubor přidružený.

ID formuláře
form_id string

ID formuláře, ke kterému je zvukový soubor přidružen. Když toto pole necháte prázdné, zobrazí se dotaz na všechny vaše zvukové soubory.

Nejnovější první
newest_first boolean

Pokud jsou k dispozici, zvukové soubory se seřadí podle updated_at data.

Zpracované
processed boolean

Vyfiltrujte zvukové soubory, které byly kompletně zpracovány.

Uložený
stored boolean

Vyfiltrujte zvukové soubory, které byly zcela uložené.

Nahrané
uploaded boolean

Vyfiltrujte zvukové soubory, které byly zcela nahrané.

Stránka
page integer

Požadované číslo stránky.

Na stránku
per_page integer

Počet položek, které se mají vrátit na stránku.

Návraty

Získání seznamu záznamů

Získejte seznam záznamů z vaší organizace, které je možné filtrovat podle dimenzí, jako je formulář, projekt, sada změn, ohraničující pole a rozsahy kalendářních dat.

Parametry

Name Klíč Vyžadováno Typ Description
Nejnovější první
newest_first boolean

Pokud jsou k dispozici, záznamy se seřadí podle updated_at data.

Ohraničující rámeček
bounding_box string

Ohraničující pole požadovaných záznamů. Formát by měl být: lat,long,lat,long (dole, vlevo, nahoře, vpravo).

ID sady změn
changeset_id string

ID sady změn přidružené k záznamu.

ID formuláře
form_id string

ID formuláře, ke kterému je záznam přidružen. Když toto pole necháte prázdné, zobrazí se dotaz na všechny vaše záznamy.

ID projektu
project_id string

ID projektu, ke kterému je záznam přidružený. Když toto pole necháte prázdné, zobrazí se dotaz na všechny vaše záznamy.

Klient vytvořený před
client_created_before date-time

Vrátí pouze záznamy vytvořené klientem (zařízením) před daným časem.

Klient vytvořený od
client_created_since date-time

Vrátí pouze záznamy vytvořené klientem (zařízením) po daném čase.

Klient se aktualizoval před
client_updated_before date-time

Vrátí pouze záznamy, které klient (zařízení) aktualizoval před daným časem.

Klient se od té doby aktualizoval
client_updated_since date-time

Vrátí pouze záznamy, které klient (zařízení) po daném čase aktualizoval.

Vytvořeno před
created_before date-time

Vrátí pouze záznamy, které byly vytvořeny (na serveru) před daným časem.

Vytvořeno od
created_since date-time

Vrátí pouze záznamy, které byly vytvořeny (na serveru) po daném čase.

Aktualizováno před
updated_before date-time

Vrátí pouze záznamy, které byly aktualizovány (na serveru) před daným časem.

Aktualizováno od
updated_since date-time

Vrátí pouze záznamy, které byly aktualizovány (na serveru) po daném čase.

Stránka
page integer

Požadované číslo stránky

Na stránku
per_page integer

Počet položek na stránku

Návraty

Získání souboru sestavy

Stáhněte si vygenerovaný soubor sestavy PDF.

Parametry

Name Klíč Vyžadováno Typ Description
ID sestavy
report_id True uuid

Jedinečný identifikátor sestavy.

Návraty

odpověď
binary

Získání zvukového původního souboru

Stáhněte si původní zvukový soubor.

Parametry

Name Klíč Vyžadováno Typ Description
ID zvuku
audio_id True string

Jedinečný identifikátor zvukového souboru.

Návraty

odpověď
binary

Získání záznamu

Načtěte podrobné informace o konkrétním záznamu podle jeho ID. To zahrnuje všechny hodnoty polí formuláře, údaje o poloze, časová razítka a přidružená metadata.

Parametry

Name Klíč Vyžadováno Typ Description
ID záznamu
record_id True string

Jedinečný identifikátor záznamu, který se má načíst.

Návraty

Částečné aktualizace záznamu

Aktualizujte konkrétní pole existujícího záznamu, aniž by bylo nutné dokončit objekt záznamu. Upraví se jenom pole zahrnutá v textu požadavku, zatímco všechna ostatní pole zůstanou beze změny. To je užitečné pro aktualizaci hodnot nebo metadat jednotlivých polí.

Parametry

Name Klíč Vyžadováno Typ Description
Typ obsahu
Content-Type string

Typ obsahu

ID záznamu
record_id True string

ID záznamu

X Skipworkflows
X-SkipWorkflows boolean

Přeskočí všechny pracovní postupy aplikací.

X Skipwebhooks
X-SkipWebhooks boolean

Přeskočí všechny webhooky aplikace.

assigned_to_id
assigned_to_id string

ID uživatele přiřazeného k tomuto záznamu

form_values
form_values object

Hodnoty polí klíčené klíčem pole

souřadnice
coordinates True

Souřadnice pro geometrii. Formát se liší podle typu: Bod používá [zeměpisnou délku, zeměpisnou šířku], LineString používá pole pozic, Polygon používá pole lineárních kroužků (např. vnější, zbytek jsou díry), více* typy používají pole odpovídajících souřadnicových struktur.

typ
type True string

Typ geometrie GeoJSON

zeměpisná šířka
latitude number

Souřadnice zeměpisné šířky

zeměpisná délka
longitude number

Souřadnice délky

project_id
project_id string

ID projektu

stav
status string

Stav záznamu

Návraty

Aktivační události

Když dojde k události Fulcrum

Aktivuje se při vytvoření, aktualizaci nebo odstranění prostředku Fulcrum. Podporuje události pro záznamy, formuláře, seznamy voleb a sady klasifikace. Nakonfigurujte webhook ve vaší organizaci Fulcrum tak, aby určil, které události se mají monitorovat.

Když dojde k události Fulcrum

Aktivuje se při vytvoření, aktualizaci nebo odstranění prostředku Fulcrum. Podporuje události pro záznamy, formuláře, seznamy voleb a sady klasifikace. Nakonfigurujte webhook ve vaší organizaci Fulcrum tak, aby určil, které události se mají monitorovat.

Parametry

Name Klíč Vyžadováno Typ Description
Typ obsahu
Content-Type string

Typ obsahu

aktivní
active boolean

Jestli je webhook povolený

Název webhooku
name True string

Zobrazovaný název webhooku

run_for_bulk_actions
run_for_bulk_actions boolean

Jestli se webhook spouští pro akce hromadného záznamu

Návraty

Datová část události Webhooku z Fulcrumu

Definice

Příloha

Name Cesta Typ Description
attached_to_id
attached_to_id string

ID prostředku, ke kterému je tato příloha připojena

attached_to_type
attached_to_type string

Typ prostředku, ke kterému je tato příloha připojena

kompletní
complete boolean

Jestli je nahrávání přílohy dokončené

file_size
file_size integer

Velikost souboru přílohy v bajtech

identifikační číslo
id string

Jedinečný identifikátor přílohy

název
name string

Název souboru přílohy

majitelé
owners array of object

Seznam odkazů na vlastníka přílohy

identifikační číslo
owners.id string

ID vlastníka

typ
owners.type string

Typ vlastníka (např. "záznam" nebo "formulář"))

stav
status string

Stav přílohy

uploaded_at
uploaded_at date-time

Časové razítko při nahrání přílohy

adresa URL
url uri

Adresa URL pro přístup k příloze

PřílohyResponse

Name Cesta Typ Description
attachments
attachments array of Attachment
totální
total integer

Celkový počet vrácených příloh

total_count
total_count integer

Celkový počet dostupných příloh

Zvuk

Name Cesta Typ Description
access_key
access_key string

Jedinečný identifikátor zvukového prostředku

content_type
content_type string

Typ MIME zvukového souboru

datum_vytvoření
created_at date-time

Časové razítko při vytvoření zvuku

vytvořeno kým
created_by string

Zobrazované jméno uživatele, který zvuk vytvořil

created_by_id
created_by_id string

ID uživatele, který vytvořil zvuk

deleted_at
deleted_at date-time

Časové razítko při odstranění zvuku

file_size
file_size integer

Velikost zvukového souboru v bajtech

form_id
form_id string

ID přidruženého formuláře

médium
medium uri

Adresa URL na střední verzi zvuku (pokud je zpracována)

metadata
metadata object

Zvuková metadata (např. doba trvání, podrobnosti formátu)

původní
original uri

Adresa URL původního zvukového souboru (pokud je uložená)

zpracovaný
processed boolean

Zda byl zvuk zpracován

record_id
record_id string

ID přidruženého záznamu

malý
small uri

Adresa URL malé verze zvuku (pokud je zpracována)

stav
status string

Stav zpracování zvuku

Uloženy
stored boolean

Zda byl zvuk uložen

skladba
track uri

Adresa URL pro přístup ke zvukové stopě (pokud je k dispozici)

updated_at
updated_at date-time

Časové razítko poslední aktualizace zvuku

updated_by
updated_by string

Zobrazované jméno uživatele, který naposledy aktualizoval zvuk

updated_by_id
updated_by_id string

ID uživatele, který naposledy aktualizoval zvuk

Nahrané
uploaded boolean

Jestli se zvuk nahrál

adresa URL
url uri

Adresa URL pro přístup ke zvukovému prostředku

AudiosResponse

Name Cesta Typ Description
audio
audio array of Audio
current_page
current_page integer
per_page
per_page integer
total_count
total_count integer
celkem stránek
total_pages integer

AuditLocation

Metadata umístění zachycená při vytváření nebo aktualizaci.

Name Cesta Typ Description
nadmořská výška
altitude double

Výška v metrech.

horizontal_accuracy
horizontal_accuracy double

Vodorovná přesnost v metrech.

zeměpisná šířka
latitude double

Souřadnice zeměpisné šířky.

zeměpisná délka
longitude double

Souřadnice délky.

Geometrie

Name Cesta Typ Description
souřadnice
coordinates

Souřadnice pro geometrii. Formát se liší podle typu: Bod používá [zeměpisnou délku, zeměpisnou šířku], LineString používá pole pozic, Polygon používá pole lineárních kroužků (např. vnější, zbytek jsou díry), více* typy používají pole odpovídajících souřadnicových struktur.

typ
type string

Typ geometrie GeoJSON

Foto

Name Cesta Typ Description
access_key
access_key string

Jedinečný identifikátor fotky

content_type
content_type string

Typ MIME fotky

datum_vytvoření
created_at date-time

Po vytvoření fotky

vytvořeno kým
created_by string

Zobrazované jméno uživatele, který fotku vytvořil

created_by_id
created_by_id string

ID uživatele, který fotku vytvořil

deleted_at
deleted_at date-time

Po odstranění fotky

exif
exif object

Metadata EXIF z fotky

file_size
file_size integer

Velikost souboru fotky v bajtech

form_id
form_id string

ID přidruženého formuláře

velký
large uri

Adresa URL velké verze fotky

zeměpisná šířka
latitude double

Zeměpisná šířka souřadnice, kde byla pořízena fotka

zeměpisná délka
longitude double

Zeměpisná délka souřadnice, kde byla pořízena fotka

původní
original uri

Adresa URL původní verze fotky

zpracovaný
processed boolean

Zda byla fotka zpracována

record_id
record_id string

ID přidruženého záznamu

Uloženy
stored boolean

Zda byla fotka uložena

miniatura
thumbnail uri

Adresa URL k verzi miniatury fotky

updated_at
updated_at date-time

Kdy byla fotka naposledy aktualizována

updated_by
updated_by string

Zobrazované jméno uživatele, který fotku naposledy aktualizoval

updated_by_id
updated_by_id string

ID uživatele, který fotku naposledy aktualizoval

Nahrané
uploaded boolean

Jestli se fotka nahrála

adresa URL
url uri

Adresa URL rozhraní API pro tento prostředek fotky

FotografieResponse

Name Cesta Typ Description
current_page
current_page integer
per_page
per_page integer
fotky
photos array of Photo
total_count
total_count integer
celkem stránek
total_pages integer

Record

Name Cesta Typ Description
nadmořská výška
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
kurz
course number
datum_vytvoření
created_at date-time
vytvořeno kým
created_by string
created_by_id
created_by_id string
created_duration
created_duration number
created_location
created_location AuditLocation

Metadata umístění zachycená při vytváření nebo aktualizaci.

edited_duration
edited_duration number
form_id
form_id string
form_values
form_values object

Hodnoty polí klíčené klíčem pole – hodnoty můžou být řetězce, objekty nebo pole v závislosti na typu pole.

geometrie
geometry Geometry
horizontal_accuracy
horizontal_accuracy number
identifikační číslo
id string
zeměpisná šířka
latitude number
zeměpisná délka
longitude number
project_id
project_id string
record_series_id
record_series_id string
speed
speed number
stav
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

Metadata umístění zachycená při vytváření nebo aktualizaci.

verze
version integer
vertical_accuracy
vertical_accuracy number

RecordHistoryItem

Name Cesta Typ Description
nadmořská výška
altitude double

Zaznamenání výšky polohy v metrech

assigned_to
assigned_to string

Zobrazované jméno přiřazeného uživatele

assigned_to_id
assigned_to_id string

ID přiřazeného uživatele

changeset_id
changeset_id string

ID sady změn

client_created_at
client_created_at date-time

Časové razítko vytvoření na straně klienta

client_updated_at
client_updated_at date-time

Časové razítko aktualizace na straně klienta

kurz
course double

Kurz/nadpis ve stupních

datum_vytvoření
created_at date-time

Časové razítko vytvoření záznamu

vytvořeno kým
created_by string

Zobrazované jméno uživatele, který záznam vytvořil

created_by_id
created_by_id string

ID uživatele, který záznam vytvořil

created_duration
created_duration integer

Doba trvání vytváření záznamů v sekundách

created_location
created_location AuditLocation

Metadata umístění zachycená při vytváření nebo aktualizaci.

edited_duration
edited_duration integer

Celková doba trvání úprav v sekundách

form_id
form_id string

ID formuláře

form_values
form_values object

Hodnoty polí formuláře (zpracované)

form_version
form_version integer

Verze formuláře v době vytvoření nebo aktualizace záznamu

souřadnice
geometry.coordinates array of number
typ
geometry.type string
history_change_type
history_change_type string

Typ změny (c=create, u=update, d=delete)

history_changed_by
history_changed_by string

Zobrazované jméno uživatele, který tuto změnu provedl

history_changed_by_id
history_changed_by_id string

ID uživatele, který tuto změnu provedl

history_created_at
history_created_at date-time

Časové razítko při vytvoření této položky historie

history_id
history_id string

ID položky historie

horizontal_accuracy
horizontal_accuracy double

Vodorovná přesnost v metrech

identifikační číslo
id string

ID záznamu

zeměpisná šířka
latitude double

Zeměpisná šířka umístění záznamu

zeměpisná délka
longitude double

Zeměpisná délka umístění záznamu

project_id
project_id string

ID projektu

record_key
record_key string

Volitelný klíč záznamu

record_sequence
record_sequence integer

Volitelné pořadové číslo záznamu

sekvence
sequence integer

Pořadové číslo (při použití stránkování založené na sekvenci)

speed
speed double

Rychlost vytváření záznamů v m/s

stav
status string

Stav záznamu

updated_at
updated_at date-time

Zaznamenat časové razítko poslední aktualizace

updated_by
updated_by string

Zobrazované jméno uživatele, který záznam naposledy aktualizoval

updated_by_id
updated_by_id string

ID uživatele, který záznam naposledy aktualizoval

updated_duration
updated_duration integer

Doba trvání aktualizace záznamu v sekundách

updated_location
updated_location AuditLocation

Metadata umístění zachycená při vytváření nebo aktualizaci.

verze
version integer

Číslo verze záznamu

vertical_accuracy
vertical_accuracy double

Svislá přesnost v metrech

RecordHistoryResponse

Name Cesta Typ Description
current_page
current_page integer

Aktuální číslo stránky (při použití stránkování)

next_sequence
next_sequence integer

Další pořadové číslo (při použití stránkování založeného na sekvenci)

per_page
per_page integer

Počet záznamů na stránku (při použití stránkování)

záznamy
records array of RecordHistoryItem
total_count
total_count integer

Celkový počet záznamů (při použití stránkování)

celkem stránek
total_pages integer

Celkový počet stránek (při použití stránkování)

RecordsResponse

Name Cesta Typ Description
current_page
current_page integer
per_page
per_page integer
záznamy
records array of Record
total_count
total_count integer
celkem stránek
total_pages integer

ReportResponse

Name Cesta Typ Description
dokončeno v
report.completed_at date-time

Časové razítko při dokončení generování sestavy

datum_vytvoření
report.created_at date-time

Časové razítko při vytvoření sestavy

selháno_při
report.failed_at date-time

Časové razítko při selhání generování sestavy (pokud je úspěšné)

identifikační číslo
report.id uuid

Jedinečný identifikátor sestavy

record_id
report.record_id uuid

ID záznamu, pro který se sestava vygenerovala

started_at
report.started_at date-time

Časové razítko při spuštění generování sestavy

stav
report.state string

Stav sestavy

ID šablony
report.template_id uuid

ID šablony použité k vygenerování sestavy

updated_at
report.updated_at date-time

Časové razítko poslední aktualizace sestavy

adresa URL
report.url uri

Adresa URL pro stažení vygenerované sestavy

Signature

Name Cesta Typ Description
access_key
access_key string

Jedinečný identifikátor podpisu

content_type
content_type string

Typ MIME souboru podpisu

datum_vytvoření
created_at date-time

Časové razítko při vytvoření podpisu

vytvořeno kým
created_by string

Zobrazované jméno uživatele, který podpis vytvořil

created_by_id
created_by_id string

ID uživatele, který podpis vytvořil

deleted_at
deleted_at date-time

Časové razítko při odstranění podpisu

file_size
file_size integer

Velikost souboru podpisu v bajtech

form_id
form_id string

ID přidruženého formuláře

velký
large uri

Adresa URL velké verze podpisu

původní
original uri

Adresa URL původního souboru podpisu

zpracovaný
processed boolean

Zda byl podpis zpracován

record_id
record_id string

ID přidruženého záznamu

Uloženy
stored boolean

Zda byl podpis uložen

miniatura
thumbnail uri

Adresa URL k verzi miniatury podpisu

updated_at
updated_at date-time

Časové razítko poslední aktualizace podpisu

updated_by
updated_by string

Zobrazované jméno uživatele, který podpis naposledy aktualizoval

updated_by_id
updated_by_id string

ID uživatele, který podpis naposledy aktualizoval

Nahrané
uploaded boolean

Zda byl podpis odeslán

adresa URL
url uri

Adresa URL rozhraní API pro načtení tohoto podpisu

SignaturesResponse

Name Cesta Typ Description
current_page
current_page integer
per_page
per_page integer
podpisy
signatures array of Signature
total_count
total_count integer
celkem stránek
total_pages integer

SinglePhotoResponse

Name Cesta Typ Description
foto
photo Photo

SingleRecordResponse

Name Cesta Typ Description
záznam
record Record

SingleSignatureResponse

Name Cesta Typ Description
signatura
signature Signature

SingleSketchResponse

Name Cesta Typ Description
Skica
sketch Sketch

Nákres

Name Cesta Typ Description
access_key
access_key string

Jedinečný identifikátor skicy

content_type
content_type string

Typ MIME souboru skica

datum_vytvoření
created_at date-time

Časové razítko při vytvoření skicy

vytvořeno kým
created_by string

Zobrazované jméno uživatele, který vytvořil skicu

created_by_id
created_by_id string

ID uživatele, který vytvořil skicu

exif
exif object

Metadata EXIF ze skicy

file_size
file_size integer

Velikost souboru skicy v bajtech

form_id
form_id string

ID přidruženého formuláře

velký
large uri

Adresa URL velké verze skicy

médium
medium uri

Adresa URL na střední verzi skicy

původní
original uri

Adresa URL původní verze skicy

zpracovaný
processed boolean

Zda se skica zpracovala

record_id
record_id string

ID přidruženého záznamu

malý
small uri

Adresa URL malé verze skicy

Uloženy
stored boolean

Zda je skica uložena

miniatura
thumbnail uri

Adresa URL k verzi skicy miniatury

updated_at
updated_at date-time

Časové razítko poslední aktualizace skicy

updated_by
updated_by string

Zobrazované jméno uživatele, který naposledy aktualizoval skicu

updated_by_id
updated_by_id string

ID uživatele, který naposledy aktualizoval skicu

Nahrané
uploaded boolean

Zda se skica nahrála

adresa URL
url uri

Adresa URL rozhraní API pro přístup k tomuto prostředku skicy

SketchesResponse

Name Cesta Typ Description
current_page
current_page integer
per_page
per_page integer
Skici
sketches array of Sketch
total_count
total_count integer
celkem stránek
total_pages integer

Video

Name Cesta Typ Description
access_key
access_key string

Jedinečný identifikátor videa

content_type
content_type string

Typ MIME videosouboru

datum_vytvoření
created_at date-time

Časové razítko při vytvoření videa

vytvořeno kým
created_by string

Zobrazované jméno uživatele, který video vytvořil

created_by_id
created_by_id string

ID uživatele, který video vytvořil

deleted_at
deleted_at date-time

Časové razítko odstranění videa

file_size
file_size integer

Velikost videosouboru v bajtech

form_id
form_id string

ID přidruženého formuláře

médium
medium uri

Adresa URL na střední verzi videa

metadata
metadata object

Další metadata o videu

původní
original uri

Adresa URL původního videosouboru

zpracovaný
processed boolean

Zda bylo video zpracováno

record_id
record_id string

ID přidruženého záznamu

malý
small uri

Adresa URL malé verze videa

stav
status string

Stav zpracování videa

Uloženy
stored boolean

Jestli se video uložilo

thumbnail_huge
thumbnail_huge uri

Adresa URL obrovského miniatury

thumbnail_huge_square
thumbnail_huge_square uri

Adresa URL obrovského čtvercových miniatur

thumbnail_large
thumbnail_large uri

Adresa URL velkého miniatury

thumbnail_large_square
thumbnail_large_square uri

Adresa URL obrázku miniatury velkého čtverce

thumbnail_medium
thumbnail_medium uri

Adresa URL na střední miniaturu

thumbnail_medium_square
thumbnail_medium_square uri

Adresa URL na obrázek miniatury středního čtverce

thumbnail_small
thumbnail_small uri

Adresa URL malého miniatury

thumbnail_small_square
thumbnail_small_square uri

Adresa URL pro miniaturu malého čtverce

skladba
track uri

Adresa URL videa ke sledování dat ve formátu JSON, pokud je k dispozici

updated_at
updated_at date-time

Časové razítko poslední aktualizace videa

updated_by
updated_by string

Zobrazované jméno uživatele, který video naposledy aktualizoval

updated_by_id
updated_by_id string

ID uživatele, který video naposledy aktualizoval

Nahrané
uploaded boolean

Jestli se video nahrálo

adresa URL
url uri

Adresa URL rozhraní API pro přístup k tomuto prostředku videa

VideosResponse

Name Cesta Typ Description
current_page
current_page integer
per_page
per_page integer
total_count
total_count integer
celkem stránek
total_pages integer
videos
videos array of Video

FulcrumWebhookPayload

Datová část události Webhooku z Fulcrumu

Name Cesta Typ Description
ID události
id string

Jedinečný identifikátor události

Typ události
type string

Typ události (např. 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 vlastníka
owner_id string

ID organizace, která vlastní tento webhook

Data událostí
data object

Data záznamu nebo zdroje přidružené k události

Vytvořeno na adrese
created_at date-time

Časové razítko, kdy došlo k události

binární

Toto je základní datový typ 'binární'.