Amazon Connect의 흐름 블록: 데이터 테이블 - Amazon Connect
설명사용 사례지원 채널흐름 유형구성 개요데이터 테이블 값 평가데이터 테이블 값 나열데이터 테이블에 쓰기구성된 블록

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Amazon Connect의 흐름 블록: 데이터 테이블

설명

Amazon Connect의 데이터 테이블 블록을 사용하면 고객 응대 흐름 내의 데이터 테이블에서 데이터를 평가, 나열 또는 쓸 수 있습니다. 이 블록은 Amazon Connect 데이터 테이블에 저장된 구조화된 데이터와 상호 작용하여 동적 의사 결정, 맞춤형 고객 경험 및 데이터 관리를 용이하게 합니다.

사용 사례

데이터 테이블 블록은 다음과 같은 경우에 유용합니다.

  • 구성 검색 - 데이터 테이블에 저장된 비즈니스 규칙, 라우팅 파라미터 또는 운영 설정에 액세스합니다.

  • 동적 라우팅 결정 - 데이터 테이블을 쿼리하여 고객 속성을 기반으로 적절한 대기열, 에이전트 또는 흐름 경로를 결정합니다.

  • 상태 확인 - 특정 작업을 진행하기 전에 계정 상태, 자격 또는 기타 조건을 확인합니다.

지원 채널

다음 표에는 이 블록이 지정된 채널을 사용하는 고객 응대를 라우팅하는 방법이 나와 있습니다.

채널 지원 여부

Voice

예

Chat

예

Task

예

이메일

예

흐름 유형

다음 흐름 유형에서 이 블록을 사용할 수 있습니다.

  • 모든 플로우

구성 개요

작업 선택

수행할 작업 유형을 선택합니다.

  • 데이터 테이블에서 읽기 - 데이터 쿼리 또는 검색(작업 평가 또는 나열)

  • 데이터 테이블에 쓰기 - 새 레코드 생성 또는 기존 레코드 업데이트

데이터 테이블 정의

  • 데이터 테이블을 직접 선택하려면 수동으로 설정을 선택합니다.

  • 드롭다운에서 대상 데이터 테이블을 선택합니다.

  • 중요: 특정 데이터 테이블을 선택하면 인터페이스가 관련 구성 섹션의 해당 테이블에서 사용 가능한 속성을 자동으로 채웁니다.

데이터 테이블 값 평가

평가 작업을 사용하여 데이터 테이블을 쿼리하고 정의된 기준에 따라 특정 속성 값을 검색합니다.

다음 이미지는 데이터 테이블 값을 평가하도록 구성된 데이터 테이블 블록의 속성 페이지를 보여줍니다.

평가 작업에 대해 구성된 데이터 테이블 블록의 속성 페이지입니다.

구성 단계

  1. 데이터 테이블에서 읽기를 작업으로 선택합니다.

  2. 읽기 작업 드롭다운에서 데이터 테이블 값 평가를 선택합니다.

  3. 쿼리 구성:

    • 데이터 테이블 블록당 최대 5개의 쿼리를 설정할 수 있습니다. 각 데이터 테이블 평가 블록에는 하나 이상의 쿼리가 필요합니다.

    • 각 쿼리에 대해:

      • 쿼리 이름(필수) - 쿼리를 설명하는 이름을 제공합니다. 중요: 쿼리 이름은이 특정 블록 내에서뿐만 아니라 전체 흐름에서 고유해야 합니다.

      • 기본 속성 - 데이터 테이블을 수동으로 선택하면 UI가 해당 테이블의 스키마에서 기본 속성 목록을 자동으로 채웁니다. 모든 기본 속성 필드는 필수입니다. 표시된 각 기본 속성에 대한 값을 제공해야 합니다. 이러한 속성은 데이터 테이블의 특정 행(들)을 식별하는 필터 역할을 합니다.

      • 쿼리 속성 - 데이터 테이블을 수동으로 선택하면 드롭다운에 해당 테이블에서 사용 가능한 모든 속성이 자동으로 채워집니다. 드롭다운에서 속성을 하나 이상 선택합니다. 다음은 흐름에서 반환되고 사용할 수 있게 되는 데이터 필드입니다. 검색된 값은 쿼리 이름을 사용하여 후속 블록에서 참조할 수 있습니다.

