sync-entities

This action can be used to sync your local database with your live database on the server. There are multiple ways to set up a sync-entities action within a jig:

1. Under action button

2. In action list

3. In onPress/onChange events (if the component has these options)

4. In onRefresh/onFocus

5. Dynamically sync multiple entities

sync-entities can't be used if you using Static Data.

Examples and code snippets

sync-entities in action

In this example, when tapping the Sync entities button the action.sync-entities is used to show a list of employees.

Example: The full example of sync-entities in action you can find in GitHub

Sync-entities action

sync-entities-action.jigx

actions:
  - children:
    - type: action.sync-entities
      options:
        title: Sync entities
        provider: DATA_PROVIDER_DYNAMIC
        entities:
          - default/employees    

sync-entities in the action list

sync-entities action

In this example the action.sync-entities is used to linkt to the a different jig.

Example: The full example of sync-entities in an action list you can find in GitHub.

sync-entities-actionlist.jigx

actions:
  - children:
    - type: action.action-list
      options:
        title: Sync entities
        actions:
          - type: action.sync-entities
            options:
              provider: DATA_PROVIDER_DYNAMIC
              entities:
                - default/employees
          - type: action.go-to
            options:
              linkTo: default-employee-detail

sync-entities in onPress/onChange event

Here is the example of sync-entities in onPress/onChange event in list-item

Example:

The full example of sync-entities in onChange you can find in GitHub. The full example of sync-entities in onPress you can find in GitHub.

Sync-entities action with onPress

sync-entities-onPress.jigx

item:
  type: component.list-item
  options:
    title: [email protected] & ' ' & @ctx.current.item.lastname
    subtitle: [email protected] = null ? '' :'The last onPress action:' & ' ' & @ctx.current.item.time
    leftElement: 
      element: avatar
      text: '' 
      uri: [email protected]
    onPress: 
      type: action.action-list
      options:
        isSequential: true
        actions:
          - type: action.execute-entity
            options:
              provider: DATA_PROVIDER_DYNAMIC
              method: update
              entity: default/employees
              data:
                id: [email protected]
                time: =$fromMillis($toMillis($now()), '[h#1]:[m01][P]')
          - type: action.sync-entities
            options:
              provider: DATA_PROVIDER_DYNAMIC
              entities:
                - default/employees

sync-entities-onChange.jigx

sync-entities in onRefresh/onFocus

sync-entities action with onRefresh

Example:

See the full example of sync-entities on onRefresh action in GitHub.

If you want to use onLoad or onFocus just change the onRefresh to onLoad or onFocus

sync-entities-onRefresh.jigx

onRefresh: 
  type: action.sync-entities
  options:
    provider: DATA_PROVIDER_DYNAMIC
    entities:
      - default/employees

sync-entities-onFocus

Dynamically sync multiple entities

When building a solution, the number of entities to sync and the parameters for each are not always known; for example, when syncing the attachments, files, or documents for a message, there can be zero, one, or more. It is necessary to dynamically specify a list of the entities, functions, and function parameters to return from the database using an expression.

Considerations

• The expression is specified in the action.sync-entities action either as a local action in the jig or as a global action.

• Dynamic sync-entities apply to the REST, OneDrive, and Salesforce data providers.

• Any of the following can be synced dynamically: entity, functions, and function parameters.

Expression structure

• The basic expression structure is =$.map(array, function).

  • Specify the array you will consult, i.e., a datasource @ctx.datasources.{datasourceName}.

  • For the function, specify ($item).

  • Example of the basic structure =$map(@ctx.datasources.{datasourceName}, function($item)).

• After defining the basic structure, map out relevant properties from the array to the relevant entity/function/parameters and specify the dynamic entry using the $.item property, e.g., "calenderId": $.item.id. This will run through all the records in the datasource and perform a sync-entities action for each record in the table.

sync-entities-action

# Example of dynamic sync-entities expression
actions:
  - children:
      - type: action.sync-entities
        options:
          title: Show events
          provider: DATA_PROVIDER_REST
          entities: | 
            =$map(@ctx.datasources.list-calendars-rest, function($item) {
              $.{
                "entity": "events-from-calendar"
                "function": "get-calendar-event-list"
                "parameters": {
                  "accessToken": "jigx.graph.oauth",
                  "calendarId": $item.id
                }
              }
            })[]

