SOAP - API-Dokumentation

Der Veranstaltungskalender verfügt über eine SOAP-Schnittstelle. Damit können andere Programme definierte Funktionen des Veranstaltungskalenders ausführen (z.B. Listen von Personen und Orte abrufen, Orte und Personen anlegen bzw. ändern.)

Die SOAP-Schnittstelle ist primär für das Erstellen und Ändern von Veranstaltungen konzipiert, nicht für den Abruf oder Export von Veranstaltungen. Dies lässt sich einfacher über die XML- oder JSON-Schnittstelle realisieren (siehe hierzu Anzeige im Internet - XML und JSON).
Zusätzliche Aufrufe, um Konfigurationen abzurufen finden Sie hier: Weitere XML / JSON Daten

Für die Authentifizierung der SOAP-Schnittstelle ist ein API-Key erforderlich, den Sie unter http://www.evangelische-termine.de/Admin/apidoc erstellen, bzw. abrufen können. Dort finden Sie auch ein Beispiel für einen SOAP-PHP-Client.

API-Dokumentation

Endpoint URI: http://www.evangelische-termine.de/soap

WSDL URI: http://www.evangelische-termine.de/soap?WSDL

Beispiele für einen PHP-Client finden Sie auf GitHub: https://github.com/vernetztekirche/ET-Soap-Examples

Complex types:

Public methods:

Complex types

Config

Konfigurations-Element

  • string key (nillable = false, minoccurs = 1, maxoccurs = 1)
    Key-Wert
  • string value (nillable = false, minoccurs = 1, maxoccurs = 1)
    Value

ConfigArray

This is an array type of Config.

Array der Parameter

channel

Kanal

  • int id (nillable = true, minoccurs = 1, maxoccurs = 1)
    eindeutige ID (primary Key)
  • int userid (nillable = true, minoccurs = 1, maxoccurs = 1)
    Veranstalter-Id
  • string title (nillable = true, minoccurs = 1, maxoccurs = 1)
    Bezeichnung
  • string description (nillable = true, minoccurs = 1, maxoccurs = 1)
    Beschreibung
  • int destination (nillable = true, minoccurs = 1, maxoccurs = 1)
    Reichweite (privat = 0 | regional = 1)

channelArray

This is an array type of channel.

Array der Kanäle

etdate

Termin etdate Terminobject

  • int id (nillable = true, minoccurs = 1, maxoccurs = 1)
    eindeutige Termin-ID (ID)
  • string start (nillable = true, minoccurs = 1, maxoccurs = 1)
    Startdatum im Format YYYY-MM-DD HH:II:SS
  • string end (nillable = true, minoccurs = 1, maxoccurs = 1)
    Enddatum im Format YYYY-MM-DD HH:II:SS
  • string mode (nillable = true, minoccurs = 1, maxoccurs = 1)
    Start-End-Modus vonbis|jeweils
  • string eventid (nillable = false, minoccurs = 1, maxoccurs = 1)
    eindeutige Stammdaten-ID (_event_ID)
  • string subtitle (nillable = true, minoccurs = 1, maxoccurs = 1)
    Untertitel
  • string externalid (nillable = true, minoccurs = 1, maxoccurs = 1)
    externe ID

event

