Wikibati - Benutzerbeiträge [de]

Kontakte

2022-12-07T08:26:13Z

N.raebiger: /* Einzelbrief ausgeben */

== Kontakte ==
Über das Menü „Verwaltung->Kontakte“ oder den Eintrag „Kontake“ im Menü am rechten Bildrand gelangen Sie zur Adressverwaltung. Von hier aus können Sie Adressen suchen, bearbeiten, anlegen und löschen. Außerdem können über die Werkzeugleiste und das Kontextmenü weitere Funktionen ausgewählt werden, u.a. das Drucken der Adresse oder das Verfassen eines Briefes an die ausgewählte Person.

== Suchen und Finden von Kontakten ==
=== Suchbegriff ===
[[Datei:adresse suchen.png|mini|Suchbegriff eingeben]]
Geben Sie hier einen oder mehrere Suchbegriffe ein. Dabei kann es sich um den Namen, die Anrede oder einen Teil der Adresse der gesuchten Person handeln.
Bei der Eingabe mehrerer Begriffe sind einige Regeln zu beachten. Die folgenden Beispiele sollen diese verdeutlichen:

=== Beispiele für Suchbegriffe ===
'''müller''' ergibt eine Liste aller Einträge, die „Müller“ am Anfang einer Spalte enthalten.

'''müller, karl''' ergibt eine Liste aller Einträge, die den genauen Text „Müller, Paul“ am Anfang einer Spalte enthalten. Diese Schreibweise eignet sich am besten zur Suche nach Namen.

'''St. Afra''' oder '''von Stain''' – hier verhält es sich genau wie beim vorhergehenden Beispiel. Gesucht wird hier die gesamte Zeichenfolge. Dies erleichtert die Suche nach Namen beginnend mit „St.“ oder „von“.

'''" Dr. Gerbelstr."''' ergibt ebenfalls eine Liste aller Einträge, die den genauen Text „Dr. Gerbel“ am Anfang einer Spalte enthalten.

'''Müller +München''' ergibt jene Einträge, die Spalten beginnend mit „Müller“ UND Spalten beginnend mit „München“ beinhalten. So können Sie zum Beispiel nach einem Herrn oder einer Frau Müller suchen, die in München wohnen.

'''Müller -München''' ergibt jene Einträge, die Spalten beginnend mit „Müller“ UND Spalten nicht beginnend mit „München“ beinhalten. So können Sie zum Beispiel nach einem Herrn oder einer Frau Muster suchen, die nicht in München wohnen.

=== Joker ===
''' %holl ''' ergibt jene Einträge, die den Begriff „holl“ beinhalten
'''m_yer''' ergibt eine Liste aller Einträge, mit „Meyer“ oder „Mayer“

: '''<ins>Hinweis</ins>'''
:: Wird kein Eintrag gefunden, der den gesuchten Begriff am Anfang einer Spalte enthält, wird der Suche der Joker „%“ vorangestellt. Damit werden auch Einträge gefunden, die den Begriff lediglich enthalten. Sie können diesen Joker auch für Ihre Suche verwenden.

: '''<ins>Anmerkung</ins>'''
::Mit der Tastenkombination ALT+U gelangen Sie automatisch zurück in das Eingabefeld, wo Sie einen neuen Suchbegriff eingeben können.

=== Abfrage ===
[[Datei:adressenabfragen.png|mini|Adressen abfragen]]
[[Datei:filter.png|thumb|none|Filter]]
Über diese Symbol können Sie sich bestimmte Teilmengen oder auch alle Adressen anzeigen lassen.

=== Beispiel ===
Anzeige aller Adressen mit der Kategorie VSYX. Klicken Sie auf die Schaltfläche
[[Datei:Kontakte_abfrage.png|thumb|mini|Abfrage]]
[[Datei:filter.png|thumb|none|Filter]]
Markieren sie den Eintrag „Kategorien“ und klicken Sie auf Schaltfläche WEITER.
Klicken Sie auf die Schaltfläche mit den 3 Punkten
[[Datei:Kontakte_dreipunkte.png|thumb|none|]]
[[Datei:Kontakte beispiel.png|thumb|mini|Kategorien]]
Markieren Sie in der Liste den Eintrag VSYX und klicken Sie auf die Schaltfläche OK und dann auf WEITER.

== Anlegen einer Adresse ==
Möchten Sie einen neuen Eintrag in der Adress-Datenbank anlegen, so können Sie das auf eine der folgenden Arten tun:
[[Datei:Kontakte symbol.png|thumb|none|]]
• einen Klick auf das Symbol oben

• den Menüeintrag „Datensatz -> Neu“

• den Eintrag „Neu“ im Kontextmenü (erreichbar durch einen Klick mit der rechten Maustaste im Bereich der Tabelle)

• die Taste F3
In dem nun folgenden Dialog können Sie den neuen Eintrag bearbeiten.
: '''<ins>Hinweis</ins>''' [[Datei:Kontakte anlegen einer adresse.png|thumb|mini|Adresse anlegen]]
:: Möchten Sie mehrere Adressen anlegen, können Sie nach dem Eintragen der Daten mit F3 die Daten speichern und sofort eine neue Adresse bearbeiten ohne den Dialog schließen zu müssen.

=== Name ===
Müller, Max

Personen mit Familienname+Komma+Leerzeichen+Vorname
=== Variante ===
Müller, Max und Paula

oder aber auch

Name1: Müller, Max

Name2: und Paula Schneider

=== Institutionen ===
Include GmbH

oder aber auch

St. Jakob, Kindergarten
=== Titel ===
Akademische Titel wie Dr. oder Prof.
=== Namenszusatz ===
jun, sen., MDB, MDL, SDS
=== PLZ ===
Einfach Postleitzahl tippen. Das System findet den Ort.
=== BLZ ===
Einfach Bankleitzahl tippen. Das System findet die Bank.
=== E-Mail 1 ===
Eingabe der Kontaktmailadresse. Je nach Systemeinstellung wird die Adresse mit Outlook abgeglichen
=== Programme ===
Versandinformation, die auf z.B. Etiketten mit angedruckt werden kann.
=== Plakate ===
Versandinformation, die auf z.B. Etiketten mit angedruckt werden kann.
=== Versandsperre ===
Optionale Ausschlussmöglichkeit von Adressen beim Versand
=== Ausgabesperre ===
Adresse wird nicht mehr ausgegeben, weder bei Briefen, Listen etc.
=== Kategorien ===
[[Datei:Kontakte_kategoriiiien.png |thumb|mini|Kategorien]] Zuordnungsmöglichkeit von Kategorien. Klicken Sie auf [[Datei:Kontakte_kategorien.png|thumb|none|]]
Klicken Sie mit der Maus auf die gewünschte(n) Kategorie(n). Übernehmen sie die Auswahl mit der Schaltfläche OK.

== Löschen einer Adresse und Wiederherstellen aus Papierkorb ==
Positionieren Sie sich auf Ihrer eingeben Adresse. Drücken sie die ENTF-Taste. Bestätigen sie die Frage „Wirklich löschen“ mit JA.

Über das Menü „Papierkörbe  Adressen“ erhalten sie die gelöschten Adressen zur Ansicht.
Positionen Sie sich auf Ihrer gelöschten Adresse und dricke Sie die RECHTE MAUSTASTE. Wählen Sie den Menüpunkt „Wiederherstellen“

== Zusammenführen von Dubletten ==
Suchen Sie nach der Adresse von Maria Bauer. Das System findet 3 Adressen. Klicken (kein Doppelklick!) Sie mit der LINKEN MAUSTASTE auf die erste Adresse in der Liste. Drücken sie die Taste F11. Klicken Sie mit der LINKEN MAUSTASTE auf die zweite Adressen und drücken sie die Taste F11. Beantworten Sie die Frage mit „JA“.

== Ausgabe von Adressen ==

=== Zwischenablage ===
Klicken sie mit der LINKEN MAUSTASTE auf eine Adresse. Dann
LINKE MAUSTASTE und wählen Sie aus dem Kontextmenü den Eintrag „Adresse in Zwischenablage kopieren“
Starten sie Microsoft Winword und drücken Sie die Tastenkombination STRG+V
=== E-Mail ===
Klicken sie mit der LINKEN MAUSTASTE auf eine Adresse. Dann LINKE MAUSTASTE und wählen Sie aus dem Kontextmenü den Eintrag „E-Mail“. Alternativ können sie in der Symbolleiste unten auf das Mailsymbol klicken. [[Datei:Kontakte mailsymbol.png |thumb|none|]]

=== Einzelbrief ausgeben ===
Klicken sie mit der LINKEN MAUSTASTE auf eine Adresse. Dann RECHTE MAUSTASTE und wählen Sie aus dem Kontextmenü den Eintrag „Brief“. Alternativ können sie in der Symbolleiste unten auf das Wordsymbol klicken.
[[Datei:Kontakte_einzelbriefeöffnen.png |thumb|mini|Einzelbriefe]]
[[Datei:Kontakte_wordsymbol.png |thumb|none|]]
Klicken Sie auf die Vorlage „Einzelbrief“ und dann auf die Schaltfläche OK.

[[Datei:Kontakte_dokumentenvermerk.png |thumb|mini|Dokumentenvermerk]] Diesen Dokumentenvermerk können Sie in der Adresse unter der Schaltfläche „Korrespondenz“ später wieder einsehen.

=== Einzelbrief ändern bzw. Variante ===
‎[[Datei:Kontakte_einzelbriefeöffnen2.png |thumb|mini|Einzelbriefe öffnen]] Klicken sie mit der LINKEN MAUSTASTE auf eine Adresse. LINKE MAUSTASTE und wählen Sie aus dem Kontextmenü den Eintrag „Brief“. Alternativ können sie in der Symbolleiste unten auf das Wordsymbol klicken.
[[Datei:Kontakte_wordsymbol.png |thumb|none|]]
Klicken Sie auf die Vorlage „Einzelbrief“ dann die RECHTE MAUSTASTE und wählen den Menüpunkt „Öffnen“. Die Vorlage wird in Winword geöffnet. Speichern Sie die Datei unter einem anderen Namen z.B. Begleitschreiben Programmheft. Beenden sie Winword. Der Öffnen-Dialog hat nun eine weitere Vorlage zur Auswahl.
[[Datei:Kontakte_Einzelbriefe3.png |thumb|mini|Begleitschreiben Programmheft]]
=== Die Direktablage ===
Mit Hilfe der Direktablage können Sie aus dem Adressverzeichnis mehrere Adressen zur gemeinsamen Verwendung herausnehmen.
Um die Direktablage anzuzeigen, drücken Sie den Schaltfläche in der Symbolleiste.
[[Datei:Kontakte_kleineschaltfläche.png |thumb|none|]]
'''Eine Adresse zur Direktablage hinzufügen.'''

Um eine markierte Adresse der Direktablage hinzuzufügen, verwenden Sie die Tastenkombination STRG+D oder „Bearbeiten  Kopieren in Direktablage“ im Menü oder übertragen die Adresse aus der Namenszelle via Drag and Drop in die Direkablage.
'''Eine Adresse aus Direktablage entfernen'''
Sie können eine Adresse aus der Direktablage wieder entfernen, indem Sie

• ENTF drücken
[[Datei:Kontakte kreuz.png |thumb|none|]]
• das oben angezeigte Symbol drücken

• den Menüeintrag „Datensatz -> Löschen“ auswählen

• den Eintrag „Löschen“ im Kontextmenü auswählen
'''Speichern der Direktablage in eine Datei'''
Sie können den Inhalt der Direktablage zur späteren Verwendung in einer Datei abspeichern. Wählen Sie dazu „Speichern“ im Kontextmenü der Direktablage oder klicken sie folgendes Symbol.
[[Datei:Kontakte symbolspiechern.png |thumb|none|]]
Es erscheint ein „Speichern unter“ Dialog, wo Sie das Verzeichnis und den Dateinamen angeben.
'''Laden der Direktablage aus einer Datei'''
Um eine zuvor in einer Datei abgespeicherte Direktablage wieder zu laden, wählen Sie „Öffnen“ im Kontextmenü der Direktablage oder klicken sie folgendes Symbol.
[[Datei:Kontakte_symbolöffnen.png|thumb|none|]]
Es erscheint ein „Öffnen“ Dialog, wo sie die gewünschte Datei auswählen können. Bestätigen Sie mit „Öffnen“ und die Direktablage wird geladen.
=== Serienbrief ===
[[Datei:Kontakte_abfragekategorien.png|thumb|mini|Serienbrief]] Klicken Sie in der Symbolleiste auf die Schaltfläche [[Datei:Kontakte_symbolword.png|thumb|none|]]

'''TIPP'''
Wenn Sie die gewählte Serienbriefvorlage vor der Ausgabe bearbeiten wollen, klicken sie mit der LINKEN MAUSTASTE auf die Auswahl „Serienbrief.doc“, betätigen dann die RECHTE MAUSTASTE und wählen „Bearbeiten“
[[Datei:Kontakte_abfrage3333.png|thumb|mini|Abfrage]] Stellen Sie Ihr Formular auf die oben angezeigten Werte ein und klicken Sie auf die Schaltfläche WEITER.
Wählen Sie eine beliebige Kategorie oder übernehmen Sie den eingetragenen Wert und klicken wieder auf WEITER.
Sie erhalten eine Liste der selektierten Adressen. Klicken Sie auf FERTIGSTELLEN und das System verbindet die Daten mit der wählten Serienbriefvorlage.

=== Serienbrief anlegen ===
Über das Menü „Vorlagen -> Adressen -> Word Dokumente -> Briefe -> Serienbriefe können Vorlagen geändert oder neu angelegt werden. Am einfachsten ist es, eine bestehende Vorlage zu öffnen, in Winword unter einem anderen Namen zu speichern und die gewünschten Änderungen vorzunehmen.
[[Datei:Konakte_vorlagen.png|thumb|mini|Vorlagen]]
Öffnen Sie mit einem Doppelklick die Vorlage „Serienbrief.doc“ und speichern Sie Datei in Winword unter einem anderen Namen, z.B. Anschreiben Mailadresse.
Das Anschreiben soll noch zusätzlich die in Kiribati gespeicherte Mailadresse andrucken.
Setzten Sie den Cursor an die gewünschte Stelle und klicken Sie in der Seriendrucksymboleiste auf die folgende Schaltfläche. Wählen Sie aus der Liste das Feld ADR_EMAIL1 und klicken Sie auf EINFÜGEN.
Speichern Sie das Dokument und geben Sie den neuen Serienbrief in Kiribati aus. [[Datei:Kontakte_symbolblock.png|thumb|none|]]

=== Verzeichnis anlegen ===
'''Verzeichnisse sind schnell und einfach anzulegende Liste.'''
Über das Menü „Vorlagen -> Adressen -> Word Dokumente -> Verzeichnisse“.
Serienbriefe können Vorlagen geändert oder neu angelegt.
Am einfachsten ist es, eine bestehende Vorlage zu öffnen, in Winword unter einem anderen Namen zu speichern und die gewünschten Änderungen vorzunehmen.
‎[[Datei:Kontakte_vorlagenbeispieldoc.png |thumb|mini|Vorlagen]]
Klicken Sie in der Symbolleiste auf die folgende Schaltfläche, um ein neues Verzeichnis anzulegen.
[[Datei:Kontakte_symbolblatt.png ‎|thumb|none|]]
Die Ausgabe soll die Felder Name, Ort und E-Mail enthalten. Über die Menüpunkte „Tabelle -> Einfügen -> Tabelle „ man zunächst eine Tabelle mit 3 Spalten und einer Zeile
Setzten Sie den Cursor in die erste Zelle und klicken Sie in der Seriendrucksymbolleiste auf die folgende Schaltfläche.
[[Datei:Kontakte_symbolblock.png|thumb|none|]]
Wählen Sie aus der Liste das Feld ADR_NAME1 und klicken Sie auf EINFÜGEN.
Verfahren sie so auch mit den restlichen zwei Feldern und wählen die Felder ADR_ORT und ADR_EMAIL1.
Speichern Sie das Dokument und geben Sie das neue Verzeichnis in Kiribati aus. Die Ausgabe ist analog wie bei Serienbriefen, nur muss der Ordner „Verzeichnisse“ ausgewählt werden.

