add docs

digitalservicebund · Nov 27, 2024 · c0a8504 · c0a8504
1 parent a5b8af8
commit c0a8504
Show file tree

Hide file tree

Showing 3 changed files with 27 additions and 2 deletions.
diff --git a/.gitignore b/.gitignore
@@ -46,3 +46,6 @@ lefthook-local.yml
 application-local.yaml
 signing_key.json
 decryption_key.json
+
+### egvp ###
+EGVP-WebService.xml
diff --git a/README.md b/README.md
@@ -32,6 +32,28 @@ brew install lefthook node talisman
 
 This will replace placeholders in the application template and install a couple of Git hooks.
 
+## Generate sources for EGVP SOAP service
+
+enable wsimport task in build.gradle.kts by setting
+
+```
+register("wsimport") {
+        enabled = true
+        ...
+```
+
+Place the webservice wsdl into the resources folder
+
+```
+/src/main/resources/EGVP-WebService.xml
+```
+
+and run
+
+```
+./gradlew clean build
+```
+
 ## Tests
 
 The project has distinct unit and integration test sets.

diff --git a/build.gradle.kts b/build.gradle.kts
@@ -71,8 +71,8 @@ tasks {
         finalizedBy(jacocoTestReport)
     }
     register("wsimport") {
-        val destDir by extra("$buildDir/generated/main/java")
         enabled = false
+        val destDir by extra("$buildDir/generated/main/java")
         doLast {
             ant.withGroovyBuilder {
                 mkdir(destDir)
@@ -84,7 +84,7 @@ tasks {
                 "wsimport"(
                     "keep" to true,
                     "sourcedestdir" to destDir,
-                    "wsdl" to "$projectDir/src/main/resources/EGVP-WebService.wsdl",
+                    "wsdl" to "$projectDir/src/main/resources/EGVP-WebService.xml",
                     "verbose" to true,
                 ) {
                     "xjcarg"("value" to "-XautoNameResolution")