Interface: DynamicSyncTableOptions<K, L, ParamDefsT, SchemaT>¶
Options provided when defining a dynamic sync table.
A ConnectionRequirement that will be used for all formulas contained within this sync table (including autocomplete formulas).
Default is true.
If false, when subsequent syncs discover new schema properties, these properties will not automatically be added as new columns on the table. The user can still manually add columns for these new properties. This only applies to tables that use dynamic schemas.
When tables with dynamic schemas are synced, the getSchema formula is run each time, which may return a schema that is different than that from the last sync. The default behavior is that any schema properties that are new in this sync are automatically added as new columns, so they are apparent to the user. However, in rare cases when schemas change frequently, this can cause the number of columns to grow quickly and become overwhelming. Setting this value to false leaves the columns unchanged and puts the choice of what columns to display into the hands of the user.
The description of the dynamic sync table. This is shown to users in the Coda UI when listing what build blocks are contained within this pack. This should describe what the dynamic sync table does in a more detailed language.
A label for the kind of entities that you are syncing. This label is used in a doc to identify
the column in this table that contains the synced data. If you don't provide an
entityName, the value
identity.name from your schema will be used instead, so in most cases you don't need to provide this.
The definition of the formula that implements this sync. This is a Coda packs formula
that returns an array of objects fitting the given schema and optionally a Continuation.
(The name is redundant and should be the same as the
name parameter here.
These will eventually be consolidated.)
A formula that that returns a browser-friendly url representing the
resource being synced. The Coda UI links to this url as the source
of the table data. This is typically a browser-friendly form of the
dynamicUrl, which is typically an API url.
A formula that returns the name of this table.
A formula that returns the schema for this table.
See identityName for an introduction.
Every dynamic schema generated from this dynamic sync table definition should all use the same name for their identity. Code that refers to objects in these tables will use the dynamicUrl to differentiate which exact table to use.
A formula that returns a list of available dynamic urls that can be used to create an instance of this dynamic sync table.
The name of the dynamic sync table. This is shown to users in the Coda UI
when listing what build blocks are contained within this pack.
This should describe the category of entities being synced. The actual
table name once added to the doc will be dynamic, it will be whatever value
is returned by the
Optional placeholder schema before the dynamic schema is retrieved.
defaultAddDynamicColumns is false, only featured columns
in placeholderSchema will be rendered by default after the sync.