Seitenhistorie

Die getForms Operation gibt die gespeicherten Formulare Formulareingänge zurück.

Wichtig: Ein Field bzw. dessen ID kann nur einmal verwendet werden. Es darf also nicht zweimal "PLZ" im selben Request gebraucht werden.

Request Struktur

Codeblock

language	html/xml

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.eforms.jaxfront.com/">
   <soapenv:Header>
      <ws:token>?</ws:token>
   </soapenv:Header>
   <soapenv:Body>
      <ws:getForms>
         <formId>?</formId>
         <dbmResource>?</dbmResource>
         <pageSize>?</pageSize>
         <offset>?</offset>
         <countTotal>?</countTotal>
         <includeXML>?</includeXML>
         <resultFields>?</resultFields>
         <search>
            <field id="?">
               <condition>?</condition>
               <orClauseGroup>?</orClauseGroup>
               <sortOrder>?</sortOrder>
               <value>?</value>
            </field>
         </search>
         <update>
            <state>?</state>
     ws:getForms>
    </update>
      </ws:getForms>
   </soapenv:Body>
</soapenv:Envelope>

Element	Default	Beschreibung

token Zugangsschlüssel zur Authentisierung

formId

Formular

	ID des Formulars
dbmResource

Absoluter

DBM Pfad

Pfad zu einem DBM. Beispiel: resources/MANDANT/FormularXY/special_search.dbm
pageSize	100	Anzahl Zeilen
offset	0	Anzahl der Zeilen, die übersprungen werden sollen.
countTotal	false	Liest alle Zeilen und gibt die Anzahl in der Response zurück.
includeXML	false	Definiert, ob das xmlField zurückgegeben werden soll.
checkPDF	false	Definiert, das überprüft werden soll, ob für ein Formular ein PDF existiert. Die einzelnen PDF müssen dann über einen Rest-Aufruf konsumiert werden.
checkAttachment	false	Definiert, das überprüft werden soll, ob für das Formular Beilagen existieren. Die einzelnen Attachments müssen dann über einen Rest-Aufruf konsumiert werden.
resultFields	* (alle)	Im XMLDBMapping definierte Felder, welche zurückgegeben werden sollten.
id

Field-

id

ID gemäss XMLDBMapping

value

	Wert, nachdem in dem Feld gesucht werden soll. Standardmässig werden die Suchabfragen mit AND verknüpft ausser es wird eine orClauseGroup angegeben.
condition	=	Wie der Wert gesucht werden soll (=, <>, >, <, >=, <=, LIKE

, BETWEEN

, IN), erläutert unter "Mögliche Operatoren für Condition"

orClauseGroup

Identifikation für

mind

mindestens 2 searchFields, welche mit OR selektiert werden sollen. Siehe "Eingeschränkte Abfrage mit Verwendung der orClauseGroup".
sortOrder	asc	Sortierung aufsteigend/absteigend (asc/desc)

Response Struktur

Mögliche Operatoren für Condition

Operator	Beschreibung	Beispiel
=	Gleich
<>	Nicht gleich
>	Grösser als
<	Kleiner als
>=	Grösser gleich
<=	Kleiner gleich
LIKE	Ähnlich wie. Suchbegriff muss mit den Wildcards % oder * umgeben sein.	<value>formular</value>
MULTI_LIKE	Wenn der Operand entweder ähnlich wie einer angegebenen Werten ist. Die Zahlenwerte müssen per "_;_" getrennt werden.	<value>BL_;_XX_;_GL</value> wenn LIKE %BL%, %XX% und %GL% gesucht werden soll.
IN	Wenn der Operand gleich ist wie einer aus einer Liste von Werten. WICHTIG: Kein Whitespace zwischen den Werten und Single-Quotes verwenden	<value>'BegriffEins','Test','weitererBegriff'</value>
BETWEEN	Wenn der Operand zwischen den beiden Zahlenwerten ist. Die Zahlenwerte müssen per Komma oder "_;_" getrennt werden.	<value>5000,6000</value> wenn 5221 gesucht wird.
CUSTOM	Eigene Where-Bedingung, erlaubt komplexe Abfragen mit Verschachtelungen.	<value>PLZ > 3000 AND PLZ < 3100 AND PLZ not like '%50%'</value>
NOT [Operator]	Kann als Prefix zur Verneinung eines Operators verwendet werden, z.B.: NOT LIKE