Veranstaltung event

  • int id (nillable = true, minoccurs = 1, maxoccurs = 1)
    eindeutige Termin-ID (ID)
  • string externalid (nillable = true, minoccurs = 1, maxoccurs = 1)
    Externe Termin-ID (date)
  • string start (nillable = true, minoccurs = 1, maxoccurs = 1)
    Startdatum im Format YYYY-MM-DD HH:II:SS
  • string end (nillable = true, minoccurs = 1, maxoccurs = 1)
    Enddatum im Format YYYY-MM-DD HH:II:SS
  • string mode (nillable = true, minoccurs = 1, maxoccurs = 1)
    Start-End-Modus vonbis|jeweils
  • int eventid (nillable = true, minoccurs = 1, maxoccurs = 1)
    eindeutige Stammdaten-ID (_event_ID)
  • string eventexternalid (nillable = true, minoccurs = 1, maxoccurs = 1)
    Externe Stammdaten-ID (_event_EXTERNAL_ID)
  • int inputmaskid (nillable = false, minoccurs = 1, maxoccurs = 1)
    Eingabeformular-ID
  • string title (nillable = true, minoccurs = 1, maxoccurs = 1)
    Veranstaltungstitel (_event_TITLE)
  • string subtitle (nillable = true, minoccurs = 1, maxoccurs = 1)
    Veranstaltungs-untertitel (SUBTITLE)
  • string eventtype (nillable = true, minoccurs = 1, maxoccurs = 1)
    Art der Veranstaltung / Kategorie (mit Komma getrennte Ids)
  • string people (nillable = true, minoccurs = 1, maxoccurs = 1)
    Zielgruppe (mit Komma getrennte Ids)
  • string shortdescription (nillable = true, minoccurs = 1, maxoccurs = 1)
    Kurzbeschreibung
  • string longdescription (nillable = true, minoccurs = 1, maxoccurs = 1)
    Ausführliche Beschreibung
  • string link (nillable = true, minoccurs = 1, maxoccurs = 1)
    Internetadresse
  • int kat (nillable = true, minoccurs = 1, maxoccurs = 1)
    Auswahl 1
  • int kat2 (nillable = true, minoccurs = 1, maxoccurs = 1)
    Auswahl 2
  • string email (nillable = true, minoccurs = 1, maxoccurs = 1)
    E-Mailadresse
  • int personid (nillable = true, minoccurs = 1, maxoccurs = 1)
    ID des Ansprechpartners
  • int placeid (nillable = false, minoccurs = 1, maxoccurs = 1)
    ID des Veranstaltungsortes
  • int regionid (nillable = true, minoccurs = 1, maxoccurs = 1)
    ID der Region 1
  • int subregionid (nillable = true, minoccurs = 1, maxoccurs = 1)
    ID der kirchl. Region (Dekanat / Kirchenkreis)
  • int region2id (nillable = true, minoccurs = 1, maxoccurs = 1)
    ID der Region 2 (Freizeitregion o.a.)
  • int region3id (nillable = true, minoccurs = 1, maxoccurs = 1)
    ID der Region 3 (Komm. Region o.a.)
  • string musickatid (nillable = true, minoccurs = 1, maxoccurs = 1)
    Musikalische Kategorie (mit '-' getrennte ids)
  • string textline1 (nillable = true, minoccurs = 1, maxoccurs = 1)
    Textzeile 1
  • string textline2 (nillable = true, minoccurs = 1, maxoccurs = 1)
    Textzeile 2
  • string textline3 (nillable = true, minoccurs = 1, maxoccurs = 1)
    Textzeile 3
  • string textline4 (nillable = true, minoccurs = 1, maxoccurs = 1)
    Textzeile 4
  • string textline5 (nillable = true, minoccurs = 1, maxoccurs = 1)
    Textzeile 5
  • string textline6 (nillable = true, minoccurs = 1, maxoccurs = 1)
    Textzeile 6
  • string textline7 (nillable = true, minoccurs = 1, maxoccurs = 1)
    Textzeile 7
  • string textline8 (nillable = true, minoccurs = 1, maxoccurs = 1)
    Textzeile 8
  • string textbox1 (nillable = true, minoccurs = 1, maxoccurs = 1)
    Textbox 1
  • string textbox2 (nillable = true, minoccurs = 1, maxoccurs = 1)
    Textbox 2
  • string textbox3 (nillable = true, minoccurs = 1, maxoccurs = 1)
    Textbox 3
  • string number1 (nillable = true, minoccurs = 1, maxoccurs = 1)
    Number 1
  • string number2 (nillable = true, minoccurs = 1, maxoccurs = 1)
    Number 2
  • string menue1 (nillable = true, minoccurs = 1, maxoccurs = 1)
    Selbstdefinierte Auswahl 1; die Werte müssen der Konfiguration der Veranstaltungstypen entsprechen; mit Komma getrennte Ids
  • string menue2 (nillable = true, minoccurs = 1, maxoccurs = 1)
    Selbstdefinierte Auswahl 2; die Werte müssen der Konfiguration der Veranstaltungstypen entsprechen; mit Komma getrennte Ids
  • string yesno1 (nillable = true, minoccurs = 1, maxoccurs = 1)
    Auswahlmenü 1 Ja|Nein
  • string yesno2 (nillable = true, minoccurs = 1, maxoccurs = 1)
    Auswahlmenü 2 Ja|Nein
  • string yesno3 (nillable = true, minoccurs = 1, maxoccurs = 1)
    Auswahlmenü 3 Ja|Nein|zero
  • string professionid (nillable = true, minoccurs = 1, maxoccurs = 1)
    Berufsgruppe (Komma-getrennte Ids)
  • string care (nillable = true, minoccurs = 1, maxoccurs = 1)
    Themen (Komma-getrennte Ids)
  • string coursetype (nillable = true, minoccurs = 1, maxoccurs = 1)
    Kursart
  • string destination (nillable = true, minoccurs = 1, maxoccurs = 1)
    Öffentlich / Intern (extern|intern)
  • string status (nillable = false, minoccurs = 1, maxoccurs = 1)
    Freigabe (ok|standby)
  • int feedbackid (nillable = true, minoccurs = 1, maxoccurs = 1)
    Rückmeldeformular-ID
  • int feedbackmax (nillable = true, minoccurs = 1, maxoccurs = 1)
    Maximale Anzahl an Rückmeldungen
  • string feedbackfrom (nillable = true, minoccurs = 1, maxoccurs = 1)
    Formular online von (Format YYYY-MM-DD)
  • string feedbackto (nillable = true, minoccurs = 1, maxoccurs = 1)
    Formular online bis (Format YYYY-MM-DD)
  • string highlight (nillable = true, minoccurs = 1, maxoccurs = 1)
    Highlight (low|rhigh|high)
  • string channels (nillable = true, minoccurs = 1, maxoccurs = 1)
    Kanäle
  • string resources (nillable = true, minoccurs = 1, maxoccurs = 1)
    Ressourcen
  • string lang (nillable = true, minoccurs = 1, maxoccurs = 1)
    Sprache(n) (deu|eng|fra|ital) mit Komma getrennt
  • string access (nillable = true, minoccurs = 1, maxoccurs = 1)
    Angaben zur Barrierefreiheit (1|2|3|4|5) mit Komma getrennt
  • int statistik (nillable = true, minoccurs = 1, maxoccurs = 1)
    Angaben zur Statistik (ganzzahliger Wert)