평가의 주요 세부 정보

  • 쿼리 제한 - 블록당 최대 5개의 쿼리

  • 최소 요구 사항 - 하나 이상의 쿼리를 구성해야 합니다.

  • 쿼리 이름 고유성 - 전체 고객 응대 흐름에서 고유해야 합니다.

  • 속성 일치 - 기본 속성은 정확한 일치를 사용하여 행을 찾습니다.

  • 필수 필드 - 모든 기본 속성은 필수입니다.

평가를 위해 검색된 데이터에 액세스

평가 작업을 실행한 후 다음 네임스페이스 형식을 사용하여 검색된 속성 값에 액세스할 수 있습니다. $.DataTables.<QueryName>.<AttributeName>

  • 구성 요소:

    • QueryName - 구성에서 쿼리에 할당한 고유한 이름입니다.

    • AttributeName - 검색하도록 선택한 속성의 이름입니다.

  • 사용량 - 이러한 값은 다음과 같은 후속 흐름 블록에서 참조할 수 있습니다.

    • 고객 응대 속성 블록 확인(조건부 분기의 경우)

    • 고객 응대 속성 블록 설정(다른 네임스페이스에 저장)

    • 프롬프트 블록 재생(개인 맞춤형 메시지 제공)

    • Lambda 함수 블록 호출(입력 파라미터로 전달)

  • 예 - "accountStatus" 및 "loyaltyTier" 속성을 검색하는 "CustomerLookup"이라는 쿼리를 구성한 경우:

    • 액세스 계정 상태: $.DataTables.CustomerLookup.accountStatus

    • 로열티 계층에 액세스: $.DataTables.CustomerLookup.loyaltyTier

  • 참고 - 쿼리가 결과를 반환하지 않거나 속성을 찾을 수 없는 경우 참조는 비어 있거나 null입니다.

데이터 테이블 값 나열

List 작업을 사용하여 지정된 기준과 일치하는 데이터 테이블에서 전체 행을 검색합니다.

다음 이미지는 데이터 테이블 값을 나열하도록 구성된 데이터 테이블 블록의 속성 페이지를 보여줍니다.

목록 작업에 대해 구성된 데이터 테이블 블록의 속성 페이지입니다.

구성 단계

  1. 작업으로 데이터 테이블에서 읽기를 선택합니다.

  2. 읽기 작업 드롭다운에서 데이터 테이블 값 나열을 선택합니다.

  3. 기본 값 그룹 구성:

    • 최대 5개의 기본 값 그룹을 추가하여 다양한 필터링 기준 세트를 정의할 수 있습니다.

    • 각 기본 값 그룹에 대해:

      • 그룹 이름(필수) - 기본 값 그룹에 대한 설명이 포함된 이름을 제공합니다. 이 이름은 후속 흐름 블록에서 검색된 레코드 세트를 참조하는 데 사용됩니다. 중요: 그룹 이름은이 특정 블록 내에서뿐만 아니라 전체 흐름에서 고유해야 합니다.

      • 기본 속성 - 데이터 테이블을 수동으로 선택하면 UI가 해당 테이블의 스키마에서 기본 속성 목록을 자동으로 채웁니다. 모든 기본 속성 필드는 필수입니다. 표시된 각 기본 속성에 대한 값을 제공해야 합니다. 이러한 속성은 반환될 데이터 테이블의 특정 행을 식별하는 필터 역할을 합니다.

    참고: 특정 속성 값을 검색하는 평가 작업과 달리 목록 작업은 기본 속성 기준과 일치하는 전체 레코드(모든 속성)를 반환합니다.

