# GetStateCounts - 차트 함수

GetStateCounts() 차트 함수는 지정된 선택 상태와 일치하는 고유 값의 총 수를 계산하는 데 사용됩니다.

GetStateCounts()를 사용하면 다음 함수의 계산을 단일 함수 호출로 결합할 수 있습니다. GetSelectedCount(), GetNotSelectedCount(), GetAlternativeCount(), GetPossibleCount() 및 GetExcludedCount(). 선택한 제외 값의 개수도 계산에 추가할 수 있습니다. 각 함수 계산이 반환된 합계에 더하거나 뺄 것인지 지정할 수 있습니다.

구문:

GetStateCounts (field\_name, state\_name [, state\_type1,...state\_typeN])

반환 데이터 유형: 정수

인수

| 인수 | 설명 |
| --- | --- |
| field\_name | 선택 상태를 계산할 필드. 존재하지 않는 필드 이름으로 인해 null 결과가 발생합니다. |
| state\_name | 대체 상태의 이름. 인수가 비어 있거나(`''`) null인 경우 상속된 대체 상태가 사용됩니다. 기본 상태를 명시적으로 사용하려면 `$`를 사용합니다. 기존 상태와 일치하지 않는 명명된(비어 있지 않은) 상태 이름은 null 결과를 초래합니다. |
| state\_type | 필드 값에 대한 하나 이상의 상태 유형 목록입니다. 이러한 상태 유형은 개수로 집계됩니다. 상태 유형은 키를 사용하여 지정됩니다. 각 키를 작은따옴표로 묶어 입력합니다.<br><br>이 인수가 생략되면 함수는 열거형과 동일한 순서로 필드에 대해 사용할 수 있는 모든 상태 개수를 포함하는 문자열을 반환합니다.<br><br>사용할 수 있는 상태 목록은 아래 테이블을 참조하십시오. |

상태 유형은 특정 키를 사용하여 참조됩니다. 숫자 버전이나 텍스트 버전의 키를 사용할 수 있습니다. 동일한 표현식에 두 개 이상의 키를 결합하여 결과를 더욱 세부적으로 사용자 지정할 수 있습니다. 총 상태 개수를 더하지 않고, 상태 개수를 뺄 수도 있습니다. 이렇게 하려면 텍스트 키를 사용하고 상태 유형 앞에 빼기 기호(`-`)를 붙입니다.

상태 유형과 해당되는 경우 빼기 기호는 작은따옴표로 묶어야 합니다.

각 필드 상태 유형에 대한 키

| 필드 상태 유형 | 설명 | 숫자 키 | 텍스트 키 |
| --- | --- | --- | --- |
| 선택됨 | 선택한 값을 계산에 포함합니다. 동등한 함수에 대해서는 [GetSelectedCount - 차트 함수](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getselectedcount.htm)를 참조하십시오. | 1 | S |
| 선택 사항 | 선택되지는 않았지만 선택은 가능한 선택 항목을 계산에 포함합니다. 동등한 함수에 대해서는 [GetPossibleCount - 차트 함수](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getpossiblecount.htm)를 참조하십시오. | 2 | O |
| 선택 취소됨 | 선택하지 않은 값을 계산에 포함합니다. 이 상태 유형은 필드가 AND 모드일 때만 사용할 수 있습니다. | 3 | D |
| 대체 항목 | 계산에 대체 가능 값을 포함합니다. 동등한 함수에 대해서는 [GetAlternativeCount - 차트 함수](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getalternativecount.htm)를 참조하십시오. | 4 | A |
| 제외됨 | 선택되지 않은 제외 값을 계산에 포함합니다. 동등한 함수에 대해서는 [GetExcludedCount - 차트 함수](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getexcludedcount.htm)를 참조하십시오. | 5 | 엑스 |
| 제외 항목 선택됨 | 선택한 제외 값을 계산에 포함합니다. | 6 | XS |

## GetStateCounts를 사용하는 경우

GetStateCounts()를 사용하면 사용자 지정 선택 상태를 계산할 수 있습니다. 이 함수를 사용하면 여러 함수 호출을 단일 함수 호출로 통합하여 표현식 작성 과정을 간소화할 수 있습니다.

예를 들어, 필드에 대해 제외 값, 대체 값, 선택한 제외 값의 총 개수를 계산해야 할 수 있습니다. GetStateCounts()를 사용하여 이 합계를 계산할 수 있습니다.

예: 차트 표현식