=== Serienmails ===
[[Datei:Kontakte_Abfragee-mail.png|thumb|mini|Abfrage1]] Klicken Sie in der Symbolleiste auf die folgende Schaltfläche.
[[Datei:Kontakte symbolword.png|thumb|none|]]
[[Datei:Kontakte_abfrage123.png|thumb|mini|Abfrage2]]Stellen Sie Ihr Formular auf die oben angezeigten Werte ein und klicken Sie auf die Schaltfläche WEITER.
Wählen Sie eine beliebige Kategorie oder übernehmen Sie den eingetragenen Wert und klicken wieder auf WEITER.
[[Datei:Kontakte e-mail.png|thumb|mini|E-mail]] Sie erhalten eine Liste der selektierten Adressen. Klicken Sie auf FERTIGSTELLEN und Sie erhalten 4 mögliche Mailvarianten.
=== Gruppenmail ===
Kiribati erstellt eine einzelne Gruppenmail. Die Mailadressen der anderen Empfänger sind für ALLE Empfänger sichtbar.
=== Gruppenmail BCC ===
Kiribati erstellt eine einzelne Gruppenmail. Die Mailadressen der anderen Empfänger sind für die anderen Empfänger nicht sichtbar.
=== Serienmail ===
Kiribati erstellt pro Adressaten eine einzelne E-Mail. Somit kann jede Nachricht mit der persönlichen Briefanrede erstellt werden.
[[Datei:Serienmail.png|thumb|mini|Serienmail]]
=== Einstellungen ===
Nur Text:
Der Editor lässt keine Formatierungen zu

Rich-Text::
Einfache Formatierungen, wie Fett, Schriftart, Farben sind möglich.

Briefanrede:
Option bestimmt, ob die Nachricht mit der persönlichen Briefanrede ergänzt wird.

Grußformel:
Option bestimmt, ob die Nachricht mit der in den Kiribati Benutzerdaten hinterlegten Grußformel ergänzt wird.

Signatur:
Option bestimmt, ob die Nachricht mit der in den Kiribati Benutzerdaten hinterlegten Signatur ergänzt wird.
[[Datei:Testmail_erstellen.png|thumb|none|]]
Mit dieser Schaltfläche können Sie an eine beliebige E-Mail Adresse die Nachricht zu Testzwecken schicken.
[[Datei:senden none.png|thumb|none|]]
Klicken Sie auf diese Schaltfläche, um die E-Mails in den Postausgang Ihres Mailclients zu stellen.
=== Word. Dokument ===
Die Mailadressen können mit einem Word.Seriendokument verknüpft und als E-Mail erstellt werden. [[Datei:Seriendruck_in_e-mail.png ‎|thumb|mini|Seriendruck in E-mail]]
Sobald Winword das Seriendokument anzeigt, klicken Sie in der Seriendrucksymboleiste auf folgende Schaltfläche
[[Datei:Klein_brief_word.png ‎|thumb|none|]]
Ergänzen sie die Betreffzeile und klicken auf OK. Winword stellt die Mails automatisch in den Postausgang Ihres Mailsystems.

Import Rückmeldungen Evangelische Termine

2019-10-31T15:14:34Z

N.raebiger: /* Felder für die Onlineanmeldung */

==Format==
Beispiel einer XML Rückmeldedatei
<?xml version="1.0" encoding="UTF-8"?>
<root>
<Export>
<Rueckmeldung>
<ldf_Nr Label="lfd. Nr.">1</ldf_Nr>
<datum Label="Rückmeldung vom">12.10.2018 12:38</datum>
<status Label="Status">weiß</status>
<erfassung Label="QR-Code erfasst">Nein</erfassung>
<info Label="Notizen" />
<Anrede Label="Anrede">Frau</Anrede>
<Titel Label="Titel">Testtitel</Titel>
<Name Label="Name">Muster</Name>
<Vorname Label="Vorname">Max</Vorname>
<Einrichtung Label="Einrichtung">AEEB</Einrichtung>
<Strasse Label="Strasse">Teststraße 1</Strasse>
<PLZ Label="PLZ">80000</PLZ>
<Ort Label="Ort">Testort</Ort>
<Telefon Label="Telefon">123456789</Telefon>
<EMail Label="EMail">muster.max@include.de</EMail>
<Bemerkung Label="Bemerkung">Mitglied</Bemerkung>
<Zahlungsart Label="Zahlungsart">Lastschrift</Zahlungsart>
<Kontoinhaber Label="Kontoinhaber">Muster Max</Kontoinhaber>
<Kreditinstitut Label="Kreditinstitut">Testbank</Kreditinstitut>
<Bankort Label="Bankort">München</Bankort>
<IBAN Label="IBAN">de123456789</IBAN>
</Rueckmeldung>
</Export>
</root>

==Import==
===Voraussetzungen===
====Zuordnung====
Einer Veranstaltung kann unter Internet->Rückmeldformular ein Formular zugeordnet werden.
Um eine Auswahl an Rückmeldeformularen anzubieten könnten diese in der INI Datei erfaßt werden.
[EVT]
Rueckmeldeformular1=376,Standard
Rueckmeldeformular2=377,EPK
====Mapping Datei====
‎[[Datei:evt_rueckmeldeformular.png|thumb|none|Rückmeldeformular]]
Im Ornder ...\daten\import\evtermine muss sich eine Textdatei beginnend mit dem Buchstaben R + Nummer des Rückmeldeformulars befinden. Beispiel R376.TXT

Inhalt der Datei ist ein Mapping zum Rückmeldeformular in Evang. Termine.

<pre>Name=onl_name
Vorname=onl_vorname
Strasse=onl_strasse
PLZ=onl_plz
Ort=onl_ort
EMail=onl_email
Bemerkung=onl_bemerkung</pre>

Mehrere Felder aus den Rückmeldeformularen aus den Evangelischen Terminen können an ein Feld in den Onlineanmeldungen von Kiribati angefügt werden. Dazu wird auf der rechten Seite des <code>=</code>-Zeichens mehrmals das gewünschte Feld angegeben werden. Z.B. kann man so nicht zuordenbare Felder in das Bemerkungsfeld schreiben:

<pre>Bemerkung=onl_bemerkung
Verpflegung=onl_bemerkung</pre>

===Felder für die Onlineanmeldung===

<pre>[onl_record] [numeric](10, 0) IDENTITY(1,1) NOT NULL,
[onl_guid] [char](38) NOT NULL,
[onl_anmeldenummer] [char](38) NULL,
[onl_anmeldesession] [char](38) NULL,
[onl_anmeldedatum] [datetime] NULL,
[onl_anmeldezeit] [char](8) NULL,
[onl_anmeldequelle] [numeric](2, 0) NULL,
[onl_veranstaltungsnummer] [char](15) NULL,
[onl_anrede] [char](50) NULL,
[onl_titel] [char](70) NULL,
[onl_name] [varchar](60) NULL,
[onl_vorname] [varchar](60) NULL,
[onl_kundennummer] [char](30) NULL,
[onl_strasse] [char](35) NULL,
[onl_lkz] [char](5) NULL,
[onl_plz] [char](10) NULL,
[onl_ort] [char](50) NULL,
[onl_telefon1] [char](37) NULL,
[onl_telefon2] [char](37) NULL,
[onl_telefax] [char](37) NULL,
[onl_email] [char](120) NULL,
[onl_beruf] [char](50) NULL,
[onl_geburtsdatum] [datetime] NULL,
[onl_bemerkung] [text] NULL,
[onl_institutionname] [char](100) NULL,
[onl_institutionstrasse] [char](50) NULL,
[onl_institutionplz] [char](10) NULL,
[onl_institutionort] [char](50) NULL,
[onl_kontonummer] [char](11) NULL,
[onl_bankleitzahl] [char](8) NULL,
[onl_bank] [char](58) NULL,
[onl_kontoinhaber] [char](27) NULL,
[onl_erledigt] [numeric](1, 0) NULL,
[onl_deleted] [numeric](1, 0) NULL,
[onl_erstellt] [char](30) NULL,
[onl_bearbeitet] [char](30) NULL,
[onl_bearbeitet_am] [datetime] NULL,
[onl_erstellt_am] [datetime] NULL,
[onl_veranstaltungsrecord] [numeric](10, 0) NULL,
[onl_teilnehmerrecord] [numeric](15, 0) NULL,
[onl_gesperrt] [numeric](1, 0) NULL,
[onl_gesperrtguid] [char](38) NULL,
[onl_erstellt_zeit] [char](8) NULL,
[onl_anrede_kurz] [char](6) NULL,
[onl_adresse_ok] [int] NULL,
[onl_adresse_typ] [int] NULL,
[onl_adresse_record] [numeric](15, 0) NULL,
[onl_adresse_edit] [int] NULL,
[onl_adresse_show] [int] NULL,
[onl_benutzer_show] [int] NULL,
[onl_adresse_ok_benutzer] [char](30) NULL,
[onl_adresse_ok_datum] [datetime] NULL,
[onl_adresse_ok_zeit] [char](8) NULL,
[onl_auto_eingang] [datetime] NULL,
[onl_auto_eingang_betreff] [char](250) NULL,
[onl_auto_eingang_text] [text] NULL,
[onl_gutscheincode] [char](70) NULL,
[onl_kontakt_ueber] [char](70) NULL,
[onl_firma] [char](70) NULL,
[onl_ustid] [char](70) NULL,
[onl_bemerkung2] [text] NULL,
[onl_bemerkung3] [text] NULL,
[onl_institutionmail] [char](120) NULL,
[onl_zahlungsweise] [int] NULL,
[onl_iban1] [varchar](34) NULL,
[onl_bic1] [varchar](11) NULL,
[onl_kontaktaufnahme] [varchar](100) NULL,
[onl_einwilligungen] [int] NULL,
[onl_sprache] [varchar](5) NULL,
[onl_mobil] [varchar](37) NULL
</pre>

Import Rückmeldungen Evangelische Termine

2019-10-31T15:12:42Z

N.raebiger:

==Format==
Beispiel einer XML Rückmeldedatei
<?xml version="1.0" encoding="UTF-8"?>
<root>
<Export>
<Rueckmeldung>
<ldf_Nr Label="lfd. Nr.">1</ldf_Nr>
<datum Label="Rückmeldung vom">12.10.2018 12:38</datum>
<status Label="Status">weiß</status>
<erfassung Label="QR-Code erfasst">Nein</erfassung>
<info Label="Notizen" />
<Anrede Label="Anrede">Frau</Anrede>
<Titel Label="Titel">Testtitel</Titel>
<Name Label="Name">Muster</Name>
<Vorname Label="Vorname">Max</Vorname>
<Einrichtung Label="Einrichtung">AEEB</Einrichtung>
<Strasse Label="Strasse">Teststraße 1</Strasse>
<PLZ Label="PLZ">80000</PLZ>
<Ort Label="Ort">Testort</Ort>
<Telefon Label="Telefon">123456789</Telefon>
<EMail Label="EMail">muster.max@include.de</EMail>
<Bemerkung Label="Bemerkung">Mitglied</Bemerkung>
<Zahlungsart Label="Zahlungsart">Lastschrift</Zahlungsart>
<Kontoinhaber Label="Kontoinhaber">Muster Max</Kontoinhaber>
<Kreditinstitut Label="Kreditinstitut">Testbank</Kreditinstitut>
<Bankort Label="Bankort">München</Bankort>
<IBAN Label="IBAN">de123456789</IBAN>
</Rueckmeldung>
</Export>
</root>

==Import==
===Voraussetzungen===
====Zuordnung====
Einer Veranstaltung kann unter Internet->Rückmeldformular ein Formular zugeordnet werden.
Um eine Auswahl an Rückmeldeformularen anzubieten könnten diese in der INI Datei erfaßt werden.
[EVT]
Rueckmeldeformular1=376,Standard
Rueckmeldeformular2=377,EPK
====Mapping Datei====
‎[[Datei:evt_rueckmeldeformular.png|thumb|none|Rückmeldeformular]]
Im Ornder ...\daten\import\evtermine muss sich eine Textdatei beginnend mit dem Buchstaben R + Nummer des Rückmeldeformulars befinden. Beispiel R376.TXT

Inhalt der Datei ist ein Mapping zum Rückmeldeformular in Evang. Termine.

<pre>Name=onl_name
Vorname=onl_vorname
Strasse=onl_strasse
PLZ=onl_plz
Ort=onl_ort
EMail=onl_email
Bemerkung=onl_bemerkung</pre>

Mehrere Felder aus den Rückmeldeformularen aus den Evangelischen Terminen können an ein Feld in den Onlineanmeldungen von Kiribati angefügt werden. Dazu wird auf der rechten Seite des <code>=</code>-Zeichens mehrmals das gewünschte Feld angegeben werden. Z.B. kann man so nicht zuordenbare Felder in das Bemerkungsfeld schreiben:

<pre>Bemerkung=onl_bemerkung
Verpflegung=onl_bemerkung</pre>

===Felder für die Onlineanmeldung===

<pre> [onl_record] [numeric](10, 0) IDENTITY(1,1) NOT NULL,
[onl_guid] [char](38) NOT NULL,
[onl_anmeldenummer] [char](38) NULL,
[onl_anmeldesession] [char](38) NULL,
[onl_anmeldedatum] [datetime] NULL,
[onl_anmeldezeit] [char](8) NULL,
[onl_anmeldequelle] [numeric](2, 0) NULL,
[onl_veranstaltungsnummer] [char](15) NULL,
[onl_anrede] [char](50) NULL,
[onl_titel] [char](70) NULL,
[onl_name] [varchar](60) NULL,
[onl_vorname] [varchar](60) NULL,
[onl_kundennummer] [char](30) NULL,
[onl_strasse] [char](35) NULL,
[onl_lkz] [char](5) NULL,
[onl_plz] [char](10) NULL,
[onl_ort] [char](50) NULL,
[onl_telefon1] [char](37) NULL,
[onl_telefon2] [char](37) NULL,
[onl_telefax] [char](37) NULL,
[onl_email] [char](120) NULL,
[onl_beruf] [char](50) NULL,
[onl_geburtsdatum] [datetime] NULL,
[onl_bemerkung] [text] NULL,
[onl_institutionname] [char](100) NULL,
[onl_institutionstrasse] [char](50) NULL,
[onl_institutionplz] [char](10) NULL,
[onl_institutionort] [char](50) NULL,
[onl_kontonummer] [char](11) NULL,
[onl_bankleitzahl] [char](8) NULL,
[onl_bank] [char](58) NULL,
[onl_kontoinhaber] [char](27) NULL,
[onl_erledigt] [numeric](1, 0) NULL,
[onl_deleted] [numeric](1, 0) NULL,
[onl_erstellt] [char](30) NULL,
[onl_bearbeitet] [char](30) NULL,
[onl_bearbeitet_am] [datetime] NULL,
[onl_erstellt_am] [datetime] NULL,
[onl_veranstaltungsrecord] [numeric](10, 0) NULL,
[onl_teilnehmerrecord] [numeric](15, 0) NULL,
[onl_gesperrt] [numeric](1, 0) NULL,
[onl_gesperrtguid] [char](38) NULL,
[onl_erstellt_zeit] [char](8) NULL,
[onl_anrede_kurz] [char](6) NULL,
[onl_adresse_ok] [int] NULL,
[onl_adresse_typ] [int] NULL,
[onl_adresse_record] [numeric](15, 0) NULL,
[onl_adresse_edit] [int] NULL,
[onl_adresse_show] [int] NULL,
[onl_benutzer_show] [int] NULL,
[onl_adresse_ok_benutzer] [char](30) NULL,
[onl_adresse_ok_datum] [datetime] NULL,
[onl_adresse_ok_zeit] [char](8) NULL,
[onl_auto_eingang] [datetime] NULL,
[onl_auto_eingang_betreff] [char](250) NULL,
[onl_auto_eingang_text] [text] NULL,
[onl_gutscheincode] [char](70) NULL,
[onl_kontakt_ueber] [char](70) NULL,
[onl_firma] [char](70) NULL,
[onl_ustid] [char](70) NULL,
[onl_bemerkung2] [text] NULL,
[onl_bemerkung3] [text] NULL,
[onl_institutionmail] [char](120) NULL,
[onl_zahlungsweise] [int] NULL,
[onl_iban1] [varchar](34) NULL,
[onl_bic1] [varchar](11) NULL,
[onl_kontaktaufnahme] [varchar](100) NULL,
[onl_einwilligungen] [int] NULL,
[onl_sprache] [varchar](5) NULL,
[onl_mobil] [varchar](37) NULL
</pre>

Import Rückmeldungen Evangelische Termine

2019-10-31T15:11:34Z

N.raebiger: /* Import */

Export Evangelische Termine

2019-10-22T20:24:28Z

N.raebiger: /* Programmbereiche im Internet abbilden: Kanal mitschicken */

== Allgemein ==

Die Schnittstelle ermöglicht einen automatische Übertragung von Veranstaltung aus Kiribati zu der Internetseite http://www.evangelische-termine.de/

== Internetausgabe anlegen ==
[[Datei:Internetausgabe_evtermine_neu.png ‎|thumb|none|]]

