syswf JSP tag library

Table 64. syswf:component Subelements Required Description Element optional When this parameter value is passed into a component, it will be accessible in the request scope in the component Java class and in the JSP page. param The value of the parameter should be specified in two ways: As a value attribute or as a content of the value tag. Example 19. Component Parameters syswf:component prefix=names name=nameList syswf:param name=color1 value=white syswf:param name=color2blacksyswf:param syswf:component syswf:page Creates an HTML page form with all required internal fields. This must be the root element of all components used as tasks. Table 65. syswf:page Attributes Required Description Attribute yes The filename of the JSP page containing the page header, this file is designed to create elements required for framework functionality. Note that there should be no graphic design. headerTemplate yes The filename of the JSP page containing the page footer, this file is designed to create elements required for framework functionality. Note that there should be no graphic design. footerTemplate syswf:wrap This tag helps you to separate page functionality from its design. It includes specified header and footer templates before and after the body element. Header and footer templates should be parametrized using syswf:param tags. Table 66. syswf:wrap Attributes Required Description Attribute no File name of JSP page containing the header. headerTemplate no File name of JSP page containing the footer. footerTemplate Table 67. syswf:wrap Subelements Required Description Element no When you pass the parameter value into a component, this parameter will be accessible in the request scope in the component Java class and JSP page. param Page 561 syswf:wrap syswf:control Creates a button or link, which should be used to trigger actions and transfers to other tasks. Table 68. syswf:control Attributes Required Description Attribute no Action to be passed to a controls parent component. action yes Allowed values are button , anchor , script , or image . The script generates the submit JavaScript command, which can be used, for example, as a value for the HTML onClick attribute. Image is a graphic button. mode no URI of task to be called. targetTask no Specifies level in navigation path to be used. targetDepth no Specifies the URL to be used to submit data; usable, for example, when you need to switch from http to https. targetUrl required in anchor and button mode control caption caption no Help text, displayed as tooltip. hint no If set to true , button is disabled and link cannot be clicked. disabled no If set to true , the task is only redirected to another task. This means that task data stored in a local session will also be accessible from the target task. Normal behavior is that a local session is not transferred between tasks. redirect required in image mode Path to the image file used as graphic button. src Table 69. syswf:control Subelements Required Description Element no Adds action parameters. param no Adds attributes to created input or an HTML tag. attribute syswf:input Inserts input field into JSP page. Page 562 syswf:input Table 70. syswf:input Attributes Required Description Attribute yes Specifies the name of the accessible value of this input field. name yes Specifies a value which appears in the input field, or a base object for the property attribute. value no Contains the property name of the object specified by the expression in the value attribute. property no Help text, displayed as a tooltip. hint no Data type which will be used to transform values between the underlying Java Bean object and the input field. dataType no If set to true , the input field will be disabled. disabled no A possible value is password, used for password fields. mode Table 71. syswf:input Subelements Required Description Element no Appends a name and value pair as attribute to the resulting HTML tag; usable, for example, for the CSS class specification for an input field. attribute syswf:selectOne Displays controls which enable the user to select one value from a list of available values. Page 563 syswf:selectOne Table 72. syswf:selectOne Attributes Required Description Attribute yes Specifies the name under which this value will be accessible; select one element. name no Specifies visual style; possible values are radio , check box , and menu . mode yes Specifies a value which will be selected, or a base object for the property attribute. value no Contains the property name of the object specified by expression in the value attribute. property yes Specifies a comma-delimited list of available values, the expression of which evaluates either to String[], or to an array of object for the optionValuesProperty attribute. optionValues no Contains property name of objects specified by expression in the optionValues attribute. optionValuesProperty no Specifies a comma-delimited list of available captions, the expression of which evaluates either to String[], or to an array of object for the optionCaptionsProperty attribute. optionCaptions no Contains property name of objects specified by expression in the optionCaptions attribute. optionCaptionsProperty no Help text, displayed as tooltip. hint no Data type which will be used to transform values between the underlying Java Bean object and the selected element. dataType Table 73. syswf:selectOne Subelements Required Description Element no Appends a namevalue pair as an attribute to resulting HTML tags. attribute syswf:selectMany Displays controls which enable the user to select multiple values from list of available values. Page 564 syswf:selectMany Table 74. syswf:selectMany Attributes Required Description Attribute yes Specifies the name under which the value of this selectMany element will be accessible. name no Specifies visual style possible values check , box and menu . mode yes Specifies an array of values which will be selected, or base objects, for the property attribute. value no Contains property name of objects specified by expression in the value attribute. property yes Specifies a comma-delimited list of available values the expression of which evaluates to String[], or to an array of object for the optionValuesProperty attribute. optionValues no Contains the property name of objects specified by expression in the optionValues attribute. optionValuesProperty no Specifies a comma-delimited list of available captions, the expression of which evaluates to either String[], or to an array of object for the optionCaptionsProperty attribute. optionCaptions no Contains a property name for objects specified by expression in the optionCaptions attribute. optionCaptionsProperty no Help text, displayed as tooltip. hint Table 75. syswf:selectMany Subelements Required Description Element no Appends a namevalue pair as an attribute to result HTML tags. attribute syswf:textArea Creates a text area HTML component. Table 76. syswf:textArea Attributes Required Description Attribute yes Specifies the name under which the value of this text area will be accessible. name yes Specifies a value which appears in the text area, or a base object for the property attribute. value no Contains a property name of an object specified by expression in the value attribute. property no Help text, displayed as tooltip. hint no Data type which will be used to transform values between underlying the Java Bean object and the text area. dataType optional If set to true , the text area will be disabled. disabled Page 565 syswf:textArea Table 77. syswf:textArea Subelements Required Description Element no Appends a namevalue pair as an attribute to the result HTML tag; usable, for example, for CSS class specification for the text area. attribute syswf:value Evaluates the given expression and transform result using data type. Table 78. syswf:value Attributes Required Description Attribute yes Specifies the expression which will be evaluated. value no Help text, displayed as tooltip. hint no Data type which will be used to transform value. dataType syswf:size This tag will fill the page attribute with size of given List, UDDIList, StringArrayList or Array. Table 79. syswf:size Attributes Required Description Attribute yes Name of variable to store the size of a given list or array. var yes Specifies an expression to be evaluated; the result must be List, UDDIList, StringArrayList or Array. value no Scope of the variable to store the size of a given list or array. Allowed values are request , session , application , or default . scope navigationPath This component renders the history path bread crumbs links navigationPath component in action Example 20. Component Parameters syswf:component name=navigationPath prefix=path

