More about Binary File rules
|
|
Binary file rules are one form of static content — rules that do not depend on clipboard values. When you save this form or check in a binary file rule, Process Commander deletes any previous file on the Web server corresponding to the rule name and the RuleSet and version.
The first time a requestor asks for this file (for example, with <IMG SRC= > HTML reference), Process Commander extracts the file from the rule into an appropriate Web server directory. The directory name is based on a hash code derived from the requestor's RuleSet list. Later requests are served directly from the file system.
Standard binary file rules define the appearance of icons and navigation elements (such as ) on the harness forms for work objects in your application. You cannot modify the standard rules, but you can override them with your images of the same size if you choose. This approach doesn't requiring finding or overriding the HTML references to the images.
For example, you can override the Designer Studio home image (logo_metal.gif) with your company or application logo. Copy the standard rule and upload a replacement GIF that is 81 pixels wide and 46 pixels tall.
Use the Image Gallery gadget ( > User Interface > Galleries > Image Gallery) to review the images stored in binary file rules.
When you use the Save As toolbar operation to copy a text file rule that contains CSS styles into a different RuleSet, a warning appears if the CSS text references images (that is, binary file rules) that are not available to you. Note the names of these images and copy or create them into your application RuleSet. BUG-5353 Rejected
When you save a flow rule, the system automatically creates a related binary file rule containing the JPG image of the flow diagram. These rules support the initial display of static flow diagrams on the Diagram tab of the Flow form. To save storage space, the system does not retain history for these generated flow rules. The latest version of the diagram image is contained in the rule, overriding any older image.
When you upload a binary file into this rule, the system converts and stores it internally in a Base64 format. Oracle and Microsoft SQL Server can process this value in an endian-independent, character-set independent way. When extracted or downloaded, Process Commander reconverts the file to its original format. C-508Per CLINB, do not document prconfig.xml settings
R-9795 CLINB 9/22/03 When a requestor session first requests this binary object, Process Commander extracts the image file from the rule into an appropriate Web server directory on the server. It determines the destination directory from the second key part of the rule, the RuleSet and version, and the Use latest version checkbox. If an older copy of the file exists, the older copy is overwritten.
Later HTTP requests for the same binary object (and the same RuleSet and Version) are served from the directory copy, for fast response.
Browsers use a workstation cache of recently received files. By default, Process Commander marks static content such as images to remain in the cache for 24 hours. To make a newly updated or overridden binary file rule containing an image reach users, you can do any of the following:
defaultcachingtimeout
element in the
prconfig.xml
file to a value lower than the default of
86,400 seconds (24 hours). This affects the expiration date in HTTP
header sent to the browser. For example: SR-22809 PEPEN
2/4/09<env name="http/defaultcachingtimeout" value="6000" />
A lower value causes more HTTP traffic and so can adversely affect response time.
If authorized, you can use the System Management application to delete all extracted static files from the HTTP server directory structure (on a specified node), forcing them to be extracted again on demand. 04-01 C-542 C-575
The binaryfile JSP tag allows a binary file to be included in a stream sent to the browser through the static JSP tag. PROJ-292 GRP-6238