{|
|style="vertical-align:top"|Allgemein
|style="vertical-align:top"|
|-
|style="vertical-align:top"|'''Profil Name'''
|style="vertical-align:top"|Kann frei gewählt werden.
|-
|style="vertical-align:top"|'''Format'''
|style="vertical-align:top"|www.evangelische-termine.wikibati.de
|-
|style="vertical-align:top"|'''Host'''
|style="vertical-align:top"|ftp.wikibati.de
|-
|style="vertical-align:top"|'''User'''
|style="vertical-align:top"|535883-evt
|-
|style="vertical-align:top"|'''Passwort'''
|style="vertical-align:top"|Bitte bei Fa. Include erfragen
|-
|style="vertical-align:top"|'''Vid'''
|style="vertical-align:top"|Ihre Veranstalter ID bei www.evangelische-termine.de
|-
|style="vertical-align:top"|'''ApiKey'''
|style="vertical-align:top"|Melden Sie sich auf www.evangelische-termine.de an. Unter Informationen->API-Key erhalten Sie den für Sie gültigen Wert.
|-
|style="vertical-align:top"|'''Raum'''
|style="vertical-align:top"|Falls der Raum unter www.evangelische-termine.de nicht zur Verfügung steht und weitere Räume über die SOAP Schnittstelle nicht angelegt werden, sollte hier die ID eines Rückfallraumes eingetragen werden.
|-
|style="vertical-align:top"|'''Tabelle'''
|style="vertical-align:top"|2
|-
|style="vertical-align:top"|'''SQL-Ansicht'''
|style="vertical-align:top"|"select *,0 as ver_int_veranstaltung_delete, '' as ver_int_hauptkategorie, '' as ver_int_nebenkategorie_1,'' as ver_int_nebenkategorie_2,'' as ver_int_nebenkategorie_3, '' as ver_int_zielgruppe,'' as ver_int_anmeldelink,0 as ver_int_anmeldeformular_typ from veranstaltungen where ver_titel1 is not null and LEN(ver_titel1)>0"
|-
|style="vertical-align:top"|
|style="vertical-align:top"|
|}

[[Datei:Internetausgabe_evtermine_neu_erweitert.png ‎|thumb|none|]]

{|
|style="vertical-align:top"|Erweitert
|style="vertical-align:top"|
|-
|style="vertical-align:top"|'''Remote Port'''
|style="vertical-align:top"|21
|-
|style="vertical-align:top"|'''Buffer'''
|style="vertical-align:top"|1024
|-
|style="vertical-align:top"|'''Transfermode'''
|style="vertical-align:top"|Binary
|-
|style="vertical-align:top"|'''Passive Transfer'''
|style="vertical-align:top"|Aktiv
|-
|style="vertical-align:top"|
|style="vertical-align:top"|
|}

[[Datei:Internetausgabe_evtermine_neu_verzeichnisse.png ‎|thumb|none|]]

{|
|style="vertical-align:top"|Verzeichnisse
|style="vertical-align:top"|
|-
|style="vertical-align:top"|'''Ziel'''
|style="vertical-align:top"|/webseiten/evtermine
|-
|style="vertical-align:top"|'''Url'''
|style="vertical-align:top"|www.evangelische-termine.wikibati.de/kiribati2evtsoap.php
|}

== Art der Erwachsenenbildungsveranstaltung ==
Mindestens einer der nachfolgenden Werte sollte im Feld "Veranstaltungsart" in Kiribati erfasst sein. Sofern kein Wert eingetragen ist, werden ALLE geschickt, da das Feld ein Pflichtfeld ist.
*Gesprächskreis
*Info-Veranstaltung
*Vortrag
*Kurs / Vortragsreihe
*Podiumsdiskussion
*Seminar
*Fortbildung
*Fachtag
*Workshop
*Studienfahrt / Studienreise
*Ausstellung / Kunst / Führung
*Musik / Lesung / Film
*Meditiation / Spirituelles Angebot

== Art der Veranstaltung (Evang. Termine) ==
Mindestens einer der nachfolgenden Werte sollte im Feld "Veranstaltungsart" in Kiribati erfasst sein. Sofern kein Wert eingetragen ist, wird SONSTIGES geschickt.
*Gruppe / Kreis
*Fortbildung / Seminar / Vortrag
*Konzert / Theater / Musik
*Freizeit / Reise
*Ausstellung / Kunst
*Meditation / Spirituelles Angebot
*Fest / Feiern
*Sport/Spiel
*Sonstiges

== Zielgruppen ==
Wird derzeit immer ALLE geschickt.

== Highlight ==
Über Veranstaltungen->Internet kann eine Veranstaltung auch als Highlight gesetzt werden.

== Rückmeldeformulare ==
Hinterlegen in INI Datei.

Beispiel:

<pre>[EVT]
Rueckmeldeformular1=1, Anmeldeformular
Rueckmeldeformular2=2, Anmeldeformular-Pekip</pre>

Zahl vor dem Komma ist die ID des Formulars in Evang. Termine

== Programmbereiche im Internet abbilden: Kanal mitschicken ==

Die Evangelischen Termine ermöglichen eine Vielzahl von Filtermöglichkeiten. So lassen sich über diese Funktion von Kiribati Programmbereiche filtern und im Internet anzeigen. Die Programmbereiche tragen z. B. Überschriften wie '''Religion & Philosophie''', '''Gesellschaft & Verantwortung''' etc. Diese Programmbereiche lassen sich nun leicht filtern und nur die Veranstaltungen zu einem dieser Programmbereiche anzeigen.

Damit dies funktioniert müssen ein paar Vorarbeiten getroffen werden:

1. Kanäle für die Programmbereiche in den Evangelischen Terminen anlegen. 
2. Kanäle in der ''INI-Datei'' von Kiribati hinterlegen. 
3. Kanäle in den Lookups den Internetkategorien zuweisen. 
4. Internetkategorien einer Veranstaltung zuweisen. 
5. Nach Programmbereichen auf der Website filtern. 
6. ggf. Stoffgebiete den Internetkategorien zuweisen. 

=== 1. Kanäle für die Programmbereich in den Evangelischen Terminen anlegen ===

Die Kanäle werden in den Evangelischen Terminen im Menüpunkt Struktur angelegt. Informationen zum Anlegen finden sich im Handbuch der Evangelischen Termine: https://handbuch.evangelische-termine.de/kan%C3%A4le. Für die weitere Einrichtung sind die jeweiligen Kanal-IDs wichtig. Sie stehen unter der Kanalbezeichnung in den Evangelischen Terminen: <code>cha: ###</code>.

Will man diese Funktionalität auch den Mitgliedseinrichtungen zur Verfügung stellen, müssen die Kanäle von einem Dekanatsadministrator als <code>regional</code> eingerichtet werden: Reichweite regional.

=== 2. Kanäle in der INI-Datei von Kiribati hinterlegen ===

In der ''INI-Datei'' von Kiribati müssen nun die Kanal-IDs hinterlegt werden. Dazu meldet man sich als '''ADMIN''' an. Im Kiribati-Menü findet sich der Editor für diese Datei unter ''Einstellungen'' und ''INI-Datei''. Diese Datei kann auch direkt im Kiribati-Verzeichnis auf der Festplatte mit einem Texteditor bearbeitet werden.

Beispiel:

<pre>[EVT]
Kanal1=beispiel1,1
Kanal1=beispiel2,2</pre>

Vor dem Komma steht die Beschreibung des Kanals, nach dem Komma steht die ID des Kanals in den Evangelischen Terminen.

=== 3. Kanäle in den Lookups den Internetkategorien zuweisen ===

Die so in der ''INI-Datei'' angelegten Kanäle können nun den Internetkategorien zugeweisen werden. Dazu wählt man im Kiribati-Menü ''Lookups'' und ''Internetkategorien''. Im Fenster weist man nun der Internetkategorie im Feld <code>Kanal EVT</code> den jeweiligen Kanal zu.

[[Datei:Evt_kanal_internetkategorien.png‎|thumb|none|Zuordnung Kanal und Internetkategorie]]

=== 4. Internetkategorien einer Veranstaltung zuweisen ===

Nun können die Internetkategorien den Veranstaltungen zugewiesen werden. Im Veranstaltungsfenster wählt man aus dem unteren Menü ''Internet'' aus. Die Felder <code>Hauptkategorie</code> und <code>Nebenkategorie [1..3]</code> können nun mit den gewünschten Internetkategorien belegt werden. Kiribati fügt dabei alle dort hinterlegten Kanäle der Veranstaltung in den Evangelischen Terminen zu.

=== 5. Nach Programmbereichen auf der Website filtern ===

Nach den wie oben angelegten Kanälen kann nun auf der eigenen Website gefiltert werden. Dazu muss entweder der Parameter <code>&cha=###</code> an die URL angehängt werden oder man nimmt die Einstellungen im jeweiligen Plugin der Evangelischen Termine vor.

* Musterwebsite der Vernetzten Kirche - Feld: <code>ID des Kanals (cha)</code>
* Wordpress-Plugin '''evangtermine''' https://de.wordpress.org/plugins/evangtermine/: <code>[et_teaser cha=###]</code>, <code>[et_veranstalter cha=###]</code> oder im Widget '''Evangelische Termine''' das Feld <code>Kanäle</code>.

=== 6. ggf. Stoffgebiete den Internetkategorien zuweisen ===

In Kiribati kann die Zuweisung der Hauptkategorie auch über die Stoffgebiete erfolgen. Damit wird dann einer Veranstaltung anhand des Stoffgebiets automatisch eine Internetkategorie zugeordnet. Die Tabelle mit den Zuweisungen findet sich in den ''Lookups'' im Kiribati-Menü unter ''Stoffgebiete''.

Export Evangelische Termine

2019-10-22T20:17:33Z

N.raebiger: /* Rückmeldeformulare */

== Allgemein ==

Die Schnittstelle ermöglicht einen automatische Übertragung von Veranstaltung aus Kiribati zu der Internetseite http://www.evangelische-termine.de/

== Internetausgabe anlegen ==
[[Datei:Internetausgabe_evtermine_neu.png ‎|thumb|none|]]

{|
|style="vertical-align:top"|Allgemein
|style="vertical-align:top"|
|-
|style="vertical-align:top"|'''Profil Name'''
|style="vertical-align:top"|Kann frei gewählt werden.
|-
|style="vertical-align:top"|'''Format'''
|style="vertical-align:top"|www.evangelische-termine.wikibati.de
|-
|style="vertical-align:top"|'''Host'''
|style="vertical-align:top"|ftp.wikibati.de
|-
|style="vertical-align:top"|'''User'''
|style="vertical-align:top"|535883-evt
|-
|style="vertical-align:top"|'''Passwort'''
|style="vertical-align:top"|Bitte bei Fa. Include erfragen
|-
|style="vertical-align:top"|'''Vid'''
|style="vertical-align:top"|Ihre Veranstalter ID bei www.evangelische-termine.de
|-
|style="vertical-align:top"|'''ApiKey'''
|style="vertical-align:top"|Melden Sie sich auf www.evangelische-termine.de an. Unter Informationen->API-Key erhalten Sie den für Sie gültigen Wert.
|-
|style="vertical-align:top"|'''Raum'''
|style="vertical-align:top"|Falls der Raum unter www.evangelische-termine.de nicht zur Verfügung steht und weitere Räume über die SOAP Schnittstelle nicht angelegt werden, sollte hier die ID eines Rückfallraumes eingetragen werden.
|-
|style="vertical-align:top"|'''Tabelle'''
|style="vertical-align:top"|2
|-
|style="vertical-align:top"|'''SQL-Ansicht'''
|style="vertical-align:top"|"select *,0 as ver_int_veranstaltung_delete, '' as ver_int_hauptkategorie, '' as ver_int_nebenkategorie_1,'' as ver_int_nebenkategorie_2,'' as ver_int_nebenkategorie_3, '' as ver_int_zielgruppe,'' as ver_int_anmeldelink,0 as ver_int_anmeldeformular_typ from veranstaltungen where ver_titel1 is not null and LEN(ver_titel1)>0"
|-
|style="vertical-align:top"|
|style="vertical-align:top"|
|}

[[Datei:Internetausgabe_evtermine_neu_erweitert.png ‎|thumb|none|]]

{|
|style="vertical-align:top"|Erweitert
|style="vertical-align:top"|
|-
|style="vertical-align:top"|'''Remote Port'''
|style="vertical-align:top"|21
|-
|style="vertical-align:top"|'''Buffer'''
|style="vertical-align:top"|1024
|-
|style="vertical-align:top"|'''Transfermode'''
|style="vertical-align:top"|Binary
|-
|style="vertical-align:top"|'''Passive Transfer'''
|style="vertical-align:top"|Aktiv
|-
|style="vertical-align:top"|
|style="vertical-align:top"|
|}

[[Datei:Internetausgabe_evtermine_neu_verzeichnisse.png ‎|thumb|none|]]

{|
|style="vertical-align:top"|Verzeichnisse
|style="vertical-align:top"|
|-
|style="vertical-align:top"|'''Ziel'''
|style="vertical-align:top"|/webseiten/evtermine
|-
|style="vertical-align:top"|'''Url'''
|style="vertical-align:top"|www.evangelische-termine.wikibati.de/kiribati2evtsoap.php
|}

== Art der Erwachsenenbildungsveranstaltung ==
Mindestens einer der nachfolgenden Werte sollte im Feld "Veranstaltungsart" in Kiribati erfasst sein. Sofern kein Wert eingetragen ist, werden ALLE geschickt, da das Feld ein Pflichtfeld ist.
*Gesprächskreis
*Info-Veranstaltung
*Vortrag
*Kurs / Vortragsreihe
*Podiumsdiskussion
*Seminar
*Fortbildung
*Fachtag
*Workshop
*Studienfahrt / Studienreise
*Ausstellung / Kunst / Führung
*Musik / Lesung / Film
*Meditiation / Spirituelles Angebot

== Art der Veranstaltung (Evang. Termine) ==
Mindestens einer der nachfolgenden Werte sollte im Feld "Veranstaltungsart" in Kiribati erfasst sein. Sofern kein Wert eingetragen ist, wird SONSTIGES geschickt.
*Gruppe / Kreis
*Fortbildung / Seminar / Vortrag
*Konzert / Theater / Musik
*Freizeit / Reise
*Ausstellung / Kunst
*Meditation / Spirituelles Angebot
*Fest / Feiern
*Sport/Spiel
*Sonstiges

== Zielgruppen ==
Wird derzeit immer ALLE geschickt.

== Highlight ==
Über Veranstaltungen->Internet kann eine Veranstaltung auch als Highlight gesetzt werden.

== Rückmeldeformulare ==
Hinterlegen in INI Datei.

Beispiel:

<pre>[EVT]
Rueckmeldeformular1=1, Anmeldeformular
Rueckmeldeformular2=2, Anmeldeformular-Pekip</pre>

Zahl vor dem Komma ist die ID des Formulars in Evang. Termine

== Programmbereiche im Internet abbilden: Kanal mitschicken ==

Die Evangelischen Termine ermöglichen eine Vielzahl von Filtermöglichkeiten. So lassen sich über diese Funktion von Kiribati Programmbereiche filtern und im Internet anzeigen. Die Programmbereiche tragen z. B. Überschriften wie '''Religion & Philosophie''', '''Gesellschaft & Verantwortung''' etc. Diese Programmbereiche lassen sich nun leicht filtern und nur die Veranstaltungen zu einem dieser Programmbereiche anzeigen.

Damit dies funktioniert müssen ein paar Vorarbeiten getroffen werden:

1. Kanäle für die Programmbereiche in den Evangelischen Terminen anlegen.
2. Kanäle in der <code>INI-Datei</code> von Kiribati hinterlegen.
3. Kanäle in den Lookups den Internetkategorien zuweisen.
4. Internetkategorien einer Veranstaltung zuweisen.
5. Nach Programmbereichen auf der Website filtern.
6. ggf. Stoffgebiete den Internetkategorien zuweisen.

=== 1. Kanäle für die Programmbereich in den Evangelischen Terminen anlegen ===

Die Kanäle werden in den Evangelischen Terminen im Menüpunkt Struktur angelegt. Informationen zum Anlegen finden sich im Handbuch der Evangelischen Termine: https://handbuch.evangelische-termine.de/kan%C3%A4le. Für die weitere Einrichtung sind die jeweiligen Kanal-IDs wichtig. Sie stehen unter der Kanalbezeichnung in den Evangelischen Terminen: <code>cha: ###</code>.

Will man diese Funktionalität auch den Mitgliedseinrichtungen zur Verfügung stellen, müssen die Kanäle von einem Dekanatsadministrator als <code>regional</code> eingerichtet werden: Reichweite regional.

=== 2. Kanäle in der INI-Datei von Kiribati hinterlegen ===

In der <code>INI-Datei</code> von Kiribati müssen nun die Kanal-IDs hinterlegt werden. Dazu meldet man sich als '''ADMIN''' an. Im Kiribati-Menü findet sich der Editor für diese Datei unter ''Einstellungen'' und ''INI-Datei''. Diese Datei kann auch direkt im Kiribati-Verzeichnis auf der Festplatte mit einem Texteditor bearbeitet werden.

Beispiel:

<pre>[EVT]
Kanal1=beispiel1,1
Kanal1=beispiel2,2</pre>

Vor dem Komma steht die Beschreibung des Kanals, nach dem Komma steht die ID des Kanals in den Evangelischen Terminen.