Response Struktur

Codeblock

language	html/xml

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:getFormsResponse xmlns:ns2="http://ws.eforms.jaxfront.com/">

Codeblock

language	html/xml

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:getFormsResponse xmlns:ns2="http://ws.eforms.jaxfront.com/">
         <result>
            <info>
               <hasNext>?</hasNext>
               <offset>?</offset>
               <pageSize>?</pageSize>
               <size>?</size>
               <totalSize>?</totalSize>
            </info>
            <row><result>
               <field id="?">?</field>
 <info>
           </row>
         <hasNext>?</result>
hasNext>
            </ns2:getFormsResponse>
   </S:Body>
</S:Envelope>

Element	Beschreibung
hasNext	toalSize - offset > pageSize
offset	Definiertes offset
pageSize	Definierte pageSize
size	Effektiv zurükgebene Anzahl Zeilen
totalSize	Total gelesene Zeilen
field	Wert
id	Field-id gemäss XMLDBMapping

Beispiele anhand des PLZ Registers

XMLDBMapping PLZ Register

Codeblock

language	html/xml
title	XMLDBMapping example (PLZ)

<XMLDBMapping openLinkSupported="false" 
 performInitialSearch="false"
 sortOrder="desc" tableName="PLZ" useColumnChooser="false"
 uuidFieldName="ONO"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="xmlDBMapping.xsd">
	<field>
  		<id>Name</id>
  		<columnName>PLACE_LONG</columnName>
  		<showAsFilter>true</showAsFilter>
  		<showAsColumn>true</showAsColumn>
 	</field>
 	<field>
  		<id>PLZ</id>
  		<columnName>PLZ</columnName>
  		<showAsFilter>false</showAsFilter>
  		<showAsColumn>true</showAsColumn>
 	</field>
 	<field>
  		<id>Canton</id>
  		<columnName>CANTON</columnName>
  		<showAsFilter>true</showAsFilter>
  		<showAsColumn>true</showAsColumn>
 	</field>
</XMLDBMapping>

...

<offset>?</offset>
               <pageSize>?</pageSize>
               <size>?</size>
               <totalSize>?</totalSize>
            </info>
            <row>
               <field id="?">?</field>
            </row>
         </result>
      </ns2:getFormsResponse>
   </S:Body>
</S:Envelope>

Element	Beschreibung
hasNext	toalSize - offset > pageSize
offset	Definiertes offset
pageSize	Definierte pageSize
size	Effektiv zurükgebene Anzahl Zeilen
totalSize	Total gelesene Zeilen
field	Wert des Feldes
id	Field-id gemäss XMLDBMapping

Beispiele anhand des PLZ Registers

XMLDBMapping PLZ Register

Codeblock

language	html/xml
title	Request	XMLDBMapping example (PLZ)

<XMLDBMapping openLinkSupported="false" 
 performInitialSearch="false"
 sortOrder="desc" tableName="PLZ" useColumnChooser="false"
 uuidFieldName="ONO"
 xmlns:xsi<soapenv:Envelope xmlns:soapenv="http://schemaswww.xmlsoapw3.org/soap/envelope/2001/XMLSchema-instance" xmlnsxsi:wsnoNamespaceSchemaLocation="http://ws.eforms.jaxfront.com/">
   <soapenv:Header>
      <ws:token>b86d157d-491f-4af0-b0ad-0141c8fe480c</ws:token>
   </soapenv:Header>
   <soapenv:Body>
      <ws:getForms>
         <formId>ZIP</formId>
         <countTotal>true</countTotal>
         <pageSize>10</pageSize>
         <offset>5329</offset>
      </ws:getForms>
   </soapenv:Body>
