사용법 및 예제

항목 목록 웹 확장에는 핵심 기능에 대한 매개 변수와 콘텐츠를 사용자 지정하기 위한 추가 매개 변수가 있습니다.

기본 매개 변수는 다음과 같습니다.

  • 항목 키: 추가 처리를 위한 항목 및 작업의 고유한 이름을 포함하는 셀 범위에 대한 참조입니다. 작업이 트리거되면 Actions.Input.Text가 다음 값 중 하나를 보냅니다.
    • Actions.Input.Text="Row": 항목을 선택합니다.
    • Actions.Input.Text="Edit": [편집] 단추가 클릭되었습니다.
    • Actions.Input.Text="Delete": [삭제] 단추가 클릭되었습니다.
  • 항목 데이터: 항목 데이터를 포함하는 셀 범위 또는 동일한 데이터의 XML을 포함하는 셀에 대한 참조입니다. 데이터 범위의 첫 번째 열은 항목 키의 다음과 같은 선택적 속성을 위해 예약되어 있습니다.
  • 제목(문자열)
  • 설명 1(문자열)
  • 설명 2(문자열)
  • 타임스탬프(문자열)
  • 표시(부울): False이면 항목을 숨깁니다. True가 기본값입니다.
  • 사용(부울): False이면 항목이 비활성화됩니다. True가 기본값입니다.
  • 선택됨(부울): True이면 항목을 선택합니다. False가 기본값입니다.
  • 편집(부울): True이면 인라인 편집 및 삭제 아이콘이 표시됩니다. False가 기본값입니다.
이러한 추가 매개 변수를 사용하면 콘텐츠를 사용자 지정할 수 있습니다. 가능한 경우 기본값을 사용하려면 =""를 지정합니다.
참고

