# Obiettivi personalizzati per carichi di lavoro in AWS WA Tool È possibile creare obiettivi personalizzati sulla base di propri pilastri, domande, best practice e piani di miglioramento. Gli obiettivi personalizzati vengono applicati a un carico di lavoro nello stesso modo in cui si utilizzano gli obiettivi forniti da AWS. È anche possibile condividere gli obiettivi personalizzati creati dall'utente con altri Account AWS e gli obiettivi personalizzati di proprietà di altri possono essere condivisi con l'utente. Si possono modificare le domande per renderle personalizzate e specifiche per una particolare tecnologia, in modo da consentire di rispondere alle esigenze di governance dell'organizzazione o estendere le linee guida fornite da Framework Well-Architected e dagli obiettivi AWS. Analogamente agli obiettivi esistenti, è possibile monitorare i progressi nel tempo creando tappe fondamentali e fornire periodicamente lo stato generando report. **Topics** + [Visualizzazione di obiettivi personalizzati in AWS WA Tool](lenses-viewing.md) + [Creazione di un obiettivo personalizzato per un carico di lavoro in AWS WA Tool](lenses-create.md) + [Visualizzazione in anteprima di un obiettivo personalizzato per un carico di lavoro in AWS WA Tool](lenses-preview.md) + [Pubblicazione di un obiettivo personalizzato in AWS WA Tool per la prima volta](lenses-publish.md) + [Pubblicazione di un aggiornamento di un obiettivo personalizzato in AWS WA Tool](lenses-publish-update.md) + [Condivisione di un obiettivo personalizzato in AWS WA Tool](lenses-sharing.md) + [Aggiunta di tag a un obiettivo personalizzato in AWS WA Tool](lenses-tagging.md) + [Eliminazione di un obiettivo personalizzato in AWS WA Tool](lenses-deleting.md) + [Specificazione del formato dell'obiettivo in AWS WA Tool](lenses-format-specification.md) # Visualizzazione di obiettivi personalizzati in AWS WA Tool È possibile visualizzare i dettagli degli obiettivi personalizzati di proprietà dell'utente e condivisi con l'utente. **Per visualizzare un obiettivo** 1. Accedi alla Console di gestione AWS e apri la console dello AWS Well-Architected Tool all'indirizzo [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/). 1. Nel riquadro di navigazione a sinistra, scegliere **Obiettivi personalizzati**. **Nota** La sezione **Obiettivi personalizzati** è vuota se non hai creato un obiettivo personalizzato o se non ne è stato condiviso uno con te. 1. Scegliere l'obiettivo personalizzato da visualizzare: + **Di mia proprietà**: mostra gli obiettivi personalizzati creati dall'utente. + **Condiviso con me**: mostra gli obiettivi personalizzati condivisi con l'utente. 1. Selezionare l'obiettivo personalizzato da visualizzare in uno dei seguenti modi: + Scegliere il nome dell'obiettivo. + Selezionare l'obiettivo e scegliere **Visualizza dettagli**. Viene visualizzata la pagina [Visualizzazione dei dettagli dell'obiettivo per un carico di lavoro in AWS WA Tool](lenses-details.md). La pagina **Obiettivi personalizzati** include i seguenti campi: **Nome** Nome dell'obiettivo. **Owner** L'ID dell'Account AWS proprietario dell'obiettivo personalizzato. **Stato** Lo stato **PUBBLICATO** indica che l'obiettivo personalizzato è stato pubblicato e può essere applicato ai carichi di lavoro o condiviso con altri Account AWS. Lo stato **BOZZA** indica che l'obiettivo personalizzato è stato creato ma non è ancora stato pubblicato. Un obiettivo personalizzato deve essere pubblicato prima di poter essere applicato ai carichi di lavoro o condiviso. **Versione** Il nome della versione dell'obiettivo personalizzato. **Ultimo aggiornamento** Data e ora dell'ultimo aggiornamento dell'obiettivo personalizzato. # Creazione di un obiettivo personalizzato per un carico di lavoro in AWS WA Tool **Per creare un obiettivo personalizzato** 1. Accedi alla Console di gestione AWS e apri la console dello AWS Well-Architected Tool all'indirizzo [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/). 1. Nel riquadro di navigazione a sinistra, scegliere **Obiettivi personalizzati**. 1. Scegliere **Crea obiettivo personalizzato**. 1. Per scaricare il file di modello JSON scegliere **Scarica file**. 1. Aprire il file di modello JSON con l'editor di testo preferito e aggiungere i dati dell'obiettivo personalizzato. Questi dati includono pilastri, domande, best practice e link dei piani di miglioramento. Fare riferimento a [Specificazione del formato dell'obiettivo in AWS WA Tool](lenses-format-specification.md) per ulteriori dettagli. Un obiettivo personalizzato non può superare la dimensione di 500 KB. 1. Selezionare **Scegli file** per scegliere il file JSON. 1. (Facoltativo) Nella sezione **Tag** aggiungere eventuali tag da associare all'obiettivo personalizzato. 1. Scegliere **Invia e anteprima** per visualizzare l'anteprima dell'obiettivo personalizzato o **Invia** per inviare l'obiettivo personalizzato senza visualizzarlo in anteprima. Se si sceglie **Invia e anteprima** per l'obiettivo personalizzato, è possibile selezionare **Avanti** per visualizzare l'anteprima dell'obiettivo o selezionare **Esci dall'anteprima** per tornare a **Obiettivi personalizzati**. Se la convalida non riesce, modificare il file JSON e provare a creare nuovamente l'obiettivo personalizzato. Una volta che AWS WA Tool convalida il file JSON, l'obiettivo personalizzato viene visualizzato in **Obiettivi personalizzati**. Una volta creato, l'obiettivo personalizzato è nello stato **BOZZA**. È necessario [pubblicare l'obiettivo](lenses-publish.md) prima che possa essere applicato ai carichi di lavoro o condiviso con altri Account AWS. È possibile creare fino a 15 obiettivi personalizzati in un Account AWS. **Dichiarazione di non responsabilità** Non includere o raccogliere informazioni di identificazione personale (PII) degli utenti finali o di altre persone all'interno o tramite gli obiettivi personalizzati. Se gli obiettivi personalizzati o quelli condivisi e utilizzati nell'account dell'utente includono o raccolgono informazioni di identificazione personale, è necessario garantire che tali informazioni incluse vengano trattate in conformità alla normativa applicabile, fornendo l'adeguata informativa sulla privacy e ottenendo il consenso necessario per il trattamento dei dati. # Visualizzazione in anteprima di un obiettivo personalizzato per un carico di lavoro in AWS WA Tool **Per visualizzare in anteprima un obiettivo personalizzato** 1. Accedi alla Console di gestione AWS e apri la console dello AWS Well-Architected Tool all'indirizzo [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/). 1. Nel riquadro di navigazione a sinistra, scegliere **Obiettivi personalizzati**. 1. È possibile visualizzare in anteprima solo gli obiettivi con lo stato **BOZZA**. Selezionare l'obiettivo personalizzato desiderato nello stato **BOZZA** e scegliere **Anteprima esperienza**. 1. Scegliere **Avanti** per visualizzare l'anteprima dell'obiettivo. 1. (Facoltativo) È possibile esaminare il **Piano di miglioramento** selezionando le best practice all'interno di ogni domanda dell'anteprima e scegliendo **Aggiorna in base alle risposte** per testare la logica di rischio. Se sono necessarie modifiche, è possibile aggiornare le [regole di rischio](lenses-format-specification.md#lenses-format-risk-rules) nel modello JSON prima della pubblicazione. 1. Scegliere **Esci dall'anteprima** per tornare all'obiettivo personalizzato. **Nota** È possibile visualizzare l'anteprima di un obiettivo personalizzato anche selezionando **Invia e anteprima** durante [la creazione di un obiettivo personalizzato](lenses-create.md). # Pubblicazione di un obiettivo personalizzato in AWS WA Tool per la prima volta **Per pubblicare un obiettivo personalizzato** 1. Accedi alla Console di gestione AWS e apri la console dello AWS Well-Architected Tool all'indirizzo [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/). 1. Nel riquadro di navigazione a sinistra, scegliere **Obiettivi personalizzati**. 1. Selezionare l'obiettivo personalizzato desiderato e scegliere **Pubblica obiettivo**. 1. Nella casella **Nome versione**, inserire un identificatore univoco per la modifica della versione. Questo valore può contenere fino a 32 caratteri alfanumerici o punti ("."). 1. Scegliere **Pubblica obiettivo personalizzato**. Dopo la pubblicazione, lo stato dell'obiettivo personalizzato diventa **PUBBLICATO**. L'obiettivo personalizzato ora può essere applicato ai carichi di lavoro o condiviso con altri Account AWS o utenti. # Pubblicazione di un aggiornamento di un obiettivo personalizzato in AWS WA Tool **Per pubblicare un aggiornamento di un obiettivo personalizzato esistente** 1. Accedi alla Console di gestione AWS e apri la console dello AWS Well-Architected Tool all'indirizzo [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/). 1. Nel riquadro di navigazione a sinistra, scegliere **Obiettivi personalizzati**. 1. Selezionare l'obiettivo personalizzato desiderato e scegliere **Modifica**. 1. Se non è disponibile un file JSON aggiornato, scegliere **Scarica file** per scaricare una copia dell'obiettivo personalizzato corrente. Modificare il file JSON scaricato con l'editor di testo preferito e apportare le modifiche desiderate. 1. Selezionare **Scegli file** per selezionare il file JSON aggiornato e scegliere **Invia e anteprima** per visualizzare l'anteprima dell'obiettivo personalizzato oppure **Invia** per inviare l'obiettivo personalizzato senza visualizzarlo in anteprima. Un obiettivo personalizzato non può superare la dimensione di 500 KB. Una volta che AWS WA Tool convalida il file JSON, l'obiettivo personalizzato viene visualizzato in **Obiettivi personalizzati** nello stato **BOZZA**. 1. Selezionare nuovamente l'obiettivo personalizzato e scegliere **Pubblica obiettivo**. 1. Scegliere **Esamina le modifiche prima della pubblicazione** per verificare che le modifiche apportate all'obiettivo personalizzato siano corrette. È inclusa la convalida dei seguenti elementi: + Il nome dell'obiettivo personalizzato + I nomi dei pilastri + Le domande nuove, aggiornate ed eliminate Scegli **Next (Successivo)**. 1. Specificare il tipo di modifica della versione. **Versione principale** Indica che sono state apportate modifiche sostanziali all'obiettivo. Si utilizza per le modifiche che influiscono sul significato dell'obiettivo personalizzato. A tutti i carichi di lavoro con l'obiettivo applicato verrà comunicato che è disponibile una nuova versione dell'obiettivo personalizzato. Le modifiche della versione principale *non* vengono applicate automaticamente ai carichi di lavoro che utilizzano l'obiettivo. **Versione secondaria** Indica che sono state apportate modifiche secondarie all'obiettivo. Si usa per piccole modifiche, come modifiche al testo o aggiornamenti dei link URL. Le modifiche della versione secondaria vengono applicate automaticamente ai carichi di lavoro che utilizzano l'obiettivo personalizzato. Scegli **Next (Successivo)**. 1. Nella casella **Nome versione**, inserire un identificatore univoco per la modifica della versione. Questo valore può contenere fino a 32 caratteri alfanumerici o punti ("."). 1. Scegliere **Pubblica obiettivo personalizzato**. Dopo la pubblicazione, lo stato dell'obiettivo personalizzato diventa **PUBBLICATO**. L'obiettivo personalizzato aggiornato ora può essere applicato ai carichi di lavoro o condiviso con altri Account AWS o utenti. Se l'aggiornamento è una *modifica della versione principale*, a tutti i carichi di lavoro a cui è stata applicata la versione precedente dell'obiettivo verrà notificata la disponibilità di una nuova versione con la possibilità di effettuare l'aggiornamento. Gli aggiornamenti della versione secondaria vengono applicati automaticamente senza notifica. È possibile creare fino a 100 versioni di un obiettivo personalizzato. # Condivisione di un obiettivo personalizzato in AWS WA Tool È possibile condividere un obiettivo personalizzato con altri Account AWS, utenti, AWS Organizations e unità organizzative (UO). **Per condividere un obiettivo personalizzato con altri Account AWS e utenti** 1. Accedi alla Console di gestione AWS e apri la console dello AWS Well-Architected Tool all'indirizzo [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/). 1. Nel riquadro di navigazione a sinistra, scegliere **Obiettivi personalizzati**. 1. Selezionare l'obiettivo personalizzato da condividere e scegliere **Visualizza dettagli**. 1. Nella pagina [Visualizzazione dei dettagli dell'obiettivo per un carico di lavoro in AWS WA Tool](lenses-details.md), scegliere **Condivisioni**. Quindi scegliere **Crea** e **Creazione di condivisioni per utenti o account** per creare un invito di condivisione dell'obiettivo. 1. Immettere l'ID Account AWS a 12 cifre o l'ARN dell'utente con cui si desidera condividere l'obiettivo personalizzato. 1. Scegliere **Crea** per inviare un invito di condivisione dell'obiettivo all'utente o all'Account AWS specificato. È possibile condividere obiettivi personalizzati con un massimo di 300 Account AWS o utenti. L'invito di condivisione dell'obiettivo scade automaticamente se non viene accettato entro sette giorni. **Importante** Prima di condividere un obiettivo personalizzato con l'organizzazione o le unità organizzative (UO), è necessario [abilitare l'accesso ad AWS Organizations](sharing.md#getting-started-sharing-orgs). **Per condividere un obiettivo personalizzato con l'organizzazione o le unità organizzative** 1. Accedi alla Console di gestione AWS e apri la console dello AWS Well-Architected Tool all'indirizzo [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/). 1. Nel riquadro di navigazione a sinistra, scegliere **Obiettivi personalizzati**. 1. Selezionare l'obiettivo personalizzato da condividere. 1. Nella pagina [Visualizzazione dei dettagli dell'obiettivo per un carico di lavoro in AWS WA Tool](lenses-details.md), scegliere **Condivisioni**. Quindi scegliere **Crea** e **Creazione di condivisioni per le Organizzazioni**. 1. Nella pagina **Crea condivisione dell'obiettivo personalizzato**, scegliere se concedere le autorizzazioni all'intera organizzazione oppure a una o più unità organizzative. 1. Scegliere **Crea** per condividere l'obiettivo personalizzato. Per vedere chi ha condiviso l'accesso a un obiettivo personalizzato, scegliere **Condivisioni** dalla pagina [Visualizzazione dei dettagli dell'obiettivo per un carico di lavoro in AWS WA Tool](lenses-details.md). **Dichiarazione di non responsabilità** Condividendo gli obiettivi personalizzati con altri Account AWS, si accetta che AWS li renda disponibili agli altri account. Questi altri account possono continuare ad accedere e utilizzare gli obiettivi personalizzati condivisi anche se si eliminano gli obiettivi personalizzati dal proprio Account AWS o si termina il proprio Account AWS. # Aggiunta di tag a un obiettivo personalizzato in AWS WA Tool **Per aggiungere tag a un obiettivo personalizzato** 1. Accedi alla Console di gestione AWS e apri la console dello AWS Well-Architected Tool all'indirizzo [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/). 1. Nel riquadro di navigazione a sinistra, scegliere **Obiettivi personalizzati**. 1. Selezionare l'obiettivo personalizzato da aggiornare. 1. Nella sezione **Tag** scegliere **Gestisci tag**. 1. Selezionare **Aggiungi nuovo tag** e immettere la **Chiave** e il **Valore **per ogni tag da aggiungere. 1. Seleziona **Salva**. Per rimuovere un tag, scegliere **Rimuovi** accanto al tag da eliminare. # Eliminazione di un obiettivo personalizzato in AWS WA Tool **Per eliminare un obiettivo personalizzato** 1. Accedi alla Console di gestione AWS e apri la console dello AWS Well-Architected Tool all'indirizzo [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/). 1. Nel riquadro di navigazione a sinistra, scegliere **Obiettivi personalizzati**. 1. Selezionare l'obiettivo personalizzato da eliminare e scegliere **Elimina**. 1. Scegliere **Delete** (Elimina). Ai carichi di lavoro esistenti con l'obiettivo applicato viene notificato che l'obiettivo personalizzato è stato eliminato, tuttavia possono continuare a utilizzarlo. L'obiettivo personalizzato non può più essere applicato a nuovi carichi di lavoro. **Dichiarazione di non responsabilità** Condividendo gli obiettivi personalizzati con altri Account AWS, si accetta che AWS li renda disponibili agli altri account. Questi altri account possono continuare ad accedere e utilizzare gli obiettivi personalizzati condivisi anche se si eliminano gli obiettivi personalizzati dal proprio Account AWS o si termina il proprio Account AWS. # Specificazione del formato dell'obiettivo in AWS WA Tool Gli obiettivi sono definiti utilizzando un formato JSON specifico. Quando si inizia a creare un obiettivo personalizzato, si ha la possibilità di scaricare un file JSON modello. È possibile utilizzare questo file come fondamento per gli obiettivi personalizzati in quanto definisce la struttura di base per i pilastri, le domande, le best practice e il piano di miglioramento. ## Sezione Obiettivi Questa sezione definisce gli attributi per l'obiettivo personalizzato. Indica il nome e la descrizione. + `schemaVersion`: la versione dello schema dell'obiettivo personalizzato da utilizzare. Impostata in base al modello, da non modificare. + `name`: il nome dell'obiettivo. Il nome può contenere fino a 128 caratteri. + `description`: la descrizione in formato testo dell'obiettivo. Questo testo viene visualizzato quando si selezionano gli obiettivi da aggiungere durante la creazione del carico di lavoro o quando si seleziona un obiettivo da applicare successivamente a un carico di lavoro esistente. La descrizione può contenere fino a 2048 caratteri. ``` "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.", ``` ## Sezione Pilastri Questa sezione definisce i pilastri associati all'obiettivo personalizzato. È possibile mappare le domande ai pilastri del Framework AWS Well-Architected, definire i pilastri o entrambe le attività. Si possono definire fino a 10 pilastri per un obiettivo personalizzato. + `id`: ID del pilastro. L'ID può contenere da 3 a 128 caratteri alfanumerici o di sottolineatura ("\$1"). Gli ID utilizzati in un pilastro devono essere univoci. Quando si mappano le domande ai pilastri del Framework, si devono usare i seguenti ID: + `operationalExcellence` + `security` + `reliability` + `performance` + `costOptimization` + `sustainability` + `name`: nome del pilastro. Il nome può contenere fino a 128 caratteri. ``` "pillars": [ { "id": "company_Privacy", "name": "Privacy Excellence", . . . }, { "id": "company_Security", "name": "Security", . . . } ] ``` ## Sezione Domande Questa sezione definisce le domande associate a un pilastro. Si possono definire fino a 20 domande in un pilastro di un obiettivo personalizzato. + `id`: ID della domanda. L'ID può contenere da 3 a 128 caratteri alfanumerici o di sottolineatura ("\$1"). Gli ID utilizzati in una domanda devono essere univoci. + `title`: titolo della domanda. Il titolo può contenere fino a 128 caratteri. + `description`: descrive la domanda in modo più dettagliato. La descrizione può contenere fino a 2048 caratteri. + `helpfulResource displayText`: facoltativo. Testo che fornisce informazioni utili sulla domanda. Il testo può contenere fino a 2048 caratteri. Deve essere immesso se viene specificato `helpfulResource url`. + `helpfulResource url`: facoltativo. Risorsa URL che spiega la domanda in modo più dettagliato. L'URL deve iniziare con `http://` o `https://`. **Nota** Quando si sincronizza un carico di lavoro personalizzato con Jira, le domande mostrano l'ID e il titolo. Il formato utilizzato nei ticket 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" }, . . . } ] ``` ## Sezione Scelte Questa sezione definisce le scelte associate a una domanda. Si possono definire fino a 15 scelte per una domanda di un obiettivo personalizzato. + `id`: ID della scelta. L'ID può contenere da 3 a 128 caratteri alfanumerici o di sottolineatura ("\$1"). È necessario specificare un ID univoco per ogni scelta di una domanda. L'aggiunta di una scelta con il suffisso `_no` equivale alla scelta `None of these` per la domanda. + `title`: titolo della scelta. Il titolo può contenere fino a 128 caratteri. + `helpfulResource displayText`: facoltativo. Testo che fornisce informazioni utili su una scelta. Il testo può contenere fino a 2048 caratteri. Deve essere incluso se viene specificato `helpfulResource url`. + `helpfulResource url`: facoltativo. Risorsa URL che spiega la scelta in modo più dettagliato. L'URL deve iniziare con `http://` o `https://`. + `improvementPlan displayText`: testo che descrive come migliorare una scelta. Il testo può contenere fino a 2048 caratteri. `improvementPlan` è obbligatorio per ogni scelta, ad eccezione della scelta `None of these`. + `improvementPlan url`: facoltativo. Risorsa URL che può contribuire al miglioramento. L'URL deve iniziare con `http://` o `https://`. + `additionalResources type`: facoltativo. Il tipo di risorse aggiuntive. Il valore può essere `HELPFUL_RESOURCE` o `IMPROVEMENT_PLAN`. + `additionalResources content`: facoltativo. Specifica i valori `displayText` e `url` per la risorsa aggiuntiva. È possibile specificare fino a cinque risorse aggiuntive utili e fino a cinque elementi aggiuntivi del piano di miglioramento per una scelta. + `displayText`: facoltativo. Testo che descrive la risorsa utile o il piano di miglioramento. Il testo può contenere fino a 2048 caratteri. Deve essere incluso se viene specificato `url`. + `url`: facoltativo. Risorsa URL per la risorsa utile o il piano di miglioramento. L'URL deve iniziare con `http://` o `https://`. **Nota** Quando si sincronizza un carico di lavoro di un obiettivo personalizzato con Jira, le scelte mostrano l'ID della domanda e della scelta, nonché il titolo della scelta. Il formato utilizzato è `[ 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" } } ``` ## Sezione Regole di rischio Questa sezione definisce in che modo le scelte selezionate determinano il livello di rischio. È possibile definire un massimo di tre regole di rischio per ogni domanda, una per ciascun livello di rischio. + `condition`: espressione booleana delle scelte che corrisponde a un livello di rischio per la domanda oppure `default`. Deve essere presente una regola di rischio `default` per ogni domanda. + `risk`: indica il rischio associato alla condizione. I valori validi sono `HIGH_RISK`, `MEDIUM_RISK` e `NO_RISK`. L'ordine delle regole di rischio è significativo. La prima `condition` che restituisce `true` stabilisce il rischio della domanda. Uno schema comune per l'implementazione delle regole di rischio consiste nell'iniziare con le regole meno rischiose (e in genere più granulari) per poi arrivare alle regole più rischiose (e meno specifiche). Per esempio: ``` "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" } ] ``` Se la domanda include tre scelte (`choice_1`, `choice_2` e `choice_3`), queste regole di rischio determinano il comportamento seguente: + Se sono selezionate tutte e tre le scelte, non vi è alcun rischio. + Se `choice_1` o `choice_2` è selezionata **e** `choice_3` è selezionata, il rischio è medio. + Se `choice_1` **non** è selezionata ma `choice_3` è selezionata, il rischio è sempre medio. + Se nessuna di queste condizioni precedenti è vera, il rischio è elevato.