Add a button or link

Custom buttons and links are added to the Preview pane when editing a layout. The URL is used to open a webpage in the current or new tab, run a CRMScript from the screen, or navigate to other parts of SuperOffice using SoProtocol. Buttons and links work similarly. The difference is that you can style a button but not a link. The instructions below assume you are already editing the layout.

​

Add a button

1. Select the tab you want to edit.
2. Select the Elements section on the left.
3. Click and drag the Button element to the layout.
4. Click to select the new button.
5. In the Settings sections to the left, replace the text “Button” with the new button name.
   You can also add the button name in other languages.
6. In the Action list, select the action to perform when clicking the button. For details about each action, see the reference section at the end of this page.
   • Open website: Select this option to add a link to a website. Select the URL encoding and target as necessary.
   • Execute CRMScript: Select this option to add a CRMScript to run specific actions in SuperOffice.
   • Shortcut (SoProtocol): Select this option to add a control that, when clicked, navigates to a different area or screen in SuperOffice.
7. In the Mode list, choose if the button should always be available, or if it should only be available in read or edit mode.
8. In the Style list, select the style of the button.

​

Add links

1. Select the tab you want to edit.
2. Select the Elements section on the left.
3. Click and drag the Link element to the layout.
4. Click to select the new link field.
5. In the Settings sections to the left, replace the text “Link” with the new link name.
   You can also add the link name in other languages.
6. In the Action list, select the action to perform when clicking the link. (Same list as for buttons.)
7. In the Mode list, choose if the link should always be available, or if it should only be available in read or edit mode.

​

Translating labels

The name and tooltip text can be translated into other languages. When the element is selected:

1. Click the button next to the label.
2. Click Add and select a language from the list.
3. Enter text for the new language.
4. Repeat steps 2-3 for additional languages.
5. Click Close to exit the translation dialog.

Remember to republish the layout.

​

Reference

Some settings depend on the selected action.

​

Open website

• URL encoding: none, ANSI, or Unicode
• Target: new tab or same tab

​

Execute CRMScript

• CRMScript: Select the specific script to run.

Learn more about CRMScript

​

Shortcut (SoProtocol)

• SoProtocol: The navigation and content part of the URL without the superoffice: prefix.

Learn more about SoProtocol