How To: Use the SmartObject Hyperlink Property to Navigate to a URL

1. Create a SmartObject called Hyperlinks with the following properties:
   
   

   Hyperlinks SmartObject	Type	Key	Required	Unique
   ID	Autonumber	Yes	No	Yes
   SmartObject Hyperlink	Hyperlink	No	No	No

2. Create a SmartObject called Sales with the following properties:
   
   

   Hyperlinks SmartObject	Type	Key	Required	Unique
   ID	Autonumber	Yes	No	Yes
   Item	Text	No	No	No
   Price per Unit	Number	No	No	No
   Quantity	Number	No	No	No
   Total	Number	No	No	No
   HyperlinkID	Number	No	No	No

In this step, you create an association between the Hyperlinks and Sales SmartObjects.

1. From the category tree, right click the Hyperlinks SmartObject and click Edit.
   
2. Go to the Associations tab and click Add to open the Add Association wizard.
   
3. On the SmartObject tab of the wizard click Add, select the Sales SmartObject from the Hyperlinks category, then click Next.
   
4. On the Association tab of the wizard, make sure the associations are defined as shown below and click Next.
   
5. On the Relationships tab of the wizard select the ID field and click Assign. Select the HyperlinkID field in the Assign property dialog. Click OK and then Finish.
   
6. The association shows on the Association tab of the Hyperlinks SmartObject. Click Finish.
   

In this step, you generate Item views for the Hyperlinks and Sales SmartObjects.

1. From the category tree, right click the Hyperlinks SmartObject and click Generate Views.
   
2. On the Generate Options page, in the Views section, make sure that the views are generated in the correct category. In this example they are generated in the Hyperlinks category. Check the Item check box for the Hyperlinks SmartObject and then click OK.
   
3. Use the same steps to generate an Item view for the Sales SmartObject. The views show in the Hyperlinks category.
   

In this step, you set the Read-Only property of the hyperlink to false so you can update it in the Item view.

1. From the K2 Designer, right-click the Hyperlinks Item view and select Edit.
   
2. On the Layout tab, click the hyperlink control of the SmartObject Hyperlink and untick the Read-Only property. This allows you to specify a URL and display value at runtime.
3. Click Finish to save the view.

In this step, you run the Hyperlinks view to add details such as a hyperlink for live exchange rates.

1. From the K2 Designer, locate the Hyperlinks Item view and click Run.
   
2. Click the hyperlink and then type the URL and Display details. Click OK and then click Create.
   
3. The Live Exchange Rates URL is saved to the Hyperlinks SmartObject for future use. Note the ID as you will use it in the next step.
   

In this step, you add a Hyperlink control and a rule to execute the Get List method.

1. From the K2 Designer, right-click the Sales Item view and select Edit.
   
2. On the Layout tab, drag the Hyperlink control onto the canvas.
   
3. Navigate to the Rules tab and click Add Rule.
4. On the Events tab, select When the View executes a method and then select Initialize.
   
5. Click the Actions tab, then select Execute a SmartObject method. Select the Hyperlinks SmartObject, Get List method and then click configure.
   
6. Type 1 next to ID on the Input Mappings tab. This is the ID of the Live Exchange Rates record you created earlier. Click the Output Mappings tab.
   
7. Drag the SmartObject Hyperlink from the Return Properties into the Hyperlink control. Click Finish and OK.
   
8. The rule shows in the Rules tab.
   
9. Click Finish to save the view.

In this step, you run the Sales Item view and use the hyperlink to navigate to the Live Exchange Rates URL.

1. From the K2 Designer, locate the Sales Item view and click Run.
   
2. Click the Live Exchange Rates hyperlink.
   
3. The Live Exchange Rates URL opens in a new browser tab.