Data Provider object

Official Content
This documentation is valid for:

Loads data in a hierarchical structure (from databases, services, fixed values, etc.).


Applications increasingly need to interact by exchanging data. From an application in a travel agency, ticket requests have to be sent to an airline containing the passengers' information; from another application, a Google service has to be used or merely exchange structured data within the application itself.

In this scenario, handling structured data becomes essential. The format used to represent them is not and will not be homogeneous. While XML is the most widely used format today, other formats are emerging, such as JSON to lighten the transfer, and we don't know what the future holds.

A Data Provider is a 'declarative procedure' used to obtain data in a hierarchical structure, with maximum clarity and minimum effort. How? By making the intention clear, that is to say, the output. Then, by simply indicating the desired format of the output.

DataProvider Input Output

Anything that can be done with a Data Provider can also be done with a Procedure. Both can be seen as processes where there is an Input, a Transformation, and an Output. The difference between them is that in a regular Procedure the focus is on the Transformation language. Meanwhile, in a Data Provider, the focus is on the Output language.

For example, if the process consists of reading all customers (Input) and writing an XML file with them (Output), the Procedure is as follows:

For Each
      &XmlWriter.WriteElement('Code', CustomerId.ToString())
      &XmlWriter.WriteElement('Name', CustomerName)

&XmlWriter is a variable of the GeneXus XMLWriter data type.

Here is not so easy to quickly 'see' the procedure output. Indeed, it is confusingly embedded inside the code written to obtain it.

Instead, the Data Provider shows clearly the intention:

          Code = CustomerId
          Name = CustomerName

Then, through the ToXML method, the output could be easily converted into the equivalent XML format:

      <Name>John Smith</Name>
      <Name>Jennifer Lopez</Name>


The way GeneXus implements hierarchical structures is the Structured Data Type (SDT) object. You can see this example fully implemented.

As you can see, a Data Provider is easier to write and understand, so some tasks will be easier to do with Data Providers than with regular Procedures. Which are they? Those that return structured data. For example:


Before going into a more formal definition, it can be helpful to present some samples:

Sample 1: Listing today's Invoices ordered by the amount

  Date = today()
  Invoice Order InvoiceAmount
  Where InvoiceDate = today()
    Id = InvoiceId 
    CustomerId = CustomerId
    CustomerName = CustomerName
    Amount = InvoiceAmount
      Id = ProductId
      DetailQuantity = InvoiceDetailQuantity 
      DetailAmount = InvoiceDetailAmount 

The output will be an SDT with today's date and a collection of items representing those invoices with InvoiceDate = today().

Sample 2: System Constants

  ChartServer = ''
  ChartParameters = '...'

Another example in the same area is loading the Tabs SDT needed by the TabbedView Web Component:

LoadTabs parm(&CustomerId)
    Code = 'General'
    WebComponent = link(WCustomerGeneral, &CustomerId)
    Code = 'Invoices'
    WebComponent = link(WCustomerInvoices, &CustomerId)

(see here for more details).

Sample 3: RSS feed with today's Invoices

  version = "2.0"
    title = "Today's Invoices"
    link = link(ViewTodayInvoices)
    item where InvoiceDate = today()
      title = format('Invoice %1', InvoiceId)
      link = link(ViewInvoice, InvoiceId)
      description = format('Invoice %1 for customer %2, amount %3', InvoiceId, CustomerName, InvoiceAmount)
      author = 'system'
      pubDate = today()

Now that you understand the spirit of Data Providers, take a look at:

And at the following examples and use cases:

Data Providers go a step further in 'declaring' instead of 'programming'. The big advantage: the underlying implementation can be changed, and the Data Provider will remain valid. More on Data Providers philosophy.


Start Video Compound data types

Subcribe to this category's changes
Sub CategoriesAdd a new subcategory in this category
PagesAdd a new page in this category