Referenced Team Sharing

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 Tagged Objects 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 illustrated 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

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 using Object Tags to extend the Layout to to include other objects (like Format or Styled Columns)

Special Columns

Any Layout which contains references to Calculated Columns or FreeText Columns will automaticallyf 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

Extended Layouts

Referenced Sharing will also take into consideration any Extended Layouts that leverage Object Tags.

If a Layout contains objects (e.g. Format Columns) which have Object Tags that reference the Layout, they will be inlcuded in the Referenced Share.

Caution

  • This requires autoCheckTagsForLayouts to be set to true in Layout Options
  • Alternatively, an implementation can be provided for isObjectExtendedInLayout (also in Layout Options)

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 illustrated Referenced Sharing of Extended Layouts which contain Object Tags
  • Alice has 2 Layouts - each with a different set of Format Columns tagged to 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 tagged Objects

Referenced Team Sharing

(Recorded with AdapTable v14.0)