.. _gnrextra/orgn/config_orgn:

Configurazione
==============




Individuazione delle tabelle da utilizzare
---------------------------------------------
È possibile specificare le tabelle a cui sarà possibile assegnare delle **annotazioni ed azioni** direttamente all'interno del file ``instanceconfig.xml``, nel tag ``entities``::

  <gnrcore_orgn pkgcode="gnrcore:orgn">
       <entities>
            <cliente tbl='fatt.cliente' caption='Cliente'/>
            <fattura tbl='fatt.fattura' caption='Fattura' pivot_date='data'/>
       </entities>
  </gnrcore_orgn>
  
Oltre alla ``tbl``, sarà possibile indicare una ``caption`` (usata nei titoli, nelle *sections*, ecc) e una ``pivot_date``.

Abilitare ORGN nelle preferenze
-------------------------------
Per l'utilizzo del sistema è necessario abilitarlo dalle Preferenze dall'apposita *checkbox*:

.. image:: /_static/images/orgn/preferenze-orgn.png
    :width: 300px
    :align: center
    
È inoltre possibile scegliere un `tag utente <https://www.genropy.org/docs/package/adm/user>`_ che potrà gestire gli appuntamenti e limitare il potere degli utenti alla sola modifica se non autori. Inoltre, è possibile identificare un `service SMS <https://www.genropy.org/docs/service/service_genropy/sms.html>`_ tra quelli configurati.

.. controllare

Definire dei Tipi di azione
----------------------------
Per prima cosa è necessario impostare dei ``Tipi di azione`` (ovvero delle azioni da intraprendere) dall'omonima voce di menu.

Nel box a sinistra sarà possibile specificare:

- un ``Codice`` (es: CALL) 
- una ``Descrizione`` (es: Richiamare) o più in basso una ``Descrizione estesa``
- un lasso di tempo ``GG prima/dopo``
- un grado di ``Priorità``
- un ``tag`` predefinito, tra quelli definiti in  :ref:`ADM<package/adm>` , per eseguire l'azione, ed eventualmente abilitare la visualizzazione a tutti gli utenti con ``Mostra a tutti in Tag``
- un ``Implementor``, ovvero il canale di comunicazione (es: E-mail, SMS, Telegram)
- a quale tabella è ``Ristretta`` l'annotazione (se non indicato, sarà assegnata a tutte le tabelle)
- un ``Background`` e un ``Text`` 

.. image:: /_static/images/orgn/tipi-azione.png
    :width: 600px
    :align: center

Nel box a destra, invece, sarà possibile costruire un ``Modello di testo``, da utilizzare per esempio nelle e-mail da inviare o negli sms.

.. Nella parte in basso ...

Definire dei Tipi di annotazione
--------------------------------
Allo stesso modo è necessario impostare dei ``Tipi di annotazione`` (ovvero degli eventi scatenanti) dall'omonima voce di menu.

Nel box a sinistra sarà possibile specificare:

- un ``Codice`` (es: REC) 
- una ``Descrizione`` (es: Reclamo)
- a quale tabella è ``Ristretta`` l'annotazione (se non indicato, sarà assegnata a tutte le tabelle)
- un ``Background`` e un ``Text`` 

.. image:: /_static/images/orgn/tipo-annotazione.png
    :width: 400px
    :align: center

Nella parte a destra è possibile specificare un ``Tipo di azione`` da intraprendere tra quelle specificate precedentemente, con il consueto meccanismo del *picker*.

.. image:: /_static/images/orgn/scelta-tipo-azione.png
    :width: 600px
    :align: center

Il box in basso ci permette di utilizzare il mondo dei `Campi dinamici <https://www.genropy.org/docs/genropy_orm/>`_ per specificare meglio le   :ref:`annotazioni<gnrextra/orgn/azioni_annotazioni>`  (es: ``prodotto_tipo`` per la richiesta informazioni di un cliente).

.. image:: /_static/images/orgn/campi-dinamici-tipo-annotazione.png
    :width: 600px
    :align: center

Abilitare azioni e annotazioni nelle risorse
--------------------------------------------
L'ultimo passaggio è l'abilitazione della sezione dedicata ad azioni e annotazioni nella tabella di destinazione.

Per fare questo è sufficiente specificare l'attributo ``annotations=True`` all'interno del metodo `th_options <https://www.genropy.org/docs/tablehandler/FormResource/base_method/th_options_method.html>`_ della Form::

  def th_options(self):
    return dict(dialog_height='400px', dialog_width='600px', annotations=True)
    
Il risultato sarà l'aggiunta di un'iconcina nella toolbar superiore della Form, da cui sarà possibile aggiungere e visualizzare azioni e annotazioni.

.. image:: /_static/images/orgn/annotations-true.png
    :width: 200px
    :align: center

.. sectionauthor:: Davide Paci