Getting Started With The Bound Grid Control
 

This quick start guide shows you how to create an instance of the Boötes AX7 Bound Grid control on a form and how to connect that instance to the Currency table without writing code.

This guide assumes that the Boötes AX7 Bound Grid control has already been successfully installed in the development machine.

1. Create a New Project.

Open Visual Studio in your Dynamics 365 for Finance and Operations development machine and create a new Unified Operations project:

Create a new Unified Operations project in Visual Studio


2. Create a New Model.

Create a new model called BoundGridQuickStart that references the BootesAX7BoundGrid model and the Currency model. The Currency model is necessary because we will be displaying the currency table in the Bound Grid control.

Go to Dynamics 365 > Model Management > Create Model:

Create Model - Boötes AX7 Bound Grid Control - Dynamics 365 for Finance and Operations

Set the model's name to BoundGridQuickStart.

Add Parameters Create Model - Boötes AX7 Bound Grid Control - Dynamics 365 for Finance and Operations

Press the Next button.

Select Package Create Model - Boötes AX7 Bound Grid Control - Dynamics 365 for Finance and Operations

Select the Create new package radio button option. Click on the Next button.

Refrences 1 Create Model - Boötes AX7 Bound Grid Control - Dynamics 365 for Finance and Operations

Check the BootesAX7BoundGrid reference.

References 2 Create Model - Boötes AX7 Bound Grid Control - Dynamics 365 for Finance and Operations

Also check the Currency reference (the Currency table is going to be displayed in the grid). Click on the Next button.

Summary Create Model - Boötes AX7 Bound Grid Control - Dynamics 365 for Finance and Operations

Uncheck the Create new project and Make this my default model for new projects check boxes. Click on the Finish button.

3. Set the Newly Created Project's Model.

Switch the project's model over to the newly created model. Right click on the project:

Project Properties - Boötes AX7 Bound Grid Control - Dynamics 365 for Finance and Operations

Select properties.

Switch Model - Boötes AX7 Bound Grid Control - Dynamics 365 for Finance and Operations

Select the BoundGridQuickStart model.

Switch Model - Boötes AX7 Bound Grid Control - Dynamics 365 for Finance and Operations

Click on the Apply button and then on the OK button to close the dialog.

4. Add a form to the project.

Right click on the project:

Add New Item - Boötes AX7 Bound Grid Control - Dynamics 365 for Finance and Operations

Select Add > New Item

Add Form - Boötes AX7 Bound Grid Control - Dynamics 365 for Finance and Operations

Select Form, change the name to BGQSForm1 and click on the Add button.

5. Copy the control over from the Bound Grid Demo.

Open another instance of Visual Studio. Open the Bound Grid Demo solution which should be located in C:\Users\Administrator\Documents\Visual Studio 2015\Projects\BootesAX7BoundGridDemo.sln.

Open Demo - Boötes AX7 Bound Grid Control - Dynamics 365 for Finance and Operations

Open the BBGBlank form.

Open Blank Form - Boötes AX7 Bound Grid Control - Dynamics 365 for Finance and Operations

Right click on the BBGBoundGrid1 control and click on Copy.

Copy Control - Boötes AX7 Bound Grid Control - Dynamics 365 for Finance and Operations

Go back to the UnifiedOperations1 project and in BGQSForm1, right-click on design and click on Paste.

Paste Control - Boötes AX7 Bound Grid Control - Dynamics 365 for Finance and Operations

You should now have an instance of a blank Boötes AX7 Bound Grid Control on BGQSForm1.

Bound Grid Control - Boötes AX7 Bound Grid Control - Dynamics 365 for Finance and Operations


6. Create the Data Source and Set the Main Properties for the Control.

In BGQSForm1 right click on data sources and click on New Data Source.

Add new datasource - Boötes AX7 Bound Grid Control - Dynamics 365 for Finance and Operations

In the properties for the new data source set the Table to Currency.

Set Table property - Boötes AX7 Bound Grid Control - Dynamics 365 for Finance and Operations

In the properties for the BBGBoundGrid1 control set the DataSource to Currency, Grid Type to Standard, Height Mode to SizeToAvailable and Width Mode to SizeToAvailable. SizeToContent is not supported.

Set Grid Properties - Boötes AX7 Bound Grid Control - Dynamics 365 for Finance and Operations

7. Create the columns.

Expand the BBGBoundGrid1 control node and right click on Columns and click on New Column.

Add new Column - Boötes AX7 Bound Grid Control - Dynamics 365 for Finance and Operations

Set the new column properties to:

  • Name: Currency_CurrencyCode
  • DataSource: Currency
  • DataField: CurrencyCode
  • Visible: True
  • Width: 250
Create another column and set the new column properties to:
  • Name: Currency_CurrencyCodeISO
  • DataSource: Currency
  • DataField: CurrencyCodeISO
  • Visible: True
  • Width: 250
Create another column and set the new column properties to:
  • Name: Currency_Txt
  • DataSource: Currency
  • DataField: Txt
  • Visible: True
  • Width: 250

8. Debug the project.

Right click on BGQSForm1 in Visual Studio's Solution Explorer and click on Set as Startup Object.

Set as Startup Object - Boötes AX7 Bound Grid Control - Dynamics 365 for Finance and Operations

Click on Debug > Start Debugging.

Start Debugging - Boötes AX7 Bound Grid Control - Dynamics 365 for Finance and Operations

You will get this result:

Currency Table - Boötes AX7 Bound Grid Control - Dynamics 365 for Finance and Operations


All trademarks remain property of their respective holders, and are used only to directly describe the products and services being provided. Their use in no way indicates any relationship between Boötes Systems SAS and the holders of said trademarks.