다음을 통해 공유

풀크럼(미리 보기)

Fulcrum은 GIS 전문가와 비 GIS 팀 구성원이 지리 공간적 데이터를 쉽게 캡처하고 공유할 수 있도록 하는 필드 우선 솔루션입니다. 이 커넥터를 사용하면 필드 데이터, 사진, 비디오 등을 관리하기 위해 Fulcrum과 통합할 수 있습니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

Service 클래스 지역
Copilot Studio 프리미엄 다음을 제외한 모든 Power Automate 지역:
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
논리 앱 표준 다음을 제외한 모든 Logic Apps 지역 :
     - Azure Government 지역
     - Azure 중국 지역
     - 미국 국방부(DoD)
Power Apps 프리미엄 다음을 제외한 모든 Power Apps 지역:
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
Power Automate 프리미엄 다음을 제외한 모든 Power Automate 지역:
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
연락처
이름 Fulcrum 지원
URL https://www.fulcrumapp.com/support
전자 메일 support@fulcrumapp.com
커넥터 메타데이터
Publisher Spatial Networks, Inc.
웹 사이트 https://www.fulcrumapp.com
개인 정보 보호 정책 https://www.fulcrumapp.com/privacy
카테고리 생산력; 데이터

받침점

Fulcrum은 GIS 전문가와 비 GIS 팀 구성원이 지리 공간적 데이터를 쉽게 캡처하고 공유할 수 있도록 하는 필드 우선 솔루션입니다. 이 커넥터를 사용하면 필드 데이터, 사진, 비디오 등을 관리하기 위해 Fulcrum과 통합할 수 있습니다.

Publisher

받침점

필수 조건

  • API 액세스를 사용하도록 설정된 활성 Fulcrum 구독

지원되는 작업

유발 요소

Fulcrum 이벤트가 발생하는 경우

Fulcrum 리소스가 생성, 업데이트 또는 삭제될 때 트리거됩니다. 레코드, 양식, 선택 목록 및 분류 집합에 대한 이벤트를 지원합니다. 모니터링할 이벤트를 지정하도록 Fulcrum 조직에서 웹후크를 구성합니다.

조치

첨부 파일 메타데이터 목록 가져오기

첨부 파일 목록을 검색합니다.

첨부 파일 가져오기

단일 첨부 파일에 대한 메타데이터를 검색합니다.

오디오 메타데이터 목록 가져오기

오디오 파일 목록에 대한 메타데이터를 검색합니다.

오디오 원본 파일 가져오기

원래 오디오 파일을 다운로드합니다.

사진 메타데이터 목록 가져오기

사진 목록에 대한 메타데이터를 검색합니다.

사진 원본 파일 가져오기

원본 사진 파일을 다운로드합니다.

사진 메타데이터 가져오기

단일 사진에 대한 메타데이터를 검색합니다.

쿼리 POST 요청 만들기

HTTP POST를 사용하여 쿼리 API 요청을 실행합니다. 조직의 데이터에 대해 쿼리하는 쿼리와 같은 SQL을 제공합니다.

레코드 목록 가져오기

양식, 프로젝트, 변경 집합, 경계 상자 및 날짜 범위와 같은 차원으로 필터링할 수 있는 조직의 레코드 목록을 가져옵니다.

레코드 만들기

제공된 양식 값, 위치 정보 및 연결된 메타데이터를 사용하여 지정된 양식에 새 레코드를 만듭니다.

레코드 삭제

조직에서 레코드를 삭제합니다.

레코드 가져오기

ID로 특정 레코드에 대한 자세한 정보를 검색합니다. 여기에는 모든 양식 필드 값, 위치 데이터, 타임스탬프 및 관련 메타데이터가 포함됩니다.

레코드 부분 업데이트

전체 레코드 개체를 요구하지 않고 기존 레코드의 특정 필드를 업데이트합니다. 요청 본문에 포함된 필드만 수정되고 다른 모든 필드는 변경되지 않은 상태로 유지됩니다. 이는 개별 필드 값 또는 메타데이터를 업데이트하는 데 유용합니다.

레코드 업데이트

제공된 레코드 개체를 사용하여 레코드를 업데이트합니다. 레코드 개체는 레코드의 전체 표현이어야 합니다. 포함되지 않은 모든 필드는 null로 간주됩니다.

레코드의 기록 가져오기

레코드의 전체 버전 기록을 검색합니다.

보고서 만들기

필요에 따라 보고서 템플릿을 사용하여 특정 레코드에 대한 새 보고서를 생성합니다.

보고서 파일 가져오기

생성된 PDF 보고서 파일을 다운로드합니다.

서명 메타데이터 목록 가져오기

서명 목록에 대한 메타데이터를 검색합니다.

서명 메타데이터 가져오기

단일 서명에 대한 메타데이터를 검색합니다.

서명 원본 파일 가져오기

원래 서명 파일을 다운로드합니다.

스케치 메타데이터 목록 가져오기

스케치 목록에 대한 메타데이터를 검색합니다.

스케치 원본 파일 가져오기

원래 스케치 파일을 다운로드합니다.

스케치 메타데이터 가져오기

단일 스케치에 대한 메타데이터를 검색합니다.

비디오 메타데이터 목록 가져오기

비디오 목록에 대한 메타데이터를 검색합니다.

비디오 원본 파일 가져오기

원본 비디오 파일을 다운로드합니다.

자격 증명 가져오기

Fulcrum 커넥터를 사용하려면 Fulcrum API 토큰이 필요합니다.

  1. 에서 Fulcrum 계정에 로그인합니다. https://web.fulcrumapp.com
  2. 설정 > API로 이동합니다.
  3. 새 API 토큰 생성 또는 기존 토큰 사용
  4. 토큰을 복사하고 연결을 만들 때 사용합니다.

시작하기

새 연결을 만들고 메시지가 표시되면 Fulcrum API 토큰을 입력합니다.

사용자 지정 호스트 URL

