Jump to: navigation, search

Make an Object appear on the Mobile Client

Revision as of 13:10, 20 November 2019 by NWE (Talk | contribs) (→‎{{UBIK}} Studio)

Publishing an object's data, including its children, properties and documents, requires to configure the Application Context Management (ACM). Follow the steps how to do that:

UBIK® Studio

  1. Set up web services
  2. Create a new Application
  3. Create a new Context
  4. Create a new MetaClassScope or Create a new QueryScope
  5. Create a new View
  6. Create a new ViewItem
  7. Release the meta definitions
  8. Restart the UBIK® Content web service

UBIK® SmartStudio

Objects can be shown on the mobile client by configuring a compatible view hierarchy using SmartStudio, and connecting the object to be shown either as a root object to the Application Context, or as a child to another object. In both cases, a Scope modelling the look & feel for objects of that type needs to be provided. In the latter case, also a connection between the Scopes for the two types of objects must be provided as well.

Step-by-step, this is how you achieve that starting from scratch:

  1. Make sure there is a UBIK® Environment including a database and functioning web services, as well as a content object you want to show on the mobile client.
  2. Open a new Application Graph worksheet.
  3. Add a Application by dragging it into the worksheet from a picker (existing Apps) or the toolbox (new App).
  4. Add a Context by dragging it into the worksheet from a picker (existing Contexts) or the toolbox (new Context).
  5. Connect the Context to the Application by dragging a connection between the two.
  6. Add a Scope by dragging a MetaClass into the worksheet from a picker (existing MetaClasses) or the toolbox (new MetaClasses). Such a Scope is a configuration for all instances of the respective MetaClass delivered to the mobile client.
  7. Configure the Scope by adjusting the access rights for its MetaProperties.
  8. Connect the Scope to the Context. This means, instances of the scoped MetaClass will be presentable as root objects (first navigation level on the mobile client).
  9. Add further Scopes to the Application Graph and connect them by dragging a connection between two of them. This means, instances of the right-hand scoped MetaClass will be presentable in the hierarchy level below the left-hand scoped MetaClass' instances.
  10. Configure the connections (i.e., View Items) by choosing the way the instances are actually connected to each other (selecting a relation or link property). This means that for an instance of the left-hand scoped MetaClass, the configured link property or relation will be used to find instances of the right-hand scoped MetaClass to be listed as children of the first instance on the mobile client.
  11. Configure a root Query for the Context by dragging a Query into the worksheet from a picker (existing Queries) or the toolbox (new Queries), and connecting it to the Context, using its root objects input connector. This means, the query finds all instances to show on the root level of the app. The Context must have a compatible scope connected to it in order for the instances to be displayed correctly.
  12. If you want an object to be shown as the child of another on the mobile client, use a relation or link property to connect the two. This relation or link property can then be configured in a connection between two compatible Scopes.
  13. Save the application graph to the desired UBIK® Environment, using the toolbar or context menu.
  14. Release the meta definitions in the Environment worksheet.
  15. Restart the web services.

See also

Retrieved from "https://wiki.augmensys.com/index.php?title=HowTo:Make_an_Object_appear_on_the_Mobile_Client&oldid=21848"