Mapping

1

Mittels dem „Formular-Mapping“ können Assistentenfeldern den Feldern eines [[PDF-Formulars|Main.05_Assistenten.03_NeuenAssistentenanlegen]] (nur um Entwurfsstatus), [[Webservices|Main.07_Einstellungen-Fachadministration.03_Module.06_Webservice]] und/oder eines [[speziellen XML-Schemas|Main.07_Einstellungen-Fachadministration.03_Module.13_XML-Schemata]] (auch im Freigabestatus) zugeordnet werden.

2

3

> {{icon name="far fa-info-circle" size="3"/}} ***Hinweis:***

4

> 1. Das Mapping der Felder bei einem Assistenten mit einem befüllten PDF-Formular ist nur notwendig, wenn die „[[Bezeichnung technisch|Main.05_Assistenten.04_Assistentenbauoberfläche.04_KonfigurationvonKomponenten]]“ der Komponenten nicht identisch, mit denen im PDF-Formular sind.

5

> 2. Die Komponente „Schaltfläche“ kann nicht gemappt werden.

6

7

## Neues Formular-Mapping erstellen

8

9

Grundsätzlich ist beim Anlegen eines neuen Assistenten noch kein Mapping vorhanden. Für die Zuweisung/Zuordnung steht zum einen in der „[[Hauptwerkzeugleiste|Main.05_Assistenten.01_Hauptwerkzeugleiste]]“ sowie in der „[[Panelwerkzeugleiste|Main.05_Assistenten.04_Assistentenbauoberfläche.01_PanelhinzufügenPanelwerkzeugleiste]]“ jeweils eine Schaltfläche für das „Formular-Mapping“ zur Verfügung. Über die Schaltfläche „Formular-Mapping“ in der Hauptwerkzeugleiste werden die Komponenten des kompletten Assistenten angezeigt. Wenn nur die Komponenten eines Panels angezeigt werden sollen, kann über die Schaltfläche „Formular-Mapping“ in der Panelwerkzeugleiste die entsprechende Ansicht geöffnet werden. Nach der Betätigung einer der Schaltflächen für das Mapping gelangt man in die Eingabemaske „Formular-Mapping-Oberfläche“.

10

11

![[Schaltflächen des Formular-Mapping|@MappingSchaltflächen.jpg]]

12

13

### Eingabemaske „Formular-Mapping-Oberfläche“

14

15

In der Eingabemaske „Formular-Mapping-Oberfläche“ kann die Zuweisung/Zuordnung der Komponenten im Assistenten auf die PDF-Formular-Felder/Webservicefelder/speziellen XML-Schema-Felder (siehe auch XML-Dokument mappen) vorgenommen werden. Standardmäßig sind in der linken Übersicht „Quellsystem“ die im Assistenten erstellten Komponenten sowie in der rechten Übersicht „Zielsystem“ die PDF-Formular-Felder/Webservicefelder/speziellen XML-Schema-Felder über eine Baumstruktur aufgeführt. Über die Pfeilicons können die unteren Ebenen der Struktur aufgeklappt werden.

16

17

> {{icon name="far fa-info-circle" size="3"/}} ***Hinweis:***

18

> Die oberen Ebenen können nicht gemappt werden, da diese z.B. Panels oder Objektgruppen darstellen.

19

20

Die entsprechenden zuzuweisenden Felder können über das Eingabefeld „Suche“ gesucht und dann mittels Drag und Drop den entsprechenden Feldern zugewiesen werden. Ein Mapping innerhalb des Quellsystems oder Zielsystems ist nicht möglich. Alle zugewiesenen Felder werden in der Feld-Mapping-Übersicht als einzelne Einträge in der unteren Feld-Mapping-Übersicht aufgeführt. Jedes einzelne Feld-Mapping kann hinsichtlich der Exportwerte und Trennzeichen in der Übersicht weiter angepasst sowie wieder gelöscht werden. Das Formular-Mapping wird erst gespeichert nach der Betätigung der Schaltfläche „Mapping speichern“. Über die Schaltfläche „Alle einklappen“ kann die ganze Baumstruktur, die über die Pfeilicons geöffnet wurde, in der jeweiligen Spalte zusammengeklappt werden.

21

22

![[Ansicht der Oberfläche für das Formular-Mapping|@MappingÜbersicht.jpg]]

23

24

> {{icon name="far fa-info-circle" size="3"/}} ***Hinweis:***

25

> Bei der Komponente „Staat“, die sich in der Komponentengruppe „Adresse“ befindet, haben Sie zwei verschiedene Möglichkeiten die Daten in das PDF-Formular eintragen zu lassen. Um beispielsweise das Land „Deutschland“ im PDF-Formular ausgeschrieben zu erhalten, muss das PDF-Formular-Feld der Komponente „Name_de“ zugewiesen werden. Soll ein Länderkürzel wie beispielsweise „DE“ im PDF-Formular-Feld eingetragen werden, muss das PDF-Formular-Feld der Komponente „Staat“ zugewiesen werden.

