cardo.Puzzle

Puzzle ist ein Werkzeug und eine Programmierumgebung zur Erstellung von Fachanwendungen mit oder ohne Geometriebezug. Die Definition der Struktur und des Verhaltens der Anwendung erfolgt dabei weitgehend deklarativ, kann aber unter Nutzung verschiedener, durch das System gebotener Schnittstellen, nahezu beliebig angepasst werden. Puzzle ist sowohl in die Oberfläche cardo als auch in cardo.Map integriert. Das System stellt darüber hinaus viele Dienste für den Zugriff auf die Daten für Dritte zur Verfügung.

Das Modul Puzzle verwendet intern ein objektorientiertes Modell zur Datenspeicherung. Dieses Datenmodell, IKX genannt, befindet sich im Kern einer jeden cardo-Installation. Das Ikx-Modul dient dabei „lediglich“ der Speicherung der Dokumentinhalte. Die Datensatzstruktur muss von einem anderen Modul bereitgestellt werden.

Der Dokumentinhalt wird im IKX über die Definition einer Datenklasse (mit dem Klasseneditor) beschrieben. Diese Datenklasse besteht aus Datenfeldern von einem integrierten Datentyp (Ganzzahl, Gleitkommazahl, Text, Ja/Nein, Datum/Uhrzeit, Geometrie, Binärdaten) oder enthält Datenfelder vom Typ einer anderen definierten komplexen Klasse (Nachschlageklasse). Auf diesem Weg ist die Erstellung von Datenstrukturen mit beliebiger Komplexität möglich.

-> START mit IKX

 

Ein integrierter Dateneditor liest die Struktur zur Laufzeit aus und generiert eine Eingabeoberfläche unter Berücksichtigung der Klassenstruktur und der auf Feldebene vergebenen Berechtigungen.

-> Dateneditor

cardo.Puzzle-Datenkonzept

Puzzle besteht aus den Elementen Kategorie, Dokument sowie Klassen und Entitäten. Die oberste Ebene im cardo.Puzzle ist eine Kategorie. Diese kann ganz themenspezifisch definiert sein. In dieser Kategorie richten Sie ihre Klassen und Entitäten ein (mit dem Klasseneditor - Management Center). Der Nutzer kann nun wiederum in der Kategorie Dokumente definieren die die Entitäten zum Inhalt haben (im Dateneditor). Folgende Abbildung soll dies veranschaulichen:

 

Dokument

Ein Dokument stellt die Instanz einer Datenklasse dar.

Puzzle organisiert die Datensätze in Form einer Baumstruktur. Dabei kann ein Dokumentinhalt sowohl an Ordnern als auch an „Blättern“ gespeichert werden.

Durch die Baumstruktur können die Daten besser organisiert werden, Berechtigungen können einfacher abgebildet werden und das durch Ikx bereitgestellte Feature der Vererbung von Inhalten kann verwendet werden. Jedes Element in dieser Baumstruktur kann über eine Knoten-ID referenziert (PuzzleNodeId) werden.

An jedem Datensatz/Dokument werden immer folgende Informationen gespeichert:

  • Anzeigetitel
  • Datum der Erstellung (automatisch)
  • Datum der letzten Änderungen (automatisch)
  • Anmeldename des Erstellers (automatisch)
  • Anmeldename des Ändernden (automatisch)

Kategorien

Die Datenspeicherung erfolgt in der Tabelle pzl_nodes.
Um verschiedene Sachverhalte in einer cardo-Installation abzubilden werden Kategorien (man könnte es auch Fachschale nennen) definiert.

Eine Kategorie wird immer durch eine .NET-Datenklasse repräsentiert. D. h. zum Einrichten einer Kategorie muss ein wenig Programmcode geschrieben werden. Bereits vorhandene Kategorien müssen im Management Center registriert werden.

Dabei sind alle Datensätze innerhalb einer Kategorie Instanzen genau einer für diese konkrete Kategorie definierten Datenklasse.

Kategorieübergreifende Zugriffe

Um in komplexen Systemen (mit mehreren Kategorien) Kategorie übergreifende Datenzugriffe zu ermöglichen, wird eine Basisklasse vom System bereitgestellt. Der Inhalt dieser Basisklasse steht für alle Dokumente in allen Kategorien zur Verfügung. Die interne ID der Basisklasse ist vom System vorgegeben (PUZZLE$ROOTBASECLASS).

