에어테이블

ssemworks-microservice-base.airtable

통신/외부외부 서비스

Airtable 테이블의 레코드를 생성(create)/단건 조회(get)/검색(search)/부분 갱신(update)/삭제(deleteRecord)한다. PAT(Personal Access Token) Bearer 인증 — 발급 시 access 목록에 대상 베이스 추가 필수.

입출력 포트

입력

에어테이블

airtable

데이터

데이터(main)

다이어그램 설명

입력: 메인 1개.
출력 포트 1개 — 결과 아이템이 다음 마이크로서비스로 전달됩니다.
색 규약 — 실선/파랑은 데이터(main) 흐름, 점선/색상 포트는 AI 서브마이크로서비스 연결(ai_*)입니다.

기본 정보

항목	값
서비스 타입	`ssemworks-microservice-base.airtable`
표시 이름	에어테이블
카테고리	통신/외부
그룹	`input, output`
버전	`1,2,2.1,2.2`

자격증명

이름	필수
`airtableTokenApi`	예

입출력

입력: 메인(main)
출력: 메인(main)

파라미터

파라미터	이름	타입	기본값	설명
작업	`operation`	선택	`get`	수행할 작업 선택지: 단건 조회(`get`) · 검색·목록(`search`) · 생성(`create`) · 부분 갱신(`update`) · 삭제(`deleteRecord`)
베이스 (base)	`base`	문자열	`""`	베이스 ID(app…) 또는 Airtable URL(https://airtable.com/app…/tbl…). n8n resourceLocator 형태도 수용. 표현식 사용 가능 필수
테이블 (table)	`table`	문자열	`""`	테이블 ID(tbl…) 또는 테이블 이름(Airtable API 가 둘 다 수용). URL 이면 tbl… 추출. 표현식 사용 가능 필수
레코드 ID (id)	`id`	문자열	`""`	대상 레코드 ID(rec…). update 는 비워두면 매핑 값의 id 필드를 폴백으로 사용. 표현식 사용 가능 표시 조건: `operation = "get" 또는 "update" 또는 "deleteRecord"`
데이터 입력 방식	`dataMode`	선택	`autoMapInputData`	기록할 필드 값을 어디서 가져올지 선택지: 입력 데이터 자동 매핑(`autoMapInputData`) · 아래에서 지정(`defineBelow`) 표시 조건: `operation = "create" 또는 "update"`
설정할 값	`fieldsToSet`	고정 컬렉션	`{}`	생성/갱신 시 필드에 기록할 값 표시 조건: `operation = "create" 또는 "update", dataMode = "defineBelow"`
필터 수식 (filterByFormula)	`filterByFormula`	문자열	`""`	Airtable formula 문법 필터. 비우면 전체. 표현식 사용 가능 표시 조건: `operation = "search"`
최대 레코드 수 (maxRecords)	`maxRecords`	숫자	`100`	반환할 최대 레코드 수(기본 100). offset 페이지네이션은 자동 추적. n8n returnAll=true/limit 형태도 수용(전체 조회 안전 상한 10,000) 표시 조건: `operation = "search"`
정렬 (sort)	`sort`	고정 컬렉션	`{}`	정렬 필드/방향 (다중 지정 가능) 표시 조건: `operation = "search"`
옵션	`options`	컬렉션	`{}`	표시 조건: `operation = "create" 또는 "update"`

ℹ️ PAT 인증: 토큰이 유효해도 PAT 의 access 목록에 없는 베이스는 Airtable 이 403/404 를 반환합니다. 토큰 설정(airtable.com/create/tokens)에서 대상 베이스를 access 에 추가하고 data.records:read/write 스코프를 부여하세요.

설정할 값 › 값 하위 필드

파라미터	이름	타입	기본값	설명
필드 이름	`fieldName`	문자열	`""`	Airtable 필드 이름(라벨) 또는 필드 ID(fld…)
값	`value`	문자열	`""`	기록할 값. 표현식 사용 가능 (={{ $json.필드 }})

정렬 (sort) › 정렬 기준 하위 필드

파라미터	이름	타입	기본값	설명
필드	`field`	문자열	`""`	정렬할 Airtable 필드 이름
방향	`direction`	선택	`asc`	선택지: 오름차순(`asc`) · 내림차순(`desc`)

옵션 하위 필드

파라미터	이름	타입	기본값	설명
타입캐스트 (typecast)	`typecast`	불리언	`true`	문자열 값을 셀렉트 옵션/링크드 레코드로 자동 변환(미존재 셀렉트 옵션 자동 생성). 기본 true — n8n 기본(false)과 다름
제외할 입력 필드 (ignoreFields)	`ignoreFields`	문자열	`""`	자동 매핑 시 제외할 입력 json 키(쉼표 구분)

기본 정보​

자격증명​

입출력​

파라미터​

설정할 값 › 값 하위 필드​

정렬 (sort) › 정렬 기준 하위 필드​

옵션 하위 필드​