

# Cadres personnalisés pour les charges de travail dans AWS WA Tool
<a name="lenses-custom"></a>

Vous pouvez créer des cadres personnalisés avec vos propres piliers, questions, bonnes pratiques et plan d’amélioration. Vous appliquez des cadres personnalisés à une charge de travail de la même manière que vous appliquez les cadres fournis par AWS. Vous pouvez également partager les cadres personnalisés que vous créez avec d’autres Comptes AWS, et les cadres personnalisés appartenant à d’autres personnes peuvent être partagés avec vous.

Vous pouvez adapter les questions dans un cadre personnalisé pour qu’elles soient spécifiques à une technologie particulière, vous aident à répondre aux besoins de gouvernance au sein de votre organisation ou étendent les conseils fournis par le cadre Well-Architected et les cadres AWS. À l’instar des cadres existants, vous pouvez suivre les progrès au fil du temps en créant des jalons et fournir un statut périodique en générant des rapports.

**Topics**
+ [Affichage des cadres personnalisés dans AWS WA Tool](lenses-viewing.md)
+ [Création d’un cadre personnalisé pour une charge de travail dans AWS WA Tool](lenses-create.md)
+ [Prévisualisation d’un cadre personnalisé pour une charge de travail dans AWS WA Tool](lenses-preview.md)
+ [Publication d’un cadre personnalisé dans AWS WA Tool pour la première fois](lenses-publish.md)
+ [Publication d’une mise à jour d’un cadre personnalisé dans AWS WA Tool](lenses-publish-update.md)
+ [Partage d’un cadre personnalisé dans AWS WA Tool](lenses-sharing.md)
+ [Ajout de balises à un cadre personnalisé dans AWS WA Tool](lenses-tagging.md)
+ [Suppression d’un cadre personnalisé dans AWS WA Tool](lenses-deleting.md)
+ [Spécification du format des cadres dans AWS WA Tool](lenses-format-specification.md)

# Affichage des cadres personnalisés dans AWS WA Tool
<a name="lenses-viewing"></a>

Vous pouvez afficher les détails des cadres personnalisés que vous possédez et des cadres personnalisés qui ont été partagés avec vous.

**Pour afficher un cadre**

1. Connectez-vous à la AWS Management Console et ouvrez la console de l’AWS Well-Architected Tool à l’adresse [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/).

1. Dans le volet de navigation de gauche, choisissez **Lentilles personnalisées**.
**Note**  
 La section **Lentilles personnalisées** est vide si vous n’avez pas créé de cadre personnalisé ou si aucun cadre personnalisé n’a été partagé avec vous. 

1. Choisissez les cadres personnalisés que vous souhaitez afficher :
   + **En ma possession** : affiche les cadres personnalisés que vous avez créés.
   + **En partage** : affiche les cadres personnalisés qui ont été partagés avec vous.

1. Sélectionnez le cadre personnalisé à afficher de l’une des manières suivantes :
   + Choisissez le nom du cadre.
   + Sélectionnez le cadre et choisissez **Afficher les détails**.

La page [Affichage des détails des cadres pour une charge de travail dans AWS WA Tool](lenses-details.md) s’affiche.

La page **Cadres personnalisés** contient les champs suivants :

**Nom**  
Nom du cadre.

**Propriétaire**  
Identifiant du Compte AWS propriétaire du cadre personnalisé.

**Statut**  
Le statut **PUBLIÉ** signifie que le cadre personnalisé a été publié et peut être appliqué aux charges de travail ou partagé avec d’autres Comptes AWS.  
Le statut **BROUILLON** signifie que le cadre personnalisé a été créé mais n’a pas encore été publié. Un cadre personnalisé doit être publié avant de pouvoir être appliqué aux charges de travail ou partagé.

**Version**  
Nom de la version du cadre personnalisé.

**Dernière mise à jour**  
Date et heure de la dernière mise à jour des cadres personnalisés.

# Création d’un cadre personnalisé pour une charge de travail dans AWS WA Tool
<a name="lenses-create"></a>

**Pour créer un cadre personnalisé**

1. Connectez-vous à la AWS Management Console et ouvrez la console de l’AWS Well-Architected Tool à l’adresse [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/).

