Versions Compared

Old Version 17

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: Removed translated content for 'fr'

...

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 :

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. 

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
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.
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>