撰寫規則集

如需定義規則集的詳細資訊，請參閱「Portal Server 管理指南」。在建立新規則集後，您必須定義必要的規則。

本節涵蓋下列主題：

• 公開介面 (規則集 DTD)

• XML DTD 範例

• 撰寫規則的步驟

• 規則集指導方針

• 定義規則集根元素

• 使用遞迴功能

• HTML 內容的規則

• JavaScript 內容的規則

• XML 內容的規則

• Cascading Style Sheet (串接樣式表) 的規則

• WML 的規則

公開介面 (規則集 DTD)

規則集 DTD：

<?xml version="1.0" encoding="UTF-8"?>
<!--
The following constraints are not represented in DTD, but taken care of programmatically
    1. In a Rule, All Mandatory attributes cannot be "*".
    2. Only one instance of the below elements is allowed, but in any order.
    1)HTMLRules
    2)JSRules
    3)XMLRules
    3. ID should always be in lower case.
-->
<!ENTITY % eURL ’URL’>
<!ENTITY % eEXPRESSION ’EXPRESSION’>
<!ENTITY % eDHTML ’DHTML’>
<!ENTITY % eDJS ’DJS’>
<!ENTITY % eSYSTEM ’SYSTEM’>

<!ENTITY % ruleSetElements ’(HTMLRules | JSRules | XMLRules)?’>
<!ENTITY % htmlElements ’(Form | Applet | Attribute)*’>
<!ENTITY % jsElements ’(Variable | Function)*’>
<!ENTITY % xmlElements ’(Attribute | TagText)*’>

<!ELEMENT RuleSet (%ruleSetElements;,%ruleSetElements;,%ruleSetElements;)>
<!ATTLIST RuleSet
    id ID #REQUIRED
    extends CDATA "none"
>

<!-- Rules for identifying rules in HTML content -->
<!ELEMENT HTMLRules (%htmlElements;)>
<!ELEMENT Form EMPTY>
<!ATTLIST Form
    name CDATA #REQUIRED
    field CDATA #REQUIRED
    valuePatterns CDATA ""
    source CDATA "*"
>

<!ELEMENT Applet EMPTY>
<!ATTLIST Applet
    code CDATA #REQUIRED
    param CDATA "*"
    valuePatterns CDATA ""
    source CDATA "*"
>

<!-- Rules for identifying rules in JS content -->
<!ELEMENT JSRules (%jsElements;)>
<!ELEMENT Variable EMPTY>
<!ATTLIST Variable
    name CDATA #REQUIRED
    type (%eURL; | %eEXPRESSION; | %eDHTML; | %eDJS; | %eSYSTEM;) "EXPRESSION"
    source CDATA "*"
>

<!ELEMENT Function EMPTY>
<!ATTLIST Function
    name CDATA #REQUIRED
    paramPatterns CDATA #REQUIRED
    type (%eURL; | %eEXPRESSION; | %eDHTML; | %eDJS;) "EXPRESSION"
    source CDATA "*"
>

<!-- Rules for identifying rules in XML content -->
<!ELEMENT XMLRules (%xmlElements;)>
<!ELEMENT TagText EMPTY>
<!ATTLIST TagText
    tag CDATA #REQUIRED
    attributePatterns CDATA ""
    source CDATA "*"
>

<!ELEMENT Attribute EMPTY>
<!ATTLIST Attribute
    name CDATA #REQUIRED
    tag CDATA "*"
    valuePatterns CDATA ""
    type (%eURL; | %eDHTML; | %eDJS; ) "URL"
    source CDATA "*"
>

除必要的屬性值不能只有 * 之外，您可使用 * 做為規則值的一部分。會忽略這類規則，但是訊息會記錄在 RuleSetInfo 記錄檔中。如需此記錄檔的資訊，請參閱除錯檔案名稱。

XML DTD 範例

本節包含一範例規則集。我們使用第 140 頁的「案例研究」來說明 Rewriter 解譯這些規則的方式。

