8206.01 Release Notes


The following topic provides all the information that you need to know about this release of WebFOCUS.

Have questions? Click Send Us Feedback (on the right) and we'll be in touch!

Release and Gen Information

Release Date Gen Information Reporting Server
Monday, July 8, 2019 wf062819a Gen 38 8206 Gen 1738
as062819a 

 

New Features

New autoGlobal Property to Synchronize Maximum and Minimum Values on Dual-Y and Split-Y Charts

You can synchronize the minimum and maximum values on dual-y and split-y charts using the "autoGlobal" property for the axis minimum and maximum values. If both the minimum and maximum values are synchronized for multiple y-axes, their scales will also be synchronized.

Synchronize the Axis Maximum and Minimum Values on Dual-Y and Split-Y Charts

"yaxis": 
{
    "min": "autoGlobal",
    "max": "autoGlobal"
},
"y2axis": 
{
    "min": "autoGlobal",
    "max": "autoGlobal"
}

or

"axisList":
{
"y1":
{
"min": "autoGlobal",
"max": "autoGlobal"
},
"y2":
{
"min": "autoGlobal",
"max": "autoGlobal"
},
...
}

Example: Synchronizing Scales on a Dual-Y Chart

The following request generates a line chart with dual-y axes, without synchronizing their minimum and maximum values.

 GRAPH FILE WF_RETAIL_LITE
SUM COGS_US DISCOUNT_US
BY PRODUCT_CATEGORY
ON GRAPH PCHOLD FORMAT JSCHART
ON GRAPH SET LOOKGRAPH LINE
ON GRAPH SET STYLE *
type=data, column=n1, bucket=x-axis,$
type=data, column=n2, bucket=y-axis,$
type=data, column=n3, bucket=y-axis(2),$
ENDSTYLE
END

The output is shown in the following image.

Chart output

The following version of the request synchronizes the maximum values for both y-axes. Since the minimum values are equal without the autoGlobal property, it is not necessary to implement that property for this chart.

GRAPH FILE WF_RETAIL_LITE
SUM COGS_US DISCOUNT_US
BY PRODUCT_CATEGORY
ON GRAPH PCHOLD FORMAT JSCHART
ON GRAPH SET LOOKGRAPH LINE
ON GRAPH SET STYLE *
type=data, column=n1, bucket=x-axis,$
type=data, column=n2, bucket=y-axis,$
type=data, column=n3, bucket=y-axis(2),$
*GRAPH_JS
"axisList": 
{
 "y1": {
    "max": "autoGlobal"
    },
 "y2": {
     "max": "autoGlobal"
     }
}
*END
ENDSTYLE
END

The output is shown in the following image.

Chart output

For more information, see the Creating HTML5 Charts With WebFOCUS Language manual. 

New SET Commands to Automatically Fit Multiple Charts in a Container

SET AUTOFIT command controls whether HTML5 chart output resizes to fit into the container in which it is placed. Two new SET commands implement AUTOFIT for a request that generates multiple charts. In order for these commands to take effect, AUTOFIT must also be enabled:

  • SET AUTOFIT-MULTI specifies whether to automatically fit multiple charts in the container.
  • SET AUTOFIT-MIN-PCT defines a minimum height for each chart.

Syntax: How to Automatically Fit Multiple Charts in a Container

ON GRAPH SET AUTOFIT-MULTI {ON|OFF}
ON GRAPH SET AUTOFIT-MIN-PCT pct

where:

ON

     Enables automatic fitting of multiple charts in their container. AUTOFIT must also be set to ON or RESIZE.

OFF

     Disables automatic fitting of multiple charts.

pct

     Is the minimum height of each chart, as a percentage of the VAXIS value. The default AUTOFIT-MIN-PCT value is 100. If the charts do not all fit 
     vertically in the container with that minimum height, the window will be generated with a scroll bar.

Example: Automatically Fitting Multiple Charts in Their Container