3.7.5. Typical Customization Tasks

• Q: Where can I find the code which generates the page header? A: It is defined in the file designpageHeader.jsp . • Q: How do I change the text displayed on a pages title bar? A: Modify content of title tag in the file pageHeader.jsp . • Q: Where is the right place to include my own JavaScript files? A: Reference to your files should be placed in pageHeader.jsp . Place your script files in the REGISTRY_HOMEappuddiweb.jarwebrootscript directory. Page 566

3.7.5. Typical Customization Tasks

• Q: Where is it possible to change the text displayed in the page footer? A: The page footer is defined in the file designpageFooter.jsp.

3.8. Business Service Control Framework

This section describes the Business Service Control BSC from the developers point of view. It describes the Business Service Control Framework architecture and configuration, and demonstrates how to customize the console. The Business Service Control implementation and configuration are contained in the JAR file bsc.jar located in directory REGISTRY_HOMEappuddi . This section has the following subsections: Section 3.8.1, Business Service Control Localization How to localize the Business Service Control, or the Registry Control. Section 3.8.2, Directory Structure The directory structure of bsc.jar. Section 3.8.3, Business Service Control Configuration Business Service Control configuration files in bsc.jar. Section 3.8.5, Permission support Features to establish whether users have permission to perform operations. Section 3.8.6, Components and Tags Components and tags in bsc.jar used to develop Business Service Control components.

3.8.1. Business Service Control Localization

Oracle Service Registry is ready for localization. This chapter is focused on localization of web applications such as the Business Service Control and Registry Control. It provides information on Oracle Service Registry localization support and how to write localizable web applications. Basic concepts The localization support is built upon standard Java resource bundles and the JSP formatting tag library. Locale detection The user language-detection routine is invoked for each HTTP request. When the user is logged in, the userAccounts languageCode is used, if it is set. Otherwise the browsers preferred language is used. The system then finds the resource bundle for the chosen locale or uses a default resource bundle, if there is no such localized resource bundle. See the ResourceBundle javadocs for details of the algorithm. The system uses UTF-8 encoding by default, but it can be configured to use a custom locale-encoding mapping in the file web.xml : webFramework encoding map locale=en encoding=UTF-8 map locale=zh encoding=Big5 encoding webFramework Resource bundles There is one resource bundle common to all JSP files serving as a dictionary - com.systinet.uddi.bui.standard.BUIMessages . It contains keys for common words like OK, Cancel or names of entities Provider, Service. Then each top-level directory in the jsp directory has a unique resource bundle for its files Page 567 Resource bundles