<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
Rules for integrating a mail client with the gateway.
-->
<!DOCTYPE RuleSet SYSTEM "jar://rewriter.jar/resources/RuleSet.dtd">
<RuleSet type="GROUPED" id="owa">
<HTMLRules>
<Attribute name="action" />
<Attribute name="background" />
<Attribute name="codebase" />
<Attribute name="href" />
<Attribute name="src" />
<Attribute name="lowsrc" />
<Attribute name="imagePath" />
<Attribute name="viewClass" />
<Attribute name="emptyURL" />
<Attribute name="draftsURL" />
<Attribute name="folderURL" />
<Attribute name="prevMonthImage" />
<Attribute name="nextMonthImage" />
<Attribute name="style" />
<Attribute name="content" tag="meta" />
</HTMLRules>
<JSRules>
<!-- Rules for Rewriting JavaScript variables in URLs -->
<Variable name="URL"> _fr.location </Variable>
<Variable name="URL"> g_szUserBase </Variable>
<Variable name="URL"> g_szPublicFolderUrl </Variable>
<Variable name="URL"> g_szExWebDir </Variable>
<Variable name="URL"> g_szViewClassURL </Variable>
<Variable name="URL"> g_szVirtualRoot </Variable>
<Variable name="URL"> g_szBaseURL </Variable>
<Variable name="URL"> g_szURL </Variable>
<Function name="EXPRESSION" name="NavigateTo" paramPatterns="y"/>
</JSRules>
<XMLRules>
<Attribute name="xmlns"/>
<Attribute name="href" tag="a"/>
<TagText tag="baseroot" />
<TagText tag="prop2" />
<TagText tag="prop1" />
<TagText tag="img" />
<TagText tag="xsl:attribute"
attributePatterns="name=src" />
</XMLRules>
</RuleSet>

撰寫規則的步驟

撰寫規則的一般程序如下：

• 識別出含有需重新寫入內容之 HTML 網頁的目錄。

• 在這些目錄中，識別出需要重新寫入的網頁。

• 識別出各網頁上需重新寫入的 URL。識別出多數 URL 的簡易方法就是搜尋 "http" 與 "/"。

• 識別出 URL 的內容類型：HTML、JavaScript 或 XML。

• 在 Access Manager 管理主控台「Portal Server 配置」下的「Rewriter 服務」中編輯需要的規則集，以撰寫重新寫入各個 URL 所需的規則。

• 將所有規則合併到該網域的規則集中。

規則集指導方針

建立規則集時，請記住：

• 特定主機的優先順序是根據最長的 URI 符合。以下列的規則集為例

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

  使用的會是 sfbay_ruleset，因為它的符合內容最長。

• 規則集中的規則會依順序套用至網頁中的所有陳述式，直到有一個規則與特定陳述式相符。

  撰寫規則時，請牢記規則的順序。規則會以出現在規則集中的順序，套用至網頁中的陳述式。若您有特定規則，及包含 "*" 的一般規則，請先定義該特定規則，然後再定義一般規則。否則，在套用特定規則之前就會先套用一般規則至所有陳述式。

• 所有的規則都必須包含在 <RuleSet> </RuleSet> 標記內。

• 將所有需重新寫入 HTML 內容的規則納入規則集的 <HTMLRules> </HTMLRules> 區段。

• 將所有需重新寫入 JavaScript 內容的規則納入規則集的 <JSRules> </JSRules> 區段。

• 將所有需重新寫入 XML 內容的規則納入規則集的 <XMLRules> </XMLRules> 區段。

• 請在您的企業內部網路網頁中，識別出需重新寫入的 URL，然後將所需規則納入規則集的相應區段 (HTML、JSRules 或 XMLRules)。

• 將規則集指派至所需網域。

• 重新啟動閘道以使變更產生作用：

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

定義規則集根元素

規則集根元素具有兩種屬性：

• RuleSetName，例如，default_ruleset。會在 RuleSet 至 URI 的對映中參照此名稱。

• Extends。此屬性指的是規則集的繼承特性。值會指向您欲從中導出規則集的規則集。

  使用值 none 以表示此新的獨立規則集不依附於任何其他的規則集，或指定 RuleSetName 以表示您的規則集依附於其他規則集。

使用遞迴功能

Rewriter 使用遞迴功能在符合的字串式樣的結尾搜尋是否有相同的式樣。

例如，當 Rewriter 剖析下列字串時：

<a href="src=abc.jpg,src=bcd.jpg,src=xyz.jpg>

規則

<Attribute name="href" valuePatterns="*src=**"/>

僅會重寫第一個出現的式樣，其形式如下：

<a href="src=http://jane.sun.com/abc.jpg>

如果您使用遞迴選項

<Attribute name="href" valuePatterns="REC:*src=**"/>;

Rewriter 會搜尋相同的式樣，直至符合字串式樣的結尾，因此輸出將會是：

<a href="src=http://jane.sun.com/abc.jpg,src=http://jane.sun.com/bcd.jpg,src=http://jane.sun.com/xyz.jpg>