Publish Assets

12 Publish Assets

You publish assets to make them available for use in sites or other channels. You can publish assets immediately or schedule them to be published at a later time and date.

Note:

You can't publish assets in business asset repository.

Here are some things to keep in mind about publishing assets:

Some channels may require assets to be approved before they can be published.
If you’re publishing an asset and it’s been translated, the version you’re publishing must be set as translated before it can be published. Select the translated version, and click Set as Translated to show that the version has been approved.
If you select multiple assets to publish, all the channels the assets are targeted to will be shown. For example, if you have two assets that are targeted for publishing to Channel A and one asset targeted to Channel B, then "Channel A (2)" and "Channel B (1)" appears in the Channel list, indicating the number of assets targeted to each channel.
You can't publish assets until they have been validated against the policies of the channels to which they'll be published. After validating, you see results showing you which assets follow the policies and which do not.
When an asset is published, a new version is created and the number to the left of the decimal point is increased. For example, if you publish version 1.2, the published version becomes version 2.
For scheduled publishing, any new versions that were created between the time of scheduling and publishing will be renumbered. For example, if you scheduled publishing of version 1.2, then created versions 1.3 and 1.4, the published version becomes version 2, version 1.3 becomes version 2.1, and version 1.4 becomes version 2.2.

You can manage publishing in the following ways:

After you publish assets, you can:

Add them to sites, see Work with Assets and Content Items.
Access published assets digital assets through a URL.

Assign Publishing Channels

To view the asset's channels, select or open the asset, click , then, in the drop-down menu, choose Channels.

To associate a new channel with the asset, click Add, select a channel, and click Add again.

To remove a channel, select it, and click Remove.

Publish Assets from the Assets Page

To publish an asset from the Assets page:

On the Assets page, right-click or select the assets you want to publish.
Choose Publish Now or Publish Later from the right-click menu or the Publish menu. If the asset is already scheduled for publishing, you won't see the Publish Now option.
If you selected Publish Later:
1. Enter a name for the publishing job so you can easily find it on the publishing calendar.
2. Optionally, enter a description to help understand what this job is used for.
3. Select when you want to publish.
4. If you want to publish content on a recurring basis, choose the frequency in the Recurrence drop-down list. If you choose Custom, you'll see additional options (for example, you can set the job to run every two weeks on Tuesdays). You can also select an end date. Note that the recurrence schedule can't be changed after the job is created.
The selected assets are added only to the first instance of the recurring job; other instances of the recurring job will be empty and you'll need to add assets to them.
If you've locked any assets, you can automatically unlock them by selecting Unlock assets locked by you automatically after publishing. If you don't want to unlock assets after publishing, make sure to clear this option.
If necessary, select a publishing channel. Assets can be pretargeted to a particular channel, making it easy for you to publish them using that channel, or you can select an alternative channel to use for the asset.
If you need to select a different channel click Selected, select one or more channels.

The channel selection can't be changed after the job is created. If you select Targeted, channels will be targeted based on the assets in the job.
Oracle Content Management will automatically validate the assets as part of the publishing process by comparing the assets to the approval and localization policies of the channel. If you'd prefer to see a validation report prior to publishing, click Pre-Validate. Please note that generating the validation report may take a long time.
When you're ready to publish, click Publish (if you selected to publish now) or Schedule (if you selected to publish later).
Oracle Content Management validates the assets by comparing the assets to the approval and localization policies of the channel. If all assets are ready, Oracle Content Management publishes them. The status is shown in the banner.
If any errors occur during publishing, the status shown in the banner includes a link to View Validation.
The validation results list the status of the selected assets, any associated translations, and any dependent assets, showing whether the assets adhere to the approval and localization policies that were set for the channel. You must correct any issues before attempting to publish again. For example, if another version of the asset is already scheduled for publishing, you must schedule publishing for a date later than the previously scheduled publishing.

You can perform the following actions:
- You can filter the results by channel or by status.
- To view an asset in a slide-out panel without leaving the Validation Results page, click next to the asset.
- To remove an asset from publishing, click the X next to the asset.

If you scheduled your assets to publish later, the asset versions are reserved for publishing, allowing you to work on new versions as necessary. You can view the calendar of publishing jobs on the Scheduled Publishing page.

You can view the history of all publishing jobs on the Publishing Jobs page.

Create an Empty Recurring Publishing Job

You might want to create an empty recurring job. For example, maybe you want a job that runs every Monday to publish new content your contributors have produced. You could create an empty job and add your contributors as managers of the job so they can add their content.

To create an empty recurring job:

On the Assets page, click More Actions in the banner menu, then select Scheduled Publishing.
Click Schedule Job.
Enter a name for the publishing job so you can easily find it on the publishing calendar. You might want to also include a description so others know the purpose of this recurring job.
Select when you want to start publishing.
Choose the frequency in the Recurrence drop-down list. The recurrence schedule can't be changed after the job is created.
Select an end date.
If necessary, select a publishing channel. Assets can be pretargeted to a particular channel, making it easy for you to publish them using that channel, or you can select an alternative channel to use for the asset.
If you need to select a different channel click Selected, select one or more channels.

