SiteparkWiki - Benutzerbeiträge [de]

Installationsanleitung CityCall115

2018-05-17T11:15:52Z

Schleuse: /* Installation von CityCall115 */

==Allgemein==
[[:Kategorie:CityCall115|CityCall115]] beschreibt die Lösung von Sitepark für Call-Center bzw. Call-Center mit erweiterter Serviceleistung sog. Service-Center. Bei einem Service-Center werden Anfragen nicht nur beantwortet, sondern u.U. auch aufgenommen und intern weitergeleitet.

Daraus resultiert, dass die Installation des Produktes [[:Kategorie:CityCall115|CityCall115]] mehr oder weniger umfangreich ist.

Grundsätzlich muss der Server so konfiguriert werden, dass der Email-Versand sowohl von '''PHP''', als auch vom '''[[IES]]''' möglich ist!

==System-Voraussetzungen==
* IES-2
** Java (JDK)
** MySQL
** Apache inkl. Mod-Proxy
* CityGov3
* [[Installationsanleitung Nutch|Nutch-Crawler]] (Tomcat wird nicht benötigt)
* PHP
** Korrekt konfigurierte Timezone
** notwendige Module
** ZEND Framework (IES-Module)
* Personalisierung

===Installation des IES-2===
Die Installation des IES-2 inkl. aller notwendigen Abhängigkeiten wird im Wiki von Sitepark bereits ausführlich beschrieben:
[[:Kategorie:Installation|Installation des IES]]

===Installation von Nutch===
[[:Kategorie:CityCall115|CityCall115]] benötigt für performante Volltextsuchen leistungsfähige Indices der Inhalte. Hierzu werden über die generierten Inhalte [http://lucene.apache.org/ Lucene]-Indices erzeugt. Als Crawler wird [http://lucene.apache.org/nutch/ Nutch] eingesetzt.

Sitepark liefert ein entsprechendes Nutch-Paket, welches über Erweiterungen für alle notwendigen Datentypen (Office2007, PDF-1.5, etc.) verfügt. Weiterhin sind zur Konfiguration Strukturen (sog. ''Zones'') definiert worden, die alle notwendigen Funktionen übersichtlich abbilden.
Für jede Instanz des ServiceCenters wird eine eigene ''Zone'' definiert. Anschließend wird der Crawl-Aufruf in einer zentralen Datei (<code>crawl-all-zones.sh</code>) konfiguriert. Die Konfiguration von Nutch wird in einem separaten Abschnitt beschrieben.

Für die Installation des Crawlers erhalten Sie von Sitepark ein gezippte Datei mit allen benötigten Inhalten: <code>sitepark-nutch-0.8.1.tar.gz</code>. Diese kann auf dem Zielsystem im <code>$SITEPARK_HOME</code> entpackt werden. Anschließend wird in <code>$SITEPARK_HOME</code> ein sog. Symbolischer Link ''nutch'' erzeugt.

Für die regelmäßige Aktualisierung aller konfigurierten Indices werden ''Cron''-Jobs benötigt. Dieser Aufruf kann bereits jetzt global konfiguriert werden und lauten etwa wie folgt:
<source lang="bash">
# m h dom mon dow command

# jede Nacht nutch Suchindizes aktualisieren
15 2 * * * /srv/sitepark/nutch/crawl-all-zones.sh 2>/dev/null
</source>

Da die Indices vom Nutzer des Webserver gelesen werden müssen, muss diesem stets nach dem Crawlen der entsprechende Verzeichnis übertragen werden. Ist dieser Nutzer <code>wwwrun</code> in der Gruppe <code>wwwrun</code> sieht der Aufruf wie folgt aus:
chown -R wwwrun.wwwrun /srv/sitepark/nutch/zones
Idealerweise wird das an das Ende der Date <code>crawl-all-zones.sh</code> angehängt.

Weiterführende Informationen zur Installation von Nutch finden Sie bei Bedarf auch [[Installationsanleitung Nutch|hier]].

===Installation von PHP===
Da [[:Kategorie:CityCall115|CityCall115]] über ein Bedienoberfläche in PHP gesteuert wird, ist auf dem entsprechendem System zusätzlich noch PHP5 inkl. benötigter Module zu installieren.
'''Zusäzliche php Module:'''
php7-xsl
php7-mysql
php7-mcrypt
php7-json
php7-curl

Eine Übersicht über die benötigten Module und weitere Installationshinweise finden Sie hier: [[Installationsanleitung PHP|Installationsanleitung für PHP]].

Weiterhin muss das System so konfiguriert werden, dass der Versand von '''Emails''' möglich ist.

Für die Generierung von PDF- bzw. XML-Dokumenten direkt aus [[:Kategorie:CityCall115|CityCall115]] heraus, werden folgende Ordner mit Schreibrechten für den Nutzer des Webserver benötigt:
* <code>$DOCUMENT_ROOT/pdf</code>
* <code>$DOCUMENT_ROOT/xml</code>
Der Wert von <code>$DOCUMENT_ROOT</code> entspricht dem Verzeichnis, das im [[IES]] für den Publisher des ServiceCenters konfiguriert wurde/wird.
Weiterhin werden dort entsprechende PHP-Bibliotheken benötigt, die Sie von Sitepark erhalten.

Ist der Apache, wie in der [[Installation unter Linux#Konfiguration|Installationsanleitung]] beschrieben, in der Gruppe des IES, so werden diese beiden Ordner inkl. notwendiger Bibliotheken automatisch während der Initialisierung von CityCall115 angelegt.

Die PHP-Bibliothek (TCPDF) für die PDF-Generierung ist manuell zu installieren:
http://www.tecnick.com/public/code/cp_dpage.php?aiocp_dp=tcpdf_installation
Auf einem IES-System (Linux) kann die Installation im <code>$SITEPARK_HOME</code> unter <code>tcpdf</code> installiert werden. Alternativ kann man den Ordner parallel zum <code>DocumenRoot</code> anlegen.

===Installation von ZEND===
Das ZEND-Framework wird von Sitepark in der benötigten Version bereit gestellt und entsprechend installiert bzw. für PHP konfiguriert. Das Framework steuert primär den Zugriff auf die vom ''Nutch''-Crawler erzeugten Indices.

Auf dem Webserver des ServiceCenters kann das Framework parallel zu den <code>DocumentRoot</code>-Verzeichnissen ausgepackt werden. Zur einfacheren Konfiguration sollte in Symbolischer Link 'zend' auf die jeweilige Version angelegt werden.
ln -s /var/www/zend-1.9 /var/www/zend

Anschließend muss der PHP <code>include_path</code> erweitert werden. Dieses kann am besten direkt innerhalb des VirtualHosts-Konfiguration des Apache erfolgen:
<source lang="ini">
...
php_value include_path ".:/srv/www/interntet/WEB-IES/zend/:/srv/www/internet/WEB-IES/citygov/php/:/srv/www/internet/WEB-IES/ies-api/php/"

# Mit Infoticket und Form-Service müssen noch weitere Pfade angehangen werden:

php_value include_path ".:/srv/www/servicecenter/WEB-IES/zend/:/srv/www/servicecenter/WEB-IES/citygov/php/:/srv/www/servicecenter/WEB-IES/ies-api/php/:/srv/www/servicecenter/WEB-IES/formservice/php/:/srv/www/servicecenter/WEB-IES/infoticket/php/"

...
</source>

Damit ist die Installation von ZEND auch schon abgeschlossen.

Weitere Details zur Installation von Zend sind auch in [[Installationsanleitung Nutch#Installation_der_PHP-Zend-Suche|diesem Dokument]] beschrieben.

===Installation der Personalisierung===
Zur Steuerung der Zugriffe der Agents entsprechend ihrer Rechte wird das Apache-Modul ''Profile-Plus'' von Sitepark benötigt.

Sie haben entweder die Möglichkeit das Quellpaket inkl. der entsprechenden MAKE-Files direkt auf dem Zielsystem zu kompilieren um so ein optimal angepasstes Apache-Modul zu erhalten. Oder Sie bekommen von Sitepark direkt ein vorkompiliertes, zu Ihrer Hardware-Architektur kompatibles, Apache Modul (<code>mod_sumpf.so</code>-Datei).
Die Installation erfolgt dann manuell und unterscheidet ist je nach Linux-Distribution etwas. Informationen hierzu finden Sie beim entsprechenden Distributor.

Allgemeine Informationen zum Modul ''Profile-Plus'' und zur Installation finden Sie [[Handbuch Personalisierung#Installation_und_Konfiguration|hier]].

Da der Zugriff auf das ServiceCenter für die entsprechende URL einmalig eingerichtet werden muss, kann das bereit hier vorgenommen werden. Bereits an dieser Stelle kann der Zugriff

Der Zugriff auf das ServiceCenter erfolgt über eine zentrale URL. Für diese kann bereits an dieser Stelle die Konfiguration der Personalisierung erfolgen. Es empfiehlt sich daher bereits jetzt die gesamte Apache-Konfiguration für das ServiceCenter vorzunehmen. Im wesentlichen sind hierzu lediglich folgende Aktionen notwendig:
*Verzeichnis für den $DOCUMENT_ROOT wählen, anlegen und dem Nutzer <code>ies</code> übertragen (<code>chown -R ies.ies</code>)
*URL und <code>DocumentRoot</code> konfigurieren.
*Konfiguration der Personalisierung:
:Die Konfiguration erfolgt entweder direkt über die <code><nowiki>Directory</nowiki></code>-Direktive in der Konfiguration des Apache oder über eine <code>.htaccess</code>-Datei, die man im $DOCUMENT_ROOT des ServiceCenter-Publishers anlegt. Für eine typische Konfiguration eines ServiceCenters kann der Inhalt wir folgt aussehen:
<source lang="apache">
SumpfFilter on
SumpfContentFilter on

# Datenbankkonfiguration
#SumpfMySQLHost localhost
SumpfMySQLDatabase servicecenterdb
SumpfMySQLUser servicecenteruser
SumpfMySQLPass servicecenterpassword

# Connection ID
SumpfMySQLConnectionID 1

# URL zum CMS-System kann angepasst werden
SumpfAuthURL http://localhost:8080/ies/infosite/templates/gui.login.xml.spml?SYS_handler=com.sitepark.ies.control.jsp.handler.LoginHandler

SumpfAuthServiceOffLineURL /WEB-IES/cc/index.php

SumpfAuthTimeLogging On

SumpfLoginURL /WEB-IES/cc/index.php
SumpfLoginFailedURL /WEB-IES/cc/index.php
#SumpfWelcomeURL /welcome.shtml

SumpfForceSession off
SumpfForceNoCaching on
SumpfAuthMechanism IES
SumpfWantedCharset UTF-8

# Interner Zugang für den Nutch-Crawler
# Das Passwort kann frei hier vergeben werden. Es wird beim der Konfiguration der Zone sangegeben (s.u.).
SumpfAllAreasUser nudge
SumpfAllAreasPass nutchpassword

# Weitere optionale Parameter
# SumpfDirectoryIndex index.php
# SumpfPersonalizedDirectory /save
# SumpfAccessFile .spaccess
# SumpfTryBasicAuth off
# SumpfNoForcedSession on
# SumpfCheckParentDirs on
# SumpfAuthMechanism IES_Tables IES
</source>
:Voraussetzung für diese Konfiguration ist natürlich die entsprechende Konfiguration von '''AllowOverride AuthConfig'''.

==Installation und Konfiguration von CityCall115==
Das ServiceCenter besteht aus einem Kern mit Basisfunktionen, die optional über sog. AddOns noch erweitert werden können. Die Installation erfolgt jeweils über ein sog. XIP-Paket, welches direkt Erweiterungen in den entsprechenden Mandanten einspielt. Da das ServiceCenter über eine generierte PHP-Seite bedient wird und es sich nicht um ein ''direktes'' IES-Modul handelt, kann auch ohne laufenden IES-Prozeß die Recherche-Funktion voll genutzt werden.

====Hinweis====
Allgemeine Hinweise zur IES-Modulen erhalten Sie [[IES-Admin (web) Module|hier]].<br>
Details zum Import von XIP-Daten finden Sie unter [[Kommandozeilen-Tool|XIP Import in der Konsole]] oder unter [[Webinterface XIP-Manager|XIP Import im Browser]]. Beachten Sie beim Import, dass die Pools und Elemente erstellt, und die Daten in den entsprechenden Publikationsbereichen veröffentlicht werden.

====Ein-Mehrmandanten Installation====
Im folgenden wird zwischen der sog. ''einfachen'' und der ''Portal-Installation'' unterschieden. Im ''einfachen'' Fall wird CityCall115 zusammen mit den Daten des Mandaten in einer Instanz installiert.

Sollen mehrere Mandanten mit einer CityCall115-Installation bedient werden, so wird ein neuer Mandant mit den entsprechenden Funktionen installiert. Alle Daten werden von weiteren Mandanten geliefert. Jeder Mandant erhält lediglich eine Erweiterung, die die Integration in das zentrale ServiceCenter ermöglicht.

In jedem Fall ist darauf zu achten, dass '''alle''' Mandanten über eine Lizenz für '''CityGov3''' und '''Personalisierung''' verfügen!

Für die Core-Funktionen des ServiceCenters gibt es ein XIP-Paket, welches alle funktionalen Elemente beinhaltet. Dieses kann später auch durch eine neue Version aktualisiert werden.

Für die Initialisierung wird ein weiteres XIP-Paket bereit gestellt, welches initiale Strukturen bereitstellt, die später den eigenen Wünschen entsprechend angepasst werden können (Layout etc.)

===Installation von CityCall115===
In der folgenden Beschreibung wird davon ausgegangen, dass es noch keine Daten und Mandanten auf dem System gibt. Alle notwendigen Aktionen zum Betrieb von CityCall115 werden hier vollständig beschrieben.

Folgendes Vorgehen ist notwendig:

* Modul [[:Kategorie:CityGov3|CityGov3]] installieren: WAR File von Sitepark im IES-Admin hochloaden
* IES-Datenbank für den neuen Mandaten anlegen
* Mandant anlegen und Anker vergeben (z.B. '''servicecenter''')
* <code>DocumentRoot</code> des ServiceCenters anlegen und dem Nutzer <code>ies</code> übertragen (sofern nicht bereits erfolgt s.o.)
* Publisher für das ServiceCenter anlegen (bei Verwendung des Beschwerdenmanagement muss der Publisch als 'Modul' gekennzeichnit werden, Live-Funktionalitäten zu ermöglichen)
* Den Apache so konfigurieren, dass Live-Aufrufe via <code>mod_proxy</code> an den IES geleitet werden. Informationen hierzu finden Sie [[Integration_des_IES_in_den_Apache#Apache-Konfiguration_f.C3.BCr_Publikationsbereiche_mit_Live-Komponenten|hier]].
* Den Anker des Publishers setzen (z.B. '''pub.cc'''). Dieser wird später für die [[#Konfiguration der Recherche|Konfiguration der Recherche]] benötigt.
* Personalisierung für diesen Publisher konfigurieren
* Die Metadaten des Publishers entsprechend für CityCall115 setzen (siehe auch [[Installationsanleitung CityGov3|Installationsanleitung CityGov3]]):
sp_vv_mode=service
* Datenbank für Personalisierung initialisieren (siehe [[Handbuch Personalisierung|Initialisierung der Personalisierungsdatenbank]])
* Zugangsdaten der Datenbank für die Personalisierung in Apache konfigurieren:
#SumpfMySQLHost localhost
SumpfMySQLDatabase servicecenterdb
SumpfMySQLUser servicecenteruser
SumpfMySQLPass servicecenterpassword
* Diesen Publisher dem Mandanten sowohl als Publisher(bei Verwendung des Beschwerdenmanagement auch als auch als Modul zuweisen.
* Mail-Publisher im IES konfigurieren und dem Mandanten zuweisen (bei einigen AddOns notwendig)
* Statistik-Datenbank anlegen:
:Für die Statistik-Funktion wird eine weitere Datenbank benötigt. Die Zugangsdaten werden im ServiceCenter konfiguriert und über PHP verwendet. Die Datenbank kann somit entweder
:* manuell
:* oder über den IES als ''nicht-IES'' Datenbank angelegt und dem Mandanten zugewiesen werden.
:Für die Initialisierung der Datenbank werden folgende Statements verwendet:
<source lang="sql">
CREATE TABLE `StatisticEntry` (
`id` int(11) NOT NULL auto_increment,
`articleID_fk` varchar(255) default NULL,
`client_fk` varchar(250) default NULL,
`parentPath_fk` varchar(500) default NULL,
`callID` varchar(255) default NULL,
`userID` varchar(255) default NULL,
`userName` varchar(255) default NULL,
`callDuration` int(11) default NULL,
`flag` int(11) default NULL,
`timestamp` bigint(20) NOT NULL default '0',
PRIMARY KEY (`id`),
KEY `articleID_fk` (`articleID_fk`),
KEY `client_fk` (`client_fk`),
KEY `parentPath_fk` (`parentPath_fk`),
KEY `userID` (`userID`),
KEY `flag` (`flag`),
KEY `timestamp` (`timestamp`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 ;

--
--CREATE TABLE `StatisticEntryKey` (
-- `statistikId_fk` int(11) NOT NULL,
-- `keyName` varchar(255) NOT NULL,
-- `keyValue` varchar(255) default NULL,
-- KEY `statistikId_fk` (`statistikId_fk`),
-- KEY `keyName` (`keyName`)
--) ENGINE=InnoDB DEFAULT CHARSET=utf8 ;

CREATE TABLE `StatisticElement` (
`articleID` varchar(255) NOT NULL default '',
`articleName` varchar(255) NOT NULL default '',
`articleTitle` varchar(255) default NULL,
`articleURL` varchar(255) default NULL,
`articleCreated` bigint(20) default NULL,
`articleChanged` bigint(20) default NULL,
`articleType` varchar(255) default NULL,
`articleDeleted` bigint(20) default NULL,
`parentID` varchar(255) default NULL,
`parentName` varchar(255) default NULL,
`parentPath` varchar(500) default NULL,
`parentOffice` varchar(255) default NULL,
`parentDepartment` varchar(255) default NULL,
`client` varchar(250) default NULL,
`timestamp` bigint(20) NOT NULL default '0',
KEY `articleID` (`articleID`),
KEY `parentID` (`parentID`),
KEY `client` (`client`),
KEY `parentPath` (`parentPath`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 ;

CREATE TABLE `StatisticElementKey` (
`articleID_fk` varchar(255) default NULL,
`client_fk` varchar(255) default NULL,
`parentPath_fk` varchar(255) default NULL,
`keyName` varchar(255) NOT NULL,
`keyValue` varchar(255) default NULL,
KEY `articleID_fk` (`articleID_fk`),
KEY `client_fk` (`client_fk`),
KEY `parentPath_fk` (`parentPath_fk`),
KEY `keyName` (`keyName`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 ;
</source>

* XIP-Paket mit den Funktionalen Erweiterungen einspielen:
:* <code>CityGov.core.stucture.xip</code> [SOLLTE bereits eingespielt sein]
:* <code>CityCall115-01.core.update.xip</code> [notwendig]
:* <code>CityCall115.base.configuration.core.xip</code> [NUR einmalig: notwendig]
*Optionale Pakete, je nach Lizenz:<br>
:* CTI
::* <code>CityCall115-03.cti.base.configuration.xip</code> [optional]
::* <code>CityCall115-03.cti.[PAKET, JE NACH ANGEBUNDENER SCHNITTSTELLE].xip</code> [optional]
:* Ticketsystem
::* <code>CityCall115-04.infoticket.update.xip</code> [optional]

:* Bei weiteren Mandaten, die an ein bestehendes CityCall angebunden werden:
::* <code>CityCall115-02.client.update.xip</code> [optional]

:Bitte ergänzen Sie für den XIP-Import die Option <code>'''ies.xip.import.publishMode'''</code> zur Steuerung der Publikation
*Wird diese Installation '''nicht''' als ''Portal'' betrieben, so ist noch die Konfiguration des Mandanten bzgl. CityGov3 erforderlich: [[Installationsanleitung CityGov3#Einstellungen_und_Administration|Konfiguration und Administration von CityGov3]]

====Konfiguration der Recherche====
Zur Konfiguration des [http://lucene.apache.org/ Lucene]-Index für eine CityCall115-Instanz kann einfach im Filesystem unter <code>$SITEPARK_HOME/nutch/zones</code> die ''Zone'' <code>localhost</code> vollständig kopiert und umbenannt werden. Es empfiehlt sich als Namen der Zone den Anker des entsprechenden Publishers zu verwenden (s.o.). Anschließend sind noch zwei Dateien manuell anzupassen:

;urls/url:Konfiguration der Start-URLs
:Hier sind die URLs für die vollständigen Objekt-Listen anzugeben. Diese werden vom ServiceCenter automatisch im entsprechenden Publisher generiert. Die Datei hat etwa den folgenden Inhalt:

http://'''SEARCH_HOST'''/auth.sp?client='''CLIENT_ANCHOR'''&welcome=/WEB-IES/cc/crawl_index.php&password=nudge&user='''nutchpassword'''

:Der Wert '''SEARCH_HOST''' muss entsprechend der eigenen URL, der Wert '''CLIENT_ANCHOR''' entsprechend dem Anker des Mandanten und '''nutchpassword''' auf das im Apache konfigurierten Nutch-Passwort angepasst werden.

;conf/urlfilter.txt:Konfiguration der globalen URL-Regeln
:Hier muss die mind. die folgende Zeile angepasst werden:

+^http://([a-z0-9]*\.)*'''SEARCH_HOST'''/

Für die regelmäßige Aktualisierung des neuen Index muss noch die zentrale Crawl-Datei (ist via Cron konfiguriert) <code>/srv/sitepark/nutch/crawl-all-zones.sh</code> entsprechend erweitert werden (wobei der Wert '''SEARCH_ZONE''' entsprechend der eigenen Zone (i.d.R. '''Anker des Publishers''') angepasst werden muss):

/srv/sitepark/nutch/crawl-zone.sh '''SEARCH_ZONE''' -d 5 -vvv -f > /srv/sitepark/nutch/logs/crawl.'''SEARCH_ZONE'''.log

Achten Sie bitte darauf, dass der Ordner für die Log-Dateien existiert und beschreibbar ist.

====Konfiguration von CityCall115====
Die Konfiguration der Installation von CityCall115 und den Modulen erfolgt anschließend über einen speziellen Artikel.

Für die Statistik-Funktion von CityCall115 muss die Datenbankverbindung konfiguriert werden. Für die Recherche ist die Konfiguration des Index notwendig. Für weitere AddOns sind zusätzliche Konfigurationen notwendig. Alle diese Einstellungen werden nach der Initialisierung direkt in InfoSite durchgeführt. Für die Konfiguration wird ein entsprechendes Template mit notwendigen Eingabemasken bereitgestellt.

Der Artikel für die globale Konfiguration ist
/ Artikel Pools/ IES / CityCall 115 / CityCall 115: Administration & Konfiguration / CityCall 115: Konfiguration
Der Anker des Artikels ist
ies.infe.cc.configuration

Je nach Installationsumfang (AddOns) sind mehr oder weniger Konfigurationseingaben notwendig bzw. möglich.

Zunächst wählt man den Mandanten aus für das im ServiceCenter aus. Wird CityCall115 als Portal betrieben, können hier mehrere Mandanten ausgewählt werden. Im ServiceCenter wird dann automatisch ein Auswahlmenü erscheinen. Nachdem man einen Mandanten ausgewählt und gespeichert hat, kann man die Konfiguration folgender Felder noch einmal anpassen:
* angezeigter Name für den Mandanten
* Name der Zone (i.d.R. Anker des Publishers)
* Skill-ID's (nur beim CTI AddOn)
Anschließend muss der Artikel noch einmal gespeichert werden.

Für die Statistik muss weiterhin die entsprechende Datenbank ausgewählt werden. Ist die Statistik-Datenbank nicht über den IES-Admin erstellt worden, können Sie die Verbindungsdaten auch manuell eingeben.

Als letztes können Sie noch die Konfiguration des Live-Nutzers vornehmen. Bitte setzen Sie zunächst das Passwort des entsprechendes Nutzers auf einen neuen Wert. Anschließend geben Sie das neue Passwort in der Konfiguration an.

====Konfiguration von Nutzern für das Beschwerdemanagement====
Für das erweiterte Formular ist das Template <code>gui.user.template</code> mit folgendem Inhalt anzulegen

<code>
<sp:io type="in">
  <sp:include anchor="is5:gui.user.template"/><br>
  <sp:include anchor="ies.tple.cc.mod.user.config"/><br>
</sp:io>
</code>

oder bei bereits existierendem Template die Zeile <code><sp:include anchor="ies.tple.cc.mod.user.config"/></code> zu ergänzen.

===Datenbank-Update der Statistik===

Ältere System mit bestehender Statistik müssen nach einem Update angepasst werden. Hier die für die Anpassungen nötigen Statements:

<source lang="sql">
-- Eineindeutigkeite der Einträge nun über ArtikelID, CleintId UND dem OrganisationsPfad:
alter table StatisticEntry add COLUMN client_fk varchar(500) DEFAULT '' AFTER articleID_fk;
alter table StatisticEntry add COLUMN parentPath_fk varchar(500) DEFAULT '' AFTER client_fk;
alter table StatisticEntry add KEY `client_fk` (`client_fk`);
alter table StatisticEntry add KEY `parentPath_fk` (`parentPath_fk`);

alter table StatisticElementKey add COLUMN client_fk varchar(500) DEFAULT '' AFTER articleID_fk;
alter table StatisticElementKey add COLUMN parentPath_fk varchar(500) DEFAULT '' AFTER client_fk;
alter table StatisticElementKey add KEY `client_fk` (`client_fk`);
alter table StatisticElementKey add KEY `parentPath_fk` (`parentPath_fk`);

-- zus. Angabe des Amtes und Dezernates in der Hierarchie
alter table StatisticElement add COLUMN parentOffice varchar(255) DEFAULT NULL AFTER parentPath;
alter table StatisticElement add COLUMN parentDepartment varchar(255) DEFAULT NULL AFTER parentOffice;

alter table StatisticElement drop PRIMARY KEY;
alter table StatisticElement add KEY `articleID` (`articleID`);
alter table StatisticElement add KEY `client` (`client`);
alter table StatisticElement add KEY `parentPath` (`parentPath`);

--
-- Nötige Update-Statements
--
update StatisticElement as elem, StatisticEntry as entry set entry.parentPath_fk = elem.parentPath , entry.client_fk = elem.client where elem.articleID = entry.articleID_fk ;

-- Bei Update von CityCall mit dem XIP-Pakten, nach dem 22.11.2016 MÜSSEN noch folgenden Statements ausgeführt werden.
update StatisticEntry set parentPath_fk = trim(parentPath_fk) ;
update StatisticElement set parentPath = trim(parentPath);

</source>

===Portal-Installation===
CityCall115 kann auch als Portal installiert werden. In dieser Variante ist ein zentrales ServiceCenter für mehrere Mandanten zuständig. Alle Anrufe werden zentral angenommen und entsprechend des jeweiligen Mandanten bearbeitet.

In der folgenden Beschreibung wird davon ausgegangen, dass es noch keine Daten und Mandanten auf dem System gibt. Alle notwendigen Aktionen zum Betrieb von CityCall115 werden hier vollständig beschrieben.

====Globale Installation von CityCall115====
Es wird ein Mandant für CityCall115 entsprechend der [[#Installation von CityCall115|oben]] beschriebenen Anleitung vollständig installiert. Die Konfiguration des Portals wird weiter unten im Abschnitt [[#Installation und Konfiguration von Mandanten|Installation und Konfiguration von Mandanten]] beschrieben. Über die URL des dort konfigurierten <code>DocumentRoot</code> wird später das ServiceCenter betrieben. Für jeden Mandaten, der über das zentrale ServiceCenter bedient wird, muss ein separater IES-Mandant auf dem gleichen IES eingerichtet werden.

*Die Daten für das ServiceCenter kommen somit stets aus den einzelnen Mandanten
*Über sog. Themen können jedoch zusätzlich auch globale Informationen aufgenommen und über der Recherche durchsucht werden.
*Die Daten aus den Modulen [[Bürgeranfrage AddOn CityCall115|Bürgeranfrage]] und [[Beschwerdemanagement AddOn CityCall115|Beschwerdemanagement]] werden '''zentral''' im ServiceCenter-Mandanten gespeichert. Dort können diese Informationen von den entsprechenden Mitarbeitern weiter bearbeitet werden.
*Alle Zugänge zur Verwendung des ServiceCenters erfolgen ebenfalls in diesem Mandanten.

====Installation und Konfiguration von Mandanten====
Die eigentlichen Daten einer CityCall115-Portal-Installation werden in unabhängigen Mandaten dezentral vorgenommen. Die Konfiguration des entsprechenden Publishers ermöglicht zusammen mit entsprechenden Templates eine nahtlose Integration. Über weitere Publisher können diese Mandanten auch parallel für den Aufbau eines Intranet, einer Internetpräsenz oder einer D115-XML-Struktur verwendet werden. Für einen neuen Mandanten sind folgende Schritte auszuführen:

* IES-Datenbank für den neuen Mandaten anlegen
* Mandant anlegen und Anker vergeben (z.B. '''client.abc''')
* Publisher für das ServiceCenter mit folgenden Angaben anlegen:
:*Als URL wird die URL des ServiceCenters konfiguriert (analog zur Konfiguration des Portal-Publishers).
:*Als <code>DocumentRoot</code> wird der <code>DocumentRoot</code> des ServiceCenters gewählt
:*Über den Parameter ''Verzeichnis'' wird später der <code>DocumentRoot</code> automatisch erweitert (z.B. <code>ms</code> für Münster). Auf diese Weise werden alle Daten des Mandanten in ein Unterverzeichnis des ServiceCenters geschrieben.
:*Die Metadaten des Publishers entsprechend für CityCall115 setzen:
sp_vv_mode=service
:*Den Anker des Publishers setzen (z.B. '''pub.client.abc'''). Dieser wird später für die [[#Konfiguration der Recherche|Konfiguration der Recherche]] benötigt.
* Diesen Publisher dem Mandanten zuweisen
* XIP-Paket mit den Funktionalen Erweiterungen einspielen:
:* <code>PHPlib</code> [notwendig]
:* <code>CityGov.core.stucture.xip</code> [notwendig]
:Bitte ergänzen Sie für den XIP-Import die Option <code>'''ies.xip.import.publishMode'''</code> zur Steuerung der Publikation
*Die Installation der CityCall115-Komponenten ist für die Mandanten '''nicht''' notwendig. Damit alle Daten in einem einheitlichen Layout generiert werden müssen noch entsprechende Rahmen-Templates in die einzelnen Mandanten eingespielt werden. Hierfür stellen wir ein entsprechendes XIP-Paket bereit:
:* <code>CityCall115_06_Client.xip</code>
:Bitte ergänzen Sie für den XIP-Import die Option <code>'''ies.xip.import.publishMode'''</code> zur Steuerung der Publikation
*Damit die eigentlichen Daten auch für Recherche-Funktionen zur Verfügung stehen muss eine entsprechende ''Nutch-Zone'' analog zu dem [[#Konfiguration der Recherche|oben]] beschriebenen Vorgehen angelegt werden.
*Weiterhin muss unter ''Attribute'' in der Mandantenkonfiguration der ''Anker'' des ServiceCenter-Mandanten über den Parameter <code>ccMaster</code> angegeben werden. Z.B.:
ccMaster=servicecenter
*Konfiguration des Mandanten bzgl. CityGov3: [[Installationsanleitung CityGov3#Einstellungen_und_Administration|Konfiguration und Administration von CityGov3]]

Abschließend wird nun in der [[#Konfiguration von CityCall115|Konfiguration des ServiceCenters]] der neue Mandant über einen weiteren Konfigurationsblock (Iterate) für das ServiceCenter ''aktiviert''.

<div class="note">Bitte beachten Sie, dass Sie bei der Konfiguration nur Mandanten auswählen können, die entsprechend für CityCall115 initialisiert wurden.</div>
====XIP Pakete einspielen====

==Erweiterungen für CityCall115==
Hier werden die möglichen Erweiterungen der Grundinstallation kurz beschrieben.

Die Installation der Erweiterungen erfolgt über sog. XIP-Dateien.

===D115 AddOn===
[[D115 AddOn CityCall115]]

===Bürgeranfrage AddOn===
[[Bürgeranfrage AddOn CityCall115]]

===Beschwerdemanagement AddOn===
[[Beschwerdemanagement AddOn CityCall115]]

===CTI AddOn===
[[CTI AddOn CityCall115]]

===InfoTicket AddOn===
[[Infoticket AddOn CityCall115]]

<noinclude>
[[Kategorie:CityCall115| ]]
</noinclude>

Ilink (SPT-Tag)

2018-02-27T11:56:14Z

Schleuse: /* Attribute */

==Name==
<spt:ilink> - Erzeugt einen Link auf das CMS

==Syntax==
<source lang="xml">
<spt:ilink value=""/>
</source>

==Beschreibung==
Der <code>spt:ilink</code>-Tag generiert einen Link auf die Bearbeitung des entsprechenden Artikels. Diese Links sind klassisch in der Website nur für Redakteure sichtbar und erlauben das Öffnen des aktuellen Artikels in der Bearbeitung von InfoSite direkt aus der Website heraus.

Seit InfoSite 6 ist auch die Verwendung des i!-Links für interne Links auf andere Artikel innerhalb des CMS möglich.

==Attribute==
{| class="prettytable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab Generator Version
|-
| <code>value</code>
| [[Text]]
| Nein
| None
| 1
|-
| <code>information</code>
| [[Attribute]]
| Nein
| None
| 1
|-
| <code>step</code>
| [[Number]]
| Nein
| None
| 1
|-
| <code>action</code>
| [[Attribute]]
| Nein
| <code>edit</code>
| 1.32
|-
|}

;<code>value</code>
:Code für den generierten i-Link.

;<code>information</code>
:Optionale Angabe eines Artikels, auf den der Link zeigen soll (z.B. für Listen).

;<code>step</code>
:Bei Templates, die mit mehreren Steps aufgebaut sind ist hiermit der Sprung an eine definierte Stelle möglich. Die Angabe erfolgt relativ zum Step "Verwaltung".

;<code>action</code>
:Gibt an ob das Objekt in der Bearbeitungsansicht (<code>edit</code>) oder in der Listen-Ansicht (<code>list</code>) geöffnet werden soll

==Beispiele==

===Einfacher Artikel mit i!-Link===

Template Quelltext
<source lang="xml">
<sp:io type="in">
<sp:text name="headline"/>
</sp:io>

<%-- einfacher Seiten-i-Link --%>
<sp:io type="out">
<sp:print name="headline"/>
</sp:io>

<spt:ilink value="Artikel bearbeiten"/>

<%-- Loop pro Treffer ein i-Link --%>
<sp:io type="out">
<sp:loop collection="collection" item="it">
<ul class="linkIntern">
<li>
<a href="<sp:print name="it.id.url"/>"><sp:print name="it.sp_title"/></a>
<div id="ilinkInline">
<spt:ilink
value="<img src=\"/img/ilink.gif\"
class=\"ilink\"
width=\"16\"
height=\"16\"
alt=\"Seite bearbeiten ...\">"
information="${it.id}"/>
</div>
</li>
</ul>
</sp:loop>
</sp:io>
</source>

===i!-Link in der Eingabe===
Template Quelltext
<source lang="xml">
<sp:io type="in">
<strong>Artikel verknüpfen</strong><br/>
<sp:link name="sp_link" type="link"/>
<spif name="sp_link.link">
<spt:ilink information="sp_link.link" step="4" />
</sp:if>
</sp:io>
</source>

<noinclude>
[[Category:SPT-Tags]]
[[Category:Qualität_des_Inhalts_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

Textarea (SPT-Tag)

2018-02-16T10:23:05Z

Schleuse: /* Attribute */

==Name==
<spt:textarea> - Erzeugt ein mehrzeiliges Textfeld, das Versionierung unterstützt

==Syntax==
<source lang="xml">
<spt:textarea name="Variablenname" rows="60" cols="5">
</source>

==Beschreibung==
Der <code>spt:textarea</code>-Tag erzeugt ein Textarea, das die Versionierung für Informationen in InfoSite unterstützt. Werden im Untermenüpunkt Bearbeitung ältere Versionen der Information ausgewählt, so erscheinen die mit der ausgewählten Version vorgenommenen inhaltlichen Änderungen der Textarea.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
{{sp_input_attributes|attribute=name|mode=row}}
|-
{{sp_input_attributes|attribute=value|mode=row}}
|-
{{sp_input_attributes|attribute=fixvalue|mode=row}}
|-
{{sp_input_attributes|attribute=locale|mode=row}}
|-
{{sp_input_attributes|attribute=type|mode=row}}
|-
{{sp_input_attributes|attribute=disabled|mode=row}}
|-
{{sp_input_attributes|attribute=readonly|mode=row}}
|-
{{sp_input_attributes|attribute=hyphenEditor|mode=row}}
|-
| <code>hyphenEditor</code>
| [[Boolean]]
| Nein
| True
| 2.17
|-
{{sp_input_attributes|attribute=dynamics|mode=row}}
|}
{{sp_input_attributes|attribute=name|mode=desc}}
{{sp_input_attributes|attribute=value|mode=desc}}
{{sp_input_attributes|attribute=fixvalue|mode=desc}}
{{sp_input_attributes|attribute=locale|mode=desc}}
{{sp_input_attributes|attribute=type|mode=desc}}
{{sp_input_attributes|attribute=disabled|mode=desc}}
{{sp_input_attributes|attribute=readonly|mode=desc}}
;<code>hyphenEditor</code>
:Deaktiviert bei 'False' den Hyphen-Editor
{{sp_input_attributes|attribute=dynamics|mode=desc}}

==Beispiele==

===Einfache Textarea===

Textarea mit den dynamischen Attributen cols und rows
<source lang="xml">
<sp:io type="in">
Textabschnitt:<br>
<spt:textarea name="sp_text" cols="20" rows="5"/>
</sp:io>

<sp:io type="out">
<sp:print name="sp_text"/>
</sp:io>
</source>

<noinclude>
[[Category:SPT-Tags]]
</noinclude>

Text (SPT-Tag)

2018-02-16T10:21:19Z

Schleuse: /* Attribute */

==Name==
<spt:text> - einzeiliges Textfeld, das Versionierung unterstützt

==Syntax==
<source lang="xml">
<spt:text name="Variablenname" size="20"/>
</source>

==Beschreibung==
Der <code><spt:text></code>-Tag erzeugt ein Textfeld, das die Darstellung von Versionsunterschieden in InfoSite5 unterstützt. Werden im Untermenüpunkt ''Bearbeitung'' ältere Versionen der Information ausgewählt, so erscheinen die mit der ausgewählten Version vorgenommenen inhaltlichen Änderungen des Textfeldes.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
{{sp_input_attributes|attribute=name|mode=row}}
|-
{{sp_input_attributes|attribute=value|mode=row}}
|-
{{sp_input_attributes|attribute=fixvalue|mode=row}}
|-
{{sp_input_attributes|attribute=locale|mode=row}}
|-
{{sp_input_attributes|attribute=type|mode=row}}
|-
{{sp_input_attributes|attribute=format|mode=row}}
|-
{{sp_input_attributes|attribute=disabled|mode=row}}
|-
{{sp_input_attributes|attribute=readonly|mode=row}}
|-
| <code>size</code>
| [[Number]]
| Nein
| 20
| 1
|-
{{sp_input_attributes|attribute=hyphenEditor|mode=row}}
|-
| <code>hyphenEditor</code>
| [[Boolean]]
| Nein
| True
| 2.17
|-
{{sp_input_attributes|attribute=dynamics|mode=row}}
|}
{{sp_input_attributes|attribute=name|mode=desc}}
{{sp_input_attributes|attribute=value|mode=desc}}
{{sp_input_attributes|attribute=fixvalue|mode=desc}}
{{sp_input_attributes|attribute=locale|mode=desc}}
{{sp_input_attributes|attribute=type|mode=desc}}
{{sp_input_attributes|attribute=format|mode=desc}}
{{sp_input_attributes|attribute=disabled|mode=desc}}
{{sp_input_attributes|attribute=readonly|mode=desc}}
;<code>size</code>
:'size'-Wert des generierten input-Tags.
;<code>hyphenEditor</code>
:Deaktiviert bei 'False' den Hyphen-Editor
{{sp_input_attributes|attribute=dynamics|mode=desc}}

==Beispiele==

===Einfache Ein- und Ausgabe eines Textfeldes===

Template Quelltext
<source lang="xml">
<sp:io type="in">
Überschrift:<br>
<spt:text name="sp_headline" size="25"/>
</sp:io>

<sp:io type="out">
<h1><sp:print name="sp_headline"/></h1>
</sp:io>

</source>

<noinclude>
[[Category:SPT-Tags]]
</noinclude>

Text (SPT-Tag)

2018-02-16T10:20:12Z

Schleuse: /* Attribute */

==Name==
<spt:text> - einzeiliges Textfeld, das Versionierung unterstützt

==Syntax==
<source lang="xml">
<spt:text name="Variablenname" size="20"/>
</source>

==Beschreibung==
Der <code><spt:text></code>-Tag erzeugt ein Textfeld, das die Darstellung von Versionsunterschieden in InfoSite5 unterstützt. Werden im Untermenüpunkt ''Bearbeitung'' ältere Versionen der Information ausgewählt, so erscheinen die mit der ausgewählten Version vorgenommenen inhaltlichen Änderungen des Textfeldes.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
{{sp_input_attributes|attribute=name|mode=row}}
|-
{{sp_input_attributes|attribute=value|mode=row}}
|-
{{sp_input_attributes|attribute=fixvalue|mode=row}}
|-
{{sp_input_attributes|attribute=locale|mode=row}}
|-
{{sp_input_attributes|attribute=type|mode=row}}
|-
{{sp_input_attributes|attribute=format|mode=row}}
|-
{{sp_input_attributes|attribute=disabled|mode=row}}
|-
{{sp_input_attributes|attribute=readonly|mode=row}}
|-
| <code>size</code>
| [[Number]]
| Nein
| 20
| 1
|-
{{sp_input_attributes|attribute=hyphenEditor|mode=row}}
|-
| <code>hyphenEditor</code>
| [[Boolean]]
| Nein
| True
| 2.17
|-
{{sp_input_attributes|attribute=dynamics|mode=row}}
|}
{{sp_input_attributes|attribute=name|mode=desc}}
{{sp_input_attributes|attribute=value|mode=desc}}
{{sp_input_attributes|attribute=fixvalue|mode=desc}}
{{sp_input_attributes|attribute=locale|mode=desc}}
{{sp_input_attributes|attribute=type|mode=desc}}
{{sp_input_attributes|attribute=format|mode=desc}}
{{sp_input_attributes|attribute=disabled|mode=desc}}
{{sp_input_attributes|attribute=readonly|mode=desc}}
;<code>size</code>
:'size'-Wert des generierten input-Tags.
{{sp_input_attributes|attribute=dynamics|mode=desc}}

==Beispiele==

===Einfache Ein- und Ausgabe eines Textfeldes===

Template Quelltext
<source lang="xml">
<sp:io type="in">
Überschrift:<br>
<spt:text name="sp_headline" size="25"/>
</sp:io>

<sp:io type="out">
<h1><sp:print name="sp_headline"/></h1>
</sp:io>

</source>

<noinclude>
[[Category:SPT-Tags]]
</noinclude>

Changelog Mobile Navigation

2018-01-11T14:15:26Z

Schleuse: /* Changelog */

<div class="noautonum">__TOC__</div>
==Changelog==
===1.7 (10.01.2018)===
''Release''
{|
| style="vertical-align:top;" | {{fix}} || Sortierung der Navigationseinträge fehlerhaft
|-
| style="vertical-align:top;" | {{add}} || Möglichkeit zur Angabe von Sortierkriterien
|-
| style="vertical-align:top;" | {{fix}} || Mobile-Seitenattribute wurde nicht korrekt mit den normalen Attributen zusammengeführt
|}
===1.6.5 (10.12.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Abwärtskompatibilitätsprobleme behoben
|}
===1.6.4 (15.10.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Links werden nicht vom UrlRewriter umgeschrieben
|}
===1.6.3 (13.05.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{update}} || Die Option Keep-Rubrics bezieht sich nun nicht mehr auf das isRubric Attribut sondern auf die erste Ebene unter der Homepage
|}
===1.6.2 (08.05.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Unter bestimmten Umständen trat beim Sortieren der Navigationseinträge ein PHP-Fehler auf
|}
===1.6.1 (07.05.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Unter bestimmten Umständen trat beim Sortieren der Navigationseinträge ein PHP-Fehler auf
|}
===1.6 (06.05.2015)===
''Release''
{|
| style="vertical-align:top;" | {{add}} || teaserAppender Callback implementiert
|}
===1.5 (05.03.2015)===
''Release''
{|
| style="vertical-align:top;" | {{add}} || Korrektur der Scrollposition wenn Animationsbedingt aus dem sichtbaren Bereich gesprungen wird
|-
| style="vertical-align:top;" | {{fix}} || Falsche Reihenfolge der Kinder
|-
| style="vertical-align:top;" | {{update}} || JavaScript JSON implementierung ist nun nicht mehr in der mobilen Navigation verpackt
|-
| style="vertical-align:top;" | {{fix}} || Nachbar-Rubriken werden nicht zugeklappt wenn die Option keepRubrics aktiviert ist
|}
===1.4.1 (10.04.2014)===
''Hotfix- Release''
{|
| style="vertical-align:top;" | {{fix}} || Pfade zu CSS-Dateien sind nicht abwärtskompatibel
|}
===1.4 (09.04.2014)===
''Release''
{|
| style="vertical-align:top;" | {{add}} || Beim Aufklappen der Navigation sollte die Scrollposition zur aktiven Seite springen
|-
| style="vertical-align:top;" | {{fix}} || Wenn die aktive Seite nicht in der Navigation angezeigt werden sollen, wird der nächste Menüpunkt nicht als aktives Item behandelt
|-
| style="vertical-align:top;" | {{add}} || Überschreibbare Renderfunktionen unterstützen
|-
| style="vertical-align:top;" | {{update}} || Touch-Rahmen für Webkit Browser wird nun nicht mehr angezeigt
|}
===1.3.3 (24.01.2014)===
''Hotfix''
{|
| style="vertical-align:top;" | {{update}} || Nodes nicht mit GET Requests nachladen
|-
| style="vertical-align:top;" | {{update}} || Option refreshDeadNodes hinzugefügt: Steuert ob im Cache-liegende Nodes entfernt oder aktualisiert werden sollen.
|}
===1.3.2 (31.07.2013)===
''Hotfix''
{|
| style="vertical-align:top;" | {{add}} || Rendering-Probleme korrigiert
|}
===1.3.1 (28.06.2013)===
''Hotfix''
{|
| style="vertical-align:top;" | {{fix}} || Rendering-Probleme bei mehrfach eingehängten Navigationspunkten
|-
| style="vertical-align:top;" | {{fix}} || Personalisierte Seiten werden nicht zuverlässig aus der Navigation ausgebunden
|}
===1.3 (25.06.2013)===
''Release''
{|
| style="vertical-align:top;" | {{add}} || Rubrikmodus implementieren
|-
| style="vertical-align:top;" | {{update}} || Performanzoptimierungen
|-
| style="vertical-align:top;" | {{fix}} || Personalisierte Artikel verursachen auf Serverseite einen Fehler
|-
| style="vertical-align:top;" | {{add}} || Die Navigation lässt sich nun einfacher erweitern, da nun auch alternative Rpc-Klassen übergeben werden können.
|}
===1.2===
''Release''
{|
| style="vertical-align:top;" | {{update}} || Performanzoptimierungen im Rendering
|-
| style="vertical-align:top;" | {{add}} || Konfigurierbare Url-Parameter
|}
===1.1.2 (11.01.2013)===
''Hotfixversion''
{|
| style="vertical-align:top;" | {{fix}} || Nativer Zurück-Button verursacht unter bestimmten Android Versionen Fehlerzustände
|}
===1.1.1 (14.12.2012)===
''Hotfix''
{|
| style="vertical-align:top;" | {{fix}} || Headline wird an der falschen Position gerendert
|}
===1.1 (30.11.2012)===
''Release''
{|
| style="vertical-align:top;" | {{update}} || Anpassung an neue IES-API Version
|}
===1.0.2===
''Hotfixversion''
{|
| style="vertical-align:top;" | {{fix}} || Nativer Zurück-Button verursacht unter bestimmten Android Versionen Fehlerzustände
|}
===1.0.1 (14.12.2012)===
''Hotfix''
{|
| style="vertical-align:top;" | {{fix}} || Headline wird an der falschen Position gerendert
|}
===1.0 (30.11.2012)===
''Release''
{|
| style="vertical-align:top;" | {{add}} || Initiale Implementierung
|}

Changelog Solr - Volltext Suchmaschine

2017-09-06T14:36:56Z

Schleuse: /* Anmerkungen */

<div class="noautonum">__TOC__</div>
==Release Notes==
====Anmerkungen====

<div class="note">
'''Änderungen in Version 2.0'''<br>
*Ab Version 2.0 wird Solr 6.6.0 verwendet. Der Index dieser Solr-Version ist inkompatibel mit dem bestehenden Index. Daher wird bei einem Update auf diese Version ein neues Index-Verzeichnis verwendet
WEBNODE_HOME/data/solr6
:Das bestehende Verzeichnis
WEBNODE_HOME/data/solr
:bleibt erhalten und sollte nach erfolgreichem Update gelöscht werden. Nach dem Update muss der Index über die vom IES bereit gestellte Konfigurations-Oberfläche für Solr der Index neu erstellt werden. Siehe [[Solr Konfiguration (ab Version 1.13)]]
* Solr 6.6.0 setzt Java 8 voraus. Hierfür muss vor dem Update darauf geachtet werden, dass auf dem Server Java 8 installiert ist.
* Solr kann nicht mehr wie bisher embedded im IES-Webnode laufen. Daher ist Solr jetzt als eigener Prozess ausgegliedert. Der IES-Webnode übernimmt aber weiterhin die Steuerung des Solr-Servers. Der IES-Webnode startet Solr wenn der IES-Webnode gestartet wird und stoppt Solr wenn der IES-Webnode gestoppt wird. Da Solr jetzt ein eigener Prozess ist muss die Speicherzuweisung für den IES-Webnode und Solr separat angegeben werden. Hierzu muss noch folgende Anpassung erfolgen:
: '''Linux'''
/etc/default/ies-webnode
:Die Speicherdefinition wie Z.B.
IES_JAVA_OPTIONS="-server -Xss8m -Xms1g -Xmx1g -XX:MaxPermSize=256m"
:muss z.B. auf
IES_JAVA_OPTIONS="-server -Xss8m -Xms256m -Xmx256m -Dsolr.memory=1g"
:geändert werden.
: '''Windows'''
IES_WEBNODE_HOME/ies-webnode.ini
:Die Speicherdefinition wie Z.B.
Virtual Machine Parameters=-Xms1024m -Xmx1024m ...
:muss z.B. auf
Virtual Machine Parameters=-Xms256m -Xmx256m -Dsolr.memory=1g ...
:geändert werden.
</div>

==Changelog==
===1.16-SNAPSHOT (22.08.2017)===
{|
|}
===1.15.1 (08.08.2017)===
''HotfixRelease''
{|
| style="vertical-align:top;" | {{fix}} || Bei der Such nach Mitarbeiter kann nicht über die Organisations-Token recherchiert werden (CityCall und VV-Intranet-Webseiten).
|}
===1.15 (01.08.2017)===
''Feature-Release''
{|
| style="vertical-align:top;" | {{update}} || SolrCoreUpdateDelayer: Solr wird nun maximal jede Minute mit URL-Listen versorgt
|}
===1.14.3 (19.06.2017)===
''Hotfeature-Release''
{|
| style="vertical-align:top;" | {{add}} || UI-Manager feuert nun nach dem Ersetzen des Suchergebnisses ein JavaScript Event
|}
===1.14.2 (08.06.2017)===
''HotfixRelease''
{|
| style="vertical-align:top;" | {{fix}} || Die Plugins (Tika Sitepark-Addons) werden nicht mehr korrekt ausgeführt.
|}
===1.14.1 (15.05.2017)===
{|
| style="vertical-align:top;" | {{fix}} || Bei Index mit zwei Webnodes können nicht parallel zwei Result-Tabs der jeweiligen Webnodes geöffnet werden
|}
===1.14 (15.05.2017)===
''Release''
{|
| style="vertical-align:top;" | {{add}} || Umstellung nach Webnode-Cluster-Support
|-
| style="vertical-align:top;" | {{add}} || Rendern des Suchergebnisses als XML
|-
| style="vertical-align:top;" | {{fix}} || Adhock-Indizierung läuft nicht korrekt bei PDF-Dateien (Medienartikel, Medien in Artikeln)
|}
===1.13.4 (28.04.2017)===
{|
| style="vertical-align:top;" | {{fix}} || Nach Umbenennung des Dateinames wird die alte Datei nicht aus dem Index entfernt
|}
===1.13.3 (24.04.2017)===
''Ho''
{|
| style="vertical-align:top;" | {{update}} || Das Euro Zeichen (€) wird beim Indizieren und Suchen ignoriert.
|}
===1.13.2 (13.04.2017)===
''Hotfix-Version''
{|
| style="vertical-align:top;" | {{fix}} || Quellen vom Type Intern-Extern werden nicht korrekt synchronisiert
|}
===1.13.1 (28.03.2017)===
''Hotfix Release''
{|
| style="vertical-align:top;" | {{add}} || URL's im Link-Header als weiterführende Links verwenden.
|-
| style="vertical-align:top;" | {{update}} || Die Funktion "Meinten Sie" liefert ungünstige Vorschläge
|}
===1.13 (27.02.2017)===
{|
| style="vertical-align:top;" | {{add}} || Konzept zur Adhoc-Indizierung ändern. Alle publizierten Artikel sollen in den Index
|-
| style="vertical-align:top;" | {{add}} || Neues Feld sp_meta_string_* dem Schema 2.0 hinzugefügt
|-
| style="vertical-align:top;" | {{fix}} || Abhängig von bestimmten Wortkombinationen, werden Produkte nicht aufgefunden
|-
| style="vertical-align:top;" | {{add}} || Schema 2.0 um Feld sp_objecttype erweitert
|-
| style="vertical-align:top;" | {{update}} || Refactoring: Crawler-Status nicht mehr im RAM sondern im Solr-Index
|}
===1.12.11 (03.04.2017)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Suggest: "list" Attribut wird nun vom jQuery-Plugin gesetzt
|}
===1.12.10 (24.03.2017)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{update}} || IES-Api Abhängigkeit auf 1.16 reduziert
|-
| style="vertical-align:top;" | {{fix}} || Kategorien-ID's werden nun wieder mit dem Prefix "id" verwendet
|}
===1.12.9 (02.03.2017)===
{|
| style="vertical-align:top;" | {{update}} || Suche nach Mitarbeiter mit dem Namen 'Ander' nicht möglich.
|}
===1.12.8 (22.08.2017)===
{|
| style="vertical-align:top;" | {{fix}} || Solr-Index wird nicht mehr aktualisiert, wenn Mandant deaktiviert und wieder aktiviert wird.
|-
| style="vertical-align:top;" | {{add}} || ResultSetFilters können nun auch mit Funktionen umgehen
|}
===1.12.7 (02.01.2017)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Nachtrag zu: Die Kategorie-Id's bei der Suche auch als Integer behandeln
|}
===1.12.6 (19.12.2016)===
''BugfixRelease''
{|
| style="vertical-align:top;" | {{update}} || Die Kategorie-Id's bei der Suche auch als Integer behandeln.
|}
===1.12.5 (08.12.2016)===
''BugfixRelease''
{|
| style="vertical-align:top;" | {{fix}} || Die Solr php-Api darf auch ohne installiertem Auth-Modul keine Fehler erzeugen.
|-
| style="vertical-align:top;" | {{fix}} || Bei extrem vielen Parameter für der zu indizierenden Seite kann der Request nicht vom Webnode (bzw Solr innerhalb des Webnode) entgegengenommen werden, da die Url über 8000 Zeichen lang sein kann.
|}
===1.12.4 (18.11.2016)===
''BugfixRelease''
{|
| style="vertical-align:top;" | {{fix}} || Crawler-Abhängikeit aktualisiert: URL-Parameter werden nicht korrekt decoded
|-
| style="vertical-align:top;" | {{update}} || Die 'Kölner' Phonetik wieder entfernt, die zu viele Begriffe aufgefunden wurden.
|-
| style="vertical-align:top;" | {{fix}} || Das Setzen von Boost-Parametern wird lediglich ergänzt und nicht ersetzt.
|}
===1.12.3 (15.11.2016)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{update}} || SiteKit: Suche nach personalisierten Resourcen
|}
===1.12.2 (14.11.2016)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{add}} || SiteKit: Suche nach personalisierten Resourcen
|}
===1.12.1 (26.10.2016)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Rollback auf Solr Version 4.10.3 aufgrund von Fehlern im Solr-Core
|}
===1.12 (25.10.2016)===
''Release''
{|
| style="vertical-align:top;" | {{add}} || spfix:* als Parameter, die auch nach der Normalisierung erhalten bleibem
|-
| style="vertical-align:top;" | {{fix}} || HTML-4 Metadaten auch für Medien untersützten
|-
| style="vertical-align:top;" | {{update}} || Ergänzung des StopwordFilters für die Url mit reduzierter Liste von Filterbegriffen.
|-
| style="vertical-align:top;" | {{add}} || Ergänzung der PhoneticFilterFactory für 'content' zur Gleichsetzung von Begriffen wie 'Meier', 'Mayer', 'Maier' und 'Meyer'
|-
| style="vertical-align:top;" | {{update}} || Update des Solr-Kerns von 4.10.2 auf 4.10.4
|-
| style="vertical-align:top;" | {{add}} || Darstellung des Suchergebnisses um Kunden-Optionen ergänzen
|}
===1.11.3 (13.09.2016)===
''BugfixRelease''
{|
| style="vertical-align:top;" | {{fix}} || Suchen mit mehreren Begriffen und aktivierter Wildcard-Suche liefern keine Ergebnisse, wenn auch mit Stopwords gesucht wird.
|}
===1.11.2 (04.08.2016)===
{|
|}
===1.11.1 (03.08.2016)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Dokumente ohne Titel werden nicht indiziert
|}
===1.11 (25.07.2016)===
''Release''
{|
| style="vertical-align:top;" | {{add}} || Auslesen von Personalisierungs-Daten (Gruppen) mit Hilfe des IES/Auth/Profile Objektes.
|-
| style="vertical-align:top;" | {{fix}} || Suche nach //abc erzeugen einen Fehler
|-
| style="vertical-align:top;" | {{add}} || Robots Meta-Tags unterstützen
|-
| style="vertical-align:top;" | {{add}} || HTTP-Status als neue Spalte im Crawler-Result
|-
| style="vertical-align:top;" | {{add}} || 'googleoff: index' und 'googleon: index' auswerten
|}
===1.10.1 (09.06.2016)===
''BugfixRelease''
{|
| style="vertical-align:top;" | {{fix}} || Bei der alphabetischen Sortierung von Suchergebnissen werden Umlaute falsch bewertet und nach allen Buchstaben eingeordnet.
|}
===1.10 (27.05.2016)===
''Release''
{|
| style="vertical-align:top;" | {{fix}} || Ein Ändern des Schemas erzeugt Probleme, da dieses in der Regel zu Inkompatibilitäten führt.
|-
| style="vertical-align:top;" | {{fix}} || Löschen von Indizes führt zu Fehlern
|-
| style="vertical-align:top;" | {{add}} || Bereichssuche: Überschrift einer Suche und Text für "Ihre Suche ergab keine Treffer." sind nun konfigurierbar
|-
| style="vertical-align:top;" | {{add}} || Live-Pagination
|-
| style="vertical-align:top;" | {{fix}} || GroupQuery wird nun korrekt gesetzt und ausgewertet
|-
| style="vertical-align:top;" | {{add}} || Mehrfaches einbinden der Bereichssuche in einer Seite
|}
===1.9.2 (27.04.2016)===
''BugfixRelease''
{|
| style="vertical-align:top;" | {{fix}} || Bei Binärdokumenten wird der Dateiname nun auch als Titel gesetzt wenn der automatisch ermittelte Titel leer ist.
|}
===1.9.1 (21.03.2016)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{add}} || Kategoriebäume als Checkbox darstellen
|-
| style="vertical-align:top;" | {{fix}} || Vorselektierte Kategorie wird bei der Ermittlung der Kategorienbäume nicht berücksichtigt
|-
| style="vertical-align:top;" | {{fix}} || Queries mit Leerzeichen am Ende erzeugten ungültige Solr-Anfragen
|}
===1.9 (11.02.2016)===
''Feature-Release''
{|
| style="vertical-align:top;" | {{add}} || Rückgabe von Auszügen (excerpts) aus den Inhalten der Suchergebnisse bei der Volltextsuche.
|-
| style="vertical-align:top;" | {{add}} || Neue Funktion zur Gruppierung von Suchergebnissen erstellt
|-
| style="vertical-align:top;" | {{add}} || Möglichkeit zur Filterung von archivierten Artikeln geschaffen und im Webseiten-Formular zur Verfügung gestellt.
|}
===1.8.3 (14.12.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{add}} || Filtering nach Datum: TimeZone wird nicht gesetzt
|-
| style="vertical-align:top;" | {{update}} || Bereichssuche: das Filtern nach einem Datum normalisieren
|-
| style="vertical-align:top;" | {{update}} || Bereichssuche: RSS-Rendering normalisieren
|-
| style="vertical-align:top;" | {{add}} || Personalisierung unterstützen
|}
===1.8.2 (10.12.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || RSS-Rendering: wenn mehrere ResultSets konfiguriert sind, werden diese nicht korrekt gerendert
|-
| style="vertical-align:top;" | {{fix}} || RSS-Rendering: div-Container der Bereichssuche wird fälschlicherweise gerendert
|}
===1.8.1 (26.11.2015)===
''Hot-Feature-Release''
{|
| style="vertical-align:top;" | {{add}} || Bereichssuche: Mehrsprachigkeit
|-
| style="vertical-align:top;" | {{add}} || Bereichssuche: Rendering des "Such-Containers" konfigurierbar machen
|}
===1.8 (16.11.2015)===
''Feature-Release''
{|
| style="vertical-align:top;" | {{update}} || PHP-Klassen auf Namespace umgestellt
|-
| style="vertical-align:top;" | {{fix}} || Bereichssuche: gesetzte Filter im Webinterface werden nicht als URL-Parameter an der Pagination angehangen
|-
| style="vertical-align:top;" | {{add}} || Bereichssuche: Filtern nach Datum: Feldname konfigurierbar machen
|-
| style="vertical-align:top;" | {{add}} || Bereichssuche: default return Fields von Solr erweiterbar machen
|-
| style="vertical-align:top;" | {{add}} || Bereichssuche: über mehrere Cores Suchen
|}
===1.7.10 (30.10.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Language wird bei Suggest nicht verwendet
|}
===1.7.9 (22.10.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || filter, sorting & facets Eigenschaften wurde nicht an der Instanz des SP.solr.Service Klasse gespeichert sondern an dessen Prototype
|}
===1.7.8 (15.10.2015)===
''Hotfix-Release + some new Features''
{|
| style="vertical-align:top;" | {{update}} || Wildcard-Suche optimieren
|-
| style="vertical-align:top;" | {{add}} || Bereichssuche: Vorgelagerte Kategorie-Filter als Baumstruktur mit "UND", "ODER", "NICHT" Filtermöglichkeiten
|-
| style="vertical-align:top;" | {{add}} || Bereichssuche: mehrere Filter pro ResultSet definieren
|-
| style="vertical-align:top;" | {{add}} || Bereichssuche: mehrere ResultSets darstellen
|-
| style="vertical-align:top;" | {{fix}} || Bereichssuche: Pagination-URL wird nicht korrekt gesetzt
|}
===1.7.7 (12.10.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{update}} || Verbesserung an der WildcardQuery
|-
| style="vertical-align:top;" | {{fix}} || Unter Umständen wird die WildcardQuery nicht korrekt zusammengebaut
|}
===1.7.6 (12.10.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Url's werden unter bestimmten Umständen nicht korrekt zusammengebaut
|}
===1.7.5 (09.10.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{update}} || Facetten Limit auf 1000 Einträge erhöhen
|}
===1.7.4 (18.08.2015)===
''Hotfix Release''
{|
| style="vertical-align:top;" | {{fix}} || Die AdHoc Indizierung wir bei aktivierter Verzögerung (interval Synchronisation) nicht ausgeführt.
|-
| style="vertical-align:top;" | {{fix}} || Beim ersten Starten der Indizierung eines Solr-Core kann es zu einem 'internal.error' kommen.
|-
| style="vertical-align:top;" | {{update}} || Bei komplexeren Index-Daten kann das Commit länger als der der interne TimeOut von 30 Sekunden dauern. Dieser Wert kann nun mit "-DsolrHttpTimeout=xxx" als Startparameter angepasst werden.
|}
===1.7.3 (17.06.2015)===
''Hotfix Release''
{|
| style="vertical-align:top;" | {{update}} || Die Eingabemaske der Bereichssuche umstrukturiert.
|-
| style="vertical-align:top;" | {{fix}} || Bei der Bereichssuche können keine Objekte gefunden werden, dessen Termin in der Zukunft liegt
|-
| style="vertical-align:top;" | {{update}} || Das Formular der Bereichssuch soll per 'get' übertragen werden, damit die Werte auch in einem RSS-Bookmark hinterlegt werden könnnen
|}
===1.7.2 (11.06.2015)===
''Bugfix Release''
{|
| style="vertical-align:top;" | {{update}} || Für den Veranstaltungskalender wurden die Felder sp_date_from und sp_date_to ergänzt, um optimaler nach den Veranstaltungen suchen zu können.
|-
| style="vertical-align:top;" | {{update}} || Für die Suche innerhalb von Bereichen (mit den PHP Komponenten) können nun Modul-Informationen übergeben werden, um den PHP-Autoloader mit den Daten des Kunden-Modules zu initialisieren.
|-
| style="vertical-align:top;" | {{fix}} || Bei der um einen Intervall verzögerten Indizierung kann es vorkommen, dass die Artikel erst Stunden später in dem Index aufgenommen werden, wenn weitere redaktionelle Änderungen erfolgten.
|}
===1.7.1 (28.04.2015)===
''Bugfix Release''
{|
| style="vertical-align:top;" | {{add}} || XSLT-lib Version 1.1 verwenden
|-
| style="vertical-align:top;" | {{fix}} || Seiten, die im Datei (oder Pfad) Namen den Begreff 'empfehlung' enthalten werden beim Indizieren fehlerhaft behandelt
|}
===1.7 (28.04.2015)===
''Feature-Release''
{|
| style="vertical-align:top;" | {{add}} || Bereitstellung von Templates und PHP Komponenten- und Render Klassen für die Bereichssuche innerhalb von ArtikelPool-Strukturen.
|-
| style="vertical-align:top;" | {{add}} || Neue Schema-Felder für geo_lat & geo_lng
|-
| style="vertical-align:top;" | {{add}} || Zeitzone bei der Suche berücksichtigen
|-
| style="vertical-align:top;" | {{update}} || Status in Administrations-Oberlfäche soll nur noch den Craw-Status anzeigen
|-
| style="vertical-align:top;" | {{add}} || XML-Import mit XSLT-Transormation für externe Daten
|-
| style="vertical-align:top;" | {{fix}} || PHP & Java Fehler wenn der Suchbegriff aus mehreren Tokens besteht und teilweise herausgefiltert wird
|}
===1.6.4 (06.01.2016)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{update}} || Wildcard-Suche optimieren
|}
===1.6.3 (01.04.2015)===
{|
| style="vertical-align:top;" | {{update}} || IES-API Version auf 1.12.1 gesetzt. Grund ist die Abwärtsinkompatibilität ab IES-Version 2.12.11 durch das setzten neue JDBC-Parameter
|}
===1.6.2 (10.03.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || VirtualHost-Namen der Publikationsbereiche werden beim Speichern der Solr-Konfiguration nicht an den Web-Node übertragen
|}
===1.6.1 (02.03.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Das Deaktivieren der 'Ad-Hoc-Synchronisation' des automatischen Crawlens in der Solr-Konfiguration wird nicht mehr korrekt ausgewertet wenn die Indizierung zusätzlich auch manuell (crontab) gestartet wird.
|}
===1.6 (19.02.2015)===
{|
| style="vertical-align:top;" | {{add}} || Update auf Cralwer-API 1.8
|}
===1.5.2 (09.02.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Darstellungsfehler in Konfigurationsoberfläche
|}
===1.5.1 (22.01.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || StackOverflowError beim deserialisieren der Crawl-Result Objekte abfangen
|-
| style="vertical-align:top;" | {{fix}} || SolrServer Singleton wird nicht synchronisiert erzeugt
|-
| style="vertical-align:top;" | {{fix}} || PHP liefert beim Ausgeben der Suchergebnisse Fehler. Zur Einhaltung der Abwärtskompatibilität muss dieses korrigiert werden.
|-
| style="vertical-align:top;" | {{fix}} || Solr hängt beim commiten des Index
|-
| style="vertical-align:top;" | {{fix}} || Updater-Thread wird nicht korrekt beendet
|}
===1.5 (01.12.2014)===
''Release''
{|
| style="vertical-align:top;" | {{update}} || Abhängigkeit auf die SP-Basis-PHP-Api Version 1.10 gesetzt.
|}
===1.4 (28.11.2014)===
''Release''
{|
| style="vertical-align:top;" | {{fix}} || Bei der Installation wird in der /etc/default/ies-webnode ein falscher Wert für XX:MaxPermSize geschrieben, so dass der Webnode mit weiteren Modulen nicht starten kann.
|-
| style="vertical-align:top;" | {{add}} || X-SP-Crawler HTTP-Header zur Auswertung in Web-Seiten
|-
| style="vertical-align:top;" | {{fix}} || Solr Konfiguration: Core wird trotz Fehlermeldung angelegt
|-
| style="vertical-align:top;" | {{update}} || Die Abhängigkeit zu der Solarium-API muss aufgelöst werden.
|-
| style="vertical-align:top;" | {{fix}} || Gleiche Url's mit mit unterschiedlichen Parameter werden bei Crawler.update() nicht aktualisiert
|-
| style="vertical-align:top;" | {{add}} || Adhoc Indizierung direkt nach Änderung der Webseite
|-
| style="vertical-align:top;" | {{fix}} || Adhoc Indizierung löscht zu viele Einträge beim Depublizieren
|-
| style="vertical-align:top;" | {{add}} || CrawlResult-Ansicht in der Solr-Konfigurationsoberfläche zeigt nicht den wirklichen Inhalt des Solr-Indexes an
|}
===1.3 (12.09.2014)===
''Feature-Release''
{|
| style="vertical-align:top;" | {{fix}} || Status-Column in der Übersicht hat kein Label
|-
| style="vertical-align:top;" | {{add}} || Anzeige der Core-Id im Übersichtsgrid
|-
| style="vertical-align:top;" | {{add}} || Start-Url standardmäßig in der Übersicht ausblenden
|-
| style="vertical-align:top;" | {{add}} || URL-Filter Ausnahme für Parameter mit bestimmten Wert
|-
| style="vertical-align:top;" | {{fix}} || Core mit mehreren Start-URL's werden nicht korrekt gecrawled, wenn die zweite Start-URL bereis über die erste Start-URL gefunden wurde.
|-
| style="vertical-align:top;" | {{add}} || Beschreibungstexte für die unterschiedlichen Normalizer Optionen
|-
| style="vertical-align:top;" | {{add}} || Einzelne Cores sollen deaktiviert werden können
|-
| style="vertical-align:top;" | {{add}} || Solr-Index direkt bei Änderungen im CMS aktualiseren
|-
| style="vertical-align:top;" | {{add}} || Nächtliches Crawlen pro Core deaktivieren
|-
| style="vertical-align:top;" | {{update}} || Auswahlmenü der Publisher in der Konfiguration der Cores sollte auch die Publisher-IDs anzeigen
|-
| style="vertical-align:top;" | {{update}} || Auswahl des Schema ist verpflichtend, da es sonst eine Exception gibt
|-
| style="vertical-align:top;" | {{add}} || URL's ohne Host-Namen des eingenen Web-Servers (und dessen Aliase) im Index speichern.
|-
| style="vertical-align:top;" | {{add}} || Update auf Solr 4.10.0
|-
| style="vertical-align:top;" | {{fix}} || Adhoc-Indizierung von Artikeln (new, modify, delete)
|}
===1.2.11 (03.09.2014)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || LinkError beim deploy
|}
===1.2.10 (02.09.2014)===
''Bugfix Release''
{|
| style="vertical-align:top;" | {{fix}} || Die Personalisierungs-Informationen werden bei der Suche nicht korrekt ausgewertet.
|}
===1.2.9 (31.07.2014)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Bei großen Websites funktioniert das Tiefen-Limit nicht korrekt
|}
===1.2.8 (03.06.2014)===
{|
| style="vertical-align:top;" | {{add}} || PHP Klassen erweitert
|}
===1.2.7 (27.05.2014)===
{|
|}
===1.2.6 (14.04.2014)===
''Hotfix- Release''
{|
| style="vertical-align:top;" | {{fix}} || Non-Proxy Einstellungen werden nicht ausgewertet
|}
===1.2.5 (01.04.2014)===
''Bugfix Release''
{|
| style="vertical-align:top;" | {{fix}} || Die Groß- Kleinschreibung wird bei den Attributen der VV-Objekten nicht korrekt ausgewertet.
|}
===1.2.4 (01.04.2014)===
''Bugfix Release''
{|
| style="vertical-align:top;" | {{update}} || Die Suggest- und Spellcheck Funktion zeigt die Vorschläge nun auch case-sensitive an.
|}
===1.2.3 (24.03.2014)===
''Hotfix- Release''
{|
| style="vertical-align:top;" | {{update}} || Net-API 1.3 einbinden, Crawler-API 1.5.1 einbinden, direkte Abhängigkeit zur Apache-HttpCommons-APi zu verhindern
|}
===1.2.2 (26.02.2014)===
''Bugfix''
{|
| style="vertical-align:top;" | {{fix}} || Probleme beim Parsen von Queries, die einen Punkte enthalten.
|}
===1.2.1 (13.02.2014)===
''Hotfix- Release''
{|
| style="vertical-align:top;" | {{fix}} || Suche im moduls wildcard = false liefert keine vollständige Trefferliste
|}
===1.2 (06.02.2014)===
''Minor Release''
{|
| style="vertical-align:top;" | {{add}} || GeoSpacial Search
|-
| style="vertical-align:top;" | {{fix}} || Unter bestimmten jQuery Versionen funktioniert die Suggest-Funktion nicht korrekt
|-
| style="vertical-align:top;" | {{update}} || Debug-Ausgaben im INFO Level
|-
| style="vertical-align:top;" | {{update}} || Neuen Rpc-Stack verwenden
|}
===1.1 (27.08.2013)===
''Feature-Release''
{|
| style="vertical-align:top;" | {{add}} || Open Funktion (Context-Menü) der Crawler-Results korrigiert
|-
| style="vertical-align:top;" | {{add}} || Überarbeitung der Index-Konfiguration Oberfläche
|}
===1.0.2 (18.02.2013)===
{|
|}
===1.0.1 (30.01.2013)===
{|
|}
===1.0 (30.01.2013)===
{|
| style="vertical-align:top;" | {{update}} || Datenbankverbindungen konfigurieren
|-
| style="vertical-align:top;" | {{update}} || Jetty ins System (Init-Sequenz) integrieren
|}

Changelog TinyMCE

2017-08-28T10:42:59Z

Schleuse: /* Hinweise */

<div class="noautonum">__TOC__</div>
====Hinweise====
<div class="note">
Mit der Version 5.0 des TinyMce Moduls wird der Support für den [https://www.tinymce.com/docs/changelog/#version460-may42017 Internet Explorer 8-10 eingestellt].
</div>

==Changelog==
===4.4 (09.02.2017)===
''Release''
{|
| style="vertical-align:top;" | {{add}} || OL konfigurierbar machen
|-
| style="vertical-align:top;" | {{update}} || Update auf TinyMce 4.5.3
|-
| style="vertical-align:top;" | {{add}} || Titel im Link wird nicht encodet
|-
| style="vertical-align:top;" | {{update}} || Systemlink-Icon im TinyMCE
|-
| style="vertical-align:top;" | {{add}} || OL konfigurierbar machen
|-
| style="vertical-align:top;" | {{update}} || Update auf TinyMce 4.5.3
|-
| style="vertical-align:top;" | {{add}} || Titel im Link wird nicht encodet
|-
| style="vertical-align:top;" | {{update}} || Systemlink-Icon im TinyMCE
|}
===4.3.2 (14.09.2016)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Tabelleneigenschaften im TinyMCE ist nicht lesbar
|-
| style="vertical-align:top;" | {{fix}} || Tabelleneigenschaften im TinyMCE ist nicht lesbar
|}
===4.3.1 (06.09.2016)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{update}} || Theme aktualisiert
|-
| style="vertical-align:top;" | {{fix}} || Es wird unter gewissen Umständen falsches Markup erzeugt
|-
| style="vertical-align:top;" | {{update}} || Theme aktualisiert
|-
| style="vertical-align:top;" | {{fix}} || Es wird unter gewissen Umständen falsches Markup erzeugt
|}
===4.3 (05.09.2016)===
''Release''
{|
| style="vertical-align:top;" | {{add}} || Update auf TinyMce Version 4.4.3
|-
| style="vertical-align:top;" | {{add}} || Update auf TinyMce Version 4.4.3
|}
===4.2.1 (29.10.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{update}} || Update auf TinyMce 4.2.7
|-
| style="vertical-align:top;" | {{fix}} || Abkürzungs- & Sprach-Icons sind vertauscht
|-
| style="vertical-align:top;" | {{update}} || Update auf TinyMce 4.2.7
|-
| style="vertical-align:top;" | {{fix}} || Abkürzungs- & Sprach-Icons sind vertauscht
|}
===4.2 (28.09.2015)===
''Release''
{|
| style="vertical-align:top;" | {{add}} || Copy & Paste Funktion: Text für den Hinweis, dass der Browser die Funktion nicht unterstützt ändern
|-
| style="vertical-align:top;" | {{update}} || Update auf TinyMce 4.2.6
|-
| style="vertical-align:top;" | {{update}} || File-Handling API anpassen
|-
| style="vertical-align:top;" | {{add}} || Copy & Paste Funktion: Text für den Hinweis, dass der Browser die Funktion nicht unterstützt ändern
|-
| style="vertical-align:top;" | {{update}} || Update auf TinyMce 4.2.6
|-
| style="vertical-align:top;" | {{update}} || File-Handling API anpassen
|}
===4.0.4 (17.12.2014)===
''Hotfix- Release''
{|
| style="vertical-align:top;" | {{fix}} || JavaScript Fehler im Internet Explorer, wegen eines Trailing Kommas
|-
| style="vertical-align:top;" | {{fix}} || JavaScript Fehler im Internet Explorer, wegen eines Trailing Kommas
|}
===4.0.3 (13.08.2014)===
''Hotfix- Release''
{|
| style="vertical-align:top;" | {{fix}} || Nach zweimaligen Bearbeiten eines Links geht die Information verloren ob der Link ein interner IES link ist oder nicht
|-
| style="vertical-align:top;" | {{add}} || JavaScript Fehler beim Aufruf des Verknüpfungsdialogs
|-
| style="vertical-align:top;" | {{fix}} || Nach zweimaligen Bearbeiten eines Links geht die Information verloren ob der Link ein interner IES link ist oder nicht
|-
| style="vertical-align:top;" | {{add}} || JavaScript Fehler beim Aufruf des Verknüpfungsdialogs
|}
===4.0.2 (08.08.2014)===
''Hotfix- Release''
{|
| style="vertical-align:top;" | {{fix}} || Interne Links können nicht bearbeitet werden
|-
| style="vertical-align:top;" | {{update}} || TinyMce auf Version 4.1.3 updaten
|-
| style="vertical-align:top;" | {{fix}} || Interne Links können nicht bearbeitet werden
|-
| style="vertical-align:top;" | {{update}} || TinyMce auf Version 4.1.3 updaten
|}
===4.0.1 (22.07.2014)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Fehlende CSS-Datei content.min.css
|-
| style="vertical-align:top;" | {{fix}} || Fehlende CSS-Datei content.min.css
|}
===4.0 (22.07.2014)===
''Release''
{|
|}

Changelog TinyMCE

2017-08-28T09:50:15Z

Schleuse:

<div class="noautonum">__TOC__</div>
====Hinweise====
<div class="note">
Mit der Version 4.5 des TinyMce Moduls wird der Support für den [https://www.tinymce.com/docs/changelog/#version460-may42017 Internet Explorer 8-10 eingestellt].
</div>
==Changelog==
===4.4 (09.02.2017)===
''Release''
{|
| style="vertical-align:top;" | {{add}} || OL konfigurierbar machen
|-
| style="vertical-align:top;" | {{update}} || Update auf TinyMce 4.5.3
|-
| style="vertical-align:top;" | {{add}} || Titel im Link wird nicht encodet
|-
| style="vertical-align:top;" | {{update}} || Systemlink-Icon im TinyMCE
|-
| style="vertical-align:top;" | {{add}} || OL konfigurierbar machen
|-
| style="vertical-align:top;" | {{update}} || Update auf TinyMce 4.5.3
|-
| style="vertical-align:top;" | {{add}} || Titel im Link wird nicht encodet
|-
| style="vertical-align:top;" | {{update}} || Systemlink-Icon im TinyMCE
|}
===4.3.2 (14.09.2016)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Tabelleneigenschaften im TinyMCE ist nicht lesbar
|-
| style="vertical-align:top;" | {{fix}} || Tabelleneigenschaften im TinyMCE ist nicht lesbar
|}
===4.3.1 (06.09.2016)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{update}} || Theme aktualisiert
|-
| style="vertical-align:top;" | {{fix}} || Es wird unter gewissen Umständen falsches Markup erzeugt
|-
| style="vertical-align:top;" | {{update}} || Theme aktualisiert
|-
| style="vertical-align:top;" | {{fix}} || Es wird unter gewissen Umständen falsches Markup erzeugt
|}
===4.3 (05.09.2016)===
''Release''
{|
| style="vertical-align:top;" | {{add}} || Update auf TinyMce Version 4.4.3
|-
| style="vertical-align:top;" | {{add}} || Update auf TinyMce Version 4.4.3
|}
===4.2.1 (29.10.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{update}} || Update auf TinyMce 4.2.7
|-
| style="vertical-align:top;" | {{fix}} || Abkürzungs- & Sprach-Icons sind vertauscht
|-
| style="vertical-align:top;" | {{update}} || Update auf TinyMce 4.2.7
|-
| style="vertical-align:top;" | {{fix}} || Abkürzungs- & Sprach-Icons sind vertauscht
|}
===4.2 (28.09.2015)===
''Release''
{|
| style="vertical-align:top;" | {{add}} || Copy & Paste Funktion: Text für den Hinweis, dass der Browser die Funktion nicht unterstützt ändern
|-
| style="vertical-align:top;" | {{update}} || Update auf TinyMce 4.2.6
|-
| style="vertical-align:top;" | {{update}} || File-Handling API anpassen
|-
| style="vertical-align:top;" | {{add}} || Copy & Paste Funktion: Text für den Hinweis, dass der Browser die Funktion nicht unterstützt ändern
|-
| style="vertical-align:top;" | {{update}} || Update auf TinyMce 4.2.6
|-
| style="vertical-align:top;" | {{update}} || File-Handling API anpassen
|}
===4.0.4 (17.12.2014)===
''Hotfix- Release''
{|
| style="vertical-align:top;" | {{fix}} || JavaScript Fehler im Internet Explorer, wegen eines Trailing Kommas
|-
| style="vertical-align:top;" | {{fix}} || JavaScript Fehler im Internet Explorer, wegen eines Trailing Kommas
|}
===4.0.3 (13.08.2014)===
''Hotfix- Release''
{|
| style="vertical-align:top;" | {{fix}} || Nach zweimaligen Bearbeiten eines Links geht die Information verloren ob der Link ein interner IES link ist oder nicht
|-
| style="vertical-align:top;" | {{add}} || JavaScript Fehler beim Aufruf des Verknüpfungsdialogs
|-
| style="vertical-align:top;" | {{fix}} || Nach zweimaligen Bearbeiten eines Links geht die Information verloren ob der Link ein interner IES link ist oder nicht
|-
| style="vertical-align:top;" | {{add}} || JavaScript Fehler beim Aufruf des Verknüpfungsdialogs
|}
===4.0.2 (08.08.2014)===
''Hotfix- Release''
{|
| style="vertical-align:top;" | {{fix}} || Interne Links können nicht bearbeitet werden
|-
| style="vertical-align:top;" | {{update}} || TinyMce auf Version 4.1.3 updaten
|-
| style="vertical-align:top;" | {{fix}} || Interne Links können nicht bearbeitet werden
|-
| style="vertical-align:top;" | {{update}} || TinyMce auf Version 4.1.3 updaten
|}
===4.0.1 (22.07.2014)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Fehlende CSS-Datei content.min.css
|-
| style="vertical-align:top;" | {{fix}} || Fehlende CSS-Datei content.min.css
|}
===4.0 (22.07.2014)===
''Release''
{|
|}

IES Bildverarbeitung

2017-07-27T10:58:46Z

Schleuse: /* Skalierung */

==Allgemein==
Alle vom IES verarbeiteten Bilder werden wie alle anderen Medien auch in der [[BinDB]] abgelegt. Die [[BinDB]] verwaltet alle Medien und stellt für Bilder erweiterte Funktionalitäten bereit, wie z.B. der Ermittlung von bildspezifischen Metadatan oder die Bereitstellung von Thumbnails.

Wird ein Bild im IES nochgeladen übernimmt die [[BinDB]] die Datei. Das System ermittelt die Metadaten des Bildes, analysiert die Farben des Bildes und skaliert die Bilder in folgenden Formaten:
:;40
::Bild wurde mit einer Höhe und Breite von 40 Pixeln mit <code>padding="off"</code> berechnet
:;h40
::Bild wurde mit einer Höhe von 40 Pixel und einer Breite proportional zum Original mit <code>padding="off"</code> berechnet
:;100
::Bild wurde mit einer Höhe und Breite von 100 Pixeln mit <code>padding="off"</code> berechnet
:;500
::Bild wurde mit einer Höhe und Breite von 500 Pixeln mit <code>padding="off"</code> berechnet
:;1000
::Bild wurde mit einer Höhe und Breite von 1000 Pixeln mit <code>padding="off"</code> berechnet
:;2000
::Bild wurde mit einer Höhe und Breite von 2000 Pixeln mit <code>padding="off"</code> berechnet

Diese Formate werden für folgende Fälle benötigt:
;Als Vorschaubilder der Dateien in der [[BinDB]]: Diese werden z.B. in Infosite genutzt. Alle in der Infosite-Oberfläche angezeigten Bilder aus der BinDB verwenden eines der oben aufgelisteten Formate.
;Basis-Datei für die Skalierung publizierter Bilder: Aus Performanzgründen können die Bildformate die für die Webseite benötigt werden nicht immer vom Original berechnet werden. Durch heutige Kameras werden so große Bilder erzeugt, dass das System nicht mehr in der Lage ist die geforderten Bildformate in akzeptabler Zeit aus den Original-Bildern zu erzeugen. Daher werden die Bilder aus einem bereits verkleinerten Basisbild berechnet, das aber noch größer ist als das gewünschte Format.

==Metadaten==
Erkennt die [[BinDB]] ein Medium als Bild werden folgende Metadaten ermittelt:
* Mime-Type
* Dateigröße
* Breite in Pixel
* Höhe in Pixel
* Bildformat (jpg, png, gif, ...)
* [[#Präsente Farben|Präsente Farben]]
* [[#Neun Pixel Bild|Neun Pixel Bild]]
* Copyright des Bildes
: Hier wird das IPTC-Feld "[https://www.iptc.org/std/photometadata/specification/IPTC-PhotoMetadata#copyright-notice Copyright Notice]" verwendet. Ist dies nicht gefüllt wird das [http://www.exiv2.org/tags.html Exif]-Feld "Exif.Image.Copyright" (Tag-ID 0x8298) verwendet.
* Titel des Bildes
: Hier wird das TPTC-Feld "[https://www.iptc.org/std/photometadata/specification/IPTC-PhotoMetadata#headline Headline]" verwendet. Ist dies nicht gefüllt wird das [http://www.exiv2.org/tags.html Exif]-Feld "Exif.Image.ImageDescription" (Tag-ID 0x010e) verwendet.
* Beschreibung des Bildes. Hier wird das IPTC-Feld "[https://www.iptc.org/std/photometadata/specification/IPTC-PhotoMetadata#description Caption/Abstract]" verwendet.
* Checksumme

==Promimente Farben==

Prominente Farben sind die Farben eines Bildes die besonders hervorstechen. Zur Ermittlung der prominenten Farben werden die Farben eines Bildes analysiert. Dabei werden die Farben nach Sättigung, Helligkeit, und Häufigkeit bewertet. Mit diesen Bewertungskriterien werden sechs Farbwerte ermittelt:

* Light Vibrant
* Vibrant
* Dark Vibrant
* Light Muted
* Muted
* Dark Muted

Nicht immer erfüllen alle Farben eines Bildes die Bewertungskriterien, daher ist es möglich, das für einige Bilder kein Farbwert für eine Kategorie ermittelt werden kann.

Hier einige Beispiele für die ermittelten Farben.

[[Bild:Prominente_Farben.png|center|frame|Prominente Farben]]

==Neun Pixel Bild==

Der IES stellt für jedes Bild ein ''Neun Pixel Bild'' zur Verfügung. Dies wird erzeugt, in dem das Bild auf 3x3 Pixel klein gerechnet wird.
Dieses ''Mini-Bild'' kann z.B. mit
<img src="data:image/gif;base64,...">
eingebunden werden, das solange angezeigt wird, bis das richtige Bild vom Browser geladen wurde.

Beispiele für ein ''Neue Pixel Bild''

[[Bild:Neun_Pixel_Bilder.png|center|frame|Neun Pixel Bilder]]

Für das ''neun Pixel Bild'' wird die gewünschte Bildgrößen per HTML bzw. CSS definiert. Durch die Skalierung des Browsers werden die neue Pixel vergrößert und weich gezeichnet.

==Skalierung==
Beim Hochladen eines Bildes in den IES, wird es automatisch in verschiedene Bildformate skaliert (Siehe oben). Diese Bildformate werden z.B. für Infosite 6 verwenden.

Für Bilder die auf einer Webseite angezeigt werden sollen, werden alle gewünschten Formate zum Generierungszeitpunkt erzeugt.

Bilder werden skaliert, in dem die gewünschte Größe angegeben wird. Hier kann die Höhe und die Breite in Pixel angegeben werden. Es ist auch möglich nur die Höhe oder nur die Breite anzugeben, dann wird der fehlende Wert anhand des Seitenverhältnisses des Bildes ermittelt.

Es gibt zwei Regeln, die beim Skalieren des Bildes immer gelten:
;Ein Bild wird nie vergrößert: Ist das Original-Bild kleiner als die gewünschte Größe wird das Bild nicht vergrößert sondern behält seine Größe. Um die gewünschte Bildgröße zu erreichen kann die Padding-Option verwendet werden oder lässt bei der Anzeigen das Bild vom Browser vergrößern.
;Bilder werden nicht verzerrt: Entspricht das Seitenverhältnis des Original-Bildes nicht dem Seitenverhältnis der gewünschten Größe, wird das Bild nicht verzerrt um das neue Seitenverhältnis zu erreichen. Hierbei bildet die gewünschte Größe einen Rahmen und das Bild wird soweit verkleinert, bis es in diesen Rahmen passt. Um die gewünschte Bildgröße dennoch zu erreichen kann die Padding-Option verwendet werden.

===Steuerung der Skalierung===

Für die Skalierung eines Bildes gibt es zwei Optionen mit denen sich die Berechnung des Bildes steuern lässt.

====Padding====
Aufgrund der zwei Regeln, dass das Bild nicht vergrößert und nicht verzerrt wird, kann die gewünschte Bildgröße nicht immer erreicht werden. Manchmal ist es aber gewünscht, dass das erzeugte Bild exakt die gewünscht Bildgröße hat. Für diese Fall kann die Padding-Option verwendet werden. Für den Fall, dass des Original-Bild zu klein ist, wird ein Rahmen um das Bild gelegt um die gewünschte Größe zu erreichen. Für den Fall, dass das Seitenverhältnis nicht passt, wird entweder rechts und links oder oben und unten eine Fläche hinzugefügt. Die Farbe des Paddings ist dabei definierbar.

[[Datei:Padding.jpg|Padding rechts und links]]

====Fit====
Mit der Option Fit gibt es eine zweite Möglichkeit ein Bild in der gewünschten Größe zu erhalten, wenn das Seitenverhältnis nicht passt. Hierbei werden nicht wie bei Padding ein Rahmen hinzugefügt, sondern das Bild wird beschnitten. Hierbei wird das Bild soweit verkleinert bis entweder die Höhe oder die Breite dem vorgegebenen Wert entspricht. Um die gewünschte Größe dann zu erreichen wird entweder oben und untern oder rechts und links das Bild beschnitten.

[[Datei:Fit.jpg|Fit oben und unten]]

Im Standard-Fall wird das Bild zu gleichen Teilen oben und unten bzw. rechts und links abgeschnitten. In einigen Fällen ist es aber Sinnvoll z.B. oben mehr zu beschneiden als unten, um wichtige Teiles des Bildes zu erhalten. Hiefür kann für das Bild ein '''Fokus-Punkt''' definiert werden. Damit wird das Bild so beschnitten, dass der Fokus-Punkt soweit wie möglich in der Bildmitte liegt.

[[Datei:Fit-focusPoint.jpg|Fit oben und unten mit Fokus-Punkt]]

Dennoch gibt es auch hier den Fall, dass das Original-Bild kleiner ist, als die gewünscht Bildgröße. Soll auch in diesem Fall die Bildgröße sichergestellt werden, muss die Option ''Fit'' zusammen mit der Option ''Padding'' verwendet werden.

===Bildformate===
Browser können Bilder nur im Format GIF, PNG und JPG darstellen. Der IES verarbeitet aber auch Bild anderer Formate. Es werden alle Formate unterstützt dessen MIME-Type mit 'image/' beginnen und von ImageMagick unterstützt werden (Siehe [https://www.imagemagick.org/script/formats.php hier]). Bei der Skalierung der Bilder werden die nicht Browser-kompatiblen Formate in kompatible Formate umgewandelt. Hierbei gelten folgende Regeln:
;GIF: Das Bild wird wieder im GIF-Format gespeichert. Enthält das GIF mehrere Frames (animiertes GIF) wird nur das erste Frame verwendet.
;PNG, JPG: Die Bilder bleiben in ihrem Format erhalten.
;SVG: Bilder im SVG-Format werden als PNG gespeichert.
;alle anderen Formate: Alle anderen Formate werden im JPG-Format gespeichert.

===Metadaten===
Ein Ziel für die skalierten Bilder ist es, die resultierende Datei möglicht klein zu halten. Dies kann unter anderem dadurch erreicht werden, die Metadaten des Originals nicht komplett in den skalierten Bilder zu übernehmen. Daher werden nur folgende Metadaten gesetzt:
* IPTC-Feld "[https://www.iptc.org/std/photometadata/specification/IPTC-PhotoMetadata#copyright-notice Copyright Notice]"
* ITPC-Feld "[https://www.iptc.org/std/photometadata/specification/IPTC-PhotoMetadata#headline Headline]"
* ITPC-Feld "[https://www.iptc.org/std/photometadata/specification/IPTC-PhotoMetadata#description Caption/Abstract]"

IES Bildverarbeitung

2017-07-27T10:52:17Z

Schleuse: /* Allgemein */

==Allgemein==
Alle vom IES verarbeiteten Bilder werden wie alle anderen Medien auch in der [[BinDB]] abgelegt. Die [[BinDB]] verwaltet alle Medien und stellt für Bilder erweiterte Funktionalitäten bereit, wie z.B. der Ermittlung von bildspezifischen Metadatan oder die Bereitstellung von Thumbnails.

Wird ein Bild im IES nochgeladen übernimmt die [[BinDB]] die Datei. Das System ermittelt die Metadaten des Bildes, analysiert die Farben des Bildes und skaliert die Bilder in folgenden Formaten:
:;40
::Bild wurde mit einer Höhe und Breite von 40 Pixeln mit <code>padding="off"</code> berechnet
:;h40
::Bild wurde mit einer Höhe von 40 Pixel und einer Breite proportional zum Original mit <code>padding="off"</code> berechnet
:;100
::Bild wurde mit einer Höhe und Breite von 100 Pixeln mit <code>padding="off"</code> berechnet
:;500
::Bild wurde mit einer Höhe und Breite von 500 Pixeln mit <code>padding="off"</code> berechnet
:;1000
::Bild wurde mit einer Höhe und Breite von 1000 Pixeln mit <code>padding="off"</code> berechnet
:;2000
::Bild wurde mit einer Höhe und Breite von 2000 Pixeln mit <code>padding="off"</code> berechnet

Diese Formate werden für folgende Fälle benötigt:
;Als Vorschaubilder der Dateien in der [[BinDB]]: Diese werden z.B. in Infosite genutzt. Alle in der Infosite-Oberfläche angezeigten Bilder aus der BinDB verwenden eines der oben aufgelisteten Formate.
;Basis-Datei für die Skalierung publizierter Bilder: Aus Performanzgründen können die Bildformate die für die Webseite benötigt werden nicht immer vom Original berechnet werden. Durch heutige Kameras werden so große Bilder erzeugt, dass das System nicht mehr in der Lage ist die geforderten Bildformate in akzeptabler Zeit aus den Original-Bildern zu erzeugen. Daher werden die Bilder aus einem bereits verkleinerten Basisbild berechnet, das aber noch größer ist als das gewünschte Format.

==Metadaten==
Erkennt die [[BinDB]] ein Medium als Bild werden folgende Metadaten ermittelt:
* Mime-Type
* Dateigröße
* Breite in Pixel
* Höhe in Pixel
* Bildformat (jpg, png, gif, ...)
* [[#Präsente Farben|Präsente Farben]]
* [[#Neun Pixel Bild|Neun Pixel Bild]]
* Copyright des Bildes
: Hier wird das IPTC-Feld "[https://www.iptc.org/std/photometadata/specification/IPTC-PhotoMetadata#copyright-notice Copyright Notice]" verwendet. Ist dies nicht gefüllt wird das [http://www.exiv2.org/tags.html Exif]-Feld "Exif.Image.Copyright" (Tag-ID 0x8298) verwendet.
* Titel des Bildes
: Hier wird das TPTC-Feld "[https://www.iptc.org/std/photometadata/specification/IPTC-PhotoMetadata#headline Headline]" verwendet. Ist dies nicht gefüllt wird das [http://www.exiv2.org/tags.html Exif]-Feld "Exif.Image.ImageDescription" (Tag-ID 0x010e) verwendet.
* Beschreibung des Bildes. Hier wird das IPTC-Feld "[https://www.iptc.org/std/photometadata/specification/IPTC-PhotoMetadata#description Caption/Abstract]" verwendet.
* Checksumme

==Promimente Farben==

Prominente Farben sind die Farben eines Bildes die besonders hervorstechen. Zur Ermittlung der prominenten Farben werden die Farben eines Bildes analysiert. Dabei werden die Farben nach Sättigung, Helligkeit, und Häufigkeit bewertet. Mit diesen Bewertungskriterien werden sechs Farbwerte ermittelt:

* Light Vibrant
* Vibrant
* Dark Vibrant
* Light Muted
* Muted
* Dark Muted

Nicht immer erfüllen alle Farben eines Bildes die Bewertungskriterien, daher ist es möglich, das für einige Bilder kein Farbwert für eine Kategorie ermittelt werden kann.

Hier einige Beispiele für die ermittelten Farben.

[[Bild:Prominente_Farben.png|center|frame|Prominente Farben]]

==Neun Pixel Bild==

Der IES stellt für jedes Bild ein ''Neun Pixel Bild'' zur Verfügung. Dies wird erzeugt, in dem das Bild auf 3x3 Pixel klein gerechnet wird.
Dieses ''Mini-Bild'' kann z.B. mit
<img src="data:image/gif;base64,...">
eingebunden werden, das solange angezeigt wird, bis das richtige Bild vom Browser geladen wurde.

Beispiele für ein ''Neue Pixel Bild''

[[Bild:Neun_Pixel_Bilder.png|center|frame|Neun Pixel Bilder]]

Für das ''neun Pixel Bild'' wird die gewünschte Bildgrößen per HTML bzw. CSS definiert. Durch die Skalierung des Browsers werden die neue Pixel vergrößert und weich gezeichnet.

==Skalierung==
Beim Hochladen eines Bildes in den IES, wird es automatisch in verschiedene Bildformate skaliert (Siehe oben). Diese Bildformate werden z.B. für Infosite 6 verwenden.

Für Bilder die auf einer Webseite angezeigt werden sollen, werden alle gewünschten Formate zum Generierungszeitpunkt erzeugt.

Bilder werden skaliert, in dem die gewünschte Größe angegeben wird. Hier kann die Höhe und die Breite in Pixel angegeben werden. Es ist auch möglich nur die Höhe oder nur die Breite anzugeben, dann wird der fehlende Wert anhand des Seitenverhältnisses des Bildes ermittelt.

Es gibt zwei Regeln, die beim Skalieren des Bildes immer gelten:
;Ein Bild wird nie vergrößert: Ist das Original-Bild kleine als die gewünschte Größe wird das Bild nicht vergrößert sondern behält seine Größe. Um die gewünschte Bildgröße zu erreich kann die Padding-Option verwendet werden oder lässt bei der Anzeigen das Bild vom Browser vergrößern.
;Bilder werden nicht verzerrt: Entspricht das Seitenverhältnis des Original-Bildes nicht dem Seitenverhältnis der gewünschten Größe, wird das Bild nicht verzerrt um das neue Seitenverhältnis zu erreichen. Hierbei bildet die gewünschte Größe einen Rahmen und das Bild wird soweit verkleinert, bis es in diesen Rahmen passt. Um die gewünschte Bildgröße dennoch zu erreich kann die Padding-Option verwendet werden.

===Steuerung der Skalierung===

Für die Skalierung eines Bildes gibt es zwei Optionen mit denen sich die Berechnung des Bildes steuern lässt.

====Padding====
Aufgrund der zwei Regeln, dass das Bild nicht vergrößert und nicht verzerrt wird, kann die gewünscht Bildgröße nicht immer erreicht werden. Manchmal ist es aber gewünscht, dass das erzeugte Bild exakt die gewünscht Bildgröße hat. Für diese Fall kann die Padding-Option verwendet werden. Für den Fall, dass des Original-Bild zu klein ist, wird ein Rahmen und das Bild gelegt um die gewünschte Größe zu erreichen. Für den Fall, dass das Seitenverhältnis nicht passt, wird entweder rechts und links oder oben und unten eine Fläche hinzugefügt. Die Farbe des Paddings ist dabei definierbar.

[[Datei:Padding.jpg|Padding rechts und links]]

====Fit====
Mit der Option Fit gibt es eine zweite Möglichkeit ein Bild in der gewünschten Größe zu erhalte, wenn das Seitenverhältnis nicht passt. Hierbei werden nicht wie bei Padding ein Rahmen hinzugefügt, sondern das Bild wird beschnitten. Hierbei wird das Bild soweit verkleinert bis entweder die Höhe oder die Breite dem vorgegebenen Wert entspricht. Um die gewünschte Größe dann zu erreichen wird entweder oben und untern oder rechts und links das Bild beschnitten.

[[Datei:Fit.jpg|Fit oben und unten]]

Im Standard-Fall wird das Bild zu gleichen Teilen oben und unten bzw. rechts und links abgeschnitten. In einigen Fällen ist es aber Sinnvoll z.B. oben mehr zu beschneiden als unten, um wichtige Teiles des Bildes zu erhalten. Hiefür kann für das Bild ein '''Fokus-Punkt''' definiert werden. Damit wir das Bild so beschnitten, dass der Fokus-Punkt soweit wie möglich in der Bildmitte liegt.

[[Datei:Fit-focusPoint.jpg|Fit oben und unten mit Fokus-Punkt]]

Dennoch gibt es auch hier den Fall, dass das Original-Bild kleiner ist als die gewünscht Bildgröße. Soll auch in diesem Fall die Bildgröße sichergestellt werden, muss die Option ''Fit'' zusammen mit der Option ''Padding'' verwendet werden.

===Bildformate===
Browser können Bilder nur im Format GIF, PNG und JPG darstellen. Der IES verarbeitet aber auch Bild anderer Formate. Es werden alle Formate unterstütz dessen MIME-Type mit 'image/' beginnt und von ImageMagick unterstützt wird (Siehe [https://www.imagemagick.org/script/formats.php hier]). Bei der Skalierung der Bilder werden die nicht Browser-kompatiblen Formate in kompatible Formate umgewandelt. Hierbei gelten folgende Regeln:
;GIF: Das Bild wird wieder im GIF-Format gespeichert. Enthält das GIF mehrere Frames (animiertes GIF) wird nur das erste Frame verwendet.
;PNG, JPG: Die Bilder bleiben in ihrem Format erhalten.
;SVG: Bilder im SVG-Format werden als PNG gespeichert.
;alle anderen Formate: Alle anderen Formate werden im JPG-Format gespeichert.

===Metadaten===
Ein Ziel für die skalierten Bilder ist es, die resultierende Datei möglicht klein zu halten. Dies kann unter anderem dadurch erreicht werden, die Metadaten des Originals nicht komplett in den skalierten Bilder zu übernehmen. Daher werden nur folgende Metadaten gesetzt:
* IPTC-Feld "[https://www.iptc.org/std/photometadata/specification/IPTC-PhotoMetadata#copyright-notice Copyright Notice]"
* ITPC-Feld "[https://www.iptc.org/std/photometadata/specification/IPTC-PhotoMetadata#headline Headline]"
* ITPC-Feld "[https://www.iptc.org/std/photometadata/specification/IPTC-PhotoMetadata#description Caption/Abstract]"

Changelog Basis-PHP-API

2017-01-13T17:02:32Z

Schleuse: /* Anmerkungen */

<div class="noautonum">__TOC__</div>
==Anmerkungen==
<div class="note">
Voraussetzung für die Version 1.8 der Basis-Php-Api ist die <b>PHP Version 5.3</b> oder höher!
</div>

<div class="note">
Ab der Version 1.16 wird die PHP-Erweiterung <em>mcrypt</em> nicht mehr benötigt, da die kryptografischen Bestandteile auf die <em>openssl</em>-Erweiterung umgestellt wurden.

Bitte vor dem Update auf die Version 1.16 sicherstellen, dass die <em>openssl</em>-Erweiterung installiert und aktiviert ist.
</div>

==Changelog==
===1.15.1 (25.10.2016)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || SP\Util\Html5:autoParagraph(string) ignoriert einzelne <br>
|}
===1.15 (24.10.2016)===
''Feature-Release''
{|
| style="vertical-align:top;" | {{add}} || Neue Methoden SP\Util\Html5::toText() und SP\Util\Html5::purify()
|-
| style="vertical-align:top;" | {{update}} || Umstieg von Zend-Http-Client auf GuzzleHttp\Client
|}
===1.14.4 (21.09.2016)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Notices in der HTML5:autoParagraph Methode
|}
===1.14.3 (08.09.2016)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || \SP\Util\Html5: purify(), toText() für PHP Version < 5.5 bereitsstellen
|}
===1.14.2 (10.08.2016)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || PHP-Fehler wegen Namespace-Umstellung in SP\ObjectData
|}
===1.14.1 (01.08.2016)===
''Hotfix-Release''
{|
|}
===1.14 (25.07.2016)===
''Release''
{|
| style="vertical-align:top;" | {{add}} || Adapter für Zend_Http & GuzzleHttp
|-
| style="vertical-align:top;" | {{add}} || getCountryCode() am User hinzugefügt
|-
| style="vertical-align:top;" | {{add}} || Html5-Utils Klasse implementiert
|-
| style="vertical-align:top;" | {{fix}} || Korrekturen für den HTTP-Client
|-
| style="vertical-align:top;" | {{add}} || Neue Methode SP\Util\Objects::coalesce()
|-
| style="vertical-align:top;" | {{update}} || SP\Util\Format::fileSize Berechnung nicht mehr mit einem Vielfachen von 1024 sondern von 1000
|}
===1.13.2 (07.07.2016)===
''BugfixRelease''
{|
| style="vertical-align:top;" | {{fix}} || Beim Hinzufügen von Objekt-Daten, die bereis gültige JSON-Objekt Instanzen sind, wird fälschlicherweise eine Exception von der ObjectData-Klasse geworfen.
|}
===1.13.1 (14.03.2016)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || SP\Net\Rpc\Client\Method->createUpload() wirft Zend_Uri_Exception: Invalid URI supplied
|}
===1.13 (11.02.2016)===
''Feature Release''
{|
| style="vertical-align:top;" | {{update}} || Einbindung von externer Bibliothekt (mobiledetect/mobiledetectlib) zur Ermittlung von Mobil-Geräten (SP\User::isMobile())
|-
| style="vertical-align:top;" | {{update}} || PHP-Klassen auf Namespace umgestellt
|}
===1.12.5 (14.01.2016)===
''Hotfix-Release''
{|
|}
===1.12.4 (05.01.2016)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || UTF-16 Chars werden bei Json_Object und Json_Array nicht korrekt encodiert
|}
===1.12.3 (18.12.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{add}} || Methoden zum Ermitteln der Proxy-Setzungen als Curl-String hinzugefügt
|}
===1.12.2 (17.12.2015)===
''Hotfix Release''
{|
| style="vertical-align:top;" | {{update}} || Erweiterung der PHP-Locales um IES-spezifische Angaben
|}
===1.12.1 (09.12.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{add}} || Locale-Klasse zum korrekten setzen des Locales implementiert
|}
===1.12 (15.10.2015)===
''Release''
{|
| style="vertical-align:top;" | {{add}} || Neue Klasse SP_Util_Number
|-
| style="vertical-align:top;" | {{add}} || SP_Json_Object::putAll implementiert
|-
| style="vertical-align:top;" | {{add}} || Neues Package SP_Email zum senden von E-Mails
|-
| style="vertical-align:top;" | {{update}} || SP_Net_Http_Client_Connection: ein Timeout kann nun gesetzt werden
|}
===1.11.2 (01.07.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{update}} || SP_Net_Http_Client_Connection: ein Timeout kann nun gesetzt werden
|}
===1.11.1 (24.04.2015)===
''Bugfix Release''
{|
| style="vertical-align:top;" | {{fix}} || Fehler innerhalb der Funktion toJson der Klasse SP_Util_Object bzw. SP_Util_Array
|}
===1.11 (05.03.2015)===
''Release''
{|
| style="vertical-align:top;" | {{add}} || SP_Util_Proxy implementiert um eine zentrale Proxy-Steuerung zu ermöglichen
|-
| style="vertical-align:top;" | {{add}} || Es muss der zu verwendende Proxy auf dem Webserver ermittelt werden können
|}
===1.10.2 (28.01.2015)===
''Bugfix Release''
{|
| style="vertical-align:top;" | {{fix}} || getAttribute der Klasse SP_Util_Attributable liefert den Default-Wert nicht zurück.
|}
===1.10.1 (07.01.2015)===
''Bugfix Release''
{|
| style="vertical-align:top;" | {{fix}} || Fehler im Konsturktor der Klasse SP_ObjectDate, wenn diesem ein SP_Json_Objekt übergben wird.
|}
===1.10 (01.12.2014)===
''Release''
{|
| style="vertical-align:top;" | {{update}} || Extrahierung der HttpClient Funktionen aus dem RPC-Client um diese auch direkt in anderen Modulen nutzen zu können.
|-
| style="vertical-align:top;" | {{fix}} || Notice wenn der optionale HTTP Header User Agent nicht mitgesendet wird
|-
| style="vertical-align:top;" | {{update}} || Die Klasse SP_Util_Crypt sollte die Deprecated Funtion mcrypt_ecb() nicht benutzten
|}
===1.9.2 (14.11.2014)===
''Hotfix- Release''
{|
| style="vertical-align:top;" | {{fix}} || ResourceBaseDir wird in Publikationsbereichen mit Publisher Directory falsch ermittelt
|}
===1.9.1 (02.10.2014)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{add}} || SP_Net_URL::getBaseUrl() Methode
|}
===1.9 (25.09.2014)===
''Feature-Release''
{|
| style="vertical-align:top;" | {{add}} || SP_Context kann nun auch mit PHP-Klassen umgehen die Namespaces nutzen
|-
| style="vertical-align:top;" | {{add}} || SP_Context sollte auch Klassen verarbeiten können die Namespaces nutzen
|-
| style="vertical-align:top;" | {{fix}} || Entschlüsseln eines Strings mittels SP_Util_Crypt::decrypt() liefert einen String mit Null Bytes am Ende
|-
| style="vertical-align:top;" | {{fix}} || SP_System_MemInfo wirft unter Windows Fehler da kein /proc/meminfo existiert
|-
| style="vertical-align:top;" | {{add}} || SP_Json_Iterator gegen SP_Util_Iterator ersetzt
|}
===1.8.2 (12.05.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{update}} || SP_Net_Rpc_Client_Connection: ein Timeout kann nun gesetzt werden
|}
===1.8.1 (11.09.2014)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{update}} || SP_Context::getBaseDir() muss immer mit einem / enden
|}
===1.8 (04.08.2014)===
''Minor Release''
{|
| style="vertical-align:top;" | {{add}} || Classloader für SP_Context
|-
| style="vertical-align:top;" | {{fix}} || SP_Context->getModuleBasePath() - Symlinks werden bei der Ermittlung des "ModuleBasePaths" nicht berücksichtigt
|-
| style="vertical-align:top;" | {{update}} || requre_once durch SP_Context::requireClasses() bzw SP_Context::requireClass() ersetzten
|-
| style="vertical-align:top;" | {{add}} || Neue Methode SP_Net_Url::toEncodedHtml()
|-
| style="vertical-align:top;" | {{add}} || Funktionen, um System Informationen (PHP, MEM, DISK) auszulesen.
|-
| style="vertical-align:top;" | {{fix}} || SP_Json_Object: optLong() geändert zu optPhpPseudoLongAsFloat()
|}
===1.7.1 (12.06.2014)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || use_only_cookies wird über SP_Context nicht auf auf 'off' gesetzt
|}
===1.7 (25.03.2014)===
''Minor Release''
{|
| style="vertical-align:top;" | {{update}} || SP_Json_Array::put prüft nun die Parameter auf Typ und Anzahl und wirft gegebenenfalls eine IllegalArgumentException
|-
| style="vertical-align:top;" | {{fix}} || Das Entfernen eines Attributes aus einem SP_Json_Object wirft eine Exception
|-
| style="vertical-align:top;" | {{fix}} || Context::loadModuleClass() - includePath wird beim "require_once" nicht verwendet
|-
| style="vertical-align:top;" | {{fix}} || Context::loadClass() - includePath wird beim "require_once" nicht verwendet
|-
| style="vertical-align:top;" | {{fix}} || SP_Json_Object: optLong() geändert zu optPhpPseudoLongAsFloat()
|-
| style="vertical-align:top;" | {{update}} || Konfigurationsparameter für SP_Context implementieren damit verhindert werden kann, dass eine Session gestartet wird
|}
===1.6.1 (28.02.2014)===
{|
| style="vertical-align:top;" | {{add}} || JSONArray- und JSONObject-Konstruktor soll String aufnehmen können
|-
| style="vertical-align:top;" | {{fix}} || Server-Variable SCRIPT_URI nicht immer verfügbar
|-
| style="vertical-align:top;" | {{fix}} || SP_Util_Crypt-Klasse nicht mehrfach verwendbar
|}
===1.6 (07.02.2014)===
''Minor Release''
{|
| style="vertical-align:top;" | {{update}} || SP_Observable von site-api nach SP_Util_Observable in sp-base-php-api verschieben
|-
| style="vertical-align:top;" | {{add}} || context-Konfiguration pro Document-Root und Bootstraps unterstützen
|-
| style="vertical-align:top;" | {{add}} || SP_Net_Url Klasse
|-
| style="vertical-align:top;" | {{add}} || Limiter-Klasse zur Beschränkung CPU-lastiger PHP-Requests
|-
| style="vertical-align:top;" | {{add}} || Lock-Klasse zur Synchronisation von PHP-Requests
|-
| style="vertical-align:top;" | {{update}} || Vom SP_Context aufgebauter Classpath muss _* und *_remove Ordner ignorieren
|}
===1.5 (30.10.2013)===
''Minor Release''
{|
| style="vertical-align:top;" | {{fix}} || Registry Lookup funktioniert unter Windows x64 nicht
|-
| style="vertical-align:top;" | {{add}} || JsonArray & JsonObject sollten eine Clear-Methode haben um den Inhalt des Objektes zu leeren
|-
| style="vertical-align:top;" | {{add}} || JsonArray::put hängt nun Werte an, wenn kein Index angegeben wurde
|-
| style="vertical-align:top;" | {{update}} || SP_Json_Object muss eine JsonException werfen wenn versucht wird ein NULL-Key zu setzen
|}
===1.4.1 (09.09.2013)===
''Hotfix''
{|
| style="vertical-align:top;" | {{fix}} || Registry-Lookup für 64Bit Windows-Systeme funktioniert nicht
|-
| style="vertical-align:top;" | {{fix}} || Beim Initialisieren der Context Klasse sollten bestehende include-path Einträge auf IES-Module (WEB-IES/*) entfernt werden.
|-
| style="vertical-align:top;" | {{fix}} || SP_Json_Array::get wirft bei einem Eintrag mit gültigem Index und NULL-Value eine Exception
|}
===1.4 (26.08.2013)===
''Minor Release''
{|
| style="vertical-align:top;" | {{fix}} || Fehlerkorrekturen am RPC-Stack
|-
| style="vertical-align:top;" | {{add}} || Der Logger kann nun feiner konfiguriert werden
|-
| style="vertical-align:top;" | {{add}} || Version-Klasse impementieren
|}
===1.3.1 (27.06.2013)===
''Bugfix-Release''
{|
| style="vertical-align:top;" | {{update}} || SP_Context darf in Session use_trans_sid nicht setzten
|}
===1.3 (25.06.2013)===
''Minor Release''
{|
| style="vertical-align:top;" | {{add}} || Neue Methode SP_Util_Logger::deprecated(), um veraltete Methoden zu kennzeichnen.
|-
| style="vertical-align:top;" | {{add}} || Rpc-Anfragen geben nun immer eine Instanz der neuen Klasse SP_Net_Rpc_Response zurück.
|-
| style="vertical-align:top;" | {{update}} || Abhängigkeit zu Zend auf Version 1.12.3 gesetzt
|-
| style="vertical-align:top;" | {{add}} || Neue Klasse SP_Util_Attributable um attributierbare Objekte zu definieren
|-
| style="vertical-align:top;" | {{add}} || Neue Klasse SP_Util_String für String-Hilfsfunktionen, die nicht im Standard-PHP enthalten sind
|-
| style="vertical-align:top;" | {{add}} || Methode SP_Context::requireClass zum Laden von PHP-Klassen direkt aus IES-Modulen implementiert
|-
| style="vertical-align:top;" | {{fix}} || Fehler in optJSONArray & optJSONObject behoben
|-
| style="vertical-align:top;" | {{add}} || Neue Klasse SP_Utils_Arrays für Array-Hilfsfunktionen, die nicht im Standard-PHP enthalten sind
|-
| style="vertical-align:top;" | {{add}} || Neue Methode SP_Util_Format::currency
|-
| style="vertical-align:top;" | {{update}} || Performanzoptimierungen im JsonWriter
|-
| style="vertical-align:top;" | {{add}} || Klasse SP_User implementieren um Nutzereigenschaften, wie z.B. den Useragent zu prüfen
|-
| style="vertical-align:top;" | {{add}} || SP_Context::requireClass zur weiteren Steuerung der Includes implementieren
|-
| style="vertical-align:top;" | {{fix}} || SP_Context wird zweifach instanziiert
|-
| style="vertical-align:top;" | {{fix}} || JsonObject::optString liefert nicht den übergebenen defaultValue zurück sondern eine String-Repräsentation des defaultValue
|}
===1.2 (19.04.2013)===
''Minor Release''
{|
| style="vertical-align:top;" | {{fix}} || Fehler beim Auslesen des Betriebssystems und unter Windows beim Auslesen der Registry
|}
===1.1 (15.04.2013)===
''Minor Release''
{|
|}
===1.0 (16.01.2013)===
''Initiale Version''
{|
| style="vertical-align:top;" | {{add}} || Umzug der Basis-PHP-Klassen von IES-API nach Basis-PHP-API
|}

Changelog IES Generator

2016-10-24T09:54:05Z

Schleuse:

<div class="noautonum">__TOC__</div>
====Anmerkungen====
<div class="note">
Mit der Version '''1.4''' des IES Generators ist für die Nutzung des Ilinks eine Generierung aller Artikel notwendig, da es funktionale Anpassungen im entsprechenden Tag gab, die nur auf diese Weise in alle Artikel einfließen können.
Verzichtet man auf die komplette Generierung aller Artikel, so wird der Ilink nur in den Seiten dargestellt, die nach dem Update über redaktionelle Arbeiten neu generiert wurden. In allen übrigen Artikeln ist der Link zum CMS nicht mehr sichtbar.
</div>

==Changelog==
===1.24.11 (09.09.2016)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || SPML-Fehler wenn ein spt:link in einem Iterator benutzt wird, welcher den selben Mamen hat
|}
===1.24.10 (04.04.2016)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || spt:imageeditor hat bei Resource-Artikeln keine Löschfunktion
|}
===1.24.9 (09.02.2016)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{update}} || Ausgabe des iLink-Icons an Link-Feldern nur dann, wenn das Feld nicht disabled ist
|-
| style="vertical-align:top;" | {{add}} || Beim Uploadfeld das readonly-Feld mit dem Dateinamen auf disabled gesetzt, wenn das Attribut "disabled" gesetzt ist
|-
| style="vertical-align:top;" | {{add}} || Beim TinyMCE-Tag die Funktion zur Umschaltung zum HTML-Editor deaktiviert, wenn Attribut "disabled" gesetzt ist
|-
| style="vertical-align:top;" | {{add}} || disabled-Attribut für <spt:updown> hinzugefügt
|}
===1.24.8 (28.01.2016)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || spt:tinymce zeigt keinen Versionsvergleich an
|}
===1.24.7 (16.12.2015)===
{|
| style="vertical-align:top;" | {{fix}} || URLs mit urlrewriting="true" beim spt:encryptemail-Tag wurde HTML-Encoded.
|-
| style="vertical-align:top;" | {{fix}} || Fehlendes Attribute phpUrlRewriting am spt:imp Tag
|-
| style="vertical-align:top;" | {{fix}} || Die Parameter popupwidth und popupheight beim Tag <spt:encryptemail> erzeugen keinen PopUp-Link mit onclick="window.open..."
|}
===1.24.6 (04.12.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{add}} || Im <spt:upload>-Tag den Fake-Feldern das Attribut tabindex="-1" hinzugefügt.
|}
===1.24.5 (27.10.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Fehlerhafte Darstellung des spt:link Tags
|}
===1.24.4 (23.10.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || spt:link Tags funktionieren nicht in korrekt in Iterates in InfoSite 6
|}
===1.24.3 (21.10.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Ungültiger Scope-Parameter im spt:tinymce tag
|}
===1.24.2 (19.10.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Syntaxfehler im spt:tinymce
|}
===1.24.1 (19.10.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Scope-Leaking beim theme Attribut des spt:tinymce
|}
===1.24 (15.10.2015)===
''Release''
{|
| style="vertical-align:top;" | {{fix}} || Inhalt von Textareas wird nach mehrfachem Öffnen und Schließen des TinyMCE Editors nicht korrekt gespeichert
|-
| style="vertical-align:top;" | {{fix}} || i!-Link Benachrichtigung für InfoSite6 wird manchmal nicht korrekt oder gar nicht dargestellt
|-
| style="vertical-align:top;" | {{add}} || spt:link bietet in InfoSite 6 nun automatisch einen i!-Link zum verknüpften Objekt an
|-
| style="vertical-align:top;" | {{add}} || Neues Attribute 'default' für sp:map und sp:collection
|-
| style="vertical-align:top;" | {{fix}} || Für dynamische Attribute der SPT-Tags wird der Page-Scope nicht korrekt evaluiert
|-
| style="vertical-align:top;" | {{fix}} || SubInformation in Iteratoren funktionieren nicht in allen Kombinationen korrekt.
|-
| style="vertical-align:top;" | {{update}} || spt:id2url - Anpassungen für das SiteKit
|-
| style="vertical-align:top;" | {{add}} || sp:include - Parameter-Übergabe und Rückgabewerte für inkludierte SPML-Dateien/Templates
|-
| style="vertical-align:top;" | {{add}} || generate.spml für Generierungen ohne Template
|-
| style="vertical-align:top;" | {{add}} || Funktionstemplates für SPML
|}
===1.23.9 (19.10.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Syntaxfehler im spt:tinymce
|}
===1.23.8 (19.10.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Scope-Leaking beim theme Attribut des spt:tinymce
|}
===1.23.7 (28.09.2015)===
''Hotfix Release''
{|
| style="vertical-align:top;" | {{fix}} || Doppelten URL-Encodierung im Encrpytmail-Tag
|}
===1.23.6 (24.09.2015)===
''Hotfix Release''
{|
| style="vertical-align:top;" | {{update}} || Optimierung der Kontaktformular-URL bei verlinkten E-Mailadressen im encryptemail-Tag (Berücksichtigung eines eventuelen QueryStrings)
|}
===1.23.5 (13.07.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Es wird immer die PHP-Variante des i!-Link genutzt
|}
===1.23.4 (13.05.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Tags die innerhalb eines Modul-Templates innerhalb von InfoSite6 genutzt wurden, haben eine falsche Ausführungsumgebung erkannt
|}
===1.23.3 (05.05.2015)===
''Hotfix Release''
{|
| style="vertical-align:top;" | {{fix}} || Default-Ausgabe des Ilinks in der Website ohne Icon
|-
| style="vertical-align:top;" | {{update}} || Optionale Ausgabe des Ilinks auf verlinkte Informationen
|}
===1.23.2 (29.04.2015)===
''Hotfix Release''
{|
| style="vertical-align:top;" | {{update}} || Interner I-Link auf CityGov implementiert
|-
| style="vertical-align:top;" | {{fix}} || Problem bei den FormSolutions Urls, Links und Texten für die Abwärtskompatibilität korrigiert
|-
| style="vertical-align:top;" | {{fix}} || spt:encryptmail escaped Attribute-Werte an a-tags nicht korrekt
|}
===1.23.1 (23.03.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{update}} || Bildoptionen wie z.B der Fokuspunkt werden beim Löschen eines Bildes im ImageEditor zurückgesetzt
|-
| style="vertical-align:top;" | {{add}} || spt:imageeditor unterstützt nun die Übergabe einer Medien-Referenz über das object Attribut
|-
| style="vertical-align:top;" | {{fix}} || spt:imageeditor funktioniert innerhalb von Iteratoren nicht korrekt
|}
===1.23 (12.03.2015)===
''Feature Release''
{|
| style="vertical-align:top;" | {{add}} || Unterstützung für das overwrite Attribut am sp:map Tag
|-
| style="vertical-align:top;" | {{add}} || Löschen eines Bildes im spt:imageeditor wird nun über ein Werkzeug im Editor anstatt einer Checkbox ausgelöst
|}
===1.22.9 (24.02.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || SPML-Fehler im Newsdesk-Zweig des spt:iterators
|}
===1.22.8 (24.02.2015)===
''Hotfix Release''
{|
| style="vertical-align:top;" | {{fix}} || Ausgabe der Werte bei sp:date nicht korrekt
|}
===1.22.7 (06.02.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Versionsvergleich bei Textareas funktioniert nicht
|}
===1.22.6 (02.02.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || spt:textarea lässt sich durch Variablensetzung von Außen beeinflussen
|}
===1.22.5 (28.01.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || maxlength Attribut des spt:textarea Tags funktioniert nicht korrekt wenn als Wert ein Leerstring übergeben wird
|}
===1.22.4 (26.01.2015)===
''Hotfix- Release''
{|
| style="vertical-align:top;" | {{fix}} || configextension Attribute am spt:tinymce tag funktioniert in Iteratoren nicht korrekt
|}
===1.22.3 (08.01.2015)===
''Hotfix- Release''
{|
|}
===1.22.2 (08.01.2015)===
''Hotfix- Release''
{|
| style="vertical-align:top;" | {{fix}} || Maxlength von spt:textarea wirkt sich auf das falsche Feld aus
|}
===1.22.1 (08.01.2015)===
''Hotfix- Release''
{|
| style="vertical-align:top;" | {{fix}} || disabled Attribut des spt:iterator tags funktioniert nicht korrekt
|-
| style="vertical-align:top;" | {{fix}} || Berechnung der Restzeichenlänge im <spt:textarea>-Tag funktioniert nicht, wenn Feld mit (fix)value vorbelegt wird.
|}
===1.22 (07.01.2015)===
''Release''
{|
| style="vertical-align:top;" | {{fix}} || Umstellung der SPT-Tags für die Diff-Ausgaben
|-
| style="vertical-align:top;" | {{fix}} || Umstellung der SPT-Tags um bei der Ausgabe von Texten Subinformations zu berücksichtigen
|}
===1.21.1 (24.11.2014)===
''Hotfix- Release''
{|
| style="vertical-align:top;" | {{add}} || ImageEditor kann nun auch mit Mehrsprachigkeit umgehen
|}
===1.21 (19.11.2014)===
''Release''
{|
| style="vertical-align:top;" | {{update}} || Anpassung der Funktion des Personalisierungstags
|-
| style="vertical-align:top;" | {{add}} || sp:compasscompiler
|-
| style="vertical-align:top;" | {{add}} || Neuer Tag spt:imageeditor - Bearbeitungsoberfläche für Bilder
|-
| style="vertical-align:top;" | {{add}} || Neues Attribut 'options' für sp:scaleimage
|}
===1.20.8 (12.11.2014)===
''Bugfix Release''
{|
| style="vertical-align:top;" | {{update}} || HTML Table Attribute werden nun nicht mehr entfernt
|-
| style="vertical-align:top;" | {{add}} || TinyMCE: Mit aktivierten Editor soll der Nutzer über das Kontextmenü Texte auch einfügen können
|-
| style="vertical-align:top;" | {{update}} || NEUE Anbindung der FormSolutions-Schnittstelle (spt:formsolutinos ohne Import aber mit ausgeblendeten Formularen)
|}
===1.20.7 (03.09.2014)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{add}} || phpUrlRewriting-Attribut für spt:imp, spt:email2img, spt:id2url und spt:escapeemail
|}
===1.20.6 (02.09.2014)===
''Hotfix- Release''
{|
| style="vertical-align:top;" | {{fix}} || Für die Auswertung der Personalisierungsinformationen mit PHP wurde der im Apache konfigurierte Nutzer nicht korrekt ausgewertet.
|-
| style="vertical-align:top;" | {{add}} || Erweiterung des internen I-Links
|}
===1.20.5 (19.08.2014)===
''Bugfix Release''
{|
|}
===1.20.4 (14.08.2014)===
''Hotfix- Release''
{|
| style="vertical-align:top;" | {{fix}} || PHP älter als Version 5.3 unterstützt die __DIR__ Konstante nicht. Diese wird in spt:personalization & spt:ilink genutzt
|}
===1.20.3 (13.08.2014)===
''Hotfix- Release''
{|
| style="vertical-align:top;" | {{fix}} || Die Ermittlung der Namen von verknüpften Artikeln schläft unter gewissen Umständen fehl
|-
| style="vertical-align:top;" | {{fix}} || min-height des spt:tinymce tag lässt sich nicht überschreiben
|}
===1.20.2 (08.08.2014)===
''Hotfix- Release''
{|
| style="vertical-align:top;" | {{fix}} || Die Ermittlung der Namen von verknüpften Artikeln im spt:tinymce tag schlägt fehl wenn der Tag in einem Iterator genutzt wird
|}
===1.20.1 (24.07.2014)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{update}} || Bei der Auswahl von FormSolutions Formularen wird der Name des zuvor gewählten Formulars in der Eingabe angezeigt und kann in der Ausgabe nun als Default Linktext verwendet werden.
|}
===1.20 (22.07.2014)===
''Release''
{|
| style="vertical-align:top;" | {{update}} || Personalisierungslogik des spt:personalization tag in PHP-Klasse auslagern
|-
| style="vertical-align:top;" | {{fix}} || In gewissen Situationen hinterlässt der spt:ilink tag, obwohl er nicht angezeigt wird, einen leeren div container
|-
| style="vertical-align:top;" | {{add}} || Refactoring des spt:tinymce tags. Update auf TinyMce Version 4
|}
===1.19.3 (08.04.2014)===
''Bugfix Release''
{|
| style="vertical-align:top;" | {{fix}} || Der I-Link innerhalb der CityGov Seiten kann bei CityGov > 3.8.3 die bestehende Session verwenden.
|}
===1.19.2 (25.03.2014)===
''Hotfix''
{|
| style="vertical-align:top;" | {{fix}} || Sicherheitsmeldungen unter bestimmten Internet Explorer Einstellungen beim Öffnen von Link-Dialogen
|}
===1.19.1 (19.03.2014)===
{|
| style="vertical-align:top;" | {{fix}} || Bei FormSolutions Verküpfungen wird die Suche und Auswahl eines Formulars nun über die FormSolutions Oberfläche erfolgen. Somit werden 'deaktivierte' Formulare aus korrekt ausgeblendet.
|}
===1.19 (12.03.2014)===
''Release''
{|
| style="vertical-align:top;" | {{fix}} || spt:tinymce passt beim Editieren eines Links nicht alle benötigten Attribute an
|-
| style="vertical-align:top;" | {{add}} || spt:personalization - Modus zur Ausgabe innerhalb eines geöffneten php-tag implementiert
|-
| style="vertical-align:top;" | {{add}} || spt:ilink für interne Verlinkungen
|}
===1.18.2 (30.01.2014)===
{|
|}
===1.18.1 (30.01.2014)===
''Hotfix Release''
{|
| style="vertical-align:top;" | {{fix}} || Der Formsolutions LinkDialog zeigt keine Pools für die Auswahl an.
|}
===1.18 (06.01.2014)===
''Minor Release''
{|
| style="vertical-align:top;" | {{fix}} || Interner Link im TinyMCE funktionierte nicht mehr
|}
===1.17.2 (20.12.2013)===
''Hotfix''
{|
| style="vertical-align:top;" | {{update}} || JavaScript-Methoden des Formsolutions-Tag angepasst
|-
| style="vertical-align:top;" | {{update}} || TinyMCE Tag generiert alten JavaScript-Code für Link-Dialog
|}
===1.17.1 (20.12.2013)===
''Hotfix Release''
{|
| style="vertical-align:top;" | {{fix}} || Link-Dialog in kann im InternetExplorer nicht aufgerufen werden
|}
===1.17 (19.12.2013)===
''Release''
{|
| style="vertical-align:top;" | {{fix}} || spt:encryptemail encodet den Parameter sp-email jetzt korrekt
|-
| style="vertical-align:top;" | {{update}} || Link und Systemlink-Dialoge dürfen Parameter nicht über die Session übertragen
|-
| style="vertical-align:top;" | {{update}} || Umstellung des HTML-Codes vom Link für den alten Systemlink-Dialog
|-
| style="vertical-align:top;" | {{fix}} || Englische Übersetzung des "Worklist Bearbeiten" - Buttons falsch
|}
===1.16 (19.11.2013)===
''Minor Release''
{|
| style="vertical-align:top;" | {{fix}} || spt:link wird unter bestimmten Umständen von Popup-Blockern blockiert
|-
| style="vertical-align:top;" | {{add}} || Neues Tag-Template "spt:mime2type" mit dem eine Dokumententypangabe auf Basis des Mimetypes erfolgt
|}
===1.15.3 (31.10.2013)===
''Hotfix Release''
{|
| style="vertical-align:top;" | {{fix}} || ILink-Icon auch ohne Neu-Generierung sichtbar
|}
===1.15.2 (24.10.2013)===
''Hotfix''
{|
| style="vertical-align:top;" | {{fix}} || spt:link funktioniert innerhalb von CityGov nicht richtig
|}
===1.15.1 (18.10.2013)===
''Hotfix''
{|
| style="vertical-align:top;" | {{fix}} || Kleine Fehlerkorrektur am spt:link tag
|}
===1.15 (18.10.2013)===
''Minor Release''
{|
| style="vertical-align:top;" | {{fix}} || spt:link funktioniert nicht in Modultemplates die in Infosite5 included werden.
|}
===1.14 (17.10.2013)===
''Minor Release''
{|
| style="vertical-align:top;" | {{update}} || Umstellung des I-Links auf PHP4 Kompatibilität
|}
===1.13 (10.10.2013)===
''Minor Release''
{|
| style="vertical-align:top;" | {{fix}} || Der I-Link Tag setzt eine PHP-Umgebung voraus, die gegebenenfalls nicht vorhanden ist. Der I-Link muss "stand-alone" funktionieren.
|-
| style="vertical-align:top;" | {{fix}} || Der Ilink verwendet intern immer den SRPC-Open Aufruf
|-
| style="vertical-align:top;" | {{fix}} || Optionaler I-Link-Redirect funktionierte nicht für Publisher mit "directory"-Angaben bei einer Domain (Portal-Konfiguration)
|}
===1.12 (27.08.2013)===
''Minor Release''
{|
| style="vertical-align:top;" | {{add}} || Browser-Spellcheck für spt:tinymce
|-
| style="vertical-align:top;" | {{update}} || Neues HTML-Markup für spt:timestamp: jetzt Button statt verlinkter Grafik
|-
| style="vertical-align:top;" | {{update}} || veraltetes MarkUp des Smarteditor-Feldes angepasst, jetzt identisch mit MarkUp des TinyMCE-Feldes
|-
| style="vertical-align:top;" | {{update}} || MarkUp-Erweiterung des Iterators: kompletten Iterator mit <div class="iterate-wrapper"> geklammert
|}
===1.11.2 (19.08.2013)===
''Bugfix Release''
{|
| style="vertical-align:top;" | {{fix}} || Mangelhafte Kapselung des locale Attributes bei spt:link bzw. spt:locale
|}
===1.11.1 (19.08.2013)===
''Bugfix''
{|
|}
===1.11 (02.08.2013)===
{|
| style="vertical-align:top;" | {{update}} || Ilink aus InfoSite6 funktionierte nicht für CityGov-Artikel
|}
===1.10.2 (03.07.2013)===
{|
|}
===1.10.1 (03.07.2013)===
''Hotfix''
{|
|}
===1.10 (26.06.2013)===
''Bugfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || spt:encryptemail - sp-email Parameter muss die Email mit <i>-Variante enthalten
|}
===1.9 (25.06.2013)===
''Feature Release''
{|
| style="vertical-align:top;" | {{add}} || Neuer Tag spt:encryptemail
|-
| style="vertical-align:top;" | {{fix}} || spt:iterator Verhalten bei Definition von min und max unlogisch
|}
===1.8 (13.05.2013)===
''Feature Release''
{|
| style="vertical-align:top;" | {{fix}} || Darstellung der eigenen Personalisierung nach automatischen Lookup auf den Parent angepasst
|-
| style="vertical-align:top;" | {{update}} || Anzeige des Eingabefeldes mit dem verlinkten Artikel nun nicht mehr als readonly sondern als disabled, wenn spt:link das Attribut disabled="true" mitgegeben wurde.
|}
===1.7.1 (03.05.2013)===
''Hotfix''
{|
| style="vertical-align:top;" | {{update}} || Anpassungen der Aufrufe für Personalisierung
|}
===1.7 (29.04.2013)===
''Feature Release''
{|
| style="vertical-align:top;" | {{fix}} || spt:id2url - &nbsp; werden durch Spaces ersetzt
|-
| style="vertical-align:top;" | {{add}} || GET-Parameter mode, email und emailImageUrl werden jetzt auch im neuen Format sp-mode, sp-email und sp-emailImageUrl vorgehalten (alte Parameter können irgendwann aus dem Tag gelöscht werden)
|}
===1.6 (16.04.2013)===
''Feature Release''
{|
| style="vertical-align:top;" | {{add}} || spt:id2url - Attribut classname hinzugefügt
|-
| style="vertical-align:top;" | {{update}} || Bedingungen für die Anzeige des I-Links optimiert, erweiterte Überprüfung der Setzungen im Cookie.
|-
| style="vertical-align:top;" | {{add}} || Attributabfrage von "html_img_dimension" in <spt:formsolutions>, <spt:ilink>, <spt:image>, <spt:imp>, <spt:ilink> und <spt:systemlink> hinzugefügt.
|-
| style="vertical-align:top;" | {{fix}} || Eingabe von Kommazahlen in einem <spt:number>-Feld führt zu einem Internal Error
|}
===1.5.2 (28.06.2013)===
''Hotfix''
{|
|}
===1.5.1 (28.06.2013)===
''Bugfix-Release''
{|
| style="vertical-align:top;" | {{add}} || spt:email2img - CSS-classe sp-mailto wir nur im ersten <a>-Tag gesetzt
|}
===1.5 (05.02.2013)===
''Bugfix Release''
{|
| style="vertical-align:top;" | {{fix}} || Ilink wird bei Artikeln der Virtuellen Verwaltung wg. eines JavaScript-Fehler nicht dargestellt.
|-
| style="vertical-align:top;" | {{update}} || Attribut id wird bei <spt:textarea> jetzt auch an den Versionsvergleich mit <spt:diff> durchgereicht
|-
| style="vertical-align:top;" | {{add}} || Attribut id bei <spt:diff> hinzugefügt
|}
===1.4 (16.01.2013)===
''Feature Release''
{|
| style="vertical-align:top;" | {{update}} || Inline-Style-Angaben des <spt:updown>-Tags entfernt
|-
| style="vertical-align:top;" | {{add}} || Erweiterung von spt:iterator um das Attribut disabled um einzelne Iterator-Blöcke zu disablen
|-
| style="vertical-align:top;" | {{update}} || Umstellung und Optimierung des Ilink-Tags
|}
===1.3 (12.12.2012)===
''Feature Release''
{|
| style="vertical-align:top;" | {{update}} || Die Map mit den sprachspezifischen Begriffen mit scope="page" deklariert, weil sich sonst spt-Tags beim Bestücken der Map gegenseitig beeinflussten
|-
| style="vertical-align:top;" | {{add}} || Erweiterung von <spt:iterator> um das Attribute "invert" und Auswertung des bereits existierenden Attributs "itemtext" (erfordert bei Benutzung der Attribute für korrekte Styles InfoSite5-Modul Version 5.4)
|}
===1.2.1 (23.11.2012)===
''Hotfix''
{|
| style="vertical-align:top;" | {{fix}} || spt:ilink führt in einem bestimmten patchelevel des IE8 & IE7 zu Fehlern
|}
===1.2 (20.11.2012)===
''Bugfix Release''
{|
| style="vertical-align:top;" | {{add}} || ilink - Unterstützung für InfoSite 6
|-
| style="vertical-align:top;" | {{fix}} || In CityGov werden bei Angebundenem TSA-BUS die zur Verfügung stehenden BUS-Artikel nicht korrekt gefiltert.
|}
===1.1.1 (16.10.2012)===
''Hotfix''
{|
| style="vertical-align:top;" | {{fix}} || JavaScript Fehler beim Aufruf des Link-Dialogs im Internet Explorer 8
|-
| style="vertical-align:top;" | {{fix}} || Bei der Umwandlung von E-Maillinks wurden doppelte class-Attribute ausgegeben, wenn der umzuwandelnde Link selbst schon eine Klassenauszeichnung hatte
|-
| style="vertical-align:top;" | {{update}} || Link und Markup des Icons in <spt:personalization> angepasst; Alternativtext und Tooltip jetzt mehrsprachig
|}
===1.1 (16.10.2012)===
''Bugfix Release''
{|
|}

Changelog IES Generator

2016-10-24T09:53:34Z

Schleuse:

<div class="noautonum">__TOC__</div>
==Changelog==
===1.24.11 (09.09.2016)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || SPML-Fehler wenn ein spt:link in einem Iterator benutzt wird, welcher den selben Mamen hat
|}
===1.24.10 (04.04.2016)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || spt:imageeditor hat bei Resource-Artikeln keine Löschfunktion
|}
===1.24.9 (09.02.2016)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{update}} || Ausgabe des iLink-Icons an Link-Feldern nur dann, wenn das Feld nicht disabled ist
|-
| style="vertical-align:top;" | {{add}} || Beim Uploadfeld das readonly-Feld mit dem Dateinamen auf disabled gesetzt, wenn das Attribut "disabled" gesetzt ist
|-
| style="vertical-align:top;" | {{add}} || Beim TinyMCE-Tag die Funktion zur Umschaltung zum HTML-Editor deaktiviert, wenn Attribut "disabled" gesetzt ist
|-
| style="vertical-align:top;" | {{add}} || disabled-Attribut für <spt:updown> hinzugefügt
|}
===1.24.8 (28.01.2016)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || spt:tinymce zeigt keinen Versionsvergleich an
|}
===1.24.7 (16.12.2015)===
{|
| style="vertical-align:top;" | {{fix}} || URLs mit urlrewriting="true" beim spt:encryptemail-Tag wurde HTML-Encoded.
|-
| style="vertical-align:top;" | {{fix}} || Fehlendes Attribute phpUrlRewriting am spt:imp Tag
|-
| style="vertical-align:top;" | {{fix}} || Die Parameter popupwidth und popupheight beim Tag <spt:encryptemail> erzeugen keinen PopUp-Link mit onclick="window.open..."
|}
===1.24.6 (04.12.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{add}} || Im <spt:upload>-Tag den Fake-Feldern das Attribut tabindex="-1" hinzugefügt.
|}
===1.24.5 (27.10.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Fehlerhafte Darstellung des spt:link Tags
|}
===1.24.4 (23.10.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || spt:link Tags funktionieren nicht in korrekt in Iterates in InfoSite 6
|}
===1.24.3 (21.10.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Ungültiger Scope-Parameter im spt:tinymce tag
|}
===1.24.2 (19.10.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Syntaxfehler im spt:tinymce
|}
===1.24.1 (19.10.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Scope-Leaking beim theme Attribut des spt:tinymce
|}
===1.24 (15.10.2015)===
''Release''
{|
| style="vertical-align:top;" | {{fix}} || Inhalt von Textareas wird nach mehrfachem Öffnen und Schließen des TinyMCE Editors nicht korrekt gespeichert
|-
| style="vertical-align:top;" | {{fix}} || i!-Link Benachrichtigung für InfoSite6 wird manchmal nicht korrekt oder gar nicht dargestellt
|-
| style="vertical-align:top;" | {{add}} || spt:link bietet in InfoSite 6 nun automatisch einen i!-Link zum verknüpften Objekt an
|-
| style="vertical-align:top;" | {{add}} || Neues Attribute 'default' für sp:map und sp:collection
|-
| style="vertical-align:top;" | {{fix}} || Für dynamische Attribute der SPT-Tags wird der Page-Scope nicht korrekt evaluiert
|-
| style="vertical-align:top;" | {{fix}} || SubInformation in Iteratoren funktionieren nicht in allen Kombinationen korrekt.
|-
| style="vertical-align:top;" | {{update}} || spt:id2url - Anpassungen für das SiteKit
|-
| style="vertical-align:top;" | {{add}} || sp:include - Parameter-Übergabe und Rückgabewerte für inkludierte SPML-Dateien/Templates
|-
| style="vertical-align:top;" | {{add}} || generate.spml für Generierungen ohne Template
|-
| style="vertical-align:top;" | {{add}} || Funktionstemplates für SPML
|}
===1.23.9 (19.10.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Syntaxfehler im spt:tinymce
|}
===1.23.8 (19.10.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Scope-Leaking beim theme Attribut des spt:tinymce
|}
===1.23.7 (28.09.2015)===
''Hotfix Release''
{|
| style="vertical-align:top;" | {{fix}} || Doppelten URL-Encodierung im Encrpytmail-Tag
|}
===1.23.6 (24.09.2015)===
''Hotfix Release''
{|
| style="vertical-align:top;" | {{update}} || Optimierung der Kontaktformular-URL bei verlinkten E-Mailadressen im encryptemail-Tag (Berücksichtigung eines eventuelen QueryStrings)
|}
===1.23.5 (13.07.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Es wird immer die PHP-Variante des i!-Link genutzt
|}
===1.23.4 (13.05.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Tags die innerhalb eines Modul-Templates innerhalb von InfoSite6 genutzt wurden, haben eine falsche Ausführungsumgebung erkannt
|}
===1.23.3 (05.05.2015)===
''Hotfix Release''
{|
| style="vertical-align:top;" | {{fix}} || Default-Ausgabe des Ilinks in der Website ohne Icon
|-
| style="vertical-align:top;" | {{update}} || Optionale Ausgabe des Ilinks auf verlinkte Informationen
|}
===1.23.2 (29.04.2015)===
''Hotfix Release''
{|
| style="vertical-align:top;" | {{update}} || Interner I-Link auf CityGov implementiert
|-
| style="vertical-align:top;" | {{fix}} || Problem bei den FormSolutions Urls, Links und Texten für die Abwärtskompatibilität korrigiert
|-
| style="vertical-align:top;" | {{fix}} || spt:encryptmail escaped Attribute-Werte an a-tags nicht korrekt
|}
===1.23.1 (23.03.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{update}} || Bildoptionen wie z.B der Fokuspunkt werden beim Löschen eines Bildes im ImageEditor zurückgesetzt
|-
| style="vertical-align:top;" | {{add}} || spt:imageeditor unterstützt nun die Übergabe einer Medien-Referenz über das object Attribut
|-
| style="vertical-align:top;" | {{fix}} || spt:imageeditor funktioniert innerhalb von Iteratoren nicht korrekt
|}
===1.23 (12.03.2015)===
''Feature Release''
{|
| style="vertical-align:top;" | {{add}} || Unterstützung für das overwrite Attribut am sp:map Tag
|-
| style="vertical-align:top;" | {{add}} || Löschen eines Bildes im spt:imageeditor wird nun über ein Werkzeug im Editor anstatt einer Checkbox ausgelöst
|}
===1.22.9 (24.02.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || SPML-Fehler im Newsdesk-Zweig des spt:iterators
|}
===1.22.8 (24.02.2015)===
''Hotfix Release''
{|
| style="vertical-align:top;" | {{fix}} || Ausgabe der Werte bei sp:date nicht korrekt
|}
===1.22.7 (06.02.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || Versionsvergleich bei Textareas funktioniert nicht
|}
===1.22.6 (02.02.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || spt:textarea lässt sich durch Variablensetzung von Außen beeinflussen
|}
===1.22.5 (28.01.2015)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || maxlength Attribut des spt:textarea Tags funktioniert nicht korrekt wenn als Wert ein Leerstring übergeben wird
|}
===1.22.4 (26.01.2015)===
''Hotfix- Release''
{|
| style="vertical-align:top;" | {{fix}} || configextension Attribute am spt:tinymce tag funktioniert in Iteratoren nicht korrekt
|}
===1.22.3 (08.01.2015)===
''Hotfix- Release''
{|
|}
===1.22.2 (08.01.2015)===
''Hotfix- Release''
{|
| style="vertical-align:top;" | {{fix}} || Maxlength von spt:textarea wirkt sich auf das falsche Feld aus
|}
===1.22.1 (08.01.2015)===
''Hotfix- Release''
{|
| style="vertical-align:top;" | {{fix}} || disabled Attribut des spt:iterator tags funktioniert nicht korrekt
|-
| style="vertical-align:top;" | {{fix}} || Berechnung der Restzeichenlänge im <spt:textarea>-Tag funktioniert nicht, wenn Feld mit (fix)value vorbelegt wird.
|}
===1.22 (07.01.2015)===
''Release''
{|
| style="vertical-align:top;" | {{fix}} || Umstellung der SPT-Tags für die Diff-Ausgaben
|-
| style="vertical-align:top;" | {{fix}} || Umstellung der SPT-Tags um bei der Ausgabe von Texten Subinformations zu berücksichtigen
|}
===1.21.1 (24.11.2014)===
''Hotfix- Release''
{|
| style="vertical-align:top;" | {{add}} || ImageEditor kann nun auch mit Mehrsprachigkeit umgehen
|}
===1.21 (19.11.2014)===
''Release''
{|
| style="vertical-align:top;" | {{update}} || Anpassung der Funktion des Personalisierungstags
|-
| style="vertical-align:top;" | {{add}} || sp:compasscompiler
|-
| style="vertical-align:top;" | {{add}} || Neuer Tag spt:imageeditor - Bearbeitungsoberfläche für Bilder
|-
| style="vertical-align:top;" | {{add}} || Neues Attribut 'options' für sp:scaleimage
|}
===1.20.8 (12.11.2014)===
''Bugfix Release''
{|
| style="vertical-align:top;" | {{update}} || HTML Table Attribute werden nun nicht mehr entfernt
|-
| style="vertical-align:top;" | {{add}} || TinyMCE: Mit aktivierten Editor soll der Nutzer über das Kontextmenü Texte auch einfügen können
|-
| style="vertical-align:top;" | {{update}} || NEUE Anbindung der FormSolutions-Schnittstelle (spt:formsolutinos ohne Import aber mit ausgeblendeten Formularen)
|}
===1.20.7 (03.09.2014)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{add}} || phpUrlRewriting-Attribut für spt:imp, spt:email2img, spt:id2url und spt:escapeemail
|}
===1.20.6 (02.09.2014)===
''Hotfix- Release''
{|
| style="vertical-align:top;" | {{fix}} || Für die Auswertung der Personalisierungsinformationen mit PHP wurde der im Apache konfigurierte Nutzer nicht korrekt ausgewertet.
|-
| style="vertical-align:top;" | {{add}} || Erweiterung des internen I-Links
|}
===1.20.5 (19.08.2014)===
''Bugfix Release''
{|
|}
===1.20.4 (14.08.2014)===
''Hotfix- Release''
{|
| style="vertical-align:top;" | {{fix}} || PHP älter als Version 5.3 unterstützt die __DIR__ Konstante nicht. Diese wird in spt:personalization & spt:ilink genutzt
|}
===1.20.3 (13.08.2014)===
''Hotfix- Release''
{|
| style="vertical-align:top;" | {{fix}} || Die Ermittlung der Namen von verknüpften Artikeln schläft unter gewissen Umständen fehl
|-
| style="vertical-align:top;" | {{fix}} || min-height des spt:tinymce tag lässt sich nicht überschreiben
|}
===1.20.2 (08.08.2014)===
''Hotfix- Release''
{|
| style="vertical-align:top;" | {{fix}} || Die Ermittlung der Namen von verknüpften Artikeln im spt:tinymce tag schlägt fehl wenn der Tag in einem Iterator genutzt wird
|}
===1.20.1 (24.07.2014)===
''Hotfix-Release''
{|
| style="vertical-align:top;" | {{update}} || Bei der Auswahl von FormSolutions Formularen wird der Name des zuvor gewählten Formulars in der Eingabe angezeigt und kann in der Ausgabe nun als Default Linktext verwendet werden.
|}
===1.20 (22.07.2014)===
''Release''
{|
| style="vertical-align:top;" | {{update}} || Personalisierungslogik des spt:personalization tag in PHP-Klasse auslagern
|-
| style="vertical-align:top;" | {{fix}} || In gewissen Situationen hinterlässt der spt:ilink tag, obwohl er nicht angezeigt wird, einen leeren div container
|-
| style="vertical-align:top;" | {{add}} || Refactoring des spt:tinymce tags. Update auf TinyMce Version 4
|}
===1.19.3 (08.04.2014)===
''Bugfix Release''
{|
| style="vertical-align:top;" | {{fix}} || Der I-Link innerhalb der CityGov Seiten kann bei CityGov > 3.8.3 die bestehende Session verwenden.
|}
===1.19.2 (25.03.2014)===
''Hotfix''
{|
| style="vertical-align:top;" | {{fix}} || Sicherheitsmeldungen unter bestimmten Internet Explorer Einstellungen beim Öffnen von Link-Dialogen
|}
===1.19.1 (19.03.2014)===
{|
| style="vertical-align:top;" | {{fix}} || Bei FormSolutions Verküpfungen wird die Suche und Auswahl eines Formulars nun über die FormSolutions Oberfläche erfolgen. Somit werden 'deaktivierte' Formulare aus korrekt ausgeblendet.
|}
===1.19 (12.03.2014)===
''Release''
{|
| style="vertical-align:top;" | {{fix}} || spt:tinymce passt beim Editieren eines Links nicht alle benötigten Attribute an
|-
| style="vertical-align:top;" | {{add}} || spt:personalization - Modus zur Ausgabe innerhalb eines geöffneten php-tag implementiert
|-
| style="vertical-align:top;" | {{add}} || spt:ilink für interne Verlinkungen
|}
===1.18.2 (30.01.2014)===
{|
|}
===1.18.1 (30.01.2014)===
''Hotfix Release''
{|
| style="vertical-align:top;" | {{fix}} || Der Formsolutions LinkDialog zeigt keine Pools für die Auswahl an.
|}
===1.18 (06.01.2014)===
''Minor Release''
{|
| style="vertical-align:top;" | {{fix}} || Interner Link im TinyMCE funktionierte nicht mehr
|}
===1.17.2 (20.12.2013)===
''Hotfix''
{|
| style="vertical-align:top;" | {{update}} || JavaScript-Methoden des Formsolutions-Tag angepasst
|-
| style="vertical-align:top;" | {{update}} || TinyMCE Tag generiert alten JavaScript-Code für Link-Dialog
|}
===1.17.1 (20.12.2013)===
''Hotfix Release''
{|
| style="vertical-align:top;" | {{fix}} || Link-Dialog in kann im InternetExplorer nicht aufgerufen werden
|}
===1.17 (19.12.2013)===
''Release''
{|
| style="vertical-align:top;" | {{fix}} || spt:encryptemail encodet den Parameter sp-email jetzt korrekt
|-
| style="vertical-align:top;" | {{update}} || Link und Systemlink-Dialoge dürfen Parameter nicht über die Session übertragen
|-
| style="vertical-align:top;" | {{update}} || Umstellung des HTML-Codes vom Link für den alten Systemlink-Dialog
|-
| style="vertical-align:top;" | {{fix}} || Englische Übersetzung des "Worklist Bearbeiten" - Buttons falsch
|}
===1.16 (19.11.2013)===
''Minor Release''
{|
| style="vertical-align:top;" | {{fix}} || spt:link wird unter bestimmten Umständen von Popup-Blockern blockiert
|-
| style="vertical-align:top;" | {{add}} || Neues Tag-Template "spt:mime2type" mit dem eine Dokumententypangabe auf Basis des Mimetypes erfolgt
|}
===1.15.3 (31.10.2013)===
''Hotfix Release''
{|
| style="vertical-align:top;" | {{fix}} || ILink-Icon auch ohne Neu-Generierung sichtbar
|}
===1.15.2 (24.10.2013)===
''Hotfix''
{|
| style="vertical-align:top;" | {{fix}} || spt:link funktioniert innerhalb von CityGov nicht richtig
|}
===1.15.1 (18.10.2013)===
''Hotfix''
{|
| style="vertical-align:top;" | {{fix}} || Kleine Fehlerkorrektur am spt:link tag
|}
===1.15 (18.10.2013)===
''Minor Release''
{|
| style="vertical-align:top;" | {{fix}} || spt:link funktioniert nicht in Modultemplates die in Infosite5 included werden.
|}
===1.14 (17.10.2013)===
''Minor Release''
{|
| style="vertical-align:top;" | {{update}} || Umstellung des I-Links auf PHP4 Kompatibilität
|}
===1.13 (10.10.2013)===
''Minor Release''
{|
| style="vertical-align:top;" | {{fix}} || Der I-Link Tag setzt eine PHP-Umgebung voraus, die gegebenenfalls nicht vorhanden ist. Der I-Link muss "stand-alone" funktionieren.
|-
| style="vertical-align:top;" | {{fix}} || Der Ilink verwendet intern immer den SRPC-Open Aufruf
|-
| style="vertical-align:top;" | {{fix}} || Optionaler I-Link-Redirect funktionierte nicht für Publisher mit "directory"-Angaben bei einer Domain (Portal-Konfiguration)
|}
===1.12 (27.08.2013)===
''Minor Release''
{|
| style="vertical-align:top;" | {{add}} || Browser-Spellcheck für spt:tinymce
|-
| style="vertical-align:top;" | {{update}} || Neues HTML-Markup für spt:timestamp: jetzt Button statt verlinkter Grafik
|-
| style="vertical-align:top;" | {{update}} || veraltetes MarkUp des Smarteditor-Feldes angepasst, jetzt identisch mit MarkUp des TinyMCE-Feldes
|-
| style="vertical-align:top;" | {{update}} || MarkUp-Erweiterung des Iterators: kompletten Iterator mit <div class="iterate-wrapper"> geklammert
|}
===1.11.2 (19.08.2013)===
''Bugfix Release''
{|
| style="vertical-align:top;" | {{fix}} || Mangelhafte Kapselung des locale Attributes bei spt:link bzw. spt:locale
|}
===1.11.1 (19.08.2013)===
''Bugfix''
{|
|}
===1.11 (02.08.2013)===
{|
| style="vertical-align:top;" | {{update}} || Ilink aus InfoSite6 funktionierte nicht für CityGov-Artikel
|}
===1.10.2 (03.07.2013)===
{|
|}
===1.10.1 (03.07.2013)===
''Hotfix''
{|
|}
===1.10 (26.06.2013)===
''Bugfix-Release''
{|
| style="vertical-align:top;" | {{fix}} || spt:encryptemail - sp-email Parameter muss die Email mit <i>-Variante enthalten
|}
===1.9 (25.06.2013)===
''Feature Release''
{|
| style="vertical-align:top;" | {{add}} || Neuer Tag spt:encryptemail
|-
| style="vertical-align:top;" | {{fix}} || spt:iterator Verhalten bei Definition von min und max unlogisch
|}
===1.8 (13.05.2013)===
''Feature Release''
{|
| style="vertical-align:top;" | {{fix}} || Darstellung der eigenen Personalisierung nach automatischen Lookup auf den Parent angepasst
|-
| style="vertical-align:top;" | {{update}} || Anzeige des Eingabefeldes mit dem verlinkten Artikel nun nicht mehr als readonly sondern als disabled, wenn spt:link das Attribut disabled="true" mitgegeben wurde.
|}
===1.7.1 (03.05.2013)===
''Hotfix''
{|
| style="vertical-align:top;" | {{update}} || Anpassungen der Aufrufe für Personalisierung
|}
===1.7 (29.04.2013)===
''Feature Release''
{|
| style="vertical-align:top;" | {{fix}} || spt:id2url - &nbsp; werden durch Spaces ersetzt
|-
| style="vertical-align:top;" | {{add}} || GET-Parameter mode, email und emailImageUrl werden jetzt auch im neuen Format sp-mode, sp-email und sp-emailImageUrl vorgehalten (alte Parameter können irgendwann aus dem Tag gelöscht werden)
|}
===1.6 (16.04.2013)===
''Feature Release''
{|
| style="vertical-align:top;" | {{add}} || spt:id2url - Attribut classname hinzugefügt
|-
| style="vertical-align:top;" | {{update}} || Bedingungen für die Anzeige des I-Links optimiert, erweiterte Überprüfung der Setzungen im Cookie.
|-
| style="vertical-align:top;" | {{add}} || Attributabfrage von "html_img_dimension" in <spt:formsolutions>, <spt:ilink>, <spt:image>, <spt:imp>, <spt:ilink> und <spt:systemlink> hinzugefügt.
|-
| style="vertical-align:top;" | {{fix}} || Eingabe von Kommazahlen in einem <spt:number>-Feld führt zu einem Internal Error
|}
===1.5.2 (28.06.2013)===
''Hotfix''
{|
|}
===1.5.1 (28.06.2013)===
''Bugfix-Release''
{|
| style="vertical-align:top;" | {{add}} || spt:email2img - CSS-classe sp-mailto wir nur im ersten <a>-Tag gesetzt
|}
===1.5 (05.02.2013)===
''Bugfix Release''
{|
| style="vertical-align:top;" | {{fix}} || Ilink wird bei Artikeln der Virtuellen Verwaltung wg. eines JavaScript-Fehler nicht dargestellt.
|-
| style="vertical-align:top;" | {{update}} || Attribut id wird bei <spt:textarea> jetzt auch an den Versionsvergleich mit <spt:diff> durchgereicht
|-
| style="vertical-align:top;" | {{add}} || Attribut id bei <spt:diff> hinzugefügt
|}
===1.4 (16.01.2013)===
''Feature Release''
{|
| style="vertical-align:top;" | {{update}} || Inline-Style-Angaben des <spt:updown>-Tags entfernt
|-
| style="vertical-align:top;" | {{add}} || Erweiterung von spt:iterator um das Attribut disabled um einzelne Iterator-Blöcke zu disablen
|-
| style="vertical-align:top;" | {{update}} || Umstellung und Optimierung des Ilink-Tags
|}
===1.3 (12.12.2012)===
''Feature Release''
{|
| style="vertical-align:top;" | {{update}} || Die Map mit den sprachspezifischen Begriffen mit scope="page" deklariert, weil sich sonst spt-Tags beim Bestücken der Map gegenseitig beeinflussten
|-
| style="vertical-align:top;" | {{add}} || Erweiterung von <spt:iterator> um das Attribute "invert" und Auswertung des bereits existierenden Attributs "itemtext" (erfordert bei Benutzung der Attribute für korrekte Styles InfoSite5-Modul Version 5.4)
|}
===1.2.1 (23.11.2012)===
''Hotfix''
{|
| style="vertical-align:top;" | {{fix}} || spt:ilink führt in einem bestimmten patchelevel des IE8 & IE7 zu Fehlern
|}
===1.2 (20.11.2012)===
''Bugfix Release''
{|
| style="vertical-align:top;" | {{add}} || ilink - Unterstützung für InfoSite 6
|-
| style="vertical-align:top;" | {{fix}} || In CityGov werden bei Angebundenem TSA-BUS die zur Verfügung stehenden BUS-Artikel nicht korrekt gefiltert.
|}
===1.1.1 (16.10.2012)===
''Hotfix''
{|
| style="vertical-align:top;" | {{fix}} || JavaScript Fehler beim Aufruf des Link-Dialogs im Internet Explorer 8
|-
| style="vertical-align:top;" | {{fix}} || Bei der Umwandlung von E-Maillinks wurden doppelte class-Attribute ausgegeben, wenn der umzuwandelnde Link selbst schon eine Klassenauszeichnung hatte
|-
| style="vertical-align:top;" | {{update}} || Link und Markup des Icons in <spt:personalization> angepasst; Alternativtext und Tooltip jetzt mehrsprachig
|}
===1.1 (16.10.2012)===
''Bugfix Release''
{|
|}

System (Objekt)

2016-09-27T08:12:28Z

Schleuse: /* Attribute */

==Name==
System - Zugriff auf Server-Objekte

==Beschreibung==
Über das System-Objekt können Attribute und Objekte des Servers ereicht werden.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Attribut || Type || Beschreibung || ab IES Version
|-
| <code>system.arguments</code>
| [[Map]] <[[Object]]>
| Liste der von einem [[sp:include]] übergebenen Argumente (Siehe auch [[Eigene Funktionen]]).
| 2.13
|-
| <code>system.warning</code>
| [[Collection]] <[[ServerMessage]]>
| Liste von Warning-[[ServerMessage|ServerMessages]], die bei der letzten Anfrage vom Server erzeugt wurden
| 1
|-
| <code>system.error</code>
| [[Collection]] <[[ServerMessage]]>
| Liste von Error-[[ServerMessage|ServerMessages]], die bei der letzten Anfrage vom Server erzeugt wurden
| 1
|-
| <code>system.fatal</code>
| [[Collection]] <[[ServerMessage]]>
| Liste von Fatal-[[ServerMessage|ServerMessages]], die bei der letzten Anfrage vom Server erzeugt wurden
| 1
|-
| <code>system.status</code>
| [[ServerStatus]]
| Liefert ein ServerStatus-Objekt mit aktuellen Status-Daten des Servers
| 1
|-
| <code>system.window</code>
| [[Window]]
| Aktuelles Fenster des Nutzers
| 1
|-
| <code>system.char</code>
| [[Map]]
| Map von Spezial-Zeichen:
LF: \n<br>
CR: \r<br>
TAB: \t<br>
DOLLAR: $ (Version 2.16)<br>
| 2.12.9
|-
| <code>system.counter.request</code>
| [[Number]]
| Anzahl der Server-Anfragen seit dem letzten Neustart
| 1
|-
| <code>system.counter.login</code>
| [[Number]]
| Anzahl der Nutzer-Anmeldungen seit dem letzten Neustart
| 1
|-
| <code>system.user</code>
| [[User]]
| Aktueller Nutzer
| 1
|-
| <code>system.information</code>
| [[Article]], [[Resource]], [[Media]]
| Aktueller Artikel, Resource oder Medium
| 1
|-
| <code>system.template</code>
| [[Template]]
| Aktuelle verwendetes Template
| 1
|-
| <code>system.publisher</code>
| [[Publisher]]
| Aktuell verwendeter Publisher (Gilt nur im Out-Modus )
| 1
|-
| <code>system.mode</code>
| [[String]]
| Gib den aktuellen Modus des Templates an: ["in"/"out"]
| 1
|-
| <code>system.module</code>
| [[Modul]]
| Liefert die aktuelle Webapplikation
| 1
|-
| <code>system.modules</code>
| [[Collection]] <[[Modul]]>
| Liefert alle Module des IES
| 2.11
|-
| <code>system.moduleMap</code>
| [[Map]] <[[String]],[[Modul]]>
| Liefert alle Module des IES als Map, wobei die ID der Map-Schlüssel ist.
| 2.17
|-
| <code>system.page</code>
| [[Page]]
| Die aktuelle Live-Seite. Dieser Wert steht nur in Live-Seiten zur Verfügung die über ein entsprechendes Template generiert wurden. Siehe auch [[spt:spml]]
| 1
|-
| <code>system.previewArticle</code>
| [[Article]]
| Vom PreviewHandler erzeugtes Artikel-Objekt
| 1
|-
| <code>system.previewUrl</code>
| [[URL]]
| URL der vom PreviewHandler generierten Seite.
| 2.1.0

|-
| <code>system.server</code>
| [[Server]]
| Serverdaten
| 1
|-
| <code>system.database</code>
| [[Database]]
| Datenbank des aktuellen Mandanten
| 1
|-
| <code>system.client</code>
| [[Client]]
| aktuelle Mandanten
| 1
|-
| <code>system.debug</code>
| [[Map]] <[[String]],[[String]]>
| debug ist eine Map mit frei definierbaren Schlüssel/Werte-Paaren, die verwendet werden kann, um Debug-Level zu definieren und in Templates zu verwenden
| 1
|-
| <code>system.now</code>
| [[Date]]
| Liefert die aktuelle Zeit des Servers zurück
| 1
|-
| <code>system.contentType</code>
| [[String]]
| Liefert den Content-Typ des Dokumentes bzw. für den aktuellen Teil des Dokumentes. Dieser Wert wird für eine SPML-Seite entweder über die JSP-Direktive: <%@ page contentType="text/html; charset=UTF-8" %> oder über <sp:io> gesetzt
| 1
|-
| <code>system.host</code>
| [[String]]
| Liefert den Hostnamen des Template-Requests Z.B. www.sitepark.com. Wird der HTTP-Header <code>X-IES-SERVER-NAME</code> mitgesendet, wird dieser Wert verwendet (ab Version 2.1.0.11).
| 1
|-
| <code>system.port</code>
| [[Number]]
| Liefert den Port des Template-Requests. Wird der HTTP-Header <code>X-IES-SERVER-PORT</code> mitgesendet, wird dieser Wert verwendet (ab Version 2.1.0.11).
| 1
|-
| <code>system.scheme</code>
| [[String]]
| Liefert das Schema des Template-Requests. Z.B. http oder https. Wird der HTTP-Header <code>X-IES-SCHEME</code> mitgesendet, wird dieser Wert verwendet (ab Version 2.1.0.11).
| 1
|-
| <code>system.protocol</code>
| [[String]]
| Liefert das Protokoll des Template-Requests. Z.B HTTP/1.1
| 1
|-
| <code>system.baseurl</code>
| [[String]]
| Liefert die Basis URL des Template-Requests Z.B. http://www.sitepark.com, http://www.sitepark.com:8080 oder https://www.sitepark.com. Durch das mitsenden der HTTP-Header: <code>X-IES-SCHEME</code>, <code>X-IES-SERVER-NAME</code> und <code>X-IES-SERVER-PORT</code> kann dieser Wert angepasst werden.
Z.B. über die Apache-Konfiguration mit mod_headers:
RequestHeader append X-IES-SCHEME "https"
RequestHeader append X-IES-SCHEME-NAME "[CMS-HOST]"
# bzw: Apache 2.4
RequestHeader set X-IES-SCHEME "https"
RequestHeader set X-IES-SERVER-NAME "[CMS-HOST]"
| 1
|-
| <code>system.constants</code>
| [[Constants]]
| Diverse Konstanten innerhalb des IES
| 1
|-
| <code>system.session</code>
| [[Number]]
| Identifier der aktuelle Session
| 1
|-
| <code>system.tag</code>
| [[String]]
| Die zuletzt vergebene TagID der Input-Felder (Das aktuelle Element)
| 1
|-
|-
| <code>system.tag.next</code>
| [[String]]
| Die nächste vergebene TagID der Input-Felder (Das nächste Element)
| 2.11
|-
| <code>system.form</code>
| [[String]]
| Die zuletzt vergebene TagID des Formulars (Das aktuelle Formular)
| 1
|-
| <code>system.random</code>
| [[String]]
| Liefert eine Zufallszahl zwischen 0 und 1
| 2.0.3
|-
| <code>system.loopItem</code>
| [[IteratorItem]]
| Liefert das aktuelle Schleifen-Element innerhalb einer [[sp:iterator]]-, [[spt:iterator]]- oder [[sp:loop]]-Schleife.
| 2.0.3.20
|-
| <code>system.iterator</code>
| [[Collection]] <[[IteratorItem]]>
| Liste der aktuellen [[IteratorItem]]-Objekte. Es handelt sich um eine Liste, da auch verschachtelte Iteratoren möglich sind.
| 2.0
|-
| <code>system.currentFieldBase</code>
| [[String]]
| Liefert innerhalb von Iteratoren und Sub-Informations den Basis-Namen.
| 2.11
|-
| <code>system.idGenerator</code>
| [[IdGenerator]]
| Liefert den Id-Generator.
| 2.11
|}

<noinclude>
[[Category:Objekte]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

System (Objekt)

2016-09-27T07:15:43Z

Schleuse: /* Attribute */

==Name==
System - Zugriff auf Server-Objekte

==Beschreibung==
Über das System-Objekt können Attribute und Objekte des Servers ereicht werden.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Attribut || Type || Beschreibung || ab IES Version
|-
| <code>system.arguments</code>
| [[Map]] <[[Object]]>
| Liste der von einem [[sp:include]] übergebenen Argumente (Siehe auch [[Eigene Funktionen]]).
| 2.13
|-
| <code>system.warning</code>
| [[Collection]] <[[ServerMessage]]>
| Liste von Warning-[[ServerMessage|ServerMessages]], die bei der letzten Anfrage vom Server erzeugt wurden
| 1
|-
| <code>system.error</code>
| [[Collection]] <[[ServerMessage]]>
| Liste von Error-[[ServerMessage|ServerMessages]], die bei der letzten Anfrage vom Server erzeugt wurden
| 1
|-
| <code>system.fatal</code>
| [[Collection]] <[[ServerMessage]]>
| Liste von Fatal-[[ServerMessage|ServerMessages]], die bei der letzten Anfrage vom Server erzeugt wurden
| 1
|-
| <code>system.status</code>
| [[ServerStatus]]
| Liefert ein ServerStatus-Objekt mit aktuellen Status-Daten des Servers
| 1
|-
| <code>system.window</code>
| [[Window]]
| Aktuelles Fenster des Nutzers
| 1
|-
| <code>system.char</code>
| [[Map]]
| Map von Spezial-Zeichen:
LF: \n<br>
CR: \r<br>
TAB: \t<br>
DOLLAR: $ (Version 2.16)<br>
| 2.12.9
|-
| <code>system.counter.request</code>
| [[Number]]
| Anzahl der Server-Anfragen seit dem letzten Neustart
| 1
|-
| <code>system.counter.login</code>
| [[Number]]
| Anzahl der Nutzer-Anmeldungen seit dem letzten Neustart
| 1
|-
| <code>system.user</code>
| [[User]]
| Aktueller Nutzer
| 1
|-
| <code>system.information</code>
| [[Article]], [[Resource]], [[Media]]
| Aktueller Artikel, Resource oder Medium
| 1
|-
| <code>system.template</code>
| [[Template]]
| Aktuelle verwendetes Template
| 1
|-
| <code>system.publisher</code>
| [[Publisher]]
| Aktuell verwendeter Publisher (Gilt nur im Out-Modus )
| 1
|-
| <code>system.mode</code>
| [[String]]
| Gib den aktuellen Modus des Templates an: ["in"/"out"]
| 1
|-
| <code>system.module</code>
| [[Modul]]
| Liefert die aktuelle Webapplikation
| 1
|-
| <code>system.modules</code>
| [[Collection]] <[[Modul]]>
| Liefert alle Module des IES
| 2.11
|-
| <code>system.moduleMap</code>
| [[Map]] <[[String]],[[Modul]]>
| Liefert alle Module des IES als Map, wobei die ID der Map-Schlüssel ist.
| 2.17
|-
| <code>system.page</code>
| [[Page]]
| Die aktuelle Live-Seite. Dieser Wert steht nur in Live-Seiten zur Verfügung die über ein entsprechendes Template generiert wurden. Siehe auch [[spt:spml]]
| 1
|-
| <code>system.previewArticle</code>
| [[Article]]
| Vom PreviewHandler erzeugtes Artikel-Objekt
| 1
|-
| <code>system.previewUrl</code>
| [[URL]]
| URL der vom PreviewHandler generierten Seite.
| 2.1.0

|-
| <code>system.server</code>
| [[Server]]
| Serverdaten
| 1
|-
| <code>system.database</code>
| [[Database]]
| Datenbank des aktuellen Mandanten
| 1
|-
| <code>system.client</code>
| [[Client]]
| aktuelle Mandanten
| 1
|-
| <code>system.debug</code>
| [[Map]] <[[String]],[[String]]>
| debug ist eine Map mit frei definierbaren Schlüssel/Werte-Paaren, die verwendet werden kann, um Debug-Level zu definieren und in Templates zu verwenden
| 1
|-
| <code>system.now</code>
| [[Date]]
| Liefert die aktuelle Zeit des Servers zurück
| 1
|-
| <code>system.contentType</code>
| [[String]]
| Liefert den Content-Typ des Dokumentes bzw. für den aktuellen Teil des Dokumentes. Dieser Wert wird für eine SPML-Seite entweder über die JSP-Direktive: <%@ page contentType="text/html; charset=UTF-8" %> oder über <sp:io> gesetzt
| 1
|-
| <code>system.host</code>
| [[String]]
| Liefert den Hostnamen des Template-Requests Z.B. www.sitepark.com. Wird der HTTP-Header <code>X-IES-SERVER-NAME</code> mitgesendet, wird dieser Wert verwendet (ab Version 2.1.0.11).
| 1
|-
| <code>system.port</code>
| [[Number]]
| Liefert den Port des Template-Requests. Wird der HTTP-Header <code>X-IES-SERVER-PORT</code> mitgesendet, wird dieser Wert verwendet (ab Version 2.1.0.11).
| 1
|-
| <code>system.scheme</code>
| [[String]]
| Liefert das Schema des Template-Requests. Z.B. http oder https. Wird der HTTP-Header <code>X-IES-SCHEME</code> mitgesendet, wird dieser Wert verwendet (ab Version 2.1.0.11).
| 1
|-
| <code>system.protocol</code>
| [[String]]
| Liefert das Protokoll des Template-Requests. Z.B HTTP/1.1
| 1
|-
| <code>system.baseurl</code>
| [[String]]
| Liefert die Basis URL des Template-Requests Z.B. http://www.sitepark.com, http://www.sitepark.com:8080 oder https://www.sitepark.com. Durch das mitsenden der HTTP-Header: <code>X-IES-SCHEME</code>, <code>X-IES-SERVER-NAME</code> und <code>X-IES-SERVER-PORT</code> kann dieser Wert angepasst werden.
Z.B. über die Apache-Konfiguration mit mod_headers:
RequestHeader append X-IES-SCHEME "https"
RequestHeader append X-IES-SCHEME-NAME "[CMS-HOST]"
# bzw: Apache 2.4
RequestHeader set X-IES-SCHEME "https"
RequestHeader set X-IES-SERVER-NAME "[CMS-HOST]"
| 1
|-
| <code>system.constants</code>
| [[Constants]]
| Diverse Konstanten innerhalb des IES
| 1
|-
| <code>system.session</code>
| [[Number]]
| Identifier der aktuelle Session
| 1
|-
| <code>system.tag</code>
| [[String]]
| Die zuletzt vergebene TagID der Input-Felder (Das aktuelle Element)
| 1
|-
|-
| <code>system.tag.next</code>
| [[String]]
| Die nächste vergebene TagID der Input-Felder (Das nächste Element)
| 2.11
|-
| <code>system.form</code>
| [[String]]
| Die zuletzt vergebene TagID des Formulars (Das aktuelle Formular)
| 1
|-
| <code>system.random</code>
| [[String]]
| Liefert eine Zufallszahl zwischen 0 und 1
| 2.0.3
|-
| <code>system.loopItem</code>
| [[IteratorItem]]
| Liefert das aktuelle Schleifen-Element innerhalb einer [[sp:iterator]]-, [[spt:iterator]]- oder [[sp:loop]]-Schleife.
| 2.0.3.20
|-
| <code>system.iterator</code>
| [[Collection]] <[[IteratorItem]]>
| Liste der aktuellen Iterator-Objekte. Es handelt sich um eine Liste, da auch verschachtelte Iteratoren möglich sind.
| 2.0
|-
| <code>system.currentFieldBase</code>
| [[String]]
| Liefert innerhalb von Iteratoren und Sub-Informations den Basis-Namen.
| 2.11
|-
| <code>system.idGenerator</code>
| [[IdGenerator]]
| Liefert den Id-Generator.
| 2.11
|}

<noinclude>
[[Category:Objekte]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

Allgemeine Funktionen

2016-07-29T16:11:56Z

Schleuse: /* Funktionen */

==Beschreibung==
Allgemeine Funktionen sind Funktionen die sich nicht auf bestimmte Objekte beziehen und allgemein anwendbar sind

==Funktionen==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Methode || Rückgabewert || Beschreibung || ab IES Version
|-
| <code>isNull([[Object]] object)</code>
| [[Boolean]]
| Liefert <code>true</code>, wenn das Objekt nicht existiert eine leere Zeichenkette oder ein leeres Artikelfeld ist. Die Abfrage, ob ein Objekt NICHT existiert kann durch ein vorangestellte "!" erreicht werden.
| 1
|-
| <code>isNumber([[Object]] object)</code>
| [[Boolean]]
| Liefert <code>true</code>, wenn das Objekt ein numerischer Wert ist. Die Abfrage, ob ein Objekt KEINE Zahl ist, kann durch ein vorangestellte "!" erreicht werden.
| 1
|-
| <code>evalText([[Text]] text)</code>
| [[String]]
| Evaluiert den Text und liefert das Ergebnis zurück.
| 1
|-
| <code>evalExpression([[Expression]] expression)</code>
| [[Number]]
| Evaluiert den Ausdruck und liefert das Ergebnis zurück.
| 1
|-
| <code>evalCondition([[Condition]] condition)</code>
| [[Boolean]]
| Evaluiert den Ausdruck und liefert das Ergebnis zurück.
| 1
|-
| <code>randomUUID()</code>
| [[String]]
| Erzeugt eine UUID
| 2.12
|-
| <code>coalesce([[Object]] object, [...])</code>
| [[Object]]
| Gibt das erste Object zurück welches nicht zu <code>null</code> oder Leerstring evaluiert werden kann
| 2.14.1
|-
| <code>isList([[Object]] object)</code>
| [[Boolean]]
| Liefert <code>true</code>, wenn das übergebene Objekte eine Liste ist
| 2.17
|-
| <code>isMap([[Object]] object)</code>
| [[Boolean]]
| Liefert <code>true</code>, wenn das übergebene Objekte eine Map ist
| 2.17
|-
|}

==Beispiele==

===IsNull im Verbindung mit sp:if===

Template Quelltext
<source lang="xml">
<sp:set name="my_value_1" value="hello world"/>
<sp:set name="my_value_2" value=""/>

<sp:if condition="!isNull(${my_value_1})">
my_value_1 = <sp:print name="my_value_1"/>
</sp:if>
<sp:if condition="isNull(${my_value_2})">
my_value_2 = isNull
</sp:if>
</source>

Ausgabe
<source lang="text">
my_valaue_1 = hello world
my_valaue_2 = isNull
</source>

===IsNumber im Verbindung mit sp:if===

Template Quelltext
<source lang="xml">
<sp:set name="my_int_1" value="123"/>
<sp:set name="my_int_2" value="hello world"/>

<sp:if condition="isNumber(${my_int_1})">
my_int_1 = <sp:print name="my_int_1"/>
</sp:if>
<sp:if condition="!isNumber(${my_int_2})">
my_int_2 = is not a number
</sp:if>
</source>

Ausgabe
<source lang="text">
my_int_1 = 123
my_int_2 = is not a number
</source>

===coalesce===
Template Quelltext
<source lang="xml">

<sp:set name="foobar" value="">
<sp:set name="foo" value="123" />
<sp:map name="frequencies" action="put" key="C" object="system.template"/>

"<sp:print name="coalesce(${!{gui.informations}}, ${barfoo}, ${frequencies.C}, 'teststring', 456)" />" = "100010100000001010-2000" [!{gui.informations}]
"<sp:print name="coalesce(${!{existiert.nicht}}, ${barfoo}, ${frequencies.C}, 'teststring', 456)" />" = "100010100000002098-6000" [system.template]
"<sp:print name="coalesce(${!{existiert.nicht}}, ${barfoo}, ${frequencies.D}, 'teststring', 456)" />" = "teststring"
"<sp:print name="coalesce(${!{existiert.nicht}}, ${barfoo}, ${frequencies.D}, ' ', 'teststring', 456)" />" = " "
</source>

<noinclude>
[[Category:Funktionen]]
</noinclude>

Map (Objekt)

2016-07-27T11:28:57Z

Schleuse: /* Methoden */

==Name==
Map - Liste von Schlüssel/Werte-Paaren

==Beschreibung==
Eine Map ist ein Objekt das Schlüssel/Werte-Paare aufnimmt. Jeder Schlüssel kann nur einmal in der Map enthalten sein. Maps können mit dem <code>[[sp:map]]</code>-Tag erzeugt, geändert und gelöscht werden. Um auf ein Element der Map zuzugreifen, wird der Schlüssel wie ein [[Attribute|Attribut]] verwendet, somit ist ein Schlüsselname bestimmten Regeln unterworfen. Z.B. sollte ein Schlüsselname nicht mit einer Zahl beginnen.

myMap.myKey

Die Map <code>myMap</code> hat einen Schlüssel <code>myKey</code>. Da <code>myKey</code> hier als [[Attribute|Attribut]] verwendet wird, muss darauf geachtet werden, dass die Schlüsselnamen den Konventionen eines Attributes entsprechen.

==Attribute==
{| class="prettytable"
|- class="hintergrundfarbe1"
! Attribut || Type || Beschreibung || ab IES Version || veraltet ab IES Version
|-
| size
| [[Number]]
| Anzahl der Einträge in der Map
| 1
| 2.17
|-
| entries
| [[Collection]] <[[MapEntry]]>
| Liste aller Schlüssel/Werte-Paare als [[MapEntry]] Objekte
| 1
| 2.17
|-
| keys
| [[Collection]] <[[Object]]>
| Liste aller Schlüssel
| 1
| 2.17
|-
| values
| [[Collection]] <[[Object]]>
| Liste aller Werte
| 1
| 2.17
|}

==Methoden==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Methode || Rückgabewert || Beschreibung || ab IES Version
|-
| <code>toJson()</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toJson([[Number]] indentFactor)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toJson([[Number]] indentFactor, [[Number]] indent)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toJson([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray()</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor, [[Number]] indent)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>get([[String]] name)</code>
| Objekt
| Liefert Wert der unter <code>name</code> abgelegt ist.
| 2.17
|-
| <code>length()</code>
| [[Number]]
| Liefert die Anzahl der Namen/Werte Paare in der Map
| 2.17
|-
| <code>getNames()</code>
| [[Collection]] <[[String]]>
| Liefert die Liste aller Namen der Map
| 2.17
|-
| <code>entrySet()</code>
| [[Collection]] <[[MapEntry]]>
| Liefert die Liste aller Namen/Werte Paare der Map
| 2.17
|-
| <code>getValues()</code>
| [[Collection]]
| Liefert die Liste aller Werte der Map
| 2.17
|}
;<code>[[String]] toJson([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
:Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
:;Parameter
::;<code>[[Number]] indentFactor</code>
:::Anzahl der Einrückungen pro Ebene. Optional (Default-Wert: 0).
::;<code>[[Number]] indent</code>
:::Initiale Anzahl der Einrückungs-Zeichen. Optional (Default-Wert: 0).
::;<code>[[String]] indentChar</code>
:::Zeichen, das als Einrückungszeichen verwendet werden soll. Optional (Default-Wert: ' ').
:;Rückgabewert
::;String
:::JSON als String.
;<code>[[String]] toPhpArray([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
:Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
:;Parameter
::;<code>[[Number]] indentFactor</code>
:::Anzahl der Einrückungen pro Ebene. Optional (Default-Wert: 0).
::;<code>[[Number]] indent</code>
:::Initiale Anzahl der Einrückungs-Zeichen. Optional (Default-Wert: 0).
::;<code>[[String]] indentChar</code>
:::Zeichen, das als Einrückungszeichen verwendet werden soll. Optional (Default-Wert: ' ').
:;Rückgabewert
::;String
:::PHPArray als String.

<noinclude>
[[Category:Objekte]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

Collection (Objekt)

2016-07-27T11:28:23Z

Schleuse: /* Methoden */

==Name==
Collection - Liste beliebiger Objekte

==Beschreibung==
Eine Collection enthält eine beliebige Liste von Objekten. In einer Collection können Objekte hinzugefügt, geändert und gelöscht werden (siehe [[sp:collection]]). Auf einzelne Objekte der Collection kann mit Hilfe eines Index zugegriffen werden. Dazu steht folgende Syntax zur Verfügung.

myCollection[3]

Bei der Angabe des Index 3 wird das 4. Element der Collection zurückgeliefert, da die Collection mit dem Index 0 beginnt. Bei der Angabe eines negativen Index können die letzten Objekte der Collection erfragt werden, ohne das die Länge der Collection bekannt sein muß.

myCollection[-1]

Bei der Angabe des Index -1 wird das letzte Objekt der Collection zurückgeliefert. Bei einem Index von -2 würde das zweitletzte Objekt zurückgeliefert werden usw.

Um alle Objekte einer Collection nacheinander in einer Schleife zu durchlaufen kann der Tag [[sp:loop]] verwendet werden.

==Ausgabe==
Bei der Ausgabe dieses Objektes werden alle Einträgen kommasepariert ausgebeben.

==Sonderregelung==
Um den Umgang mit Collections zu vereinfachen gilt folgende Sondereregelung:

Wird auf die Collection ein Attribut abgefragt, das die Collection nicht besitzt, so wird dieses Attribut von dem ersten Eintrag der Liste abgefragt. Besitzt auch das erste Element der Liste dieses Attribut nicht, wird nichts zurück geliefert.

==Attribute==
{| class="prettytable"
|- class="hintergrundfarbe1"
! Attribut || Type || Beschreibung || ab IES Version || veraltet ab IES Version
|-
| size
| [[Number]]
| Anzahl der Objekte in der Collection
| 1
| 2.17
|}

==Methoden==
{| class="prettytable"
|- class="hintergrundfarbe1"
! Methode || Rückgabewert || Beschreibung || ab IES Version
|-
| <code>contains(Object o)</code>
| [[Boolean]]
| Liefert <code>true</code>, wenn das Objekt in der Liste enthalten ist.
| 1
|-
| <code>toJson()</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toJson([[Number]] indentFactor)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toJson([[Number]] indentFactor, [[Number]] indent)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toJson([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray()</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor, [[Number]] indent)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>join([[String]] separator)</code>
| [[String]]
| Erzeugt aus der Collection einen String, bei dem zwischen jedem Element die angegebene Zeichenkette eingefügt wird.
| 2.13
|-
| <code>intersect(Collection c)</code>
| [[Collection]]
| Liefert die Schnittmenge der aktuellen List mit der übergebenen.
| 2.13
|-
| <code>toMap([[String]] key)</code>
| [[String]]
| Erzeugt aus einer Collection eine Map, wobei die Objekte in der Collection ein Feld mit dem übergebenen Name in <code>key</code> besitzten müssen.
| 2.13
|-
| <code>length()</code>
| [[Number]]
| Liefert die Anzahl der Werte in der Liste
| 2.17
|-
|}

;<code>[[Boolean]] contains(Object o)</code>
:Liefert <code>true</code>, wenn das Objekt in der Collection enthalten ist. Alle Objekte der Liste werden mit <code>o</code> verglichen. Stimmt ein Objekt der Collection mit <code>o</code> überein wird <code>true</code> zurückgeliefert, sonst <code>false</code>. Zu beachten ist, das die Objekte nicht direkt miteinander verglichen werden, sondern zunächst in ein ''Vergleichsobjekt'' umgewandelt werden. Bei Objekten, die eine [[ID]] besitzen wird diese ID als ''Vergleichsobjekt'' verwendet. Daraus folgt, dass nicht die Objekte selber miteinander verglichen werden, sondern lediglich deren IDs.
:;Parameter
::;<code>Object o</code>
:::Objekt, das mit den Objekten der Collection verglichen werden soll.
:;Rückgabewert
::;Boolean
:::<code>true</code>, wenn das Objekt enhalten ist, sonst <code>false</code>.
;<code>[[Collection]] intersect(Collection c)</code>
:Liefert die Schnittmenge der aktuellen List mit der übergebenen. Alle Objekte der Liste werden mit den Objekten von <code>c</code> verglichen. Stimmt ein Objekt der Collection mit <code>o</code> überein, ist es in der zurück gegebenen liste einthalten. Zu beachten ist, das die Objekte nicht direkt miteinander verglichen werden, sondern zunächst in ein ''Vergleichsobjekt'' umgewandelt werden. Bei Objekten, die eine [[ID]] besitzen wird diese ID als ''Vergleichsobjekt'' verwendet. Daraus folgt, dass nicht die Objekte selber miteinander verglichen werden, sondern lediglich deren IDs.
:;Parameter
::;<code>Object o</code>
:::Objekt, das mit den Objekten der Collection verglichen werden soll.
:;Rückgabewert
::;Collection
:::Schnittmenge der beiden Collections.
;<code>[[Map]] toMap([[String]] key)</code>
:Erzeugt aus einer Collection eine Map, wobei die Objekte in der Collection ein Feld mit dem übergebenen Name in <code>key</code> besitzten müssen. Der Wert des Feldes wird als Key der Map verwendet.
:;Parameter
::;<code>[[String]] key</code>
:::Feldname dessen Wert als Key für die Map verwendet wird.
:;Rückgabewert
::;Map
:::Map mit den Einträgen der Liste gemappt auf des Feld <code>key</code>
;<code>[[String]] toJson([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
:Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
:;Parameter
::;<code>[[Number]] indentFactor</code>
:::Anzahl der Einrückungen pro Ebene. Optional (Default-Wert: 0).
::;<code>[[Number]] indent</code>
:::Initiale Anzahl der Einrückungs-Zeichen. Optional (Default-Wert: 0).
::;<code>[[String]] indentChar</code>
:::Zeichen, das als Einrückungszeichen verwendet werden soll. Optional (Default-Wert: ' ').
:;Rückgabewert
::;String
:::JSON als String.
;<code>[[String]] toPhpArray([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
:Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
:;Parameter
::;<code>[[Number]] indentFactor</code>
:::Anzahl der Einrückungen pro Ebene. Optional (Default-Wert: 0).
::;<code>[[Number]] indent</code>
:::Initiale Anzahl der Einrückungs-Zeichen. Optional (Default-Wert: 0).
::;<code>[[String]] indentChar</code>
:::Zeichen, das als Einrückungszeichen verwendet werden soll. Optional (Default-Wert: ' ').
:;Rückgabewert
::;String
:::PHPArray als String.
;<code>[[String]] join([[String]] separator)</code>
:Erzeugt aus der Collection einen String, bei dem zwischen jedem Element die angegebene Zeichenkette eingefügt wird.
:Beispiel:
<sp:collection name="myList" action="add" value="peter"/>
<sp:collection name="myList" action="add" value="paul"/>
<sp:collection name="myList" action="add" value="mary"/>
<sp:print name="myList.join(' or ')"/>
wird zu
peter or paul or mary
:;Parameter
::;<code>[[String]] separator</code>
:::Zeichen, das zwischen die verketteten Elemente der Liste eingefügt wird.
:;Rückgabewert
::;String
:::String aus den Elementen der Collection.

<noinclude>
[[Category:Objekte]]
</noinclude>

Collection (Objekt)

2016-07-27T11:28:15Z

Schleuse: /* Methoden */

==Name==
Collection - Liste beliebiger Objekte

==Beschreibung==
Eine Collection enthält eine beliebige Liste von Objekten. In einer Collection können Objekte hinzugefügt, geändert und gelöscht werden (siehe [[sp:collection]]). Auf einzelne Objekte der Collection kann mit Hilfe eines Index zugegriffen werden. Dazu steht folgende Syntax zur Verfügung.

myCollection[3]

Bei der Angabe des Index 3 wird das 4. Element der Collection zurückgeliefert, da die Collection mit dem Index 0 beginnt. Bei der Angabe eines negativen Index können die letzten Objekte der Collection erfragt werden, ohne das die Länge der Collection bekannt sein muß.

myCollection[-1]

Bei der Angabe des Index -1 wird das letzte Objekt der Collection zurückgeliefert. Bei einem Index von -2 würde das zweitletzte Objekt zurückgeliefert werden usw.

Um alle Objekte einer Collection nacheinander in einer Schleife zu durchlaufen kann der Tag [[sp:loop]] verwendet werden.

==Ausgabe==
Bei der Ausgabe dieses Objektes werden alle Einträgen kommasepariert ausgebeben.

==Sonderregelung==
Um den Umgang mit Collections zu vereinfachen gilt folgende Sondereregelung:

Wird auf die Collection ein Attribut abgefragt, das die Collection nicht besitzt, so wird dieses Attribut von dem ersten Eintrag der Liste abgefragt. Besitzt auch das erste Element der Liste dieses Attribut nicht, wird nichts zurück geliefert.

==Attribute==
{| class="prettytable"
|- class="hintergrundfarbe1"
! Attribut || Type || Beschreibung || ab IES Version || veraltet ab IES Version
|-
| size
| [[Number]]
| Anzahl der Objekte in der Collection
| 1
| 2.17
|}

==Methoden==
{| class="prettytable"
|- class="hintergrundfarbe1"
! Methode || Rückgabewert || Beschreibung || ab IES Version
|-
| <code>contains(Object o)</code>
| [[Boolean]]
| Liefert <code>true</code>, wenn das Objekt in der Liste enthalten ist.
| 1
| <code>toJson()</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toJson([[Number]] indentFactor)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toJson([[Number]] indentFactor, [[Number]] indent)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toJson([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray()</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor, [[Number]] indent)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>join([[String]] separator)</code>
| [[String]]
| Erzeugt aus der Collection einen String, bei dem zwischen jedem Element die angegebene Zeichenkette eingefügt wird.
| 2.13
|-
| <code>intersect(Collection c)</code>
| [[Collection]]
| Liefert die Schnittmenge der aktuellen List mit der übergebenen.
| 2.13
|-
| <code>toMap([[String]] key)</code>
| [[String]]
| Erzeugt aus einer Collection eine Map, wobei die Objekte in der Collection ein Feld mit dem übergebenen Name in <code>key</code> besitzten müssen.
| 2.13
|-
| <code>length()</code>
| [[Number]]
| Liefert die Anzahl der Werte in der Liste
| 2.17
|-
|}

;<code>[[Boolean]] contains(Object o)</code>
:Liefert <code>true</code>, wenn das Objekt in der Collection enthalten ist. Alle Objekte der Liste werden mit <code>o</code> verglichen. Stimmt ein Objekt der Collection mit <code>o</code> überein wird <code>true</code> zurückgeliefert, sonst <code>false</code>. Zu beachten ist, das die Objekte nicht direkt miteinander verglichen werden, sondern zunächst in ein ''Vergleichsobjekt'' umgewandelt werden. Bei Objekten, die eine [[ID]] besitzen wird diese ID als ''Vergleichsobjekt'' verwendet. Daraus folgt, dass nicht die Objekte selber miteinander verglichen werden, sondern lediglich deren IDs.
:;Parameter
::;<code>Object o</code>
:::Objekt, das mit den Objekten der Collection verglichen werden soll.
:;Rückgabewert
::;Boolean
:::<code>true</code>, wenn das Objekt enhalten ist, sonst <code>false</code>.
;<code>[[Collection]] intersect(Collection c)</code>
:Liefert die Schnittmenge der aktuellen List mit der übergebenen. Alle Objekte der Liste werden mit den Objekten von <code>c</code> verglichen. Stimmt ein Objekt der Collection mit <code>o</code> überein, ist es in der zurück gegebenen liste einthalten. Zu beachten ist, das die Objekte nicht direkt miteinander verglichen werden, sondern zunächst in ein ''Vergleichsobjekt'' umgewandelt werden. Bei Objekten, die eine [[ID]] besitzen wird diese ID als ''Vergleichsobjekt'' verwendet. Daraus folgt, dass nicht die Objekte selber miteinander verglichen werden, sondern lediglich deren IDs.
:;Parameter
::;<code>Object o</code>
:::Objekt, das mit den Objekten der Collection verglichen werden soll.
:;Rückgabewert
::;Collection
:::Schnittmenge der beiden Collections.
;<code>[[Map]] toMap([[String]] key)</code>
:Erzeugt aus einer Collection eine Map, wobei die Objekte in der Collection ein Feld mit dem übergebenen Name in <code>key</code> besitzten müssen. Der Wert des Feldes wird als Key der Map verwendet.
:;Parameter
::;<code>[[String]] key</code>
:::Feldname dessen Wert als Key für die Map verwendet wird.
:;Rückgabewert
::;Map
:::Map mit den Einträgen der Liste gemappt auf des Feld <code>key</code>
;<code>[[String]] toJson([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
:Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
:;Parameter
::;<code>[[Number]] indentFactor</code>
:::Anzahl der Einrückungen pro Ebene. Optional (Default-Wert: 0).
::;<code>[[Number]] indent</code>
:::Initiale Anzahl der Einrückungs-Zeichen. Optional (Default-Wert: 0).
::;<code>[[String]] indentChar</code>
:::Zeichen, das als Einrückungszeichen verwendet werden soll. Optional (Default-Wert: ' ').
:;Rückgabewert
::;String
:::JSON als String.
;<code>[[String]] toPhpArray([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
:Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
:;Parameter
::;<code>[[Number]] indentFactor</code>
:::Anzahl der Einrückungen pro Ebene. Optional (Default-Wert: 0).
::;<code>[[Number]] indent</code>
:::Initiale Anzahl der Einrückungs-Zeichen. Optional (Default-Wert: 0).
::;<code>[[String]] indentChar</code>
:::Zeichen, das als Einrückungszeichen verwendet werden soll. Optional (Default-Wert: ' ').
:;Rückgabewert
::;String
:::PHPArray als String.
;<code>[[String]] join([[String]] separator)</code>
:Erzeugt aus der Collection einen String, bei dem zwischen jedem Element die angegebene Zeichenkette eingefügt wird.
:Beispiel:
<sp:collection name="myList" action="add" value="peter"/>
<sp:collection name="myList" action="add" value="paul"/>
<sp:collection name="myList" action="add" value="mary"/>
<sp:print name="myList.join(' or ')"/>
wird zu
peter or paul or mary
:;Parameter
::;<code>[[String]] separator</code>
:::Zeichen, das zwischen die verketteten Elemente der Liste eingefügt wird.
:;Rückgabewert
::;String
:::String aus den Elementen der Collection.

<noinclude>
[[Category:Objekte]]
</noinclude>

Collection (Objekt)

2016-07-27T11:27:59Z

Schleuse: /* Methoden */

==Name==
Collection - Liste beliebiger Objekte

==Beschreibung==
Eine Collection enthält eine beliebige Liste von Objekten. In einer Collection können Objekte hinzugefügt, geändert und gelöscht werden (siehe [[sp:collection]]). Auf einzelne Objekte der Collection kann mit Hilfe eines Index zugegriffen werden. Dazu steht folgende Syntax zur Verfügung.

myCollection[3]

Bei der Angabe des Index 3 wird das 4. Element der Collection zurückgeliefert, da die Collection mit dem Index 0 beginnt. Bei der Angabe eines negativen Index können die letzten Objekte der Collection erfragt werden, ohne das die Länge der Collection bekannt sein muß.

myCollection[-1]

Bei der Angabe des Index -1 wird das letzte Objekt der Collection zurückgeliefert. Bei einem Index von -2 würde das zweitletzte Objekt zurückgeliefert werden usw.

Um alle Objekte einer Collection nacheinander in einer Schleife zu durchlaufen kann der Tag [[sp:loop]] verwendet werden.

==Ausgabe==
Bei der Ausgabe dieses Objektes werden alle Einträgen kommasepariert ausgebeben.

==Sonderregelung==
Um den Umgang mit Collections zu vereinfachen gilt folgende Sondereregelung:

Wird auf die Collection ein Attribut abgefragt, das die Collection nicht besitzt, so wird dieses Attribut von dem ersten Eintrag der Liste abgefragt. Besitzt auch das erste Element der Liste dieses Attribut nicht, wird nichts zurück geliefert.

==Attribute==
{| class="prettytable"
|- class="hintergrundfarbe1"
! Attribut || Type || Beschreibung || ab IES Version || veraltet ab IES Version
|-
| size
| [[Number]]
| Anzahl der Objekte in der Collection
| 1
| 2.17
|}

==Methoden==
{| class="prettytable"
|- class="hintergrundfarbe1"
! Methode || Rückgabewert || Beschreibung || ab IES Version
|-
| <code>contains(Object o)</code>
| [[Boolean]]
| Liefert <code>true</code>, wenn das Objekt in der Liste enthalten ist.
| 1
|-
| <code>intersect(Collection c)</code>
| [[Collection]]
| Liefert die Schnittmenge der aktuellen List mit der übergebenen.
| 2.13
|-
| <code>toMap([[String]] key)</code>
| [[String]]
| Erzeugt aus einer Collection eine Map, wobei die Objekte in der Collection ein Feld mit dem übergebenen Name in <code>key</code> besitzten müssen.
| 2.13
|-
| <code>toJson()</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toJson([[Number]] indentFactor)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toJson([[Number]] indentFactor, [[Number]] indent)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toJson([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray()</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor, [[Number]] indent)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>join([[String]] separator)</code>
| [[String]]
| Erzeugt aus der Collection einen String, bei dem zwischen jedem Element die angegebene Zeichenkette eingefügt wird.
| 2.13
|-
| <code>length()</code>
| [[Number]]
| Liefert die Anzahl der Werte in der Liste
| 2.17
|-
|}

;<code>[[Boolean]] contains(Object o)</code>
:Liefert <code>true</code>, wenn das Objekt in der Collection enthalten ist. Alle Objekte der Liste werden mit <code>o</code> verglichen. Stimmt ein Objekt der Collection mit <code>o</code> überein wird <code>true</code> zurückgeliefert, sonst <code>false</code>. Zu beachten ist, das die Objekte nicht direkt miteinander verglichen werden, sondern zunächst in ein ''Vergleichsobjekt'' umgewandelt werden. Bei Objekten, die eine [[ID]] besitzen wird diese ID als ''Vergleichsobjekt'' verwendet. Daraus folgt, dass nicht die Objekte selber miteinander verglichen werden, sondern lediglich deren IDs.
:;Parameter
::;<code>Object o</code>
:::Objekt, das mit den Objekten der Collection verglichen werden soll.
:;Rückgabewert
::;Boolean
:::<code>true</code>, wenn das Objekt enhalten ist, sonst <code>false</code>.
;<code>[[Collection]] intersect(Collection c)</code>
:Liefert die Schnittmenge der aktuellen List mit der übergebenen. Alle Objekte der Liste werden mit den Objekten von <code>c</code> verglichen. Stimmt ein Objekt der Collection mit <code>o</code> überein, ist es in der zurück gegebenen liste einthalten. Zu beachten ist, das die Objekte nicht direkt miteinander verglichen werden, sondern zunächst in ein ''Vergleichsobjekt'' umgewandelt werden. Bei Objekten, die eine [[ID]] besitzen wird diese ID als ''Vergleichsobjekt'' verwendet. Daraus folgt, dass nicht die Objekte selber miteinander verglichen werden, sondern lediglich deren IDs.
:;Parameter
::;<code>Object o</code>
:::Objekt, das mit den Objekten der Collection verglichen werden soll.
:;Rückgabewert
::;Collection
:::Schnittmenge der beiden Collections.
;<code>[[Map]] toMap([[String]] key)</code>
:Erzeugt aus einer Collection eine Map, wobei die Objekte in der Collection ein Feld mit dem übergebenen Name in <code>key</code> besitzten müssen. Der Wert des Feldes wird als Key der Map verwendet.
:;Parameter
::;<code>[[String]] key</code>
:::Feldname dessen Wert als Key für die Map verwendet wird.
:;Rückgabewert
::;Map
:::Map mit den Einträgen der Liste gemappt auf des Feld <code>key</code>
;<code>[[String]] toJson([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
:Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
:;Parameter
::;<code>[[Number]] indentFactor</code>
:::Anzahl der Einrückungen pro Ebene. Optional (Default-Wert: 0).
::;<code>[[Number]] indent</code>
:::Initiale Anzahl der Einrückungs-Zeichen. Optional (Default-Wert: 0).
::;<code>[[String]] indentChar</code>
:::Zeichen, das als Einrückungszeichen verwendet werden soll. Optional (Default-Wert: ' ').
:;Rückgabewert
::;String
:::JSON als String.
;<code>[[String]] toPhpArray([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
:Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
:;Parameter
::;<code>[[Number]] indentFactor</code>
:::Anzahl der Einrückungen pro Ebene. Optional (Default-Wert: 0).
::;<code>[[Number]] indent</code>
:::Initiale Anzahl der Einrückungs-Zeichen. Optional (Default-Wert: 0).
::;<code>[[String]] indentChar</code>
:::Zeichen, das als Einrückungszeichen verwendet werden soll. Optional (Default-Wert: ' ').
:;Rückgabewert
::;String
:::PHPArray als String.
;<code>[[String]] join([[String]] separator)</code>
:Erzeugt aus der Collection einen String, bei dem zwischen jedem Element die angegebene Zeichenkette eingefügt wird.
:Beispiel:
<sp:collection name="myList" action="add" value="peter"/>
<sp:collection name="myList" action="add" value="paul"/>
<sp:collection name="myList" action="add" value="mary"/>
<sp:print name="myList.join(' or ')"/>
wird zu
peter or paul or mary
:;Parameter
::;<code>[[String]] separator</code>
:::Zeichen, das zwischen die verketteten Elemente der Liste eingefügt wird.
:;Rückgabewert
::;String
:::String aus den Elementen der Collection.

<noinclude>
[[Category:Objekte]]
</noinclude>

Collection (Objekt)

2016-07-27T11:27:42Z

Schleuse: /* Methoden */

==Name==
Collection - Liste beliebiger Objekte

==Beschreibung==
Eine Collection enthält eine beliebige Liste von Objekten. In einer Collection können Objekte hinzugefügt, geändert und gelöscht werden (siehe [[sp:collection]]). Auf einzelne Objekte der Collection kann mit Hilfe eines Index zugegriffen werden. Dazu steht folgende Syntax zur Verfügung.

myCollection[3]

Bei der Angabe des Index 3 wird das 4. Element der Collection zurückgeliefert, da die Collection mit dem Index 0 beginnt. Bei der Angabe eines negativen Index können die letzten Objekte der Collection erfragt werden, ohne das die Länge der Collection bekannt sein muß.

myCollection[-1]

Bei der Angabe des Index -1 wird das letzte Objekt der Collection zurückgeliefert. Bei einem Index von -2 würde das zweitletzte Objekt zurückgeliefert werden usw.

Um alle Objekte einer Collection nacheinander in einer Schleife zu durchlaufen kann der Tag [[sp:loop]] verwendet werden.

==Ausgabe==
Bei der Ausgabe dieses Objektes werden alle Einträgen kommasepariert ausgebeben.

==Sonderregelung==
Um den Umgang mit Collections zu vereinfachen gilt folgende Sondereregelung:

Wird auf die Collection ein Attribut abgefragt, das die Collection nicht besitzt, so wird dieses Attribut von dem ersten Eintrag der Liste abgefragt. Besitzt auch das erste Element der Liste dieses Attribut nicht, wird nichts zurück geliefert.

==Attribute==
{| class="prettytable"
|- class="hintergrundfarbe1"
! Attribut || Type || Beschreibung || ab IES Version || veraltet ab IES Version
|-
| size
| [[Number]]
| Anzahl der Objekte in der Collection
| 1
| 2.17
|}

==Methoden==
{| class="prettytable"
|- class="hintergrundfarbe1"
! Methode || Rückgabewert || Beschreibung || ab IES Version
| <code>contains(Object o)</code>
| [[Boolean]]
| Liefert <code>true</code>, wenn das Objekt in der Liste enthalten ist.
| 1
|-
| <code>intersect(Collection c)</code>
| [[Collection]]
| Liefert die Schnittmenge der aktuellen List mit der übergebenen.
| 2.13
|-
| <code>toMap([[String]] key)</code>
| [[String]]
| Erzeugt aus einer Collection eine Map, wobei die Objekte in der Collection ein Feld mit dem übergebenen Name in <code>key</code> besitzten müssen.
| 2.13
|-
| <code>toJson()</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toJson([[Number]] indentFactor)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toJson([[Number]] indentFactor, [[Number]] indent)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toJson([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray()</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor, [[Number]] indent)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>join([[String]] separator)</code>
| [[String]]
| Erzeugt aus der Collection einen String, bei dem zwischen jedem Element die angegebene Zeichenkette eingefügt wird.
| 2.13
|-
| <code>length()</code>
| [[Number]]
| Liefert die Anzahl der Werte in der Liste
| 2.17
|-
|}

;<code>[[Boolean]] contains(Object o)</code>
:Liefert <code>true</code>, wenn das Objekt in der Collection enthalten ist. Alle Objekte der Liste werden mit <code>o</code> verglichen. Stimmt ein Objekt der Collection mit <code>o</code> überein wird <code>true</code> zurückgeliefert, sonst <code>false</code>. Zu beachten ist, das die Objekte nicht direkt miteinander verglichen werden, sondern zunächst in ein ''Vergleichsobjekt'' umgewandelt werden. Bei Objekten, die eine [[ID]] besitzen wird diese ID als ''Vergleichsobjekt'' verwendet. Daraus folgt, dass nicht die Objekte selber miteinander verglichen werden, sondern lediglich deren IDs.
:;Parameter
::;<code>Object o</code>
:::Objekt, das mit den Objekten der Collection verglichen werden soll.
:;Rückgabewert
::;Boolean
:::<code>true</code>, wenn das Objekt enhalten ist, sonst <code>false</code>.
;<code>[[Collection]] intersect(Collection c)</code>
:Liefert die Schnittmenge der aktuellen List mit der übergebenen. Alle Objekte der Liste werden mit den Objekten von <code>c</code> verglichen. Stimmt ein Objekt der Collection mit <code>o</code> überein, ist es in der zurück gegebenen liste einthalten. Zu beachten ist, das die Objekte nicht direkt miteinander verglichen werden, sondern zunächst in ein ''Vergleichsobjekt'' umgewandelt werden. Bei Objekten, die eine [[ID]] besitzen wird diese ID als ''Vergleichsobjekt'' verwendet. Daraus folgt, dass nicht die Objekte selber miteinander verglichen werden, sondern lediglich deren IDs.
:;Parameter
::;<code>Object o</code>
:::Objekt, das mit den Objekten der Collection verglichen werden soll.
:;Rückgabewert
::;Collection
:::Schnittmenge der beiden Collections.
;<code>[[Map]] toMap([[String]] key)</code>
:Erzeugt aus einer Collection eine Map, wobei die Objekte in der Collection ein Feld mit dem übergebenen Name in <code>key</code> besitzten müssen. Der Wert des Feldes wird als Key der Map verwendet.
:;Parameter
::;<code>[[String]] key</code>
:::Feldname dessen Wert als Key für die Map verwendet wird.
:;Rückgabewert
::;Map
:::Map mit den Einträgen der Liste gemappt auf des Feld <code>key</code>
;<code>[[String]] toJson([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
:Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
:;Parameter
::;<code>[[Number]] indentFactor</code>
:::Anzahl der Einrückungen pro Ebene. Optional (Default-Wert: 0).
::;<code>[[Number]] indent</code>
:::Initiale Anzahl der Einrückungs-Zeichen. Optional (Default-Wert: 0).
::;<code>[[String]] indentChar</code>
:::Zeichen, das als Einrückungszeichen verwendet werden soll. Optional (Default-Wert: ' ').
:;Rückgabewert
::;String
:::JSON als String.
;<code>[[String]] toPhpArray([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
:Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
:;Parameter
::;<code>[[Number]] indentFactor</code>
:::Anzahl der Einrückungen pro Ebene. Optional (Default-Wert: 0).
::;<code>[[Number]] indent</code>
:::Initiale Anzahl der Einrückungs-Zeichen. Optional (Default-Wert: 0).
::;<code>[[String]] indentChar</code>
:::Zeichen, das als Einrückungszeichen verwendet werden soll. Optional (Default-Wert: ' ').
:;Rückgabewert
::;String
:::PHPArray als String.
;<code>[[String]] join([[String]] separator)</code>
:Erzeugt aus der Collection einen String, bei dem zwischen jedem Element die angegebene Zeichenkette eingefügt wird.
:Beispiel:
<sp:collection name="myList" action="add" value="peter"/>
<sp:collection name="myList" action="add" value="paul"/>
<sp:collection name="myList" action="add" value="mary"/>
<sp:print name="myList.join(' or ')"/>
wird zu
peter or paul or mary
:;Parameter
::;<code>[[String]] separator</code>
:::Zeichen, das zwischen die verketteten Elemente der Liste eingefügt wird.
:;Rückgabewert
::;String
:::String aus den Elementen der Collection.

<noinclude>
[[Category:Objekte]]
</noinclude>

Collection (Objekt)

2016-07-27T11:27:23Z

Schleuse: /* Methoden */

==Name==
Collection - Liste beliebiger Objekte

==Beschreibung==
Eine Collection enthält eine beliebige Liste von Objekten. In einer Collection können Objekte hinzugefügt, geändert und gelöscht werden (siehe [[sp:collection]]). Auf einzelne Objekte der Collection kann mit Hilfe eines Index zugegriffen werden. Dazu steht folgende Syntax zur Verfügung.

myCollection[3]

Bei der Angabe des Index 3 wird das 4. Element der Collection zurückgeliefert, da die Collection mit dem Index 0 beginnt. Bei der Angabe eines negativen Index können die letzten Objekte der Collection erfragt werden, ohne das die Länge der Collection bekannt sein muß.

myCollection[-1]

Bei der Angabe des Index -1 wird das letzte Objekt der Collection zurückgeliefert. Bei einem Index von -2 würde das zweitletzte Objekt zurückgeliefert werden usw.

Um alle Objekte einer Collection nacheinander in einer Schleife zu durchlaufen kann der Tag [[sp:loop]] verwendet werden.

==Ausgabe==
Bei der Ausgabe dieses Objektes werden alle Einträgen kommasepariert ausgebeben.

==Sonderregelung==
Um den Umgang mit Collections zu vereinfachen gilt folgende Sondereregelung:

Wird auf die Collection ein Attribut abgefragt, das die Collection nicht besitzt, so wird dieses Attribut von dem ersten Eintrag der Liste abgefragt. Besitzt auch das erste Element der Liste dieses Attribut nicht, wird nichts zurück geliefert.

==Attribute==
{| class="prettytable"
|- class="hintergrundfarbe1"
! Attribut || Type || Beschreibung || ab IES Version || veraltet ab IES Version
|-
| size
| [[Number]]
| Anzahl der Objekte in der Collection
| 1
| 2.17
|}

==Methoden==
{| class="prettytable"
|- class="hintergrundfarbe1"
! Methode || Rückgabewert || Beschreibung || ab IES Version
|-
| <code>length()</code>
| [[Number]]
| Liefert die Anzahl der Namen/Werte Paare in der Liste
| 2.17
|-
| <code>contains(Object o)</code>
| [[Boolean]]
| Liefert <code>true</code>, wenn das Objekt in der Liste enthalten ist.
| 1
|-
| <code>intersect(Collection c)</code>
| [[Collection]]
| Liefert die Schnittmenge der aktuellen List mit der übergebenen.
| 2.13
|-
| <code>toMap([[String]] key)</code>
| [[String]]
| Erzeugt aus einer Collection eine Map, wobei die Objekte in der Collection ein Feld mit dem übergebenen Name in <code>key</code> besitzten müssen.
| 2.13
|-
| <code>toJson()</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toJson([[Number]] indentFactor)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toJson([[Number]] indentFactor, [[Number]] indent)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toJson([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray()</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor, [[Number]] indent)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>join([[String]] separator)</code>
| [[String]]
| Erzeugt aus der Collection einen String, bei dem zwischen jedem Element die angegebene Zeichenkette eingefügt wird.
| 2.13
|}

;<code>[[Boolean]] contains(Object o)</code>
:Liefert <code>true</code>, wenn das Objekt in der Collection enthalten ist. Alle Objekte der Liste werden mit <code>o</code> verglichen. Stimmt ein Objekt der Collection mit <code>o</code> überein wird <code>true</code> zurückgeliefert, sonst <code>false</code>. Zu beachten ist, das die Objekte nicht direkt miteinander verglichen werden, sondern zunächst in ein ''Vergleichsobjekt'' umgewandelt werden. Bei Objekten, die eine [[ID]] besitzen wird diese ID als ''Vergleichsobjekt'' verwendet. Daraus folgt, dass nicht die Objekte selber miteinander verglichen werden, sondern lediglich deren IDs.
:;Parameter
::;<code>Object o</code>
:::Objekt, das mit den Objekten der Collection verglichen werden soll.
:;Rückgabewert
::;Boolean
:::<code>true</code>, wenn das Objekt enhalten ist, sonst <code>false</code>.
;<code>[[Collection]] intersect(Collection c)</code>
:Liefert die Schnittmenge der aktuellen List mit der übergebenen. Alle Objekte der Liste werden mit den Objekten von <code>c</code> verglichen. Stimmt ein Objekt der Collection mit <code>o</code> überein, ist es in der zurück gegebenen liste einthalten. Zu beachten ist, das die Objekte nicht direkt miteinander verglichen werden, sondern zunächst in ein ''Vergleichsobjekt'' umgewandelt werden. Bei Objekten, die eine [[ID]] besitzen wird diese ID als ''Vergleichsobjekt'' verwendet. Daraus folgt, dass nicht die Objekte selber miteinander verglichen werden, sondern lediglich deren IDs.
:;Parameter
::;<code>Object o</code>
:::Objekt, das mit den Objekten der Collection verglichen werden soll.
:;Rückgabewert
::;Collection
:::Schnittmenge der beiden Collections.
;<code>[[Map]] toMap([[String]] key)</code>
:Erzeugt aus einer Collection eine Map, wobei die Objekte in der Collection ein Feld mit dem übergebenen Name in <code>key</code> besitzten müssen. Der Wert des Feldes wird als Key der Map verwendet.
:;Parameter
::;<code>[[String]] key</code>
:::Feldname dessen Wert als Key für die Map verwendet wird.
:;Rückgabewert
::;Map
:::Map mit den Einträgen der Liste gemappt auf des Feld <code>key</code>
;<code>[[String]] toJson([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
:Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
:;Parameter
::;<code>[[Number]] indentFactor</code>
:::Anzahl der Einrückungen pro Ebene. Optional (Default-Wert: 0).
::;<code>[[Number]] indent</code>
:::Initiale Anzahl der Einrückungs-Zeichen. Optional (Default-Wert: 0).
::;<code>[[String]] indentChar</code>
:::Zeichen, das als Einrückungszeichen verwendet werden soll. Optional (Default-Wert: ' ').
:;Rückgabewert
::;String
:::JSON als String.
;<code>[[String]] toPhpArray([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
:Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
:;Parameter
::;<code>[[Number]] indentFactor</code>
:::Anzahl der Einrückungen pro Ebene. Optional (Default-Wert: 0).
::;<code>[[Number]] indent</code>
:::Initiale Anzahl der Einrückungs-Zeichen. Optional (Default-Wert: 0).
::;<code>[[String]] indentChar</code>
:::Zeichen, das als Einrückungszeichen verwendet werden soll. Optional (Default-Wert: ' ').
:;Rückgabewert
::;String
:::PHPArray als String.
;<code>[[String]] join([[String]] separator)</code>
:Erzeugt aus der Collection einen String, bei dem zwischen jedem Element die angegebene Zeichenkette eingefügt wird.
:Beispiel:
<sp:collection name="myList" action="add" value="peter"/>
<sp:collection name="myList" action="add" value="paul"/>
<sp:collection name="myList" action="add" value="mary"/>
<sp:print name="myList.join(' or ')"/>
wird zu
peter or paul or mary
:;Parameter
::;<code>[[String]] separator</code>
:::Zeichen, das zwischen die verketteten Elemente der Liste eingefügt wird.
:;Rückgabewert
::;String
:::String aus den Elementen der Collection.

<noinclude>
[[Category:Objekte]]
</noinclude>

Collection (Objekt)

2016-07-27T11:26:38Z

Schleuse: /* Attribute */

==Name==
Collection - Liste beliebiger Objekte

==Beschreibung==
Eine Collection enthält eine beliebige Liste von Objekten. In einer Collection können Objekte hinzugefügt, geändert und gelöscht werden (siehe [[sp:collection]]). Auf einzelne Objekte der Collection kann mit Hilfe eines Index zugegriffen werden. Dazu steht folgende Syntax zur Verfügung.

myCollection[3]

Bei der Angabe des Index 3 wird das 4. Element der Collection zurückgeliefert, da die Collection mit dem Index 0 beginnt. Bei der Angabe eines negativen Index können die letzten Objekte der Collection erfragt werden, ohne das die Länge der Collection bekannt sein muß.

myCollection[-1]

Bei der Angabe des Index -1 wird das letzte Objekt der Collection zurückgeliefert. Bei einem Index von -2 würde das zweitletzte Objekt zurückgeliefert werden usw.

Um alle Objekte einer Collection nacheinander in einer Schleife zu durchlaufen kann der Tag [[sp:loop]] verwendet werden.

==Ausgabe==
Bei der Ausgabe dieses Objektes werden alle Einträgen kommasepariert ausgebeben.

==Sonderregelung==
Um den Umgang mit Collections zu vereinfachen gilt folgende Sondereregelung:

Wird auf die Collection ein Attribut abgefragt, das die Collection nicht besitzt, so wird dieses Attribut von dem ersten Eintrag der Liste abgefragt. Besitzt auch das erste Element der Liste dieses Attribut nicht, wird nichts zurück geliefert.

==Attribute==
{| class="prettytable"
|- class="hintergrundfarbe1"
! Attribut || Type || Beschreibung || ab IES Version || veraltet ab IES Version
|-
| size
| [[Number]]
| Anzahl der Objekte in der Collection
| 1
| 2.17
|}

==Methoden==
{| class="prettytable"
|- class="hintergrundfarbe1"
! Methode || Rückgabewert || Beschreibung || ab IES Version
|-
| <code>contains(Object o)</code>
| [[Boolean]]
| Liefert <code>true</code>, wenn das Objekt in der Liste enthalten ist.
| 1
|-
| <code>intersect(Collection c)</code>
| [[Collection]]
| Liefert die Schnittmenge der aktuellen List mit der übergebenen.
| 2.13
|-
| <code>toMap([[String]] key)</code>
| [[String]]
| Erzeugt aus einer Collection eine Map, wobei die Objekte in der Collection ein Feld mit dem übergebenen Name in <code>key</code> besitzten müssen.
| 2.13
|-
| <code>toJson()</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toJson([[Number]] indentFactor)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toJson([[Number]] indentFactor, [[Number]] indent)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toJson([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray()</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor, [[Number]] indent)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>join([[String]] separator)</code>
| [[String]]
| Erzeugt aus der Collection einen String, bei dem zwischen jedem Element die angegebene Zeichenkette eingefügt wird.
| 2.13
|}

;<code>[[Boolean]] contains(Object o)</code>
:Liefert <code>true</code>, wenn das Objekt in der Collection enthalten ist. Alle Objekte der Liste werden mit <code>o</code> verglichen. Stimmt ein Objekt der Collection mit <code>o</code> überein wird <code>true</code> zurückgeliefert, sonst <code>false</code>. Zu beachten ist, das die Objekte nicht direkt miteinander verglichen werden, sondern zunächst in ein ''Vergleichsobjekt'' umgewandelt werden. Bei Objekten, die eine [[ID]] besitzen wird diese ID als ''Vergleichsobjekt'' verwendet. Daraus folgt, dass nicht die Objekte selber miteinander verglichen werden, sondern lediglich deren IDs.
:;Parameter
::;<code>Object o</code>
:::Objekt, das mit den Objekten der Collection verglichen werden soll.
:;Rückgabewert
::;Boolean
:::<code>true</code>, wenn das Objekt enhalten ist, sonst <code>false</code>.
;<code>[[Collection]] intersect(Collection c)</code>
:Liefert die Schnittmenge der aktuellen List mit der übergebenen. Alle Objekte der Liste werden mit den Objekten von <code>c</code> verglichen. Stimmt ein Objekt der Collection mit <code>o</code> überein, ist es in der zurück gegebenen liste einthalten. Zu beachten ist, das die Objekte nicht direkt miteinander verglichen werden, sondern zunächst in ein ''Vergleichsobjekt'' umgewandelt werden. Bei Objekten, die eine [[ID]] besitzen wird diese ID als ''Vergleichsobjekt'' verwendet. Daraus folgt, dass nicht die Objekte selber miteinander verglichen werden, sondern lediglich deren IDs.
:;Parameter
::;<code>Object o</code>
:::Objekt, das mit den Objekten der Collection verglichen werden soll.
:;Rückgabewert
::;Collection
:::Schnittmenge der beiden Collections.
;<code>[[Map]] toMap([[String]] key)</code>
:Erzeugt aus einer Collection eine Map, wobei die Objekte in der Collection ein Feld mit dem übergebenen Name in <code>key</code> besitzten müssen. Der Wert des Feldes wird als Key der Map verwendet.
:;Parameter
::;<code>[[String]] key</code>
:::Feldname dessen Wert als Key für die Map verwendet wird.
:;Rückgabewert
::;Map
:::Map mit den Einträgen der Liste gemappt auf des Feld <code>key</code>
;<code>[[String]] toJson([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
:Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
:;Parameter
::;<code>[[Number]] indentFactor</code>
:::Anzahl der Einrückungen pro Ebene. Optional (Default-Wert: 0).
::;<code>[[Number]] indent</code>
:::Initiale Anzahl der Einrückungs-Zeichen. Optional (Default-Wert: 0).
::;<code>[[String]] indentChar</code>
:::Zeichen, das als Einrückungszeichen verwendet werden soll. Optional (Default-Wert: ' ').
:;Rückgabewert
::;String
:::JSON als String.
;<code>[[String]] toPhpArray([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
:Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
:;Parameter
::;<code>[[Number]] indentFactor</code>
:::Anzahl der Einrückungen pro Ebene. Optional (Default-Wert: 0).
::;<code>[[Number]] indent</code>
:::Initiale Anzahl der Einrückungs-Zeichen. Optional (Default-Wert: 0).
::;<code>[[String]] indentChar</code>
:::Zeichen, das als Einrückungszeichen verwendet werden soll. Optional (Default-Wert: ' ').
:;Rückgabewert
::;String
:::PHPArray als String.
;<code>[[String]] join([[String]] separator)</code>
:Erzeugt aus der Collection einen String, bei dem zwischen jedem Element die angegebene Zeichenkette eingefügt wird.
:Beispiel:
<sp:collection name="myList" action="add" value="peter"/>
<sp:collection name="myList" action="add" value="paul"/>
<sp:collection name="myList" action="add" value="mary"/>
<sp:print name="myList.join(' or ')"/>
wird zu
peter or paul or mary
:;Parameter
::;<code>[[String]] separator</code>
:::Zeichen, das zwischen die verketteten Elemente der Liste eingefügt wird.
:;Rückgabewert
::;String
:::String aus den Elementen der Collection.

<noinclude>
[[Category:Objekte]]
</noinclude>

Map (Objekt)

2016-07-27T11:15:37Z

Schleuse: /* Methoden */

==Name==
Map - Liste von Schlüssel/Werte-Paaren

==Beschreibung==
Eine Map ist ein Objekt das Schlüssel/Werte-Paare aufnimmt. Jeder Schlüssel kann nur einmal in der Map enthalten sein. Maps können mit dem <code>[[sp:map]]</code>-Tag erzeugt, geändert und gelöscht werden. Um auf ein Element der Map zuzugreifen, wird der Schlüssel wie ein [[Attribute|Attribut]] verwendet, somit ist ein Schlüsselname bestimmten Regeln unterworfen. Z.B. sollte ein Schlüsselname nicht mit einer Zahl beginnen.

myMap.myKey

Die Map <code>myMap</code> hat einen Schlüssel <code>myKey</code>. Da <code>myKey</code> hier als [[Attribute|Attribut]] verwendet wird, muss darauf geachtet werden, dass die Schlüsselnamen den Konventionen eines Attributes entsprechen.

==Attribute==
{| class="prettytable"
|- class="hintergrundfarbe1"
! Attribut || Type || Beschreibung || ab IES Version || veraltet ab IES Version
|-
| size
| [[Number]]
| Anzahl der Einträge in der Map
| 1
| 2.17
|-
| entries
| [[Collection]] <[[MapEntry]]>
| Liste aller Schlüssel/Werte-Paare als [[MapEntry]] Objekte
| 1
| 2.17
|-
| keys
| [[Collection]] <[[Object]]>
| Liste aller Schlüssel
| 1
| 2.17
|-
| values
| [[Collection]] <[[Object]]>
| Liste aller Werte
| 1
| 2.17
|}

==Methoden==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Methode || Rückgabewert || Beschreibung || ab IES Version
|-
| <code>get([[String]] name)</code>
| Objekt
| Liefert Wert der unter <code>name</code> abgelegt ist.
| 2.17
|-
| <code>length()</code>
| [[Number]]
| Liefert die Anzahl der Namen/Werte Paare in der Map
| 2.17
|-
| <code>getNames()</code>
| [[Collection]] <[[String]]>
| Liefert die Liste aller Namen der Map
| 2.17
|-
| <code>entrySet()</code>
| [[Collection]] <[[MapEntry]]>
| Liefert die Liste aller Namen/Werte Paare der Map
| 2.17
|-
| <code>getValues()</code>
| [[Collection]]
| Liefert die Liste aller Werte der Map
| 2.17
|-
| <code>toJson()</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toJson([[Number]] indentFactor)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toJson([[Number]] indentFactor, [[Number]] indent)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toJson([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray()</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor, [[Number]] indent)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|}
;<code>[[String]] toJson([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
:Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
:;Parameter
::;<code>[[Number]] indentFactor</code>
:::Anzahl der Einrückungen pro Ebene. Optional (Default-Wert: 0).
::;<code>[[Number]] indent</code>
:::Initiale Anzahl der Einrückungs-Zeichen. Optional (Default-Wert: 0).
::;<code>[[String]] indentChar</code>
:::Zeichen, das als Einrückungszeichen verwendet werden soll. Optional (Default-Wert: ' ').
:;Rückgabewert
::;String
:::JSON als String.
;<code>[[String]] toPhpArray([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
:Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
:;Parameter
::;<code>[[Number]] indentFactor</code>
:::Anzahl der Einrückungen pro Ebene. Optional (Default-Wert: 0).
::;<code>[[Number]] indent</code>
:::Initiale Anzahl der Einrückungs-Zeichen. Optional (Default-Wert: 0).
::;<code>[[String]] indentChar</code>
:::Zeichen, das als Einrückungszeichen verwendet werden soll. Optional (Default-Wert: ' ').
:;Rückgabewert
::;String
:::PHPArray als String.

<noinclude>
[[Category:Objekte]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

Map (Objekt)

2016-07-27T11:14:59Z

Schleuse: /* Methoden */

==Name==
Map - Liste von Schlüssel/Werte-Paaren

==Beschreibung==
Eine Map ist ein Objekt das Schlüssel/Werte-Paare aufnimmt. Jeder Schlüssel kann nur einmal in der Map enthalten sein. Maps können mit dem <code>[[sp:map]]</code>-Tag erzeugt, geändert und gelöscht werden. Um auf ein Element der Map zuzugreifen, wird der Schlüssel wie ein [[Attribute|Attribut]] verwendet, somit ist ein Schlüsselname bestimmten Regeln unterworfen. Z.B. sollte ein Schlüsselname nicht mit einer Zahl beginnen.

myMap.myKey

Die Map <code>myMap</code> hat einen Schlüssel <code>myKey</code>. Da <code>myKey</code> hier als [[Attribute|Attribut]] verwendet wird, muss darauf geachtet werden, dass die Schlüsselnamen den Konventionen eines Attributes entsprechen.

==Attribute==
{| class="prettytable"
|- class="hintergrundfarbe1"
! Attribut || Type || Beschreibung || ab IES Version || veraltet ab IES Version
|-
| size
| [[Number]]
| Anzahl der Einträge in der Map
| 1
| 2.17
|-
| entries
| [[Collection]] <[[MapEntry]]>
| Liste aller Schlüssel/Werte-Paare als [[MapEntry]] Objekte
| 1
| 2.17
|-
| keys
| [[Collection]] <[[Object]]>
| Liste aller Schlüssel
| 1
| 2.17
|-
| values
| [[Collection]] <[[Object]]>
| Liste aller Werte
| 1
| 2.17
|}

==Methoden==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Methode || Rückgabewert || Beschreibung || ab IES Version
|-
| <code>get([[String]] name)</code>
| Objekt
| Liefert Wert der unter <code>name</code> abgelegt ist.
| 2.17
|-
| <code>length()</code>
| [[Number]]
| Liefert die Anzahl der Namen/Werte Paare in dem JSON-Objektes.
| 2.17
|-
| <code>getNames()</code>
| [[Collection]] <[[String]]>
| Liefert die Liste aller Namen des JSON-Objektes.
| 2.17
|-
| <code>entrySet()</code>
| [[Collection]] <[[MapEntry]]>
| Liefert die Liste aller Namen/Werte Paare des JSON-Objektes.
| 2.17
|-
| <code>getValues()</code>
| [[Collection]]
| Liefert die Liste aller Werte des JSON-Objektes.
| 2.17
|-
| <code>toJson()</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toJson([[Number]] indentFactor)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toJson([[Number]] indentFactor, [[Number]] indent)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toJson([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray()</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor, [[Number]] indent)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|}
;<code>[[String]] toJson([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
:Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
:;Parameter
::;<code>[[Number]] indentFactor</code>
:::Anzahl der Einrückungen pro Ebene. Optional (Default-Wert: 0).
::;<code>[[Number]] indent</code>
:::Initiale Anzahl der Einrückungs-Zeichen. Optional (Default-Wert: 0).
::;<code>[[String]] indentChar</code>
:::Zeichen, das als Einrückungszeichen verwendet werden soll. Optional (Default-Wert: ' ').
:;Rückgabewert
::;String
:::JSON als String.
;<code>[[String]] toPhpArray([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
:Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
:;Parameter
::;<code>[[Number]] indentFactor</code>
:::Anzahl der Einrückungen pro Ebene. Optional (Default-Wert: 0).
::;<code>[[Number]] indent</code>
:::Initiale Anzahl der Einrückungs-Zeichen. Optional (Default-Wert: 0).
::;<code>[[String]] indentChar</code>
:::Zeichen, das als Einrückungszeichen verwendet werden soll. Optional (Default-Wert: ' ').
:;Rückgabewert
::;String
:::PHPArray als String.

<noinclude>
[[Category:Objekte]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

Map (Objekt)

2016-07-27T11:13:51Z

Schleuse: /* Attribute */

==Name==
Map - Liste von Schlüssel/Werte-Paaren

==Beschreibung==
Eine Map ist ein Objekt das Schlüssel/Werte-Paare aufnimmt. Jeder Schlüssel kann nur einmal in der Map enthalten sein. Maps können mit dem <code>[[sp:map]]</code>-Tag erzeugt, geändert und gelöscht werden. Um auf ein Element der Map zuzugreifen, wird der Schlüssel wie ein [[Attribute|Attribut]] verwendet, somit ist ein Schlüsselname bestimmten Regeln unterworfen. Z.B. sollte ein Schlüsselname nicht mit einer Zahl beginnen.

myMap.myKey

Die Map <code>myMap</code> hat einen Schlüssel <code>myKey</code>. Da <code>myKey</code> hier als [[Attribute|Attribut]] verwendet wird, muss darauf geachtet werden, dass die Schlüsselnamen den Konventionen eines Attributes entsprechen.

==Attribute==
{| class="prettytable"
|- class="hintergrundfarbe1"
! Attribut || Type || Beschreibung || ab IES Version || veraltet ab IES Version
|-
| size
| [[Number]]
| Anzahl der Einträge in der Map
| 1
| 2.17
|-
| entries
| [[Collection]] <[[MapEntry]]>
| Liste aller Schlüssel/Werte-Paare als [[MapEntry]] Objekte
| 1
| 2.17
|-
| keys
| [[Collection]] <[[Object]]>
| Liste aller Schlüssel
| 1
| 2.17
|-
| values
| [[Collection]] <[[Object]]>
| Liste aller Werte
| 1
| 2.17
|}

==Methoden==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Methode || Rückgabewert || Beschreibung || ab IES Version
|-
| <code>toJson()</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toJson([[Number]] indentFactor)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toJson([[Number]] indentFactor, [[Number]] indent)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toJson([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray()</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor, [[Number]] indent)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
| [[String]]
| Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|}
;<code>[[String]] toJson([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
:Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
:;Parameter
::;<code>[[Number]] indentFactor</code>
:::Anzahl der Einrückungen pro Ebene. Optional (Default-Wert: 0).
::;<code>[[Number]] indent</code>
:::Initiale Anzahl der Einrückungs-Zeichen. Optional (Default-Wert: 0).
::;<code>[[String]] indentChar</code>
:::Zeichen, das als Einrückungszeichen verwendet werden soll. Optional (Default-Wert: ' ').
:;Rückgabewert
::;String
:::JSON als String.
;<code>[[String]] toPhpArray([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
:Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
:;Parameter
::;<code>[[Number]] indentFactor</code>
:::Anzahl der Einrückungen pro Ebene. Optional (Default-Wert: 0).
::;<code>[[Number]] indent</code>
:::Initiale Anzahl der Einrückungs-Zeichen. Optional (Default-Wert: 0).
::;<code>[[String]] indentChar</code>
:::Zeichen, das als Einrückungszeichen verwendet werden soll. Optional (Default-Wert: ' ').
:;Rückgabewert
::;String
:::PHPArray als String.

<noinclude>
[[Category:Objekte]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

JSONObject (Objekt)

2016-07-27T11:06:04Z

Schleuse: /* Methoden */

==Name==
JSONObject - http://www.json.org/

==Beschreibung==
Ein JSONObject kann über <code>[[String]].toJson</code> erzeugt werden um JSON-Daten die als Zeichenkette vorliegen verarbeiten zu können. Über die normale Objekt-Notation von SPML kann dann auf die Daten des JSONObject zugegriffen werden.

<source lang="xml">
<sp:set name="jsontxt">{
"a" : null,
"b" : 1,
"c" : 1.4,
"d" : "abc",
"e" : [1,2,3]
}</sp:set>
<sp:set name="json" object="jsontxt.toJson"/>

<sp:print name="json.b"/><br>
<sp:print name="json.e[1]"/>
</source>

Das JSONObject stellt Methoden bereit dessen Rückgabewerte mit sp:loop verwendbar sind
<source lang="xml">
<sp:set name="jsontxt">{
"a" : null,
"b" : 1,
"c" : 1.4,
"d" : "abc",
"e" : [1,2,3]
}</sp:set>
<sp:set name="json" object="jsontxt.toJson"/>
<sp:loop collection="json.getValues()" item="it">
<sp:print name="it"/>
</sp:loop>
</source>

==Methoden==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Methode || Rückgabewert || Beschreibung || ab IES Version
|-
| <code>get([[String]] name)</code>
| Objekt
| Liefert Wert der unter <code>name</code> abgelegt ist.
| 2.9
|-
| <code>length()</code>
| [[Number]]
| Liefert die Anzahl der Namen/Werte Paare in dem JSON-Objektes.
| 2.9
|-
| <code>getNames()</code>
| [[Collection]] <[[String]]>
| Liefert die Liste aller Namen des JSON-Objektes.
| 2.9
|-
| <code>entrySet()</code>
| [[Collection]] <[[MapEntry]]>
| Liefert die Liste aller Namen/Werte Paare des JSON-Objektes.
| 2.9
|-
| <code>getValues()</code>
| [[Collection]]
| Liefert die Liste aller Werte des JSON-Objektes.
| 2.9
|-
| <code>toString()</code>
| [[String]]
| Erzeugt aus den Daten des JSONObject einen String, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toString([[Number]] indentFactor)</code>
| [[String]]
| Erzeugt aus den Daten des JSONObject einen String, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toString([[Number]] indentFactor, [[Number]] indent)</code>
| [[String]]
| Erzeugt aus den Daten des JSONObject einen String, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toString([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
| [[String]]
| Erzeugt aus den Daten des JSONObject einen String, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray()</code>
| [[String]]
| Erzeugt aus den Daten des JSONObject einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor)</code>
| [[String]]
| Erzeugt aus den Daten des JSONObject einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor, [[Number]] indent)</code>
| [[String]]
| Erzeugt aus den Daten des JSONObject einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|-
| <code>toPhpArray([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
| [[String]]
| Erzeugt aus den Daten des JSONObject einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
| 2.9
|}

==Methoden==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Methode || Rückgabewert || Beschreibung || ab IES Version
|-
| <code>locale([[String]] locale)</code>
| Object
| Liefert bei einem Mehrsprachigem Feld den Text mit der angegebenen Sprache
| 2.13
|-
| <code>locale([[String]] locale, [[Boolean]] lookup)</code>
| Object
| Liefert bei einem Mehrsprachigem Feld den Text mit der angegebenen Sprache
| 2.13
|}

;<code>Object get([[String]] name)</code>
:Liefert Wert der unter <code>name</code> abgelegt ist.
:;Rückgabewert
::;Object
:::Wert der unter <code>name</code> abgelegt ist.
;<code>[[Number]] length()</code>
:Liefert die Anzahl der Element in dem Array.
:;Rückgabewert
::;Number
:::Anzahl der Element in dem Array.
;<code>[[Collection]] <[[String]]> getNames()</code>
:Liefert die Liste aller Namen des JSON-Objektes.
:;Rückgabewert
::;Collection <String>
:::Liste aller Namen des JSON-Objektes.
;<code>[[Collection]] <[[MapEntry]]> entrySet()</code>
:Liefert die Liste aller Namen/Werte Paare des JSON-Objektes.
:;Rückgabewert
::;Collection <MapEntry>
:::Liste aller Namen/Werte Paare des JSON-Objektes.
;<code>[[Collection]] getValues()</code>
:Liefert die Liste aller Werte des JSON-Objektes.
:;Rückgabewert
::;Collection
:::Liste aller Werte des JSON-Objektes.
;<code>[[String]] toString([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
:Erzeugt aus den Daten des JSONObject einen String, der mit sp:print ausgegeben werden kann.
:;Parameter
::;<code>[[Number]] indentFactor</code>
:::Anzahl der Einrückungen pro Ebene. Optional (Default-Wert: 0).
::;<code>[[Number]] indent</code>
:::Initiale Anzahl der Einrückungs-Zeichen. Optional (Default-Wert: 0).
::;<code>[[String]] indentChar</code>
:::Zeichen, das als Einrückungszeichen verwendet werden soll. Optional (Default-Wert: ' ').
:;Rückgabewert
::;String
:::JSON als String.
;<code>[[String]] toPhpArray([[Number]] indentFactor, [[Number]] indent, [[String]] indentChar)</code>
:Erzeugt aus den Daten des JSONObject einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.
:;Parameter
::;<code>[[Number]] indentFactor</code>
:::Anzahl der Einrückungen pro Ebene. Optional (Default-Wert: 0).
::;<code>[[Number]] indent</code>
:::Initiale Anzahl der Einrückungs-Zeichen. Optional (Default-Wert: 0).
::;<code>[[String]] indentChar</code>
:::Zeichen, das als Einrückungszeichen verwendet werden soll. Optional (Default-Wert: ' ').
:;Rückgabewert
::;String
:::PHPArray als String.
;<code>[[Object]] locale([[String]] locale, [[Boolean]] lookup)</code>
:Liefert bei einer mehrsprachigen JSON-Struktur die Daten der entsprechenden Sprache. Mehrsprachige JSON-Strukturen sind so definiert, das die Keys das Locale definieren
<source lang="javascript">{
myMultilingualData: {
"de" : {
...
},
"en" : {
...
}
}
}</source> Es wird ein Lookup angewendet (wenn nicht deaktiviert). der zunächst nach z.B. 'de_DE' sucht, wenn für das Locale kein Wert definiert ist, dann wird nach 'de' gesucht, wenn dann auch noch nichts gefunden wird, dann wir nach 'default' gesucht. Beispiel:
<source lang="xml">
<sp:print name="myMultilingualData.locale('de_DE')"/>
</source>
:;Parameter
::;<code>String locale</code>
:::Locale das verwendet werden soll.
::;<code>Boolean lookup</code> (optional, default ist true)
:::Gibt an ob ein Lookup für das Locale angewendet werden soll.
:;Rückgabewert
::;Object
:::Wert der angegebenen Sprache oder null.

<noinclude>
[[Category:Objekte]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

Tinymce (SPT-Tag)

2016-04-18T13:03:36Z

Schleuse: /* Attribute */

==Name==
<spt:tinymce> - Integriert einen Editor

==Syntax==
<source lang="xml">
<spt:tinymce name="variable" theme="simple"/>
</source>

==Beschreibung==
Mit dem tinymce-Tag wird ein externer WYSIWYG-Editor ins CMS eingebunden. "<b>W</b>hat <b>Y</b>ou <b>S</b>ee <b>I</b>s <b>W</b>hat <b>Y</b>ou <b>G</b>et" steht für eine Übernahme eines geschriebenen Textes auf der Website, so wie ihn der Redakteur bei der Eingabe sieht. Auf diese Weise kann der Redakteur z.B. Tabellen oder Formatierungen in seine Artikel einbinden ohne über HTML-Kenntnisse zu verfügen. Die Ausgabe hängt aber nicht nur vom Editor, sondern auch von den Einstellungen des Browsers und den installierten Systemschriften ab.

Der Editor TinyMCE ist ein Open-Source Produkt der Firma [http://tinymce.moxiecode.com Moxiecode] und kann im Rahmen des CMS "so wie er ist" genutzt werden. TinyMCE ist kein Produkt der Sitepark GmbH und wird daher nicht von unserem Support betreut. Fehler-Meldungen und Erweiterungswünsche werden von Sitepark an den Hersteller weitergeleitet.

==Themes==
Über die Theme-Option lässt sich aus aktuell 2 vordefinierten Konfiguration wählen:

*simple
[[Datei:tiny-theme-simple.png]]
*advanced
[[Datei:tiny-theme-advanced.png]]

==Konfigurationserweiterung==
Sollten die vordefinieren Themes den Anforderungen nicht entsprechen lässt sich der <code><spt:tinymce /></code> über unterschiedliche Mechanismen erweitern/überschreiben.

; Konfiguration mandantenweit ergänzen''(nicht empfohlen)''
: Hier wird die Standard-Konfiguration durch eine eigene ergänzt. Alle <code><spt:tinymce></code>-Tags die nicht das Attribut <code>config</code> verwenden, sind von dieser Anpassung betroffen. Die Anpassungen werden in einem Template mit dem Anker <code>tag.spt.tinymce.configextension</code> vorgenommen

; Konfiguration per Konfigurationserweiterungen überschreiben ''(nicht empfohlen)''
: Hier wird die Standard-Konfiguration durch eine eigene vordefinierte Konfiguration vollständig ersetzt. Die Konfigurationen werden in einem Template mit dem Anker <code>tag.spt.tinymce.config.${configname}</code> implementiert, wobei <code>${configname}</code> einen Platzhalter für den Namen der Konfiguration bildet. Der Name wird dem <code><spt:tinymce/></code>-Tag über das Attribut <code>config</code> übergeben.

; Konfiguration per Konfigurationserweiterungen erweitern
: Hier wird die Standard-Konfiguration durch eine eigene vordefinierte Konfiguration ergänzt. Die Ergänzungen werden in einem Template mit dem Anker <code>tag.spt.tinymce.configextension.${configextensionname}</code> implementiert, wobei <code>${configextensionname}</code> einen Platzhalter für den Namen der Konfigurationserweiterung bildet. Der Name wird dem <code><spt:tinymce/></code>-Tag über das Attribut <code>configextension</code> übergeben.

; Zusätzliche Konfiguration als Tag-Attribut
: Hier wird eine Konfigurationserweiterung über das Attribute <code>configvalues</code> inline an das <code><spt:tinymce/></code> übergeben.

==Konfigurationsoptionen==
Die Konfiguration des TinyMCE besteht aus verschiedenen Konfigurations-Parametern, die mit [http://de.wikipedia.org/wiki/JavaScript_Object_Notation JSON] ohne umschließende geschweifte Klammern {} angegeben werden müssen.

Beispiel für TinyMCE-Konfiguration
<source lang="javascript">
toolbar: [
"pastetext | undo redo | bold italic | subscript superscript | indent outdent | bullist numlist | iesLink | charmap | abbr | table | removeformat"
],
statusbar: false,
object_resizing: false,
menu : {
file : {title : 'File' , items : 'newdocument'},
edit : {title : 'Edit' , items : 'undo redo | cut copy paste pastetext | selectall'},
insert : {title : 'Insert', items : 'link media | template hr'},
view : {title : 'View' , items : 'visualaid'},
format : {title : 'Format', items : 'bold italic underline strikethrough superscript subscript | formats | removeformat'},
table : {title : 'Table' , items : 'inserttable tableprops deletetable | cell row column'},
tools : {title : 'Tools' , items : 'spellchecker code'}
}
</source>

<div class="note">
Es ist zu beachten, das hinter dem letzten Parameter kein Komma stehen darf.
</div>

Alle für den TinyMCE verfügbaren Parameter können unter [http://www.tinymce.com/wiki.php/configuration http://www.tinymce.com] eingesehen werden.

<div class="note">
Folgende Plugins werden standardmäßig geladen, wobei zu beachten ist, dass das <code>iesLink</code>-Plugin die Aufgabe des <code>link</code>-Plugins übernimmt.
<source lang="javascript">
fullscreen, charmap, paste, table, contextmenu, abbr, iesLink, lang
</source>
</div>

==Konfigurationserweiterung Ablauf==

Die Konfigurationsauswertung findet wie folgt statt:

<blockquote>
Das aktive Configset wird auf das Theme gesetzt.<br/>
Wenn eine Konfiguration angegeben wurde wird das bisher gesetzte Configset mit dem eingebunden Configset überschrieben <code>(tag.spt.tinymce.config.${config})</code><br/><br/>

Wenn eine Konfigurationserweiterung angegeben wurde, wird das bisher gesetzte Configset durch das angegebene erweitert <code>(tag.spt.tinymce.configextension.${configextension})</code>.<br/>
Wenn keine Konfigurationserweiterung angegeben wurde, wird das bisher gesetzte Configset durch die Mandanten-Erweiterung erweitert <code>(tag.spt.tinymce.configextension)</code>.<br/><br/>

Wenn Configvalues angegeben wurden wird das bisher gesetzte Configset durch die übergebenen Optionen erweitert.
</blockquote>

===Standard Konfiguration pro Mandant ersetzen===
<div class="note">''Zu Beachten ist das ein überschreiben der globalen TinyMCE-Konfiguration (innerhalb des Mandanten) alle voreingestellten Setzungen wie die Einbindung eines angepassten CSS, die Auflistung aller zu verwendenden HTML-Elemente, etc. nicht mehr verwendet werden. Es sollte geprüft werden, ob es ausreicht die Standardkonfiguration zu ergänzen (siehe untern)''</div>

Es ist möglich die Standard-Konfiguration für den TinyMCE pro Mandant durch eine eigene Konfiguration zu ersetzen. Hierzu muß ein Template mit dem Anchor
tag.spt.tinymce.config
angelegt werden, in dem die Konfiguration hinterlegt ist. Existiert ein Template mit dem angegebenen Anchor, wird automatisch diese Konfiguration verwendet ohne das im <code><spt:tinymce></code>-Tag noch Änderungen vorgenommen werden müssten.

===Zusätzliche Konfigurationen pro Mandant definieren===
<div class="note">''Zu Beachten ist das bei der Verwendung einer eigenen Konfiguration alle voreingestellten Standard-Setzungen wie die Einbindung eines angepassten CSS, die Auflistung aller zu verwendenden HTML-Elemente, etc. nicht mehr verwendet werden. Es sollte geprüft werden, ob es ausreicht die Standardkonfiguration zu ergänzen (siehe untern)''</div>

Parallel zu der Standard-Konfiguration können weiter Konfigurationen pro Mandante definiert werden. Hierzu können Templates mit dem Anchor
tag.spt.tinymce.config.<configname>
angelegt werden, wobei mit <code><configname></code> ein beliegeber Name (Anchorkonform) vergeben werden kann. Um die Konfiguration zu verwenden muß im <code><spt:tinymce></code>-Tag mit dem Attribut <code>config</code> der <code><configname></code> der Konfiguration angegeben werden, die verwendet werden soll.

===Standard Konfigurations-Ergänzungen pro Mandant definieren===
Es ist möglich die Standard-Konfiguration für den TinyMCE pro Mandant mit eine eigene Konfiguration zu ergänzen. Hierzu muß ein Template mit dem Anchor
tag.spt.tinymce.configextension
angelegt werden, in dem die Konfiguration hinterlegt ist. Existiert ein Template mit dem angegebenen Anchor, wird automatisch diese Konfiguration verwendet ohne das im <code><spt:tinymce></code>-Tag noch Änderungen vorgenommen werden müssten.

===Zusätzliche Konfigurations-Ergänzungen pro Mandant definieren===

Parallel zu den Standard-Konfigurations-Ergänzungen können weiter Ergänzungen pro Mandante definiert werden. Hierzu können Templates mit dem Anchor
tag.spt.tinymce.configextension.<configextensionname>
angelegt werden, wobei mit <code><configextensionname></code> ein beliegeber Name (Anchorkonform) vergeben werden kann. Um die Konfiguration zu verwenden muß im <code><spt:tinymce></code>-Tag mit dem Attribut <code>configextension</code> der <code><configextensionname></code> der Konfiguration angegeben werden, die verwendet werden soll.

===Konfiguration in Tag-Attribut===
Mit dem Attribut <code>configvalues</code> können Konfigurationsparameter direkt angegeben werden. Diese Parameter werden mit JSON ohne umschließende geschweifte Klammern {} angegeben.
<source lang="xml">
<sp:set name="_tinyconfig">
param1 : "a",
param2 : false
</sp:set>
<spt:tinymce ... configvalues="${_tinyconfig}" ... />
</source>

==Mit dem <code>spt:tinymce</code> erzeugte Texte ausgeben (ab Version 2.0.3)==
Durch TinyMCE-Plugins des IES ist eine Nachbearbeitung des erzeugten Textes notwendig. Der Text sollte vor der Ausgabe den Tag [[spt:prehtml]] durchlaufen. Nur so ist sichergestellt, dass z.B. interne Links, die über den Editor eingetragen wurden, auch richtig ausgegeben werden.

Beispiel
<source lang="xml">
<sp:io type="in">
<spt:tinymce name="sp_body"/>
</sp:io>

<sp:io type="out">
<spt:prehtml name="processed_body" object="sp_body"/><sp:print name="processed_body"/>
</sp:io>
</source>

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
{{sp_input_attributes|attribute=name|mode=row}}
|-
{{sp_input_attributes|attribute=value|mode=row}}
|-
{{sp_input_attributes|attribute=fixvalue|mode=row}}
|-
{{sp_input_attributes|attribute=type|mode=row}}
|-
{{sp_input_attributes|attribute=disabled|mode=row}}
|-
{{sp_input_attributes|attribute=readonly|mode=row}}
|-
| <code>rows</code>
| [[Number]]
| Nein
| 15
| 1
|-
| <code>cols</code>
| [[Number]]
| Nein
| 80
| 1
|-
| <code>theme</code>
| [[Text]]
| Nein
| advanced
| 1
|-
| <code>pools</code>
| [[Anchor]]-List oder [[ID]]-List
| Nein
| aktueller Informationspool
| 1
|-
| <code>config</code>
| [[Text]]
| Nein
|
| 2.0.3
|-
| <code>configextension</code>
| [[Text]]
| Nein
|
| 2.0.3
|-
| <code>configvalues</code>
| [[Text]]
| Nein
|
| 2.0.3
|-
| <code>toggle</code>
| [[Condition]] Oder [[Text]]
| Nein
| true
| 2.26
|-
{{sp_input_attributes|attribute=dynamics|mode=row}}
|}
{{sp_input_attributes|attribute=name|mode=desc}}
{{sp_input_attributes|attribute=value|mode=desc}}
{{sp_input_attributes|attribute=fixvalue|mode=desc}}
{{sp_input_attributes|attribute=locale|mode=desc}}
{{sp_input_attributes|attribute=type|mode=desc}}
{{sp_input_attributes|attribute=disabled|mode=desc}}
{{sp_input_attributes|attribute=readonly|mode=desc}}
;<code>rows</code>
:Höhe des Eingabefeldes in Zeilen.

;<code>cols</code>
:Breite des Eingabefeldes in Spalten.

;<code>theme</code>
:Konfigurationstypen, die den Funktionsumfang für den Editor beschreiben. Mögliche Themes sind:
:;simple
:;advanced

;<code>pools</code>
:Kommaseparierte Liste von [[Anchor|Anchors]] von Artikelpools oder von [[ID|IDs]] von Artikelpools; die Elemente der Pools werden dem Redakteur in einem Linkdialog innerhalb des Editors zur Auswahl angeboten. Voraussetzung, dass der interne Linkdialog überhaupt angezeigt wird, ist die Konfiguration des Editors mit iesLink über theme_advanced_buttons in der [http://wiki.moxiecode.com/index.php/TinyMCE:Configuration TinyMCE:Configuration]. Ausgabeseitig muss man darauf achten, dass ein interner Link vor der Ausgabe mit [[spt:id2url]] umgewandelt wird.

;<code>config</code>
:Mit diesem Attribut wird der Name einer Konfiguration angegeben. Die in dieser Konfiguration angegebenen Konfigurationsparameter überschreiben die IES-Standardkonfiguration. Die Angaben werden in JSON angegeben, wobei die umschließenden geschweiften Klammern {} nicht mit angegeben werden dürfen. Die möglichen Konfigurationsparameter sind unter [http://wiki.moxiecode.com/index.php/TinyMCE:Configuration TinyMCE:Configuration] aufgelistet.

;<code>configextension</code>
:Mit diesem Attribut wird der Name einer Konfigurations-Ergänzung angegeben. Die in dieser Ergänzung angegebenen Konfigurationsparameter ergänzen und überschreiben die Parameter der IES-Standardkonfiguration. Die Angaben werden in JSON angegeben, wobei die umschließenden geschweiften Klammern {} nicht mit angegeben werden dürfen. Die möglichen Konfigurationsparameter sind unter [http://wiki.moxiecode.com/index.php/TinyMCE:Configuration TinyMCE:Configuration] aufgelistet.

;<code>configvalues</code>
:Mit diesem Attribut können TinyMCE Konfigurationen angegeben werden. Die Konfigurationsparameter ergänzen und überschreiben die Parameter der IES-Standardkonfiguration. Die Angaben werden in JSON angegeben, wobei die umschließenden geschweiften Klammern {} nicht mit angegeben werden dürfen. Die möglichen Konfigurationsparameter sind unter [http://wiki.moxiecode.com/index.php/TinyMCE:Configuration TinyMCE:Configuration] aufgelistet.
{{sp_input_attributes|attribute=dynamics|mode=desc}}

;<code>toggle</code>
:Mit diesem Attribut lässt sich angeben, wie der TinyMce eingeschaltet werden soll. True für einen Toggle Button, False für keinen Toggle-Button, auto für automatisches togglen

==Beispiele==

===WYSIWYG-Editor nutzen und Inhalt ausgeben===

Template Quelltext
<source lang="xml">
<sp:io type="in">
<spt:tinymce name="sp_body"/>
</sp:io>

<sp:io type="out">
<spt:prehtml name="processed_body" object="sp_body"/><sp:print name="processed_body"/>
</sp:io>
</source>

=== Barrierefreie Datentabellen ===
<p>In der Tabellendarstellung haben wir Sehende es einfacher komplexe Strukturen zu erkennen.<br /> Wir können in der Spalte kurz nach oben schauen, um uns zu vergewissern zu welcher Kopfinformation der Zelleninhalt gehört. Für Screenreader ist hier unbedingt eine eindeutige Zuordnung nötig.</p>
<p>Die Web Content Accessibility Guidelines fordert in den Guidelines 2.0 von einer HTML Tabelle</p>
<ol>
<li>Ein Caption-Element welches eine kurze Überschrift der Tabelle bereitstellt [http://www.w3.org/TR/WCAG20-TECHS/H39 (H39)] [http://www.w3.org/TR/WCAG20/#content-structure-separation-programmatic (Level A)]</li>
<li>Eine Trennung des Überschrifts- und Inhaltsbereichs der Tabelle mit dem thead-, und tbody-Element [http://www.w3.org/TR/WCAG20-TECHS/H51 (H51)] [http://www.w3.org/TR/WCAG20/#content-structure-separation-programmatic (Level A)]</li>
<li>In dem Überschriftsbereich sollen die th-Elemente mit dem Attribut scope=“col“ eine Verknüpfung zu einer Spalte haben [http://www.w3.org/TR/WCAG20-TECHS/H63 (H63)] [http://www.w3.org/TR/WCAG20/#content-structure-separation-programmatic (Level A)]. Wenn Datenzellen mehr als einer Zeilen- und/oder Spaltenüberschrift zugeordnet sind werden die Zellen mit ID- und header-Attribut miteinander verknüpft [http://www.w3.org/TR/WCAG20-TECHS/H43 (H43)] [http://www.w3.org/TR/WCAG20/#content-structure-separation-programmatic (Level A)]</li>
<li>Falls vorgesehen sollten td-Elemente mit dem Attribut scope=“row“ Zeilenheaderzellen definieren [http://www.w3.org/TR/WCAG20-TECHS/H63 (H63)] [http://www.w3.org/TR/WCAG20-TECHS/H43 (H43)] [http://www.w3.org/TR/WCAG20/#content-structure-separation-programmatic (Level A)]</li>
</ol>
<br>
=====Wie erstelle ich eine Tabelle=====
<p>
<ol>
<li>
<div class="notice">Öffnen Sie die Tabellenkonfiguration über den Schalter in der Toolbar und wählen Sie aus wie viele Spalten/Zeilen Sie benötigen.</div><br/>
[[Datei:tiny-table-tutorial-step-1.png|alt=Barrierefreie Tabellen erstellen Schritt 1|Barrierefreie Tabellen erstellen Schritt 1]]<br/><br/>
</li>

<li>
<div class="notice">Öffnen Sie die Tabelleneigenschaften.</div><br/>
[[Datei:tiny-table-tutorial-step-2.png|alt=Barrierefreie Tabellen erstellen Schritt 2|Barrierefreie Tabellen erstellen Schritt 2]]<br/><br/>
</li>

<li>
<div class="notice">Hier kann die Option zur Eingabe einer Caption aktiviert werden.</div><br/>
[[Datei:tiny-table-tutorial-step-3.png|alt=Barrierefreie Tabellen erstellen Schritt 3|Barrierefreie Tabellen erstellen Schritt 3]]<br/><br/>
</li>

<li>
<div class="notice">Nun erscheint oberhalb der Tabelle ein neues Feld zur Eingabe der Caption</div><br/>
[[Datei:tiny-table-tutorial-step-4.png|alt=Barrierefreie Tabellen erstellen Schritt 4|Barrierefreie Tabellen erstellen Schritt 4]]<br/><br/>
</li>

<li>
<div class="notice">Füllen Sie die weiter Tabelle mit Inhalten</div><br/>
[[Datei:tiny-table-tutorial-step-5.png|alt=Barrierefreie Tabellen erstellen Schritt 5|Barrierefreie Tabellen erstellen Schritt 5]]<br/><br/>
</li>

<li>
<div class="notice">Um die obere Zeile als Spaltenbeschreibung zu deklarieren, markieren Sie die Zeile und öffnen die Zelleneigenschaften</div><br/>
[[Datei:tiny-table-tutorial-step-6.png|alt=Barrierefreie Tabellen erstellen Schritt 6|Barrierefreie Tabellen erstellen Schritt 6]]<br/><br/>
</li>

<li>
<div class="notice">Ändern Sie den Zellentyp auf Kopfzeile</div><br/>
[[Datei:tiny-table-tutorial-step-7.png|alt=Barrierefreie Tabellen erstellen Schritt 7|Barrierefreie Tabellen erstellen Schritt 7]]<br/><br/>
</li>

<li>
<div class="notice">Um anzugeben, dass es sich bei den markierten Feldern um Spaltenüberschriften handelt, müssen Sie den Gültigkeitsbereich auf Spalte ändern</div><br/>
[[Datei:tiny-table-tutorial-step-8.png|alt=Barrierefreie Tabellen erstellen Schritt 8|Barrierefreie Tabellen erstellen Schritt 8]]<br/><br/>
</li>

<li>
<div class="notice">Gehen Sie bei Zeilenüberschriften genauso vor</div><br/>
[[Datei:tiny-table-tutorial-step-9.png|alt=Barrierefreie Tabellen erstellen Schritt 9|Barrierefreie Tabellen erstellen Schritt 9]]
[[Datei:tiny-table-tutorial-step-10.png|alt=Barrierefreie Tabellen erstellen Schritt 10|Barrierefreie Tabellen erstellen Schritt 10]]<br/><br/>
</li>

<li>
<div class="notice">An stelle von "Spalte" geben wir hier als Gültigkeitsbereich "Zeile" an, da es sich um zeilenweise Überschriften handelt</div><br/>
[[Datei:tiny-table-tutorial-step-11.png|alt=Barrierefreie Tabellen erstellen Schritt 11|Barrierefreie Tabellen erstellen Schritt 11]]<br/><br/>
</li>

<li>
<div class="notice">Die fertige Ausgabe auf der Website kann dann z.B. so aussehen:</div><br/>
[[Datei:tiny-table-tutorial-step-12.png|alt=Barrierefreie Tabellen erstellen Schritt 12|Barrierefreie Tabellen erstellen Schritt 12]]
<br/><br/>
</li>
</ol>
</p>

===== Was schreibt der TinyMCE nun auf die Webseite? =====
<p>So sieht der HTML Code mit unseren Zusatzinformationen und Änderungen aus:<br />
<source lang="xml">
<table>
<caption>Gruppe G</caption>
<tbody>
<tr>
<th scope="col">Land</th>
<th scope="col">Punkte</th>
<th scope="col">Tore</th>
<th scope="col">Tordifferenz</th>
<th scope="col">Siege</th>
</tr>
<tr>
<th scope="row">Deutschland</th>
<td>3</td>
<td>4</td>
<td>4</td>
<td>1</td>
</tr>
<tr>
<th scope="row">USA</th>
<td>3</td>
<td>2</td>
<td>1</td>
<td>1</td>
</tr>
<tr>
<th scope="row">Ghana</th>
<td>0</td>
<td>1</td>
<td>-1</td>
<td>0</td>
</tr>
<tr>
<th scope="row">Portugal</th>
<td>0</td>
<td>0</td>
<td>-4</td>
<td>0</td>
</tr>
</tbody>
</table>
</source>
</p>

<noinclude>
[[Category:SPT-Tags]]
</noinclude>

Tinymce (SPT-Tag)

2016-04-18T13:02:45Z

Schleuse: /* Attribute */

==Name==
<spt:tinymce> - Integriert einen Editor

==Syntax==
<source lang="xml">
<spt:tinymce name="variable" theme="simple"/>
</source>

==Beschreibung==
Mit dem tinymce-Tag wird ein externer WYSIWYG-Editor ins CMS eingebunden. "<b>W</b>hat <b>Y</b>ou <b>S</b>ee <b>I</b>s <b>W</b>hat <b>Y</b>ou <b>G</b>et" steht für eine Übernahme eines geschriebenen Textes auf der Website, so wie ihn der Redakteur bei der Eingabe sieht. Auf diese Weise kann der Redakteur z.B. Tabellen oder Formatierungen in seine Artikel einbinden ohne über HTML-Kenntnisse zu verfügen. Die Ausgabe hängt aber nicht nur vom Editor, sondern auch von den Einstellungen des Browsers und den installierten Systemschriften ab.

Der Editor TinyMCE ist ein Open-Source Produkt der Firma [http://tinymce.moxiecode.com Moxiecode] und kann im Rahmen des CMS "so wie er ist" genutzt werden. TinyMCE ist kein Produkt der Sitepark GmbH und wird daher nicht von unserem Support betreut. Fehler-Meldungen und Erweiterungswünsche werden von Sitepark an den Hersteller weitergeleitet.

==Themes==
Über die Theme-Option lässt sich aus aktuell 2 vordefinierten Konfiguration wählen:

*simple
[[Datei:tiny-theme-simple.png]]
*advanced
[[Datei:tiny-theme-advanced.png]]

==Konfigurationserweiterung==
Sollten die vordefinieren Themes den Anforderungen nicht entsprechen lässt sich der <code><spt:tinymce /></code> über unterschiedliche Mechanismen erweitern/überschreiben.

; Konfiguration mandantenweit ergänzen''(nicht empfohlen)''
: Hier wird die Standard-Konfiguration durch eine eigene ergänzt. Alle <code><spt:tinymce></code>-Tags die nicht das Attribut <code>config</code> verwenden, sind von dieser Anpassung betroffen. Die Anpassungen werden in einem Template mit dem Anker <code>tag.spt.tinymce.configextension</code> vorgenommen

; Konfiguration per Konfigurationserweiterungen überschreiben ''(nicht empfohlen)''
: Hier wird die Standard-Konfiguration durch eine eigene vordefinierte Konfiguration vollständig ersetzt. Die Konfigurationen werden in einem Template mit dem Anker <code>tag.spt.tinymce.config.${configname}</code> implementiert, wobei <code>${configname}</code> einen Platzhalter für den Namen der Konfiguration bildet. Der Name wird dem <code><spt:tinymce/></code>-Tag über das Attribut <code>config</code> übergeben.

; Konfiguration per Konfigurationserweiterungen erweitern
: Hier wird die Standard-Konfiguration durch eine eigene vordefinierte Konfiguration ergänzt. Die Ergänzungen werden in einem Template mit dem Anker <code>tag.spt.tinymce.configextension.${configextensionname}</code> implementiert, wobei <code>${configextensionname}</code> einen Platzhalter für den Namen der Konfigurationserweiterung bildet. Der Name wird dem <code><spt:tinymce/></code>-Tag über das Attribut <code>configextension</code> übergeben.

; Zusätzliche Konfiguration als Tag-Attribut
: Hier wird eine Konfigurationserweiterung über das Attribute <code>configvalues</code> inline an das <code><spt:tinymce/></code> übergeben.

==Konfigurationsoptionen==
Die Konfiguration des TinyMCE besteht aus verschiedenen Konfigurations-Parametern, die mit [http://de.wikipedia.org/wiki/JavaScript_Object_Notation JSON] ohne umschließende geschweifte Klammern {} angegeben werden müssen.

Beispiel für TinyMCE-Konfiguration
<source lang="javascript">
toolbar: [
"pastetext | undo redo | bold italic | subscript superscript | indent outdent | bullist numlist | iesLink | charmap | abbr | table | removeformat"
],
statusbar: false,
object_resizing: false,
menu : {
file : {title : 'File' , items : 'newdocument'},
edit : {title : 'Edit' , items : 'undo redo | cut copy paste pastetext | selectall'},
insert : {title : 'Insert', items : 'link media | template hr'},
view : {title : 'View' , items : 'visualaid'},
format : {title : 'Format', items : 'bold italic underline strikethrough superscript subscript | formats | removeformat'},
table : {title : 'Table' , items : 'inserttable tableprops deletetable | cell row column'},
tools : {title : 'Tools' , items : 'spellchecker code'}
}
</source>

<div class="note">
Es ist zu beachten, das hinter dem letzten Parameter kein Komma stehen darf.
</div>

Alle für den TinyMCE verfügbaren Parameter können unter [http://www.tinymce.com/wiki.php/configuration http://www.tinymce.com] eingesehen werden.

<div class="note">
Folgende Plugins werden standardmäßig geladen, wobei zu beachten ist, dass das <code>iesLink</code>-Plugin die Aufgabe des <code>link</code>-Plugins übernimmt.
<source lang="javascript">
fullscreen, charmap, paste, table, contextmenu, abbr, iesLink, lang
</source>
</div>

==Konfigurationserweiterung Ablauf==

Die Konfigurationsauswertung findet wie folgt statt:

<blockquote>
Das aktive Configset wird auf das Theme gesetzt.<br/>
Wenn eine Konfiguration angegeben wurde wird das bisher gesetzte Configset mit dem eingebunden Configset überschrieben <code>(tag.spt.tinymce.config.${config})</code><br/><br/>

Wenn eine Konfigurationserweiterung angegeben wurde, wird das bisher gesetzte Configset durch das angegebene erweitert <code>(tag.spt.tinymce.configextension.${configextension})</code>.<br/>
Wenn keine Konfigurationserweiterung angegeben wurde, wird das bisher gesetzte Configset durch die Mandanten-Erweiterung erweitert <code>(tag.spt.tinymce.configextension)</code>.<br/><br/>

Wenn Configvalues angegeben wurden wird das bisher gesetzte Configset durch die übergebenen Optionen erweitert.
</blockquote>

===Standard Konfiguration pro Mandant ersetzen===
<div class="note">''Zu Beachten ist das ein überschreiben der globalen TinyMCE-Konfiguration (innerhalb des Mandanten) alle voreingestellten Setzungen wie die Einbindung eines angepassten CSS, die Auflistung aller zu verwendenden HTML-Elemente, etc. nicht mehr verwendet werden. Es sollte geprüft werden, ob es ausreicht die Standardkonfiguration zu ergänzen (siehe untern)''</div>

Es ist möglich die Standard-Konfiguration für den TinyMCE pro Mandant durch eine eigene Konfiguration zu ersetzen. Hierzu muß ein Template mit dem Anchor
tag.spt.tinymce.config
angelegt werden, in dem die Konfiguration hinterlegt ist. Existiert ein Template mit dem angegebenen Anchor, wird automatisch diese Konfiguration verwendet ohne das im <code><spt:tinymce></code>-Tag noch Änderungen vorgenommen werden müssten.

===Zusätzliche Konfigurationen pro Mandant definieren===
<div class="note">''Zu Beachten ist das bei der Verwendung einer eigenen Konfiguration alle voreingestellten Standard-Setzungen wie die Einbindung eines angepassten CSS, die Auflistung aller zu verwendenden HTML-Elemente, etc. nicht mehr verwendet werden. Es sollte geprüft werden, ob es ausreicht die Standardkonfiguration zu ergänzen (siehe untern)''</div>

Parallel zu der Standard-Konfiguration können weiter Konfigurationen pro Mandante definiert werden. Hierzu können Templates mit dem Anchor
tag.spt.tinymce.config.<configname>
angelegt werden, wobei mit <code><configname></code> ein beliegeber Name (Anchorkonform) vergeben werden kann. Um die Konfiguration zu verwenden muß im <code><spt:tinymce></code>-Tag mit dem Attribut <code>config</code> der <code><configname></code> der Konfiguration angegeben werden, die verwendet werden soll.

===Standard Konfigurations-Ergänzungen pro Mandant definieren===
Es ist möglich die Standard-Konfiguration für den TinyMCE pro Mandant mit eine eigene Konfiguration zu ergänzen. Hierzu muß ein Template mit dem Anchor
tag.spt.tinymce.configextension
angelegt werden, in dem die Konfiguration hinterlegt ist. Existiert ein Template mit dem angegebenen Anchor, wird automatisch diese Konfiguration verwendet ohne das im <code><spt:tinymce></code>-Tag noch Änderungen vorgenommen werden müssten.

===Zusätzliche Konfigurations-Ergänzungen pro Mandant definieren===

Parallel zu den Standard-Konfigurations-Ergänzungen können weiter Ergänzungen pro Mandante definiert werden. Hierzu können Templates mit dem Anchor
tag.spt.tinymce.configextension.<configextensionname>
angelegt werden, wobei mit <code><configextensionname></code> ein beliegeber Name (Anchorkonform) vergeben werden kann. Um die Konfiguration zu verwenden muß im <code><spt:tinymce></code>-Tag mit dem Attribut <code>configextension</code> der <code><configextensionname></code> der Konfiguration angegeben werden, die verwendet werden soll.

===Konfiguration in Tag-Attribut===
Mit dem Attribut <code>configvalues</code> können Konfigurationsparameter direkt angegeben werden. Diese Parameter werden mit JSON ohne umschließende geschweifte Klammern {} angegeben.
<source lang="xml">
<sp:set name="_tinyconfig">
param1 : "a",
param2 : false
</sp:set>
<spt:tinymce ... configvalues="${_tinyconfig}" ... />
</source>

==Mit dem <code>spt:tinymce</code> erzeugte Texte ausgeben (ab Version 2.0.3)==
Durch TinyMCE-Plugins des IES ist eine Nachbearbeitung des erzeugten Textes notwendig. Der Text sollte vor der Ausgabe den Tag [[spt:prehtml]] durchlaufen. Nur so ist sichergestellt, dass z.B. interne Links, die über den Editor eingetragen wurden, auch richtig ausgegeben werden.

Beispiel
<source lang="xml">
<sp:io type="in">
<spt:tinymce name="sp_body"/>
</sp:io>

<sp:io type="out">
<spt:prehtml name="processed_body" object="sp_body"/><sp:print name="processed_body"/>
</sp:io>
</source>

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
{{sp_input_attributes|attribute=name|mode=row}}
|-
{{sp_input_attributes|attribute=value|mode=row}}
|-
{{sp_input_attributes|attribute=fixvalue|mode=row}}
|-
{{sp_input_attributes|attribute=type|mode=row}}
|-
{{sp_input_attributes|attribute=disabled|mode=row}}
|-
{{sp_input_attributes|attribute=readonly|mode=row}}
|-
| <code>rows</code>
| [[Number]]
| Nein
| 15
| 1
|-
| <code>cols</code>
| [[Number]]
| Nein
| 80
| 1
|-
| <code>theme</code>
| [[Text]]
| Nein
| advanced
| 1
|-
| <code>pools</code>
| [[Anchor]]-List oder [[ID]]-List
| Nein
| aktueller Informationspool
| 1
|-
| <code>config</code>
| [[Text]]
| Nein
|
| 2.0.3
|-
| <code>configextension</code>
| [[Text]]
| Nein
|
| 2.0.3
|-
| <code>configvalues</code>
| [[Text]]
| Nein
|
| 2.0.3
|-
| <code>toggle</code>
| [[Condition]] Oder [[Text]]
| Nein
| true
| 2.26
|-
{{sp_input_attributes|attribute=dynamics|mode=row}}
|}
{{sp_input_attributes|attribute=name|mode=desc}}
{{sp_input_attributes|attribute=value|mode=desc}}
{{sp_input_attributes|attribute=fixvalue|mode=desc}}
{{sp_input_attributes|attribute=locale|mode=desc}}
{{sp_input_attributes|attribute=type|mode=desc}}
{{sp_input_attributes|attribute=disabled|mode=desc}}
{{sp_input_attributes|attribute=readonly|mode=desc}}
;<code>rows</code>
:Höhe des Eingabefeldes in Zeilen.

;<code>cols</code>
:Breite des Eingabefeldes in Spalten.

;<code>theme</code>
:Konfigurationstypen, die den Funktionsumfang für den Editor beschreiben. Mögliche Themes sind:
:;simple
:;advanced

;<code>pools</code>
:Kommaseparierte Liste von [[Anchor|Anchors]] von Artikelpools oder von [[ID|IDs]] von Artikelpools; die Elemente der Pools werden dem Redakteur in einem Linkdialog innerhalb des Editors zur Auswahl angeboten. Voraussetzung, dass der interne Linkdialog überhaupt angezeigt wird, ist die Konfiguration des Editors mit iesLink über theme_advanced_buttons in der [http://wiki.moxiecode.com/index.php/TinyMCE:Configuration TinyMCE:Configuration]. Ausgabeseitig muss man darauf achten, dass ein interner Link vor der Ausgabe mit [[spt:id2url]] umgewandelt wird.

;<code>config</code>
:Mit diesem Attribut wird der Name einer Konfiguration angegeben. Die in dieser Konfiguration angegebenen Konfigurationsparameter überschreiben die IES-Standardkonfiguration. Die Angaben werden in JSON angegeben, wobei die umschließenden geschweiften Klammern {} nicht mit angegeben werden dürfen. Die möglichen Konfigurationsparameter sind unter [http://wiki.moxiecode.com/index.php/TinyMCE:Configuration TinyMCE:Configuration] aufgelistet.

;<code>configextension</code>
:Mit diesem Attribut wird der Name einer Konfigurations-Ergänzung angegeben. Die in dieser Ergänzung angegebenen Konfigurationsparameter ergänzen und überschreiben die Parameter der IES-Standardkonfiguration. Die Angaben werden in JSON angegeben, wobei die umschließenden geschweiften Klammern {} nicht mit angegeben werden dürfen. Die möglichen Konfigurationsparameter sind unter [http://wiki.moxiecode.com/index.php/TinyMCE:Configuration TinyMCE:Configuration] aufgelistet.

;<code>configvalues</code>
:Mit diesem Attribut können TinyMCE Konfigurationen angegeben werden. Die Konfigurationsparameter ergänzen und überschreiben die Parameter der IES-Standardkonfiguration. Die Angaben werden in JSON angegeben, wobei die umschließenden geschweiften Klammern {} nicht mit angegeben werden dürfen. Die möglichen Konfigurationsparameter sind unter [http://wiki.moxiecode.com/index.php/TinyMCE:Configuration TinyMCE:Configuration] aufgelistet.
{{sp_input_attributes|attribute=dynamics|mode=desc}}

;<code>toggle</code>
:Mit diesem Attribut lässt sich angeben, wie der TinyMce eingeschaltet werden soll. True für einen Toggle Button, False für keinen Toggle-Button, auto für Automatisches togglen

==Beispiele==

===WYSIWYG-Editor nutzen und Inhalt ausgeben===

Template Quelltext
<source lang="xml">
<sp:io type="in">
<spt:tinymce name="sp_body"/>
</sp:io>

<sp:io type="out">
<spt:prehtml name="processed_body" object="sp_body"/><sp:print name="processed_body"/>
</sp:io>
</source>

=== Barrierefreie Datentabellen ===
<p>In der Tabellendarstellung haben wir Sehende es einfacher komplexe Strukturen zu erkennen.<br /> Wir können in der Spalte kurz nach oben schauen, um uns zu vergewissern zu welcher Kopfinformation der Zelleninhalt gehört. Für Screenreader ist hier unbedingt eine eindeutige Zuordnung nötig.</p>
<p>Die Web Content Accessibility Guidelines fordert in den Guidelines 2.0 von einer HTML Tabelle</p>
<ol>
<li>Ein Caption-Element welches eine kurze Überschrift der Tabelle bereitstellt [http://www.w3.org/TR/WCAG20-TECHS/H39 (H39)] [http://www.w3.org/TR/WCAG20/#content-structure-separation-programmatic (Level A)]</li>
<li>Eine Trennung des Überschrifts- und Inhaltsbereichs der Tabelle mit dem thead-, und tbody-Element [http://www.w3.org/TR/WCAG20-TECHS/H51 (H51)] [http://www.w3.org/TR/WCAG20/#content-structure-separation-programmatic (Level A)]</li>
<li>In dem Überschriftsbereich sollen die th-Elemente mit dem Attribut scope=“col“ eine Verknüpfung zu einer Spalte haben [http://www.w3.org/TR/WCAG20-TECHS/H63 (H63)] [http://www.w3.org/TR/WCAG20/#content-structure-separation-programmatic (Level A)]. Wenn Datenzellen mehr als einer Zeilen- und/oder Spaltenüberschrift zugeordnet sind werden die Zellen mit ID- und header-Attribut miteinander verknüpft [http://www.w3.org/TR/WCAG20-TECHS/H43 (H43)] [http://www.w3.org/TR/WCAG20/#content-structure-separation-programmatic (Level A)]</li>
<li>Falls vorgesehen sollten td-Elemente mit dem Attribut scope=“row“ Zeilenheaderzellen definieren [http://www.w3.org/TR/WCAG20-TECHS/H63 (H63)] [http://www.w3.org/TR/WCAG20-TECHS/H43 (H43)] [http://www.w3.org/TR/WCAG20/#content-structure-separation-programmatic (Level A)]</li>
</ol>
<br>
=====Wie erstelle ich eine Tabelle=====
<p>
<ol>
<li>
<div class="notice">Öffnen Sie die Tabellenkonfiguration über den Schalter in der Toolbar und wählen Sie aus wie viele Spalten/Zeilen Sie benötigen.</div><br/>
[[Datei:tiny-table-tutorial-step-1.png|alt=Barrierefreie Tabellen erstellen Schritt 1|Barrierefreie Tabellen erstellen Schritt 1]]<br/><br/>
</li>

<li>
<div class="notice">Öffnen Sie die Tabelleneigenschaften.</div><br/>
[[Datei:tiny-table-tutorial-step-2.png|alt=Barrierefreie Tabellen erstellen Schritt 2|Barrierefreie Tabellen erstellen Schritt 2]]<br/><br/>
</li>

<li>
<div class="notice">Hier kann die Option zur Eingabe einer Caption aktiviert werden.</div><br/>
[[Datei:tiny-table-tutorial-step-3.png|alt=Barrierefreie Tabellen erstellen Schritt 3|Barrierefreie Tabellen erstellen Schritt 3]]<br/><br/>
</li>

<li>
<div class="notice">Nun erscheint oberhalb der Tabelle ein neues Feld zur Eingabe der Caption</div><br/>
[[Datei:tiny-table-tutorial-step-4.png|alt=Barrierefreie Tabellen erstellen Schritt 4|Barrierefreie Tabellen erstellen Schritt 4]]<br/><br/>
</li>

<li>
<div class="notice">Füllen Sie die weiter Tabelle mit Inhalten</div><br/>
[[Datei:tiny-table-tutorial-step-5.png|alt=Barrierefreie Tabellen erstellen Schritt 5|Barrierefreie Tabellen erstellen Schritt 5]]<br/><br/>
</li>

<li>
<div class="notice">Um die obere Zeile als Spaltenbeschreibung zu deklarieren, markieren Sie die Zeile und öffnen die Zelleneigenschaften</div><br/>
[[Datei:tiny-table-tutorial-step-6.png|alt=Barrierefreie Tabellen erstellen Schritt 6|Barrierefreie Tabellen erstellen Schritt 6]]<br/><br/>
</li>

<li>
<div class="notice">Ändern Sie den Zellentyp auf Kopfzeile</div><br/>
[[Datei:tiny-table-tutorial-step-7.png|alt=Barrierefreie Tabellen erstellen Schritt 7|Barrierefreie Tabellen erstellen Schritt 7]]<br/><br/>
</li>

<li>
<div class="notice">Um anzugeben, dass es sich bei den markierten Feldern um Spaltenüberschriften handelt, müssen Sie den Gültigkeitsbereich auf Spalte ändern</div><br/>
[[Datei:tiny-table-tutorial-step-8.png|alt=Barrierefreie Tabellen erstellen Schritt 8|Barrierefreie Tabellen erstellen Schritt 8]]<br/><br/>
</li>

<li>
<div class="notice">Gehen Sie bei Zeilenüberschriften genauso vor</div><br/>
[[Datei:tiny-table-tutorial-step-9.png|alt=Barrierefreie Tabellen erstellen Schritt 9|Barrierefreie Tabellen erstellen Schritt 9]]
[[Datei:tiny-table-tutorial-step-10.png|alt=Barrierefreie Tabellen erstellen Schritt 10|Barrierefreie Tabellen erstellen Schritt 10]]<br/><br/>
</li>

<li>
<div class="notice">An stelle von "Spalte" geben wir hier als Gültigkeitsbereich "Zeile" an, da es sich um zeilenweise Überschriften handelt</div><br/>
[[Datei:tiny-table-tutorial-step-11.png|alt=Barrierefreie Tabellen erstellen Schritt 11|Barrierefreie Tabellen erstellen Schritt 11]]<br/><br/>
</li>

<li>
<div class="notice">Die fertige Ausgabe auf der Website kann dann z.B. so aussehen:</div><br/>
[[Datei:tiny-table-tutorial-step-12.png|alt=Barrierefreie Tabellen erstellen Schritt 12|Barrierefreie Tabellen erstellen Schritt 12]]
<br/><br/>
</li>
</ol>
</p>

===== Was schreibt der TinyMCE nun auf die Webseite? =====
<p>So sieht der HTML Code mit unseren Zusatzinformationen und Änderungen aus:<br />
<source lang="xml">
<table>
<caption>Gruppe G</caption>
<tbody>
<tr>
<th scope="col">Land</th>
<th scope="col">Punkte</th>
<th scope="col">Tore</th>
<th scope="col">Tordifferenz</th>
<th scope="col">Siege</th>
</tr>
<tr>
<th scope="row">Deutschland</th>
<td>3</td>
<td>4</td>
<td>4</td>
<td>1</td>
</tr>
<tr>
<th scope="row">USA</th>
<td>3</td>
<td>2</td>
<td>1</td>
<td>1</td>
</tr>
<tr>
<th scope="row">Ghana</th>
<td>0</td>
<td>1</td>
<td>-1</td>
<td>0</td>
</tr>
<tr>
<th scope="row">Portugal</th>
<td>0</td>
<td>0</td>
<td>-4</td>
<td>0</td>
</tr>
</tbody>
</table>
</source>
</p>

<noinclude>
[[Category:SPT-Tags]]
</noinclude>

Tinymce (SPT-Tag)

2016-04-18T13:02:27Z

Schleuse: /* Attribute */

==Name==
<spt:tinymce> - Integriert einen Editor

==Syntax==
<source lang="xml">
<spt:tinymce name="variable" theme="simple"/>
</source>

==Beschreibung==
Mit dem tinymce-Tag wird ein externer WYSIWYG-Editor ins CMS eingebunden. "<b>W</b>hat <b>Y</b>ou <b>S</b>ee <b>I</b>s <b>W</b>hat <b>Y</b>ou <b>G</b>et" steht für eine Übernahme eines geschriebenen Textes auf der Website, so wie ihn der Redakteur bei der Eingabe sieht. Auf diese Weise kann der Redakteur z.B. Tabellen oder Formatierungen in seine Artikel einbinden ohne über HTML-Kenntnisse zu verfügen. Die Ausgabe hängt aber nicht nur vom Editor, sondern auch von den Einstellungen des Browsers und den installierten Systemschriften ab.

Der Editor TinyMCE ist ein Open-Source Produkt der Firma [http://tinymce.moxiecode.com Moxiecode] und kann im Rahmen des CMS "so wie er ist" genutzt werden. TinyMCE ist kein Produkt der Sitepark GmbH und wird daher nicht von unserem Support betreut. Fehler-Meldungen und Erweiterungswünsche werden von Sitepark an den Hersteller weitergeleitet.

==Themes==
Über die Theme-Option lässt sich aus aktuell 2 vordefinierten Konfiguration wählen:

*simple
[[Datei:tiny-theme-simple.png]]
*advanced
[[Datei:tiny-theme-advanced.png]]

==Konfigurationserweiterung==
Sollten die vordefinieren Themes den Anforderungen nicht entsprechen lässt sich der <code><spt:tinymce /></code> über unterschiedliche Mechanismen erweitern/überschreiben.

; Konfiguration mandantenweit ergänzen''(nicht empfohlen)''
: Hier wird die Standard-Konfiguration durch eine eigene ergänzt. Alle <code><spt:tinymce></code>-Tags die nicht das Attribut <code>config</code> verwenden, sind von dieser Anpassung betroffen. Die Anpassungen werden in einem Template mit dem Anker <code>tag.spt.tinymce.configextension</code> vorgenommen

; Konfiguration per Konfigurationserweiterungen überschreiben ''(nicht empfohlen)''
: Hier wird die Standard-Konfiguration durch eine eigene vordefinierte Konfiguration vollständig ersetzt. Die Konfigurationen werden in einem Template mit dem Anker <code>tag.spt.tinymce.config.${configname}</code> implementiert, wobei <code>${configname}</code> einen Platzhalter für den Namen der Konfiguration bildet. Der Name wird dem <code><spt:tinymce/></code>-Tag über das Attribut <code>config</code> übergeben.

; Konfiguration per Konfigurationserweiterungen erweitern
: Hier wird die Standard-Konfiguration durch eine eigene vordefinierte Konfiguration ergänzt. Die Ergänzungen werden in einem Template mit dem Anker <code>tag.spt.tinymce.configextension.${configextensionname}</code> implementiert, wobei <code>${configextensionname}</code> einen Platzhalter für den Namen der Konfigurationserweiterung bildet. Der Name wird dem <code><spt:tinymce/></code>-Tag über das Attribut <code>configextension</code> übergeben.

; Zusätzliche Konfiguration als Tag-Attribut
: Hier wird eine Konfigurationserweiterung über das Attribute <code>configvalues</code> inline an das <code><spt:tinymce/></code> übergeben.

==Konfigurationsoptionen==
Die Konfiguration des TinyMCE besteht aus verschiedenen Konfigurations-Parametern, die mit [http://de.wikipedia.org/wiki/JavaScript_Object_Notation JSON] ohne umschließende geschweifte Klammern {} angegeben werden müssen.

Beispiel für TinyMCE-Konfiguration
<source lang="javascript">
toolbar: [
"pastetext | undo redo | bold italic | subscript superscript | indent outdent | bullist numlist | iesLink | charmap | abbr | table | removeformat"
],
statusbar: false,
object_resizing: false,
menu : {
file : {title : 'File' , items : 'newdocument'},
edit : {title : 'Edit' , items : 'undo redo | cut copy paste pastetext | selectall'},
insert : {title : 'Insert', items : 'link media | template hr'},
view : {title : 'View' , items : 'visualaid'},
format : {title : 'Format', items : 'bold italic underline strikethrough superscript subscript | formats | removeformat'},
table : {title : 'Table' , items : 'inserttable tableprops deletetable | cell row column'},
tools : {title : 'Tools' , items : 'spellchecker code'}
}
</source>

<div class="note">
Es ist zu beachten, das hinter dem letzten Parameter kein Komma stehen darf.
</div>

Alle für den TinyMCE verfügbaren Parameter können unter [http://www.tinymce.com/wiki.php/configuration http://www.tinymce.com] eingesehen werden.

<div class="note">
Folgende Plugins werden standardmäßig geladen, wobei zu beachten ist, dass das <code>iesLink</code>-Plugin die Aufgabe des <code>link</code>-Plugins übernimmt.
<source lang="javascript">
fullscreen, charmap, paste, table, contextmenu, abbr, iesLink, lang
</source>
</div>

==Konfigurationserweiterung Ablauf==

Die Konfigurationsauswertung findet wie folgt statt:

<blockquote>
Das aktive Configset wird auf das Theme gesetzt.<br/>
Wenn eine Konfiguration angegeben wurde wird das bisher gesetzte Configset mit dem eingebunden Configset überschrieben <code>(tag.spt.tinymce.config.${config})</code><br/><br/>

Wenn eine Konfigurationserweiterung angegeben wurde, wird das bisher gesetzte Configset durch das angegebene erweitert <code>(tag.spt.tinymce.configextension.${configextension})</code>.<br/>
Wenn keine Konfigurationserweiterung angegeben wurde, wird das bisher gesetzte Configset durch die Mandanten-Erweiterung erweitert <code>(tag.spt.tinymce.configextension)</code>.<br/><br/>

Wenn Configvalues angegeben wurden wird das bisher gesetzte Configset durch die übergebenen Optionen erweitert.
</blockquote>

===Standard Konfiguration pro Mandant ersetzen===
<div class="note">''Zu Beachten ist das ein überschreiben der globalen TinyMCE-Konfiguration (innerhalb des Mandanten) alle voreingestellten Setzungen wie die Einbindung eines angepassten CSS, die Auflistung aller zu verwendenden HTML-Elemente, etc. nicht mehr verwendet werden. Es sollte geprüft werden, ob es ausreicht die Standardkonfiguration zu ergänzen (siehe untern)''</div>

Es ist möglich die Standard-Konfiguration für den TinyMCE pro Mandant durch eine eigene Konfiguration zu ersetzen. Hierzu muß ein Template mit dem Anchor
tag.spt.tinymce.config
angelegt werden, in dem die Konfiguration hinterlegt ist. Existiert ein Template mit dem angegebenen Anchor, wird automatisch diese Konfiguration verwendet ohne das im <code><spt:tinymce></code>-Tag noch Änderungen vorgenommen werden müssten.

===Zusätzliche Konfigurationen pro Mandant definieren===
<div class="note">''Zu Beachten ist das bei der Verwendung einer eigenen Konfiguration alle voreingestellten Standard-Setzungen wie die Einbindung eines angepassten CSS, die Auflistung aller zu verwendenden HTML-Elemente, etc. nicht mehr verwendet werden. Es sollte geprüft werden, ob es ausreicht die Standardkonfiguration zu ergänzen (siehe untern)''</div>

Parallel zu der Standard-Konfiguration können weiter Konfigurationen pro Mandante definiert werden. Hierzu können Templates mit dem Anchor
tag.spt.tinymce.config.<configname>
angelegt werden, wobei mit <code><configname></code> ein beliegeber Name (Anchorkonform) vergeben werden kann. Um die Konfiguration zu verwenden muß im <code><spt:tinymce></code>-Tag mit dem Attribut <code>config</code> der <code><configname></code> der Konfiguration angegeben werden, die verwendet werden soll.

===Standard Konfigurations-Ergänzungen pro Mandant definieren===
Es ist möglich die Standard-Konfiguration für den TinyMCE pro Mandant mit eine eigene Konfiguration zu ergänzen. Hierzu muß ein Template mit dem Anchor
tag.spt.tinymce.configextension
angelegt werden, in dem die Konfiguration hinterlegt ist. Existiert ein Template mit dem angegebenen Anchor, wird automatisch diese Konfiguration verwendet ohne das im <code><spt:tinymce></code>-Tag noch Änderungen vorgenommen werden müssten.

===Zusätzliche Konfigurations-Ergänzungen pro Mandant definieren===

Parallel zu den Standard-Konfigurations-Ergänzungen können weiter Ergänzungen pro Mandante definiert werden. Hierzu können Templates mit dem Anchor
tag.spt.tinymce.configextension.<configextensionname>
angelegt werden, wobei mit <code><configextensionname></code> ein beliegeber Name (Anchorkonform) vergeben werden kann. Um die Konfiguration zu verwenden muß im <code><spt:tinymce></code>-Tag mit dem Attribut <code>configextension</code> der <code><configextensionname></code> der Konfiguration angegeben werden, die verwendet werden soll.

===Konfiguration in Tag-Attribut===
Mit dem Attribut <code>configvalues</code> können Konfigurationsparameter direkt angegeben werden. Diese Parameter werden mit JSON ohne umschließende geschweifte Klammern {} angegeben.
<source lang="xml">
<sp:set name="_tinyconfig">
param1 : "a",
param2 : false
</sp:set>
<spt:tinymce ... configvalues="${_tinyconfig}" ... />
</source>

==Mit dem <code>spt:tinymce</code> erzeugte Texte ausgeben (ab Version 2.0.3)==
Durch TinyMCE-Plugins des IES ist eine Nachbearbeitung des erzeugten Textes notwendig. Der Text sollte vor der Ausgabe den Tag [[spt:prehtml]] durchlaufen. Nur so ist sichergestellt, dass z.B. interne Links, die über den Editor eingetragen wurden, auch richtig ausgegeben werden.

Beispiel
<source lang="xml">
<sp:io type="in">
<spt:tinymce name="sp_body"/>
</sp:io>

<sp:io type="out">
<spt:prehtml name="processed_body" object="sp_body"/><sp:print name="processed_body"/>
</sp:io>
</source>

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
{{sp_input_attributes|attribute=name|mode=row}}
|-
{{sp_input_attributes|attribute=value|mode=row}}
|-
{{sp_input_attributes|attribute=fixvalue|mode=row}}
|-
{{sp_input_attributes|attribute=type|mode=row}}
|-
{{sp_input_attributes|attribute=disabled|mode=row}}
|-
{{sp_input_attributes|attribute=readonly|mode=row}}
|-
| <code>rows</code>
| [[Number]]
| Nein
| 15
| 1
|-
| <code>cols</code>
| [[Number]]
| Nein
| 80
| 1
|-
| <code>theme</code>
| [[Text]]
| Nein
| advanced
| 1
|-
| <code>pools</code>
| [[Anchor]]-List oder [[ID]]-List
| Nein
| aktueller Informationspool
| 1
|-
| <code>config</code>
| [[Text]]
| Nein
|
| 2.0.3
|-
| <code>configextension</code>
| [[Text]]
| Nein
|
| 2.0.3
|-
| <code>configvalues</code>
| [[Text]]
| Nein
|
| 2.0.3
|-
| <code>toggle</code>
| [[Condition]] Oder [[Text]]
| Nein
| true
| 2.26
|-
{{sp_input_attributes|attribute=dynamics|mode=row}}
|}
{{sp_input_attributes|attribute=name|mode=desc}}
{{sp_input_attributes|attribute=value|mode=desc}}
{{sp_input_attributes|attribute=fixvalue|mode=desc}}
{{sp_input_attributes|attribute=locale|mode=desc}}
{{sp_input_attributes|attribute=type|mode=desc}}
{{sp_input_attributes|attribute=disabled|mode=desc}}
{{sp_input_attributes|attribute=readonly|mode=desc}}
;<code>rows</code>
:Höhe des Eingabefeldes in Zeilen.

;<code>cols</code>
:Breite des Eingabefeldes in Spalten.

;<code>theme</code>
:Konfigurationstypen, die den Funktionsumfang für den Editor beschreiben. Mögliche Themes sind:
:;simple
:;advanced

;<code>pools</code>
:Kommaseparierte Liste von [[Anchor|Anchors]] von Artikelpools oder von [[ID|IDs]] von Artikelpools; die Elemente der Pools werden dem Redakteur in einem Linkdialog innerhalb des Editors zur Auswahl angeboten. Voraussetzung, dass der interne Linkdialog überhaupt angezeigt wird, ist die Konfiguration des Editors mit iesLink über theme_advanced_buttons in der [http://wiki.moxiecode.com/index.php/TinyMCE:Configuration TinyMCE:Configuration]. Ausgabeseitig muss man darauf achten, dass ein interner Link vor der Ausgabe mit [[spt:id2url]] umgewandelt wird.

;<code>config</code>
:Mit diesem Attribut wird der Name einer Konfiguration angegeben. Die in dieser Konfiguration angegebenen Konfigurationsparameter überschreiben die IES-Standardkonfiguration. Die Angaben werden in JSON angegeben, wobei die umschließenden geschweiften Klammern {} nicht mit angegeben werden dürfen. Die möglichen Konfigurationsparameter sind unter [http://wiki.moxiecode.com/index.php/TinyMCE:Configuration TinyMCE:Configuration] aufgelistet.

;<code>toggle</code>
:Mit diesem Attribut lässt sich angeben, wie der TinyMce eingeschaltet werden soll. True für einen Toggle Button, False für keinen Toggle-Button, auto für Automatisches togglen

;<code>configextension</code>
:Mit diesem Attribut wird der Name einer Konfigurations-Ergänzung angegeben. Die in dieser Ergänzung angegebenen Konfigurationsparameter ergänzen und überschreiben die Parameter der IES-Standardkonfiguration. Die Angaben werden in JSON angegeben, wobei die umschließenden geschweiften Klammern {} nicht mit angegeben werden dürfen. Die möglichen Konfigurationsparameter sind unter [http://wiki.moxiecode.com/index.php/TinyMCE:Configuration TinyMCE:Configuration] aufgelistet.

;<code>configvalues</code>
:Mit diesem Attribut können TinyMCE Konfigurationen angegeben werden. Die Konfigurationsparameter ergänzen und überschreiben die Parameter der IES-Standardkonfiguration. Die Angaben werden in JSON angegeben, wobei die umschließenden geschweiften Klammern {} nicht mit angegeben werden dürfen. Die möglichen Konfigurationsparameter sind unter [http://wiki.moxiecode.com/index.php/TinyMCE:Configuration TinyMCE:Configuration] aufgelistet.
{{sp_input_attributes|attribute=dynamics|mode=desc}}

==Beispiele==

===WYSIWYG-Editor nutzen und Inhalt ausgeben===

Template Quelltext
<source lang="xml">
<sp:io type="in">
<spt:tinymce name="sp_body"/>
</sp:io>

<sp:io type="out">
<spt:prehtml name="processed_body" object="sp_body"/><sp:print name="processed_body"/>
</sp:io>
</source>

=== Barrierefreie Datentabellen ===
<p>In der Tabellendarstellung haben wir Sehende es einfacher komplexe Strukturen zu erkennen.<br /> Wir können in der Spalte kurz nach oben schauen, um uns zu vergewissern zu welcher Kopfinformation der Zelleninhalt gehört. Für Screenreader ist hier unbedingt eine eindeutige Zuordnung nötig.</p>
<p>Die Web Content Accessibility Guidelines fordert in den Guidelines 2.0 von einer HTML Tabelle</p>
<ol>
<li>Ein Caption-Element welches eine kurze Überschrift der Tabelle bereitstellt [http://www.w3.org/TR/WCAG20-TECHS/H39 (H39)] [http://www.w3.org/TR/WCAG20/#content-structure-separation-programmatic (Level A)]</li>
<li>Eine Trennung des Überschrifts- und Inhaltsbereichs der Tabelle mit dem thead-, und tbody-Element [http://www.w3.org/TR/WCAG20-TECHS/H51 (H51)] [http://www.w3.org/TR/WCAG20/#content-structure-separation-programmatic (Level A)]</li>
<li>In dem Überschriftsbereich sollen die th-Elemente mit dem Attribut scope=“col“ eine Verknüpfung zu einer Spalte haben [http://www.w3.org/TR/WCAG20-TECHS/H63 (H63)] [http://www.w3.org/TR/WCAG20/#content-structure-separation-programmatic (Level A)]. Wenn Datenzellen mehr als einer Zeilen- und/oder Spaltenüberschrift zugeordnet sind werden die Zellen mit ID- und header-Attribut miteinander verknüpft [http://www.w3.org/TR/WCAG20-TECHS/H43 (H43)] [http://www.w3.org/TR/WCAG20/#content-structure-separation-programmatic (Level A)]</li>
<li>Falls vorgesehen sollten td-Elemente mit dem Attribut scope=“row“ Zeilenheaderzellen definieren [http://www.w3.org/TR/WCAG20-TECHS/H63 (H63)] [http://www.w3.org/TR/WCAG20-TECHS/H43 (H43)] [http://www.w3.org/TR/WCAG20/#content-structure-separation-programmatic (Level A)]</li>
</ol>
<br>
=====Wie erstelle ich eine Tabelle=====
<p>
<ol>
<li>
<div class="notice">Öffnen Sie die Tabellenkonfiguration über den Schalter in der Toolbar und wählen Sie aus wie viele Spalten/Zeilen Sie benötigen.</div><br/>
[[Datei:tiny-table-tutorial-step-1.png|alt=Barrierefreie Tabellen erstellen Schritt 1|Barrierefreie Tabellen erstellen Schritt 1]]<br/><br/>
</li>

<li>
<div class="notice">Öffnen Sie die Tabelleneigenschaften.</div><br/>
[[Datei:tiny-table-tutorial-step-2.png|alt=Barrierefreie Tabellen erstellen Schritt 2|Barrierefreie Tabellen erstellen Schritt 2]]<br/><br/>
</li>

<li>
<div class="notice">Hier kann die Option zur Eingabe einer Caption aktiviert werden.</div><br/>
[[Datei:tiny-table-tutorial-step-3.png|alt=Barrierefreie Tabellen erstellen Schritt 3|Barrierefreie Tabellen erstellen Schritt 3]]<br/><br/>
</li>

<li>
<div class="notice">Nun erscheint oberhalb der Tabelle ein neues Feld zur Eingabe der Caption</div><br/>
[[Datei:tiny-table-tutorial-step-4.png|alt=Barrierefreie Tabellen erstellen Schritt 4|Barrierefreie Tabellen erstellen Schritt 4]]<br/><br/>
</li>

<li>
<div class="notice">Füllen Sie die weiter Tabelle mit Inhalten</div><br/>
[[Datei:tiny-table-tutorial-step-5.png|alt=Barrierefreie Tabellen erstellen Schritt 5|Barrierefreie Tabellen erstellen Schritt 5]]<br/><br/>
</li>

<li>
<div class="notice">Um die obere Zeile als Spaltenbeschreibung zu deklarieren, markieren Sie die Zeile und öffnen die Zelleneigenschaften</div><br/>
[[Datei:tiny-table-tutorial-step-6.png|alt=Barrierefreie Tabellen erstellen Schritt 6|Barrierefreie Tabellen erstellen Schritt 6]]<br/><br/>
</li>

<li>
<div class="notice">Ändern Sie den Zellentyp auf Kopfzeile</div><br/>
[[Datei:tiny-table-tutorial-step-7.png|alt=Barrierefreie Tabellen erstellen Schritt 7|Barrierefreie Tabellen erstellen Schritt 7]]<br/><br/>
</li>

<li>
<div class="notice">Um anzugeben, dass es sich bei den markierten Feldern um Spaltenüberschriften handelt, müssen Sie den Gültigkeitsbereich auf Spalte ändern</div><br/>
[[Datei:tiny-table-tutorial-step-8.png|alt=Barrierefreie Tabellen erstellen Schritt 8|Barrierefreie Tabellen erstellen Schritt 8]]<br/><br/>
</li>

<li>
<div class="notice">Gehen Sie bei Zeilenüberschriften genauso vor</div><br/>
[[Datei:tiny-table-tutorial-step-9.png|alt=Barrierefreie Tabellen erstellen Schritt 9|Barrierefreie Tabellen erstellen Schritt 9]]
[[Datei:tiny-table-tutorial-step-10.png|alt=Barrierefreie Tabellen erstellen Schritt 10|Barrierefreie Tabellen erstellen Schritt 10]]<br/><br/>
</li>

<li>
<div class="notice">An stelle von "Spalte" geben wir hier als Gültigkeitsbereich "Zeile" an, da es sich um zeilenweise Überschriften handelt</div><br/>
[[Datei:tiny-table-tutorial-step-11.png|alt=Barrierefreie Tabellen erstellen Schritt 11|Barrierefreie Tabellen erstellen Schritt 11]]<br/><br/>
</li>

<li>
<div class="notice">Die fertige Ausgabe auf der Website kann dann z.B. so aussehen:</div><br/>
[[Datei:tiny-table-tutorial-step-12.png|alt=Barrierefreie Tabellen erstellen Schritt 12|Barrierefreie Tabellen erstellen Schritt 12]]
<br/><br/>
</li>
</ol>
</p>

===== Was schreibt der TinyMCE nun auf die Webseite? =====
<p>So sieht der HTML Code mit unseren Zusatzinformationen und Änderungen aus:<br />
<source lang="xml">
<table>
<caption>Gruppe G</caption>
<tbody>
<tr>
<th scope="col">Land</th>
<th scope="col">Punkte</th>
<th scope="col">Tore</th>
<th scope="col">Tordifferenz</th>
<th scope="col">Siege</th>
</tr>
<tr>
<th scope="row">Deutschland</th>
<td>3</td>
<td>4</td>
<td>4</td>
<td>1</td>
</tr>
<tr>
<th scope="row">USA</th>
<td>3</td>
<td>2</td>
<td>1</td>
<td>1</td>
</tr>
<tr>
<th scope="row">Ghana</th>
<td>0</td>
<td>1</td>
<td>-1</td>
<td>0</td>
</tr>
<tr>
<th scope="row">Portugal</th>
<td>0</td>
<td>0</td>
<td>-4</td>
<td>0</td>
</tr>
</tbody>
</table>
</source>
</p>

<noinclude>
[[Category:SPT-Tags]]
</noinclude>

Tinymce (SPT-Tag)

2016-04-18T13:00:54Z

Schleuse: /* Attribute */

==Name==
<spt:tinymce> - Integriert einen Editor

==Syntax==
<source lang="xml">
<spt:tinymce name="variable" theme="simple"/>
</source>

==Beschreibung==
Mit dem tinymce-Tag wird ein externer WYSIWYG-Editor ins CMS eingebunden. "<b>W</b>hat <b>Y</b>ou <b>S</b>ee <b>I</b>s <b>W</b>hat <b>Y</b>ou <b>G</b>et" steht für eine Übernahme eines geschriebenen Textes auf der Website, so wie ihn der Redakteur bei der Eingabe sieht. Auf diese Weise kann der Redakteur z.B. Tabellen oder Formatierungen in seine Artikel einbinden ohne über HTML-Kenntnisse zu verfügen. Die Ausgabe hängt aber nicht nur vom Editor, sondern auch von den Einstellungen des Browsers und den installierten Systemschriften ab.

Der Editor TinyMCE ist ein Open-Source Produkt der Firma [http://tinymce.moxiecode.com Moxiecode] und kann im Rahmen des CMS "so wie er ist" genutzt werden. TinyMCE ist kein Produkt der Sitepark GmbH und wird daher nicht von unserem Support betreut. Fehler-Meldungen und Erweiterungswünsche werden von Sitepark an den Hersteller weitergeleitet.

==Themes==
Über die Theme-Option lässt sich aus aktuell 2 vordefinierten Konfiguration wählen:

*simple
[[Datei:tiny-theme-simple.png]]
*advanced
[[Datei:tiny-theme-advanced.png]]

==Konfigurationserweiterung==
Sollten die vordefinieren Themes den Anforderungen nicht entsprechen lässt sich der <code><spt:tinymce /></code> über unterschiedliche Mechanismen erweitern/überschreiben.

; Konfiguration mandantenweit ergänzen''(nicht empfohlen)''
: Hier wird die Standard-Konfiguration durch eine eigene ergänzt. Alle <code><spt:tinymce></code>-Tags die nicht das Attribut <code>config</code> verwenden, sind von dieser Anpassung betroffen. Die Anpassungen werden in einem Template mit dem Anker <code>tag.spt.tinymce.configextension</code> vorgenommen

; Konfiguration per Konfigurationserweiterungen überschreiben ''(nicht empfohlen)''
: Hier wird die Standard-Konfiguration durch eine eigene vordefinierte Konfiguration vollständig ersetzt. Die Konfigurationen werden in einem Template mit dem Anker <code>tag.spt.tinymce.config.${configname}</code> implementiert, wobei <code>${configname}</code> einen Platzhalter für den Namen der Konfiguration bildet. Der Name wird dem <code><spt:tinymce/></code>-Tag über das Attribut <code>config</code> übergeben.

; Konfiguration per Konfigurationserweiterungen erweitern
: Hier wird die Standard-Konfiguration durch eine eigene vordefinierte Konfiguration ergänzt. Die Ergänzungen werden in einem Template mit dem Anker <code>tag.spt.tinymce.configextension.${configextensionname}</code> implementiert, wobei <code>${configextensionname}</code> einen Platzhalter für den Namen der Konfigurationserweiterung bildet. Der Name wird dem <code><spt:tinymce/></code>-Tag über das Attribut <code>configextension</code> übergeben.

; Zusätzliche Konfiguration als Tag-Attribut
: Hier wird eine Konfigurationserweiterung über das Attribute <code>configvalues</code> inline an das <code><spt:tinymce/></code> übergeben.

==Konfigurationsoptionen==
Die Konfiguration des TinyMCE besteht aus verschiedenen Konfigurations-Parametern, die mit [http://de.wikipedia.org/wiki/JavaScript_Object_Notation JSON] ohne umschließende geschweifte Klammern {} angegeben werden müssen.

Beispiel für TinyMCE-Konfiguration
<source lang="javascript">
toolbar: [
"pastetext | undo redo | bold italic | subscript superscript | indent outdent | bullist numlist | iesLink | charmap | abbr | table | removeformat"
],
statusbar: false,
object_resizing: false,
menu : {
file : {title : 'File' , items : 'newdocument'},
edit : {title : 'Edit' , items : 'undo redo | cut copy paste pastetext | selectall'},
insert : {title : 'Insert', items : 'link media | template hr'},
view : {title : 'View' , items : 'visualaid'},
format : {title : 'Format', items : 'bold italic underline strikethrough superscript subscript | formats | removeformat'},
table : {title : 'Table' , items : 'inserttable tableprops deletetable | cell row column'},
tools : {title : 'Tools' , items : 'spellchecker code'}
}
</source>

<div class="note">
Es ist zu beachten, das hinter dem letzten Parameter kein Komma stehen darf.
</div>

Alle für den TinyMCE verfügbaren Parameter können unter [http://www.tinymce.com/wiki.php/configuration http://www.tinymce.com] eingesehen werden.

<div class="note">
Folgende Plugins werden standardmäßig geladen, wobei zu beachten ist, dass das <code>iesLink</code>-Plugin die Aufgabe des <code>link</code>-Plugins übernimmt.
<source lang="javascript">
fullscreen, charmap, paste, table, contextmenu, abbr, iesLink, lang
</source>
</div>

==Konfigurationserweiterung Ablauf==

Die Konfigurationsauswertung findet wie folgt statt:

<blockquote>
Das aktive Configset wird auf das Theme gesetzt.<br/>
Wenn eine Konfiguration angegeben wurde wird das bisher gesetzte Configset mit dem eingebunden Configset überschrieben <code>(tag.spt.tinymce.config.${config})</code><br/><br/>

Wenn eine Konfigurationserweiterung angegeben wurde, wird das bisher gesetzte Configset durch das angegebene erweitert <code>(tag.spt.tinymce.configextension.${configextension})</code>.<br/>
Wenn keine Konfigurationserweiterung angegeben wurde, wird das bisher gesetzte Configset durch die Mandanten-Erweiterung erweitert <code>(tag.spt.tinymce.configextension)</code>.<br/><br/>

Wenn Configvalues angegeben wurden wird das bisher gesetzte Configset durch die übergebenen Optionen erweitert.
</blockquote>

===Standard Konfiguration pro Mandant ersetzen===
<div class="note">''Zu Beachten ist das ein überschreiben der globalen TinyMCE-Konfiguration (innerhalb des Mandanten) alle voreingestellten Setzungen wie die Einbindung eines angepassten CSS, die Auflistung aller zu verwendenden HTML-Elemente, etc. nicht mehr verwendet werden. Es sollte geprüft werden, ob es ausreicht die Standardkonfiguration zu ergänzen (siehe untern)''</div>

Es ist möglich die Standard-Konfiguration für den TinyMCE pro Mandant durch eine eigene Konfiguration zu ersetzen. Hierzu muß ein Template mit dem Anchor
tag.spt.tinymce.config
angelegt werden, in dem die Konfiguration hinterlegt ist. Existiert ein Template mit dem angegebenen Anchor, wird automatisch diese Konfiguration verwendet ohne das im <code><spt:tinymce></code>-Tag noch Änderungen vorgenommen werden müssten.

===Zusätzliche Konfigurationen pro Mandant definieren===
<div class="note">''Zu Beachten ist das bei der Verwendung einer eigenen Konfiguration alle voreingestellten Standard-Setzungen wie die Einbindung eines angepassten CSS, die Auflistung aller zu verwendenden HTML-Elemente, etc. nicht mehr verwendet werden. Es sollte geprüft werden, ob es ausreicht die Standardkonfiguration zu ergänzen (siehe untern)''</div>

Parallel zu der Standard-Konfiguration können weiter Konfigurationen pro Mandante definiert werden. Hierzu können Templates mit dem Anchor
tag.spt.tinymce.config.<configname>
angelegt werden, wobei mit <code><configname></code> ein beliegeber Name (Anchorkonform) vergeben werden kann. Um die Konfiguration zu verwenden muß im <code><spt:tinymce></code>-Tag mit dem Attribut <code>config</code> der <code><configname></code> der Konfiguration angegeben werden, die verwendet werden soll.

===Standard Konfigurations-Ergänzungen pro Mandant definieren===
Es ist möglich die Standard-Konfiguration für den TinyMCE pro Mandant mit eine eigene Konfiguration zu ergänzen. Hierzu muß ein Template mit dem Anchor
tag.spt.tinymce.configextension
angelegt werden, in dem die Konfiguration hinterlegt ist. Existiert ein Template mit dem angegebenen Anchor, wird automatisch diese Konfiguration verwendet ohne das im <code><spt:tinymce></code>-Tag noch Änderungen vorgenommen werden müssten.

===Zusätzliche Konfigurations-Ergänzungen pro Mandant definieren===

Parallel zu den Standard-Konfigurations-Ergänzungen können weiter Ergänzungen pro Mandante definiert werden. Hierzu können Templates mit dem Anchor
tag.spt.tinymce.configextension.<configextensionname>
angelegt werden, wobei mit <code><configextensionname></code> ein beliegeber Name (Anchorkonform) vergeben werden kann. Um die Konfiguration zu verwenden muß im <code><spt:tinymce></code>-Tag mit dem Attribut <code>configextension</code> der <code><configextensionname></code> der Konfiguration angegeben werden, die verwendet werden soll.

===Konfiguration in Tag-Attribut===
Mit dem Attribut <code>configvalues</code> können Konfigurationsparameter direkt angegeben werden. Diese Parameter werden mit JSON ohne umschließende geschweifte Klammern {} angegeben.
<source lang="xml">
<sp:set name="_tinyconfig">
param1 : "a",
param2 : false
</sp:set>
<spt:tinymce ... configvalues="${_tinyconfig}" ... />
</source>

==Mit dem <code>spt:tinymce</code> erzeugte Texte ausgeben (ab Version 2.0.3)==
Durch TinyMCE-Plugins des IES ist eine Nachbearbeitung des erzeugten Textes notwendig. Der Text sollte vor der Ausgabe den Tag [[spt:prehtml]] durchlaufen. Nur so ist sichergestellt, dass z.B. interne Links, die über den Editor eingetragen wurden, auch richtig ausgegeben werden.

Beispiel
<source lang="xml">
<sp:io type="in">
<spt:tinymce name="sp_body"/>
</sp:io>

<sp:io type="out">
<spt:prehtml name="processed_body" object="sp_body"/><sp:print name="processed_body"/>
</sp:io>
</source>

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
{{sp_input_attributes|attribute=name|mode=row}}
|-
{{sp_input_attributes|attribute=value|mode=row}}
|-
{{sp_input_attributes|attribute=fixvalue|mode=row}}
|-
{{sp_input_attributes|attribute=type|mode=row}}
|-
{{sp_input_attributes|attribute=disabled|mode=row}}
|-
{{sp_input_attributes|attribute=readonly|mode=row}}
|-
| <code>rows</code>
| [[Number]]
| Nein
| 15
| 1
|-
| <code>cols</code>
| [[Number]]
| Nein
| 80
| 1
|-
| <code>theme</code>
| [[Text]]
| Nein
| advanced
| 1
|-
| <code>pools</code>
| [[Anchor]]-List oder [[ID]]-List
| Nein
| aktueller Informationspool
| 1
|-
| <code>config</code>
| [[Text]]
| Nein
|
| 2.0.3
|-
| <code>configextension</code>
| [[Text]]
| Nein
|
| 2.0.3
|-
| <code>configvalues</code>
| [[Text]]
| Nein
|
| 2.0.3
|-
| <code>toggle</code>
| [[Condition]] Oder [[Text]]
| Nein
| true
| 2.26
|-
{{sp_input_attributes|attribute=dynamics|mode=row}}
|}
{{sp_input_attributes|attribute=name|mode=desc}}
{{sp_input_attributes|attribute=value|mode=desc}}
{{sp_input_attributes|attribute=fixvalue|mode=desc}}
{{sp_input_attributes|attribute=locale|mode=desc}}
{{sp_input_attributes|attribute=type|mode=desc}}
{{sp_input_attributes|attribute=disabled|mode=desc}}
{{sp_input_attributes|attribute=readonly|mode=desc}}
;<code>rows</code>
:Höhe des Eingabefeldes in Zeilen.

;<code>cols</code>
:Breite des Eingabefeldes in Spalten.

;<code>theme</code>
:Konfigurationstypen, die den Funktionsumfang für den Editor beschreiben. Mögliche Themes sind:
:;simple
:;advanced

;<code>pools</code>
:Kommaseparierte Liste von [[Anchor|Anchors]] von Artikelpools oder von [[ID|IDs]] von Artikelpools; die Elemente der Pools werden dem Redakteur in einem Linkdialog innerhalb des Editors zur Auswahl angeboten. Voraussetzung, dass der interne Linkdialog überhaupt angezeigt wird, ist die Konfiguration des Editors mit iesLink über theme_advanced_buttons in der [http://wiki.moxiecode.com/index.php/TinyMCE:Configuration TinyMCE:Configuration]. Ausgabeseitig muss man darauf achten, dass ein interner Link vor der Ausgabe mit [[spt:id2url]] umgewandelt wird.

;<code>config</code>
:Mit diesem Attribut wird der Name einer Konfiguration angegeben. Die in dieser Konfiguration angegebenen Konfigurationsparameter überschreiben die IES-Standardkonfiguration. Die Angaben werden in JSON angegeben, wobei die umschließenden geschweiften Klammern {} nicht mit angegeben werden dürfen. Die möglichen Konfigurationsparameter sind unter [http://wiki.moxiecode.com/index.php/TinyMCE:Configuration TinyMCE:Configuration] aufgelistet.

;<code>configextension</code>
:Mit diesem Attribut wird der Name einer Konfigurations-Ergänzung angegeben. Die in dieser Ergänzung angegebenen Konfigurationsparameter ergänzen und überschreiben die Parameter der IES-Standardkonfiguration. Die Angaben werden in JSON angegeben, wobei die umschließenden geschweiften Klammern {} nicht mit angegeben werden dürfen. Die möglichen Konfigurationsparameter sind unter [http://wiki.moxiecode.com/index.php/TinyMCE:Configuration TinyMCE:Configuration] aufgelistet.

;<code>configvalues</code>
:Mit diesem Attribut können TinyMCE Konfigurationen angegeben werden. Die Konfigurationsparameter ergänzen und überschreiben die Parameter der IES-Standardkonfiguration. Die Angaben werden in JSON angegeben, wobei die umschließenden geschweiften Klammern {} nicht mit angegeben werden dürfen. Die möglichen Konfigurationsparameter sind unter [http://wiki.moxiecode.com/index.php/TinyMCE:Configuration TinyMCE:Configuration] aufgelistet.
{{sp_input_attributes|attribute=dynamics|mode=desc}}

==Beispiele==

===WYSIWYG-Editor nutzen und Inhalt ausgeben===

Template Quelltext
<source lang="xml">
<sp:io type="in">
<spt:tinymce name="sp_body"/>
</sp:io>

<sp:io type="out">
<spt:prehtml name="processed_body" object="sp_body"/><sp:print name="processed_body"/>
</sp:io>
</source>

=== Barrierefreie Datentabellen ===
<p>In der Tabellendarstellung haben wir Sehende es einfacher komplexe Strukturen zu erkennen.<br /> Wir können in der Spalte kurz nach oben schauen, um uns zu vergewissern zu welcher Kopfinformation der Zelleninhalt gehört. Für Screenreader ist hier unbedingt eine eindeutige Zuordnung nötig.</p>
<p>Die Web Content Accessibility Guidelines fordert in den Guidelines 2.0 von einer HTML Tabelle</p>
<ol>
<li>Ein Caption-Element welches eine kurze Überschrift der Tabelle bereitstellt [http://www.w3.org/TR/WCAG20-TECHS/H39 (H39)] [http://www.w3.org/TR/WCAG20/#content-structure-separation-programmatic (Level A)]</li>
<li>Eine Trennung des Überschrifts- und Inhaltsbereichs der Tabelle mit dem thead-, und tbody-Element [http://www.w3.org/TR/WCAG20-TECHS/H51 (H51)] [http://www.w3.org/TR/WCAG20/#content-structure-separation-programmatic (Level A)]</li>
<li>In dem Überschriftsbereich sollen die th-Elemente mit dem Attribut scope=“col“ eine Verknüpfung zu einer Spalte haben [http://www.w3.org/TR/WCAG20-TECHS/H63 (H63)] [http://www.w3.org/TR/WCAG20/#content-structure-separation-programmatic (Level A)]. Wenn Datenzellen mehr als einer Zeilen- und/oder Spaltenüberschrift zugeordnet sind werden die Zellen mit ID- und header-Attribut miteinander verknüpft [http://www.w3.org/TR/WCAG20-TECHS/H43 (H43)] [http://www.w3.org/TR/WCAG20/#content-structure-separation-programmatic (Level A)]</li>
<li>Falls vorgesehen sollten td-Elemente mit dem Attribut scope=“row“ Zeilenheaderzellen definieren [http://www.w3.org/TR/WCAG20-TECHS/H63 (H63)] [http://www.w3.org/TR/WCAG20-TECHS/H43 (H43)] [http://www.w3.org/TR/WCAG20/#content-structure-separation-programmatic (Level A)]</li>
</ol>
<br>
=====Wie erstelle ich eine Tabelle=====
<p>
<ol>
<li>
<div class="notice">Öffnen Sie die Tabellenkonfiguration über den Schalter in der Toolbar und wählen Sie aus wie viele Spalten/Zeilen Sie benötigen.</div><br/>
[[Datei:tiny-table-tutorial-step-1.png|alt=Barrierefreie Tabellen erstellen Schritt 1|Barrierefreie Tabellen erstellen Schritt 1]]<br/><br/>
</li>

<li>
<div class="notice">Öffnen Sie die Tabelleneigenschaften.</div><br/>
[[Datei:tiny-table-tutorial-step-2.png|alt=Barrierefreie Tabellen erstellen Schritt 2|Barrierefreie Tabellen erstellen Schritt 2]]<br/><br/>
</li>

<li>
<div class="notice">Hier kann die Option zur Eingabe einer Caption aktiviert werden.</div><br/>
[[Datei:tiny-table-tutorial-step-3.png|alt=Barrierefreie Tabellen erstellen Schritt 3|Barrierefreie Tabellen erstellen Schritt 3]]<br/><br/>
</li>

<li>
<div class="notice">Nun erscheint oberhalb der Tabelle ein neues Feld zur Eingabe der Caption</div><br/>
[[Datei:tiny-table-tutorial-step-4.png|alt=Barrierefreie Tabellen erstellen Schritt 4|Barrierefreie Tabellen erstellen Schritt 4]]<br/><br/>
</li>

<li>
<div class="notice">Füllen Sie die weiter Tabelle mit Inhalten</div><br/>
[[Datei:tiny-table-tutorial-step-5.png|alt=Barrierefreie Tabellen erstellen Schritt 5|Barrierefreie Tabellen erstellen Schritt 5]]<br/><br/>
</li>

<li>
<div class="notice">Um die obere Zeile als Spaltenbeschreibung zu deklarieren, markieren Sie die Zeile und öffnen die Zelleneigenschaften</div><br/>
[[Datei:tiny-table-tutorial-step-6.png|alt=Barrierefreie Tabellen erstellen Schritt 6|Barrierefreie Tabellen erstellen Schritt 6]]<br/><br/>
</li>

<li>
<div class="notice">Ändern Sie den Zellentyp auf Kopfzeile</div><br/>
[[Datei:tiny-table-tutorial-step-7.png|alt=Barrierefreie Tabellen erstellen Schritt 7|Barrierefreie Tabellen erstellen Schritt 7]]<br/><br/>
</li>

<li>
<div class="notice">Um anzugeben, dass es sich bei den markierten Feldern um Spaltenüberschriften handelt, müssen Sie den Gültigkeitsbereich auf Spalte ändern</div><br/>
[[Datei:tiny-table-tutorial-step-8.png|alt=Barrierefreie Tabellen erstellen Schritt 8|Barrierefreie Tabellen erstellen Schritt 8]]<br/><br/>
</li>

<li>
<div class="notice">Gehen Sie bei Zeilenüberschriften genauso vor</div><br/>
[[Datei:tiny-table-tutorial-step-9.png|alt=Barrierefreie Tabellen erstellen Schritt 9|Barrierefreie Tabellen erstellen Schritt 9]]
[[Datei:tiny-table-tutorial-step-10.png|alt=Barrierefreie Tabellen erstellen Schritt 10|Barrierefreie Tabellen erstellen Schritt 10]]<br/><br/>
</li>

<li>
<div class="notice">An stelle von "Spalte" geben wir hier als Gültigkeitsbereich "Zeile" an, da es sich um zeilenweise Überschriften handelt</div><br/>
[[Datei:tiny-table-tutorial-step-11.png|alt=Barrierefreie Tabellen erstellen Schritt 11|Barrierefreie Tabellen erstellen Schritt 11]]<br/><br/>
</li>

<li>
<div class="notice">Die fertige Ausgabe auf der Website kann dann z.B. so aussehen:</div><br/>
[[Datei:tiny-table-tutorial-step-12.png|alt=Barrierefreie Tabellen erstellen Schritt 12|Barrierefreie Tabellen erstellen Schritt 12]]
<br/><br/>
</li>
</ol>
</p>

===== Was schreibt der TinyMCE nun auf die Webseite? =====
<p>So sieht der HTML Code mit unseren Zusatzinformationen und Änderungen aus:<br />
<source lang="xml">
<table>
<caption>Gruppe G</caption>
<tbody>
<tr>
<th scope="col">Land</th>
<th scope="col">Punkte</th>
<th scope="col">Tore</th>
<th scope="col">Tordifferenz</th>
<th scope="col">Siege</th>
</tr>
<tr>
<th scope="row">Deutschland</th>
<td>3</td>
<td>4</td>
<td>4</td>
<td>1</td>
</tr>
<tr>
<th scope="row">USA</th>
<td>3</td>
<td>2</td>
<td>1</td>
<td>1</td>
</tr>
<tr>
<th scope="row">Ghana</th>
<td>0</td>
<td>1</td>
<td>-1</td>
<td>0</td>
</tr>
<tr>
<th scope="row">Portugal</th>
<td>0</td>
<td>0</td>
<td>-4</td>
<td>0</td>
</tr>
</tbody>
</table>
</source>
</p>

<noinclude>
[[Category:SPT-Tags]]
</noinclude>

Tinymce (SPT-Tag)

2016-04-18T13:00:06Z

Schleuse:

==Name==
<spt:tinymce> - Integriert einen Editor

==Syntax==
<source lang="xml">
<spt:tinymce name="variable" theme="simple"/>
</source>

==Beschreibung==
Mit dem tinymce-Tag wird ein externer WYSIWYG-Editor ins CMS eingebunden. "<b>W</b>hat <b>Y</b>ou <b>S</b>ee <b>I</b>s <b>W</b>hat <b>Y</b>ou <b>G</b>et" steht für eine Übernahme eines geschriebenen Textes auf der Website, so wie ihn der Redakteur bei der Eingabe sieht. Auf diese Weise kann der Redakteur z.B. Tabellen oder Formatierungen in seine Artikel einbinden ohne über HTML-Kenntnisse zu verfügen. Die Ausgabe hängt aber nicht nur vom Editor, sondern auch von den Einstellungen des Browsers und den installierten Systemschriften ab.

Der Editor TinyMCE ist ein Open-Source Produkt der Firma [http://tinymce.moxiecode.com Moxiecode] und kann im Rahmen des CMS "so wie er ist" genutzt werden. TinyMCE ist kein Produkt der Sitepark GmbH und wird daher nicht von unserem Support betreut. Fehler-Meldungen und Erweiterungswünsche werden von Sitepark an den Hersteller weitergeleitet.

==Themes==
Über die Theme-Option lässt sich aus aktuell 2 vordefinierten Konfiguration wählen:

*simple
[[Datei:tiny-theme-simple.png]]
*advanced
[[Datei:tiny-theme-advanced.png]]

==Konfigurationserweiterung==
Sollten die vordefinieren Themes den Anforderungen nicht entsprechen lässt sich der <code><spt:tinymce /></code> über unterschiedliche Mechanismen erweitern/überschreiben.

; Konfiguration mandantenweit ergänzen''(nicht empfohlen)''
: Hier wird die Standard-Konfiguration durch eine eigene ergänzt. Alle <code><spt:tinymce></code>-Tags die nicht das Attribut <code>config</code> verwenden, sind von dieser Anpassung betroffen. Die Anpassungen werden in einem Template mit dem Anker <code>tag.spt.tinymce.configextension</code> vorgenommen

; Konfiguration per Konfigurationserweiterungen überschreiben ''(nicht empfohlen)''
: Hier wird die Standard-Konfiguration durch eine eigene vordefinierte Konfiguration vollständig ersetzt. Die Konfigurationen werden in einem Template mit dem Anker <code>tag.spt.tinymce.config.${configname}</code> implementiert, wobei <code>${configname}</code> einen Platzhalter für den Namen der Konfiguration bildet. Der Name wird dem <code><spt:tinymce/></code>-Tag über das Attribut <code>config</code> übergeben.

; Konfiguration per Konfigurationserweiterungen erweitern
: Hier wird die Standard-Konfiguration durch eine eigene vordefinierte Konfiguration ergänzt. Die Ergänzungen werden in einem Template mit dem Anker <code>tag.spt.tinymce.configextension.${configextensionname}</code> implementiert, wobei <code>${configextensionname}</code> einen Platzhalter für den Namen der Konfigurationserweiterung bildet. Der Name wird dem <code><spt:tinymce/></code>-Tag über das Attribut <code>configextension</code> übergeben.

; Zusätzliche Konfiguration als Tag-Attribut
: Hier wird eine Konfigurationserweiterung über das Attribute <code>configvalues</code> inline an das <code><spt:tinymce/></code> übergeben.

==Konfigurationsoptionen==
Die Konfiguration des TinyMCE besteht aus verschiedenen Konfigurations-Parametern, die mit [http://de.wikipedia.org/wiki/JavaScript_Object_Notation JSON] ohne umschließende geschweifte Klammern {} angegeben werden müssen.

Beispiel für TinyMCE-Konfiguration
<source lang="javascript">
toolbar: [
"pastetext | undo redo | bold italic | subscript superscript | indent outdent | bullist numlist | iesLink | charmap | abbr | table | removeformat"
],
statusbar: false,
object_resizing: false,
menu : {
file : {title : 'File' , items : 'newdocument'},
edit : {title : 'Edit' , items : 'undo redo | cut copy paste pastetext | selectall'},
insert : {title : 'Insert', items : 'link media | template hr'},
view : {title : 'View' , items : 'visualaid'},
format : {title : 'Format', items : 'bold italic underline strikethrough superscript subscript | formats | removeformat'},
table : {title : 'Table' , items : 'inserttable tableprops deletetable | cell row column'},
tools : {title : 'Tools' , items : 'spellchecker code'}
}
</source>

<div class="note">
Es ist zu beachten, das hinter dem letzten Parameter kein Komma stehen darf.
</div>

Alle für den TinyMCE verfügbaren Parameter können unter [http://www.tinymce.com/wiki.php/configuration http://www.tinymce.com] eingesehen werden.

<div class="note">
Folgende Plugins werden standardmäßig geladen, wobei zu beachten ist, dass das <code>iesLink</code>-Plugin die Aufgabe des <code>link</code>-Plugins übernimmt.
<source lang="javascript">
fullscreen, charmap, paste, table, contextmenu, abbr, iesLink, lang
</source>
</div>

==Konfigurationserweiterung Ablauf==

Die Konfigurationsauswertung findet wie folgt statt:

<blockquote>
Das aktive Configset wird auf das Theme gesetzt.<br/>
Wenn eine Konfiguration angegeben wurde wird das bisher gesetzte Configset mit dem eingebunden Configset überschrieben <code>(tag.spt.tinymce.config.${config})</code><br/><br/>

Wenn eine Konfigurationserweiterung angegeben wurde, wird das bisher gesetzte Configset durch das angegebene erweitert <code>(tag.spt.tinymce.configextension.${configextension})</code>.<br/>
Wenn keine Konfigurationserweiterung angegeben wurde, wird das bisher gesetzte Configset durch die Mandanten-Erweiterung erweitert <code>(tag.spt.tinymce.configextension)</code>.<br/><br/>

Wenn Configvalues angegeben wurden wird das bisher gesetzte Configset durch die übergebenen Optionen erweitert.
</blockquote>

===Standard Konfiguration pro Mandant ersetzen===
<div class="note">''Zu Beachten ist das ein überschreiben der globalen TinyMCE-Konfiguration (innerhalb des Mandanten) alle voreingestellten Setzungen wie die Einbindung eines angepassten CSS, die Auflistung aller zu verwendenden HTML-Elemente, etc. nicht mehr verwendet werden. Es sollte geprüft werden, ob es ausreicht die Standardkonfiguration zu ergänzen (siehe untern)''</div>

Es ist möglich die Standard-Konfiguration für den TinyMCE pro Mandant durch eine eigene Konfiguration zu ersetzen. Hierzu muß ein Template mit dem Anchor
tag.spt.tinymce.config
angelegt werden, in dem die Konfiguration hinterlegt ist. Existiert ein Template mit dem angegebenen Anchor, wird automatisch diese Konfiguration verwendet ohne das im <code><spt:tinymce></code>-Tag noch Änderungen vorgenommen werden müssten.

===Zusätzliche Konfigurationen pro Mandant definieren===
<div class="note">''Zu Beachten ist das bei der Verwendung einer eigenen Konfiguration alle voreingestellten Standard-Setzungen wie die Einbindung eines angepassten CSS, die Auflistung aller zu verwendenden HTML-Elemente, etc. nicht mehr verwendet werden. Es sollte geprüft werden, ob es ausreicht die Standardkonfiguration zu ergänzen (siehe untern)''</div>

Parallel zu der Standard-Konfiguration können weiter Konfigurationen pro Mandante definiert werden. Hierzu können Templates mit dem Anchor
tag.spt.tinymce.config.<configname>
angelegt werden, wobei mit <code><configname></code> ein beliegeber Name (Anchorkonform) vergeben werden kann. Um die Konfiguration zu verwenden muß im <code><spt:tinymce></code>-Tag mit dem Attribut <code>config</code> der <code><configname></code> der Konfiguration angegeben werden, die verwendet werden soll.

===Standard Konfigurations-Ergänzungen pro Mandant definieren===
Es ist möglich die Standard-Konfiguration für den TinyMCE pro Mandant mit eine eigene Konfiguration zu ergänzen. Hierzu muß ein Template mit dem Anchor
tag.spt.tinymce.configextension
angelegt werden, in dem die Konfiguration hinterlegt ist. Existiert ein Template mit dem angegebenen Anchor, wird automatisch diese Konfiguration verwendet ohne das im <code><spt:tinymce></code>-Tag noch Änderungen vorgenommen werden müssten.

===Zusätzliche Konfigurations-Ergänzungen pro Mandant definieren===

Parallel zu den Standard-Konfigurations-Ergänzungen können weiter Ergänzungen pro Mandante definiert werden. Hierzu können Templates mit dem Anchor
tag.spt.tinymce.configextension.<configextensionname>
angelegt werden, wobei mit <code><configextensionname></code> ein beliegeber Name (Anchorkonform) vergeben werden kann. Um die Konfiguration zu verwenden muß im <code><spt:tinymce></code>-Tag mit dem Attribut <code>configextension</code> der <code><configextensionname></code> der Konfiguration angegeben werden, die verwendet werden soll.

===Konfiguration in Tag-Attribut===
Mit dem Attribut <code>configvalues</code> können Konfigurationsparameter direkt angegeben werden. Diese Parameter werden mit JSON ohne umschließende geschweifte Klammern {} angegeben.
<source lang="xml">
<sp:set name="_tinyconfig">
param1 : "a",
param2 : false
</sp:set>
<spt:tinymce ... configvalues="${_tinyconfig}" ... />
</source>

==Mit dem <code>spt:tinymce</code> erzeugte Texte ausgeben (ab Version 2.0.3)==
Durch TinyMCE-Plugins des IES ist eine Nachbearbeitung des erzeugten Textes notwendig. Der Text sollte vor der Ausgabe den Tag [[spt:prehtml]] durchlaufen. Nur so ist sichergestellt, dass z.B. interne Links, die über den Editor eingetragen wurden, auch richtig ausgegeben werden.

Beispiel
<source lang="xml">
<sp:io type="in">
<spt:tinymce name="sp_body"/>
</sp:io>

<sp:io type="out">
<spt:prehtml name="processed_body" object="sp_body"/><sp:print name="processed_body"/>
</sp:io>
</source>

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
{{sp_input_attributes|attribute=name|mode=row}}
|-
{{sp_input_attributes|attribute=value|mode=row}}
|-
{{sp_input_attributes|attribute=fixvalue|mode=row}}
|-
{{sp_input_attributes|attribute=type|mode=row}}
|-
{{sp_input_attributes|attribute=disabled|mode=row}}
|-
{{sp_input_attributes|attribute=readonly|mode=row}}
|-
| <code>rows</code>
| [[Number]]
| Nein
| 15
| 1
|-
| <code>cols</code>
| [[Number]]
| Nein
| 80
| 1
|-
| <code>theme</code>
| [[Text]]
| Nein
| advanced
| 1
|-
| <code>pools</code>
| [[Anchor]]-List oder [[ID]]-List
| Nein
| aktueller Informationspool
| 1
|-
| <code>config</code>
| [[Text]]
| Nein
|
| 2.0.3
|-
| <code>configextension</code>
| [[Text]]
| Nein
|
| 2.0.3
|-
| <code>configvalues</code>
| [[Condition]] Oder [[Text]]
| Nein
| true
| 2.0.3
|-
{{sp_input_attributes|attribute=dynamics|mode=row}}
|}
{{sp_input_attributes|attribute=name|mode=desc}}
{{sp_input_attributes|attribute=value|mode=desc}}
{{sp_input_attributes|attribute=fixvalue|mode=desc}}
{{sp_input_attributes|attribute=locale|mode=desc}}
{{sp_input_attributes|attribute=type|mode=desc}}
{{sp_input_attributes|attribute=disabled|mode=desc}}
{{sp_input_attributes|attribute=readonly|mode=desc}}
;<code>rows</code>
:Höhe des Eingabefeldes in Zeilen.

;<code>cols</code>
:Breite des Eingabefeldes in Spalten.

;<code>theme</code>
:Konfigurationstypen, die den Funktionsumfang für den Editor beschreiben. Mögliche Themes sind:
:;simple
:;advanced

;<code>pools</code>
:Kommaseparierte Liste von [[Anchor|Anchors]] von Artikelpools oder von [[ID|IDs]] von Artikelpools; die Elemente der Pools werden dem Redakteur in einem Linkdialog innerhalb des Editors zur Auswahl angeboten. Voraussetzung, dass der interne Linkdialog überhaupt angezeigt wird, ist die Konfiguration des Editors mit iesLink über theme_advanced_buttons in der [http://wiki.moxiecode.com/index.php/TinyMCE:Configuration TinyMCE:Configuration]. Ausgabeseitig muss man darauf achten, dass ein interner Link vor der Ausgabe mit [[spt:id2url]] umgewandelt wird.

;<code>config</code>
:Mit diesem Attribut wird der Name einer Konfiguration angegeben. Die in dieser Konfiguration angegebenen Konfigurationsparameter überschreiben die IES-Standardkonfiguration. Die Angaben werden in JSON angegeben, wobei die umschließenden geschweiften Klammern {} nicht mit angegeben werden dürfen. Die möglichen Konfigurationsparameter sind unter [http://wiki.moxiecode.com/index.php/TinyMCE:Configuration TinyMCE:Configuration] aufgelistet.

;<code>configextension</code>
:Mit diesem Attribut wird der Name einer Konfigurations-Ergänzung angegeben. Die in dieser Ergänzung angegebenen Konfigurationsparameter ergänzen und überschreiben die Parameter der IES-Standardkonfiguration. Die Angaben werden in JSON angegeben, wobei die umschließenden geschweiften Klammern {} nicht mit angegeben werden dürfen. Die möglichen Konfigurationsparameter sind unter [http://wiki.moxiecode.com/index.php/TinyMCE:Configuration TinyMCE:Configuration] aufgelistet.

;<code>configvalues</code>
:Mit diesem Attribut können TinyMCE Konfigurationen angegeben werden. Die Konfigurationsparameter ergänzen und überschreiben die Parameter der IES-Standardkonfiguration. Die Angaben werden in JSON angegeben, wobei die umschließenden geschweiften Klammern {} nicht mit angegeben werden dürfen. Die möglichen Konfigurationsparameter sind unter [http://wiki.moxiecode.com/index.php/TinyMCE:Configuration TinyMCE:Configuration] aufgelistet.
{{sp_input_attributes|attribute=dynamics|mode=desc}}

==Beispiele==

===WYSIWYG-Editor nutzen und Inhalt ausgeben===

Template Quelltext
<source lang="xml">
<sp:io type="in">
<spt:tinymce name="sp_body"/>
</sp:io>

<sp:io type="out">
<spt:prehtml name="processed_body" object="sp_body"/><sp:print name="processed_body"/>
</sp:io>
</source>

=== Barrierefreie Datentabellen ===
<p>In der Tabellendarstellung haben wir Sehende es einfacher komplexe Strukturen zu erkennen.<br /> Wir können in der Spalte kurz nach oben schauen, um uns zu vergewissern zu welcher Kopfinformation der Zelleninhalt gehört. Für Screenreader ist hier unbedingt eine eindeutige Zuordnung nötig.</p>
<p>Die Web Content Accessibility Guidelines fordert in den Guidelines 2.0 von einer HTML Tabelle</p>
<ol>
<li>Ein Caption-Element welches eine kurze Überschrift der Tabelle bereitstellt [http://www.w3.org/TR/WCAG20-TECHS/H39 (H39)] [http://www.w3.org/TR/WCAG20/#content-structure-separation-programmatic (Level A)]</li>
<li>Eine Trennung des Überschrifts- und Inhaltsbereichs der Tabelle mit dem thead-, und tbody-Element [http://www.w3.org/TR/WCAG20-TECHS/H51 (H51)] [http://www.w3.org/TR/WCAG20/#content-structure-separation-programmatic (Level A)]</li>
<li>In dem Überschriftsbereich sollen die th-Elemente mit dem Attribut scope=“col“ eine Verknüpfung zu einer Spalte haben [http://www.w3.org/TR/WCAG20-TECHS/H63 (H63)] [http://www.w3.org/TR/WCAG20/#content-structure-separation-programmatic (Level A)]. Wenn Datenzellen mehr als einer Zeilen- und/oder Spaltenüberschrift zugeordnet sind werden die Zellen mit ID- und header-Attribut miteinander verknüpft [http://www.w3.org/TR/WCAG20-TECHS/H43 (H43)] [http://www.w3.org/TR/WCAG20/#content-structure-separation-programmatic (Level A)]</li>
<li>Falls vorgesehen sollten td-Elemente mit dem Attribut scope=“row“ Zeilenheaderzellen definieren [http://www.w3.org/TR/WCAG20-TECHS/H63 (H63)] [http://www.w3.org/TR/WCAG20-TECHS/H43 (H43)] [http://www.w3.org/TR/WCAG20/#content-structure-separation-programmatic (Level A)]</li>
</ol>
<br>
=====Wie erstelle ich eine Tabelle=====
<p>
<ol>
<li>
<div class="notice">Öffnen Sie die Tabellenkonfiguration über den Schalter in der Toolbar und wählen Sie aus wie viele Spalten/Zeilen Sie benötigen.</div><br/>
[[Datei:tiny-table-tutorial-step-1.png|alt=Barrierefreie Tabellen erstellen Schritt 1|Barrierefreie Tabellen erstellen Schritt 1]]<br/><br/>
</li>

<li>
<div class="notice">Öffnen Sie die Tabelleneigenschaften.</div><br/>
[[Datei:tiny-table-tutorial-step-2.png|alt=Barrierefreie Tabellen erstellen Schritt 2|Barrierefreie Tabellen erstellen Schritt 2]]<br/><br/>
</li>

<li>
<div class="notice">Hier kann die Option zur Eingabe einer Caption aktiviert werden.</div><br/>
[[Datei:tiny-table-tutorial-step-3.png|alt=Barrierefreie Tabellen erstellen Schritt 3|Barrierefreie Tabellen erstellen Schritt 3]]<br/><br/>
</li>

<li>
<div class="notice">Nun erscheint oberhalb der Tabelle ein neues Feld zur Eingabe der Caption</div><br/>
[[Datei:tiny-table-tutorial-step-4.png|alt=Barrierefreie Tabellen erstellen Schritt 4|Barrierefreie Tabellen erstellen Schritt 4]]<br/><br/>
</li>

<li>
<div class="notice">Füllen Sie die weiter Tabelle mit Inhalten</div><br/>
[[Datei:tiny-table-tutorial-step-5.png|alt=Barrierefreie Tabellen erstellen Schritt 5|Barrierefreie Tabellen erstellen Schritt 5]]<br/><br/>
</li>

<li>
<div class="notice">Um die obere Zeile als Spaltenbeschreibung zu deklarieren, markieren Sie die Zeile und öffnen die Zelleneigenschaften</div><br/>
[[Datei:tiny-table-tutorial-step-6.png|alt=Barrierefreie Tabellen erstellen Schritt 6|Barrierefreie Tabellen erstellen Schritt 6]]<br/><br/>
</li>

<li>
<div class="notice">Ändern Sie den Zellentyp auf Kopfzeile</div><br/>
[[Datei:tiny-table-tutorial-step-7.png|alt=Barrierefreie Tabellen erstellen Schritt 7|Barrierefreie Tabellen erstellen Schritt 7]]<br/><br/>
</li>

<li>
<div class="notice">Um anzugeben, dass es sich bei den markierten Feldern um Spaltenüberschriften handelt, müssen Sie den Gültigkeitsbereich auf Spalte ändern</div><br/>
[[Datei:tiny-table-tutorial-step-8.png|alt=Barrierefreie Tabellen erstellen Schritt 8|Barrierefreie Tabellen erstellen Schritt 8]]<br/><br/>
</li>

<li>
<div class="notice">Gehen Sie bei Zeilenüberschriften genauso vor</div><br/>
[[Datei:tiny-table-tutorial-step-9.png|alt=Barrierefreie Tabellen erstellen Schritt 9|Barrierefreie Tabellen erstellen Schritt 9]]
[[Datei:tiny-table-tutorial-step-10.png|alt=Barrierefreie Tabellen erstellen Schritt 10|Barrierefreie Tabellen erstellen Schritt 10]]<br/><br/>
</li>

<li>
<div class="notice">An stelle von "Spalte" geben wir hier als Gültigkeitsbereich "Zeile" an, da es sich um zeilenweise Überschriften handelt</div><br/>
[[Datei:tiny-table-tutorial-step-11.png|alt=Barrierefreie Tabellen erstellen Schritt 11|Barrierefreie Tabellen erstellen Schritt 11]]<br/><br/>
</li>

<li>
<div class="notice">Die fertige Ausgabe auf der Website kann dann z.B. so aussehen:</div><br/>
[[Datei:tiny-table-tutorial-step-12.png|alt=Barrierefreie Tabellen erstellen Schritt 12|Barrierefreie Tabellen erstellen Schritt 12]]
<br/><br/>
</li>
</ol>
</p>

===== Was schreibt der TinyMCE nun auf die Webseite? =====
<p>So sieht der HTML Code mit unseren Zusatzinformationen und Änderungen aus:<br />
<source lang="xml">
<table>
<caption>Gruppe G</caption>
<tbody>
<tr>
<th scope="col">Land</th>
<th scope="col">Punkte</th>
<th scope="col">Tore</th>
<th scope="col">Tordifferenz</th>
<th scope="col">Siege</th>
</tr>
<tr>
<th scope="row">Deutschland</th>
<td>3</td>
<td>4</td>
<td>4</td>
<td>1</td>
</tr>
<tr>
<th scope="row">USA</th>
<td>3</td>
<td>2</td>
<td>1</td>
<td>1</td>
</tr>
<tr>
<th scope="row">Ghana</th>
<td>0</td>
<td>1</td>
<td>-1</td>
<td>0</td>
</tr>
<tr>
<th scope="row">Portugal</th>
<td>0</td>
<td>0</td>
<td>-4</td>
<td>0</td>
</tr>
</tbody>
</table>
</source>
</p>

<noinclude>
[[Category:SPT-Tags]]
</noinclude>

Allgemeine Funktionen

2016-03-09T13:59:10Z

Schleuse: /* Beispiele */

==Beschreibung==
Allgemeine Funktionen sind Funktionen die sich nicht auf bestimmte Objekte beziehen und allgemein anwendbar sind

==Funktionen==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Methode || Rückgabewert || Beschreibung || ab IES Version
|-
| <code>isNull([[Object]] object)</code>
| [[Boolean]]
| Liefert <code>true</code>, wenn das Objekt nicht existiert eine leere Zeichenkette oder ein leeres Artikelfeld ist. Die Abfrage, ob ein Objekt NICHT existiert kann durch ein vorangestellte "!" erreicht werden.
| 1
|-
| <code>isNumber([[Object]] object)</code>
| [[Boolean]]
| Liefert <code>true</code>, wenn das Objekt ein numerischer Wert ist. Die Abfrage, ob ein Objekt KEINE Zahl ist, kann durch ein vorangestellte "!" erreicht werden.
| 1
|-
| <code>evalText([[Text]] text)</code>
| [[String]]
| Evaluiert den Text und liefert das Ergebnis zurück.
| 1
|-
| <code>evalExpression([[Expression]] expression)</code>
| [[Number]]
| Evaluiert den Ausdruck und liefert das Ergebnis zurück.
| 1
|-
| <code>evalCondition([[Condition]] condition)</code>
| [[Boolean]]
| Evaluiert den Ausdruck und liefert das Ergebnis zurück.
| 1
|-
| <code>randomUUID()</code>
| [[String]]
| Erzeugt eine UUID
| 2.12
|-
| <code>coalesce([[Object]] object, [...])</code>
| [[Object]]
| Gibt das erste Object zurück welches nicht zu <code>null</code> oder Leerstring evaluiert werden kann
| 2.14.1
|}

==Beispiele==

===IsNull im Verbindung mit sp:if===

Template Quelltext
<source lang="xml">
<sp:set name="my_value_1" value="hello world"/>
<sp:set name="my_value_2" value=""/>

<sp:if condition="!isNull(${my_value_1})">
my_value_1 = <sp:print name="my_value_1"/>
</sp:if>
<sp:if condition="isNull(${my_value_2})">
my_value_2 = isNull
</sp:if>
</source>

Ausgabe
<source lang="text">
my_valaue_1 = hello world
my_valaue_2 = isNull
</source>

===IsNumber im Verbindung mit sp:if===

Template Quelltext
<source lang="xml">
<sp:set name="my_int_1" value="123"/>
<sp:set name="my_int_2" value="hello world"/>

<sp:if condition="isNumber(${my_int_1})">
my_int_1 = <sp:print name="my_int_1"/>
</sp:if>
<sp:if condition="!isNumber(${my_int_2})">
my_int_2 = is not a number
</sp:if>
</source>

Ausgabe
<source lang="text">
my_int_1 = 123
my_int_2 = is not a number
</source>

===coalesce===
Template Quelltext
<source lang="xml">

<sp:set name="foobar" value="">
<sp:set name="foo" value="123" />
<sp:map name="frequencies" action="put" key="C" object="system.template"/>

"<sp:print name="coalesce(${!{gui.informations}}, ${barfoo}, ${frequencies.C}, 'teststring', 456)" />" = "100010100000001010-2000" [!{gui.informations}]
"<sp:print name="coalesce(${!{existiert.nicht}}, ${barfoo}, ${frequencies.C}, 'teststring', 456)" />" = "100010100000002098-6000" [system.template]
"<sp:print name="coalesce(${!{existiert.nicht}}, ${barfoo}, ${frequencies.D}, 'teststring', 456)" />" = "teststring"
"<sp:print name="coalesce(${!{existiert.nicht}}, ${barfoo}, ${frequencies.D}, ' ', 'teststring', 456)" />" = " "
</source>

<noinclude>
[[Category:Funktionen]]
</noinclude>

Allgemeine Funktionen

2016-03-09T13:55:30Z

Schleuse: /* Funktionen */

Tinymce (SPT-Tag)

2015-11-30T12:13:59Z

Schleuse: /* Konfigurationserweiterung */

==Name==
<spt:tinymce> - Integriert einen Editor

==Syntax==
<source lang="xml">
<spt:tinymce name="variable" theme="simple"/>
</source>

==Beschreibung==
Mit dem tinymce-Tag wird ein externer WYSIWYG-Editor ins CMS eingebunden. "<b>W</b>hat <b>Y</b>ou <b>S</b>ee <b>I</b>s <b>W</b>hat <b>Y</b>ou <b>G</b>et" steht für eine Übernahme eines geschriebenen Textes auf der Website, so wie ihn der Redakteur bei der Eingabe sieht. Auf diese Weise kann der Redakteur z.B. Tabellen oder Formatierungen in seine Artikel einbinden ohne über HTML-Kenntnisse zu verfügen. Die Ausgabe hängt aber nicht nur vom Editor, sondern auch von den Einstellungen des Browsers und den installierten Systemschriften ab.

Der Editor TinyMCE ist ein Open-Source Produkt der Firma [http://tinymce.moxiecode.com Moxiecode] und kann im Rahmen des CMS "so wie er ist" genutzt werden. TinyMCE ist kein Produkt der Sitepark GmbH und wird daher nicht von unserem Support betreut. Fehler-Meldungen und Erweiterungswünsche werden von Sitepark an den Hersteller weitergeleitet.

==Themes==
Über die Theme-Option lässt sich aus aktuell 2 vordefinierten Konfiguration wählen:

*simple
[[Datei:tiny-theme-simple.png]]
*advanced
[[Datei:tiny-theme-advanced.png]]

==Konfigurationserweiterung==
Sollten die vordefinieren Themes den Anforderungen nicht entsprechen lässt sich der <code><spt:tinymce /></code> über unterschiedliche Mechanismen erweitern/überschreiben.

; Konfiguration mandantenweit ergänzen''(nicht empfohlen)''
: Hier wird die Standard-Konfiguration durch eine eigene ergänzt. Alle <code><spt:tinymce></code>-Tags die nicht das Attribut <code>config</code> verwenden, sind von dieser Anpassung betroffen. Die Anpassungen werden in einem Template mit dem Anker <code>tag.spt.tinymce.configextension</code> vorgenommen

; Konfiguration per Konfigurationserweiterungen überschreiben ''(nicht empfohlen)''
: Hier wird die Standard-Konfiguration durch eine eigene vordefinierte Konfiguration vollständig ersetzt. Die Konfigurationen werden in einem Template mit dem Anker <code>tag.spt.tinymce.config.${configname}</code> implementiert, wobei <code>${configname}</code> einen Platzhalter für den Namen der Konfiguration bildet. Der Name wird dem <code><spt:tinymce/></code>-Tag über das Attribut <code>config</code> übergeben.

; Konfiguration per Konfigurationserweiterungen erweitern
: Hier wird die Standard-Konfiguration durch eine eigene vordefinierte Konfiguration ergänzt. Die Ergänzungen werden in einem Template mit dem Anker <code>tag.spt.tinymce.configextension.${configextensionname}</code> implementiert, wobei <code>${configextensionname}</code> einen Platzhalter für den Namen der Konfigurationserweiterung bildet. Der Name wird dem <code><spt:tinymce/></code>-Tag über das Attribut <code>configextension</code> übergeben.

; Zusätzliche Konfiguration als Tag-Attribut
: Hier wird eine Konfigurationserweiterung über das Attribute <code>configvalues</code> inline an das <code><spt:tinymce/></code> übergeben.

==Konfigurationsoptionen==
Die Konfiguration des TinyMCE besteht aus verschiedenen Konfigurations-Parametern, die mit [http://de.wikipedia.org/wiki/JavaScript_Object_Notation JSON] ohne umschließende geschweifte Klammern {} angegeben werden müssen.

Beispiel für TinyMCE-Konfiguration
<source lang="javascript">
toolbar: [
"pastetext | undo redo | bold italic | subscript superscript | indent outdent | bullist numlist | iesLink | charmap | abbr | table | removeformat"
],
statusbar: false,
object_resizing: false,
menu : {
file : {title : 'File' , items : 'newdocument'},
edit : {title : 'Edit' , items : 'undo redo | cut copy paste pastetext | selectall'},
insert : {title : 'Insert', items : 'link media | template hr'},
view : {title : 'View' , items : 'visualaid'},
format : {title : 'Format', items : 'bold italic underline strikethrough superscript subscript | formats | removeformat'},
table : {title : 'Table' , items : 'inserttable tableprops deletetable | cell row column'},
tools : {title : 'Tools' , items : 'spellchecker code'}
}
</source>

<div class="note">
Es ist zu beachten, das hinter dem letzten Parameter kein Komma stehen darf.
</div>

Alle für den TinyMCE verfügbaren Parameter können unter [http://www.tinymce.com/wiki.php/configuration http://www.tinymce.com] eingesehen werden.

<div class="note">
Folgende Plugins werden standardmäßig geladen, wobei zu beachten ist, dass das <code>iesLink</code>-Plugin die Aufgabe des <code>link</code>-Plugins übernimmt.
<source lang="javascript">
fullscreen, charmap, paste, table, contextmenu, abbr, iesLink, lang
</source>
</div>

==Konfigurationserweiterung Ablauf==

Die Konfigurationsauswertung findet wie folgt statt:

<blockquote>
Das aktive Configset wird auf das Theme gesetzt.<br/>
Wenn eine Konfiguration angegeben wurde wird das bisher gesetzte Configset mit dem eingebunden Configset überschrieben <code>(tag.spt.tinymce.config.${config})</code><br/><br/>

Wenn eine Konfigurationserweiterung angegeben wurde, wird das bisher gesetzte Configset durch das angegebene erweitert <code>(tag.spt.tinymce.configextension.${configextension})</code>.<br/>
Wenn keine Konfigurationserweiterung angegeben wurde, wird das bisher gesetzte Configset durch die Mandanten-Erweiterung erweitert <code>(tag.spt.tinymce.configextension)</code>.<br/><br/>

Wenn Configvalues angegeben wurden wird das bisher gesetzte Configset durch die übergebenen Optionen erweitert.
</blockquote>

===Standard Konfiguration pro Mandant ersetzen===
<div class="note">''Zu Beachten ist das ein überschreiben der globalen TinyMCE-Konfiguration (innerhalb des Mandanten) alle voreingestellten Setzungen wie die Einbindung eines angepassten CSS, die Auflistung aller zu verwendenden HTML-Elemente, etc. nicht mehr verwendet werden. Es sollte geprüft werden, ob es ausreicht die Standardkonfiguration zu ergänzen (siehe untern)''</div>

Es ist möglich die Standard-Konfiguration für den TinyMCE pro Mandant durch eine eigene Konfiguration zu ersetzen. Hierzu muß ein Template mit dem Anchor
tag.spt.tinymce.config
angelegt werden, in dem die Konfiguration hinterlegt ist. Existiert ein Template mit dem angegebenen Anchor, wird automatisch diese Konfiguration verwendet ohne das im <code><spt:tinymce></code>-Tag noch Änderungen vorgenommen werden müssten.

===Zusätzliche Konfigurationen pro Mandant definieren===
<div class="note">''Zu Beachten ist das bei der Verwendung einer eigenen Konfiguration alle voreingestellten Standard-Setzungen wie die Einbindung eines angepassten CSS, die Auflistung aller zu verwendenden HTML-Elemente, etc. nicht mehr verwendet werden. Es sollte geprüft werden, ob es ausreicht die Standardkonfiguration zu ergänzen (siehe untern)''</div>

Parallel zu der Standard-Konfiguration können weiter Konfigurationen pro Mandante definiert werden. Hierzu können Templates mit dem Anchor
tag.spt.tinymce.config.<configname>
angelegt werden, wobei mit <code><configname></code> ein beliegeber Name (Anchorkonform) vergeben werden kann. Um die Konfiguration zu verwenden muß im <code><spt:tinymce></code>-Tag mit dem Attribut <code>config</code> der <code><configname></code> der Konfiguration angegeben werden, die verwendet werden soll.

===Standard Konfigurations-Ergänzungen pro Mandant definieren===
Es ist möglich die Standard-Konfiguration für den TinyMCE pro Mandant mit eine eigene Konfiguration zu ergänzen. Hierzu muß ein Template mit dem Anchor
tag.spt.tinymce.configextension
angelegt werden, in dem die Konfiguration hinterlegt ist. Existiert ein Template mit dem angegebenen Anchor, wird automatisch diese Konfiguration verwendet ohne das im <code><spt:tinymce></code>-Tag noch Änderungen vorgenommen werden müssten.

===Zusätzliche Konfigurations-Ergänzungen pro Mandant definieren===

Parallel zu den Standard-Konfigurations-Ergänzungen können weiter Ergänzungen pro Mandante definiert werden. Hierzu können Templates mit dem Anchor
tag.spt.tinymce.configextension.<configextensionname>
angelegt werden, wobei mit <code><configextensionname></code> ein beliegeber Name (Anchorkonform) vergeben werden kann. Um die Konfiguration zu verwenden muß im <code><spt:tinymce></code>-Tag mit dem Attribut <code>configextension</code> der <code><configextensionname></code> der Konfiguration angegeben werden, die verwendet werden soll.

===Konfiguration in Tag-Attribut===
Mit dem Attribut <code>configvalues</code> können Konfigurationsparameter direkt angegeben werden. Diese Parameter werden mit JSON ohne umschließende geschweifte Klammern {} angegeben.
<source lang="xml">
<sp:set name="_tinyconfig">
param1 : "a",
param2 : false
</sp:set>
<spt:tinymce ... configvalues="${_tinyconfig}" ... />
</source>

==Mit dem <code>spt:tinymce</code> erzeugte Texte ausgeben (ab Version 2.0.3)==
Durch TinyMCE-Plugins des IES ist eine Nachbearbeitung des erzeugten Textes notwendig. Der Text sollte vor der Ausgabe den Tag [[spt:prehtml]] durchlaufen. Nur so ist sichergestellt, dass z.B. interne Links, die über den Editor eingetragen wurden, auch richtig ausgegeben werden.

Beispiel
<source lang="xml">
<sp:io type="in">
<spt:tinymce name="sp_body"/>
</sp:io>

<sp:io type="out">
<spt:prehtml name="processed_body" object="sp_body"/><sp:print name="processed_body"/>
</sp:io>
</source>

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
{{sp_input_attributes|attribute=name|mode=row}}
|-
{{sp_input_attributes|attribute=value|mode=row}}
|-
{{sp_input_attributes|attribute=fixvalue|mode=row}}
|-
{{sp_input_attributes|attribute=type|mode=row}}
|-
{{sp_input_attributes|attribute=disabled|mode=row}}
|-
{{sp_input_attributes|attribute=readonly|mode=row}}
|-
| <code>rows</code>
| [[Number]]
| Nein
| 15
| 1
|-
| <code>cols</code>
| [[Number]]
| Nein
| 80
| 1
|-
| <code>theme</code>
| [[Text]]
| Nein
| advanced
| 1
|-
| <code>pools</code>
| [[Anchor]]-List oder [[ID]]-List
| Nein
| aktueller Informationspool
| 1
|-
| <code>config</code>
| [[Text]]
| Nein
|
| 2.0.3
|-
| <code>configextension</code>
| [[Text]]
| Nein
|
| 2.0.3
|-
| <code>configvalues</code>
| [[Text]]
| Nein
|
| 2.0.3
|-
{{sp_input_attributes|attribute=dynamics|mode=row}}
|}
{{sp_input_attributes|attribute=name|mode=desc}}
{{sp_input_attributes|attribute=value|mode=desc}}
{{sp_input_attributes|attribute=fixvalue|mode=desc}}
{{sp_input_attributes|attribute=locale|mode=desc}}
{{sp_input_attributes|attribute=type|mode=desc}}
{{sp_input_attributes|attribute=disabled|mode=desc}}
{{sp_input_attributes|attribute=readonly|mode=desc}}
;<code>rows</code>
:Höhe des Eingabefeldes in Zeilen.

;<code>cols</code>
:Breite des Eingabefeldes in Spalten.

;<code>theme</code>
:Konfigurationstypen, die den Funktionsumfang für den Editor beschreiben. Mögliche Themes sind:
:;simple
:;advanced

;<code>pools</code>
:Kommaseparierte Liste von [[Anchor|Anchors]] von Artikelpools oder von [[ID|IDs]] von Artikelpools; die Elemente der Pools werden dem Redakteur in einem Linkdialog innerhalb des Editors zur Auswahl angeboten. Voraussetzung, dass der interne Linkdialog überhaupt angezeigt wird, ist die Konfiguration des Editors mit iesLink über theme_advanced_buttons in der [http://wiki.moxiecode.com/index.php/TinyMCE:Configuration TinyMCE:Configuration]. Ausgabeseitig muss man darauf achten, dass ein interner Link vor der Ausgabe mit [[spt:id2url]] umgewandelt wird.

;<code>config</code>
:Mit diesem Attribut wird der Name einer Konfiguration angegeben. Die in dieser Konfiguration angegebenen Konfigurationsparameter überschreiben die IES-Standardkonfiguration. Die Angaben werden in JSON angegeben, wobei die umschließenden geschweiften Klammern {} nicht mit angegeben werden dürfen. Die möglichen Konfigurationsparameter sind unter [http://wiki.moxiecode.com/index.php/TinyMCE:Configuration TinyMCE:Configuration] aufgelistet.

;<code>configextension</code>
:Mit diesem Attribut wird der Name einer Konfigurations-Ergänzung angegeben. Die in dieser Ergänzung angegebenen Konfigurationsparameter ergänzen und überschreiben die Parameter der IES-Standardkonfiguration. Die Angaben werden in JSON angegeben, wobei die umschließenden geschweiften Klammern {} nicht mit angegeben werden dürfen. Die möglichen Konfigurationsparameter sind unter [http://wiki.moxiecode.com/index.php/TinyMCE:Configuration TinyMCE:Configuration] aufgelistet.

;<code>configvalues</code>
:Mit diesem Attribut können TinyMCE Konfigurationen angegeben werden. Die Konfigurationsparameter ergänzen und überschreiben die Parameter der IES-Standardkonfiguration. Die Angaben werden in JSON angegeben, wobei die umschließenden geschweiften Klammern {} nicht mit angegeben werden dürfen. Die möglichen Konfigurationsparameter sind unter [http://wiki.moxiecode.com/index.php/TinyMCE:Configuration TinyMCE:Configuration] aufgelistet.
{{sp_input_attributes|attribute=dynamics|mode=desc}}

==Beispiele==

===WYSIWYG-Editor nutzen und Inhalt ausgeben===

Template Quelltext
<source lang="xml">
<sp:io type="in">
<spt:tinymce name="sp_body"/>
</sp:io>

<sp:io type="out">
<spt:prehtml name="processed_body" object="sp_body"/><sp:print name="processed_body"/>
</sp:io>
</source>

=== Barrierefreie Datentabellen ===
<p>In der Tabellendarstellung haben wir Sehende es einfacher komplexe Strukturen zu erkennen.<br /> Wir können in der Spalte kurz nach oben schauen, um uns zu vergewissern zu welcher Kopfinformation der Zelleninhalt gehört. Für Screenreader ist hier unbedingt eine eindeutige Zuordnung nötig.</p>
<p>Die Web Content Accessibility Guidelines fordert in den Guidelines 2.0 von einer HTML Tabelle</p>
<ol>
<li>Ein Caption-Element welches eine kurze Überschrift der Tabelle bereitstellt [http://www.w3.org/TR/WCAG20-TECHS/H39 (H39)] [http://www.w3.org/TR/WCAG20/#content-structure-separation-programmatic (Level A)]</li>
<li>Eine Trennung des Überschrifts- und Inhaltsbereichs der Tabelle mit dem thead-, und tbody-Element [http://www.w3.org/TR/WCAG20-TECHS/H51 (H51)] [http://www.w3.org/TR/WCAG20/#content-structure-separation-programmatic (Level A)]</li>
<li>In dem Überschriftsbereich sollen die th-Elemente mit dem Attribut scope=“col“ eine Verknüpfung zu einer Spalte haben [http://www.w3.org/TR/WCAG20-TECHS/H63 (H63)] [http://www.w3.org/TR/WCAG20/#content-structure-separation-programmatic (Level A)]. Wenn Datenzellen mehr als einer Zeilen- und/oder Spaltenüberschrift zugeordnet sind werden die Zellen mit ID- und header-Attribut miteinander verknüpft [http://www.w3.org/TR/WCAG20-TECHS/H43 (H43)] [http://www.w3.org/TR/WCAG20/#content-structure-separation-programmatic (Level A)]</li>
<li>Falls vorgesehen sollten td-Elemente mit dem Attribut scope=“row“ Zeilenheaderzellen definieren [http://www.w3.org/TR/WCAG20-TECHS/H63 (H63)] [http://www.w3.org/TR/WCAG20-TECHS/H43 (H43)] [http://www.w3.org/TR/WCAG20/#content-structure-separation-programmatic (Level A)]</li>
</ol>
<br>
=====Wie erstelle ich eine Tabelle=====
<p>
<ol>
<li>
<div class="notice">Öffnen Sie die Tabellenkonfiguration über den Schalter in der Toolbar und wählen Sie aus wie viele Spalten/Zeilen Sie benötigen.</div><br/>
[[Datei:tiny-table-tutorial-step-1.png|alt=Barrierefreie Tabellen erstellen Schritt 1|Barrierefreie Tabellen erstellen Schritt 1]]<br/><br/>
</li>

<li>
<div class="notice">Öffnen Sie die Tabelleneigenschaften.</div><br/>
[[Datei:tiny-table-tutorial-step-2.png|alt=Barrierefreie Tabellen erstellen Schritt 2|Barrierefreie Tabellen erstellen Schritt 2]]<br/><br/>
</li>

<li>
<div class="notice">Hier kann die Option zur Eingabe einer Caption aktiviert werden.</div><br/>
[[Datei:tiny-table-tutorial-step-3.png|alt=Barrierefreie Tabellen erstellen Schritt 3|Barrierefreie Tabellen erstellen Schritt 3]]<br/><br/>
</li>

<li>
<div class="notice">Nun erscheint oberhalb der Tabelle ein neues Feld zur Eingabe der Caption</div><br/>
[[Datei:tiny-table-tutorial-step-4.png|alt=Barrierefreie Tabellen erstellen Schritt 4|Barrierefreie Tabellen erstellen Schritt 4]]<br/><br/>
</li>

<li>
<div class="notice">Füllen Sie die weiter Tabelle mit Inhalten</div><br/>
[[Datei:tiny-table-tutorial-step-5.png|alt=Barrierefreie Tabellen erstellen Schritt 5|Barrierefreie Tabellen erstellen Schritt 5]]<br/><br/>
</li>

<li>
<div class="notice">Um die obere Zeile als Spaltenbeschreibung zu deklarieren, markieren Sie die Zeile und öffnen die Zelleneigenschaften</div><br/>
[[Datei:tiny-table-tutorial-step-6.png|alt=Barrierefreie Tabellen erstellen Schritt 6|Barrierefreie Tabellen erstellen Schritt 6]]<br/><br/>
</li>

<li>
<div class="notice">Ändern Sie den Zellentyp auf Kopfzeile</div><br/>
[[Datei:tiny-table-tutorial-step-7.png|alt=Barrierefreie Tabellen erstellen Schritt 7|Barrierefreie Tabellen erstellen Schritt 7]]<br/><br/>
</li>

<li>
<div class="notice">Um anzugeben, dass es sich bei den markierten Feldern um Spaltenüberschriften handelt, müssen Sie den Gültigkeitsbereich auf Spalte ändern</div><br/>
[[Datei:tiny-table-tutorial-step-8.png|alt=Barrierefreie Tabellen erstellen Schritt 8|Barrierefreie Tabellen erstellen Schritt 8]]<br/><br/>
</li>

<li>
<div class="notice">Gehen Sie bei Zeilenüberschriften genauso vor</div><br/>
[[Datei:tiny-table-tutorial-step-9.png|alt=Barrierefreie Tabellen erstellen Schritt 9|Barrierefreie Tabellen erstellen Schritt 9]]
[[Datei:tiny-table-tutorial-step-10.png|alt=Barrierefreie Tabellen erstellen Schritt 10|Barrierefreie Tabellen erstellen Schritt 10]]<br/><br/>
</li>

<li>
<div class="notice">An stelle von "Spalte" geben wir hier als Gültigkeitsbereich "Zeile" an, da es sich um zeilenweise Überschriften handelt</div><br/>
[[Datei:tiny-table-tutorial-step-11.png|alt=Barrierefreie Tabellen erstellen Schritt 11|Barrierefreie Tabellen erstellen Schritt 11]]<br/><br/>
</li>

<li>
<div class="notice">Die fertige Ausgabe auf der Website kann dann z.B. so aussehen:</div><br/>
[[Datei:tiny-table-tutorial-step-12.png|alt=Barrierefreie Tabellen erstellen Schritt 12|Barrierefreie Tabellen erstellen Schritt 12]]
<br/><br/>
</li>
</ol>
</p>

===== Was schreibt der TinyMCE nun auf die Webseite? =====
<p>So sieht der HTML Code mit unseren Zusatzinformationen und Änderungen aus:<br />
<source lang="xml">
<table>
<caption>Gruppe G</caption>
<tbody>
<tr>
<th scope="col">Land</th>
<th scope="col">Punkte</th>
<th scope="col">Tore</th>
<th scope="col">Tordifferenz</th>
<th scope="col">Siege</th>
</tr>
<tr>
<th scope="row">Deutschland</th>
<td>3</td>
<td>4</td>
<td>4</td>
<td>1</td>
</tr>
<tr>
<th scope="row">USA</th>
<td>3</td>
<td>2</td>
<td>1</td>
<td>1</td>
</tr>
<tr>
<th scope="row">Ghana</th>
<td>0</td>
<td>1</td>
<td>-1</td>
<td>0</td>
</tr>
<tr>
<th scope="row">Portugal</th>
<td>0</td>
<td>0</td>
<td>-4</td>
<td>0</td>
</tr>
</tbody>
</table>
</source>
</p>

<noinclude>
[[Category:SPT-Tags]]
</noinclude>

Ilink (SPT-Tag)

2015-11-25T08:35:55Z

Schleuse: /* i!-Link in der Eingabe */

==Name==
<spt:ilink> - Erzeugt einen Link auf das CMS

==Syntax==
<source lang="xml">
<spt:ilink value=""/>
</source>

==Beschreibung==
Der <code>spt:ilink</code>-Tag generiert einen Link auf die Bearbeitung des entsprechenden Artikels. Diese Links sind klassisch in der Website nur für Redakteure sichtbar und erlauben das Öffnen des aktuellen Artikels in der Bearbeitung von InfoSite direkt aus der Website heraus.

Seit InfoSite 6 ist auch die Verwendung des i!-Links für interne Links auf andere Artikel innerhalb des CMS möglich.

==Attribute==
{| class="prettytable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>value</code>
| [[Text]]
| Nein
| None
| 1
|-
| <code>information</code>
| [[Attribute]]
| Nein
| None
| 1
|-
| <code>step</code>
| [[Number]]
| Nein
| None
| 2.0.1
|}

;<code>value</code>
:Code für den generierten i-Link.

;<code>information</code>
:Optionale Angabe eines Artikels, auf den der Link zeigen soll (z.B. für Listen).

;<code>step</code>
:Bei Templates, die mit mehreren Steps aufgebaut sind ist hiermit der Sprung an eine definierte Stelle möglich. Die Angabe erfolgt relativ zum Step "Verwaltung".

==Beispiele==

===Einfacher Artikel mit i!-Link===

Template Quelltext
<source lang="xml">
<sp:io type="in">
<sp:text name="headline"/>
</sp:io>

<%-- einfacher Seiten-i-Link --%>
<sp:io type="out">
<sp:print name="headline"/>
</sp:io>

<spt:ilink value="Artikel bearbeiten"/>

<%-- Loop pro Treffer ein i-Link --%>
<sp:io type="out">
<sp:loop collection="collection" item="it">
<ul class="linkIntern">
<li>
<a href="<sp:print name="it.id.url"/>"><sp:print name="it.sp_title"/></a>
<div id="ilinkInline">
<spt:ilink
value="<img src=\"/img/ilink.gif\"
class=\"ilink\"
width=\"16\"
height=\"16\"
alt=\"Seite bearbeiten ...\">"
information="${it.id}"/>
</div>
</li>
</ul>
</sp:loop>
</sp:io>
</source>

===i!-Link in der Eingabe===
Template Quelltext
<source lang="xml">
<sp:io type="in">
<strong>Artikel verknüpfen</strong><br/>
<sp:link name="sp_link" type="link"/>
<spif name="sp_link.link">
<spt:ilink information="sp_link.link" step="4" />
</sp:if>
</sp:io>
</source>

<noinclude>
[[Category:SPT-Tags]]
[[Category:Qualität_des_Inhalts_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

Ilink (SPT-Tag)

2015-11-25T08:35:41Z

Schleuse: /* i!-Link in der Eingabe */

==Name==
<spt:ilink> - Erzeugt einen Link auf das CMS

==Syntax==
<source lang="xml">
<spt:ilink value=""/>
</source>

==Beschreibung==
Der <code>spt:ilink</code>-Tag generiert einen Link auf die Bearbeitung des entsprechenden Artikels. Diese Links sind klassisch in der Website nur für Redakteure sichtbar und erlauben das Öffnen des aktuellen Artikels in der Bearbeitung von InfoSite direkt aus der Website heraus.

Seit InfoSite 6 ist auch die Verwendung des i!-Links für interne Links auf andere Artikel innerhalb des CMS möglich.

==Attribute==
{| class="prettytable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>value</code>
| [[Text]]
| Nein
| None
| 1
|-
| <code>information</code>
| [[Attribute]]
| Nein
| None
| 1
|-
| <code>step</code>
| [[Number]]
| Nein
| None
| 2.0.1
|}

;<code>value</code>
:Code für den generierten i-Link.

;<code>information</code>
:Optionale Angabe eines Artikels, auf den der Link zeigen soll (z.B. für Listen).

;<code>step</code>
:Bei Templates, die mit mehreren Steps aufgebaut sind ist hiermit der Sprung an eine definierte Stelle möglich. Die Angabe erfolgt relativ zum Step "Verwaltung".

==Beispiele==

===Einfacher Artikel mit i!-Link===

Template Quelltext
<source lang="xml">
<sp:io type="in">
<sp:text name="headline"/>
</sp:io>

<%-- einfacher Seiten-i-Link --%>
<sp:io type="out">
<sp:print name="headline"/>
</sp:io>

<spt:ilink value="Artikel bearbeiten"/>

<%-- Loop pro Treffer ein i-Link --%>
<sp:io type="out">
<sp:loop collection="collection" item="it">
<ul class="linkIntern">
<li>
<a href="<sp:print name="it.id.url"/>"><sp:print name="it.sp_title"/></a>
<div id="ilinkInline">
<spt:ilink
value="<img src=\"/img/ilink.gif\"
class=\"ilink\"
width=\"16\"
height=\"16\"
alt=\"Seite bearbeiten ...\">"
information="${it.id}"/>
</div>
</li>
</ul>
</sp:loop>
</sp:io>
</source>

===i!-Link in der Eingabe===
Template Quelltext
<source lang="xml">
<sp:io type="in">
<strong>Artikel verknüpfen</strong><br/>
<sp:link name="sp_link" type="link"/>
<spif name="sp_link.link">
<spt:ilink object="sp_link.link" step="4" />
</sp:if>
</sp:io>
</source>

<noinclude>
[[Category:SPT-Tags]]
[[Category:Qualität_des_Inhalts_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

Ilink (SPT-Tag)

2015-11-25T08:24:06Z

Schleuse: /* Beispiele */

==Name==
<spt:ilink> - Erzeugt einen Link auf das CMS

==Syntax==
<source lang="xml">
<spt:ilink value=""/>
</source>

==Beschreibung==
Der <code>spt:ilink</code>-Tag generiert einen Link auf die Bearbeitung des entsprechenden Artikels. Diese Links sind klassisch in der Website nur für Redakteure sichtbar und erlauben das Öffnen des aktuellen Artikels in der Bearbeitung von InfoSite direkt aus der Website heraus.

Seit InfoSite 6 ist auch die Verwendung des i!-Links für interne Links auf andere Artikel innerhalb des CMS möglich.

==Attribute==
{| class="prettytable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>value</code>
| [[Text]]
| Nein
| None
| 1
|-
| <code>information</code>
| [[Attribute]]
| Nein
| None
| 1
|-
| <code>step</code>
| [[Number]]
| Nein
| None
| 2.0.1
|}

;<code>value</code>
:Code für den generierten i-Link.

;<code>information</code>
:Optionale Angabe eines Artikels, auf den der Link zeigen soll (z.B. für Listen).

;<code>step</code>
:Bei Templates, die mit mehreren Steps aufgebaut sind ist hiermit der Sprung an eine definierte Stelle möglich. Die Angabe erfolgt relativ zum Step "Verwaltung".

==Beispiele==

===Einfacher Artikel mit i!-Link===

Template Quelltext
<source lang="xml">
<sp:io type="in">
<sp:text name="headline"/>
</sp:io>

<%-- einfacher Seiten-i-Link --%>
<sp:io type="out">
<sp:print name="headline"/>
</sp:io>

<spt:ilink value="Artikel bearbeiten"/>

<%-- Loop pro Treffer ein i-Link --%>
<sp:io type="out">
<sp:loop collection="collection" item="it">
<ul class="linkIntern">
<li>
<a href="<sp:print name="it.id.url"/>"><sp:print name="it.sp_title"/></a>
<div id="ilinkInline">
<spt:ilink
value="<img src=\"/img/ilink.gif\"
class=\"ilink\"
width=\"16\"
height=\"16\"
alt=\"Seite bearbeiten ...\">"
information="${it.id}"/>
</div>
</li>
</ul>
</sp:loop>
</sp:io>
</source>

===i!-Link in der Eingabe===
Template Quelltext
<source lang="xml">
<strong>Artikel verknüpfen</strong><br/>
<sp:link name="sp_link" type="link"/>
<spif name="sp_link.link">
<spt:ilink object="sp_link.link" step="4" />
</sp:if>
</source>

<noinclude>
[[Category:SPT-Tags]]
[[Category:Qualität_des_Inhalts_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

Scope (SP-Tag)

2015-11-20T13:34:21Z

Schleuse: /* Verschachtelte Scope-Tags */

==Name==
<sp:scope> - Setzt den Standard-Scope für alle Tags im tagbody

==Syntax==
<source lang="xml">
<sp:scope scope="page">
...
</sp:scope>
</source>

==Beschreibung==
Mit dem Scope-Tag kann der Standard-Scope von <code>request</code> auf einen beliebigen anderen Scope gewechselt werden.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>scope</code>
| [[Variable]]
| Ja
| request
| 2.14
|}

;<code>scope</code>
:Gültigkeitsbereich der als Standard-Scope im Tagbody definiert werden soll. Möglich sind page und request.

==Beispiele==
===Standard-Scope ändern===

<source lang="xml">
<sp:set name="foobar" value="123" /> <%-- Variable wird im Request Scope definiert --%>
<sp:scope scope="page">
<sp:set name="foo" value="123" /> <%-- Variable wird im Page Scope definiert --%>
<sp:set name="bar" scope="request" value="123" /> <%-- Variable wird im Request Scope definiert --%>
</sp:scope>
<sp:set name="barfoo" value="123" /> <%-- Variable wird im Request Scope definiert --%>
</source>

===Verschachtelte Scope-Tags===

<source lang="xml">
<sp:set name="foobar" value="123" /> <%-- Variable wird im Request Scope definiert --%>
<sp:scope scope="page">
<sp:set name="foo" value="123" /> <%-- Variable wird im Page Scope definiert --%>
<sp:set name="bar" scope="request" value="123" /> <%-- Variable wird im Request Scope definiert --%>
<sp:scope scope="request">
<sp:set name="foofoo" value="123" /> <%-- Variable wird im Request Scope definiert --%>
</sp:scope>
</sp:scope>
<sp:set name="barfoo" value="123" /> <%-- Variable wird im Request Scope definiert --%>
</source>

<noinclude>
[[Category:SP-Tags]]
[[Category:Qualität_des_Codes_prüfen]]
[[Category:Beispiel_überarbeiten_testen]]
</noinclude>

Scope (SP-Tag)

2015-11-20T13:34:14Z

Schleuse: /* =Verschachtelte Scope-Tags */

==Name==
<sp:scope> - Setzt den Standard-Scope für alle Tags im tagbody

==Syntax==
<source lang="xml">
<sp:scope scope="page">
...
</sp:scope>
</source>

==Beschreibung==
Mit dem Scope-Tag kann der Standard-Scope von <code>request</code> auf einen beliebigen anderen Scope gewechselt werden.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>scope</code>
| [[Variable]]
| Ja
| request
| 2.14
|}

;<code>scope</code>
:Gültigkeitsbereich der als Standard-Scope im Tagbody definiert werden soll. Möglich sind page und request.

==Beispiele==
===Standard-Scope ändern===

<source lang="xml">
<sp:set name="foobar" value="123" /> <%-- Variable wird im Request Scope definiert --%>
<sp:scope scope="page">
<sp:set name="foo" value="123" /> <%-- Variable wird im Page Scope definiert --%>
<sp:set name="bar" scope="request" value="123" /> <%-- Variable wird im Request Scope definiert --%>
</sp:scope>
<sp:set name="barfoo" value="123" /> <%-- Variable wird im Request Scope definiert --%>
</source>

===Verschachtelte Scope-Tags===

Template Quelltext
<source lang="xml">
<sp:set name="foobar" value="123" /> <%-- Variable wird im Request Scope definiert --%>
<sp:scope scope="page">
<sp:set name="foo" value="123" /> <%-- Variable wird im Page Scope definiert --%>
<sp:set name="bar" scope="request" value="123" /> <%-- Variable wird im Request Scope definiert --%>
<sp:scope scope="request">
<sp:set name="foofoo" value="123" /> <%-- Variable wird im Request Scope definiert --%>
</sp:scope>
</sp:scope>
<sp:set name="barfoo" value="123" /> <%-- Variable wird im Request Scope definiert --%>
</source>

<noinclude>
[[Category:SP-Tags]]
[[Category:Qualität_des_Codes_prüfen]]
[[Category:Beispiel_überarbeiten_testen]]
</noinclude>

Scope (SP-Tag)

2015-11-20T13:34:07Z

Schleuse: /* Standard-Scope Ändern */

==Name==
<sp:scope> - Setzt den Standard-Scope für alle Tags im tagbody

==Syntax==
<source lang="xml">
<sp:scope scope="page">
...
</sp:scope>
</source>

==Beschreibung==
Mit dem Scope-Tag kann der Standard-Scope von <code>request</code> auf einen beliebigen anderen Scope gewechselt werden.

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>scope</code>
| [[Variable]]
| Ja
| request
| 2.14
|}

;<code>scope</code>
:Gültigkeitsbereich der als Standard-Scope im Tagbody definiert werden soll. Möglich sind page und request.

==Beispiele==
===Standard-Scope ändern===

<source lang="xml">
<sp:set name="foobar" value="123" /> <%-- Variable wird im Request Scope definiert --%>
<sp:scope scope="page">
<sp:set name="foo" value="123" /> <%-- Variable wird im Page Scope definiert --%>
<sp:set name="bar" scope="request" value="123" /> <%-- Variable wird im Request Scope definiert --%>
</sp:scope>
<sp:set name="barfoo" value="123" /> <%-- Variable wird im Request Scope definiert --%>
</source>

===Verschachtelte Scope-Tags==

Template Quelltext
<source lang="xml">
<sp:set name="foobar" value="123" /> <%-- Variable wird im Request Scope definiert --%>
<sp:scope scope="page">
<sp:set name="foo" value="123" /> <%-- Variable wird im Page Scope definiert --%>
<sp:set name="bar" scope="request" value="123" /> <%-- Variable wird im Request Scope definiert --%>
<sp:scope scope="request">
<sp:set name="foofoo" value="123" /> <%-- Variable wird im Request Scope definiert --%>
</sp:scope>
</sp:scope>
<sp:set name="barfoo" value="123" /> <%-- Variable wird im Request Scope definiert --%>
</source>

<noinclude>
[[Category:SP-Tags]]
[[Category:Qualität_des_Codes_prüfen]]
[[Category:Beispiel_überarbeiten_testen]]
</noinclude>

Scope (SP-Tag)

2015-11-20T13:32:18Z

Schleuse: Die Seite wurde neu angelegt: „==Name== <sp:scope> - Setzt den Standard-Scope für alle Tags im tagbody ==Syntax== <source lang="xml"> <sp:scope scope="page"> ... </sp:scope> </source> ==B…“

Collection (SP-Tag)

2015-11-13T12:04:21Z

Schleuse: /* Attribute */

==Name==
<sp:collection> - Erzeugt oder ändert eine Liste

==Syntax==
<source lang="xml"><sp:collection name="variable" action="add" value="come back at ${myTime}" index="2" />
</source>

==Beschreibung==
Mit Hilfe von <code>sp:collection</code> können Listen erzeugt und verändert werden. Listen können beliebige Objekte enthalten. Je nach angegebener Aktion können Listenelemente hinzugefügt, ersetzt oder gelöscht werden.

Listen können erzeugt werden, indem die einzelnen Einträge über die <code>action</code> <code>add</code>, bzw. <code>addAll</code> hinzugefügt werden. Listen können aber auch über Suchabfragen mit dem Attribut <code>query</code> oder dem Attribut <code>object</code> (wenn ein [[QueryInformation]]-Objekt übergeben wird) erzeugt werden.

'''(Ab Version 2.0.3)'''

Werte können über die Attribute value oder object gesetzte werden. Alternativ ist es auch möglich den Wert im Body des Tags zu setzten. Hierbei wird zunächst der Body ausgeführt und das Ergebnis verwendet

<source lang="xml">
<sp:collection name="family" action="add"><sp:print name="father"/></sp:collection>
</source>

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>name</code>
| [[Variable]]
| Ja
| None
| 1
|-
| <code>action</code>
| [[Text]]
| Ja außer für query
| None
| 1
|-
| <code>value</code>
| [[Text]]
| Ja oder object oder im Body des Tags, für add und replace
| None
| 1
|-
| <code>object</code>
| [[Attribute]]
| Ja oder value oder im Body des Tags, für add und replace
| None
| 1
|-
| <code>expression</code>
| [[Expression]]
| Ja oder value bzw. object bzw. condition oder im Body des Tags
| None
| 2.11
|-
| <code>condition</code>
| [[Condition]]
| Ja oder value bzw. object bzw. expresson oder im Body des Tags
| None
| 2.11
|-
| <code>index</code>
| [[Expression]]
| Ja, für remove und replace
| None
| 1
|-
| <code>query</code>
| [[SPQL|Query]]
| Nein
| None
| 1
|-
| <code>default</code>
| [[Text]]
| Nein
| None
| 2.13
|-
| <code>publisher</code>
| [[Text]]
| Nein
| auto
| 1
|-
| <code>locale</code>
| [[Locale]]
| Nein
| None
| 1
|-
| <code>scope</code>
| [[Scope]]
| Nein
| request
| 1
|}

;<code>name</code>
:Name der Liste.

;<code>action</code>
:Aktion, die ausgeführt werden soll. Es existieren die Aktionen <code>add</code>, <code>addAll</code>, <code>remove</code>, <code>clear</code>, <code>new</code>, <code>replace</code>, <code>removeFirst</code>, <code>removeLast</code> und <code>unique</code>.
:;add
::Fügt ein Element am Ende der Liste ein. Ist ein <code>index</code> angegeben, so wird das Element an dieser Position eingefügt. Das ursprüngliche Elemente und alle nachfolgenden Elemente werden eine Position weiter geschoben.
:;addNotEmpty
::Fügt ein Element am Ende der Liste ein, wenn der Wert nicht null oder ein Leerstring ist. Ist ein <code>index</code> angegeben, so wird das Element an dieser Position eingefügt. Das ursprüngliche Elemente und alle nachfolgenden Elemente werden eine Position weiter geschoben.
:;addAll
::Mit dieser Aktion können mehrere Elemente der Liste hinzugefügt werden. Dazu muss <code>object</code> vom Typ [[Collection]] sein.
:;remove
::Löscht ein Element aus der Liste. Ist <code>index</code> angegeben, wird das Element an der Index-Position gelöscht und alle nachfolgenden Elemente rutschen eine Position nach oben. Ist <code>object</code> bzw. <code>value</code> angegeben, wird das Element in der Liste gesucht und gelöscht.
:;clear
::Löscht alle Elemente aus der Liste.
:;new
::Erzeugt eine neue leere Liste.
:;replace
::Ersetzt ein Element der Liste. <code>index</code> gibt hierbei die Position des Elements an, das durch <code>object</code> bzw. <code>value</code> ersetzt werden soll.
:;removeFirst
::Löscht das erste Element der Liste.
:;removeLast
::Löscht das letzte Element der Liste.
:;unique
::Entfernt alle mehrfach vorkommenden Elemente aus der Liste.
:;insert
::Fügt ein Element ein und verschiebt alle nachfolgenden Elemente um eine Position. Wenn in eine Position eingefügt wird, die noch nicht belegt ist, wird das delta mit <code>null</code> aufgefüllt.

;<code>value</code>
:Ein [[Text]], der mit der Liste verarbeitet werden soll.

;<code>object</code>
:Ein [[Object|Objekt]] das mit der Liste verarbeitet werden soll. Ist <code>object</code> vom Typ [[QueryInformation]], so gilt das gleiche wie beim Attribut <code>query</code>.

;<code>expression</code>
:Die [[Expression]] wird ausgewertet und als Wert in die Variable geschrieben.

;<code>condition</code>
:Die [[Condition]] wird ausgewertet und als Bedingung in die Variable geschrieben.

;<code>index</code>
:Listen-Position mit der eine Aktion ausgeführt werden soll.

;<code>query</code>
:Fügt in die Collection die Ergebnisse der übergebenen [[SPQL|Suchabfrage]] ein. Ist dieses Attibut gesetzt, ist kein <code>action</code> nötig. Die Aktion entspricht einem <code>addAll</code>. Es kann jedoch eine andere Aktion angegeben werden.

;<code>default</code>
:Der Text, der verwendet wird, wenn die Inhalte von value, expression und body leer sind.

;<code>publisher</code>
:Wird der Collection-Tag in Verbindung mit Suchabfragen verwendet (durch <code>query</code> oder <code>object</code>), ist ein Publikationsbereich erforderlich, mit der die Suchabfrage ausgeführt werden soll. Mit diesem Attribut können ein oder mehrere Publikationsbereiche angegeben werden (durch Kommata getrennt). Entweder werden die Publikationsbereiche durch ihren Anchor angegeben, oder folgende Schlüsselwörter verwendet:
:;current
::Der aktuelle Publikationsbereich. Dieser steht im <code>out</code>- und <code>preview</code>-Modus als default-Wert zur Verfügung.
:;ignore
::Ignoriert die Publikationsbereiche und liefert die Treffer unabhängig davon, ob sie publiziert sind oder nicht.
:;all
::Liefert die Treffer, wenn sie in irgendeinem der dem Mandanten zugewiesenen Publikationsbereiche publiziert sind.
:;auto
::Entspricht im <code>out</code>- und <code>preview</code>-Modus dem Schlüsselwort <code>current</code> und im <code>in</code>-Modus <code>ignore</code>.

;<code>locale</code>
:Dieses Attribut dient zur Auswahl der zu verwendende Sprache bei mehrsprachigen Variablen.

;<code>scope</code>
:[[Scope|Namensraum]], in dem die Variable definiert ist. Für diesen Tag ist der Page- und Request-Scope möglich (<code>page</code>, <code>request</code>).

==Beispiele==

===Eine Liste von Strings erstellen===

Template Quelltext
<source lang="xml">
<sp:collection name="myList" action="add" value="peter"/>
<sp:collection name="myList" action="add" value="paul"/>
<sp:collection name="myList" action="add" value="mary"/>
</source>

===Zwei Listen zu einer Liste vereinen===

Template Quelltext
<source lang="xml">
<sp:collection name="family" action="add" value="father"/>
<sp:collection name="family" action="add" value="mother"/>
<sp:collection name="family" action="add" value="sister"/>
<sp:collection name="family" action="add" value="brother"/>

<sp:collection name="friends" action="add" value="girl friend"/>
<sp:collection name="friends" action="add" value="boy friend"/>

<sp:collection name="nice_people" action="addAll" object="family"/>
<sp:collection name="nice_people" action="addAll" object="friends"/>
</source>

===Suchabfrage ausführen===

Template Quelltext
<source lang="xml">
<sp:collection name="queryResult" query="infolevel = 'content'"/>
</source>

<noinclude>
[[Category:SP-Tags]]
[[Category:Qualität_des_Codes_prüfen]]
[[Category:Beispiel_überarbeiten_testen]]
</noinclude>

Sort (SP-Tag)

2015-10-07T14:29:17Z

Schleuse: /* Attribute */

==Name==
<sp:sort> - Sortiert eine Liste

==Syntax==
<source lang="xml">
<sp:sort name="sortedList" collection="listToSort" keys="lastName, birthday" sequences="desc, asc" types="text, number" locale="en"/>
</source>

==Beschreibung==
Der Sort-Tag sortiert eine Liste nach den angegeben Sortierkriterien (<code>keys</code>). Zu jedem Sortierkriterium kann eine Sortierreihenfolge (<code>sequences</code>) angegeben werden, die bestimmt ob auf- oder absteigend sortiert werden soll. Weiter kann für jedes Sortierkriterium ein Sortiertyp (<code>types</code>) festgelegt werden, um zu bestimmen, ob Zeichenketten oder Zahlen sortiert werden sollen.

Punkte, Leerzeichen und Bindestriche werden bei der Text-Sortierung nicht berücksichtigt. Für Umlaute und Groß- bzw. Kleinbuchstaben gilt folgende Reihenfolge: a, A, ä, Ä, aa, Aa, äa, Äa, ad, Ad, ae, Ae

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>name</code>
| [[Variable]]
| Ja
| None
| 1
|-
| <code>collection</code>
| [[Collection]]
| Ja
| None
| 1
|-
| <code>keys</code>
| kommaseparierte Liste von [[Text|Texten]]
| Nein
| das Element selbst
| 1
|-
| <code>sequences</code>
| kommaseparierte Liste von [[Text|Texten]]
| <code>asc</code> für alle Sortierkriterien
| None
| 1
|-
| <code>types</code>
| kommaseparierte Liste von [[Text|Texten]]
| <code>text</code> für alle Sortierkriterien
| None
| 1
|-
| <code>locale</code>
| [[Locale]]
| Nein
| None
| 1
|-
| <code>scope</code>
| [[Text]]
| Nein
| None
| 2.13
|}

;<code>name</code>
:Name der sortierten Liste.

;<code>collection</code>
:Name der zu sortierenden Liste.

;<code>keys</code>
:Die Sortierkriterien nach denen die Elemente der Liste sortiert werden sollen. Diese Parameter ist optional. Ist kein Sortierkriterium angegeben, so wird das Element selber für die Sortierung verwendet. Dies ist beispielsweise der Fall, wenn die Liste nicht aus Elementen sondern aus einfachen Zeichenketten besteht. Die Objekte der Liste haben keine Attribute und es soll nach den Zeichenketten selbst sortiert werden.

;<code>sequences</code>
:Für jedes Sortierkriterium muss eine Sortierreihenfolge festgelegt werden, mit der bestimmt wird, ob mit dem Sortierkriterium aufsteigend (<code>asc</code>), absteigend (<code>desc</code>) oder zufällig (<code>random</code>) sortiert wird. Ist kein Sortierkriterium angegeben muss genau eine Sortierreihenfolge angegeben werden.

;<code>types</code>
:Für jedes Sortierkriterium muss ein Sortiertyp festgelegt werden, der bestimmt, wie sortiert wird. Dabei ist eine Sortierung von Zeichenketten (<code>text</code>) oder eine Sortierung von Zahlen (<code>number</code>) möglich. Ist kein Sortierkriterium angegeben, muss genau ein Sortiertyp angegeben werden.

;<code>locale</code>
:Dieses Attribut dient zur Auswahl der zu verwendenden Sprache bei mehrsprachigen Variablen.

;<code>scope</code>
:Gültigkeitsbereich, in dem die Variable definiert ist. Möglich sind: page|request|session.

==Beispiele==

===Auf- und absteigende Sortierung===

Template Quelltext
<source lang="xml">
<sp:collection name="names" action="add" value="Dr. Peter Pan"/>
<sp:collection name="names" action="add" value="Karsten Müller"/>
<sp:collection name="names" action="add" value="Gaby Schmidt"/>
<sp:collection name="names" action="add" value="Dr. Hans-Peter Schlau"/>
<sp:collection name="names" action="add" value="Dr. Heinz-Rüdiger Schlauer"/>
<sp:collection name="names" action="add" value="Tina Meier"/>
<sp:collection name="names" action="add" value="Marion Hempel"/>
<sp:collection name="names" action="add" value="Jörg Jürgens"/>
<sp:collection name="names" action="add" value="Adam Apfel"/>
<sp:collection name="names" action="add" value="100-900"/>
<sp:collection name="names" action="add" value="20-30"/>
<sp:collection name="names" action="add" value="-"/>
<sp:collection name="names" action="add" value="-F"/>
<sp:collection name="names" action="add" value="*"/>

Unsortierte Liste:<br>
<sp:loop collection="names" item="it">
<sp:print name="it"/>
</sp:loop>

Liste aufsteigend sortieren:
<sp:sort name="sortedList" collection="names" sequences="desc"/>
<sp:loop collection="sortedList" item="it">
<sp:print name="it"/>
</sp:loop>
<br>
Liste absteigend sortieren:
<sp:sort name="sortedList" collection="names"/>
<sp:iterator collection="sortedList" item="it">
<sp:print name="it"/>
</sp:iterator>
</source>

Ausgabe
<source lang="text">
Unsortierte Liste:
Dr. Peter Pan
Karsten Müller
Gaby Schmidt
Dr. Hans-Peter Schlau
Dr. Heinz-Rüdiger Schlauer
Tina Meier
Marion Hempel
Jörg Jürgens
Adam Apfel
100-900
20-30
-
-F
*

Liste aufsteigend sortieren:
Tina Meier
Marion Hempel
Karsten Müller
Jörg Jürgens
Gaby Schmidt
-F
Dr. Peter Pan
Dr. Heinz-Rüdiger Schlauer
Dr. Hans-Peter Schlau
Adam Apfel
20-30
100-900
*
-

Liste absteigend sortieren:
-
*
100-900
20-30
Adam Apfel
Dr. Hans-Peter Schlau
Dr. Heinz-Rüdiger Schlauer
Dr. Peter Pan
-F
Gaby Schmidt
Jörg Jürgens
Karsten Müller
Marion Hempel
Tina Meier
</source>

===Zeichenketten und Zahlen sortieren===

Template Quelltext
<source lang="xml">
<sp:collection name="numbers" action="add" value="1092"/>
<sp:collection name="numbers" action="add" value="-64"/>
<sp:collection name="numbers" action="add" value="16"/>
<sp:collection name="numbers" action="add" value="403.56"/>
<sp:collection name="numbers" action="add" value="-1056.0998"/>
<sp:collection name="numbers" action="add" value="59"/>
<sp:collection name="numbers" action="add" value="0.56"/>

Unsortierte Liste:
<sp:iterator collection="numbers" item="it">
<sp:print name="it"/>
</sp:iterator>

Liste als Zeichenkette sortieren:
<sp:sort name="sortedList" collection="numbers"/>
<sp:loop collection="sortedList" item="it">
<sp:print name="it"/>
</sp:loop>

Liste als Zahlen sortieren:
<sp:sort name="sortedList" collection="numbers" types="number"/>
<sp:loop collection="sortedList" item="it">
<sp:print name="it"/>
</sp:loop>
</source>

Ausgabe
<source lang="text">
Unsortierte Liste:
1092
-64
16
403.56
-1056.0998
59
0.56

Liste als Zeichenkette sortieren:
0.56
-1056.0998
1092
16
403.56
59
-64

Liste als Zahlen sortieren:
-1056.0998
-64
0.56
16
59
403.56
1092
</source>

<noinclude>
[[Category:SP-Tags]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

Sort (SP-Tag)

2015-10-07T14:29:03Z

Schleuse: /* Attribute */

==Name==
<sp:sort> - Sortiert eine Liste

==Syntax==
<source lang="xml">
<sp:sort name="sortedList" collection="listToSort" keys="lastName, birthday" sequences="desc, asc" types="text, number" locale="en"/>
</source>

==Beschreibung==
Der Sort-Tag sortiert eine Liste nach den angegeben Sortierkriterien (<code>keys</code>). Zu jedem Sortierkriterium kann eine Sortierreihenfolge (<code>sequences</code>) angegeben werden, die bestimmt ob auf- oder absteigend sortiert werden soll. Weiter kann für jedes Sortierkriterium ein Sortiertyp (<code>types</code>) festgelegt werden, um zu bestimmen, ob Zeichenketten oder Zahlen sortiert werden sollen.

Punkte, Leerzeichen und Bindestriche werden bei der Text-Sortierung nicht berücksichtigt. Für Umlaute und Groß- bzw. Kleinbuchstaben gilt folgende Reihenfolge: a, A, ä, Ä, aa, Aa, äa, Äa, ad, Ad, ae, Ae

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>name</code>
| [[Variable]]
| Ja
| None
| 1
|-
| <code>collection</code>
| [[Collection]]
| Ja
| None
| 1
|-
| <code>keys</code>
| kommaseparierte Liste von [[Text|Texten]]
| Nein
| das Element selbst
| 1
|-
| <code>sequences</code>
| kommaseparierte Liste von [[Text|Texten]]
| <code>asc</code> für alle Sortierkriterien
| None
| 1
|-
| <code>types</code>
| kommaseparierte Liste von [[Text|Texten]]
| <code>text</code> für alle Sortierkriterien
| None
| 1
|-
| <code>locale</code>
| [[Locale]]
| Nein
| None
| 1
|-
| <code>scope</code>
| [[Text]]
| Nein
| None
| 2.13
|}

;<code>name</code>
:Name der sortierten Liste.

;<code>collection</code>
:Name der zu sortierenden Liste.

;<code>keys</code>
:Die Sortierkriterien nach denen die Elemente der Liste sortiert werden sollen. Diese Parameter ist optional. Ist kein Sortierkriterium angegeben, so wird das Element selber für die Sortierung verwendet. Dies ist beispielsweise der Fall, wenn die Liste nicht aus Elementen sondern aus einfachen Zeichenketten besteht. Die Objekte der Liste haben keine Attribute und es soll nach den Zeichenketten selbst sortiert werden.

;<code>sequences</code>
:Für jedes Sortierkriterium muss eine Sortierreihenfolge festgelegt werden, mit der bestimmt wird, ob mit dem Sortierkriterium aufsteigend (<code>asc</code>), absteigend (<code>desc</code>) oder zufällig (<code>random</code>) sortiert wird. Ist kein Sortierkriterium angegeben muss genau eine Sortierreihenfolge angegeben werden.

;<code>types</code>
:Für jedes Sortierkriterium muss ein Sortiertyp festgelegt werden, der bestimmt, wie sortiert wird. Dabei ist eine Sortierung von Zeichenketten (<code>text</code>) oder eine Sortierung von Zahlen (<code>number</code>) möglich. Ist kein Sortierkriterium angegeben, muss genau ein Sortiertyp angegeben werden.

;<code>locale</code>
:Dieses Attribut dient zur Auswahl der zu verwendenden Sprache bei mehrsprachigen Variablen.

;<code>scope</code>
;Gültigkeitsbereich, in dem die Variable definiert ist. Möglich sind: page|request|session.

==Beispiele==

===Auf- und absteigende Sortierung===

Template Quelltext
<source lang="xml">
<sp:collection name="names" action="add" value="Dr. Peter Pan"/>
<sp:collection name="names" action="add" value="Karsten Müller"/>
<sp:collection name="names" action="add" value="Gaby Schmidt"/>
<sp:collection name="names" action="add" value="Dr. Hans-Peter Schlau"/>
<sp:collection name="names" action="add" value="Dr. Heinz-Rüdiger Schlauer"/>
<sp:collection name="names" action="add" value="Tina Meier"/>
<sp:collection name="names" action="add" value="Marion Hempel"/>
<sp:collection name="names" action="add" value="Jörg Jürgens"/>
<sp:collection name="names" action="add" value="Adam Apfel"/>
<sp:collection name="names" action="add" value="100-900"/>
<sp:collection name="names" action="add" value="20-30"/>
<sp:collection name="names" action="add" value="-"/>
<sp:collection name="names" action="add" value="-F"/>
<sp:collection name="names" action="add" value="*"/>

Unsortierte Liste:<br>
<sp:loop collection="names" item="it">
<sp:print name="it"/>
</sp:loop>

Liste aufsteigend sortieren:
<sp:sort name="sortedList" collection="names" sequences="desc"/>
<sp:loop collection="sortedList" item="it">
<sp:print name="it"/>
</sp:loop>
<br>
Liste absteigend sortieren:
<sp:sort name="sortedList" collection="names"/>
<sp:iterator collection="sortedList" item="it">
<sp:print name="it"/>
</sp:iterator>
</source>

Ausgabe
<source lang="text">
Unsortierte Liste:
Dr. Peter Pan
Karsten Müller
Gaby Schmidt
Dr. Hans-Peter Schlau
Dr. Heinz-Rüdiger Schlauer
Tina Meier
Marion Hempel
Jörg Jürgens
Adam Apfel
100-900
20-30
-
-F
*

Liste aufsteigend sortieren:
Tina Meier
Marion Hempel
Karsten Müller
Jörg Jürgens
Gaby Schmidt
-F
Dr. Peter Pan
Dr. Heinz-Rüdiger Schlauer
Dr. Hans-Peter Schlau
Adam Apfel
20-30
100-900
*
-

Liste absteigend sortieren:
-
*
100-900
20-30
Adam Apfel
Dr. Hans-Peter Schlau
Dr. Heinz-Rüdiger Schlauer
Dr. Peter Pan
-F
Gaby Schmidt
Jörg Jürgens
Karsten Müller
Marion Hempel
Tina Meier
</source>

===Zeichenketten und Zahlen sortieren===

Template Quelltext
<source lang="xml">
<sp:collection name="numbers" action="add" value="1092"/>
<sp:collection name="numbers" action="add" value="-64"/>
<sp:collection name="numbers" action="add" value="16"/>
<sp:collection name="numbers" action="add" value="403.56"/>
<sp:collection name="numbers" action="add" value="-1056.0998"/>
<sp:collection name="numbers" action="add" value="59"/>
<sp:collection name="numbers" action="add" value="0.56"/>

Unsortierte Liste:
<sp:iterator collection="numbers" item="it">
<sp:print name="it"/>
</sp:iterator>

Liste als Zeichenkette sortieren:
<sp:sort name="sortedList" collection="numbers"/>
<sp:loop collection="sortedList" item="it">
<sp:print name="it"/>
</sp:loop>

Liste als Zahlen sortieren:
<sp:sort name="sortedList" collection="numbers" types="number"/>
<sp:loop collection="sortedList" item="it">
<sp:print name="it"/>
</sp:loop>
</source>

Ausgabe
<source lang="text">
Unsortierte Liste:
1092
-64
16
403.56
-1056.0998
59
0.56

Liste als Zeichenkette sortieren:
0.56
-1056.0998
1092
16
403.56
59
-64

Liste als Zahlen sortieren:
-1056.0998
-64
0.56
16
59
403.56
1092
</source>

<noinclude>
[[Category:SP-Tags]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

Sort (SP-Tag)

2015-10-07T14:28:37Z

Schleuse: /* Attribute */

==Name==
<sp:sort> - Sortiert eine Liste

==Syntax==
<source lang="xml">
<sp:sort name="sortedList" collection="listToSort" keys="lastName, birthday" sequences="desc, asc" types="text, number" locale="en"/>
</source>

==Beschreibung==
Der Sort-Tag sortiert eine Liste nach den angegeben Sortierkriterien (<code>keys</code>). Zu jedem Sortierkriterium kann eine Sortierreihenfolge (<code>sequences</code>) angegeben werden, die bestimmt ob auf- oder absteigend sortiert werden soll. Weiter kann für jedes Sortierkriterium ein Sortiertyp (<code>types</code>) festgelegt werden, um zu bestimmen, ob Zeichenketten oder Zahlen sortiert werden sollen.

Punkte, Leerzeichen und Bindestriche werden bei der Text-Sortierung nicht berücksichtigt. Für Umlaute und Groß- bzw. Kleinbuchstaben gilt folgende Reihenfolge: a, A, ä, Ä, aa, Aa, äa, Äa, ad, Ad, ae, Ae

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>name</code>
| [[Variable]]
| Ja
| None
| 1
|-
| <code>collection</code>
| [[Collection]]
| Ja
| None
| 1
|-
| <code>keys</code>
| kommaseparierte Liste von [[Text|Texten]]
| Nein
| das Element selbst
| 1
|-
| <code>sequences</code>
| kommaseparierte Liste von [[Text|Texten]]
| <code>asc</code> für alle Sortierkriterien
| None
| 1
|-
| <code>types</code>
| kommaseparierte Liste von [[Text|Texten]]
| <code>text</code> für alle Sortierkriterien
| None
| 1
|-
| <code>locale</code>
| [[Locale]]
| Nein
| None
| 1
|-
| <code>scope</code>
| [[Text]]
| Nein
| None
| 2.13
|}

;<code>name</code>
:Name der sortierten Liste.

;<code>collection</code>
:Name der zu sortierenden Liste.

;<code>keys</code>
:Die Sortierkriterien nach denen die Elemente der Liste sortiert werden sollen. Diese Parameter ist optional. Ist kein Sortierkriterium angegeben, so wird das Element selber für die Sortierung verwendet. Dies ist beispielsweise der Fall, wenn die Liste nicht aus Elementen sondern aus einfachen Zeichenketten besteht. Die Objekte der Liste haben keine Attribute und es soll nach den Zeichenketten selbst sortiert werden.

;<code>sequences</code>
:Für jedes Sortierkriterium muss eine Sortierreihenfolge festgelegt werden, mit der bestimmt wird, ob mit dem Sortierkriterium aufsteigend (<code>asc</code>), absteigend (<code>desc</code>) oder zufällig (<code>random</code>) sortiert wird. Ist kein Sortierkriterium angegeben muss genau eine Sortierreihenfolge angegeben werden.

;<code>types</code>
:Für jedes Sortierkriterium muss ein Sortiertyp festgelegt werden, der bestimmt, wie sortiert wird. Dabei ist eine Sortierung von Zeichenketten (<code>text</code>) oder eine Sortierung von Zahlen (<code>number</code>) möglich. Ist kein Sortierkriterium angegeben, muss genau ein Sortiertyp angegeben werden.

;<code>locale</code>
:Dieses Attribut dient zur Auswahl der zu verwendenden Sprache bei mehrsprachigen Variablen.

==Beispiele==

===Auf- und absteigende Sortierung===

Template Quelltext
<source lang="xml">
<sp:collection name="names" action="add" value="Dr. Peter Pan"/>
<sp:collection name="names" action="add" value="Karsten Müller"/>
<sp:collection name="names" action="add" value="Gaby Schmidt"/>
<sp:collection name="names" action="add" value="Dr. Hans-Peter Schlau"/>
<sp:collection name="names" action="add" value="Dr. Heinz-Rüdiger Schlauer"/>
<sp:collection name="names" action="add" value="Tina Meier"/>
<sp:collection name="names" action="add" value="Marion Hempel"/>
<sp:collection name="names" action="add" value="Jörg Jürgens"/>
<sp:collection name="names" action="add" value="Adam Apfel"/>
<sp:collection name="names" action="add" value="100-900"/>
<sp:collection name="names" action="add" value="20-30"/>
<sp:collection name="names" action="add" value="-"/>
<sp:collection name="names" action="add" value="-F"/>
<sp:collection name="names" action="add" value="*"/>

Unsortierte Liste:<br>
<sp:loop collection="names" item="it">
<sp:print name="it"/>
</sp:loop>

Liste aufsteigend sortieren:
<sp:sort name="sortedList" collection="names" sequences="desc"/>
<sp:loop collection="sortedList" item="it">
<sp:print name="it"/>
</sp:loop>
<br>
Liste absteigend sortieren:
<sp:sort name="sortedList" collection="names"/>
<sp:iterator collection="sortedList" item="it">
<sp:print name="it"/>
</sp:iterator>
</source>

Ausgabe
<source lang="text">
Unsortierte Liste:
Dr. Peter Pan
Karsten Müller
Gaby Schmidt
Dr. Hans-Peter Schlau
Dr. Heinz-Rüdiger Schlauer
Tina Meier
Marion Hempel
Jörg Jürgens
Adam Apfel
100-900
20-30
-
-F
*

Liste aufsteigend sortieren:
Tina Meier
Marion Hempel
Karsten Müller
Jörg Jürgens
Gaby Schmidt
-F
Dr. Peter Pan
Dr. Heinz-Rüdiger Schlauer
Dr. Hans-Peter Schlau
Adam Apfel
20-30
100-900
*
-

Liste absteigend sortieren:
-
*
100-900
20-30
Adam Apfel
Dr. Hans-Peter Schlau
Dr. Heinz-Rüdiger Schlauer
Dr. Peter Pan
-F
Gaby Schmidt
Jörg Jürgens
Karsten Müller
Marion Hempel
Tina Meier
</source>

===Zeichenketten und Zahlen sortieren===

Template Quelltext
<source lang="xml">
<sp:collection name="numbers" action="add" value="1092"/>
<sp:collection name="numbers" action="add" value="-64"/>
<sp:collection name="numbers" action="add" value="16"/>
<sp:collection name="numbers" action="add" value="403.56"/>
<sp:collection name="numbers" action="add" value="-1056.0998"/>
<sp:collection name="numbers" action="add" value="59"/>
<sp:collection name="numbers" action="add" value="0.56"/>

Unsortierte Liste:
<sp:iterator collection="numbers" item="it">
<sp:print name="it"/>
</sp:iterator>

Liste als Zeichenkette sortieren:
<sp:sort name="sortedList" collection="numbers"/>
<sp:loop collection="sortedList" item="it">
<sp:print name="it"/>
</sp:loop>

Liste als Zahlen sortieren:
<sp:sort name="sortedList" collection="numbers" types="number"/>
<sp:loop collection="sortedList" item="it">
<sp:print name="it"/>
</sp:loop>
</source>

Ausgabe
<source lang="text">
Unsortierte Liste:
1092
-64
16
403.56
-1056.0998
59
0.56

Liste als Zeichenkette sortieren:
0.56
-1056.0998
1092
16
403.56
59
-64

Liste als Zahlen sortieren:
-1056.0998
-64
0.56
16
59
403.56
1092
</source>

<noinclude>
[[Category:SP-Tags]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

Sort (SP-Tag)

2015-10-07T14:28:25Z

Schleuse: /* Attribute */

==Name==
<sp:sort> - Sortiert eine Liste

==Syntax==
<source lang="xml">
<sp:sort name="sortedList" collection="listToSort" keys="lastName, birthday" sequences="desc, asc" types="text, number" locale="en"/>
</source>

==Beschreibung==
Der Sort-Tag sortiert eine Liste nach den angegeben Sortierkriterien (<code>keys</code>). Zu jedem Sortierkriterium kann eine Sortierreihenfolge (<code>sequences</code>) angegeben werden, die bestimmt ob auf- oder absteigend sortiert werden soll. Weiter kann für jedes Sortierkriterium ein Sortiertyp (<code>types</code>) festgelegt werden, um zu bestimmen, ob Zeichenketten oder Zahlen sortiert werden sollen.

Punkte, Leerzeichen und Bindestriche werden bei der Text-Sortierung nicht berücksichtigt. Für Umlaute und Groß- bzw. Kleinbuchstaben gilt folgende Reihenfolge: a, A, ä, Ä, aa, Aa, äa, Äa, ad, Ad, ae, Ae

==Attribute==
{| class="prettytable sortable"
|- class="hintergrundfarbe1"
! Name || Type || Required || Default || ab IES Version
|-
| <code>name</code>
| [[Variable]]
| Ja
| None
| 1
|-
| <code>collection</code>
| [[Collection]]
| Ja
| None
| 1
|-
| <code>keys</code>
| kommaseparierte Liste von [[Text|Texten]]
| Nein
| das Element selbst
| 1
|-
| <code>sequences</code>
| kommaseparierte Liste von [[Text|Texten]]
| <code>asc</code> für alle Sortierkriterien
| None
| 1
|-
| <code>types</code>
| kommaseparierte Liste von [[Text|Texten]]
| <code>text</code> für alle Sortierkriterien
| None
| 1
|-
| <code>locale</code>
| [[Locale]]
| Nein
| None
| 1
| <code>scope</code>
| [[Text]]
| Nein
| None
| 2.13
|}

;<code>name</code>
:Name der sortierten Liste.

;<code>collection</code>
:Name der zu sortierenden Liste.

;<code>keys</code>
:Die Sortierkriterien nach denen die Elemente der Liste sortiert werden sollen. Diese Parameter ist optional. Ist kein Sortierkriterium angegeben, so wird das Element selber für die Sortierung verwendet. Dies ist beispielsweise der Fall, wenn die Liste nicht aus Elementen sondern aus einfachen Zeichenketten besteht. Die Objekte der Liste haben keine Attribute und es soll nach den Zeichenketten selbst sortiert werden.

;<code>sequences</code>
:Für jedes Sortierkriterium muss eine Sortierreihenfolge festgelegt werden, mit der bestimmt wird, ob mit dem Sortierkriterium aufsteigend (<code>asc</code>), absteigend (<code>desc</code>) oder zufällig (<code>random</code>) sortiert wird. Ist kein Sortierkriterium angegeben muss genau eine Sortierreihenfolge angegeben werden.

;<code>types</code>
:Für jedes Sortierkriterium muss ein Sortiertyp festgelegt werden, der bestimmt, wie sortiert wird. Dabei ist eine Sortierung von Zeichenketten (<code>text</code>) oder eine Sortierung von Zahlen (<code>number</code>) möglich. Ist kein Sortierkriterium angegeben, muss genau ein Sortiertyp angegeben werden.

;<code>locale</code>
:Dieses Attribut dient zur Auswahl der zu verwendenden Sprache bei mehrsprachigen Variablen.

==Beispiele==

===Auf- und absteigende Sortierung===

Template Quelltext
<source lang="xml">
<sp:collection name="names" action="add" value="Dr. Peter Pan"/>
<sp:collection name="names" action="add" value="Karsten Müller"/>
<sp:collection name="names" action="add" value="Gaby Schmidt"/>
<sp:collection name="names" action="add" value="Dr. Hans-Peter Schlau"/>
<sp:collection name="names" action="add" value="Dr. Heinz-Rüdiger Schlauer"/>
<sp:collection name="names" action="add" value="Tina Meier"/>
<sp:collection name="names" action="add" value="Marion Hempel"/>
<sp:collection name="names" action="add" value="Jörg Jürgens"/>
<sp:collection name="names" action="add" value="Adam Apfel"/>
<sp:collection name="names" action="add" value="100-900"/>
<sp:collection name="names" action="add" value="20-30"/>
<sp:collection name="names" action="add" value="-"/>
<sp:collection name="names" action="add" value="-F"/>
<sp:collection name="names" action="add" value="*"/>

Unsortierte Liste:<br>
<sp:loop collection="names" item="it">
<sp:print name="it"/>
</sp:loop>

Liste aufsteigend sortieren:
<sp:sort name="sortedList" collection="names" sequences="desc"/>
<sp:loop collection="sortedList" item="it">
<sp:print name="it"/>
</sp:loop>
<br>
Liste absteigend sortieren:
<sp:sort name="sortedList" collection="names"/>
<sp:iterator collection="sortedList" item="it">
<sp:print name="it"/>
</sp:iterator>
</source>

Ausgabe
<source lang="text">
Unsortierte Liste:
Dr. Peter Pan
Karsten Müller
Gaby Schmidt
Dr. Hans-Peter Schlau
Dr. Heinz-Rüdiger Schlauer
Tina Meier
Marion Hempel
Jörg Jürgens
Adam Apfel
100-900
20-30
-
-F
*

Liste aufsteigend sortieren:
Tina Meier
Marion Hempel
Karsten Müller
Jörg Jürgens
Gaby Schmidt
-F
Dr. Peter Pan
Dr. Heinz-Rüdiger Schlauer
Dr. Hans-Peter Schlau
Adam Apfel
20-30
100-900
*
-

Liste absteigend sortieren:
-
*
100-900
20-30
Adam Apfel
Dr. Hans-Peter Schlau
Dr. Heinz-Rüdiger Schlauer
Dr. Peter Pan
-F
Gaby Schmidt
Jörg Jürgens
Karsten Müller
Marion Hempel
Tina Meier
</source>

===Zeichenketten und Zahlen sortieren===

Template Quelltext
<source lang="xml">
<sp:collection name="numbers" action="add" value="1092"/>
<sp:collection name="numbers" action="add" value="-64"/>
<sp:collection name="numbers" action="add" value="16"/>
<sp:collection name="numbers" action="add" value="403.56"/>
<sp:collection name="numbers" action="add" value="-1056.0998"/>
<sp:collection name="numbers" action="add" value="59"/>
<sp:collection name="numbers" action="add" value="0.56"/>

Unsortierte Liste:
<sp:iterator collection="numbers" item="it">
<sp:print name="it"/>
</sp:iterator>

Liste als Zeichenkette sortieren:
<sp:sort name="sortedList" collection="numbers"/>
<sp:loop collection="sortedList" item="it">
<sp:print name="it"/>
</sp:loop>

Liste als Zahlen sortieren:
<sp:sort name="sortedList" collection="numbers" types="number"/>
<sp:loop collection="sortedList" item="it">
<sp:print name="it"/>
</sp:loop>
</source>

Ausgabe
<source lang="text">
Unsortierte Liste:
1092
-64
16
403.56
-1056.0998
59
0.56

Liste als Zeichenkette sortieren:
0.56
-1056.0998
1092
16
403.56
59
-64

Liste als Zahlen sortieren:
-1056.0998
-64
0.56
16
59
403.56
1092
</source>

<noinclude>
[[Category:SP-Tags]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

Abschnitt: Intro

2015-08-19T13:11:30Z

Schleuse: /* IES Optionen */

==Beschreibung==
Mit dem Intro-Abschnitt können einleitenden Artikelstammdaten eingegeben werden. Diese Informationen werden an unterschiedlichen Stellen Ausgegeben.

;Seitentitel: Gibt den Titel der Seite an. Dieser wird an unterschiedlichsten Stellen genutzt:
* Für die Definition des Title-Tags in HTML.
* Wird als Anzeigewert für Artikel in InfoSite 6 genutzt
* Wenn Links auf diesen Artikel verweisen, wird der Seitentitel als title Attribut für den Link genutzt.
* Text für die Navigationslinks
;Überschrift: Gibt die Überschrift der Seite an.
;Einleitungstext: Der Einleitungstext ist ein kurzer Text der die aktuelle Seite einleiten soll.
;Bild: Definiert das Bild der Seite.
;Alternativtext zum Bild: Dient als Alternativtext des Bildes
;Copyrighttext zum Bild: Gibt Copyrightinformationen zum Artikelbild an
;Bildbeschriftung: Ein kurzer Text der das Bild beschreibt

==Konfiguration==
===IES Optionen===
{| class="prettytable"
|- class="hintergrundfarbe1"
! Name || Type || Beschreibung
|-
| <code>sectionTypes.intro.options.title.maxlength</code>
| [[Number]]
| Gibt die maximale Länge des Seitentitels an
|-
| <code>sectionTypes.intro.options.headline.enabled</code>
| [[Boolean]]
| Gibt an ob die Eingabe der Überschrift möglich ist
|-
| <code>sectionTypes.intro.options.headline.maxlength</code>
| [[Number]]
| Gibt die maximale länge der Überschrift an
|-
| <code>sectionTypes.intro.options.intro.enabled</code>
| [[Boolean]]
| Gibt an ob die Eingabe des Einleitungstextes möglich ist
|-
| <code>sectionTypes.intro.options.headline.maxlength</code>
| [[Number]]
| Gibt die maximale länge des Einleitungstextes an
|-
| <code>sectionTypes.intro.options.image.enabled</code>
| [[Boolean]]
| Gibt an ob die Definition eines Artikelbildes möglich ist
|-
| <code>sectionTypes.intro.options.image.copyright.enabled</code>
| [[Boolean]]
| Gibt an ob die Definition eines Copyrighthinweis zu dem Artikelbildes möglich ist
|-
| <code>sectionTypes.intro.options.image.copyright.default</code>
| [[String]]
| Gibt das Standardcopyright für den Copyrighthinweis zu dem Artikelbild an
|-
| <code>sectionTypes.intro.options.image.legend.enabled</code>
| [[Boolean]]
| Gibt an ob die Definition einer Bildbeschriftung möglich ist
|}
====Beispiel====
<source lang="javascript">
{
"sectionTypes" : {
...,
"image": {
"id" : "intro",
"name": "Intro",
"template": { "module" : "sitekit-module", "uri" : "/templates/sectionTypes/intro.spml" },
"aggregator" : { "module" : "sitekit-module", "uri" : "/aggregator/sectionTypes/intro.spml" },
"options": {
"title": {
"maxlength": 60
},
"headline": {
"enabled": true,
"maxlength": 160
},
"intro": {
"enabled": true,
"maxlength": 320
},
"image": {
"enabled": true,
"copyright": {
"enabled": true,
"default": ":global.copyright"
},
"legend": {
"enabled": true
}
}
}
},
...
}
}
</source>

===PHP Optionen===

==Mehrsprachigkeit==
Unterstütz z.Z. keine Mehrsprachigkeit.

===IES Mehrsprachigkeit===

===PHP Mehrsprachigkeit===
Hat keine Mehrsprachigkeits-Definitionen in PHP

==Datenstruktur==
===IES Datenstruktur===

===PHP Datenstruktur===
Der Intro-Abschnitt benutzt folgende Models:
<source lang="xml">
</source>
<noinclude>
[[Category:Abschnitte]]
</noinclude>

Abschnitt: Intro

2015-08-19T13:11:10Z

Schleuse: /* Beschreibung */

==Beschreibung==
Mit dem Intro-Abschnitt können einleitenden Artikelstammdaten eingegeben werden. Diese Informationen werden an unterschiedlichen Stellen Ausgegeben.

;Seitentitel: Gibt den Titel der Seite an. Dieser wird an unterschiedlichsten Stellen genutzt:
* Für die Definition des Title-Tags in HTML.
* Wird als Anzeigewert für Artikel in InfoSite 6 genutzt
* Wenn Links auf diesen Artikel verweisen, wird der Seitentitel als title Attribut für den Link genutzt.
* Text für die Navigationslinks
;Überschrift: Gibt die Überschrift der Seite an.
;Einleitungstext: Der Einleitungstext ist ein kurzer Text der die aktuelle Seite einleiten soll.
;Bild: Definiert das Bild der Seite.
;Alternativtext zum Bild: Dient als Alternativtext des Bildes
;Copyrighttext zum Bild: Gibt Copyrightinformationen zum Artikelbild an
;Bildbeschriftung: Ein kurzer Text der das Bild beschreibt

==Konfiguration==
===IES Optionen===
{| class="prettytable"
|- class="hintergrundfarbe1"
! Name || Type || Beschreibung
|-
| <code>sectionTypes.intro.options.title.maxlength</code>
| [[Number]]
| Gibt die maximale Länge des Seitentitels an
|-
| <code>sectionTypes.intro.options.headline.enabled</code>
| [[Boolean]]
| Gibt an ob die Eingabe der Überschrift möglich ist
|-
| <code>sectionTypes.intro.options.headline.maxlength</code>
| [[Number]]
| Gibt die maximale länge der Überschrift an
|-
| <code>sectionTypes.intro.options.intro.enabled</code>
| [[Boolean]]
| Gibt an ob die Eingabe des Einleitungstextes möglich ist
|-
| <code>sectionTypes.intro.options.headline.maxlength</code>
| [[Number]]
| Gibt die maximale länge des Einleitungstextes an
|-
| <code>sectionTypes.intro.options.image.enabled</code>
| [[Boolean]]
| Gibt an ob die Definition eines Artikelbildes möglich ist
|-
| <code>sectionTypes.intro.options.image.copyright.enabled</code>
| [[Boolean]]
| Gibt an ob die Definition eines Copyrighthinweis zu dem Artikelbildes möglich ist
|-
| <code>sectionTypes.intro.options.image.copyright.default</code>
| [[String]]
| Gibt das Standardcopyright für den Copyrighthinweis zu dem Artikelbild an
|-
| <code>sectionTypes.intro.options.image.legend.enabled</code>
| [[Boolean]]
| Gibt an ob die Definition einer Kurzbeschreibung zu dem Artikelbildes möglich ist
|}
====Beispiel====
<source lang="javascript">
{
"sectionTypes" : {
...,
"image": {
"id" : "intro",
"name": "Intro",
"template": { "module" : "sitekit-module", "uri" : "/templates/sectionTypes/intro.spml" },
"aggregator" : { "module" : "sitekit-module", "uri" : "/aggregator/sectionTypes/intro.spml" },
"options": {
"title": {
"maxlength": 60
},
"headline": {
"enabled": true,
"maxlength": 160
},
"intro": {
"enabled": true,
"maxlength": 320
},
"image": {
"enabled": true,
"copyright": {
"enabled": true,
"default": ":global.copyright"
},
"legend": {
"enabled": true
}
}
}
},
...
}
}
</source>

===PHP Optionen===

==Mehrsprachigkeit==
Unterstütz z.Z. keine Mehrsprachigkeit.

===IES Mehrsprachigkeit===

===PHP Mehrsprachigkeit===
Hat keine Mehrsprachigkeits-Definitionen in PHP

==Datenstruktur==
===IES Datenstruktur===

===PHP Datenstruktur===
Der Intro-Abschnitt benutzt folgende Models:
<source lang="xml">
</source>
<noinclude>
[[Category:Abschnitte]]
</noinclude>