Generating a URL in an RTF field using a workflow

To define a workflow to generate an external URL

1. Create a form or use an existing form, and add an RTF field and a button field on the form. For example, you can create a form with the following objects in Developer Studio.
   • A regular character field to enter an URL.
   • An RTF field to copy the URL from the regular character field using a workflow.
   • A button to trigger the workflow.

2. Select the button and in the Properties window, set the Visible property to False.

   You can also set to use the label of the button as the label for the external links.

3. Select the RTF field, in the Properties window, select the External URL Button property and click the ellipses button. 
4. In the Field Selector dialog box, select the button field to link it to the RTF field. For more information, see Using-field-names-field-values-and-expressions-in-workflow. 
5. Save the form.
6. Create an active link associated to the form that uses the Button/Menu Field execution option and specify the button field.
7. Define the required workflow actions needed to generate the URL string. Note that the last action must be a Set Field action to set the generated URL from the character field to the RTF field. Using the Set Field action, set the contents from the character field to the RTF field
8. Save the active link.

Verifying the workflow

You can verify the defined workflow using Mid Tier.

To verify the workflow for inserting an external URL

1. Open the form in Mid Tier.
2. Enter an external URL in the character field. You can specify the URL in the following formats:
   • www.bmc.com
   • http://www.bmc.com
   • <a href="http://www.bmc.com">

   • https://www.bmc.com.

     To open the Hypertext Transfer Protocol (HTTP) links, you can specify the URL without using the http:// string.  However, to open a Hypertext Transfer Protocol Secure (https) links, you must specify the complete address. For example, https://www.bmc.com.

3. Open the RTF Editor.
4. Select the text to add a link to the external link.
5. Click the option to open the Link Options dialog box.

6. Click the option next to the Link URL field. 
   This triggers the workflow associated with the RTF field to generate a URL and inserts the URL in the Link URL field. 

   If the workflow was constructed properly, then the URL generated by the workflow will be set in the URL Link Options Dialog. 

7. Close the Link Options dialog box.
8. Click OK to close the RTF Editor.
9. If you click on the selected text in the RTF display mode, the specified URL opens.

Generating URLS that link to the form Data

The RTF fields can generate a URL dynamically in the display mode based on AR System defined attributes provided in the HTML tag. The dynamic URL enables users to link to a specific entry or a set of entries on the AR System server.

Perform the following steps to generate a dynamic URL:

1. Open the form that you created in Mid Tier. See To define a workflow to generate an external URL.
2. Click the expand box next to the character field to open a dialog box.

3. Enter an HTML tag using the following format to generate a URL.
   <a href ="" arschema="form_name"arqual="qualification" arserver="servername"
   For example, <a href ="" arschema="User" arqual="RequestID=1"

   You cannot use the special characters such as ', ", < and > in the value of an HTML attribute and so qualifications need special considerations and must be replaced with the HTML character codes (such as, &quot;). To link to a form that opens with a range of entries matching the qualification. For example, to open all entries with RequestID is less than 100. So, you have to use special HTML characters.

   The following table lists the attributes that you can use in the HTML tag to generate a URL for a specific entry.

   Attribute	Description
   href	Source URL. For dynamic URL, you must add this attribute with an empty string. For example href =""
   arschema	(Optional) Form name. To link to an entry on the current form, you can ignore this attribute and the current form is assumed.
   arserver	(Optional) Server name. To link to an entry on the current server, you can ignore this attribute and the current server is assumed.
   arentryid	Entry ID or request ID of the entry on the server. Note: If you use arentryid attribute in the tag, you cannot use the arqual attribute.
   arqual	The qualification to open a specific entry or entries on the form. The form opens in the Search mode with the matching entries in the list. Note: If you use arqual in the tag, you cannot use the arentryid attribute.
   arvui	(Optional) View name. If you do not specify this option, the form opens in the default view.
   arattID	(Optional) Attachment ID. This opens an attachment embedded to a specific attachment field ID on the specific form.

4. Click OK.
5. Open the RTF Editor.
6. Select the text to add a link to the external link.
7. Click the option to open the Link Options dialog box.
8. Click the option next to the Link URL field.
   This triggers the workflow associated with the RTF field to generate a URL based on the attribute specifications and updates the URL in the Link URL field.
9. Close the Link Options dialog box.
10. Click OK to close the RTF Editor.
11. (Optional) Select the Open in a new window option to open an external URL on a new window.