Loading the ISO 20022 schemas

To use the ISO 20022 schemas, you must first load the XSD schema files on the computer running Test Integrations and APIs. Then, you must load the schema files for the Test Integrations and APIs Agent on the computer on which the agent is installed.

Before you begin

Make sure you have the required permission. On Windows™, you must be able to run a command prompt as an administrator. On Linux™ or Mac OS you must be the same user who installed the Test Integrations and APIs or Test Integrations and APIs Agent software.

Procedure

  1. Load the schemas on the computer on which Test Integrations and APIs is installed.
    1. Close the Test Integrations and APIs user interface.
    2. Open a command prompt or terminal window.
      • If you use a Windows™ computer, open the command prompt by right-clicking the Command Prompt icon, and then click Run as administrator.
      • If you use a Linux™ or Mac OS computer, open a terminal window. Ensure that you were the one who installed Test Integrations and APIs.
    3. Run the following command to change the directory:
      cd <install_dir>/tools/ISO20022XSDDownloader

      For example, the <install_dir> in Windows can be C:\Program Files\HCL\DevOpsTestAPI

    4. Run the following script that depends on the operating system of your computer:
      • startup.bat on Windows™
      • startup.sh on Linux™
      • startup_mac.sh on Mac OS
      After the script starts, explanatory text is displayed.
    5. Press Enter. For each of the submitting organizations, enter Y if you accept the displayed conditions and want to continue with the download. Otherwise, enter N and end the download.
      You must accept agreements from all submitting parties before you can download the files.
      The ISO20022 schema files are downloaded to the following directory: <install_dir>/externalSchemaCache/schemas.iso20022.org
    6. Close the command prompt or terminal window and restart Test Integrations and APIs.
      You can now see the ISO 20022 schemas in the Schema Library view.
  2. Load the schemas on the computer on which Test Integrations and APIs Agent is installed. Perform the following steps for each computer:
    1. Stop the Test Integrations and APIs Agent service on the Agent computer.
    2. Open a command prompt or terminal window.
      • If you use a Windows™ computer, open the command prompt by right-clicking the Command Prompt icon, and then click Run as administrator.
      • If you use a Linux™ or Mac OS computer, open a terminal window. Ensure that you were the one who installed Test Integrations and APIs.
    3. Run the following command to change the directory:
      cd <agent_install_dir>/tools/ISO20022XSDDownloader

      For example, the <agent_install_dir> in Windows can be C:\Program Files\HCL\DevOpsTestAPIAgent.

    4. Run the following script that depends on the operating system of your computer:
      • startup.bat on Windows™
      • startup.sh on Linux™
      After the script starts, explanatory text is displayed.
    5. Press Enter. For each of the submitting organizations, enter Y if you accept the displayed conditions and want to continue with the download. Otherwise, enter N and end the download.
      The ISO20022 schema files are downloaded to the following directory: <agent_install_dir>/externalSchemaCache/schemas.iso20022.org
    6. Close the command prompt or terminal window and restart the Test Integrations and APIs Agent service.

What to do next

You can view the ISO20022 schemas in the Schema Library. See ISO 20022 schema overview.