feedback

Feedback (Rückmeldung)

  • int id (nillable = true, minoccurs = 1, maxoccurs = 1)
    Id der Rueckmeldung
  • int dateid (nillable = true, minoccurs = 1, maxoccurs = 1)
    Veranstaltungs-Id (date)
  • string externalid (nillable = true, minoccurs = 1, maxoccurs = 1)
    Externe Veranstaltungs-Id (date)
  • string added (nillable = true, minoccurs = 1, maxoccurs = 1)
    Datum der Rückmeldung
  • string values (nillable = true, minoccurs = 1, maxoccurs = 1)
    Werte als JSON-codierter String. Bitte beachten Sie: Je nach Rückmeldeformular können die Key-Value Werte unterschiedlich sein!
  • string status (nillable = true, minoccurs = 1, maxoccurs = 1)
    Bearbeitungsstatus
  • string info (nillable = true, minoccurs = 1, maxoccurs = 1)
    Info / Notizen
  • int formid (nillable = true, minoccurs = 1, maxoccurs = 1)
    Id des Rückmeldeformulars

feedbackArray

This is an array type of feedback.

Array von Feedbacks (Rückmeldungen)

field

Eigenes Formularfeld

  • int fieldid (nillable = true, minoccurs = 1, maxoccurs = 1)
    Nr. des Feldes (z.B: 12 bei field12 )
  • string eventid (nillable = true, minoccurs = 1, maxoccurs = 1)
    Veranstaltungs-Id (event)
  • string value (nillable = true, minoccurs = 1, maxoccurs = 1)
    Wert

