Brazos Attach File Control May Fail without Additional Configuration when Used in BPM 8.5.7 Processes
Problem
With IBM BPM 8.5.7, you may notice that Attach File controls using the 'Associate with Process Instance' option generate generic error messages. After attempting to upload a file, the control presents an "Internal Server Error" validation popup and the following message is recorded in the...
View Topic
Brazos UI 4.x Upgrade Guide
Note: This guide is applicable to both v3.x to v4.x and v3.x to v5.x toolkit upgrades. No special changes are required to upgrade applications using v4.x to use v5.x of the toolkit.
The 4.x version of the Brazos UI Toolkit was released on 2015-07-19. The 4.0 version change mostly focused on upgra...
View Topic
Brazos UI Attach File Control
The Brazos UI Attach File Control provides IBM BPM with the most stylish, flexible and powerful file attachment widget ever! This fully featured control works with both the internal BPM document repository as well as external ECM repositories. Features include drag and drop to upload files, integ...
View Topic
Brazos UI End User License Agreement
Brazos UI Developer Edition EULA
The Brazos UI Developer Edition v5.0 introduces a new EULA that includes several changes. We recommend that you review the EULA prior to downloading the Brazos UI Developer Edition. Use of any Brazos tool signifies acceptance of the related EULA.
Brazos UI Enterpr...
View Topic
Brazos UI for IBM BPM External UI - Changing the log level
Overview
This article is specific to Brazos UI for IBM BPM External User Interfaces. Brazos UI utilizes Log4j2 as its logging framework. This article explains how to customize the logging configuration.
Changing the default logging
The log levels and appenders may be overridden by providing a cus...
View Topic
Brazos UI Modal - Boundary Events and Validation
Overview
This article is to help explain how use boundary events and validation with the Brazos UI Modal coach view.
Boundary Events
The Brazos UI Modal control has 4 configuration options that allow you to fire boundary events. These can be found in the "Boundary Event" configuration options for...
View Topic
Brazos UI Style Guide
Starting in the middle of the Texas summer, we trained a group of new hires on BPM and Brazos. The link below will take you to 11 tips that proved invaluable in adding some finishing touches to their sample applications.
11 tips to make your BPM screens shine: https://assets.bp-3cloud.com/posts/1...
View Topic
Click to Full Select Output Text or Table Cell Value
In some scenarios of "Swivel Chair" the users would need to select values presented on Coachs and copy/paste them to other systems. In these cases the values can be masked and with complex formats and this turns the value section harder to do.
To facilitate these cases a custom Coach View can be ...
View Topic
Configuring URL for Brazos UI Attach File control in IBM BPM 8.5.x
Introduction
It's a common scenario to use Load Balancer (LB) URL or any other front-end URL in IBM BPM instead of BPM server hostname URL to access Process Portal and other IBM BPM applications.
Brazos UI also depends on IBM BPM URLs for downloading files uploaded with the Attach File control....
View Topic
Cross-Site Scripting Protections: Permitted Elements and Attributes
Background
Brazos UI controls have been hardened against Cross-Site Scripting (XSS) vulnerabilities. One of the main methods for achieving these protections is through blanket sanitization of various controls to remove potentially exploitable HTML tags, attributes, and code. The security assumpti...
View Topic
Customizing Brazos UI Style and Logo
Overview
You can easily customize the style of the BP3 Brazos UI Toolkit using CSS. To make this even easier for you we have included a CSS generator in the BP3 Brazos UI Examples Process App that allows you to graphically define colors for some basic UI elements, and generate a CSS starter file...
View Topic
Customizing Controls in Brazos UI the Right Way
Overview
Though we believe that Brazos UI is robust enough to meet the overwhelming majority of use cases, you may find yourself in a situation where the available controls in Brazos UI don't seem to fit your needs. There are a number of escalating steps to take when you run into this situation t...
View Topic
Customizing the Look of Brazos UI Controls
Overview
Customizing the Brazos UI can be easily done on a global scale to give your processes a unique or branded look and cross-task consistency (See the Technote “Customizing Brazos UI Style and Logo”). However, sometimes you are are going to want to style specific controls in a non-global man...
View Topic
Data Table Deletes 2 Rows Instead of One
Problem
A Data Table with delete button in one of the columns deletes the correct row and the row next to it.
Symptom
Usually, this behaviour doesn't present any client-side or server-side errors.
Cause
When rows are added on client-side and also server-side in parallel, this can cause synch...
View Topic
Deprecated Brazos UI Controls
Overview
Our goal with the Brazos UI is to never break backwards compatibility or break existing coaches that are using an existing Brazos control. As part of this philosophy, when there are advances that prevent us from easily upgrading an existing control, there will be instances where we need ...
View Topic
Disable Tabindex on Brazos UI Controls
Some user groups prefer to utilize keyboard navigation for moving across the screen. By default, pressing "Tab" will cycle through fields on the screen.
In certain use cases, not all fields are useful for tabbing through, so skipping them in the flow of the page would be helpful for speeding up n...
View Topic
How do I use the Brazos UI Toolkit?
The Brazos UI Toolkit is shipped with the Brazos UI Examples Process App. The Brazos UI Examples Process App contains the toolkit documentation and examples of the Brazos controls and features. The Examples Process App is built using BPM and Brazos, so you can use it as both a reference for the c...
View Topic
How to Customize the Brazos Template -- The Right Way
Introduction
Nearly anyone using Brazos UI will want to build a custom template. This gives you several advantages including:
Change the header and footer to match your color scheme
Add your corporate logo
Add CSS overrides in one central place
You'll need the Brazos Template to use Brazos...
View Topic
IBM BPM Coaches Exposed As Administrative Services Don't Render Properly In Internet Explorer
Issue Description
You have services (client side human services or heritage human services) exposed as administrative services in IBM BPM Process Admin console. When you try to launch such a service from Process Admin (PA) console some of the controls or the whole service is not rendered properly...
View Topic
IBM BPM WebPD limitations in WYSIWYG preview when customizing UI controls
Description
IBM BPM Web Process Designer (WebPD) incorporates preview files to improve the WYSIWYG view of the Coach layout. However, placing a Coach View in a wrapper complicates the ability of the preview to work correctly.
If you have followed along the steps of creating your own custom templa...
View Topic
Known Issue with Brazos UI Horizontal Bar Chart (Chrome only)
Problem
The Brazos UI team was recently made aware of an issue with the Horizontal Bar chart. This issue is specific to a particular page layout, so we were unable to find a universal solution. This article will describe the issue and the two suggested work-arounds.
This issue occurs when a hor...
View Topic
Lighter, Faster: Using Table Controls in Non-Editable Mode
Overview
The Brazos UI Table control has a configuration option to display as non-editable. Using Read Only mode comes with a performance boost but there are a few quirks to keep an eye out for.
Background
The Developer and Enterprise Editions of Brazos UI have identical Table controls. The Table...
View Topic
Modal Closes and Blocks the Screen
Problem
User clicks on the Modal launch button, the modal opens and then closes leaving the gray layer blocking the screen. After that, the gray overlay will block any further interactions with the coach.
Symptom
Usually, this behavior doesn't present any client-side or server-side errors.
Cause
...
View Topic
Online Documentation for Brazos UI
As a convenience for our users, we extract the in-line documentation for each of the Coach Views, Business Objects, and Services used in the Brazos UI toolkit. This documentation matches the latest version available for all of these artifacts in the Process Designer, but without the inconvenience...
View Topic
Output Text: Reworking XSS-Sanitized HTML Bindings
Problem
Due to security concerns, Brazos UI controls displaying HTML are currently not permitted to include elements, attributes, or content that result in executable JavaScript. Cross-Site Scripting (XSS) protections will remove elements and attributes that are not on a white-list from the bound...
View Topic
Performing Client-Side Calculations to Improve Performance
Problem
A common implementation is to have a field that automatically calculates and displays a total based on the values of other fields in a table or coach. Generally a boundary event is triggered every time one of these fields is updated and a server script is used to recalculate the new tota...
View Topic
Resolving an Attach File Control "Forbidden" Server Error
Problem
The BP3 Brazos UI Examples Application includes demonstrations of the attach file control. These examples connect to either the internal BPM repository or the BP3 Alfresco ECM server. When attempting to upload files to the BP3 Alfresco document repository you may encounter the following ...
View Topic
Resource Bundle Group with name BrazosResources is not attached
Overview
With Brazos UI v3.14 or later, when running a coach from a Process Center environment you might receive the error "Resource Bundle Group with name BrazosResources is not attached." This is due to an IBM BPM product bug. This bug was exposed in Brazos UI v3.14 and later due to the Intern...
View Topic
Restyling a Single-Option Checkbox
For certain uses a single Check Box is ideal but does not fit stylistically. Using both the label and the selection list option when there is only a single choice may be redundant when the checkbox itself is understood from context by users. Hiding the label or selection list simplifies this but ...
View Topic
Styling Coaches for Printing
While maintaining a paperless process is one of the benefits of BPM, it may be necessary to capture certain steps in paper form. Brazos UI has built-in styles that are applied when printing but further CSS can be included with your coach to highly customize the layout and appearance of a printed ...
View Topic