Cisco Cisco Collaboration Server Dynamic Content Adapter

Page of 223
DCA 2.01 Administration and Configuration Guide 
About Customizing the DCA Parser   97 
About Customizing the DCA Parser 
The DCA parser's out-of-box configuration has been designed and tested to deliver 
trouble-free performance on a wide range of Web content. For many users, 
therefore, there may be no need to modify the parser's default functionality. 
Furthermore, many content-related collaboration issues can be addressed more 
expediently using other DCA configuration options. 
However, as desired you can customize the DCA parser in any manner you choose. 
The parser allows full customization, even to the extent replacing all default parsing 
functionality with your own. Parser customization allows to you to add to the DCA 
parsing process literally any behavior that can be attained through JavaScript. 
Reasons for Customizing the Parser 
Common reasons to customize the parser include: 
•  Troubleshooting parsing errors: The most obvious reason to modify the 
parser is to correct parsing errors. Examples of parsing errors include: 
Improperly parsed links: Some Web pages may contain hard-to-find links that do 
not parse correctly using the parser's out-of-the-box configuration. Parsing errors 
of this type often manifest themselves as JavaScript errors. JavaScript errors that 
occur only when a page is accessed through the DCA almost always indicate a 
parsing problem. 
Frameproofed Pages: Because the Collaboration Toolbar uses a frameset, DCA 
users cannot collaborate on frameproofed pages. The DCA's out-of-box 
configuration addresses this by parsing out many common frameproofing 
techniques. Frameproofing methods not handled by the parser's default 
configuration and which cause a page to "break out" of the Collaboration Toolbar 
frameset may require parser modification  
•  Adding functionality or content to pages: You can use parser configuration to 
insert code or content into pages served through the DCA. 
•  Customizing pages for different users: You can configure the parser to 
reformat pages differently for different users, including agents and callers. 
Background Knowledge 
Customizing the DCA parser can be a complex process with a distinct learning curve. 
In particular, creating  expressions that match exactly the pieces of document text