# AWS WA Tool의 워크로드에 대한 사용자 지정 렌즈
자체 원칙, 질문, 모범 사례 및 개선 계획을 사용하여 사용자 지정 렌즈를 생성할 수 있습니다. AWS 제공 렌즈를 적용하는 것과 같은 방식으로 사용자 지정 렌즈를 워크로드에 적용할 수 있습니다. 자신이 만든 사용자 지정 렌즈를 다른 AWS 계정에 공유할 수도 있고, 다른 사람이 소유한 사용자 지정 렌즈가 나에게 공유될 수도 있습니다.
사용자 지정 렌즈로 특정 기술에 맞게 질문을 조정하거나, 조직 내 거버넌스 요구 사항을 충족하는 데 도움을 주거나, Well-Architected Framework 및 AWS 렌즈에서 제공하는 지침을 확장할 수 있습니다. 기존 렌즈와 마찬가지로 마일스톤을 생성하여 시간 경과에 따른 진행 상황을 추적하고, 보고서를 생성하여 주기적 상태를 제공할 수 있습니다.
**Topics**
+ [AWS WA Tool에서 사용자 지정 렌즈 보기](lenses-viewing.md)
+ [AWS WA Tool에서 워크로드에 대한 사용자 지정 렌즈 생성](lenses-create.md)
+ [AWS WA Tool에서 워크로드에 대한 사용자 지정 렌즈 미리 보기](lenses-preview.md)
+ [AWS WA Tool에서 사용자 지정 렌즈를 최초로 게시](lenses-publish.md)
+ [AWS WA Tool에서 사용자 지정 렌즈에 업데이트 게시](lenses-publish-update.md)
+ [AWS WA Tool에서 사용자 지정 렌즈 공유](lenses-sharing.md)
+ [AWS WA Tool에서 사용자 지정 렌즈에 태그 추가](lenses-tagging.md)
+ [AWS WA Tool에서 사용자 지정 렌즈 삭제](lenses-deleting.md)
+ [AWS WA Tool의 렌즈 형식 사양](lenses-format-specification.md)
# AWS WA Tool에서 사용자 지정 렌즈 보기
내가 소유한 사용자 지정 렌즈 및 나에게 공유된 사용자 지정 렌즈의 세부 정보를 볼 수 있습니다.
**렌즈를 보려면**
1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/)에서 AWS Well-Architected Tool 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **사용자 지정 렌즈**를 선택합니다.
**참고**
사용자 지정 렌즈를 생성하지 않았거나 사용자 지정 렌즈를 공유하지 않은 경우 **사용자 지정 렌즈** 섹션은 비어 있습니다.
1. 확인할 사용자 지정 렌즈를 선택합니다.
+ **내 소유** - 내가 생성한 사용자 지정 렌즈를 보여줍니다.
+ **나와 공유됨** - 나에게 공유된 사용자 지정 렌즈를 보여줍니다.
1. 확인할 사용자 지정 렌즈를 다음 중 한 가지 방법으로 선택합니다.
+ 렌즈의 이름을 선택합니다.
+ 렌즈를 선택하고 **세부 정보 보기**를 선택합니다.
[AWS WA Tool에서 워크로드에 대한 렌즈 세부 정보 보기](lenses-details.md) 페이지가 표시됩니다.
**사용자 지정 렌즈** 페이지에는 다음과 같은 필드가 있습니다.
**명칭**
렌즈의 이름입니다.
**소유자**
사용자 지정 렌즈를 소유한 AWS 계정 ID입니다.
**상태 표시기**
**게시됨** 상태는 사용자 지정 렌즈가 게시되었으며 이를 워크로드에 적용하거나 다른 AWS 계정에 공유할 수 있음을 의미합니다.
**초안** 상태는 사용자 지정 렌즈가 생성되었지만 아직 게시되지 않았음을 의미합니다. 사용자 지정 렌즈를 워크로드에 적용하거나 공유하려면 먼저 게시해야 합니다.
**버전**
사용자 지정 렌즈의 버전 이름입니다.
**최종 업데이트 날짜**
사용자 지정 렌즈가 마지막으로 업데이트된 날짜와 시간입니다.
# AWS WA Tool에서 워크로드에 대한 사용자 지정 렌즈 생성
**사용자 지정 렌즈를 생성하려면**
1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/)에서 AWS Well-Architected Tool 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **사용자 지정 렌즈**를 선택합니다.
1. **사용자 지정 렌즈**를 선택합니다.
1. **파일 다운로드** 선택하여 JSON 템플릿 파일을 다운로드합니다.
1. 선호하는 텍스트 편집기로 JSON 템플릿 파일을 열고 사용자 지정 렌즈에 대한 데이터를 추가합니다. 이 데이터에는 원칙, 질문, 모범 사례, 개선 계획 링크가 포함됩니다.
자세한 내용은 [AWS WA Tool의 렌즈 형식 사양](lenses-format-specification.md) 섹션을 참조하세요. 사용자 지정 렌즈의 크기는 500KB를 초과할 수 없습니다.
1. **파일 선택**을 선택하여 JSON 파일을 선택합니다.
1. (선택 사항) **태그** 섹션에서 사용자 지정 렌즈에 연결할 태그를 추가합니다.
1. 사용자 지정 렌즈를 미리 보려면 **제출 및 미리 보기**기를 선택하고, 미리 보기 없이 사용자 지정 렌즈를 제출하려면 **제출**을 선택합니다.
사용자 지정 렌즈 **제출 및 미리 보기**를 선택한 경우 **다음**을 선택하여 렌즈 미리 보기를 통해 탐색하거나 **미리 보기 종료**를 선택하여 **사용자 지정 렌즈**로 돌아갈 수 있습니다.
검증이 실패하면 JSON 파일을 수정하고 사용자 지정 렌즈를 다시 생성해 보세요.
AWS WA Tool이 JSON 파일의 유효성을 검사하면 사용자 지정 렌즈가 **사용자 지정 렌즈**에 표시됩니다.
생성된 사용자 지정 렌즈는 **초안** 상태입니다. 렌즈를 워크로드에 적용하거나 다른 AWS 계정와 공유하려면 먼저 [렌즈를 게시](lenses-publish.md)해야 합니다.
하나의 AWS 계정에 최대 15개의 사용자 지정 렌즈를 생성할 수 있습니다.
**면책 조항**
사용자 지정 렌즈 내에서 또는 렌즈를 통해 최종 사용자 또는 기타 식별 가능한 개인의 개인 식별 정보(PII)를 포함하거나 수집하지 마세요. 내 사용자 지정 렌즈 또는 나에게 공유되어 내 계정에서 사용되는 사용자 지정 렌즈에 PII가 포함되거나 수집되는 경우, 포함된 PII가 관련 법률에 따라 처리되도록 하고, 적절한 개인 정보 보호 고지를 제공하고, 해당 데이터를 처리하는 데 필요한 동의를 얻을 책임은 나에게 있습니다.
# AWS WA Tool에서 워크로드에 대한 사용자 지정 렌즈 미리 보기
**사용자 지정 렌즈를 미리 보려면**
1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/)에서 AWS Well-Architected Tool 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **사용자 지정 렌즈**를 선택합니다.
1. **초안** 상태의 렌즈만 미리 볼 수 있습니다. 원하는 **초안** 사용자 지정 렌즈를 선택하고 **미리 보기 경험**을 선택합니다.
1. **다음**을 선택하여 렌즈 미리 보기를 통해 탐색합니다.
1. (선택 사항) 미리 보기의 각 질문 내에서 모범 사례를 선택하여 **개선 계획**을 검토하고, **답변에 기반하여 업데이트**를 선택하여 위험 논리를 테스트할 수 있습니다. 변경이 필요한 경우 게시하기 전에 JSON 템플릿의 [위험 규칙](lenses-format-specification.md#lenses-format-risk-rules)을 업데이트할 수 있습니다.
1. 사용자 지정 렌즈로 돌아가려면 **미리 보기 종료**를 선택합니다.
**참고**
[사용자 지정 렌즈 생성 시](lenses-create.md) **제출 및 미리 보기**를 선택하여 사용자 지정 렌즈를 미리 볼 수도 있습니다.
# AWS WA Tool에서 사용자 지정 렌즈를 최초로 게시
**사용자 지정 렌즈를 게시하려면**
1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/)에서 AWS Well-Architected Tool 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **사용자 지정 렌즈**를 선택합니다.
1. 원하는 사용자 지정 렌즈를 선택하고 **렌즈 게시**를 선택합니다.
1. **버전 이름** 상자에 버전 변경에 대한 고유 식별자를 입력합니다. 이 값은 최대 32자까지 가능하며 영숫자와 마침표(“.”)만 포함해야 합니다.
1. **사용자 지정 렌즈 게시**를 선택합니다.
사용자 지정 렌즈가 게시된 후에는 **게시됨** 상태가 됩니다.
이제 사용자 지정 렌즈를 워크로드에 적용하거나 다른 AWS 계정 또는 다른 사용자와 공유할 수 있습니다.
# AWS WA Tool에서 사용자 지정 렌즈에 업데이트 게시
**기존 사용자 지정 렌즈에 업데이트를 게시하려면**
1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/)에서 AWS Well-Architected Tool 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **사용자 지정 렌즈**를 선택합니다.
1. 원하는 사용자 지정 렌즈를 선택하고 **편집**을 선택합니다.
1. 업데이트된 JSON 파일이 준비되지 않은 경우 **파일 다운로드**를 선택하여 현재 사용자 지정 렌즈의 사본을 다운로드하세요. 자주 사용하는 텍스트 편집기로 다운로드된 JSON 파일을 편집하고 원하는 대로 변경합니다.
1. **파일 선택**을 선택하여 업데이트된 JSON 파일을 선택하고 **제출 및 미리 보기**를 선택하여 사용자 지정 렌즈를 미리 보거나 **제출**을 선택하여 미리 보기를 거치지 않고 사용자 지정 렌즈를 제출하세요.
사용자 지정 렌즈의 크기는 500KB를 초과할 수 없습니다.
AWS WA Tool이 JSON 파일의 유효성을 검사하면 사용자 지정 렌즈가 **초안** 상태로 **사용자 지정 렌즈**에 표시됩니다.
1. 사용자 지정 렌즈를 다시 선택하고 **렌즈 게시**를 선택합니다.
1. **게시 전에 변경 사항 검토**를 선택하여 사용자 지정 렌즈에 대한 변경 사항이 올바른지 확인하세요. 여기에는 다음과 같은 검증이 포함됩니다.
+ 사용자 지정 렌즈의 이름
+ 원칙 이름
+ 새 질문, 업데이트된 질문, 삭제된 질문
**다음**을 선택합니다.
1. 버전 변경의 유형을 지정합니다.
**메이저 버전**
렌즈가 대폭 변경되었음을 나타냅니다. 사용자 지정 렌즈의 의미에 영향을 미치는 변경에 사용합니다.
렌즈가 적용된 모든 워크로드에 새 버전의 사용자 지정 렌즈를 이용할 수 있다는 알림이 전송됩니다.
메이저 버전 변경 사항은 렌즈를 사용하는 워크로드에 자동으로 적용되지 *않습니다*.
**마이너 버전**
렌즈가 약간 변경되었음을 나타냅니다. 텍스트 변경이나 URL 링크 업데이트와 같은 사소한 변경에 사용합니다.
마이너 버전 변경 사항은 사용자 지정 렌즈를 사용하는 워크로드에 자동으로 적용됩니다.
**다음**을 선택합니다.
1. **버전 이름** 상자에 버전 변경에 대한 고유 식별자를 입력합니다. 이 값은 최대 32자까지 가능하며 영숫자와 마침표(“.”)만 포함해야 합니다.
1. **사용자 지정 렌즈 게시**를 선택합니다.
사용자 지정 렌즈가 게시된 후에는 **게시됨** 상태가 됩니다.
이제 업데이트된 사용자 지정 렌즈를 워크로드에 적용하거나 다른 AWS 계정 또는 다른 사용자와 공유할 수 있습니다.
업데이트가 *메이저 버전 변경*인 경우 이전 버전의 렌즈가 적용된 모든 워크로드에 새 버전을 사용할 수 있다는 알림이 전송되고 업그레이드 옵션이 제공됩니다.
마이너 버전 업데이트가 알림 없이 자동으로 적용됩니다.
최대 100개의 사용자 지정 렌즈 버전을 생성할 수 있습니다.
# AWS WA Tool에서 사용자 지정 렌즈 공유
사용자 지정 렌즈를 다른 AWS 계정, 다른 사용자, AWS Organizations, 조직 단위(OU)에 공유할 수 있습니다.
**사용자 지정 렌즈를 다른 AWS 계정 및 다른 사용자와 공유하려면**
1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/)에서 AWS Well-Architected Tool 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **사용자 지정 렌즈**를 선택합니다.
1. 공유할 사용자 지정 렌즈를 선택하고 **세부 정보 보기**를 선택합니다.
1. [AWS WA Tool에서 워크로드에 대한 렌즈 세부 정보 보기](lenses-details.md) 페이지에서 **공유**를 선택합니다. 그런 다음 **생성** 및 **사용자 또는 계정에 대한 공유 생성**을 선택하여 렌즈 공유 초대를 생성합니다.
1. 사용자 지정 렌즈를 공유할 사용자의 12자리 AWS 계정 ID 또는 ARN을 입력합니다.
1. 지정한 AWS 계정 또는 사용자에게 렌즈 공유 초대를 보내려면 **생성**을 선택합니다.
최대 300명의 AWS 계정 또는 사용자에게 사용자 지정 렌즈를 공유할 수 있습니다.
7일 이내에 렌즈 공유 초대를 수락하지 않으면 초대가 자동으로 만료됩니다.
**중요**
사용자 지정 렌즈를 조직 또는 조직 단위(OU)에 공유하기 전에 [AWS Organizations 액세스를 활성화](sharing.md#getting-started-sharing-orgs)해야 합니다.
**사용자 지정 렌즈를 조직 또는 OU에 공유하려면**
1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/)에서 AWS Well-Architected Tool 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **사용자 지정 렌즈**를 선택합니다.
1. 공유할 사용자 지정 렌즈를 선택합니다.
1. [AWS WA Tool에서 워크로드에 대한 렌즈 세부 정보 보기](lenses-details.md) 페이지에서 **공유**를 선택합니다. 그런 다음 **생성** 및 **Organizations에 대한 공유 생성**을 선택합니다.
1. **사용자 지정 렌즈 공유 생성** 페이지에서 전체 조직에 권한을 부여할지 아니면 하나 이상의 OU에 권한을 부여할지 선택합니다.
1. **생성**을 선택하여 사용자 지정 렌즈를 공유합니다.
사용자 지정 렌즈에 대한 액세스 권한을 공유한 사람을 확인하려면 [AWS WA Tool에서 워크로드에 대한 렌즈 세부 정보 보기](lenses-details.md) 페이지에서 **공유**를 선택합니다.
**면책 조항**
사용자 지정 렌즈를 다른 AWS 계정에 공유하면 AWS가 사용자 지정 렌즈를 다른 계정에서 사용할 수 있도록 승인하는 것으로 간주됩니다. 사용자가 자체 AWS 계정에서 사용자 지정 렌즈를 삭제하거나 AWS 계정를 해지하더라도 이러한 다른 계정에서는 공유된 사용자 지정 렌즈에 계속 액세스하여 사용할 수 있습니다.
# AWS WA Tool에서 사용자 지정 렌즈에 태그 추가
**사용자 지정 렌즈에 태그를 추가하려면**
1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/)에서 AWS Well-Architected Tool 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **사용자 지정 렌즈**를 선택합니다.
1. 업데이트할 사용자 지정 렌즈를 선택합니다.
1. **태그** 섹션에서 **태그 관리**를 선택합니다.
1. 추가할 각 태그에 대해 **새 태그 추가**를 선택하고 **키**와 **값**을 입력합니다.
1. **저장**을 선택합니다.
태그를 제거하려면 제거하려는 태그 옆에 있는**제거**를 선택합니다.
# AWS WA Tool에서 사용자 지정 렌즈 삭제
**사용자 지정 렌즈를 삭제하려면**
1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/)에서 AWS Well-Architected Tool 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **사용자 지정 렌즈**를 선택합니다.
1. 삭제할 사용자 지정 렌즈를 선택하고 **삭제**를 선택합니다.
1. **삭제**를 선택합니다.
렌즈가 적용된 기존 워크로드에 사용자 지정 렌즈가 삭제되었다는 알림이 전송되지만 계속 사용할 수 있습니다. 새 워크로드에는 더 이상 사용자 지정 렌즈를 적용할 수 없습니다.
**면책 조항**
사용자 지정 렌즈를 다른 AWS 계정에 공유하면 AWS가 사용자 지정 렌즈를 다른 계정에서 사용할 수 있도록 승인하는 것으로 간주됩니다. 사용자가 자체 AWS 계정에서 사용자 지정 렌즈를 삭제하거나 AWS 계정를 해지하더라도 이러한 다른 계정에서는 공유된 사용자 지정 렌즈에 계속 액세스하여 사용할 수 있습니다.
# AWS WA Tool의 렌즈 형식 사양
렌즈는 특정 JSON 형식을 사용하여 정의됩니다. 사용자 지정 렌즈를 생성하기 시작하면 템플릿 JSON 파일을 다운로드할 수 있습니다. 이 파일은 원칙의 기본 구조, 질문, 모범 사례, 개선 계획을 정의하므로 사용자 지정 렌즈의 기반으로 사용할 수 있습니다.
## 렌즈 섹션
이 섹션에서는 사용자 지정 렌즈 자체의 속성을 정의합니다. 다음은 속성의 이름과 설명입니다.
+ `schemaVersion`: 사용할 사용자 지정 렌즈 스키마의 버전입니다. 템플릿에 의해 설정되므로 변경하지 마세요.
+ `name`: 렌즈의 이름입니다. 이름은 최대 128자까지 지정할 수 있습니다.
+ `description`: 렌즈에 대한 텍스트 설명입니다. 이 텍스트는 워크로드 생성 중에 추가할 렌즈를 선택하거나 나중에 기존 워크로드에 적용할 렌즈를 선택할 때 표시됩니다. 설명은 최대 2048자까지 작성할 수 있습니다.
```
"schemaVersion": "2021-11-01",
"name": "Company Policy ABC",
"description": "This lens provides a set of specific questions to assess compliance with company policy ABC-2021 as revised on 2021/09/01.",
```
## 원칙 섹션
이 섹션에서는 사용자 지정 렌즈와 관련된 원칙을 정의합니다. 질문을 AWS Well-Architected Framework의 원칙에 매핑하거나, 자체 원칙을 정의하거나, 두 작업을 모두 수행할 수 있습니다.
사용자 지정 렌즈 하나에는 최대 10개의 원칙을 정의할 수 있습니다.
+ `id`: 원칙의 ID입니다. ID에는 3\$1128자까지 사용 가능하며 영숫자 및 밑줄('\$1') 문자만 포함할 수 있습니다. 원칙에 사용되는 ID는 고유해야 합니다.
질문을 Framework의 원칙에 매핑할 때는 다음 ID를 사용하세요.
+ `operationalExcellence`
+ `security`
+ `reliability`
+ `performance`
+ `costOptimization`
+ `sustainability`
+ `name`: 원칙의 이름입니다. 이름은 최대 128자까지 지정할 수 있습니다.
```
"pillars": [
{
"id": "company_Privacy",
"name": "Privacy Excellence",
.
.
.
},
{
"id": "company_Security",
"name": "Security",
.
.
.
}
]
```
## 질문 섹션
이 섹션에서는 원칙과 관련된 질문을 정의합니다.
사용자 지정 렌즈에서는 원칙에 최대 20개의 질문을 정의할 수 있습니다.
+ `id`: 질문의 ID입니다. ID에는 3\$1128자까지 사용 가능하며 영숫자 및 밑줄('\$1') 문자만 포함할 수 있습니다. 질문에 사용되는 ID는 고유해야 합니다.
+ `title`: 질문의 제목입니다. 제목은 최대 128자까지 지정할 수 있습니다.
+ `description`: 질문을 더 자세히 설명합니다. 설명은 최대 2048자까지 작성할 수 있습니다.
+ `helpfulResource displayText`: 선택 사항입니다. 질문에 대한 유용한 정보를 제공하는 텍스트입니다. 텍스트는 최대 2048자까지 작성할 수 있습니다. `helpfulResource url`을 지정하는 경우 이 텍스트도 지정해야 합니다.
+ `helpfulResource url`: 선택 사항입니다. 질문을 더 자세히 설명하는 URL 리소스입니다. URL은 `http://` 또는 `https://`로 시작해야 합니다.
**참고**
사용자 지정 렌즈 워크로드를 Jira와 동기화할 때 질문에는 질문의 "id"와 "title"이 모두 표시됩니다.
Jira 티켓에 사용된 형식은 `[ QuestionID ] QuestionTitle`입니다.
```
"questions": [
{
"id": "privacy01",
"title": "How do you ensure HR conversations are private?",
"description": "Career and benefits discussions should occur on secure channels only and be audited regularly for compliance.",
"helpfulResource": {
"displayText": "This is helpful text for the first question",
"url": "https://example.com/poptquest01_help.html"
},
.
.
.
},
{
"id": "privacy02",
"title": "Is your team following the company privacy policy?",
"description": "Our company requires customers to opt-in to data use and does not disclose customer data to third parties either individually or in aggregate.",
"helpfulResource": {
"displayText": "This is helpful text for the second question",
"url": "https://example.com/poptquest02_help.html"
},
.
.
.
}
]
```
## 선택 항목 섹션
이 섹션에서는 질문과 관련된 선택 항목을 정의합니다.
사용자 지정 렌즈에서는 질문에 최대 15개의 선택 항목을 정의할 수 있습니다.
+ `id`: 선택 항목의 ID입니다. ID에는 3\$1128자까지 사용 가능하며 영숫자 및 밑줄('\$1') 문자만 포함할 수 있습니다. 질문의 각 선택 항목에 대해 고유한 ID를 지정해야 합니다. 접미사가 `_no`인 선택 항목을 추가하면 질문에 대한 `None of these` 선택 항목으로 작동합니다.
+ `title`: 선택 항목의 제목입니다. 제목은 최대 128자까지 지정할 수 있습니다.
+ `helpfulResource displayText`: 선택 사항입니다. 선택 항목에 대한 유용한 정보를 제공하는 텍스트입니다. 텍스트는 최대 2048자까지 작성할 수 있습니다. `helpfulResource url`이 지정된 경우 텍스트를 포함해야 합니다.
+ `helpfulResource url`: 선택 사항입니다. 선택 항목을 더 자세히 설명하는 URL 리소스입니다. URL은 `http://` 또는 `https://`로 시작해야 합니다.
+ `improvementPlan displayText`: 선택 항목을 개선할 수 있는 방법을 설명하는 텍스트입니다. 텍스트는 최대 2048자까지 작성할 수 있습니다. `None of these` 선택 항목을 제외한 각 선택 항목에는 `improvementPlan`이 필요합니다.
+ `improvementPlan url`: 선택 사항입니다. 개선에 도움이 될 수 있는 URL 리소스입니다. URL은 `http://` 또는 `https://`로 시작해야 합니다.
+ `additionalResources type`: 선택 사항입니다. 추가 리소스 유형입니다. 이때 값은 `HELPFUL_RESOURCE` 또는 `IMPROVEMENT_PLAN`이 될 수 있습니다.
+ `additionalResources content`: 선택 사항입니다. 추가 리소스의 `displayText` 및 `url` 값을 지정합니다. 선택 항목에 최대 5개의 유용한 추가 리소스와 최대 5개의 추가 개선 계획 항목을 지정할 수 있습니다.
+ `displayText`: 선택 사항입니다. 유용한 리소스 또는 개선 계획을 설명하는 텍스트입니다. 텍스트는 최대 2048자까지 작성할 수 있습니다. `url`이 지정된 경우 텍스트를 포함해야 합니다.
+ `url`: 선택 사항입니다. 유용한 리소스 또는 개선 계획을 위한 URL 리소스입니다. URL은 `http://` 또는 `https://`로 시작해야 합니다.
**참고**
사용자 지정 렌즈 워크로드를 Jira와 동기화할 때 선택 항목에는 질문 및 선택 항목의 "id"와 선택 항목의 "title"이 표시됩니다.
사용된 형식은 `[ QuestionID | ChoiceID ] ChoiceTitle`입니다.
```
"choices": [
{
"id": "choice_1",
"title": "Option 1",
"helpfulResource": {
"displayText": "This is helpful text for the first choice",
"url": "https://example.com/popt01_help.html"
},
"improvementPlan": {
"displayText": "This is text that will be shown for improvement of this choice.",
"url": "https://example.com/popt01_iplan.html"
}
},
{
"id": "choice_2",
"title": "Option 2",
"helpfulResource": {
"displayText": "This is helpful text for the second choice",
"url": "https://example.com/hr_manual_CORP_1.pdf"
},
"improvementPlan": {
"displayText": "This is text that will be shown for improvement of this choice.",
"url": "https://example.com/popt02_iplan_01.html"
},
"additionalResources":[
{
"type": "HELPFUL_RESOURCE",
"content": [
{
"displayText": "This is the second set of helpful text for this choice.",
"url": "https://example.com/hr_manual_country.html"
},
{
"displayText": "This is the third set of helpful text for this choice.",
"url": "https://example.com/hr_manual_city.html"
}
]
},
{
"type": "IMPROVEMENT_PLAN",
"content": [
{
"displayText": "This is additional text that will be shown for improvement of this choice.",
"url": "https://example.com/popt02_iplan_02.html"
},
{
"displayText": "This is the third piece of improvement plan text.",
"url": "https://example.com/popt02_iplan_03.html"
}
{
"displayText": "This is the fourth piece of improvement plan text.",
"url": "https://example.com/popt02_iplan_04.html"
}
]
}
]
},
{
"id": "option_no",
"title": "None of these",
"helpfulResource": {
"displayText": "Choose this if your workload does not follow these best practices.",
"url": "https://example.com/popt02_iplan_none.html"
}
}
```
## 위험 규칙 섹션
이 섹션에서는 선택한 선택 항목이 위험 수준을 결정하는 방법을 정의합니다.
각 위험 수준에 하나씩, 질문당 최대 3개의 위험 규칙을 정의할 수 있습니다.
+ `condition`: 질문의 위험 수준에 매핑되는 선택 항목의 부울 표현식으로, 해당 사항이 없는 경우 `default` 값이 지정됩니다.
각 질문에는 `default` 위험 규칙이 있어야 합니다.
+ `risk`: 조건과 관련된 위험을 나타냅니다. 유효한 값은 `HIGH_RISK`, `MEDIUM_RISK`, `NO_RISK`입니다.
위험 규칙의 순서는 중요합니다. 첫 번째 `condition`은 `true`로 평가되며 질문에 대한 위험 수준을 설정합니다. 위험 규칙을 구현하는 일반적인 패턴은 위험이 가장 적은(일반적으로 가장 세분화된) 규칙에서 시작하여 가장 위험한(가장 구체적이지 않은) 규칙 순서로 적용하는 것입니다.
예시:
```
"riskRules": [
{
"condition": "choice_1 && choice_2 && choice_3",
"risk": "NO_RISK"
},
{
"condition": "((choice_1 || choice_2) && choice_3) || (!choice_1 && choice_3)",
"risk": "MEDIUM_RISK"
},
{
"condition": "default",
"risk": "HIGH_RISK"
}
]
```
질문에 세 가지 선택 항목(`choice_1`,`choice_2`, `choice_3`)이 있는 경우 이러한 위험 규칙의 결과는 다음과 같습니다.
+ 세 가지 선택 항목을 모두 선택해도 위험은 없습니다.
+ `choice_1` 또는 `choice_2` 중 하나가 선택된 **상태에서** `choice_3`이 선택된 경우 위험 수준은 중간입니다.
+ `choice_1`이 선택되지 **않은** 상태에서 `choice_3`이 선택된 경우 역시 위험 수준이 중간입니다.
+ 위 조건 중 어느 것에도 해당하지 않으면 높은 위험입니다.