1. Dans le volet de navigation de gauche, choisissez **Lentilles personnalisées**.

1. Choisissez **Créer un cadre personnalisé**.

1. Choisissez **Télécharger le fichier** pour télécharger le fichier de modèle JSON.

1. Ouvrez le fichier de modèle JSON avec votre éditeur de texte préféré et ajoutez les données pour votre cadre personnalisé. Ces données incluent vos piliers, vos questions, vos bonnes pratiques et les liens vers les plans d’amélioration.

   Pour plus d'informations, consultez [Spécification du format des cadres dans AWS WA Tool](lenses-format-specification.md). La taille d’un cadre personnalisé ne peut pas dépasser 500 Ko.

1. Choisissez **Choisir un fichier** pour sélectionner votre fichier JSON.

1. (Facultatif) Dans la section **Balises**, ajoutez les balises que vous souhaitez associer au cadre personnalisé.

1. Choisissez **Soumettre et prévisualiser** pour prévisualiser le cadre personnalisé, ou **Soumettre** pour soumettre le cadre personnalisé sans prévisualisation.

   Si vous choisissez de **soumettre et prévisualiser** votre cadre personnalisé, vous pouvez sélectionner **Suivant** pour naviguer dans l’aperçu du cadre, ou sélectionner **Quitter l’aperçu** pour revenir à la page **Lentilles personnalisées**.

Si la validation échoue, modifiez votre fichier JSON et réessayez de créer le cadre personnalisé.

Une fois qu’AWS WA Tool a validé votre fichier JSON, votre cadre personnalisé est affiché dans **Lentilles personnalisées**.

Une fois qu’un cadre personnalisé a été créé, il passe au statut **BROUILLON**. Vous devez [publier le cadre](lenses-publish.md) avant de l’appliquer à des charges de travail ou de le partager avec d’autres Comptes AWS. 

Vous pouvez créer jusqu’à 15 cadres personnalisés dans un Compte AWS.

**Exclusion de responsabilité**  
N’incluez et ne collectez pas de données d’identification personnelle (PII) d’utilisateurs finaux ou d’autres personnes identifiables dans ou via vos cadres personnalisés. Si votre cadre personnalisé ou ceux partagés avec vous et utilisés dans votre compte incluent ou collectent des données d’identification personnelle, vous devez : vous assurer que les données d’identification personnelle incluses sont traitées conformément à la loi applicable, fournir des avis de confidentialité adéquats et obtenir les consentements nécessaires pour traiter ces données.

# Prévisualisation d’un cadre personnalisé pour une charge de travail dans AWS WA Tool
<a name="lenses-preview"></a>

**Pour prévisualiser un cadre personnalisé**

1. Connectez-vous à la AWS Management Console et ouvrez la console de l’AWS Well-Architected Tool à l’adresse [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/).

1. Dans le volet de navigation de gauche, choisissez **Lentilles personnalisées**.

1. Seuls les cadres dotés du statut **BROUILLON** peuvent être prévisualisés. Sélectionnez le cadre personnalisé **BROUILLON** souhaité et choisissez **Prévisualiser l’expérience**.

1. Choisissez **Suivant** pour parcourir l’aperçu du cadre.

