Fusion의 키 기반 표 제출 함수

Core 제출 함수는 레이블이 있는 버튼을 만들고 클릭할 때 다른 표 영역으로 값을 제출합니다. timestamp를 기록하는 형태와 클릭 시점에 값을 계산하는 lazy 형태가 있습니다.

대상은 Fusion 문서와 그 안의 표 영역입니다. 제출할 시트의 편집 권한이 필요하며, 대상이 데이터셋에 동기화되어 있으면 최신 변경을 빌드할 데이터셋 편집 권한도 필요합니다. 키가 이미 있으면 행을 갱신하고 없으면 삽입하는 제출 흐름은 액션 제출과 같습니다.

공통 인수

인수	자료형과 의미
button_label	String. 버튼에 표시할 문자열
document_identifier	String. 대상 Fusion 문서 RID. 문서 URL의 ri.fusion.main... 식별자
region_name	String. 값을 받을 표 영역 이름. 대상 시트에서 미리 생성
should_submit	Any. true인 셀 또는 행을 제출할 Boolean 값/참조
key_column	String. 고유 키 값을 저장할 대상 열. 키 값은 고유해야 함
key_value	Any. 키로 제출할 셀 또는 범위
column, value	String 열 이름과 Any 값의 반복 쌍
timestamp_column	String. timestamp 형태에서 현재 시각을 기록할 대상 열

추가 열과 값의 쌍은 필요한 만큼 지정할 수 있습니다. 대상에 제출할 순서대로 인수 쌍을 나열합니다.

아래 예시는 현재 문서에 submit_table이라는 표 영역을 만들고 key_column과 value_column 열을 준비한 경우입니다. timestamp 예시에는 time 열도 필요합니다. 실제 대상이 다른 문서라면 document_metadata('document_identifier') 대신 그 문서의 RID를 사용합니다.

기본 키 제출

submit_to_region_with_key(
  button_label: string,
  document_identifier: string,
  region_name: string,
  should_submit: any,
  key_column: string,
  key_value: any,
  [column: string, value: any, ...]
): string

다음 버튼은 A2:A10과 B2:B10을 각각 key_column과 value_column에 제출합니다.

=submit_to_region_with_key(
  'Submit!', document_metadata('document_identifier'), 'submit_table', true,
  'key_column', A2:A10, 'value_column', B2:B10
)

현재 시각도 기록

submit_to_region_with_key_and_timestamp(
  button_label: string,
  document_identifier: string,
  region_name: string,
  should_submit: any,
  timestamp_column: string,
  key_column: string,
  key_value: any,
  [column: string, value: any, ...]
): string

지정한 키와 값에 더해 timestamp_column에 현재 시각을 기록합니다.

=submit_to_region_with_key_and_timestamp(
  'Submit!', document_metadata('document_identifier'), 'submit_table', true,
  'time', 'key_column', A2:A10, 'value_column', B2:B10
)

클릭 시점의 값으로 제출

submit_to_region_with_key_lazy(
  button_label: string,
  document_identifier: string,
  region_name: string,
  should_submit: any,
  key_column: string,
  key_value: any,
  [column: string, value: any, ...]
): string

기본 키 제출과 같지만 값을 클릭 시점에 계산하고 대상 표 영역 정보를 캐시합니다. 큰 범위를 제출하거나 같은 영역에 연속해서 제출할 때 사용할 수 있습니다.

=submit_to_region_with_key_lazy(
  'Submit!', document_metadata('document_identifier'), 'submit_table', true,
  'key_column', A2:A10, 'value_column', B2:B10
)

이 형태에는 timestamp_column 인수가 없습니다.

클릭 시점 계산과 시각 기록

submit_to_region_with_key_and_timestamp_lazy(
  button_label: string,
  document_identifier: string,
  region_name: string,
  should_submit: any,
  timestamp_column: string,
  key_column: string,
  key_value: any,
  [column: string, value: any, ...]
): string

클릭 시점에 제출값을 계산하고 대상 영역 정보를 캐시하면서 현재 timestamp도 기록합니다.

=submit_to_region_with_key_and_timestamp_lazy(
  'Submit!', document_metadata('document_identifier'), 'submit_table', true,
  'time', 'key_column', A2:A10, 'value_column', B2:B10
)