KoboToolbox 노드 문서

n8n에서 KoboToolbox 노드를 사용하는 방법을 알아보세요. 기술 문서를 통해 KoboToolbox 노드를 워크플로에 통합합니다.

KoboToolbox 노드를 사용하여 KoboToolbox에서의 작업을 자동화하고, KoboToolbox를 다른 애플리케이션과 통합합니다. n8n은 파일, 폼, 훅 및 제출물 생성, 업데이트, 삭제 및 가져오기를 포함한 광범위한 KoboToolbox 기능을 기본으로 지원합니다. 이 페이지에서 KoboToolbox 노드가 지원하는 작업 목록과 추가 리소스 링크를 확인할 수 있습니다. 자격 증명 인증 설정에 대한 안내는 KoboToolbox 자격 증명 을 참조하세요. 작업 # 파일 생성 삭제 가져오기 여러 개 가져오기 폼 가져오기 여러 개 가져오기 재배포 훅 가져오기 여러 개 가져오기 로그 모두 재시도 하나 재시도 제출물 삭제 가져오기 여러 개 가져오기 유효성 검사 상태 가져오기 유효성 검사 상태 업데이트 템플릿 및 예제 # 이 노드의 워크플로 템플릿은 n8n 워크플로 템플릿 갤러리 에서 확인할 수 있습니다. 옵션 # 쿼리 옵션 # 제출물 쿼리 작업은 쿼리 옵션을 지원합니다: 매개변수 패널의 주요 섹션에서: Start 는 쿼리를 시작할 인덱스 오프셋을 제어합니다 (API 페이지네이션 로직 사용을 위해). Limit 은 반환할 최대 레코드 수를 설정합니다. API는 사용자가 제공하는 값에 관계없이 항상 30,000개의 반환 레코드로 제한됩니다. 쿼리 옵션 섹션에서 다음 매개변수를 활성화할 수 있습니다: Query 를 사용하면 MongoDB의 JSON 쿼리 형식으로 필터 술어를 지정할 수 있습니다. 예를 들어: {"status": "success", "_submission_time": {"$lt": "2021-11-01T01:02:03"}} 는 status 필드에 success 값이 있고 2021년 11월 1일 01:02:03 이전에 제출된 모든 제출물을 쿼리합니다. Fields 를 사용하면 응답을 더 가볍게 만들기 위해 가져올 필드 목록을 지정할 수 있습니다. Sort 를 사용하면 MongoDB JSON 형식으로 정렬 기준 목록을 제공할 수 있습니다. 예를 들어, {"status": 1, "_submission_time": -1} 은 오름차순 상태, 그 다음 내림차순 제출 시간으로 정렬을 지정합니다. 이 옵션에 대한 자세한 내용은 Formhub API 문서 에서 확인할 수 있습니다. 제출물 옵션 # 폼 제출 데이터를 반환하는 모든 작업은 응답을 조정하는 옵션을 제공합니다. 다음이 포함됩니다: 다운로드 옵션을 사용하면 사진 및 동영상과 같이 각 폼 제출에 연결된 모든 첨부 파일을 다운로드할 수 있습니다. 이름 패턴과 다운로드할 파일 크기(사용 가능한 경우 - 일반적으로 이미지의 경우)도 선택할 수 있습니다. 형식 옵션은 재형식화 정보 에 설명된 대로 재형식화를 수행합니다. 재형식화 정보 # KoboToolbox 제출 데이터의 기본 JSON 형식은 스키마를 인식하지 못하고 모든 필드가 문자열로 반환되기 때문에 처리하기 어려울 때가 있습니다. 이 노드는 모든 폼 제출을 반환하는 작업(제출물 쿼리, 가져오기 및 첨부 파일 다운로드 작업)에서 사용 가