{"id":2904,"date":"2019-03-27T08:42:13","date_gmt":"2019-03-27T07:42:13","guid":{"rendered":"http:\/\/www.capri-soft.de\/blog\/?p=2904"},"modified":"2019-04-23T10:00:14","modified_gmt":"2019-04-23T08:00:14","slug":"sparx-systems-enterprise-architect-sql-interpretation-der-linkdarstellung-link-layout-eines-diagrams-ueber-das-relationale-ea-datenmodell","status":"publish","type":"post","link":"https:\/\/www.capri-soft.de\/blog\/?p=2904","title":{"rendered":"Sparx Systems Enterprise Architect + SQL : Interpretation der Linkdarstellung \/ Link Layout eines Diagrams \u00fcber das relationale EA Datenmodell"},"content":{"rendered":"\n

Problem<\/h2>\n\n\n\n

\u00dcber das relationale Datenmodell des Enterprise Architects soll die Geometrie von Links auf Diagrammen rekonstruiert werden. Die n\u00f6tigen Felder sind in den Tiefen der Datenstrukturen aus Tabellen und Attributen in einem Memo-\/Freitext-Feld versteckt. <\/p>\n\n\n\n

Ich entwickle zur Zeit eine eigene Interpretation des EA-Renderers mit GoJS, wo ich auf das Problem gesto\u00dfen bin, dass ich aufgrund der unterschiedlichen Connectorstyles, welche f\u00fcr einen Link auf unterschiedlichen Diagrammen eine andere Geometrie vorweisen kann, den Endpunkt nicht ermitteln kann. Eine L\u00f6sung hierzu m\u00f6chte ich hier ausarbeiten.<\/p>\n\n\n\n

Analyse<\/h2>\n\n\n\n

Relationen<\/h3>\n\n\n\n

Ein Link\/Connector (Tabelle „t_connector<\/strong>„) kann auf mehreren Diagrammen unterschiedliche Darstellungen haben. Die Geometrie des Links auf einem Diagramm<\/em> wird \u00fcber das Attribut „Geometry<\/strong>“ der Tabelle „t_diagramlinks<\/strong>“ bestimmt. Das Attribut „Geometry“ ist ein Langtext-\/Memo-Feld und wird im folgenden einer Analyse unterzogen, da sich im Internet nur sehr sp\u00e4rlich Informationen \u00fcber den Aufbau und die Bedeutung des Doppelpunkt-separierten Strings finden.<\/p>\n\n\n\n

Die Tabelle „t_diagramlinks“<\/h3>\n\n\n\n

“ A DiagramLink is an object that holds display information on a connector between two elements in a specific diagram. It includes, for example, the custom points and display appearance. It can be accessed from the Diagram DiagramLinks collection. “ <\/p>https:\/\/sparxsystems.com\/enterprise_architect_user_guide\/
14.0\/automation\/diagramlinks.html<\/cite><\/blockquote>\n\n\n\n
Attribute<\/u><\/strong><\/td>Remarks<\/u><\/strong> <\/td><\/tr>

ConnectorID <\/td>		Long<\/strong>
Notes: Read\/Write
The ID of the associated connector. <\/td><\/tr>

DiagramID <\/td>		Long<\/strong>
Notes: Read\/Write
The local ID for the associated diagram. <\/td><\/tr>

Geometry <\/u><\/strong><\/em><\/td>		String (Memo-Field)<\/strong>
Notes: Read\/Write
The geometry associated with the current connector in this diagram. <\/em><\/strong><\/td><\/tr>

HiddenLabels <\/td>		Boolean<\/strong>
Notes: Indicates if this connector’s labels are hidden on the diagram. <\/td><\/tr>

InstanceID <\/td>		Long<\/strong>
Notes: Read only
The connector identifier for the current model. <\/td><\/tr>

IsHidden <\/td>		Boolean<\/strong>
Notes: Read\/Write
Indicates if this item is hidden or not. <\/td><\/tr>

LineColor <\/td>		 Long<\/strong>
Notes: Sets the line color of the connector.
Set to -1 to reset to the default color in the model. <\/td><\/tr>

LineStyle <\/td>		Long<\/strong>
Notes: Sets the line style of the connector.
1 = Direct
2 = Auto Routing
3 = Custom Line
4 = Tree Vertical
5 = Tree Horizontal
6 = Lateral Vertical
7 = Lateral Horizontal
8 = Orthogonal Square
9 = Orthogonal Rounded <\/td><\/tr>

LineWidth <\/td>
Long<\/strong>
Notes: Sets the line width of the connector. <\/td><\/tr>

ObjectType <\/td>		ObjectType<\/strong>
Notes: Read only
Distinguishes objects referenced through a Dispatch interface. <\/td><\/tr>

Path <\/td>		String<\/strong>
Notes: Read\/Write
The path of the connector in this diagram. <\/td><\/tr>

SourceInstanceUID <\/td>		String<\/strong>
Notes: Read only
Returns the Unique Identifier of the source object. <\/td><\/tr>

SuppressSegment <\/td>		Boolean<\/strong>
Notes: Indicates whether the connector segments are suppressed. <\/td><\/tr>

Style <\/td>		String<\/strong>
Notes: Read\/Write
Additional style information; for example, color or thickness. <\/td><\/tr>

TargetInstanceUID <\/td>		String<\/strong>
Notes: Read only
Returns the Unique Identifier of the target object. <\/td><\/tr><\/tbody><\/table>\n\n\n\n
\"\"<\/a>
Der String „Geometry“ wird in MDB Viewer Plus als (MEMO) dargestellt, das MemoFeld kann allerdings rechts eingeblendet werden. Dort tauchen einige weitere versteckte Attribute f\u00fcr die Geometry der Linie auf, welche im nachfolgendem Analysiert werden
<\/figcaption><\/figure>\n\n\n\n
\"\"
Die Auswahl des LineStyles f\u00fcr einen Connector, wie oben im Screenshot dargestellt, bestimmt die Darstellung.<\/figcaption><\/figure>\n\n\n\n
\"\"
Die LineStyles werden in der Tabelle [t_diagramlinks] und \u00fcber Mode={1,2,3}<\/strong> und dem optionalen Zusatz TREE={V,H,OS,OR,LV,LH}:Mode=3 <\/strong>f\u00fcr Mode „3“ gespeichert.<\/figcaption><\/figure>\n\n\n\n
\"\"
Das Hauptproblem: Das Datenmodell besitzt nicht die Information, an welcher Seite der End-Knoten\/das Ziel-Rechteck geschnitten wird. Lediglich \u00fcber das Attribut t_diagrammlinks.Geometry l\u00e4sst sich \u00fcber den CSV-Value „Edge“ die Startseite des Startknotens bestimmen.<\/figcaption><\/figure><\/div>\n\n\n\n

Fremdmeinungen einholen – ein Ausflug in die Forenwelt<\/h2>\n\n\n\n

Ich habe mich aus Gr\u00fcnden der Kollaboration entschieden, die Analysen in Stackoverflow und EA fortzuf\u00fchren. Hier finden sich die Links zu meinem Beitrag:<\/p>\n\n\n\n

https:\/\/stackoverflow.com\/questions\/55341368\/enterprise-architect-how-to-get-the-edge-of-the-end-node-using-a-sql-query-on <\/a><\/p>\n\n\n\n

https:\/\/www.sparxsystems.com\/forums\/smf\/index.php\/topic,42536.0.html<\/a><\/p>\n\n\n\n

https:\/\/matheplanet.de\/matheplanet\/nuke\/html\/viewtopic.php?topic=241211<\/a><\/p>\n\n\n\n

Fazit: <\/strong>Obwohl mir kein Forum eine nutzbare L\u00f6sung angeboten hat, lohnt es sich sich neue Anregungen zu dem Problem einzuholen<\/p>\n\n\n\n

L\u00f6sung f\u00fcr das Problem mit der fehlenden Ecke des Zielknoten (Target Edge) – Rechteckschnitt <\/h2>\n\n\n\n

Im Datenmodell wird die Mouse-Release Position \u00fcber Geometry EX\/EY (Geometry) gespeichert, was allerdings nicht der Schnittpunkt mit dem Rechteck ist.<\/p>\n\n\n\n

Mit 4 Geraden l\u00e4sst sich das Rechteck bestimmen (obgleich nat\u00fcrlich auch Punkte existieren, die nicht auf dem Rechteck liegen).<\/p>\n\n\n\n

\"\"
Seite 1 der L\u00f6sung<\/figcaption><\/figure>\n\n\n\n
\"\"<\/figure>\n\n\n
\n\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\n\/\/ Erzeuge eine eigene Link-Klasse f\u00fcr das Routing der Pfeile, die von Hand gezogen wurden \n\/\/ und \u00fcber spezielle Attribute in der EAP-Datei definiert werden\n\/\/ Ruft die Superklasse von go.Link im Konstruktor auf\nfunction MultiNodePathLink() {\n    go.Link.call(this);\n}\ngo.Diagram.inherit(MultiNodePathLink, go.Link); \/\/ Erben von go.Link\n\n\/\/ ignores this.routing, this.adjusting, this.corner, this.smoothness, this.curviness\n\/** @override *\/\nMultiNodePathLink.prototype.computePoints = function () {\n\n    \/\/ Die this Referenz ist hier ist ein geerbter ein go.Link. der bei Links\n    var startNode = this.fromNode;\n    var startNodeX = startNode.location.M;  \/\/ X-Koordinate vom Startknoten\n    var startNodeY = startNode.location.N; \/\/ Y-Koordinate vom Startknoten\n\n    var endNode = this.toNode;\n    var endNodeX = endNode.location.M;  \/\/ X-Koordinate vom Startknoten\n    var endNodeY = endNode.location.N; \/\/ Y-Koordinate vom Startknoten\n   \n    var startNodeData = startNode.data; \/\/ Das sind die Daten\n    var endNodeData = endNode.data; \/\/ Das sind die Daten\n\n    \/\/ Die Link-Daten\n    var linkProperties = this.data;\n    \/\/** Das Feld Style in [t_diagramlink] bestimmt die Connector-Darstellung  **\/\n    \/\/ https:\/\/www.capri-soft.de\/blog\/?p=2904\n    \/*\n     *  1 = Direct                    Mode=1\n     *  2 = Auto Routing              Mode=2\n     *  3 = Custom Line               Mode=3\n     *  4 = Tree Vertical             Mode=3;TREE=V\n     *  5 = Tree Horizontal           Mode=3;TREE=H\n     *  6 = Lateral Vertical          Mode=3;TREE=LV\n     *  7 = Lateral Horizontal        Mode=3;TREE=LH\n     *  8 = Orthogonal Square         Mode=3;TREE=OS\n     *  9 = Orthogonal Rounded        Mode=3;TREE=OR\n     *\/\n    var styleStringArray = linkProperties.style.split(";");\n    var mode = -1;\n    var tree = '';\n    for (var i = 0; i < styleStringArray.length; i++) {\n        if (styleStringArray[i].trim().indexOf('Mode=') > -1) {\n            mode = styleStringArray[i].replace('Mode=', '');\n        }\n\n        if (styleStringArray[i].trim().indexOf('TREE=') > -1) {\n            tree = styleStringArray[i].replace('TREE=', '');\n        }\n    }\n\n\n\n    \/\/ In der Tabelle t_diagramlinks in der Freitextspalte "Geometry" wird in einem CSV-String \n    \/\/ gespeichert, wie der Link letztendlich auf dem Diagram gezogen wurde\n    var geometryString = linkProperties.geometry.split(";");\n    var sx, sy, ex, ey, edge;\n    for (var i = 0; i < geometryString.length; i++) {\n        \/\/ SX and SY are relative to the centre of the start object \n        if (geometryString[i].trim().indexOf('SX=') > -1) sx = geometryString[i].replace('SX=', '');\n        if (geometryString[i].trim().indexOf('SY=') > -1) sy = geometryString[i].replace('SY=', '');\n\n        \/\/ EX and EY are relative to the centre of the end object\n        if (geometryString[i].trim().indexOf('EX=') > -1) ex = geometryString[i].replace('EX=', '');\n        if (geometryString[i].trim().indexOf('EY=') > -1) ey = geometryString[i].replace('EY=', '');\n\n        \/\/ EDGE ranges in value from 1-4, with 1=Top, 2=Right, 3=Bottom, 4=Left (Outgoing Point of the Start Object)\n        if (geometryString[i].trim().indexOf('EDGE=') > -1) edge = geometryString[i].replace('EDGE=', '');\n    }\n    \n\n\n    \/\/ Hier beginnt das Custom-Routing\n    if (typeof (sx) === "undefined" || typeof (sy) === "undefined" || typeof (ex) === "undefined" || typeof (ey) === "undefined" || typeof (edge) === "undefined") {\n        return;\n    }\n       \n    this.clearPoints();\n\n    if (linkProperties.start_object_name == 'System Verification Test Reports' && linkProperties.end_object_name == 'System test specifications') {\n        var test = 'irrsinn';\n    }\n    \/\/ Hier werden die Wege definiert f\u00fcr das gecustomizte Link Routing\n    \/\/ Geht der Link nach oben oder unten wird die Y-Koordinate des Startknotens genutzt (Weil Orthogonales Routing)\n    var startConnX = null;\n    var startConnY = null;\n    if (edge == 1) { \/\/ Ecke oben\n        startConnX = Math.abs(startNodeX) + Math.abs((startNode.actualBounds.width \/ 2) + new Number(sx));\n        startConnY = Math.abs(startNodeY);\n    }\n    else if (edge == 3) { \/\/ Ecke unten\n        startConnX = Math.abs(startNodeX) + Math.abs((startNode.actualBounds.width \/ 2) + new Number(sx));\n        startConnY = Math.abs(startNodeY) + new Number(startNode.actualBounds.height);\n    }\n    else if (edge == 2) { \/\/ Ecke rechts\n        startConnX = Math.abs(startNodeX) + startNode.actualBounds.width;\n        startConnY = Math.abs(startNodeY) + Math.abs((startNode.actualBounds.height \/ 2) - new Number(sy));\n    }\n    else if (edge == 4) { \/\/ Ecke links\n        startConnX = new Number(Math.abs(startNodeX));\n        startConnY = Math.round(startNodeY) + Math.round((startNode.actualBounds.height \/ 2) - new Number(sy));\n    }\n    else {\n        alert('Die Edge konnte nicht entdeckt werden! Ist der Geometry String in der EAP Datei richtig?');\n    }\n\n    this.addPoint(new go.Point(Math.round(startConnX), Math.round(startConnY)));\n\n    \/\/ Abfrage: Gibt es einen letzten Path Punkt?\n    var lastPathPunkt=false;\n    var lastPathPunktX, lastPathPunktY;\n\n    if (mode != 1)\n    {\n        \/\/ Routing \u00fcber die Zwischenwege\n        if (typeof linkProperties.conn_path !== "undefined" && linkProperties.conn_path !== "") {\n            var splittedArray = linkProperties.conn_path.split(";");\n            if (splittedArray.length > 1) {\n                \/\/ Hier ist mindestens ein Wert vorhanden da auch der erste mit Semikolon abgeschlossen wird im Path vom EA\n                for (var i = 0; i < splittedArray.length - 1; i++) {\n                    var einMittelPunkt = splittedArray[i];\n                    var mittelPunktArray = einMittelPunkt.split(":");\n                    this.addPoint(new go.Point(Math.abs(new Number(mittelPunktArray[0])), Math.abs(new Number(mittelPunktArray[1]))))\n                    lastPathPunktX = Math.abs(new Number(mittelPunktArray[0]));\n                    lastPathPunktY = Math.abs(new Number(mittelPunktArray[1]));\n                    lastPathPunkt = true;\n                }\n            }\n        }\n    }\n\n    \/\/ Wenn es keinen Pfad gab,muss der letzte Punkt mit dem Startknoten identisch sein\n    if (lastPathPunkt == false) {\n        lastPathPunktX = Math.abs(Math.round(startConnX));\n        lastPathPunktY = Math.abs(Math.round(startConnY));\n    }\n\n    \/\/ End-Routing\n    \/\/ Der Endpunkt in EA in Document Coordinates\n    var endConnX = Math.abs(endNodeX) + Math.abs((endNode.actualBounds.width \/ 2) + new Number(ex));\n    var endConnY = Math.abs(endNodeY) + Math.abs((endNode.actualBounds.height \/ 2) - new Number(ey));\n\n    \/\/ Spezialf\u00e4lle bei horizontalen und vertikalen Linien:\n    if (endConnX == lastPathPunktX) {\n        \/\/ Es liegt eine vertikale Gerade (z.B. von oben nach unten) vor\n        this.addPoint(new go.Point(Math.round(lastPathPunktX), Math.round(lastPathPunktY)));\n        this.addPoint(new go.Point(Math.round(endConnX), Math.round(endConnY)));\n\n    } else if (endConnY == lastPathPunktY) {\n        \/\/ Es liegt eine horizontale Gerade (z.B. von rechts nach links) vor\n        this.addPoint(new go.Point(Math.round(lastPathPunktX), Math.round(lastPathPunktY)));\n        this.addPoint(new go.Point(Math.round(endConnX), Math.round(endConnY)));\n    } else {\n        \/\/ Es ist keine Gerade sondern ein Gerade, die mit y=m*x+b beschrieben werden kann\n\n        \/\/ 1.) Gerade zwischen Start- und Endpunkt ermittelnhn\n        \/\/      Ye-Ys\n        \/\/  m = -----    b=Ys-m*Xs oder b=Ye-m*Xe\n        \/\/      Xe-Xs\n        var m = (endConnY - lastPathPunktY) \/ (endConnX - lastPathPunktX);\n        var b = lastPathPunktY - m * lastPathPunktX\n\n        \/\/ 2.) Ermittlung der horizontalen und vertikalen Geraden des Rechteckes und dem Schnittpunkten\n        \/\/ Die Geraden, die das Rechteck definieren:\n        var rY1 = endNodeY;\n        var rY2 = endNodeY + endNode.actualBounds.height;\n        var rX1 = endNodeX;\n        var rX2 = endNodeX + endNode.actualBounds.width;\n        \/\/ (rX1, rY1) -zu-> (rX2, rY2)\n        \n        \/\/ Horizontale Geraden: \n        \/\/     y - b\n        \/\/ x = -----\n        \/\/       m\n\n\n        var lengthToPoint = [];\n\n        var sX1 = (rY1 - b) \/ m; \/\/ S1(sX1|rY1)\n        if (sX1 >= rX1 && sX1 <= rX2) {\n            \/\/ Der Schnittpunkt sX1 ist am Rechteck\n            \/\/ Distanz: d=SQRT((y2-y1)^2+(x2-x1)^2)\n            var dS1 = Math.sqrt(Math.pow(rY1 - lastPathPunktY, 2) + Math.pow(sX1 - lastPathPunktX, 2));\n\n            lengthToPoint.push({\n                "distanz": dS1,\n                "x": sX1,\n                "y": rY1\n            });\n\n        }\n\n        var sX2 = (rY2 - b) \/ m; \/\/ S2(sX2|rY2)\n        if (sX2 >= rX1 && sX2 <= rX2) {\n            \/\/ Der Schnittpunkt sX2 ist am Rechteck\n            \/\/ Distanz: d=SQRT((y2-y1)^2+(x2-x1)^2)\n            var dS2 = Math.sqrt(Math.pow(rY2 - lastPathPunktY, 2) + Math.pow(sX2 - lastPathPunktX, 2));\n\n            lengthToPoint.push({\n                "distanz": dS2,\n                "x": sX2,\n                "y": rY2\n            });\n        }\n\n        \/\/ Vertikale Geraden:\n        \/\/\n        \/\/ y = m*x + b\n\n        var sY1 = m * rX1 + b; \/\/ S3(rX1|sY1)\n        if (sY1 >= rY1 && sY1 <= rY2) {\n            \/\/ Der Schnittpunkt sY1 ist am Rechteck\n            \/\/ Distanz: d=SQRT((y2-y1)^2+(x2-x1)^2)\n            var dS3 = Math.sqrt(Math.pow(sY1 - lastPathPunktY, 2) + Math.pow(rX1 - lastPathPunktX, 2));\n\n            lengthToPoint.push({\n                "distanz": dS3,\n                "x": rX1,\n                "y": sY1\n            });\n        }\n\n        var sY2 = m * rX2 + b; \/\/ S4(rX2|sY2)\n        if (sY2 >= rY1 && sY2 <= rY2) {\n            \/\/ Der Schnittpunkt sY2 ist am Rechteck\n            \/\/ Distanz: d=SQRT((y2-y1)^2+(x2-x1)^2)\n            var dS4 = Math.sqrt(Math.pow(sY2 - lastPathPunktY, 2) + Math.pow(rX2 - lastPathPunktX, 2));\n\n            lengthToPoint.push({\n                "distanz": dS4,\n                "x": rX2,\n                "y": sY2\n            });\n        }\n\n        \/\/ Sortiere alle Punkte nach Distanz - der mit der kleinsten Entfernung isses\n        lengthToPoint.sort(function (a, b) { return a.distanz - b.distanz });\n\n        if (lengthToPoint.length > 0)\n        {\n            this.addPoint(new go.Point(Math.round(lengthToPoint[0].x), Math.round(lengthToPoint[0].y)));\n        }\n        else\n        {\n            this.addPoint(new go.Point(Math.round(lastPathPunktX), Math.round(lastPathPunktY)));\n        }\n\n        \n    }\n\n    return true;\n};\n\/\/ end MultiNodePathLink class\n<\/pre><\/div>