기본적으로 커넥터는 .에서 api.fulcrumapp.com프로덕션 Fulcrum API를 사용합니다. 다른 지역의 경우 연결을 만들 때 다른 호스트 URL을 지정할 수 있습니다.

지역별 엔드포인트:

  • United States(기본값): api.fulcrumapp.com
  • 캐나다: api.fulcrumapp-ca.com
  • 오스트레일리아: api.fulcrumapp-au.com
  • 유럽: api.fulcrumapp-eu.com

형식: 프로토콜 또는 경로 없이 호스트 이름만 입력합니다. 커넥터는 HTTPS 및 올바른 API 경로를 자동으로 사용합니다.

문제 해결.

  • 네트워크에서 사용자 지정 호스트에 액세스할 수 있는지 확인
  • 호스트 이름이 올바른지 확인합니다(오타 없음).
  • API 토큰이 지정된 호스트에 대해 유효한지 확인합니다.

알려진 문제 및 제한 사항

  • 속도 제한은 Fulcrum 플랜에 따라 적용됩니다.

배포 지침

이 커넥터를 Microsoft Power Automate 및 Power Apps 사용자 지정 커넥터로 배포하려면 >을 사용합니다.

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.
기본값 연결을 만들기 위한 매개 변수입니다. 모든 지역 공유할 수 없음

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

이름 유형 설명 필수
API 토큰 시큐어스트링 (보안 문자열) 인증을 위한 Fulcrum API 토큰 진실
호스트 URL 문자열 Fulcrum 인스턴스에 대한 API 호스트

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초

동작

레코드 가져오기

ID로 특정 레코드에 대한 자세한 정보를 검색합니다. 여기에는 모든 양식 필드 값, 위치 데이터, 타임스탬프 및 관련 메타데이터가 포함됩니다.
레코드 만들기

제공된 양식 값, 위치 정보 및 연결된 메타데이터를 사용하여 지정된 양식에 새 레코드를 만듭니다.
레코드 목록 가져오기

양식, 프로젝트, 변경 집합, 경계 상자 및 날짜 범위와 같은 차원으로 필터링할 수 있는 조직의 레코드 목록을 가져옵니다.
레코드 부분 업데이트

전체 레코드 개체를 요구하지 않고 기존 레코드의 특정 필드를 업데이트합니다. 요청 본문에 포함된 필드만 수정되고 다른 모든 필드는 변경되지 않은 상태로 유지됩니다. 이는 개별 필드 값 또는 메타데이터를 업데이트하는 데 유용합니다.
레코드 삭제

조직에서 레코드를 삭제합니다.
레코드 업데이트

제공된 레코드 개체를 사용하여 레코드를 업데이트합니다. 레코드 개체는 레코드의 전체 표현이어야 합니다. 포함되지 않은 모든 필드는 null로 간주됩니다.
레코드의 기록 가져오기

레코드의 전체 버전 기록을 검색합니다.
보고서 만들기

필요에 따라 보고서 템플릿을 사용하여 특정 레코드에 대한 새 보고서를 생성합니다.
보고서 파일 가져오기

생성된 PDF 보고서 파일을 다운로드합니다.
비디오 메타데이터 목록 가져오기

비디오 목록에 대한 메타데이터를 검색합니다.
비디오 원본 파일 가져오기

원본 비디오 파일을 다운로드합니다.
사진 메타데이터 가져오기

단일 사진에 대한 메타데이터를 검색합니다.
사진 메타데이터 목록 가져오기

사진 목록에 대한 메타데이터를 검색합니다.
사진 원본 파일 가져오기

원본 사진 파일을 다운로드합니다.
서명 메타데이터 가져오기

단일 서명에 대한 메타데이터를 검색합니다.
서명 메타데이터 목록 가져오기

서명 목록에 대한 메타데이터를 검색합니다.
서명 원본 파일 가져오기

원래 서명 파일을 다운로드합니다.
스케치 메타데이터 가져오기

단일 스케치에 대한 메타데이터를 검색합니다.
스케치 메타데이터 목록 가져오기

스케치 목록에 대한 메타데이터를 검색합니다.
스케치 원본 파일 가져오기

원래 스케치 파일을 다운로드합니다.
오디오 메타데이터 목록 가져오기

오디오 파일 목록에 대한 메타데이터를 검색합니다.
오디오 원본 파일 가져오기

원래 오디오 파일을 다운로드합니다.
첨부 파일 가져오기

단일 첨부 파일에 대한 메타데이터를 검색합니다.
첨부 파일 메타데이터 목록 가져오기

첨부 파일 목록을 검색합니다.
쿼리 POST 요청 만들기

HTTP POST를 사용하여 쿼리 API 요청을 실행합니다. 조직의 데이터에 대해 쿼리하는 쿼리와 같은 SQL을 제공합니다.

레코드 가져오기

작업 ID:
Records-get-single

ID로 특정 레코드에 대한 자세한 정보를 검색합니다. 여기에는 모든 양식 필드 값, 위치 데이터, 타임스탬프 및 관련 메타데이터가 포함됩니다.

매개 변수

Name 키 필수 형식 Description
레코드 ID
 record_id True string

검색할 레코드의 고유 식별자입니다.

반환

몸
SingleRecordResponse

레코드 만들기

작업 ID:
Records-create

제공된 양식 값, 위치 정보 및 연결된 메타데이터를 사용하여 지정된 양식에 새 레코드를 만듭니다.

매개 변수

Name 키 필수 형식 Description
콘텐츠 형식
 Content-Type string

콘텐츠 형식
X Skipworkflows
 X-SkipWorkflows boolean

모든 앱 워크플로 건너뛰기
X Skipwebhooks
 X-SkipWebhooks boolean

모든 앱 웹후크를 건너뜁니다.
assigned_to_id
 assigned_to_id string

이 레코드에 할당된 사용자의 ID
form_id
 form_id True string

이 레코드가 속한 양식의 ID
form_values
 form_values object

필드 키로 키가 지정된 필드 값
좌표
 coordinates True

