Ruleset Guidelines

When creating a ruleset, keep the following in mind:

• The order of precedence for specific hosts is based on the longest URI match. For example for the following rulesets

  mail1.central.abc.com|iplanet_mail_ruleset
  *.sfbay.abc.com|sfbay_ruleset
  *.abc.com|generic_ruleset

  sfbay_ruleset is used as it has the longest match.

• The rules in the ruleset are applied to each statement in the page until a rule matches a particular statement.

  While writing the rules, keep in mind the order of the rules. Rules are applied to the statements in a page, in the order in which they occur in the ruleset. If you have specific rules, and general rules that contain a "*", define the specific rules first, then the general rules. Otherwise, the general rule is applied to all statements, even before the specific rule is encountered.

• All rules need to be enclosed within the <RuleSet> </RuleSet> tags.

• Include all rules that need to rewrite HTML content in the <HTMLRules> </HTMLRules> section of the ruleset.

• Include all rules that need to rewrite JavaScript content in the <JSRules> </JSRules> section of the ruleset.

• Include all rules that need to rewrite XML content in the <XMLRules> </XMLRules> section of the ruleset.

• In your intranet pages, identify the URLs that need to be rewritten, and include the required rules in the appropriate sections (HTML, JSRules, or XMLRules) of the ruleset.

• Assign the ruleset to the required domain.

• Restart the Gateway to affect any changes:

  gateway-install-root/SUNWportal/bin/gateway -n gateway-profile-name start