Administer > Configuration > OO Designer

The OO Designer

The OO Designer is a web-based environment for authoring flows, which is embedded in the CSA UI.

This chapter provides information about configuring the OO Designer to work in an HTML Inline Frame Element (iFrame).

Note An iFrame embeds another HTML page into the current page.

Complete the following steps to configure CSA's OO Designer to appear in an iFrame instead of appearing in a new browser window.

  1. After installing CSA, edit the following file:
    CSA_HOME/jboss-as/standalone/deployments/csa.war/dashboard/config.json

  2. Locate the following section:

    {

    "id": "oo_designer",
    "name": "oo_designer",
    "description": "oo_designer_description",
    "enabled": true,
    "style": "oo_designer",
    "type": "link",
    "target": "_blank",
    "url": "/csa/oows_redirect.jsp",
    "helptopic": "/csa/oowshelp_redirect.jsp",
    "roles": ["CSA_ADMIN", "WORKFLOW_AUTHOR"]

    }

  3. Remove the line containing target and change the value of the type field to "iframe" as shown in bold font:

    {

    "id": "oo_designer",
    "name": "oo_designer",
    "description": "oo_designer_description",
    "enabled": true,
    "style": "oo_designer",
    "type": "iframe",
    "url": "/csa/oows_redirect.jsp",
    "helptopic": "/csa/oowshelp_redirect.jsp",
    "roles": ["CSA_ADMIN", "WORKFLOW_AUTHOR"]

    }

  4. Edit the following file:
    CSA_HOME/jboss-as/standalone/deployments/csa.war/oows_redirect.jsp

  5. Add "?embedded=true" to the URL as shown in bold font:

    <%@page import="com.hp.csa.core.cfg.CSAProperties" %>
    <html>
    <head>
    <%
    String oowsURL = CSAProperties.get("OO_WS_URL");
    response.sendRedirect(oowsURL + "/oo-designer/?embedded=true");
    %>
    </head>
    </html>

  6. Do the following to restart the HPE Cloud Automation service:

    • Window: Restart the HPE Cloud Service Automation service.

    • Linux: Run the following commandsr:

      1. Run ./csa stop

      2. Run ./csa status and check that the csa service is not running.

      3. Run ./csa start and check that the csa service is running.

CSA includes a self-signed certificate. After you configure CSA to open the OO Designer in an iframe, the browser might not trust the certificate. So you might not be able to open the OO Designer.

Complete the following steps to remedy this certificate issue.

  1. After you enter the CSA URL into a browser, the browser might mark the URL as being untrusted:

    • Chrome:

    • Internet Explorer: Look for a certificate error in the URL.

  2. Do the following to open a certificate dialog:

    • Chrome: Click the red triangle, then click Details.
    • Internet Explorer: Click the certificate error, then click View certificates.
  3. After the certificate dialog appears, export the certificate to a file using DER encoded binary X.509 (.CER) format. Remember the file name and location to which you exported the file.

  4. To Import the certificate to a browser's Trusted Root Certification Authorities do the following:

    • Chrome

      1. Click Settings >Show advanced settings...

      2. Locate the HTTPS/SSL section and click Manage certificates.

      3. After the Certificates dialog appears, select Trusted Root Certification Authorities.

      4. Click Import...

      5. Navigate to the certificate file that you exported previously.

      6. During the next step, select Place all certificates in the following store.

      7. Ensure that Certificate store is set to Trusted Root Certification Authorities, then click Next.

      8. Follow the remaining browser navigation instructions to install the certificate.

      9. Restart the browser and enter the CSA URL into the browser to test that you can now open CSA.

    • Internet Explorer:

      1. Click Internet Options >Content > Certificates.

      2. After the Certificates dialog appears, select Trusted Root Certification Authorities.

      3. Click Import...

      4. Navigate to the certificate file that you exported previously.

      5. During the next step, select Place all certificates in the following store.

      6. Ensure that Certificate store is set to Trusted Root Certification Authorities, then click Next.

      7. Follow the remaining browser navigation instructions to install the certificate.

      8. Restart the browser and enter the CSA URL into the browser to test that you can now open CSA.