Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The EDI solutions provided by Adeptia are readily available as EDI accelerators that you can download, deploy on the AC application, and start using. The accelerators are in the form of zip files. 

Deploying in AC 4.x

To deploy the EDI accelerators, follow the steps given below:

  1. Go to this location to view the details of migration helm package.

  2. Add migration repo using the following command:

    Code Block
    helm repo add adeptia-connect-migration https://adeptia.github.io/adeptia-connect-migration/charts/
  3. Click DEFAULT VALUES to download the values.yaml file.

    Image Removed
  4. Provide values for the following properties and environment variables in values.yaml file as shown in the table below.

...

Variable/Property

...

Value

...

BACKEND_DB_URL

...

<URL of the backend database server>

  • jdbc:sqlserver://<DB Hostname>:<Port Number>;database=<Backend Database Name>

  • jdbc:oracle:thin:@<hostName>:<portNumber>:<S ID/ServiceName>

...

BACKEND_DB_USERNAME

...

<Username of your backend database server>

...

BACKEND_DB_PASSWORD

...

<Password for your backend database server>

...

BACKEND_DB_DRIVER_CLASS

...

<Backend database driver class name>

...

BACKEND_DB_TYPE

...

<Type of the backend database server> For example, SQL-Server.

...

SHARED_PATH

...

<Environment variable in the values.yaml file that contains the configured shared path> The default value for this variable is /shared. This is the folder created at the root level in the PVC when you deploy Adeptia Connect.

...

MIGRATION_XML_FILE_PATH

...

<Path of the folder that contains the accelerator>.

5. Navigate to the migration directory, and run the below command to install the accelerator.

Code Block
helm upgrade -i migration adeptia/migration -f adeptia/values.yaml -n <NAMESPACE>

The Migration job does not get deleted automatically after the deployment is complete. You need to manually delete it before you start a new deployment. 

Deploying in AC 3.x (Windows)

Steps to deploy accelerator:

  1. Go to the location where Adeptia Connect is installed, for example, C:\Program Files\AdeptiaConnect\AdeptiaConnect-<version>.

  2. Open the bin folder.

  3. Double-click MigrationUtility.exe to run the Migration Utility Wizard.

    Image Removed
  4. Click Next.

  5. Select Adeptia Connect, and then click Next.

    Image Removed
  6. Select Install Accelerators, and then click Next

    Image Removed
  7. Browse to and select the accelerator zip, and click Next.

    Image Removed
  8. Browse to and select the Connect Server target location where you want to deploy the accelerator, for example, C:\Program Files\AdeptiaConnect\AdeptiaConnect-<version>\ConnectServer\AdeptiaServer, and then click Next.  
    Once the accelerator is installed successfully, a confirmation message appears.

  9. Click OK to close the confirmation dialog box. 

  10. Click Save Logs to save the logs. Choose the location to save the logs.

  11. Click Finish to exit the Migration utility.

Deploying in AC 3.x (Linux)

Steps to deploy accelerator:

...

Open Terminal, and go to the ServerKernel directory.

...

Enter the following command, and then press ENTER to start the Migration Utility.

Code Block
./migrationutility.sh –console

...

Type 2 for Adeptia Connect, and then press ENTER.

...

Type 3 for accelerator deployment, and press ENTER.

...

Type the source directory containing the accelerator zip, and press ENTER.

...

After you've downloaded the export zip (required EDI solution package based on your industry type) file containing the EDI Transactions, you can import the package by using the Import Package option under Solution Promotion feature at the target environment to deploy the solution.

Deploying the package

Follow the steps given below to import and thus deploy the package.  

  1. Click Account > Tools > Solution Promotion.

  2. On the left panel, select Import Packages.

  3. Click CREATE Import Package.

    Image Added
  4. On the Create Import Package screen, 

    1. Provide a name for the import package.

    2. Provide a description for the import package.

    3. In the Select Project field, select the project where you want to keep the import package.

    4. In the Override User field, select the user to whom you want to provide ownership of the Transactions.

    5. In the Override Modified By User field, select the user who will be reflected in the Modified By field of every Transaction after the deployment.
      Note: Ensure that you select a user in this field.

  5. Click Save & Exit.

  6. Click More under ACTION against the package, and then click Import Package.

    Image Added
  7. On the Import Package screen, click Browse to select the export zip file.

  8. Click Import.
    This deploys the EDI solution to the target environment and also creates a corresponding rollback zip that can be used to rollback the import operation. You can visit the Dashboard to view the details of the import operation. 

    You can also perform the rollback operation on the package from its More menu under ACTION.

Post deployment steps

After you have deployed the package, you need to grant permission to the partner on its respective EDI solution project. To grant permissions, follow the steps given below.

  1. Go to Configure > Projects.

  2. Click the More option under the Action column to view the action menu of the EDI Project.

  3. Click Grant Access.

    Image Added
  4. On the Grant Access screen, in the Partner tile, click Grant Access.

    Image Added
  5. On the Confirm dialog box, click Yes, grant it to provide access to the Partner.

Anchor
Rollingback
Rollingback
Rolling back the import operation

If you decide upon rolling back the import operation, you need to follow the instructions given below.

  1. Download the rollback zip file corresponding to the import package from the Dashboard by navigating as follows:
    Dashboard > Solution Promotion > More > rollback zip

    Image Added
  2. Go to the Import Packages manage page by navigating as follows:
    Account > Tools > Solution Promotion > Import Packages

  3. Click More under ACTION against the import package, and then click Rollback.

    Image Added
  4. On the Rollback screen, click Browse to select the rollback zip you have downloaded in step 1.

    Image Added
  5. Click Rollback.
    This rolls back the import operation. You can go to Dashboard > Solution Promotion to see the details of the rollback operation.