# Automatic Case Creation from ICA - Cyto Array Analysis

### **Overview**

This feature enables automatic case creation in Emedgene following the successful completion of specific array analysis events on ICA. The automation supports efficient and standardized case generation, ensuring timely downstream review and interpretation.

### **When It Applies**

This feature is triggered when a **DRAGEN Array - Cytogenetics analysis with Emedgene tertiary interpretation** analysis is completed successfully on ICA.

<figure><img src="https://1131024994-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGCW0DnLlE7QjoZPNmKIi%2Fuploads%2Fgit-blob-c9b24bce5f83d6d8875f419d0ad277d1ca800157%2Fimage%20(7)%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

### **Prerequisites**

Before automatic case creation can occur, ensure the following conditions are met:

1. **The user needs to have access to BSSH and Emedgene in the same workgroup.**
2. **The managed ICA project must be** [**connected**](https://help.connected.illumina.com/emedgene/emedgene-analyze-manual/managing_data_storage) **to the Emedgene workgroup:**
   * The managed ICA project needs to be the one was created automatically by BSSH after running the first analysis (BSSH {workgroup name}, for example "BSSH MyWG").
   * This ensures EMG has access to the analysis outputs and metadata from the managed ICA project.
3. **Enabling ICA Notifications for the BSSH Project:**

   To ensure proper integration with EMG, ICA notifications must be enabled for the specific BSSH project. EMG relies on these notifications to detect when an analysis has successfully completed.

   \
   To configure an SNS notification in your managed ICA project, follow these steps:

   * In the ICA portal, in the managed project, navigate to the **Notifications** section via the left-hand menu.

   <div data-full-width="true"><figure><img src="https://1131024994-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGCW0DnLlE7QjoZPNmKIi%2Fuploads%2Fgit-blob-cee9edf57b49986ed37c2820f23ceb4a27cbef1c%2Fimage%20(2)%20(1).png?alt=media" alt=""><figcaption></figcaption></figure></div>

   * Click **+ Create**, then select **ICA Event**.

   <figure><img src="https://1131024994-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGCW0DnLlE7QjoZPNmKIi%2Fuploads%2Fgit-blob-233ef0050284a8d118e03b4ba8d58ce103b880b2%2Fimage%20(3)%20(1).png?alt=media" alt="" width="239"><figcaption></figcaption></figure>

   * Fill in the required fields as follows:
     * **Event**: `Analysis Success`
     * **Type**: `SNS`
     * **Address**: Provide the correct address based on your region (contact support if unsure).
     * **Payload Version**: `v4`
     * **AWS Region**: This will be auto-populated based on the provided address.
     * (Recommended) Click **Send Test Message** to verify the configuration.
     * Click **Save** to complete the setup.

   <figure><img src="https://1131024994-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGCW0DnLlE7QjoZPNmKIi%2Fuploads%2Fgit-blob-21d6ac4a976ca1394729fb7cb6ff0e91582669cb%2Fimage%20(7)%20(1)%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>
4. **Run a BSSH analysis according to the DRAGEN Array** [**user guide**](https://help.dragenarray.illumina.com/)

### **Automatic Case Creation Workflow**

Upon successful analysis completion, the system will:

1. **Create a New Case in EMG**
   * **Case Type**: Set to **Array**.
     * *Note: No ROI file will be associated with the case.*
   * **Sample Type**: Set to **VCF**.
   * **Phenotype**: Automatically marked as **Healthy**, with **no phenotypes assigned**.
2. **Attach Files to the Case** Each automatically generated case will include:
   * **VCF file** (mandatory)
   * **Visualization files**:
     * LRR bedgraph
     * BAF bedgraph
   * **gt\_summary JSON file** (containing metadata and quality information)
3. **Extract and Apply Metadata from Sample Sheet**
   * If available, **Gender/Sex** is extracted and applied to the case.
   * If not available, the case is labeled as **Sex: Unknown**.
4. **Exclude Failed Analyses**
   * Analyses marked as failed will **not** trigger case creation in Emedgene.

### **Limitations**

Please note the following limitations of the automatic case creation feature:

1. **Supports only singleton cases**
   * Cases involving multiple individuals (e.g., trios or families) are not supported.
2. **No phenotype support**
   * All cases will be marked as **Healthy**, with **no phenotypes included**, regardless of the sample metadata.

### **Benefits**

* Streamlined and seamless workflow between ICA and Emedgene.
* Reduces manual intervention and potential for data entry errors.