conversion agent studio in eclipse verwenden · workbench-fensters. in der regel umfasst eine...

Conversion Agent Studio in Eclipse verwenden

Der SAP Conversion Agent von Informatica(Version 8.5)

Conversion Agent Studio in Eclipse verwenden

Version 8.5

Copyright © 2001–2008 Informatica Corporation. Alle Rechte vorbehalten.

Diese Software und die zugehörige Dokumentation enthalten proprietäre Informationen der Informatica Corporation, werden unter einem Lizenzvertrag mit Einschränkungen hinsichtlich Verwendung und Veröffentlichung zur Verfügung gestellt und sind urheberrechtlich geschützt. Das Zurückentwickeln (Reverse Engineering) der Software ist untersagt. Ohne ausdrückliche schriftliche Genehmigung der Informatica Corporation darf kein Teil dieses Dokuments zu irgendeinem Zweck vervielfältigt oder übertragen werden, unabhängig davon, auf welche Art und Weise oder mit welchen Mitteln (elektronisch, mechanisch, durch Fotokopieren, Aufzeichnen usw.) dies geschieht. Diese Software ist durch US-amerikanische Patentnummern und andere ausstehende Patente geschützt.

Die Verwendung, Vervielfältigung oder Veröffentlichung der Software durch die US-Regierung unterliegt den Bestimmungen des jeweiligen Softwarelizenzvertrags und gemäß DFARS 227.7202-1(a) und 227.7702-3(a) (1995), DFARS 252.227-7013(c)(1)(ii) (OCT 1988), FAR 12.212(a) (1995), FAR 52.227-19 oder FAR 52.227-14 (ALT III).

Die in dieser Software und in diesem Dokument enthaltenen Informationen können jederzeit ohne vorherige Ankündigung geändert werden. Informatica Corporation gewährleistet nicht die Fehlerfreiheit dieser Software oder Dokumentation.

Informatica, PowerCenter, PowerCenterRT, PowerCenter Connect, PowerCenter Data Analyzer, PowerExchange, PowerMart, Metadata Manager, Informatica Data Quality, Informatica Data Explorer, Informatica Complex Data Exchange, Informatica On Demand Data Replicator und Informatica B2B Data Exchange sind Marken oder eingetragene Marken der Informatica Corporation in den USA und/oder anderen Ländern. Alle weiteren Produkt- und Firmennamen sind möglicherweise Markennamen oder Warenzeichen der jeweiligen Eigentümer.

Teile dieser Software und/oder Dokumentation sind durch die Urheberrechte Dritter geschützt, und zwar einschließlich, ohne Einschränkung: Copyright © Sun Microsystems. Alle Rechte vorbehalten. Copyright 1985-2003 Adobe Systems Inc. Alle Rechte vorbehalten. Copyright 1996-2004 Glyph & Cog, LLC. Alle Rechte vorbehalten.