기하 도형의 좌표입니다. 형식은 유형에 따라 다릅니다. 점 사용 [경도, 위도], LineString은 위치 배열을 사용하고, 다각형은 선형 링 배열을 사용합니다(첫 번째는 외부이고 나머지는 구멍임), Multi* 형식은 해당 좌표 구조의 배열을 사용합니다.
유형
 type True string

GeoJSON 기하 도형 형식
latitude
 latitude number

위도 좌표
경도
 longitude number

경도 좌표
project_id
 project_id string

프로젝트의 ID
상태
 status string

레코드의 상태

반환

몸
SingleRecordResponse

레코드 목록 가져오기

작업 ID:
Records-get-all

양식, 프로젝트, 변경 집합, 경계 상자 및 날짜 범위와 같은 차원으로 필터링할 수 있는 조직의 레코드 목록을 가져옵니다.

매개 변수

Name 키 필수 형식 Description
최신 첫 번째
 newest_first boolean

있는 경우 레코드는 updated_at 날짜별로 정렬됩니다.
경계 상자
 bounding_box string

요청된 레코드의 경계 상자입니다. 형식은 위도,long,위도,long(아래쪽, 왼쪽, 위쪽, 오른쪽)이어야 합니다.
변경 집합 ID
 changeset_id string

레코드와 연결된 변경 집합의 ID입니다.
양식 ID
 form_id string

레코드가 연결된 폼의 ID입니다. 이 값을 비워 두면 모든 레코드에 대해 쿼리됩니다.
프로젝트 ID
 project_id string

레코드가 연결된 프로젝트의 ID입니다. 이 값을 비워 두면 모든 레코드에 대해 쿼리됩니다.
이전에 만든 클라이언트
 client_created_before date-time

지정된 시간 전에 클라이언트(디바이스)에서 만든 레코드만 반환합니다.
이후 클라이언트 생성됨
 client_created_since date-time

지정된 시간 후에 클라이언트(디바이스)에서 만든 레코드만 반환합니다.
이전에 업데이트된 클라이언트
 client_updated_before date-time

지정된 시간 전에 클라이언트(디바이스)에서 업데이트한 레코드만 반환합니다.
이후 클라이언트 업데이트됨
 client_updated_since date-time

지정된 시간 후에 클라이언트(디바이스)에서 업데이트한 레코드만 반환합니다.
이전에 만든 경우
 created_before date-time

지정된 시간 전에 만들어진 레코드만 반환합니다(서버에서).
이후 생성됨
 created_since date-time

지정된 시간 후에 만들어진 레코드만 반환합니다(서버에서).
이전에 업데이트됨
 updated_before date-time

지정된 시간 전에(서버에서) 업데이트된 레코드만 반환합니다.
이후 업데이트됨
 updated_since date-time

지정된 시간 후에(서버에서) 업데이트된 레코드만 반환합니다.
페이지
 page integer

요청된 페이지 번호
페이지당
 per_page integer

페이지당 항목 수

반환

몸
RecordsResponse

레코드 부분 업데이트

작업 ID:
Records-partial-update

전체 레코드 개체를 요구하지 않고 기존 레코드의 특정 필드를 업데이트합니다. 요청 본문에 포함된 필드만 수정되고 다른 모든 필드는 변경되지 않은 상태로 유지됩니다. 이는 개별 필드 값 또는 메타데이터를 업데이트하는 데 유용합니다.

매개 변수

Name 키 필수 형식 Description
콘텐츠 형식
 Content-Type string

콘텐츠 형식
레코드 ID
 record_id True string

레코드 ID
X Skipworkflows
 X-SkipWorkflows boolean

모든 앱 워크플로 건너뛰기
X Skipwebhooks
 X-SkipWebhooks boolean

모든 앱 웹후크를 건너뜁니다.
assigned_to_id
 assigned_to_id string

이 레코드에 할당된 사용자의 ID
form_values
 form_values object

필드 키로 키가 지정된 필드 값
좌표
 coordinates True

기하 도형의 좌표입니다. 형식은 유형에 따라 다릅니다. 점 사용 [경도, 위도], LineString은 위치 배열을 사용하고, 다각형은 선형 링 배열을 사용합니다(첫 번째는 외부이고 나머지는 구멍임), Multi* 형식은 해당 좌표 구조의 배열을 사용합니다.
유형
 type True string

GeoJSON 기하 도형 형식
latitude
 latitude number

위도 좌표
경도
 longitude number

경도 좌표
project_id
 project_id string

프로젝트의 ID
상태
 status string

레코드의 상태

반환

몸
SingleRecordResponse

레코드 삭제

작업 ID:
Records-delete

조직에서 레코드를 삭제합니다.

매개 변수

Name 키 필수 형식 Description
레코드 ID
 record_id True string

삭제할 레코드의 고유 식별자입니다.
X Skipworkflows
 X-SkipWorkflows boolean

모든 앱 워크플로 건너뛰기
X Skipwebhooks
 X-SkipWebhooks boolean

모든 앱 웹후크를 건너뜁니다.

반환

몸
SingleRecordResponse

레코드 업데이트

작업 ID:
Records-update

제공된 레코드 개체를 사용하여 레코드를 업데이트합니다. 레코드 개체는 레코드의 전체 표현이어야 합니다. 포함되지 않은 모든 필드는 null로 간주됩니다.

매개 변수

Name 키 필수 형식 Description
콘텐츠 형식
 Content-Type string

콘텐츠 형식
레코드 ID
 record_id True string

레코드 ID
X Skipworkflows
 X-SkipWorkflows boolean

모든 앱 워크플로 건너뛰기
X Skipwebhooks
 X-SkipWebhooks boolean

모든 앱 웹후크를 건너뜁니다.
assigned_to_id
 assigned_to_id string

이 레코드에 할당된 사용자의 ID
form_id
 form_id True string

이 레코드가 속한 양식의 ID
form_values
 form_values object

필드 키로 키가 지정된 필드 값
좌표
 coordinates True