오류 메시지와 같이 텍스트를 지정할 수 있는 경우 TRANSLATEUNIQUESTRING 함수를 사용하여 사용자 인터페이스의 언어가 변경되면 텍스트가 번역되도록 합니다.

  • 다중 선택: True이면 다중 선택이 사용하도록 설정됩니다. False가 기본값입니다.
  • 검색 상자 자리 표시자: 기본적으로 검색 상자는 표시되고 비어 있습니다. 확인란을 사용하지 않도록 설정하려면 False를 지정합니다.
  • 오류 메시지: 기본적으로 목록 항목이 없는 경우 오류 메시지는 “사용 가능한 항목 없음”입니다.
  • 기본 제목: 목록의 제목입니다. 기본적으로 제목이 표시되지 않습니다.
  • 기본 제목 색상: 제목의 기본 색상은 #368ac0입니다.
  • 제목 색상: 제목 글꼴의 기본 색상은 #1a1a1a입니다.
  • 선택한 색상: 선택한 행이 강조 표시되는 색상입니다. 기본 값은 #c8e9f4입니다.
  • 선택한 항목 텍스트: 기본적으로 텍스트는 “선택됨”입니다. 이 매개 변수는 다중 선택이 활성화된 경우에만 적용할 수 있습니다.
  • 작업 제거: [제거] 단추를 클릭할 때 트리거되는 셀에 대한 작업을 정의합니다. 기본 텍스트는 “제거”입니다. 이 매개 변수는 다중 선택이 활성화된 경우에만 적용할 수 있습니다.
  • 측면 테두리 숨기기: 행의 왼쪽 및 오른쪽 테두리를 숨기려면 True를 지정합니다. 기본적으로 테두리가 표시됩니다.
  • 테두리 색: 기본적으로 테두리의 색상은 #d8d8d8입니다.
  1. Application Studio 보고서를 만듭니다.
  2. 이 샘플 데이터를 B8:H12 범위에 삽입합니다.
    제목 설명1 설명2 사용 선택됨 편집
    a 항목 A 설명 A FALSE TRUE
    b 항목 B 설명 B 세부 정보 B FALSE FALSE FALSE
    c 항목 C 설명 C TRUE FALSE
    d 항목 D 설명 D FALSE FALSE
  3. 이름이 rv_SelectedItem인 보고서 변수를 만들고 c를 변수 및 기본값으로 지정합니다. 변수 속성에서 [영구적임] 옵션의 값으로 False를 지정합니다.
  4. G9 셀에 =ReportVariables.rv_SelectedItem.Text=B9를 지정합니다. 수식을 G10, G11 및 G12 셀에 복사합니다.
    이 업데이트 후에 셀은 원래 텍스트를 유지합니다.
  5. 각 키 셀(B9, B10, B11 및 B12)에서 다음 특성을 갖는 작업을 만듭니다.
    작업: 유형
    매개 변수 설정을 작업 유형으로 선택합니다.
    작업: 모드
    모드로 웹 확장을 선택합니다.
    작업: 조건
    =Actions.Input.Text="ROW"를 지정합니다.
    참고

    이 조건은 작업 모드가 웹 확장인 경우를 제외하고 유효하지 않습니다.

    매개 변수: 이름
    [매개 변수 추가]를 클릭하고 rv_SelectedItem 변수를 선택합니다.
    매개 변수: 속성
    선택한 Value(.Text)를 지정합니다.
    매개 변수: 값
    B9의 작업에 대해 =B9를 지정합니다. 다른 작업의 경우 각각 =B10, =B11=B12를 지정합니다.
  6. 이름이 rv_TitleItemA인 보고서 변수를 만들고 항목 A를 해당 값으로 지정합니다. 변수 속성에서 항목 A를 기본값으로 지정하고 [영구적임] 옵션의 값으로 False를 선택합니다.
  7. C9 셀에 =ReportVariables.rv_TitleItemA.Text를 지정하고 [Enter] 키를 누릅니다.
    이 업데이트 후에 셀은 원래 텍스트를 유지합니다.
  8. B9 셀에서 다음 특성을 사용하여 작업을 만듭니다.
    작업: 유형
    매개 변수 설정을 작업 유형으로 선택합니다.
    작업: 모드
    모드로 웹 확장을 선택합니다.
    작업: 조건
    =Actions.Input.Text="EDIT"를 지정합니다.
    참고

    이 조건은 작업 모드가 웹 확장인 경우를 제외하고 유효하지 않습니다.

    매개 변수: 이름
    [매개 변수 추가]를 클릭하고 rv_TitleItemA 변수를 선택합니다.
    매개 변수: 속성
    Value(.Text)를 선택합니다.
    매개 변수: 값
    ="Edited Item A"를 지정합니다.
  9. B13 셀에 다음 SETPROPERTY 수식을 지정합니다.
    =SETPROPERTY("",B9:B12,C8,C9:C12,D8,D9:D12,E8,E9:E12,F8,F9:F12,G8,G9:G12,H8,H9:H12)
  10. 개체 도구 모음에서 [웹 확장]을 클릭하고 항목 목록 웹 확장을 두 번 클릭합니다.
    커서가 십자선으로 바뀝니다.
  11. 커서를 끌어서 웹 확장을 삽입하고 크기 및 위치를 지정합니다.
  12. 다음 매개 변수를 지정합니다.
    고유 이름
    목록 항목의 고유한 이름을 포함하는 셀 범위를 지정합니다. 이 예제에서는 =B9:B12를 지정합니다.
    항목 데이터
    확장에 대한 데이터 테이블을 정의하는 셀 범위를 지정합니다. 이 예제에서는 =B13을 지정합니다.
  13. 선택 사항으로 이러한 매개 변수의 값을 지정하거나 =""를 지정하여 기본값을 사용합니다.
    기본 제목
    기본적으로 목록에는 제목이 없습니다. 선택 사항으로 제목을 지정합니다.
    기본 제목 글꼴 색상
    기본 제목이 지정되면 기본 색상은 파란색(#368ac0)입니다. 선택 사항으로 다른 색상 값을 지정합니다.
    검색 상자 자리 표시자
    기본적으로 검색 상자는 비어 있습니다. 선택 사항으로 상자에 표시할 텍스트를 지정합니다. 검색 상자를 숨기려면 FALSE(대/소문자 구분)를 지정합니다.
    오류 메시지
    기본적으로 사용 가능한 항목이 없으면 오류가 표시되지 않습니다. 선택 사항으로 오류 메시지를 지정합니다. UI 언어가 변경된 경우 편리하게 오류를 번역하려면 TRANSLATESTRING을 사용합니다.
    제목 글꼴 색상
    기본적으로 목록 항목의 제목은 짙은 회색(#1a1a1a)입니다. 선택 사항으로 다른 색 값을 지정합니다.
    선택한 색상
    선택한 목록 항목이 강조 표시되는 색상을 지정합니다. 기본값은 연한 파란색(#c8e9f4)입니다. 선택 사항으로 다른 색상 값을 지정합니다.
    다중 선택
    기본적으로 단일 항목만 선택할 수 있습니다. 여러 항목을 선택할 수 있는 확인란을 사용하도록 설정하려면 =”TRUE”를 지정합니다.
    측면 테두리 숨기기
    기본적으로 각 행에는 왼쪽 및 오른쪽 테두리가 있습니다. 이러한 테두리를 숨기려면 "=TRUE"를 지정합니다.
    테두리 색
    기본적으로 목록의 맨 위와 옆쪽 테두리는 연한 회색(#d8d8d8)입니다. 선택 사항으로 다른 색상 값을 지정합니다.
    선택한 항목 텍스트
    다중 선택이 사용하도록 설정된 경우 선택한 항목의 수가 표시된 후 Selected가 표시됩니다. 선택 사항으로 다른 텍스트를 지정합니다. UI 언어가 변경된 경우 편리하게 텍스트를 번역하려면 TRANSLATESTRINGUNIQUE를 사용합니다.
    작업 표시줄 제거 단추

    다중 선택을 사용하도록 설정하면 제거 단추를 표시하여 선택한 항목의 선택을 취소할 수 있습니다. 제거라는 단어가 포함된 셀의 참조를 지정합니다.

    UI 언어가 변경된 경우 편리하게 단추를 번역하려면 TRANSLATESTRING을 사용합니다.