Versions Compared

Old Version 16

changes.mady.by.user jtel Support

Saved on

compared with

New Version Current

changes.mady.by.user jtel Support

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Content imported from a Scroll Translations translation file.
Sv translation
languageen

Introduction

Import Export Schemes are designed to replace the fixed import / export file structure in the jtel system.

They work on CSV style files which are separated by a fixed character (usually but not always semicolon). Import export schemes require CSV files with a header line to work correctly.

The import / export schemes mechanism provides a flexible way to specify:

  • the fields used in the data import process
    • how they are formatted
    • which internal field in the jtel system should the external field be mapped to
  • the fields used in the export process
    • which internal field in the jtel system should be mapped to a particular position in the export file
    • how should it be formatted

Import export schemes provide a way to implement "asymetric" imports and exports - i.e. where the internal fields in the jtel system do not necessarily have to be mapped to data in the external file and vice versa, and the ordering of the fields can be implemented in a more flexible manner.

Supported Data

Currently, import export schemes are supported by the following modules in the software:

This feature set will be expanded in the future, and eventually the old import / export mechanism will be replaced by it entirely.

Importing

When Data is imported, if it is too long for a field of type VARCHAR, it will be truncated.

Creating / Editing

Import export schemes are created using a client administrator account, and accessing the "System Settings ... Import Export Schemes" menu.

The following information is required:

FieldContents
NameA name for the import export scheme.
Import Export NameThe jtel internal data set on which this operation will operate.
XML DefinitionThe XML definition for the import / export provided.

XML Definition

An XML example definition is provided below, together with an example file, to illustrate the XML definition. 

Translations Ignore


Code Block
titleExample XML Definition
<importExport2>
	<import>
		<type>CSV</type>
		<encoding>UTF-8</encoding>
		<delimiter>;</delimiter>
	</import>
	<export>
		<type>CSV</type>
		<encoding>UTF-8</encoding>
		<bom>1</bom>
		<delimiter>;</delimiter>
	</export>
	<fieldMappings>
		<fieldMapping internalField="RandomSortOrder" externalField="Priority" externalType="INTEGER" importOnly="true"/>
		<fieldMapping internalField="ReferenceNumber" externalField="RefNumber" externalType="VARCHAR"/>
		<fieldMapping internalField="ExternalSystemLink" externalField="Hyperlink" externalType="VARCHAR"/>
		<fieldMapping internalField="" externalField="EKCODE" externalType="VARCHAR"/>
		<fieldMapping internalField="Salutation" externalField="Sal" externalType="VARCHAR"/>
		<fieldMapping internalField="Name" externalField="Name" externalType="VARCHAR"/>
		<fieldMapping internalField="FirstName" externalField="First" externalType="VARCHAR"/>
		<fieldMapping internalField="Address" externalField="Addr" externalType="VARCHAR"/>
		<fieldMapping internalField="Country" externalField="Country" externalType="VARCHAR"/>
		<fieldMapping internalField="PostalCode" externalField="PostCode" externalType="VARCHAR"/>
		<fieldMapping internalField="City" externalField="City" externalType="VARCHAR"/>
		<fieldMapping internalField="PhoneNumber1" externalField="Tel1" externalType="TEL:49"/>
		<fieldMapping internalField="PhoneNumber2" externalField="Tel2" externalType="TEL:49"/>
		<fieldMapping internalField="Email" externalField="Mail" externalType="VARCHAR"/>
		<fieldMapping internalField="Tag" externalField="DataIdentifier" externalType="VARCHAR"/>
		<fieldMapping internalField="UserData" externalField="CustomerNumber" externalType="VARCHAR"/>
		<fieldMapping internalField="dtBeginDate" externalField="StartDate" externalType="DATETIME:dd.MM.yyyy"/>
		<fieldMapping internalField="dtEndDate" externalField="EndDate" externalType="DATETIME:yyyyMMdd"/>
		<fieldMapping internalField="Client" externalField="ClientName" externalType="VARCHAR"/>
		<fieldMapping internalField="" externalField="NotImported1" externalType="VARCHAR"/>
		<fieldMapping internalField="" externalField="NotImported2" externalType="VARCHAR"/>
		<fieldMapping internalField="" externalField="NotImported2" externalType="VARCHAR"/>
	</fieldMappings>
</importExport2>





Sv translation
languagede

Einführung

Import-Export-Schemata sollen die feste Import/Export-Dateistruktur im Jtel-System ersetzen.

Sie arbeiten mit Dateien im CSV-Stil, die durch ein festes Zeichen (normalerweise, aber nicht immer Semikolon) getrennt sind. Import-Export-Schemata benötigen CSV-Dateien mit einer Kopfzeile, um korrekt zu funktionieren.