기하 도형의 좌표입니다. 형식은 유형에 따라 다릅니다. 점 사용 [경도, 위도], LineString은 위치 배열을 사용하고, 다각형은 선형 링 배열을 사용합니다(첫 번째는 외부이고 나머지는 구멍임), Multi* 형식은 해당 좌표 구조의 배열을 사용합니다.
유형
 type True string

GeoJSON 기하 도형 형식
latitude
 latitude number

위도 좌표
경도
 longitude number

경도 좌표
project_id
 project_id string

프로젝트의 ID
상태
 status string

레코드의 상태

레코드의 기록 가져오기

작업 ID:
Records-get-history

레코드의 전체 버전 기록을 검색합니다.

매개 변수

Name 키 필수 형식 Description
레코드 ID
 record_id True string

기록을 검색하려는 레코드의 고유 식별자입니다.

반환

몸
RecordHistoryResponse

보고서 만들기

작업 ID:
Reports-create

필요에 따라 보고서 템플릿을 사용하여 특정 레코드에 대한 새 보고서를 생성합니다.

매개 변수

Name 키 필수 형식 Description
record_id
 record_id True uuid

에 대한 보고서를 생성할 레코드의 ID입니다.
템플릿_아이디
 template_id uuid

사용할 보고서 템플릿의 ID(선택 사항)

반환

몸
ReportResponse

보고서 파일 가져오기

작업 ID:
Reports-file

생성된 PDF 보고서 파일을 다운로드합니다.

매개 변수

Name 키 필수 형식 Description
보고서 ID
 report_id True uuid

보고서의 고유 식별자입니다.

반환

response
binary

비디오 메타데이터 목록 가져오기

작업 ID:
Videos-get-all

비디오 목록에 대한 메타데이터를 검색합니다.

매개 변수

Name 키 필수 형식 Description
레코드 ID
 record_id string

비디오가 연결된 레코드의 ID입니다.
양식 ID
 form_id string

비디오가 연결된 양식의 ID입니다. 이 값을 비워 두면 모든 비디오에 대한 쿼리가 수행됩니다.
최신 첫 번째
 newest_first boolean

있는 경우 비디오는 updated_at 날짜별로 정렬됩니다.
처리
 processed boolean

완전히 처리된 비디오를 필터링합니다.
저장됨
 stored boolean

완전히 저장된 비디오를 필터링합니다.
업로드됨
 uploaded boolean

완전히 업로드된 비디오를 필터링합니다.
페이지
 page integer

요청된 페이지 번호입니다.
페이지당
 per_page integer

페이지당 반환할 항목 수입니다.

반환

몸
VideosResponse

비디오 원본 파일 가져오기

작업 ID:
Videos-get-original-file

원본 비디오 파일을 다운로드합니다.

매개 변수

Name 키 필수 형식 Description
비디오 ID
 video_id True string

비디오의 고유 식별자입니다.

반환

response
binary

사진 메타데이터 가져오기

작업 ID:
Photos-get-single-metadata

단일 사진에 대한 메타데이터를 검색합니다.

매개 변수

Name 키 필수 형식 Description
사진 ID
 photo_id True string

사진의 고유 식별자입니다.

반환

몸
SinglePhotoResponse

사진 메타데이터 목록 가져오기

작업 ID:
Photos-get-all-metadata

사진 목록에 대한 메타데이터를 검색합니다.

매개 변수

Name 키 필수 형식 Description
레코드 ID
 record_id string

사진이 연결된 레코드의 ID입니다.
양식 ID
 form_id string

사진이 연결된 양식의 ID입니다. 이 값을 비워 두면 모든 사진에 대해 쿼리됩니다.
최신 첫 번째
 newest_first boolean

있는 경우 사진은 updated_at 날짜별로 정렬됩니다.
처리
 processed boolean

완전히 처리된 사진을 필터링합니다.
저장됨
 stored boolean

완전히 저장된 사진을 필터링합니다.
업로드됨
 uploaded boolean

완전히 업로드된 사진을 필터링합니다.
페이지
 page integer

요청된 페이지 번호입니다.
페이지당
 per_page integer

페이지당 반환할 항목 수입니다.

반환

몸
PhotosResponse

사진 원본 파일 가져오기

작업 ID:
Photos-get-single-file

원본 사진 파일을 다운로드합니다.

매개 변수

Name 키 필수 형식 Description
사진 ID
 photo_id True string

사진의 고유 식별자입니다.

반환

response
binary

서명 메타데이터 가져오기

작업 ID:
Signatures-get-single-metadata

단일 서명에 대한 메타데이터를 검색합니다.

매개 변수

Name 키 필수 형식 Description
서명 ID
 signature_id True string

서명의 고유 식별자입니다.

반환

몸
SingleSignatureResponse

서명 메타데이터 목록 가져오기

작업 ID:
Signatures-get-all

서명 목록에 대한 메타데이터를 검색합니다.

매개 변수

Name 키 필수 형식 Description
레코드 ID
 record_id string

사진이 연결된 레코드의 ID입니다.
양식 ID
 form_id string

사진이 연결된 양식의 ID입니다. 이 값을 비워 두면 모든 사진에 대해 쿼리됩니다.
최신 첫 번째
 newest_first boolean

있는 경우 사진은 updated_at 날짜별로 정렬됩니다.
처리
 processed boolean

완전히 처리된 서명을 필터링합니다.
저장됨
 stored boolean

완전히 저장된 서명을 필터링합니다.
업로드됨
 uploaded boolean

완전히 업로드된 서명을 필터링합니다.
페이지
 page integer

요청된 페이지 번호입니다.
페이지당
 per_page integer

페이지당 반환할 항목 수입니다.

반환

몸
SignaturesResponse

서명 원본 파일 가져오기

작업 ID:
Signatures-get-single-file

원래 서명 파일을 다운로드합니다.

매개 변수

Name 키 필수 형식 Description
서명 ID
 signature_id True string

서명의 고유 식별자입니다.

반환

response
binary

스케치 메타데이터 가져오기

