Custom S-Control Attributes

Find out about custom S-Control attributes.

Required Editions

Available in: Salesforce Classic
Available in: Contact Manager, Group, Professional, Enterprise, Performance, Unlimited, and Developer Editions
Attribute Name Description
Label The text that displays on page layouts for embedded s-controls.
S-Control Name The unique name for the s-control. This name can contain only underscores and alphanumeric characters, and must be unique in your org. It must begin with a letter, not include spaces, not end with an underscore, and not contain two consecutive underscores.
Type

Determines how you plan to use the s-control.

HTML
Select this option if you want to enter the content for your s-control in the Content area.
URL
Select this option if you want to enter the link or URL of an external website in the Content area.
Snippet
Snippets are s-controls that are designed to be included in other s-controls. Select this option if you want to enter the content for your s-control snippet in the Content area.
Description Text that describes the s-control. This only displays to administrators.
Content

Enter the content or source for your s-control. You can enter up to 1 million characters. The HTML code defines exactly how your users should view the custom s-control.

  • If you are building a formula in the Advanced Formula tab or for approvals or rules, such as workflow, validation, assignment, auto-response, or escalation, click Insert Field, choose a field, and click Insert.

    To create a basic formula that passes specific Salesforce data, select the Simple Formula tab, choose the field type in the Select Field Type drop-down list, and choose one of the fields listed in the Insert Field drop-down list. Build cross-object formulas to span to related objects and reference merge fields on those objects.

  • To insert an operator, choose the appropriate operator icon from the Insert Operator drop-down list.
  • To insert a function, double-click its name in the list, or select it and click Insert Selected Function. To filter the list of functions, choose a category from the Functions drop-down list. Select a function and click Help on this function to view a description and examples of formulas using that function.
  • To reference a file that you uploaded in the Filename field as part of the custom s-control, select Custom S-Control from the Select Field Type drop-down list, and choose Custom S-Control URL to get the merge field for it. For a Java applet, you can also use the {!Scontrol_JavaCodebase} merge field and the {!Scontrol_JavaArchive} merge field.
  • To insert activity merge fields, select Event or Task from Select Field Type.

Internet standards require special encoding for URLs. Salesforce encodes the text from any merge field you insert into a link. Encode extra text in your link manually. For example, to generate the following URL:

http://www.google.com/search?q={!user.name} Steve Mark 50%
http://www.google.com/search?q={!user.name}+Steve+Mark+50%25

Salesforce strips double quotes from URLs when the content source is a URL. If you must use double quotes, encode them manually. For example, to generate the URL http://www.google.com/search?q="salesforce+foundation", use this content: http://www.google.com/search?q=%22salesforce+foundation%22

Filename Upload a file to display when you add this custom s-control to a custom link. The file can contain a Java applet, Active-X control, or any other type of content. This option applies to HTML s-controls only.
Prebuild In Page This option keeps the s-control in memory, which may improve performance when the page is reloaded because the s-control does not have to be reloaded. This option applies to HTML s-controls only.
Encoding The default encoding setting is Unicode (UTF-8). Change it if you are passing information to a URL that requires data in a different format. This option is available when you select URL for the Type.