Formsolutions (SPT-Tag): Unterschied zwischen den Versionen

Aus SiteparkWiki
Zur Navigation springen Zur Suche springen
 
(20 dazwischenliegende Versionen von 4 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
 
==Name==
 
==Name==
−
<spt:formsolutions> - Verknüpfung von Form-Solutions Formularen mit Artikeln
+
<spt:formsolutions> (ab Version 2.0.3.15) - Erzeugt eine eindeutige Url auf PDF-Dokumente des Form-Solutions Formular Servers.
  
 
==Syntax==
 
==Syntax==
 
<source lang="xml">
 
<source lang="xml">
−
<sp:formsolutions name="variable"/>
+
<spt:formsolutions name="variable"/>
−
</source>  
+
</source>
  
 
==Beschreibung==
 
==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 (zweiter Button, die Seite öffnet sich in einem Popup-Fenster).
+
Über ein Popup-Fenster kann ein Formsolutions-Formular recherchiert und ausgewählt werden [[Bild:Icn_formsolutions_edit.png]]. Für das ausgewählte Formular können zusätzliche Eigenschaften für diese Verknüpfung konfiguriert werden. Nach Abschluss der Konfiguration wird das Popup-Fenster geschlossen und die URL auf das PDF Dokument an dem IES-Artikel hinterlegt. Eine Vorschau des Dokumentes kann mit dem Button [[Bild:Icn_view.png‎]] angezeigt werden.  
−
 
 
−
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.
 
−
 
 
−
==Verwendung der Verknüpfung==
 
−
Das verknüpfte Formular kann über das <code>link</code>-Attribut erlangt werden. Beispielsweise wurde mit folgendem Template eine Verknüpfung erzeugt:
 
−
<source lang="xml">
 
−
<sp:io type="in">
 
−
  <sp:formsolutions name="formlink"/>
 
−
</sp:io>
 
−
</source>
 
−
Das Formular ist immer ein Resource-Artikel und kann über <code>formlink.link</code> angesprochen werden. Da die URL des Formulares für jede Verknüpfung angelegt wird, wird die URL nicht über <code>formlink.link</code>, sondern über <code>formlink.url</code> ausgebeben. Für das Formular stehen folgende Felder zur Verfügung:
 
−
{| class="prettytable"
 
−
|- class="hintergrundfarbe1"
 
−
! Feldname || Beschreibung
 
−
|-
 
−
| <code>formlink.link</code>
 
−
| Formular-Resource-Artikel
 
−
|-
 
−
| <code>formlink.link.fs_fnr</code>
 
−
| Eindeute ID des Formulares
 
−
|-
 
−
| <code>formlink.link.fs_pagecount</code>
 
−
| Anzahl der Seiten des Formulars
 
−
|-
 
−
| <code>formlink.link.fs_created</code>
 
−
| Datum an dem das Formular erstellt wurde (Format DD-MM-YYYY)
 
−
|-
 
−
| <code>formlink.link.fs_changed</code>
 
−
| Datum an dem das Formular das letzte mal geändert wurde (Format DD-MM-YYYY)
 
−
|-
 
−
| <code>formlink.link.fs_beschr</code>
 
−
| Beschreibung zu dem Formular
 
−
|-
 
−
| <code>formlink.link.fs_type</code>
 
−
| Gibt an, ob das Formular ein Form-Solutions eigenes Formular ist (type=fs) oder ob es vom Kunden angelegt wurde (type=knd)
 
−
|-
 
−
| <code>formlink.url</code>
 
−
| 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 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==
+
Siehe auch [[FormSolutions Schnittstelle]]
−
* 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==
 
==Attribute==
−
{| class="prettytable"
+
{| class="prettytable sortable"
 
|- class="hintergrundfarbe1"
 
|- class="hintergrundfarbe1"
 
! Name || Type || Required || Default || ab IES Version
 
! Name || Type || Required || Default || ab IES Version
 
|-
 
|-
−
| <code>xxx</code>
+
| <code>name</code>
−
| [[Attribute]]
+
| [[Variable]]
 
| Ja
 
| Ja
−
| None
+
| nein
−
| 1
+
| 2.0.3.15
 
|-
 
|-
−
| <code>xxx</code>
+
| <code>locale</code>
 
| [[Text]]
 
| [[Text]]
 
| Nein
 
| Nein
−
| None
+
| default
−
| 1
+
| 2.0.3.15
−
|-
 
−
| <code>xxx</code>
 
−
| [[Expression]]
 
−
| Nein
 
−
| None
 
−
| 1
 
−
|-
 
−
| <code>xxx</code>
 
−
| [[Locale]]
 
−
| Nein
 
−
| None
 
−
| 1
 
 
|}
 
|}
  
−
;<code>xxx</code>
+
;<code>name</code>
−
:xxx.
+
:Name der Variable, unter der die Verknüpfung in die Datenbank geschrieben wird.
  
−
;<code>xxx</code>
+
;<code>locale</code>
−
:xxx.
+
:Diese Attribut bestimmt die Mehrsprachigkeit der Variable.
  
−
==Beispiele==
+
==Beispiel==
−
 
 
−
===Beispiel A===
 
−
 
 
−
Template Quelltext
 
 
<source lang="xml">
 
<source lang="xml">
−
xxx
+
<sp:io type="in">
−
</source>
+
  Im Iterator<br>
−
 
+
  <spt:iterator name="form_it">
−
Ausgabe
+
    Formular<br/>
−
<source lang="text">
+
    <spt:formsolutions name="fs_link"/>
−
xxx
+
  </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.text"/> (<sp:print name="it.fs_link_formularId"/>)</a>
 +
      <br> 
 +
    </sp:loop>
 +
  </body>
 +
</html>
 +
</sp:io>
 
</source>
 
</source>
−
 
−
===Beispiel B===
 
−
 
−
Template Quelltext
 
−
<source lang="xml">
 
−
xxx
 
−
</source>
 
−
 
−
Ausgabe
 
−
<source lang="text">
 
−
xxx
 
−
</source>
 
−
 
  
 
<noinclude>
 
<noinclude>

Aktuelle Version vom 8. Juni 2015, 13:53 Uhr

Name

<spt:formsolutions> (ab Version 2.0.3.15) - Erzeugt eine eindeutige Url auf PDF-Dokumente des Form-Solutions Formular Servers.

Syntax

<spt:formsolutions name="variable"/>

Beschreibung

Über ein Popup-Fenster kann ein Formsolutions-Formular recherchiert und ausgewählt werden Icn formsolutions edit.png. Für das ausgewählte Formular können zusätzliche Eigenschaften für diese Verknüpfung konfiguriert werden. Nach Abschluss der Konfiguration wird das Popup-Fenster geschlossen und die URL auf das PDF Dokument an dem IES-Artikel hinterlegt. Eine Vorschau des Dokumentes kann mit dem Button Icn view.png angezeigt werden.

Siehe auch FormSolutions Schnittstelle

Attribute

Name Type Required Default ab IES Version
name Variable Ja nein 2.0.3.15
locale Text Nein default 2.0.3.15
name
Name der Variable, unter der die Verknüpfung in die Datenbank geschrieben wird.
locale
Diese Attribut bestimmt die Mehrsprachigkeit der Variable.

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.text"/> (<sp:print name="it.fs_link_formularId"/>)</a>
      <br>  
    </sp:loop>
  </body>
</html>
</sp:io>
Abgerufen von „https://wiki.sitepark.com/index.php?title=Formsolutions_(SPT-Tag)&oldid=7429“