Friday, September 24, 2021

PowerApps: Nested Gallery

Hello Friends,

Welcome back with another post on PowerApps. We are starting a series of posts in which we will learn about-

  1. Nested Gallery
  2. Expand / Collapse (individual master child record set)
  3. Expand All / Collapse All
  4. Alternate row color
Below is the overview of functionality, we are going to discuss-

We will learn all these features one by one. So let's start-

  1. Before starting, we need a SharePoint List having below columns-
    1. OrderID
    2. ItemName
    3. ItemQuantity
  2. We have kept the list simple to just show the functionality.
  3. Now add 5-6 orders with each having multiple items.

  4. Now click on App Launcher (grid of 9 dots at top left corner) and click on PowerApps to open the PowerApps maker platform.
  5. I am creating PowerApps in Tablet mode so that the display of nested gallery should be clear.
  6. First of all, add connection with SharePoint list. For this, click on Data icon from left navigation menu, click on Add Data. Now select the SharePoint connector. Select the Site and then list "OrdersList".
  7.  
  8. Now, add a button at bottom right corner which will load the data from SharePoint to local collection.
  9. Click on Insert >> Button. Rename it btnLoadData. Set Text as "Load Data".
  10. Add below function on "OnSelect" property-
  11. ClearCollect(OrdersListCollection,GroupBy(OrdersList,"OrderID","ListItemDetails"));
    
  12. This function will load the data from SharePoint list into a local collection "OrdersListCollection" with grouping on OrderID. The grouped data will reflect under column "ListItemDetails". It means, the local collection will have two column-
    1. OrderID
    2. ListItemDetails


  13. Now we will add gallery control on screen. For this, choose the gallery of type "Blank flexible height". The reason behind this is that we will expand the item based on the number of child items.

  14. Set the-
    1. Height property of gallery as "Parent.Height"
    2. Width property as "1000"
    3. Items property as "OrdersListCollection"
  15. Now click on the Edit icon of item template as shown in below screenshot-
  16. Add a label and set it's-
    1. Width as 400
    2. Position X as 0
    3. Position Y as 0
    4. FontWeight as Bold
    5. Height as 50
    6. Fill as RGBA(241, 244, 249, 1)
    7. Rename it as lblOrderID
    8. Text as Concatenate("Order ID: ",Text(ThisItem.OrderID))
  17. Add one more label and set it's-
    1. Width as 585
    2. Position X as 400
    3. Position Y as 0
    4. FontWeight as Bold
    5. Height as 50
    6. Fill as RGBA(241, 244, 249, 1)
    7. Rename it as lblCustomer
    8. Text as Concatenate("Customer: ",LookUp(OrdersList,OrderID = ThisItem.OrderID,'Created By'.DisplayName))

  18. This will show the Order ID and the Customer name. Rename this gallery as "GalleryOrderMaster".
  19.  Now we will add one more gallery, which will show the Items associated with that particular Order ID. Once again, click on edit icon as shown in Step 20 and add another gallery of type "Blank flexible height". Rename it as "GalleryItemsDetails".
  20. Set-
    1. Position X as 50
    2. Position Y as 50 (you may set it dynamic by specifying lblOrderID.Height + lblOrderID.Y)
    3. Width as 885
    4. Height as 100 (we will make it dynamic later in code)
    5. Items as ThisItem.ListItemDetails
  21. Now we will add two labels to show the ItemName and ItemQuantity.
  22. Add first label and set-
    1. Name as lblItemName
    2. Text as ThisItem.ItemName
    3. Position X as 0
    4. Position Y as 0
    5. Width as 300
    6. Height as 50

  23. a
  24. Similarly, add another label and set-
    1. Name as lblItemQuantity
    2. Text as ThisItem.ItemQuantity
    3. Position X as 300
    4. Position Y as 0
    5. Width as 300
    6. Height as 50

  25. This way you can show nested items. The basic part is complete. Now, if you execute the PowerApps, you will find that the height of nested gallery is fixed. So, we will make it dynamic. For this, set the Height of GalleryItemDetails as "(CountA(ThisItem.ListItemDetails.ItemName)+1)*50". We have added +1 to make sure there should be no scrollbar.

  26. This way we can achieve nested gallery functionality. In next post, we will discuss about Expand / collapse feature in nested gallery.
  27. UPDATE:
    1. Some times, you may find that if the data in nested gallery is too large, then the behavior of parent-nested gallery becomes abnormal.

    2. As you can see, Parent Items (Kamal, Manoj...) are inline with Child Items (Item-491, Item-492...). (Below is the dynamic height code which you will read in my next articles of this series).
    3. The Height code is-
    4. If(
          ThisItem.OrderID = ParentGallery.Selected.OrderID,
          (CountA(
              Filter(
                  CollChild,
                  OrderID = ThisItem.OrderID
              ).ItemName
          ) + 1) * 50,
          0
      )
      
    5. To avoid this situation, we need to fix the height of child gallery upto a max limit. But the problem is that, there is Max Height property available for Gallery control.
    6. So, we have prepared a workaround to overcome this problem. We have Min function. We will make use of it.
    7.  Let's modify the code for Height (I am taking maximum height for child gallery as 400)-
    8. If(
          ThisItem.OrderID = ParentGallery.Selected.OrderID,
          Min(
              (CountA(
                  Filter(
                      CollChild,
                      OrderID = ThisItem.OrderID
                  ).ItemName
              ) + 1) * 50,
              400
          ),
          0
      )
      
    9. After implementing this code, the height of child gallery is set to maximum 400 as the calculated height was much greater than 400. Therefore, Min function gave 400 as output.
    10.   
    11. In case if the calculated height is less than 400, in that case, the Min function will gave the calculated value as output. 
With this, I am concluding this post.
Happy Coding !!!
Will see you again with some new topics.

Stay Safe !
Stay Healthy !

No comments:

Post a Comment

Note: Only a member of this blog may post a comment.