기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # Amazon Connect의 흐름 블록: 데이터 테이블 ## 설명 Amazon Connect의 데이터 테이블 블록을 사용하면 고객 응대 흐름 내의 데이터 테이블에서 데이터를 평가, 나열 또는 쓸 수 있습니다. 이 블록은 Amazon Connect 데이터 테이블에 저장된 구조화된 데이터와 상호 작용하여 동적 의사 결정, 맞춤형 고객 경험 및 데이터 관리를 용이하게 합니다. ## 사용 사례 데이터 테이블 블록은 다음과 같은 경우에 유용합니다. + **구성 검색** - 데이터 테이블에 저장된 비즈니스 규칙, 라우팅 파라미터 또는 운영 설정에 액세스합니다. + **동적 라우팅 결정** - 데이터 테이블을 쿼리하여 고객 속성을 기반으로 적절한 대기열, 에이전트 또는 흐름 경로를 결정합니다. + **상태 확인** - 특정 작업을 진행하기 전에 계정 상태, 자격 또는 기타 조건을 확인합니다. ## 지원 채널 다음 표에는 이 블록이 지정된 채널을 사용하는 고객 응대를 라우팅하는 방법이 나와 있습니다. | 채널 | 지원 여부 | | --- | --- | | Voice | 예 | | Chat | 예 | | Task | 예 | | 이메일 | 예 | ## 흐름 유형 다음 [흐름 유형](create-contact-flow.md#contact-flow-types)에서 이 블록을 사용할 수 있습니다. + 모든 플로우 ## 구성 개요 ### 작업 선택 수행할 작업 유형을 선택합니다. + 데이터 테이블에서 읽기 - 데이터 쿼리 또는 검색(작업 평가 또는 나열) + 데이터 테이블에 쓰기 - 새 레코드 생성 또는 기존 레코드 업데이트 ### 데이터 테이블 정의 + 데이터 테이블을 직접 선택하려면 **수동으로 설정을** 선택합니다. + 드롭다운에서 대상 데이터 테이블을 선택합니다. + 중요: 특정 데이터 테이블을 선택하면 인터페이스가 관련 구성 섹션의 해당 테이블에서 사용 가능한 속성을 자동으로 채웁니다. ## 데이터 테이블 값 평가 평가 작업을 사용하여 데이터 테이블을 쿼리하고 정의된 기준에 따라 특정 속성 값을 검색합니다. 다음 이미지는 **데이터 테이블** 값을 평가하도록 구성된 데이터 테이블 블록의 **속성** 페이지를 보여줍니다. ![평가 작업에 대해 구성된 데이터 테이블 블록의 속성 페이지입니다.](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/data-table-evaluate.png) ### 구성 단계 1. 작업으로 **데이터 테이블에서 읽기**를 선택합니다. 1. 읽기 작업 드롭다운에서 **데이터 테이블 값 평가를** 선택합니다. 1. 쿼리 구성: + 데이터 테이블 블록당 최대 5개의 쿼리를 설정할 수 있습니다. 각 데이터 테이블 평가 블록에는 하나 이상의 쿼리가 필요합니다. + 각 쿼리에 대해: + **쿼리 이름(필수)** - 쿼리를 설명하는 이름을 제공합니다. 중요: 쿼리 이름은이 특정 블록 내에서뿐만 아니라 전체 흐름에서 고유해야 합니다. + **기본 속성** - 데이터 테이블을 수동으로 선택하면 UI가 해당 테이블의 스키마에서 기본 속성 목록을 자동으로 채웁니다. 모든 기본 속성 필드는 필수입니다. 표시된 각 기본 속성에 대한 값을 제공해야 합니다. 이러한 속성은 데이터 테이블의 특정 행(들)을 식별하는 필터 역할을 합니다. + **쿼리 속성 **- 데이터 테이블을 수동으로 선택하면 드롭다운에 해당 테이블에서 사용 가능한 모든 속성이 자동으로 채워집니다. 드롭다운에서 속성을 하나 이상 선택합니다. 다음은 반환되어 흐름에서 사용할 수 있게 되는 데이터 필드입니다. 검색된 값은 쿼리 이름을 사용하여 후속 블록에서 참조할 수 있습니다. ### 평가의 주요 세부 정보 + **쿼리 제한** - 블록당 최대 5개의 쿼리 + **최소 요구 사항** - 하나 이상의 쿼리를 구성해야 합니다. + **쿼리 이름 고유성** - 전체 고객 응대 흐름에서 고유해야 합니다. + **속성 일치** - 기본 속성은 정확한 일치를 사용하여 행을 찾습니다. + **필수 필드** - 모든 기본 속성은 필수입니다. ### 평가를 위해 검색된 데이터에 액세스 평가 작업을 실행한 후 네임스페이스 형식을 사용하여 검색된 속성 값에 액세스할 수 있습니다`$.DataTables.{{QueryName}}.{{AttributeName}}`. 대괄호와 작은따옴표를 사용하여 속성 이름을 특수 문자로 참조합니다. 예를 들어 `$.DataTables.CustomQuery['my attribute name with spaces']`입니다. **데이터 테이블** 네임스페이스 동적 드롭다운 선택을 사용하는 경우 루트 네임스페이스를 생략할 `$.DataTables.`수 있습니다. + **구성 요소:** + `QueryName` - 구성에서 쿼리에 할당한 고유한 이름입니다. + `AttributeName` - 검색하도록 선택한 속성의 이름입니다. + **사용량** - 이러한 값은 다음과 같은 후속 흐름 블록에서 참조할 수 있습니다. + 고객 응대 속성 블록 확인(조건부 분기의 경우) + 고객 응대 속성 블록 설정(다른 네임스페이스에 저장) + 프롬프트 블록 재생(개인 맞춤형 메시지 제공) + Lambda 함수 블록 호출(입력 파라미터로 전달) + **예** - "accountStatus" 및 "loyaltyTier" 속성을 검색하는 "CustomerLookup"이라는 쿼리를 구성한 경우: + 액세스 계정 상태: `$.DataTables.CustomerLookup.accountStatus` + 로열티 계층에 액세스: `$.DataTables.CustomerLookup.loyaltyTier` + **참고:** + 쿼리가 결과를 반환하지 않거나 속성을 찾을 수 없는 경우 참조는 비어 있거나 null입니다. + 유형 목록의 데이터 테이블 값은 지원되지 않습니다. + 후속 데이터 테이블 블록은 데이터 테이블 네임스페이스에서 이전 쿼리를 지웁니다. + 데이터 테이블 네임스페이스의 쿼리 결과는 데이터 테이블 흐름 블록이 포함된 흐름에서만 사용할 수 있습니다. ## 데이터 테이블 값 나열 List 작업을 사용하여 지정된 기준과 일치하는 데이터 테이블에서 전체 행을 검색합니다. 다음 이미지는 **데이터 테이블** 값을 나열하도록 구성된 데이터 테이블 블록의 **속성** 페이지를 보여줍니다. ![목록 작업에 대해 구성된 데이터 테이블 블록의 속성 페이지입니다.](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/data-table-list.png) ### 구성 단계 1. **데이터 테이블에서 읽기**를 작업으로 선택합니다. 1. 읽기 작업 드롭다운에서 **데이터 테이블 값 나열**을 선택합니다. 1. 기본 값 그룹 구성: + 최대 5개의 기본 값 그룹을 추가하여 다양한 필터링 기준 세트를 정의할 수 있습니다. + 각 기본 값 그룹에 대해: + **그룹 이름(필수)** - 기본 값 그룹에 대한 설명이 포함된 이름을 제공합니다. 이 이름은 후속 흐름 블록에서 검색된 레코드 세트를 참조하는 데 사용됩니다. 중요: 그룹 이름은이 특정 블록 내에서뿐만 아니라 전체 흐름에서 고유해야 합니다. + **기본 속성** - 데이터 테이블을 수동으로 선택하면 UI가 해당 테이블의 스키마에서 기본 속성 목록을 자동으로 채웁니다. 모든 기본 속성 필드는 필수입니다. 표시된 각 기본 속성에 대한 값을 제공해야 합니다. 이러한 속성은 반환될 데이터 테이블의 특정 행을 식별하는 필터 역할을 합니다. 참고: 특정 속성 값을 검색하는 평가 작업과 달리 목록 작업은 기본 속성 기준과 일치하는 전체 레코드(모든 속성)를 반환합니다. ### 목록의 키 세부 정보 + **기본 값 그룹 제한** - 블록당 최대 5개의 기본 값 그룹 + **그룹 이름 고유성** - 전체 고객 응대 흐름에서 고유해야 합니다. + **속성 일치** - 기본 속성은 정확한 일치를 사용하여 행을 찾습니다. + **반환 동작** - 선택한 속성뿐만 아니라 전체 레코드를 반환합니다. 기본 값 그룹이 구성되지 않은 경우 전체 테이블이 로 32KB 한도로 로드됩니다. ### 목록에 대해 검색된 데이터 액세스 목록 작업을 실행한 후 검색된 데이터는 구조화된 형식으로 저장됩니다. 다음 네임스페이스 패턴을 사용하여 데이터에 액세스할 수 있습니다. + **메타데이터 액세스:** + 데이터 테이블 ID: `$.DataTableList.ResultData.dataTableId` + 잠금 버전: `$.DataTableList.ResultData.lockVersion.dataTable` + **데이터 액세스 나열** - 목록에서 특정 데이터에 액세스하려면: + 인덱스별로 특정 행에 액세스합니다. `$.DataTableList.ResultData.primaryKeyGroups.{{GroupName}}[{{index}}]` + 기본 키 값에 액세스: `$.DataTableList.ResultData.primaryKeyGroups.{{GroupName}}[{{index}}].primaryKeys[{{index}}].attributeValue` + 액세스 속성 값: `$.DataTableList.ResultData.primaryKeyGroups.{{GroupName}}[{{index}}].attributes[{{index}}].attributeValue` + **사용량** - 이러한 값은 다음과 같은 후속 흐름 블록에서 참조할 수 있습니다. + 고객 응대 속성 블록 설정(특정 값 추출 및 저장) + Lambda 함수 블록 또는 모듈 호출(처리를 위해 전체 결과 집합 전달) + **예** - "OrderHistory"라는 기본 값 그룹을 구성한 경우: + 첫 번째 행에 액세스: `$.DataTableList.ResultData.primaryKeyGroups.OrderHistory[0]` + 첫 번째 행의 첫 번째 속성 값에 액세스합니다. `$.DataTableList.ResultData.primaryKeyGroups.OrderHistory[0].attributes[0].attributeValue` + **참고:** + 이 목록은 선택한 레코드뿐만 아니라 전체 레코드(모든 속성)를 반환합니다. + 일치하는 레코드를 찾을 수 없는 경우 primaryKeyGroups 배열이 비어 있습니다. + 프라이머리 키 그룹이 구성되지 않은 경우 전체 테이블이 로드되고 "기본" 그룹 이름으로 결과에 액세스할 수 있습니다. `$.DataTableList.ResultData.primaryKeyGroups.default[index]` + 흐름 블록의 배열 요소에 액세스할 때 백틱을 사용하여 JSONPath 참조를 래핑합니다. ``$.DataTableList.ResultData.primaryKeyGroups.[index]`` ## 데이터 테이블에 쓰기 쓰기 작업을 사용하여 새 레코드를 생성하거나 데이터 테이블의 기존 레코드를 업데이트합니다. 다음 이미지는 **데이터 테이블에** 쓰도록 구성된 데이터 테이블 블록의 **속성** 페이지를 보여줍니다. ![쓰기 작업에 대해 구성된 데이터 테이블 블록의 속성 페이지입니다.](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/data-table-write.png) ### 구성 단계 1. **데이터 테이블에 쓰기**를 작업으로 선택합니다. 1. 기본 값 그룹 구성: + 여러 기본 값 그룹을 추가하여 작성 또는 업데이트할 여러 레코드를 정의할 수 있습니다. 각 데이터 테이블 쓰기 블록에는 하나 이상의 기본 값 그룹이 필요합니다. + 인터페이스는 탭을 통해 두 가지 입력 방법을 제공합니다. + 입력 탭 - 구조화된 양식 기반 구성(대부분의 사용자에게 권장됨) + 원시 JSON 탭 - 고급 사용자를 위한 직접 JSON 입력 + 각 기본 값 그룹에 대해: + **그룹 이름(필수)** - 기본 값 그룹에 대한 설명이 포함된 이름을 제공합니다. 이 이름은 후속 흐름 블록에서 쓰기 작업을 참조하는 데 사용됩니다. 중요: 그룹 이름은이 특정 블록 내에서뿐만 아니라 전체 흐름에서 고유해야 합니다. + **기본 속성** - 데이터 테이블을 수동으로 선택하면 UI가 해당 테이블의 스키마에서 기본 속성 목록을 자동으로 채웁니다. 모든 기본 속성 필드는 필수입니다. 표시된 각 기본 속성에 대한 값을 제공해야 합니다. 이러한 속성은 생성 또는 업데이트할 레코드를 결정하는 키 필드 역할을 합니다. 기본 속성 값이 일치하는 레코드가 있는 경우 레코드가 업데이트되고, 그렇지 않으면 새 레코드가 생성됩니다. + **쓰기를 위한 속성 구성** + **속성 이름(필수)** - 데이터 테이블을 수동으로 선택하면 드롭다운에 해당 테이블에서 사용 가능한 모든 속성이 자동으로 채워집니다. 작성하거나 업데이트할 속성을 선택합니다. **작성할 속성 추가를 클릭하여 여러 속성을 추가할 수 있습니다**. + **속성 값 구성** - 각 속성에 대해 다음 옵션 중 하나를 선택합니다. + 속성 값 설정(기본적으로 선택됨) - 속성에 쓸 값을 지정합니다. 이 필드는이 옵션을 선택할 때 필요합니다. 값은 정적 텍스트, 고객 응대 속성 또는 시스템 변수일 수 있습니다. + 기본값 사용 - 데이터 테이블 스키마에 정의된 기본값을 사용합니다. 이 옵션을 선택하면 추가 값 입력이 필요하지 않습니다. + **잠금 버전 구성** - 잠금 버전 설정은 데이터 테이블에 대한 동시 쓰기 작업을 처리하는 방법을 제어합니다. + 최신 옵션 사용 - 항상 레코드의 최신 버전에 씁니다. 동시 업데이트 가능성이 낮거나 허용 가능한 대부분의 사용 사례에 적합합니다. + 동적 옵션 설정 - 런타임 시 Lambda 또는 모듈을 통해 버전 번호를 동적으로 지정할 수 있습니다. ### 쓰기에 대한 속성 제한 쓰기 작업의 총 속성 제한은 단일 블록의 모든 기본 값 그룹에서 25입니다. 이 제한은 다음과 같이 계산됩니다. + 기본 값 그룹에 "쓰기 속성"이 구성되어 있지 않은 경우 - 해당 그룹의 기본 속성 값 수는 총 제한에 포함됩니다. + 기본 값 그룹에 "쓰기 위한 속성"이 구성된 경우 - 작성할 속성 수는 총 제한에 포함됩니다(이 경우 기본 속성은 계산되지 않음). **예**: + 예제 1: 3개의 기본 속성이 있고 쓸 속성이 없는 기본 값 그룹 = 제한에 대해 3 + 예제 2: 3개의 기본 속성과 5개의 쓰기 속성이 있는 기본 값 그룹 = 제한에 대해 5 + 예제 3: 각각 3개의 기본 속성과 5개의 쓰기 속성이 있는 3개의 기본 값 그룹 = 한도에 대해 15(5 \+ 5 \+ 5) 중요: 모든 기본 값 그룹에서 계수된 모든 속성의 합계가 25를 초과해서는 안 됩니다. ### 쓰기에 대한 키 세부 정보 + **최소 요구 사항** - 하나 이상의 기본 값 그룹을 구성해야 합니다. + **기본 값 그룹에 대한 제한 없음** - 목록 작업과 달리 기본 값 그룹 수에는 고정된 제한이 없습니다. + **속성 제한** - 모든 기본 값 그룹에서 계수된 속성의 총 합계가 25를 초과해서는 안 됩니다. + **속성 일치** - 기본 속성은 정확한 일치를 사용하여 대상 레코드를 식별합니다. + **필수 필드** - 모든 기본 속성과 선택한 속성 값("속성 값 설정"을 선택한 경우)은 필수입니다. + **업서트 동작** - 일치하는 기본 속성이 있는 레코드가 있는 경우 레코드가 업데이트됩니다. 그렇지 않으면 새 레코드가 생성됩니다. ## 구성된 블록 구성되면이 블록에는 **성공** 및 **오류**에 대한 브랜치가 있습니다.