View source | Discuss this page | Page history | Printable version   

ERP 2.50:Developers Guide/How to create a dataset/it

Contents

Obiettivo

Questo how-to si concentrerà sulla creazione di un dataset in Openbravo ERP e anche sulla spiegazione con alcuni esempi in dettaglio nella sezione Esempi . I Dataset esportano sia i dati di riferimento sia i dati di default.

Introduzione al Concetto di Dataset

Bulbgraph.png   Per concetti teorici dettagliati sui dataset si prega di dare un'occhiata alle seguenti pagine :
  1. Progetto di Modularità
  2. Manuale Sviluppatore

Prima di tutto abbiamo bisogno di capire il concetto di dataset , che permette di esportare i set di dati provenienti da tabelle diverse in un unico passaggio. Ciò è particolarmente utile per gestire e distribuire il modulo con i dati di riferimento, per esempio aliquote , le regioni o i dati di default in una nuova tabella(e) aggiunta da un modulo.


Un dataset è definito tramite le sue Tabelle di Dataset e le Colonne di Dataset . Questa configurazione dettagliata indica quali tabelle e quali colonne di ogni tabella verranno esportate.

Bulbgraph.png   Ci sono alcune cose importanti da notare:
  • Un Dataset appartiene ad un modulo, in modo che i moduli possono aggiungere Datasets e definire i propri Datasets.
  • Livello di Accesso ai Dati: filtra le tabelle che possono essere selezionate per questo set di dati, solo tabelle con il Livello di Accesso ai Dati impostato possono essere incluse nel Dataset (see Livello Accesso Dati section for more information).

Dati Riferimento

I dati di riferimento sono impacchettati, distribuiti e installat insieme al implementazione del codice di programma del modulo.

In Openbravo ERP 2.50, il concetto di dati di riferimento è generalizzato e qualsiasi dato nell'istanza può essere esportato in un modulo e importato per l'installazione / applicazione del modulo.

È possibile trovare il campo / opzione Contiene dati di riferimento al momento della creazione del modulo.

Struttura Dati per definire Dataset

Ci sono principalmente tre tabelle riferite come struttura dati per definire i dataset :

1. DataSet con le seguenti colonne:Value, Nome, Descrizione, Modulo e DataAccessLevel

Dataset.png

Se la colonna esportazione permesso è spuntata viene visualizzato il  pulsante Export Dati di riferimento

2. DataSet_Table con le seguenti colonne:DataSet, Tabella, fullBusinessObjec, includeAllColumns, excludeAuditInfo e whereClause (espressione HQL)


Dataset table.png

Nota: Se il campo IsBusinessObject è spuntato allora i 'records-figli' della tabella vengono esportati.
 Per esempio se la tabella del dataset è definito per la tabella C_Order e questo campo è spuntato poi anche le righe della C_OrderLines correlate vengono esportate.


Bulbgraph.png   Un oggetto di business completo è un record che include tutte le sue relazioni uno-a-molti definita nel AD attraverso l'attributo isParent di una colonna. Un esempio di oggetto di business completo è un prodotto con i suoi fornitori, prezzi, ecc Una descrizione completa di oggetti di business è fornita nel progetto DAL.


3. Dataset_column con le seguenti colonne: DataSet_Table, Colonna, isExcluded e conditionClause (espressione Java).


Dataset column.png


Livello Accesso Dati

Il Livello di Accesso ai Dati viene utilizzato per definire la modalità di importazione / installazione del modulo a vari livelli come livello di System, a livello di Client, a livello di Organizzazione, ecc Questi valori di livello di accesso è disponibile sulla tabella a Dataset. Di seguito è riportato il dettaglio esplicativo ad ogni livello di accesso.

Esportare un Modulo

Prima dell'impacchettamento abbiamo bisogno di esportare il modulo che crea una directory nella cartella modules della directory principale di Openbravo ERP e i file XML appropriati per l'inserimento nel modulo finito. I moduli che non sono etichettati come in sviluppo non vengono esportati in modo che bisogna ricordare che è necessario selezionare la casella di controllo In Sviluppo quando si definisce un nuovo modulo.

Quando lo sviluppo del modulo è finito, aprire una finestra di comando / shell e passare al progetto di sviluppo Openbravo ERP e eseguire il comando export.database.

ant export.database

Impacchettare un Modulo

L'ultimo passo nel processo è di confezionare il modulo e distribuirlo per l'utente finale.

Per creare un pacchetto di un modulo, eseguire il comando ant package.module -Dmodule=nomemodulo, dove nomemodulo è il nome del pacchetto Java del modulo. Quindi, nel caso del modulo howto, il comando sarà:

ant package.module -Dmodule=org.openbravo.howto

Esempi

Qui di seguito troverete degli esempi per sapere come creare un dataset e esportarlo con i dati di riferimento.

Dataset di Ruoli e Accessi

In questa sezione potete trovare l'esempio di un dataset di Ruoli e Accessi. Essa riguarda essenzialmente la definizione del ruolo all'interno dell'organizzazione e dei privilegi di cui hanno bisogno.