1. (Facultatif) Vous pouvez examiner votre **plan d’amélioration** en sélectionnant les bonnes pratiques pour chaque question de l’aperçu et en choisissant **Mettre à jour selon les réponses** pour tester votre logique de risque. Si des modifications sont nécessaires, vous pouvez mettre à jour les [règles de risque](lenses-format-specification.md#lenses-format-risk-rules) dans votre modèle JSON avant de le publier. 

1. Choisissez **Quitter l’aperçu** pour revenir au cadre personnalisé.

**Note**  
Vous pouvez également prévisualiser un cadre personnalisé en sélectionnant **Soumettre et prévisualiser** lors de la [création d’un cadre personnalisé](lenses-create.md). 

# Publication d’un cadre personnalisé dans AWS WA Tool pour la première fois
<a name="lenses-publish"></a>

**Pour publier un cadre personnalisé**

1. Connectez-vous à la AWS Management Console et ouvrez la console de l’AWS Well-Architected Tool à l’adresse [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/).

1. Dans le volet de navigation de gauche, choisissez **Lentilles personnalisées**.

1. Sélectionnez le cadre personnalisé souhaité, puis choisissez **Publier la lentille**.

1. Dans le champ **Nom de la version**, entrez un identifiant unique pour le changement de version. Cette valeur peut comporter jusqu’à 32 caractères et ne doit contenir que des caractères alphanumériques et des points (« . »).

1. Choisissez **Publier une lentille personnalisée**.

   Une fois qu’un cadre personnalisé a été publié, il prend le statut **PUBLIÉ**. 

Le cadre personnalisé peut désormais être appliqué aux charges de travail ou partagé avec d’autres utilisateurs ou Comptes AWS.

# Publication d’une mise à jour d’un cadre personnalisé dans AWS WA Tool
<a name="lenses-publish-update"></a>

**Pour publier une mise à jour d’un cadre personnalisé existant**

1. Connectez-vous à la AWS Management Console et ouvrez la console de l’AWS Well-Architected Tool à l’adresse [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/).

1. Dans le volet de navigation de gauche, choisissez **Lentilles personnalisées**.

1. Sélectionnez le cadre personnalisé souhaité et choisissez **Modifier**.

1. Si aucun fichier JSON mis à jour n’est prêt, choisissez **Télécharger le fichier** pour télécharger une copie du cadre personnalisé actuel. Modifiez le fichier JSON téléchargé à l’aide de votre éditeur de texte préféré et apportez les modifications souhaitées.

1. Choisissez **Choisir un fichier** pour sélectionner votre fichier JSON mis à jour et choisissez **Soumettre et prévisualiser** pour prévisualiser le cadre personnalisé, ou **Soumettre** pour soumettre le cadre personnalisé sans prévisualisation.

   La taille d’un cadre personnalisé ne peut pas dépasser 500 Ko.

   Une fois qu’AWS WA Tool a validé votre fichier JSON, votre cadre personnalisé est affiché dans **Lentilles personnalisées** avec le statut **BROUILLON**.

1. Sélectionnez à nouveau le cadre personnalisé et choisissez **Publier la lentille**.

1. Choisissez **Vérifier les modifications avant de les publier** pour vérifier que les modifications apportées à votre cadre personnalisé sont correctes. Cela inclut la validation des éléments suivants :
   + Nom du cadre personnalisé
   + Noms des piliers
   + Questions nouvelles, mises à jour et supprimées

   Choisissez **Suivant**.

1. Spécifiez le type de changement de version.  
**Version majeure**  
Indique que des changements substantiels ont été apportés au cadre. À utiliser pour les changements qui ont un impact sur la signification du cadre personnalisé.  
Toutes les charges de travail auxquelles le cadre a été appliqué seront informées qu’une nouvelle version du cadre personnalisé est disponible.  
Les changements de version majeurs *ne sont pas* automatiquement appliqués aux charges de travail utilisant le cadre.  
**Version mineure**  
Indique que des changements mineurs ont été apportés au cadre. À utiliser pour de petites modifications, telles que des modifications de texte ou des mises à jour des liens URL.  
Les changements de version mineurs sont automatiquement appliqués aux charges de travail utilisant le cadre personnalisé.

   Choisissez **Suivant**.

1. Dans le champ **Nom de la version**, entrez un identifiant unique pour le changement de version. Cette valeur peut comporter jusqu’à 32 caractères et ne doit contenir que des caractères alphanumériques et des points (« . »).

1. Choisissez **Publier une lentille personnalisée**.

   Une fois qu’un cadre personnalisé a été publié, il prend le statut **PUBLIÉ**. 

Le cadre personnalisé mis à jour peut désormais être appliqué aux charges de travail ou partagé avec d’autres utilisateurs ou Comptes AWS.

Si la mise à jour est un *changement de version majeur*, toutes les charges de travail associées à la version précédente du cadre seront informées qu’une nouvelle version est disponible et auront la possibilité de procéder à une mise à niveau.

Les mises à jour de version mineure sont automatiquement appliquées sans notification.

Vous pouvez créer jusqu’à 100 versions d’un cadre personnalisé.

# Partage d’un cadre personnalisé dans AWS WA Tool
<a name="lenses-sharing"></a>

Vous pouvez partager un cadre personnalisé avec d’autres Comptes AWS, utilisateurs et unités d’organisation (UO).

**Pour partager un cadre personnalisé avec d’autres Comptes AWS et utilisateurs**

1. Connectez-vous à la AWS Management Console et ouvrez la console de l’AWS Well-Architected Tool à l’adresse [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/).

1. Dans le volet de navigation de gauche, choisissez **Lentilles personnalisées**.

1. Sélectionnez le cadre personnalisé à partager et choisissez **Afficher les détails**.

1. Sur la page [Affichage des détails des cadres pour une charge de travail dans AWS WA Tool](lenses-details.md), choisissez **Partagers**. Choisissez ensuite **Créer** et **Créer des partages avec des comptes ou des utilisateurs** pour créer une invitation de partage de cadre.

1. Saisissez l’ID de Compte AWS à 12 chiffres ou l’ARN de l’utilisateur avec lequel vous souhaitez partager le cadre personnalisé.

1. Choisissez **Créer** pour envoyer une invitation de partage de cadre au Compte AWS ou à l’utilisateur spécifié.

Vous pouvez partager un cadre personnalisé avec un maximum de 300 Comptes AWS ou utilisateurs.

Si l’invitation de partage de cadre n’est pas acceptée dans les sept jours, elle expire automatiquement. 

**Important**  
Avant de partager un cadre personnalisé avec une organisation ou des unités d’organisation (UO), vous devez [activer l’accès AWS Organizations](sharing.md#getting-started-sharing-orgs).

**Pour partager un cadre personnalisé avec votre organisation ou vos unités d’organisation**

1. Connectez-vous à la AWS Management Console et ouvrez la console de l’AWS Well-Architected Tool à l’adresse [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/).

1. Dans le volet de navigation de gauche, choisissez **Lentilles personnalisées**.

1. Sélectionnez le cadre personnalisé à partager.

1. Sur la page [Affichage des détails des cadres pour une charge de travail dans AWS WA Tool](lenses-details.md), choisissez **Partagers**. Choisissez ensuite **Créer** and **Créer des partages avec des organisations**.

1. Sur la page **Créer un partage de lentille personnalisée**, choisissez d’accorder des autorisations à l’ensemble de l’organisation ou à une ou plusieurs unités d’organisation.

1. Choisissez **Créer** pour partager le cadre personnalisé.

Pour savoir qui a un accès partagé à un cadre personnalisé, choisissez **Partages** dans la page [Affichage des détails des cadres pour une charge de travail dans AWS WA Tool](lenses-details.md).

**Exclusion de responsabilité**  
En partageant vos cadres personnalisés avec d’autres Comptes AWS, vous reconnaissez qu’AWS mettra vos cadres personnalisés à la disposition de ces autres comptes. Ces autres comptes pourront continuer à accéder à vos cadres personnalisés partagés et à les utiliser même si vous supprimez les cadres personnalisés de votre propre Compte AWS ou si vous résiliez votre Compte AWS.

# Ajout de balises à un cadre personnalisé dans AWS WA Tool
<a name="lenses-tagging"></a>

**Pour ajouter des balises à un cadre personnalisé**

1. Connectez-vous à la AWS Management Console et ouvrez la console de l’AWS Well-Architected Tool à l’adresse [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/).

1. Dans le volet de navigation de gauche, choisissez **Lentilles personnalisées**.

1. Sélectionnez le cadre personnalisé que vous souhaitez mettre à jour.

1. Dans la section **Balises**, choisissez **Gérer les balises**.

1. Sélectionnez **Ajouter une nouvelle balise** et entrez la **clé** et la **valeur** de chaque balise à ajouter.

1. Sélectionnez **Save**. 

Pour supprimer une balise, choisissez **Supprimer** en regard de la balise que vous souhaitez supprimer. 

# Suppression d’un cadre personnalisé dans AWS WA Tool
<a name="lenses-deleting"></a>

**Pour supprimer un cadre personnalisé**

1. Connectez-vous à la AWS Management Console et ouvrez la console de l’AWS Well-Architected Tool à l’adresse [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/).

1. Dans le volet de navigation de gauche, choisissez **Lentilles personnalisées**.

1. Sélectionnez le cadre personnalisé à supprimer, puis choisissez **Supprimer**.

1. Sélectionnez **Delete (Supprimer)**.

   Les charges de travail existantes auxquelles le cadre est appliqué sont informées que le cadre personnalisé a été supprimé, mais peuvent continuer à l’utiliser. Le cadre personnalisé ne peut plus être appliqué aux nouvelles charges de travail.

**Exclusion de responsabilité**  
En partageant vos cadres personnalisés avec d’autres Comptes AWS, vous reconnaissez qu’AWS mettra vos cadres personnalisés à la disposition de ces autres comptes. Ces autres comptes pourront continuer à accéder à vos cadres personnalisés partagés et à les utiliser même si vous supprimez les cadres personnalisés de votre propre Compte AWS ou si vous résiliez votre Compte AWS.

# Spécification du format des cadres dans AWS WA Tool
<a name="lenses-format-specification"></a>

Les cadres sont définis à l’aide d’un format JSON spécifique. Lorsque vous commencez à créer un cadre personnalisé, vous avez la possibilité de télécharger un fichier de modèle JSON. Vous pouvez utiliser ce fichier comme base pour vos cadres personnalisés car il définit la structure de base des piliers, des questions, des bonnes pratiques et du plan d’amélioration.

## Section du cadre
<a name="lenses-format-lens"></a>

Cette section définit les attributs du cadre personnalisé lui-même. Il s’agit de son nom et de sa description.
+ `schemaVersion` : version du schéma du cadre personnalisé à utiliser. Défini par le modèle, à ne pas modifier.
+ `name` : nom du cadre. La longueur maximale du nom est de 128 caractères. 
+ `description` : description textuelle du cadre. Ce texte s’affiche lorsque vous sélectionnez des cadres à ajouter lors de la création de la charge de travail ou lorsque vous sélectionnez un cadre à appliquer ultérieurement à une charge de travail existante. La description peut comporter jusqu’à 2 048 caractères.

```
    "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.",
```

## Section « pillars »
<a name="lenses-format-pillars"></a>

Cette section définit les piliers associés au cadre personnalisé. Vous pouvez mapper vos questions aux piliers du cadre AWS Well-Architected, définir vos propres piliers, ou les deux.

Vous pouvez définir jusqu’à 10 piliers dans un cadre personnalisé.
+ `id` : ID du pilier. L’identifiant peut comporter entre 3 et 128 caractères et ne peut contenir que des caractères alphanumériques et des traits de soulignement (« \$1 »). Les identifiants utilisés dans un pilier doivent être uniques. 

  Lorsque vous mappez vos questions aux piliers du cadre, utilisez les identifiants suivants :
  + `operationalExcellence`
  + `security`
  + `reliability`
  + `performance`
  + `costOptimization`
  + `sustainability`
+ `name` : nom du pilier. La longueur maximale du nom est de 128 caractères.

```
     "pillars": [
        {
            "id": "company_Privacy",
            "name": "Privacy Excellence",
            .
            .
            .
        },
        {
            "id": "company_Security",
            "name": "Security",
            .
            .
            .
        }
     ]
```

## Section « questions »
<a name="lenses-format-questions"></a>

Cette section définit les questions associées à un pilier.

Vous pouvez définir jusqu’à 20 questions dans un pilier d’un cadre personnalisé.
+ `id` : identifiant de la question. L’identifiant peut comporter entre 3 et 128 caractères et ne peut contenir que des caractères alphanumériques et des traits de soulignement (« \$1 »). Les identifiants utilisés dans une question doivent être uniques. 
+ `title` : intitulé de la question. La longueur maximale de l’intitulé est de 128 caractères.
+ `description` : décrit la question de manière plus détaillée. La description peut comporter jusqu’à 2 048 caractères.
+ `helpfulResource displayText` : facultatif. Texte fournissant des informations utiles sur la question. La longueur maximale du texte est de 2 048 caractères. Il doit être spécifié, si `helpfulResource url` est spécifié. 
+ `helpfulResource url` : facultatif. Une ressource URL qui explique la question plus en détail. L’URL doit commencer par `http://` ou `https://`.

**Note**  
 Lorsque vous synchronisez la charge de travail d’un cadre personnalisé avec Jira, la section « questions » affiche à la fois les éléments « id » et « title » de la question.   
 Le format utilisé dans les tickets Jira est `[ 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"
        },
        .
        .
        .
    }
]
```

## Section « choices »
<a name="lenses-format-choices"></a>

Cette section définit les choix associées à une question.

Vous pouvez définir jusqu’à 15 choix pour une question dans un cadre personnalisé.
+ `id` : identifiant du choix. L’identifiant peut comporter entre 3 et 128 caractères et ne peut contenir que des caractères alphanumériques et des traits de soulignement (« \$1 »). Un identifiant unique doit être spécifié pour chaque choix d’une question. L’ajout d’un choix avec le suffixe `_no` fera office de choix `None of these` pour la question. 
+ `title` : intitulé du choix. La longueur maximale de l’intitulé est de 128 caractères.
+ `helpfulResource displayText` : facultatif. Texte fournissant des informations utiles sur un choix. La longueur maximale du texte est de 2 048 caractères. Doit être inclus si `helpfulResource url` est spécifié.
+ `helpfulResource url` : facultatif. Une ressource URL qui explique le choix plus en détail. L’URL doit commencer par `http://` ou `https://`.
+ `improvementPlan displayText` : texte qui décrit comment un choix peut être amélioré. La longueur maximale du texte est de 2 048 caractères. Un élément `improvementPlan` est requis pour chaque choix, sauf pour un choix `None of these`.
+ `improvementPlan url` : facultatif. Une ressource URL qui peut contribuer à l’amélioration. L’URL doit commencer par `http://` ou `https://`.
+ `additionalResources type` : facultatif. Type de ressources supplémentaires. La valeur peut être `HELPFUL_RESOURCE` ou `IMPROVEMENT_PLAN`.
+ `additionalResources content` : facultatif. Spécifie les valeurs `displayText` et `url` pour la ressource supplémentaire. Jusqu’à cinq ressources utiles supplémentaires et jusqu’à cinq éléments supplémentaires du plan d’amélioration peuvent être spécifiés pour un choix.
  + `displayText` : facultatif. Texte décrivant la ressource utile ou le plan d’amélioration. La longueur maximale du texte est de 2 048 caractères. Doit être inclus si `url` est spécifié.
  + `url` : facultatif. Une ressource URL pour la ressource utile ou le plan d’amélioration. L’URL doit commencer par `http://` ou `https://`.

**Note**  
 Lorsque vous synchronisez une charge de travail de cadre personnalisé avec Jira, les choix affichent l’élément « id » de la question et du choix, ainsi que l’élément « title » du choix.   
 Le format utilisé est `[ 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"
              }
              
            }
```

## Section des règles de risque
<a name="lenses-format-risk-rules"></a>

Cette section définit comment les choix sélectionnés déterminent le niveau de risque.

Vous pouvez définir un maximum de trois règles de risque par question, une pour chaque niveau de risque.
+ `condition` : expression booléenne des choix correspondant au niveau de risque de la question, ou `default`.

  Il doit exister une règle de risque `default` pour chaque question.
+ `risk` : indique le risque associé à la condition. Les valeurs valides sont `HIGH_RISK`, `MEDIUM_RISK` et `NO_RISK`.

L’ordre de vos règles de risque est important. La première `condition` qui a pour valeur `true` définit le risque associé à la question. Un modèle courant de mise en œuvre des règles de risque consiste à commencer par les règles les moins risquées (et généralement les plus précises) et à poursuivre jusqu’aux règles les plus risquées (et les moins spécifiques).

Par exemple :

```
 "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"
       }
 ]
```

Si la question comporte trois choix (`choice_1`, `choice_2` et `choice_3`), ces règles de risque entraînent le comportement suivant :
+ Si les trois choix sont sélectionnés, il n’y a aucun risque.
+ Si `choice_1` ou `choice_2` est sélectionné **et** si `choice_3` est sélectionné, le risque est moyen.
+ Si `choice_1` **n’est pas** sélectionné mais que `choice_3` est sélectionné, le risque est moyen également.
+ Si aucune de ces conditions préalables n’est vraie, le risque est élevé.