Appearance
Public link
A public link publishes the content of a notebook as a snapshot at the time it's published. Anyone who knows the link can view it without logging in to Codatum. Besides the whole notebook, you can also share URLs for an individual page or an individual chart.
Viewers can't do the following.
- Change parameters
- Re-run SQL
- Download
- Use the Explorer
- Comment
See Sharing for a comparison of sharing methods.
Creating and managing
Publishing requires publish permission on the source notebook, and publish permission on the connections used by the pages being published. Notebooks accessed through a shared folder can't be published. See Notebook and Connection for details on permissions.
- Open Share on the notebook screen, then select the Public link tab.
- Select Create public link.
- Configure the following, then select Publish.
| Item | Description |
|---|---|
| Link name | The name of the link. Defaults to the notebook name. You can also set an icon. |
| Published pages | The pages to publish. At least one page other than a section divider is required. |
| Embedded connections | Automatically extracted from the pages being published. Publish permission on the target connections is required. |
| Enable expiration | When enabled, published content is deleted after the specified number of days. Disabled by default. When enabled, the default number of days is 30, and you can specify a range from 1 to 90. |
After publishing, you can do the following from the Published public links list.
- Select the name to view it (not a link if it has expired).
- Publish changes: republishes to reflect changes to the notebook. You can check the diff with Compare notebook before publishing.
- Share: copy the URL after configuring the display options.
- Compare with current notebook
- Delete
- Change log (if you have permission to view the audit log)
Changes to the notebook itself aren't automatically reflected. You need Publish changes to reflect them.
URL sharing options
From Share, you can generate a URL at the following units.
- Entire report
- Individual page
- Individual chart
For Entire report, you can configure the following options.
| Item | Choices / content |
|---|---|
| Header | Show Codatum logo and title / Show Codatum logo only. Defaults to showing the Codatum logo and title. |
| SQL block | Show / Show results only / Hide. Defaults to showing it. |
| Hide sidebar | When enabled, hides the left sidebar. Disabled by default. |
| Theme | Light theme / Dark theme / Sync with system |
You can also get the embed code from the same screen.
Specification
- Public link pages have
noindexset, which suppresses indexing by search engines. - Data at the time of publishing is saved and shown as a snapshot.
- If expiration is enabled, published content is deleted once the specified number of days has passed since publishing.
- A workspace policy can disable creating and updating public links.
- The number you can create has a limit that depends on your contract (see Limits).
- A workspace owner can check the list of active public links from the global nav > Workspace settings > Public links. You can filter by keyword and open the source notebook or the public link.
When you can't publish
Check the following.
- Whether you have publish permission on the source notebook (notebooks accessed through a shared folder can't be published).
- Whether you have publish permission on the connections used by the pages being published.
- Whether creating and updating is disabled by a workspace policy.
- Whether you've reached the limit on the number of public links (global nav > Workspace settings > Usage).