26

27

![[Richtige Zuweisung der Komponente Staat|@MappingStaat.jpg]]

28

29

- **Mapping anzeigen**

30

Über die Schaltfläche „Mapping anzeigen“ wird in der Spalte „Quellsystem“ und „Zielsystem“ die gemappten Felder angezeigt. Das heißt alle Ebenen werden dementsprechend geöffnet. So enthält beispielsweise das Zielsystem die Assistentenfelder und das Quellsystem die PDF-Formular-Felder, Webservicefelder oder speziellen XML-Schema-Felder.

- **Exportwerte**

Exportwerte sind Werte die im Assistenten in der [[Konfiguration der Komponente|Main.05_Assistenten.04_Assistentenbauoberfläche.04_KonfigurationvonKomponenten]] und im PDF-Formular festgelegt worden sind. Beispielsweise wurde in einer Dropdownkomponente im Assistenten die Exportwerte mit „Ja“ und „Nein“ festgelegt. Im PDF-Formular sind hingegen die Exportwerte „1“ und „2“ hinterlegt worden. Um zu definieren, welche Exportwerte zusammengehören, müssen diese entsprechend zugeordnet werden. Hierfür steht die Schaltfläche „Exportwerte bearbeiten“, die sich hinter jedem Eintrag in der „Feld-Mapping-Übersicht“ befindet, zur Verfügung. Mittels Drag und Drop können in der sich öffnenden Eingabemaske „Exportwerte bearbeiten“ die Exportwerte, die im Assistent definiert wurden, den Exportwerten vom PDF-Formular-Feld zugeordnet werden. In der linken Übersicht „Exportwerte Quellsystem“ befinden sich hierzu die Exportwerte der Komponente im Assistenten und in der rechten Übersicht „Exportwerte Zielsystem“ die Exportwerte des PDF-Formular-Felds. Über die Schaltfläche „OK“ wird die Zuordnung gespeichert.

35

36

> {{icon name="far fa-info-circle" size="3"/}} **_Hinweis:_**

37

> Nicht jede Komponente/jedes PDF-Formular-Feld enthält Exportwerte.

38

39

![[Ansicht der Exportwerte|@MappingExportwerte.jpg]]

- **Verknüpfen**

Sollen mehrere Komponenten im Assistenten auf ein PDF-Formular-Feld zugewiesen/zugeordnet werden, kann dies mittels einem Trennzeichen/Muster erfolgen. Hierzu steht die Schaltfläche „Verknüpfungen bearbeiten“ zur Verfügung. In der sich öffnenden Eingabemaske „Verknüpfungen festlegen“ können die eingetragenen Daten aus den Komponenten über eine Festlegung eines „Trennzeichens/Musters“ sichtbar getrennt werden. Hierzu kann ein „einmaliges Trennzeichen“ wie ein Komma (,), Absatz (/r) oder ein „spezielles Muster“ festgelegt werden. Bei der Definition eines speziellen Musters muss darauf geachtet werden, dass das Muster einem definierten Schema entspricht.

**Beispiel:**

{0} {1}, {2} {3}

Die Zahlen in den Curly Brackets ({}) stehen hierbei als Platzhalter für die Reihenfolge der Applikationsfelder. Die Reihenfolge der Applikationsfelder kann in der „Übersicht der Applikationsfelder“ in der „Verknüpfungen Festlegung“ mittels den nebenstehenden Schaltflächen geändert werden. Über die Schaltfläche „OK“ wird die Festlegung gespeichert.

49

50

![[Ansicht der Festlegung von Trennzeichen|@MappingTrennzeichen.jpg]]

51

52

53

- **Mapping entfernen**

54

Ein falsch hinterlegtes oder unnötiges Feld-Mapping kann jederzeit über die Schaltfläche „Mapping entfernen“, die sich hinter jedem Eintrag, in der „Feld-Mapping Übersicht“ befindet, Zeile für Zeile entfernt werden. Wird eine Komponente oder ein Panel im Assistenten gelöscht, wird automatisch das Feld-Mapping der Komponente/des Panels gelöscht.

55

56

57

- **Quellsystem und Zielsystem tauschen**

58

Über die Schaltfläche „Quellsystem<->Zielsystem“ können die Inhalte der Systeme geändert werden. So enthält beispielsweise das Zielsystem die Assistentenfelder und das Quellsystem die PDF-Formular-Felder, Webservicefelder oder speziellen XML-Schema-Felder.

59

60

> {{icon name="far fa-info-circle" size="3"/}} ***Hinweis:***

61

> Beim Ändern der Mappingrichtung gehen bisherige Feldzuordnungen verloren.

___

## XML-Dokument (Webserivce/spezielles XML) mappen

67

68

Für die Zuordnung der Assistentenfelder zu einem [[Webservice|Main.07_Einstellungen-Fachadministration.03_Module.06_Webservice]] und/oder einem [[speziellen XML-Schemas|Main.07_Einstellungen-Fachadministration.03_Module.13_XML-Schemata]] gibt es verschiedene Möglichkeiten.