=== 3. Kanäle in den Lookups den Internetkategorien zuweisen ===

Die so in der <code>INI-Datei</code> angelegten Kanäle können nun den Internetkategorien zugeweisen werden. Dazu wählt man im Kiribati-Menü ''Lookups'' und ''Internetkategorien''. Im Fenster weist man nun der Internetkategorie im Feld <code>Kanal EVT</code> den jeweiligen Kanal zu.

[[Datei:Evt_kanal_internetkategorien.png‎|thumb|none|Zuordnung Kanal und Internetkategorie]]

=== 4. Internetkategorien einer Veranstaltung zuweisen ===

Nun können die Internetkategorien den Veranstaltungen zugewiesen werden. Im Veranstaltungsfenster wählt man aus dem unteren Menü ''Internet'' aus. Die Felder <code>Hauptkategorie</code> und <code>Nebenkategorie [1..3]</code> können nun mit den gewünschten Internetkategorien belegt werden. Kiribati fügt dabei alle dort hinterlegten Kanäle der Veranstaltung in den Evangelischen Terminen zu.

=== 5. Nach Programmbereichen auf der Website filtern ===

Nach den wie oben angelegten Kanälen kann nun auf der eigenen Website gefiltert werden. Dazu muss entweder der Parameter <code>&cha=###</code> an die URL angehängt werden oder man nimmt die Einstellungen im jeweiligen Plugin der Evangelischen Termine vor.

* Musterwebsite der Vernetzten Kirche - Feld: <code>ID des Kanals (cha)</code>
* Wordpress-Plugin '''evangtermine''' https://de.wordpress.org/plugins/evangtermine/: <code>[et_teaser cha=###]</code>, <code>[et_veranstalter cha=###]</code> oder im Widget '''Evangelische Termine''' das Feld <code>Kanäle</code>.

=== 6. ggf. Stoffgebiete den Internetkategorien zuweisen ===

In Kiribati kann die Zuweisung der Hauptkategorie auch über die Stoffgebiete erfolgen. Damit wird dann einer Veranstaltung anhand des Stoffgebiets automatisch eine Internetkategorie zugeordnet. Die Tabelle mit den Zuweisungen findet sich in den ''Lookups'' im Kiribati-Menü unter ''Stoffgebiete''.

Export Evangelische Termine

2019-10-22T20:16:45Z

N.raebiger: /* Programmbereiche im Internet abbilden: Kanal mitschicken */

== Allgemein ==

Die Schnittstelle ermöglicht einen automatische Übertragung von Veranstaltung aus Kiribati zu der Internetseite http://www.evangelische-termine.de/

== Internetausgabe anlegen ==
[[Datei:Internetausgabe_evtermine_neu.png ‎|thumb|none|]]

{|
|style="vertical-align:top"|Allgemein
|style="vertical-align:top"|
|-
|style="vertical-align:top"|'''Profil Name'''
|style="vertical-align:top"|Kann frei gewählt werden.
|-
|style="vertical-align:top"|'''Format'''
|style="vertical-align:top"|www.evangelische-termine.wikibati.de
|-
|style="vertical-align:top"|'''Host'''
|style="vertical-align:top"|ftp.wikibati.de
|-
|style="vertical-align:top"|'''User'''
|style="vertical-align:top"|535883-evt
|-
|style="vertical-align:top"|'''Passwort'''
|style="vertical-align:top"|Bitte bei Fa. Include erfragen
|-
|style="vertical-align:top"|'''Vid'''
|style="vertical-align:top"|Ihre Veranstalter ID bei www.evangelische-termine.de
|-
|style="vertical-align:top"|'''ApiKey'''
|style="vertical-align:top"|Melden Sie sich auf www.evangelische-termine.de an. Unter Informationen->API-Key erhalten Sie den für Sie gültigen Wert.
|-
|style="vertical-align:top"|'''Raum'''
|style="vertical-align:top"|Falls der Raum unter www.evangelische-termine.de nicht zur Verfügung steht und weitere Räume über die SOAP Schnittstelle nicht angelegt werden, sollte hier die ID eines Rückfallraumes eingetragen werden.
|-
|style="vertical-align:top"|'''Tabelle'''
|style="vertical-align:top"|2
|-
|style="vertical-align:top"|'''SQL-Ansicht'''
|style="vertical-align:top"|"select *,0 as ver_int_veranstaltung_delete, '' as ver_int_hauptkategorie, '' as ver_int_nebenkategorie_1,'' as ver_int_nebenkategorie_2,'' as ver_int_nebenkategorie_3, '' as ver_int_zielgruppe,'' as ver_int_anmeldelink,0 as ver_int_anmeldeformular_typ from veranstaltungen where ver_titel1 is not null and LEN(ver_titel1)>0"
|-
|style="vertical-align:top"|
|style="vertical-align:top"|
|}

[[Datei:Internetausgabe_evtermine_neu_erweitert.png ‎|thumb|none|]]

{|
|style="vertical-align:top"|Erweitert
|style="vertical-align:top"|
|-
|style="vertical-align:top"|'''Remote Port'''
|style="vertical-align:top"|21
|-
|style="vertical-align:top"|'''Buffer'''
|style="vertical-align:top"|1024
|-
|style="vertical-align:top"|'''Transfermode'''
|style="vertical-align:top"|Binary
|-
|style="vertical-align:top"|'''Passive Transfer'''
|style="vertical-align:top"|Aktiv
|-
|style="vertical-align:top"|
|style="vertical-align:top"|
|}

[[Datei:Internetausgabe_evtermine_neu_verzeichnisse.png ‎|thumb|none|]]

{|
|style="vertical-align:top"|Verzeichnisse
|style="vertical-align:top"|
|-
|style="vertical-align:top"|'''Ziel'''
|style="vertical-align:top"|/webseiten/evtermine
|-
|style="vertical-align:top"|'''Url'''
|style="vertical-align:top"|www.evangelische-termine.wikibati.de/kiribati2evtsoap.php
|}

== Art der Erwachsenenbildungsveranstaltung ==
Mindestens einer der nachfolgenden Werte sollte im Feld "Veranstaltungsart" in Kiribati erfasst sein. Sofern kein Wert eingetragen ist, werden ALLE geschickt, da das Feld ein Pflichtfeld ist.
*Gesprächskreis
*Info-Veranstaltung
*Vortrag
*Kurs / Vortragsreihe
*Podiumsdiskussion
*Seminar
*Fortbildung
*Fachtag
*Workshop
*Studienfahrt / Studienreise
*Ausstellung / Kunst / Führung
*Musik / Lesung / Film
*Meditiation / Spirituelles Angebot

== Art der Veranstaltung (Evang. Termine) ==
Mindestens einer der nachfolgenden Werte sollte im Feld "Veranstaltungsart" in Kiribati erfasst sein. Sofern kein Wert eingetragen ist, wird SONSTIGES geschickt.
*Gruppe / Kreis
*Fortbildung / Seminar / Vortrag
*Konzert / Theater / Musik
*Freizeit / Reise
*Ausstellung / Kunst
*Meditation / Spirituelles Angebot
*Fest / Feiern
*Sport/Spiel
*Sonstiges

== Zielgruppen ==
Wird derzeit immer ALLE geschickt.

== Highlight ==
Über Veranstaltungen->Internet kann eine Veranstaltung auch als Highlight gesetzt werden.

== Rückmeldeformulare ==
Hinterlegen in INI Datei.

Beispiel:

[EVT]

Rueckmeldeformular1=1, Anmeldeformular

Rueckmeldeformular2=2, Anmeldeformular-Pekip

Zahl vor dem Komma ist die ID des Formulars in Evang. Termine

== Programmbereiche im Internet abbilden: Kanal mitschicken ==

Die Evangelischen Termine ermöglichen eine Vielzahl von Filtermöglichkeiten. So lassen sich über diese Funktion von Kiribati Programmbereiche filtern und im Internet anzeigen. Die Programmbereiche tragen z. B. Überschriften wie '''Religion & Philosophie''', '''Gesellschaft & Verantwortung''' etc. Diese Programmbereiche lassen sich nun leicht filtern und nur die Veranstaltungen zu einem dieser Programmbereiche anzeigen.

Damit dies funktioniert müssen ein paar Vorarbeiten getroffen werden:

1. Kanäle für die Programmbereiche in den Evangelischen Terminen anlegen.
2. Kanäle in der <code>INI-Datei</code> von Kiribati hinterlegen.
3. Kanäle in den Lookups den Internetkategorien zuweisen.
4. Internetkategorien einer Veranstaltung zuweisen.
5. Nach Programmbereichen auf der Website filtern.
6. ggf. Stoffgebiete den Internetkategorien zuweisen.

=== 1. Kanäle für die Programmbereich in den Evangelischen Terminen anlegen ===

Die Kanäle werden in den Evangelischen Terminen im Menüpunkt Struktur angelegt. Informationen zum Anlegen finden sich im Handbuch der Evangelischen Termine: https://handbuch.evangelische-termine.de/kan%C3%A4le. Für die weitere Einrichtung sind die jeweiligen Kanal-IDs wichtig. Sie stehen unter der Kanalbezeichnung in den Evangelischen Terminen: <code>cha: ###</code>.

Will man diese Funktionalität auch den Mitgliedseinrichtungen zur Verfügung stellen, müssen die Kanäle von einem Dekanatsadministrator als <code>regional</code> eingerichtet werden: Reichweite regional.

=== 2. Kanäle in der INI-Datei von Kiribati hinterlegen ===

In der <code>INI-Datei</code> von Kiribati müssen nun die Kanal-IDs hinterlegt werden. Dazu meldet man sich als '''ADMIN''' an. Im Kiribati-Menü findet sich der Editor für diese Datei unter ''Einstellungen'' und ''INI-Datei''. Diese Datei kann auch direkt im Kiribati-Verzeichnis auf der Festplatte mit einem Texteditor bearbeitet werden.

Beispiel:

<pre>[EVT]
Kanal1=beispiel1,1
Kanal1=beispiel2,2</pre>

Vor dem Komma steht die Beschreibung des Kanals, nach dem Komma steht die ID des Kanals in den Evangelischen Terminen.

=== 3. Kanäle in den Lookups den Internetkategorien zuweisen ===

Die so in der <code>INI-Datei</code> angelegten Kanäle können nun den Internetkategorien zugeweisen werden. Dazu wählt man im Kiribati-Menü ''Lookups'' und ''Internetkategorien''. Im Fenster weist man nun der Internetkategorie im Feld <code>Kanal EVT</code> den jeweiligen Kanal zu.

[[Datei:Evt_kanal_internetkategorien.png‎|thumb|none|Zuordnung Kanal und Internetkategorie]]

=== 4. Internetkategorien einer Veranstaltung zuweisen ===

Nun können die Internetkategorien den Veranstaltungen zugewiesen werden. Im Veranstaltungsfenster wählt man aus dem unteren Menü ''Internet'' aus. Die Felder <code>Hauptkategorie</code> und <code>Nebenkategorie [1..3]</code> können nun mit den gewünschten Internetkategorien belegt werden. Kiribati fügt dabei alle dort hinterlegten Kanäle der Veranstaltung in den Evangelischen Terminen zu.

=== 5. Nach Programmbereichen auf der Website filtern ===

Nach den wie oben angelegten Kanälen kann nun auf der eigenen Website gefiltert werden. Dazu muss entweder der Parameter <code>&cha=###</code> an die URL angehängt werden oder man nimmt die Einstellungen im jeweiligen Plugin der Evangelischen Termine vor.

* Musterwebsite der Vernetzten Kirche - Feld: <code>ID des Kanals (cha)</code>
* Wordpress-Plugin '''evangtermine''' https://de.wordpress.org/plugins/evangtermine/: <code>[et_teaser cha=###]</code>, <code>[et_veranstalter cha=###]</code> oder im Widget '''Evangelische Termine''' das Feld <code>Kanäle</code>.

=== 6. ggf. Stoffgebiete den Internetkategorien zuweisen ===

In Kiribati kann die Zuweisung der Hauptkategorie auch über die Stoffgebiete erfolgen. Damit wird dann einer Veranstaltung anhand des Stoffgebiets automatisch eine Internetkategorie zugeordnet. Die Tabelle mit den Zuweisungen findet sich in den ''Lookups'' im Kiribati-Menü unter ''Stoffgebiete''.

Export Evangelische Termine

2019-10-17T13:07:07Z

N.raebiger: /* Kanal mitschicken */

Import Evangelische Termine

2019-10-09T11:34:34Z

N.raebiger: /* Einstellungen für Administratoren */

== Allgemein ==

Die Schnittstelle ermöglicht einen automatischen Import von Veranstaltungsmeldungen der Internetseite http://www.evangelische-termine.de/, der evangelische Veranstaltungskalender für Bayern, in das [[Veranstaltungen| Veranstaltungsmodul]] von Kiribati zur Weiterverarbeitung als Programmheft und zur Übernahme in die [[Landesstatistik|Landesstatistik]].

