| ... |
... |
@@ -83,7 +83,7 @@ |
| 83 |
83 |
|
| 84 |
84 |
{{code language="xml"}} |
| 85 |
85 |
<properties> |
| 86 |
|
- <xfc.version>7.2.1</xfc.version> |
|
86 |
+ <xfc.version>7.0.10</xfc.version> |
| 87 |
87 |
</properties> |
| 88 |
88 |
|
| 89 |
89 |
<dependencies> |
| ... |
... |
@@ -136,15 +136,11 @@ |
| 136 |
136 |
: Erforderlich. Version von {{formcycle/}}, für die das Plugin gedacht ist. Ist erforderlich, damit {{formcycle/}} bei der Installation die Kompatibilität prüfen kann. |
| 137 |
137 |
; Implementation-Version |
| 138 |
138 |
: Erforderlich. Version des Plugins; Diese wird z.B. in der Oberfläche angezeigt. |
| 139 |
|
-; Plugin-Key |
| 140 |
|
-: Erforderlch. Wird zur Identifizierung des Plugin innherhalb von {{formcycle/}} verwendet, und auch von etwa dem Deploy-Plugin oder Server-Plugin. Empfohlener Wert ist {{code}}${project.groupId}:${project.artifactId}{{/code}}. |
| 141 |
141 |
; Build-Time oder Build-Timestamp |
| 142 |
142 |
: Optional. Wird bei SNAPSHOT-Versionen mit angezeigt, um den SNAPSHOT zu identifizieren. |
|
141 |
+; Implementation-Title |
|
142 |
+: Optional. Wird standardmäßig etwa vom Deploy-Plugin verwendet, um das Plugin zu identifzieren. |
| 143 |
143 |
|
| 144 |
|
-{{info}} |
| 145 |
|
-Bis einschließlich Version 7.x von {{formcycle/}} ist noch {{code}}Implementation-Title{{/code}} mit dem gleichen Wert wie {{code}}Plugin-Key{{/code}} erforderlich. |
| 146 |
|
-{{/info}} |
| 147 |
|
- |
| 148 |
148 |
Diese Informationen können wie unten beschrieben mittels des //maven-assembly-plugin// in die Manifest-Datei geschrieben werden. |
| 149 |
149 |
|
| 150 |
150 |
Weiterhin ist beim Bauen zu beachten, dass eine sogenannte Fat-JAR gebaut werden muss. Abhängigkeiten zu {{formcycle case="dat"/}} sowie anderen Bibliotheken, welche bereits durch {{formcycle case="acc"/}} mitgeliefert werden, sollten wie bereits erwähnt im scope //provided// eingebunden werden. Falls im Plugin aber noch andere Abhängigkeiten benutzt werden, müssen diese in der JAR-Datei inkludiert werden (Fat JAR). |
| ... |
... |
@@ -248,7 +248,7 @@ |
| 248 |
248 |
* Ein Maven-Plugin, welches nach dem Bauen das Plugin via HTTP an einen laufenden {{formcycle/}}-Server sendet |
| 249 |
249 |
* Ein Plugin für {{formcycle/}}, welche die Gegenstelle in {{formcycle/}} bereitstellt und das Plugin aus dem HTTP-Request in {{formcycle/}} installiert. |
| 250 |
250 |
|
| 251 |
|
-Weitere Details können im [[Hilfe-Artikel zum Deploy-Plugin>>doc:Formcycle.PluginDocumentation.FormcycleDeployPluginPlugin]] nachgelesen werden. Für die meisten Fälle ist kene Konfiguration in der //pom.xml// erforderlich. Es empfiehlt sich aber, wenigstens die Version festzusetzen: |
|
247 |
+Weitere Details können im [[Hilfe-Artikel zum Deploy-Plugin>>doc:Formcycle.PluginDocumentation.FormcycleDeployPluginPlugin]] nachgelesen werden. Für die meisten Fälle reicht folgende Konfiguration in der //pom.xml// des Plugin-Projekts aus: |
| 252 |
252 |
|
| 253 |
253 |
{{code language="xml"}} |
| 254 |
254 |
<properties> |
| ... |
... |
@@ -259,27 +259,27 @@ |
| 259 |
259 |
<groupId>de.xima.fc.maven.plugin</groupId> |
| 260 |
260 |
<artifactId>fc-deploy-plugin-maven-plugin</artifactId> |
| 261 |
261 |
<version>${fc-deploy-plugin-maven-plugin.version}</version> |
|
258 |
+ <executions> |
|
259 |
+ <execution> |
|
260 |
+ <id>upload</id> |
|
261 |
+ <phase>package</phase> |
|
262 |
+ <goals> |
|
263 |
+ <goal>deploy</goal> |
|
264 |
+ </goals> |
|
265 |
+ </execution> |
|
266 |
+ </executions> |
| 262 |
262 |
</plugin> |
| 263 |
263 |
</plugins> |
| 264 |
264 |
</build> |
| 265 |
265 |
{{/code}} |
| 266 |
266 |
|
| 267 |
|
-Sofern das Deploy-Plugin bereits in {{formcycle/}} installiert ist, kann das Plugin-Projekt dann wie folgt gebaut und hochgeladen werden: |
|
272 |
+Sofern das Deploy-Plugin bereits in {{formcycle/}} installiert ist, kann das Plugin-Projekt dann beim Bauen wie folgt hochgeladen werden: |
| 268 |
268 |
|
| 269 |
269 |
{{code language="bash"}} |
| 270 |
|
-mvn fc-deploy:deploy |
| 271 |
|
-{{/code}} |
| 272 |
|
- |
| 273 |
|
-Es wird hierbei davon ausgegangen, dass {{formcycle/}} unter der Standard-URL {{code}}http://localhost:8080/xima-formcycle{{/code}} läuft und das Standard-Passwort "admin" für das Deploy-Plugin verwendet wird. Ist dies nicht der Fall, können die Werte auch angepasst werden: |
| 274 |
|
- |
| 275 |
|
-{{code language="bash"}} |
| 276 |
276 |
mvn package fc-deploy:deploy -DfcDeployUrl=http://localhost:8080/xima-formcycle -DfcDeployToken=admin |
| 277 |
277 |
{{/code}} |
| 278 |
278 |
|
| 279 |
|
-{{info}} |
| 280 |
|
-Bis einschließlich Version 7.x von {{formcycle/}} und dem Maven-Plugin ist es noch erforderlich, die package-Phase explizit aufzuführen. Zudem müssen die URL und das Passwort angegeben werden. Ab Version 8.x sind die Standardwerte gesetzt und die package-Phase wird automatisch ausgeführt. |
| 281 |
|
-{{/info}} |
| 282 |
|
- |
|
278 |
+Wird Eclipse benutzt, kann auch eine Launch-Configuration mit den //fcDeployUrl// und dem //fcDeployToken// angelegt werden. Das Plugin wird dann unter den System-Plugins registriert. |
| 283 |
283 |
Soll das Plugin im Bereich eines bestimmten Mandanten registriert werden, so kann dies über den zusätzlichen Launch-Configuration Parameter //fcDeployClientId //erreicht werden. Dieser Parameter muss als Wert die Id des Mandanten enthalten. |
| 284 |
284 |
|
| 285 |
285 |
== FC-Server-Plugin == |
| ... |
... |
@@ -290,7 +290,7 @@ |
| 290 |
290 |
|
| 291 |
291 |
{{code language="bash"}} |
| 292 |
292 |
# Aktuelle Version starten |
| 293 |
|
-mvn fc-server:run-ms-war |
|
289 |
+mvn package fc-server:run-ms-war |
| 294 |
294 |
|
| 295 |
295 |
# Spezifische Version starten |
| 296 |
296 |
mvn de.xima.fc.maven.plugin:fc-server-maven-plugin:7.0.4:run-ms-war -DxfcVersion=7.0.16 |
| ... |
... |
@@ -301,18 +301,9 @@ |
| 301 |
301 |
{{/info}} |
| 302 |
302 |
|
| 303 |
303 |
{{info}} |
| 304 |
|
-Bis einschließlich Version 7.x von {{formcycle/}} und dem Maven-Plugin ist es noch erforderlich, die package-Phase explizit aufzuführen: {{code}}mvn package fc-server:run-ms-war{{/code}}. Ab Version 8.x geschieht dies automatisch. |
| 305 |
|
-{{/info}} |
| 306 |
|
- |
| 307 |
|
-{{info}} |
| 308 |
308 |
Die Major- und Minor-Version des Maven-Plugins sollte immer der Major- und Minor-Version des zu startenden {{formcycle case="gen"/}} entsprechen. Für {{formcycle/}} 7.0.x sollte also das Maven-Plugin in Version 7.0.x verwendet werde, für {{formcycle/}} 7.1.x das Maven-Plugin in Version 7.1.x usw. |
| 309 |
309 |
{{/info}} |
| 310 |
310 |
|
| 311 |
311 |
Nach kurzer Wartezeit (beim ersten Mal kann es länger dauern) ist dann ein {{formcycle/}}-Server gestartet. Die URL steht am Ende in der Kommandozeile, standardmäßig http://localhost:8080/xima-formcycle Der Zugang für den Superadmin ist {{code language="plaintext"}}sadmin{{/code}} (Passwort {{code language="plaintext"}}admin{{/code}}), der Zugang für den Mandantadministrator {{code language="plaintext"}}admin{{/code}} (Passwort {{code language="plaintext"}}/admin_{{/code}}). |
| 312 |
312 |
|
| 313 |
|
-Falls der Befehl in einem Maven-Projekt eines {{formcycle/}}-Plugins ausgeführt wird, dann wird das Plugin automatisch gebaut und nach dem Starten des Servers hochgeladen und installiert. Zudem wird versucht, die {{formcycle/}}-Version aus dem Plugin-Projekt auszulesen. |
| 314 |
|
- |
| 315 |
|
-Dies funktioniert auch in einem Ordner ohne Maven-Projekt. Falls keine {{formcycle/}}-Version angegeben ist, wird eine Standard-Version genommen, abhängig von der Maven-Plugin-Version. |
| 316 |
|
- |
| 317 |
|
-Für fortgeschrittenen Gebrauch siehe die [[README.md>>attach:README.md||rel="__blank"]]. |
| 318 |
|
- |
|
305 |
+Dies funktioniert auch in einem Ordner ohne Maven-Projekt. Falls keine {{formcycle/}} angegeben ist, wird eine Standard-Version genommen. Wird der Befehl innerhalb eines Plugin-Maven-Projekts ausgeführt, wird versucht, die Version von {{formcycle/}} aus dem Plugin-Projekt auszulesen. |