Der Mechanismus der Import-/Exportschemata bietet eine flexible Möglichkeit zur Spezifizierung:

  • die im Datenimportprozess verwendeten Felder
    • wie sie formatiert sind
    • auf welches interne Feld im Jtel-System das externe Feld abgebildet werden soll
  • die im Exportprozess verwendeten Felder
    • welches interne Feld im Jtel-System auf eine bestimmte Position in der Exportdatei gemappt werden soll
    • wie es formatiert sein sollte

Import-Export-Schemata bieten eine Möglichkeit, "asymmetrische" Importe und Exporte zu implementieren - d.h. bei denen die internen Felder im Jtel-System nicht notwendigerweise auf Daten in der externen Datei und umgekehrt abgebildet werden müssen und die Anordnung der Felder flexibler umgesetzt werden kann.

Unterstützte Daten

Derzeit werden Import-Export-Schemata von den folgenden Modulen in der Software unterstützt:

Dieser Funktionsumfang wird in Zukunft erweitert werden, und schließlich wird der alte Import-/Export-Mechanismus vollständig durch diesen ersetzt werden.

Importieren

Wenn Daten beim Import zu lang für ein Feld vom Typ VARCHAR sind, werden sie gekürzt.

Erstellen/Bearbeiten

Import-Export-Schemata werden unter Verwendung eines Client-Administrator-Kontos und unter Zugriff auf die "Systemeinstellungen ... Import-Export-Schemata" aufgerufen und erstellt..

Die folgenden Informationen sind erforderlich:

FeldInhalt
NameEin Name für das Import-Export-Schema.
Import Export NameDer interne Jtel-Datensatz, mit dem diese Operation durchgeführt wird.
XML DefinitionDie XML-Definition für den Import/Export wird zur Verfügung gestellt.

XML Definition

Nachstehend finden Sie eine XML-Beispieldefinition zusammen mit einer Beispieldatei, um die XML-Definition zu veranschaulichen. 

Translations Ignore


Code Block
titleExample XML Definition
<importExport2>
	<import>
		<type>CSV</type>
		<encoding>UTF-8</encoding>
		<delimiter>;</delimiter>
	</import>
	<export>
		<type>CSV</type>
		<encoding>UTF-8</encoding>
		<bom>1</bom>
		<delimiter>;</delimiter>
	</export>
	<fieldMappings>
		<fieldMapping internalField="RandomSortOrder" externalField="Priority" externalType="INTEGER" importOnly="true"/>
		<fieldMapping internalField="ReferenceNumber" externalField="RefNumber" externalType="VARCHAR"/>
		<fieldMapping internalField="ExternalSystemLink" externalField="Hyperlink" externalType="VARCHAR"/>
		<fieldMapping internalField="" externalField="EKCODE" externalType="VARCHAR"/>
		<fieldMapping internalField="Salutation" externalField="Sal" externalType="VARCHAR"/>
		<fieldMapping internalField="Name" externalField="Name" externalType="VARCHAR"/>
		<fieldMapping internalField="FirstName" externalField="First" externalType="VARCHAR"/>
		<fieldMapping internalField="Address" externalField="Addr" externalType="VARCHAR"/>
		<fieldMapping internalField="Country" externalField="Country" externalType="VARCHAR"/>
		<fieldMapping internalField="PostalCode" externalField="PostCode" externalType="VARCHAR"/>
		<fieldMapping internalField="City" externalField="City" externalType="VARCHAR"/>
		<fieldMapping internalField="PhoneNumber1" externalField="Tel1" externalType="TEL:49"/>
		<fieldMapping internalField="PhoneNumber2" externalField="Tel2" externalType="TEL:49"/>
		<fieldMapping internalField="Email" externalField="Mail" externalType="VARCHAR"/>
		<fieldMapping internalField="Tag" externalField="DataIdentifier" externalType="VARCHAR"/>
		<fieldMapping internalField="UserData" externalField="CustomerNumber" externalType="VARCHAR"/>
		<fieldMapping internalField="dtBeginDate" externalField="StartDate" externalType="DATETIME:dd.MM.yyyy"/>
		<fieldMapping internalField="dtEndDate" externalField="EndDate" externalType="DATETIME:yyyyMMdd"/>
		<fieldMapping internalField="Client" externalField="ClientName" externalType="VARCHAR"/>
		<fieldMapping internalField="" externalField="NotImported1" externalType="VARCHAR"/>
		<fieldMapping internalField="" externalField="NotImported2" externalType="VARCHAR"/>
		<fieldMapping internalField="" externalField="NotImported2" externalType="VARCHAR"/>
	</fieldMappings>
</importExport2>





