> For the complete documentation index, see [llms.txt](https://docs.aligned.ch/aligned-elements-web-client-user-manual/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aligned.ch/aligned-elements-web-client-user-manual/3.2.300.26398/risk-analysis/perform-a-preliminary-hazard-analysis.md). # Perform a Preliminary Hazard Analysis When performing a **Risk Analysis** (also known as Preliminary Hazard Analysis), five different document object types are involved. The central document object is the **Risk Analysis** that describes the hazardous situation. It links to **Harms** and optionally **Measures** in the system and keeps these links as a **Probability Of Harm** object. As input to the Risk Analysis, zero or more **Causes** may be defined. {% hint style="info" %} **Note!** Aligned Elements provide a large number of configuration option when it comes to risk management. These configuration options include naming conventions, risk parameter design, risk calculations and a large number of behaviors and UI settings. When Risk Assessment are discussed here we specify them as two major input types: * Preliminary Hazard Analysis (PHA) * Failuremode and Effect Analysis (FMEA) #### Preliminary Hazard Analysis The Hazardous Situation and Foreseeable sequence of Events are entered in the main item. In the Risk Table, one or more Harms (with their severities) can be added where each can be associated with one or more (Risk Control) Measures. Each row in th etable is represented by an (AE internal and technical) Probability Of Harm (POH) item. Per default, two risk parameters are applied: severity, associated with the Harm and probability. #### Failuremode and Effect Analysis Effects (and their impacts/severities) and Causes (and their likelihoods/probabilities) are defined in separate input controls in the FM UI and automatically combined/permutated in the risk table below. Each row in the risk table is represented by an (AE internal and technical) Hazard item which can be associated with zero, one or more Mitigation items. Per default, three risk parameters are applied: severity (or impact), associated with the Effect, probability (or likelhood) associated with the Cause and Visibility, associated with the combination of Cause and Effect. Note that these are primarilly two types of risk input modes (with associated UI behaviors) in Aligned Elements! To accomodate the large variability among customer risk assessments, the large number of configuration possibilities makes it is entierly possible to configure an FMEA using the PHA Input type or a PHA using the FMEA input type! These configuration possibilities can also be used to model: * Process Risk Assessments * Cyber Security Risk Assessments * Usability Risk Assessments * etc. {% endhint %} {% hint style="info" %} Note! Causes, Measures and Harms can only be created directly from the Project Explorer. {% endhint %} Measures and Harms can be assigned to the Risk Analysis by clicking on **Add Row**. To remove an assigned object, please use the applicable **Remove Row** button. Causes can only be assigned by setting traces outside of the editor. A Cause should trace towards a Risk Analysis object. To create a Risk Analysis as above, follow these steps: 1\) Create a Risk Analysis item Create the item and fill in the **Hazardous Situation** text box. If applicable, fill out the section for **Foreseeable Sequence of Events**. 2\) Assign Harms to the Risk Analysis item Use the Plus button in the risk grid to add existing **Harms** or click **Create Harm** in the selection dialog to create and apply a new Harm. This will create a new row in the risk grid. 3\) Evaluate the Risk Use the dropdowns for risk parameters in the risk grid to assign **Probability** and **Severity** values to the Harm in question. The risk will be automatically calculated based on these parameters. 4\) Add Measures to the Risk Assign **Measures** to the risk using the plus button or **Create a new Measure** from the selection dialog. The residual risk will be calculated based on measures you add. After the Risk Analysis object has been saved, you may assign any Cause to the Risk Analysis by selecting **Trace From...** in the Actions drop-down and select one or more causes. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.aligned.ch/aligned-elements-web-client-user-manual/3.2.300.26398/risk-analysis/perform-a-preliminary-hazard-analysis.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.