person

Klasse person

  • int id (nillable = true, minoccurs = 1, maxoccurs = 1)
    eindeutige ID (primary Key)
  • int userid (nillable = true, minoccurs = 1, maxoccurs = 1)
    Veranstalter-Id (nur lesbar)
  • string name (nillable = true, minoccurs = 1, maxoccurs = 1)
    Name
  • string email (nillable = true, minoccurs = 1, maxoccurs = 1)
    E-Mailadresse
  • string contact (nillable = true, minoccurs = 1, maxoccurs = 1)
    Kontaktinformationen
  • int position (nillable = true, minoccurs = 1, maxoccurs = 1)
    Position (Reihenfolge der Darstellung, nur lesbar)
  • string destination (nillable = true, minoccurs = 1, maxoccurs = 1)
    Reichweite ('private'|'global')
  • string changed (nillable = true, minoccurs = 1, maxoccurs = 1)
    letzte Änderung (nur lesbar)
  • string externalId (nillable = true, minoccurs = 1, maxoccurs = 1)
    externe ID

personArray

This is an array type of person.

Array der Personen

place

Definition der Klasse place = Veranstaltungsort

  • int id (nillable = true, minoccurs = 1, maxoccurs = 1)
    eindeutige ID (primary Key)
  • int userid (nillable = true, minoccurs = 1, maxoccurs = 1)
    Veranstalter-Id
  • string name (nillable = true, minoccurs = 1, maxoccurs = 1)
    Name
  • string streetNr (nillable = true, minoccurs = 1, maxoccurs = 1)
    Straße und Hausnummer
  • string zip (nillable = true, minoccurs = 1, maxoccurs = 1)
    Postleitzahl
  • string city (nillable = true, minoccurs = 1, maxoccurs = 1)
    postalischer Ort
  • int region (nillable = true, minoccurs = 1, maxoccurs = 1)
    Region
  • string info (nillable = true, minoccurs = 1, maxoccurs = 1)
    Weitere Informationen
  • int kat (nillable = true, minoccurs = 1, maxoccurs = 1)
    Kategorie (10|20|30|40|50|60|70|80|90)
  • string open (nillable = true, minoccurs = 1, maxoccurs = 1)
    Öffnungszeiten
  • string description (nillable = true, minoccurs = 1, maxoccurs = 1)
    Beschreibung der Kirche bei Offenen Kirchen (HTML-Tags erlaubt)
  • string destination (nillable = true, minoccurs = 1, maxoccurs = 1)
    Reichweite (private|global)
  • string image (nillable = true, minoccurs = 1, maxoccurs = 1)
    Bild-Url (nur lesbar)
  • string thumbnail (nillable = true, minoccurs = 1, maxoccurs = 1)
    Thumbnail-Url (nur lesbar)
  • string glat (nillable = true, minoccurs = 1, maxoccurs = 1)
    Geoposition lat
  • string glong (nillable = true, minoccurs = 1, maxoccurs = 1)
    Geoposition long
  • int position (nillable = true, minoccurs = 1, maxoccurs = 1)
    Position (Reihenfolge der Darstellung, nur lesbar)
  • string color (nillable = true, minoccurs = 1, maxoccurs = 1)
    Farbe Format HTML-Hex-Code #XXXXXX
  • string changed (nillable = true, minoccurs = 1, maxoccurs = 1)
    letzte Änderung (nur lesbar)
  • string externalId (nillable = true, minoccurs = 1, maxoccurs = 1)
    externe ID
  • int equip (nillable = true, minoccurs = 1, maxoccurs = unbounded)
    Angaben zur Barrierefreiheit (1 : Rollstuhlgeeignet, 2 : Induktionsanlage für Hörgeräte, 3 : Behinderten WC, 4 : Behindertenparkplatz)
  • string equiptext (nillable = true, minoccurs = 1, maxoccurs = 1)
    Weitere Angaben zur Barrierefreiheit
  • int kat2 (nillable = true, minoccurs = 1, maxoccurs = unbounded)
    Kategorien (je nach Definition, z.B. Kirche liegt an folgenden Pilgerwegen; [etparam.placekat2] )
  • int notpublic (nillable = true, minoccurs = 1, maxoccurs = 1)
    für fremde Verwendung freigegeben 0|1