작업 ID:
Sketches-get-single-metadata

단일 스케치에 대한 메타데이터를 검색합니다.

매개 변수

Name 키 필수 형식 Description
스케치 ID
 sketch_id True string

스케치 ID

반환

몸
SingleSketchResponse

스케치 메타데이터 목록 가져오기

작업 ID:
Sketches-get-all-metadata

스케치 목록에 대한 메타데이터를 검색합니다.

매개 변수

Name 키 필수 형식 Description
레코드 ID
 record_id string

스케치가 연결된 레코드의 ID입니다.
양식 ID
 form_id string

스케치가 연결된 폼의 ID입니다. 이 값을 비워 두면 모든 스케치에 대해 쿼리됩니다.
최신 첫 번째
 newest_first boolean

있는 경우 스케치는 updated_at 날짜별로 정렬됩니다.
처리
 processed boolean

스케치가 완전히 처리되었습니다.
저장됨
 stored boolean

스케치가 완전히 저장되었습니다.
업로드됨
 uploaded boolean

스케치가 완전히 업로드되었습니다.
페이지
 page integer

요청된 페이지 번호
페이지당
 per_page integer

페이지당 항목 수

반환

몸
SketchesResponse

스케치 원본 파일 가져오기

작업 ID:
Sketches-get-single-file

원래 스케치 파일을 다운로드합니다.

매개 변수

Name 키 필수 형식 Description
스케치 ID
 sketch_id True string

스케치 ID

반환

response
binary

오디오 메타데이터 목록 가져오기

작업 ID:
Audio-get-all

오디오 파일 목록에 대한 메타데이터를 검색합니다.

매개 변수

Name 키 필수 형식 Description
레코드 ID
 record_id string

오디오 파일이 연결된 레코드의 ID입니다.
양식 ID
 form_id string

오디오 파일이 연결된 양식의 ID입니다. 이 값을 비워 두면 모든 오디오 파일에 대해 쿼리됩니다.
최신 첫 번째
 newest_first boolean

있는 경우 오디오 파일은 updated_at 날짜별로 정렬됩니다.
처리
 processed boolean

완전히 처리된 오디오 파일을 필터링합니다.
저장됨
 stored boolean

완전히 저장된 오디오 파일을 필터링합니다.
업로드됨
 uploaded boolean

완전히 업로드된 오디오 파일을 필터링합니다.
페이지
 page integer

요청된 페이지 번호입니다.
페이지당
 per_page integer

페이지당 반환할 항목 수입니다.

반환

몸
AudiosResponse

오디오 원본 파일 가져오기

작업 ID:
Audio-get-original-file

원래 오디오 파일을 다운로드합니다.

매개 변수

Name 키 필수 형식 Description
오디오 ID
 audio_id True string

오디오 파일의 고유 식별자입니다.

반환

response
binary

첨부 파일 가져오기

작업 ID:
Get-single-attachment

단일 첨부 파일에 대한 메타데이터를 검색합니다.

매개 변수

Name 키 필수 형식 Description
첨부 파일 ID
 attachment_id True string

첨부 파일의 고유 식별자입니다.

반환

몸
Attachment

첨부 파일 메타데이터 목록 가져오기

작업 ID:
Get-all-attachments

첨부 파일 목록을 검색합니다.

매개 변수

Name 키 필수 형식 Description
레코드 ID
 record_id string

첨부 파일이 연결된 레코드의 ID입니다. 레코드 첨부 파일을 나열할 때 필요합니다.
양식 ID
 form_id string

첨부 파일이 연결된 양식의 ID입니다. 이 매개 변수를 사용하면 양식 내의 모든 참조 파일을 가져올 수 있으며 양식의 모든 레코드 첨부 파일을 가져올 수는 없습니다.
소유자 유형
 owner_type string

쿼리할 첨부 파일의 형식입니다. 또는 formrecord.이어야 합니다.
정렬
 sort string

결과를 정렬할 필드입니다.
정렬 방향
 sort_direction string

정렬 방향(asc, desc)입니다. 기본값은 asc입니다.

반환

몸
AttachmentsResponse

쿼리 POST 요청 만들기

작업 ID:
Query-post

HTTP POST를 사용하여 쿼리 API 요청을 실행합니다. 조직의 데이터에 대해 쿼리하는 쿼리와 같은 SQL을 제공합니다.

매개 변수

Name 키 필수 형식 Description
페이지
 page integer

요청된 페이지 번호입니다.
페이지당
 per_page integer

페이지당 반환할 항목 수입니다.
format
 format string

응답 형식
q
 q True string

실행할 SQL 쿼리
테이블 이름
 table_name string

쿼리할 테이블의 이름

트리거

Fulcrum 이벤트가 발생하는 경우

Fulcrum 리소스가 생성, 업데이트 또는 삭제될 때 트리거됩니다. 레코드, 양식, 선택 목록 및 분류 집합에 대한 이벤트를 지원합니다. 모니터링할 이벤트를 지정하도록 Fulcrum 조직에서 웹후크를 구성합니다.

Fulcrum 이벤트가 발생하는 경우

작업 ID:
OnFulcrumEvent

Fulcrum 리소스가 생성, 업데이트 또는 삭제될 때 트리거됩니다. 레코드, 양식, 선택 목록 및 분류 집합에 대한 이벤트를 지원합니다. 모니터링할 이벤트를 지정하도록 Fulcrum 조직에서 웹후크를 구성합니다.

매개 변수

Name 키 필수 형식 Description
콘텐츠 형식
 Content-Type string

콘텐츠 형식
active
 active boolean

웹후크를 사용할 수 있는지 여부
웹후크 이름
 name True string

웹후크의 표시 이름
run_for_bulk_actions
 run_for_bulk_actions boolean

웹후크가 대량 레코드 작업에 대해 실행되는지 여부

반환

Fulcrum의 웹후크 이벤트 페이로드

몸
FulcrumWebhookPayload

정의

Attachment

Name 경로 형식 Description
attached_to_id
 attached_to_id string

