Configuring Rich Forms

You need to configure the following steps to access Rich Forms in Adeptia Suite. You can configure Rich Forms in MySQL, SQL Server, and Oracle database only.

To configure Rich Forms:

Import Adeptia Suite public certificate to Adeptia Suite Truststore. This step is mandatory only if you are accessing Adeptia Suite through HTTPS protocol.
1. Export Public Key
  The steps to export the key varies from browser to browser. The following are the steps to export the public key in Google Chrome browser.
  1. Open the browser and type the HTTPS URL to access Adeptia Suite.
  2. Click > More tools > Developer tools.
  3. Click Security tab.
  4. Click View Certificate.
  5. On the Certificate window, on the Details tab, click Copy to File.
  6. Click Next to start exporting the certificate.
  7. Choose DER encoded binary X.509 (.CER) and click Next.
  8. Specify the location to save the exported file and click Next.
  9. Click Finish to export. A dialog box appears confirming the export process have been completed successfully.
  10. Click OK to exit from the wizard.
2. Import Adeptia Suite certificate into Adeptia Suite Truststore
  1. Open Command Prompt (press Win + R and type cmd).
  2. Go to the directory where JRE is installed (for example, C:/Program Files/Java/jre8/bin).
  3. Run the following Keytool command to import a certificate
```
keytool -import -trustcacerts -file <Path_of_SSL_Certificate> -alias <alias_name> -keystore <Path of Truststore file> -storepass changeit
```
    where,
    <Path_of_SSL_Certificate> is the path of SSL certificate.
    <Path of Truststore file> is the path of Adeptia Suite Truststore.
    For example, keytool -import -trustcacerts -file "/home/ec2-user/Downloads/localhost.cer" -alias selfsign -keystore "/opt/AdeptiaSuite-6.9/AdeptiaServer/ServerKernel/etc/truststore/cacerts"
Create a new database withutf-8character set. Depending on the database you are using, expand the database to find the query to create a new database.
MySQL
```
create database <database_name> default character set "utf8" default collate "utf8_unicode_ci";
```
SQL Server
```
create database <database_name>;
```
Oracle
Adeptia supports Oracle 12c and 11g only. Depending on the version you are using, follow the wizard to create a new database.
After creating the new database, you need to create a user other than System user and grant access to the Oracle database (created above) to the new user.
1. Log in to the new database created above.
2. Create a user by executing the following command:
  CREATE USER <Username> IDENTIFIED BY <Password> QUOTA UNLIMITED ON USERS;
  where,
  <Username> is the name of the user.
  <Password> is the password to authenticate a user.
3. Run the following queries to grant permissions:
  GRANT CONNECT, CREATE SESSION, RESOURCE, CREATE VIEW TO <Username>; GRANT create session TO <Username>; GRANT create table TO <Username>; GRANT create view TO <Username>; GRANT create any trigger TO <Username>; GRANT create any procedure TO <Username>; GRANT create sequence TO <Username>; GRANT create synonym TO <Username>; GRANT create sequence TO <Username>; GRANT create any index TO <Username>; GRANT create sequence TO <Username>; GRANT alter any table TO <Username>; where, <Username> is the name of the new user created above.
Go to .../<AdeptiaInstallFolder>/ServerKernel/etc folder.

Open server-configure.properties file in the Text Editor.

In Frevvo Database Configuration subgroup, provide the details of the database you are using in the properties.

Property Name	Description
abpm.frevvo.db.driver	Name of the Frevvo database driver URL. MySQL: com.mysql.jdbc.Driver SQL-Server: com.microsoft.sqlserver.jdbc.SQLServerDriver Oracle: oracle.jdbc.OracleDriver
abpm.frevvo.db.url	Name of the Frevvo database connection URL. The format of the URL for MySQL and SQL Server database is: jdbc:<Database_Name>://<IPaddress_on_which_Database_is_installed>:<Database_Port_No>/<Database_Name_Created_in_Step2> If you are using a named instance of SQL Server database, then enter the URL in the following format: jdbc:<Database_Name>://<IPaddress_on_which_Database_is_installed>:<Database_Port_No>/<Database_Name_Created_in_Step2>;instanceName=<instance_name> MySQL: jdbc:mysql://192.168.1.2:3306/frevvoDB SQL-Server: jdbc:sqlserver://192.168.1.1:1433;databaseName=frevvo SQL-Server (using instance): jdbc:sqlserver://192.168.1.1:1433;databaseName=frevvo;instanceName=adeptia The format of the URL for Oracle database is: Oracle: jdbc:oracle:thin:@<IPaddress_on_which_Database_is_installed>:<Database_Port_No>:<Database_Name_Created_in_Step2> for example, jdbc:oracle:thin:@192.168.1.3:1521:frevvodb
abpm.frevvo.db.username	Database username you are using. In case you are using Oracle then type the user name that you have created in the database in Step 2.
abpm.frevvo.db.password	Password to access database. In case you are using Oracle then type the password that you have provided in the database in Step 2. To use an encrypted password of the database, change the value of 'encrypt' property to "y".
abpm.frevvo.dbType	Database you are using, for example, MySQL, SQL-Server, Oracle.

If you are using SQL Server database, use Microsoft driver class and database URL instead of using JTDS.

Save the file.

Go to .../<AdeptiaInstallFolder>/ServerKernel/etc/jetty/contexts folder.
Rename richForms.xml_disable file to richForms.xml.
Start Kernel and WebRunner. This will create Rich Forms related tables in the newly created database.
Open the browser and type the URL in the format:
<protocol_name>://<IPaddress>:<Port_No>/frevvo
where,
<protocol_name> is the protocol you are using, for example, http or https.
<IPaddress> is the domain name or IP address of the server hosting Adeptia Suite.
<Port_No> is the port number of the server hosting Adeptia Suite.
For example, http://192.168.1.1:8080/frevvo.
On the License Expired screen, type the license key and click Submit. Contact Adeptia Support Team for the license key.
Sign in to Frevvo using following default credentials and create a tenant:
Username: admin@d
Password: admin
1. On the Manage server screen, click Manage Tenants.
2. On the Tenants screen, click .
3. On the Add New Tenant screen, type adeptia in the Tenant Id, Admin User Id, Tenant Name, Admin User Password, Tenant Description, and Re-enter Admin User Password.
4. Type support@adeptia.com in the Admin User Email Address.
5. Click Submit. This creates your tenant.
6. Sign out from the user account.
Now sign in to Frevvo using following credentials and deploy Adeptia Template Rich Form.
Username: adeptia@adeptia
Password: adeptia
1. Click Home.
2. Click Upload.
3. On the Upload Application screen, click Choose File, and upload AdeptiaTemplate_app.zip file from the folder where you have extracted installer zip.
4. Click Upload.
  This deploys Adeptia Template Rich Form.

Verifying Rich Forms Configuration

Open the browser and type the URL in the format:
<protocol_name>://<IPaddress>:<Port_No>/frevvo
where,
<protocol_name> is the protocol you are using, for example, http or https.
<IPaddress> is the domain name or IP address of the server hosting Adeptia Suite.
<Port_No> is the port number of the server hosting Adeptia Suite.
Login using following credentials:
Username: adeptia@adeptia
Password: adeptia
Check the Adeptia Live Forms version displayed at the bottom of the screen. If it is 7.3.2 indicates your Frevvo version has been configured successfully.