The following request generates a chart for each value of the BUSINESS_REGION field. AUTOFIT is set ON, AUTOFIT-MULTI is set ON, and AUTOFIT-MIN-PCT is set to 50% of the VAXIS value.

GRAPH FILE WF_RETAIL_LITE
HEADING CENTER
"Region: <BUSINESS_REGION"
SUM COGS_US REVENUE_US
BY BUSINESS_REGION NOPRINT
BY PRODUCT_CATEGORY
ON GRAPH PCHOLD FORMAT JSCHART
ON GRAPH SET LOOKGRAPH LINE
ON GRAPH SET EMBEDHEADING ON
ON GRAPH SET VAXIS 200
ON GRAPH SET AUTOFIT ON
ON GRAPH SET AUTOFIT-MULTI ON
ON GRAPH SET AUTOFIT-MIN-PCT 50
ON GRAPH SET STYLE *
type=heading, size=16, style=bold, $
TYPE=DATA, COLUMN=N1, BUCKET=page, $
TYPE=DATA, COLUMN=N2, BUCKET=x-axis, $
TYPE=DATA, COLUMN=N3, BUCKET=y-axis, $
TYPE=DATA, COLUMN=N4, BUCKET=y-axis, $
END

The output is shown in the following image. All four charts fit in the window, and no scrollbar is generated.

Output of chart

For more information, see the Creating HTML5 Charts With WebFOCUS Language manual. 

Enhanced FTP Server Configuration Management

ReportCaster administrators who wish to take advantage of the speed and efficiency of the FTP protocol for scheduled report distributions can now create and manage predefined FTP Server connection configurations from the Configuration tab in the ReportCaster console, as shown in the following image.

Admin Console

Predefined FTP Setting configurations can be made available to FTP distribution schedules as shown in the following image.

FTP Distribution Options Dialog Box

This new feature is an enhancement of the existing capability to create FTP setting configurations within individual schedules. However, administrators can deactivate this capability and limit all schedules to predefined FTP settings by selecting the Don’t allow user defined FTP in schedule check box in the (Default Settings) configuration

This ability to limit users to predefined FTP Setting configurations enables administrators to manage all FTP Setting configurations from a central location, and ensures that users always select a valid FTP Server connection when creating FTP or File system distribution schedules.

To learn more, see Using the FTP Distribution Option.

Fixes

  • When using a dual-axis graph, linear trendlines used for measures on the Y2-axis are displayed using the scale of the Y1-axis. (190304015)
  • Added validation for variable name of IBIF_focexec for valid focexec names. (190212043)