</soapenv:Envelope>xmlDBMapping.xsd">
	<field>
  		<id>Name</id>
  		<columnName>PLACE_LONG</columnName>
  		<showAsFilter>true</showAsFilter>
  		<showAsColumn>true</showAsColumn>
 	</field>
 	<field>
  		<id>PLZ</id>
  		<columnName>PLZ</columnName>
  		<showAsFilter>false</showAsFilter>
  		<showAsColumn>true</showAsColumn>
 	</field>
 	<field>
  		<id>Canton</id>
  		<columnName>CANTON</columnName>
  		<showAsFilter>true</showAsFilter>
  		<showAsColumn>true</showAsColumn>
 	</field>
</XMLDBMapping>

Seitenweise Abfragen

Codeblock

language	html/xml
title	ResponseRequest

<S<soapenv:Envelope xmlns:Ssoapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:getFormsResponse xmlns:ns2ws="http://ws.eforms.jaxfront.com/">
         <result>
            <info>
               <hasNext>false</hasNext>
               <offset>5329</offset>.com/">
   <soapenv:Header>
               <pageSize>10</pageSize><ws:token>b86d157d-491f-4af0-b0ad-0141c8fe480c</ws:token>
               <size>2</size>
   </soapenv:Header>
   <soapenv:Body>
         <totalSize>5331</totalSize><ws:getForms>
            </info><formId>ZIP</formId>
            <row><countTotal>true</countTotal>
         <pageSize>10</pageSize>
      <field id="Name">Lausanne 1 Dépôt<<offset>5329</field>offset>
      </ws:getForms>
   </soapenv:Body>
</soapenv:Envelope>

Codeblock

language	html/xml
title	Response

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">       <field id="PLZ">1000</field>
   <S:Body>
            <field id="Canton">VD</field><ns2:getFormsResponse xmlns:ns2="http://ws.eforms.jaxfront.com/">
            </row><result>
            <row><info>
               <field id="Name">Lausanne</field><hasNext>false</hasNext>
               <field id="PLZ">1000</field><offset>5329</offset>
               <field id="Canton">VD</field>
<pageSize>10</pageSize>
               <<size>2</row>size>
         </result>
       <totalSize>5331</totalSize>
     </ns2:getFormsResponse>
     </S:Body>
</S:Envelope>

Eingeschränkte Abfrage

Codeblock

language	html/xml
title	Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.eforms.jaxfront.com/"> </info>
   <soapenv:Header>
      <ws:token>b86d157d-491f-4af0-b0ad-0141c8fe480c</ws:token>
   </soapenv:Header><row>
   <soapenv:Body>
      <ws:getForms>
      <field id="Name">Lausanne 1 <formId>ZIP<Dépôt</formId>field>
               <field id="PLZ">1000</field>
  <countTotal>true</countTotal>
         <search>
    <field id="Canton">VD</field>
       <field id ="PLZ">   </row>
            <row>
                <value>9656</value><field id="Name">Lausanne</field>
               <condition>>=</condition>
<field id="PLZ">1000</field>
                <sortOrder>desc</sortOrder><field id="Canton">VD</field>
            </field>row>
         </search>result>
      </wsns2:getForms>getFormsResponse>
   </soapenvS:Body>
</soapenvS:Envelope>

Eingeschränkte Abfrage

Codeblock

language	html/xml
title	ResponseRequest

<S<soapenv:Envelope xmlns:Ssoapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:getFormsResponse xmlns:ns2ws="http://ws.eforms.jaxfront.com/">
   <soapenv:Header>
      <result><ws:token>b86d157d-491f-4af0-b0ad-0141c8fe480c</ws:token>
   </soapenv:Header>
         <info><soapenv:Body>
      <ws:getForms>
         <hasNext>false<<formId>ZIP</hasNext>formId>
               <offset>0</offset><countTotal>true</countTotal>
         <search>
      <pageSize>100</pageSize>
      <field id ="PLZ">       <size>3</size>
        
       <totalSize>3</totalSize>
            </info><value>9656</value>
            <row>
   <condition>>=</condition>
            <field id="PLZ">9658</field>
     <sortOrder>desc</sortOrder>
          <field id="Name">Wildhaus<  </field>
         </search>
      </ws:getForms>
   </soapenv:Body>
</soapenv:Envelope>

Codeblock

