In this section: |
It is beneficial to apply consistent naming standards for the Presentation and Reporting and Metadata Layers. Easily identifiable patterns adopted organizationally makes it easier to organize and search for content. Naming standards are expected to differ between companies.
In this section: |
Apply naming standards across all WebFOCUS environments to reduce configuration and application changes when promoting code between WebFOCUS environments.
The names given to a Domain folder and an Application Directory should have consistent patterns that are meaningful and can be easily identified. Additionally, names given to Domain folders and Application Directories should be indicative of the relationship between them.
When there is a one-to-one mapping between Domain folders and Application Directories, you can use the same name for both, which makes the mapping clearer. For example, the Domain folder can be SALES and the Application Directory can be SALES.
Procedures, which are often used to generate reports, charts, and visualizations, may be located on the Presentation Layer under the Content node or on the WebFOCUS Reporting Server in the location specified by the approot configuration parameter. It is beneficial to apply naming conventions to each procedure so they can be easily traced back to application or procedure usage. For example, all procedures under SALES begin with SA_.
It is beneficial to apply naming standards to both a portal and portal pages. Some customers apply security authorization to portal pages, limiting access to specific groups. Applying names that can be related to a business purpose or department is useful.
ReportCaster schedules can be Managed Reporting based, WebFOCUS Server schedule based, or both. Naming standards can be applied to the name of the ReportCaster schedule so it is easily distinguishable as to which type of procedure the ReportCaster schedule is based.
Keep logical data connection names uniform across WebFOCUS environments to allow seamless code migration across WebFOCUS environments. The properties of the database connection for each WebFOCUS environment should point to environment specific data. Connection names are written to the Access File. When metadata is moved between WebFOCUS environments, the connection names need to match or the request will fail. For example, in DEV, if a connection name is called MyTest, the QA environment should also have a connection name of MyTest that is pointing to QA data.
Keep Reporting Server node names uniform across environments to allow seamless code migration across environments. The properties of the Reporting Server node can be assigned to Domain folders or resources. When resources are moved between WebFOCUS environments using Change Management, the Reporting Server node specified on Domain folders or resources must match Reporting Server nodes defined in the WebFOCUS Client communications configuration file, odin.cfg, in the target environment.
In this section: |
Creating code modules that are standardized is beneficial in that all developers can use the same code across applications. For instance, a FOCEXEC can be created to contain all the date variables that are used in the applications and used by all developers.
Developers should always begin in the GUI and stay in the GUI, unless it becomes absolutely necessary to continue coding manually. This may be the case if Dialogue Manager is needed for certain types of logic.
The HTML Canvas is intended for the business developer who needs to create a launch page for WebFOCUS reports and charts. It shields the business user from the complexities of HTML, CSS, XML, and JavaScript. HTML Canvas files are not meant to be manually edited and doing such will most likely render them unable to run and we cannot support them. Developers who are familiar with HTML and JavaScript coding who want to write their own code, are encouraged to make use of the WebFOCUS Web Services Enablement Option along with the HTML Authoring tool of their choice. In App Studio, there is a right-click menu option called Edit in Windows associated tool when an HTM file in the Configured Environments tree is selected. The user can use Windows Explorer to associate the HTM extension to an HTML Authoring tool of their choice and then this option will cause that HTML Authoring tool to open with the HTM file. See the WebFOCUS Web Services documentation for further information.
Reusing objects to keep applications and code standardized across the enterprise has several advantages and can be enforced at several levels:
Note: Working With WebFOCUS Metadata covers reuse of metadata attributes, including the use of temporary fields used with DEFINE and COMPUTE.
Information Builders |