28 Manage Publishing Channels
A publishing channel determines the release rules that are applied to an item in a repository. A channel can be public and available to everyone, or secure and limited. You must be a repository administrator to manage publishing channels.
Note:
- If you're using Oracle Content Management Starter Edition, you're limited to only one publishing channel, not including the one allowed site channel. To increase the number of publishing channels and take advantage of the full feature set, upgrade to the Premium Edition.
- Publishing channels aren't used in business asset repositories.
A publishing channel can be applied to one or more asset repositories and the assets managed in the repositories. In addition, one repository might use multiple channels. Specific assets in a repository can use different channels, letting you fine tune the policies to be applied in individual cases.
When a site is created, a publishing channel is automatically created using the site name as the channel name.
By default the Publishing Channels page shows all publishing channels, sorted by name. Use the drop-down menu on the right to change the sort order. You can also use the search box to find a publishing channel by name.
You can manage publishing channels in the following ways:
Create a Publishing Channel
A publishing channel determines the release rules that are applied to an item in a repository. A channel can be public and available to everyone, or secure and limited. You must be a repository administrator to create and share publishing channels.
To create a channel:
- Sign in as a repository administrator in your browser and click Content under Administration in the left navigation menu.
- Choose Publishing Channels from the drop-down list and then click Create.
- Enter a name for the channel. Don’t use special characters in the name.
- Enter an optional description. It’s useful to describe how the channel can be used so others will understand it quickly and easily.
- Decide what the publishing policy will be. You can elect to have items published without approval, or restrict publishing to only those items that have been through an approval process.
- Choose the localization policy to use for the channel.
- Select a search results ranking policy and the asset types to which you want to apply the ranking policy.
- If you set a ranking policy scope, the ranking policy will be applied to results that match the ranking policy rules, but only if the assets are of an asset type selected here.
- If you don't set a ranking policy scope and a user limits their search to one or more asset types, the ranking policy will be applied to all results that match the ranking policy rules (both standard field rules and user-defined field rules).
- If you don't set a ranking policy scope and a user doesn't limit their search to an asset type, only the standard field rules in the ranking policy will be used to apply the ranking policy.
- Decide if the channel will be public or secure. A public channel is one that can be used by anyone in your organization. A secure channel is limited to people with a specific role.
- If you selected Secure, select which groups of registered users can access the assets or other resources published to this secure channel.
- Cloud Users: Only Oracle cloud users who can sign into your identity domain can access the secure content.
- Service Users: Only users who can sign into this instance of Oracle Content Management can access the secure content.
- Specific Users: Specify users who can access the secure content. Click Manage Users, then click Add Members. Enter a user name or a portion of a user name in the search field, and select the user from the displayed list. Repeat the process to add more users. When you're done adding users click Add. To remove a user, click Remove from the menu below the user’s name. When selecting users, click Done.
- Click Save when done.
After the channel is created, a channel ID and a channel token are assigned to the channel. If you created a secure channel, a channel secret is also assigned to the channel. These values can be used when creating customized interfaces. To see the values, click the channel to open it in the editor.
Associate a Publishing Channel with a Repository
You must associate a publishing channel with at least one repository in order for it to be used to publish assets in the repository.
You can associate a publishing channel with a repository when you create the repository or you can edit the repository to add the publishing channel.
To edit a repository to add a publishing channel:
- Sign in as a repository administrator in your browser and click Content under Administration in the left navigation menu.
- Choose Repositories from the drop-down list.
- Open the repository you want to associate the publishing channel with.
- Under Publishing Channels, choose the publishing channels to be used with the repository.
Edit a Publishing Channel
To edit a channel:
- Sign in as a repository administrator in your browser and click Content under Administration in the left navigation menu.
- Choose Publishing Channels from the drop-down list.
- Click the publishing channel you want to edit.
- Edit the publishing policy, localization policy, search results ranking policy, or ranking policy scope as necessary.
- If you created a secure channel and need your API client app to access the secure content, use the channel secret:
- To copy the Channel Secret, click .
- To get a new channel secret, click Refresh.
- To revoke access through the channel secret, click Revoke.
- If you changed the published resources access from public to secure, you'll need to save your changes and open the channel in the editor again to see the channel secret.
- If you need to supply your API client app with channel information, use the channel ID and token. Click to open the Properties pane, then click the API tab.
- To copy the Channel ID or Channel Token, click next to the value.
- To get a new channel token, click Refresh.
- Click Save when done.
Share a Publishing Channel
Sharing a channel is like sharing any file or folder. Just select the channel, click Members, and choose members and choose the role they can have. You can share with individuals or with groups.
If you assign someone a Manager role, make sure that person is a repository administrator. That will allow the user to fully manage the channel, including adding other users, publishing assets to the channel, and doing other administrative tasks.
When you create a site, a publishing channel is automatically created with the site name as its name. You can’t edit any of the details of the channel except its description and you can’t directly share the channel with others. You’ll need to share it by sharing the site.
Users without an administrative role will be able to target assets to a channel without the channel being shared with them. But you must share a channel to a person with a minimum of a contributor role in order for that person to publish or unpublish assets. Even if the person has a manager role in the repository, they must also have a role for the channel in order to use it for publishing.
Delete a Publishing Channel
You can’t delete a channel if it has published assets or if it's associated with a site. You have to delete the published assets or the site in order to delete the channel.
To delete a publishing channel, select it and then click Delete.
View Publishing Channel Properties
The publishing channel properties show when the publishing channel was created and last updated and the API information. You can also view or edit the name and description.
To view the properties, open the publishing channel, then click .
Property information is divided into tabs:
- General – displays the name, description, when the publishing channel was created, and when it was last updated. You can edit the name or description, and then click Save to save your changes.
- API – displays the channel ID and channel token. To copy the ID or token to the clipboard, click next to it.
If the channel token is ever compromised, you can prevent unwanted access to any content previously published to the channel by refreshing the channel token. Click Refresh.