language	html/xml
title	Response

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body><field id="Canton">SG</field>
            </row>
            <row>
               <field id="PLZ">9657</field><ns2:getFormsResponse xmlns:ns2="http://ws.eforms.jaxfront.com/">
         <result>
      <field id="Name">Unterwasser</field>      <info>
               <field id="Canton">SG</field>
<hasNext>false</hasNext>
               <<offset>0</row>offset>
            <row>   <pageSize>100</pageSize>
               <field id="PLZ">9656</field><size>3</size>
               <field id="Name">Alt St. Johann</field><totalSize>3</totalSize>
            </info>
   <field id="Canton">SG</field>
         <row>
     </row>
           </result><field id="PLZ">9658</field>
      </ns2:getFormsResponse>
   </S:Body>
</S:Envelope>

Eingeschränkte Abfrage mit Verwendung der orClauseGroup

Codeblock

language	html/xml
title	Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.eforms.jaxfront.com/">
   <soapenv:Header>
         <field id="Name">Wildhaus</field>
               <field id="Canton">SG</field>
         <ws:token>b86d157d-491f-4af0-b0ad-0141c8fe480c</ws:token>
   </soapenv:Header>row>
   <soapenv:Body>
       <ws:getForms>
  <row>
       <formId>ZIP</formId>
         <countTotal>true</countTotal><field id="PLZ">9657</field>
         <search>
            <field id ="PLZ"> Name">Unterwasser</field>
              
 <field id="Canton">SG</field>
             <value>6085<</value>row>
            <row>
   <condition>></condition>
               <orClauseGroup>OR1</orClauseGroup><field id="PLZ">9656</field>
            </field>
   <field id="Name">Alt   St. Johann</field>
     <field id ="Name">        <field id="Canton">SG</field>
      
      </row>
         <value>Schangnau<</value>result>
      </ns2:getFormsResponse>
   </S:Body>
</S:Envelope>

Eingeschränkte Abfrage mit Verwendung der orClauseGroup

Codeblock

language	html/xml
title	Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.eforms.jaxfront.com/">
   <soapenv:Header>      <condition>=</condition>
               <orClauseGroup>OR1</orClauseGroup>
            </field>
            <field id ="Canton">               
               <value>BE</value>
               <condition>=</condition>
    <ws:token>b86d157d-491f-4af0-b0ad-0141c8fe480c</ws:token>
   </soapenv:Header>
   <soapenv:Body>
        </field><ws:getForms>
         <<formId>ZIP</search>formId>
      </ws:getForms>
   </soapenv:Body>
</soapenv:Envelope>

Resultierende Query (Pseudo): ... WHERE (PLZ > '6085' OR PLACE_LONG= 'Schangnau') AND CANTON = 'BE'

Codeblock

language	html/xml
title	Response

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
<countTotal>true</countTotal>
         <search>
            <field id="PLZ">               
              <ns2:getFormsResponse xmlns:ns2="http://ws.eforms.jaxfront.com/">
 <value>6085</value>
           <result>    <condition>></condition>
            <info>
   <orClauseGroup>OR1</orClauseGroup>
            <hasNext>false<</hasNext>field>
            <field id  <offset>0</offset>
 ="Name">               <pageSize>100</pageSize>
               <size>2<<value>Schangnau</size>value>
               <totalSize>2<<condition>=</totalSize>condition>
              < <orClauseGroup>OR1</info>orClauseGroup>
            <row></field>
               <field id ="PLZ">6197</field>
 Canton">              <field id="Name">Schangnau</field>
               <field id="Canton">BE</field>
<value>BE</value>
               <condition>=</row>condition>
            <row>
       </field>
        <field id="PLZ">6086</field> </search>
      </ws:getForms>
   </soapenv:Body>
</soapenv:Envelope>

Resultierende Query (Pseudo): ... WHERE (PLZ > '6085' OR PLACE_LONG= 'Schangnau') AND CANTON = 'BE'

Codeblock

language	html/xml
title	Response

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <field id="Name">Hasliberg Reuti</field>
               <field id="Canton">BE</field><ns2:getFormsResponse xmlns:ns2="http://ws.eforms.jaxfront.com/">
         <result>
   </row>
         </result><info>
      </ns2:getFormsResponse>
   </S:Body>