목록의 키 세부 정보

  • 기본 값 그룹 제한 - 블록당 최대 5개의 기본 값 그룹

  • 그룹 이름 고유성 - 전체 고객 응대 흐름에서 고유해야 합니다.

  • 속성 일치 - 기본 속성은 정확한 일치를 사용하여 행을 찾습니다.

  • 반환 동작 - 선택한 속성뿐만 아니라 전체 레코드를 반환합니다. 기본 값 그룹이 구성되지 않은 경우 전체 테이블이 로 32KB 한도로 로드됩니다.

목록에 대해 검색된 데이터 액세스

목록 작업을 실행한 후 검색된 데이터는 구조화된 형식으로 저장됩니다. 다음 네임스페이스 패턴을 사용하여 데이터에 액세스할 수 있습니다.

  • 메타데이터 액세스:

    • 데이터 테이블 ID: $.DataTableList.Result.dataTableId

    • 잠금 버전: $.DataTableList.Result.lockVersion.dataTable

  • 데이터 액세스 나열 - 목록에서 특정 데이터에 액세스하려면:

    • 인덱스별로 특정 행에 액세스합니다. $.DataTableList.Result.primaryKeyGroups.<GroupName>[index]

    • 기본 키 값에 액세스: $.DataTableList.Result.primaryKeyGroups.<GroupName>[index].primaryKeys[index].attributeValue

    • 액세스 속성 값: $.DataTableList.Result.primaryKeyGroups.<GroupName>[index].attributes[index].attributeValue

  • 사용량 - 이러한 값은 다음과 같은 후속 흐름 블록에서 참조할 수 있습니다.

    • 고객 응대 속성 블록 설정(특정 값 추출 및 저장)

    • Lambda 함수 블록 또는 모듈 호출(처리를 위해 전체 결과 집합 전달)

  • 예 - "OrderHistory"라는 기본 값 그룹을 구성한 경우:

    • 첫 번째 행에 액세스: $.DataTableList.Result.primaryKeyGroups.OrderHistory[0]

    • 첫 번째 행의 첫 번째 속성 값에 액세스합니다. $.DataTableList.Result.primaryKeyGroups.OrderHistory[0].attributes[0].attributeValue

  • 참고:

    • 이 목록은 선택한 레코드뿐만 아니라 전체 레코드(모든 속성)를 반환합니다.

    • 일치하는 레코드를 찾을 수 없는 경우 primaryKeyGroups 배열이 비어 있습니다.

    • 프라이머리 키 그룹이 구성되지 않은 경우 전체 테이블이 로드되고 "기본" 그룹 이름으로 결과에 액세스할 수 있습니다. $.DataTableList.Result.primaryKeyGroups.default[index]

데이터 테이블에 쓰기

쓰기 작업을 사용하여 새 레코드를 생성하거나 데이터 테이블의 기존 레코드를 업데이트합니다.

다음 이미지는 데이터 테이블에 쓰도록 구성된 데이터 테이블 블록의 속성 페이지를 보여줍니다.

쓰기 작업에 대해 구성된 데이터 테이블 블록의 속성 페이지입니다.

