Referenced Team Sharing

View as Markdown

Summary

  • Referenced Team Sharing ensures that complex Shared Entities are fully shareable
  • Not only is the object shared but so are any dependent objects (e.g. Calculated Column in a Layout)
  • When sharing an Extended Layout all objects extended into that Layout are included in the Share

Sometimes when using Team Sharing, a Shared Entity might contain references to other objects.

When this happens, AdapTable will:

  • find all the associated dependencies
  • upload them into Team Share together with the main Shared Entity
Deep Dive

How Referenced Sharing Works

Sharing Objects

The most common referencing use case is when one Adaptable Object references a second AdapTable Object.

For instance sharing a Format Column which references a Named Query.

AdapTable will ensure that all dependencies are shared.

Referenced Team Sharing: Adaptable Objects
Fork
  • This demo illustrates Referenced Sharing of AdapTable Objects:
  • Alice has 2 related objects:
    • a Named Query called Hottest JavaScript
    • a Format Column which references the Named Query to style rows that match
Try It Out
  • As Alice share the Format Column
  • Switch to Bob and open TeamShare
  • You will note that not only is the Format Column there but so is the Named Query which it references
Loading demo…

Sharing Layouts

Another common use case for Referenced Team Sharing is when a Layout is shared.

A Layout can include references to other objects in 2 ways:

  • by containing Special Columns - e.g. Calculated Columns or FreeText Columns
  • by being an Extended Layout which includes other objects (like Format or Styled Columns)

Special Columns

Any Layout which contains references to Calculated Columns or FreeText Columns will automatically include them in Referenced Sharing.

Referenced Team Sharing: Layouts
Fork
Try It Out
  • As Alice shares the Layout by clicking the 'Share Special Column View' button in the Dashboard
  • Switch to Bob and open TeamShare
  • Note that not only is the Layout there but so are the Calculated and FreeText Columns
  • Select the 'Special Column View' Layout and see how the Shared Layout automatically includes the 2 Columns
Loading demo…

Extended Layouts

Referenced Sharing will also take into consideration any Extended Layouts.

If objects (e.g. Format Columns) have been extended into a Layout, they will be included in the Referenced Share.

The Shared Entity stores LayoutExtensions — which objects were extended into the Layout at share time — so import recreates the same Extended Layout on the downloader's grid.

Note

  • Only objects explicitly extended into the Layout are shared — global objects (available in every Layout) are not included
  • If an Active Share is used, changing which objects are extended into the Layout will update the Share
  • Shared entities are migrated on load when autoMigrateState is enabled; see Migrating Shared Entities and the Version 24 Release Note when planning a shared-store upgrade.

Find Out More

See Extending Layouts for detailed instructions on how to scope Adaptable Objects to particular Layouts

Referenced Team Sharing: Extended Layouts
Fork
  • This demo illustrates Referenced Sharing of Extended Layouts
  • Alice has 2 Layouts - each with a different set of Format Columns and Styled Columns extended into that Layout:
    • First View - Name, Language and Date columns
    • Second View - Github Stars, Closed Issues and also Date columns, plus a Condition where Language is 'HTML'
  • There is a button in the Dashboard for Alice to share the First View Layout
Try It Out
  • As Alice shares the First View Layout by clicking the 'Share Layout: First View' button in the Dashboard
  • Switch to Bob and open TeamShare
  • You will note that not only is the Layout there but so are the associated Format Columns
  • Upload the First View Layout and you will see that the Shared Layout automatically includes all the extended Objects
Loading demo…