10.2

Edit

Install IA Cloud Developer

You can install IA Cloud Developer either directly on a developer workstation or on remote VDI within your company's private network. The latter installation option is typically used to comply with security policies or when it is impossible to install the company's applications on a developer workstation.

To get the installation package, refer to the download instructions.

Check prerequisites

Before moving to the installation, remember to do the following:

  1. Stop your running programs.

  2. Check if automatic Windows updates are not running at the moment. Otherwise, wait for them to complete or pause the process.

  3. Check that you have no previous versions of Express/Business Edition installed. Otherwise, uninstall.

  4. Make sure the antivirus software allows you to execute files and save data to folders required for launching and working with IA Cloud Developer:

    1. Execute all EXE and BAT files from C:/IntelligentAutomationCloudDeveloper.
    2. Execute MS SQL Server Express from C:/Program Files/Microsoft SQL Server.
    3. Execute Abbyy OCR from C:/Program Files (x86)/ABBYY SDK.
    4. Allow the system to store data in:
      • C:/ProgramData/WorkFusion
      • C:/Users/${user.directory}/ControlTower
      • C:/Users/${user.directory}/.m2
      • C:/Users/${user.directory}/.eclipse
      • C:/Users/${user.directory}/workfusion-workspace and other WorkSpace folders you can create during work

  5. Check that you can access the WorkFusion Nexus repository with all the latest artifacts and dependencies from your IDE (either Eclipse or IDEA). Ensure that https://repository.workfusion.com is available and Maven can work with it.

    note

    To resolve possible certificate or proxy issues if IA Cloud Developer is installed on secure VDI, see Install IA Cloud Developer to VDI | Troubleshoot major problems.

    If access to WorkFusion Nexus is strictly prohibited by policy, ensure that corporate Nexus is available and you have the URL and credentials to add to the project's pom.xml and Maven's settings.xml.

    To verify that, in IA Cloud Developer's Eclipse IDE (Studio), generate a project from the latest ODF archetype compatible with your server version and build a project with Maven by running mvn clean install.

Install IA Cloud Developer

To install IA Cloud Developer:

  1. Run IntelligentAutomationCloudDeveloperInstaller.exe as Administrator.

  2. Select the I accept the terms in the License Agreement checkbox. To view the agreement, click the License Agreement link.

    Read the License Agreement carefully. Use the scroll bar or press the page down key. Click Back to return to the installation process.

    Click Next.

  1. Сreate your Administrator credentials that will be valid for IA Cloud Developer only. The credentials must meet the following requirements:

    • For Username, 5 to 20 Latin letters or digits.
    • For Password, 8 to 20 Latin letters or digits.

    Click Next to proceed.

  2. Set the destination folder for installation.

    warning

    Avoid installing IA Cloud Developer into the folder containing spaces, for example, C:/Program Files. Instead, use the recommended default folder C:/IntelligentAutomationCloudDeveloper.

  3. Click Install.

  4. On the User Account Control screen, accept a security prompt by clicking Yes . The installation process starts.

  5. On finishing the installation, you are prompted that WorkFusion development environment works with the default Maven configuration on your workstation. Click OK to proceed.

    note

    Mind that the installer is backing up your C:/Users/User/.m2/settings.xml file. The renamed original file is located in the same .m2 folder.

  6. Check the box to launch Intelligent Automation Cloud Developer and click Finish.

Resolve possible issue during installation

IA Cloud Developer installer includes a standard installation package of MS SQL Express, the desktop database server used by multiple Platform components. During the MS SQL Express installation, you can get an error that terminates the whole IA Cloud Developer installation process:

The installation log shows the following error:

[4200:3508][2022-03-16T21:14:38]e000: Error 0x851a001a: Process returned error: 0x851a001a
[4200:3508][2022-03-16T21:14:38]e000: Error 0x851a001a: Failed to execute EXE package.
[3B10:0920][2022-03-16T21:14:38]e000: Error 0x851a001a: Failed to configure per-machine EXE package.
[3B10:0920][2022-03-16T21:14:38]i319: Applied execute package: SQLEXPR2016SP2x64ENU, result: 0x851a001a, restart: None
[3B10:0920][2022-03-16T21:14:38]e000: Error 0x851a001a: Failed to execute EXE package.

To fix, uncheck the "Beta: Use Unicode UTF-8 for worldwide language support" property in OS's Region Settings. To find this property, go to Settings > Time & Language > Region > Additional date, time & regional settings > Change date, time, or number formats > Administrative > Change system locale.

Install ImageMagick

ImageMagick is a command-line tool for image manipulations. It is used for image optimizations to achieve image characteristics that improve OCR quality. In particular, the Tagging Over Document workflow in the out-of-the-box OCR Use Case uses ImageMagick and Ghostscript.

To install, perform the following steps:

  1. Download the installation EXE files.

  2. Run the ImageMagick.exe file and accept the agreement.

    Before you continue, read the following information and click Next.

  3. Specify the destination folder for the installation and click Next.

  4. Select the Start Menu folder and click Next.

  5. On the Select Additional Tasks screen, select the Add application directory to your system path checkbox and click Next.

  6. Click Install to proceed.

  7. As soon as ImageMagick is installed, see the following information and click Next.

  8. Click Finish to exit.

Check installation

To check installed ImageMagick, follow the steps below:

  1. In a command-line tool, run any of the following commands to check the ImageMagick version:

    magick identify --version
# or 
magick convert -version

  2. Convert any PDF file sample with the following command:

    magick convert <path_to_pdf_file_for_convertion path_to_converted_file>

  3. Run the ghostscript.exe file to install Ghostscript.

  4. Run the ToD OCR workflow by choosing the Enriched output ETL Bot as OCR Type in OCR settings.

Browser driver potential expiration issue

RPA requires the latest Selenium drivers to support the latest browsers. The latter can be auto-updated at any time daily, so Selenium drivers included in IA Cloud Developer can become outdated.

If you face exceptions in Chrome, Firefox, or Internet Explorer tests of a test Business Process, update the corresponding driver:

  1. Find and download the latest drivers:
  2. In C:/IntelligentAutomationCloudDeveloper/RPA/rpa-grid/drivers/windows, replace the driver file with a new version. Choose the proper bit rate for your OS: x32 or x64.
  3. Stop and start the RPA Worker component group to get the system to use the new driver file.
← System requirementsInstall IA Cloud Developer to VDI →