Skip to content
REFERENCE

U.PUB_SECRET

Summary

Helper method used to create properly formatted metadata for applying a publish secret to a report being published. Publish secrets are used to restrict publish rights to reports

Syntax

=U.PUB_SECRET(publish_secret, [publish_secret_prior], [metadata])

Parameters

Parameter Required Description
publish_secret Yes The secret to be applied to publishes
[publish_secret_prior] No The prior publish secret applied to the report. Used when changing or removing a publish secret to prove to server publisher has publish rights
[metadata] No Additional metadata to be applied to report being published. If specified this metadata is combined with the pub_secret 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.PUB_SECRET("myPubSecret")

=U.PUB_SECRET("myNewPubSecret","myPubSecret")

=U.PUB_SECRET("RUNLINE/DESK3/PNL")

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.