In dieser Basisklasse, welche bereits zwei feste Elemente enthält, können Sie nun weitere Entitäten einrichten.

Puzzle Dokumente im CMS

Puzzle Dokumente können durch die Neuentwicklung von Controls auch direkt im Content Management System Wilma angezeigt werden.

Weitere Informationen finden Sie in unserer CMS Hilfe.

Schulungen für cardo.Puzzle

Wir bieten verschiedene Schulungsschwerpunkte von der Erstellung einer einfachen Struktur bis zur Programmierung für cardo.Puzzle an.

Bitte sprechen Sie uns an.

Weitere Informationen zum Inhalt der Schulung finden Sie HIER!

neu ab Version 3.8.7

alle Änderungen betreffen den Editor V2

  • Nachschlagelisten mit großer Anzahl (>100) von Werten werden durch ein Register verwaltet, Autovervollständigen-Funktion ist intgeriert
  • verschachtelte Nachschlagelisten können definiert werden
  • farbiger Text und Bilder können im Parameter Beschreibung an der Entität hinterlegt werden (HTML)
  • Mehrfachauswahl von Objekten im Baum möglich
  • Gruppen können im Editor minimiert werden

Abgleich von gleichen Puzzle Kategorien

neu ab Version 3.8.6
  • Excel Export der Dokumente eines Ordners im V1
  • Geometrieerfassung mit ToPG für den V2
  • Bereitstellung von 3 Testkategorien
neu ab Version 3.8.5.
  • Das für Dresden entwickelte Plugin für die Anbindung Dresdner Bilddatenbank
    funktioniert jetzt auch im Ikx-Editor V2.
  • Sowohl die GSS - Erweiterung als auch die Verortung über cardo-Orf sind jetzt auch im Puzzle-Editor V2 verfügbar.
  • Erstellung von Versionen einer Puzzle Kategorie möglich
  • Im Erweiterungsobjekt iduCore, das in den XSLTs üblicherweise als 'cardoExtension' eingebettet ist, gibt es neue Funktionen zur Ermittlung von Geometrieparametern: GetGeomLength, GetGeomPerimeter und GetGeomArea

neu ab Version 3.8.3.

Bei der Entwicklung einer Kategorie kann festgelegt werden, in welcher Reihenfolge Basisklasse und Kategorieklasse im Editor angezeigt werden bzw. ob eine der beiden Klassen nicht angezeigt wird.

Ebenfalls kann festgelegt werden, ob der Validierungs-Button im Editor angezeigt wird.

neu ab Version 3.8

Ab Version 3.8 gibt es eine neue Version des Editors (Editor V2) und der Dokumentliste. Die Komponenten sind vollständig neu geschrieben. Aufrufbar ist der neue Editor über /net3/puzzle/main2.aspx. Als Framework kommt ExtJs in Version 4 zum Einsatz. Die Anzeige der Dokumente erfolgt in einer kombinierten Baum-/ Grid-Ansicht. Dabei können auch weitere Spalteninhalte in der Dokumentliste angezeigt werden (siehe neues Feld-Attribut ShowInEditor). Die Sortierung der Liste ist dabei nach allen Attributen möglich. Der neue Editor wertet die Attribute für die Ausgestaltung etwas anders aus. Dabei werden z. B. bessere Möglichkeiten der Gruppierung der Datenfelder geboten.

Hinweis: Es werden z. Z. noch nicht alle Erweiterungen von Puzzle von den neuen Oberflächenkomponenten unterstützt. In den nächsten Versionen werden diese nachgerüstet

puzzlev2.png

Neuigkeiten ab Version 3.8.2.

Die Komponente ORF ist im Standalone Editor (V1) mit enthalten.

Kategorien mit der Implementierung eines IPuzzleCategoryNodeChangeHandler werden beim Ändern von Rechten über den Event-Typ "AfterNodeRightsChange" benachrichtigt.

Bei der Transformation in PDF wird im Namespace eo:iduPdf ein weiteres
Erweiterungsobjekt zur Verfügung gestellt, mit Methoden zum Einstellen der Seitenränder und des Papierformates.

Für leere Ikx-Dokumente wird im internen Xml nur noch das Root-Element ausgegeben.

Die automatisch erstellten Puzzle-WebDienste enthalten in der Public-
Variante des Dienstes *nur noch* die Methoden, für welche das Attribut
[IDU.cardo3.CoreModules.Puzzle.WebServices.GenerateInPublicHandler()] deklariert ist.