Webservices

Der Zugriff auf die Daten erfolgt über vorgefertigte Anwendungsseiten oder über (SOAP-) Dienste.

Anwendungenseiten einer cardo Installation

Im Folgenden ein Überblick der möglichen Anwendungsseiten, die in jeder cardo-Installation vorhanden sind:

  • /net3/puzzle/main.aspx?IkxStoreID={id} - die Hauptanwendung zum Erstellen, Ändern und Anzeigen aller Kategorien, diese Anwendung ist auch direkt in der cardo Oberfläche unter „Anwendungen“ zu finden
  • /net3/puzzle/ShowDoc.aspx?puzzleNodeId={id} – Zeigt den Inhalt des Datensatzes HTML-formatiert an
  • /net3/puzzle/PuzzleEditor.aspx?puzzleNodeId={id} – Zeigt eine Bearbeitungsseite für den Datensatz an
SOAP-Dienste für den Datenzugriff über cardo.Puzzle
  • /net3/services/puzzleServices2.asmx oder /net3/public/services/puzzleServices2.asmx – verschiedene Methoden für das Suchen von Daten, Abrufen von Dokumenten und Abrufen von Beschreibungen der Klassen und Kategorien, die Dienste sind inhaltlich identisch, unterscheiden sich aber in der Benutzerauthentifizierung. Alle Aufrufe an „Public“ werden immer unter dem Systemaccount „SYSTEM_ANONYMOUS_USER“ durchgeführt, im anderen Fall wird der Account des aufrufenden Benutzers verwendet.
  • /net3/services/puzzleCategoryServices.asmx 
    oder /net3/public/services/puzzleCategoryServices.asmx – diese Dienste werden automatisch erstellt, wenn in der Kategoriedefinition entsprechende Einstellungen vorgenommen wurden
Methoden im cardo-Diensthandler
  • /net3/ogc.ashx?Service=IKX, mit folgende Methoden:
    • GetBlobData – Abrufen von Binärdaten (z. B. PDF-Dokumenten, die im Puzzle gespeichert sind)
    • GetBlobTumbnailImageData – Miniaturansicht eines im Dokument gespeicherten Bildes
  • /net3/ogc.ashx?Service=IKXSCHEMA, mit folgende Methoden:
    •  GetPuzzleSchema – liefert ein XSD-Schema der Definition der Datenklasse der übergebene Kategorie
  • /net3/ogc.ashx?Service=PUZZLE, mit folgenden Methoden
    • GetPdf - liefert das generierte PDF; mit dem Parameter 'style' kann der Name der Ansicht übergeben werden;qid ist die 'qualifizierte Id' und besteht aus {StoreId:PzlNodeId}
      Bsp.: ogc.ashx?Service=PUZZLE&Request=GetPdf&qid=0:1540&style=footerTest
    • GetHtml - liefert das generierte Html-Dokument; mit dem Parameter 'style' kann der Name der Ansicht übergeben werden
Hinweis: der Diensthandler kann ebenso wie die SOAP-Dienste über /net3/public/ aufgerufen werden.
 
Hinweis: Bei allen Diensten wird eine ausführliche Beschreibung ausgegeben, wenn der Dienst ohne weitere Parameter aufgerufen wird.
Methode zum Aufruf des mobilen Puzzles:
  • /net3/puzzle/mobile.aspx?ikxstoreid=xx (notieren Sie hier die entsprechende StoreID. Die IkxStoreId finden Sie im Managementcenter/Ikx im Infobutton des jeweiligen Stores)