--- title: "기능 모범 사례" slug: "functions-best-practices" updated: 2026-10-22T11:28:33Z published: 2026-10-22T11:28:33Z canonical: "support.tulip.co/functions-best-practices" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # 기능 모범 사례 Who can use Functions As of r380, Functions is generally available. **Read more in the [Community thread](https://community.tulip.co/t/functions-production-release-available-for-early-access/15658).** --- ## 테이블에 데이터를 기록하려면 Functions를 사용하세요 ### 권장 접근 방식 여러 앱이나 앱 단계가 동일한 테이블에 데이터를 기록하거나 다음 사항을 적용해야 할 때 함수를 생성하십시오: - 필수 입력 항목 - 유효한 값(예: 상태가 승인된 목록에 포함되어야 함) - 일관된 메타데이터(작성자, 작성 일시) **이것이 중요한 이유** 시민 개발자가 트리거 내에서 직접 테이블 레코드를 생성할 경우 다음과 같은 문제가 발생할 수 있습니다: - ID 명명 규칙을 따르지 않을 수 있음 - 필수 필드를 누락할 수 있음 - 필드 값을 잘못 입력할 수 있습니다("in progress" 대 "in-progress") - 메타데이터를 일관성 없이 입력할 수 있음 함수를 사용하면 동일한 스키마를 강제 적용하여 이러한 오류를 방지할 수 있습니다. **예시** 각 앱 개발자가 필드와 내용이 일관되지 않은 “샘플” 레코드를 생성하도록 내버려 두지 말고, 다음과 같은 기능을 가진 **‘샘플 생성’** 함수를 만드세요: - 일관된 입력값(작업 ID, 샘플 유형, 수량, 타임스탬프, 사용자, 앱 이름)을 요구합니다. - 샘플 유형이 승인된 목록에 포함되어 있는지 검증 **함수**:**CreateSample입력값:** - job_id (텍스트) - sample_type (텍스트) - quantity (숫자) - app name (텍스트) - user requesting (사용자) **논리**: 1. sample_type이 ["A", "B", "C"]에 포함되는지 유효성 검사 2. 유효하지 않은 경우 오류 메시지 반환 3. 다음 내용을 포함하여 테이블 레코드를 생성합니다: - ID: 함수 내에서 생성 - 작업 ID: 입력값 - 샘플 유형: 입력값 - 수량: 입력값 - 로트 번호: 입력값 (제공되지 않은 경우 비워 둠) - 작성자: 입력값 4. 성공 메시지를 반환합니다 **출력**: - 상태 (텍스트): "성공" 또는 "오류" - 메시지 (텍스트): 실패 시 오류 설명 시료에 대한 테이블 레코드를 생성해야 할 때는 입력값을 함수에 전달하면, 함수가 나머지 작업을 처리합니다. ### 피해야 할 패턴 간단한 작업이라 할지라도 테이블 쓰기 작업마다 함수를 생성하지 마십시오. **이것이 문제를 일으키는 이유** - 함수가 무분별하게 늘어납니다(수백 개의 일회용 함수). - 단순한 쓰기 작업에 별다른 이점 없이 복잡성만 증가시킵니다 - 디버깅이 더 어려워집니다(확인해야 할 부분이 많아짐). **테이블 쓰기 시 함수 사용을 피해야 하는 경우** - 기존 테이블 레코드 업데이트(예: 상태 업데이트 또는 수량 감소) - 단일 앱에서 테이블에 데이터를 기록하는 경우 - 필수적인 거버넌스나 유효성 검증이 필요하지 않은 경우 ## 반복적인 다단계 로직에는 함수를 사용하십시오 ### 권장 접근 방식 여러 앱에 걸쳐 여러 단계에서 동일한 트리거 작업 순서가 발생하는 경우, 이를 함수로 추출하십시오. **예: 라벨 인쇄용 ZPL 코드 가져오기** **함수**: ZPL**코드** 가져오기**입력**: - 자재 ID (텍스트) **변수**: - ZPL 코드 변수 (텍스트) **출력**: - ZPL 코드 (텍스트) **논리**: 1. 데이터 업데이트: 구성 'ZPL 코드 변수' - [@Inputs.자재 ID를 포함한 ZPL 코드 표현식]으로 설정 2. 반환: 'ZPL 코드' 데이터 소스 'ZPL 코드 변수' ### 피해야 할 패턴 모든 앱을 통틀어 총 1~2회만 발생하는 논리를 위한 함수는 생성하지 마십시오. **이것이 문제를 일으키는 이유** - 함수 관리에 드는 오버헤드가 이점을 상회합니다 - 앱 개발자가 드문 경우를 위해 함수 인터페이스를 익혀야만 합니다. - 함수와 앱 간 전환으로 인해 디버깅이 더 어려워집니다 ## 커넥터 함수를 함수에 내장하십시오 ### 권장 접근 방식 커넥터 함수를 사용할 때는 해당 커넥터 함수의 입력값을 커넥터 함수를 호출하는 함수로 전달하십시오. 그러면 해당 함수에서 타임아웃 재시도 및 오류 처리를 보다 쉽고 중앙 집중화된 방식으로 처리할 수 있어, 솔루션 전반에 걸쳐 앱 로직을 단순화할 수 있습니다. 커넥터 함수를 함수에 내장하면 개별 앱에 적용해야 할 변경 사항을 줄여, 향후 ERP 마이그레이션 시 발생할 수 있는 작업량을 최소화할 수도 있습니다. **예시** **함수**:**주문** 업데이트(Update Process Order)**입력**: - 주문 ID (텍스트) - 상태 (텍스트) **출력**: - 오류 메시지 (텍스트) **변수**: - HTTP 코드 (정수) - 타임아웃 재시도 횟수 (정수) - 오류 메시지 (텍스트) **논리**: 1. 커넥터 함수 실행 2. HTTP 코드가 성공인 경우, 함수 종료 3. HTTP 코드가 타임아웃이고 ‘타임아웃 재시도 횟수’가 지정된 값 이하인 경우, ‘타임아웃 재시도 횟수’를 증가시키고 ‘커넥터 함수 실행’으로 돌아갑니다. 4. HTTP 코드가 함수 논리로 해결할 수 없는 코드인 경우, ‘오류 메시지’ 출력에 유용한 메시지를 반환합니다. ## 개별 테이블 레코드 필드가 아닌 레코드 ID를 전달하십시오 ### 권장 접근 방식 함수에서 테이블 레코드의 데이터가 필요한 경우, 레코드 ID를 전달하고 함수 내에서 레코드를 불러오십시오. **예** 다음 예제는 논리적으로는 정확하지만(여기서 ‘주문 ID’는 Orders 테이블의 ID이고 다른 필드는 해당 테이블의 열입니다), 더 간단한 구성 방법이 있습니다. **함수**:**주문** 처리**입력값**: - 주문 ID (텍스트) - 고객 이름 (텍스트) - 제품 ID (텍스트) - 수량 (숫자) - 마감일 (날짜/시간) - 우선순위 (텍스트) **논리**: 1. [입력 필드를 사용하여 논리 처리] 아래 예제는 최소한의 입력값만 사용하여 동일한 결과를 얻습니다: **함수**:**주문** 처리입력 항목: - 주문 ID (텍스트) **논리**: 1. 테이블 레코드 가져오기: ID가 '주문 ID' 입력값과 일치하는 Orders 테이블 2. [테이블 레코드 필드를 사용하여 논리 처리] **두 번째 예시가 더 나은 접근 방식인 이유:** - 입력 항목이 적음 (6개 이상 대신 1개) - 테이블 스키마가 변경되더라도 함수를 쉽게 조정할 수 있음 - 앱 내 함수 호출이 더 깔끔해짐 - 잘못된 필드를 잘못된 입력에 매핑할 가능성이 줄어듦 ## 함수와 입력 매개변수의 이름을 일관되게 지정하고 설명 ### 권장 접근 방식 워크스페이스 내 모든 함수에 걸쳐 일관된 명명 규칙을 사용하십시오. **함수 이름** - 동사 + 명사 형식 사용: 샘플 생성, 작업 상태 업데이트, 일련번호 유효성 검사 - 명사만 사용하지 마십시오: Sample, Job, Serial Number **함수 설명** - 함수가 수행하는 작업에 대해 직관적인 설명을 작성하십시오. 예를 들어, "Create Defect"라는 함수의 경우, "Defects 테이블에 상태가 OPEN인 새 레코드를 생성합니다"와 같은 설명을 작성하십시오. **입력 항목 이름** - 일관된 용어를 사용하십시오: 항상 ‘작업 지시서 ID’를 사용하십시오(‘주문 ID’나 ‘Work_id’를 혼용하지 마십시오). - 가능한 경우 테이블 필드 이름과 일치시켜야 합니다 **논리 블록 이름** - 명확하게 표현하십시오: “Get Table Record” 대신 “Get Job Record” - 나중에 이 코드를 읽을 사람을 위해: “값 확인” 대신 “샘플 유형 유효성 검사” **이것이 중요한 이유** - 앱 개발자가 함수의 목적을 빠르게 파악할 수 있습니다 - 여러 함수를 사용할 때 인지적 부담을 줄여줍니다 - “사용 위치” 분석을 더 쉽게 할 수 있게 됨 - 문서화 및 교육의 질을 높입니다 ## 입력 유효성 검사 및 사용자 오류 메시지를 원활하게 처리 ### 권장 접근 방식 항상 함수 입력값을 필수 입력 항목으로 지정하고, 적절한 경우 입력 유효성 검사 규칙을 사용하십시오. 함수 내에서 입력값의 유효성을 검사하지 마십시오. **이것이 중요한 이유** - 앱 사용자는 값을 입력할 때 명확한 피드백을 받습니다 - 앱에서 입력 유효성 검사를 처리하고, 함수는 유효성이 확인된 입력값으로만 실행되도록 함으로써 함수 로직을 단순화합니다 - 잘못된 입력으로 인한 데이터 손상을 방지합니다 ### 피해야 할 패턴 함수 내에서 입력 값을 검증하지 마십시오. **이것이 문제를 일으키는 이유** - 앱 편집기에서 제공하는 입력 유효성 검사 기능과 중복됩니다 - 함수 내에서 입력의 유효성을 재확인하는 과정에서 불필요한 지연이 발생합니다 NOTE App builders can bypass the system by passing blank static values in function inputs. For functions where validated data is critical, it may be best practice to validate inputs in the function itself (in addition to marking required fields in the app). ## 루프 내 테이블 쿼리를 최소화하십시오 함수가 배열을 순회하는 경우, 각 반복마다 테이블을 쿼리하지 마십시오. 대신, 루프 시작 전에 한 번 쿼리를 실행하고 그 결과를 참조하십시오. ## 단순 참조가 아닌 논리 처리를 위해 함수를 사용하십시오 단일 테이블 레코드만 가져오는 함수는 만들지 마십시오. 이는 record placeholders 의 용도입니다. 함수는 데이터를 변환하는 논리를 처리하는 데만 사용하십시오. ## 출력 크기 제한 함수가 큰 객체나 배열을 반환하는 경우, 전체 객체 배열이 아닌 애플리케이션에 필요한 필드만 반환하는 것을 고려하십시오. --- ## 추가 자료 {{snippet.원하는 정보를 찾으셨나요?}}