Example sync-entities dynamically for calendars (full input source)

To return all records from the input source use $item.id. In this example, a jig has two lists; the first list shows all the user's calendars, and the second list uses the ids from the first list to return all the events for all the calendars. A summary component shows a count of the number of events.

Sync calendars and events

full-calendar-list

# Jig for to show the calendars and events
title: Calendars
type: jig.default

header:
  type: component.jig-header
  options:
    height: small
    children:
      type: component.image
      options:
        source:
          uri: https://images.unsplash.com/photo-1435527173128-983b87201f4d?w=800&auto=format&fit=crop&q=60&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxzZWFyY2h8Mnx8Y2FsZW5kYXJ8ZW58MHx8MHx8fDA%3D

onRefresh: 
  type: action.execute-action
  options:
    action: sync-dynamic-ds-rest
    parameters:
      datasource: [email protected]

actions:
  - children:  
    # dynamically list all calendars using REST using the sync-dynamic-ds-rest
    # global action with and the full datasource.
      - type: action.execute-action
        options:
          title: Sync all calendar events
          action: sync-dynamic-ds-rest
          parameters:
            datasource: [email protected]
            
children:
  - type: component.section
    options:
      title: My calendars
      children:
        - type: component.list
          options:
          # use the list-calendars-rest to return the list of calendars.
            data: [email protected]
            maximumItemsToRender: 8
            item: 
              type: component.list-item
              options:
                title: [email protected]
                value: [email protected]
  - type: component.section
    options:
      title: All Calendar Events
      children:
        - type: component.list
          options:
          # use the list-calendars-rest to return the list events by calendar.
            data: [email protected]
            maximumItemsToRender: 8
            item: 
              type: component.list-item
              options:
                title: [email protected]
               
summary:
  children:
    type: component.summary
    options: 
      layout: counter
 # Expression to count the number of events across all calendars.     
      value: =$count(@ctx.datasources.list-events-by-calendar)
      title: Total events 

sync-dynamic-ds-rest

get-calendar-event-list

Example sync-entities dynamically for a selected calendar

To return all records for a selected calendar use =$map(@ctx.action.parameters.selected, function($item) in the global action. In this example, a jig has a dropdown to select the calendar and a Show events button syncs the entries in the selected calendar. A summary component shows a count of the number of events in the selected calendar.

Sync events for the birthday calendar

my-events.jigx

# jig to selected the calendar and sync the events for that calendar
title: My events
type: jig.default

header:
  type: component.jig-header
  options:
    height: small
    children:
      type: component.image
      options:
        source:
          uri: https://images.unsplash.com/photo-1633526543814-9718c8922b7a?q=80&w=2670&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D

onRefresh: 
  type: action.execute-action
  options:
    action: sync-dynamic-ds-rest
    parameters:
      datasource: [email protected]

actions:
  - children: 
  # return events for a selected calendar by passing the selected array in the 
  # parameters.
      - type: action.execute-action
        options:
          title: Show events
          action: sync-dynamic-selected-rest
          parameters:
            selected: [email protected]
  # If you wanted a single value returned replace {selected} with {value}.
      
children:
  - type: component.form
    instanceId: selectCalendarForm
    options:
      children:
        - type: component.dropdown
          instanceId: selectCalendar
          options:
            label: Select Calendar
            data: [email protected]
            isMultiple: true
            item:
              type: component.dropdown-item
              options:
                title: [email protected]
                value: [email protected]
  
  - type: component.list
    options:
      data: [email protected]
      maximumItemsToRender: 8
      item: 
        type: component.list-item
        options:
         leftElement: 
           element: icon
           icon: event
         title: [email protected]
         subtitle: [email protected]

summary:
  children:
    type: component.summary
    options: 
      layout: counter
      value: =$count(@ctx.datasources.list-events-by-calendar)
      title: Number of events

message =

get-calendar-event-list