Formsolutions (SPT-Tag)

Name

<spt:formsolutions> (ab Version 2.0.3.15) - Verknüpfung von Form-Solutions Formularen mit Artikeln

Syntax

<sp:formsolutions name="variable"/>

Beschreibung

Dieser Tag ist vergleichbar mit spt:link. Über ein Popup-Fenster kann ein Formsolutions-Formular ausgewählt werden (), um es mit dem Artikel zu verknüpfen. Für das ausgewählte Formular können zusätzliche Eigenschaften für diese Verknüpfung konfiguriert werden. Diese Konfiguration erfolgt, indem eine Konfigurationsseite des Formsolutions-Servers aufgerufen wird ().

Nach der Auswahl eines Formulars wird für diese Verknüpfung eine URL erzeugt. Wird das Formular mehrmals verknüpft, wird für jede Verknüpfung eine eigene URL erzeugt, die unabhängig voneinander konfiguriert werden. Das Formular kann über aufgerufen werden.

Verwendung der Verknüpfung

Das verknüpfte Formular kann über das link-Attribut erlangt werden. Beispielsweise wurde mit folgendem Template eine Verknüpfung erzeugt:

<sp:io type="in">
  <sp:formsolutions name="formlink"/>
</sp:io>

Das Formular ist immer ein Resource-Artikel und kann über formlink.link angesprochen werden. Da die URL des Formulares für jede Verknüpfung angelegt wird, wird die URL nicht über formlink.link, sondern über formlink.url ausgebeben. Für das Formular stehen folgende Felder zur Verfügung:

Feldname	Beschreibung
formlink.link	Formular-Resource-Artikel
formlink.link.fs_fnr	Eindeute ID des Formulares
formlink.link.fs_pagecount	Anzahl der Seiten des Formulars
formlink.link.fs_created	Datum an dem das Formular erstellt wurde (Format DD-MM-YYYY)
formlink.link.fs_changed	Datum an dem das Formular das letzte mal geändert wurde (Format DD-MM-YYYY)
formlink.link.fs_beschr	Beschreibung zu dem Formular
formlink.link.fs_type	Gibt an, ob das Formular ein Form-Solutions eigenes Formular ist (type=fs) oder ob es vom Kunden angelegt wurde (type=knd)
formlink.url	Für diese Verknüpfung erzeugte URL zu dem Formular

Voraussetzung

Um diesen Tag verwenden zu können müssen bestimmte Voraussetzungen erfüllt sein.

• Der Kunde muss eine Form-Solutions Lizenz besitzen, um den den Form-Solutions-Server ansprechen zu können
• Die Redakteure, die die Formulare Verknüpfen sollen, müssen Zugang zum Internet haben, um den Formsolutions-Server erreichen zu können.
• Es muss ein ArtikelPool mit dem Anchor 'formsolutions' existieren.
• Es muss folgendes Template mit dem Anchor 'formsolutions.template.config' angelegt sein:

<sp:io type="in">
  <em>
  Diese Konfigurationswerte werden über den Form-Solutions import gesetzt und können an dieser Stellen nicht geändert werden.
  Ist eine Änderung der Werte nötig, muss diese Änderung am Importer vorgenommen werden.
  </em>
  <br/>
  <br/>
  Webservice Url<br>
  <spt:text name="wsurl" readonly="false" size="80"/><br/>
  CMS-Key<br>
  <spt:text name="cms" readonly="true" size="80"/><br/>
  Nutzer-Nummer<br>
  <spt:text name="user" readonly="true" size="80"/><br/>
</sp:io>

• Es muss folgendes Template mit dem Anchor 'formsolutions.template.form' angelegt sein:

