Learning Library

← Back to Library

Creating a Grid-Based UI in IBM BPM

Key Points

  • The demo shows how to create a client‑side Human Service called “Travel Request” in IBM BPM 8570 and add a Travel Request business object variable.
  • A new “Start with Grid” option lets you quickly generate a header‑footer grid layout for the coach, which can then be edited using grid‑editing mode.
  • Grid editing involves adding cells via the plus icon, resizing them to fit a 12‑column layout, and splitting areas to achieve the desired arrangement of fields.
  • After finalizing the grid, fields from the variable palette are dragged into the cells, including destination details and a map view that displays the postal code area.
  • The bottom cell of the grid is used to place an OK button, completing the user interface for submitting travel requests.

Full Transcript

# Creating a Grid-Based UI in IBM BPM **Source:** [https://www.youtube.com/watch?v=KkSyPserNy8](https://www.youtube.com/watch?v=KkSyPserNy8) **Duration:** 00:10:37 ## Summary - The demo shows how to create a client‑side Human Service called “Travel Request” in IBM BPM 8570 and add a Travel Request business object variable. - A new “Start with Grid” option lets you quickly generate a header‑footer grid layout for the coach, which can then be edited using grid‑editing mode. - Grid editing involves adding cells via the plus icon, resizing them to fit a 12‑column layout, and splitting areas to achieve the desired arrangement of fields. - After finalizing the grid, fields from the variable palette are dragged into the cells, including destination details and a map view that displays the postal code area. - The bottom cell of the grid is used to place an OK button, completing the user interface for submitting travel requests. ## Sections - [00:00:00](https://www.youtube.com/watch?v=KkSyPserNy8&t=0s) **IBM BPM Grid Layout Demonstration** - The speaker walks through creating a client‑side Human Service for a travel request in IBM BPM 8.5.7, adds a travel request variable, renames the coach, and uses the new “Start with Grid” feature to select and edit a header‑footer grid layout. ## Full Transcript
0:00[Music] 0:12welcome to the IBM BPM 8570 0:16demonstration on grid support in this 0:18demonstration I will create a simple 0:20user interface for requesting travel 0:23within an organization to start with I'm 0:25going to create a client side Human 0:27Service called travel request 0:30to start we're going to add a variable 0:32to capture the information about the 0:37request our variable name will be called 0:39travel 0:41request and the type of that variable 0:43will be the travel request business 0:45object that I created 0:47earlier going to go back to the diagram 0:50tab now and we're going to rename the 0:51default 0:53coach to gather 0:56info Next Step we're going to go to the 0:59coaches tab 1:00we're going to click on gather 1:02info and here you'll see the first 1:04difference compared to previous versions 1:06of 1:07BPM we have a new Option here called 1:09start with 1:10grid this allows you to quickly get 1:12started with a grid on your new coach I 1:15have an idea of what my layout should 1:17look like so I'm going to choose the 1:18header footer starting point for my grid 1:20and click okay once the layout loads you 1:23can see we have three cells within our 1:25layout which can be populated with 1:27content from the pallet although this 1:30grid is a good starting point I want a 1:32different grid for my layout in order to 1:35change the grid I'm going to go into 1:36grid editing mode using these radio 1:38buttons in the top right corner here 1:40content mode allows you to add layout 1:42items to the canvas grid is the mode 1:44used to edit the grid I'm going to click 1:46the grid R button and we can see that 1:49the editor is changed to allow me to 1:51edit the grid I want first name last 1:54name and employee number across the top 1:56so I want to create two more cells to do 1:58this I can just hover over any cell or 2:01container within the grid and click the 2:04plus icon this easily allows me to add a 2:07new cell I will add another 2:11one next I want to resize my cells so 2:14that they're evenly spaced across the 2:15top in order to do this I all I have to 2:17do is hover over the right edge of a 2:20cell as I drag you can see there's a 12 2:24column overlay the available width of 2:26the coach is divided evenly into 12 2:28column all cells are aligned to these 12 2:30columns I'm going to complete the resize 2:32of the 2:33cell and then I'm going to resize the 2:35next cell to be also four columns 2:39wide next I want to split the middle 2:42area into half I will do that using the 2:45same technique clicking the plus icon to 2:47create that new cell I'm going to leave 2:50the bottom cell as is that's going to 2:52hold the buttons within our 2:54coach our grid is now complete and I'm 2:56going to switch to the content view to 2:58populate it 3:01I'm expanding the variables within my 3:04pallet and I'm going to drag and drop 3:06some of the fields into the 3:11grid as I'm dragging you can see that 3:14all cells are highlighted even ones that 3:16have content 3:22already next I'm going to add some of 3:24the fields dealing with the destination 3:27for the request 3:34I'm going to add a map view to the right 3:37of those fields the map is going to show 3:40the postal code area on a 3:42map finally I'm going to drag my okay 3:45button into this bottom 3:47cell and create a companion cancel 3:54button I now have my coach authored with 3:57a grid the last thing to do is to set 4:00the binding on the 4:01map and then 4:07run I will run the client side Human 4:10Service to inspect the coach layout at 4:11runtime if I adjust the width of the 4:13browser we can see the columns within 4:15the grid dynamically 4:18adjust if I make the browser width very 4:21small we can see the layout does not 4:23look very good our next step is going to 4:26be to make the grid responsive to 4:27smaller device sizes to to make our 4:30layout responsive we're going to go back 4:31to the editor and make changes to the 4:33top middle and bottom sections of our 4:35layout to start with we're going to deal 4:38with the top I'm going to go into the 4:40grid editing mode and go to the medium 4:43device size what we want is to have a 4:45little bit more room for each of these 4:47fields in order to do this I'm going to 4:49resize the cells on the medium device 4:56size the horizontal span of the cells 4:59are device 5:02dependent finally switching to the small 5:04device I'm going to set the width of 5:06these cells to to span the entire width 5:08of the 5:17device next we're going to make the 5:19middle section 5:20responsive to start with we're actually 5:22going to change some positioning and 5:24configuration options on the views 5:28themselves on the map Coach View which 5:30is a custom Coach View that I authored I 5:32have a responsive configuration option 5:34for the default map type we're going to 5:36set that to satellite on 5:39large we're also going to set the height 5:41to be 400 pixels because we do have 5:44quite a bit of real estate on a large 5:47device next on the medium size we're 5:50going to change the height to 300 5:54pixels and we're going to configure the 5:56Coach View to be rad by default 6:01lastly we're going to change the 6:02rendering of the is customer travel 6:04field to be a switch on medium and 6:07smaller devices finally on this small 6:10device size we realize we don't have a 6:12lot of real estate at all so what we're 6:14going to do is hide the map completely 6:16on this device to do that we're going to 6:18click on the grid editing mode select 6:21the cell that contains the 6:24map and set it to be hidden on small 6:28devices we can then take the remaining 6:31cell and resize it so it spans the 6:33entire 6:34width we've Now hidden the map on small 6:37devices and given the destination Fields 6:40enough real 6:41estate finally we're going to adjust the 6:44bottom section which contains the 6:47buttons first what we're going to do is 6:49change the layout of the cell cells can 6:53lay out their content both vertically 6:54and horizontally because these are 6:56buttons we're going to lay them out 6:58horizontally 6:59on a large device we want them right 7:01aligned to match the desktop 7:06Paradigm on medium device sizes I want 7:09the buttons to be larger and centered in 7:12order to do this I'm going to change the 7:13alignment the alignment is a responsive 7:16setting as you can see from the icon to 7:18the left of the 7:19field now that we have the button Center 7:22aligned we're going to go to the content 7:24editing mode this will allow us to 7:27change the positioning properties of the 7:28buttons and make them 7:37wider previewing the small device size 7:41we can see our buttons still look decent 7:42and we will leave it as is to complete 7:45our client side Human Service we're 7:47going to add another screen to show the 7:49map when on a small device size to get 7:52to this map we're going to add another 7:53button to our 7:57layout this button is going going to be 7:59called view 8:01map we only want this button to appear 8:04on small device sizes so we'll go to the 8:07visibility we'll set it to be required 8:09on the small size switch to 8:12large and set its visibility To 8:18None on the 8:20diagram we're going to add a new coach 8:22to view the map 8:30and I will wire it to the button I just 8:37created When selecting view map we're 8:39given the same dialogue in this case 8:41we're not going to use a grid because 8:42it's going to be a very simple 8:46coach we'll create a instance of the map 8:49Coach View bind it to the postal 8:56code set its height to be 400 pixel pixs 9:00and that completes this coach let's run 9:03the client side Human Service to see the 9:05final 9:06Behavior we can see on large first name 9:08last name employee number each share a 9:10third of the horizontal space across the 9:12top is customer travel is a 9:15checkbox our map is Satellite by default 9:18and the okay and cancel buttons are 9:19right aligned if we adjust the browser 9:21width to medium size we can see that 9:24first name last name employee number are 9:27all 50% of the browser with with 9:29employee number flowing onto the next 9:31line the okay and cancel buttons are now 9:34larger and aligned to the center 9:37customer travel is now a switch and our 9:40map is road by 9:46default if I make the browser width even 9:49smaller we are not the small device 9:51setting the map is completely hidden all 9:55of our fields are now spanning the 9:56entire device width which would be very 9:58useful on a device such as a phone if I 10:01click the view map button we are taken 10:03to another screen with the map 10:06showing and that concludes the 10:08demonstration grid support is a simple 10:11and intuitive way of laying out the root 10:13content in your coach and Coach views 10:16which is both lightweight and responsive 10:18at runtime thank you 10:29n 10:33[Music]