Dieses Produkt enthält von Boost (http://www.boost.org/) entwickelte Software. Die mit dieser Software verbundenen Berechtigungen und Einschränkungen unterliegen den unter „http://www.boost.org/LICENSE_1_0.txt“ verfügbaren Bedingungen.

Dieses Produkt enthält von Mozilla (http://www.mozilla.org/) entwickelte Software. Die Ihnen erteilte Berechtigung, die Software oder entsprechende Unterlagen zu verwenden, unterliegt den Bestimmungen des GNU Lesser General Public License Agreements (siehe „http://www.gnu.org/licenses/lgpl.html“). Die Mozilla-Unterlagen werden wie besehen kostenlos von Informatica bereitgestellt, ohne ausdrückliche oder konkludente Garantie, einschließlich, aber nicht beschränkt auf konkludente Garantien der Handelsüblichkeit und/oder Eignung für einen bestimmten Zweck.

Dieses Produkt enthält Software, die von der Apache Software Foundation (http://www.apache.org/) entwickelt wurde und unter den Bedingungen des Lizenzvertrags von Apache License, Version 2.0, lizenziert ist. Eine Kopie des Lizenzvertrags erhalten Sie unter http://www.apache.org/licenses/LICENSE-2.0. Die unter dem Lizenzvertrag vertriebene Software wird „WIE BESEHEN“, OHNE JEGLICHE GEWÄHRLEISTUNG, weder ausdrücklich noch konkludent, vertrieben, es sei denn, dies wird durch anwendbares Recht angeordnet oder schriftlich vereinbart. Rechte und Einschränkungen für bestimmte Sprachen finden Sie in der entsprechenden Lizenzvereinbarung.

Dieses Produkt enthält von SourceForge (http://sourceforge.net/projects/mpxj/) entwickelte Software. Die Ihnen erteilte Berechtigung, die Software oder entsprechende Unterlagen zu verwenden, unterliegt den Bestimmungen des GNU Lesser General Public License Agreements (siehe „http://www.gnu.org/licenses/lgpl.html“). Die SourceForge-Unterlagen werden wie besehen kostenlos von Informatica bereitgestellt, ohne ausdrückliche oder konkludente Garantie, einschließlich, aber nicht beschränkt auf konkludente Garantien der Handelsüblichkeit und/oder Eignung für einen bestimmten Zweck.

Dieses Produkt enthält urheberrechtlich geschützte Curl-Software (Copyright 1996-2007, Daniel Stenberg, <[email protected]>). Alle Rechte vorbehalten. Die mit dieser Software verbundenen Berechtigungen und Einschränkungen unterliegen den unter „http://curl.haxx.se/docs/copyright.html“ verfügbaren Bedingungen. Die Erlaubnis, diese Software für jeden beliebigen Zweck gegen Gebühr oder kostenlos zu verwenden, zu kopieren, zu ändern und zu verteilen, wird hiermit erteilt, sofern die oben genannten urheberrechtlichen Hinweise und diese Erlaubnis in allen Exemplaren angegeben werden.

Dieses Produkt enthält urheberrechtlich geschützte ICU-Software (Copyright © 1995-2003 International Business Machines Corporation und andere). Alle Rechte vorbehalten. Die mit dieser Software verbundenen Berechtigungen und Einschränkungen unterliegen den unter „http://www-306.ibm.com/software/globalization/icu/license.jsp“ verfügbaren Bedingungen.

Dieses Produkt enthält urheberrechtlich geschützte OSSP UUID-Software (Copyright © 2002 Ralf S. Engelschall, Copyright © 2002 The OSSP Project Copyright © 2002 Cable & Wireless Deutschland). Die mit dieser Software verbundenen Berechtigungen und Einschränkungen unterliegen den unter „http://www.opensource.org/licenses/mit-license.php“ verfügbaren Bedingungen.

Dieses Produkt enthält urheberrechtlich geschützte Eclipse-Software (Copyright © 2007 The Eclipse Foundation). Alle Rechte vorbehalten. Die mit dieser Software verbundenen Berechtigungen und Einschränkungen unterliegen den unter „http://www.eclipse.org/org/documents/epl-v10.php“ verfügbaren Bedingungen.

libstdc++ wird gemäß den unter „http://gcc.gnu.org/onlinedocs/libstdc++/17_intro/license.html“ angegebenen Bestimmungen mit diesem Produkt vertrieben.

HAFTUNGSAUSSCHLUSS: Informatica Corporation stellt diese Dokumentation wie besehen bereit, ohne ausdrückliche oder konkludente Garantie, einschließlich, aber nicht beschränkt auf konkludente Garantien der Nichtverletzung von Rechten Dritter, der Handelsüblichkeit und/oder Eignung für einen bestimmten Zweck. Die in dieser Dokumentation bereitgestellten Informationen können technische Ungenauigkeiten oder Druckfehler enthalten. Informatica kann jederzeit ohne vorherige Ankündigung Verbesserungen und/oder Änderungen an den in dieser Dokumentation beschriebenen Produkten vornehmen.

Teilenummer: CDE-ECL-85000-0001

April 2008

Inhaltsverzeichnis

Vorwort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viiEinholen der Conversion-Agent-Dokumentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

Kapitel 1: Übersicht . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Einführung in die Studio-Umgebung . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Eclipse-Plattform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Kapitel 2: Arbeiten mit der Eclipse Workbench . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Öffnen der Workbench . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Anzeigen der Conversion Agent Perspektive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Layout der Conversion Agent-Perspektive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Menü. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Menü „Datei“ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Menü „Bearbeiten“ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Menü „Navigieren“. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Menü „Suchen“ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Menü „Projekt“ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Menü „Ausführen“ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Menü „IntelliScript“ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Menü „Fenster“ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Menü „Hilfe“ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Symbolleisten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Symbolleiste . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Shortcut-Leiste . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Symbolleisten in Sichten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Sichten und Editoren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Ändern der Größe einer Sicht bzw. eines Editors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Tastenkombinationen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Kapitel 3: Arbeiten mit Projekten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Anlegen eines Projekts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Speicherort von Projekten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Standardspeicherort Workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Projekte außerhalb des Workspace-Ordners speichern . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Speicherort eines Projekts ermitteln . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Workspace verschieben . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Mehrere Workspaces öffnen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Projektdateien . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Dateinamen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Anzeigen einer Datei . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Importieren eines vorhandenen Projekts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Ausführen eines Projekts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

iii

Anzeigen der Ergebnisse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Bereitstellen von Projekten als Dienst . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Kapitel 4: Verwenden der Ansichten von Conversion Agent . . . . . . . . . . . . . . . . . . . 19Arbeiten mit Sichten. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Anzeigen von Ansichten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Menüs in Sichten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Symbolleisten in Sichten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Ansichtentypen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Conversion Agent-Explorer-Ansicht . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Komponentenansicht . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Ansicht IntelliScript-Assistent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Hilfeansicht . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Ereignisansicht . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Binärquellenansicht . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Schema-Ansicht . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Repository-Ansicht . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Problemansicht . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Kapitel 5: Verwenden des IntelliScript-Editors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Über IntelliScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Erstellen oder Hinzufügen von TGP-Skriptdateien . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Öffnen eines IntelliScript-Editors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Layout des Editors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Registerkarten des Beispielbereichs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Finden von Ankern. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Komponenten und Eigenschaften . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Grundeigenschaften und erweiterte Eigenschaften . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Bearbeitungsverfahren. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Basisprozedur für das Bearbeiten: Auswahl-Eingabe-Zuordnen-Eingabe . . . . . . . . . . . . . 30

Kopieren und Einfügen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Drag&Drop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Suchen und Ersetzen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Einfügen von Komponenten in das IntelliScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Bearbeiten der Eigenschaften einer Komponente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Einfügen von Tabulatoren, Zeilenumbrüchen und anderen Sonderzeichen . . . . . . . . . . . . 32

Definieren einer globalen Komponente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Hilfe zu einer Komponente anzeigen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

IntelliScript-Symbole . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Geführter Modus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Speichern des IntelliScripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Menüs des IntelliScript-Editors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Anpassen der Komponentenliste . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

iv Inhaltsverzeichnis

Kapitel 6: Einstellungen in Conversion Agent Studio . . . . . . . . . . . . . . . . . . . . . . . . 39Bearbeiten der Einstellungen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Einstellungen für den XML- und den XSD-Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Stichwortverzeichnis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

v

vi Inhaltsverzeichnis

Vorwort

Conversion Agent Studio in Eclipse verwenden wurde für Entwickler, Analysten und sonstige Benutzer geschrieben, die Umwandlungen in Conversion Agent Studio entwerfen, konfigurieren und testen. In diesem Buch wird die Benutzeroberfläche von Studio beschrieben, die in Eclipse bereitgestellt wird. Es enthält Anleitungen zur Verwendung der Studio-Menüs, -Symbolleisten, -Ansichten und -Editoren.

Dieses Handbuch setzt voraus, dass Sie über grundlegende Kenntnissezum Arbeiten mit Conversion Agent verfügen. Diese Grundkenntnisse können Sie sich aneignen, indem Sie die interaktiven Übungen in Erste Schritte mit Conversion Agent ausführen.

Parallel zu diesem Buch sollten Sie das Conversion Agent Studio Benutzerhandbuch lesen, in dem Sie ausführliche Informationen zu den Umwandlungskomponenten finden, die Sie im Studio konfigurieren können.

Einholen der Conversion-Agent-DokumentationBei Windows-Plattformen wird die Dokumentation für den Conversion Agent als Online-Hilfe der Software mitgeliefert. Unter folgender Adresse können Sie PDF-Exemplare der Conversion Agent Handbücher herunterladen:

http://help.sap.com/saphelp_nw70/helpdata/en/43/fc39c16bfb025ee10000000a1553f7/content.htm

vii

http://help.sap.com/saphelp_nw70/helpdata/en/43/fc39c16bfb025ee10000000a1553f7/content.htm

viii Vorwort

K A P I T E L 1

Übersicht

Dieses Kapitel enthält folgendes Thema:

♦ Einführung in die Studio-Umgebung, 1

Einführung in die Studio-UmgebungConversion Agent Studio ist die Entwurfs- und Konfigurationsumgebung des Systems. Conversion Agent Mit dem Studio können Sie Umwandlungen implementieren, mit denen alle Arten von Daten verarbeitet werden können.

Conversion Agent Studio ist in die Eclipse-Plattform als Plug-In-Modul integriert. Die Eclipse-Plattform bietet eine vielseitige Entwicklungsumgebung, in der Sie Umwandlungen konfigurieren und bereitstellen können. Sie können die Umwandlungen entweder zusammen mit anderen in Eclipse entwickelten Projekten oder unabhängig von Eclipse verwenden.

Dieses Handbuch erläutert, wie Sie Conversion Agent Studio in der Eclipse-Umgebung verwenden. Es erhält Anleitungen für das Verwenden der Oberfläche von Eclipse, um Conversion Agent-Projekte zu erstellen, zu bearbeiten und zu verwalten.

Das Handbuch erklärt weder das logische Konzept von Conversion Agent noch, wie Umwandlungen funktionieren. Weitere Informationen zu diesen Themen finden Sie im Handbuch Erste Schritte mit Conversion Agent und im Conversion Agent Studio Benutzerhandbuch.

Hinweis: Dieses Handbuch beschreibt nur die Eclipse-Funktionen, die in Conversion Agent verwendet werden. Erläuterungen der weiteren Eclipse-Funktionen finden Sie in der Online-Hilfe von Eclipse.

Eclipse-PlattformEclipse ist eine offene Plattform für die Tool-Integration, die von der Eclipse Foundation entwickelt und gepflegt wird. Die Plattform stellt einen Rahmen zur Verfügung, der das Erstellen, Integrieren und Verwenden von Software-Tools vereinfacht. Die Tools arbeiten als Plug-Ins in der Eclipse-Umgebung.

Weitere Informationen über die Eclipse Foundation finden Sie unter http://www.eclipse.org.

Zu den wesentlichen Elementen der Eclipse-Umgebung gehören die Workbench, Projekte, der Arbeitsbereich (Workspace), Perspektiven, Ansichten und Editoren. In den folgenden Abschnitten werden diese Elemente erläutert.

1

http://www.eclipse.org/

WorkbenchDie Workbench ist die Desktop-Entwicklungsumgebung von Eclipse. Über die Umgebung können Sie Umwandlungen erstellen, bearbeiten, testen und bereitstellen.

ProjekteIn Eclipse führen Sie alle Arbeiten in einem Framework namens Projekt durch. Ein Projekt wird in einem angegebenen Ordner gespeichert, wobei einige Projektdateien jedoch auch außerhalb dieses Ordners abgelegt sein können.

WorkspaceEin Workspace ist der Speicherort, an dem Eclipse einen Satz Projekte speichert. Wenn Sie die Workbench öffnen, werden alle Projekte im aktuellen Workspace angezeigt. Es können mehrere Projekte, die zu demselben Workspace gehören, gleichzeitig bearbeitet werden.

Der Conversion Agent-Workspace ist der Arbeitsbereich, in dem Eclipse Conversion Agent-Projekte speichert. Standardmäßig gibt es einen einzigen Conversion Agent-Workspace unter folgendem Pfad:

Eigene Dateien\SAP\ConversionAgent\4.0\workspace

Sie haben die Möglichkeit, mehr als einen Workspace anzulegen. Sie können z. B. getrennte Arbeitsbereiche für Ihre Conversion Agent-Projekte und für andere Arten von Eclipse-Projekten anlegen. Sie können ebenfalls mehrere Arbeitsbereiche für verschiedene Mengen von Conversion Agent-Projekten haben. In einer Workbench kann immer nur jeweils ein Workspace geöffnet sein, Sie können jedoch mehrere Workbenches öffnen.

PerspektivenDie Workbench definiert eine oder mehrere Perspektiven. Eine Perspektive ist ein vordefiniertes Layout des Workbench-Fensters. In der Regel umfasst eine Perspektive einen Editorbereich und mehrere Ansichten. Dem Editor und den Ansichten können einer Reihe von Menüs und Symbolleisten zugeordnet werden.

Jede Perspektive stellt eine Reihe von Funktionen zum Durchführen einer bestimmten Art von Aufgabe oder zum Arbeiten mit bestimmten Ressourcen bereit. In diesem Buch wird die Erstellen-Perspektive (Authoring-Perspektive) von Conversion Agent beschrieben. Diese Perspektive stellt Editoren, Ansichten und weitere Tools für das Entwickeln und Testen von Umwandlungsprojekten bereit.

Abbildung 1-1. Eclipse Workbench

2 Kapitel 1: Übersicht

SichtenEine Ansicht ist ein Fenster, in dem Daten angezeigt werden.

Grundsätzlich formuliert können Sie in einer Ansicht Projektdaten betrachten, während Sie in einem Editor die Daten ändern können. In einer Ansicht können Sie zwar Optionen einstellen oder bestimmte vordefinierte Operationen ausführen, Sie können die Daten jedoch nicht frei bearbeiten.

Sichten dienen in der Regel dazu, in einem Projekt zu navigieren, einen Editor zu öffnen oder Eigenschaften eines Projekts anzuzeigen, welches in einem Editor ausgewählt ist. Die Explorer-Ansicht von Conversion Agent zeigt z. B. eine Liste der Projekte, die sich im Workspace von Conversion Agent befinden, sowie die Dateien an, die zu den Projekten gehören.

Einige Ansichten haben Menüs und Symbolleisten, über die Vorgänge für die Elemente in der Ansicht ausgeführt werden können.

Üblicherweise werden die Vorgänge, die Sie in einer Ansicht ausführen, sofort gespeichert. Sie müssen also nicht explizit den Befehl oder das Symbol zum Speichern anklicken. Anders verhält sich dies, wenn sich der Vorgang in der Ansicht auf den Inhalt eines Editors auswirkt. In diesem Fall müssen Sie das Projekt speichern, um den Vorgang unwiderruflich zu machen.

EditorenEin Editor ist ein Fenster, in dem Sie den Inhalt eines Projekts erstellen und ändern können. Ein Editor unterscheidet sich von einer Ansicht dadurch, dass Sie die Daten frei bearbeiten können. In einer Ansicht sind Sie auf wenige vordefinierte Vorgänge beschränkt.

Sie öffnen einen Editor, indem Sie in der Explorer-Ansicht von Conversion Agent auf eine Datei doppelklicken oder in der Komponentenansicht auf eine Komponente doppelklicken. Wenn Sie beispielsweise auf eine TGP-Skriptdatei doppelklicken, wird die Datei in einem IntelliScript-Editor geöffnet.

Sie können eine beliebige Anzahl an Editoren gleichzeitig öffnen, es kann aber immer nur einer aktiv sein. Das Menü und die Symbolleiste zeigen die Befehle und Operationen an, die im aktiven Editor anwendbar sind.

Registerkarten im Editor geben die Namen der Dateien oder Ressourcen an, die momentan zum Bearbeiten geöffnet sind. Ein Sternchen (*) auf der Registerkarte zeigt an, dass sich ungesicherte Daten im Editor befinden. Sie müssen den Befehl „Datei > Speichern“ oder die Schaltfläche „Speichern“ anklicken, um die Änderungen zu speichern.

Abbildung 1-2. IntelliScript-Editor für TGP-Skriptdateien

Einführung in die Studio-Umgebung 3

4 Kapitel 1: Übersicht

K A P I T E L 2

Arbeiten mit der Eclipse Workbench

Dieses Kapitel umfasst die folgenden Themen:

♦ Öffnen der Workbench, 5

♦ Menü, 6

♦ Symbolleisten, 9

♦ Sichten und Editoren, 10

♦ Tastenkombinationen, 10

Öffnen der WorkbenchDie Eclipse Workbench ist die Umgebung, in der Conversion Agent Studio arbeitet. Dieses Kapitel beschreibt die Werkzeuge der Workbench, die für die Verwendung in Conversion Agent zur Verfügung stehen, z. B. die Menüs, Symbolleisten und Fenster.

So öffnen Sie die Eclipse Workbench:

Klicken Sie im Windows-Startmenü auf „Alle Programme > SAP Conversion Agent > Studio“.

Anzeigen der Conversion Agent PerspektiveDamit Sie in Conversion Agent Studio arbeiten können, müssen Sie die Erstellen-Perspektive (Authoring-Perspektive) von Conversion Agent Studio öffnen. Die Perspektive stellt die Ansichten und Editoren bereit, die Sie zum Konfigurieren von Umwandlungsprojekten benötigen.

Wenn Sie die Eclipse Workbench schließen und erneut öffnen, wird weiterhin die aktuelle Perspektive angezeigt.

So öffnen Sie die Perspektive:

Klicken Sie im Eclipse-Menü auf „Window > Open Perspective > Other > Conversion Agent Studio Authoring“.

Wenn Sie die Perspektive verändert haben (z. B. durch Öffnen und Schließen von Fenstern oder durch Verschieben der Fenster), können Sie die Standardperspektive wiederherstellen.

So stellen Sie die Perspektive wieder her:

Klicken Sie im Eclipse-Menü auf „Window > Reset Perspective“.

5

Layout der Conversion Agent-PerspektiveWenn Sie die Conversion Agent-Perspektive erstmals anzeigen, werden folgende Fenster angezeigt:

♦ Conversion Agent Explorer-Ansicht

♦ Komponentenansicht

♦ Ereignisansicht

♦ Editorbereich

Die Komponenten- und die Ereignisansicht werden über anderen Ansichten gestapelt. Sie können die gewünschte Ansicht auswählen, indem Sie auf den Reiter der entsprechenden Registerkarte klicken.

MenüDie folgenden Abschnitte beschreiben die Befehle im Eclipse-Menü, die in Conversion Agent verwendet werden.

Je nach aktuellem Bearbeitungsvorgang können einige Befehle ausgeblendet oder deaktiviert sein. Einige Befehle werden nur angezeigt, wenn ein bestimmter Editor aktiv ist.

Hinweis: Die folgenden Tabellen enthalten nur die Befehle, die üblicherweise in Conversion Agent verwendet werden. Sie enthalten keine Befehle, die zwar von Eclipse bereitgestellt werden, in Conversion Agent aber nur selten verwendet werden.

Menü „Datei“Über das Menü „Datei“ können Sie Conversion Agent-Projekte erstellen, importieren und verwalten.

Menüoption Beschreibung

Neu Erstellt ein neues Projekt bzw. eine neue Komponente.Um ein neues Projekt zu erstellen, verwenden Sie den Befehl „Datei > Neu > Projekt“. Weitere Informationen hierzu finden Sie unter „Arbeiten mit Projekten“ auf Seite 11.Wenn Sie einem vorhandenen Projekt eine Parser- oder Serializer-Komponente hinzufügen möchten, verwenden Sie den Befehl „Datei > Neu > Parser oder Datei > Neu > Serializer“.

Schließen Schließt den aktiven Editor.

Alle schließen Schließt alle Editoren.

Speichern Speichert die aktive Projektdatei.

Workspace wechseln

Öffnet einen weiteren Workspace.

Drucken Druckt den Inhalt des aktiven Editors.

Druckereinrichtung (Print Setup)

Ermöglicht es, einen Drucker zu konfigurieren.

Importieren Mit diesem Befehl können Sie ein vorhandenes Conversion Agent-Projekt in den Workspace importieren.Weitere Informationen hierzu finden Sie unter „Importieren eines vorhandenen Projekts“ auf Seite 15.

Eigenschaften Mit diesem Befehl können Sie die Eigenschaften eines Projekts einstellen, das im Conversion Agent Explorer ausgewählt ist. Weitere Informationen über Projekteigenschaften finden Sie im Conversion Agent Studio Benutzerhandbuch.

Beenden Beendet Eclipse.

6 Kapitel 2: Arbeiten mit der Eclipse Workbench

Menü „Bearbeiten“Das Menü „Bearbeiten“ enthält die Standardbearbeitungsbefehle von Eclipse.

Menü „Navigieren“Die Befehle in diesem Menü sind Teil der Eclipse-Plattform. Sie haben keine bestimmte Anwendung in Conversion Agent Studio.

Menü „Suchen“Die Befehle in diesem Menü sind Teil der Eclipse-Plattform. Sie haben keine bestimmte Anwendung in Conversion Agent Studio.

Menü „Projekt“Das Menü „Projekt“ enthält mehrere Befehle für das Verwalten von Conversion Agent-Projekten.

Menü „Ausführen“Über das Menü „Ausführen“ können Sie eine Umwandlung in der Studio-Umgebung testen.


Rückgängig Macht den letzten Bearbeitungsvorgang rückgängig.

Wiederherstellen Stellt einen Vorgang wieder her, den Sie mit „Rückgängig“ abgebrochen haben.

Ausschneiden, Kopieren, Einfügen, Löschen

Mit diesen Befehlen können Sie den ausgewählten Inhalt im aktiven Editor kopieren und löschen.

Alles markieren Markiert den gesamten Inhalt des aktiven Editors.

Suchen/Ersetzen Sucht und ersetzt Text im aktiven Editor.


Validieren Überprüft die Integrität der Projektdateien. Der Befehl überprüft z. B., ob die in einem Projekt verwendeten Datenbehälter im XSD-Schema definiert sind.

Bereitstellen Stellt ein Projekt bereit, indem es das Projekt im Repository von Conversion Agent platziert. Conversion Agent Engine kann diese Projekte dann als Conversion Agent-Dienst ausführen. Weitere Informationen über das Bereitstellen von Diensten finden Sie im Conversion Agent Studio Benutzerhandbuch.

Eigenschaften Mit diesem Befehl können Sie die Eigenschaften eines Projekts einstellen, das in einem IntelliScript-Editor angezeigt wird. Weitere Informationen über Projekteigenschaften finden Sie im Conversion Agent Studio Benutzerhandbuch.


Ausführen Führt die Umwandlung aus.Wählen Sie im Dialogfenster die Startkomponente aus, die Conversion Agent aktivieren soll. Klicken Sie dann auf die Schaltfläche „Ausführen“, um die Umwandlung auszuführen.

<Name der Startkomponente> ausführen

Führt die Umwandlung aus, wenn die Startkomponente bereits definiert wurde.

Menü 7

Menü „IntelliScript“Das Menü „IntelliScript“ wird angezeigt, wenn der IntelliScript-Editor aktiv ist.

Menü „Fenster“Über das Menü „Fenster“ können Sie Perspektiven und Ansichten anzeigen.

Menü „Hilfe“Über das Menü „Hilfe“ können Sie Informationen zu Conversion Agent bzw. zu Eclipse anzeigen.


Einfügen Fügt eine Komponente wie Parser, Serializer, Variable, Marker, Content, Mapper oder RepeatingGroup ein.

Testdokument Schaltet die Anzeige im Beispielbereich temporär von der Beispielquelldatei auf eine andere Quelldatei um.

Beispielquelle öffnen Öffnet das Beispielquelldokument, das für eine Umwandlung definiert ist.

Automatisch Beispiel lernen Aktiviert die automatische Farbcodierung im Beispielbereich. Wenn Sie einen Parser konfigurieren, hebt Conversion Agent automatisch die Anker im Beispiel hervor.

Beispiel lernen Farbcodiert die Anker im Beispielbereich im Stil „Beispiel lernen“. In diesem Stil bezeichnen die Farben die verschiedenen Stellen, die Conversion Agent zum Definieren der Anker verwendet.

Beispiel markieren Führt den ausgewählten Parser aus und hebt die Anker im Beispielbereich im Stil „Beispiel markieren“ hervor. In diesem Stil bezeichnen die Farben die Instanzen eines Ankers, die der Parser im Beispiel gefunden hat.

Lernen/Markieren des Beispiels beenden

Beendet die Farbcodierung. Wenn das Beispiel sehr lang ist, können Sie die farbige Darstellung mit dieser Option beenden und die Anzeige damit beschleunigen.

IntelliScript Zeigt nur den IntelliScript-Bereich an.

Beide Zeigt sowohl den IntelliScript- als auch den Beispielbereich an.

Beispiel Zeigt nur den Beispielbereich an.

Geführter Modus Aktiviert den geführten Modus, der Sie beim Konfigurieren des IntelliScripts unterstützt. Weitere Informationen hierzu finden Sie unter „Geführter Modus“ auf Seite 34.


Perspektive öffnen Zeigt eine angegebene Perspektive an. Für Conversion Agent-Projekte müssen Sie in Conversion Agent Studio die Perspektive „Erstellen“ (Authoring) öffnen.

Ansicht einblenden Zeigt eine angegebene Ansicht an.

Perspektive wiederherstellen Stellt die aktuelle Perspektive wieder in ihrem Standardlayout her.

Einstellungen Mit diesem Befehl können Sie die Anzeigeeinstellungen angeben. Weitere Informationen hierzu finden Sie unter „Einstellungen in Conversion Agent Studio“ auf Seite 39.


Willkommen Zeigt die Willkommensseite von Conversion Agent Studio an. Die Seite enthält kurze Anleitungen für die Arbeit mit dem Studio.

Inhalt der Hilfe Zeigt die Onlinedokumentation von Eclipse an.


SymbolleistenDieser Abschnitt beschreibt die Symbolleisten, die in der Erstellen-Perspektive (Authoring-Perspektive) von Conversion Agent verfügbar sind.

SymbolleisteDie Workbench-Symbolleiste wird oben im Eclipse-Fenster direkt unter dem Menü angezeigt. Auf der linken Seite der Symbolleiste befinden sich die Standardschaltflächen für Eclipse. Auf der rechten Seite befinden sich die Schaltflächen, die speziell zur aktiven Perspektive und zum aktiven Editor gehören.

In der folgenden Tabelle werden die Schaltflächen erläutert, die in Conversion Agent verwendet werden.

Bibliothek hinzufügen oder entfernen Installiert, aktualisiert oder deinstalliert Umwandlungsbibliotheken, die mit Branchenstandards verwendet werden können, z. B. EDI oder HL7. Weitere Informationen finden Sie in Conversion Agent-Bibliotheken.

Conversion Agent Hilfe Zeigt die Onlinedokumentation von Conversion Agent an.

Über Conversion Agent Studio Zeigt Informationen zur Version von Conversion Agent Studio an.

Abbildung 2-1. Symbolleiste, wenn ein IntelliScript-Editor aktiv ist

Tool Beschreibung

Neu Die Schaltfläche Neu zeigt den Neue Projektassistenten an, der Sie beim Anlegen verschiedener Typen von Projekten unterstützt. Weitere Informationen hierzu finden Sie unter „Arbeiten mit Projekten“ auf Seite 11.Der Pfeil unmittelbar rechts neben der Schaltfläche „Neu“ bietet Optionen für bestimmte Typen von neuen Projekten oder Komponenten.

Speichern Speichert Ihre Änderungen

Drucken Druckt den Inhalt des aktiven Editors.

Nur IntelliScript-Bereich einblenden Zeigt nur den IntelliScript-Bereich an.

IntelliScript- und Beispielbereich einblenden.

Zeigt sowohl den IntelliScript- als auch den Beispielbereich an.

Nur Beispielbereich einblenden Zeigt nur den Beispielbereich an.

Geführten Modus und Tipps in IntelliScript aktivieren

Aktiviert den geführten Modus, der Sie beim Konfigurieren des IntelliScripts unterstützt. Weitere Informationen hierzu finden Sie unter „Geführter Modus“ auf Seite 34.

Neuen Parser in Skript einfügen Fügt eine neue Parser-Komponente in das IntelliScript ein.

Neuen Serializer in Skript einfügen Fügt eine neue Serializer-Komponente in das IntelliScript ein.

Neuen Mapper in Skript einfügen Fügt eine neue Mapper-Komponente in das IntelliScript ein.

Neue Variable in Skript einfügen Fügt eine neue Variable in das IntelliScript ein.

Neuen Marker in Skript einfügen Fügt einen neuen Marker-Anker in das IntelliScript ein.

Neuen Content in Skript einfügen Fügt einen neuen Content-Anker in das IntelliScript ein.

Neue RepeatingGroup in Skript einfügen

Fügt einen neuen RepeatingGroup-Anker in das IntelliScript ein.


Symbolleisten 9

Shortcut-LeisteStandardmäßig befindet sich die Shortcut-Leiste unter der Symbolleiste. Über die Shortcut-Leiste können Sie Perspektiven öffnen und wechseln.

Symbolleisten in SichtenEinige Ansichten verfügen über ihre eigenen Symbolleisten. Weitere Informationen hierzu finden Sie unter „Verwenden der Ansichten von Conversion Agent“ auf Seite 19.

Sichten und EditorenIn der Authoring-Perspektive von Conversion Agent sind viele Ansichten und Editoren definiert. Weitere Informationen hierzu finden Sie unter „Verwenden der Ansichten von Conversion Agent“ auf Seite 19 und unter „Verwenden des IntelliScript-Editors“ auf Seite 25.

Ändern der Größe einer Sicht bzw. eines EditorsSie können die Größe einer Ansicht oder eines Editors durch Ziehen an den zugehörigen Rahmenlinien ändern.

Um eine Ansicht oder einen Editor zu maximieren, doppelklicken Sie auf die Titelleiste. Um die ursprüngliche Größe des Fensters wiederherzustellen, führen Sie einen Rechtsklick auf der Titelleiste aus und wählen „Wiederherstellen“ aus.

Um das Fenster an eine neue Position zum Andocken zu verschieben, ziehen Sie an dessen Titelleiste. Eclipse lässt es nicht zu, Fenster an bestimmten Stellen anzudocken. Sie können z. B. eine Ansicht an einer anderen Ansicht andocken, nicht aber an einen Editor.

TastenkombinationenEinige der Befehle von Conversion Agent können Sie durch Drücken von Tastenkombinationen ausführen.

Die Tastenkombinationen werden in den Menüs angezeigt. Im Menü „Ausführen“ wird z. B. angegeben, dass die Taste F5 eine Umwandlung ausführt.

Beispiel automatisch lernen, wenn sich Skript ändert

Aktiviert die automatische Farbcodierung im Beispielbereich. Wenn Sie im IntelliScript Anker definieren, hebt Conversion Agent die entsprechende Stelle im Beispiel automatisch hervor.

Beispiel entsprechend des aktuellen Skripts lernen

Farbcodiert die Anker im Beispielbereich im Stil „Beispiel lernen“. In diesem Stil bezeichnen die Farben die verschiedenen Stellen, die Conversion Agent zum Definieren der Anker verwendet.

Gesamtes Beispiel entsprechend des aktuellen Skripts markieren

Führt den ausgewählten Parser aus und hebt die Anker im Beispielbereich im Stil „Beispiel markieren“ hervor. In diesem Stil bezeichnen die Farben die Instanzen eines Ankers, die der Parser im Beispiel gefunden hat.

Beispiel markieren oder lernen beenden

Beendet die Farbcodierung. Wenn das Beispiel sehr lang ist, können Sie die farbige Darstellung mit dieser Option beenden und die Anzeige damit beschleunigen.

Tool Beschreibung


K A P I T E L 3

Arbeiten mit Projekten


♦ Anlegen eines Projekts, 11

♦ Speicherort von Projekten, 13

♦ Projektdateien, 14

♦ Importieren eines vorhandenen Projekts, 15

♦ Ausführen eines Projekts, 16

♦ Bereitstellen von Projekten als Dienst, 17

Anlegen eines ProjektsEin Conversion Agent-Projekt enthält die Dateien und Ressourcen, die zum Ausführen einer oder mehrerer Umwandlungen nötig sind. In Conversion Agent Studio können Sie Projekte anlegen, konfigurieren und bereitstellen.

Jedes Projekt ist einem bestimmten Ordner auf Ihrer Festplatte zugeordnet. Die meisten Projektdateien werden in diesem Ordner gespeichert. Einige Dateien, z. B. das Quelldokument, können an anderen Speicherorten gespeichert werden.

So legen Sie ein neues Conversion Agent-Projekt an:

1. Klicken Sie im Menü auf „Datei > Neu > Projekt“.

2. Erweitern Sie im Assistenten „Neues Projekt“ den Knoten Conversion Agent.

11

3. Wählen Sie einen der folgenden Projekttypen von Conversion Agent aus:

4. Geben Sie die folgenden Informationen ein:

5. Folgen Sie den Anweisungen auf dem Bildschirm, um die weiteren Projektoptionen zu konfigurieren. Die Optionen variieren je nach Projekttyp, den Sie ausgewählt haben.

Wenn Sie den Assistenten abgeschlossen haben, wird der Projektordner auf Ihrer Festplatte angelegt. Die Projektdateien werden in der Explorer-Ansicht von Conversion Agent angezeigt.

So gehen Sie vor, um ein vorhandenes Projekt zu öffnen und zu bearbeiten:

1. Öffnen Sie Conversion Agent Studio.

2. Expandieren Sie im Conversion Agent Explorer den Baum unter dem Projekt.

3. Doppelklicken Sie auf die Datei, die Sie betrachten oder bearbeiten möchten, z. B. eine TGP-Skriptdatei, oder führen Sie einen Rechtsklick aus und wählen „Öffnen“ aus.

Sie können ein Projekt auch öffnen, indem Sie in der Komponentensicht auf eine Komponente doppelklicken.

So entfernen Sie ein Projekt:

Klicken Sie im Conversion Agent Explorer mit der rechten Maustaste auf das Projekt, und klicken Sie auf „Entfernen“.

Projekttyp Beschreibung

Leeres Projekt Diese Option legt ein nicht konfiguriertes Projekt an. Wenn Sie das Projekt angelegt haben, können Sie mit dem IntelliScript-Editor und den anderen Werkzeugen von Conversion Agent eine beliebige Art der Umwandlung konfigurieren.Ein leeres Projekt wird erfahrenen Benutzern von Conversion Agent empfohlen. Dieser Projekttyp ist am flexibelsten, der Assistent führt Sie jedoch nicht durch die Schritte der Projektkonfiguration.

Import-Projekt Diese Option generiert ein Conversion Agent-Projekt aus einer vorhandenen COBOL-Datendefinition. Das Projekt enthält einen Parser, einen Serializer und ein XSD-Schema, welche mit COBOL-Daten in Übereinstimmung mit der Definition arbeiten. Weitere Informationen dazu finden Sie in Verarbeiten von COBOL-Daten in Conversion Agent.Hinweis: Verwenden Sie diese Option nicht, um ein vorhandenes Conversion Agent-Projekt zu importieren. Verwenden Sie zu diesem Zweck „Datei > Importieren“.

Bibliotheksprojekt Diese Option importiert ein Projekt aus einer Conversion Agent-Bibliothek. Der Assistent legt eine Kopie des Projekts an, die Sie dann Ihren Anforderungen entsprechend bearbeiten können. Weitere Informationen hierzu finden Sie unter Conversion Agent Bibliotheken.

Parser-Projekt Diese Option legt ein Projekt an, das einen Parser enthält. Der Assistent führt Sie durch die Grundkonfiguration des Parsers. Sie werden z. B. aufgefordert, ein Beispielquelldokument zu definieren und ein XSD-Schema auszuwählen. Wenn Sie den Assistenten abgeschlossen haben, müssen Sie das IntelliScript bearbeiten und Komponenten wie Anker und Aktionen hinzufügen. Weitere Informationen über Parser finden Sie im Conversion Agent Studio Benutzerhandbuch.

Serializer-Projekt Diese Option legt ein Projekt an, welches einen Serializer enthält. Der Assistent führt Sie durch die Grundkonfiguration des Serializers. Sie werden z. B. aufgefordert, ein XSD-Schema auszuwählen. Wenn Sie den Assistenten abgeschlossen haben, müssen Sie das IntelliScript bearbeiten und Komponenten wie Serialisierungsanker und Aktionen hinzufügen. Weitere Informationen über Serializer finden Sie im Conversion Agent Studio Benutzerhandbuch.

Eigenschaft Beschreibung

Projektname Ein Bezeichner für das Projekt.

Projektspeicherort Der Speicherort des Projektordners. Der Standardspeicherort ist der Eclipse-Workspace. Weitere Informationen hierzu finden Sie unter „Speicherort von Projekten“ auf Seite 13.

12 Kapitel 3: Arbeiten mit Projekten

Sie werden aufgefordert, den Projektordner von der Festplatte zu löschen. Wenn Sie den Ordner nicht löschen, wird das Projekt zwar aus dem Workspace entfernt, Sie können es jedoch wieder importieren, wenn Sie es später verwenden wollen.

So aktivieren Sie ein Projekt:

Wählen Sie in der Explorer-Ansicht von Conversion Agent ein Projekt aus.

Das Projekt wird aktiviert. Die anderen Sichten zeigen Informationen zum aktiven Projekt an.

Speicherort von ProjektenStandardmäßig speichert Conversion Agent Studio alle Projekte im Workspace-Ordner von Eclipse.

Wenn Sie in Eclipse arbeiten, müssen Sie den Speicherort des Projekts nicht kennen. Eclipse verwaltet die Projekte und Dateien automatisch. Möglicherweise möchten Sie aber z. B. zu folgenden Zwecken den Speicherort Ihres Projekts überprüfen:

♦ Um Ihre Conversion Agent-Projekte zu sichern.

♦ Um eine Datei zu speichern, die nicht von Eclipse verwaltet wird, wie z. B. ein Testdokument oder die Spezifikation eines Projektdesigns.

Sie können den Speicherort des Workspace verschieben, wenn dies erforderlich ist.

Die folgenden Abschnitte beschreiben zusammengefasst, wie diese Aufgaben durchgeführt werden. Weitere Informationen hierzu finden Sie in der Eclipse-Dokumentation.

Standardspeicherort WorkspaceDer Standardspeicherort des Eclipse-Workspace für Conversion Agent-Projekte ist:

Eigene Dateien\SAP\ConversionAgent\4.0\workspace

Projekte außerhalb des Workspace-Ordners speichernMit dem Assistenten „Neues Projekt“ können Sie ein Projekt entweder im Workspace oder an einem anderen Speicherort anlegen.

In beiden Fällen betrachtet Eclipse das Projekt als zum Workspace gehörig. Wenn Sie Conversion Agent Studio schließen und erneut öffnen, wird das Projekt weiterhin im Conversion Agent Explorer angezeigt. Sie können Projekte, die außerhalb des Workspace-Ordners gespeichert werden, auf dieselbe Weise bearbeiten und ausführen wie Projekte, die im Workspace-Ordner gespeichert werden.

Speicherort eines Projekts ermittelnSie können den Speicherort eines Projekts durch eine der folgenden Methoden ermitteln:

So ermitteln Sie den Speicherort mit dem Conversion Agent Explorer:

1. Wählen Sie in der Explorer-Ansicht von Conversion Agent das Projekt aus.

2. Wählen Sie im Menü „Datei“ die Option „Eigenschaften“ aus.

3. Die Info-Seite des Eigenschaftenfensters zeigt den Speicherort des Projekts an.

So ermitteln Sie den Speicherort mit dem IntelliScript-Editor:

1. Wählen Sie beim Bearbeiten einer TGP-Skriptdatei im IntelliScript-Editor „Projekt > Eigenschaften“.


Speicherort von Projekten 13

So ermitteln Sie den Speicherort mit dem Eclipse Navigator:

1. Klicken Sie im Menü „Windows“ auf „Show View > Other“.

2. Expandieren Sie die Kategorie „General“, öffnen Sie die Navigator-Ansicht, und klicken Sie auf OK.

3. Klicken Sie im Navigator mit der rechten Maustaste auf das gewünschte Projekt oder die gewünschte Datei, und klicken Sie auf „Properties“.


Workspace verschiebenSie können den Speicherort des Workspace von Conversion Agent Studio verschieben, indem Sie die folgenden Schritte ausführen. Dies kann beispielsweise erforderlich sein, wenn andere Benutzer auf den Workspace zugreifen müssen, aber keine entsprechenden Berechtigungen für den Standardspeicherort des Workspace haben.

So verschieben Sie den Speicherort des Workspace von Conversion Agent Studio:

1. Schließen Sie Conversion Agent Studio.

2. Klicken Sie im Windows-Startmenü auf „SAP Conversion Agent > Konfiguration“.

Dadurch wird der Konfigurationseditor von Conversion Agent geöffnet.

3. Bearbeiten Sie die folgende Einstellung:

CM Configuration/CM Studio/Eclipse/Workspace

4. Öffnen Sie Conversion Agent Studio.

Wenn der neue Workspace-Ordner noch nicht vorhanden ist, wird er erstellt.

5. Klicken Sie im Menü „Fenster“ auf „Perspektive öffnen > Conversion Agent Studio erstellen“ (Authoring).

6. Importieren Sie ggf. die Projekte aus dem alten Workspace in den neuen. Weitere Informationen hierzu finden Sie unter „Importieren eines vorhandenen Projekts“ auf Seite 15.

Mehrere Workspaces öffnenSie können nicht zwei Workspaces gleichzeitig in einer einzigen Instanz der Eclipse Workbench öffnen. Sie können aber zwei Workbenches öffnen, die mit unterschiedlichen Workspaces konfiguriert sind.

ProjektdateienDie Hauptdateitypen, die in Conversion Agent-Projekten verwendet werden, lauten wie folgt:

Dateityp Beschreibung

Hauptprojektdatei Eine *.cmw-Datei, die die Daten des Hauptprojekts enthält Der Name dieser Datei ist der Name des Projekts.

Beispielquelldokumente Beispiele der Eingabedokumente, die in einer Umwandlung verarbeitet werden sollen

Skriptdateien Eine oder mehrere *.tgp-Dateien, die Umwandlungen definieren

XSD-Schemadateien Eine oder mehrere *.xsd-Dateien, die die in Umwandlungen verwendeten XML-Strukturen definieren

Ergebnisdateien Dateien, die infolge der Ausführung eines Projekts erstellt werden, z. B. Ausgabe- und Protokolldateien.


DateinamenZur Sicherstellung plattformübergreifender Kompatibilität dürfen die Namen der Projektverzeichnisse nur die Buchstaben des englischen Alphabets (A-Z, a-z), Ziffern (0-9), Leerzeichen sowie die folgenden Symbole enthalten:

# % & + , - . = @ [ ] _ { }

Anzeigen einer DateiIn jedem Projekt zeigt der Conversion Agent Explorer Kategorien für die oben genannten Dateitypen an, zum Beispiel:

Examples Scripts XSD Results

Um eine der Dateien zu öffnen, doppelklicken Sie im Conversion Agent Explorer auf den Dateinamen.

Importieren eines vorhandenen ProjektsSie können ein Projekt importieren, das außerhalb des aktuellen Eclipse-Workspace gespeichert ist.

Das Importverfahren kopiert die wichtigen Projektdateien wie zum Beispiel die CMW-, TGP-, XSD- und Beispielquelldateien. Eventuell kopiert es andere im Projektordner gespeicherte Dateien wie etwa Testdokumente nicht. Solche Dateien müssen Sie manuell kopieren.

Es gibt keine Verknüpfung zwischen dem ursprünglichen Projekt und der importierten Kopie. Wenn Sie also die importierte Kopie bearbeiten, bleibt das ursprüngliche Projekt unverändert.

So importieren Sie ein Projekt:

1. Wählen Sie im Menü „Datei“ die Option „Importieren“ aus.

Daraufhin wird ein Importassistent geöffnet.

2. Wählen Sie die Option aus, mit der ein vorhandenes Conversion Agent-Projekt in den Workspace (Arbeitsbereich) importiert wird, und klicken Sie auf „Weiter“.

3. Navigieren Sie zur *.cmw-Datei des vorhandenen Projekts.

4. Geben Sie einen Namen für das importierte Projekt ein.

Der Standardname ist der Name des vorhandenen Projekts.

5. Klicken Sie auf „Fertigstellen“.

6. Wenn das vorhandene Projekt in einer früheren Version von Conversion Agent erstellt wurde, werden Sie aufgefordert, die importierte Kopie zu aktualisieren. Klicken Sie auf OK.

Das System kopiert das Projekt in den Workspace-Ordner von Conversion Agent. Wenn der Import abgeschlossen ist, wird das importierte Projekt im Conversion Agent Explorer angezeigt.

Hinweis: Wenn das Projekt bereits zu einem anderen Eclipse-Workspace gehört oder in Eclipse angelegt wurde, gibt es einen alternativen Importvorgang. Wählen Sie in Schritt 2 die Option, ein vorhandenes Projekt in den Workspace zu importieren. Dadurch bleibt das ursprüngliche Projekt an seinem aktuellen Speicherort und wird dem aktuellen Workspace hinzugefügt. Es wird keine Kopie des Projekts erstellt.

Importieren eines vorhandenen Projekts 15

Ausführen eines Projekts Um ein Projekt zu testen, können Sie es in Conversion Agent Studio ausführen.

So führen Sie ein Projekt aus:

1. Legen Sie die Startkomponente des Projekts auf eine der folgenden Arten fest:

♦ Klicken Sie die Komponente im IntelliScript-Editor mit der rechten Maustaste an, und klicken Sie „Als Startkomponente definieren“ an.

♦ Klicken Sie die Komponente in der Komponentenansicht mit der rechten Maustaste an, und klicken Sie „Als Startkomponente definieren“ an.

♦ Wählen Sie im Menü den Befehl „Ausführen > Ausführen“ aus. Wählen Sie im Dialogfenster die Startkomponente aus.

2. Sie können im Befehl „Ausführen > Ausführen“ auf die Schaltfläche „Details“ klicken und Anfangswerte für die Variablen festlegen, die im Projekt definiert sind.

Die Anfangswerte, die Sie auf diese Weise zugewiesen haben, werden verwendet, wenn Sie das Projekt in Conversion Agent Studio testen. Diese Werte haben keinerlei Auswirkungen, wenn Sie das Projekt später als einen Conversion Agent-Dienst bereitstellen.

Weitere Informationen über Variablen finden Sie im Conversion Agent Studio Benutzerhandbuch.

3. Wenn Sie die Komponente ausführen möchten, klicken Sie auf einen der folgenden Befehle:

♦ Ausführen > Ausführen

♦ Ausführen > Startup Component Name ausführen

Anzeigen der ErgebnisseUm die Ausgabe eines Projekts anzuzeigen, doppelklicken Sie auf die entsprechende Datei in der Kategorie Ergebnisse der Explorer-Ansicht von Conversion Agent.

Die Ausgabe eines Parsers ist beispielsweise eine XML-Datei. Um die Ausgabe anzuzeigen, suchen Sie die XML-Datei in der Kategorie Ergebnisse und doppelklicken auf deren Namen. Abhängig von den Studio-Einstellungen wird die XML-Datei in einem einfachen Texteditor oder in Microsoft Internet Explorer angezeigt. Weitere Informationen hierzu finden Sie unter „Einstellungen für den XML- und den XSD-Editor“ auf Seite 41.

Hinweis: Wenn Sie Windows XP SP2 oder höher verwenden, zeigt der Internet Explorer eventuell eine Warnung an, die auf aktive Inhalte in der XML-Ergebnisdatei hinweist. Diese Meldung können Sie bedenkenlos ignorieren.


Bereitstellen von Projekten als DienstWenn Sie ein Projekt bereitstellen, wird es in das Repository von Conversion Agent kopiert. Conversion Agent Engine kann dieses Projekt dann als Conversion Agent-Dienst ausführen.

So stellen Sie ein Projekt bereit:

1. Wählen Sie im Menü „Projekt“ den Befehl „Bereitstellen“ aus.

2. Bearbeiten Sie die Optionen, und klicken Sie auf „Bereitstellen“.

Weitere Informationen über das Bereitstellen von Diensten finden Sie im Conversion Agent Studio Benutzerhandbuch.

Bereitstellen von Projekten als Dienst 17

K A P I T E L 4

Verwenden der Ansichten von Conversion Agent


♦ Arbeiten mit Sichten, 19

♦ Ansichtentypen, 20

Arbeiten mit SichtenDie Conversion Agent-Ansichten bieten Ihnen unterschiedliche Möglichkeiten, Projektinformationen darzustellen. Verwenden Sie die Ansichten z. B. für folgende Zwecke:

♦ Analysieren der Dateien und Komponenten eines Projekts

♦ Öffnen einer Datei in einem Editor

♦ Analysieren der beim Ausführen eines Projekts auftretenden Ereignisse

♦ Diagnostizieren von Problemen in der Umwandlungssyntax

♦ Lesen der Online-Hilfe zu einer Komponente

Anzeigen von AnsichtenUm die Conversion Agent-Ansichten anzuzeigen, öffnen Sie die Authoring-Perspektive von Conversion Agent.

Standardmäßig werden die Ansichten auf der linken Seite und im unteren Bereich der Workbench angezeigt. Viele der Ansichten sind gestapelt. Um zwischen den Ansichten zu wechseln, klicken Sie jeweils auf den Reiter der entsprechenden Registerkarte.

Menüs in SichtenWenn Sie in einer Ansicht einen Rechtsklick ausführen, wird ein Menü angezeigt. In dem Menü stehen Befehle zur Verfügung, die für die jeweilige Ansicht bzw. für das Element, welches Sie in der Ansicht ausgewählt haben, spezifisch sind. Einige Befehle in den Menüs in Ansichten sind in den anderen Menüs oder in Symbolleisten nicht verfügbar.

19

Symbolleisten in SichtenIn einigen Ansichten wird eine kleine Symbolleiste angezeigt, über die Vorgänge für Elemente in der jeweiligen Ansicht ausgeführt werden können.

AnsichtentypenDieser Abschnitt beschreibt die Ansichten, die in der Erstellen-Perspektive (Authoring) von Conversion Agent Studio verfügbar sind.

Conversion Agent-Explorer-AnsichtDie Explorer-Ansicht von Conversion Agent listet alle Conversion Agent-Projekte und -Dateien auf, die im Workspace vorhanden sind. Sie können eine Datei in einem Editor öffnen, indem Sie auf den Dateinamen doppelklicken.

Standardmäßig wird die Ansicht im oberen linken Bereich der Workbench angezeigt.

MenüWenn Sie in der Explorer-Ansicht von Conversion Agent einen Rechtsklick ausführen, erscheint ein Menü mit folgenden Optionen:

KomponentenansichtDie Komponentenansicht zeigt alle im Projekt definierten Komponenten der obersten Ebene an. Sie können eine Komponente bearbeiten, indem Sie auf den Komponentennamen doppelklicken.

Folgende Komponententypen werden in dieser Ansicht angezeigt:

♦ Parser

♦ Serializer

♦ Mapper

♦ Transformer

Option Beschreibung

Neu Erstellt eine neue Skript- (*.tgp) oder Schemadatei (*.xsd).

Öffnen Öffnet das ausgewählte Projekt oder die ausgewählte Datei. - Wenn Sie ein Projekt öffnen, können Sie die Dateien darin bearbeiten. - Wenn Sie eine Datei öffnen, wird diese in einem Editor angezeigt (dasselbe passiert,

wenn Sie auf die Datei doppelklicken).

Umbenennen Benennt die ausgewählte Skriptdatei um.

Datei hinzufügen Fügt dem Projekt eine vorhandene Skript- oder Schemadatei hinzu. Die Datei wird in den Projektordner kopiert.

Löschen Entfernt das ausgewählte Projekt oder die ausgewählte Datei aus dem Workspace. Es besteht auch die Option, das Projekt oder die Datei von der Festplatte zu entfernen.

XSDs neu laden Lädt die XSD-Schemata neu. Wenn Sie ein Schema bearbeiten, sollten Sie es neu laden, damit sichergestellt ist, dass das Projekt mit der neuesten Schemaversion arbeitet.

Beispiel-XML erzeugen Generiert ein XML-Beispiel, das einem XSD-Schema entspricht. Das Beispiel bildet die XML-Struktur ab, die von dem Schema definiert wird.

Projekt schließen Schließt das Projekt sowie alle ihm zugeordneten Ansichten und Editoren. Sie können die Dateien des Projekts erst bearbeiten, wenn Sie es wieder öffnen.

20 Kapitel 4: Verwenden der Ansichten von Conversion Agent

♦ Variablen

♦ Alle weiteren Komponenten, die auf der obersten Ebene des IntelliScript definiert sind

Standardmäßig wird die Komponentenansicht zusammen mit der Ansicht des IntelliScript-Assistenten in der unteren linken Ecke der Workbench gestapelt.

MenüWenn Sie in der Komponentenansicht einen Rechtsklick ausführen, erscheint ein Menü mit folgenden Optionen:

Ansicht IntelliScript-AssistentDie Ansicht des IntelliScript-Assistenten stellt die speziellen IntelliScript-Optionen in einem Dialogfeldformat dar. Diese Ansicht ist am besten für neue Conversion Agent-Benutzer geeignet, die noch nicht mit dem IntelliScript vertraut sind.

Wenn Sie z. B. in einem IntelliScript-Editor einen Content-Anker wählen, zeigt der IntelliScript-Assistent die wichtigsten Eigenschaften des Ankers an.

Der IntelliScript-Assistent ist nur für einige Conversion Agent-Komponenten aktiv, wie z. B. Content, Marker und RepeatingGroup-Anker. Bei anderen Komponenten bleibt die Ansicht leer.

Standardmäßig wird die Ansicht des IntelliScript-Assistenten zusammen mit der Komponentenansicht in der unteren linken Ecke der Workbench gestapelt.

SymbolleisteDie Symbolleiste des IntelliScript-Assistenten stellt folgende Schaltflächen zur Verfügung:

Option Beschreibung

Löschen Löscht die ausgewählte Komponente.

Umbenennen Benennt die ausgewählte Komponente um.

Gehe zu Hebt die ausgewählte Komponente im IntelliScript-Editor hervor.

Als Startkomponente festlegen Wählt die Komponente aus, die aktiviert werden soll, wenn das Projekt ausgeführt wird.

Button Beschreibung

Fokus zur nächsten Komponente wechseln

Wählt den nächsten Marker-, Content- oder RepeatingGroup-Anker des IntelliScripts aus.

Fokus zur vorherigen Komponente wechseln

Wählen den letzten Marker-, Content- oder RepeatingGroup-Anker des IntelliScripts aus.

Die fokussierte Komponente aufreißen Wechselt zu einer verschachtelten Ebene des IntelliScript-Baums und wählt die erste Komponente, die Sie in der Ansicht bearbeiten können. Wenn momentan z. B. eine Parser-Komponente ausgewählt ist, wird über die Schaltfläche die Auswahl zu einem Anker, der im Parser geschachtelt ist, gewechselt.

Die fokussierte Komponente komprimieren

Wechselt zur obersten Ebene des IntelliScript-Baums.

Fokussierte Komponente entfernen Löscht die aktuell ausgewählte Komponente aus dem IntelliScript.

Änderungen in IntelliScript übernehmen Übernimmt die Änderungen, die Sie im IntelliScript-Assistenten vorgenommen haben, in das IntelliScript. Wenn Sie vergessen, auf diese Schaltfläche zu klicken, werden Sie, sobald Sie eine andere Komponente auswählen möchten, von Conversion Agent aufgefordert, die Änderungen zu übernehmen.

Ansichtentypen 21

HilfeansichtDie Hilfeansicht zeigt die kontextbezogene Online-Hilfe zu den Elementen an, die Sie in einem Editor auswählen. Wenn Sie z. B. einen Marker-Anker in einem IntelliScript-Editor auswählen, zeigt die Hilfeansicht das Hilfethema an, das den Marker-Anker beschreibt.

Sie können die Hilfeansicht anzeigen, indem Sie auf deren Registerkarte klicken oder die F1-Taste drücken, wenn Sie sich im Editor befinden.

Hinweis: Die Hilfeansicht zeigt nur die Themen an, die für den aktuellen Editor relevant sind. Um die gesamte Dokumentationsbibliothek von Conversion Agent anzuzeigen, verwenden Sie die Befehle im Hilfemenü.

Die Hilfeansicht wird standardmäßig mit verschiedenen anderen Ansichten im unteren rechten Bereich der Workbench gestapelt.

SymbolleisteIn der Symbolleiste der Hilfeansicht stehen folgende Schaltflächen zur Verfügung:

EreignisansichtDie Ereignisansicht zeigt die Ereignisse an, die beim Ausführen eines Projekts auftreten. Wenn Sie z. B. ein Parser-Projekt ausführen, zeigt die Ansicht für jeden Anker, den der Parser findet, ein Ereignis an.

Wenn Sie auf ein Ereignis doppelklicken, hebt Conversion Agent den Grund des Ereignisses im IntelliScript und im Beispielquelldokument hervor. Wenn Sie z. B. auf das Ereignis für einen Content-Anker doppelklicken, hebt Conversion Agent den Text hervor, der vom Anker abgerufen wurde. Wenn außerdem ein Serializer- oder Mapper-Projekt das Beispielquelldokument validiert, zeigt Studio Fehlermeldungen in der Ereignisansicht an.

Die Ereignisansicht wird standardmäßig mit verschiedenen anderen Ansichten im unteren rechten Bereich der Workbench gestapelt.

Weitere Informationen über Ereignisse finden Sie im Conversion Agent Studio Benutzerhandbuch.

Sie können die Ereignistypen, die in der Ereignisansicht angezeigt werden, sowie die Art und Weise, wie Fehler hervorgehoben werden, konfigurieren. Weitere Informationen hierzu finden Sie unter „Einstellungen in Conversion Agent Studio“ auf Seite 39.

Sie können ein Ereignisprotokoll, das zu einem anderen Conversion Agent-Projekt oder -Dienst gehört, öffnen, indem Sie die Datei *.cme in die Ereignisansicht ziehen. Weitere Informationen zu Ereignisprotokollen finden Sie im Conversion Agent Engine Entwicklerhandbuch.

MenüWenn Sie in der Ereignisansicht einen Rechtsklick ausführen, wird ein Menü mit folgenden Optionen angezeigt.

Button Beschreibung

Hilfe zurück Kehrt zum zuvor angezeigten Hilfethema zurück.

Option Beschreibung

Seite öffnen Öffnet das Quelldokument, von dem ein Ereignis ausgelöst wurde.

Suchen Sucht ein Ereignis, das den angegebenen Text enthält.

Nächstes suchen Sucht die nächste Stelle, an welcher der angegebene Text vorkommt.

Auto-Expandieren Expandiert den Ereignisbaum vollständig.


BinärquellenansichtDie Binärquellenansicht zeigt den Inhalt des Beispielbereichs in einer Hexadezimaldarstellung an. Wenn Sie Daten in dieser Ansicht auswählen, werden im Quellbereich die zugehörigen Daten ausgewählt und umgekehrt. Dies ist nützlich, wenn Sie z. B. Steuerzeichen wie Tabulatoren oder Zeilenumbrüche parsen müssen.

Die Binärquellenansicht wird standardmäßig mit verschiedenen anderen Ansichten im unteren rechten Bereich der Workbench gestapelt.

Schema-AnsichtDie Schema-Ansicht zeigt die XML-Elemente, XML-Attribute und Variablen an, die im Projekt definiert sind. Insgesamt werden die Elemente, Attribute und Variablen als Datenbehälter bezeichnet. Weitere Informationen über Datenbehälter finden Sie im Conversion Agent Studio Benutzerhandbuch.

Diese können Sie per Ziehen und Ablegen aus dem Beispielquelldokument in die Schemaansicht übernehmen, um die Content-Anker zu definieren.

Die Schema-Ansicht wird standardmäßig mit verschiedenen anderen Ansichten im unteren rechten Bereich der Workbench gestapelt.

Repository-AnsichtDie Repository-Ansicht listet die Conversion Agent-Dienste auf, die auf dem Rechner bereitgestellt worden sind. Weitere Informationen über das Bereitstellen von Diensten finden Sie im Conversion Agent Studio Benutzerhandbuch.

Die Repository-Ansicht wird standardmäßig mit verschiedenen anderen Ansichten im unteren rechten Bereich der Workbench gestapelt.

Projektereignisse neu laden Lädt die Ereignisse des aktuellen Projekts neu. Dieser Befehl ist nützlich, nachdem Sie ein weiteres Ereignisprotokoll geöffnet haben.

Horizontal teilen, Vertikal teilen Das Ereignisprotokoll wird in einen Navigations- und einen Ereignisbereich geteilt. Mit diesen Befehlen steuern Sie, ob das Fenster horizontal oder vertikal geteilt wird.

Abbildung 4-1. Binärquellenansicht

Abbildung 4-2. Schema-Ansicht

Option Beschreibung

Ansichtentypen 23

MenüWenn Sie in der Repository-Ansicht einen Rechtsklick ausführen, wird ein Menü mit folgenden Optionen angezeigt.

ProblemansichtDie Problemansicht wird angezeigt, wenn Conversion Agent Fehler in der Projektkonfiguration festgestellt hat. In der Ansicht können beispielsweise XSD-Syntaxfehler angezeigt werden. Sie können auf einen Fehler doppelklicken, um den Fehler im Editor zu finden.

Die Problemansicht wird standardmäßig mit verschiedenen anderen Ansichten im unteren rechten Bereich der Workbench gestapelt.

Option Beschreibung

Löschen Entfernt den Dienst aus dem Repository, so dass er nicht mehr verfügbar ist.

Eigenschaften Zeigt die Eigenschaften des Diensts an.

Aktualisieren Lädt die Darstellung des Diensts neu.


K A P I T E L 5

Verwenden des IntelliScript-Editors


♦ Über IntelliScript, 25

♦ Öffnen eines IntelliScript-Editors, 26

♦ Komponenten und Eigenschaften, 29

♦ Bearbeitungsverfahren, 30

♦ Menüs des IntelliScript-Editors, 35

♦ Anpassen der Komponentenliste, 36

Über IntelliScriptDas IntelliScript ist das wichtigste Werkzeug, mit dem Sie eine Umwandlung konfigurieren.

Das IntelliScript verfügt über eine Baumstruktur. Die oberste, globale Ebene des Baums zeigt die ausführbaren Umwandlungskomponenten wie Parser, Serializer und Mapper an. Diese Komponenten werden als ausführbar bezeichnet, weil sie als Startkomponenten des Projekts festgelegt werden können.

Sie können auch nicht ausführbare Komponenten wie Variablen oder Aktionen auf der globalen Ebene definieren. Dadurch können Sie die Komponenten an anderen Speicherorten im Projekt verwenden.

Auf den geschachtelten Ebenen des IntelliScripts können Sie Komponenten wie Anker und Aktionen definieren. Sie können auf die Symbole + oder - klicken, um den IntelliScript-Baum zu erweitern und die geschachtelten Ebenen anzuzeigen.

In den folgenden Abschnitten werden einige grundlegenden Anweisungen für das Bearbeiten des IntelliScripts gegeben. Weitere Informationen finden Sie unter Erste Schritte mit Conversion Agent.

Erstellen oder Hinzufügen von TGP-SkriptdateienDas IntelliScript wird in TGP-Scriptdateien definiert. Die meisten Projekte verfügen standardmäßig über eine einzige Skriptdatei. Sie haben die Möglichkeit, zusätzliche Skriptdateien einzufügen. Dies kann Ihnen dabei helfen, ein Projekt zu organisieren, indem Sie z. B. verschiedene Typen von Komponenten in verschiedenen Dateien definieren. Sie können mehrere Skriptdateien gleichzeitig bearbeiten, indem Sie diese in verschiedenen IntelliScript-Editoren öffnen.

Die Komponenten, die Sie in den einzelnen Skriptdateien definieren, sind im gesamten Projekt verfügbar. Beispielsweise kann ein Parser, der in einer Skriptdatei definiert ist, einen zweiten Parser aufrufen, der in demselben Projekt in einer anderen Skriptdatei definiert ist.

25

So erstellen Sie eine Skriptdatei:

1. Klicken Sie im Conversion Agent Explorer mit der rechten Maustaste auf den Skripts-Knoten.

2. Klicken Sie auf „Neu > Skript“.

3. Optional geben Sie für die Datei einen Namen ein und überschreiben den Standardnamen.

So fügen Sie einem Projekt eine vorhandene Skriptdatei zu:

1. Klicken Sie im Conversion Agent Explorer mit der rechten Maustaste auf den Skripts-Knoten.

2. Klicken Sie auf die Schaltfläche „Datei hinzufügen“, und wählen Sie die Datei aus.

Conversion Agent kopiert die Datei in den Projektordner. Sie können die Kopie bearbeiten, ohne das Original zu ändern.

So benennen Sie eine bestehende Skriptdatei um:

1. Klicken Sie im Conversion Agent Explorer mit der rechten Maustaste auf die Datei, und wählen Sie „Umbenennen“ aus.

2. Geben Sie den neuen Namen ein.

Öffnen eines IntelliScript-EditorsDer IntelliScript-Editor zeigt den Inhalt einer TGP-Skriptdatei an. Um einen IntelliScript-Editor zu öffnen, klicken Sie doppelt auf die Skriptdatei in der Conversion Agent Explorer-Ansicht.

Sie können einen IntelliScript-Editor auch öffnen, indem Sie in der Komponentenansicht auf eine Komponente doppelklicken. Dadurch öffnen Sie die Skriptdatei, in der die Komponente definiert ist.

Layout des EditorsDer IntelliScript-Editor hat zwei Bereiche:

♦ Der linke Bereich ist der IntelliScript-Bereich, der das IntelliScript anzeigt. Hier definieren Sie die Umwandlungskomponenten.

♦ Der rechte Bereich ist der Beispielbereich, der das Beispielquelldokument einer Umwandlung anzeigt. In diesem Bereich können Sie eine Umwandlung anzeigen, konfigurieren oder testen.

Der Beispielbereich ist schreibgeschützt. Das Beispielquelldokument kann nicht in Conversion Agent Studio bearbeitet werden.

So zeigen Sie die beiden Bereiche an oder blenden diese aus:

Wählen Sie im Menü die Option „IntelliScript“, „Beispiel“ oder „Beide“ aus.

26 Kapitel 5: Verwenden des IntelliScript-Editors

Die entsprechenden Bereiche werden angezeigt.

Registerkarten des BeispielbereichsJe nach Dokumenttyp hat der Beispielbereich ein, zwei oder drei Registerkarten. Die Registerkarten zeigen die Beispielquelle in verschiedenen Modi an.

Microsoft Office-Dokumente anzeigenUm ein Microsoft-Office-Dokument im Browser-Fenster des Beispielbereichs anzuzeigen, müssen Sie alle anderen Instanzen der Office-Anwendung schließen. Wenn Sie z. B. versuchen, ein Microsoft Word-Quelldokument in Conversion Agent zu öffnen, während Sie Microsoft Word gleichzeitig auf Ihrem Rechner geöffnet haben, zeigt Conversion Agent eine Warnung an. Schließen Sie Word, und öffnen Sie das Quelldokument erneut in Conversion Agent, um das Problem zu lösen.

Im Browser-Fenster werden Microsoft Office-Dokumente in genau den Anzeigeeinstellungen angezeigt, die Sie in der Office-Anwendung vorgenommen haben. Wenn Sie z. B. Ihre Word-Version so eingestellt haben, dass ausgeblendeter Text und Formatierungszeichen angezeigt werden, wird das Dokument auch so im Browser-Fenster angezeigt.

Wenn Sie die Beispielquelle mit einem Dokumentprozessor konfigurieren, zeigt das Browser-Fenster das Originaldokument an und nicht das verarbeitete Dokument. Weitere Informationen zu Dokumentprozessoren finden Sie im Conversion Agent Studio Benutzerhandbuch.

Abbildung 5-1. IntelliScript-Editor

Tab Beschreibung

Registerkarte „Quelle“ (Source)

Hier wird der Text des Dokuments angezeigt.

Registerkarte „Baum“ (Tree)

Zeigt den Code eines HTML- oder XML-Quelldokuments in einer eingerückten Baumdarstellung an. Bei einem komplexen Dokument ist die Verwendung der Baumdarstellung eventuell einfacher als die Darstellung im Quellfenster.

Registerkarte „Browser“ (Browser-Fenster)

Zeigt ein Dokument in einem Fenster des Internet Explorer an. Dieses Fenster (Registerkarte) ist nützlich, um z. B. die formatierte Ansicht eines HTML-, PDF- oder Microsoft Office-Dokuments zu betrachten.Wenn das Fenster das Dokument nicht anzeigen kann, überprüfen Sie, ob das richtige Plug-In für den Internet Explorer installiert und richtig konfiguriert ist. Um z. B. ein PDF-Dokument anzuzeigen, muss das Plug-In für den Adobe Reader installiert sein.

Öffnen eines IntelliScript-Editors 27

BeispieleDie folgenden Abbildungen zeigen in allen drei Fenstern des Beispielbereichs denselben Abschnitt eines Microsoft-Word-Dokuments, das mit dem WordToHtml-Dokumentprozessor konfiguriert worden ist.

Finden von AnkernWenn Sie einen Parser bearbeiten, lassen sich die entsprechenden Anker im IntelliScript- und Beispiel-Bereich leicht finden.

♦ Klicken Sie mit der rechten Maustaste auf einen Anker im IntelliScript, und wählen Sie „Markierung anzeigen“ aus. Mit diesem Befehl finden Sie den Anker im Beispielbereich.

♦ Klicken Sie auf einen Anker im Beispielbereich. Dieser Anker wird automatisch im IntelliScript ausgewählt.

Abbildung 5-2. Registerkarte „Quelle“ (Source)

Abbildung 5-3. Registerkarte „Baum“ (Tree)

Abbildung 5-4. Registerkarte „Browser“ (Browser-Fenster)


Komponenten und EigenschaftenDas IntelliScript enthält zwei Arten von Elementen:

♦ Komponenten. Elemente, die Sie in den IntelliScript-Baum einfügen bzw. aus ihm löschen können. Beispiele für Komponenten sind Parser, Serializer, Anker, Aktionen und Transformer.

♦ Eigenschaften. Elemente, die Sie zwar bearbeiten, jedoch nicht einfügen oder löschen können (außer durch Einfügen bzw. Löschen einer Komponente, die diese Elemente enthält). Beispiele für Eigenschaften sind die Eigenschaft example_source eines Parsers oder die Eigenschaft search eines Marker-Ankers.

Die Namen der Komponenten und Eigenschaften werden im IntelliScript-Editor in unterschiedlichen Farben angezeigt.

Grundeigenschaften und erweiterte EigenschaftenZum Vereinfachen der Anzeige werden die Eigenschaften im IntelliScript in zwei Kategorien verwaltet:

♦ Grundeigenschaften. Eigenschaften, die in den meisten Verwendungen der Komponente wichtig sind. In der Regel müssen Sie diese Eigenschaften zuweisen, um die Komponente zu verwenden.

♦ Erweiterte Eigenschaften. Eigenschaften, die Sie häufig nicht zuweisen müssen. Diese Eigenschaften haben eventuell Standardwerte, die Sie in der Regel nicht ändern müssen, oder die Eigenschaften implementieren Optionen, die Sie meist nicht verwenden müssen.

Das IntelliScript zeigt die Grundeigenschaften immer an. Es blendet die erweiterten Eigenschaften solange aus, bis sie diese gezielt anzeigen.

Die Unterscheidung erfolgt nur aus Anzeigegründen. Erweiterte Eigenschaften lassen sich genauso einfach verwenden wie Grundeigenschaften. Zögern Sie nicht, erweiterte Eigenschaften zu verwenden, wenn Sie diese in Ihren Projekten benötigen.

So zeigen Sie die erweiterten Eigenschaften einer Komponente an:

Klicken Sie auf das Symbol >> rechts vom Komponentennamen.

Das Symbol >> wird in << geändert, und die erweiterten Eigenschaften werden angezeigt.

Abbildung 5-5. Namen in Blau sind Komponenten, Namen in Dunkelrot sind Eigenschaften

Öffnen eines IntelliScript-Editors 29

So blenden Sie die erweiterten Eigenschaften aus:

1. Klicken Sie auf das Symbol << rechts vom Komponentennamen.

Das Symbol << wird in >> geändert, und die erweiterten Eigenschaften werden ausgeblendet. Wenn Sie einer erweiterten Eigenschaft aber einen Nicht-Standard-Wert zugewiesen haben, wird diese weiterhin angezeigt.

BearbeitungsverfahrenUm das IntelliScript zu bearbeiten, folgen Sie den in diesem Abschnitt beschriebenen Verfahren.

Basisprozedur für das Bearbeiten: Auswahl-Eingabe-Zuordnen-Eingabe

So bearbeiten Sie das IntelliScript:

1. Klicken Sie mit der Maus, um die Komponente oder Eigenschaft auszuwählen, dies Sie bearbeiten möchten.

2. Drücken Sie die Eingabetaste, um in den Bearbeitungsmodus zu wechseln. An den meisten Stellen können Sie auch doppelklicken, statt die Eingabetaste zu drücken.

3. Weisen Sie den Komponentennamen oder den Eigenschaftenwert zu.

4. Drücken Sie nochmals die Eingabetaste, um die Bearbeitungsvorgang abzuschließen.

Mit diesem einfachen Verfahren können Sie jede Zeile des IntelliScripts bearbeiten. Das Verfahren wird in folgenden Abbildungen veranschaulicht.

Abbildung 5-6. IntelliScript mit eingeblendeten Grundeigenschaften

Abbildung 5-7. IntelliScript mit eingeblendeten Grund- und erweiterten Eigenschaften

Abbildung 5-8. Wählen Sie die Stelle aus, die Sie bearbeiten möchten.

Abbildung 5-9. Drücken Sie die Eingabetaste.


Kopieren und EinfügenIm IntelliScript können Sie Komponenten kopieren und einfügen.

Um mehrere Komponenten gleichzeitig zu kopieren, halten Sie die Strg- oder Umschalttaste gedrückt, während Sie die Komponenten mit der Maus auswählen. Die Komponenten müssen sich alle auf derselben Verschachtelungsebene im IntelliScript befinden.

Sie können Komponenten nur an Stellen einfügen, an denen dies sinnvoll ist. Beispielsweise können Sie Serialisierungsanker unter einem Serializer, jedoch nicht unter einem Parser einfügen.

Drag&DropSie können per Drag&Drop Komponenten von einer Stelle an eine andere verschieben. Sie können diese Methode z. B. verwenden, um die Reihenfolge der Anker innerhalb eines Parsers zu ändern.

Um mehrere Komponenten gleichzeitig zu verschieben, halten Sie die Strg- oder Umschalttaste gedrückt, während Sie die Komponenten mit der Maus auswählen. Lassen Sie die Strg- oder Umschalttaste los und ziehen Sie dann mit der Maus.

Um die ausgewählten Komponenten zu kopieren (statt sie zu verschieben), halten Sie beim Ziehen die Umschalttaste gedrückt.

Suchen und ErsetzenUm Text im IntelliScript zu suchen oder zu ersetzen, wählen Sie im Menü den Befehl „Bearbeiten > Suchen/Ersetzen“ aus.

Einfügen von Komponenten in das IntelliScriptUnter zahlreichen Komponenten zeigt das IntelliScript eine horizontale Linie an. Diese enthält meist eine Beschriftung wie contains. Der Linie sind ein Pfeil und drei Punkte nachgestellt (...). Sie können geschachtelte Komponenten an den drei Punkten einfügen.

Abbildung 5-10. Weisen Sie den Wert zu.

Abbildung 5-11. Drücken Sie die Eingabetaste erneut.

Abbildung 5-12. Geschachtelte Komponenten an den drei Punkten einfügen

Bearbeitungsverfahren 31

So fügen Sie eine Komponente ein:

1. Markieren Sie die drei Punkte, und drücken Sie die Eingabe-taste.

Es wird eine Liste mit den Komponenten angezeigt, die Sie an dieser Stelle einfügen können.

2. Wählen Sie in der Liste eine Komponente aus.

Alternativ können Sie die ersten Buchstaben des Komponentennamens eingeben. Der Name wird dann automatisch vervollständigt.

3. Drücken Sie nochmals die Eingabetaste, um das Einfügen abzuschließen.

So löschen Sie eine Komponente:

Wählen Sie die Komponente aus, und drücken Sie die Entf-Taste.

Bearbeiten der Eigenschaften einer KomponenteSo weisen Sie eine Eigenschaft zu:

1. Wählen Sie den Wert der Eigenschaft aus, und drücken Sie die Eingabetaste.

Je nach Art der Eigenschaft wird ein Textfeld, eine Liste oder ein Dialogfenster angezeigt.

2. Geben Sie den gewünschten Eigenschaftenwert ein bzw. wählen Sie diesen aus.

3. Drücken Sie nochmals die Eingabetaste, um die Zuweisung abzuschließen.

Einfügen von Tabulatoren, Zeilenumbrüchen und anderen Sonderzeichen

Wenn Sie eine Texteigenschaft zuweisen, können Sie Sonderzeichen einfügen, indem Sie die entsprechenden numerischen ASCII-Codes eingeben.

So fügen Sie Sonderzeichen ein:

1. Wählen Sie eine Eigenschaft aus, und drücken Sie die Eingabetaste, um mit dem Bearbeiten zu beginnen.

2. Drücken Sie Strg+a.

Es wird ein kleiner Punkt angezeigt, der kennzeichnet, dass das Zeichen ein ASCII-Code ist.

3. Geben Sie den dreistelligen ASCII-Code ein. Sie können z. .B. Folgendes eingeben:

4. Um einen String aus ASCII-Codes einzugeben, wiederholen Sie die Schritte 2 und 3.

Sie können ASCII-Codes und normalen Text mischen.

ASCII-Code Zeichen

009 Tab

010 Lnefeed

013 Wagenrücklauf


5. Drücken Sie die Eingabetaste, um die Bearbeitung abzuschließen.

Das IntelliScript zeigt einen Tabulator in Form des Symbols « an. Andere Zeichen werden mit ihrem entsprechenden ASCII-Zeichencode angezeigt.

Definieren einer globalen KomponenteSie können Komponenten sowohl im globalen als auch im lokalen Bereich einsetzen.

Die meisten Komponenten von Conversion Agent können sowohl global als auch lokal eingesetzt werden.

Anker z. B. sind in der Regel lokal definiert. Sie können einen Anker aber auch als globale Komponente definieren, wenn Sie dieselbe Ankerkonfiguration in mehreren Parsern oder mehrmals in demselben Parser verwenden wollen. Sie können den als global definierten Anker an jeder gewünschten Stelle durch seinen Bezeichner referenzieren.

In folgender Abbildung wird ein Beispiel dargestellt. Ein Marker-Anker ist auf globaler Ebene definiert, und es ist ihm der Bezeichner MyMarker zugewiesen.

Ein Parser kann somit den Bezeichner MyMarker verwenden, anstatt jedes Mal, wenn der Marker-Anker benötigt wird, die Konfiguration des Marker-Ankers zu wiederholen. Sie können entweder MyMarker an der entsprechenden Stelle im Parser aus der Dropdown-Liste auswählen oder MyMarker an diese Stelle ziehen.

Einschränkungen bei NamenDie Namen, die Sie den IntelliScript-Komponenten zuweisen, dürfen nur lateinische Buchstaben (A-Z, a-z), Ziffern (0-9) und Unterstriche (_) enthalten. Sie müssen mit einem Buchstaben beginnen und können bis zu 127 Zeichen lang sein.

Abbildung 5-13. Eingeben von ASCII-Codes

Abbildung 5-14. Resultierende IntelliScript-Anzeige

Bereich Beschreibung

Globaler Bereich Die Komponente ist auf der obersten Ebene des IntelliScripts definiert. Sie kann an jeder beliebigen Stelle des Projekts aufgerufen und verwendet werden.

Lokaler Bereich Die Komponente ist auf einer geschachtelten Ebene des IntelliScripts definiert. Sie kann nur an dieser bestimmten Stelle des Projekts aufgerufen und verwendet werden.

Abbildung 5-15. Globaler Marker-Anker

Abbildung 5-16. Global definierter Marker wird in einem Parser verwendet

Bearbeitungsverfahren 33

Hilfe zu einer Komponente anzeigenBeim Bearbeiten des IntelliScripts können Sie die Themen der Online-Hilfe anzeigen, die eine Komponente oder Eigenschaft beschreiben.

So zeigen Sie die Hilfe an:

1. Zeigen Sie die Hilfeansicht an.

2. Wählen Sie die Komponente oder Eigenschaft aus.

Die Hilfe zeigt automatisch die Stelle an, die das ausgewählte Element beschreibt.

IntelliScript-SymboleDas IntelliScript zeigt jeden Komponententypen mit einem charakteristischen Symbol an. Folgende Liste führt zu Referenzzwecken einen Teil der gebräuchlichsten Symbole auf, die im IntelliScript verwendet werden.

Geführter ModusDie Funktion „Geführter Modus“ führt Sie durch den Prozess des Erstellens eines Ankers. Wenn der geführte Modus aktiv ist und Sie einen String im Beispielquelldokument als Anker definieren, werden die erforderlichen Eigenschaften sowie ein erklärender Tipp automatisch angezeigt.

Symbol Komponente

Parser

Serializer

Mapper

Transformer

Marker

ContentContentSerializer

Group

RepeatingGroup

StringSerializer

Handle

Schlüssel

Andere Anker

Aktionen

Standardsymbol, wenn kein bestimmtes Symbol für eine Komponente vorhanden ist


Durch wiederholtes Drücken der Eingabetaste durchlaufen Sie eine logische Folge von Feldern. Die Tipps auf dem Bildschirm erläutern die richtige Verwendung der jeweiligen Eigenschaft.

So aktivieren Sie den geführten Modus:

Klicken Sie im Menü auf den Befehl „IntelliScript > Geführter Modus“.

Speichern des IntelliScriptsWenn ein Sternchen (*) auf der Registerkarte des IntelliScript-Editors angezeigt wird, enthält der Editor ungespeicherte Änderungen. Wenn Sie den Editor schließen oder Studio beenden möchten, aber noch nicht gespeicherte Änderungen vorhanden sind, werden Sie aufgefordert, die Änderungen zu speichern.

Menüs des IntelliScript-EditorsKlicken Sie im IntelliScript-Editor mit der rechten Maustaste, um ein Menü anzuzeigen. Die Menüoptionen hängen von dem Kontext ab, in dem Sie geklickt haben.

Tabelle 5-1. Menü des IntelliScript-Bereichs

Option Beschreibung

Markierung anzeigen Hebt den ausgewählten Anker in der Beispielquelle hervor.

Als Einrichtungskomponente festlegen

Legt die ausgewählte Komponente als Startkomponente des Projekts fest.

Ausschneiden, Kopieren, Einfügen, Löschen

Hiermit können Sie Komponenten im IntelliScript kopieren, einfügen oder löschen.

Optional machen, Obligatorisch machen

Wählt die optional-Eigenschaft einer Komponente aus oder hebt die Auswahl der Eigenschaft auf. Wenn eine Komponente optional ist, schlägt die Elternkomponente bei einem Scheitern der Komponente nicht fehl. Weitere Informationen finden Sie im Conversion Agent Studio Benutzerhandbuch.

Aktivieren, Deaktivieren Aktiviert oder deaktiviert die Eigenschaft deaktiviert einer Komponente. Eine deaktivierte Komponente wird ignoriert. Diese Funktion ist hilfreich, um eine Komponente temporär zum Testen und zur Fehlerbehebung zu deaktivieren.

Skript-Modus, Intelli-Modus Der Intelli-Modus zeigt das IntelliScript in einer lesbaren grafischen Darstellung an. Das ist der Modus, der in diesem Handbuch sowie in der weiteren Conversion Agent-Dokumentation dargestellt ist.Der Script-Modus zeigt den Rohinhalt der *.tgp-Datei an. Dieser Modus ist ausschließlich für eine erweiterte Fehlerbehebung vorgesehen.

Beispielquelle öffnen Öffnet die Beispielquelldatei des ausgewählten Parsers, Serializers oder Mappers.

Serializer erstellen Erstellt einen Serializer aus dem ausgewählten Parser. Der Serializer und der Parser führen inverse Umwandlungen durch.

Tabelle 5-2. Menü des Beispielbereichs

Option Beschreibung

Kopieren Kopiert einen String in die Zwischenablage.

Marker einfügen Definiert den ausgewählten Text als einen Marker-Anker. Der Anker wird im IntelliScript hinzugefügt.

Content einfügen Definiert den ausgewählten Text als einen Content-Anker. Der Anker wird im IntelliScript hinzugefügt.

Abstandsgestützten Inhalt einfügen

Definiert die ausgewählte Position als einen Content-Anker. Der Anker wird im IntelliScript hinzugefügt.

Menüs des IntelliScript-Editors 35

Anpassen der KomponentenlisteSie können der Liste, die im IntelliScript-Editor angezeigt wird, angepasste Komponenten hinzufügen. Sie können sowohl die Komponentenliste eines einzelnen Projekts anpassen als auch die globale Komponentenliste, die in allen Projekten angezeigt wird.

Sie können dies mit einer von Ihnen entwickelten externen Komponente tun, wie beispielsweise einem Dokumentprozessor oder einer Aktion. Wenn Sie die externe Komponente regelmäßig verwenden möchten, kann dies einfacher sein, als die Komponente an jeder Stelle erneut zu konfigurieren.

Weitere Informationen hierzu finden Sie unter „Externe Komponenten“ im Conversion Agent Engine Entwicklerhandbuch.

So passen Sie die Komponentenliste in einem einzelnen Projekt an:

Definieren Sie eine globale Komponente.

Der Name der globalen Komponente wird der Komponentenliste hinzugefügt. Weitere Informationen hierzu finden Sie unter „Definieren einer globalen Komponente“ auf Seite 33.

So passen Sie die Komponentenliste in allen Projekten an:

1. Klicken Sie in einem Projekt den Skripts-Knoten im Conversion Agent Explorer mit der rechten Maustaste an, und klicken Sie dann auf „Neu > Skript“. Es wird eine neue TGP-Skriptdatei erstellt.

2. Doppelklicken Sie auf die neue Skriptdatei, um sie in einem IntelliScript-Editor zu öffnen.

3. Definieren Sie die Komponente, die Sie der Komponentenliste hinzufügen möchten, auf der globalen Ebene des IntelliScripts.

Konfigurieren Sie die Komponente. Wenn es sich bei der Komponente z. B. um einen ExternalPreProcessor handelt, konfigurieren Sie diesen so, dass die Vorverarbeitung mit einer bestimmten benutzerdefinierten DLL durchgeführt wird.

Weitere Informationen hierzu finden Sie unter „Definieren einer globalen Komponente“ auf Seite 33.

4. Speichern Sie die Skriptdatei.

5. Kopieren Sie die Datei in das Unterverzeichnis autoInclude\user des Installationsverzeichnisses von Conversion Agent.

6. Falls Conversion Agent Studio derzeit geöffnet ist, schließen Sie es, und öffnen Sie es dann erneut.

Conversion Agent Studio zeigt dann den Bezeichner in der Komponentenliste aller Projekte an.

RepeatingGroup einfügen

Definiert den ausgewählten Text als Trennzeichen eines RepeatingGroup-Ankers. Der Anker wird im IntelliScript hinzugefügt.

Instanz anzeigen Sucht im IntelliScript nach dem ausgewählten Anker .

Ereignis anzeigen Sucht in der Ereignisanzeige nach dem entsprechenden Ereignis.

Suchen Sucht einen String im Beispielquelldokument.

Logisches Codieren Wenn das Beispielquelldokument Text in einer Sprache mit Lesefolge von rechts nach links enthält, z. B. Hebräisch oder Arabisch, wechselt dieser Befehl die Anzeige von links-nach-rechts in rechts-nach-links.

Zeilenumbruch Bricht lange Zeilen um.

Quelle speichern unter Speichert das Beispielquelldokument an einem angegebenen Speicherort unter einem angegebenen Namen.

Tabelle 5-2. Menü des Beispielbereichs

Option Beschreibung


7. Kopieren Sie die Skriptdatei in den Ordner autoInclude\user auf jedem Rechner, auf dem Sie Conversion Agent Engine ausführen.

Dadurch wird die Komponente zur Laufzeit für Conversion Agent Engine verfügbar.

Anpassen der Komponentenliste 37

K A P I T E L 6

Einstellungen in Conversion Agent Studio


♦ Bearbeiten der Einstellungen, 39

♦ Einstellungen für den XML- und den XSD-Editor, 41

Bearbeiten der EinstellungenIm Einstellungsfenster können Sie Optionen einstellen, wie Conversion Agent Studio auf der Eclipse-Plattform arbeitet.

Diese Einstellungen betreffen nur das Verhalten von Conversion Agent Studio. Sie wirken sich nicht darauf aus, wie ein Projekt in Conversion Agent Engine ausgeführt wird.

Einige der Einstellungen steuern, wie Ereignisprotokolle generiert und angezeigt werden. Die Einstellungen gelten nur für Protokolle, die generiert oder angezeigt werden in

Hinweis: Dieses Kapitel beschreibt die Einstellungen, die für Conversion Agent Studio spezifisch sind. Weitere Informationen zu anderen Eclipse-Einstellungen finden Sie in der Online-Hilfe von Eclipse.

So bearbeiten Sie die Einstellungen von Conversion Agent Studio:

1. Wählen Sie im Menü den Befehl „Fenster > Einstellungen“ aus.

2. Wählen Sie auf der linken Seite des Einstellungsfensters die Einstellungskategorie aus:

♦ Conversion Agent. Allgemeine Einstellungen für die Arbeit mit Studio

♦ Ereignisse in Conversion Agent/Conversion Agent Einstellungen für die Anzeige von Ereignisprotokollen in der Ereignisansicht

♦ Bibliotheken (Branchennormen) Installiert, aktualisiert oder deinstalliert Umwandlungsbibliotheken, die mit Branchenstandards verwendet werden können, z. B. EDI Weitere Informationen finden Sie in Conversion Agent-Bibliotheken.

39

3. Legen Sie auf der rechten Seite die Optionen für die einzelnen Einstellungen fest.

Hinweis: Die Ereigniseinstellungen wirken sich nur auf die Anzeige von Ereignisprotokollen aus. Sie haben keine Auswirkungen auf den Inhalt der Protokolldatei. Weitere Informationen zu Protokolloptionen finden Sie im Conversion Agent Studio Benutzerhandbuch.

Tabelle 6-1. Einstellungen in der Kategorie Conversion Agent

Einstellung Beschreibung

Protokollieren Wenn diese Option ausgewählt ist, erfasst Conversion Agent Studio jeden seiner Vorgänge in einer Protokolldatei. Das Protokoll wird von zur Problembehebung verwendet.

Dateiname des Protokolls Dies ist der Pfad der Protokolldatei.

Automatisch speichern Wenn diese Option ausgewählt ist, speichert Conversion Agent Studio in regelmäßigen Abständen eine Sicherungskopie Ihrer TGP-Skriptdateien, während Sie diese bearbeiten.Die Sicherungskopien werden im Projektordner gespeichert und erhalten die Dateierweiterung *.tgp.bak. Unter normalen Bedingungen löscht Conversion Agent Studio die Sicherungskopien, wenn Sie mit der Bearbeitung fertig sind. Wenn ein Systemfehler bei der Bearbeitung auftritt, bietet Conversion Agent Studio an, die *.tgp.bak-Dateien wiederherzustellen, wenn Sie das Projekt wieder öffnen.

Intervall für Speichern im Hintergrund (in Minuten)

Der zeitliche Abstand zwischen dem automatischen Speichern.

Fokussierte Instanz hervorheben

Wenn diese Option ausgewählt ist und Sie die Eigenschaften einer Komponente im IntelliScript auswählen, wird die gesamte Komponente hervorgehoben. In diesem Modus wird eine komplexe IntelliScript-Anzeige deutlicher dargestellt.

Geführter Modus In dieser Einstellung geben Sie an, ob der geführte Modus standardmäßig aktiviert wird, wenn Sie einen neuen IntelliScript-Editor öffnen.Das Ändern der Einstellung wirkt sich nicht auf einen bereits geöffneten IntelliScript-Editor aus. Um den geführten Modus in einem offenen Editor zu aktivieren oder deaktivieren, verwenden Sie die Schaltfläche auf der Symbolleiste oder den Befehl im IntelliScript-Menü. Weitere Informationen hierzu finden Sie unter „Geführter Modus“ auf Seite 34.

Tabelle 6-2. Einstellungen in der Kategorie Conversion Agent-Ereignisse

Einstellung Beschreibung

Filter Mit dieser Einstellung können Sie Benachrichtigungen zu Informationsereignissen, Warnungen und Fehlern ein- oder ausblenden.

Feld anzeigen Hiermit können Sie den Namen des Parsers, der URL oder den Pfad des Quelldokuments sowie die Uhrzeit anzeigen.

Typ anzeigen Hiermit können Sie den Stil der Ereignisanzeige festlegen. Die verfügbaren Stile sind:- Flach. Die Ereignisse werden in einer nicht eingerückten Liste angezeigt.- Baum. Die Ereignisse werden in einem Baum angezeigt.- Baum mit rekursiven Parsern als Geschwisterknoten. Wie beim Baum, außer dass die Iterationen von

rekursiven Parsern als Geschwisterknoten angezeigt werden.

Verteilen aller Ereignisse Ist diese Option aktiviert, verteilt die Ereignisansicht alle Ereignisse auf der obersten Ebene des Navigationsbaums. Dadurch können Sie sehen, welche Zweige des Baums Fehler oder Warnungen enthalten, noch bevor Sie den Baum expandieren. Beachten Sie, dass einige Ereignisse (z. B. schwerwiegende Fehler) standardmäßig verteilt werden.

Ausgewählte Ereignisse filtern, Ausgewählte Ereignisse verteilen

Ermöglicht Ihnen die Auswahl einzelner Ereignistypen, die gefiltert oder verteilt werden sollen.

40 Kapitel 6: Einstellungen in Conversion Agent Studio

Einstellungen für den XML- und den XSD-EditorSie können den Editor festlegen, den Eclipse beim beim Öffnen einer XML-Datei oder eines XSD-Schemas vom Conversion Agent Explorer aus anzeigt.

So wählen Sie den XML-Editor aus:


2. Wählen Sie im linken Bereich des Fensters „Einstellungen“ die Optionen „Allgemein > Editoren > Dateizuweisungen“ aus.

3. Wählen Sie oben rechts den Dateityp *.xml aus.

Falls er nicht angezeigt wird, klicken Sie auf „Hinzufügen“ und geben den Dateityp *.xml ein.

4. Wählen Sie im unteren rechten Bereich den gewünschten Editor aus oder fügen Sie den gewünschten Editor hinzu.

Zur Anzeige von XML-Dateien in Microsoft Internet Explorer klicken Sie beispielsweise auf die Schaltfläche „Hinzufügen“ und navigieren zuc:\Program Files\Internet Explorer\IEXPLORE.EXE.

5. Klicken Sie auf die Schaltfläche „Standard“, damit der ausgewählte Editor zum Standard-XML-Editor wird.

6. Schließen Sie Studio, und öffnen Sie es erneut.

So wählen Sie den XSD-Editor aus:


2. Wählen Sie im linken Bereich des Fensters „Einstellungen“ die Optionen „Allgemein > Editoren > Dateizuweisungen“ aus.

3. Wählen Sie oben rechts den Dateityp *.xsd aus.

4. Wählen Sie im unteren rechten Bereich den gewünschten Editor aus.

Wenn ein externer XSD-Editor verwendet werden soll, klicken Sie auf die Schaltfläche „Hinzufügen“ und navigieren zu der Programmdatei.

5. Klicken Sie auf die Schaltfläche „Standard“, damit der ausgewählte Editor zum Standard-XSD-Editor wird.

6. Schließen Sie Studio, und öffnen Sie es erneut.

Einstellungen für den XML- und den XSD-Editor 41

42 Kapitel 6: Einstellungen in Conversion Agent Studio

S T I C H W O R T V E R Z E I C H N I S

AAnsicht

Ereignisse 22Ansichten

Arbeiten mit 19Binär 23Eclipse 3Explorer 20Hilfe 22IntelliScript-Assistent 21Komponente 20Probleme 24Repository 23Schema 23

AssistentenNeues Projekt 11

AusführenMenü 7

BBearbeiten

Menü 7Bezeichner

IntelliScript 33Bibliotheken

Einstellungen 39Binärquelle

Ansicht 23

DDatei

Menü 6Dateien

Projekt 14Dateinamen

Einschränkungen 15Dienste

bereitstellen 17Dokumentationen

Online 22Dropdown-Liste

Anpassen von Komponenten 36

EEclipse-Plattform

Ansichten 3Editoren 3Perspektiven 2Projekte 2Überblick 1Workbench 2, 5

EditorenEclipse 3IntelliScript 25

Eigenschaft „optional“Auswahl im Menü 35

Eigenschaft disabledAuswahl im Menü 35

Eigenschaftenim IntelliScript 29

EinstellungenStudio 39

EreignisseAnsicht 22Einstellungen für die Anzeige 39

ExplorerAnsicht 20

FFenster

Menü 8

GGeführter Modus

Standardmäßig aktivieren 40geführter Modus 35globale Komponenten

Anpassen der Dropdown-Liste 36

HHilfe

Ansicht 22Eclipse anzeigen 8Menü 8Über IntelliScript 22

43

IIntelliScript

Anpassen der Dropdown-Liste 36bearbeiten 30Einschränkungen bei Namen 33Menü 8verwendete Symbole 34

IntelliScript-AssistentAnsicht 21

IntelliScript-Editor 25geführter Modus 35Komponenten und Eigenschaften 29

Internet ExplorerXML anzeigen in 41

KKomponente

Ansicht 20Komponenten

Anpassen der Dropdown-Liste 36im IntelliScript 29

MMenü

Ausführen 7Bearbeiten 7Datei 6Eclipse 6Fenster 8Hilfe 8IntelliScript 8Navigieren 7Projekt 7Suchen 7

Microsoft-Office-DokumenteAnsicht im Quellbereich 27

NNamen

IntelliScript 33Projektdateien 15

NavigierenMenü 7

PPerspektive

öffnen 5Perspektiven

Eclipse 2Probleme

Ansicht 24Projekt

Menü 7Projekte

aktivieren 13anlegen 11

Ausführen 16außerhalb Workspace speichern 13bereitstellen 17Dateien 14Eclipse 2Löschen 12neu anlegen 6, 9Speicherort von 13vorhandene in Workspace importieren 15

Projekte importierenin Eclipse-Workspace 15

RRegisterkarte „Baum“ (Tree)

Beispielbereich 27Registerkarte „Browser“ (Browser-Fenster)

Beispielbereich 27Microsoft-Office-Dokumente 27

Registerkarte „Quelle“ (Source)Beispielbereich 27

RepositoryAnsicht 23

SSchema

Ansicht 23Schema-Editor

Einstellung festlegen 41Skriptdateien

erstellen oder hinzufügen 25mehrere 25Umbenennen 26

StudioEinstellungen 39Übersicht 1

SuchenMenü 7

SymboleIntelliScript 34

SymbolleistenWorkbench 9

TTastatur

Tastenkombinationen 10TGP-Dateien

erstellen oder hinzufügen 25

WWorkbench

Eclipse 2, 5Workspace

Eclipse 2Projekte außerhalb speichern 13Standardspeicherort 13verschieben 14

44 Stichwortverzeichnis

Workspace Speicherort von 13Workspaces

mehrere öffnen 14

XXML-Editor

Einstellung festlegen 41XSD-Editor

Einstellung festlegen 41

Stichwortverzeichnis 45

46 Stichwortverzeichnis

HINWEISE

Dieses Informatica-Produkt (die „Software“) umfasst bestimmte Treiber (die „DataDirect-Treiber“) von DataDirect Technologies, einem Betreiber von Progress Software Corporation („DataDirect“), die folgenden Bedingungen und Bestimmungen unterliegen:

1. DIE DATADIRECT-TREIBER WERDEN „WIE GESEHEN“ OHNE JEGLICHE GEWÄHRLEISTUNG, WEDER AUSDRÜCKLICH NOCH STILLSCHWEIGEND, BEREITGESTELLT, EINSCHLIESSLICH JEDOCH NICHT BESCHRÄNKT AUF DIE STILLSCHWEIGENDEN GEWÄHRLEISTUNGEN DER HANDELSÜBLICHKEIT, EIGNUNG FÜR EINEN BESTIMMTEN ZWECK UND DER NICHTVERLETZUNG VON RECHTEN DRITTER.

2. IN KEINEM FALL SIND DATADIRECT ODER SEINE DRITTANBIETER DEM ENDBENUTZER GEGENÜBER HAFTBAR FÜR UNMITTELBARE, MITTELBARE, ZUFÄLLIGE, SPEZIELLE, FOLGE- ODER ANDERE SCHÄDEN, DIE SICH AUS DER VERWENDUNG DER ODBC-TREIBER ERGEBEN, UNABHÄNGIG DAVON, OB SIE IM VORAUS ÜBER DIE MÖGLICHKEIT SOLCHER SCHÄDEN INFORMIERT WORDEN SIND ODER NICHT. DIESE BESCHRÄNKUNGEN GELTEN FÜR ALLE KLAGEGEGENSTÄNDE, EINSCHLIESSLICH, JEDOCH NICHT BESCHRÄNKT AUF VERTRAGSBRUCH, GEWÄHRLEISTUNGSBRUCH, FAHRLÄSSIGKEIT, KAUSALHAFTUNG, TÄUSCHUNG UND ANDERE UNERLAUBTE HANDLUNGEN.

conversion agent studio in eclipse verwenden · workbench-fensters. in der regel umfasst eine...

Documents