<sp:io type="in">
  Formular-Nummer<br/>
  <spt:text name="fs_fnr"/><br/>
  Anzahl der Seiten<br/>
  <spt:text name="fs_pagecount"/><br/>
  Erzeugt am<br/>
  <spt:text name="fs_created"/><br/>
  Letzte Änderung am<br/>
  <spt:text name="fs_changed"/><br/>
  Bemerkung<br/>
  <spt:text name="fs_bem"/><br/>
  Beschreibung<br/>
  <spt:text name="fs_beschr"/><br/>
  Typ<br/>
  <spt:text name="fs_type"/><br/>
</sp:io>

• Es muss der Form-Solutions Import eingerichtet sein. Um den Import einrichten zu können müssen von dem Kunden folgende Informationen bereit gestellt werden:
  • CMS-Key des Kunden-Accounts
  • Kunden-Account: Login und Passwort

Einschränkungen

• Ist für den Redakteur der Form-Solutions-Server nicht erreichbar (z.B. kein Zugang zum Internet) können keine erweiterten Konfigurationen für die Formulare vorgenommen werden.
• Werden im Form-Solutions-Server Formulare gelöscht, werden die Artikel, die diese Formulare im CMS abbilden auch gelöscht. Die für die einzelnen Artikel generierten URL bleiben im System. Über Template-Logik kann aber, wenn gewünscht, darauf reagiert werden. Alle Artikel, die mit einem gelöschten Formular verlinkt wurden, werden nach dem löschen des Formulars neu generiert.
• Eine übergreifende Konfiguration der generierten Formular-URL's wie z.B. 'Alle Formulare sollen jetzt einen Barcode enthalten' ist über das CMS nicht möglich.

Attribute

Name	Type	Required	Default	ab IES Version
name	Variable	Ja	nein	2.0.3.15
type	Linktyp	Nein	link	2.0.3.15
pools	Anchor-List oder ID-List	Nein	!{formsolutions}	2.0.3.15
locale	Text	Nein	default	2.0.3.15
size	Number	Nein	50	2.0.3.15
width	Number	Nein	Wert des Mediums	2.0.3.15
height	Number	Nein	Wert des Mediums	2.0.3.15
showTree	Text	Nein	true	2.0.3.15

name

Name der Variable, unter der die Verknüpfung in die Datenbank geschrieben wird.

type

Typ der Verlinkung

systemlink

bei Änderung des verlinkten Artikels wird der verlinkende Artikel neu publiziert.

navlink

bei Änderung des verlinkenden Artikels wird der verlinkte neu publiziert.

resultlink

wird auf eine Suchabfrage verlinkt wird bei Änderung der Suchabfrage der verlinkende Artikel neu publiziert.

link

es erfolgt keine Aktualisierung in irgendeine Richtung.

pools

Kommaseparierte Liste mit Anchors von Artikelpools oder mit IDs von Artikelpools; die Elemente der Pools werden dem Redakteur zur Auswahl angeboten.

locale

Diese Attribut bestimmt die Mehrsprachigkeit der Variable.

size

HTML-size Wert des von spt:link erzeugten Eingabefeldes.

width

Bei type="image" kann durch dieses Attribut der 'width'-Wert des generierten <img ...>-Tags gesetzt werden.

height

Bei type="image" kann durch dieses Attribut der 'height'-Wert des generierten <img ...>-Tags gesetzt werden.

showTree

wenn false, werden nur die im Attribut pools übergebenen Einsprungpunkte in der Baumansicht angezeigt (ohne Aufklappmöglichkeit und ohne Kinder)

Beispiel

<sp:io type="in">
  Im Iterator<br>
  <spt:iterator name="form_it">
    Formular<br/>
    <spt:formsolutions name="fs_link"/>
  </spt:iterator>
</sp:io>
<sp:io type="out"><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
  <head>
    <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  </head>
  <body>
    <sp:loop collection="form_it" item="it">
      <a href="<sp:print name="it.fs_link.url"/>"><sp:print name="it.fs_link.link.name"/></a>
      <br>  
    </sp:loop>
  </body>
</html>
</sp:io>