</S:Envelope>

Abfrage der JAXForms Standard-Formulare (Standard XMLDBMapping)

Wenn keine formId und dbmResource angegeben werden, werden die Standard JAXForms Formulare abgefragt.

Codeblock

language	html/xml
title	Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.eforms.jaxfront.com/">
   <soapenv:Header>
      <ws:token>30de6360-c1e4-4e72-a3c2-b0b7f0f2b2b1</ws:token>
   </soapenv:Header>
   <soapenv:Body>         <hasNext>false</hasNext>
               <offset>0</offset>
               <pageSize>100</pageSize>
               <size>2</size>
               <totalSize>2</totalSize>
      <ws:getForms>
      </info>
   <countTotal>true</countTotal>
         <includeXML>false</includeXML><row>
         <resultFields>Type,Sender</resultFields>
      <field id="PLZ">6197</field>
   <search>
            <field id ="Type">Name">Schangnau</field>
               <field id="Canton">BE</field>
            </row>
   <value>DEMO-FEEDBACK</value>
         <row>
   </field>
            <field id ="Sender">PLZ">6086</field>
               <field id="Name">Hasliberg Reuti</field>
               <value>rwu@jaxfront.com</value><field id="Canton">BE</field>
            </field>row>
         </search>result>
      </wsns2:getForms>getFormsResponse>
   </soapenvS:Body>
</soapenvS:Envelope>

Abfrage der JAXForms Standard-Formulare (Standard XMLDBMapping)

Wenn keine formId und dbmResource angegeben werden, werden die Standard JAXForms Formulare abgefragt.

Codeblock

language	html/xml
title	ResponseRequest

<S<soapenv:Envelope xmlns:Ssoapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:getFormsResponse xmlns:ns2ws="http://ws.eforms.jaxfront.com/">
   <soapenv:Header>
      <result><ws:token>30de6360-c1e4-4e72-a3c2-b0b7f0f2b2b1</ws:token>
            <info></soapenv:Header>
               <hasNext>false</hasNext><soapenv:Body>
      <ws:getForms>
         <offset>0<<countTotal>true</offset>countTotal>
         <includeXML>false</includeXML>
      <pageSize>100</pageSize>
   <resultFields>Type,Sender</resultFields>
         <search>
   <size>1</size>
         <field id ="Type">    <totalSize>1</totalSize>
            </info>
            <row>
   <value>DEMO-FEEDBACK</value>
            <field id="Type">DEMO-FEEDBACK<</field>
               <field id ="Sender">rwu@jaxfront.com</field>
>               </row>
           </result>    <value>rwu@jaxfront.com</value>
            </ns2:getFormsResponse>field>
   </S:Body>
</S:Envelope>

...

      </search>
      </ws:getForms>
   </soapenv:Body>
</soapenv:Envelope>

Codeblock

language	html/xml
title	Response

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:getFormsResponse xmlns:ns2="http://ws.eforms.jaxfront.com/">
         <result>
            <info>
               <hasNext>false</hasNext>
               <offset>0</offset>
               <pageSize>100</pageSize>
               <size>1</size>
               <totalSize>1</totalSize>
            </info>
            <row>
               <field id="Type">DEMO-FEEDBACK</field>
               <field id="Sender">rwu@jaxfront.com</field>
            </row>
         </result>
      </ns2:getFormsResponse>
   </S:Body>
</S:Envelope>

Seitenhierarchie

Versionen im Vergleich

Alte Version 48

Neue Version Aktuell

Schlüssel

Request Struktur

Response Struktur

Mögliche Operatoren für Condition

Response Struktur

Beispiele anhand des PLZ Registers

Beispiele anhand des PLZ Registers

Seitenweise Abfragen

Eingeschränkte Abfrage

Eingeschränkte Abfrage

Eingeschränkte Abfrage mit Verwendung der orClauseGroup

Eingeschränkte Abfrage mit Verwendung der orClauseGroup

Abfrage der JAXForms Standard-Formulare (Standard XMLDBMapping)

Abfrage der JAXForms Standard-Formulare (Standard XMLDBMapping)