69

70

- **Mapping im Entwurfsstatus**

71

Bereits im Entwurfsstatus eines Assistenten kann eine Zuordnung der Assistentenfelder zu einem Webservice bzw. zu einem speziellen XML-Schema vorgenommen werden. Hierzu steht in der Mappingoberfläche die Schaltfläche „Dokument öffnen“ im Zielsystem zur Verfügung. Hierüber steht eine Auswahlliste aller hinterlegter Webservices sowie XML-Schemas zur Verfügung. Nach der Auswahl des entsprechenden Eintrags und dem Betätigen der Schaltfläche „OK“ wird der Webservice/das XML-Schema mit seinen zu mappenden Feldern im Zielsystem angezeigt.

72

> {{icon name="far fa-info-circle" size="3"/}} ***Hinweis:***

73

> Wenn zuvor über die Schaltfläche „Quellsystem und Zielsystem vertauschen“ betätigt wurde, wird der/das ausgewählte Webservice/XML-Schema im Quellsystem angezeigt.

74

75

![[Schaltfläche XML-Dokument|@MappingXMLDokumentAuswahl.jpg]]

76

77

78

- **Mapping über die Webservicekomponente**

79

Mit der Hilfe einer „[[Webservice-Komponente|Main.05_Assistenten.04_Assistentenbauoberfläche.03_Bibliothek]]“ kann während dem Ausfüllprozess eine Webservice-Anfrage stattfinden. Beispielsweise wird bei der Eingabe eines Kennzeichens geprüft, ob das Kennzeichen und die Zulassungsbehörde zulässig sind. Hierzu muss eine „Webservice-Komponente“ in das Panel eingefügt und konfiguriert werden. In der „Komponenten Konfiguration“ muss hierzu dann der entsprechende Webservice ausgewählt werden. Nach der Auswahl des Webservice-Dienstes kann über die Schaltfläche „Webservice-Nachricht“ und „Webservice-Antwort“ jeweils die Formularinhaltsdaten gemappt werden. Die Felder des Webservices/XML-Schemas stehen dann sofort im Zielsystem in der Mappingoberfläche zur Verfügung.

80

> {{icon name="far fa-info-circle" size="3"/}} ***Hinweis:***

81

> Die Schaltflächen um die Formularinhaltsdaten zu mappen sind erst nutzbar, wenn zuvor der Webservice-Dienst ausgewählt und über die Schaltfläche „Übernehmen“ die Konfiguration gespeichert wurde.

82

83

![[Mapping bei einer Webservicekomponente|@MappingWebserviceKomponente.jpg]]

84

85

86

- **Mapping über die Veröffentlichung**

87

Um beim Einreichen/Übergeben eines Assistenten einen Webservice anzusprechen bzw. ein spezielles XML-Schema mit den eingereichten zu übergeben, muss in der „[[Veröffentlichung|Main.05_Assistenten.02_VeröffentlichungvonAssistenten]]“ des Assistenten der Webservicedienst bzw. das spezielle XML-Schema ausgewählt werden. Hierzu muss in der Veröffentlichung die „Webservice-Anfrage während Einreichung“ oder Einstellung „Spezielles XML“ auf „Ja“ eingestellt und die Konfigurationen ausgewählt werden. Nach der Auswahl des Webservice-Dienstes/XML-Schemas kann über die Schaltfläche „Webservice-Nachricht“ und „Webservice-Antwort“ bzw. „XML-Anfrage mappen“ (siehe auch [[Webservice Nutzung|Main.05_Assistenten.04_Assistentenbauoberfläche.06_Mapping]] oder [[Nutzung XML-Schema|Main.07_Einstellungen-Fachadministration.03_Module.13_XML-Schemata]]) jeweils die Formularinhaltsdaten gemappt werden. Die Felder des Webservices/XML-Schemas stehen dann sofort im Zielsystem in der Mappingoberfläche zur Verfügung.

88

89

![[Veröffentlichung mit Webservice|@MappingWebserviceNutzungVeröffentlichung.jpg]]

___

## Änderung der „Bezeichnung technisch“ einer Komponente/Panels

96

97

Wurde ein Feld-Mapping für eine Komponente erstellt, bei der sich im Nachhinein die „[[Bezeichnung technisch|Main.05_Assistenten.04_Assistentenbauoberfläche.04_KonfigurationvonKomponenten]]“ oder der Panelname ändert, passt sich der Feldmapping-Eintrag automatisch an. Trotzdem wird es angeraten zum Schluss noch einmal das Mapping zu überprüfen.

___

## Assistent anlegen mit einer neuen Version

102

103

Wird für einen bereits „freigegebenen Assistenten“ eine „[[neue Version|Main.05_Assistenten.05_Assistentenaktualisieren]]“ erstellt, wird das bestehende Mapping der vorhergehenden Version für die neue Version übernommen.

Wiki-Quellcode von Mapping

Navigation