# Gestisci le Tue Entità

Con crystal puoi ottenere insight sui tuoi dati attraverso i topic. I topic vengono creati tramite le **entità**, che corrispondono alle colonne di dati che li costituiscono. È importante dare un nome ad ogni entità così che tu e il tuo team possiate usarlo quando parlate con crystal e possiate essere sicuri di ottenere gli insight corrispondenti.

Ogni entità può essere utilizzata per più topic: ecco perché è utile avere un quadro generale in un'area dedicata alla loro gestione.

Vediamo come funziona la gestione delle entità.

## **Il pannello di gestione delle entità** <a href="#h_828fe4a966" id="h_828fe4a966"></a>

Per aprire il pannello di gestione delle entità dalla Console Self-service, clicca su **Entity management** nell'angolo in alto a destra della pagina.

![](https://crystal-1aa63e8abb35.intercom-attachments-7.com/i/o/280636251/bdcf8cdc78a5af0066886187/6sAqGfFH584hqraqhPBrAn_ulo4RyLPWaS9Lxa9go2y3tuujL4YUmLI3ta2S3LSiH4fayii8g1Xve8Frd0zO7r24j0iRFUSvb8x_aWuBhuOTw9fHUykaA_EOkiiY1gSjhH5jfhlw?expires=1621266503\&signature=a14fc4359189c270c85ae614f79a36325703d446f9766a197a4d8bec2cbbd277)

Le entità sono necessarie per generare topic: se non hai ancora topic, quest'area sarà vuota.

Se hai già creato dei topic, vedrai un elenco di tutte le entità usate nei tuoi topic. Nella lista si farà riferimento a ciascuna entità, indicando la variazione primaria del nome e, nel caso di un progetto multilingua, anche la lingua di default del progetto.

Sotto il nome dell'entità, ci sono i dettagli specifici corrispondenti: il nome originale della colonna associata e quello della tabella e della fonte dati di provenienza. Quando cerchi un'entità specifica, per restringere il campo, puoi fare la ricerca per uno qualsiasi di questi dettagli e trovare le entità corrispondenti.

![](https://crystal-1aa63e8abb35.intercom-attachments-7.com/i/o/280636253/eec6a05475710acef64cb1b3/H5TrfhQAii3ghTGWzcychKIxOc0KP1_iXN-9ZyRVXp1pP6HzJOnq3ENvhem0oEKmjGsKc8A6WLGBffgsdbSCTIqxDmLFSoZ-ouN-aXPPwwgTHZn2vEwS0cNYOresUFjCKeZ_mUTr?expires=1621266503\&signature=d7dfa5736bceae1fbf41695c27508963def3a65caaca15850ec34fe9356c6692)

Se un'entità appartiene a una **colonna personalizzata**, verrà mostrata un'icona viola. Potrai modificarla come tutte le altre:

<div align="left"><img src="https://content.gitbook.com/content/cnnKpOPNK55hq8nWnuDD/blobs/YKUg08KjQQqTXhammM0U/custom%20entity.jpeg" alt=""></div>

Clicca su una delle entità per visualizzarne i dettagli. Comparirà una nuova finestra:

![](https://crystal-1aa63e8abb35.intercom-attachments-7.com/i/o/280636257/bb9bda7458eb9f47b4f07a5e/TqF_VUgCnEt3fVEcpjz3bsGduKSmWfRZ0hrNromC8H3IxufIm_wXBH3xiRqSrB_Yw9YReLyc3Swzd6CO4hiyuKzkTzxs21Exjzc4mJL26fk5--WA_E3oP62ktj1owwedy3VX-PjC?expires=1621266503\&signature=bf0959b5d25f55bba1c1e0a3d7355d3baa71ed4b41ecce6947976bd68599b77f)

Se clicchi su **Topics using this entity**, vedrai l'elenco di tutti i topic in cui viene utilizzata come entità principali o come filtri.

![](https://crystal-1aa63e8abb35.intercom-attachments-7.com/i/o/280636260/1f1162073d4c9ceb105abf6f/FLVmCg4PxVUo9Rdvwg_mRg-QEQbX4P0nccTVjDA-rHAPY6vNlJfO_Kc2Gg4tv5hN_SGDy1KLFgHyhEh7ZGMHXBsxfv6xj76k12jnHML3DFjQmH0M90__gKOjxrbUg5UI2FqTNPNs?expires=1621266503\&signature=bd033dcf5e17e7119a4a81174972459abacdce137804e802c2fcf1182f40a5c7)

Le entità possono essere utilizzate come nucleo per creare un topic oppure come filtri per fare ricerche nel dettaglio. Solo nel caso in cui un’entità venga utilizzata in un topic come [filtro dinamico,](https://docs.igenius.ai/italiano/crystal-console/topics/filter) vedrai la relativa voce nei dettagli dell'entità.

![](https://crystal-1aa63e8abb35.intercom-attachments-7.com/i/o/280636264/b151c3f459d0f7c813bda9c2/bitynSQ7iHRd1VkmeNEX0Hvn4TKyOXK7_XLqlyE-NWYV9oEVtCUeJ-fiswa7L0pbEHBoAwCipvtw-KbSdBpG2GtWPccIwEbrPpDJYmapJjGMHZrWrSlGsuYhr9QUYmCRItZ1Ph44?expires=1621266503\&signature=a75f4d24e76f8cd8ef909f33173dc1bd1d4dea60fb3601b1de0c5db8bdd49c40)

La voce **filter type** ti mostra per quale tipo di filtro viene utilizzata questa entità e aiuta crystal a mettere i tuoi dati in relazione alle tue domande e darti risposte più precise.

![](https://crystal-1aa63e8abb35.intercom-attachments-7.com/i/o/280636269/48c79d9b1952d4c0198e1bab/7OcxSfvod212O5UuHf53QQiDG9A5ws-X347RRxbqd4a6SuEXZ5jxwiLJFgl17pHB4imhB4h6m_VhWM-1xJFIvQu0plo-WPeWhaRqutNV-nlNdL2M8akY8JAn406xSEiC4QekR_kf?expires=1621266503\&signature=b26869560ecee2a0eed1b4c418c75c9dcde53ad65ad953d710e3186f0894f1f9)

Tornando alla visualizzazione dei dettagli della singola entità, puoi vedere la lingua o le lingue in cui è disponibile il tuo progetto e lo stato dell'entità in quelle lingue (complete, ready o to do).

Per ogni lingua vedrai i suoi **alias** (o nomi alternativi). Quello contrassegnato da una stella è l'**alias** **di default** a cui crystal farà riferimento principalmente: se questo alias è l'entità principale di un topic, sarà parte del nome del topic.

Ad esempio, se l'alias principale è "**Vendite**", crystal ti parlerà di "vendite", ma se anche "**guadagno**" è impostato come alias alternativo, crystal saprà a cosa ti riferisci se le chiedi di mostrarti i **guadagni per il 2019.**

![](https://crystal-1aa63e8abb35.intercom-attachments-7.com/i/o/280636280/d281ad38401c3cb782238a03/jeEXCaL9C7eGV9iZShyxP35HfgeUJ_NkQP6zKe3GRJNfLvTMpZMZg3knf5GyZ-A7to0fnCVcxHSq9JMrpQhKlSMnk6tObeSUaVQm-d1YhPLNrwtMl8wmPvStt5UcR7LXtHDvdvyQ?expires=1621266503\&signature=0b2fa7fe8431bfbcf9f7f6a05dfebd99307daa5aa937d57eedca8c47ed696b86)

Puoi aggiungere o rimuovere alias e impostare un alias di default a tua scelta. Vediamo come.

## **Aggiungi un nuovo alias** <a href="#h_055ef4db02" id="h_055ef4db02"></a>

Per aggiungere un nuovo alias, clicca su **Edit** nella pagina della singola entità.

![](https://crystal-1aa63e8abb35.intercom-attachments-7.com/i/o/280636286/49cd1d674ef06526f3386f6f/Si6-DeveOeMgDuu5lVuoQ2K7zJFQa62CZ1H4wQz-0UyGrFFI4bLzVJNZk70yyqspqr3VjkkjhyTNVffzB3tpKb5jRJBmhczIDFnhXyuKJtbuqBI-ZXUxvi4S66vkZdaDO8qknbv_?expires=1621266503\&signature=1255494c16aaea90216ae9ac1f128e8b118d0690f25f9390bcb2eb9465727e28)

In questo modo abiliti l'editor degli alias: qui puoi sia aggiungere nuovi alias, inserendoli nel campo bianco, sia cancellare quelli già esistenti, cliccando sulla X.

Puoi anche decidere di cambiare l’alias di default impostato per un’entità cliccando sulla stella gialla, che indica per l’appunto l’alias di default.

{% hint style="info" %}
Ricorda che **più alias crei per ciascuna entità, più sarà facile per crystal comprendere la conversazione**
{% endhint %}

![](https://crystal-1aa63e8abb35.intercom-attachments-7.com/i/o/280636293/f4908b5d803c52f077c26f9d/AlTSwUZyzuJ5oTvRiunF1BSZI64n4a9z_JOeqMsaY9SwdiIppk-Cq5P2w42DDxLp3-X3f_qlxN-eo2mtVql3ylGsQGsNIAnlQS2SqBO_ekVqKAq1xZxO6HasFlAeocEeQAgPrRC6?expires=1621266503\&signature=19bd2eaab4b5144cfa60cb01490e738d9c01551339a317a660f7675eb37a2828)

Sotto gli alias vedrai la voce **Value aliasing**, che ti permette di assegnare alias anche a ogni singolo valore della colonna associata all’entità. Ad esempio, se hai una colonna di paesi in cui sono presenti acronimi, potresti voler inserire anche il nome completo del Paese, o viceversa, come **Stati Uniti** e **USA**.&#x20;

{% hint style="warning" %}
Tieni presente che non puoi applicare alias di valore ai dati numerici.
{% endhint %}

Se fai clic sulla voce alias del valore, vedrai la schermata seguente:

![](https://crystal-1aa63e8abb35.intercom-attachments-7.com/i/o/280636301/fd8ef576af5846379f5090d0/slWHRrKzAuhHVdiM00CrhXFW75oowzsyytJuQEsRd_N-_6d-eWeCGnYzYl10-Xso8ijKlvcNXIuYkQcFMgBvBvx9-n08e6GSxjvCcsmV_fGFakfKx1KvdL2BwAckCcW5utJcvigp?expires=1621266503\&signature=654ff8241e205e9b29f872152860732b726726eb80d5d4a730529197ebeab464)

Qui puoi vedere tutti i valori della colonna relativi all'entità e puoi inserire più alias o eliminare quelli già creati. Clicca su **Done** per confermare le modifiche e tornare alla schermata dei dettagli principali in cui è possibile rendere effettivi i cambiamenti. Qui clicca su **Save** per salvare tutte le modifiche.

Dato che la modifica di un'entità avrà un impatto su tutti gli topic correlati, riceverai un messaggio di conferma per ricordarti di quali topic si tratta. Se completi le modifiche, questi topic saranno **temporaneamente non disponibili**.

Infatti, questi topic devono essere aggiornati prima di poter essere riutilizzati.

![](https://crystal-1aa63e8abb35.intercom-attachments-7.com/i/o/280636308/f6af5f9b6c5606bba711b90d/crz25nqsxOVZbKl9tLyik8mECZo0E9vpnMOBIGZ-GURsNNApIngYh9NEtZy4ChVQ88Kvb7yzQpT7ErQoIjncHBYwWXN2gxv2k57bJejGlzzyc3jatu4sofeVtUpczgo6nbvjGIzv?expires=1621266503\&signature=bea1c068cdced6b42c334b10f6d7e9266375c872b9d6d34f1c42f0ed868eb19c)

## **Rimuovi un'entità** <a href="#h_f35ff56b82" id="h_f35ff56b82"></a>

Rimuovere un'entità è molto semplice. Basta cliccare su **Delete** nella parte inferiore del pannello.

![](https://crystal-1aa63e8abb35.intercom-attachments-7.com/i/o/280636318/694118639d856faa5e4ce3ec/YCyIDTRzGH_nGobbTkoxzOyhjlzG863MPdKxpi_CTHaETjeV9_uhCaOTQjkDvzuHWQ6uuyZhxdgcZb_RLAZqYreVZdySjPJuxuMfbqGMjTx2JWXCbB1a8fDSdNMThWOtRfTBu1Az?expires=1621266503\&signature=d0e00fefa8a1cecb9ae13aa2aa5ee94f6a4930a662f906c343220d457c021e1b)

Dato che l'eliminazione di un'entità va a incidere su tutti i topic che la utilizzano, che saranno saranno **temporaneamente non disponibili,** ti verrà chiesto di confermare prima di completare l’eliminazione.

## Come posso modificare le entità che hanno già svolto il training?

Puoi modificare le entità esistenti dal pannello di controllo in qualunque momento. Ricorda che tutti i topic che usano una determinata entità dovranno essere sottoposti nuovamente al training nel caso in cui questa fosse modificata, quindi potrebbero non essere disponibili per qualche momento.

***
