Open Thema mit Navigation

Diese Funktionalität ist nur in bestimmten Ausbaustufen verfügbar.

Sie befinden sich hier: Tutorial > Projekterzeugung per Import > Teil 3 – Durch Importieren einer CSV-Datei Werte in einzelne Parameter schreiben > Durch Importieren einer CSV-Datei Werte in einzelne Parameter schreiben

Durch Importieren einer CSV-Datei Werte in einzelne Parameter schreiben

Voraussetzungen:

Der Bibliotheks-Katalog enthält neben den Systembibliotheken die Architektur T_Mechatronic_Architecture und den Baukasten T_Mechatronic_ModularSystem.

Im Projekt-Katalog ist das Projekt Feeder vorhanden.

Um Parameterwerte in der bestehenden Konfiguration zu setzen wird die CSV-Datei Parameter.csv importiert. Dazu wird noch die Vorlagen-Datei Template_CSV.imx benötigt.

Hinweis:

Mit den identischen Vorlagen- und Schema-Dateien können identisch aufgebaute Excel-Dateien importiert werden.

Closed Inhalt der Parameters.csv:

Beschreibung der CSV-Datei:

Die CSV-Datei besteht aus 8 Zeilen und 3 Spalten.

Die Spalten haben keine Überschriften.

Über den auszuwertenden Daten wird mit einer Zelle, die den Text "Header" enthält, ein Bereich für Kopdaten eingeleitet. Die Kopfdaten enden in der Zeile, in der eine Zelle mit dem Text "LineEndHeader" enthalten ist.

Die auszuwertenden Daten sind über 3 Spalten verteilt:

A = Name des Parameters

B = Wert des Parameters

C = Typ des Parameters

Diese Angaben werden mit Hilfe der XSL-Datei Parameter.xsl intern in ein Fragment im IMX-Format konvertiert. Das Fragment wird in der Vorlagendatei Template_CSV.imx anstelle des Tags <importFragment/> eingefügt.

Closed Inhalt der Template_CSV.imx: 

<?xml version="1.0" encoding="utf-8"?>
<imx xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xi="http://www.w3.org/2001/XInclude" version="1.0">
	<project name="Feeder" save="true">
		<libraries>
			<add type="String" value="T_Mechatronic_ModularSystem"/>
		</libraries>
		<mo name="Feeder" typeClass="T_Mechatronic_ModularSystem.Mechatronic.Stations.Feeder" >
			<importFragment/>
		</mo>
	</project>
</imx>

So werden Parameterwerte gesetzt:

  1. Wählen Sie den Menüpunkt Datei > Importieren....

    2. Der Import-Assistent öffnet sich mit der Seite Auswählen.

  2. Navigieren Sie zu Projekt > Import.
  3. Bestätigen Sie mit [Weiter >].

    4. Der Import-Assistent öffnet die Seite Importiere Datei.

  4. Geben Sie im Feld Quell-Dateiname die Datei Parameter.csv an.

    5. Die Datei befindet sich im folgenden Verzeichnis:

    <EEC installation path>\resources\Import\CSV

    Nutzen Sie [Durchsuchen...] um zur Datei zu navigieren. Wählen Sie gegebenenfalls den Dateifilter Excel Arbeitsmappen (*.xls, *.xlsx, *.xlsm).

  5. Wählen Sie aus der aufklappbaren Liste Default:Parameter.xsl. Das Eingabefeld wird dadurch ausgegraut.
  6. Geben Sie im Feld Dateiname der Vorlage die Datei Template_CSV.imx an.

    7. Die Datei befindet sich im folgenden Verzeichnis:

    <EEC installation path>\resources\Import\IMX

    Nutzen Sie [Durchsuchen...] um zur Datei zu navigieren. Wählen Sie gegebenenfalls den Dateifilter IMX-Dateien (*.imx).

  7. Entfernen Sie die Option Neues Projekt anlegen und markieren Sie in der Liste darunter das Projekt Feeder.
  8. Bestätigen Sie mit [Fertigstellen].

Ergebnis:

Im Projekt-Katalog wird die Konfiguration mit dem Namen Feeder angezeigt.

  1. Öffnen Sie die Komponente Feeder.
  2. Öffnen Sie den Editor Parameter (Parameters).

In der Spalte Wert (Value) ist zu erkennen, dass alle Werte aus der CSV-Datei als String importiert worden sind.

Der Parameter ParameterBoolean ist mit dem Wert ='true' befüllt. Da dies kein gültiger boolescher Wert ist, wird als Ergebnis false eingetragen.

Für die Parameter ParameterDouble und ParameterInteger werden Formelfehler angezeigt, da die importierten Werte nicht als Double, bzw. Integer interpretiert werden können.

Der Parameter ParameterMap ist durch den Import nicht befüllt worden und ist deshalb <<null>>.

