Skip to content
REFERENCE

U.PUB_AND_PASTE

Summary

Helper method used to create properly formatted metadata that prevents the publication of stale data saved with a workbook when it is opened. Used in situations where multiple users concurrently update the same topic

Syntax

=U.PUB_AND_PASTE([topic_exists], [metadata])

Parameters

Parameter Required Description
[topic_exists] No If set to TRUE then the report will not be published until the existing report data is definitively pasted into the workbook; therefore if set to TRUE it will prevent newly created topics from ever being published
[metadata] No Additional metadata to be applied to report being published; can be selected from multiple ranges. If specified this metadata is combined with the pub_and_paste metadata into a single list of metadata entries

Behavior

The documented public interface is supported by the current U Add-in source signature and the maintained Usage Examples workbook. Optional parameters are shown in square brackets in the syntax above; omit the brackets when entering a formula.

Return Value

Returns the function result or action status described by the formula and parameters above. The maintained sources do not define a narrower, stable return contract for this function.

Examples

=U.DO(U.PUBLISH(C137,C138,G139:H146,U.PUB_AND_PASTE()))

Notes

  • Formula examples are preserved from maintained workbook usage and normalized to the current U. prefix.
  • Complete formulas demonstrate working patterns; they do not imply that undocumented option values are supported.
  • Where maintained sources do not specify every accepted value, default, or error message, this page does not infer one.
  • For functions that perform actions, use a visible trigger or supported block/throttle parameter to avoid unintended repetition during recalculation.