placeArray

This is an array type of place.

Array der Orte

resource

Resource

  • int id (nillable = true, minoccurs = 1, maxoccurs = 1)
    eindeutige ID (primary Key)
  • int userid (nillable = true, minoccurs = 1, maxoccurs = 1)
    Veranstalter-Id
  • string name (nillable = false, minoccurs = 1, maxoccurs = 1)
    Bezeichnung
  • string description (nillable = true, minoccurs = 1, maxoccurs = 1)
    Beschreibung
  • int color (nillable = true, minoccurs = 1, maxoccurs = 1)
    Farbe
  • string image (nillable = true, minoccurs = 1, maxoccurs = 1)
    Bild

resourceArray

This is an array type of resource.

Array der Ressourcen

soapresult

Ergebnis soapresult

  • int id (nillable = true, minoccurs = 1, maxoccurs = 1)
    eindeutige ID des jeweiligen Objekts bei saveEvent (ID), savePlace, savePerson
  • int eventid (nillable = true, minoccurs = 1, maxoccurs = 1)
    eindeutige Event-ID (_event_ID) bei saveEvent
  • string webformpollid (nillable = true, minoccurs = 1, maxoccurs = 1)
    eindeutige ID des jeweiligen Objekts bei saveWebformPoll
  • string error (nillable = true, minoccurs = 1, maxoccurs = 1)
    Fehlermeldung(en)
  • string report (nillable = true, minoccurs = 1, maxoccurs = 1)
    Report
  • string detail (nillable = true, minoccurs = 1, maxoccurs = 1)
    Details

webform

Webform

  • string id (nillable = true, minoccurs = 1, maxoccurs = 1)
    eindeutige ID (primary Key)
  • string name (nillable = true, minoccurs = 1, maxoccurs = 1)
    Bezeichnung

webformArray

This is an array type of webform.

Array der Formulartypen

webformpoll

WebformPoll (Verwendung eines Formulartyps)

  • string id (nillable = true, minoccurs = 1, maxoccurs = 1)
    eindeutige ID (primary Key)
  • string webformid (nillable = false, minoccurs = 1, maxoccurs = 1)
    eindeutige ID des verwendeten Formulartyps
  • string name (nillable = true, minoccurs = 1, maxoccurs = 1)
    Bezeichnung
  • string dateid (nillable = true, minoccurs = 1, maxoccurs = 1)
    Date-Id | External-date-id der verknüpften Veranstaltung
  • string start (nillable = true, minoccurs = 1, maxoccurs = 1)
    verfügbar ab, Format dd.mm.yyyy
  • string end (nillable = true, minoccurs = 1, maxoccurs = 1)
    verfügbar bis, Format dd.mm.yyyy
  • string storno (nillable = true, minoccurs = 1, maxoccurs = 1)
    vom Nutzer stornierbar bis
  • int resultlimit (nillable = true, minoccurs = 1, maxoccurs = 1)
    max. Anzahl der Anmeldungen
  • int waitinglist (nillable = true, minoccurs = 1, maxoccurs = 1)
    Warteliste 1|0
  • string authuser (nillable = true, minoccurs = 1, maxoccurs = 1)
    Benutzername für Registrierungsfunktion
  • string authpw (nillable = true, minoccurs = 1, maxoccurs = 1)
    Passwort für Registrierungsfunktion
  • int paypal (nillable = true, minoccurs = 1, maxoccurs = 1)
    Paypal-Integration 1|0
  • float baseprice (nillable = true, minoccurs = 1, maxoccurs = 1)
    Grundpreis
  • string message (nillable = true, minoccurs = 1, maxoccurs = 1)
    Hinweis/Meldung nach Abschicken des Formulars
  • string resultviewkeys (nillable = true, minoccurs = 1, maxoccurs = unbounded)
    keys der Felder, die in der Ergebnisübersicht angezeigt werden sollen

