전송처 - kintone
    • PDF

    전송처 - kintone

    • PDF

    기사 요약

    개요

    사이보우스의 kintone으로 데이터를 전송하는 설정 도움말 페이지입니다.

    제약조건

    :::(경고)

    • kintone API의 제약이 있습니다.
    • 전송 설정마다 kintone 측에서 앱을 만들어야 합니다.
      • TROCCO 측에서 자동으로 앱을 생성할 수 없습니다.
    • 전송 모드가 upsert인 경우, 업데이트 키에 빈 레코드가 포함되어 있으면 해당 레코드가 새로 추가됩니다.
      • 전송 대상에 빈 키가 있는 레코드가 존재하더라도 해당 행은 업데이트되지 않습니다.
        :::

    보충 사항

    전송 설정 STEP2의 컬럼 정의에 대해

    전송 설정 STEP2 '컬럼 정의'의 컬럼 이름에 kintone 앱의 필드 코드를 입력하세요.

    설정 항목

    STEP1 기본 설정

    품목명필수내용
    kintone 연결 정보미리 등록되어 있는 kintone의 연결 정보 중 이번 전송 설정에 필요한 권한이 있는 것을 선택합니다.
    앱 ID데이터를 전송할 kintone 앱 ID를 입력합니다.
    앱 ID는 앱 화면의 URL에서 확인할 수 있습니다.
    data-destination-kintone-2024-08-29-5-57-0
    API로 조회하는 경우 kintone API 공식 문서 - 앱 ID 조회 하기를 참고하세요.
    게스트 스페이스 IDNo게스트 공간을 이용하는 경우, 게스트 공간 ID를 입력해 주세요.
    전송 모드전송 모드를 지정합니다.
  • insert: 전송 대상에 레코드를 전송합니다.
  • update: 업데이트 키가 일치하는 레코드를 업데이트합니다.
  • upsert: 업데이트 키가 일치하는 레코드가 있으면 업데이트하고, 그렇지 않으면 새로 레코드를 전송한다.
  • 업데이트 키전송 모드에서 update 또는 upsert를 선택한 경우 입력합니다.
    고유한 값을 가진 필드의 컬럼 이름을 입력하세요.
    레코드 ID를 지정할 수도 있습니다. 이 경우 $id를 입력하세요.
    참고로 업데이트 키는 STEP2 컬럼 정의의 임의의 컬럼 이름과 일치해야 합니다.

    STEP1 세부 설정

    상세 설정을 클릭하면 설정 항목이 표시됩니다.

    품목명기본값내용
    테이블 전송 키----------------------------------------------------------------------------------------------.앱 내 테이블(구: 하위 테이블)로 레코드를 전송할 때 입력합니다.
    자세한 내용은 앱 내 테이블(구: 하위 테이블)을 업데이트하고 싶을 때를 참고하세요.
    한 번의 요청으로 업데이트하는 레코드 수100한 번에 업데이트할 레코드 수를 입력합니다.
    NULL이 포함된 경우 업데이트 처리NULL로 업데이트하기kintone에서 레코드 갱신 시 전송 데이터에 포함된 NULL 값을 어떻게 처리할지 설정할 수 있습니다. 아래에서 선택하세요.
    • NULL로 업데이트하기
      • 전송 데이터에 포함된 NULL 값은 업데이트 대상 kintone의 데이터에 반영됩니다.
    • 업데이트 건너뛰기
      • 전송 데이터에 포함된 NULL 값은 업데이트 대상 kintone의 데이터에 반영되지 않고 원래 값이 유지됩니다.
    단, kintone에 새로 추가되는 레코드에는 본 항목의 설정이 적용되지 않으며, 전송 데이터의 NULL 값은 NULL 값 그대로 추가됩니다.

    STEP2 출력 옵션

    컬럼에 대한 세부적인 설정을 할 수 있습니다.

    항목내용
    칼럼명전송 설정 STEP2 컬럼 정의에서 원하는 컬럼 이름을 입력합니다.
    필드 코드전송할 kintone 앱의 필드 코드를 입력합니다.
    데이터 유형필드의 데이터 유형을 명시적으로 지정하고 싶을 때 선택합니다.
    선택할 수 있는 타입 목록
  • SINGLE_LINE_TEXT
  • MULTI_LINE_TEXT
  • RICH_TEXT
  • NUMBER
  • CHECK_BOX
  • RADIO_BUTTON
  • MULTI_SELECT
  • DROP_DOWN
  • DATE
  • TIME
  • DATETIME
  • LINK
  • SUBTABLE
  • 시간대DATE형 또는 TIME형으로 전송하고 싶을 때 배포 시 사용할 시간대를 입력할 수 있습니다.
    테이블의 행을 정렬하는 컬럼SUBTABLE 타입으로 전송하고 싶은 경우, 테이블(구: 하위 테이블)에 값을 오름차순으로 정렬한 상태로 등록할 수 있습니다.
    자세한 내용은 앱 내 테이블(구: 하위 테이블)을 업데이트하고 싶을 때를 참고하세요.

    앱 내 테이블(구: 하위 테이블)을 업데이트하고 싶은 경우

    앱 내 테이블(이하 서브테이블로 표기)로 레코드를 전송할 수도 있습니다.
    아래에서는 필드를 계층 구조별로 구분하여 설명합니다.

    • 앱 바로 아래 필드
    • 서브 테이블 내 필드

    한 번의 전송으로 앱 바로 아래 필드에 대한 전송 및 하위 테이블 내 필드 업데이트를 일괄적으로 수행할 수 있습니다.

    하위 테이블로의 전송에 대한 제약
    • 전송 모드에서 update나``upsert를 선택하더라도 하위 테이블로의 데이터 전송은 항상 재전송이 됩니다.
      즉, 기존 하위 테이블의 레코드는 전송할 때마다 새로 전송된 데이터로 대체된다.
    • 앱 바로 아래 필드에 고유한 값으로 구성된 필드가 하나 이상 존재해야 합니다.

    2차원 테이블을 이용한 서브 테이블 업데이트

    준비할 전송 데이터

    서브테이블 내 필드 레코드가 최소 단위가 되는 형태로 앱 바로 아래 필드 값이 평탄화되어 결합된 테이블을 준비합니다.
    구체적인 예를 들어 설명하겠습니다.

    • 앱 바로 아래: 안건 ID, 회사명이라는 필드가 존재함.
    • 하위 테이블: 활동 이력이라는 하위 테이블에 활동 날짜, 활동 내용이라는 필드가 존재합니다.

    이러한 경우 아래와 같은 4열의 테이블을 준비합니다.
    전송 데이터에는 서브테이블 자체에 대한 요소(위 예시에서의 활동 이력 )를 포함할 필요는 없습니다.

    data-destination-kintone-2024-08-29-5-57-1

    전송 설정 STEP1 상세 설정의 테이블 전송 키

    고유값으로 구성된 앱 바로 아래 필드에 해당 컬럼 이름을 입력합니다.
    여기서 지정된 컬럼의 값에 따라 하위 테이블의 레코드가 그룹화됩니다.
    참고로 이 부분에 입력한 값은 다음 단계에서 설정하는 컬럼 정의의 임의의 컬럼 이름과 일치해야 합니다.

    data-destination-kintone-2024-08-29-5-57-2

    전송 설정 STEP2 컬럼 정의

    컬럼 이름을 각각 아래와 같이 입력합니다.

    • 앱 바로 아래 필드: 해당 필드의 필드 코드
    • 하위 테이블의 필드: " 서브 테이블의 필드 코드. 하위 테이블 내 필드의 필드 코드 "
      • . 를 포함하여 입력해야 합니다.

    data-destination-kintone-2024-08-29-5-57-3

    전송 설정 STEP2 출력 옵션의 컬럼 설정

    컬럼 설정을 추가하여 필드별로 데이터 유형을 명시적으로 지정할 수 있습니다.
    컬럼 이름에는전송 설정 STEP2의 컬럼 정의에서 지정한 컬럼 이름을 입력하세요.
    단, 서브테이블 내 필드의 경우 . 를 포함하여 입력해야 합니다.

    또한, 하위 테이블에 대해 어떤 필드의 값을 기준으로 오름차순으로 정렬하여 데이터를 전송할 수도 있습니다.
    정렬하여 전송하고 싶다면 아래와 같이 컬럼 설정을 추가해 주세요.

    • 컬럼 이름: 전송 설정 STEP2의 컬럼 정의에서 지정한 서브테이블 내 필드에서 컬럼 이름의 ' 서브테이블 필드 코드 ' 부분( . 앞부분)을 입력한다.
    • 필드 코드: 해당 하위 테이블의 필드 코드를 입력하세요.
    • 데이터 유형: SUBTABLE을 선택해 주세요.
    • 테이블의 행을 정렬할 컬럼: 임의의 하위 테이블 내 필드의 필드 코드를 입력하세요.
      • 이 부분에서는 " 하위 테이블의 필드 코드." ( . 의 앞부분) 부분을 입력할 필요가 없습니다.

    data-destination-kintone-2024-08-29-5-57-4

    위 설정에 따라 전송 작업을 실행하면 아래와 같이 데이터가 전송됩니다.

    data-destination-kintone-2024-08-29-5-57-5

    안건 ID가 1인 내용을 확인하면 하위 테이블도 업데이트된 것을 확인할 수 있습니다.

    data-destination-kintone-2024-08-29-5-57-6


    이 문서가 도움이 되었습니까?