prepare_global_references
Create GLOBAL references (globalReferenceNode) pinned to ONE SPECIFIC row. Use this when a document must reference MULTIPLE DIFFERENT rows of the same table at once (e.g. Alice’s email AND Bob’s email, a roster, a comparison). Each reference is locked to the rowId you pass and is independent of the document’s active row, so different references can point to different rows. Call lookup_table_rows first to get the rowId. Returns a mapping of columnId to tableReferenceId to use on globalReferenceNode nodes (markdown: {{globalref:ID}}). For the common case where ALL placeholders should share one row that the user can switch later, use prepare_placeholder_references instead. IMPORTANT: If you just created a new document, pass the documentId parameter with the new document’s ID.
Parameters
string
required
The ID of the table whose columns you want to reference.
array<string>
required
Array of column IDs to create global references for (all pinned to the same rowId).
string
required
Required. The specific row to pin these references to. Obtain from lookup_table_rows.
string
The target document ID. Required when no document is open in context. Falls back to the context documentId if omitted.