webformresult

WebformResult (Webform-Ergebnis)

  • string id (nillable = true, minoccurs = 1, maxoccurs = 1)
    Id des WebformResults
  • int dateid (nillable = true, minoccurs = 1, maxoccurs = 1)
    Veranstaltungs-Id (date)
  • string externalid (nillable = true, minoccurs = 1, maxoccurs = 1)
    Externe Veranstaltungs-Id (date)
  • string created (nillable = true, minoccurs = 1, maxoccurs = 1)
    Datum des WebformResults
  • string storno (nillable = true, minoccurs = 1, maxoccurs = 1)
    Datum der Stornierung
  • string registered (nillable = true, minoccurs = 1, maxoccurs = 1)
    Datum der Registrierung
  • string deleted (nillable = true, minoccurs = 1, maxoccurs = 1)
    Datum der Löschung
  • int stage (nillable = true, minoccurs = 1, maxoccurs = 1)
    Liste: 1 = Hauptliste, 2 = Warteliste, 3 = Storniert, 9 = Gelöscht
  • string values (nillable = true, minoccurs = 1, maxoccurs = 1)
    Werte als JSON-codierter String. Bitte beachten Sie: Je nach Webformular können die Key-Value Werte unterschiedlich sein!
  • string raw (nillable = true, minoccurs = 1, maxoccurs = 1)
    Werte als JSON-codierter String der raw-Values
  • string status (nillable = true, minoccurs = 1, maxoccurs = 1)
    Bearbeitungsstatus
  • string info (nillable = true, minoccurs = 1, maxoccurs = 1)
    Info / Notizen
  • string price (nillable = true, minoccurs = 1, maxoccurs = 1)
    Preis
  • string billnr (nillable = true, minoccurs = 1, maxoccurs = 1)
    Rechnungsnummer
  • string formid (nillable = true, minoccurs = 1, maxoccurs = 1)
    Id des Webformulars
  • string pollid (nillable = true, minoccurs = 1, maxoccurs = 1)
    Id der Verwendung

webformresultArray

This is an array type of webformresult.

Array von webformresults (Webform-Ergebnissen)

Public methods

addEtDate

soapresult addEtDate (
    etdate etdate,
    boolean external
)

Fügt ein neues Datum zu einem Termin hinzu

  • etdate etdate
    Terminobject
  • boolean external
    true, wenn die date->eventid die externalId (event) ist

Return value soapresult: Ergebnis

addEventImage

soapresult addEventImage (
    string eventid,
    string imageurl,
    boolean external,
    string caption
)

Fügt ein Bild zu einer Veranstaltung hinzu. Das Bild muss über das Internet abrufbar sein.
Es wird automatisch auf eine maximale Größe von 300x300 Pixel skaliert.

  • string eventid
    id (int) oder externalid (string) der Veranstaltung (event)
  • string imageurl
    Webadresse des Bildes. Beispiel: http:://www.ihredomain.de/meinBild.png
  • boolean external
    eventid ist externalid
  • string caption
    Bildunterschrift

addEventImageAsEncodedString

soapresult addEventImageAsEncodedString (
    string eventid,
    string imagedata,
    boolean external,
    string caption
)

Fügt ein Bild zu einer Veranstaltung hinzu. Die Bilddaten werden als base64-codierter String übertragen.
Es wird automatisch auf eine maximale Größe von 300x300 Pixel skaliert.

  • string eventid
    id (int) oder externalid (string) der Veranstaltung (event)
  • string imagedata
    Bilddaten als base64-codierter String, png oder jpg
  • boolean external
    eventid ist externalid
  • string caption
    Bildunterschrift

addPlaceImage

soapresult addPlaceImage (
    string placeid,
    string imageurl,
    boolean external,
    string caption
)

Fügt ein Bild zu einem Veranstaltungsort hinzu. Das Bild muss über das Internet abrufbar sein.
Es wird automatisch auf eine maximale Größe von 300x300 Pixel skaliert.

  • string placeid
    ID (int) oder externalid (string) des Veranstaltungsortes
  • string imageurl
    Webadresse des Bildes. Beispiel: http:://www.ihredomain.de/meinBild.png
  • boolean external
    placeid ist externalid
  • string caption
    Bildrechte