Einzig der Parameter ParameterString ist mit dem Wert Hello World korrekt gesetzt.

Fazit:

Die dritte Spalte der CSV-Datei wurde bei Konvertierung nicht erfasst und in der Folge wurden alle importierten Werte als String interpretiert.

Sollen die Parameter typgerecht importiert werden, muss die Schemadatei für die Transformation der CSV-Datei in ein Fragment angepasst werden.

So ändern Sie die XSL-Datei:

  1. Kopieren Sie die Datei <EEC installation path>\install\importschemas\Parameter.xsl in den folgenden Ordner:
    2. <EEC installation path>\resources\Import\XSL
  2. Benennen Sie die Datei um zu ParameterWithType.xsl.
  3. Öffnen Sie die Datei ParameterWithType.xsl mit einem beliebigen Editor, beispielsweise Notepad++.
  4. Navigieren Sie in der Datei zum Tag <xsl:template match="row" >.

Aussehen vor der Änderung:

<xsl:template match="row" >
	<xsl:choose>
		<xsl:when test="@number > $LineEndHeader ">
			<xsl:element name="parameter">
				<xsl:attribute name="name">
					<xsl:value-of select="col[@number='1']"/>
				</xsl:attribute>
				<xsl:attribute name="value">
					<xsl:value-of select="col[@number='2']"/>
				</xsl:attribute>
			</xsl:element>
		</xsl:when>
		<xsl:otherwise>
		</xsl:otherwise>
		</xsl:choose>
</xsl:template>

Fügen Sie die folgenden Zeilen am Ende des Blocks von <xsl:element name="parameter"> ein:

<xsl:attribute name="type">
	<xsl:value-of select="col[@number='3']"/>
</xsl:attribute>

Das Ergebnis sollte so aussehen:

<xsl:template match="row" >
	<xsl:choose>
		<xsl:when test="@number > $LineEndHeader ">
			<xsl:element name="parameter">
				<xsl:attribute name="name">
					<xsl:value-of select="col[@number='1']"/>
				</xsl:attribute>
				<xsl:attribute name="value">
					<xsl:value-of select="col[@number='2']"/>
				</xsl:attribute>
				<xsl:attribute name="type">
					<xsl:value-of select="col[@number='3']"/>
				</xsl:attribute>
			</xsl:element>
		</xsl:when>
		<xsl:otherwise>
		</xsl:otherwise>
		</xsl:choose>
</xsl:template>

Import mit der geänderten Schemadatei ParameterWithType.xsl:

  1. Wählen Sie den Menüpunkt Datei > Importieren....

    2. Der Import-Assistent öffnet sich mit der Seite Auswählen.

  2. Navigieren Sie zu Projekt > Import.
  3. Bestätigen Sie mit [Weiter >].

    4. Der Import-Assistent öffnet die Seite Importiere Datei.

  4. Geben Sie im Feld Quell-Dateiname die Datei Parameter.csv an.

    5. Die Datei befindet sich im folgenden Verzeichnis:

    <EEC installation path>\resources\Import\CSV

    Nutzen Sie [Durchsuchen...] um zur Datei zu navigieren. Wählen Sie gegebenenfalls den Dateifilter Excel Arbeitsmappen (*.xls, *.xlsx, *.xlsm).

  5. Wählen Sie aus der aufklappbaren Liste Kunden-Schema. Geben Sie die geänderte Schema-Datei an.
    6. <EEC installation path>\resources\Import\XSL\ParameterWithType.xsl

    Nutzen Sie [Durchsuchen...] um zur Datei zu navigieren. Wählen Sie gegebenenfalls den Dateifilter Schema-XSL-Dateien (*.xsl, *.xslt).

  6. Geben Sie im Feld Dateiname der Vorlage die Datei Template_CSV.imx an.

    7. Die Datei befindet sich im folgenden Verzeichnis:

    <EEC installation path>\resources\Import\IMX

    Nutzen Sie [Durchsuchen...] um zur Datei zu navigieren. Wählen Sie gegebenenfalls den Dateifilter IMX-Dateien (*.imx).

  7. Entfernen Sie die Option Neues Projekt anlegen und markieren Sie in der Liste darunter das Projekt Feeder.
  8. Bestätigen Sie mit [Fertigstellen].

Ergebnis:

Im Projekt-Katalog wird die Konfiguration mit dem Namen Feeder angezeigt.

  1. Öffnen Sie die Komponente Feeder.
  2. Öffnen Sie den Editor Parameter.

In der Spalte Wert ist zu erkennen, dass alle Werte aus der CSV-Datei mit ihren eigenen Typen importiert worden sind.

Der Parameter ParameterMap ist durch den Import nicht befüllt worden und ist deshalb <<null>>.