The channel selection can't be changed after the job is created. If you select Targeted, channels will be targeted based on the assets in the job.
Optionally, add assets to the first instance of the job by clicking Add Assets, selecting the assets, and then clicking Validate.
When you're done, click Schedule.

Manage Scheduled Publishing Jobs

When you schedule assets for publishing, a publishing job is created. You can then view the publishing schedule, and edit or cancel pending jobs.

To see the publishing schedule, on the Assets page, click More Actions in the banner menu, then select Scheduled Publishing. The Scheduled Publishing page shows a calendar of all publishing jobs and their status:

(Scheduled) - The one-time publishing job hasn't started yet.
(Recurring) - The recurring publishing job hasn't started yet.
(In Progress) - The publishing job is in progress.
(Completed) - The publishing job completed successfully.
(Canceled) - The publishing job was canceled.
(Failed) - The publishing job failed. You should have seen a failure message above the banner about why the job failed, but you can also see it by clicking the job. Correct the problem, then reschedule the job.

You can perform the following tasks:

Task	Description
View job details	To view a publishing job, click it, then click Open. The details include the job name and description; the scheduled publishing date and time; if it's a recurring job, the frequency and end date; when the job was last updated and who updated it; and the validation details. To view an asset in a slide-out panel without leaving the job details page, click next to the asset. Additional information is included in the job properties. If the properties aren't already displayed, click View Properties or . The properties enable you to edit the job name and description; for recurring jobs, this affects the whole series. The properties also include when the job was created and who created it; when the job was last updated and who updated it; when the job will start; the end date for recurring jobs; and the frequency for recurring jobs.
Add managers to a job	To add users you want to be able to manage the job, click Open, then click Add Managers. If you add managers to a recurring job, they will be added to all instances of the job
Update the assets to the latest versions	If any of the assets included in the job have newer versions, you can update the job to include the latest versions by clicking Update Versions. You can see each asset's version number in the list of included assets.
Edit a pending job (including adding assets)	To edit a pending publishing job, click it, click Open, then click Edit Job. For one-time jobs, you can change the job name and add or remove assets. For recurring jobs, you can change the description for this instance of the job or add or remove assets. To change the name or description of the whole job series, view the job properties. Note: When the publishing job finishes, Oracle Content Management will send an email to all of the job's managers with the status of the job.
Cancel a scheduled job	To cancel a job, click it, then click Cancel Job. If it's a recurring job, you can cancel all recurrences or just the one you opened.
Copy a completed job	Top copy a completed job, click it, click Open, then click Copy.
Filter or search for the jobs shown in the calendar	If necessary, click to show the filter pane. Search for a job name or description, then click a result to see the job in the calendar. Filter the jobs by job status, hide weekends, or show only jobs you've scheduled.
Change the calendar view	Change the view of the calendar to day, week, or month, using the buttons at the top right of the calendar.
Jump to a particular date	Jump to a particular date by clicking a day in the date picker in the filter pane.
Create an empty recurring job	You might want to create an empty recurring job. For example, maybe you want a job that runs every Monday to publish new content your contributors have produced. You could create an empty job and add your contributors as managers of the job, so they can add their content. To create an empty recurring job, click Schedule Job.

You can view the history of all publishing jobs on the Publishing Jobs page.

View Publishing Jobs History and Logs

You can view the history and details of all past asset publishing jobs.

To see the publishing event logs, on the Assets page, click More Actions in the banner menu, then select Publishing Jobs.

To filter the list by job type, select an option in the first drop-down list. You can view all, completed, failed, publish now, publish later, and publish HTML jobs.

By default, you see 50 jobs per page. To change this, select a new value in the second drop-down list.

The following information is available for each publishing job:

Task	Description
Name	The name of the publishing job. Non-scheduled jobs are named "Publishing Job" followed by the date of the job. An icon representing the type of job appears before the name: Publish now job Scheduled job Rendition (publish HTML) job
Status	(Published) - The publishing job completed successfully. (Failed) - The publishing job failed.
Published	The date and time of the publishing job.
Published By	The user who initiated the publishing job.
Publish Log	Click to download a JSON log of the publishing job.
Rendition Log	Click to download a JSON log of the renditions (published HTML) created by the publishing job.

To view additional information about a job, select it, and then click . The Properties pane shows information such as the job description and publishing channel.

Access Published Digital Assets Through a URL

Published digital assets are also accessible using the shorter URL path https://your-domain/content/assets/ (for example, https://instanceName-accountName.cec.ocp.oraclecloud.com/content/assets/). This path is open for search bots to crawl the assets. Use this path to access the digital asset's file content if you want your digital assets, such as PDF files, to be indexed by search engines.