addPlaceImageAsEncodedString

soapresult addPlaceImageAsEncodedString (
    string placeid,
    string imagedata,
    boolean external,
    string caption
)

Fügt ein Bild zu einem Ort hinzu. Die Bilddaten werden als base64-codierter String übertragen.
Es wird automatisch auf eine maximale Größe von 300x300 Pixel skaliert.

  • string placeid
    ID (int) oder externalid (string) des Veranstaltungsortes
  • string imagedata
    Bilddaten als base64-codierter String, png oder jpg
  • boolean external
    placeid ist externalid
  • string caption
    Bildrechte

deleteEvent

soapresult deleteEvent (
    string id,
    boolean external
)

Löscht einen Termin
die $id ist der primary Key oder die externalId des date-Objects
Bei einer Reihe wird nur der Einzeltermin gelöscht, bei einer Einzelveranstaltung auch die Stammdaten

  • string id
    ID (int) oder externalId (string) des Termins (date)
  • boolean external
    bei true : id ist die externalId

Return value soapresult: Ergebnis

deletePerson

soapresult deletePerson (
    string id,
    boolean external
)

Löscht einen Ansprechpartner
Nur möglich, wenn der Ansprechpartner nicht mehr mit Veranstaltungen verbunden ist.
Bei Verwendung von $external = true wird der Ansprechpartner anhand der externalId ausgewählt.

  • string id
    ID (int) oder externalId (string) des Ansprechpartners
  • boolean external
    (optional) externalId verwenden

Return value soapresult: Ergebnis

deletePlace

soapresult deletePlace (
    string id,
    boolean external
)

Löscht einen Veranstaltungsort
Nur möglich, wenn der Veranstaltungsort nicht mehr mit Veranstaltungen verbunden ist.
Bei Verwendung von $external = true wird der Ort anhand der externalId ausgewählt.

  • string id
    ID (int) oder externalId (string) des Veranstaltungsorte
  • boolean external
    (optional) externalId verwenden

Return value soapresult: Ergebnis

getFeedbacksOfPeriod

feedbackArray getFeedbacksOfPeriod (
    string start,
    string end
)

Liefert ein Array von Rückmeldungen eines mit start und end festgelegten Zeitraums

  • string start
    Beginn Zeitraum im Format YYYY-MM-DD
  • string end
    Ende des Zeitraums (einschließlich) im Format YYYY-MM-DD

Return value feedbackArray: Rückmeldungen oder soapresult mit Fehlermeldung

getParameterValues

ConfigArray getParameterValues ( string key )

Liefert die Werte von festdefinierten Werte wie Veranstaltungsart, Zielgruppen, Regionen, etc.

  • string key
    Name des Parameters, mögliche Werte: eventtype|people|region|region2|region3|musickat|kat|placeregion|professionid|care|coursetype

Return value ConfigArray: enhält die Rückgabewerte

getPerson

person getPerson (
    string id,
    boolean external
)

Liefert einen Ansprechpartner anhand der eindeutigen ID oder der externalId

  • string id
    Id (int) oder externalId (string) des Ansprechpartners
  • boolean external
    (optional) externalId verwenden

Return value person: ein Ansprechpartner person oder soapresult mit Fehlermeldung

getPlace

place getPlace (
    string id,
    boolean external
)

Liefert einen Ort anhand der eindeutigen ID

  • string id
    Id (int) oder externalId (string) des Veranstaltungsortes
  • boolean external
    (optional) externalId verwenden, default = false

Return value place: ein Veranstaltungsort oder soapresult mit Fehlermeldung

getWebformResultsOfPeriod

webformresultArray getWebformResultsOfPeriod (
    string start,
    string end
)

Liefert ein Array von WebformResults eines mit start und end festgelegten Zeitraums

  • string start
    Beginn Zeitraum im Format YYYY-MM-DD
  • string end
    Ende des Zeitraums (einschließlich) im Format YYYY-MM-DD