구성 단계

  1. 데이터 테이블에 쓰기를 작업으로 선택합니다.

  2. 기본 값 그룹 구성:

    • 여러 기본 값 그룹을 추가하여 작성 또는 업데이트할 여러 레코드를 정의할 수 있습니다. 각 데이터 테이블 쓰기 블록에는 하나 이상의 기본 값 그룹이 필요합니다.

    • 인터페이스는 탭을 통해 두 가지 입력 방법을 제공합니다.

      • 입력 탭 - 구조화된 양식 기반 구성(대부분의 사용자에게 권장)

      • 원시 JSON 탭 - 고급 사용자를 위한 직접 JSON 입력

    • 각 기본 값 그룹에 대해:

      • 그룹 이름(필수) - 기본 값 그룹에 대한 설명이 포함된 이름을 제공합니다. 이 이름은 후속 흐름 블록에서 쓰기 작업을 참조하는 데 사용됩니다. 중요: 그룹 이름은이 특정 블록 내에서뿐만 아니라 전체 흐름에서 고유해야 합니다.

      • 기본 속성 - 데이터 테이블을 수동으로 선택하면 UI가 해당 테이블의 스키마에서 기본 속성 목록을 자동으로 채웁니다. 모든 기본 속성 필드는 필수입니다. 표시된 각 기본 속성에 대한 값을 제공해야 합니다. 이러한 속성은 생성 또는 업데이트할 레코드를 결정하는 키 필드 역할을 합니다. 기본 속성 값이 일치하는 레코드가 있는 경우 레코드가 업데이트됩니다. 그렇지 않으면 새 레코드가 생성됩니다.

      • 쓰기를 위한 속성 구성

        • 속성 이름(필수) - 데이터 테이블을 수동으로 선택하면 드롭다운에 해당 테이블에서 사용 가능한 모든 속성이 자동으로 채워집니다. 작성하거나 업데이트할 속성을 선택합니다. 작성할 속성 추가를 클릭하여 여러 속성을 추가할 수 있습니다.

        • 속성 값 구성 - 각 속성에 대해 다음 옵션 중 하나를 선택합니다.

          • 속성 값 설정(기본적으로 선택됨) - 속성에 쓸 값을 지정합니다. 이 필드는이 옵션을 선택할 때 필요합니다. 값은 정적 텍스트, 고객 응대 속성 또는 시스템 변수일 수 있습니다.

          • 기본값 사용 - 데이터 테이블 스키마에 정의된 기본값을 사용합니다. 이 옵션을 선택하면 추가 값 입력이 필요하지 않습니다.

      • 잠금 버전 구성 - 잠금 버전 설정은 데이터 테이블에 대한 동시 쓰기 작업을 처리하는 방법을 제어합니다.

        • 최신 옵션 사용 - 항상 레코드의 최신 버전에 씁니다. 동시 업데이트 가능성이 낮거나 허용 가능한 대부분의 사용 사례에 적합합니다.

        • 동적 옵션 설정 - 런타임 시 Lambda 또는 모듈을 통해 버전 번호를 동적으로 지정할 수 있습니다.

쓰기에 대한 속성 제한

쓰기 작업의 총 속성 제한은 단일 블록의 모든 기본 값 그룹에서 25입니다. 이 제한은 다음과 같이 계산됩니다.

  • 기본 값 그룹에 "쓰기 속성"이 구성되어 있지 않은 경우 - 해당 그룹의 기본 속성 값 수는 총 제한에 포함됩니다.

  • 기본 값 그룹에 "쓰기 위한 속성"이 구성된 경우 - 작성할 속성 수는 총 제한에 포함됩니다(이 경우 기본 속성은 계산되지 않음).

예:

  • 예제 1: 3개의 기본 속성이 있고 쓸 속성이 없는 기본 값 그룹 = 제한에 대해 3

  • 예제 2: 3개의 기본 속성과 5개의 쓰기 속성이 있는 기본 값 그룹 = 제한에 대해 5

  • 예제 3: 각각 3개의 기본 속성과 5개의 쓰기 속성이 있는 3개의 기본 값 그룹 = 한도에 대해 15(5 + 5 + 5)

중요: 모든 기본 값 그룹에서 계수된 모든 속성의 합계가 25를 초과해서는 안 됩니다.

쓰기에 대한 키 세부 정보

  • 최소 요구 사항 - 하나 이상의 기본 값 그룹을 구성해야 합니다.

  • 기본 값 그룹에 대한 제한 없음 - 목록 작업과 달리 기본 값 그룹 수에는 고정된 제한이 없습니다.

  • 속성 제한 - 모든 기본 값 그룹에서 계수된 속성의 총 합계가 25를 초과해서는 안 됩니다.

  • 속성 일치 - 기본 속성은 정확한 일치를 사용하여 대상 레코드를 식별합니다.

  • 필수 필드 - 모든 기본 속성과 선택한 속성 값("속성 값 설정"을 선택한 경우)은 필수입니다.

  • 업서트 동작 - 일치하는 기본 속성이 있는 레코드가 있는 경우 레코드가 업데이트됩니다. 그렇지 않으면 새 레코드가 생성됩니다.

구성된 블록

구성되면이 블록에는 성공 및 오류에 대한 브랜치가 있습니다.