Upgrade Notes

  • In App Studio, the Action, Method, Enctype, and Accept properties have been removed from the Form component in the Properties panel because these properties were not actually being used.
  • In App Studio, an output widget container no longer contains the Autosize options in the Properties panel. Everything inside the widget is now fully CSS3 responsive at run time. Autosize is handled by JavaScript and responsive is handled by CSS3 styles.
  • When upgrading from previous versions of ReportCaster, FTP setting configuration information remains available in existing distribution schedules as long as the default value (Customized FTP) is assigned to the FTP Server Name field.
    • If you replace this value with a predefined FTP setting configuration in an individual schedule, the previous FTP Setting configuration information for that schedule is overwritten automatically.
    • If you limit FTP Setting configurations to a predefined list by selecting the Don’t allow user defined FTP in schedule check box in the (Default Settings) configuration, the previously FTP Setting configuration information for all schedules becomes unavailable, and is replaced by the default FTP Setting configuration or a predefined FTP Setting configuration selected for an individual schedule.
  • After an upgrade to Release 8206, only those users working in roles that include the new Create Shortcuts (opShortcut) privilege, located in the Basic Reporting privilege category, can continue to create shortcuts. Even though this privilege is included in the DomainBasicUser, DomainAdvancedUser, DomainDeveloper, DomainAnalyst, and WebFOCUSManager roles, it is not selected by default. Administrators must either select the Create Shortcuts privilege check box directly, or use the Role Update utility, located on the Configuration tab of the Administration Console, to include this privilege in each of the roles that can continue to use this feature.
  • The Display Esri Configuration Utility (opEsriAdminConsole) privilege, which granted access to the Esri Configuration Utility, was removed from the Application Development privilege category located on the Roles tab of the Security Center. The new ArcGIS API for JavaScript replaces the Esri Configuration Utility and is available to all users. Existing maps created using the ESRI Configuration Utility continue to work with the new ArcGIS API for JavaScript. However, you cannot upgrade them without first recreating them with the new ESRI HTML5 component-based Point Map or Choropleth Map options available from the WebFOCUS Designer or InfoAssist Chart Picker.
  • The following changes appear on the InfoAssist Properties page of the Administration Console Configuration tab. These changes were called for by In-Document Analytics rebranding, and they match changes to the labels of the corresponding format options in the Output File Format list that opens from the Format Group in the InfoAssist Home Page ribbon.
    • In the Format Tab section, the Active PDF option was renamed PDF Analytic Document Format and the Active Report option was renamed HTML Analytic Document Format.
    • In the Report Output Format, Chart Output Format, and Document Output Format lists located in the Tools Options Dialog Defaults section, the Active Report option was renamed HTML Analytic Document and the Active PDF option was renamed PDF Analytic Document.
  • The functions previously categorized as Statistical Python functions have been reclassified as Machine Learning (Python-based) functions. The names of the functions have changed as follows:
    • BLR_CLASSIFY is now named CLASSIFY_BLR.
    • KNN_CLASSIFY is now named CLASSIFY_KNN.
    • KNN_REGRESS is now named REGRESS_KNN.
    • RF_CLASSIFY is now named CLASSIFY_RF.
    • RF_REGRESS is now named REGRESS_RF.
    • POLY_REGRESS is now named REGRESS_POLY.
  • The enhanced In-Document Analytics user interface available is configured by default for new installations and is not supported with the Microsoft Internet Explorer 11 browser. If you have requirements to support Microsoft Internet Explorer 11 browser, you can configure the Legacy In-Document Analytics user interface using the WebFOCUS Administration Console.

    Customers upgrading to 8206 from 8205 or earlier releases will have the Legacy In-Document Analytics user interface configured.

    The new In-Document Analytics setting appears in the Tools Option Dialog Defaults section of the InfoAssist Properties page, which is located on the Configuration tab of the Administration Console. This setting establishes the default value for the In-Document Analytics setting in the Procedure Settings dialog box which opens from the InfoAssist Quick Access toolbar. The value in this setting determines the interface used to display reports, charts, and documents using the HTML Analytic Document format. There are two valid values:
    • Designer Style. Content displayed conforms to the conventions of WebFOCUS Designer and includes the Navigation icons, such as the Chart Format menu and the ellipsis menu.
    • Legacy. Content displayed conforms to the legacy run-time interface and provides options like the legacy column menu.

      Content created in earlier versions is automatically assigned to the Legacy display, which conforms to the conventions of the Active Technologies format, and provides options like the Chart/Rollup and Pivot tools.

      New content is automatically assigned to the WebFOCUS Designer option, which is selected by default.

      To convert content created in earlier versions to the WebFOCUS Designer display, developers must open that content for editing, reset the value in the In-Document Analytics setting to Web FOCUS Designer, and save the revised procedure. As an alternative, developers can use the text editor to add the following commands directly to a procedure.

      -DEFAULTH &WF_ARVERSION=2; SET ARVERSION=&WF_ARVERSION;

