Cisco IAC 4.1 is a highly-extensible product. The services, processes and user interface may be extended and customized to suite deployment-specific requirements.
Cisco IAC 4.1 user interface uses Cisco Prime UI XWT toolkit with IAC-specific extensions to provide Cisco IAC product with a consistent look-and-feel. The tools and process described in this document will compress and optimize your own customer user interface's web assets to improve page load times and decrease bandwidth utilization.
There are no specific requirements for this document.
Please make sure that Cisco IAC 4.1 or later is installed, configured, and running in the supported versions (or see the Cisco Intelligent Automation for Cloud Compatibility Matrix for details) before you begin.
For more information on document conventions, refer to Cisco Technical Tips Conventions.
Cisco IAC UI SDK uses Java SDK and Apache Maven.
Ensure the JAVA_HOME environment variable contains the location where the Java SDK is installed. Java Development Kit can be downloaded from www.oracle.com/technetwork/java/javase/downloads/index.htm.
Cisco UI SDK has been tested with Maven 3.0.5, 3.1.1 and 3.2.2. Extract the Maven package to your computer and set your PATH variable to the extracted package's bin directory so you can run the mvn command without typing in a full path.
Creating a Maven settings.xml with a proxy configuration
Maven will automatically download the necessary plugins and dependencies to build the UI. If you do not require a proxy to access the public internet, no further configuration is required. If you require a proxy to download items off the public internet, create a settings.xml file that defines the proxy information. A settings.xml is used to configure the behavior of Maven when advanced configuration is required.
A template settings.xml is located in the Maven installation directory under conf as:
<?xml version="1.0" encoding="UTF-8"?>
The contents of the zip file will be located in a directory called xwt-iac once extracted where x.y.z is the installed Cisco IAC version number. Please also make sure dist.pom.xml is there after the extraction.
Find the zipped file,xwt-iac-x.y.z-src.zip, in Windows Explorer. Click File > "Extract All" from the top menu and follow the Windows Explorer Extraction Wizard window
mvn [-s <path to settings.xml>] [-Dmaven.repo.local=.repository] -f dist.pom.xml package
Explanation of the options
-s <path to settings.xml>: (optional) If you require a settings.xml to configure proxy settings, you must specify the path to the settings.xml.
-Dmaven.repo.local=.repository: (optional) Maven will download project dependencies and maven plugins when building the UI. This option tells what directory those files will be downloaded to if you would like to control this. The default behaviour is to download them to your home directory in .m2/repository
-f dist.pom.xml: (mandatory) The path to the maven build script
package: (mandatory) The build target to run.
mvn -s c:\source\xwt-iac\settings.xml -Dmaven.repo.local=c:\source\xwt-iac\repository -f dist.pom.xml package
The built package will be located in target\xwt-iac.zip
The xwt-iac package contents must be extracted to the deployed RequestCenter.war inside custom/IAC. Create a backup of this directory before installing this package.