Default Values

When defining a data service, a user may have an requirement, that even if a user has not entered a specific parameter value in a request, a default value should be automatically added to the query. This can be done in WSO2 Data Services Server using the default values feature that is found when defining a query.

The WSO2 Data Services Server adds default values when defining queries. Therefore, even if a user has not entered a specific parameter value in a request, a default value gets automatically added to the query. For example, shown below is how a default value is set for an Input Mapping in a query:

Referring to Internal Property Values using Default Values

The Data Services Server defines special system variables that can be used as default values. At the moment, it only provides a variable for retreiving the username of the current user authenticated in a secured data service. This variable can be accessed using the following syntax:

#{USERNAME}: Dynamically replaces the input mapping with the current user's username when a data service request is processed.

#{NULL}: Sets the current input mapping value to null.
         It's the same as providing "xsi:nil" in the incoming message's input parameter element.

#{TENANT_ID}: Represents the current tenant ID.
              This is useful in a Stratos deployment where multiple tenants live in the same server.

#{USER_ROLES}: This value contains the list of user roles that the current calling user has.
               If the parameter mapped is of type ARRAY, it will have the full list of user roles.
               If it's a SCALAR, it will only contain the first user role of the user.

For a demonstration of the usage of default values, refer to the Default Values Sample in the Data Services Server examples section.