Onboard UPS Connector to Axon-ivy market (#1)

* Initial commit

* feat: add rest client to call UPS API

* feat: add tracking demo

* Finalize demo of UPS

* update pom.xml

* add JUnit Test for ups connector

* chore: polish doc & move images to folder

* chore: Update product.json & group id, project version

* fix: Correct version

* chore: Adjust product component

* fix: update version

* fix: update version

* refactor: format code and remove unused code

* update pom.xml add oauth module

* remove line space

* refactor: change to normal property to avoid encoded the variable on rest client config

* fix: correct parameter in process after changing variable name

* refactor: add variable for Auth base URL

* refactor: use frame-10 template, update property name

* fix: update project build plugin version

* Remove pattern project

* refactor: update package name, format code

* fix: correct OAuth feature location on rest client

* refactor: add connector tags, change version in pom.xml

* refactor: add tag for demo project

* update project build plugin version (#7)

---------

Co-authored-by: Ny Huynh <[email protected]>
Co-authored-by: Ny Huynh <[email protected]>
Co-authored-by: AAVN\ptanh2 <[email protected]>
Co-authored-by: ptanhaxon <[email protected]>

.gitignore

@@ -10,9 +10,10 @@ hs_err_pid*
 
 # maven
 target/
+lib/mvn-deps/
 
 # ivy
-lib/mvn-deps/
-logs/
+classes/
 src_dataClasses/
 src_wsproc/
+logs/

.project

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>ups-modules</name>
+	<comment></comment>
+	<projects>
+	</projects>
+	<buildSpec>
+	</buildSpec>
+	<natures>
+	</natures>
+</projectDescription>

README.md

@@ -1,7 +1,6 @@
-# MY-PRODUCT-NAME
+# UPS connector
+[![CI Build](https://github.com/axonivy-market/ups-connector/actions/workflows/ci.yml/badge.svg)](https://github.com/axonivy-market/ups-connector/actions/workflows/ci.yml)
 
-[![CI Build](https://github.com/axonivy-market/REPO-NAME/actions/workflows/ci.yml/badge.svg)](https://github.com/axonivy-market/REPO-NAME/actions/workflows/ci.yml)
+This is a UPS module built in the Axon Ivy framework, enabling users to seamlessly integrate with UPS services. With this app, users can effortlessly manage their packages through UPS.
 
-"YOUR SHORT DESCRIPTION GOES HERE"
-
-Read our [documentation](MY-PRODUCT-NAME-product/README.md).
+Read our [documentation](ups-connector-product/README.md).

pom.xml

@@ -1,12 +1,13 @@
 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
   <modelVersion>4.0.0</modelVersion>
-  <groupId>com.axonivy.market</groupId><!-- your group id: e.g. com.axonivy.connector.<myconnector> or com.axonivy.utils.<myutil> -->
-  <name>my-product</name><!-- fill your product name -->
-  <artifactId>my-product-modules</artifactId><!-- fill your product name + a "-modules" postfix -->
-  <version>10.0.0-SNAPSHOT</version><!-- identicate your minimal compliant ivy version with the first 2 digits -->
+  <groupId>com.axonivy.connector.ups</groupId>
+  <name>ups-connector</name>
+  <artifactId>ups-connector-modules</artifactId>
+  <version>10.0.14-SNAPSHOT</version>
   <packaging>pom</packaging>
 
   <modules>
+  	<module>ups-oauth-feature</module>
     <module>${project.name}</module>
     <module>${project.name}-demo</module>
     <module>${project.name}-test</module>

ups-connector-demo/.classpath

@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<classpath>
+	<classpathentry kind="src" path="src">
+		<attributes>
+			<attribute name="optional" value="true"/>
+		</attributes>
+	</classpathentry>
+	<classpathentry excluding="**/*.ivyClass|**/*.p.json|**/*.rddescriptor|**/*.xhtml" kind="src" path="src_hd">
+		<attributes>
+			<attribute name="optional" value="true"/>
+		</attributes>
+	</classpathentry>
+	<classpathentry kind="src" path="src_wsproc">
+		<attributes>
+			<attribute name="optional" value="true"/>
+		</attributes>
+	</classpathentry>
+	<classpathentry kind="src" path="src_dataClasses">
+		<attributes>
+			<attribute name="optional" value="true"/>
+		</attributes>
+	</classpathentry>
+	<classpathentry kind="con" path="org.eclipse.m2e.MAVEN2_CLASSPATH_CONTAINER">
+		<attributes>
+			<attribute name="maven.pomderived" value="true"/>
+		</attributes>
+	</classpathentry>
+	<classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER"/>
+	<classpathentry exported="true" kind="con" path="IVY_CONTAINER"/>
+	<classpathentry kind="con" path="WEBAPP_CONTAINER"/>
+	<classpathentry kind="con" path="org.eclipse.jst.j2ee.internal.web.container"/>
+	<classpathentry kind="output" path="target/classes"/>
+</classpath>

ups-connector-demo/.gitignore

@@ -0,0 +1,19 @@
+# general
+Thumbs.db
+.DS_Store
+*~
+*.log
+
+# java
+*.class
+hs_err_pid*
+
+# maven
+target/
+lib/mvn-deps/
+
+# ivy
+classes/
+src_dataClasses/
+src_wsproc/
+logs/

ups-connector-demo/.project

@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>ups-connector-demo</name>
+	<comment></comment>
+	<projects>
+	</projects>
+	<buildSpec>
+		<buildCommand>
+			<name>ch.ivyteam.ivy.designer.dataClasses.ui.ivyDataClassBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>ch.ivyteam.ivy.designer.process.ui.ivyWebServiceProcessClassBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>org.eclipse.jdt.core.javabuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>org.eclipse.wst.common.project.facet.core.builder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>ch.ivyteam.ivy.designer.ide.ivyModelValidationBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>org.eclipse.m2e.core.maven2Builder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+	</buildSpec>
+	<natures>
+		<nature>ch.ivyteam.ivy.project.IvyProjectNature</nature>
+		<nature>org.eclipse.wst.common.modulecore.ModuleCoreNature</nature>
+		<nature>org.eclipse.jem.workbench.JavaEMFNature</nature>
+		<nature>org.eclipse.jdt.core.javanature</nature>
+		<nature>org.eclipse.m2e.core.maven2Nature</nature>
+		<nature>org.eclipse.jem.beaninfo.BeanInfoNature</nature>
+		<nature>org.eclipse.wst.common.project.facet.core.nature</nature>
+		<nature>org.eclipse.wst.jsdt.core.jsNature</nature>
+	</natures>
+</projectDescription>

ups-connector-demo/.settings/.jsdtscope

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<classpath>
+	<classpathentry excluding="**/bower_components/*|**/node_modules/*|**/*.min.js" kind="src" path="webContent"/>
+	<classpathentry kind="con" path="org.eclipse.wst.jsdt.launching.JRE_CONTAINER"/>
+	<classpathentry kind="con" path="org.eclipse.wst.jsdt.launching.WebProject">
+		<attributes>
+			<attribute name="hide" value="true"/>
+		</attributes>
+	</classpathentry>
+	<classpathentry kind="con" path="org.eclipse.wst.jsdt.launching.baseBrowserLibrary"/>
+	<classpathentry kind="output" path=""/>
+</classpath>

ups-connector-demo/.settings/ch.ivyteam.ivy.designer.prefs

@@ -0,0 +1,5 @@
+ch.ivyteam.ivy.designer.preferences.DataClassPreferencePage\:DEFAULT_DATA_CLASS=com.axonivy.ups.connector.demo.Data
+ch.ivyteam.ivy.designer.preferences.DataClassPreferencePage\:DEFAULT_NAMESPACE=com.axonivy.ups.connector.demo
+ch.ivyteam.ivy.project.preferences\:PRIMEFACES_VERSION=11
+ch.ivyteam.ivy.project.preferences\:PROJECT_VERSION=100000
+eclipse.preferences.version=1

ups-connector-demo/.settings/org.eclipse.jdt.core.prefs

@@ -0,0 +1,10 @@
+eclipse.preferences.version=1
+org.eclipse.jdt.core.compiler.codegen.inlineJsrBytecode=enabled
+org.eclipse.jdt.core.compiler.codegen.targetPlatform=17
+org.eclipse.jdt.core.compiler.compliance=17
+org.eclipse.jdt.core.compiler.problem.assertIdentifier=error
+org.eclipse.jdt.core.compiler.problem.enablePreviewFeatures=disabled
+org.eclipse.jdt.core.compiler.problem.enumIdentifier=error
+org.eclipse.jdt.core.compiler.problem.reportPreviewFeatures=warning
+org.eclipse.jdt.core.compiler.release=enabled
+org.eclipse.jdt.core.compiler.source=17

ups-connector-demo/.settings/org.eclipse.wst.common.component

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?><project-modules id="moduleCoreId" project-version="1.5.0">
+    <wb-module deploy-name="ups-connector-demo">
+        <wb-resource deploy-path="/" source-path="/webContent" tag="defaultRootSource"/>
+        <wb-resource deploy-path="/WEB-INF/classes" source-path="/src"/>
+        <wb-resource deploy-path="/WEB-INF/classes" source-path="/src_hd"/>
+        <wb-resource deploy-path="/WEB-INF/classes" source-path="/src_wsproc"/>
+        <wb-resource deploy-path="/WEB-INF/classes" source-path="/src_dataClasses"/>
+        <property name="context-root" value="ups-connector-demo"/>
+        <property name="java-output-path" value="/ups-connector-demo/target/classes"/>
+    </wb-module>
+</project-modules>

ups-connector-demo/.settings/org.eclipse.wst.common.project.facet.core.prefs.xml

@@ -0,0 +1,7 @@
+<root>
+  <facet id="jst.jsf">
+    <node name="libprov">
+      <attribute name="provider-id" value="jsf-user-library-provider"/>
+    </node>
+  </facet>
+</root>

ups-connector-demo/.settings/org.eclipse.wst.common.project.facet.core.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<faceted-project>
+  <fixed facet="wst.jsdt.web"/>
+  <installed facet="java" version="17"/>
+  <installed facet="jst.web" version="3.0"/>
+  <installed facet="wst.jsdt.web" version="1.0"/>
+  <installed facet="jst.jsf" version="2.1"/>
+</faceted-project>

ups-connector-demo/.settings/org.eclipse.wst.css.core.prefs

@@ -0,0 +1,2 @@
+css-profile/<project>=org.eclipse.wst.css.core.cssprofile.css3
+eclipse.preferences.version=1

ups-connector-demo/.settings/org.eclipse.wst.jsdt.ui.superType.container

@@ -0,0 +1 @@
+org.eclipse.wst.jsdt.launching.baseBrowserLibrary

ups-connector-demo/.settings/org.eclipse.wst.jsdt.ui.superType.name

@@ -0,0 +1 @@
+Window

ups-connector-demo/config/custom-fields.yaml

@@ -0,0 +1,20 @@
+# == Custom Fields Information ==
+# 
+# You can define here your project custom fields.
+# Have a look at our documentation for more information.
+#
+CustomFields:
+#  Tasks:
+#    MyTaskCustomField:
+#      Label: My task custom field
+#      Description: This new task custom field can be used to ...
+#      Type: STRING
+#  Cases:
+#    MyCaseCustomField:
+#      Label: My case custom field
+#      Description: This new case custom field can be used to ...
+#      Type: STRING
+#  Starts:
+#    MyStartCustomField:
+#      Label: My start custom field
+#      Description: This new start custom field can be used to ...

ups-connector-demo/config/databases.yaml

@@ -0,0 +1 @@
+Databases:

ups-connector-demo/config/overrides.any

@@ -0,0 +1 @@
+*

ups-connector-demo/config/persistence.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<persistence xmlns="http://xmlns.jcp.org/xml/ns/persistence" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.2" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/persistence http://xmlns.jcp.org/xml/ns/persistence/persistence_2_2.xsd"/>

ups-connector-demo/config/rest-clients.yaml

@@ -0,0 +1 @@
+RestClients:

ups-connector-demo/config/roles.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<role>
+    <identifier>Everybody</identifier>
+</role>

ups-connector-demo/config/users.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<userConfig/>

ups-connector-demo/config/variables.yaml

@@ -0,0 +1,24 @@
+# == Variables ==
+# 
+# You can define here your project Variables.
+# If you want to define/override a Variable for a specific Environment, 
+# add an additional ‘variables.yaml’ file in a subdirectory in the ‘Config’ folder: 
+# '<project>/Config/_<environment>/variables.yaml
+#
+Variables:
+
+  ups-connector:
+
+      # Url to UPS connector
+      Url: "https://wwwcie.ups.com/api"
+
+      # Your UPS Auth base URI
+      authUri: "https://wwwcie.ups.com/security/v1/oauth"
+
+      # Your UPS Application (client) ID
+      appId: "ZItPy7z8Ep1bZBpGLVQbW3CPiMk9rGFJDpRLjgocLCJbQ5Tw"
+
+      # Secret key from your applications "certificates & secrets"
+      # [password]
+      secretKey: "rLLiUjXI5j59kjvCWBfmXspBNCeW7Oo6x0RhOL0EyDSnADF7Vj4kHjx0JNAK3Jvi"
+

ups-connector-demo/config/webservice-clients.yaml

@@ -0,0 +1 @@
+WebServiceClients:

ups-connector-demo/dataclasses/com/axonivy/ups/connector/demo/Data.ivyClass

@@ -0,0 +1,2 @@
+Data #class
+com.axonivy.ups.connector.demo #namespace