== Handbuch: Evangelische Termine ==
Eine Dokumentation der Eingabe in Evangelische Termine finden sie unter [http://handbuch.evangelische-termine.de/erg%C3%A4nzung-ebw http://handbuch.evangelische-termine.de/ergänzung-ebw]

== Vorraussetzungen ==

Die Veranstaltungsmeldungen müssen im Veranstaltungskalender http://www.evangelische-termine.de/ in einem bestimmtem Formular, aktuell das Formular "Erwachsenenbildung", erfaßt werden. In Kiribati ist derzeit das Modul [[Veranstaltungen|Veranstaltungen]] und die Schnittstell "Import Evang. Termine" zwingend notwendig. Eine sofortige Übernahme in die [[Landesstatistik|Landesstatistik]] ist nicht möglich. In der Erfassung der Veranstaltungsmeldungen fehlen wichtige Daten für die Statistik.Diese Daten müssen vom EBW inhaltich geprüft und ergänzt werden.

== Automatischer Import ==
[[Datei:Import_ev_termine.png|mini|Import starten ]]
=== Import starten ===
Öffnen Sie in Kiribati das [[Veranstaltungen|Veranstaltungsmodul]] und klicken in der Toolbar auf die Schaltfläche 'Import'
[[Datei:Import_ev_termine_datumsbereich.png|mini|Datumsbereich]]

=== Datumsbereich auswählen ===
Geben Sie den Zeitraum an. Im Standard zeigt die Maske den zuletzt gewählten Zeitraum.

=== Datumsbereich mit Bereich bzw. VID auswählen ===
Sollte in der der KUBOS.INI Datei keine Veranstalterid eingetragen sein, kann man in den Bereichen die VID erfassen und jeweils nur eine Kirchengemeinde abrufen.
[[Datei:Datum_mit_bereich.png ‎|mini|Import mit Bereich starten ]]
[[Datei:Bereich_VID.png‎|mini|VID im Bereich erfassen]]

=== Vorschau ===
Bevor die Veranstaltungen übernommen werden, erhalten Sie eine Vorschau. Hier können Sie die Übernahme auch abbrechen. Klicken Sie auf die Schaltfläche rechts untern "Veranstaltungen importieren".
Veranstaltungen die bereits vorhanden sind, werden überschrieben.
: '''<ins>Tipp</ins>'''
:: Aus dem Import erhält Kiribati keine Bereiche. Somit fehlen Kommune und Kommunalkennziffer für die Landesstatistik. Allerdings werden die Veranstaltungsort und -räume aus Evang. Termine in die Raumdatei importiert. Tragen sie dort die Bereiche nach und wiederholen Sie den Import. Dann sind in den Veranstaltungen alle Bereiche vorhanden.

== Manueller Import ==

In Arbeit ...

== Einstellungen für Administratoren ==
In der Section [Import] der INI-Datei von Kiribati müssen folgende Einstellungen getroffen werden.

: '''<ins>Veranstaltungen_auto=1</ins>'''
:: Die Schnittstelle holt die Daten automatisch. 0 bedeutet eine manuelle Übernahme.

: '''<ins>Veranstaltungen_url=http://www.evangelische-termine.de/Veranstalter/xml.php</ins>'''
::Weblink zum Importaufruf

: '''<ins>Veranstaltungen_vid=203</ins>'''
::Ruft die Veranstaltungen mit der Veranstalterid 203 ab. Wird kein Wert hinterlegt, werden alle aus Veranstaltungen_region abgerufen.

: '''<ins>Veranstaltungen_region=203</ins>'''
::Die Dekanate haben jeweils eine 3-stellige Dekanatenummer. Beispiel Kempten: 203 Der Parameter lautet region Alternativ zum Dekanat können Sie auch die Veranstaltungen von einzelnen Veranstaltern abrufen. Jeder Veranstalter hat eine ID - Parameter vid. Die Kirchengemeinde Oberstdorf hat z.B. die vid 788. Es können auch mehrere Regionen mit kommaetrennten Werten abgerufen werden. Beispiel 101,102,103
Die ID finden Sie auch unter http://handbuch.evangelische-termine.de/Dekanats-ID

Will man nicht alle Veranstalter einer Region ausgeben, kann der Parameter <code>?vidfilter=</code> angehängt werden: <code>Veranstaltungen_region=203?vidfilter=VID1,VID2</code> (VID1 und VID2 müssen durch die Veranstalter-IDs aus den Evangelischen Terminen ersetzt werden. Mehrere VIDs werden durch Kommata getrennt. Achtung: Keine Leerzeichen verwewenden!)

: '''<ins>Veranstaltungen_ipm=808</ins> NICHT MEHR NOTWENDIG. Stattdessen wird vom System auswahl=eb (Kanal "Erwachsenenbildung") verwendet'''
::IMP ist die ID des Eingabeformular zur Erfassung der Daten. Derzeit das Formular 'Erwachsenenbildung' mit der ID 808.
::Das alte Formular 'EBS' ist mit der ID 646 abzurufen.

: '''<ins>Veranstaltungen_vid=2042</ins>'''
::Veranstalterid. Der Wert für veranstaltungen_region sollt dann auf all gesetzt werden.
Beispiel: http://www.evangelische-termine.de/Veranstalter/xml.php?region=all&vid=2042&ipm=808&highlight=all&itemsPerPage=200&start=2018-01-01&end=2018-12-31

: '''<ins>Veranstaltungen_dest=all</ins>'''
::Die Einstellung all bringt auch die internen Veranstaltungen.

: '''<ins>Veranstaltungen_itemsPerPage=100</ins>'''
::Anzahl der pro "Seite" exportierten Veranstaltungen.

: '''<ins>Veranstaltungen_setproxy=10.214.193.150:80</ins>'''
::Erfolgt der Internetzugang über eine Proxy-Server (Beispiel "Sicheres Kirchennetz") dann muss hier die IP-Adresse des Server mit Port angegeben werden.

: '''<ins>Veranstaltungen_proakt=1</ins>'''
::0 = Die Veranstaltungen werden abhängig vom Beginndatum dem Programm mit der Jahreszahl des Beginndatums gespeichert.
::1 = Die Veranstaltungen werden in das beim Import gewählte Programm gespeichert.
::2 = In Arbeit ... (Die Veranstaltungen werden in dem Programm gepeichert, das dem Datumsbereich entspricht.

Import Evangelische Termine

2019-10-09T11:32:30Z

N.raebiger:

== Allgemein ==

Die Schnittstelle ermöglicht einen automatischen Import von Veranstaltungsmeldungen der Internetseite http://www.evangelische-termine.de/, der evangelische Veranstaltungskalender für Bayern, in das [[Veranstaltungen| Veranstaltungsmodul]] von Kiribati zur Weiterverarbeitung als Programmheft und zur Übernahme in die [[Landesstatistik|Landesstatistik]].

== Handbuch: Evangelische Termine ==
Eine Dokumentation der Eingabe in Evangelische Termine finden sie unter [http://handbuch.evangelische-termine.de/erg%C3%A4nzung-ebw http://handbuch.evangelische-termine.de/ergänzung-ebw]

== Vorraussetzungen ==

Die Veranstaltungsmeldungen müssen im Veranstaltungskalender http://www.evangelische-termine.de/ in einem bestimmtem Formular, aktuell das Formular "Erwachsenenbildung", erfaßt werden. In Kiribati ist derzeit das Modul [[Veranstaltungen|Veranstaltungen]] und die Schnittstell "Import Evang. Termine" zwingend notwendig. Eine sofortige Übernahme in die [[Landesstatistik|Landesstatistik]] ist nicht möglich. In der Erfassung der Veranstaltungsmeldungen fehlen wichtige Daten für die Statistik.Diese Daten müssen vom EBW inhaltich geprüft und ergänzt werden.

== Automatischer Import ==
[[Datei:Import_ev_termine.png|mini|Import starten ]]
=== Import starten ===
Öffnen Sie in Kiribati das [[Veranstaltungen|Veranstaltungsmodul]] und klicken in der Toolbar auf die Schaltfläche 'Import'
[[Datei:Import_ev_termine_datumsbereich.png|mini|Datumsbereich]]

=== Datumsbereich auswählen ===
Geben Sie den Zeitraum an. Im Standard zeigt die Maske den zuletzt gewählten Zeitraum.

=== Datumsbereich mit Bereich bzw. VID auswählen ===
Sollte in der der KUBOS.INI Datei keine Veranstalterid eingetragen sein, kann man in den Bereichen die VID erfassen und jeweils nur eine Kirchengemeinde abrufen.
[[Datei:Datum_mit_bereich.png ‎|mini|Import mit Bereich starten ]]
[[Datei:Bereich_VID.png‎|mini|VID im Bereich erfassen]]

=== Vorschau ===
Bevor die Veranstaltungen übernommen werden, erhalten Sie eine Vorschau. Hier können Sie die Übernahme auch abbrechen. Klicken Sie auf die Schaltfläche rechts untern "Veranstaltungen importieren".
Veranstaltungen die bereits vorhanden sind, werden überschrieben.
: '''<ins>Tipp</ins>'''
:: Aus dem Import erhält Kiribati keine Bereiche. Somit fehlen Kommune und Kommunalkennziffer für die Landesstatistik. Allerdings werden die Veranstaltungsort und -räume aus Evang. Termine in die Raumdatei importiert. Tragen sie dort die Bereiche nach und wiederholen Sie den Import. Dann sind in den Veranstaltungen alle Bereiche vorhanden.

== Manueller Import ==

In Arbeit ...

== Einstellungen für Administratoren ==
In der Section [Import] der INI-Datei von Kiribati müssen folgende Einstellungen getroffen werden.

: '''<ins>Veranstaltungen_auto=1</ins>'''
:: Die Schnittstelle holt die Daten automatisch. 0 bedeutet eine manuelle Übernahme.

: '''<ins>Veranstaltungen_url=http://www.evangelische-termine.de/Veranstalter/xml.php</ins>'''
::Weblink zum Importaufruf

: '''<ins>Veranstaltungen_vid=203</ins>'''
::Ruft die Veranstaltungen mit der Veranstalterid 203 ab. Wird kein Wert hinterlegt, werden alle aus Veranstaltungen_region abgerufen.

: '''<ins>Veranstaltungen_region=203</ins>'''
::Die Dekanate haben jeweils eine 3-stellige Dekanatenummer. Beispiel Kempten: 203 Der Parameter lautet region Alternativ zum Dekanat können Sie auch die Veranstaltungen von einzelnen Veranstaltern abrufen. Jeder Veranstalter hat eine ID - Parameter vid. Die Kirchengemeinde Oberstdorf hat z.B. die vid 788. Es können auch mehrere Regionen mit kommaetrennten Werten abgerufen werden. Beispiel 101,102,103
Die ID finden Sie auch unter http://handbuch.evangelische-termine.de/Dekanats-ID

Will man nicht alle Veranstalter einer Region ausgeben, kann der Parameter `?vidfilter=` angehängt werden: `Veranstaltungen_region=203?vidfilter=VID1,VID2` (VID1 und VID2 müssen durch die Veranstalter-IDs aus den Evangelischen Terminen ersetzt werden. Mehrere VIDs werden durch Kommata getrennt. Achtung: Keine Leerzeichen verwewenden!)

: '''<ins>Veranstaltungen_ipm=808</ins> NICHT MEHR NOTWENDIG. Stattdessen wird vom System auswahl=eb (Kanal "Erwachsenenbildung") verwendet'''
::IMP ist die ID des Eingabeformular zur Erfassung der Daten. Derzeit das Formular 'Erwachsenenbildung' mit der ID 808.
::Das alte Formular 'EBS' ist mit der ID 646 abzurufen.

: '''<ins>Veranstaltungen_vid=2042</ins>'''
::Veranstalterid. Der Wert für veranstaltungen_region sollt dann auf all gesetzt werden.
Beispiel: http://www.evangelische-termine.de/Veranstalter/xml.php?region=all&vid=2042&ipm=808&highlight=all&itemsPerPage=200&start=2018-01-01&end=2018-12-31

: '''<ins>Veranstaltungen_dest=all</ins>'''
::Die Einstellung all bringt auch die internen Veranstaltungen.

: '''<ins>Veranstaltungen_itemsPerPage=100</ins>'''
::Anzahl der pro "Seite" exportierten Veranstaltungen.

: '''<ins>Veranstaltungen_setproxy=10.214.193.150:80</ins>'''
::Erfolgt der Internetzugang über eine Proxy-Server (Beispiel "Sicheres Kirchennetz") dann muss hier die IP-Adresse des Server mit Port angegeben werden.

: '''<ins>Veranstaltungen_proakt=1</ins>'''
::0 = Die Veranstaltungen werden abhängig vom Beginndatum dem Programm mit der Jahreszahl des Beginndatums gespeichert.
::1 = Die Veranstaltungen werden in das beim Import gewählte Programm gespeichert.
::2 = In Arbeit ... (Die Veranstaltungen werden in dem Programm gepeichert, das dem Datumsbereich entspricht.

Indesign xml raebiger

2016-09-06T14:15:37Z

N.raebiger: /* XML-Daten importieren */

== Beschreibung eines möglichen Workflows ==
Die vorbereitenden Schritte müssen nur bei der Erstellung des Templates durchgeführt werden. Hat man sich alles eingerichtet, muss man nur doch die Veranstaltungen in Kiribati exportieren und dann die Verknüpfung der XML-Datei in InDesign ändern oder die XML-Datei importieren.

=== Testdaten in Kiribati anlegen und exportieren ===
Die Testdaten sollten alle gewünschten Informationen enthalten, damit später in InDesign die einzelnen Felder (in InDesign ''Tags'' genannt) enthalten sind. Es empiehlt sich eine Veranstaltung mit mehreren Terminen, ReferentInnen (Mitwirkende), einem Stoffgebiet und Gebühren anzulegen. Damit werden alle Elemente beim Export erzeugt ([[Kiribati-XML-Export|Beispiel der XML-Datei mit Beschreibungen]]). Außerdem sollte man sich jetzt darüber Gedanken machen, welche Informationen später im Programmheft erscheinen sollen. Möchte man z. B. nur eine kurze Beschreibung drucken, ist es u. U. nicht sinnvoll dafür das Feld ''Beschreibung'' zu verwenden, da dieses z. B. durch einen Import von Veranstaltungen aus den Evangelischen Terminen bei einem erneuten Import überschrieben wird. Die Felder ''Aufriss/Abriss'' in Kiribati sind z. B. gut für eine Kurzbeschreibung.

Ggf. ist es auch sinnvoll, ein Kontrollkästchen in Kiribati festzulegen, über das bei der Abfrage der Veranstaltungen gesteuert werden kann, ob eine Veranstaltung im Programmheft aufgenommen werden soll oder nicht (z. B. Kontrollkästchen ''publizieren'').

==== Export vorbereiten ====
Auch für den Export der Daten ist es sinnvoll, vorher festzulegen, wie die Daten abgefragt und sortiert sein müssen. Evtl. muss dafür eine neue Definition für die Abfrage und Sortierung erstellt werden. Dazu müssen Sie in Kiribati als ADMIN angemeldet sein und in der rechten Menüleiste den Punkt Datenbank ⇒ Abfragen ⇒ Veranstaltungen wählen. Aus der Liste können Sie sich eine Vorlage heraussuchen, mit F7 duplizieren und das Duplikat dann mit einem Doppelklick bearbeiten.

==== Konfiguration für den Datenexport ====
In der Datei <code>kubos.ini</code> im Kiribati-Installationsverzeichnis findet sich der Abschnitt [InDesign]. Den Wert von <code>XML_verschachtelt</code> sollte man auf 1 setzen. Dadurch erreicht man, dass Kiribati beim Export die Datensätze aus den einzelnen Datenbanktabellen so verschachtelt, dass diese gut von InDesign oder durch ein [[XSLT-Stylesheet]] (vor der Verarbeitung in InDesign) verarbeitet werden können.
<pre>
[InDesign]
XML_verschachtelt=1
XML_Schema=0
</pre>

==== Veranstaltungsdaten exportieren ====
Kiribati kennt schon den Export für InDesign. Um die Daten zu exportieren, startet man das Modul ''Veranstaltungen'' und wählt dann aus dem Datei-Menü den Punkt ''Varianten von Liste, Etikette, Word.Dokumenten, Serienemails ...'' oder das Icon ''Sendungen''. Als Dokumenttyp wählt man ''Adobe InDesign XML'', wählt die gewünschte Abfrage und Sortierung aus und erhält im Anschluss eine Liste mit den ausgewählten und sortierten Veranstaltungen. Durch fertigstellen werden die XML-Daten erzeugt. Diese öffnet man dann in einem Editor und speichert die Datei im gewünschten Verzeichnis.

=== Satzdatei in InDesign erstellen, Testdaten importieren und die Satzdatei gestalten ===
==== Satzdatei in InDesign einrichten ====
In InDesign erstellt man nun eine leere Satzdatei, die aber schon das Format bekommt, das man später an die Druckerei übermittelt (z. B. DL 105x210 mm, 16 Seiten, Doppelseite, Anschnitt umlaufend 2 mm). Nach dem Anlegen der Satzdatei erstellt man auf der Seite, auf der das eigentliche Programm erscheinen soll ein leeres Textfeld, das so groß sein soll, wie der zur Verfügung stehende Platz.

[[Datei:InDesign-leere-Satzdatei.jpg|200px|thumb|right|Screenshot einer leeren Satzdatei in InDesign mit geöffneter Strukturansicht und der geöffneten Palette ''Tags''.]] In diesem Beispiel beginnt das Veranstaltungsprogramm auf der Seite 3 (nach der Titelseite und einem Editorial). Neben der Werkzeugpalette am linken Bildschirmrand ist die ''Strukturansicht'' eingeblendet. Über das Menü Ansicht ⇒ Struktur ⇒ Struktur einblenden kann diese Ansicht geöffnet werden. Außerdem ist die Palette ''Tags'' eingeblendet. Diese erreicht man über das Menü Fenster ⇒ Hilfsprogramme ⇒ Tags. Beide werden wir für die nächsten Schritte benötigen.

In der Strukturansicht sieht man später die Struktur der XML-Daten. Die einzelnen Felder aus der XML-Datei sind in der Tagspalette ohne Struktur aufgeführt.

In der Tagspalette sieht man das Tag ''Root''. Dieses klickt man doppelt an oder wählt aus dem Palettenmenü den Punkt ''Tag-Optionen'' aus. Das Root-Element erhält nun den Namen des Root-Elements aus der XML-Datei. In der XML-Datei aus Kiribati heißt das Root-Element '''veranstaltungen'''. Nachdem man die Änderung mit OK bestätigt hat, ändert sich der Name ''Root'' in der Tagspalette und in der Strukturansicht in ''veranstaltungen''.

Nun klickt man das Element ''veranstaltungen'' in der Strukturansicht an und zieht es mit gedrückter Maustaste auf den oben erstellten Textrahmen. Wenn man im Menü Ansicht ⇒ Struktur ⇒ Rahmen mit Tags einblenden aktiviert, färbt sich der Textrahmen ein.

Unterhalb des Root-Elements ''veranstaltungen'' wird nun die Struktur der Daten abgebildet. Dazu werden im Textfeld Platzhalter angelegt, die dann beim Import durch die XML-Daten ersetzt werden. Es gibt dafür mehrere Wege. Ich habe mich für den hier beschriebenen entschieden.

# [[Datei:InDesign-Tags-in-der-Tagspalette.jpg|200px|thumb|right|Tags in der Tagpalette]]In der ''Tags''-Palette wird für jedes Feld ein ''Tag'' angelegt, z. B. <pre>veranstaltung, ver_titel1, ver_titel2, ver_art, ver_nummer, ver_raum, ver_strasse, ver_ort, ver_aufriss, ver_bereich1_lang, ver_www, mitwirkende, ver_ref_name, ver_ref_ausbildung, termine, ver_ter_datum, ver_ter_beginn_zeit, ver_ter_ende_zeit, gebuehren, ver_geb_betrag ...</pre>
# [[Datei:InDesign-Strukturansicht.jpg|200px|thumb|right|Strukturansicht mit den strukturierten Tags.]]Die ''Tags'' werden jetzt in der Strukturansicht der Struktur hinzugefügt. Dazu klickt man mit der rechten Maustaste auf das Elternelement (zunächst ''veranstaltungen''). Aus dem Kontextmenü wählt man Neues Element ⇒ ''veranstaltung''. Erklärung: In der XML-Datei enthält der Root-Container ''veranstaltungen'' mehrere Elemente vom Typ ''veranstaltung''. Wenn in einem späteren Schritt die XML-Datei importiert wird, werden mehrere Veranstaltungen vom Typ ''veranstaltung'' angelegt. InDesign fügt dem Textrahmen die wiederholenden Blöcke hinzu. Nun werden im Kind-Element ''veranstaltung'' weitere Elemente über das Kontextmenü ⇒ Neues Element hinzugefügt.
# [[Datei:InDesign-Textmodus-mit-Tags.jpg|200px|thumb|right|Im Textmodus von InDesign werden die Tags aus der Strukturansicht angezeigt. Diese können dort nun bearbeitet und formatiert werden.]]Die in die Strukturansicht übernommenen Tags werden auch dem Textrahmen hinzugefügt und können nun dort weiter bearbeitet werden. Dazu wählt man das Textwerkzeug in InDesign und klickt einmal in den Textrahmen. Mit der Tastenkombination STRG+y kann man den Text im Textmodus bearbeiten (alternativ kann dieser Textmodus über das Menü Bearbeiten ⇒ Im Textmodus bearbeiten aufgerufen werden). Was sollte bearbeitet werden:
#* Zeilenumbrüche nach dem jeweiligen schließenden Tag hinzufügen (im Ausklappmenü zu den Anzeigeoptionen - in der Menüleiste von InDesign das kleine Symbol mit den Linialen links und oben - können die Verborgenen Zeichen eingeblendet werden).
#* [[Datei:InDesign-Textmodus und Absatzformate.jpg|200px|thumb|right|Tags im Textmodus mit zugewiesenen Absatzformaten.]]Anschließend kann die Formatierung (Schriftart, Schriftgrad, Schriftschnitt, Abstände etc.) für jeden Absatz angepasst werden. Es können auch für einzelne Tags Zeichenformate mit einem anderen Erscheinungsbild angelegt werden.
# Wenn alles passt, sollte man sich von dieser Datei dringend eine Kopie speicher, um zu verhindern, dass bei einem Fehler die Arbeit wiederholt werden muss.
# Nun wird die Struktur in einer XML-Datei gespeichert. Dazu wählt man im Palettenmenü der Strukturansicht den Punkt XML exportieren... und speichert die XML-Datei am gewünschten Ort.
# Mit einem Hilfsprogramm (z. B. [http://xml-copy-editor.sourceforge.net/ XML Copy Editor]) erstellt man sich nun aus der gespeicherten XML-Datei eine DTD (Document Type Definition) und speichert diese ebenfalls am gewünschten Ort.
# Diese lädt man nun in InDesign über das Palettenmenü der Strukturansicht ⇒ DTD laden...

==== XML-Daten importieren ====
[[Datei:InDesign-XML-Importoptionen-Echtdaten.jpg|200px|thumb|right|Importoptionen für den XML Import in InDesign.]] Nun ist es endlich soweit und die XML-Daten können importiert werden. Aus dem Datei-Menü ⇒ '''XML importieren...'''. Es öffnet sich der Dialog zur Auswahl der XML-Datei. Diese wählt man aus dem Verzeichnis aus, in das man die Datei aus Kiribati gespeichert hat. Im unteren Bereich muss der Haken bei ''XML-Importoptionen anzeigen'' gesetzt sein. Und man sollte ''Inhalte zusammenführen'' wählen, wenn man nicht eine zweite Datei einlesen möchte. Als Importoptionen nimmt man im folgenden Fenster die Einstellungen vor, wie sie im Screenshot zu sehen sind. Nach dem Klick auf OK fließen die Veranstaltungsdaten in das erstellte Layout. Die Formatierungen der Absätze werden übernommen.

[[Datei:InDesign-Leerzeilen-entfernen.jpg|200px|thumb|right|Mit diesen Einstellungen im Suchen/Ersetzen-Dialog können Leerzeilen entfernt werden.]][[Datei:InDesign-Leerstellen-am-Zeilenanfang-entfernen.jpg|200px|thumb|right|Mit diesen Einstellungen können Leerstellen am Zeilenanfang entfernt werden.]]Unter Umständen können unschöne Leerzeilen entstehen, wenn einzelne Felder leer sind oder es sind führende Leerzeichen enthalten. Diese kann man leicht mit Bearbeiten ⇒ ''Suchen/Ersetzen...'' beseitigen. Im Suchen/Ersetzen-Dialog nimmt man die Einstellungen vor, wie im Screenshot abgebildet. Ausgewählt werden können die Einstellungen über das Dropdownfeld im oberen Teil des Fensters. Die Auswahl ''Leerstellen am Zeilenanfang ...'' muss man sich einmalig selbst erstellen: ''Mehrere Leerstellen in einzelne Leerstelle'' auswählen, vor das erste Zeichen in der Zeile ''Suchen nach'' das Zeichen <code>^</code> setzen und dann neben dem Dropdownfeld auf das Diskettensymbol klicken, einen eigenen Namen vergeben und die Abfrage speichen. Nun kann sie leicht wieder aufgerufen werden.

Jetzt folgt noch die Handarbeit: Seitenumbrüche, Layoutkorrekturen, Korrekturen, andere Texte, evtl. Bilder und Grafiken ...

== Kritik ==
Dieses Verfahren ist leicht umzusetzen und nachzubilden. Hat man sich seine InDesign-Datei eingerichtet, die Daten in Kiribati ordentlich gepflegt und ist man mit dem Ergebnis zufrieden, dann braucht man in der Tag nicht mehr.

Allerdings kann InDesign noch mehr: Mit einem [[XSLT-Stylesheet]] können die XML-Daten vor dem Import noch manipuliert werden. Dieses kann entweder direkt beim Import der XML-Daten angewandt werden (leider wird von InDesign nur die Version 1.0 unterstützt) oder man besorgt sich einen XSLT-Compiler der die Version 2.0 unterstützt. Die XML-Daten werden vor dem Import in InDesign nach den Vorgaben im XSLT-Stylesheet gefiltert, neu zusammengestellt, verknüpft, manipuliert ... Die Vorbereitung der Satzdatei und der Import funktioniert dann in etwa so, wie auf dieser Seite beschrieben oder man erstellt sich eine Datei mit den Absatz- und Zeichenformaten und weist diese schon vorab den Tags zu. Dann ist es egal, wie die XML-Datei aufgebaut ist. InDesign erstellt das Veranstaltungsprogramm anhand der Tags in der XML-Datei und weist automatisch die entsprechenden Formate zu. Damit beginnt die '''Magie''' erst richtig.

Indesign xml raebiger

2016-09-06T14:15:11Z

N.raebiger: /* XML-Daten importieren */

Indesign xml raebiger

2016-09-06T14:14:42Z

N.raebiger: /* XML-Daten importieren */

Indesign xml raebiger

2016-09-06T14:13:38Z

N.raebiger:

Datei:InDesign-Leerstellen-am-Zeilenanfang-entfernen.jpg

2016-09-06T14:12:35Z

N.raebiger: Mit diesen Einstellungen können Leerstellen am Zeilenanfang entfernt werden.

Mit diesen Einstellungen können Leerstellen am Zeilenanfang entfernt werden.

XSLT-Stylesheet

2016-09-06T13:53:38Z

N.raebiger: Die Seite wurde neu angelegt: „In diesem Abschnitt beschreibe ich die wichtigsten Befehle in einem XSLT-Stylesheet. Um sich selbst ein Stylesheet zu erstellen, ist es sinnvoll, die Struktur…“

In diesem Abschnitt beschreibe ich die wichtigsten Befehle in einem XSLT-Stylesheet. Um sich selbst ein Stylesheet zu erstellen, ist es sinnvoll, die Struktur der [[Kiribati-XML-Export |XML-Datei aus Kiribati]] zu verstehen.

== Grundgerüst des Stylesheets ==
Eingeleitet wird ein XSLT-Stylesheet durch

=== Version 1.0 ===
<pre>
<?xml version="1.0" encoding="UTF-8"?>

<xsl:stylesheet
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
version="1.0">

<xsl:output method="xml" version="1.0" encoding="UTF-8" standalone="yes" indent="yes"/>
</pre>

=== Version 2.0 ===
<pre>
<?xml version="1.0" encoding="UTF-8"?>

<xsl:stylesheet
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:fn="http://www.w3.org/2005/xpath-functions"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
version="2.0">

<xsl:output method="xml" version="1.0" encoding="UTF-8" standalone="yes" indent="yes"/>
</pre>

Der Unterschied besteht in der Versionsmitteilung <code>1.0</code> oder <code>2.0</code> und den aufgeführten Namensräumen (Namespaces xmlns:fn und xmlns:xs - diese werden von der Version 1.0 nicht zur Verfügung gestellt).

Die <code>xsl:output</code> Anweisung weist den Compiler an, eine neue XML-Datei zu erstellen.

Als nächstes wird in beiden Versionen das Template erstellt. Dies geschieht durch:

<pre>
<xsl:template match="/">
...
</xsl:template>
</pre>

Der Matchparameter gibt an, auf welches Element das Template bezogen wird <code>match="/"</code> gibt an, dass das Template für die gesamte Datei gilt.

Abgeschlossen wird das Stylesheet noch durch das schließende Tag

<pre>
</xsl:stylesheet>
</pre>

== XSLT-Befehle ==
Eine XML-Datei zeichnet sich durch einen strukturierten Inhalt aus. Die Struktur wird mit sogenannten Tags dargestellt. XML selbst steht für Extensible Markup-Language, also eine erweiterbare Beschreibung der Struktur. Ein Tag besteht aus einem öffnenden und einem schließenden Element: <code><element>INHALT</element></code>. Ist der Inhalt leer, wird das öffnende Tag als <code><element /></code> geschrieben. '''element''' ist ein freiwählbarer Text aus Buchstaben, Ziffern und dem Unterstrich.

Auch ein XSLT-Stylesheet wird durch Tags beschrieben, die wie in einer XML-Datei aufgebaut sind. Den einzelnen Befehlen wird allerdings ein Namensraum vorangestellt: '''xsl:'''. Die hier beschriebenen Tags sind eine Auswahl, die für die Verarbeitung einer XML-Datei aus Kiribati zur Vorbereitung des Imports in InDesign hilfreich sein können. Weitere Tags und detailierte Beschreibungen können leicht über eine Suchmaschine gefunden werden (z. B. [http://www.w3schools.com/xsl]). Die Anweisungen zur Verarbeitung der XML-Datei werden zwischen <code><xsl:template match="/">...</xsl:template></code> geschrieben.

=== Element erstellen ===
Möchte man ein neues Feld erstellen, teilt man dies dem Stylesheet durch das Tag <code><xsl:element name="'''Bezeichnung'''"></code> mit. Zwischen das öffnende und das schließende Tag wird dann der Inhalt gestellt. Der Inhalt kann entweder ein statischer Text sein, oder durch das Stylesheet berechnet werden.

<code><xsl:element name="Bezeichnung">Statischer Text</xsl:element></code>

; <code><xsl:element name="veranstaltungen">...</xsl:element></code>
: Damit wird ein umschließenden Tag um alle aufgeführten Veranstaltungen erstellt. Gleiches ist in der Ausgangsdatei zu finden. Dieses Tag wird als Root-Tag bezeichnet. In InDesign wird dieses Element dann in das Textfeld gezogen.

=== Mehrere gleiche Elemente behandeln ===
In der Ausgangsdatei sind die Daten der einzelnen Veranstaltungen jeweils zwischen <code><veranstaltung>...</veranstaltung></code> enthalten. Die einzelnen Veranstaltungen müssen nun auch einzeln behandelt werden. In einem XSLT-Stylesheet wird dies in einer '''fore-each'''-Schleife erledigt (für alle Elemente eines Pfades - in unserem Fall veranstaltungen/veranstaltung).

<code><xsl:fore-each select="Pfad">...</xsl:fore-each></code>

; <code><xsl:fore-each select"veranstaltungen/veranstaltung">...</xsl:fore-each></code>
: Durch diese Anweisung wird die Schleife so oft durchlaufen, bis alle Veranstaltungen in der XML-Datei bearbeitet wurden.
'''Anmerkung''': Innerhalb der Schleife muss dann noch ein <code><xsl:element name="veranstaltung">...</xsl:element></code> aufgenommen werden, damit in der Ausgabedatei jede Veranstaltung auch wieder in einem eigenen Pfad enthalten ist.

=== Element aus der Ausgangsdatei kopieren ===
Möchte man ein Element komplett übernehmen, kann man dies ganz einfach durch die Anweisung <code><xsl:copy-of select="Bezeichnung" /></code> erledigen. Damit wird das Element inklusive der umschließenden Tags in die Ausgabedatei kopiert.

; <code><xsl:copy-of select="ver_titel1" /></code>
: Kopiert das Feld <code>ver_titel1</code> in die Ausgabedatei.

=== Nur den Wert eines Elements übernehmen ===
Im Gegensatz zu <code>copy-of</code> kann man mit <code>value-of</code> auf den Wert eines Elements zugreifen. Dadurch kann man z. B. mehrere Elemente zusammenfassen, den Wert in einer Variablen zwischenspeichern oder mit Funktionen (Version 2.0) bearbeiten. Der Wert wird ohne die umschließenden Tags übernommen.

<code><xsl:value-of select="Bezeichnung" /></code>

; <code><xsl:element name="art_nummer"><xsl:value-of select="ver_art" /> - <xsl:value-of select="ver_nummer" /></xsl:element></code>
: Durch diesen Anweisungsblock wird ein neues Element in der Ausgabedatei mit dem Namen <code>art_nummer</code> erstellt. Die Werte der Felder <code>ver_art</code> und <code>ver_nummer</code> werden ausgelesen und zwischen das neue umschließende Element geschrieben. Zwischen den beiden Werten wird ein Gedankenstrich platziert.

=== Bedingte Ausführung von Anweisungen ===
Damit Elemente in der Ausgabedatei in Abhängigkeit von bestimmten Werten in der Ausgangsdatei erstellt werden, kann mit Bedingungen gearbeitet werden. XSLT kennt zwei unterschiedliche Anweisungen für eine bedingte Ausführung.

==== einfache Bedingung ====
Die einfache Bedingung kennt nur einen Zweig, der ausgeführt wird, wenn ein Test positiv ist: <code><xsl:if test="'''Bedingung'''">...</xsl:if></code>. '''Bedingung''' steht dabei für einen logischen Ausdruck, z. B. einen Vergleich. Damit zwei Werte verglichen werden können, benötigt man unterschiedliche [http://www.w3schools.com/xsl/xpath_operators.asp Operatoren].

; <code><xsl:if test="ver_titel2 != <nowiki>''</nowiki>"><xsl:copy-of select="ver_titel2" /></xsl:if></code>
: Hier wird geprüft, ob <code>ver_titel2</code> nicht leer ist. Wenn also ein Text enthalten ist, wir dieser in die Ausgabedatei kopiert.

XSLT kennt keine <code>else</code>-Anweisung. Man kann dies aber durch eine Fallunterscheidung umgehen.

==== Fallunterscheidungen - mehrere Bedingungen ====
Es ist auch möglich eine komplexere Fallunterscheidung aufzubauen, die dann zu verschiedenen Bedingungen jeweils andere Ergebnisse liefert. Anders als bei <code><xsl:if>...</xsl:if></code> gibt es bei der Fallunterscheidung die Möglichkeit einen Anweisungsblock aufzurufen, wenn keiner der vorangegangenen Fälle zutrifft. So lässt sich auch ein <code>else</code>-Block aufbauen.

<pre>
<xsl:choose>
<xsl:when test="Bedingung_1">...</xsl:when>
<xsl:when test="Bedingung_2">...</xsl:when>
...
<xsl:when test="Bedingung_n">...</xsl:when>
<xsl:otherwise>...<xsl:otherwise>
</xsl:choose>
</pre>

Mit <code><xsl:choose>...</xsl:choose></code> wird ein Block mit einer Fallunterscheidung aufgebaut. Die einzelnen Bedingungen werden mit <code><xsl:when test="Bedingung_x">...</xsl:when></code> aufgebaut. Trifft keine der Bedingungen zu, wird der Block <code><xsl:otherwise>...</xsl:otherwise></code> ausgeführt.

<pre>
<xsl:choose>
<xsl:when test="ver_titel2 != <nowiki>''</nowiki>"><xsl:copy-of select="ver_titel2" /></xsl:when>
<xsl:when test="ver_beschreibung_2" != <nowiki>''</nowiki>"><xsl:element name="ver_titel2"><xsl:value-of select="ver_beschreibung_2" /></xsl:element></xsl:when>
</xsl:choose>
</pre>
: Hier wird zunächst geprüft, ob <code>ver_titel2</code> einen Wert enthält. Ist dies der Fall, wird eine Kopie von <code>ver_titel2</code> erstellt. Falls <code>ver_titel2</code> leer ist, wird die nächste Bedingung überprüft. Ist in dieser <code>ver_beschreibung_2</code> nicht leer, wird ein Element mit dem Namen <code>ver_titel2</code> erzeugt und der Wert aus <code>ver_beschreibung_2</code> in das neue Element geschrieben. Sind beide Felder leer, erhält die Ausgabedatei für diese Veranstaltung auch keinen <code>ver_titel2</code>. Für InDesign ist dies wichtig, würde ein leerer <code>ver_titel2</code> in der Ausgabedatei stehen, würde InDesign auch für ein leeres Feld einen Platzhalter einbauen.

=== Arbeiten mit Variablen ===
Manchmal ist es sinnvoll Werte zwischenzuspeichern und diese dann an unterschiedlichen Stellen wieder aufzurufen. Mit <code><xsl:variable name="'''Bezeichner'''">...</xsl:variable></code> ist dies möglich. Der Name der Variablen wird mit '''Bezeichner''' festgelegt. Im Anweisungsblock zwischen den umschließenden Tags wird dann der Inhalt der Variablen aufgebaut.

; <code><xsl:variable name="tab"><xsl:text>	</xsl:text></xsl:variable></code>
: Damit wir eine Variable <code>tab</code> angelegt. Der Inhalt ist ein Textelement, dessen Inhalt ein Tabulatorzeichen ist. Auf diese Variable kann dann mit <code><xsl:value-of select="$tab" /></code> zugegriffen werden. Eine praktische Anwendung davon ist die Kombination mehrerer Felder in einem neuen Ausgabefeld. Die Inhalte der Eingabefelder wird dann durch ein Tabulator getrennt. In InDesign stellt man dann die Tabulatoren in den Absatzformaten entsprechend ein.

=== Funktionen zur Verarbeitung von Feldern (Version 2.0) ===
Möchte man die Inhalte von Feldern noch weiter verändern, benötigt man einen Compiler, der die Version 2.0 von XSLT unterstützt. Hier sind nur wenige Funktionen beschrieben, mit denen man den Text verändern kann. Eine detailierte Beschreibungen der Funktionen findet sich unter http://www.xsltfunctions.com/.

==== fn:replace(''string'', ''pattern'', ''replace'') ====
Mit dieser Funktion kann der Inhalt eines Feldes verändert werden.

; <code><xsl:value-of select="fn:replace(fn:replace(ver_geb_betrag, '\.', ','), ',00', '')" /></xsl:element><xsl:text> Euro</xsl:text></code>
: Mit diesem Ausdruck werden im Feld <code>ver_geb_betrag</code> Punkte durch Kommas ersetzt und Nachkommastellen gelöscht, wenn sie <code>,00</code> sind. Und hinten wird noch ''Euro'' angehängt.

<pre>
<xsl:variable name="termine"><xsl:value-of select="ver_termine"/></xsl:variable>
<xsl:variable name="newline"><xsl:text>
</xsl:text></xsl:variable>
<xsl:variable name="delimiter">[<xsl:value-of select="ver_delimiter"/>]</xsl:variable>
<xsl:element name="termine"><xsl:value-of select="fn:replace(fn:replace($termine, $delimiter, $newline), ' von', ',')"/></xsl:element>
</pre>
: In der Variablen <code>termine</code> wird der Wert aus <code>ver_termine</code> zwischengespeichert. Die Variable <code>newline</code> erhält ein Textelment, dessen Inhalt ein Zeilenumbruch ist. Das Trennzeichen aus Kiribati wird in der Variablen <code>delimiter</code> gespeichert. Die Zeichen <code>[...]</code> sind notwendig, da das Trennzeichen in Kiribati der senkrechte Strich '|' ist. In XSLT bezeichnet dieser jedoch eine Schnittmenge. Würde man die Klammern nicht setzen, bricht der Compiler mit einer Fehlermeldung ab. Anschließend werden die Trennzeichen durch das Zeichen ''neue Zeile'' mithilfe von <code>fn:replace($termine, $delimiter, $newline)</code> ersetzt. Außerdem wird, ebenfalls mit einer <code>fn:replace</code>-Anweisung, ''von'' durch ein Komma ersetzt.

== XML-Daten filtern und aufbereiten ==
=== Version 1.0 ===
==== XML-Datei und Stylesheet Version 1.0 direkt in InDesign importieren ====
==== XML-Datei mit einem Compiler bearbeiten ====

=== Stylesheet Version 2.0 mit Saxon kompilieren ===

== Weiterführende Links ==
* Einführung in XSLT http://www.w3schools.com/xsl/
* XSLT-Funktionen http://www.xsltfunctions.com/ (Version 2.0)
* [https://www.data2type.de/xml-xslt-xslfo/xslt/ XSLT-Referenz]
* [https://www.data2type.de/xml-xslt-xslfo/xpath/ XPath-Einführung]
* [https://www.data2type.de/en/xml-xslt-xslfo/xslt/xslt-xpath-function-reference/ XSLT- und XPath Funktionsreferenz]
* Saxon
* XML-Editor

* http://www.java2s.com/Tutorial/XML/0100__XSLT-stylesheet/countTakesanodesetargumentandreturnsavalueequaltothenumberofnodesinthenodeset.htm
* http://www.fh-wedel.de/~si/seminare/ss01/Ausarbeitung/5.xslt/xslt6.htm
* http://www.w3schools.com/xsl/el_preserve-space.asp
* http://www.w3schools.com/xsl/xsl_w3celementref.asp
* http://www.w3schools.com/xsl/el_decimal-format.asp
* *http://www.w3schools.com/xsl/el_text.asp

Kiribati-XML-Export

2016-09-06T13:53:01Z

N.raebiger: Die Seite wurde neu angelegt: „Im folgenden Abschnitt ist die Struktur einer von Kiribati exportierten XML-Datei zu sehen. Zwischen den ''Tags'' steht eine kurze Erklärung zu den Tags. '''v…“

Im folgenden Abschnitt ist die Struktur einer von Kiribati exportierten XML-Datei zu sehen. Zwischen den ''Tags'' steht eine kurze Erklärung zu den Tags. '''veranstaltungen''' bildet die Klammer um alle exportierten Veranstaltungen. Jede einzelne Veranstaltung ist im Tag '''veranstaltung''' aufgeführt. Unter veranstaltung gibt weitere "Klammern": '''termine''', '''mitwirkende''', '''gebuehren''', '''kategorien'''. Diese Informationen stammen aus weiteren in Kiribati verknüpften Tabellen. Mit einem [[XSLT-Stylesheet]] kann man die strukturierten Informationen in eine XML-Datei für die Verwendung in InDesign kopieren, neu zusammenstellen, anders sortieren oder weiter bearbeiten.

<pre>
<?xml version = "1.0" encoding="utf-8" standalone="yes"?>
<veranstaltungen>

<veranstaltung>
<ver_guid>wird intern von Kiribati verwendet</ver_guid>
<ver_record>wird intern von Kiribati verwendet</ver_record>
<ver_nummer>Veranstaltungsnummer aus Kiribati - ggf. ID aus den Evangelischen Terminen</ver_nummer>
<ver_art>Veranstaltungsart</ver_art>
<ver_form>Veranstaltungsform (E|R|B)</ver_form>
<ver_programm>Programm in Kiribati</ver_programm>
<ver_titel1>Titel 1. Zeile</ver_titel1>
<ver_titel2>Titel 2. Zeile</ver_titel2>
<ver_titel3>Titel 3. Zeile</ver_titel3>
<ver_aufriss>Aufriss</ver_aufriss>
<ver_abriss>Abriss</ver_abriss>
<ver_reihe_titel1>Reihentitel</ver_reihe_titel1>
<ver_reihe_record>0</ver_reihe_record>
<ver_themen_record>0</ver_themen_record>
<ver_beschreibung>Beschreibung</ver_beschreibung>
<ver_beschreibung_html/>
<ver_beschreibung_kurz>Alternativer Beschreibungstext (Internet -> Alternative Internetdarstellung)</ver_beschreibung_kurz>
<ver_beschreibung_2>Kurzbeschreibung aus den Evangelischen Terminen</ver_beschreibung_2>
<ver_beschreibung_2_html/>
<ver_beschreibung_2_caption>Bezeichnung "Kurzbeschreibung" aus den Evangelischen Terminen</ver_beschreibung_2_caption>
<ver_beschreibung_3>Ansprechpartner aus den Evangelischen Terminen</ver_beschreibung_3>
<ver_beschreibung_3_html/>
<ver_beschreibung_3_caption>Bezeichnung "Ansprechpartner" aus den Evangelischen Terminen</ver_beschreibung_3_caption>
<ver_beschreibung_4>Referentenliste aus den Evangelischen Terminen</ver_beschreibung_4>
<ver_beschreibung_4_html/>
<ver_beschreibung_4_caption>Bezeichnung "ReferentInnen" aus den Evangelischen Terminen</ver_beschreibung_4_caption>
<ver_beschreibung_5>Art der Veröffentlichung aus den Evangelischen Terminen</ver_beschreibung_5>
<ver_beschreibung_5_html/>
<ver_beschreibung_5_caption>Bezeichnung "Veröffentlicht" aus den Evangelischen Terminen</ver_beschreibung_5_caption>
<ver_beschreibung_6/>
<ver_beschreibung_6_html/>
<ver_beschreibung_6_caption/>
<ver_bereich1>Bereich I</ver_bereich1>
<ver_bereich1_lang>Bereich I - ausführlicher Text</ver_bereich1_lang>
<ver_kooperation>Kooperation</ver_kooperation>
<ver_bereich2>Bereich II</ver_bereich2>
<ver_bereich2_lang>Bereich II - ausführlicher Text</ver_bereich2_lang>
<ver_int_highlight>Highlight-Markierung (Internet -> Highlight)</ver_int_highlight>
<ver_int_anmeldelink>Anmeldelink (Internet -> Anmeldelink)</ver_int_anmeldelink>
<ver_email_bestaetigung>Bestätigung (0|1)</ver_email_bestaetigung>
<ver_treffen>Anzahl der Treffen</ver_treffen>
<ver_beginn_datum>Beginndatum (YYYY-MM-DDT00:00:00)</ver_beginn_datum>
<ver_ende_datum>Endedatum(YYYY-MM-DDT00:00:00)</ver_ende_datum>
<ver_beginn_zeit1>Beginn Zeit 1 (HH:mm)</ver_beginn_zeit1>
<ver_beginn_zeit2>Beginn Zeit 2 (HH:mm)</ver_beginn_zeit2>
<ver_ende_zeit1>Ende Zeit 1 (HH:mm)</ver_ende_zeit1>
<ver_ende_zeit2>Ende Zeit 2 (HH:mm)</ver_ende_zeit2>
<ver_abgesagt>Abgesagt (0|1)</ver_abgesagt>
<ver_deleted>Gelöscht (0|1)</ver_deleted>
<ver_gesperrt>Gesperrt (0|1)</ver_gesperrt>
<ver_punkte/>
<ver_anmeldestelle>Anmeldung -> Anmeldestelle</ver_anmeldestelle>
<ver_tn_maximal>Teilnehmeranzahl max. (Gebühren -> Maximal)</ver_tn_maximal>
<ver_tn_belegt>Teilnehmeranzahl belegt</ver_tn_belegt>
<ver_tn_minimal>Teilnehmeranzahl min. (Gebühren -> Minimal)</ver_tn_minimal>
<ver_tn_frei>frei Teilnehmerplätze</ver_tn_frei>
<ver_tn_warteliste>Anzahl Teilnehmer auf Warteliste</ver_tn_warteliste>
<ver_tn_schwellwert>Schwellwert (Gebühren -> Schwellwert)</ver_tn_schwellwert>
<ver_fachbereich>Stoffgebiet</ver_fachbereich>
<ver_raum>Veranstaltungsort</ver_raum>
<ver_raum_record>wird intern von Kiribati verwendet</ver_raum_record>
<ver_raum_bezeichnung>Bezeichnung des Veranstaltungsorts (Auswahlliste)</ver_raum_bezeichnung>
<ver_adresse>Adresse -> Adresse</ver_adresse>
<ver_strasse>Adresse -> Straße</ver_strasse>
<ver_plz>Adresse -> PLZ</ver_plz>
<ver_ort>Adresse -> Ort</ver_ort>
<ver_lkz>Adresse -> Lkz-Land</ver_lkz>
<ver_ansprechpartner/>
<ver_telefon1>Adresse -> Telefon I</ver_telefon1>
<ver_telefon2>Adresse -> Telefon II</ver_telefon2>
<ver_mobil>Adresse -> Mobil</ver_mobil>
<ver_www>Adresse -> WWW</ver_www>
<ver_email>Adresse -> E-Mail I</ver_email>
<ver_stichwoerter>Sonstiges -> Stichwörter</ver_stichwoerter>
<ver_diverses>Sostiges -> Frei 1</ver_diverses>
<ver_diverses_2>Sonstiges -> Frei 2</ver_diverses_2>
<ver_anzahlung>Gebühren -> Anzahlung</ver_anzahlung>
<ver_delimiter>Trennzeichen für diverse Felder</ver_delimiter>
<ver_gebuehren_zusatztext>Gebühren -> Zusatztext (oben)</ver_gebuehren_zusatztext>
<ver_gebuehren_zusatztext_html/>
<ver_termine>Liste der Termine (wird von Kiribati erstellt - Trennzeichen ver_delimiter)</ver_termine>
<ver_termine_kurz>Liste der Termine (wird von Kiribati erstellt - Trennzeichen ver_delimiter)</ver_termine_kurz>
<ver_termine_zusatztext>Zusatztext (Termine -> Zusatztext)</ver_termine_zusatztext>
<ver_termine_zusatztext_html/>
<ver_erstmalig>0</ver_erstmalig>
<ver_anmeldung>Anmeldetyp (Internet -> Anmeldetyp)</ver_anmeldung>
<ver_quelle>0</ver_quelle>
<ver_mandant>1</ver_mandant>
<ver_zahlungsweisen>Zahlungsweisen (Internet -> Zahlungsweisen)</ver_zahlungsweisen>
<ver_zahlungsweise_prio>Zahlungsweisen (Priorisierung)</ver_zahlungsweise_prio>
<ver_permanent>Internet -> Permanente Veranstaltung (0|1)</ver_permanent>
<ver_folgetermine>Internet -> Folgetermine selektierbar (0|1)</ver_folgetermine>
<ver_bearbeitet_am>Datansatz wurde zuletzt an diesem Datum bearbeitet</ver_bearbeitet_am>
<ver_bereich1_kennziffer_aussenstelle>01</ver_bereich1_kennziffer_aussenstelle>
<ver_fachbereich_lang>Stoffgebiet Beschreibung</ver_fachbereich_lang>
<kategorien>
<ver_record>12457</ver_record>
<ver_kat_record>39</ver_kat_record>
<ver_kat_kurz>300</ver_kat_kurz>
<ver_kat_lang>Gesellschaft - eine Welt</ver_kat_lang>
</kategorien>
<mitwirkende>
<ver_record>vgl. ver_record -> veranstaltungen/veranstaltung</ver_record>
<ver_ref_record>wird intern von Kiribati verwendet</ver_ref_record>
<ver_ref_funktion>Dozenten -> Funktion</ver_ref_funktion>
<ver_ref_name>Dozenten -> DozentIn</ver_ref_name>
<ver_ref_ort>Dozenten -> Ort</ver_ref_ort>
<ver_ref_ausbildung>Dozenten -> Ausbildungsdaten</ver_ref_ausbildung>
<ver_ref_beruf>Dozenten -> Beruf</ver_ref_beruf>
<ver_ref_bild>ist belegt, wenn ein Bild beim Referenten hinterlegt wurde</ver_ref_bild>
<ver_ref_bild_ext>(Dateierweiterung) ist belegt, wenn ein Bild beim Referenten hinterlegt wurde</ver_ref_bild_ext>
<ver_ref_adresse_record>Adresse des Referenten</ver_ref_adresse_record>
</mitwirkende>
<termine>
<ver_record>vgl. ver_record -> veranstaltungen/veranstaltung</ver_record>
<ver_ter_record>wird intern von Kiribati verwendet</ver_ter_record>
<ver_ter_datum>Datum (YYYY-MM-DD)</ver_ter_datum>
<ver_ter_titel>Titel der einzelnen Veranstaltung (bei mehreren Terminen - vgl. Termine)</ver_ter_titel>
<ver_ter_beginn_zeit>HH:mm</ver_ter_beginn_zeit>
<ver_ter_ende_zeit>HH:mm</ver_ter_ende_zeit>
<ver_ter_raum>Veranstaltungsort (bei wechselnden Orten einer Reihe)</ver_ter_raum>
<ver_ter_raum_record>0</ver_ter_raum_record>
<ver_ter_raum_bezeichnung>Bezeichnung des Veranstaltungsorts (Auswahlliste - bei wechselnden Orten einer Reihe)</ver_ter_raum_bezeichnung>
</termine>
<gebuehren>
<ver_record>vgl. ver_record -> veranstaltungen/veranstaltung</ver_record>
<ver_geb_record>wird intern von Kiribati verwendet</ver_geb_record>
<ver_geb_bezeichnung>Bezeichnung der Gebühr</ver_geb_bezeichnung>
<ver_geb_gruppe>1</ver_geb_gruppe>
<ver_geb_gruppe_text/>
<ver_geb_betrag>Betrag</ver_geb_betrag>
<ver_geb_zimmertyp/>
<ver_geb_ermaessigt>ermäßigter Betrag (0|1)</ver_geb_ermaessigt>
<ver_geb_pflicht>0</ver_geb_pflicht>
<ver_geb_standard>1</ver_geb_standard>
<ver_geb_aktionspreis_von/>
<ver_geb_aktionspreis_bis/>
</gebuehren>
</veranstaltung>
</veranstaltungen>
</pre>

Datei:InDesign-Leerzeilen-entfernen.jpg

2016-09-06T13:51:30Z

N.raebiger: N.raebiger lud eine neue Version von „Datei:InDesign-Leerzeilen-entfernen.jpg“ hoch

Mit diesen Einstellungen im Suchen/Ersetzen-Dialog können Leerzeilen entfernt werden.

Datei:InDesign-Leerzeilen-entfernen.jpg

2016-09-06T13:50:46Z

N.raebiger: N.raebiger lud eine neue Version von „Datei:InDesign-Leerzeilen-entfernen.jpg“ hoch

Mit diesen Einstellungen im Suchen/Ersetzen-Dialog können Leerzeilen entfernt werden.

Datei:InDesign-Leerzeilen-entfernen.jpg

2016-09-06T13:46:37Z

N.raebiger: Mit diesen Einstellungen im Suchen/Ersetzen-Dialog können Leerzeilen entfernt werden.

Mit diesen Einstellungen im Suchen/Ersetzen-Dialog können Leerzeilen entfernt werden.

Datei:InDesign-XML-Importoptionen-Echtdaten.jpg

2016-09-06T13:46:00Z

N.raebiger: Importoptionen für den XML Import in InDesign.

Importoptionen für den XML Import in InDesign.

Datei:InDesign-Textmodus und Absatzformate.jpg

2016-09-06T13:45:13Z

N.raebiger: Ansicht der Tags im Textmodus mit den zugewiesenen Absatzformaten

Ansicht der Tags im Textmodus mit den zugewiesenen Absatzformaten

Datei:InDesign-Textmodus-mit-Tags.jpg

2016-09-06T13:44:30Z

N.raebiger: Textmodus zum Bearbeiten der Formatierung.

Textmodus zum Bearbeiten der Formatierung.

Datei:InDesign-Strukturansicht.jpg

2016-09-06T13:43:50Z

N.raebiger: Strukturansicht mit strukturierten Tags aus der Tagspallette

Strukturansicht mit strukturierten Tags aus der Tagspallette

Datei:InDesign-Tags-in-der-Tagspalette.jpg

2016-09-06T13:43:11Z

N.raebiger: Die in der Tagspalette angelegten Tags. Diese müssen, nachdem sie angelegt wurden, in der Strukturansicht hinzugefügt werden.

Die in der Tagspalette angelegten Tags. Diese müssen, nachdem sie angelegt wurden, in der Strukturansicht hinzugefügt werden.

Datei:InDesign-leere-Satzdatei.jpg

2016-09-06T13:42:10Z

N.raebiger: Screenshot einer leeren Satzdatei in InDesign mit geöffneter Strukturansicht und der geöffneten Palette ''Tags''.

Screenshot einer leeren Satzdatei in InDesign mit geöffneter Strukturansicht und der geöffneten Palette ''Tags''.

Indesign xml raebiger

2016-09-06T13:40:28Z

N.raebiger: Die Seite wurde neu angelegt: „== Beschreibung eines möglichen Workflows == Die vorbereitenden Schritte müssen nur bei der Erstellung des Templates durchgeführt werden. Hat man sich alles…“

== Beschreibung eines möglichen Workflows ==
Die vorbereitenden Schritte müssen nur bei der Erstellung des Templates durchgeführt werden. Hat man sich alles eingerichtet, muss man nur doch die Veranstaltungen in Kiribati exportieren und dann die Verknüpfung der XML-Datei in InDesign ändern oder die XML-Datei importieren.

=== Testdaten in Kiribati anlegen und exportieren ===
Die Testdaten sollten alle gewünschten Informationen enthalten, damit später in InDesign die einzelnen Felder (in InDesign ''Tags'' genannt) enthalten sind. Es empiehlt sich eine Veranstaltung mit mehreren Terminen, ReferentInnen (Mitwirkende), einem Stoffgebiet und Gebühren anzulegen. Damit werden alle Elemente beim Export erzeugt ([[Kiribati-XML-Export|Beispiel der XML-Datei mit Beschreibungen]]). Außerdem sollte man sich jetzt darüber Gedanken machen, welche Informationen später im Programmheft erscheinen sollen. Möchte man z. B. nur eine kurze Beschreibung drucken, ist es u. U. nicht sinnvoll dafür das Feld ''Beschreibung'' zu verwenden, da dieses z. B. durch einen Import von Veranstaltungen aus den Evangelischen Terminen bei einem erneuten Import überschrieben wird. Die Felder ''Aufriss/Abriss'' in Kiribati sind z. B. gut für eine Kurzbeschreibung.

Ggf. ist es auch sinnvoll, ein Kontrollkästchen in Kiribati festzulegen, über das bei der Abfrage der Veranstaltungen gesteuert werden kann, ob eine Veranstaltung im Programmheft aufgenommen werden soll oder nicht (z. B. Kontrollkästchen ''publizieren'').

==== Export vorbereiten ====
Auch für den Export der Daten ist es sinnvoll, vorher festzulegen, wie die Daten abgefragt und sortiert sein müssen. Evtl. muss dafür eine neue Definition für die Abfrage und Sortierung erstellt werden. Dazu müssen Sie in Kiribati als ADMIN angemeldet sein und in der rechten Menüleiste den Punkt Datenbank ⇒ Abfragen ⇒ Veranstaltungen wählen. Aus der Liste können Sie sich eine Vorlage heraussuchen, mit F7 duplizieren und das Duplikat dann mit einem Doppelklick bearbeiten.

==== Konfiguration für den Datenexport ====
In der Datei <code>kubos.ini</code> im Kiribati-Installationsverzeichnis findet sich der Abschnitt [InDesign]. Den Wert von <code>XML_verschachtelt</code> sollte man auf 1 setzen. Dadurch erreicht man, dass Kiribati beim Export die Datensätze aus den einzelnen Datenbanktabellen so verschachtelt, dass diese gut von InDesign oder durch ein [[XSLT-Stylesheet]] (vor der Verarbeitung in InDesign) verarbeitet werden können.
<pre>
[InDesign]
XML_verschachtelt=1
XML_Schema=0
</pre>

==== Veranstaltungsdaten exportieren ====
Kiribati kennt schon den Export für InDesign. Um die Daten zu exportieren, startet man das Modul ''Veranstaltungen'' und wählt dann aus dem Datei-Menü den Punkt ''Varianten von Liste, Etikette, Word.Dokumenten, Serienemails ...'' oder das Icon ''Sendungen''. Als Dokumenttyp wählt man ''Adobe InDesign XML'', wählt die gewünschte Abfrage und Sortierung aus und erhält im Anschluss eine Liste mit den ausgewählten und sortierten Veranstaltungen. Durch fertigstellen werden die XML-Daten erzeugt. Diese öffnet man dann in einem Editor und speichert die Datei im gewünschten Verzeichnis.

=== Satzdatei in InDesign erstellen, Testdaten importieren und die Satzdatei gestalten ===
==== Satzdatei in InDesign einrichten ====
In InDesign erstellt man nun eine leere Satzdatei, die aber schon das Format bekommt, das man später an die Druckerei übermittelt (z. B. DL 105x210 mm, 16 Seiten, Doppelseite, Anschnitt umlaufend 2 mm). Nach dem Anlegen der Satzdatei erstellt man auf der Seite, auf der das eigentliche Programm erscheinen soll ein leeres Textfeld, das so groß sein soll, wie der zur Verfügung stehende Platz.

[[Datei:InDesign-leere-Satzdatei.jpg|200px|thumb|right|Screenshot einer leeren Satzdatei in InDesign mit geöffneter Strukturansicht und der geöffneten Palette ''Tags''.]] In diesem Beispiel beginnt das Veranstaltungsprogramm auf der Seite 3 (nach der Titelseite und einem Editorial). Neben der Werkzeugpalette am linken Bildschirmrand ist die ''Strukturansicht'' eingeblendet. Über das Menü Ansicht ⇒ Struktur ⇒ Struktur einblenden kann diese Ansicht geöffnet werden. Außerdem ist die Palette ''Tags'' eingeblendet. Diese erreicht man über das Menü Fenster ⇒ Hilfsprogramme ⇒ Tags. Beide werden wir für die nächsten Schritte benötigen.

In der Strukturansicht sieht man später die Struktur der XML-Daten. Die einzelnen Felder aus der XML-Datei sind in der Tagspalette ohne Struktur aufgeführt.

In der Tagspalette sieht man das Tag ''Root''. Dieses klickt man doppelt an oder wählt aus dem Palettenmenü den Punkt ''Tag-Optionen'' aus. Das Root-Element erhält nun den Namen des Root-Elements aus der XML-Datei. In der XML-Datei aus Kiribati heißt das Root-Element '''veranstaltungen'''. Nachdem man die Änderung mit OK bestätigt hat, ändert sich der Name ''Root'' in der Tagspalette und in der Strukturansicht in ''veranstaltungen''.

Nun klickt man das Element ''veranstaltungen'' in der Strukturansicht an und zieht es mit gedrückter Maustaste auf den oben erstellten Textrahmen. Wenn man im Menü Ansicht ⇒ Struktur ⇒ Rahmen mit Tags einblenden aktiviert, färbt sich der Textrahmen ein.

Unterhalb des Root-Elements ''veranstaltungen'' wird nun die Struktur der Daten abgebildet. Dazu werden im Textfeld Platzhalter angelegt, die dann beim Import durch die XML-Daten ersetzt werden. Es gibt dafür mehrere Wege. Ich habe mich für den hier beschriebenen entschieden.

# [[Datei:InDesign-Tags-in-der-Tagspalette.jpg|200px|thumb|right|Tags in der Tagpalette]]In der ''Tags''-Palette wird für jedes Feld ein ''Tag'' angelegt, z. B. <pre>veranstaltung, ver_titel1, ver_titel2, ver_art, ver_nummer, ver_raum, ver_strasse, ver_ort, ver_aufriss, ver_bereich1_lang, ver_www, mitwirkende, ver_ref_name, ver_ref_ausbildung, termine, ver_ter_datum, ver_ter_beginn_zeit, ver_ter_ende_zeit, gebuehren, ver_geb_betrag ...</pre>
# [[Datei:InDesign-Strukturansicht.jpg|200px|thumb|right|Strukturansicht mit den strukturierten Tags.]]Die ''Tags'' werden jetzt in der Strukturansicht der Struktur hinzugefügt. Dazu klickt man mit der rechten Maustaste auf das Elternelement (zunächst ''veranstaltungen''). Aus dem Kontextmenü wählt man Neues Element ⇒ ''veranstaltung''. Erklärung: In der XML-Datei enthält der Root-Container ''veranstaltungen'' mehrere Elemente vom Typ ''veranstaltung''. Wenn in einem späteren Schritt die XML-Datei importiert wird, werden mehrere Veranstaltungen vom Typ ''veranstaltung'' angelegt. InDesign fügt dem Textrahmen die wiederholenden Blöcke hinzu. Nun werden im Kind-Element ''veranstaltung'' weitere Elemente über das Kontextmenü ⇒ Neues Element hinzugefügt.
# [[Datei:InDesign-Textmodus-mit-Tags.jpg|200px|thumb|right|Im Textmodus von InDesign werden die Tags aus der Strukturansicht angezeigt. Diese können dort nun bearbeitet und formatiert werden.]]Die in die Strukturansicht übernommenen Tags werden auch dem Textrahmen hinzugefügt und können nun dort weiter bearbeitet werden. Dazu wählt man das Textwerkzeug in InDesign und klickt einmal in den Textrahmen. Mit der Tastenkombination STRG+y kann man den Text im Textmodus bearbeiten (alternativ kann dieser Textmodus über das Menü Bearbeiten ⇒ Im Textmodus bearbeiten aufgerufen werden). Was sollte bearbeitet werden:
#* Zeilenumbrüche nach dem jeweiligen schließenden Tag hinzufügen (im Ausklappmenü zu den Anzeigeoptionen - in der Menüleiste von InDesign das kleine Symbol mit den Linialen links und oben - können die Verborgenen Zeichen eingeblendet werden).
#* [[Datei:InDesign-Textmodus und Absatzformate.jpg|200px|thumb|right|Tags im Textmodus mit zugewiesenen Absatzformaten.]]Anschließend kann die Formatierung (Schriftart, Schriftgrad, Schriftschnitt, Abstände etc.) für jeden Absatz angepasst werden. Es können auch für einzelne Tags Zeichenformate mit einem anderen Erscheinungsbild angelegt werden.
# Wenn alles passt, sollte man sich von dieser Datei dringend eine Kopie speicher, um zu verhindern, dass bei einem Fehler die Arbeit wiederholt werden muss.
# Nun wird die Struktur in einer XML-Datei gespeichert. Dazu wählt man im Palettenmenü der Strukturansicht den Punkt XML exportieren... und speichert die XML-Datei am gewünschten Ort.
# Mit einem Hilfsprogramm (z. B. [http://xml-copy-editor.sourceforge.net/ XML Copy Editor]) erstellt man sich nun aus der gespeicherten XML-Datei eine DTD (Document Type Definition) und speichert diese ebenfalls am gewünschten Ort.
# Diese lädt man nun in InDesign über das Palettenmenü der Strukturansicht ⇒ DTD laden...

==== XML-Daten importieren ====
[[Datei:InDesign-XML-Importoptionen-Echtdaten.jpg|200px|thumb|right|Importoptionen für den XML Import in InDesign.]] Nun ist es endlich soweit und die XML-Daten können importiert werden. Aus dem Datei-Menü ⇒ '''XML importieren...'''. Es öffnet sich der Dialog zur Auswahl der XML-Datei. Diese wählt man aus dem Verzeichnis aus, in das man die Datei aus Kiribati gespeichert hat. Im unteren Bereich muss der Haken bei ''XML-Importoptionen anzeigen'' gesetzt sein. Und man sollte ''Inhalte zusammenführen'' wählen, wenn man nicht eine zweite Datei einlesen möchte. Als Importoptionen nimmt man im folgenden Fenster die Einstellungen vor, wie sie im Screenshot zu sehen sind. Nach dem Klick auf OK fließen die Veranstaltungsdaten in das erstellte Layout. Die Formatierungen der Absätze werden übernommen.

[[Datei:InDesign-Leerzeilen-entfernen.jpg|200px|thumb|right|Mit diesen Einstellungen im Suchen/Ersetzen-Dialog können Leerzeilen entfernt werden.]]Unter Umständen können unschöne Leerzeilen entstehen, wenn einzelne Felder leer sind. Diese kann man leicht mit Bearbeiten ⇒ ''Suchen/Ersetzen...'' beseitigen. Im Suchen/Ersetzen-Dialog sucht man nach <code>^b^b</code> und ersetzt diese durch ein einfachen <code>^b</code>. Die beiden Zeichen stehen für Umbruchzeichen ⇒ Standardzeilenumbruch (zu finden über das @-Symbol rechts neben den Eingabefeldern. Siehe dazu auch den Screenshot.

Jetzt folgt noch die Handarbeit: Seitenumbrüche, Layoutkorrekturen, Korrekturen, andere Texte, evtl. Bilder und Grafiken ...

== Kritik ==
Dieses Verfahren ist leicht umzusetzen und nachzubilden. Hat man sich seine InDesign-Datei eingerichtet, die Daten in Kiribati ordentlich gepflegt und ist man mit dem Ergebnis zufrieden, dann braucht man in der Tag nicht mehr.

Allerdings kann InDesign noch mehr: Mit einem [[XSLT-Stylesheet]] können die XML-Daten vor dem Import noch manipuliert werden. Dieses kann entweder direkt beim Import der XML-Daten angewandt werden (leider wird von InDesign nur die Version 1.0 unterstützt) oder man besorgt sich einen XSLT-Compiler der die Version 2.0 unterstützt. Die XML-Daten werden vor dem Import in InDesign nach den Vorgaben im XSLT-Stylesheet gefiltert, neu zusammengestellt, verknüpft, manipuliert ... Die Vorbereitung der Satzdatei und der Import funktioniert dann in etwa so, wie auf dieser Seite beschrieben oder man erstellt sich eine Datei mit den Absatz- und Zeichenformaten und weist diese schon vorab den Tags zu. Dann ist es egal, wie die XML-Datei aufgebaut ist. InDesign erstellt das Veranstaltungsprogramm anhand der Tags in der XML-Datei und weist automatisch die entsprechenden Formate zu. Damit beginnt die '''Magie''' erst richtig.