이 첨부 파일이 연결된 리소스의 ID
attached_to_type
 attached_to_type string

이 첨부 파일이 연결된 리소스의 유형
완성하다
 complete boolean

첨부 파일 업로드가 완료되었는지 여부
file_size
 file_size integer

첨부 파일의 크기(바이트)
아이디
 id string

첨부 파일의 고유 식별자
이름
 name string

첨부 파일의 파일 이름
소유자
 owners array of object

첨부 파일에 대한 소유자 참조 목록
아이디
 owners.id string

소유자의 ID
유형
 owners.type string

소유자 유형(예: 'record' 또는 'form')
상태
 status string

첨부 파일의 상태
uploaded_at
 uploaded_at date-time

첨부 파일이 업로드된 타임스탬프
url
 url uri

첨부 파일에 액세스하기 위한 URL

AttachmentsResponse

Name 경로 형식 Description
첨부 파일
 attachments array of Attachment
합계
 total integer

반환된 총 첨부 파일 수
total_count
 total_count integer

사용 가능한 총 첨부 파일 수

오디오

Name 경로 형식 Description
access_key
 access_key string

오디오 리소스에 대한 고유 식별자
content_type
 content_type string

오디오 파일의 MIME 형식
생성_시간
 created_at date-time

오디오가 만들어진 타임스탬프
작성자
 created_by string

오디오를 만든 사용자의 표시 이름
created_by_id
 created_by_id string

오디오를 만든 사용자의 ID
deleted_at
 deleted_at date-time

오디오가 삭제된 타임스탬프
file_size
 file_size integer

오디오 파일 크기(바이트)
form_id
 form_id string

연결된 양식의 ID
중간
 medium uri

오디오의 URL-중간 버전(처리된 경우)
metadata
 metadata object

오디오 메타데이터(예: 기간, 형식 세부 정보)
오리지널
 original uri

원본 오디오 파일에 대한 URL(저장된 경우)
처리
 processed boolean

오디오가 처리되었는지 여부
record_id
 record_id string

연결된 레코드의 ID
작다
 small uri

작은 버전의 오디오에 대한 URL(처리된 경우)
상태
 status string

오디오의 처리 상태
저장
 stored boolean

오디오가 저장되었는지 여부
track
 track uri

오디오 트랙에 액세스하기 위한 URL(사용 가능한 경우)
updated_at
 updated_at date-time

오디오가 마지막으로 업데이트된 타임스탬프
updated_by
 updated_by string

오디오를 마지막으로 업데이트한 사용자의 표시 이름
updated_by_id
 updated_by_id string

오디오를 마지막으로 업데이트한 사용자의 ID
업로드
 uploaded boolean

오디오가 업로드되었는지 여부
url
 url uri

오디오 리소스에 액세스하기 위한 URL

AudiosResponse

Name 경로 형식 Description
audio
 audio array of Audio
current_page
 current_page integer
per_page
 per_page integer
total_count
 total_count integer
전체 페이지
 total_pages integer

AuditLocation

만들거나 업데이트할 때 캡처된 위치 메타데이터입니다.

Name 경로 형식 Description
고도
 altitude double

미터 단위의 고도입니다.
horizontal_accuracy
 horizontal_accuracy double

가로 정확도(미터)입니다.
latitude
 latitude double

위도 좌표입니다.
경도
 longitude double

경도 좌표입니다.

기하학

Name 경로 형식 Description
좌표
 coordinates

기하 도형의 좌표입니다. 형식은 유형에 따라 다릅니다. 점 사용 [경도, 위도], LineString은 위치 배열을 사용하고, 다각형은 선형 링 배열을 사용합니다(첫 번째는 외부이고 나머지는 구멍임), Multi* 형식은 해당 좌표 구조의 배열을 사용합니다.
유형
 type string

GeoJSON 기하 도형 형식

사진

Name 경로 형식 Description
access_key
 access_key string

사진의 고유 식별자
content_type
 content_type string

사진의 MIME 형식
생성_시간
 created_at date-time

사진을 만든 경우
작성자
 created_by string

사진을 만든 사용자의 표시 이름
created_by_id
 created_by_id string

사진을 만든 사용자의 ID
deleted_at
 deleted_at date-time

사진이 삭제된 경우
exif
 exif object

사진의 EXIF 메타데이터
file_size
 file_size integer

사진 파일의 크기(바이트)
form_id
 form_id string

연결된 양식의 ID
크게
 large uri

사진의 큰 버전에 대한 URL
latitude
 latitude double

사진을 찍은 위도 좌표
경도
 longitude double

사진을 찍은 경도 좌표
오리지널
 original uri

사진의 원래 버전에 대한 URL
처리
 processed boolean

사진이 처리되었는지 여부
record_id
 record_id string

연결된 레코드의 ID
저장
 stored boolean

사진이 저장되었는지 여부
섬네일
 thumbnail uri

사진의 썸네일 버전 URL
updated_at
 updated_at date-time

사진이 마지막으로 업데이트된 경우
updated_by
 updated_by string

사진을 마지막으로 업데이트한 사용자의 표시 이름
updated_by_id
 updated_by_id string

사진을 마지막으로 업데이트한 사용자의 ID
업로드
 uploaded boolean

사진이 업로드되었는지 여부
url
 url uri

이 사진 리소스에 대한 API URL

PhotosResponse

Name 경로 형식 Description
current_page
 current_page integer
per_page
 per_page integer
사진
 photos array of Photo
total_count
 total_count integer
전체 페이지
 total_pages integer

녹음

Name 경로 형식 Description
고도
 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
코스
 course number
생성_시간
 created_at date-time
작성자
 created_by string
created_by_id
 created_by_id string
created_duration
 created_duration number
created_location
 created_location AuditLocation

만들거나 업데이트할 때 캡처된 위치 메타데이터입니다.
edited_duration
 edited_duration number
form_id
 form_id string
form_values
 form_values object