Return value webformresultArray: WebformResults oder soapresult mit Fehlermeldung

listChannels

channelArray listChannels ( )

Auflistung aller Kanäle

Return value channelArray: der Kanäle

listFeedbacks

feedbackArray listFeedbacks (
    string id,
    boolean external
)

Liefert ein Array von Rückmeldungen anhand der Date-ID oder der externalId

  • string id
    Id (int) oder externalId (string) der Veranstaltung (Date)
  • boolean external
    (optional) externalId verwenden

Return value feedbackArray: Rückmeldungen oder soapresult mit Fehlermeldung

listPersons

personArray listPersons ( )

Auflistung aller angelegten Ansprechpartner eines Veranstalters

Return value personArray: Array der Ansprechpartner

listPlaces

placeArray listPlaces ( )

Auflistung aller angelegten Veranstaltungsorte eines Veranstalters

Return value placeArray: Array der Veranstaltungsorte

listResources

resourceArray listResources ( )

Auflistung aller Ressourcen

Return value resourceArray: der Ressourcen

listWebformResults

webformresultArray listWebformResults (
    string id,
    boolean external
)

Liefert ein Array von Webform-Ergebnissen anhand der Date-ID oder der externalId

  • string id
    Id (int) oder externalId (string) der Veranstaltung (Date)
  • boolean external
    (optional) externalId verwenden

Return value webformresultArray: Ergebnisse oder soapresult mit Fehlermeldung

listWebforms

webformArray listWebforms ( )

Auflistung aller Formulartypen eines Veranstalters

Return value webformArray: Array der Formulartypen

removeEventImage

soapresult removeEventImage (
    string eventid,
    boolean external
)

Löscht ein Bild von einer Veranstaltung

  • string eventid
    id (int) oder externalid (string) der Veranstaltung (event)
  • boolean external
    eventid ist externalid

removePlaceImage

soapresult removePlaceImage (
    string placeid,
    boolean external
)

Löscht ein Bild von einem Veranstaltungsort

  • string placeid
    id (int) oder externalid (string) des Veranstaltungsortes (place)
  • boolean external
    placeid ist externalid

saveEvent

soapresult saveEvent ( event event )

Neue Veranstaltung erstellen oder aktualisieren. Für eine Aktualisierung müssen id und eventid oder externalid angegeben sein.

  • event event
    Veranstaltung

Return value soapresult: mit Ergebnis oder Fehlermeldung des Funktionsaufrufs

saveField

soapresult saveField (
    field field,
    boolean external
)

Speichert den Wert eines eigenen Formularfeldes

  • field field
    Field-Objekt
  • boolean external
    bei true : eventid des Field-Objekts ist die externalId des events

Return value soapresult: Ergebnis

savePerson

soapresult savePerson ( person person )

Speichert einen Ansprechpartner.
Wenn die eindeutige ID gesetzt ist, wird der Eintrag mit den Angaben aktualisiert.
Ohne ID wird ein neuer Datensatz angelegt.
Ein Ansprechpartner kann auch mit einer externen ID (externalId) angelegt und aktualisiert werden.
Pflichtangabe: $person->name
Ab 100 Ansprechpartnern pro Veranstalter können keine weiteren mehr über die SOAP-Schnittstelle angelegt werden.

  • person person
    Ansprechpartner

Return value soapresult: Ergebnis

savePlace

soapresult savePlace ( place place )

Speichert einen Ort
Wenn die eindeutige ID gesetzt ist, wird der Eintrag mit den Angaben aktualisiert.
Ohne ID wird ein neuer Datensatz angelegt.
Pflichtangaben: $place->name, $place->kat, $place->city
Ab 100 Veranstaltungsorten pro Veranstalter können keine weiteren mehr über die SOAP-Schnittstelle angelegt werden.

  • place place
    Veranstaltungsort

Return value soapresult: Ergebnis

saveWebformPoll

soapresult saveWebformPoll ( webformpoll webformpoll )

Erstellt oder Aktualisiert eine Formulartyp-Verwendung (Poll)

Return value soapresult: Ergebnis