| 예 | 결과 |
| --- | --- |
| `=GetStateCounts( ProductName, Null(), 'S' )` | 상속된 대체 상태에서 `ProductName`에 대해 선택된 개수를 반환합니다. |
| `=GetStateCounts( ProductName, '', 'X', 'A', 'XS' )` | `ProductName`에 대한 제외 값, 선택된 제외 값 및 대체 값의 총 개수를 반환합니다. 상속된 대체 상태가 사용됩니다. |
| `=GetStateCounts( ProductName, '', 'S', 'XS' )` | 상속된 상태에서 `ProductName`에 대한 사용자 선택의 총 개수를 반환합니다. |
| ProductName 필드가 and 모드에 있는 경우.<br><br><br>`=GetStateCounts(ProductName, '', 'D', '-O')` | `ProductName`에 대해 가능한 값의 개수에서 선택되지 않은 값의 개수를 뺀 값을 반환합니다. 상속된 대체 상태가 사용됩니다. |
| `=GetStateCounts(ProductName, '', 'X', , 'A', 'XS')` | `ProductName`에 대한 제외 값, 선택된 제외 값 및 대체 값의 총 개수를 반환합니다. 상속된 대체 상태가 사용됩니다. |
| `=GetStateCounts(ProductName, '$', 'O')` | 기본 대체 상태에서 `ProductName`에 대한 가능한 개수를 반환합니다. |
| `=GetStateCounts(ProductName, 'StateA', 'S')` | `StateA`라는 대체 상태에서 선택된 `ProductName` 개수를 반환합니다. |

## 예 1 – 총 사용자 선택 수 계산(선택된 제외 값 포함)

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getstatecounts.htm)

#### 차트 표현식

개요

GetSelectedCount() 함수는 선택한 값의 총 수를 반환하는데, 여기에는 선택한 제외 값의 총 수는 포함되지 않습니다. GetExcludedCount()을 사용하면 선택한 제외 값의 개수를 차트 계산에 포함할 수 있습니다.

데이터 로드 편집기를 열고 다음 로드 스크립트를 새 섹션에 추가합니다.

로드 스크립트

```
Names:
LOAD * inline [
First name|Last name|Initials|Has cellphone
John|Anderson|JA|Yes
Sue|Brown|SB|Yes
Mark|Carr|MC|No
Peter|Devonshire|PD|No
Jane|Elliot|JE|Yes
Peter|Franc|PF|Yes ] (delimiter is '|');
```

결과

다음과 같이 하십시오.

1. 데이터를 로드하고 시트를 엽니다.

2. 두 개의 필터 창을 만듭니다.

3. 첫 번째 필터 창에 First name을 차원으로 추가합니다. 두 번째 필터 창에 Last name을 차원으로 추가합니다.

4. 다음으로, 이 측정값을 사용하여 KPI를 만듭니다.

   `=GetStateCounts([First Name],'', 'S','XS')`

5. First name 필터 창에서 Mark 및 Peter 값을 선택합니다. Last name 필터 창에서 Carr 값을 선택합니다.

6. KPI가 2라는 값을 표시하는지 확인합니다. 이는 선택한 제외 값 Peter를 포함하여 선택한 모든 값이 계산됨을 나타냅니다.

## 예 2 – 제외 값, 선택된 제외 값, 대체 값의 개수 결합

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getstatecounts.htm)

#### 차트 표현식

개요

GetExcludedCount() 함수는 선택되지 않은 제외 값의 총 고유 값 수를 반환합니다. 시각화에 선택한 제외 및 대체 개수를 포함하려면 다음과 같이 GetStateCounts() 함수를 사용할 수 있습니다.

데이터 로드 편집기를 열고 다음 로드 스크립트를 새 섹션에 추가합니다.

로드 스크립트

```
Names:
LOAD * inline [
First name|Last name|Initials|Has cellphone
John|Anderson|JA|Yes
Sue|Brown|SB|Yes
Mark|Carr|MC|No
Peter|Devonshire|PD|No
Jane|Elliot|JE|Yes
Peter|Franc|PF|Yes ] (delimiter is '|');
```

결과

다음과 같이 하십시오.

1. 데이터를 로드하고 시트를 엽니다.

2. 두 개의 필터 창을 만듭니다.

3. 첫 번째 필터 창에 First name을 차원으로 추가합니다. 두 번째 필터 창에 Last name을 차원으로 추가합니다.

4. 다음으로, 이 측정값을 사용하여 KPI를 만듭니다.

   `=GetStateCounts([First name], '', 'X', 'A', 'XS')`

5. First name 필터 창에서 John 및 Peter 값을 선택합니다. Last name 필터 창에서 Franc 값을 선택합니다.

6. KPI가 4라는 값을 표시하는 것을 확인합니다. 이는 제외 값의 개수 외에도 선택한 제외 값 John이 계산에 포함된다는 것을 나타냅니다.

7. KPI를 편집하고 기존 측정값을 다음으로 바꿉니다.

   `=GetStateCounts([Last name], '', 'X', 'A', 'XS')`

8. 기존 선택 항목을 유지하면서 Last name 필터 창에서 Anderson 값을 선택합니다.

9. KPI가 여전히 4라는 값을 표시하는 것을 확인합니다. 이는 제외 값의 개수 외에도 대체 가능 값 Devonshire이 개수에 포함된다는 것을 나타냅니다.