필드 키로 키가 지정된 필드 값 - 값은 필드 형식에 따라 문자열, 개체 또는 배열일 수 있습니다.
기하학
 geometry Geometry
horizontal_accuracy
 horizontal_accuracy number
아이디
 id string
latitude
 latitude number
경도
 longitude number
project_id
 project_id string
record_series_id
 record_series_id string
speed
 speed number
상태
 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

만들거나 업데이트할 때 캡처된 위치 메타데이터입니다.
버전
 version integer
vertical_accuracy
 vertical_accuracy number

RecordHistoryItem

Name 경로 형식 Description
고도
 altitude double

기록 위치 고도(미터)
assigned_to
 assigned_to string

할당된 사용자의 표시 이름
assigned_to_id
 assigned_to_id string

할당된 사용자의 ID
changeset_id
 changeset_id string

변경 집합 ID
client_created_at
 client_created_at date-time

클라이언트 쪽 만들기 타임스탬프
client_updated_at
 client_updated_at date-time

클라이언트 쪽 업데이트 타임스탬프
코스
 course double

과정/도의 제목
생성_시간
 created_at date-time

레코드 만들기 타임스탬프
작성자
 created_by string

레코드를 만든 사용자의 표시 이름
created_by_id
 created_by_id string

레코드를 만든 사용자의 ID
created_duration
 created_duration integer

레코드 생성 기간(초)
created_location
 created_location AuditLocation

만들거나 업데이트할 때 캡처된 위치 메타데이터입니다.
edited_duration
 edited_duration integer

총 편집 기간(초)
form_id
 form_id string

양식 ID
form_values
 form_values object

양식 필드 값(처리됨)
form_version
 form_version integer

레코드 생성/업데이트 시 양식 버전
좌표
 geometry.coordinates array of number
유형
 geometry.type string
history_change_type
 history_change_type string

변경 유형(c=create, u=update, d=delete)
history_changed_by
 history_changed_by string

이 변경을 수행한 사용자의 표시 이름
history_changed_by_id
 history_changed_by_id string

이 변경을 수행한 사용자의 ID
history_created_at
 history_created_at date-time

이 기록 항목이 만들어진 타임스탬프
history_id
 history_id string

기록 항목 ID
horizontal_accuracy
 horizontal_accuracy double

가로 정확도(미터)
아이디
 id string

레코드 ID
latitude
 latitude double

레코드 위치 위도
경도
 longitude double

레코드 위치 경도
project_id
 project_id string

프로젝트 ID
record_key
 record_key string

선택적 레코드 키
record_sequence
 record_sequence integer

선택적 레코드 시퀀스 번호
시퀀스
 sequence integer

시퀀스 번호(시퀀스 기반 페이지 매김을 사용하는 경우)
speed
 speed double

m/s에서 레코드를 만들 때의 속도
상태
 status string

레코드 상태
updated_at
 updated_at date-time

마지막 업데이트 타임스탬프 기록
updated_by
 updated_by string

레코드를 마지막으로 업데이트한 사용자의 표시 이름
updated_by_id
 updated_by_id string

레코드를 마지막으로 업데이트한 사용자의 ID
updated_duration
 updated_duration integer

레코드 업데이트 기간(초)
updated_location
 updated_location AuditLocation

만들거나 업데이트할 때 캡처된 위치 메타데이터입니다.
버전
 version integer

레코드 버전 번호
vertical_accuracy
 vertical_accuracy double

수직 정확도(미터)

RecordHistoryResponse

Name 경로 형식 Description
current_page
 current_page integer

현재 페이지 번호(페이지 매김 사용 시)
next_sequence
 next_sequence integer

다음 시퀀스 번호(시퀀스 기반 페이지 매김을 사용하는 경우)
per_page
 per_page integer

페이지당 레코드 수(페이지 매김 사용 시)
레코드
 records array of RecordHistoryItem
total_count
 total_count integer

총 레코드 수(페이지 매김 사용 시)
전체 페이지
 total_pages integer

총 페이지 수(페이지 매김 사용 시)

RecordsResponse

Name 경로 형식 Description
current_page
 current_page integer
per_page
 per_page integer
레코드
 records array of Record
total_count
 total_count integer
전체 페이지
 total_pages integer

ReportResponse

Name 경로 형식 Description
completed_at
 report.completed_at date-time

보고서 생성이 완료된 타임스탬프
생성_시간
 report.created_at date-time

보고서를 만들 때의 타임스탬프입니다.
failed_at
 report.failed_at date-time

보고서 생성에 실패한 타임스탬프(성공한 경우 null)
아이디
 report.id uuid

보고서의 고유 식별자입니다.
record_id
 report.record_id uuid

보고서가 생성된 레코드의 ID입니다.
started_at
 report.started_at date-time

보고서 생성이 시작된 타임스탬프
주
 report.state string

보고서의 상태입니다.
템플릿_아이디
 report.template_id uuid

보고서를 생성하는 데 사용되는 템플릿의 ID입니다.
updated_at
 report.updated_at date-time

보고서가 마지막으로 업데이트된 타임스탬프
url
 report.url uri

생성된 보고서를 다운로드할 URL입니다.

Signature

Name 경로 형식 Description
access_key
 access_key string

서명에 대한 고유 식별자
content_type
 content_type string

서명 파일의 MIME 형식
생성_시간
 created_at date-time

서명이 만들어진 타임스탬프
작성자
 created_by string

서명을 만든 사용자의 표시 이름
created_by_id
 created_by_id string

서명을 만든 사용자의 ID
deleted_at
 deleted_at date-time

서명이 삭제된 타임스탬프
file_size
 file_size integer

서명 파일의 크기(바이트)
form_id
 form_id string

연결된 양식의 ID
크게
 large uri

서명의 큰 버전에 대한 URL
오리지널
 original uri

원래 서명 파일의 URL
처리
 processed boolean

서명이 처리되었는지 여부
record_id
 record_id string

연결된 레코드의 ID
저장
 stored boolean

서명이 저장되었는지 여부
섬네일
 thumbnail uri

