L’applicazione Importa dati permette di eseguire l’importazione dei dati selezionati (per esempio come file .xml) dal repositorio di sistema tramite il servizio Business Integration Service (BIS). Tali dati possono essere esportati dal sistema in file con l’utilizzo dell’applicazione Esporta dati e poi, dopo l’applicazione di eventuali modifiche, importati verso lo stesso o un altro (per esempio più recente) sistema.
Questo articolo contiene la descrizione delle procedure riguardanti l’utilizzo dell’applicazione Importa dati nel contesto delle distinte base commerciale.
Informazioni di base
Nel sistema Comarch ERP Enterprise le distinte di base commerciale permettono di combinare articoli.
Si distinguono due tipi di scambio di dati:
- scambio di dati tra sistemi Comarch ERP Enterprise diversi
- importazioni dei dati da una versione anteriore del sistema verso una versione più recente
L’articolo contiene le informazioni relative all’importazione delle distinte base commerciale dalla versione precedente del sistema. La descrizione dettagliata dello scambio di dati tra i sistemi Comarch ERP Enterprise si trova negli articoli Importazione dati ed Esportazione dati.
Le condizioni che devono essere soddisfatte durante l’importazione e le procedure riguardanti il lavoro nell’applicazione Importa dati verranno presentate nei seguenti paragrafi:
- Importazione dei dati
- Attributi necessari per l’importazione
Importazione dei dati
Condizioni iniziali:
- è disponibile il filtro per l’oggetto business isag.app.general.obj.Kit, che contiene gli attributi che devono essere importati
- possedere un file esportato prima da un altro ambiente CEE
Per importare i dati del set:
- Apri l’applicazione Importa dati
- Nella testata dell’applicazione, nel campo Filtro, seleziona il filtro KIT (business entity: isag.app.general.obj.Kit), utilizzando il pulsante [Guida ai valori].
3. Nell’area di lavoro sono selezionati gli attributi predefiniti per l’importazione. Se necessario, durante questa tappa è ancora possibile aggiungere degli attributi.
4. Seleziona il pulsante [Importa dati] disponibile sulla barra standard degli strumenti. Viene aperta l’applicazione in background Importa dati.
5. Nell’applicazione Importa dati bisogna:
- Nel campo File sorgente indicare il file che deve essere importato dal repositorio del sistema
- Selezionare il tipo di file Le seguenti estensioni sono disponibili da selezionare:
- XML (*.xml)
- Testo separato da separatore (*.xls)
- Testo Unicode separato da tabulazione (*.xls)
- JSON (*.json)
- selezionare la coda di elaborazione dei dati nella scheda Impostazioni background
- adattare le impostazioni di elaborazione secondo le necessità, per esempio definire il comportamento del sistema in caso di errore o cambiare il server dell’applicazione
6. Selezionare il pulsante [In background] per avviare l’importazione.
Attributi necessari per l’importazione
Per importare un file dalla versione precedente del sistema bisogna specificare almeno i seguenti attributi:
- attributi di identificazione (chiave business)
- campi obbligatori
Di seguito si trova la tabella con gli attributi:
| Attributo/Relazione | Denominazione | Commento |
| OrganizationalUnit | Organizzazione | Opzionale |
| Item | Articolo | Obbligatorio, alternativamente, tramite la posizione è anche possibile specificare Guid |
| type | Struttura | Opzionale, valore predefinito: Variabile |
| priceDetermination | Determinazione del prezzo | Opzionale, valore predefinito: Componenti |
| printComponents | Output dei componenti sui documenti esterni | Opzionale, valore predefinito: Falso |
Attributi relativi ai componenti che fanno parte delle distinte base commerciale:
| Attributo/Relazione | Denominazione | Commento |
| sequence | Numerazione | Obbligatorio, deve essere superiore a 0 |
| Item | Articolo | Obbligatorio, può essere specificato anche tramite Guid |
| quantity | Quantità | Obbligatorio, deve essere superiore a 0 |
| validFrom | Valido dal | Opzionale, valore predefinito: data corrente |
| validUntil | Valido al | Opzionale, valore predefinito: data massima di sistema |
Esempio di un file di importazione in formato XML per un set a due componenti:
<?xml version=”1.0″ encoding=”UTF-8″?>
<semiramis xmlns=”com.cisag.app.general.obj.Kit”
xsi:schemaLocation=”com.cisag.app.general.obj.Kit Kit.xsd”
created=”2005-12-12T14:28:07.983Z” locale=”en-USXMLSchemaCompliant”
xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”>
<Kit xmlns=”com.cisag.app.general.obj.Kit”>
<Item>KITITEM</Item>
<Details>
<Item>10010</Item>
<quantity>10.000000</quantity>
<sequence>10</sequence>
</Details>
<Details>
<Item>10020</Item>
<quantity>20.000000</quantity>
<sequence>20</sequence>
</Details>
</Kit>
</semiramis>
Esempio di file in formato XML con tutti gli attributi gestiti:
<?xml version=”1.0″ encoding=”UTF-8″?>
<semiramis xmlns=”com.cisag.app.general.obj.Kit”
xsi:schemaLocation=”com.cisag.app.general.obj.Kit Kit.xsd”
created=”2005-12-12T14:28:07.983Z” locale=”en-USXMLSchemaCompliant”
xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”>
<Kit xmlns=”com.cisag.app.general.obj.Kit”>
<OrganizationalUnit>SALORG</OrganizationalUnit>
<Item>KITITEM</Item>
<type>VARIABLE</type>
<priceDetermination>COMPONENTS</priceDetermination>
<printComponents>true</printComponents>
<Details>
<Item>10010</Item>
<quantity>10.000000</quantity>
<sequence>10</sequence>
<validFrom>2005-11-30T23:00:00.000Z</validFrom>
<validUntil>2005-12-31T23:00:00.000Z</validUntil>
</Details>
<Details>
<Item>10020</Item>
<quantity>20.000000</quantity>
<sequence>20</sequence>
<validFrom>2005-09-20T22:00:00.000Z</validFrom>
<validUntil>4712-12-31T00:00:00.000Z</validUntil>
</Details>
</Kit>
</semiramis>