Creare un Ruolo e Assegnare Privilegi


Creare un utente e Assegnare l'utente al Ruolo


Creare u nuovo modulo

Create a Dataset of roles and access

  1. From the Application menu, select Application Dictionary > Dataset
  2. Click New.
  3. From the Module list, select the module above created.
  4. Specify a search key, name and description.
  5. From the Data Access Level list, select the Data access level as Organization.
  6. Select the Export allowed option.
  7. Select the Table Tab
  8. From the Table list, select the table whose content you want to include in the module. For example, ad_role_org_access, ad_role, ad_user_roles
  9. In the SQL where clause field, specify the SQL "WHERE" statement that will identify the set of rows to be exported, in DAL notation. For example, adrole.id='2EA831D59184490E9BA858E9745EF89F'
  10. Select the Include All Columns option.
  11. Select isBusinessObject option
  12. Click Save
  13. Click the Export Reference Data button to export the reference data to an .xml file that you can include in the module

Exporting and Packaging Module

After completing all the steps successfully. Run the below ant task to

export the module:
ant export.database -Dmodule="org.openbravo.rolesandaccess"
packaging the module:
ant package.module -Dmodule="org.openbravo.rolesandaccess"

On successful execution of the above task an .obx file has been generated.


How to Install - Organization Access Level Reference Data

To install the new module into the running Openbravo ERP then need handle the steps carefully. In this example we have selected the access level as Organization then the installation would be done using Enterprise Module Management find below the steps.

Dataset di Tasse o Avvisi

In questa sezione potete trovare l'esempio su i dataset di tasse o di avvisi. Il processo di creazione di un modulo di dati di riferimento standard per le imposte e gli avvisi, è stato impostato Openbravo ERP in un modo particolare per soddisfare esigenze locali, è possibile esportare i dati e convertirli in un modulo, in modo da poterlo condividere con altri utenti.

Registrazione di un modulo dati per le tasse e gli avvisi:

Definizione ed Esportazione del Dataset

  1. Dal menu Applicazioni, selezionare Dizionario Applicazione > Dataset
  2. Fare clic su Nuovo.
  3. Dall'elenco dei Moduli, selezionare il modulo creato in precedenza.
  4. Specificare una chiave di ricerca, il nome e la descrizione.
  5. Dalla lista dei Livelli di Accesso Dati , selezionare il livello di accesso ai dati come System Only
  6. Selezionare l'opzione Consenti Export.
  7. Selezionare la scheda Tabella
  8. dalla lista Tabella, selezionare la tabella i cui contenuti si desidera includere nel modulo.
  9. Nella clausola SQL where , specificare il comando SQL "WHERE" che identificherà l'insieme di righe che verranno esportate, in notazione DAL. Ad esempio, client.id = '1000001 '
  10. Per esportare tutte le colonne, selezionare l'opzione Includere Tutte le colonne. Per includere solo alcune colonne, selezionare la scheda Colonne e creare un nuovo record per ogni colonna che si desidera esportare.
  11. Per includere le colonne di sicurezza audit (created, createdby, updated and updatedby) nell'esportazione, deselezionare la casella di controllo Escludi Info Audit .
  12. Deselezionare il campo Is Business Object.
  13. Fare clic su Salva
  14. Fare clic sul pulsante Esporta Dati di Riferimento per esportare i dati di riferimento a un file. xml che è possibile includere nel modulo.

Export e Packaging del Modulo

Dopo aver completato tutti i passaggi correttamente. Eseguire il seguente task ant per esportare il modulo:

ant export.database -Dmodule="org.openbravo.taxesandalerts"
packaging del modulo:
ant package.module -Dmodule="org.openbravo.taxesandalerts"

Se il task ant viene eseguito correttamente viene generato un file .obx.

Come Installare - Dati Riferimento con Livello Accesso System/Client

Per installare il nuovo modulo in Openbravo ERP quindi è necessario gestire la procedura con attenzione. In questo esempio abbiamo selezionato il livello di accesso come organizzazione quindi l'installazione potrebbe essere fatto con Gestione Moduli seguendo i passi :

Dataset di regioni

In this section you can export the reference data with the examples on regions. Find below the steps to create the Dataset for this module:

select * from c_country where countrycode like 'IN%';


Exporting and Packaging Module

After completing all the steps successfully. Run the below ant task to

export the module:
ant export.database -Dmodule="org.openbravo.indianstates"
packaging the module:
ant package.module -Dmodule="org.openbravo.indianstates"

On successful execution of the above task an .obx file has been generated.


How to Install - System Only Access Level Reference Data

To install the new module into the running Openbravo ERP then need handle the steps carefully. In this example we have selected the access level as Organization then the installation would be done using Enterprise Module Management find below the steps.


Retrieved from "http://wiki.openbravo.com/wiki/ERP_2.50:Developers_Guide/How_to_create_a_dataset/it"

This page has been accessed 4,700 times. This page was last modified on 14 June 2011, at 11:04. Content is available under Creative Commons Attribution-ShareAlike 2.5 Spain License.