서명의 썸네일 버전에 대한 URL
updated_at
 updated_at date-time

서명이 마지막으로 업데이트된 타임스탬프
updated_by
 updated_by string

서명을 마지막으로 업데이트한 사용자의 표시 이름
updated_by_id
 updated_by_id string

서명을 마지막으로 업데이트한 사용자의 ID
업로드
 uploaded boolean

서명이 업로드되었는지 여부
url
 url uri

이 서명을 검색하는 API URL

SignaturesResponse

Name 경로 형식 Description
current_page
 current_page integer
per_page
 per_page integer
서명
 signatures array of Signature
total_count
 total_count integer
전체 페이지
 total_pages integer

SinglePhotoResponse

Name 경로 형식 Description
사진
 photo Photo

SingleRecordResponse

Name 경로 형식 Description
기록
 record Record

SingleSignatureResponse

Name 경로 형식 Description
서명
 signature Signature

SingleSketchResponse

Name 경로 형식 Description
스케치
 sketch Sketch

스케치

Name 경로 형식 Description
access_key
 access_key string

스케치의 고유 식별자
content_type
 content_type string

스케치 파일의 MIME 형식
생성_시간
 created_at date-time

스케치가 만들어진 타임스탬프
작성자
 created_by string

스케치를 만든 사용자의 표시 이름
created_by_id
 created_by_id string

스케치를 만든 사용자의 ID
exif
 exif object

스케치의 EXIF 메타데이터
file_size
 file_size integer

스케치 파일의 크기(바이트)
form_id
 form_id string

연결된 양식의 ID
크게
 large uri

큰 버전의 스케치에 대한 URL
중간
 medium uri

스케치의 URL에서 중간 버전까지
오리지널
 original uri

스케치의 원래 버전에 대한 URL
처리
 processed boolean

스케치가 처리되었는지 여부
record_id
 record_id string

연결된 레코드의 ID
작다
 small uri

스케치의 작은 버전에 대한 URL
저장
 stored boolean

스케치가 저장되었는지 여부
섬네일
 thumbnail uri

스케치의 썸네일 버전에 대한 URL
updated_at
 updated_at date-time

스케치가 마지막으로 업데이트된 타임스탬프
updated_by
 updated_by string

스케치를 마지막으로 업데이트한 사용자의 표시 이름
updated_by_id
 updated_by_id string

스케치를 마지막으로 업데이트한 사용자의 ID
업로드
 uploaded boolean

스케치가 업로드되었는지 여부
url
 url uri

이 스케치 리소스에 액세스하기 위한 API URL

SketchesResponse

Name 경로 형식 Description
current_page
 current_page integer
per_page
 per_page integer
스케치
 sketches array of Sketch
total_count
 total_count integer
전체 페이지
 total_pages integer

동영상

Name 경로 형식 Description
access_key
 access_key string

비디오의 고유 식별자
content_type
 content_type string

비디오 파일의 MIME 형식
생성_시간
 created_at date-time

비디오가 만들어진 타임스탬프
작성자
 created_by string

비디오를 만든 사용자의 표시 이름
created_by_id
 created_by_id string

비디오를 만든 사용자의 ID
deleted_at
 deleted_at date-time

비디오가 삭제된 타임스탬프
file_size
 file_size integer

비디오 파일 크기(바이트)
form_id
 form_id string

연결된 양식의 ID
중간
 medium uri

비디오의 URL-중간 버전
metadata
 metadata object

비디오에 대한 추가 메타데이터
오리지널
 original uri

원본 비디오 파일의 URL
처리
 processed boolean

비디오가 처리되었는지 여부
record_id
 record_id string

연결된 레코드의 ID
작다
 small uri

비디오의 작은 버전에 대한 URL
상태
 status string

비디오의 처리 상태
저장
 stored boolean

비디오가 저장되었는지 여부
thumbnail_huge
 thumbnail_huge uri

거대한 썸네일 이미지에 대한 URL
thumbnail_huge_square
 thumbnail_huge_square uri

거대한 사각형 썸네일 이미지에 대한 URL
thumbnail_large
 thumbnail_large uri

큰 썸네일 이미지의 URL
thumbnail_large_square
 thumbnail_large_square uri

큰 사각형 썸네일 이미지에 대한 URL
thumbnail_medium
 thumbnail_medium uri

URL에서 중간 크기로 축소판 그림 이미지
thumbnail_medium_square
 thumbnail_medium_square uri

URL에서 중간 크기로의 썸네일 이미지
thumbnail_small
 thumbnail_small uri

작은 썸네일 이미지에 대한 URL
thumbnail_small_square
 thumbnail_small_square uri

작은 사각형 썸네일 이미지에 대한 URL
track
 track uri

사용 가능한 경우 JSON 형식의 비디오 트랙 데이터에 대한 URL
updated_at
 updated_at date-time

비디오가 마지막으로 업데이트된 타임스탬프
updated_by
 updated_by string

비디오를 마지막으로 업데이트한 사용자의 표시 이름
updated_by_id
 updated_by_id string

비디오를 마지막으로 업데이트한 사용자의 ID
업로드
 uploaded boolean

비디오가 업로드되었는지 여부
url
 url uri

이 비디오 리소스에 액세스하기 위한 API URL

VideosResponse

Name 경로 형식 Description
current_page
 current_page integer
per_page
 per_page integer
total_count
 total_count integer
전체 페이지
 total_pages integer
videos
 videos array of Video

FulcrumWebhookPayload

Fulcrum의 웹후크 이벤트 페이로드

Name 경로 형식 Description
이벤트 ID
 id string

이벤트의 고유 식별자입니다.
이벤트 유형
 type string

이벤트 유형(예: 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
 owner_id string

이 웹후크를 소유하는 조직의 ID입니다.
이벤트 데이터
 data object

이벤트와 연결된 레코드 또는 리소스 데이터
만든 위치에서
 created_at date-time

이벤트가 발생한 타임스탬프

이진법

기본 데이터 형식 'binary'입니다.