> For the complete documentation index, see [llms.txt](https://ssobig-corp.gitbook.io/ssobig-tool-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ssobig-corp.gitbook.io/ssobig-tool-guide/undefined-2/undefined-4.md).
# 필터시스템 알아보기
> SSOBIG TOOL 필터시스템이란?
>
> * 필터 시스템은 플레이어 응답, 투표 결과, 성별, 팀, 구역, 역할등을 조건별로 선별하여 표시할 수 있는 기능입니다.
> * 이를 통해 사용자는 특정 유형에 해당하는 데이터만 노출할 수 있습니다.
## 필터 시스템 구성
필터 시스템은 **세 가지 주요 요소**로 이루어집니다.
* **유형 (Type)**
데이터를 분류하는 기준입니다.
* 예: 팀, 구역, 성별, 역할, 응답 여부 등
* **대상 (Target)**
유형에 해당하는 구체적인 값을 지정합니다.
* 예: 팀의 경우 “팀 1”, 구역의 경우 “A구역” 등
* **조건 (Condition)**
대상 값과 비교하여, 원하는 데이터를 추려내는 설정입니다.
* 쉽게 말해 “경우에만” 또는 “경우가아닌”을 선택하는 것입니다.
{% hint style="info" %}
여러가지 필터를 AND , OR 을 통해 연결 할 수 있습니다.
**AND**
* 두 조건이 모두 만족해야 결과가 참이 됩니다.
* 예: "팀 = 팀1 AND 성별 = 남성"은 팀1에 속하고 성별이 남성인 플레이어들이 해당됩니다.
**OR**
* 하나의 조건만 만족해도 결과가 참이 됩니다.
* 예: "구역 = A OR 구역 = B"는 A 구역 또는 B 구역에 속한 플레이어들을 해당됩니다.
{% endhint %}
## 필터 사용 예시 및 방법
필터를 사용하는 방법은 4가지가 있습니다.
* 보기 플레이어필터
* 응답한 플레이어 필터
* 표시할 플레이어 필터
* 접근 권한
### 플레이어 필터 이미지 설명
* 플레이어 필터를 활용하여 원하는 플레이어의 보기, 응답 목록, 정보가 표시될지 여부를 설정하는 기능입니다. 이 기능을 사용하면 특정 조건을 충족하는 플레이어로 표시되도록 할 수 있으며, 보다 맞춤형 투표 및 정보 설정이 가능합니다.
> A 남자가 **같은 팀 내 이성 플레이어만 선택**할 수 있도록 설정합니다.
>
> * **유형:** 성별 → **대상:** 이성 → **조건:** 경우에만
> * **AND**
> * **유형:** 팀 → **대상:** 내 팀 → **조건:** 경우에만
>
> ✅ **결과:** 같은 팀의 여성 플레이어(A 여자, C 여자)만 선택 가능, 다른 플레이어는 제외됩니다.
### 접근 권한 이미지 설명
* 접근 권한은 플레이어 필터를 활용하여 특정 플레이어에게 정보를 보여주거나 숨길 수 있는 시스템입니다. 이를 통해 진행자는 특정 조건을 충족하는 플레이어만 정보를 확인할 수 있도록 설정할 수 있습니다.
> **예시: 남자들의 채팅방(남자만) & 2차 투표(여자만) 설정**
>
> * **남자들의 채팅방** → 성별 필터를 ‘남성, 경우에만’으로 설정하여 남자들만 입장 가능
> * **2차 투표(여자)** → 성별 필터를 ‘여성, 경우에만’으로 설정하여 여자들만 투표 가능
아래에서 각 방법의 예시와 자세한 사용 방법을 알려드리겠습니다.
### 보기 필터 예시 사용 방법
**목적:**
투표나 설문에서 표시되는 선택지(보기)를 특정 조건에 맞게 제한하거나, 필요한 항목만 보여주기 위해 사용합니다.
**설정 방법:**
1. **보기 유형 선택**
* 매칭 모듈을 만들어 보기 설정을 합니다.. (매칭 투표는기본적으로 플레이어들의 닉네임이 선택지로 표시됩니다.)
2. **필터 추가**
* \[보기 필터] 메뉴에서 **\[필터 추가]** 버튼을 클릭합니다.
3. **조건 설정**
* **유형:** “성별”을 선택합니다.
* **대상**: “이성”을 선택합니다.
* 예를 들어, 플레이어가 남성이라면 “여성”으로, 플레이어가 여성이라면 “남성”이 보기에 뜨게 됩니다.
* **조건:** “경우에만” 조건을 선택합니다.(즉, 플레이어의 성별 정보가 지정한 대상과 동일한 경우에만 해당 옵션이 표시되도록 설정합니다.)
4. **저장 및 적용**
* 모든 조건을 입력한 후, **\[편집씬변경 반영]** 버튼을 클릭하여 변경사항을 저장합니다.
* 우측 미리보기 기능을 통해, 오직 플레이어의 이성에 해당하는 플레이어들만 선택지로 노출되는지 확인합니다.
> Tip:
>
> * 필터 설정 후 반드시 미리보기를 통해 원하는 이성 투표 대상만 노출되는지 확인하세요.
> * 여러 조건을 결합해야 할 경우, **AND** 활용해 “이성일 경우에만” 외 추가 조건(예: 내 팀일 경우에만)을 적용할 수 있습니다.
***
### 응답한 플레이어 필터
**목적:**
특정 투표나 설문에서 이미 응답을 제출한 플레이어들만 선별하여, 그들의 결과를 다르게 보여주거나 지정된 사람의 응답만 보이게 합니다.
**설정 방법:**
1. **필터 옵션 선택**
* 투표 결과 모듈 내에서 **\[응답한 플레이어 필터]** 옵션을 선택하여 필터 설정 창을 엽니다.
2. **필터 추가**
* **\[응답한 플레이어 필터]** 메뉴에서 **\[필터 추가]** 버튼을 클릭합니다.
3. **유형 및 대상 지정**
* **유형:** “팀”을 선택합니다.
* **대상:** “내 팀” 을 설정합니다.
* **조건**:“경우에만” 조건을 선택합니다.(즉, 플레이어가 같은 팀의 응답만 보이게 설정됩니다.)
4. **저장 및 확인**
* 모든 설정을 완료한 후, **\[편집씬변경 반영]** 버튼을 클릭해 변경 사항을 저장합니다.
* 우측 미리보기 기능을 사용하여, 동일한 팀에 속한 플레이어들의 응답만 정확하게 표시되는지 확인합니다.
> **Tip:** 팀이 정확하게 설정되어 있어야 올바른 필터링이 이루어집니다. 필요 시 복수 조건(예: 팀과 성별을 **AND**로 결합하여 더 세밀하게 필터링할 수 있습니다.
***
### 접근 권한 예시 사용 방법
**목적:**
모듈 전체 또는 특정 데이터를 누가 볼 수 있는지를 제한하여, 민감 정보나 특정 그룹만 노출되도록 합니다.
**사용 방법:**
1. **접근 권한 탭 선택**
* 투표 모듈의 설정 화면에서 **\[접근 권한]** 탭을 클릭합니다.
2. **필터 추가**
* **\[필터 설정]** 메뉴에서 **\[필터 추가]** 버튼을 클릭합니다.
3. **역할 기반 필터 적용**
* **유형:** “응답한 ”을 선택합니다.
* **대상:** 원하는”투표,설문” 등 선택합니다.
* 조건: “경우에만”을 선택합니다.
* 이 설정을 통해 전에 투표,설문을 응답한 플레이어만 해당 모듈이 보이게 됩니다.
4. **저장 및 적용 확인**
* **\[편집씬변경 반영]** 버튼을 눌러 적용한 후, 우측 미리보기에서 오직 투표에 응답한 플레이어들만 해당 결과를 볼 수 있는지 확인합니다.
> Tip:
>
> * 접근 권한은 보기 필터와 함께 사용될 수 있으며, 보기,플레이어 필터는 모듈의 세부 정보를, 접근 권한은 모듈 전체의 노출 범위를 제한하는 역할을 합니다.