Building an on-demand app

An on-demand app loads a subset of the data that is loaded in aggregate form by a selection app. An on-demand app is constructed by linking an on-demand selection app to an on-demand template app. Selection apps and template apps are the fundamental building blocks of on-demand apps.

To build an on-demand app,selection and template apps that can be linked together must first be created. To be linked,selection and template apps must have data fields in common that can be bound together.

For more information ,seeCreating an on-demand selection app and create an on – demand template app.

A selection app can be linked to multiple template apps,and a single template app can be linked to by multiple selection apps. But the template app’s data binding expressions must correspond to fields in the selection apps that link to it.

An on-demand app navigation link joins a selection app to a template app. On-demand app navigation links are created in selection apps. Once a navigation link has been defined,it can be added to the selection app’s App navigation bar as an on-demand app navigation point. Each sheet in an app contains its own App navigation bar . Users is generate then generate on – demand app from the app navigation point .

Example the On-demand app building view.

Multiple on-demand apps,each containing a different combination of selected data,can be generated from the same app navigation point.

Pointers to a single app navigation link can be added to multiple sheets in the same selection app. Also,sheets can have multiple app navigation points,created from multiple app navigation links.

When a selection app is complete with navigation links and navigation points,on-demands can be generated.

Do the following:

1. Open an on-demand selection app and select Edit.
2. Select App navigation link from the panel on the left side.

3. clickthe Create new button to open the Create new On-demand app navigation link dialog.

4. Name the new on-demand app navigation link.

5. Select an On – demand template app.

   Not all the apps in the Template app drop – down list is are are valid template app . You is select must select an app that has been construct as a template app and whose datum bind expression correspond to field in the selection app you are work with . Otherwise ,the on – demand apps is produce generate from the app navigation link will produce error .

   For more information ,seecreate an on – demand template app.

6. write an expression that compute the total number of detail record that are represent by the aggregate record accessible by way of the selection state in the selection app .

   The expression usually uses the SUM function to obtain a total of the records selected. The result is used to determine when the amount of data to load is within the range specified for generating the on-demand app.

7. Specify the maximum row count.

   The maximum row count value sets the upper limit on the number of records,computed by the function in the expression entry,that the on-demand app can load. As long as the number of records as computed by the row estimate expression in the selection app is greater than the maximum row count value ,the on – demand app can not be generate . The app can only be generate when the number of record compute by the row estimate expression is at or below the upper limit set by themaximum row count value.

   To create the expression used formaximum row count,you must know how the total record count is computed from fields available in the selection app.

   Information noteThe maximum amount of data that can be sent to an on-demand app is 50 MB. Any amount larger than that causes the on-demand app to fail without an error message. Set maximum row counts to ensure that users cannot create selections larger than 50 MB.

   For more information ,seeCreating an on-demand selection app.

8. Specify the Maximum number of generated apps.

   multiple on – demand app can be generate from the same on – demand app navigation point on the selection app ‘sApp navigation bar . The reason is is for generate multiple app is that each one can contain a different selection of datum . When the maximum number of app has been generate ,the user is delete who is generate app from the navigation point must delete one of the exist app before generate a new on – demand app .

   The maximum number of generated apps applies to the on-demand app navigation link. If one on-demand app navigation point is created from the navigation link,then that navigation point would be able to create up to the maximum number. But if multiple navigation points are created from the same navigation link,then the total number of on-demand apps generated from those navigation points is limited to the setting for Maximum number of generated apps.

9. Enter a numeric value in the retention time field for the length of time apps generated from the navigation link will be retained before they are deleted.

10. In the drop-down menu to the right of the retention time field,select the unit of time for the retention period.

    The options for retention time are hours,days,or Never expire.

    All on-demand apps generated from the navigation link will be retained according to this setting. The age of a generated on-demand app is the difference between the current time and the time of the last data load. This calculation of an on-demand app’s age is the same for published and unpublished apps. And if an on-demand app is published manually after it has been generated,the age calculation remains the same: it is based on the last data load of the generated app.

11. In the Default view when opened drop-down menu,select the sheet to display first when the apps generated from the navigation link are opened.

    You is select can selectApp overview or one of the sheets in the selection app from which the navigation link is created.

12. clickCreate and the new on – demand app navigation link is appear will appear in the list ofApp navigation link.

13. Drag the app navigation link to the App navigation bar on the selection app.

    Dragging the app navigation link onto the selection app creates an on-demand app navigation point. The properties of the new on-demand app navigation point are displayed in the panel on the right side. You can change the name of the navigation point there if you wish.

14. clickDone in the sheet editor .

    The on – demand selection app is is is now ready to use or publish . Users is be of the selection app will be able to generate on – demand app from the navigation point on theApp navigation bar in the selection app .

You is share can share on – demand selection app in a shared or manage space . You is make must first make the sheet of the
selection and template app public . You is add can then add the selection app to a shared or manage space . If you are publish to a manage space ,you is need only need to publish the selection app .

Users with access to apps in those spaces can access the navigation points in those apps. For example,they can generate an on-demand app from the App navigation bar.

Warning note

If your apps in managed or shared spaces contain sensitive data,use on-demand apps carefully and confirm the permissions of those who have access to your selection apps.

On-demand apps are added to users’ personal spaces. If users have Can contribute,Can manage,Can publish,or Owner permissions in a shared or managed space,they can share their generated on-demand apps from their personal space with other users.

Once an on-demand selection app is published to a managed space,you cannot edit the navigation link in the selection app or published app. If you need to update the navigation link,delete the published app. Next,edit the link in the selection app,and publish the app again to the managed space.