Known Issues

  • Bursting reports by parameter values is not supported with interactive content using the new Designer style of In-Document Analytics capabilities.
  • When creating interactive Dashboards, you can only use Fullscreen mode to modify chart or report (grid) components. Other Dashboard components, such as images and text, do not display.
  • If you are working with an In-Document Analytics chart in landscape mode on an Android mobile device and you switch to portrait mode, your content displays in fullscreen mode. Your chart displays at the bottom. If you run your content in new window mode, your In-Document Analytics chart does not display in fullscreen mode, displaying the chart on the right.
  • When working in Document mode with In-Document Analytics, an error occurs if you attempt to run a document or dashboard using Internet Explorer 11.
  • When creating bar charts using the New option on the Ellipsis menu, the Color bucket incorrectly performs a count for a dimension field. It also shows a heat legend. The expected result is a color legend for each unique item.
  • If you add an existing ARVERSION=1 report to an AHTML document set to ARVERSION=2, it fails at run time, displaying JSON text on the screen instead of the expected report output.
  • Running the configuration migration from the CMD line or UNIX Shell displays an error message in the log file. This error does not impact migration of the configuration files.
  • After running WFReposUtilCMDLine.bat or WFReposUtilCMDLine.sh, the RPT_DATA, RPT_METADATA, and RPT_USAGE tables are not getting dropped and are still available in the repository.
  • If you attempt to run an ARVERSION=2 (In-Document Analytics) AHTML Fusion chart procedure (.fex), it continuously loads and produces an F12 error. This does not occur with Fusion charts that employ ARVERSION=1.
  • If you are working with a procedure (.fex) and you change the ARVERSION to ARVERSION=2, global filters do not display when you run the procedure. 
  • When you use the WebFOCUS Online Help in Japanese, if you type a search term in the Search box that contains NLS characters and press Enter, the words next to the Search box are corrupted. The workaround is to click the Go button next to the Search box, instead of pressing Enter. 
  • Changing the chart type at run-time is not supported for an AHTML chart that has ARVERSION=1 and which does not use the new chart properties (bucket syntax). As a workaround, convert the chart to use the new chart attributes (recommended), or set ARVERSION to 1.
  • When creating reports in WebFOCUS Designer using the Technical Preview feature, the default font may not display all NLS characters correctly. To ensure that these characters display properly in reports, change the values of the FONT attributes, in the report section of the embedded StyleSheet you are using, to a font that supports the required NLS characters. For example: 
    TYPE=REPORT, FONT='Arial Unicode MS',$
  • Kerberos Authentication cannot be completed successfully in installations of WebFOCUS that use Java version 1.8.0_212, which is currently delivered in the WebFOCUS installation. In order to address this issue, replace version 1.8.0_212 with the latest available version of Java, currently 1.8.0_232. Upcoming WebFOCUS installations will include the most recent working version of Java.
  • Field Titles are not displayed properly on HTML charts in installations of WebFOCUS that are configured for the Japanese language and use Java version 1.8.0_212, which is currently delivered in the WebFOCUS installation. In order to address this issue, replace version 1.8.0_212 with the latest available version of Java, currently 1.8.0_232. Upcoming WebFOCUS installations will include the most recent working version of Java.
  • The Export Scenario dialog box does not display Master File Shortcuts in the list of available items under the Resources node. Even though they are not visible, Master File Shortcuts are present in the list and can be included in Export Scenarios. In order to add a Master File Shortcut to a scenario you must right-click the folder that contains it and choose the Select with Sub-tree menu option. The Master File Shortcut will be transferred to the Scenario, along with the rest of the items in the folder.
  • Both the db_collation.sh file and the db_collation.bat file generate the "Main WARN Error while converting string [ ] to type," error message in the Command Prompt window at the end of their run. This message has no impact on the functionality of this post-installation utility, and it completes the run successfully.
  • The load_repos.sh file generates the "WARNING: sun.reflect.Reflection.getCaller Class is not supported. This will impact performance," error message in the Command Prompt window at the end of its run. In addition, the  b_inplace_update.sh, WFReposUtilCMDLine.sh, and update_repos.sh files generate the "Main WARN Error while converting string [ ] to type," error message in the Command Prompt window at the end of their run. These messages have no impact on the functionality of these post installation utilities, and each one completes its run successfully.

System Requirements 

This release is now certified and has been tested with Google Chrome version 75 and Firefox version 67.