Sv translation
languagefr

Introduction

Les schémas d'importation et d'exportation sont conçus pour remplacer la structure fixe des fichiers d'importation/exportation dans le système jtel.

Ils travaillent sur des fichiers de style CSV qui sont séparés par un caractère fixe (généralement, mais pas toujours, un point-virgule). Les schémas d'importation et d'exportation nécessitent des fichiers CSV avec une ligne d'en-tête pour fonctionner correctement.

Le mécanisme des schémas d'importation/exportation offre un moyen souple de préciser :

  • les champs utilisés dans le processus d'importation des données
    • la façon dont ils sont formatés
    • à quel champ interne du système jtel le champ externe doit-il être associé
  • les champs utilisés dans le processus d'exportation
    • quel champ interne du système jtel doit être mis en correspondance avec une position particulière dans le fichier d'exportation
    • comment doit-il être formaté

Les régimes d'import-export permettent de mettre en œuvre des importations et des exportations "asymétriques", c'est-à-dire que les champs internes du système jtel ne doivent pas nécessairement être mis en correspondance avec les données du fichier externe et vice versa, et que l'ordre des champs peut être mis en œuvre de manière plus souple.

Données prises en charge

Actuellement, les régimes d'importation et d'exportation sont soutenus par les modules suivants du logiciel :

Cet ensemble de fonctionnalités sera élargi à l'avenir et, à terme, l'ancien mécanisme d'importation/exportation sera entièrement remplacé par celui-ci.

Importation

When Data is imported, if it is too long for a field of type VARCHAR, it will be truncated.

Création / Edition

Les régimes d'importation et d'exportation sont créés à l'aide d'un compte d'administrateur client, et l'accès au menu "Paramètres du système ... Régimes d'importation et d'exportation".

Les informations suivantes sont requises :

ChampContenus
NomUn nom pour le régime d'importation et d'exportation.
Importer Exporter NomL'ensemble des données internes de jtel sur lesquelles reposera cette opération.
Définition XMLLa définition XML pour l'importation/exportation est fournie.

Définition XML

Un exemple de définition XML est fourni ci-dessous, ainsi qu'un fichier d'exemple, pour illustrer la définition XML. 

Translations Ignore


Code Block
titleExemple de définition XML
<importExport2> <import> <type>CSV</type> <encoding>UTF-8</encoding> <delimiter>;</delimiter> </import> <export> <type>CSV</type> <encoding>UTF-8</encoding> <bom>1</bom> <delimiter>;</delimiter> </export> <fieldMappings> <fieldMapping internalField="RandomSortOrder" externalField="Priority" externalType="INTEGER" importOnly="true"/> <fieldMapping internalField="ReferenceNumber" externalField="RefNumber" externalType="VARCHAR"/> <fieldMapping internalField="ExternalSystemLink" externalField="Hyperlink" externalType="VARCHAR"/> <fieldMapping internalField="" externalField="EKCODE" externalType="VARCHAR"/> <fieldMapping internalField="Salutation" externalField="Sal" externalType="VARCHAR"/> <fieldMapping internalField="Name" externalField="Name" externalType="VARCHAR"/> <fieldMapping internalField="FirstName" externalField="First" externalType="VARCHAR"/> <fieldMapping internalField="Address" externalField="Addr" externalType="VARCHAR"/> <fieldMapping internalField="Country" externalField="Country" externalType="VARCHAR"/> <fieldMapping internalField="PostalCode" externalField="PostCode" externalType="VARCHAR"/> <fieldMapping internalField="City" externalField="City" externalType="VARCHAR"/> <fieldMapping internalField="PhoneNumber1" externalField="Tel1" externalType="TEL:49"/> <fieldMapping internalField="PhoneNumber2" externalField="Tel2" externalType="TEL:49"/> <fieldMapping internalField="Email" externalField="Mail" externalType="VARCHAR"/> <fieldMapping internalField="Tag" externalField="DataIdentifier" externalType="VARCHAR"/> <fieldMapping internalField="UserData" externalField="CustomerNumber" externalType="VARCHAR"/> <fieldMapping internalField="dtBeginDate" externalField="StartDate" externalType="DATETIME:dd.MM.yyyy"/> <fieldMapping internalField="dtEndDate" externalField="EndDate" externalType="DATETIME:yyyyMMdd"/> <fieldMapping internalField="Client" externalField="ClientName" externalType="VARCHAR"/> <fieldMapping internalField="" externalField="NotImported1" externalType="VARCHAR"/> <fieldMapping internalField="" externalField="NotImported2" externalType="VARCHAR"/> <fieldMapping internalField="" externalField="NotImported2" externalType="VARCHAR"/> </fieldMappings> </importExport2>