Using ADOBE SCENE7 ®

Using
ADOBE® SCENE7®
Legal notices
Legal notices
For legal notices, see http://helpx.adobe.com/legal/legal-notices.html.
Last updated 10/9/2014
iii
Contents
Chapter 1: Introducing Adobe Scene7
What’s new . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
System requirements
.................................................................................................. 1
Adobe Scene7 Publishing System desktop applications
Using Help
Support
................................................................. 2
............................................................................................................ 2
............................................................................................................... 2
Help for Scene7 Media Portal
Adobe Training Services
Developer resources
.......................................................................................... 4
............................................................................................... 4
................................................................................................... 4
Chapter 2: Getting started
Adobe Scene7 platform overview
...................................................................................... 7
Using Scene7 Publishing System desktop version
Media Portal
...................................................................... 9
.......................................................................................................... 9
Signing in and out
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Navigation basics
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Setup basics
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
About rich media
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Chapter 3: Setup
Personal Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Application Setup
Publish Setup
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Video SEO (Search Engine Optimization)
Administration Setup
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Chapter 4: Media Portal
System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Quick Start: Media Portal administration
Media Portal user roles
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Creating and managing Media Portal groups
Adding and managing Media Portal users
Managing FTP accounts
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Specifying export options available to Media Portal users
Creating and enabling Image Presets
Making more efficient use of metadata
Customizing the Media Portal screen
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Chapter 5: Upload and publish assets
Uploading files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Publishing files
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Testing assets before making them public
Checking job files
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Last updated 10/9/2014
iv
USING SCENE7
Contents
Chapter 6: Managing assets
Working with asset folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Viewing assets in the Browse Panel
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Selecting assets in the Browse Panel
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Searching assets
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Previewing an asset
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Moving, renaming, and deleting assets
Working in Detail view
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Viewing, adding, and exporting metadata
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Exporting assets from Scene7 Publishing System
Sharing asset changes with peers in real time
Printing assets
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Managing the Trash folder
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Organizing your work with Projects
Chapter 7: Image Sizing
Quick Start: Image Sizing
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Uploading master images
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Setting up Image Presets
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Publishing master images
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Linking URLs to your web application
Chapter 8: Zoom
Quick Start: Zoom
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Uploading zoom images
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Creating zoom targets for Guided Zoom
Setting up Zoom Viewer Presets
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Previewing image assets with different Zoom Viewers
Publishing zoom images
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Linking Zoom viewers to your web pages
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Chapter 9: eCatalogs
Quick Start: eCatalog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Uploading the PDF files
Creating an eCatalog
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
Creating eCatalog Image Maps
Managing Info Panel content
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Setting up eCatalog Viewer Presets
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Previewing eCatalogs in the eCatalog Viewer
Publishing eCatalogs
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Linking an eCatalog to a web page
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Chapter 10: Image Sets
Quick Start: Image Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Preparing Image Set assets for upload
Creating an Image Set
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Including zoom targets and Image Maps in Image Sets
Managing info panel content
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
Last updated 10/9/2014
v
USING SCENE7
Contents
Viewing Image Sets
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
Automated Image Set generation
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Linking an Image Set to a web page
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Chapter 11: Swatch Sets
Quick Start: Swatch Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Preparing Swatch Set assets for upload
Creating a Swatch Set
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
Including zoom targets and Image Maps in Swatch Sets
Viewing Swatch Sets
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
Linking a Swatch Set to a web page
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
Chapter 12: Spin Sets
Quick Start: Spin Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Creating a Spin Set
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
Setting up Spin Set Viewer Presets
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Previewing a Spin Set
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Publishing a Spin Set
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
Linking a Spin Set to a web page
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
Chapter 13: Template Basics
Quick Start: Template Basics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
Uploading template files
Creating a template
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
Creating template parameters
Publishing templates
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
Linking a template to a web page
Managing content variations
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
Chapter 14: Template Publishing
Quick Start: Template Publishing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
Create the initial template in Illustrator
Upload files for Template Publishing
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
Defining variability: Parameterization versus DOM manipulation
Parameterizing a template in Scene7
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
Preview and update template attributes
DOM manipulation
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
Linking an FXG template to a web page
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
Creating a PDF document
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
Chapter 15: Video
Working with HTML5 video
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
Best practice: Using the HTML5 Video viewer
Quick Start: Video
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Uploading and encoding videos
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
Previewing videos in a video viewer
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
Deploying video to your websites and mobile sites
Adding captions to video
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
Last updated 10/9/2014
vi
USING SCENE7
Contents
Adding chapter markers to video
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
Exporting source and encoded videos
Using the Universal URL
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Chapter 16: Video Recuts
Quick Start: Video Recuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
Video Presets
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
Uploading and transcoding video for Video Recuts
Thumbnails for Video Recuts
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
Setting up Viewer Presets for Video Recuts
Creating Video Recuts
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
Create a Video Recut Template
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
Creating information panels for Video Recuts
Previewing Video Recuts in a Viewer
Publishing a Video Recut
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
Deploying a Video Recut on your web site
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
Chapter 17: Mixed Media Sets
Quick Start: Mixed Media Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
Creating a Mixed Media Set
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
Setting up a Mixed Media Set Viewer Preset
Publishing a Mixed Media Set
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
Linking a Mixed Media Set to a web page
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
Chapter 18: Adobe Analytics Instrumentation Kit
Enabling Adobe Analytics Video Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
Quick Start: Integrating Scene7 and Adobe Analytics
Log in to Adobe Analytics
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Configuring Adobe Analytics reports
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Publishing Adobe Analytics configuration information
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Instrumenting a viewer using the Adobe Analytics Instrumentation Kit
Testing the integration by viewing an Adobe Analytics report
Disabling Adobe Analytics tracking
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
Chapter 19: Test&Target integration
Quick Start: Test&Target integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
Integrating Scene7 with Test&Target
Creating an offer set
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
Pushing offer sets to Test&Target
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
Chapter 20: User-generated content
Uploading an image asset or a vector asset
Deleting an uploaded asset
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
Getting disk usage information
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
Chapter 21: Master files
Best practices for optimizing the quality of your images
Editing images
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
Last updated 10/9/2014
vii
USING SCENE7
Contents
Creating Image Maps
Cropping an image
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
Sharpening an image
Adjusting an image
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
Image editing options at upload
Working with PDFs
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
Working with PSD files
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310
Working with PostScript and Illustrator files
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
Working with vignette, window covering, and cabinet files
Working with Viewer SWF files
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
Chapter 22: Support files
Fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
ICC profiles
XML files
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
Last updated 10/9/2014
1
Chapter 1: Introducing Adobe Scene7
Welcome to Adobe® Scene7®, the leading on-demand cross-media publishing system for uploading, managing,
enhancing, and publishing dynamic rich content to all devices and screens. Adobe Scene7 solutions include the
following:
• Dynamic Imaging: Real-time editing, formatting and sizing, interactive zoom and pan; color swatching and texture
swatching; 360-degree spin; image templates; multimedia viewers.
• eCatalogs: Author, hotspot linking, publish and deliver dynamically served online catalogs into configurable
viewers.
• Media Portal: Self-serve environment providing portal users with administrator-controlled “views” into Scene7
assets for easy access to upload, browse, search, preview, and export of assets.
• eVideo: Upload final videos in any format, automatically transcode and standardize to Flash formats, manage, edit,
create hot spots and video templates, publish and stream into configurable video viewers
• Visual Configurators: Real-time rendering technology to enable online visual configuration for personalization and
customization effects such as real-time rendering of colors textures, surfaces, patterns, monograms, and engravings
into product images or scenes.
• Web-to-Print: Real-time composition technology and framework to enable custom web-to-print solutions for
creating customized and personalized documents.
• Target email and print: Deliver visually targeted, personalized email campaigns tied to customer profile, product,
and channel databases.
What’s new
To review the latest Adobe Scene7 release information, including new features, enhancements, and fixes, see the
Scene7 Release Notes.
System requirements
For the best experience using Scene7 Publishing System, make sure that your system meets the following system
requirements and recommendations:
• Microsoft® Windows® 7 or later or Mac OS X 10.6 or higher Macintosh® Intel processor required.
• 3 GB RAM or higher required (4 GB or higher recommended).
• Color monitor.
• Video card supporting True Color at 1280x1024 resolution or higher.
• JAVA-enabled browser, Flash 11 or higher.
• Windows-supported browsers: Internet Explorer 9.0 or higher; Firefox 23 or higher.
• Macintosh-supported browsers: Safari 6.0 or higher, Firefox™ 23 or higher.
Note: If your browser does not have Flash Player version 11, you can download it from Adobe at
www.adobe.com/go/learn_sc7_flashplayer_en.
Last updated 10/9/2014
2
USING SCENE7
Introducing Adobe Scene7
Adobe Scene7 Publishing System desktop applications
The Adobe Scene7 Publishing System desktop application is an Adobe AIR® application that lets you run SPS and
Media Portal from your desktop without a web browser. You can use the SPS desktop application to upload files and
folders from your desktop.
Using Help
Adobe Scene7 offers the Help program and onscreen Help.
Help program
The Scene7 Help system is designed to direct you to information for completing all tasks. To access Help in the Scene7
Publishing System, choose Help > Help on This Topic. The Help system opens to a page that explains the Scene7 screen
you are currently viewing. Choose Help > Help Contents to open the Help program to its table of contents.
To use the Help program:
Contents search Click the Plus icon next to content titles and subtitles to find information. You can click the Minus
icon to collapse subtitles.
Search by keyword Enter a search term in the Search box. You see a list of pages from the Help system with the word
you entered. Select a page to open it.
Hypertext link cross-references Throughout the Help system are many hypertext link cross-references. Select a
hypertext link to open the Help program to a page with more information or background information about the task
you want to do.
For information about getting technical support from Scene7, choose Help > Support.
Onscreen Help
Scene7 offers onscreen Help:
Tool tips You see a tool tip when you move the cursor over buttons, menus, and navigation links. Tool tips tell you the
names of these onscreen items so you can identify them quickly.
Onscreen instructions Some screens present getting-started instructions in the form of a text overlay that explains how
to accomplish a task. In addition, some screens also offer these icons:
• Instructions icon Click the Info Tip icon
icon to read brief task instructions.
• Question Mark icon Click the Question Mark icon
next to specific buttons or controls to get an explanation of
a button or control.
Support
Technical support offerings are designed to meet the needs of any size company. This table describes Scene7 tech
support offerings:
Last updated 10/9/2014
3
USING SCENE7
Introducing Adobe Scene7
Support
Trial version
Subscription
Case limit
2 per month
Unlimited
Response time
2 business days
4 business hours
Free live web training and
video tutorials
Included
Included
E-mail support
s7trialsupport@adobe.com
US/Canada:
s7support@adobe.com
Japan:
s7support_jp@adobe.com
EMEA:
s7intsupport@adobe.com
Live telephone support
Not available
US/Canada:
(800) 898-9743 or (408) 454-5910, Monday-Friday,
06:00-18:00 (PT)
Japan:
+81-3-6743-9632, Monday-Friday, 9:00 AM to 5:00 PM
(Standard hours)
Europe:
+44 (0)20 35641782, Monday-Friday, 09:00-18:00
(UTC/GMT)
Germany:
+49 (0)69 51709005, Monday-Friday, 10:00-19:00
(CET)
France:
+33 157324085, Monday-Friday, 10:00-19:00 (CET)
Netherlands:
+31 (0)20 2035138, Monday-Friday, 10:00-19:00 (CET)
When reporting issues to Technical Support, include this information:
• Company name
• Your name, phone number, and e-mail address
• Scene7 application, platform, and version
• Issue description and the steps necessary to reproduce the problem
• Error message (if any)
• Browser type and version (if applicable)
• Adobe® Flash® Player version (if applicable)
Last updated 10/9/2014
4
USING SCENE7
Introducing Adobe Scene7
Help for Scene7 Media Portal
The following Help document is also available from Scene7:
Using Scene7 Media Portal Adobe Scene7 Media Portal is a browser-based environment providing portal users easy
access to upload, browse, search, preview, and export assets in corporate-approved formats. See
www.adobe.com/go/learn_sc7_mediaportalusing_en.
Adobe Training Services
Scene7 offers training in the form of video tutorials, instructor-led workshops and web sessions, and demos.
Adobe Training Services
Adobe Training Services provides in-depth, customized classroom training designed for your organization. Training
can take the form of regional university-style classes, web-based sessions, or custom onsite workshops. Regional classes
are open to all customers and held periodically at various locations across North America and EMEA. Custom sessions
can be tailored for beginning to advanced users, end users, administrators, and IT staff.
See Adobe Training Services.
Quick Start Video Tutorials
Learn about Media Portal, dynamic imaging, eCatalogs, eVideos, Web to Print, and many other subjects pertaining to
understanding and using Scene7 Publishing System.
See Quick Start Video Tutorials.
Demos
Watch demonstrations of Scene7 features.
See Demos.
Getting Started chapter of Help
The Getting Started section of the Help system presents instructions for users who are new to Scene7. It explains the
basics of the platform, navigation, setup, asset management, and building rich media.
See “Getting started” on page 7.
Developer resources
Scene7 provides documentation for the latest major version of each Scene7 software module. Module documents are
available for Scene7 Image Authoring, the Scene7 Publishing System, Image Server, Render Server, Viewers, and Webto-Print.
Release notes are also available for some modules. Release notes provide details on the release, including
enhancements, new functionality, tips, troubleshooting advice, and known outstanding issues. Release notes also offer
interactive examples of rich-media features and how to activate them. In addition, Release Notes offer installation and
configuration instructions for clients with licensed software.
Last updated 10/9/2014
5
USING SCENE7
Introducing Adobe Scene7
Reference Guides to the Image Server, Render Server, and Viewers describe the http protocols for these server
modules. Web site developers who want to further customize and leverage Scene7 rich media for a web site or custom
application can use these guides. Scene7 assumes that the reader is familiar with the Scene7 system, general http
protocol standards and conventions, and basic imaging terminology.
Scene7 Publishing System API
Document
Web address
API Reference Guide
Contact Scene7 technical support for documentation.
Image Authoring
Document
Web address
User Guide
Contact Scene7 technical support for this documentation.
Release Notes
Contact Scene7 technical support for this documentation.
Image Serving and Image Rendering
Document
Web address
API Reference Guide
https://marketing.adobe.com/resources/help/en_US/s7/is_ir_api/index.html
Viewers
Document
Web address
Viewers Reference Guide and
Release Notes
https://marketing.adobe.com/resources/help/en_US/s7/viewers_ref/index.html
Viewer Library Examples
https://marketing.adobe.com/resources/help/en_US/s7/vlist/vlist.html
Adobe Scene7 Viewer SDK for Adobe www.adobe.com/go/learn/learn_s7_devresources_en
Flash
Adobe Scene7 HTML5 Viewer SDK
www.adobe.com/go/learn/learn_s7_devresources_en
Web-to-Print
Document
Web address
Reference Guide
www.adobe.com/go/learn_s7_webtoprint_en
Solution Accelerator SDK
www.adobe.com/go/learn/learn_s7_devresources_en
Accessing SDKs through Adobe Developer Connection
To download and install the SDKs, you must register with Adobe Developer Connection.
1 In your Web browser, go to Adobe Developer Connection at https://marketing.adobe.com/developer/en_US.
2 On the Developer Connection Home page, near the upper-right corner, click Register.
3 In the Register dialog box, enter your username, email address, and then agree to the Terms and Conditions.
4 Click Create New Account.
You are sent a Welcome email.
Last updated 10/9/2014
6
USING SCENE7
Introducing Adobe Scene7
5 To activate your account and set your password, in the email, click Click to change password.
6 Set your password, and then click Save.
7 In the upper-right corner of the Developer Connection page, click Dev Center.
(https://marketing.adobe.com/developer/en_US/devcenter).
8 In the left navigation area, click Scene7.
9 Follow the on-screen instructions to download and install the SDK that you want.
Last updated 10/9/2014
7
Chapter 2: Getting started
Adobe® Scene7® lets you upload media assets to the Scene7 Publishing System (SPS), build rich media, and publish your
work to Scene7 Image Servers. You can upload many different types of assets such as images, PDFs, PSD files, videos,
graphics, and fonts. As part of the publishing process, Scene7 generates the URLs you need for your web sites, mobile
devices, and applications.
Rich media tools include image sizing, eCatalogs, Image Sets, Spin Sets, Swatch Sets, Mixed Media Sets, basic
Templates, FXG Templates, and Video Recuts.
Adobe Scene7 platform overview
Scene7 is an integrated, rich media management, publishing, and serving environment. Rich media can be delivered
to all marketing and selling channels, including the web, print material, e-mail campaigns, web portals, desktops, and
devices.
Workflow process
The key Scene7 workflow steps are:
Upload and manage your assets Upload your media assets to SPS. You can organize, browse, and search for assets on
the system. You can also apply metadata to assets. If you install Adobe Scene7 Publishing System desktop application,
you can upload files and folders by dragging them from your desktop to an upload folder.
Create rich media Create different configurations of your assets such as eCatalogs, Image Sets, Spin Sets, Swatch Sets,
Mixed Media Sets, basic Templates, FXG Templates, and Video Recuts. For more information, see “About rich media”
on page 13.
Publish and administer Publish assets to the Scene7 Saas network, as well as monitor the status of assets when they are
published, administer user rights, and maintain security.
Serve Deliver media from Scene7 SaaS network to web pages, applications, and mobile devices; the media are
performance-optimized and are delivered with CDN caching. Scene7 provides you with a URL for each asset. After
you publish the asset, the URL becomes active.
Last updated 10/9/2014
8
USING SCENE7
Getting started
CREATE
AUTHOR
DELIVER
Master Assets
(Images, Videos, Audio)
Web
Scene7 Publishing System
Adobe Creative Suite
(Graphics, Layouts, Skins, PDFs, etc.)
Upload,
Download
Dynamic Imaging
eCatalogs
Media Portal
eVideos
Dynamic Banners
Print
Add-ons:
Web-to-Print
Email & Print
Visual Configurators
eMail
MS Office
API & SDKs (UGC, WTP)
Desktop
Servers (IS, RS, FMS, TS, IDS)
Other
(Fonts, ICC, XML, Scene7 VNT, FXG, Zip)
SaaS Infrastructure
(Storage, Bandwidth, CDN, Analytics)
Devices
The Scene7 workflow process.
Single master images and single URL calls
Scene7 is fundamentally different from other systems because you can use Scene7 to deliver media dynamically from
single master assets and URL calls.
The URL strings you generate with Scene7 include instructions that tell the server how to display the asset when it is
delivered. For example, the same master image can be delivered in different sizes, formats, weights, colors, and zoom
views. As part of building and publishing media assets with Scene7, you visually configure the effects. In so doing, you
create the URL calls that correctly tell the server how to present your master asset to applications.
eMail
Scene7 can deliver the same master image to different mediums in different sizes and formats.
Last updated 10/9/2014
9
USING SCENE7
Getting started
Content caching
The images that Scene7 generates dynamically are cache-friendly; in most cases, they are JPEG images with unique
URL calls that identify them. The images are delivered on the content delivery network (CDN), a system of servers that
are networked together on the Internet to deliver content faster. The images are distributed from servers located
globally, and then to computers. When implementing a caching mechanism using any CDN vendor, you simply
change the server name to point to the CDN-enabled Scene7 Image Server. All Scene7 editions include bundled CDN
caching.
Using Scene7 Publishing System desktop version
Scene7 Publishing System is available in a desktop application to streamline the uploading of assets into the web-based
Scene7 Publishing platform. The desktop version includes all of the features in the web version. It also includes the
ability to upload files and folders by dragging them directly from the desktop.
System requirements
For the best experience using Scene7 desktop, make sure that your system meets the following system requirements
and recommendations:
• Microsoft® Windows® 7 or later; Mac OS X 10.6 or higher with Macintosh® Intel processor required.
• 3 GB RAM or higher required ( 4 GB or higher recommended).
• Minimum Resolution 1000 X 640 – (1024 X 768 or higher recommended.)
• Adobe AIR 15.0 or higher required.
Installing Scene7 Publishing System desktop version
1 In Scene7 Publishing System, click Setup > Personal Setup.
2 On the Personal Setup page, under Desktop Version, do one of the following: or
• Click Install Now.
• If you have previously installed the desktop version, click Reinstall Now
Media Portal
Adobe Media Portal provides companies with the ability to easily acquire, control, and distribute approved creative
assets to external partners and channels, as well as internal business users. This browser-based, “self-serve”
environment provides portal users with administrator-controlled “views” into Scene7 assets for easy access to upload,
browse, search, preview, and export assets in corporate-approved formats.
For more information about Media Portal including system requirements, see
www.adobe.com/go/learn_sc7_mediaportalusing_en.
For information about administering Media Portal, see “Quick Start: Media Portal administration” on page 68.
Last updated 10/9/2014
10
USING SCENE7
Getting started
Signing in and out
Upload, building, and publishing with the Scene7 Publishing System requires meeting certain user prerequisites and
system requirements. You identify yourself to SPS by signing in. When you have finished using Scene7, sign out.
Make sure that you have the following before using Scene7:
Setup You must have been set up to use Scene7 by your administrator.
URL You must have the URL location for accessing Scene7. You get this URL via the “Welcome” e-mail or from your
Scene7 administrator.
Login name You use your e-mail address as your login name.
Password You obtain your temporary password in a “Welcome” e-mail from Scene7 or from your Scene7
administrator. The first time you sign in, you are prompted to change this temporary password.
Sign in
The Welcome e-mail you received from your administrator provides you with the sign-in URL, your username, and a
temporary password.
1 Start your web browser.
2 Go to the Scene7 sign-in URL (from the Welcome e-mail). Alternatively, you can sign in from the Scene7 web site
(www.adobe.com/products/scene7.html) by selecting the Client Login button.
3 Enter your e-mail address in the User Name box.
4 Enter your password in the Password box.
5 Optionally, you can make your computer remember your e-mail address by selecting the Remember My User
Name option.
6 Click Sign In.
More Help topics
“Personal Setup” on page 15
Sign out
• Click Sign Out, located on the right side of the Global Navigation bar.
• Exit your browser.
Important: Because SPS is web-based, going to a different web site exits the system. For example, if you click the Back
button in your browser window, you exit Scene7.
Navigation basics
The Scene7 Publishing System screen includes three major areas: Global Navigation bar, Asset Library, and Browse
Panel/Build Panel.
Last updated 10/9/2014
11
USING SCENE7
Getting started
Main Scene7 areas.
A. Global Navigation bar B. Asset Library C. Filters tab D. Browse Panel E. Media Cart (Media Portal only)
Global Navigation bar
The Global Navigation bar, located along the top of the screen, offers buttons for performing different tasks:
Select Company Choose the company you want to access from the menu. This button isn’t available if you’re working
with one company.
Upload Opens the Upload screen so you can upload files from your computer or network to SPS. You can upload files
from your desktop or via FTP. See “Uploading files” on page 79.
Build Choose a Build task from the menu. The Build panel opens so you can create an asset type.
Publish Opens the Publish screen so you can publish rich media assets to Scene7 Image Servers and the rest of the
Scene7 SAAS Infrastructure. See “Publishing files” on page 87.
Jobs Opens the Jobs screen so you can examine records of upload and publish jobs.
Recent Opens the Recent Activity screen so you can view the names of recently modified assets and recent upload and
publish jobs.
Setup Opens the Setup screen so you can choose setup or administration options for optimizing your use of Scene7.
See “Setup” on page 15.
Help Choose a Help option:
• Help > Help On This Topic Opens the Help system to a page with information about the task you are currently
doing.
• Help > Video Tutorial Accesses videos on specific topics to demonstrate how to get started with each rich media
publishing workflow.
• Help > Help Contents Opens the Help system to the Introduction page. You can click through the Table of
Contents to find and view different topics.
Last updated 10/9/2014
12
USING SCENE7
Getting started
• Help > About Tells you which version of Scene7 you are running.
• Help > Support Tells you how to get technical support from Scene7.
Sign Out Exits the Scene7 Publishing System.
Asset Library
Use the Asset Library to organize the assets you are working with. You can create folders and subfolders for organizing
your assets in the Asset Library.
At the top of the Asset Library panel are commands for locating assets. You can search for assets and filter to locate
assets. Click the Trash icon at the bottom of the Asset Library to examine assets you deleted.
You can click Asset Library controls to open or close the Asset Library and get more room to work onscreen. Select the
Expand/Collapse control to expand or close the panel. These controls are located on the left side of the panel.
More Help topics
“Managing assets” on page 97
Browse Panel/Build Panel
The Browse/Build Panel is where you do much of your work. What appears in this panel depends on whether you are
working in Browse mode or Build mode:
Browse mode Select a folder in the Asset Library to view and work with its contents in the Browse Panel. This panel
offers the File, Preview, Select All, Select None, and Sort menus for working with assets. You can also view assets in
, List View
, or Detail View
button.
different ways by moving the slider or selecting the Grid View
Selecting the Detail View button or double-clicking an asset opens the asset in Detail view, where you can perform
asset-dependent file operations.
Build mode Click the Build button and choose an option to start building an eCatalog, Image Set, Spin Set, or one of
several other available items on the Build menu. The Build screen opens. You can select the assets you want to work
with before or after you enter Build mode.
More Help topics
“Managing assets” on page 97
“Viewing assets in the Browse Panel” on page 98
“Selecting assets in the Browse Panel” on page 98
“Searching assets” on page 99
Setup basics
Use the Scene7 Publishing System Setup screen to enter your personal settings. If you are an administrator, set up your
company settings. To open a Setup screen, click the Setup button on the Global Navigation bar.
The settings available to you on this screen depend on your status as a user or administrator:
• Users can only access Personal settings and the accounts of companies of which they are a member; they cannot
perform any administrative tasks.
Last updated 10/9/2014
13
USING SCENE7
Getting started
• Administrators can access Personal settings, as well as view and administer their own company accounts. They can
also perform all application setup functions, and all administration functions, including adding administrators and
users.
Administrators can also set up Image Presets and Viewer Presets in the Setup screen:
Image Presets Image Presets are saved formats for displaying master images at different sizes and formats.
Viewer Presets Viewer Presets determine how you see your rich media when you see it in a viewer.
More Help topics
“Setup” on page 15
“User Administration” on page 62
“Image Presets” on page 23
“Viewer Presets” on page 32
About rich media
Scene7 offers many tools for creating rich media. You create these rich media types:
eCatalogs Present an interactive web version of your catalog or other print material. Create clickable areas (called
Image Maps) that show rollover content and allow customers to turn pages, zoom, pan, and attach sticky notes to
pages. See “Quick Start: eCatalog” on page 136.
eVideo Delivery high-quality video experiences to multiple screens, including desktops, mobile devices, and tablets.
Use predefined Scene7 encoding presets or customize encoding to control the quality and size of video. Organize,
browse, and search video with full metadata support for efficient management of video assets. See “Quick Start: Video”
on page 209.
Image Maps Dynamically serve images at any size and format throughout your web site. Instead of manually creating
many images at different sizes, you only use one master image. As Scene7 delivers the requested image, it optimizes
the image for highest-quality results in size, format, weight, quality, and sharpening. See “Quick Start: Image Sizing”
on page 119.
Image Sets Deliver an interactive shopping experience in which users can view products in multiple views. You can
combine zoom, multiple views, and color swatches for an integrated viewing experience. See “Quick Start: Image Sets”
on page 151.
Mixed Media Sets Provide a mix of image sets, spin sets, swatch sets, zoom targets, video, and audio in one
presentation. You can set up Mixed Media sets with tabs to separate video from images. You can also specify where
and how to display swatches and zoom targets and give users a full multimedia view of your products or services. See
“Quick Start: Mixed Media Sets” on page 255.
Spin Sets Sequence images to spin them horizontally. Spin Sets allow visitors to your web site to turn products and
view them from different sides. You can create one-dimensional and two-dimensional Spin Sets. See “Quick Start: Spin
Sets” on page 167.
Swatch Sets Deliver an interactive shopping experience in which users can view products in different colors and
patterns. You can combine zoom, multiple views, and color swatches for an integrated viewing experience. See “Swatch
Sets” on page 160.
Template Basics Create data-driven templates that combine fonts, images, and graphics for monogramming, online
personalization, and promotions. For example, layer sale or other promotional graphics onto product images or place
Last updated 10/9/2014
14
USING SCENE7
Getting started
the names of customers on T-shirts or coffee mugs. Customers can see their names in e-mail messages or print
brochures you send to them. See “Quick Start: Template Basics” on page 175.
Template Publishing Create professionally branded print content that is easy for your customers, clients, and staff to
customize and personalize. You can maintain corporate content and brand identity throughout the publishing
process. End users can customize the print content — but only the part of the content that you allow them to
customize. Personalized stationary, business cards, posters, greeting cards, labels, checks, gifts, clothing, calendars,
scrapbooks, and photo albums are examples of customized print products that you can deliver. Corporations can
maintain a common brand identity in their signage that can be customized for different regions, franchises, stores, and
branch offices. See “Quick Start: Template Publishing” on page 188.
Video Recuts Combine video clips, audio, photos, graphics, text, and transitions in the easy-to-use Video Recut
window. Create Video Recuts to easily enhance your video to highlight features and targeted promotions. See “Quick
Start: Video Recuts” on page 234.
Zoom Targets Allow customers to zoom in, zoom out, and pan images using the configurable viewers that come with
Scene7. Customers can quickly and interactively view high-resolution product details. See “Quick Start: Zoom” on
page 126.
Last updated 10/9/2014
15
Chapter 3: Setup
Adobe® Scene7 offers the Setup screens so you can customize Scene7 for your company and administer users:
• Open the Personal Setup screen to change personal settings, such as your Browse Panel settings and your password.
See “Personal Setup” on page 15.
• Open the Application Setup screens to enter general application settings, create Image Presets, Video Presets,
Viewer Presets, and define metadata.
See “Application Setup” on page 20.
• Open the Administration Setup screens to administer users and access usage reports.
See “Administration Setup” on page 62.
• Open the Media Portal screens to administer Media Portal.
See “Media Portal” on page 68.
To open the Setup screens, on the Global Navigation bar, click Setup, and then choose the type of settings you want.
In the Setup screen, you can display different Setup options by clicking the expand/collapse controls.
Important: All users can change settings on the Personal Setup screen, but the Application Setup and Administration
Setup screens are reserved for administrators.
Personal Setup
All users can change settings on the Personal Setup screen. To open the Personal Setup screen, click Setup > Personal
Setup.
Note: The Personal Setup screen lists which user role you have in the Scene7 Publishing System: Company Administrator,
Administrator, or User.
The Personal Setup settings control the default behavior of the Browse Panel, how you receive e-mail, and password
settings. Remember to click Save after you change these settings.
My Account Information
Identifies your account name, name, user name (e-mail address), and assigned user role.
Desktop Version
Click Install Now to install the desktop version of Scene7 Publishing System on your local hard drive. Or, click
Reinstall Now to install the desktop version again.
Illustator Plug-in for Web-to-Print
On computers running Windows 7 or 8, you must have administrator privileges and log on as an administrator in
Windows to install the Adobe Illustrator Plug-in for Web-to-Print. After you install the plug-in, it is available in Adobe
Illustrator.
The plug-in is supported for the following Adobe Illustrator versions:
• Adobe Illustrator 18 in Adobe Creative Cloud 2014.
Last updated 10/9/2014
16
USING SCENE7
Setup
• Adobe Illustrator 17 in Adobe Creative Cloud.
• Adobe Illustrator 16 in Adobe Creative Suite 6.
Supported Adobe Illustrator platforms include the following:
• Apple Mac OS X 10.7 or greater.
• Windows 8, 32-bit and 64-bit.
• Windows 7, 32-bit and 64-bit.
• Windows XP, 32-bit and 64-bit (for Adobe Illustrator 16 in Adobe Creative Suite 6 only).
See also “Template Publishing” on page 188.
To install the plug-in on your local hard drive
1 On the Personal Setup page in Scene7 Publishing System, under Illustrator Plug-in for Web-to-Print, click
Download Now to download the Illustrator Plug-in for Web-to-Print.zip file.
2 Uncompress the ZIP file to a temporary folder.
A readme file is included at the root of the unzipped file to provide you with additional information about the plug-in.
3 Depending on your installed operating system, do one of the following:
• Windows
Last updated 10/9/2014
17
USING SCENE7
Setup
If you are
running
Do this
Adobe Illustrator
18 in Adobe
Creative Cloud
2014
1 From the root of the unzipped folder, click CC-2014.
2 Depending on the bit version of Adobe Illustrator that you are using,
click win32 or win64.
3 Click libraries > flame, and then copy aflame.dll to Adobe Illustrator's
executable folder. For example, C:\Program Files\Adobe\Adobe
Illustrator CC 2014\Support Files\Contents\Windows.
Note: This example path is for the 64-bit location; the 32-bit location may
fall under Program Files (x86) instead.
4 Return to the same libraries folder, click flamingo, and then copy
aflamingo.dll to the same Adobe Illustrator executable folder that you
used in the previous step.
5 Return to the win32 or win64 folder that you selected in step 2, and then
copy AdobeS7FXGFileFormat.aip to Adobe Illustrator's plug-ins folder.
For example, C:\Program Files\Adobe\Adobe Illustrator CC
2014\Plug-ins\Illustrator Formats.
Note: This example path is for the 64-bit location; the 32-bit location may
fall under Program Files (x86) instead.
Adobe Illustrator
17 in Adobe
Creative Cloud
1 From the root of the unzipped folder, click CC.
2 Depending on the bit version of Adobe Illustrator that you are using,
click win32 or win64.
3 Copy AdobeS7FXGFileFormat.aip to Adobe Illustrator's plug-ins
folder. For example, C:\Program Files\Adobe\Adobe Illustrator CC
(64 Bit)\Plug-ins\Illustrator Formats.
Note: This example path is for the 64-bit location; the 32-bit location may
fall under Program Files (x86) instead.
Adobe Illustrator
16 in Adobe
Creative Suite 6
1 From the root of the unzipped folder, click 6.0.
2 Depending on the bit version of Adobe Illustrator that you are using,
click win32 or win64.
3 Copy AdobeS7FXGFileFormat.aip to Adobe Illustrator's plug-ins
folder. For example, C:\Program Files\Adobe\Adobe Illustrator CS6
(64 Bit)\Plug-ins\Illustrator Formats.
Note: This example path is for the 64-bit location; the 32-bit location may
fall under Program Files (x86) instead.
• Mac
Last updated 10/9/2014
18
USING SCENE7
Setup
If you are running
Do this
Adobe Illustrator 18 in
Adobe Creative Cloud 2014
1 From the root of the unzipped folder, click CC-2014 >
mac64.
2 Click libraries > flame, and then copy the
aflame.framework folder to Adobe Illustrator package
contents folder. For example, /Applications/Adobe
Illustrator CC 2014/
Illustrator.app/Contents/Frameworks/.
(To open Adobe Illustrator’s package contents folder,
right-click on the Adobe illustrator CC 2014 icon and
click Show Package Contents from context menu)..
3 Return to the same libraries folder, click flamingo,
and then copy the aflamingo.framework folder to the
same Adobe Illustrator package contents folder that
you used in the previous step.
4 Return to the mac64 folder that you selected in step 1,
and then copy the AdobeS7FXGFileFormat.aip folder
to Adobe Illustrator’s plug-in folder. For example,
/Applications/Adobe Illustrator CC 2014/Plugins/Illustrator Formats/.
Adobe Illustrator 17 in
Adobe Creative Cloud
1 From the root of the unzipped folder, click CC >
mac64.
2 Copy the AdobeS7FXGFileFormat.aip folder to Adobe
Illustrator’s plug-in folder. For example,
/Applications/Adobe Illustrator CC/Plugins/Illustrator Formats/.
Adobe Illustrator 16 in
Adobe Creative Suite 6
1 From the root of the unzipped folder, click 6.0 >
mac64.
2 Copy the AdobeS7FXGFileFormat.aip folder to Adobe
Illustrator’s plug-in folder. For example,
/Applications/Adobe Illustrator CS6/Plugins/Illustrator Formats/.
The plug-in is now available for you to use in Adobe Illustrator.
Browser
Thumbnail Size Determines the default size of thumbnail images in Grid view in the Browse Panel.
Default Asset Library View Determines whether the assets in the Asset Library for build sets appear as thumbnails or
by name. If you are working with large quantities of assets in the Asset Library, you can view the assets by name. For
example, if you are building a large eCatalog with many PDF files, you can view the assets by name to make the list
shorter.
Default Browse Sort Order Determines the order in which assets appear by default in the Browse Panel. Choose a sort
criterion on the menu and whether you want an ascending or descending sort.
Last updated 10/9/2014
19
USING SCENE7
Setup
Default Browse Location Lets you set the browse location to the default, the last folder browsed, or to a specific
location that you navigate to and identify. You can also set the browse location to sort the files and folders in ascending
or descending order.
Default Browse View Determines whether Grid view or List view is the default view you see when you first open the
Browse Panel.
Splash Screen Display Determines whether you see any splash screens, including the Welcome splash screen.
Show ToolTips Determines whether tool tips appear when you move the pointer over buttons, menus, and navigation
links. Tool tips describe on-screen items.
Checkerboard Background Displays a checkerboard layer behind images, letting you easily see the transparent areas
of an image that has an alpha channel.
Show File Size Displays the file size of an asset when you are browsing.
Confirm When Leaving SPS Displays a confirmation window before you exit Scene7 Publishing System.
Include UDFs in Search Deselected (default) to improve system performance for most metadata searches that you run.
If most of your metadata searches benefit from including user-defined fields, you can select this option to turn it on.
As an alternative, use Advanced Search to give you a more directed and faster search experience than including userdefined fields.
See “Conducting an advanced search” on page 99.
See also “User-Defined Fields” on page 49.
Basic Search Type Choose a default search type, Contains or Starts With.
Show Media Portal Features Select this option to access Media Portal features, such as Media Cart.
Show Command Feedback Show command requests to the server.
Show Dialog During Export Displays a dialog box when you perform an export. If you deselect this option, you can still
go to the Jobs page to retrieve the results of your export.
Email
Email Options Choose how you want Scene7 to inform you by e-mail when upload and publish jobs are completed.
You can receive job completion notices only if warnings or errors occurred.
Email Scope Determines whether you receive all job e-mail for your company or only e-mail about upload and publish
jobs you initiate.
Email Types Determines whether you are informed when upload jobs and publish jobs are completed.
Language
Preferred Language Determines the language for the interface.
Password
New Password Enter a new password (it must be at least six characters long).
Re-Type Password Re-enter the new password to confirm that you are entering it correctly.
Password Expiration Determines whether your password expires after 72 days as a security measure. If you select Yes,
you are asked to create a new password after 72 days.
Last updated 10/9/2014
20
USING SCENE7
Setup
Application Setup
You can use the Application Setup pages to enter general settings, create image presets, video encoding presets, viewer
presets, or to define universal viewers, default viewers, and metadata. You can also setup batch set presets to automate
the generation of 2D spin sets (for example), publishing settings, and video SEO settings.
Important: Only Scene7 Publishing System administrators can change settings on the Application Setup pages.
General Settings
To open the Application General Settings page, on the Global Navigation bar, click Setup > Application Setup >
General Settings.
Servers
On account creation, Scene7 automatically provides the assigned servers for your company. These servers are used to
construct URL strings for your web site and applications. These URL calls are specific to your account.
See also “Testing the Secure Testing service” on page 92.
Published Server Name This server is the live CDN server used in all system-generated URL calls specific to your
account. Do not change this server name unless you are instructed to do so by a Scene7 support technician.
Origin Server Name This server is used for quality assurance testing only. Do not change this server name unless
instructed to do so by a Scene7 support technician.
AGM Server Name This server is used for Web-to-Print templates. This server is set on a company-wide basis. Do not
change this server name unless instructed to do so by a Scene7 support technician.
Test&Target Server Name Your Test&Target URL, up to and including .com. For instructions about obtaining this
URL, see “Integrating Scene7 with Test&Target” on page 273.
iOS Streaming Server Name The URL to your Scene7 iOS streaming server. This server delivers streaming video to
iOS-based devices using HTTP protocol.
RTMP Streaming Server Name The URL to your Scene7 RTMP (Real Time Messaging Protocol) streaming server. This
server delivers streaming video using RTMP protocol and Flash Media Server.
Progressive Video Server Name The URL to your Scene7 progressive video server. This server delivers progressive
video using HTTP protocol.
Show URL for Unpublished Assets Select this option if you want Scene7 to display a URL when previewing any asset,
whether it is published or not. If the asset is not published, the URL does not work. However, you can use the URL for
planning or organizational purposes.
Allow AIR Install Select this option to allow users to download Scene7 Publishing System desktop version to their local
hard drives. Users install the application from the Desktop Version area of the Personal Setup screen.
AIR users must manually uninstall their existing app and reinstall from the web version of Scene7 Publishing System
(in Personal Settings). After this one-time reinstallation, you are prompted to upgrade whenever the server has a newer
version of Scene7 Publishing System AIR. Scene7 Publishing System is integrated with the Application Update
Framework which streamlines the upgrade process.
CDN Invalidation Template Specifies the template that is used for invalidating the CDN (Content Delivery Network)
cache.
For example, suppose you enter an image URL (including image presets or modifiers) referencing <ID>, instead of a
specific image ID as in the following example:
Last updated 10/9/2014
21
USING SCENE7
Setup
http://sample.scene7.com/is/image/Company/<ID>?$s7product$
If the Template just contains <ID>, then SPS fills in the http://<server>/is/image, where <server> is the Publish
Server Name that is defined in General Settings.
Setting the CDN Invalidate Template, selecting an image named Backpack_B, and then clicking File > Invalidate
CDN results in the following generated URL in the CDN Invalidate interface:
http://sample.scene7.com/is/image/Company/Backpack_B?$s7product$
In the URL list box, click Continue to clear the cache for that specific image URL call. Note that you can also add URLs
by typing or pasting them into the URL list box; you do not need to set the Template beforehand.
After you have selected your CDN Invalidation Template, and made an Invalidate CDN request, an indicator will pop
up in the user interface that gives you an estimate of how long it will take to clear the cache.
Similarly, if multiple images are selected within SPS when you click File > Invalidate CDN, each image is referenced
in the saved Template URL. Therefore, you can define a CDN Invalidate Template referencing each URL that is
referenced on your Web site (such as product detail, search results, and so forth). Then, when you select one or images
for invalidation from cache, the URLs automatically populate the interface.
See “Content caching” on page 9.
See “Republished assets and CDN delays” on page 90.
Browse
Show Projects Determines whether Projects are available as a means of organizing your Scene7 assets. See “Organizing
your work with Projects” on page 117.
Show Sample eVideo Content Provides sample content for Video Recuts in the eVideo Recuts screen. The sample
content — audio, background, borders, captions, effects, graphics, transitions, and video — appears in the Sample
eVideo Content panel.
Show Generated Content In folders, shows content generated from an asset. For example, when a PDF file is rasterized
as it is uploaded, Scene7 creates one image for each page in the original PDF. If Show Generated Content is selected,
each image generated when the original PDF was uploaded appears along with the PDF in the folder to which the PDF
was uploaded.
Show Encoded Videos Deselected (off) by default.
To quickly search and browse for videos in Scene7 Publishing System without having to navigate through numerous
encoded derivatives of the same video, leave this option deselected (default). Only the Master Video thumbnail, which
is the source video you uploaded and used to create all the derivatives, and only the “parent” Adaptive Video Set
thumbnail, which contains all the “child” derivatives of the encoded video set, are displayed in the user interface.
You can, however, still access individual encoded videos from the Master Video or the Adaptive Video Set. To do so,
double-click the video thumbnail image to open Detail View. Then click Encoded Videos in the right panel to access
all the “child” videos.
You can also use File > Reprocess to create more encoded “child” videos directly from an Adaptive Video Set. Scene7
Publishing System automatically finds the “parent” Master Video of the Adaptive Video Set and uses that as the source
video for transcoding. When you save the new individual encoded videos, however, they are not seen when you search
or browse. However, they are still accessible from the Encoded Videos tab in Detail View.
See “Uploading and encoding videos” on page 211.
To continue the ability to access all your encoded video derivatives when you search and browse, select Show Encoded
Videos.
Last updated 10/9/2014
22
USING SCENE7
Setup
There are certain actions on the Build menu that only work, or optionally work, with individual videos. This
functionality makes it necessary to show all the encoded video derivatives that you can select from, regardless of how
you set Show Encoded Videos. The Build actions that over-ride the Show Encoded Videos setting include Adaptive
Video Sets, eCatalogs, and Video Recuts.
Note: If you did not use Scene7 Publishing System to upload and encode your video assets, Scene7 shows all your
individual encoded videos, even is this option is deselected.
Scene7 FTP Account
Server Lists your FTP account server.
User Name Lists your FTP account user name.
Upload to Application
Overwrite Images Scene7 does not allow two files to have the same name. Each item's Scene7 Publishing System ID
(the image name minus the filename extension) must be unique. Because of this rule, the Upload dialog box has an
Overwrite option. The exact effect of this option depends on the specified Overwrite Images option. These options
specify how replacement images are uploaded: whether they replace the original images, or become duplicate images.
Duplicate images are renamed with a “-1” (for example, chair.tif is renamed chair-1.tif). These options affect images
uploaded to a different folder than the original or images with a different filename extension from the original (such
as JPG, TIF, or PNG). (See “Using the Overwrite Images option” on page 23.)
• Overwrite in current folder, same base image name/extension This option is the strictest rule for replacement. It
requires that you upload the replacement image to the same folder as the original, and that the replacement image has
the same filename extension as the original. If these requirements are not met, a duplicate is created.
• Overwrite in current folder, same base asset name regardless of extension Requires that you upload the
replacement image to the same folder as the original, however the filename extension can be different from the
original. For example, chair.tif replaces chair.jpg.
• Overwrite in any folder, same base asset name/extension Requires that the replacement image has the same
filename extension as the original image (for example, chair.jpg must replace chair.jpg, not chair.tif). However, you
can upload the replacement image to a different folder than the original. The updated image resides in the new folder;
the file can no longer be found in its original location
• Overwrite in any folder, same base asset name regardless of extension This option is the most inclusive
replacement rule. You can upload a replacement image to a different folder than the original, upload a file with a
different filename extension, and replace the original file. If the original file is in a different folder, the replacement
image resides in the new folder to which it was uploaded.
Retain Publish Specifies whether a replacement image uploaded to Scene7 retains the Ready to Publish setting of the
image it is replacing, or the setting is specified on upload.
Default Color Profiles Specifies the color profiles applied as part of Default Color Profile Options when adding CMYK
images.
Default Upload Options Opens the Upload Job Options dialog box, where you can specify default upload options. For
information about these options, see “Upload options” on page 84.
Image Map Editor, to Application
Default Image Mapping HREF Defines the default URL used for the image mapping href column. This URL is the
default URL you see when you create new Image Maps.
Default Image Mapping Template Defines the default Javascript for the image mapping href template. You can set
custom code here to be executed whenever you click an image map.
Last updated 10/9/2014
23
USING SCENE7
Setup
Other Settings, to Application
Trash Can Clean Up Warnings Assets in the Trash are automatically removed within seven days. Select “Send emails
before trash items are automatically deleted” if you want notifications sent to company administrators when assets that
are in the Trash are four days away from being permanently deleted. See “Managing the Trash folder” on page 116.
Using the Overwrite Images option
Scene7 does not allow two files to have the same name. Each item's Scene7 Publishing System ID (the image name
minus the filename extension) must be unique. Because of this rule, the Upload dialog box includes Overwrite Images
options. The exact effect of this option depends on a setting for each company's Scene7 Publishing System Internal
Settings.
If you previously uploaded images and then changed the original files (or replaced them), the chosen Overwrite option
specifies how Scene7 replaces the images. No information about the image changes, but the new image replaces the old
one. If the folder also contains images that are not already in Scene7, these images are added.
Use this option if images you have uploaded have changed in some way (image has been altered) but the reference to
the image remains the same. Overwrite is also helpful when uploading and ripping Adobe® PDFs. To fine-tune how
Scene7 rips the image, adjust the ICC color profile options in the Upload dialog box and re-upload using the Overwrite
feature.
The Scene7 IDs that are used to access images from the production servers are derived from the image filenames. The
use of uppercase and lowercase characters in the filename is important, both in the replacement of existing files and
for the Scene7 IDs used to access the image. Be sure the use of uppercase and lowercase characters in filenames is
correct before uploading into Scene7 to avoid Scene7 IDs that differ only in case for the same image.
If you deselect this option, all images with the same filenames as existing images are treated as duplicates and are not
added.
Image Presets
The Image Presets screen is for creating and editing Image Presets. Image Presets enable Scene7 to deliver images
dynamically at different sizes from the same master image. Each Image Preset represents a predefined collection of
sizing and formatting commands for displaying images. When you create an Image Preset, you choose a size for image
delivery. You also choose formatting commands so that the appearance of the image is optimized when the image is
delivered for viewing.
Administrators can create presets for exporting assets. Users can choose a preset when they export images, which also
reformats images to the specifications that the administrator specifies.
To open the Image Preset screen, on the Global Navigation bar, click Setup > Image Presets.
More Help topics
“Setting up Image Presets” on page 121
Creating and editing Image Presets
1 Click Setup > Image Presets.
2 Create a new preset or start from an existing one:
Creating an Image Preset Click Add.
Creating an Image Preset from an existing preset Select the Image Preset that is most like the one you want to
create, and then click Edit.
Last updated 10/9/2014
24
USING SCENE7
Setup
3 On the Add (or Edit) Preset screen, enter a name for the preset.
4 Set the Preset options that you want.
See “Image Preset options” on page 24.
5 Click Save, or if you started from an existing preset, click Save As.
6 To preview the preset with your own image, click Browse and then select an image. To preview with the default
image, click Reset.
You can edit an Image Preset by selecting its name on the Image Presets screen and then clicking Edit. To delete an
Image Preset, select it, and then click Delete.
Image Preset options
The Add Preset and Edit Preset screens offers these options for creating and editing Image Presets:
Preset Name Enter a descriptive name without any blank spaces. Include the image-size specification in the name to
help users identify this Image Preset.
Width and Height Enter in pixels the size at which the image is delivered.
Format Choose a format from the menu. Choosing the GIF, JPEG, PDF, or TIFF format brings up additional options:
• GIF Color Quantization Options
• Type Choose Adaptive (the default), Web, or Macintosh. If you choose GIF With Alpha, the Macintosh® option
is not available.
• Dither Choose Diffuse or Off.
• Number Of Colors Drag the slider to enter 2–255.
• Color List Enter a comma-separated list. For example, for white, gray, and black, enter 000000,888888,ffffff.
• JPEG Options
• Quality Controls the JPEG compression level. This setting affects both file size and image quality. The JPEG
quality scale is 1–100.
• Enable JPG Chrominance Downsampling Because the eye is less sensitive to high-frequency color information
than high-frequency luminance, JPEG images divide image information into luminance and color components.
When a JPEG image is compressed, the luminance component is left at full resolution, while the color components
are downsampled by averaging together groups of pixels. Downsampling reduces the data volume by one half or
one third with almost no impact on perceived quality. Downsampling is not applicable to grayscale images. This
technique reduces the amount of compression useful for images with high contrast (for example, images with
overlaid text).
• PDF and TIFF options
• Compression Choose a compression algorithm.
Colorspace Choose a color space.
Sharpening Select the Enable Simple Sharpening option to apply a basic sharpening filter to the image after all scaling
takes place. Sharpening can help compensate for blurriness that can result when you display an image at a different
size.
For more information about sharpening, resample modes, and unsharp masking, see “Sharpening an image” on
page 300.
Last updated 10/9/2014
25
USING SCENE7
Setup
Resample Mode Choose a Resampling mode option. These options sharpen the image when it is downsampled:
• B-Linear The fastest resampling method; some aliasing artifacts are noticeable.
• Bi-Cubic Increases CPU usage on the Image Server, but yields sharper images with less noticeable aliasing artifacts.
• Sharp2 Can produce slightly sharper results than the Bi-Cubic option, but at even higher CPU cost on the Image
Server.
• Tri-Linear Uses both higher and lower resolutions, if available; recommended only when aliasing is an issue. This
method reduces JPEG size due to reduced high-frequency data.
Unsharp Masking Choose these options to fine-tune sharpening:
• Amount Controls the amount of contrast applied to edge pixels. The default is 1.0. For high-resolution images, you
can increase it to as high as 5.0. Think of Amount as a measure of filter intensity.
• Radius Determines the number of pixels surrounding the edge pixels that affect the sharpening. For highresolution images, enter from 1 through 2. A low value sharpens only the edge pixels; a high value sharpens a wider
band of pixels. The correct value depends on the size of the image.
• Threshold Determines the range of contrast to ignore when the unsharp mask filter is applied. In other words, this
option determines how different the sharpened pixels must be from the surrounding area before they are considered
edge pixels and are sharpened. To avoid introducing noise, experiment with values between .02 and 0.2. The default
value of 6 sharpens all pixels in the image.
• Color Space Determines whether the image uses the space in which the image was created, usually RGB (Original)
or a luminance space (Intensity).
Color Choose these options:
• Output Color Profile Select Use Default or one of the ICC color profiles available on the Scene7 Publishing System.
See also “ICC profiles” on page 315.
• Rendering Intent Select an option if you want to override the default rendering intent of the color profile. Use this
option when one of the default ICC profiles is the target color space of a color conversion, an output device (printer
or monitor) is characterized by this profile, and the specified rendering intent is valid for this profile.
• Embed Profile Select this option so that, if you open this image in Adobe® Photoshop®, it uses this profile.
Print Resolution Choose a resolution for printing this image; 72 pixels is the default.
URL Modifiers If you prefer to specify the URL modifiers that define your Image Preset, rather than the settings, enter
the modifiers here.
Sample Image URL Lists the “raw” URL string that the Scene7 Image Server uses to deliver images with the Image
Preset you are adding or editing. This URL string encodes all the format settings you select in the Add Preset or Edit
Preset screen.
Editing, removing, or deactivating an image preset
1 Click Setup > Image Presets.
2 In the Image Presets screen, select a preset in the table, and then do one of the following:
• Click Edit and then specify new options in the Edit Preset dialog box.
• Click Delete to remove the preset from the list.
• Deselect the Active check box next to a preset name to remove it from the entire Scene7 Publishing System user
interface for MediaPortal users.
Last updated 10/9/2014
26
USING SCENE7
Setup
Activating or deactivating adaptive video presets
Scene7 offers Adaptive Video encoding presets. It is a master list of presets that combines both 16:9 Adaptive Video
presets and 4:3 Adaptive Video presets into one group. These predefined presets reflect the most common encoding
settings and are optimized for playback on target mobile devices, tablets, and desktops.
Only “Adaptive Video” encoding presets are activated (enabled or “turned on”) by default. You can deactivate it, if
desired. Inactive Adaptive Video presets do not appear as a selectable option in the eVideo section of the Upload Job
Options dialog box.
See “Uploading and encoding videos” on page 211.
To activate or deactivate adaptive video presets
1 Near the upper-right corner of Scene7 Publishing System, click Setup > Application Setup > Video Presets >
Adaptive Video Presets.
2 On the Adaptive Video Presets page, deselect the check box next to a preset name to remove the preset from the
eVideo Options list in the Upload Job Options dialog box.
3 Click Close.
Video presets for encoding video files
To choose an encoding preset, in the lower-right corner of the Upload page, click Job Options. In the Upload Job
Options dialog box, expand eVideo Options and choose the video encoding presets you want.
Note: With the exception of “Adaptive Video”, which is enabled by default, you may not see all of the other adaptive video
or single video encoding presets in the Upload Job Options dialog box. Scene7 Administrators determine which video
encoding presets are visible in the Upload Job Options dialog box.
• Choose from the following adaptive video encoding or single encoding presets:
16:9 Adaptive Video Create 16:9 aspect ratio videos for delivery to desktops (compatible with Flash 9), mobile
(iPhone, iPad, Android), and tablets (iPad, Android), optimized with the resolution and bit rate that best matches
the viewer's connection speed.
4:3 Adaptive Video Create 4:3 aspect ratio videos for delivery to desktops (compatible with Flash 9), mobile
(iPhone, iPad, Android), and tablets (iPad, Android), optimized with the resolution and bit rate that best matches
the viewer's connection speed.
Adaptive Video A single encoding preset that works with any aspect ratio to create videos for delivery to mobile,
tablet, and desktop. Uploaded source videos that are encoded with this preset are set with a fixed height. However,
the width automatically scales to preserve the video’s aspect ratio.
This flexibility of having an “Auto-scale” is also available by default when you create your own custom video
encoding preset.
See “Adding or editing a video encoding preset” on page 220.
Adaptive Video Encoding (16:9 or 4:3) Create both 16:9 and 4:3 aspect ratio videos for delivery to desktops
(compatible with Flash 9), mobile (iPhone, iPad, Android), and tablets (iPad, Android), optimized with the
resolution and bit rate that best matches the viewer's connection speed.
See “Adaptive Video Encoding (16:9 or 4:3) video presets” on page 28.
Single Encoding Presets •Desktop (compatible with Flash 9 and with HTML5 OGG) Create an MP4 file for
delivering a streaming or progressive eVideo experience to desktop computers.
See “Desktop video encoding presets” on page 29.
Last updated 10/9/2014
27
USING SCENE7
Setup
• Mobile (iPhone, iPad, Android) Create an MP4 file for delivery on iPhones, iPads, and Androids.
See “Mobile video encoding presets” on page 30.
• Tablet (iPad, Android) Create an MP4 file for delivery on iPads and Androids.
Or, create an OGV file for delivering a progressive eVideo experience to desktop computers using the browser’s
HTML5 video player.
See “Tablet video encoding presets” on page 31.
Note: To deliver video to iPads, you can choose a Mobile encoding preset or a Tablet encoding preset. Tablet presets
are designed especially for the iPad, typically with higher resolution and quality to take advantage of the larger screen
size and bandwidth connection. Delivering video files encoded with a Tablet preset requires you to include devicedetection code on your mobile site or application. This code switches between an iPhone or iPad video experience,
depending on the playback device. Choosing a Mobile preset for delivering video files to the iPad is a more simplified
workflow. The reason is because you can use the same video file for both iPhones and iPads. However, the quality is
standardized to the lower resolution iPhone experience.
• Under the Encoding Presets group, in the Sort Encoding Presets drop-down list, select Name or Size to sort presets
by name or resolution size.
• Choose an encoding preset based on the resolution size and bandwidth with which you plan to play the video.
• You can select Adaptive Video Encoding and one or more encoding preset per video. For example, you can encode
a file for both desktop and mobile in one upload job.
After you click Start Upload, the original master video file is uploaded and encoded files are generated from the master file.
About encoding preset options
Parameters of the encoding preset options are the following:
Target connection speed The Internet connection speed of the targeted end user.
Encoded file suffix The suffix that is attached to the encoded video file for identification purposes.
Video bit rate (data rate) The amount of data that is encoded to make up a single second of video playback (in kilobits
per second).
Pixel Width/Height The width dimension of the screen image, in pixels; the height dimension of the screen image (in
pixels).
Frame per second (fps) The number of frames, or still images, for each second of video. In the United States and Japan,
most video is shot at 29.97 fps; in Europe and Asia (excluding Japan), most video is shot at 25 fps. Film is shot at 24 fps.
Audio bit rate The amount of data that is encoded to make up a single second of audio playback, in kilobits per second.
The following tables show you recommended best practices for selecting video presets and the naming conventions
that are used to designate encoded files.
Adaptive Video (default)
An encoding preset that works with any aspect ratio to let you create videos for delivery to mobile, tablet, and desktop.
Uploaded source videos that are encoded using this preset (the default and a best practice) are set to a fixed height while
the width automatically scales to preserve the video’s aspect ratio.
Last updated 10/9/2014
28
USING SCENE7
Setup
Adaptive Video (default)
Encoding Preset
Name/Tooltip Text
Encoded file suffix
Video
data rate
(Kbps)
Width/Height Fps
(pixels)
Audio bit
rate
(kbps)
Recommendations
1
Auto x360, 800 Kbps
_Mobile_Autox360p
_800K
800
Autox360
Same
as
source
64
For mobile (iPhone, iPad,
Android)
2
Auto x 480, 1400 Kbps
_Tablet_Autox480p_
1400K
1400
Autox480
Same
as
source
64
For tablet (iPad, Android)
3
Auto x 720, 2600 Kbps
_Flash9_Autox720p_ 2600
2600K
Autox720
Same
as
source
64
For desktop (compatible
with Flash 9)
Adaptive Video Encoding (16:9 or 4:3) video presets
These adaptive video encoding presets combine a series of individual encode presets that are automatically selected for
you based on the aspect ratio of the video that you uploaded. For example, if you upload a 4:3 video, it is automatically
encoded using all five 4:3 presets found within the master preset list in the Adaptive Video Encoding (16:9 or 4:3)
option.
For information about encoding options parameters, see “About encoding preset options” on page 27.
Adaptive Video Encoding (16:9 or 4:3) presets
Encoding Preset
Name/Tooltip Text
Target
Encoded file suffix
connectio
n speed
(Kbps)
Video
data rate
(Kbps)
Width/Height Fps
(pixels)
Audio bit
rate
(kbps)
Recommendations
1
16:9, 512x288, Mobile
(iPhone, iPad, Android),
(400 Kbps)
500
_Mobile_512x288_4
00K
400
512x288
Same
as
source
64
Low resolution, 3G
2
4:3, 384x288px, Mobile
(iPhone, iPad, Android),
(400 Kbps)
500
_Mobile_384x288_4
00K
400
384x288
Same
as
source
64
Low resolution, 3G
3
16:9, 512x288, Mobile
(iPhone, iPad, Android),
(600 Kbps)
700
_Mobile_512x288_6
00K
600
512x288
Same
as
source
64
Medium resolution, 3G
4
4:3, 384x288, Mobile
(iPhone, iPad, Android),
(600 Kbps)
700
_Mobile_384x288_6
00
600
384x288
Same
as
source
64
Medium resolution, 3G
5
16:9, 640x360, Tablet
(iPad, Android), (800
Kbps)
900
_iPad_640x360_800K 800
640x360
Same
as
source
80
Medium resolution, WiFi
6
4:3, 640x480, Tablet
(iPad, Android), (800
Kbps)
900
_iPad_640x480_800K 800
640x480
Same
as
source
80
Medium resolution, WiFi
7
16:9, 768x432, Tablet
(iPad, Android), (1200
Kbps)
1.5 Mbps
_iPad_768x432_1200 1200
K
768x432
Same
as
source
96
High resolution, WiFi
Last updated 10/9/2014
29
USING SCENE7
Setup
Encoding Preset
Name/Tooltip Text
Target
Encoded file suffix
connectio
n speed
(Kbps)
8
4:3, 768x576, Tablet
(iPad, Android), (1200
Kbps)
1.5 Mbps
9
16:9, 1280x720, Desktop
(Compatible with Flash
9), (2000 Kbps)
1
0
4:3, 1280x960, Desktop
(Compatible with Flash
9), (2000 Kbps)
Video
data rate
(Kbps)
Width/Height Fps
(pixels)
Audio bit
rate
(kbps)
Recommendations
_iPad_768x576_1200 1200
K
768x576
Same
as
source
96
High resolution, WiFi
3.0 Mbps
_1280x720_2000K
2000
1280x720
Same
as
source
128
High-definition,
widescreen
3.0 Mbps
_1280x960_2000K
2000 Kbps 1280x960
Same
as
source
128
High-definition
Desktop video encoding presets
Video encoding presets for MP4 and OGV on desktop computers.
For information about encoding options parameters, see “About encoding preset options” on page 27.
H264 Main 3.2 - Audio AAC, MP4 file extension
Encoding Preset
Name/Tooltip Text
Target
Encoded file suffix
connectio
n speed
(Kbps)
Video
data rate
(Kbps)
Width/Height Fps
(pixels)
Audio bit
rate
(Kbps)
Recommendations
1
16:9, 480x270 (400 Kbps) 500
_480x270_400K
400
480x270
Same
as
source
64
Low widescreen
resolution
2
16:9, 640x360 (800 Kbps) 900
_640x360_800K
800
640x360
Same
as
source
80
Medium widescreen
resolution
3
16:9, 800x450 (1200
Kbps)
1.5 Mbps
_800x450_1200K
1200
800x450
Same
as
source
96
Medium-high resolution
4
16:9, 1280x720 (2000
Kbps)
3.0 Mbps
_1280x720_2000K
2000
1280x720
Same
as
source
128
High-definition,
widescreen
5
4:3, 320x240 (400 Kbps)
500
_320X240_400K
400
320x240
Same
as
source
64
Low resolution
6
4:3, 480x360 (800 Kbps)
900
_480x360_800K
800
480x360
Same
as
source
80
Medium resolution
7
4:3, 640x480 (1200 Kbps) 1.5 Mbps
_640x480_1200K
1200
640x480
Same
as
source
96
Medium-high resolution
8
4:3, 1280x960 (2000
Kbps)
_1280x960_2000K
2000
1280x960
Same
as
source
128
High-defintion
3.0 Mbps
Last updated 10/9/2014
30
USING SCENE7
Setup
OGG Theora Vorbis - OGV file extension
Encoding Preset
Name/Tooltip Text
Target
Encoded file suffix
connectio
n speed
(Kbps)
Video
data rate
(Kbps)
Width/Height Fps
(pixels)
Audio bit
rate
(Kbps)
Recommendations
1
16:9, 480x270 (400 Kbps), 500
OGG
_OGG_480x270_400
K
400
480x270
Same
as
source
64
Low widescreen
resolution
2
16:9, 640x360 (800 Kbps), 900
OGG
_OGG_640x360_800
K
800
640x360
Same
as
source
80
Medium widescreen
resolution
3
16:9, 800x450 (1200
Kbps), OGG
1.5 Mbps
_OGG_800x450_120
0K
1200
800x450
Same
as
source
96
Medium-high resolution
4
16:9, 1280x720 (2000
Kbps), OGG
3.0 Mbps
_OGG_1280x720_20
00K
2000
1280x720
Same
as
source
128
High-definition,
widescreen
5
4:3, 320x240 (400 Kbps),
OGG
500
_OGG_320X240_400
K
400
320x240
Same
as
source
64
Low resolution
6
4:3, 480x360 (800 Kbps),
OGG
900
_OGG_480x360_800
K
800
480x360
Same
as
source
80
Medium resolution
7
4:3, 640x480 (1200 Kbps), 1.5 Mbps
OGG
_OGG_640x480_120
0K
1200
640x480
Same
as
source
96
Medium-high resolution
8
4:3, 1280x960 (2000
Kbps), OGG
_OGG_1280x960_20
00K
2000
1280x960
Same
as
source
128
High-defintion
3.0 Mbps
Mobile video encoding presets
Same as source fps. Video encoding presets for iPhone, iPad, and Android mobile devices.
For information about encoding options parameters, see “About encoding preset options” on page 27.
H264 Baseline 2.1 - Audio AAC, MP4 file extension
Encoding Preset
Target
Name/Tooltip Text Connection
Speed
(Kbps)
Encoded file suffix
Video bit Pixel
Fps
rate
Width/Height
(Kbps)
Audio
bit rate
(Kbps)
Recommendations
1
16:9, 512x288,
Mobile (400 Kbps)
500
_Mobile_512x288_400K
400
512x288
Same as
source
64
Low resolution, 3G
2
16:9, 512x288,
Mobile (600 Kbps)
700
_Mobile_512x288_600K
600
512x288
Same as
source
64
Medium resolution, 3G
3
16:9, 512x288,
Mobile (800 Kbps)
900
_Mobile_512x288_800K
800
512x288
Same as
source
80
Medium resolution, WiFi
4
16:9, 512x288,
Mobile (1000 Kbps)
1.2 Mbps
_Mobile_512x288_1000K 1000
512x288
Same as
source
80
High resolution, Wi-Fi
5
16:9, 512x288,
Mobile (1200 Kbps)
1.5 Mbps
_Mobile_512x288_1200K 1200
512x288
Same as
source
96
High resolution, Wi-Fi
Last updated 10/9/2014
31
USING SCENE7
Setup
Encoding Preset
Target
Name/Tooltip Text Connection
Speed
(Kbps)
Encoded file suffix
Video bit Pixel
Fps
rate
Width/Height
(Kbps)
Audio
bit rate
(Kbps)
Recommendations
6
4:3, 384x288, Mobile 500
(400 Kbps)
_Mobile_384x288_400K
400
384x288
Same as
source
64
Low resolution, 3G
7
4:3, 384x288, Mobile 700
(600 Kbps)
_Mobile_384x288_600K
600
384x288
Same as
source
64
Medium resolution, 3G
8
4:3, 448x336, Mobile 900
(800 Kbps)
_Mobile_448x336_800K
800
448x336
Same as
source
80
Medium resolution, WiFi
9
4:3, 448x336, Mobile 1.2 Mbps
(1000 Kbps)
_Mobile_448x336_1000K 1000
448x336
Same as
source
80
High resolution, Wi-Fi
10 4:3, 448x336, Mobile 1.5 Mbps
(1200 Kbps)
_Mobile_448x336_1200K 1200
448x336
Same as
source
96
High resolution, Wi-Fi
Tablet video encoding presets
Same as source fps. Video encoding presets for iPad, and Android tablet devices.
For information about encoding options parameters, see “About encoding preset options” on page 27
H264 Main 3.1 - Audio HE-AACv1, MP4 file extension
Encoding Preset
Name/Tooltip Text
Target
Connection
Speed
(Kbps)
Encoded file suffix
Video bit
rate
(Kbps)
Pixel
Width/Height
Fps
1
16:9, 512x288, iPad
(400 Kbps)
500
_iPad_512x288_400K
400
512x288
Same as 64
source
Low resolution, 3G
2
16:9, 512x288, iPad
(600 Kbps)
700
_iPad_512x288_600K
600
512x288
Same as 64
source
Medium resolution, 3G
3
16:9, 640x360, iPad
(800 Kbps)
900
_iPad_640x360_800K
800
640x360
Same as 80
source
Medium resolution, Wi-Fi
4
16:9, 640x360, iPad
(1000 Kbps)
1.2 Mbps
_iPad_640x360_1000K
1000
640x360
Same as 80
source
High resolution, Wi-Fi
5
16:9, 768x432, iPad
(1200 Kbps)
1.5 Mbps
_iPad_768x432_1200K
1200
768x432
Same as 96
source
High resolution, Wi-Fi
6
4:3, 384x288, iPad (400
Kbps)
500
_iPad_384x288_400K
400
384x288
Same as 64
source
Low resolution, 3G
7
4:3, 512x384, iPad (600
Kbps)
700
_iPad_512x384_600K
600
512x384
Same as 64
source
Medium resolution, 3G
8
4:3, 640x480, iPad (800
Kbps)
900
_iPad_640x480_800K
800
640x480
Same as 80
source
Medium resolution, Wi-Fi
9
4:3, 640x480, iPad
(1000 Kbps)
1.2 Mbps
_iPad_640x480_1000K
1000
640x480
Same as 80
source
High resolution, Wi-Fi
10 4:3, 768x576, iPad
(1200 Kbps)
1.5 Mbps
_iPad_768x576_1200K
1200
768x576
Same as 96
source
High resolution, Wi-Fi
Last updated 10/9/2014
Audio
bit rate
(Kbps)
Recommendations
32
USING SCENE7
Setup
Viewer Presets
A Viewer Preset is a collection of settings that determine how users view rich-media assets on their computer screens
and mobile devices. As an administrator, you can create Viewer Presets. Settings are available for an array of viewer
configuration options. For example, you can change the viewer display size, zoom behavior, color schemes, borders,
and fonts.
As a best practice, use Scene7 HTML5 Video viewers. The presets used in HTML5 Video viewers are robust video
players. By combining into a single player the ability to design the playback components using HTML5 and CSS, have
embedded playback, and use adaptive and progressive streaming depending on the browser’s capability, you extend
the reach of your rich media content to desktop, tablet, and mobile users, and ensure a streamlined video experience.
See About HTML5 Viewers in the Adobe Scene7 Viewers Reference Guide.
See “Scene7 Viewer Preset compatibility matrix” on page 33.
See “Best practice: Using the HTML5 Video viewer” on page 207.
Depending on the viewer, you can add community features. Community features include an Embed button, E-mail
button, Link button, and Visit Site button. These buttons let people using the viewers share the viewer with others or
open the Scene7 web site.
See also Scene7 Viewers Reference Library Examples.
Viewer support for responsive designed web pages
Different web pages have different needs. Sometimes you will want a web page that provides a link that opens the
HTML5 Viewer in a separate browser window. In other cases, it may be necessary to embed the HTML5 Viewer
directly on the hosting page. In the latter case, the web page may have a static layout. Or, it may be "responsive" and
display differently on different devices or for different browser window sizes. To accommodate these needs, the
HTML5 Viewers that come with Scene7 support both static web pages and responsive designed web pages.
See Responsive Static Image libraryin the Scene7 Image Serving API Help for more information on how to embed
responsive viewers onto your web pages.
Viewer Preset types
Administrators can create and customize the following types of Viewer Presets:
eCatalog Viewer Simulates the experience of reading a printed catalog. You can move from page to page, zoom in and
out of items on a page, and use image maps to see more information about items on the page. You can also include an
Info Panel to display detailed information and an image-mapped item if the map area has a valid rollover_key
attribute. To include an Info Panel, specify an Information Server URL in the Info Panel Settings panel of the eCatalog
Viewer Preset window.
Swatch Set Viewer Displays an image in a different color, material, texture, finish, or fabric. Users click a thumbnail
to see the variations in the image.
Mixed Media Set Viewer Displays different types of media in one viewer. You can include Swatch Sets, Spin Sets,
images, and videos. You can set up tabs to contain different types of content, such as a tab for image sets and a tab for
videos. Videos played back from a Mixed Media Set use a standard video viewer with a timeline and video controls,
such as Stop, Pause, Rewind, and Play. When you set up a Mixed Media Set Viewer preset, you specify which viewers
you want to use for the different types of assets in your Mixed Media Set. You can also use the Grid Viewer or Carousel
Viewer to view a Mixed Media Set.
Spin Set Viewer Provides multiple views of an image so users can turn the object to examine the different sides and
angles.
Last updated 10/9/2014
33
USING SCENE7
Setup
Video Viewer Displays videos using the resolution dimensions of the source file or a custom size. Scene7 comes with
many predefined Viewer Presets for playing video, and if you are an administrator, you can create custom Video
Viewer presets. There are more than a dozen different settings for configuring the Video Viewer. You can configure
its size, foreground and background color, video and audio controls, progress bar, user-interface skin, social features,
and Help.
Video Recut Viewer For creating Video Recuts, provides sample audio, backgrounds, borders, captions, effects,
graphics, transitions, and video. This content appears in the Sample eVideo Content panel in the Video Recut screen.
Zoom Viewers Offers a choice of three types of zoom viewer:
• Zoom Viewer Lets users zoom into the area by clicking it. They can click controls to zoom in, zoom out, and reset
the image to its default size.
• Zoom Viewer: Fly-out Displays a second image of the zoomed area next to the original image. There are no controls
to use, users simply move the selection over the area they want to view.
When determining the complete bandwidth usage for this viewer, consider that both the main image and the flyout
image are served in the viewer. The main image size (Stage Width and Height) and the Zoom Factor determine the
flyout image size. To keep the flyout file size from becoming too large, balance these two values: if you have a large
main image size, lower the Zoom Factor value. (The Flyout Width and Flyout Height determine the size of the flyout
window, but not the size of the flyout image that is served into the viewer.)
For example, if your main image size is 350 by 350 pixels, with a Zoom Factor of 3, the resulting flyout image is 1050
by 1050 pixels. If your main image size is 300 by 300 pixels, with a Zoom Factor of 4, the flyout image is 1200 by 1200
pixels. Depending on the JPEG quality setting (recommended settings are between 80-90), you can decrease the file
size significantly. Recommended zoom factors are 2.5 to 4, depending on the size of your main image.
Scene7 Viewer Preset compatibility matrix
The following table identifies the currently available Scene7 Viewer Presets. The table also specifies the viewer’s
compatibility with desktop and mobile devices, and the technology that is used for each given viewer.
See also Scene7 Viewers Reference Library Examples.
For information about supported web browser and operating system versions for Viewers, you can review the Viewers
Release Notes.
See Scene7 Viewers Reference Release Notes.
Viewer
Technology
Desktop
Apple
iPhone
Apple
iPad
Android
Android
Smartphone Tablet
HTML5
X
X
X
X
X
Universal_HTML5_Zoom_inli HTML5
ne
X
X
X
X
X
Universal_HTML5_Zoom_da
rk
HTML5
X
X
X
X
X
Universal_HTML5_Zoom_lig
ht
HTML5
X
X
X
X
X
FlyoutZoom_Flash
Flash AS3
X
Zoom Viewers
Universal_HTML5_Flyout
Last updated 10/9/2014
34
USING SCENE7
Setup
Viewer
Technology
Desktop
Apple
iPhone
Apple
iPad
Android
Android
Smartphone Tablet
FlyoutZoom2_Flash
Flash AS3
X
Legacy-Zoom-Guided
Flash AS2
X
Zoom
Flash AS3
X
Viewer
Technology
Desktop
Apple
iPhone
Apple iPad Android
Smartphon
e
Android
Tablet
Universal_HTML5_Flyout
HTML5
X
X
X
X
X
Universal_HTML5_ImageSet
_dark
HTML5
X
X
X
X
X
Universal_HTML5_ImageSet
_light
HTML5
X
X
X
X
X
FlyoutZoom_Flash
Flash AS3
X
FlyoutZoom2_Flash
Flash AS3
X
ImageSet
Flash AS3
X
ImageSet_Slideshow_Flash
Flash AS3
X
Legacy-ImageSet-Guided
Flash AS2
X
Viewer
Technology
Desktop
Apple
iPhone
Apple iPad Android
Smartphon
e
Android
Tablet
HTML5
X
X
X
X
X
Universal_HTML5_SwatchSet HTML5
_dark
X
X
X
X
X
Universal_HTML5_SwatchSet HTML5
_light
X
X
X
X
X
FlyoutZoom_Flash
Flash AS3
X
FlyoutZoom2_Flash
Flash AS3
X
SwatchSet
Flash AS3
X
SwatchSet_Slideshow_Flash
Flash AS3
X
Image Set Viewers
Swatch Set Viewers
Universal_HTML5_Flyout
Last updated 10/9/2014
35
USING SCENE7
Setup
Viewer
Technology
Desktop
Apple
iPhone
Apple iPad Android
Smartphon
e
Android
Tablet
X
X
X
X
X
HTML5
X
X
X
X
X
eCatalog_Flash
Flash AS3
X
eCatalog_PopupViewers_Fla
sh
Flash AS3
X
Legacy-eCatalog
Flash AS2
X
Viewer
Technology
Desktop
Apple
iPhone
Apple iPad Android
Smartphon
e
Android
Tablet
Universal_HTML5_SpinSet_d HTML5
ark
X
X
X
X
X
Universal_HTML5_SpinSet_li
ght
HTML5
X
X
X
X
X
Spin
Flash AS3
X
Spin_Auto_Flash
Flash AS3
X
Spin_eCat_Flash
Flash AS3
X
eCatalog Viewers
Universal_HTML5_eCatalog_ HTML5
Adv
(Includes support for social
media.)
Universal_HTML5_eCatalog
(Includes support for social
media.)
Spin Viewers
Last updated 10/9/2014
36
USING SCENE7
Setup
Viewer
Technology
Desktop
Apple
iPhone
Apple
iPad
Android
Smartph
one
Android
Tablet
Blackber Windows
ry
Phone
Smartph
one
eVideo Viewers
Scene7 supports mobile video playback for MP4 H.264 video. You can find Blackberry devices that support this video format at the
following:
Supported video formats on Blackberry
You can also find Windows devices that support this video format at the following:
Supported video formats on Windows Phone
Universal_HTML5_Video
HTML5
X
X
X
X
X
X
X
HTML5
X
X
X
X
X
X
X
Video
Flash AS3
X
Video_eCat
Flash AS3
X
Video_Caption
Flash AS3
X
(Includes support for closed
captioning.)
See “Best practice: Using
the HTML5 Video viewer”
on page 207.
Universal_HTML5_Video_s
ocial
(Includes support for closed
captioning and social
media.)
Viewer
Technology
Desktop
Apple
iPhone
Apple iPad Android
Smartphon
e
Android
Tablet
Flash AS3
X
Viewer
Technology
Desktop
Apple
iPhone
Apple iPad Android
Smartphon
e
Android
Tablet
Universal_HTML5_MixedMe
dia_dark
HTML5
X
X
X
X
X
Universal_HTML5_MixedMe
dia_light
HTML5
X
X
X
X
X
MixedMedia_AutoSpin_Flas
h
Flash AS3
X
Mixed_Media
Flash AS3
X
Video Recut Viewer
VideoRecut
Mixed Media Set Viewers
Last updated 10/9/2014
37
USING SCENE7
Setup
Supported Mobile Viewers Gestures matrix
The following table identifies the mobile viewer gestures that are supported on iOS, Android 2.x, and Android 3.x
devices.
Gesture
Flyout Zoom
Zoom
eCatalog
Spin
Drag
Pans
Pans
Pans
Pans
Tap
Shows flyout window Shows or hides the user Shows or hides the
interface
user interface
Shows or hides the user
interface
Double-tap
Does not apply
Zooms in or resets
Zooms in or resets
Zooms in or resets
Pinch open
Does not apply
Zooms in (iOS and
Android 3x only)
Zooms in (iOS and
Android 3x only)
Zooms in (iOS and
Android 3x only)
Pinch close
Does not apply
Zooms out (iOS and
Android 3x only)
Zooms out (iOS and
Android 3x only)
Zooms out (iOS and
Android 3x only)
Swipe
Scrolls swatch bar
Scrolls images
Scrolls pages
Spins
Flick
Scrolls swatch bar
Scrolls images
Scrolls pages
Spins
About the Viewer Preset screen
Create and manage Viewer Presets on the Viewer Presets screen. To open this screen, click Setup > Viewer Presets.
The Viewer Presets screen offers tools for doing these tasks:
Adding a preset Click Add and make choices in the Add Viewer Preset dialog box.
See “Adding and editing Viewer presets” on page 38.
Editing a preset Select a preset, and then click Edit.
See “Adding and editing Viewer presets” on page 38.
Deleting a preset Select a preset, and then click Delete.
Adding localization support to a preset Add locale map string values to Image Server under Publish Setup, then edit a
Flash AS3 Viewer preset, and add localized tool tip text.
See “Adding localization support to a Flash AS3 Viewer preset” on page 39.
Exporting a preset Select an HTML5 or Flash AS3 viewer preset, and then click Export to download the viewer skin
so that you can use it as the basis for creating and adding a new viewer preset.
See “Exporting an HTML5 or a Flash AS3 Viewer Preset” on page 40.
Filtering the Viewer Preset list Use these tools to filter the list:
• Open the Active/Inactive drop-down list and choose an option to show active presets, inactive presets, or all
presets.
• Open the Platform drop-down list choose to show only viewers for the Flash AS3 platform.
• Open the Viewer drop-down list and choose an option to see only viewers of a certain kind. Choose All Viewers
to see all viewers.
Sorting presets Click a column heading (Active, Universal, Type, Preset, or Platform) to sort the list on a column.
Click a column heading a second time to sort the list in descending (or ascending) order.
See “About Universal Viewers” on page 42.
Activating and deactivating presets Select a preset and click its Active option to activate or deactivate it.
Last updated 10/9/2014
38
USING SCENE7
Setup
See “Activating or deactivating Viewer presets” on page 41.
Click Preview on the right side of the Viewer Presets screen to see what an asset looks like in the Viewer Preset you
selected. To see a different asset, you can click Browse in the Viewer Presets screen and select a different asset in the
Select Asset Preview dialog box.
Adding and editing Viewer presets
Besides adding viewer presets using Add in the user interface, you can also use Export to add a viewer preset. You
simply export an existing viewer preset for Flash AS3 or HTML5, and then use that as the basis for the new preset.
See “Exporting an HTML5 or a Flash AS3 Viewer Preset” on page 40.
To add and edit Viewer presets
1 Near the upper-right corner of Scene7 Publishing System, click Setup > Viewer Presets.
You can filter on the list of presets. For example, to see only presets for Video Viewers, select Video Viewer from
the Viewers drop-down menu on the toolbar directly above the table.
2 In the Viewer Presets screen, add or edit the Viewer Preset on the Viewer Presets screen.
Adding Click Add on the toolbar. In the Add Viewer Preset dialog box, choose a platform, and choose a rich-media
asset type.
Click Save As when you have finished creating the Viewer Preset.
Adding by starting from an existing Viewer Preset In the table, select a Video Viewer Preset, and then click Edit on
the toolbar.
After you reconfigure the Video Viewer, click Save As to save the preset using a different name in the Preset Name
text field.
Editing Select an existing Viewer Preset, and then click Edit.
3 In the Configure Viewer screen, in the Preset Name field, enter or edit the preset name.
4 Set the remaining options that you want.
Note: Choose Same As Source to automatically size the Video Viewer to the resolution size of the encoded video itself.
If you choose this option, you cannot enter the Stage Width and Stage Height. Instead, these options come from the
video itself. If you choose Same As Source, set the Margin Size option to reflect the skin dimensions outside the video
playback area. This margin size is the pixel height and width of the video controls. You can use the following
illustration to help you determine the margin sizes that you want to use.
The stage height and width and the margin height and width of a Video Viewer.
Last updated 10/9/2014
39
USING SCENE7
Setup
5 Do one of the following:
• Click Save As if you added a Viewer preset by starting from an existing preset.
• Click Save if you added or edited a Viewer preset.
Adding localization support to a Flash AS3 Viewer preset
You can add localized tool tip text to a Flash AS3 Viewer.
To accomplish this functionality you first define a locale map string on the Image Server. Then you edit the tool tip
text of a Flash AS3 Viewer preset.
See “Considerations when setting up localization of assets” on page 56.
Be aware Scene7 Publishing System does not include fonts for Eastern languages such as Japanese, Chinese, or Korean.
Such languages typically require UTF-8 or a different character set. Therefore, to use these languages for tool tip text
you can log on to Scene7 from that locale and type the tool tip values that you want. Or, the tool tip text as UTF-8; that
is, cut and paste the text from a word processor that runs the desired Eastern language.
Besides the ability to use localized tool tips in a Viewer by following the steps below, there is an alternate method you
can use. You can add localized tool tips and even localized graphics to a Viewer directly in the Viewer SDK. For
instructions, see the Localization chapter in the Adobe Scene7 Viewer SDK for Adobe Flash PDF guide, available as part
of the Adobe Scene7 Viewer SDK download from Adobe Developer Connection.
Note: To setup Localization Support options, contact Adobe Scene7 Technical Support or send an email to
s7support@adobe.com requesting setup help.
To add localization support to a Flash AS3 Viewer Preset
1 Click Setup > Application Setup > Publish Setup > Image Server.
2 In the Image Server Publish panel, scroll down to the Localization Support section.
Note: To setup Localization Support options, contact Adobe Scene7 Technical Support or send an email to
s7support@adobe.com requesting setup.
3 In the Locale Map String text field, specify the languages that you want to support.
For example, if you want to support English, Spanish, and Japanese in a Viewer, the proper syntax of the map string
is en,en,|es,es,|ja,ja,. The parameter is LocaleStrMap.
For each pair of two letter languages, the first two letter code is the name of the language. You could also spell out
the name of the language instead of using a two letter code (as in English, en,). Regardless of the method you
use, the list of languages you specify here also populates the list of languages that appear in the Locale drop-down
list when you edit a Viewer Preset. It is also used when requesting a localized viewer by way of
viewerURL&locale=en in the viewer URL.
4 Click Save, and then click OK.
5 In the left panel of the Setup screen, under Application Setup, click Viewers > Viewer Presets.
6 In the All Platforms drop-down list on the Setup toolbar, select Flash AS3.
7 Select an active Viewer Preset, and then on the Setup toolbar, click Edit.
8 In the Configure Viewer screen, from the Locale drop-down list, select a language whose tool tips you want to
appear localized in the Viewer.
9 In the left panel of the Configure Viewer screen, click a component name, such as Pause Play Button or Full Screen
Button.
10 In the component’s tool tip text field, type the value for the language that you selected.
Last updated 10/9/2014
40
USING SCENE7
Setup
11 When you have finished entering tool tip values for the various components that make up a Viewer Preset, in the
lower-right corner of the Configure Viewer screen, click Save As.
12 Repeat steps 8-10 if you are supporting additional languages.
13 In the Save As New Preset Name dialog box, type the new name of the Viewer Preset, and then click Save.
Exporting an HTML5 or a Flash AS3 Viewer Preset
You can export an existing HTML5 or Flash AS3 Viewer Preset to use as the basis for creating a new HTML5 or Flash
AS3 Viewer Preset. This export option is useful because you do not have to create the viewer from scratch. Instead, you
export a preset that looks and behaves close to what you want, then you can use that as a starting point to make design
adjustments.
If you are exporting an HTML5 Viewer Preset, be sure that you have the HTML5 Viewer SDK installed so that you can
edit the exported CSS and related Javascript. Likewise, if you are exporting a Flash AS3 Viewer Preset, be sure that you
have the Flash Viewer SDK installed on Adobe Flash Professional so that you can edit the exported FLA file.
See “Developer resources” on page 4.
To export an HTML5 or a Flash AS3 Viewer Preset
1 Click Setup > Viewer Presets.
2 On the Viewer Presets toolbar, in the second drop-down list from the left, select HTML5 or Flash AS3.
3 In the third drop-down list from the left, select All Viewers.
4 Select the viewer preset that you want to use as the basis for a new HTML5 or Flash AS3 Viewer Preset.
5 In the toolbar, click Export.
6 In the Export Selected Assets dialog box, click Submit Export.
Following export, you get a zipped FLA file if you exported a Flash AS3 viewer. Or, if you exported an HTML5
viewer, you get a CSS file. Download and unzip the file.
7 Do one of the following depending on the viewer preset you exported:
• Open the FLA file in Adobe Flash Professional and make your changes. Be sure that you have the Scene7 Viewer
Flash SDK installed before you edit the file.
Export the FLA file as a movie and save the resulting SWF file.
• Open the CSS file in a CSS editor, make your changes, and then save the file.
8 Upload the SWF file or the CSS file to Scene7 Publishing System.
See “Uploading files” on page 79.
9 Publish the SWF file or the CSS file to the Scene7 Image Server.
See “Publishing files” on page 87.
10 Add the new viewer preset as usual. Depending on the viewer that you exported, select the viewer SWF or the viewer
CSS file that you uploaded.
See “Adding and editing Viewer presets” on page 38.
Last updated 10/9/2014
41
USING SCENE7
Setup
Activating or deactivating Viewer presets
To create a URL for showing assets, users open the Presets drop-down list in the Preview dialog box, select a Viewer
Preset, and click Copy URL (see “Copying the URL of a Viewer preset” on page 41). This Presets list offers Viewer
Presets that administrators add and manage on the Viewer Presets screen. For example, all active eCatalog Viewer
presets appear on the Presets drop-down list in the Preview dialog box when a user previews an eCatalog.
Unless you deactivate Viewer Presets on the Viewer Presets screen, the Presets drop-down list in the Preview dialog
box can get crowded.
To activate or deactivate Viewer Presets
1 Choose Setup > Viewer Presets to open the Viewer Presets screen.
2 Select or deselect Active options to activate or deactivate Viewer Presets.
More Help topics
“About the Viewer Preset screen” on page 37
“About Universal Viewers” on page 42
Copying the URL of a Viewer preset
After you publish an asset, you can copy a URL for displaying the asset with the settings from a Viewer Preset.
The URL is copied to the Clipboard. You can use it as necessary in the HTML code of your web page, mobile device,
or application.
To copy the URL of a Viewer preset
1 Select the asset in the Browse Panel.
2 Above the Asset Browse panel, on the right side of the toolbar, do one of the following:
• Click Grid View. In the Asset Browse panel, double-click a single asset to open it in Detail View. In the URLs
and Embed Code panel on the right, click Copy URL to the right of the viewer you want.
• Click Grid View. In the Asset Browse panel, select a single asset, and then below the thumbnail image, click
Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Copy URL.
• Click List View. In the Asset Browse panel, select a single asset, and then to the right of the thumbnail image,
click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Copy URL.
• Click Grid View, List View, or Detail View. On the same toolbar, click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Copy URL.
Copying the embed code of a Viewer preset
Using the Embed Code feature lets you review the viewer code for the selected Viewer Preset. You can also copy the
code to the clipboard so you can paste it in your web pages for deployment of the viewer.
Editing of the code is not permitted in the Embed Code dialog box.
To copy the embed code of a Viewer preset
1 Select the asset in the Asset Browse Panel.
Last updated 10/9/2014
42
USING SCENE7
Setup
2 Above the Asset Browse panel, on the right side of the toolbar, do one of the following:
• Click Grid View. In the Asset Browse panel, double-click a single asset to open it in Detail View. In the URLs
panel on the right, click Embed Code.
• Click Grid View. In the Asset Browse panel, select a single asset, and then below the thumbnail image, click
Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Embed Code.
• Click List View. In the Asset Browse panel, select a single asset, and then to the right of the thumbnail image,
click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Embed Code.
• Click Grid View, List View, or Detail View. On the same toolbar, click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Embed Code.
3 In the Embed Code dialog box, click Copy to Clipboard.
4 Click Close.
About Universal Viewers
Note: Using Universal Viewers is not a best practice and, therefore, not recommended-they are intended for legacy use
only. As a best practice use the HTML5 viewers that come with Scene7 Publishing System.
See “Best practice: Using the HTML5 Video viewer” on page 207.
See also “Scene7 Viewer Preset compatibility matrix” on page 33.
You can use Universal Viewers to publish videos and images to multiple screens such as desktop, smartphones, and
tablets, all from a single URL.
In the past, because different platforms supported different technologies like Flash or HTML5, you had to create your
own viewers. Then, you had to write your own device detection to be able to switch between those different experiences.
Overall, the entire process required much more development work and also the maintenance of multiple URLs.
When you set up Universal Viewers, Scene7 provides you with a single universal URL that you can deploy and
integrate into your websites, mobile sites, and mobile apps. In addition, Scene7 Publishing System automatically does
the device detection, and serves your customers the right content, in the right viewer, to the right device.
The actual setup of Universal Viewers is done under Application Setup. The viewer types that you can set up include
Zoom, Image Set, Swatch Set, Spin, eCatalog, Video.
You can also use an existing Universal Viewer preset as the basis for creating own named, Universal Viewer profiles.
For example, you may decide to create different viewers of the same type for localization purposes, for different
business units within the same company, for product categories, or for each season (such as a Spring eCatalog
Universal Viewer and a Summer eCatalog Universal Viewer).
For each viewer type, such as Zoom, its targeted platforms and associated viewers are displayed, such as HTML-based
Viewers or viewers based on Flash technology. For each different targeted platform, you drag-and-drop the viewer that
you want to use with a particular device such as smartphone, tablet, or desktop.
For handheld smartphones, Android-based and Apple-based smartphones are supported. For tablets, Android-based
and Apple-based tablets are supported. For desktops, Flash Player is supported.
To edit the setup of Universal Viewers later on, be sure that you publish a job to Scene7 Image Server so that your
changes take effect.
Last updated 10/9/2014
43
USING SCENE7
Setup
See also Scene7 Viewer Library Examples.
Setting up Universal Viewers
Note: Using Universal Viewers is not a best practice and, therefore, not recommended-they are intended for legacy use
only. As a best practice use the HTML5 viewers that come with Scene7 Publishing System.
See “Best practice: Using the HTML5 Video viewer” on page 207.
See also “Scene7 Viewer Preset compatibility matrix” on page 33.
The viewers that are available for setup in Universal Viewers are a combination of all pre-defined Viewer Presets that
came with Scene7, and any custom viewers that you have added. It excludes any kind of custom viewers that you have
implemented but have not yet uploaded into Scene7 Publishing System.
You can see what viewers are exposed and selectable in Universal Viewers by looking at the viewers that are listed in
Viewer Presets.
See “Viewer Presets” on page 32.
If you are editing an existing Universal Viewer setup, be sure that you publish a job to Scene7 Image Server so that your
changes take effect.
To set up Universal Viewers
1 On the Setup menu, click Application Setup.
2 In the left panel, in the Application Setup tree, click Viewers > Universal Viewers.
3 Near the upper-left side of the Universal Viewers page, click a viewer type tab, or click the New Profile tab, and
then do one of the following:
Last updated 10/9/2014
44
USING SCENE7
Setup
If the viewer
type tab you
clicked is
Do the following:
Zoom, Image
Set, Swatch
Set, Spin, or
eCatalog
In the HTML-based Viewers group box or the Viewers for Adobe Flash group box, drag the viewer
that you want to use and drop it onto a device’s screen.
Video
To use the universal URL for video, you must group videos that are encoded at different bit rates into
an Adaptive Video Set. The reason for this is because you should not use the same video for playback
across different screens. For example, mobile devices typically require video at a lower bit rate,
however, desktop screens can accommodate a higher bit rate.
When you hover your pointer on a viewer, the device screens that are compatible with the viewer are
highlighted in the user interface; incompatible device screens are dimmed (not available).
•
In the video viewers group box, drag the viewer that you want to use and drop it onto the screen
for Desktop.
If you intend to support adaptive streaming on desktop computers, use the AS3
"Video" viewer.
•
In the Smart Phone text field or the Tablet text field, enter a target bit rate for playback on each
device. These fields apply only when there is no adaptive streaming. Adaptive streaming is
supported on Apple iOS devices for customers with the eVideo streaming license. In such case, the
video bit rate is automatically picked based on the detect bandwidth. Otherwise, Scene7 picks the
video in the Adaptive Video Set that has the closest bit rate to your target without going over and
plays that video by way of progressive download. Mobile devices have native, built-in video
players and, therefore, do not have viewers.
The bit rate is a measure of the video’s quality level. In other words, the higher the bit rate, the better
the video quality. Conversely, the lower the bit rate the lower the video quality. For example, you can
enter a lower target Kbps rate for smartphones because they are often used on a lower bandwidth
connection. Whereas, for higher bandwidth connections, you can enter a higher bit rate for a tablet
because your customers are likely using a Wi-Fi connection. It is recommended that you set the
target bit rate of "500" in the Smartphone category and "1000" in the Tablet category.
See “Best practices for video encoding” on page 215.
New Profile
•
In the drop-down list on the New Profile tab, select a viewer preset on which to base your new
Universal Viewer.
•
In the HTML-based Viewers group box or the Viewers for Adobe Flash group box, drag the viewer
that you want to use and drop it onto a device’s screen.
When you hover your pointer on a viewer, the device screens that are
compatible with the viewer are highlighted in the user interface; incompatible
device screens are dimmed (not available).
•
Double-click the New Profile tab, and then type the name of the new Universal Viewer in the text
field.
4 (Optional) On the Select image preset fallback drop-down list, select the name of the image preset that you want
to use.
If Scene7 encounters an unsupported device or screen, a static image is displayed using the preset settings that you
select from the drop-down list. The list is based on Image Presets that you have created and added in Scene7
Publishing System.
See “Creating and editing Image Presets” on page 23.
5 In the lower-right of the Universal Viewer page, click Save.
6 Click Close to return to the Browse page.
Last updated 10/9/2014
45
USING SCENE7
Setup
Previewing Universal Viewers
Note: Using Universal Viewers is not a best practice and, therefore, not recommended-they are intended for legacy use
only. As a best practice use the HTML5 viewers that come with Scene7 Publishing System.
See “Best practice: Using the HTML5 Video viewer” on page 207.
See also “Scene7 Viewer Preset compatibility matrix” on page 33.
You can preview the Universal Viewers that you have set to ensure that you have selected the right viewer for the right
device.
If you need to make any changes to the setup of Universal Viewers, be sure that you publish a job to Scene7 Image
Server so that your changes take effect.
See also Scene7 Viewers Reference Library Examples.
To preview Universal Viewers
1 In the Asset Library panel on the left side, navigate to the Asset folder that contains the asset that you want to
preview with a viewer.
2 Above the Assets Browse panel, on the right side of the toolbar, click Grid View, List View, or Detail View.
3 Depending on the View you are using, do one of the following:
• In the Asset Browse panel of the Grid View or List View, select a single asset. In the Preview drop-down list near
the thumbnail image, select Viewer List.
• In the toolbar above the Assets window of the Grid View, List View, or Detail View, in the Preview drop-down
list, click Viewer List.
4 Do one of the following:
• In the Viewer List table, click the column heading Platform Type to sort the column by ascending or descending
order.
In the Platform Type column, locate the names of viewers whose platform type is Universal, and then click
Preview in the row whose viewer you want to see.
• Near the upper-right corner of the Viewer List table, in the Platform drop-down list, select Universal to filter
the table on the Universal platform type.
Click Preview in the row whose Universal Viewer you want to see.
5 Close the displayed viewer in the browser pop-up window to return to the Viewer List screen.
6 In the lower-right corner of the screen, click Close to return to the Assets window.
Copying a Universal Viewer URL
Note: Using Universal Viewers is not a best practice and, therefore, not recommended-they are intended for legacy use
only. As a best practice use the HTML5 viewers that come with Scene7 Publishing System.
See “Best practice: Using the HTML5 Video viewer” on page 207.
See also “Scene7 Viewer Preset compatibility matrix” on page 33.
You can copy a universal URL either from within the Viewer List window or the Detail View window.
To copy a Universal Viewer URL
1 In the Asset Library panel on the left side, navigate to the Asset folder that contains the asset whose URL you want
to copy.
Last updated 10/9/2014
46
USING SCENE7
Setup
2 Do the following:
To copy the Universal URL by way of
Do one of the following:
Viewer List
•
Above the Assets window, on the right side of the toolbar,
click Grid View. In the Asset window, below a thumbnail
image of an asset, click Preview > Viewer List.
•
Above the Assets window, on the right side of the toolbar,
click List View. In the Asset window, select an asset, and
then to the right of the thumbnail image, click Preview >
Viewer List.
•
Above the assets window, on the right side of the toolbar,
click Detail View. On the same toolbar, click Preview >
Viewer List.
•
Above the Assets window, on the right side of the toolbar,
click Grid View. In the Asset window, double-click the
thumbnail image of a single asset to open it in Detail View.
Detail View
3 (This step is optional for Grid View or List View; it does not apply if you are in Detail View) In the Viewer List
window, in the URL Encoding for Copy URL Generation drop-down list near the lower-left corner, select the URL
encoding that you want applied to the asset’s URL when it is copied.
4 Do one of the following:
• If you are accessing by way of the Viewer List window, click Copy URL in the row that has Universal as the
Platform type.
• If you are accessing by way of Detail View, in the URLs panel, under the Universal Presets heading, click Copy URL.
Copying the embed code of a Universal Viewer
Note: Using Universal Viewers is not a best practice and, therefore, not recommended-they are intended for legacy use
only. As a best practice use the HTML5 viewers that come with Scene7 Publishing System.
See “Best practice: Using the HTML5 Video viewer” on page 207.
See also “Scene7 Viewer Preset compatibility matrix” on page 33.
Using the Embed Code feature lets you review the viewer code for the selected Universal viewer. You can also copy the
code to the clipboard so you can paste it in your web pages for deployment of the viewer. Editing of the code is not
permitted in the Embed Code dialog box.
To copy the embed code of a Universal Viewer
1 in the Asset Library panel on the left side, navigate to an asset folder that contains an asset whose Universal viewer
embed code you want to copy.
2 Above the Asset Browse panel, on the right side of the toolbar, do one of the following:
• Click Grid View. In the Asset Browse panel, double-click a single asset to open it in Detail View. In the URLs and
Embed Code panel on the right, under Universal Presets, click Embed Code to the right of the viewer you want.
• Click Grid View. In the Asset Browse panel, select a single asset, and then below the thumbnail image, click
Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Embed Code to the right of a viewer whose
platform type is Universal.
Last updated 10/9/2014
47
USING SCENE7
Setup
• Click List View. In the Asset Browse panel, select a single asset, and then to the right of the thumbnail image,
click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Embed Code to the right of a viewer whose
platform type is Universal.
• Click Grid View, List View, or Detail View. On the same toolbar, click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Embed Code to the right of a viewer whose
platform type is Universal.
3 In the Embed Code dialog box, in the text field, specify a target DIV layer name for the Universal viewer embed code.
You can specify any name you want. The name simply helps you to keep DIV layers organized and is used in the
setTargetDiv tag of the embed code.
4 Click Get Embed Code.
Editing the code is not permitted in the Embed Code dialog box.
5 Click Copy to Clipboard.
6 Click Close.
Configuring Default Viewers
You can use Default Viewers to configure the default viewer that is associated with an asset when you use Preview in
Scene7 Publishing System. You can set up the default preview experience for the following asset types:
• Image
• Video
• SpinSet
• Catalog
• ImageSet
• SwatchSet
• MediaSet
• Video Recut
“Previewing an asset” on page 102
To configure default viewers
1 In the Setup drop-down list, click Application Setup.
2 In the Setup window, in the left pane, expand Application Setup > Viewers
3 Click Default Viewers.
4 In the Default Viewers window, in the drop-down list for each asset type, select the viewer that you want to associate
with the asset’s preview.
5 In the lower-right corner of the Default Viewers window, click Save Settings.
6 In the lower-right corner of the Setup window, click Close to return to the Asset window.
Last updated 10/9/2014
48
USING SCENE7
Setup
Metadata Views
Metadata is standardized information about an asset. You can use metadata to streamline your workflow, organize
your assets, and improve searching. Scene7 supports the IPTC (International Press Telecommunications Council)
standard and the XMP (extensible metadata platform) standard. Before users view or enter metadata about an asset in
Detail view, they can open the Metadata Views menu and choose the set of metadata fields that they want to view or
use to describe the asset.
Scene7 comes with pre-defined Metadata Views, and administrators can create their own Metadata Views for users to
choose when they enter metadata.
More Help topics
“Viewing, adding, and exporting metadata” on page 108
Creating a Metadata View
1 Choose Setup > Application Setup > Metadata Views.
2 Click Add.
3 Enter a name for the view in the Preset Name field.
4 (Optional) Check Make Default to make this view the one that users see when they open the Metadata panel in
Detail View.
5 (Optional) Select Include UDF to include user-defined fields in the view. User-defined fields appear at the top of
the Metadata panel in Detail View.
6 Select the fields you want for the view (click Select All to select all the fields).
7 Click Save.
The selected categories and fields for the view appear in the Preview panel.
Managing Metadata Views
1 Choose Setup > Application Setup > Metadata Views.
2 Do any of the following:
• To preview a view, select it. The fields in the view appear in the Preview panel.
• To edit a view, select it and click Edit. Then select or deselect field names on the Preview panel, and select or
deselect the Include UDF option.
• To delete a view, select it and click Delete
• To make a view the default, select it and click Make Default. The default view is the one that users see when they
open an asset in Detail view and go to the Metadata panel.
Metadata Presets
Metadata Presets give administrators a way to control and regulate metadata that is assigned to assets. In Detail view,
a user can enter metadata about an asset in fields provided for that purpose. For example, a user can enter an owner
name, copyright description, and address. To ensure that users enter this information accurately and completely, you
can create Metadata Presets. Choosing a Metadata Preset in Detail view populates metadata fields with pre-defined
values. For example, an owner name, copyright description, and address are entered automatically.
Create a Metadata Preset for each set of metadata values you want users to be able to enter automatically in Detail view
to describe an asset.
Last updated 10/9/2014
49
USING SCENE7
Setup
More Help topics
“Viewing, adding, and exporting metadata” on page 108
“User-Defined Fields” on page 49
Creating or editing a Metadata Preset
1 Choose Setup > Application Setup > Metadata Presets.
2 In the Metadata Presets screen, do one of the following:
• To create a preset, click Add. Type a name for the preset in the Metadata Template Name field and then click
Metadata Views and choose a view on the drop-down list (see “Metadata Views” on page 48).
• To edit an existing preset, select the preset from the Metadata Presets list and click Edit.
3 Expand headings you want to include in the preset and enter values in the different fields you want to include in
the preset.
4 Click Save.
The selected categories and fields for the preset appear in the Preview panel.
Managing Metadata Presets
1 Choose Setup > Application Setup > Metadata Presets.
2 Do any of the following:
• To preview a preset, select the preset you want to preview. The preset information (categories and fields) appears
in the Preview screen.
• To delete a preset, select the preset and click Delete.
User-Defined Fields
A Media Portal Administrator or a Company Administrator can create custom, user-defined metadata fields. Custom
field help you organize assets in the Scene7 Publishing System. The fields can also be marked as Active, as necessary.
When activated, the names of these custom metadata fields appear in the Metadata panel in Detail view. Users can
enter information in user-defined metadata fields to describe assets. Users can also make a user-defined metadata field
a criterion in searches.
One effective use of user-defined metadata fields is to delay the activation time of an asset for a specific launch or sale.
You define an “activation” and a “deactivation” field, both based on the type Date. Then, using the Metadata panel in
Detail view or File > Edit Info, you can specify when the asset is activated and when it is deactivated. Scene7
Publishing System checks the publish status of an asset, and the publish history. If it is not within the activation time,
the publish status will show as “Not Published”.
Note: To make user-defined fields appear in the Metadata panel in Detail view, include user-defined fields in Metadata
Views. On the Metadata Views screen, select the Include UDF (user-defined fields) option. For more information, see
“Metadata Views” on page 48.
Important: To search for assets using custom, user-defined fields, click Setup > Personal Setup, and then select Include
UDFs in Search. See “Personal Setup” on page 15.
Creating a user-defined metadata field
1 Click Setup > Application Setup > Metadata > User-Defined Fields.
2 Click Add
Last updated 10/9/2014
50
USING SCENE7
Setup
3 In the Custom Field dialog box, set the options you want.
Name Enter a name for the metadata field.
Type Choose an option that defines the type of information that users can enter in the metadata field:
• String A text string.
• Int An integer.
• Float A floating-point number.
• Yes/No A yes/no Boolean value.
• Date A date. The MM/DD/YYYY format is accepted.
• Filename The name of a file.
• Color The name of a color.
• Dimension The width and height of the asset.
• Untyped For backwards-compatibility. Do not select this option.
Default Value Optionally, enter the value users are most likely to enter in the field. The value you enter becomes
the default value for the field you create.
Applies To Optionally, choose an asset type if you want the metadata field to apply only to a specific type of asset.
Important: Choose an Applies To option carefully because you cannot change the Applies To option after you create
a user-defined field. Scene7 lets you edit the name, type, and default value of a user-defined field, but not the Applies
To setting.
4 Click Save when you finish creating the metadata field.
Manage user-defined fields
The User-Defined Fields screen offers commands for managing custom, user-defined metadata fields.
Only a Media Portal Administrator or a Company Administrator can manage user-defined fields.
To open this screen, click Setup > Application Setup > Metadata > User-Defined Fields.
Editing a field Select the field, and then click Edit.
Deleting a field Select the field, and then click Delete.
Activating and deactivating fields Click to select or deselect the Active option next to the name of a field. If you are in
a company administration role, this option may not be shown. Because this option is related to MediaPortal, you must
select (turn on) Show MediaPortal Features in Personal Setup to see the activating and deactivating fields.
Optimize Files
As you upload files to the Scene7 Publishing System, the system optimizes them for storage and publishing. If the
upload process is interrupted, however, some images cannot be optimized. In this case, you see the “Image not yet
optimized” message. You can, however, optimize these files if you are an administrator.
Scene7 Publishing System searches through your files and optimizes only those images that were not fully optimized
before.
1 Choose Setup > Application Setup, and then select Optimize Files.
2 Enter information for the optimization job and click Submit.
Last updated 10/9/2014
51
USING SCENE7
Setup
If you are working with more than one company, optimize files belonging to different companies separately.
More Help topics
“Checking job files” on page 93
Batch Set Presets
Use the batch set presets to automatically create image sets or spin sets while a job is running to upload assets to the
Scene7 Publishing System.
Company administrators first define naming conventions for the assets that they want to group together in a set. You
can then create abatch set preset to reference these images. Each preset is a uniquely named, self-contained set of
instructions that defines how to construct the set using images that match the defined naming conventions in the
preset recipe.
All active batch set presets for a company are listed on the Upload Job Option dialog box, so you can specify which
preset you want applied during each upload session. Company administrators see all active and inactive batch set
presets. When you upload files, Scene7 automatically creates a set with all files that match the defined naming
convention in the active presets.
Default Naming
The company administrator creates a default naming convention that is used in any batch set preset recipe. The default
naming convention selected in the batch set preset definition may be all your company needs to batch-generate sets
for all websites. A batch set preset is created to use the default naming convention you define. You are able to create as
many Batch Set presets with alternate, custom naming conventions needed for a particular set of content in cases
where there is an exception to the company-defined default naming.
While setting up a default naming convention is not required to use batch set preset functionality, best practice
recommends that you use the default naming convention to define as many elements of your naming convention that
you want grouped in a set in order to streamline batch set creation.
1 Click Setup > Application Setup > Batch Set Presets > Default Naming.
2 Select View Form or View Code to specify how you want to view and enter information about each element.
You can select the View Code check box to view the regular expression value building alongside your form
selections. You are able to enter or alter these values to help define the elements of the naming convention, if the
form view limits you for any reason. If your values are unable to be parsed in the form view, the form fields will
become inactive.
Note: De-activated form fields do not indicate invalid regular expression. There is no validation that your regular
expressions are correct. You will see results of the regular expression you are building for each element after the Result
line. The complete regular expression is visible at the bottom of the page.
3 Expand each element as necessary and enter the naming conventions you want to use.
4 As necessary, click Add to add another naming convention for an element. Or click Remove to delete a naming
convention for an element.
5 Click Save As and type a name for the preset. Or click Save if you are editing an existing preset.
Alternately, you can use View Code with no form fields available. In this view you create your naming convention
definitions entirely using regular expressions.
Last updated 10/9/2014
52
USING SCENE7
Setup
Two elements are available for definition, Match and Base Name. These fields let you define all elements of a naming
convention and identify the part of the convention used to name the set in which they are contained. A company’s
individual naming convention may make use of one or more lines of definition for each of these elements. You can use
as many lines for your unique definition and group them into distinct elements, such as for Main Image, Color
element, Alternate View element, and Swatch element.
Creating a batch set preset
Scene7 uses batch set presets to organize assets that share some common information or content into sets of images
for display in viewers. The batch set preset recipes automatically run alongside the asset import jobs you schedule in
Scene7.
Use Batch Set Preset to create, edit, and manage your batch set presets. You can create as many batch set presets as
necessary to cover all asset ingest jobs you require. There are two forms of batch set preset definitions: one for a default
naming convention that you might have set up, and one for custom naming conventions that you create on the fly.
You can use the either the form field method to define a batch set preset or the code method, which lets you use regular
expressions. As in Default Naming, you can choose Code View at the same time you are defining in the Form View
and use of regular expressions to build your definitions. Alternately, you can uncheck either view to use one or the
other exclusively.
See also “Creating a batch set preset for the auto generation of a 2D Spin Set” on page 53.
To create a batch set preset
1 Click Setup > Application Setup > Batch Set Presets > Batch Set Preset. View Form, as set in the upper-right
corner of the Details page, is the default view.
2 In the Preset List panel, click Add to activate the definition fields in the Details panel on the right hand side of the
screen.
3 In the Details panel, in the Preset Name field, type a name for the preset.
4 In the Batch Set Type drop-down menu, select a preset type.
To autogenerate a 2D Spin Set, select Multi-Axis Spin Set from the Batch Set Type drop-down list.
5 Do one of the following:
• If you are using a default naming convention that you previously set up under Application Setup > Batch Set
Presets > Default Naming, expand Asset Naming Conventions, and then in the File Naming drop-down list,
click Default.
• To define a naming convention as you set up the preset, expand Asset Naming Conventions, and then in the
File Naming drop-down list, click Custom.
6 For Sequence order, define the order for the images after the set is grouped together in Scene7. By default, your
assets are ordered alphanumerically. However, you can use a comma-separated list of regular expressions to define
the order.
7 For Set Naming and Creation Convention, specify the suffix or prefix to the base name you defined in the Asset
Naming Convention. Also define where the image set will be created within the Scene7 folder structure.
If you define large numbers of image sets, you may prefer to keep these separate from the folders that contain the
assets themselves. Many customers create an Image Sets folder and redirect the application to place batch set
generated sets here.
8 Click Save in the Details Panel.
Last updated 10/9/2014
53
USING SCENE7
Setup
Creating a batch set preset for the auto generation of a 2D Spin Set
You can use the Batch Set Type Multi-Axis Spin Set to create a “recipe” that automates the generation of 2D Spin Sets.
The grouping of images uses Row and Column regular expressions so that the image assets are properly aligned in the
corresponding location in the multi-dimensional array.
See also “Creating a batch set preset” on page 52.
There is no minimum or maximum number of rows or columns that you must have in a multi-axis spin set.
As an example, suppose you want to create a multi-axis spin set named spin-2dspin. You have a set of spin set images
that contain three rows, with 12 images per row. The images are named as follows:
spin-01-01
spin-01-02
…
spin-01-12
spin-02-01
…
spin-03-12
With this information, your Batch Set Type recipe might be created as follows:
Batch Set Type recipe for a 2D Spin Set.
Grouping for the shared asset name part of the spinset is added to the Match field (as highlighted). The variable part
of the asset name containing the row and column is added to the Row and Column fields, respectively.
Last updated 10/9/2014
54
USING SCENE7
Setup
When the Spin Set is uploaded and published, you would activate the name of the 2D Spin Set recipe that is listed under
Batch Set Presets in the Upload Job Options dialog box.
To create a batch set preset for the auto generation of a 2D Spin Set
1 Choose Setup > Application Setup > Batch Set Presets > Batch Set Preset. View Form, as set in the upper-right
corner of the Details page, is the default view.
2 In the Preset List panel, click Add to activate the definition fields in the Details panel on the right hand side of the
screen.
3 In the Details panel, in the Preset Name field, type a name for the preset.
4 In the Batch Set Type drop-down menu, select Asset Set.
5 In the Sub Type drop-down list, select Multi-Axis Spin Set.
6 Expand Asset Naming Conventions, and then in the File Naming drop-down list, click Custom.
7 Use the Match and, optionally, Base Name attributes to define a regular expression for the naming of image assets
that make up the grouping.
For example, your literal Match regular expression might look like the following:
(\w+)-\w+-\w+
8 Expand Row Column Position, and then define the name format for the position of the image asset within the 2D
Spin Set array.
Use the parenthesis to embrace the row or column position in the file name.
For example, for your row regular expression, it might look like the following:
\w+-R([0-9]+)-\w+
or
\w+-(\d+)-\w+
For your column regular expression, it might look like the following:
\w+-\w+-C([0-9]+)
or
\w+-\w+-C(\d+)
Remember that these are only examples. You can create your regular expression however you want to suit your
needs.
Note: If the combination of row and column regular expressions is unable to determine the position of the asset within
the multi-dimensional spinset array, then that asset is not added to the set and an error is logged.
9 For Set Naming and Creation Convention, specify the suffix or prefix to the base name you defined in the Asset
Naming Convention. Also define where the image set will be created within the Scene7 folder structure.
If you define large numbers of image sets, you may prefer to keep these separate from the folders that contain the
assets themselves. Many customers create an Image Sets folder and redirect the application to place batch set
generated sets here.
10 Click Save in the Details Panel.
11 Upload and publish your Spin Set as usual making sure you activate the name of your 2D Spin Set in the Job Load
Options dialog box, under Batch Set Presets.
Last updated 10/9/2014
55
USING SCENE7
Setup
See “Upload and publish assets” on page 79.
Publish Setup
The Publish Setup screen settings determine how assets are delivered by default from Scene7 servers to web sites or
applications. If no setting is specified, the Scene7 server delivers an asset according to a default setting on a Publish
Setup screen. For example, a request to deliver an image that does not include a resolution attribute yields an image
with the Default Object Resolution setting on the Image Server screen.
Administrators can change the default settings on the Image Server, Image Renderer, and Vignette screens to establish
default settings for delivering assets from servers.
To open the Publish Setup screens, click Setup > Application Setup > Publish Setup.
Important: The Publish Setup screens are for use by experienced web site developers and programmers. Scene7 assumes
that users who change settings on these screens are familiar with the Scene7 Publishing System, HTTP protocol standards
and conventions, and basic imaging technology.
Image Server
The Image Server screen establishes default settings for delivering images from image servers. Settings are available in
these five categories (see the Image Server screen itself for detailed descriptions of the settings).
Change these settings only with the assistance of a Scene7 support person.
Catalog Management These settings determine how Scene7 Publishing System and the catalog interact. Unlike most
web servers, Scene7 Image Server URL calls go to a manifest, or catalog, file rather than an image file proper. The
catalog file (not to be confused with an eCatalog) contains a list of all content published to the image server along with
the path to each image. If you have a Digimarc ID, enter your user information in the Digimarc User Info section.
Request Attributes These settings impose limits on images that can be delivered from the server.
Default Request Attributes These settings pertain to the default appearance of images.
Common Thumbnail Attributes These settings pertain to the default appearance and alignment of thumbnail images.
Defaults for Catalog Fields These settings pertain to the resolution and default thumbnail type of images.
Color Management Attributes These settings determine which ICC color profiles are used.
Compatibility Attributes This setting enables leading and trailing paragraphs in text layers to be treated as they were
in version 3.6 for backwards compatibility.
Localization Support These settings let you manage multiple locale attributes. It also lets you specify a locale map
string so you can define which languages you want to support for the various tooltips in Viewers.
For example, if you are a multi-national brand that sells in different countries, you can ensure that each country has
their own locale-specific Viewer. To accomplish this functionality, you specify a locale map string. Then you edit the
tooltip text in a Viewer’s preset by adding the translated text strings for the language you want.
Note: To set up Localization Support options, contact Adobe Scene7 Technical Support or send an email to
s7support@adobe.com requesting setup help.
For more information about setting up Localization Support, see “Considerations when setting up localization of
assets” on page 56.
See also “Adding localization support to a Flash AS3 Viewer preset” on page 39.
Last updated 10/9/2014
56
USING SCENE7
Setup
Considerations when setting up localization of assets
Note: If you want to set up Localization Support options in Scene7 Publishing System, such as the Locale Map field,
contact Adobe Scene7 Technical Support. Or, send an email to s7support@adobe.com requesting setup help.
A common way to use the Scene7 Publishing System (SPS) is to manage the product imagery on e-Commerce websites.
International businesses face the challenge that assets for similar products look different from country to country.
Usually the differences are for a very few part of the overall media. Addressing such differences by copying all assets
for each of the countries and over-write just the differences is a tremendous effort and contradicts the single master
asset metaphor. Such differences for assets can endure, from country-specific videos with different audio tracks, to
subtle but important differences in a power cord that is used with the product. S7 uses a basic lookup mechanism. You
define an order of asset suffixes in which the Image Server is looking, starting from the required locale.
How assets are localized
The locale for an IS (Image Serving) request is identified with the following IS/IR (Image Rendering) command:
locale=
This command accepts a locale id (locId) string which is not case-sensitive. The locale id is typically a 2-6 character
string composed of letters and “_”.
IS supports arbitrary printable ASCII strings.The locale= command has a global scope, meaning that it is applied to
the entire request, including all nested IS and IR requests, referenced templates, and image layers. Multiple locales per
request, such as a different locale for each layer, is not supported. However, it is conceivable to allow explicit overrides
in nested requests.
If locale= is not specified, attribute::DefaultLocale is passed to the translation engines. Limited input
validation is applied to the locale= value. Empty locale= values are permitted. Because locale= has a global scope,
attribute::DefaultLocale is provided by the main catalog for the entire request.
Some of the benefits of using locale= and attribute::DefaultLocale include the following:
• Share contents for multiple locales.
• Access locale-specific contents using generic ids.
• Allow flexibility around naming conventions and the management of locale-specific contents, such as locale prefix
versus suffix, or locale-specific contents in a separate catalog.
• Support direct access to locale-specific versions.
• Aggregate objects, such as image sets, may contain generic references to potentially locale-specific contents.
• Supports all contents managed by catalogs that may need localization, including images, image sets, vignettes,
materials, and viewer configuration records.
• Minimize changes to the IPS database and IS manifest mechanisms.
• Support for static contents such as videos and skins will be added when RFC IS-63 is implemented.
• The default locale is configurable.
Application scenarios
Last updated 10/9/2014
57
USING SCENE7
Setup
Application
Scenario
Viewer localization
After static content catalogs are implemented, localization is controlled entirely with
the locale= parameter, appended to all requests that are made to IS. Configuration
records, skins, splash screens, and so on, can have locale-specific variants or not. The
correct contents is provided by IS without the viewer needing to know which contents
is localized and what its IDs are.
Images and video
Multi-national companies often have a mix of generic and locale-specific contents. With
this mechanism, a reference to an image or video can be generic, and IS serves up the
locale-specific contents if it is available.
Image sets and Media sets The entire image set can be different for some locales--such as when a eCatalog is
completely different--with the translation from a generic to a locale-specific image set
handled by the viewer.
More commonly, individual IDs in a generic set may refer to localized contents. For
example, most photos of an appliance can be the same in all languages, except the
photo of the control panel. IS automatically translate IDs, so there is no need to
generate locale-specific image sets.
Implementing asset localization
Scene7 Publishing and Image Serving have an interface that allows for the localizations of images and static content.
Without localization, an Image Server URL looks like the following:
http://server/is/image/company/image
With localization, an Image Server URL adds the locale= parameter to the path, as in the following:
http://server/is/image/company/image?locale=de_DE
On receipt of the http call by the Image Server, the locale= parameter is parsed through the localeMap field found in
Setup > Application Setup > Publish Setup > Image Server > Localization Support group.
The Locale Map field contains a list of entries that are separated using the pipe symbol (|).
Each entry consists of a comma-separated list of values. The first value is the search value that is passed by the locale=
parameter. The remaining values are suffix/replacement values that are subsequently tried until one results in an
existing image.
Whether a suffix value or a replacement value is applied depends on the Global Locale setting in Setup > Application
Setup > Publish Setup > Image Server > Localization Support group.
Note: The Global Locale setting is currently only possible when you set it through the API, not within the Scene7
Publishing System interface.
Suffix example
URL
localeMap IDs
Result
http://serve
r/is/image/c
ompany/image
?locale=de_D
E
de_DE,_DE,|fr_FR,_FR,
Notice that there is no GlobalLocale
defined. The locale parameter de_DE is
matched against the first entry in the
localeMap. The first corresponding value
_DE is added as a suffix to the asset
image_DE and an attempt is made to find
it on the Image Server. If it is found on the
server, it is returned. Otherwise, the second
value “” is used as a suffix, resulting in the
image itself being returned.
Last updated 10/9/2014
58
USING SCENE7
Setup
Replacement example
URL
GlobalLocale and localeMap IDs
Result
In the replacement example above,
GlobalLocale is set to main. The locale
parameter de_DE is matched against the
first entry in the localeMap. The
GlobalLocale substring is found and
replaced with the first corresponding value
de in the localeMap: image-de-01. If it is
found on the Image Server, it is returned. If
not, the second value is replaced, resulting
in image-main-01.
http://server/is/ima GlobalLocale=main
ge/company/imagemain-01?locale=de_DE localeMap de_DE,de,main|fr_FR,fr,main
If no locale is defined in the URL, the Image Server takes the DefaultLocale, if it is defined, and applies it to the URL.
If an unknown or empty locale parameter is supplied with locale=, then the localeMap is scanned for the empty value
“starting with,”. It is important to configure this to have a default locale applied for unknown locales.
About the defaultImage
The Image Server tries the options for the requested locale, one after the other. If no match is found, the locale options
are applied to the defaultImage, and the matching version is returned. Therefore, either each locale should include an
option for the image without localization, or localized defaultImage versions should be made available in Scene7
Publishing System.
Scenarios for finding the localeMap
Suppose you want to support the following locales:
en, en_us, en_uk, de, de_at, de_de, fr
You map these locales to the suffixes _E, _G, and _F, for English, German, and French, respectively. For all examples,
the generic input image ID is myImg.
Standard behavior for finding the localeMap
The locale IDs are mapped to their corresponding suffixes. If no locale-specific ID is found in the catalog, the generic
ID is tried. Note the empty locSuffix values which map to the generic ID.
attribute::LocaleMap=en,_E,|en_us,_E,|en_uk,_E,|fr,_F,|de,_D,|de_at,_D,|de_de,_D,
locale=
Output IDs to search
en,en_us, en_uk
myImg_E, myImg
de,de_de,de_at
myImg_D, myImg
fr
myImg_F, myImg
All others
-
Finding the localeMap when the locale is unknown
You can map unknown locales to specific IDs or to generic IDs. For our example, you can map unknown locales to the
English IDs, or if they do not exist, to the generic IDs.
attribute::LocaleMap=en,_E,|en_us,_E,|en_uk,_E,|fr,_F,|de,_D,|de_at,_D,|de_de,_D,|,_E,
Last updated 10/9/2014
59
USING SCENE7
Setup
locale=
Output IDs to search
de,de_de,de_at
myImg_D,myImg
fr
myImg_F,myImg
All others
myImg_E,myImg
You could also have a dedicated locSuffix, such as U, just for unknown locales, and force to the default image if no _U
exists, as in the following:
attribute::LocaleMap=en,_E,|en_us,_E,|en_uk,_E,|fr,_F,|de,_D,|de_at,_D,|de_de,_D,|,U
Or, you can map directly to the generic ID, as in the following:
attribute::LocaleMap=en,_E,|en_us,_E,|en_uk,_E,|fr,_F,|de,_D,|de_at,_D,|de_de,_D,|,
Finding the localeMap using a multi-tiered lookup
It is often desirable to group locales, such as European, Middle Eastern, and North American, to address regional
standards, such as skin exposure. You can achieve this effect using a multi-tiered lookup.
For this example, suppose you want to support collections for Western and Middle Eastern use. Both collections are
based on the generic image collection, and both add or modify some images. Both collections are then further refined
for specific locales, such as m1, m2 for two middle-eastern variants, and w1, w2, and w3 for three Western locales,
except that images are shared for w1 and w3. Unknown locales are mapped only to the generic collection and do not
have access to locale-specific images. The following is what the map would look like:
attribute::LocaleMap=w1,-W,|w2,-W2,-W,|w3,-W,|m1,-M1,-M,|m2,-M2,-M,|,
locale=
Output IDs to search
w1, w3
myImg-W, myImg
w2
myImg-W2, myImg-W, myImg
m1
myImg-M1, myImg-M, myImg
m2
myImg-M2, myImg-M, myImg
All others
mylmg
Finding the localeMap by searching for specific IDs
Some image naming conventions may not support generic image IDs. The generic IDs from the request must be
mapped to a specific ID in the catalog. However, there may be instances where the exact specific ID is not known.
Using the first example as a basis, images for all languages may have the suffixes _1, _2, or _3. Images that are specific
to French locales may have the suffixes _22 or _23 suffix. And images that are specific to German locales may have the
suffixes _470 or _480.
attribute::LocaleMap=,_1,_2,_3|fr,_22,_23,_1,_2,_3|de,_470,_480,_1,_2,_3|de_at,_470,_480,_1,
_2,_3|de_de,_470,_480,_1,_2,_3
locale=
Output IDs to search
fr
myImg_22, myImg_23, myImg_1, myImg_2, myImg_3
de, de_at, de_de
myImg_470, myImg_480, myImg_1, myImg_2,myImg_3
All others
myImg_1, myImg_2, myImg_3
Last updated 10/9/2014
60
USING SCENE7
Setup
Important considerations when implementing localization support
• Localization is limited to ID-based asset calls and cannot be used on path-based asset calls. Therefore, when calling
videos with locale, it must be called as company/assetID; no full path to the video. This means that you cannot use
rtmp with localization because that method is for use with path-based video calls only.
• You cannot use a Mixed Media Set that contains a single video when localeMap is active, otherwise the call to the
contents of the set fails. To work around this issue you can add a single video to an Adaptive Video Set. Then, add
the Adaptive Video Set to a Mixed Media Set.
• Certain requests are not localized, such as requests for the contents of an Adaptive Video Set. Therefore, if you
intend to use Adaptive Video Sets with localization, you should place the Adaptive Video Set within a Mixed Media
Set. Then, call the set into a Mixed Media viewer with the locale= parameter.
Image Renderer
The Image Renderer screen establishes default settings for delivering Image Sets from image rendering servers.
Settings are available in these five categories (see the Image Server screen itself for detailed descriptions of the settings):
Catalog Management These settings determine how Scene7 Publishing System and the catalog file interact. Scene7
Render Server URL calls are made to the catalog, which in turn calls to deliver images from the server. Change these
settings only with the assistance of a Scene7 support person.
Session Attributes These settings establish error parameters, the URL for relative image URLs, and whether object
overlapping is permitted.
Default Material Attributes These settings establish default resolution and sharpening settings for images.
Response Image Attributes These settings pertain to the default appearance of images.
Color Management Attributes These settings pertain to the default color settings of images.
Vignette
The Vignette screen offers settings for establishing the default appearance of vignettes (see the screen itself for detailed
descriptions of options).
Video SEO (Search Engine Optimization)
SEO is the process of improving the volume of traffic to a Web site from search engines. While search engines excel at
gathering information about text-based content, they cannot adequately acquire information about video unless this
information is provided to them.
Using Scene7 Video SEO, you can leverage video metadata to provide search engines with descriptions of your videos.
Scene7 provides the ability to create Video Sitemaps and mRSS feeds. These are standard XML files for submitting
video information to search engines:
Video Sitemap Informs Google exactly where and what the video content is on a site. Consequently, videos are fully
searchable on Google. For example, a Video Sitemap can specify the running time and categories of videos. For
information about video Sitemaps, see http://www.google.com/support/webmasters/bin/answer.py?answer=80471.
mRSS (Media Really Simple Syndication) feed Used by content publishers to feed media files into Yahoo! Video
Search. For information about mRSS feeds, see http://www.rssboard.org/media-rss.
Note: Google supports both the Video Sitemap and mRSS feed protocol for submitting information to search engines.
Last updated 10/9/2014
61
USING SCENE7
Setup
Scene7 can generate Video Sitemaps and mRSS feeds from metadata that is stored with each video. When you create
Video Sitemaps and mRSS feeds, you decide which metadata fields from video files to include. In this way, you describe
your videos to search engines so that search engines can more accurately direct traffic to videos on your web site
Important: Before creating a Video Sitemap or mRSS feed, find out which fields the search engine requires in the XML
file and how to structure these fields. To create a successful Video Sitemap or mRSS feed, it must satisfy the requirements
of the search engine.
Scene7 creates reports about Video Sitemaps and mRSS feeds after you generate them. These reports are available on
the Video SEO Report screen.
Important: For the Video Sitemaps and mRSS feeds, Scene7 captures metadata only from videos that are marked for
publish. Mark videos for publish to include their metadata in Video Sitemaps and mRSS feeds.
Choosing Video SEO settings
Choose Video SEO settings for Video Sitemaps and mRSS feeds on the Video Search Engine Optimization Settings
screen. To open this screen, choose Setup > Application Setup > Video SEO > Settings.
In the General Setting area, choose whether to generate Video Sitemaps, mRSS feeds, or both. In the Generation
Settings area, map metadata fields to input fields.
After you choose settings, click Generate (or Save & Generate) to create the Video Sitemap, mRSS feeds, or both.
Choosing General Settings
On the Generation Mode drop-down list, choose a report mode:
Video Sitemap Create a Video Sitemap.
mRSS Feed Create a Media RSS (mRSS) feed.
Both Create both types of XML files.
Off Choose this option to stop generating Video Sitemaps and a Media RSS (mRSS) feeds.
On the Automatic/Manual Mode drop-down list, choose whether to generate automatically or manually:
Automatic Mode Scene7 automatically generates one Video Sitemap, Media RSS (mRSS) feed, or both, each day.
Choose the Mark for Publish option to automatically mark for publish the XML file that Scene7 generates.
Manual Mode Scene7 generates the Video Sitemap, Media RSS (mRSS) feed, or both, when you click Generate or Save
& Generate in the Video Search Optimization Settings screen. Choose these options as well:
• No Further Settings Doesn't mark for publish the XML file that is generated.
• Mark for Publish Marks for publish the XML file that is generated.
• Allow Partial Generation Search engines may reject an XML file if it doesn’t contain complete metadata
information for all videos. This option generates the XML file even if metadata isn’t available for some videos. A
warning is registered on the Report screen. Choose this option if you intend to export the XML file and process the
missing information manually.
Last updated 10/9/2014
62
USING SCENE7
Setup
Choosing Generation Settings
The Generation Settings area lists input fields for the Video Sitemap and/or mRSS feed, and in the Metadata panel, the
names of metadata fields. Use the General Settings area to map input fields to metadata fields. By doing so, you tell
Scene7 where to obtain metadata for the Video Sitemap and/or mRSS feed.
1 On the Metadata Views menu, choose a metadata view. After you choose a view, the names of metadata fields
appear in the Metadata panel. (For information about metadata views, see “Metadata Views” on page 48.)
2 Drag metadata field names from the Metadata panel to the Landing Page, Title, Description, Tags, and Category
input fields. The Landing Page, Title, and Description fields are required.
Note: You can also manually enter data in input fields.
3 Click Save (to save your settings without generating the XML file), Generate (to generate the XML file), or Save &
Generate (to save and generate the file).
The XML file is generated and recorded in the Job log. Video Sitemap (video-sitemap) and a Media RSS (mRSS)
feed (mrss-feed) files are stored in the root folder of your company.
Note: You must publish the Video Sitemap or mRSS feed before you can submit it to search engines. Video Sitemap and
Media RSS (mRSS) feed files are stored in the root folder of the company. Mark these XML files for publish, if necessary,
and click Publish.
Submitting Video Sitemap and mRSS-Feed files to search engines
Video Sitemap and Media RSS (mRSS) feed files are stored in the root folder of the company:
• http://{publish-server}/is/content/{companyname}/mrss-feed.xml
• http://{publish-server}/is/content/{companyname}/video-sitemap.xml
Copy one of these URLs into the search engine’s webmaster tools to submit your Video Sitemap or Media RSS (mRSS)
feed file to search engines.
Viewing Video SEO reports
View Video SEO reports on the Video Search Engine Optimization Report screen. To open this screen, choose Setup
> Application Setup > Video SEO > Reports.
If errors occurred when a report was generated, they are listed on the Report screen.
Administration Setup
The Administration Setup screens are for administering Scene7 Publishing System users. Use these screens to enable
users to work in the Scene7 Publishing System and to communicate by e-mail with users.
❖ To access Administration Setup options, click Setup > Personal Setup. Expand Administration Setup.
User Administration
All Scene7 users are assigned a role that determines their privileges and access rights to features in Scene7 Publishing
System. Administrators determine the different roles and responsibilities for the companies to which they are assigned.
Typically, Scene7 configures the first set of companies and assigns a company administrator. The company
administrator then sets up and administers Scene7 Publishing System users.
Last updated 10/9/2014
63
USING SCENE7
Setup
Scene7 Publishing System supports three user roles. All three roles can access companies set up for the Scene7
Publishing System:
SPS Administrator Can view and administer all features in Scene7 Publishing System, as well as set up companies and
add administrators and users.
Company Administrator Can view and administer only their own companies. A Company Administrator can also
perform all administration functions, including adding administrators and users. A Company Administrator can add
a user to the SPS company admin accounts. (This role is the default user role.)
SPS User Can access companies to which they have been assigned; cannot perform any administrative duties.
After you add a user, Scene7 Publishing System sends the user a Welcome e-mail message. The message includes a
password and the Scene7 Publishing System URL.
Adding a user or administrator
1 Click Setup > Application Setup > Administration Setup >User Administration.
2 Click Add.
3 Enter the name and email address of the user or administrator that you want to add, then click Next.
Note: The apostrophe character (‘) is not allowed in email addresses.
4 Choose a Role option to assign a role to the user.
See “User Administration” on page 62.
5 Select a company name to add a user to a company.
6 If you want to add the user to a group (if you are adding a Media Portal user or contributor), click Next and add the user.
7 Click Save to complete the user setup.
After saving, a prompt asks if you want to add a user to another company. Click Add if you want to add the user to
a company.
All new users are given a randomly generated password; users are required to change passwords the first time they
log in to Scene7 Publishing System.
New users are sent a Welcome e-mail after you add them. The e-mail provides a temporary password and explains
how to log on to the Scene 7 Publishing System.
If the user does not receive the welcome email, have them go the SPS login page (http://s7sps1.scene7.com), and
click Forgot My Password. The password is reset and a new email is sent. If the user does not receive the email and
it is not in their Junk folder, contact Technical Support.
When adding new Media Portal users, you can also go to Setup > Application Setup > User Administration, then
click Upload User List and select a .csv file containing no more than 500 users.
Deleting a user
You can delete users from Scene7 Publishing System by making them invalid. Invalid users are removed from the
system and all accounts.
1 Click Setup > Application Setup > Administration Setup > User Administration.
2 Select a user from the list, and then click Edit.
3 Deselect Valid.
4 Click Save.
Last updated 10/9/2014
64
USING SCENE7
Setup
Activating or deactivating users
Users who have been deactivated no longer have permission to enter the account listed at the top of the Select Accounts
To Access menu.
1 Click Setup > Application Setup > Administration Setup > User Administration.
2 In the user list, select or deselect the Active option next to the name of the user.
Editing user information
The user information that you can edit depends on your role as an administrator and the assigned role of the user
whose information you want to edit. Options that are dimmed (unavailable) are not editable.
1 Go to Setup > Application Setup > Administration Setup > User Administration.
2 Select the user and click Edit.
3 Select the entry in the table that shows the company you are trying to modify permissions or access for, then click
the Manage Company link.
4 Select the user role.
5 If you want to change the user’s group membership (if you are editing or adding a Media Portal user or
contributor), click Next and edit the group membership.
6 Click Save.
Filtering and sorting the user list
You can filter and sort the user list to locate users. All users in all accounts you administer appear in the Users list,
regardless of the account selected in the Select Account To Access menu.
You can use the following user list filtering techniques:
Filter by group Select the By Group menu and choose an option to narrow the list to users in a group.
Filter by user role Select the By User Role menu and choose an option to narrow the list to users or administrators of
different types.
Filter by field name Select the Enable Filter By Field option. Then select the By Field Name menu, choose a column
for filtering the list, and select the Filter Character menu and choose a letter. The list is filtered on one of the columns
by the letter you chose. Deselect the Enable Filter By Field option to see the full list.
Filter out invalid users Deselect the Include Invalid option. The search results display only users who are in the system.
Invalid users have been deleted from the system and the accounts you administer.
Sort by column heading Click a heading to sort all users by their status, alphabetically by first name, last name, or
email, by user role, or by valid/invalid status.
If you have many users, you can limit the size of the list by selecting the Max List Size menu and choosing a number.
Bandwidth & Storage
SPS Administrators can generate bandwidth, storage, and other types of reports for the companies they administer.
These reports are available on the Bandwidth & Storage screen.
To open this screen, click Setup > Personal Setup. Expand Administration Setup, and then click Bandwidth & Storage.
Types of reports
The following table describes reports that you can generate from the Bandwidth & Storage screen:
Last updated 10/9/2014
65
USING SCENE7
Setup
Report
Information
Use
Bandwidth
Bandwidth use by company
Track bandwidth usage by company over specific date ranges
to determine traffic patterns.
Storage
Storage usage
Track the amount of data uploaded by company.
Image Content
The number of image requests by type
Track the number of requests and volume for different image
types.
Domain
The number of URL requests by domain
Track image usage based on the domain of the image request
for a specific company. (Scene7 can provide more than one
domain per account. For more information, contact Technical
Support.)
Video Streaming
Bandwidth usage for streaming video
Track streaming video usage by company over specific date
ranges to determine traffic patterns.
Video Content
Playing time of different videos
Determine which are the most viewed and least viewed videos.
The Image Content report provides information about requests for the following image types:
Image Request Requests for images.
Thumbnail Request Requests for swatch or alternate images in viewers.
Mask Request Requests to images returning gray-scale masks.
Viewer Tile Request Image requests loaded by a viewer.
Vnt Object Request Image rendering requests that return an image with specified objects in the requested vignettes.
Vnt Info Request Image rendering requests that return information concerning the requested vignettes.
Note: The Video Streaming report applies to streaming videos only. It doesn’t track the viewing of progressive videos.
Generating a report
To generate a bandwidth, storage, image content, domain, video streaming, or video content report:
1 Choose Setup > Personal Setup.
2 Expand Administration Setup, and then click Bandwidth & Storage.
3 Click a tab: Bandwidth, Storage, Image Content, Domain, Video Streaming, or Video Content.
See “Types of reports” on page 64.
Viewing data in different ways
After you generate a report on the Bandwidth & Storage page, you can choose options for viewing information. You
can choose how information is presented, view information in a chart or data grid, and specify a time period for
capturing information. In Data view, you can also sort information and rearrange columns.
Viewing data in a chart or data grid Click the Chart View option to view data in a chart; click the Data View option to
view data in a data grid.
Choosing a report presentation type On the Report Type menu, choose Summary, Daily, or monthly to organize data
in summary form, by day, or by month. Not all reports provide this option.
Last updated 10/9/2014
66
USING SCENE7
Setup
Specifying a time period Choose options to define a time period for your report, and then click Update after you
define a time period:
• Pre-defined time period On the Pre-defined Report menu, choose an option. For example, choose Last Month to
capture data from the previous month.
• Custom time period On the Pre-defined Report menu, choose Custom. Then choose a date on the Start Month (or
Start Date) menu and a date on the # of Months (or # or Days) menu. For Domain and Video Content Reports, you
can choose a specific start and end date for capturing report information.
Sorting data (Data view only) To sort information on a column, click the column’s heading. Click again to sort in
descending order.
Rearranging columns (Data view only) To move a column to a different location on the data grid, drag its heading.
Exporting and printing reports
After you generate a report, you can export its data for use in spreadsheets and other applications. You can also print
reports.
Exporting report data In Data view, sort and arrange the data as necessary. Then open the Export menu and choose a
format: Tab Delimited, Comma Separated, or HTML Formatted. The data is copied to the Clipboard in the format you
chose. You can now paste the data into a spreadsheet or application.
Printing a report Click Print, choose the options you want in the Print dialog box, and then click OK.
More Help topics
“Image Errors” on page 66
Image Errors
SPS Administrators can generate Image Error reports. An Image Error report provides a list of the 20 most frequent
image errors, for the past 24 hours, for the company you are currently logged in to. Follow these steps to generate an
Image Error report:
1 Click Setup > Personal Setup.
2 Expand Administration Setup, and then click Image Errors.
3 (Optional) Do any of the following:
• Click a heading to sort errors by the heading information. By default, errors are sorted by number of
occurrences, highest to lowest.
• Move the cursor over the Response field for an error to see the specific error message.
• Move the cursor over the URL field or the Referrer field to see the link to the image or referrer web page.
• Click URL Copy URL to copy the link to the actual image. You can paste this link in a browser window to go to
the image and investigate the error.
• Click Referrer Copy URL to copy the link to the referrer web page.
Errors displayed are for the company you are currently logged in to. Each error includes the following information:
Image ID ID for the offending image.
Time The time range of the first time the error was reported to the last time the error was reported, within the last 24
hours.
Count The number of errors reported on the image.
Last updated 10/9/2014
67
USING SCENE7
Setup
Response The specific error message. Errors are either 4xx or 5xx.
URLs Lists the URL to the image on Scene 7.
Referrer Specifies the URL for the web site where the initial request came from. The referrer can be any web site that
has a link to the image.
The URL and Referrer columns have Copy URL associated with them to simplify testing.
More Help topics
“Bandwidth & Storage” on page 64
Last updated 10/9/2014
68
Chapter 4: Media Portal
Adobe® Scene7® Media Portal allows companies to easily acquire, control, and distribute approved creative assets to
external partners and channels, and internal business users. This browser-based, “self-serve” environment provides
Media Portal users with administrator-controlled “views” into Scene7 assets for easy access to , browse, search,
preview, and export assets in corporate-approved formats.
As an administrator, you control how users view, access, and use assets in Media Portal. Moreover, you can customize
the Media Portal interface to match your web site and brand. You can specify font, font color, and font size, as well as
incorporate branding elements such as logos in the Media Portal interface.
System requirements
For the best experience using Scene7 Media Portal, make sure that your system meets the following system
requirements and recommendations:
• Microsoft® Windows® 7 or later or Mac OS X 10.6 or higher Macintosh® Intel processor required.
• 3 GB RAM or higher required (4 GB or higher recommended).
• Color monitor.
• Video card supporting True Color at 1280x1024 resolution or higher.
• JAVA-enabled browser, Flash 11 or higher.
• Windows-supported browsers: Internet Explorer 9 or higher; Firefox 23.0 or higher.
• Macintosh-supported browsers: Safari 6.0 or higher, Firefox™ 23 or higher.
Note: If your browser does not have Flash Player version 11, you can download it from Adobe at
www.adobe.com/go/learn_sc7_flashplayer_en.
Quick Start: Media Portal administration
This Quick Start is designed to get you up and running quickly with Media Portal administration. At the end of each
step is a cross-reference to a topic where you can get more information.
1. Understand Media Portal user roles
Media Portal users fall in three roles — user, contributor, and user-contributor. Each role can perform a different set
of tasks. For example, a contributor can rename and delete files and folders, but a user cannot do those tasks.
Understand the different roles so that when you add users, you understand what responsibilities you give them.
See “Media Portal user roles” on page 70.
Last updated 10/9/2014
69
USING SCENE7
Media Portal
2. Create groups for managing users
Groups determine the folders and files to which a user has access, what users can do in those folders and files, and
which Image Presets are available. As an administrator, your first task is to create groups. For each group, decide which
folders, files, and Image Presets group members can access. As well, grant read, write, and delete permissions to the
group members. These permissions determine whether members can browse, edit, rename, and delete the folders and
files to which they have access.
See “Creating and managing Media Portal groups” on page 71.
3. Add users
When you add a user, you assign the user a role (user, contributor, or user-contributor). You also assign the user to
one or more groups. To speed the process of adding users, you can upload a user list in the form of a CSV file. New
users are sent a Welcome e-mail message and instructions for logging on to Media Portal.
See “Adding and managing Media Portal users” on page 73.
4. Manage FTP accounts
You can have separate FTP accounts that are associated with Media Portal and mapped to a specific folder in your
Scene7 Publishing System account. This kind of functionality means you can allow users to upload digital assets into
your account using separate FTP accounts.
See “Managing FTP accounts” on page 75.
Note: Only Media Portal Administrators can administer these FTP accounts . In addition, only users with the role of
Media Portal Contributor-User or Media Portal Contributor can upload files.
See “Media Portal user roles” on page 70.
5. Specify export options
Media Portal users, when they export files, can reformat the files and export original master files — if you give them
permission to do that. As an administrator, you decide how users export files.
See “Specifying export options available to Media Portal users” on page 76.
6. Create Image Presets
An Image Preset is a collection of pre-defined settings that change the size, image quality, format, resolution, and other
aspects of an image’s appearance when it is exported. You can create Image Presets to control how images are
reformatted when users export them.
See “Creating and enabling Image Presets” on page 77.
7. Create metadata presets and user-defined metadata fields
Metadata describes and identifies a file; it is used for searching for and organizing assets. To make sure that metadata
is entered correctly and that metadata fields that require data are filled in, you can create metadata presets. A metadata
preset is a pre-defined set of metadata entries. You can also create metadata fields that uniquely describe the files you
work with.
See “Making more efficient use of metadata” on page 77.
8. Customize the Media Portal screen
Media Portal style settings allow you to brand the Media Portal screen with your company logo and colors. Use the
style settings to put your company stamp on Media Portal.
Last updated 10/9/2014
70
USING SCENE7
Media Portal
See “Customizing the Media Portal screen” on page 78.
Media Portal user roles
Media Portal provides the following roles, each with different access rights and permissions. When you sign up a user,
you assign the user one of the following roles:
Media Portal Administrator Can add and remove administrators, contributors, and users. The administrator can also
set group access rights, manage FTP accounts, assign corporate-approved conversion formats (presets), send e-mail to
Media Portal users, and view portal usage and storage reporting.
Media Portal User Has access to folders and files. A user can only browse, preview, and download files. This role is
suitable for channel or service partners that need access to your corporate-approved assets.
Media Portal Contributor Can upload, preview, and browse files and metadata in areas to which an administrator has
granted permissions. A contributor cannot download files. Contributors can edit metadata, change the names of files,
move files to different folders, and delete files.
Media Portal Contributor-User Has access to folders and files. A contributor-user can browse, preview, download, and
upload images and metadata. Contributor-users can change the names of files, move files to different folders, and
delete files.
This table describes the tasks that users with different roles can do. Administrators and contributor-users can do all
the tasks listed in this table:
Task
User
Contributor
Contributor-User
Browse folders and files
X
X
X
Browse metadata
X
X
X
Preview files
X
X
X
Search for files
X
X
X
Upload files to Scene7 Publishing System
X
X
Edit and import asset metadata
X
X
Create, rename, and delete folders
X
X
Export asset metadata
X
X
Change file names
X
X
Move files to different folders
X
X
Rename files
X
X
Delete files
X
X
Export (download) files from SPS
X
X
Last updated 10/9/2014
71
USING SCENE7
Media Portal
Creating and managing Media Portal groups
Groups are designed to help you administer Media Portal users. To access an asset, a user must be a member of at least
one group that has permission to access that asset. When you add a user, you assign the user to one or more groups.
In so doing, you grant the user access to folders to which the group has been assigned. You can also choose which
Image Presets are available to a group.
Using groups to restrict access to folders, assets, and Image Presets
To grant access permission at different levels, you create groups. For each group, you assign read, write, and delete
permissions to different folders and assets in folders. As well, you decide which Image Presets are available to the
group. You then assign users to groups. A user can be a member of more than one group. The group concept gives you
the flexibility to assign access to limited sets of the total content.
If you don’t specifically grant a group permission to an asset or folder, that asset or folder inherits the permissions you
assigned to its parent folder (the folder above it in the folder hierarchy). Grant permissions to a parent folder if you
want to make sure that all its child folders inherit the same permissions.
Note: Users can belong to more than one group. When a user belongs to two groups with different access permissions to
a folder, the user is granted the highest access.
Adding a group
1 Click Setup > Media Portal Setup > Groups.
2 Click Add.
3 In the Add Group dialog box, enter a name for the group in the Group Name box, and then click Add Group.
4 If you want, you can select the boxes next to the names of users to add users to the new group.
5 If you want to specify access permissions at this time, click the Asset Access Permissions tab, and then specify the
options you want.
See “Establishing asset access permissions for a group” on page 71.
6 If you want to choose which Image Presets are available to the group, click the Image Preset Access Permissions
tab, and select Image Presets that the group can use.
See “Choosing Image Preset access permissions for a group” on page 72.
7 Click Close.
Establishing asset access permissions for a group
1 Click Setup > Media Portal Setup > Groups.
2 On the Groups list page, do one of the following:
• To add a group and specify permissions, click Add. In the Add Group dialog box, enter a name for the group,
click Add Group, and add users to the group.
• To edit a group’s permissions, select the group, and then click Edit.
3 In the Add Group or Edit group dialog box, click the Asset Access Permissions tab. The right side of the tab offers
boxes for establishing read, write, and delete permissions for folders and assets. You can expand and collapse
folders and subfolders in the left pane.
Last updated 10/9/2014
72
USING SCENE7
Media Portal
4 To assign rights to folders or individual assets, select the folder in the left pane. The folder contents appear in the right
pane. Then assign rights for the group by selecting the boxes for the corresponding files or folders in the right pane.
This table maps different tasks to read, write, and delete permissions.
Task
Read
Browse folders and files
X
Write
Edit files (crop, sharpen, adjust)
X
Change filenames
X
Move files to different folders
X
Rename files
X
Delete files
Delete
X
5 Click Close.
Important: Access rights are established when you select a box. When you assign rights to a folder, its subfolders and all
files within it are given the same rights as the parent folder. However, you can specify different rights for individual
subfolders and asset files.
Choosing Image Preset access permissions for a group
Choose Image Preset access permissions for a group if you want to specify which Image Presets are available to group
members when they export assets with Media Portal.
See also “Specifying export options available to Media Portal users” on page 76.
1 Click Setup > Media Portal Setup > Groups.
2 On the Groups list page, do one of the following:
• To add a group and specify which Image Presets are available to it, click Add. In the Add Group dialog box, enter
a name for the group, click Add Group, and add users to the group.
• To edit a group’s Image Preset options, select the group, and then click Edit.
3 In the Add Group or Edit group dialog box, click the Image Preset Access Permissions tab.
4 Select or deselect Image Presets to specify which presets are available to Media Portal users when they export assets.
5 Click Close.
Edit and delete groups
1 Click Setup > Media Portal Setup > Groups.
2 On the Group List page, select a group and edit or delete it.
Editing a group Click Edit, and then choose options in the Edit Group dialog box.
Deleting a group Click Delete.
Last updated 10/9/2014
73
USING SCENE7
Media Portal
Adding and managing Media Portal users
As an administrator, you can add and manage users, decide whether they can change passwords, edit user information,
and upload user lists. These tasks are accomplished on the User Administration screen. To access this screen, click
Setup > Application Setup > Administration Setup > User Administration.
Important: Before you add users, set up groups for administering them. Media Portal does not let you add a user without
assigning the user to one or more groups. For more information, see “Creating and managing Media Portal groups” on
page 71.
Handling Media Portal passwords
Media Portal users, contributors, and contributor-users are sent a Welcome e-mail message with a password when you
sign them up. Administrators can decide whether Media Portal users can change this password.
1 Click Setup > Media Portal Setup > General Settings.
2 On the General Settings page, select or deselect Allow Media Portal user to change Password.
3 Click Save.
Note: Media Portal users who are allowed to change passwords can do so by clicking Setup > Personal Setup and
changing passwords on the Personal Setup screen.
Adding a Media Portal user
1 Click Setup > Application Setup > Administration Setup > User Administation.
2 On the User Administration page, click Add.
3 In the Add User dialog box, in the User Info panel, enter the First Name, Last Name, and Email address of the user,
and then click Next.
4 In the Company/Role panel, in the Companies drop-down list, select a company or companies for the user.
5 In the Role list, select a Media Portal role, and then click Next.
See “Media Portal user roles” on page 70.
6 In the Access Groups panel, select one or more groups.
See “Creating and managing Media Portal groups” on page 71.
7 (Optional) Click Email Settings to choose e-mail settings different from the default settings.
See “Setting up the Welcome e-mail message for Media Portal users” on page 75.
8 Click Add User.
After you add a user, Media Portal sends the user a Welcome e-mail message. The message includes a temporary
password and the Media Portal URL.
Uploading a Media Portal user list
If you have numerous users to add, you can upload a user list. The users are added automatically to the currently
selected account.
Create the user list as a CSV (comma-separated values) file containing the user information. After the list is uploaded,
the users in the list are automatically added to the account with their specified group assignments. A Welcome e-mail
is sent to each new user, including a link to Media Portal and a temporary password.
Last updated 10/9/2014
74
USING SCENE7
Media Portal
Creating the CSV file
Create a CSV file (filename.csv) that conforms to the following format and fields. The first row of the file must contain
the column headings listed in this table; you can order these columns as desired. All columns are required.
Column name
Description
First Name
The first name.
Last Name
The last name.
Email
A valid e-mail address.
Password
A case-sensitive password string.
User Role
MediaPortalAdmin
MediaPortalUser
MediaPortalContributor
MediaPortalContributorUser
Groups
List of one or more account group assignments for each user, separated by
commas. You specify the group by prefixing the account name, separated by
forward slash (/). For example, PortalCo/IT, where PortalCo is the account and IT
is the group within the PortalCo account.
The following sample spreadsheet demonstrates how to lay out a CSV file:
First Name
Last Name
Email
Password
User Role
Groups
Peter
Peterson
petep@company.com
welcome
MediaPortalAdmin
PortalCo/IT,PortalCo/Admin
Kevin
Marks
kevinm@myco.com
welcome
MediaPortalUser
PortalCo/MktgGroup,
PortalCo/test
Uploading the CSV file
1 Open the User Administration Setup screen.
2 Click Upload User List.
3 In the Select File to Upload dialog box, select the CSV file, and then click Open.
Each user in the list is automatically added to the groups specified. A Welcome e-mail message is sent to each.
Note: If the CSV file was not formatted correctly, the following error message appears: “An error occurred while processing
the uploaded CSV file. Check the file contents for valid data.” In addition, if the CSV contains an existing IP or IPS user,
the user is not added to the User List.
Generating a selectable list of Media Portal users
You can display the names and e-mail addresses of Media Portal users in a pop-up window. This list is useful if you
want to cut and paste user names and addresses for use outside Media Portal.
1 Click Setup > Application Setup > Administration Setup > User Administration.
2 In the By User Role drop-down list, choose the name of a Media Portal user role, and click Refresh to display the
names of one class of Media Portal user.
3 Click Popup List to open the pop-up window. You can copy and paste this list.
Last updated 10/9/2014
75
USING SCENE7
Media Portal
Setting up the Welcome e-mail message for Media Portal users
You can send a Welcome e-mail when you add new Media Portal users, contributors, and contributor-users. You can
configure this e-mail message or tell Scene7 not to send it.
1 Choose Setup > Application Setup > Administration Setup > User Administration.
2 In the User Administration Setup screen, click Email Settings button.
3 In the Email Settings dialog box, specify any of the following settings:
Send Email Deselect this option if you don’t want to inform new users by e-mail that you have signed them up.
Default Password Enter a temporary password for new users, or leave the field empty to have Scene7 generate
random passwords. Users are asked to change passwords the first time they log in.
Replacement URL Enter a URL different from the default if your users access Scene7 through a different URL.
Other user management tasks
Starting on the User Administration Setup screen, you can also do these tasks:
Filter and sort the user list Filter the list of Media Portal users to locate users.
See “Filtering and sorting the user list” on page 64.
Delete users Delete a user from the list.
See “Deleting a user” on page 63.
Activate and deactivate users Suspend a user from accessing folders.
See “Activating or deactivating users” on page 64.
Edit user information Enter up-to-date information about a user.
See “Editing user information” on page 64.
Create user-defined fields Create custom, user-defined metadata fields to help organize assets in the Scene7
Publishing System. The fields can also be activated or deactivated, as necessary.
See “User-Defined Fields” on page 49.
Managing FTP accounts
Only Media Portal Administrators can administer and manage FTP accounts. In addition, only users with the role of
Media Portal Contributor-User or Media Portal Contributor can upload digital assets.
Remember that you can activate or deactivate existing Media Portal users by way of the User Administration page in
Administration Setup.
See “Activating or deactivating users” on page 64.
1 Click Setup > Media Portal > FTP Accounts.
2 On the Add FTP Account page, in the FTP Accounts Username drop-list, select a user.
If a user is not listed, you may need to first add them as a Media Portal Admin, a Media Portal Contributor-User,
or a Media Portal Contributor by way of Administration Setup. After you add the user with the proper role, their
user name is available from the drop-down list.
Last updated 10/9/2014
76
USING SCENE7
Media Portal
See “Adding a Media Portal user” on page 73.
3 In the Password and Confirm fields, type the password to the FTP account.
4 Click Save to add the account to the Existing Accounts table.
To upload media assets, you need the FTP Account Username that is listed in the Existing Accounts table, and the
password that is assigned to the account.
See “Uploading files” on page 79.
Deleting an existing FTP account
1 Click Setup > Media Portal > FTP Accounts.
2 On the Add FTP Account page, in the Existing Accounts table, select the FTP account that you want to remove.
3 Click Delete.
Specifying export options available to Media Portal
users
If the administrator gives them permission, Media Portal users can reformat images as they export them. For example,
they can change the size, file format, and image quality. Automatically reformatting images as they are exported saves
time by not having to reformat images separately. Moreover, administrators can create a preset —a pre-established
selection of image format settings. You can use a preset when exporting images to reformat them to the specifications
of your company.
The following two restrictions apply if you export image assets by way of a user-defined conversion or if you export
original master images:
• The compressed Zip export file has a maximum file size of 1 GB for the export job.
• You can have a maximum of 500 total assets per export job.
See also “Exporting assets from Scene7 Publishing System” on page 113.
To specify export options available to Media Portal users
1 Click Setup > Image Presets.
2 In the Image Presets window, select any of the following:
Enable User-Defined Conversion When selected, this option lets users choose other from the Size drop-down list
in the Export Selected Assets window. Users can then choose a unit of measure such as pixels or centimeters, and
then specify the desired width and height. When they export or download these files, the image files are
reformatted.
When pixels are chosen from the Size drop-down list, the resulting image width x height cannot exceed 100 million
pixels. This size equates to 10,000 x 10,000 pixels for a square image, or roughly 8,000 x 12,000 pixels for a 2x3
aspect ratio image. This size limitation does not apply if you export original master images.
Deselect this option if you want users to download files without reformatting them as they are downloaded.
Enable Export Original Lets you export original master images. In the Export Selected Assets panel, users can open
the Conversion drop-down menu and choose Export Original to export original files. Deselect this option if you
want to force users to choose an Image Preset or choose conversion options when they export images.
Last updated 10/9/2014
77
USING SCENE7
Media Portal
More Help topics
“Image Presets” on page 23
“Choosing Image Preset access permissions for a group” on page 72
Creating and enabling Image Presets
When users export image assets using Media Portal, they can choose an Image Preset in the Export Selected Assets
dialog box. An Image Preset is a collection of pre-defined settings that change the size, image quality, format,
resolution, and other aspects of an image’s appearance when it is exported.
Media Portal administrators can create Image Presets to control how images are reformatted when they are exported.
Image Presets reformat images to the specifications of your company when users export images from the Scene7
Publishing System. Rather than reformatting images on their own, users export them to the precise specifications of
an Image Preset.
The following restrictions apply when you export image assets:
• The width x height must be less than or equal to 100 MB per image. For example, the image cannot exceed 10K x
10K, or any aspect variation below, such as 8K x 12K.
• There is a maximum of 1 GB total file size per export job.
• You can have a maximum of 500 total assets per export job.
Note: These restrictions apply only to the exporting of derived image assets, not the exporting of master files.
To create Image Presets, see “Image Presets” on page 23.
To enable users to choose Image Presets when they export files, see “Specifying export options available to Media
Portal users” on page 76.
To choose which Image Presets are available to the members of a group, see “Choosing Image Preset access
permissions for a group” on page 72.
Making more efficient use of metadata
All files on the Scene7 Publishing System contain metadata. Metadata describes and identifies a file; it is used for
searching for and organizing assets. To view an asset’s metadata, open it in Detail view and examine the Metadata
panel. The metadata fields on this panel provide descriptive information about the asset.
Metadata is not useful in searches and asset organization unless it is entered correctly in metadata fields. To enter
metadata correctly and to make sure that all the right metadata fields contain metadata, you can create metadata
presets. A metadata preset is a pre-defined set of metadata entries. Rather than enter metadata themselves, users can,
in Detail view, choose a metadata preset to fill metadata fields with predefined information.
To create metadata presets, see “Metadata Presets” on page 48.
To create metadata fields that uniquely describe the assets you work with, see “User-Defined Fields” on page 49.
Last updated 10/9/2014
78
USING SCENE7
Media Portal
Customizing the Media Portal screen
The Media Portal style settings allow you to brand the Media Portal screen with your company logo and colors. Use
the style settings to put your company stamp on Media Portal.
To access the style settings, choose Setup > Media Portal Setup > Style Settings. Be sure you click Save to save your
settings after you make them. You can click Restore to bring back the default settings. As you make your choices, the
Preview panel shows you what your choices look like.
Logo Click Browse and choose a graphic in the Select Logo Image window.
Application Create a gradient color blend by making choices on the Background Gradient Colors menus.
Tree Choose a rollover color (the color that appears when you move the pointer over an item) and selection color (the
color that appears when you select an item).
Accordion Choose background colors, a border style, and rollover and selected colors for the accordion that appears
on the right side of the screen in Details view.
Accordion Header Choose whether to make text in the accordion header boldface.
Datagrid Choose colors for the header row in data grids.
Alert Choose a background color for alert message boxes.
Progress Bar Choose a color for the bar that indicates the progress of uploads and downloads.
For Media Portal users to see the style settings you choose, they must append ?company=(company name) to the URL
with which they access Media Portal. For example, to see style settings, Media Portal users who access the PortalCo
company at the following:
http://s7sps1.scene7.com/MediaPortal
would use the following URL instead:
http://s7sps1.scene7.com/MediaPortal?company=PortalCo
Including the company name in the URL enables Media Portal to recognize which company a user wants to access and
apply the company’s style settings accordingly.
You can learn more about communicating URL changes to Media Portal users, and setting up a Welcome e-mail
message so new users receive the correct Media Portal URL.
See Email Communications and “Setting up the Welcome e-mail message for Media Portal users” on page 75.
Last updated 10/9/2014
79
Chapter 5: Upload and publish assets
Your work in Scene7 falls in three basic areas:
• Uploading file assets to the Scene7 Publishing System.
• Managing your files so you can use them to build rich-media assets.
• Publishing your asset files to a Scene7 server so that they are available for delivery to your website and application.
When you upload asset files to SPS and when you publish asset files to Scene7 servers, the system records these file
transfers on the Jobs page. You can go to this page to track and monitor your upload and publishing activities.
Important: When you upload a file, Scene7 generates the URL for the file. This URL is not active until you publish the file.
Note: A new Instant Publish feature was made available shortly after the release of SPS 6.0. This feature, which publishes
assets immediately with one step, is being rolled out gradually, replacing the “Mark for Publish” functionality. Some users
will continue to see the current interface and functionality for a while, until they are included in the rollout. In addition,
some assets will continue to use the “Mark for Publish” process for a while after the rollout.
Uploading files
Before you upload assets files to the Scene7 Publishing System, make sure that the asset files are named correctly, and
that your folder structure is set up and organized the way you want. You can upload files from a Scene7-provided FTP
site or directly from your computer or network. Scene7 offers options for optimizing files as you upload them. If you
installed Adobe Scene7 Publishing System desktop application, you can upload files and folders by dragging them
directly from your desktop. (See “General Settings” on page 20.)
Preparing your assets and folders for uploading
Before uploading assets to the Scene7 Publishing System, make sure that they are in the right format and size. You also
have to observe the Scene7 rules for naming assets. By setting up a folder organization and structure for the files, you
make sure you can locate and work with files easily.
Supported asset file formats
This table lists the asset file formats that the Scene7 Publishing System supports. For information on supported
Camera Raw files, see www.adobe.com/go/learn_s7_cameraraw_en.
Asset file formats
Description
Audio
AAC, HE-AAC, AC3, WAV, WMA, AIFF, MP3
Cascading Style Sheet
CSS
Color profiles
ICC, ICM
Flash
FLA, FLV, SWF, SWC, F4V
Fonts
AFM, OTF, PFB, PFM, PhotoFont, TTC, TTF
FXG
FXG
Illustrator
AI, FXG
Last updated 10/9/2014
80
USING SCENE7
Upload and publish assets
Asset file formats
Description
Images
BMP, FPX, GIF, JPEG, JPG, PNG, PICT (Windows only), TIF, TIFF
InDesign
INDD, INDT
MS Office
DOC, PPT, RTF, XLS
PDF
PDF
Photoshop
PSD, FXG, and Camera Raw
PostScript
EPS, PS
Scene7 Image Authoring
VNC, VNT, VNW
SVG
SVG, SVGX
TAR
TAR
Video
3GP, AVI, F4V, FLV, M2P, M2T, M2TS, M2V, M4V, MOV, MP4, MPEG, MPG, MTS, OGV, TS, VOB, WMV/ASF
XML
XML
ZIP
ZIP
TAR and ZIP upload support includes a check box to select if you want to unpack the files.
Asset types
To achieve optimal results with the Scene7 platform, be sure to use the recommended file formats and sizes. This table
lists asset types, some with recommended formats and file sizes for commonly used assets.
Asset type
Description/Recommendations
Audio
Input audio asset formats include AAC, HE-AAC, AC3, WAV, WMA, AIFF, MP3. You can transcode audio
to the following formats: MP3, AAC, and HE-AAC.
Images (for Image Sizing, Zoom,
Image Sets, Spin Sets)
Images have to be at least 2000 pixels at the longest dimension; typical image sizes range from 1500
to 2500 pixels in the longest dimension. Lossless image formats, including TIFF and PNG files, are
recommended. If you use a JPEG image, use the highest-quality settings. Animate GIF files are handled
like other static content, such as SWF animations.
eCatalogs
Use high-resolution PDF files created in Adobe® Acrobat® or a Creative Suite application saved as
“press-ready.” PDFs include all needed fonts, images, masks, and referenced graphical elements, either
as single-pages, double-page spreads, or in a multi-page format. Order your pages by naming the files
in alphanumeric order. Place all PDFs for your eCatalog in a single folder for ease of uploading. You can
select cropping options on upload to remove the trim area from PDFs, including crop marks,
registration targets, or color bars. Most press-ready PDF files are in the CMYK color space, so it is
important to obtain the CMYK ICC color profile used with your PDF files.
Templates
Layered image or layout design that can include text, images, and layers. Image layers, text strings, and
attributes, such as color and size, can be parameterized so that variable data can be customized. Image
requirements for use in templates are the same as other images. Prepare your graphics in Photoshop
or another image-editing program. Save each graphic as a flattened transparent file in TIFF or PNG
format. Ensure that the image resolution is appropriate for expected use. Images for print should be
300 ppi.
Videos
Scene7 supports video files saved in the FLV, F4V, OGV, and MP4 format. You can transcode files to
MP4 format at upload.
See “Supported asset file formats” on page 79.
Fonts
Uploaded TrueType, Type1 (Windows Only), OpenType fonts, and PhotoFonts
Images
Images and layered image files.
Last updated 10/9/2014
81
USING SCENE7
Upload and publish assets
Asset type
Description/Recommendations
Image Sets and Swatch Sets
A set of related images that can be displayed in a viewer.
ICC profiles
A color profile you can use to convert an uploaded image from its source color space into a different
color space.
Viewer SWFs
Custom-designed FLA files you can use as "skins" for various Scene7 viewers.
Vignettes
Images authored with the Image Authoring program, as well as related files.
Content files
Adobe InDesign, Illustrator, or Photoshop content files.
FXG files
Resolution-independent graphic format files that you can use to create customizable templates for
output to print, web, email, desktop, and devices.
SVG files
Scalable vector graphic files that Image Serving servers can render.
XML files
Files that define pre-processing rules that are used to modify the path and query portions of requests.
Cascading Style Sheet files.
Upload CSS skins for customization of HTML5 viewers. This is similar to uploading viewer skins (SWFs)
for Flash viewers.
JavaScript files
Javascript files are used for viewer instrumentation to hold account information. Adobe Security
recommends this only for client accounts that have a separate domain in use for delivery (to avoid
cross site scripting).
Note: When you upload image files and PDFs to SPS, the system converts these source files to P-TIFF (Pyramid TIFF)
files. These P-TIFFs are the files that are later published to Scene7 Image Servers. Scene7 uses the Pyramid Tiff file format
because it contains various zoom ratios that allow for fast zooming when viewed with a Scene7 Zoom Viewer.
Supported Static File Formats
Scene7 supports several static file formats. Static content is any asset that is published "as-is," such as XML, PDF, SWF,
CSS, and so on.
The following file types can be published:
• Flash video
• Viewer SWF
• XML
• PDF (when PDF is specifically marked for publish after upload, to avoid delivery of all PDFs for existing
eCatalog/PDF workflow)
• PrX video
• Master video
• ZIP
• Animated GIF
• CSS
• JavaScript (when the company is configured with its own domain)
• Audio files
Scene7 does not provide the option to generate a preview URL of static content.
Last updated 10/9/2014
82
USING SCENE7
Upload and publish assets
Filename requirements
Because filename extensions are stripped from filenames during the upload process, the system does not allow files to
have the same root name. In the Scene7 system, the asset filename minus the filename extension becomes the asset ID
for the asset. For this reason, no two assets can have the same name.
Make sure that all users in your company understand these file naming rules:
• Asset IDs with the same exact name are not allowed in the system.
• Asset ID names are case sensitive.
• As a best practice, make sure that asset IDs do not contain blank spaces (for example, black jacket.tif and blue
jacket.jpg). Scene7 ASCII-encodes blank spaces in asset names when it uses asset names to construct URL strings.
These ASCII codes are hard to read, which can make reading URLs more difficult.
• Language-specific characters are permitted in filenames. However, the following characters are not permitted in
filenames:
\;/?:@&=+$,*"<>|'{}%
If a filename contains one or more of the above characters, the characters are removed from the filename on upload.
In most cases, an asset filename can be the same as its item number, product SKU, or other name as in the following:
Item
Filename
Asset ID
896649
896649.jpg
896649
48A3_2X
48A3_2X.tif
48A3_2X
Folder organization and structure
Organize and structure folders and subfolders for your content in the Scene7 Publishing System before you upload
your content to the system. Planning ahead this way has two major advantages:
• When you upload your content to SPS via FTP, you can tell the system to replicate your folder structure during the
upload. This way, your content is organized in the same folders and subfolders in SPS as it is on your computer or
network. (To replicate your folder structure in SPS, select the Include Subfolders option when you upload assets via FTP.)
• Reorganizing folders inside the system after files are uploaded is much more difficult than starting with a carefully
considered folder structure.
The folder-naming approach and structure you choose for storing your content on the Scene7 Publishing System
depends on the needs of your organization. Here are some sample folder structures:
SKU-based Folders are named according to SKUs or item numbers. For example, separate folders are created for all
0-, 20-, 30- number series.
Brand-based For manufacturers with multiple brand lines and retailers who market other brands from other
companies, separate files into product folders named for different brands.
Project-based Folders are organized according to rollout/drop date or project name. Clients who primarily produce
eCatalogs favor this approach.
Mirror of web site folder hierarchy This folder structure mirrors the folder structure of the website, with the folders
named, for example, for product categories.
More Help topics
“Working with asset folders” on page 97
Last updated 10/9/2014
83
USING SCENE7
Upload and publish assets
Uploading your files
You can upload individual files from the desktop or upload folders via FTP. If you want to upload more than 100 MB
of files or upload entire folders and subfolders, select Via FTP.
If you’ve installed the Scene7 Publishing System desktop application, you can drag files and folders directly from your
desktop to the destination upload folder.
The Scene7 Publishing System sends you an email message to confirm when your upload job begins and ends, and to
notify you of any problems.
During (or immediately after) a large upload job, some new items may display the “Image not yet optimized” message.
This message appears because the files have not been fully processed and added to SPS. You can optimize these files
later. (See “Optimize Files” on page 50.)
More Help topics
“Handling recurring upload and publish jobs” on page 94
“Using an upload or publish job as a trigger” on page 96
Upload files from the desktop using Scene7
1 On the Global Navigation bar, click Upload.
2 On the Upload page, click From Desktop.
3 Click Browse.
4 In the Select files to Upload dialog box, select the files you want to upload, and then click Open (Windows®) or
Select (Mac OS®).
Note: After you select files, Scene7 lists their names on the Filenames list. You can remove a file by selecting it and
selecting the Delete button.
5 In the Choose Folder Destination group box, select a destination folder for the uploaded files.
6 Near the lower-right corner of the Upload page, click Job Options, and then specify the options you want.
See “Upload options” on page 84.
Note: Two upload options, Publish After Uploading and Overwrite in Any Folder, are available on the Upload Job
Options dialog box. Other options might be available, depending on the settings in Applications Setup > General
Settings > Upload to Applications > Overwrite Images. You can access other upload job options by clicking the Job
Options button. For information about all the upload options, see “Upload options” on page 84.
7 Click Save.
8 Click Submit Upload.
To see the progress of the upload, click Jobs on the Global Navigation Bar. You can continue working in Scene7
Publishing System and return to the Jobs page at any time to review an in-progress job.
To cancel an upload job in progress, select Cancel next to the Duration time.
More Help topics
“Handling recurring upload and publish jobs” on page 94
“Using an upload or publish job as a trigger” on page 96
Last updated 10/9/2014
84
USING SCENE7
Upload and publish assets
Upload files using SPS Desktop application
The Scene7 Publishing System Desktop application lets you upload files and folders by dragging.
1 In the Scene7 Publishing System Desktop application, on the Global Navigation bar, click Upload. The Desktop
File System dialog box opens
2 In the Desktop File System dialog box, in the bottom half, select the destination folder for the uploaded files or
folders.
3 Drag one or more files or folders from list of files and folders on your computer or network (on the top half of the
dialog box) to the bottom half of the dialog box.
4 Click Job Options, and then specify the options you want.
See “Upload options” on page 84.
5 Click Upload Now.
To cancel an upload job in progress, click Jobs, and then click Cancel.
Upload files using Via FTP
1 Log in to the Scene7 FTP site that is specific to your particular region. Use the FTP user name and password that
you received from your administrator.
2 In Scene7, on the Global Navigation bar, click Upload.
3 On the Upload page, click Via FTP.
4 Choose an FTP folder to upload files from, and then choose a destination folder in the Scene7 Publishing System.
5 Click Job Options and specify the options you want.
See “Upload options” on page 84.
Note: Two upload options, Publish After Uploading and Overwrite in Any Folder, are available on the Upload page.
You can access other upload job options by clicking Job Options. For information about all the upload options, see
“Upload options” on page 84.
6 Click Submit Upload.
To see the progress of the upload, on the Global Navigation Bar, click Jobs. The Jobs page shows you the progress
of the upload. You can continue working in Scene7 Publishing System and return to the Jobs page at any time to
review an in-progress job.
To cancel an upload job in progress, click Cancel next to the Duration time.
More Help topics
“Handling recurring upload and publish jobs” on page 94
“Using an upload or publish job as a trigger” on page 96
Upload options
When uploading files, you can choose from the following options:
Job Name Enter a name for this upload job. The job and other upload and publishing jobs are recorded on the Jobs
page, where you can check the status of jobs.
See “Checking job files” on page 93.
Last updated 10/9/2014
85
USING SCENE7
Upload and publish assets
Publish After Upload Select this option to automatically publish the assets that you upload. When you publish files,
files are sent to live servers. URLs for these files can then be used on external websites and applications. This option is
also available on the Upload page.
See also Instant Publish Notice PDF.
Overwrite in any folder, same base asset name regardless of extension Select this option if you want the files you
upload to replace existing files with the same names. The name of this option could be different, depending on the
settings in Application Setup > General Settings > Upload to Application > Overwrite Images.
Job Options Click Job Options to open the Upload Job Options dialog box and choose options that affect the entire
upload job. These options are the same for all file types.
Note: You can choose default options for uploading files starting on the Application General Settings page. To open this page,
choose Setup > Application Setup. Click the Default Upload Options button to open the Upload Job Options dialog box.
• When (Via FTP uploads only) Select One-Time or Recurring. To set a recurring job, choose a Repeat option—Daily,
Weekly, Monthly, or Custom—to specify when you want the publishing job to recur. Then specify the scheduling
options as necessary.
• Overwrite in any folder, same base asset name regardless of extension Select this option if you want the files you
upload to replace existing files with the same names. This option is also available on the Upload page. The name of this
option could be different, depending on the settings in Application Setup > General Settings > Upload to Application
> Overwrite Images.
• Include subfolders (Via FTP uploads only) Select this option if you want to upload subfolders of the folder you
intend to upload. The names of the folder and its subfolders you upload are entered automatically in SPS.
• Process metadata files (Via FTP uploads only) Select this option if you want to upload a tab-delimited or XML file
to add metadata to multiple assets.
See “Import metadata (via FTP)” on page 110.
• Crop Options To automatically crop white-space pixels from an image, open the Crop menu, choose Manual, and
enter pixel measurements in the Top, Right, Bottom, and Left fields to crop from the sides. You can also choose Trim
on the Crop menu and choose these options:
Trim Away Based On
Choose whether to crop based on color or transparency:
• Color: Choose the Color option. Then select the Corner menu and choose the corner of the image with the color
that best represents the white-space color you want to crop.
• Transparency: Choose the Transparency option.
Tolerance
Drag the slider to specify a tolerance from 0 through 1:
• Trimming based on color: Specify 0 to crop pixels only if they exactly match the color you selected in the corner of
the image. Numbers closer to 1 allow for more color difference.
• Trimming based on transparency: Specify 0 to crop pixels only if they are totally transparent; numbers closer to 1
allow for more transparency.
• Color Profile Options Choose a color conversion when you create optimized files that are used for Scene7 dynamic
delivery:
Default Color Preservation
Last updated 10/9/2014
86
USING SCENE7
Upload and publish assets
Maintains the source image colors whenever the images contain color space information; there is no color conversion.
Nearly all images today have the appropriate color profile already embedded. However, if a CMYK source image does
not contain an embedded color profile, the colors are converted to sRGB (standard Red Green Blue) color space. sRGB
is the recommended color space for displaying images on web pages.
Keep Original Color Space
Retains the original colors without any color conversion at the point of ingestion into Scene7 Publishing System. For
images without an embedded color profile, any required color conversion to process requests for the image are done
using the default color profiles as configured in the Publish settings. These color profiles may not align with the color
in the files created with this option. Therefore, you are encouraged to use the option Default Color Preservation.
Custom From > To
Opens menus so you can choose a Convert From and Convert To color space. This advanced option overrides any
color information that is embedded in the source file. You should only select this option when all the images that you
are submitting contain incorrect or missing color profile data.
• Image Editing Options You can preserve the clipping masks in images, and choose a color profile.
See “Image editing options at upload” on page 305.
• PostScript Options You can rasterize PostScript® files, crop files, maintain transparent backgrounds, choose a
resolution, and choose a color space.
See “Working with PostScript and Illustrator files” on page 312.
• Photoshop Options You can create templates from Adobe® Photoshop® files, maintain layers, specify how layers are
named, extract text, and specify how images are anchored into templates.
See “PSD upload options” on page 310.
• PDF Options You can rasterize the files, extract search words and links, auto-generate an eCatalog, set the
resolution, and choose a color space.
See “PDF upload options” on page 308.
• Illustrator Options You can rasterize Adobe Illustrator® files, maintain transparent backgrounds, choose a
resolution, and choose a color space.
See “Working with PostScript and Illustrator files” on page 312.
• eVideo Options You can transcode a video file by choosing a Video Preset.
See “Working with video encoding presets” on page 219.
• Additional Metadata Options Enter keywords that describe the files you will upload. Separate keywords by comma.
Keywords make searching for assets easier.
See “Conducting an advanced search” on page 99.
• Batch Set Presets If you want to create an Image Set, multi-axis Spin Set, or Swatch Set from the uploaded files,
click the Active column for the preset you want to use. You can select more than one preset. You create the presets in
the Application Setup/Batch Set Presets page.
See “Batch Set Presets” on page 51.
Follow an upload with another job
When you upload items using FTP, you can schedule a subsequent job to begin as soon as the upload is complete. (If
other jobs are scheduled to begin at that time, the job you schedule here will be queued after them.)
Last updated 10/9/2014
87
USING SCENE7
Upload and publish assets
The new job sends a notification to the address you specify so that the code at that location can be triggered. This
follow-on publishing job uses the same name as the upload job, but with the text Pub_ added to the beginning.
To follow an upload with another job
1 Click Upload, and click the VIA FTP tab.
2 In the Advanced section, choose one of the following from the Follow Upload With Another Job option:
• HTTP Request
• Image Serving Publish
• Image Rendering Publish
• Video Publish
3 Specify the HTTP address.
4 Specify if you want to execute only if files were uploaded.
5 Indicate whether you want to run this request every time this job completes, or only when files were published.
Note: Regularly scheduled jobs may not result in any files being published.
Publishing files
You publish your assets to Scene7 Image Servers. You can publish assets on a one-time basis or arrange for Scene7 to
publish assets on a recurring schedule. After your assets are published, they are available to you for delivery. You can
copy the URL calls from the Scene7 Publishing System and add them to your website or application.
Publish After Uploading
Assets either in a published or unpublished state. By default, any assets that you upload into Scene7 are automatically
marked for publishing.
For more information, see the Instant Publish Notice PDF.
Use these techniques to mark assets for publish:
Publish After Uploading On the Upload page, near the bottom, select Publish After Uploading. The default is a
selected state.
Publish After Uploading In the Job Options dialog box, select Publish After Uploading. The default is a selected state.
Some "child" assets are automatically marked for publish when their parents are marked for publish. This table lists
child assets that are marked for publish automatically.
Parent (group) item
Child (member) items
Image sets
Images within the set.
Swatch sets
Swatches within the set.
Spin sets
Images within the set.
Templates
Template files, pages, and images.
Last updated 10/9/2014
88
USING SCENE7
Upload and publish assets
Derived images are also automatically marked for publish when their parent images are being published. Derived
images include images you adjusted with image-editing options. You can see these derived images in Detail view under
Built & Derivatives.
Creating a publish job
Create a publish job to publish assets you have uploaded to Scene7 servers but chose not to automatically published
them yet. You can perform a one-time publish job or schedule jobs to recur on a regular basis. Scene7 offers advanced
publishing options for publishing to specific servers and options for republishing assets that have already been
published.
To create a publish job
1 On the Global Navigation bar, click Publish.
2 In the Publish dialog box, choose whether you want a one-time or recurring publish job.
See “Creating a one-time publish job” on page 88and “Creating a recurring publish job” on page 88.
3 Enter a job name.
4 Optionally, display the Advanced options and choose these options.
See “Advanced publish options” on page 89.
5 Click Submit Publish.
SPS tracks publish jobs on the Jobs page. You can review publish jobs on that page.
Important: Assets you republish (you have published them before) do not appear immediately on your website because
of the web caching mechanism on the content delivery network (CDN). See “Republished assets and CDN delays” on
page 90.
More Help topics
“Canceling a publish job” on page 89
“Checking job files” on page 93
“Editing, deleting, pausing, and resuming recurring jobs” on page 94
Creating a one-time publish job
Create a one-time publish job by selecting the One-Time option on the Publish page.
If you want the publish job to occur at a later date, select the When menu, and choose Schedule For Later. Then use
the Calendar and Time slider to select a day and time to execute the publish job.
Creating a recurring publish job
Create a recurring publish job by selecting the Recurring option on the Publish page.
Then choose a Repeat option—Daily, Weekly, Monthly, or Custom—to declare when you want the publishing job to
recur. Scene7 presents calendar tools for scheduling the recurring publish job. You can choose the Custom option and
enter a rule in the Rule box to describe a custom job interval.
See “Creating a custom upload or publish job time interval” on page 95.
Note: Recurring publish (and upload) jobs are listed on the Jobs page. You can edit or delete a scheduled job by going to
the Scheduled tab of the Jobs page.
Last updated 10/9/2014
89
USING SCENE7
Upload and publish assets
Advanced publish options
You can display the Advanced options on the Publish page and choose these options for handling a publish job:
Publish To Choose a server type to publish assets only to a specific server, not to all servers.
Publish By default, SPS publishes only assets that are new and have not been published before (the New Since Last
Publish option). However, you can choose Full Publish to also publish assets that have been updated or changed since
they were last published. Choose Full w/ Search Data if you are publishing an eCatalog and you want readers to be able
to search it by keyword.
Run Job As Choose a user name from the list. You can sort jobs by user name on the Jobs page. By choosing a name,
you associate a publish job with a user.
HTTP Notification Enter a URL to trigger subsequent publish jobs.
See “Using an upload or publish job as a trigger” on page 96.)
Canceling a publish job
You can cancel an in-progress publish job. Moreover, if you are an administrator, you can cancel an in-progress
publishing job from the company Jobs page.
To cancel a publishing job, go to the Jobs page and click Cancel. On the Scheduled tab of the Jobs page, you can pause
or resume a job by deselecting or selecting the check box in the job’s Active column.
Note: After you cancel a publish job, its status changes to “stopping” until the job reaches a point where it can stop safely.
Stopping a publish job can take some time if the job is in the process of getting data from the database.
Manually publishing assets
You can publish individual assets manually instead of creating a publishing job. When you publish sets, such as an
Image Set or an Adaptive Video Set, the set (or “parent”) and all members (or “children”) within that set get published.
Unpublished assets are indicated in the user interface by a grey, round icon with a slash through it (unpublished state),
to the left of the asset’s name. After an asset is published, the icon turns green and has a white check mark in the center
(published state).
To manually publish assets
❖ Do one of the following:
•
In the Grid View, List View, or Details View, use standard file selection methods to select one or more
unpublished assets.
On the Global Navigation Bar, click File > Publish.
• In the Grid View, List View, or Details View, click the grey, round icon with a slash through it, to the left of the
asset’s name.
Manually unpublishing assets
You can unpublish individual assets manually. When you unpublish sets, such as a Swatch Set or an eCatalog, the set
(or “parent”) itself goes into an unpublished state. However, the members (or “children”) within that set are not
affected; instead, they each retain their existing published or unpublished state.
Published assets are indicated in the user interface by a round, green icon with a white check mark in the center
(published state), to the left of the asset’s name. After an asset is unpublished, the icon turns grey with a slash through
it (unpublished state),
Last updated 10/9/2014
90
USING SCENE7
Upload and publish assets
To manually unpublish assets
❖ Do one of the following:
•
In the Grid View, List View, or Details View, select one or more pubished assets.
On the Global Navigation Bar, click File > Unpublish.
• In the Grid View, List View, or Details View, click the round, green check mark icon to the left of the asset’s name.
Getting an asset’s publish history
The last date an asset was published is shown in Detail view at the top of the panel. You can get more details about the
publishing history by opening the History & Published Servers panel in Detail view. From there, you can see when the
asset was published and to which servers it was published.
More Help topics
“Checking job files” on page 93
Republished assets and CDN delays
Scene7 assets are distributed on the content delivery network (CDN). CDN is a system of computer servers networked
together that cooperate transparently to deliver content, especially large media content, to end users. In the CDN
system, web content is stored in web caches across the Internet (called the edge cache network). Web content is
delivered from these web caches to end users to make for faster deliveries.
The first time someone downloads a web page, the assets are delivered to a CDN web cache server. They are stored on
this server so that the next time someone in the same area accesses the web page, the same cached content can be
delivered faster. The content is delivered faster because it is located closer to the end user. CDN makes for faster web
page displays. It decreases bandwidth demands on the central server because content is delivered from the edge cache
network, not from a central server in every instance.
Newly published Scene7 content is available immediately to the end user and quickly populates the edge cache
network. However, newly republished content—images that have the exact same names as images previously
published to an image server—is not updated on CDN for up to ten hours. Instead, end users see what is in a web cache
on the CDN network. For this reason, your Scene7 republished assets may not appear to end users for ten hours.
If you want your newly republished image assets to be available sooner than the ten-hour delay, you can flush web
caches on CDN. Flushing these web caches removes old content from CDN web caches and replaces it with your most
recently published assets.
To flush the cache, click File > Invalidate CDN. All selected files are removed from the cache. If there are no
publishable assets, or if you are not a company admin, the Remove from CDN option is not available.
Testing assets before making them public
Secure Testing helps you define a secure test environment and build a robust B2B solution, based upon a configurable
set of IP address and ranges. This functionality lets you match your Scene7 deployments with the architecture of your
content management and commerce platform.
With Secure Testing, you can preview the staging version of the website with unpublished content.
Last updated 10/9/2014
91
USING SCENE7
Upload and publish assets
You might prefer to create a staging environment rather than making assets publicly available for the following
reasons:
• Preview websites before public launch (staging website).
• Serve assets that require restricted access, such as eCatalogs that show prices in a B2B web application.
• Use assets behind a firewall as part of product information management system, customer service application,
training site, and so on.
Note: Secure Testing does not affect access to the Scene7 Publishing System. SPS security remains consistent and requires
the usual credentials for access to SPS and related web services.
How Secure Testing works
Most corporations run their Internet behind a firewall. Access to the Internet is possible through certain routes and
typically through a limited range of public IP addresses.
From your corporate network, you can figure out your public IP address using websites like http://whatismyip.com or
request this information from your corporate IT organization.
With the Secure Testing, Scene7 establishes a dedicated Image Server for staging environments or internal
applications. Any request to this server checks the origin IP address. If the incoming request is not within the approved
list of IP addresses, a failure response is returned. The Scene7 Company Administrator configures the approved list of
IP addresses for their company’s Secure Testing environment.
Because the location of the original request must be confirmed, the traffic of the Secure Testing service is not routed
through a content distribution network like public Scene7 Image Server traffic. Requests to the Secure Testing service
might have a slightly higher latency compared to the public Scene7 Image Servers.
Unpublished assets are immediately available from the Secure Testing services, without the need to publish. This
allows you to run a preview before assets are published to their public facing image server.
Note: Secure Testing services leverage the Catalog Server that is configured with an internal publish context. Therefore,
if your company is configured to publish to Secure Testing, be aware that any uploaded assets in Scene7 Publishing System
immediately become available on Secure Testing services. This functionality is true regardless of whether or not the assets
are marked for publish on upload.
The Secure Testing service currently supports the following asset types:
• Images.
• Vignettes (Render Server requests).
• Sets, including image sets, eCatalog, render sets, and media sets.
• Standard Scene7 rich media viewers.
• Scene7 OnDemand JSP pages.
• Static content, such as PDF files and progressively served videos.
• HTTP video streaming.
• Progressive video streaming.
The following asset types and functionalities are currently not supported:
• RTMP video streaming
• Render Server requests
• UGC services
Last updated 10/9/2014
92
USING SCENE7
Upload and publish assets
• Web-to-print
• Scene7 Info or eCatalog search
Testing the Secure Testing service
You should test the Secure Testing service to make sure it works as expected.
Prepare your account
1 Contact Technical Support and request that Secure Testing be enabled on your account.
2 In Scene7 Publishing System, click Setup > Publish Setup > Image Server.
3 On the Image Server Publish page, in the Publish Context drop-down list, select Test Image Serving.
4 For the Client Address Filter, click Add.
5 Select the check box to enable (turn on) the address, and then type an IP address and net mask in the respective text
fields.
6 Repeat the previous two steps to add more IP addresses. Otherwise, continue to the next step.
7 At the lower-left of the Image Server Publish page, click Save
8 Upload the desired images to your Scene7 Publishing System account.
See “Uploading files” on page 79.
9 Make sure some of the images are marked for publish and others are unmarked, and then submit the publish job.
See “Publishing files” on page 87.
10 Determine the name of your Secure Testing service by clicking Setup > Application Setup > General Settings.
11 On the Application General Settings page, under the Servers group, find the name to the right of Test Publish
Context Server Name.
Contact Technical Support if the server name is missing or URLs to the server do not work.
Prepare website variations
You need two variations of a website that links the published and unpublished assets:
• Public version: Link assets using your traditional Scene7 URL syntax
• Staging version: Link assets using the same syntax but with the Secure Testing site name
Run the tests
Perform the following tests:
1 Check whether assets are visible from within your corporate network.
From within the corporate network identified by the previously defined IP address range, the staging version of the
website should display all images, whether marked for publish or not. This allows you to test without accidentally
making images available before preview approval or product launch.
Confirm that the public version of your site shows published assets as previously experienced with Scene7.
2 From outside your corporate network, verify that nonpublished assets (that is, unmarked for publish) are protected
from third-party access.
Access your network from outside (such as, from your home computer or over a 3G connection), then verify that
the public version of the site shows all published assets but none of the unpublished content.
Last updated 10/9/2014
93
USING SCENE7
Upload and publish assets
Confirm that the staging version does not show any asset because you are accessing the Secure Testing service from
an unapproved IP address.
Checking job files
To monitor file uploads to the Scene7 Publishing System and files you publish to Scene7 servers, SPS offers the Jobs
page. You can review upload and publish jobs on the Jobs page, check the status of jobs, and cancel publishing jobs
from this page. You can also schedule upload and publishing jobs.
When you upload assets, a spinning icon appears next to the Jobs menu, indicating a job is in progress, and the number
of files in progress. You can click the icon to see more information about the active job.
Note: A list of your recently published jobs is also available on the Recent Activity page. Click Recent on the Global
Navigation bar to open this page.
About the Jobs page
Select the Jobs button on the Global Navigation bar to open the Jobs page. By default, jobs are listed starting with the
most recent.
Jobs are listed in these categories on the History tab of the Jobs page:
Job Type An icon indicates the job type: Upload and Publish are the most common job types.
Job Name The name of the job. The name includes the user-entered portion of the name and the date-and-time stamp.
Started When the job started.
Total The number of files transferred.
W (warnings) The number of warnings in the job (if any). Warnings indicate problems with the job that did not affect
overall job completion. These warnings can usually be ignored because they report on hidden files. For example,
.DS_store files (Macintosh) and Thumbs.db files (Windows) contain information about how to display image files to
users. Warning entries regarding these files, however, can be ignored because they don’t pertain to how these files are
used in Scene7. You can double-click a job name to get detailed information about warnings.
E (errors) Lists the number of errors in the job (if any). You can double-click a job name to get detailed information
about errors.
Duration How long it took to complete the job.
Status Shows the status of the job.
Destination For upload jobs, the company name and folder to which the files were uploaded. This category doesn’t
apply to publish jobs.
Submitted By Lists who uploaded the assets.
Note: You can cancel in-progress publish and upload jobs by clicking the Cancel button next to the progress bar.
More Help topics
“Changing views on the Jobs page” on page 94
Last updated 10/9/2014
94
USING SCENE7
Upload and publish assets
Changing views on the Jobs page
Use these techniques to sort jobs or change your view of the History tab of the Jobs page:
Sorting Select a column name to sort the list by a particular column. You can select the switch beside the column name
to sort in descending or ascending order.
Date Range Select the Date Range menu and choose an option to narrow the list of jobs to the current date, the
previous week, or the previous month. Choose Custom Date Range to enter a specific date range.
Job Type Select the Job Type menu and choose Publish or Upload to narrow the list to publish jobs or upload jobs.
Choose All to see both types of jobs.
Show Choose Show > My Jobs or Show > All Jobs to narrow the list to jobs you ordered or jobs that people in your
company ordered.
More Help topics
“About the Jobs page” on page 93
“Viewing, copying, or printing a Job Details report” on page 94
Viewing, copying, or printing a Job Details report
Double-click the name of a report on the Jobs page to open the Job Details page. This page provides a summary report
about the files in the job. Click View Detail to see an entry’s SPS ID, destination path, and status information. If you
uploaded a PDF or PostScript file that requires fonts that are not available in SPS, the report lists the missing fonts.
You can copy this information to the Clipboard.
1 Double-click the name of a report on the Jobs page to open the Job Details page.
2 Click View Detail to get a detailed report about an entry.
3 Click Copy to Clipboard.
More Help topics
“About the Jobs page” on page 93
Handling recurring upload and publish jobs
Recurring upload and publish jobs that you create on the Upload and Publish pages are listed on the Scheduled tab of
the Jobs page. You can edit and delete recurring jobs on the Scheduled tab.
Select the Jobs button on the Global Navigation bar and, on the Jobs page, select the Scheduled tab to edit and delete
recurring jobs.
Note: You can filter the job list on the Scheduled tab with the Job Type and Show menus. Choose a Job Type to narrow
the list to publish jobs of a specific kind. Choose a Show option to display jobs you created or jobs created by everyone in
your company.
Editing, deleting, pausing, and resuming recurring jobs
Select a recurring job on the Jobs page and follow these instructions to edit or delete it:
Editing a recurring job Select the Edit button and enter schedule information in the Edit Scheduled Job dialog box. If
you want the job to recur at an interval of your choice, choose Repeat > Custom.
See “Creating a custom upload or publish job time interval” on page 95.
Last updated 10/9/2014
95
USING SCENE7
Upload and publish assets
Deleting a recurring job Select the Delete button.
Pausing (and resuming) a recurring job In the Active column, deselect a check box to pause a job; select a check box to
resume a job that was paused.
Creating a custom upload or publish job time interval
To create a custom time interval for an upload (via FTP) or a publish job, choose Repeat > Custom on the Upload or
Publish page. Then enter numbers and wildcards in the Rule box to describe a time interval for the upload or publish
jobs to recur.
The syntax for describing custom upload and publish time intervals in the Rule box is:
[seconds] [minutes] [hour of day] [day of month] [month] [day of week]
For example, 0 15 10 * * ? schedules a job at 10:15.00 every day.
The following tables and list explain how to describe a time interval in the Rule box.
This table shows the time increments, their allowed values, and the wildcards they support:
Time increments
Values allowed
Comments
Wildcards supported
Seconds
0–59
,-*/
Minutes
0–59
,-*/
Hours
0–23
Note the use of a 24-hour clock.
Day of the month
1–31
You cannot specify a numeric value for both , - * / ? L C
“day of the month” and “day of the week.”
One of these fields must use a ? wildcard
character.
Month
1–12 or Jan, Feb, Mar, Apr,
May, Jun, Jul, Aug, Sep, Sep,
Oct, Nov, Dec
Values are case sensitive.
Day of the week
Mon, Tue, Wed, Thu, Fri, Sat,
Sun
Values are case sensitive. You cannot specify , - * / ? L C #
a numeric value for both “day of the month”
and “day of the week.” One of these fields
must use a ? wildcard character.
Year (optional)
Empty or 1970–2099
,-*/
,-*/
,-*/
This table describes the wildcard characters that are allowed in the Rule box and how to use them:
Wildcard character
Name
What it describes
*
Asterisk
All values (for example, “every minute”).
?
Question mark
No specific value (for example, “any minute within the specified hour”).
,
Comma
Additional values (for example, “Monday and Wednesday”).
-
Hyphen
Range of values (for example, “Monday through Friday”).
/
Forward slash
Increments (for example, “every 15 minutes”).
Last updated 10/9/2014
96
USING SCENE7
Upload and publish assets
Wildcard character
Name
What it describes
L
Capital L
Last “day of the month” or “day of the week” (available for these fields only).
For example, if the month is January, an L value for the “day of the month”
field schedules the job for January 31.
For the “day of the week” field, you can enter this character alone to schedule
the job on Saturday. You can use it with a number (for example, 6L) to specify
the last Friday of the month.
Do not specify L with the comma or hyphen wildcards.
#
Number sign
“Nth” weekday of the month (available for the “day of the week” field only).
For example, 6#3 in the “day of the week” field specifies the third Friday of the
month. The 6 denotes “Friday” (the sixth day of the week) and the 3 denotes
the third occurrence in the month.
C
# Capital C
First calendar “day of the month” or “day of the week” (available for these
fields only). For example, specifying a value of 1C for “day of the month”
schedules the first day in the calendar that occurs on or after the fifth.
For the “day of the week” field, specifying 1C schedules the first day in the
calendar that occurs on or after Sunday
This list gives examples of describing time intervals in the Rule box:
• 0 0 12 * * ?: Noon every day
• 0 15 10 ? * *: 10:15 am every day
• 0 0/5 14 * * ?: Every 5 minutes between 2:00 and 2:55 pm every day
• 0 0/5 14,18 * * ?: Every 5 minutes between 2:00 and 2:55 pm every day and every 5 minutes between 6:00 and 6:55
pm every day
• 0 10,44 14 ? 3: Wed at 2:10 pm and 2:44 pm every Wednesday in March
• 0 15 10 ? *: Mon–Fri at 10:15 am every weekday
• 0 15 10 20 * ?: At 10:15 am on the 20th day of every month
• 0 15 10 L * ?: At 10:15 am on the last day of every month
• 0 15 10 ? * 6L: At 10:15 am on the last Friday of every month
• 0 15 10 * * 6#3: At 10:15 am on the third Friday of every month
Using an upload or publish job as a trigger
When you upload assets via FTP or run a publish job, you can schedule a subsequent job to begin as soon as the upload
is complete. (If other jobs are scheduled to begin at that time, the job you schedule here is queued behind them.) The
new job sends a notification to the address you specify so that code at that location can be triggered. This follow-on
upload job is given the same name as the current upload job, but with the prefix _Pub.
To make one upload or publish job trigger another job, select Advanced on the Upload or Publish page. Then enter
the URL in the HTTP Notification text field.
Last updated 10/9/2014
97
Chapter 6: Managing assets
Scene7 offers the Asset Library for managing assets. The Asset Library holds the folders where you store your asset
files. Selecting a folder in the Asset Library displays the contents of the folder in the Browse Panel. You can view items
in the Browse Panel in Grid, List, or Detail view. When you want to focus on a single asset, double-click it in the Browse
Panel to display it in Detail view.
The Browse Panel offers tools for viewing, selecting, locating, previewing, moving, renaming, and deleting assets.
Assets that you delete are placed in the Trash folder; you can recover assets from this folder.
When you want to examine or work with an asset, open it in Detail view. You can record metadata in Detail view to
make locating and working with an asset easier.
Working with asset folders
File assets in the Scene7 Publishing System are kept in folders. These folders are listed in alphabetical order in the Asset
Library Panel. Before you upload files from your computer or network to Scene7 Publishing System, you are asked to
name a folder for storing the files. Create these folders before uploading any files.
Be sure to establish a folder structure and organization for storing your files on Scene7 Publishing System before you
upload files.
Displaying, moving, hiding, and opening folders
The Asset Library displays files in a folder tree. When you select a folder in the Asset Library, its contents appear in the
Browse Panel. Use these techniques to locate folders in the folder tree:
Displaying subfolders Select the Expand Folder icon to display the subfolders in a folder. This icon is located to the
left of folder names.
Moving a folder You can move a folder by dragging it and dropping it in its new location, or by selecting File >Move
Folder.
Hiding folders Select the Collapse Folder icon to collapse subfolders. This icon is located to the left of folder names.
Opening a folder Select a folder to display its contents in the Browse Panel.
You can hide or display the Asset Library by clicking the Expand/Collapse control on its left side. Collapse the Asset
Library panel when you need more room to work in the Browse Panel.
Creating folders
Follow these steps to create a folder:
1 In the Asset Library, select the folder you want to create a folder in.
2 Select the Add Folder button
. This icon is located at the top of the folder list.
3 Enter a descriptive name for your new folder or subfolder by typing it into the field next to the folder icon.
Last updated 10/9/2014
98
USING SCENE7
Managing assets
You can also create folders in Scene7 Publishing System when you upload files via FTP. Selecting the Include
Subfolders option when you upload via FTP replicates the folder structure on your computer in the system. Files
and subfolders on your computer or network are replicated in the Asset Library, and the assets you upload are placed
in these folders.
Deleting and renaming folders
Select a folder and use these techniques to delete or rename it:
Deleting Select the Remove Folder button
. Assets in a deleted folder are placed in the Trash folder. You can
recover them from there.
Renaming Double-click the name and enter a new name.
Important: You cannot copy folders or assets because doing so would create duplicate folders and assets on Scene7
Publishing System, and duplicates are not allowed on the system.
Viewing assets in the Browse Panel
You can change your view of assets in the Browse Panel by selecting a View button:
Grid view Select the Grid View button
to see assets in thumbnail form in a grid. In Grid view, you can drag the
Thumbnail slider to change the size of the thumbnail images.
List view Select the List View button
to see assets in a list. The list tells you the name, type, creation date, and lastmodification date of each asset. Depending on the type of asset you are working with, you get other information as
well. For example, you can see the dimensions and file size of an image.
Detail view Select an asset, and then select the Detail View button
to examine the asset in Detail view. You can
also double-click an asset or select it and choose File > Details to see it in Detail view. If your administrator has
specified the Show URL preference, URLs appear for all assets in Detail view; however, the URLs are only active once
the asset has been published.
You can select a default view for the Browse Panel and make the panel work to your specifications. See “Personal
Setup” on page 15.
Selecting assets in the Browse Panel
Select an asset in the Browse Panel to work with it. Use these techniques to select assets:
A single asset Click the asset (double-clicking opens the asset in Detail view).
Several assets Ctrl+click (Windows) or Command+click (Macintosh) assets to select assets in different places on the
Browse Panel. Shift+click (click one asset, and then Shift+click another) to select adjacent assets.
All assets in the Browse Panel Choose Select > All.
No assets Choose Select > None.
Last updated 10/9/2014
99
USING SCENE7
Managing assets
Searching assets
To locate file assets in Scene7 Publishing System, you can view assets by type, sort assets in the Browse Panel, conduct
a simple search, conduct an advanced search, and filter for assets.
The Personal Setup screen offers options for choosing how you want to conduct searches. For example, you can choose
a default search type and choose whether to include user-defined fields in searches. For more information, see
“Personal Setup” on page 15.
More Help topics
“Navigation basics” on page 10
Viewing assets by type
To see only files of a certain type as you browse, open the Show drop-down menu in the Asset Library, and then choose
a file type. Only assets of the type you chose appear in the Asset Library.
Sorting files in the Browse Panel
To sort the contents of a folder or search results in the Browse Panel, select the Sort menu and choose an option. The
options are Name, Size, Type, Date Created, and Last Modified.
You can choose Ascending or Descending to sort assets in ascending or descending order by the criteria you choose.
In List View, you can sort by clicking a column name.
Conducting a simple search
Use the Search field to conduct simple searches. You can search for items by name or search for items whose metadata
contains a keyword.
To conduct a simple search:
1 Select the folder in the Asset Library to search in a particular folder and its subfolders
2 Click
in the Asset Library and choose an option that describes how narrow or broad you want the search to
be. You can choose Within All Files & Folders, Within Selected Folder, or Within Selected Folder & Subfolders.
3 Enter a search term.
4 Click Go or press Enter.
The results of your search appear in the Browse Panel.
Scene7 tracks searches. To run a search a second time, select the Search button and choose the name of a search at the
bottom of the Search menu.
Conducting an advanced search
Click Advanced Search in the Asset Library to search using many criteria, including values in metadata fields.
Specify any of the following criteria in your search:
Filter By Asset Type Narrow your search to one asset type only by choosing an asset type on the menu.
Files and Folders Choose where you want to search: Within All Files & Folders, Within Selected Folder, or Within
Selected Folder & Subfolders.
Last updated 10/9/2014
100
USING SCENE7
Managing assets
All Publish States Search for files that are marked ready for publish, are not marked ready for publish, or all files.
Conditions If you specify metadata criteria for searching, select whether the search must match all conditions (an ALL
search) or any condition (an OR search).
Specify Metadata Search Criteria Create one or more search fields for searching metadata. To create search fields:
1 Open the Metadata View list (to the left of the Add a Field menu) and choose a Metadata View. You can choose
compact View, IPTC, XMP, or a view your administrator set up.
2 Select the Add a Field menu and choose a field name on the drop-down list.
3 Choose a Contains option (Contains, Does Not Contain, Begins With, Ends With, or Equals).
4 For numeric fields, choose a value or enter a custom date range.
5 (Optional) Repeat steps 1–4 to create more search fields.
You can click the Remove Search Field button to remove a search field.
Click Search to begin your search. The results of the search appear in the Browse Panel. You can change any search
condition and click Search to run the search again.
Click Clear to clear search criteria and start a new search. Click Close when you finish searching to close the Search
panel.
More Help topics
“Viewing, adding, and exporting metadata” on page 108
Filter assets using metadata
Filter assets in the Filters tab of the Asset Library. To filter assets, you use metadata values as the criteria. After you
choose a metadata field you want to use for filtering, the Filters tab lists all metadata values that were entered in the
field you chose and the number of assets that were assigned each value. For example, in a filter operation on the Creator
metadata field, the Filters tab lists all names that were entered in the Creator metadata field for different assets, and for
each name, the number of assets assigned the name. You then click a metadata value to see all assets that were assigned
that value. In the example, you click the Jimmy metadata value to see all assets in which the name Jimmy was entered
in the Creator metadata field. You can filter using more than one metadata field as a filtering criterion.
You can save filter operations in order to run them many times.
Note: Only metadata fields in the default Metadata View can be used for filter operations. The Metadata Views screen
shows the name of the default Metadata View.
See “Metadata Views” on page 48.
More Help topics
“Viewing, adding, and exporting metadata” on page 108
Last updated 10/9/2014
101
USING SCENE7
Managing assets
Running a filter operation
Follow these steps to locate assets by filtering with their metadata values:
1 Click the Filters tab in the Asset Library.
The criteria of your previous filter operation appear in the Filters pane. The Filters pane is divided into panels, with
each panel representing a metadata field. Use the panels to choose which metadata fields to filter with, and within
each field, to choose a metadata value for the filter operation.
To run a filter operation you created and saved, click the Select Preset button and choose the operation’s name on
the menu.
See “Saving, repeating, and deleting filter operations” on page 101.
2 Clicking the Field button
on a panel, follow these instructions to display the filtering menu and construct the
filter operation:
Choosing a metadata field Select the name of the field on the filtering menu.
Note: Only the names of metadata fields in the default Metadata View appear on the filtering menu.
See “Metadata Views” on page 48.
Adding a metadata field Choose Add a Panel. After the panel appears on the Filters pane, click its Field button and
choose the name of a metadata field on the filtering menu.
Removing a metadata field Choose Remove This Panel on the filtering menu.
When you choose a metadata field, its panel lists:
• All metadata values entered in the field.
• For each metadata value, the number of assets given the value.
3 Repeat Step 2 as many times as necessary to list all metadata fields for the filter operation on panels.
4 In each panel, select a metadata value to filter on. You can’t select more than one metadata value in each panel.
Assets that match all the values you selected appear in the Browse panel.
To temporarily remove a field from the filter operation, click Deselect All. This option is located at the top of each
panel, above metadata values.
5 (Optional) To save the filter operation and be able to run it later, click the Select Preset button, choose Save Current
As New Presets, and enter a name in the Save dialog box.
Saving, repeating, and deleting filter operations
Follow these instructions on the Filters tab to save, repeat, and delete filter operations:
Saving a filter operation Click the Select Preset button, choose Save Current As New Presets, and enter a name in the
Save dialog box.
Repeating a filter operation Click the Select Preset button and choose the name of a filter operation on the menu. The
menu lists filter operations that you saved.
Deleting a filter operation from the Select Preset menu Run the filter operation. Then click the Select Preset button
and choose Delete Preset on the menu.
Using the metadata server
The metadata server is a public API that you can use to search for assets by metadata via http requests.
Last updated 10/9/2014
102
USING SCENE7
Managing assets
To configure the metadata server, click Setup > Application Setup > Publish Setup >Metadata Server.
The Metadata Server Publish screen opens. This screen lets you set the following options:
Instant Publish Automatically pushes any metadata changes when they are made, including new assets, keyword
changes, and so on.
XMP Packet Publishes the XMP Packet. This packet is not used for searching, but provides the most up-to-date XMP/
Keywords Publishes your keywords to the metadata server for use in searches.
Metadata Server Publish Fields Select the fields to include in the metadata. This enables you to determine how much
information about your assets is available to the public. These fields are also displayed in Metadata Views, but can only
be changed in the metadata server.
Click Publish Now to start the job. A confirmation appears, telling you the job has started.
Previewing an asset
You can use Preview to see how a digital asset will look when viewed by a customer. The Preview uses the default viewer
that is assigned to the asset. Default viewers are configured in Application Setup.
See “Configuring Default Viewers” on page 47.
If you are previewing a template asset with parameter layers, you can make changes to the parameters or change the
image preset. Because your changes are made inline, you can view the results immediately from the same Preview
window.
See also Scene7 Viewer Library Examples.
To preview an asset
1 In the Asset Library panel on the left side, navigate to the Asset folders that contains the asset you want to preview.
2 Do any one of the following:
• Above the Assets window, on the right side of the toolbar, click Grid View.
• Above the Assets window, on the right side of the toolbar, click List View.
• Above the Assets window, on the right side of the toolbar, click Detail View.
3 Depending on the View you are using, do one of the following:
• In the Asset window of the Grid View or List View, select a single asset, and then click Preview near the
thumbnail image.
• On the toolbar above the Assets window of the Grid View, List View, or Detail View, click Preview.
Previewing an asset based on viewer platform type
You can use Viewer List to preview how an asset appears on particular viewer platform type such as HTML5.
Depending on the asset type and the associated viewer that you have selected to preview, not all platforms are available
in Viewer List.
You can also use Viewer List to copy a viewer’s URL or view and copy the viewer code for embedding in your web
pages.
For a given viewer platform, the Viewer List window lets you visually see what devices, such as tablets and
Smartphones, thate viewer is available for use.
Last updated 10/9/2014
103
USING SCENE7
Managing assets
To preview an asset based on viewer platform type
1 In the Asset Library panel on the left side, navigate to the Asset folders that contains the asset you want to preview.
2 Do any one of the following:
• Above the Assets window, on the right side of the toolbar, click Grid View. In the Asset window, select a single
asset, and then below the thumbnail image, click Preview > Viewer List.
• Above the Assets window, on the right side of the toolbar, click List View. In the Asset window, select a single
asset, and then to the right of the thumbnail image, click Preview > Viewer List.
• Above the Assets window, on the right side of the toolbar, click Detail View. On the same toolbar, click Preview
> Viewer List.
3 (Optional) In the Viewer List window, click the column heading Name or Platform type to sort the column by
ascending or descending order.
4 In the Viewer List window, under the Actions column of the table, click Preview to see how the asset appears for a
selected viewer and platform type.
Close the displayed preview to return to the Viewer List window.
5 (Optional) In the Viewer List window, in the URL Encoding for Copy URL Generation drop-down list at the
bottom, select the URL encoding that you want applied to the asset’s URL when it is copied.
6 (Optional) Do any of the following:
• In the Viewer List window, under the Actions column of the table, click Copy URL for a selected viewer and
platform type.
When you click Copy URL, its associated URL is automatically copied to the clipboard.
• In the Viewer List window, under the Actions column of the table, click Embed Code.
When you click Embed Code, the Embed Code window is opened where you can review the viewer code. Editing
of the code is not permitted in the window. You can also copy the code to the clipboard so you can paste it in
your web pages.
Close the displayed preview to return to the Viewer List window.
• In the upper-right corner of the Viewer List window, click Universal URL to copy the unpublished URL to the
clipboard.
See “About Universal Viewers” on page 42.
7 In the lower-right corner of the Viewer List window, click Close to return to the Assets screen.
Previewing an image asset based on its Image Preset
You can preview an image asset based on its Image Preset to find out what your image looks like when it is delivered
dynamically to your web site or application at different sizes.
An Image Preset is a collection of pre-defined settings that change the size, image quality, format, resolution, and other
aspects of an image’s appearance when it is exported.
See “Setting up Image Presets” on page 121.
See “Creating and enabling Image Presets” on page 77.
Last updated 10/9/2014
104
USING SCENE7
Managing assets
To preview an image asset based on its Image Preset
1 In the Asset Library panel on the left side, navigate to the Asset folders that contains the image asset you want to
preview.
2 Do any one of the following:
• Above the Assets window, on the right side of the toolbar, click Grid View. In the Asset window, select a single
image asset, and then below the thumbnail image, click Preview > Image Preset List.
• Above the Assets window, on the right side of the toolbar, click List View. In the Asset window, select a single
image asset, and then to the right of the thumbnail image, click Preview > Image Preset List.
• Above the Assets window, on the right side of the toolbar, click Detail View. On the same toolbar, click Preview
> Image Preset List.
3 In the Image Preset List window, in the table, select the name of a preset type whose image asset you want to preview
inline in the right pane.
4 (Optional) In the Image Preset List window, in the URL Encoding for Copy URL Generation drop-down list at the
bottom, select the URL encoding that you want applied to the image asset’s URL when it is copied.
5 (Optional) In the Image Preset List window, in the upper-right area of the preview pane, click Copy URL for the
selected preset type.
When you click Copy URL, its associated URL is automatically copied to the clipboard.
6 In the lower-right corner of the Image Preset List window, click Close to return to the Assets screen.
Moving, renaming, and deleting assets
You can move, rename, and delete assets from the Browse Panel. As well, you can delete many assets simultaneously
with a text file.
More Help topics
“Selecting assets in the Browse Panel” on page 98
“Preparing your assets and folders for uploading” on page 79
“Restoring assets from the Trash folder” on page 116
Move assets
You can move assets to different folders in the Browse Panel.
❖ Select the asset or assets in the Browse Panel, and do one of the following:
• Display the folder you want to move the assets to in the Asset Library and drag the assets to the folder.
• Choose File > Move, select a folder in the Move Assets window, and select Move.
Rename assets
To rename an asset:
❖ Select the asset in the Browse Panel, and do one of the following:
• Select the name, type in a new name, and press Enter or click away from the name.
Last updated 10/9/2014
105
USING SCENE7
Managing assets
• Choose File > Rename. The name of the asset is highlighted. Enter a new name and press Enter.
Be sure that you do not to enter the name of an existing Scene7 Publishing System asset.
Delete assets
You can delete selected assets in the Browse Panel as well as delete entire folders. Deleted assets and folders are moved
to the Trash folder, where they remain for seven days before being permanently deleted.
When you delete an asset, all assets derived from it are deleted as well. For example, deleting an image for which you
created zoom targets deletes the zoom targets along with the image.
Important: Zoom targets, image attributes, and history entries are permanently deleted when you delete the assets from
which they derive. They are not moved along with the asset to the Trash folder; they cannot be restored from the Trash.
❖ Do any of the following:
• To delete one or more assets, select the assets in the Browse Panel, and press Delete or choose File > Delete.
• To delete a folder, select the folder in the Asset Library, and click Remove Folder
.
Deleting a folder deletes the folder, all the assets in the folder, as well as all assets in its subfolders.
Important: Scene7 recommends overwriting asset files rather than deleting them if your reason for deleting an asset file
is to replace it with another by the same name.
Delete multiple assets with a text file
To delete many assets at once throughout the Asset Library, you can list the assets you want to delete in a text file and
submit the list to Scene7.
Create the list of Scene7 Publishing System IDs and save it as a text (.txt) file. Each Scene7 Publishing System ID must
be on its own line (followed by a hard return).
After you create the list, follow these steps to use it to delete assets:
1 Choose File > Delete Asset List.
2 In the Delete Asset list dialog box, browse or type the path to the text file with the list of assets you want to delete.
3 Click the Delete button.
When you delete assets with a text file, if any Scene7 Publishing System ID is not on the list, a message is displayed
letting you know that Scene7 is “Unable to validate these entries in your list:” along with the list of entries. However,
Scene7 will not generate an error on the Job screen.
Working in Detail view
You can work with and learn about an asset by opening it in Detail view. In Detail view, you see the asset size,
attributes, derivatives, and metadata. You also see whether and when the asset was published and obtain the URL of
published assets. Depending on the asset type, you can preview it at different sizes, zoom in on it, and perform
sharpening, cropping, and other formatting operations.
Last updated 10/9/2014
106
USING SCENE7
Managing assets
An asset in Detail view.
To open the folder where the asset is stored, you can click the folder path at the top of the Information panel.
Open an asset in Detail view
To closely examine, preview, or work on an asset, you can display it in Detail view.
❖ In the Browse Panel, do one of the following:
• Double-click the asset.
• Select the asset and then select the Detail View button
.
• Select the asset, and choose File > Details.
You can page from asset to asset in the same folder in Detail view by selecting the Previous Asset or Next Asset button.
These buttons are located in the upper-right corner in Detail view.
Getting information in Detail view
Detail view provides information about an asset or file. It shows this information about an item: the folder where it is
stored, its filename, the date the item was uploaded to Scene7 Publishing System, and its publishing history. You can
also view and edit metadata and add keywords for an asset in Detail view.
You can obtain an asset URL in Detail view; however, the URL is not active until you publish the asset. For images,
Detail view also provides a list of build and derived assets and metadata, such as zoom targets and Image Sets.
More Help topics
“Viewing, adding, and exporting metadata” on page 108
Last updated 10/9/2014
107
USING SCENE7
Managing assets
Working with assets in Detail view
Detail view offers tools for working with the asset you opened. Which tools are available depends on the type of asset
you are working with, but Detail view always offers these functions:
items for publish Click the Publish icon to the left of the name, or click File > Publish or File > Unpublish.
Renaming the asset Select the name and enter a new name.
Editing and adding metadata Select the Metadata panel and make changes as desired. See “Viewing, adding, and
exporting metadata” on page 108.
Editing and adding keywords Select Keywords and add or remove them as desired. See “Add or edit keywords” on
page 109.
Deleting the asset Click File > Delete.
For discrete files—images, Image Sets, and fonts, for example—you can view the publishing and editing history, and
check job details, in Detail view.
This table shows which additional options are available with different types of assets in Detail view.
Asset type
Edit/adjust
Preview
Images
Add Image Maps
Yes; Zoom and Image Presets.
Add zoom targets
Crop
Sharpen
Create adjusted views
Cabinet and window covering
images
No
Thumbnail.
eCatalogs
Edit
Yes. Info Panel also available.
Flash source files
No
No.
Fonts
Edit font information
No.
FXG files
Edit
Yes.
ICC profiles
Edit profile information
No.
Illustrator Files
No (unless converted to FXG)
No.
Image Sets
Edit
Yes.
InDesign files
No (unless converted to FXG)
No.
PDF files
No
No.
PSD files
Yes for individual layers
Yes for individual layers.
Spin sets
Edit
Yes.
SVG files
No
No.
Templates
Edit
Yes.
Videos
No
Yes.
Viewer SWF files
No
No.
Last updated 10/9/2014
108
USING SCENE7
Managing assets
Asset type
Edit/adjust
Preview
Vignettes and rendered vignettes
No
Image is shown. You can view the contents and structure of the
renderable elements of the vignette in XML format.
XML files
No
Contents are shown.
ZIP files
No
Contents are not shown.
Viewing, adding, and exporting metadata
You can store information specific to the files you work with in the Scene7 Publishing System; this information is
called metadata. You can use metadata in Scene7 for organizing, searching, filtering, and sorting your assets.
Metadata appears in Detail view along with Scene7-generated information, such as the file creation date, publishing
date, and keywords. To view metadata, open the asset in Detail view and select the Metadata panel. You can enter and
edit metadata in Detail view.
Some metadata is embedded directly into a file. If a file contains this metadata, Scene7 automatically uploads it with
the file. You can embed metadata into source assets in Adobe Photoshop, InDesign, Illustrator, and other applications;
Scene7 recognizes this metadata. You can also add metadata to individual files in the Metadata panel in Detail view.
To ensure consistency across assets, company administrators create Metadata templates that provide the metadata
fields that can be filled in.
For more information about embedded metadata, see www.adobe.com/go/learn_s7_xmp_en.
More Help topics
“Viewer Presets” on page 32
“Metadata Presets” on page 48
View metadata
To view an asset’s metadata, open the asset in Detail view, and click the Metadata panel. Then choose an option on the
Metadata View menu to select a set of metadata fields. Scene7 offers these Metadata Views:
Compact View A basic list of values.
IPTC Values as defined by the International Press Telecommunications Council.
XMP Values as defined by the extensible metadata platform.
Administrators can create Metadata Views. These views also appear on the Metadata Views menu. For information
about creating Metadata Views, see “Metadata Views” on page 48.
Manually enter metadata for an asset
1 Open the asset in Detail view.
2 Open the Metadata panel and do one or both of the following:
• Choose a Metadata View to determine which metadata fields appear in the panel.
• Choose a Preset Value and click Apply to populate metadata fields with preset values. Company administrators
create these preset values.
Last updated 10/9/2014
109
USING SCENE7
Managing assets
3 Enter values in the Metadata panel.
To edit the metadata of several assets at once, select the assets and choose File > Edit Info. Edits you make to metadata
in the Edit Info window apply to all the assets you selected.
Add or edit keywords
In addition to metadata, you can use keywords to assist in searching and managing your assets.
If you’ve added keywords to other files during this session, or if you’ve removed keywords from your list, they appear
in the Keyword Suggestions table.
1 Open the file in Detail View.
2 Click Keywords.
3 To add keywords, do any of the following:
• Type a keyword in the text box and click Add.
• Click a keyword in the Keyword Suggestions table.
4 To remove a keyword, select it and click Remove. It moves to the Keyword Suggestions table.
Note: You can add keywords to files as you upload them to Scene7. In the Upload Job Options dialog box, choose
Additional Metadata and enter keywords. See “Upload options” on page 84.
Import metadata
Rather than manually enter metadata one asset at a time, you can import metadata for many different assets from a
tab-delimited or XML file. Entering the metadata in a tab-delimited or XML file and importing the file is less timeconsuming than entering metadata in individual assets. In the first row of the tab-delimited file, enter the ID and the
names of fields for which you want to record metadata. In each subsequent row, enter an asset ID name followed by
metadata values. Fields that are not included in the tab-delimited or XML file are not modified. To import metadata
from an XML file, make sure that you conform to the DTD.
Note: You can create a template for entering metadata so that it can be properly imported to Scene7 Publishing System.
After you create the template, you can use it to enter the metadata. See “Create a template for entering metadata to
upload” on page 111.
You can find more information about standardized properties at: http://www.adobe.com/devnet/xmp.html
1 In the Browse Panel, select the images to which you want to add metadata from the tab-delimited or XML file.
2 Click File > Import Metadata.
3 In the Upload Metadata dialog box, click Browse.
4 In the Select files to upload dialog box, select the tab-delimited or XML file with the metadata.
5 Enter a job name.
6 Click Upload.
Identifying different metadata types in the import
Keep the following in mind when identifying different metadata types to import:
• User Defined Fields are identified by their name as created in Setup > Application Setup > Metadata > User-Defined
fields. Use the Generate file functionality to get a list of all defined UDFs in the correct import format.
Last updated 10/9/2014
110
USING SCENE7
Managing assets
• XMP Metadata properties must have the related XMP-prefix before the (property-) name. A colon separates the
prefix and name. The XMP prefix can be found in Setup > Application Setup > Metadata > Metadata Schema editor.
The technical names can be found in documentation of related XMP schema. Note that XMP properties names do
not appear in the Generate file feature.
• Metadata Schema properties must have the related prefix before the (property-) name. A colon separates the prefix
and name. The prefix and the property names are defined in the Metadata Schema editor. Note that Metadata
Schema properties names do not appear in the Generate file feature.
For example: The XMP property for keywords is the XMP schema "Dublin Core" with the prefix "dc" and “subject” is
the technical XMP name. The prefix and technical XMP name are combined into the "dc:subject" full property name.
In the XML metadata import format, "dc.subject" must be the property name. In the tab-delimited import format it
must be the column-header.
Import Keywords
Keywords can be imported as comma separated list. If a comma appears in any of the individual values, it needs to be
escaped by a backslash (\). A literal backslash is the usual double-backslash (\\).
For example, a metadata import file containing the value "Hello\, World!,back\\slash,foo" for "dc:subject" sets three
XMP keywords on the asset: "Hello, World!," "back\slash," and "foo."
Import XMP and Metadata Schema metadata XMP files
The XML import accepts only valid XML. When importing XMP or Metadata Schema fields the namespace prefix is
added and behaves here like a XMP-namespace. This namespace must be declare e.g. in the top-level tag.
For example:
<ips xmlns:dc="http://purl.org/dc/elements/1.1/">
<ghw_object vc_objectname="img_001" dc:subject="word1,word2"
</ips>
Import XMP and Metadata Schema metadata Tab Delimited files
The prefix must be added to the related column header of the import field.
Import metadata (via FTP)
You can import metadata for multiple files by entering the metadata in a tab-delimited or XML file and selecting the
Process metadata files option on the Upload (Via FTP) screen.
Make sure the data in the tab-delimited or XML file is in the correct format. In the first row, enter the ID field followed
by the names of metadata fields to be modified. In each subsequent row, enter an asset ID name followed by metadata
values. Fields that are not included in the tab-delimited or XML file are not modified.
Click the Upload button on the Global Navigation Bar, and on the Jobs screen, select the Via FTP tab to import the
metadata. Then click Job Options. In the Upload Job Options dialog box, Choose Process metadata files.
Batch rename IDs using metadata
Using metadata imported from a tab-delimited file or XML file, you can rename Scene7 Publishing System IDs. The
imported metadata is applied only to the images specified in the metadata file itself. It doesn't matter whether images
are selected on the Browse Panel.
To rename an image’s Scene7 Publishing System ID, add a column labeled newipsid to the tab-delimited file, or add a
field called new_vc_objectname to the XML data.
Last updated 10/9/2014
111
USING SCENE7
Managing assets
For example:
ipsid
newipsid
testjacket_1
Jacket_test_1
testjacket_blue
Jacket_test_2
The job log for the Metadata job will show which IDs were successfully renamed and which ones were not.
Create a template for entering metadata to upload
Scene7 offers a command for creating a template for recording metadata. Using the template ensures that the metadata
is entered in the right format so it can be uploaded correctly to Scene7 Publishing System. Follow these steps to create
a template for use in recording and importing metadata to Scene7 Publishing System:
1 Select image assets with metadata fields you want for your template.
2 Choose File > Import Metadata.
3 Select Image for the Asset Properties Type.
4 From the Generate File menu, select Tab Delimited Template, Asset's XML Metadata, or XML DTD.
5 Click Generate.
6 In the dialog box that appears, copy the data. Use this data to construct the template.
More Help topics
“Import metadata” on page 109
Working with Metadata Schemas
A company administrator can view a list of all available schemas. Open Application Setup -> Metadata -> Metadata
Schema.
Initially, the list of global standard schemas like XMP are hidden. They can be shown using the checkbox at the bottom
of the list.
The company administrator can create a new custom schema, or edit an existing custom schema.
You can use the Metadata Schema Editor to perform the following actions:
Action
Description
Add
Adds a new property to the schema. A modal dialog collects the information: ID,
Label, Structure and Data Type.
Add Choice Value
Adds a new selectable choice to a property with structure Open Choice or Closed
Choice. All choice values have the same type. You must select the property itself to
enable the button.
Last updated 10/9/2014
112
USING SCENE7
Managing assets
Action
Description
Edit
Edit the Label of a property or choice value. You can only change the Label, ID, and
type information is immutable.
Move Up / Move Down
The order in the schema is reflected in the UI. To change the order, select a
property or choice value and move it with the buttons. Drag & drop is not
supported at this time.
Delete
Deletes a property or choice value from the schema. This does not delete values
from the XMP block or the Database. The property is no longer available for
Metadata Views and is removed from the Asset Detail View.If the property was
published to the Metadata Server, perform a force publish to remove the data from
the public-facing Metadata Server.
The system automatically generates a custom schema for User-defined fields with the prefix "s7udf". These are the
existing User-defined Fields and are edited in their own Setup section.
Note: Changes to the schema never change the asset metadata itself. However, they are not visible for all SPS and
Metadata Server functionality and can't be accessed after being changed. Likewise, if metadata for an asset exists, the
creation of the matching schema makes the metadata usable in SPS and the Metadata Server.
The Metadata Schema Editor offers a graphical way to add or edit a custom company schema inside SPS. A schema is
defined by a prefix, a namespace, and a list of properties.
• Name
UI-Name for the schema. Used to identify the properties in Metadata Views and Advanced Search. Similar to XMP
Sections like Basic, IPTC, PDF.
• Prefix
Technical unique identifier for the schema. Restricted to the letters a-z and A-Z. The prefix is not visible in the SPS
UI, but used, when metadata for an asset is stored in the XMP block and our database. The prefix is used, to
uniquely identify metadata fields in metadata search queries on the Metadata Server or import.
• Namespace
Technical unique identifier for the schema, typically a URL in the form http://your.company.com/name/version/.
See the list of standard schemas for examples. The namespace is not visible in the SPS UI, but is used to store
metadata in the XMP block.
• Description
Free form description of the schema.
Note: The prefix and namespace cannot be edited. To change these properties, you must delete and re-create the schema.
Properties describe the metadata that can be stored with this schema in the XMP block. A property consists of:
Last updated 10/9/2014
113
USING SCENE7
Managing assets
Property
Description
ID
Technical identifier for this property. The ID is not visible in SPS UI, but used, when
metadata for an asset is stored in the XMP block and our database. The ID is used,
to create search queries on the Metadata Server. The ID has some restrictions such
as:
•
No spaces
•
No ".", ":", "$"
•
No number as first character
•
Best practice is to use a-z or A-Z as first character
Once created, the ID cannot be changed.
Label
UI-Name for this property.
Structure
Determines the type of the property together with Data Type. Structure can be one
of:
Data Type
•
Simple Type: single value of data type
•
Sequence: a list of values of the same data type
•
Open Choice: select one item from a list of predefined values, or enter free text.
Can be only of data type String or Integer
•
Closed Choice: select one item from a list of predefined values (a popup or
combo-box)
Select from these available types:
•
String
•
Integer
•
Float
•
Yes/No (Boolean)
•
Date
When the property has the structure Open Choice or Closed Choice, you must provide at least one Choice Value. Open
Choice can be changed. Closed Choice cannot be changed. All Choice Values have the data type of the property.
Property
Description
ID
Technical identifier for this value. The ID is not visible in the SPS UI, but is used
when metadata for an asset is stored in the XMP block and the database. The ID is
used in search queries on the Metadata Server. The ID cannot contain any spaces.
Once created, the ID cannot be changed.
Label
UI-Name for this value.
Exporting assets from Scene7 Publishing System
You can save assets you edited in Scene7 Publishing System to a local network drive. Exported assets are bundled in a
ZIP file for downloading or sending by e-mail.
Last updated 10/9/2014
114
USING SCENE7
Managing assets
The compressed Zip file has a maximum file size of 1 GB for the export job. Also, be aware that you are allowed a
maximum of 500 total assets per export job.
Scene7 keeps a record of export jobs in the Jobs screen.
To export assets from Scene7 Publishing System
1 Select the assets you want to export, and then click File > Export.
2 In the Export Selected Assets window, click Image Options, and then specify any of the following options
(administrators determine which options are available to their users):
Presets Optionally, choose an Image Preset to format the asset when you export it. If you choose an Image Preset,
the other formatting options are not available, as the asset adopts the formats defined by the Image Preset.
Conversion Convert the asset file or the original image.
Size You can select a standard size. Or, you can click Other from the Size drop-down list, choose the desired unit
of measure, and then specify the width and height.
See also “Specifying export options available to Media Portal users” on page 76.
Format Choose an image format.
Color Choose RGB, CMYK, or Gray.
Resolution Choose 72, 150, or 300 ppi.
Job Name You can assign a job name to the export.
Send Email To Optionally, enter an e-mail address to send the assets by e-mail. The e-mail message lists the URL
where the recipient can go to download the assets.
3 Click Export.
Three basic export actions are supported:
• Original File (export the original file for the asset)
• Convert Using Preset (use an image preset to format the asset)
• Convert Without Preset (use the export dialog to specify image modifiers)
The following asset types cannot be exported. All others should generate an export.
• Image Sets
• Render Sets
• Spin Sets
• Media Sets
• Multi-bitrate Sets
• eCatalogs
In addition, templates cannot be exported as an “original file.”
You can use conversion to export the following asset types:
• Images
• Templates
• Adjusted Images
• PDF (will generate converted pages)
Last updated 10/9/2014
115
USING SCENE7
Managing assets
• Postscript
The following behavior results when a large selection of various asset types are fed into the exporter:
• All asset types which cannot be exported are removed from the list before job submittal
• If a conversion is requested, all types which can be converted are, and all others are exported as original
Sharing asset changes with peers in real time
With multiple copies of Scene7 running on one or more computers in the same company, the following actions from
any Scene7 client are updated in real-time with all peer clients:
• Edit an asset (builder, image editor, etc.)
• Rename an asset
• Delete an asset
• Move an asset
• Upload one or more assets (both desktop and FTP)
• Create, delete, or rename a folder
After a change is made in the originating client, all peer clients logged into the same company are updated with the
change. Changes are made to peers without notification, unless the peer is editing a changing asset in any of the image
editors or builders.
When you log in, Flash Player prompts you to allow or deny peer updates. You can "remember" the choice so you are
only prompted once. To clear your choice, delete the appropriate site from the Peer Assisted Networking panel in
Global Settings.
If you are editing an asset that is changed by a peer, you are prompted to ingest the change into the builder or editor.
If you choose Yes, then the builder or editor discards any changes made to the asset and imports the updated asset. If
you choose No, the asset is unchanged in the builder or editor and any changes you’ve made persist in that session.
When you save the asset, you are notified that a newer version exists and asked if you want to overwrite the asset with
your changes.
Printing assets
Follow these steps to print an asset:
1 In the Browse Panel, select the asset or assets you want to print.
2 Choose File > Print or press Ctrl+P (Windows) or Command+P (Macintosh).
3 In the Print dialog box, choose how many copies to print and then select the Print button.
Last updated 10/9/2014
116
USING SCENE7
Managing assets
Managing the Trash folder
Items that you delete from the Scene7 Publishing System are moved to the Trash folder. They remain for seven days
in this folder until they are restored or permanently deleted. You can examine deleted items by selecting the Trash
icon located at the bottom of the Asset Library and viewing items in the Trash folder.
All users can restore items in the Trash folder to the folders from which they were deleted. All users can also empty the
Trash folder of all its contents.
Deleting items from the Trash folder permanently deletes items from Scene7 Publishing System; items deleted from
the Trash folder can no longer be restored. For information on setting up notifications for company administrators
when assets are about to be automatically deleted from the Trash, see “General Settings” on page 20.
Important: Assets that have been moved to the Trash folder are still registered on the Scene7 Publishing System. If you
try to upload a file that has the same name as a deleted file in the Trash folder, Scene7 treats the asset you want to upload
as a duplicate asset. As such, a number is appended to its name.
More Help topics
“Delete assets” on page 105
About the Trash folder
Deleting an item in a folder places the item in the Trash folder. The following happens when you delete an item and
move it to the Trash folder:
• Although the item has been removed from your Scene7 Publishing System folders, its ID cannot be assigned to
another asset while it remains in the Trash folder. If you try to upload an asset with the same name as a file in the
Trash folder, Scene7 appends a numeral to the name of the asset.
• The item cannot be published. Even if the item was marked for publish when you deleted it, it is not published.
• The item remains in the Trash folder until it is restored, seven days pass, or someone chooses the Empty The Trash
command. After seven days, an automatic clean-up operation permanently deletes the item.
Restoring assets from the Trash folder
It isn’t necessary for the person who deleted an asset to restore it; anyone can restore assets from the Trash folder.
Assets that are restored are placed in the folders from which they were deleted. If these folders no longer exist, the
Scene7 Publishing System re-creates them, and the restored assets are placed in the re-created folders.
Follow these steps to restore assets from the Trash folder to the folders from which they were deleted:
1 Select the Trash icon
to open the Trash folder.
2 Select the asset or assets you want to restore.
3 Choose File > Restore From Trash.
Permanently deleting assets in the Trash folder
When you delete assets in the Trash folder, the assets are permanently deleted. Assets are automatically deleted from
the Trash folder after seven days.
Last updated 10/9/2014
117
USING SCENE7
Managing assets
To permanently delete assets from the Trash folder, select the Trash icon
individual assets or delete all the assets in the folder:
, to open the Trash folder. Then delete
Deleting individual assets Select the assets you want to permanently delete and choose File > Empty From Trash.
Deleting all assets Choose File > Empty Trash.
Organizing your work with Projects
Projects provide an optional, secondary way for you to organize assets independently of the folders in which they are
stored. An asset can be placed in only one folder, but it can be copied into more than one Project folder for
organizational purposes.
After you create a Project folder, you can place assets in it. However, assets in a Project are actually pointers to the Asset
Library folder in which the assets are actually stored. You can place an asset in more than one Project. For example, an
image of a blouse can be placed in both the “Blouses” and “Fall Collection” Project folders.
You can create a Project when you upload files or create Projects in the Asset Library Panel.
Scene7 recommends organizing assets with metadata rather than Projects. See “Viewing, adding, and exporting
metadata” on page 108.
Note: For you to organize assets in Projects, your administrator must have set you up to use them. If you don’t see a
Projects folder section at the bottom of the Assets Library, this method of organizing assets is not available to you. See
“General Settings” on page 20.
Creating a Project folder
You can create a Project folder starting in the Assets Library or when you upload files to the Scene7 Publishing System:
In the Asset Library Scroll to the bottom of the Asset Library, to the Projects section, and select the Add Project
button
. Then enter a name for the project.
When uploading files In the Upload screen, select the Add to Project menu and choose Create Project. Then enter a
name for the project.
Note: The Projects area in the Asset Library is a single level folder list; it doesn’t permit subfolders.
Working with Project folders
Follow these instructions to display, delete, and rename a Project folder:
Browsing contents Select the name of the folder in the Asset Library. Its assets appear in the Browse Panel.
Deleting Project folders Select the Project folder and then select the Remove Project button
. Deleting assets from
a Project folder does not delete them from Scene7 Publishing System; the assets remain in the original folders in which
they are stored.
Renaming Project folders Double-click the name of the folder in the Asset Panel, and then enter a new name.
Last updated 10/9/2014
118
USING SCENE7
Managing assets
Adding assets to a Project folder
You can add images to a Project folder starting in the Browse Panel or when you upload files to the Scene7 Publishing
System:
From the Browse Panel Select the assets and drag them to a Project folder. You can also choose File > Add To Project,
select a Project folder name in the Select Project dialog box, and select the Submit button.
When uploading files In the Upload screen, click the Job Options button. In the Upload Job Options dialog box,
choose Projects, and select a project name.
Last updated 10/9/2014
119
Chapter 7: Image Sizing
Image Sizing refers to the ability of Scene7 to create multiple derivative images based on a single high-resolution image.
Rather than manually creating several images­—for example, a thumbnail and enlarged-view image—for your web site
or application, you provide a single master image. Scene7 generates all modified images just as you request them. Being
able to deliver images dynamically from a single master image has many advantages:
• You do not have to manually create several copies of the image at different sizes. You supply one master image to
Scene7, and Scene7 generates different-sized derivatives from the master image.
• You can quickly change the size of an image type throughout your web site or application. For example, to change
all thumbnail images, you can modify the “thumbnail” Image Preset. An Image Preset—it’s similar to a macro—is
a collection of size and formatting attributes. You can modify the “thumbnail” Image Preset to change the size of
all thumbnail images throughout your web site or application.
• You do not have to manage the masters and all of the various derivatives in any of your content or asset
management systems internally or externally.
2000 pixels
2000 pixels
Single master image
(Recommend 1500-2500 pixels
in longest dimension)
1.
2.
3.
4.
Dynamically
sized images
(using Image Presets)
Upload single master image file
Create Image Presets (to define size, format, sharpening & other settings)
Publish
Copy URLs and use on Websites to display different sizes dynamically
You can create multiple derivative images at different sizes from the same high-resolution master file.
Quick Start: Image Sizing
This Image Sizing Quick Start is designed to help you get up and running quickly with Image Sizing techniques in the
Scene7 Publishing System. Follow steps 1 through 5. After each step is a cross-reference where you can find more
information if you need it.
Last updated 10/9/2014
120
USING SCENE7
Image Sizing
1. Uploading master images
Start by uploading your master images to the Scene7 Publishing System. As to size, Scene7 recommends using images
that are the largest size you anticipate using on your web site or application. For example, if you want viewers to zoom
images, upload images that are at least 2000 pixels in the largest dimension. Scene7 supports many image file formats,
but lossless TIFF and PNG images are recommended.
Select the Upload button on the Global Navigation bar to upload files from your computer to a folder on the Scene7
Publishing System. See “Uploading master images” on page 121.
2. Setting up Image Presets
Like a macro, an Image Preset is a collection of predefined size and formatting commands saved under a name. An
Image Preset governs the size and formatting with which images are delivered from Scene7 Image Servers. You can set
up Image Presets on your own if you have company administrator status. Scene7 also comes with default Image
Presets, and you can use them to dynamically deliver images.
To create an Image Preset (if you are an administrator), choose Setup > Application Setup. On the Setup screen, display
the Application Setup options and choose Image Presets. Then select the Add or Edit button to create an Image Preset.
The Image Preset you create is added to the Image Preset menu on the Preview screen. You can use your new Image
Preset to display images dynamically on your web sites and applications. See “Setting up Image Presets” on page 121.
3. Previewing Image Presets
The next step is to preview the Image Presets your administrator set up at the different preset sizes.
To explore Image Presets, click Setup > Image Presets, and then browse to an Image Preset.
Experiment with the different Image Presets. Find out what your image looks like when it is delivered dynamically to
your web site or application at different sizes.
See “Previewing an image asset based on its Image Preset” on page 103.
4. Publishing your master images
Publishing your master image files serves two essential purposes:
• Publishing your master images to Scene7 Image Servers so that images can be dynamically delivered to your web
site and application.
• Publishing activates the URL strings for calling images from Scene7 Image Servers to your web site or application.
After publishing, you can copy and place the Scene7-generated URLs where necessary in your web site or
application.
Select the Publish button on the Global Navigation bar to initiate a publish. On the Publish screen, select the Start
Publish button. See “Publishing master images” on page 123.
5. Linking URLs to your web application
Scene7 creates URL callout strings for images. When you publish images to Scene7 Image Servers, the URLs become
active. You can copy these URL strings from the Browse Panel (in Detail view) or Preview screen. After you copy the
URL strings, you can use them in your web site and applications. The URL for image sizing replaces the reference to a
static image name in your web page code. The URL references a master image name, which is replaced by your
database for each new image to display.
URL strings generated with Image Presets contain the name of an Image Preset. This name is enclosed in dollar signs
($). For example, $thumbnail$ can be the Image Preset designed to show master images at thumbnail size. See
“Linking URLs to your web application” on page 123.
Last updated 10/9/2014
121
USING SCENE7
Image Sizing
Uploading master images
Before uploading images to the Scene7 Publishing System, make sure they are the highest quality size and format.
Scene7 recommends uploading high-quality images with a sufficient pixel count (from 1500 to 2000 pixels in the long
dimension). This allows for any dynamic imaging that is required.
For details on uploading images, see “Uploading files” on page 79.
Preparing your master images for upload
Prepare your master image files before you upload them to the Scene7 Publishing System:
Image size Create the largest size images you anticipate using. Typical image sizes range from 1500 to 2500 pixels in
the longest dimension. If you intend to use the Zoom feature, Scene7 recommends using images that are at least 2000
pixels in the longest dimension for optimal zoom detail.
File formats Scene7 supports all standard image file formats, including TIFF, BMP, JPEG, PSD, GIF, and EPS. Lossless
image formats—TIFF and PNG—are recommended. If you are using a JPEG image, use the highest quality settings.
Color space RGB is the color space for web image presentations; CMYK images commonly used for printing are
automatically converted to RGB when you upload them. Uploading CMYK images that have an embedded ICC color
profile for the conversion to RGB is recommended. See also “ICC profiles” on page 315.
Setting up Image Presets
Like a macro, an Image Preset is a predefined collection of sizing and formatting commands saved under a name. To
understand how Image Presets work, suppose your web site requires each product image to appear at two different
sizes: 500 x 500 pixels and 150 x 150 pixels. You create two Image Presets, one called “Enlarge” to display images at
500x500 pixels and one called “Thumbnail” to display images at 150 x 150 pixels. To deliver images at the “Enlarge”
and “Thumbnail” size, a Scene7 Image Server looks up the definition of the Enlarge Image Preset and Thumbnail
Image Preset. Then the server dynamically generates an image at the size and formatting specifications of each Image
Preset.
Scene7 comes with several “best practice” Image Presets that are already set up for you to use. Administrators can
create new Image Presets as well. To create an Image Preset, you can start from scratch or you can start from an existing
one and save it under a new name.
Images that are reduced in size when they are delivered dynamically from a server can lose sharpness and detail. For
this reason, each Image Preset contains formatting controls for optimizing an image when it is delivered at a particular
size. These controls make sure that your images are sharp and clear when they are delivered to your web site or
application.
Creating an Image Preset
You can create your own Image Presets if you are a company administrator. You can create new Image Presets or start
with a default Image Preset that Scene7 provides, edit it, and save it with a new name.
To create an Image Preset
1 Click Setup > Image Presets.
You can browse to an Image Preset name on this screen to preview an existing Image Preset. When you select an
Image Preset name, the sample image in the Preview window changes size and appearance.
Last updated 10/9/2014
122
USING SCENE7
Image Sizing
2 Do one of the following:
Creating an Image Preset Click Add.
Editing an Image Preset Browse to the Image Preset that is most like the one you want to create and then click Edit.
3 Enter a name for the Image Preset.
4 Enter Width and Height measurements in pixels. These measurements determine the size at which images are
delivered.
5 Fill in the Add Preset or Edit Preset screen. For details, see “Image Preset options” on page 24.
Scene7 recommends these “best practice” option choices to start:
Format Choose JPEG or another format that meets your requirements. All web browsers support the JPEG image
format; it offers a good balance between small files sizes and image quality. However, JPEG format images use a
lossy compression scheme that can introduce unwanted image artifacts if the compression setting is too low. For
that reason, Scene7 recommends setting the compression quality (on the slider) to 75. This setting offers a good
balance between image quality and small file size.
Sharpening Do not select Sharpening (this sharpening filter offers less control than Unsharp Masking settings).
Resample Mode Choose Bi-Cubic.
Unsharp Masking (USM) options Enter the settings shown here:
Preset type
Size
USM: Amount
USM: Radius
USM: Threshold
Cross-Sell (mini-thumbnail)
75 x 75
1.5
0.8
5
Thumbnail
150 x 150
1.1
1
5
Main
350 x 350
1
1
6
Enlarge
500 x 500
1.2
1.2
5
6 Click Save.
The Scene7 “best practice” options for creating Image Presets listed here are general recommendations; sharpening is
highly subjective. These “best practice” settings were based on a 2000 x 2000 master image; settings for larger or smaller
masters can be different. If you want to adjust the Unsharp Masking settings, Scene7 recommends these ranges:
Amount Between .8 and 1.5.
Radius Between .6 and 2.
Threshold From 1-6.
To delete an Image Preset, select it on the Image Presets screen and select the Delete button.
More Help topics
“Creating and editing Image Presets” on page 23
“Image Preset options” on page 24
“Previewing an image asset based on its Image Preset” on page 103
Last updated 10/9/2014
123
USING SCENE7
Image Sizing
Publishing master images
Publishing your image files publishes them to Scene7 Image Servers, where they are available to your web site and
application. What’s more, during the publishing process, the Scene7 Publishing System activates the URL strings you
need for your web site and application.
More Help topics
“Publishing files” on page 87
Marking master images for publish
Master images must be marked for publish in order for them to be copied to Scene7 Image Servers. You can mark your
master images for publish in the Browse Panel by selecting the Mark for Publish icon . You can also mark images
for publish when you upload them to the Scene7 Publishing System.
Publishing your master images
To publish master images to Scene7 Image Servers, start by selecting the Publish button on the Global Navigation bar.
Then select a When option (One-Time or Recurring), optionally enter a name for the publish job, and select the Start
Publish button.
Important: The URL is not active until you publish the asset.
Linking URLs to your web application
Your web sites and applications access Scene7 Image Server content via URL strings. After you publish an image,
Scene7 activates a URL string that references the Image Preset on Scene7 Image Servers. You can paste these URLs into
a web browser for testing.
To place these URL strings in your web pages and applications, copy them from the Scene7 Publishing System. To
obtain a URL string generated with an Image Preset, go to the Preview screen or the Browse Panel (in Detail view).
Obtaining an Image Preset URL
You can obtain a URL string generated by an Image Preset from Preview or from Detail View. After you copy the URL,
it lands on the Clipboard so you can paste it as necessary.
Important: The URL is not active until you publish the asset.
Obtaining an Image Preset URL from Preview
1 In the Asset Library panel on the left side, navigate to the Asset folders that contains the image asset you want to
preview.
2 Do any one of the following:
• Above the Assets window, on the right side of the toolbar, click Grid View. In the Asset window, select a single
image asset, and then below the thumbnail image, click Preview > Image Preset List.
• Above the Assets window, on the right side of the toolbar, click List View. In the Asset window, select a single
image asset, and then to the right of the thumbnail image, click Preview > Image Preset List.
Last updated 10/9/2014
124
USING SCENE7
Image Sizing
• Above the Assets window, on the right side of the toolbar, click Detail View. On the same toolbar, click Preview
> Image Preset List.
3 (Optional) In the Image Preset List window, in the URL Encoding for Copy URL Generation drop-down list at the
bottom, select the URL encoding that you want applied to the image asset’s URL when it is copied.
4 In the Image Preset List window, in the upper-right area of the preview pane, click Copy URL for the selected preset type.
5 In the lower-right corner of the Image Preset List window, click Close to return to the Assets screen.
Obtaining an Image Preset URL from the Browse Panel
1 In the Asset Library panel on the left side, navigate to the Asset folders that contains the image asset you want to
preview.
2 Above the Assets window, on the right side of the toolbar, click Grid View. In the Asset window, select a single
image asset.
3 Above the Assets window, on the right side of the toolbar, click Detail View.
4 Click URLs on the panel on the right side of the screen to unfold the list of Image Presets.
5 Click Copy URL link next to the name of the Image Preset with the URL you want to copy to the Clipboard.
About Image Preset URL strings
A URL call for Image Sizing to Scene7 Image Servers has the following basic syntax:
path/name of Image Server/account name/image name?modifier1&modifier2&...
In a Scene7 Image Server URL, instructions to the server for displaying the image appear after the question mark (?).
For example, this URL call delivers an image named “backpack” at a width of 250 pixels:
http://s71.scene7.com/is/image/S7learn/backpack?wid=250
An Image Preset URL contains all the modifier instructions for presenting the image at the proper size and formatting
specifications. Without an Image Preset, notice all the modifier instructions after the question mark (?) in this URL
string:
http://s71.scene7.com/is/image/S7learn/backpack?wid=250&fmt=jpeg&qlt=80,0&resMode=sharp&op_u
sm=1.1,0.5,1,0
However, in a URL string generated with an Image Preset, the name of the Image Preset appears in place of the
instructions defined by the Image Preset. For example, referring to the long URL above, the URL string is:
http://s71.scene7.com/is/image/S7learn/backpack?$Large$
Image Preset names in URLs are enclosed in dollar signs ($). When a Scene7 Image Server encounters the Image Preset
portion of the URL (the Large in this case), using the size and formatting instructions defined by the “Large” Image
Preset.
More Help topics
“Adding dynamic images to your web page” on page 124
Adding dynamic images to your web page
To add dynamic images to your web page, the <IMG> tag in your HTML web page code typically is modified using the
Scene7 URL string to make a request to Scene7 Image Servers. This string produces the image at the size and
formatting specifications defined by the Image Preset.
Last updated 10/9/2014
125
USING SCENE7
Image Sizing
For example, instead of the typical call to open a static image such as
img src="/company_images/products/backpack_thumbnail.jpg"
you now use the <IMG> tag to replace the reference to a static image with an Image Preset call to the Scene7 platform.
A sample call looks like this:
img src="http://s7d2.scene7.com/is/image/S7learn/backpack_trns?$thumbnail$"
In this example, a Scene7 Image Server “looks up” the definition of $thumbnail$ and dynamically generates the
appropriate image with the sizing and formatting specifications defined by the thumbnail Image Preset. In a URL
string, all items except the product image filename (backpack_trns in this case) are typically hardwired for the page
template. The only element that is automatically inserted in the page template from your commerce server is the IPS
ID or name of the image.
More Help topics
“About Image Preset URL strings” on page 124
Last updated 10/9/2014
126
Chapter 8: Zoom
Zooming allows you to interactively view high-resolution details in images. For example, you can see the colors,
options, angles, and details of an image in a dynamic, fully configurable, integrated viewer. This viewer can be
embedded on a web page or appear in a pop-up window. You can inspect images at close range and pan images at high
resolutions to examine them closely. Zooming gives your clients an engaging, informative, and interactive viewing
experience.
Scene7 also offers guided zooming—a means for you to highlight the important features in an image. For example, to
focus the attention of viewers on a logo, you can create a zoom target for the logo. When viewers click this zoom target,
they zoom to the logo.
All zoom images are created and served from single master images, graphics, and database-driven attributes. Scene7
zooming greatly reduces the time and cost of producing and delivering images. You can use Zoom Viewers, available
in both HTML5 and Flash AS3, to zoom images. The Zoom Viewer has buttons that you can click to zoom and pan;
you can also pan by dragging onscreen. Using Zoom Viewer Presets, you can configure the Zoom Viewer in which you
zoom images.
Quick Start: Zoom
This Zoom Quick Start is designed to get up and running quickly with Zoom techniques in Scene7. Follow steps 1
through 6. After each step is a cross-reference to a topic heading where you can find more information.
1. Uploading zoom Images
Start by uploading your zoom images to the Scene7 Publishing System. For optimal zooming, Scene7 recommends that
the images are at least 2000 pixels in the longest dimension.
Select the Upload button on the Global Navigation bar to upload images from your computer or network to a folder
on the Scene7 Publishing System. See “Uploading zoom images” on page 127.
2. Creating zoom targets for guided zooming
Zoom targets present a way for you to highlight specific parts of an image. For example, you can direct attention to the
parts of an image that make it unique or distinctive. In the Zoom Viewer window, zoom targets appear in the form of
thumbnail images to the side of the image. Selecting one of these zoom target thumbnails automatically zooms to a
part of the image that you specify.
To create a zoom target, click the rollover Edit button and choose Zoom Targets, or open an image in the Browse Panel
. Then use the Zoom tools on the Zoom Target Editor screen to
in Detail view and click the Zoom Targets button
isolate part of the image as a target. See “Creating zoom targets for Guided Zoom” on page 128.
3. Setting up Zoom Viewer Presets
Zoom Viewer Presets determine the style and behavior of your Zoom Viewers. You can set up Zoom Viewer Presets
if you are an administrator; Scene7 comes with default “best practice” Zoom Viewer Presets as well.
To create a Zoom Viewer Preset, click the Setup button on the Global Navigation bar and choose Viewer Presets. Then
click the Add button in the Viewer Presets screen, choose a platform, choose a Zoom Viewer, and click Add. Then
choose options on the Configure Viewer screen.
Last updated 10/9/2014
127
USING SCENE7
Zoom
Scene7 offers Zoom Viewer Preset options that enable you to select the button style and overall look of the viewer. You
can also customize the zoom settings for your web site. See “Setting up Zoom Viewer Presets” on page 130.
4. Previewing images with the Zoom Viewer
You can preview images in a Zoom Viewer to see what the zooming experience is when images are zoomed.
To explore different Zoom Viewer Presets and how they present the zooming experience, select an image in the Browse
Panel and click the Preview button. The Preview screen opens. Choose Presets > Zoom, and then select a preset with
the Zoom menus.
Zoom buttons appear. You can see what the zoom images look like on your web site. Select the Zoom buttons (and
zoom targets) to test the settings of the Zoom Viewer Preset you chose. See “Previewing image assets with different
Zoom Viewers” on page 131.
5. Publishing zoom images
Publishing your zoom images places them on Scene7 Image Servers so that they can be delivered to your web site and
application. As part of the publishing process, the Scene7 Publishing System activates URL strings. These URL strings
call zoom images from Scene7 Image Servers to your web site or application.
Select the Publish button on the Global Navigation bar to initiate a publish. On the Publish screen, select the Start
Publish button. See “Publishing zoom images” on page 132.
6. Linking Zoom Viewers to your web page
Scene7 creates the URL callout strings necessary for zooming images, and activates them when you publish images to
Scene7 Image Servers. You can copy these URL strings from the Preview screen. After you copy the URL strings, they
are available to your web sites and applications. See “Linking Zoom viewers to your web pages” on page 132.
Uploading zoom images
Zoom images must have a high pixel count. A high number of pixels is needed so that viewers can clearly see image details
when they zoom images. Make sure that the images you use are the appropriate size before uploading them to SPS.
Select the Upload button on the Global Navigation bar to begin uploading images.
For detailed instruction on uploading images, see “Uploading files” on page 79.
Preparing your images for zooming
To take best advantage of Scene7 Zoom features, prepare your zoom image files before you upload them:
Image size Scene7 recommends using images files that are, at minimum, 2000 pixels in the longest dimension. This
way, images can clearly be seen when users zoom them.
File formats Scene7 supports all standard image file formats, including TIFF, BMP, JPEG, PSD, GIF, and EPS. Lossless
image formats—TIFF and PNG—are recommended. If you are using a JPEG image, use the highest quality settings.
Color space RGB is the color space for web image presentations; CMYK images are automatically converted to RGB
when you upload them. Uploading CMYK images that have an embedded ICC color profile for the conversion to RGB
is recommended. See also “ICC profiles” on page 315.
More Help topics
“Uploading files” on page 79
Last updated 10/9/2014
128
USING SCENE7
Zoom
Creating zoom targets for Guided Zoom
Zoom targets guide your viewers to certain parts of an image. As well as free-form zooming, viewers can click a zoom
target thumbnail and zoom to the part of the image you want them to focus on. Zoom targets are an opportunity for
you to highlight the attractive or interesting parts of an image.
Thumbnail zoom targets in the Zoom Viewer.
About zoom targets
The maximum zoom percentage of zoom targets is 100 percent. The minimum zoom percentage varies based on a
combination of the viewer size and the image size, as shown in this table:
Image size
Viewer size
Zoom percentage
Large
Smaller
Smaller minimum
Small
Larger
Larger minimum
You can change the size of the Zoom Viewer to match the size being used on your web page. To permanently change
this setting, you can change the viewer size on the Setup screen (if you are an administrator). See “Setting up Zoom
Viewer Presets” on page 130.
Creating and editing zoom targets
Create and edit zoom targets on the Zoom Target Editor screen. To open this screen, select an image and do one of the
following:
• Click the rollover Edit button and choose Zoom Targets.
• In the Browse Panel, display the image in Detail view and click the Zoom Targets button
.
On the Zoom Target Editor screen, click the Select Target button (the arrow) to select a target before changing its size
or position. Click the Add Targets button (the rectangle) to create a zoom target on the image. The Zoom Target Editor
screen also offers tools for deleting, copying, and naming zoom targets.
Last updated 10/9/2014
129
USING SCENE7
Zoom
Creating a zoom target
Open the Zoom Target Editor screen and follow these steps to create a zoom target:
1 Click the Add Targets button (the rectangle), move the pointer over the image, and click where you want to the
zoom target to be.
A thumbnail image of the zoom target appears in the panel on the right side of the screen.
2 Click the Select Target button (the arrow), click to select the zoom target you created, and adjust the size and
position of the target.
Resizing Move the pointer over a corner of the zoom target and drag to enlarge or shrink the target.
Positioning Move the pointer over the zoom target and drag it to a different location.
3 Enter a name for the zoom target in the Name box.
Important: What you enter in the Name box is more than a name. When users move the pointer over the zoom target,
they see what you enter in the Name box. Enter a brief description of the zoom target in the Name box so users know
what they can zoom on.
4 Optionally, enter user data in the User Data field. This field is for web site designers to add information to the zoom
target.
5 Click the Save button.
The coordinates and zoom level of the zoom target are saved. A thumbnail of your zoom target with the name you
entered appears on the right side of the screen.
To see what your zoom targets look like in a Zoom Viewer, click the Preview button in the Zoom Target Editor screen
and choose a Zoom Viewer in the Preview screen. For information about this screen, see “Previewing image assets with
different Zoom Viewers” on page 131.
Editing zoom targets
Use these techniques on the Zoom Target Editor screen to edit zoom targets:
Repositioning With the Select Target button (the arrow), click the target to select it. Then drag the target to a different
location.
Resizing With the Select Target button (the arrow), click the target to select it. Then move the pointer over a corner
of the zoom target and drag to enlarge or shrink the target.
Deleting Click the target’s thumbnail image on the right side of the screen. Then click the Delete Target button.
Renaming Click the target’s thumbnail image on the right side of the screen. Then enter a name in the Name box and
click Save.
Copying zoom targets
You can copy zoom targets from one image to another. Copy targets when two images present similar content and
their zoom targets belong in the same locations. Follow these steps to copy zoom targets to another image:
1 Open the image with zoom targets you want to copy in the Zoom Target Editor screen.
2 Click the Copy Targets To button.
3 In the Select Images dialog box, select an image and click the Select button.
Last updated 10/9/2014
130
USING SCENE7
Zoom
Setting up Zoom Viewer Presets
Zoom Viewer Presets determine the style, behavior, and look of your Zoom viewers. Scene7 offers many options for
customizing and skinning Viewers. Scene7 comes with default basic (fast), fly-out, and custom Zoom Viewer Presets.
If you are an administrator, you can create new company Zoom Viewer Presets or edit a default preset and save it with
a new name.
All Zoom Viewers have buttons for zooming in, zooming out, panning, and resetting the image to its original state
after zooming. What these buttons look like and what the window itself looks like depends on your choice of Zoom
Viewer Presets. You can configure a Zoom Viewer Preset with different colors, borders, fonts, and image settings.
When configuring a Guided Zoom Viewer, you can also choose where to place the zoom targets. Zoom targets are the
thumbnails that users click to zoom to areas you specify.
More Help topics
“Adding and editing Viewer presets” on page 38
About Zoom Viewer Presets
Scene7 offers these Zoom Viewer Presets:
Zoom Viewer: Basic Provides a basic zoom on original image.
Zoom Viewer: Fly-out Displays a second image of the zoomed area next to the original image. There are no controls to
use, users simply move the selection over the area they want to view.
When determining the complete bandwidth usage for this viewer, consider that both the main image and the flyout
image are served in the viewer. The flyout image size is determined by the main image size (Stage Width and Height)
and the Zoom Factor. To keep the flyout file size from becoming too large, balance these two values: if you have a large
main image size, lower the Zoom Factor value. (The Flyout Width and Flyout Height determine the size of the flyout
window, but not the size of the flyout image that is served into the viewer.)
For example, if your main image size is 350 by 350 pixels, with a Zoom Factor of 3, the resulting flyout image is 1050
by 1050 pixels. If your main image size is 300 by 300 pixels, with a Zoom Factor of 4, the flyout image is 1200 by 1200
pixels. Depending on the JPEG quality setting (recommended settings are between 80-90), you can decrease the file
size significantly. Recommended zoom factors are 2.5 to 4, depending on the size of your main image.
Scene7 recommends these parameters for fly-out Zoom Viewer Presets:
• Enlarged image size Approximately 1500 by 1500 pixels, not to exceed 2000 by 2000 pixels.
• Image size 100KB or under, not to exceed 150KB (compress the file to keep it under 150KB).
Zoom Viewer: Custom Provides guided or unguided zoom with images, Image Sets with multiple views, or Color
Swatch Sets.
Creating and editing Zoom Viewer Presets
Follow these steps to create or edit a Zoom Viewer Preset:
1 Choose Setup > Viewer Presets.
2 Do one of the following:
Creating a preset Click the Add button. In the Add Viewer Preset dialog box, choose a platform, choose a Zoom
Viewer, and click Add. Then enter a name for the preset in the Preset Name box.
Last updated 10/9/2014
131
USING SCENE7
Zoom
Editing a preset Select a Zoom Viewer Preset and click the Edit button.
3 Specify settings as desired.
To see a description of an option, click the Info Tip icon
adjacent to the option.
The preview screen displays the viewer as you update and change settings.
4 Click Save or Save As.
5 On the Viewer Presets screen, examine the Zoom Viewer Preset or Guided Zoom Viewer Preset you created. If it
needs adjusting, click Edit, change settings on the Configure Viewer screen, and click Save.
For information about managing Viewer Presets on the Viewer Presets screen, see “Viewer Presets” on page 32.
Previewing image assets with different Zoom Viewers
On the Viewer List screen, you can preview images using different Zoom Viewer Presets.
See “Configuring Default Viewers” on page 47.
See “Previewing an asset” on page 102.
To preview image assets with different zoom viewers
1 In the Asset Library panel on the left side, in the Show drop-down list, select an image-based asset type such as
Image or Image Set.
2 In the Asset Library panel on the left side, navigate the Asset folders that contain images that you want to preview
with a Zoom Viewer.
3 Do one of the following:
• Above the Assets window, on the right side of the toolbar, click Grid View. In the Asset window, below the
thumbnail image, click Preview > Viewer List.
• Above the Assets window, on the right side of the toolbar, click List View. In the Asset window, select an asset,
and then to the right of the thumbnail image, click Preview > Viewer List.
• Above the Assets window, on the right side of the toolbar, click Detail View. On the same toolbar, click Preview
> Viewer List.
4 In the Viewer List window, in the table, click a viewer link to preview the asset in the selected viewer.
5 Close the displayed viewer to return to the Viewer List screen.
6 In the lower-right corner of the Viewer List window, click Close to return to the Assets screen.
More Help topics
“Setting up Zoom Viewer Presets” on page 130
“Configuring Default Viewers” on page 47
Last updated 10/9/2014
132
USING SCENE7
Zoom
Publishing zoom images
Publishing places your zoom images on Scene7 Image Servers so they can be made available to your web site and
application. As part of the publishing process, SPS activates the URL strings. You can place these URL strings in the
HTML code of your web site.
More Help topics
“Publishing files” on page 87
Marking images for publish
Images must be marked for publish in order for them to be copied to Scene7 Image Servers. You can mark your images
for publish in the Browse Panel by selecting the Mark for Publish icon . As well, you can mark images for publish
when you upload them.
Publishing the images
To publish zoom images, start by selecting the Publish button on the Global Navigation bar. Then select a When
option (One-Time or Recurring), optionally enter a name for the publish job, and select the Start Publish button.
Linking Zoom viewers to your web pages
Your web sites and applications access Scene7 Image Server content, including master images and associated zoom
targets, and Zoom Viewer Presets, by way of URL strings or embedded code. These URL strings are activated during
the publishing process. To place these URL strings or the embedded code in your web pages and applications, you copy
them from the Scene7 Publishing System.
Important: The URL is not active until you publish the asset.
Copying a Zoom viewer URL
1 in the Asset Library panel on the left side, navigate to the asset folder that contains the Zoom viewer whose URL
you want to copy.
2 Above the Asset Browse panel, on the right side of the toolbar, do one of the following:
• Click Grid View or List View. In the Asset Browse panel, double-click a single asset to open it in Detail View.
In the URLs and Embed Code panel on the right, click Copy URL to the right of the viewer you want.
• Click Grid View. In the Asset Browse panel, select a single asset, and then below the thumbnail image, click
Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Copy URL.
• Click List View. In the Asset Browse panel, select a single asset, and then to the right of the thumbnail image,
click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Copy URL.
• Click Grid View, List View, or Detail View. On the same toolbar, click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Copy URL.
Last updated 10/9/2014
133
USING SCENE7
Zoom
Adding Zoom viewer URLs to your web page
Typically, visitors to a web site zoom images by first selecting a Zoom icon (often the icon shows the image of a
magnifying glass). Selecting this icon launches a dynamic web page (ASP or JSP) that displays the image in a pop-up
window. The pop-up window is where visitors actually zoom the image.
Here is an example of code that your IT staff can create to open a pop-up window for zooming:
<a href="javascript:zoom_window();">
<img src="http://www.scene7.com/images/buttons/zoomMag.gif" width="50" height="50" border="0"
/></a>
Notice that the link calls a JavaScript function called zoom_window(). The zoom_window() function is placed above
the </HEAD> tag in the HTML code of the web page:
<script language="javascript">
<!-function zoom_window() {
window.open("http://s7d4.scene7.com/s7ondemand/zoom/flasht_zoom.jsp
?company=S7Web&sku=Backpack1&zoomwidth=420&zoomheight=470&
vc=skin=/is-viewers/flash/basicZoomSkin.swf","", "toolbar=no,location=no,directories=no,"
+ "status=no,menubar=no,scrollbars=yes"+
"resizable=yes,width=500,height=450,top=0,left=0,right=0,bottom=0")
}
-->
</script>
Notice that the URL of the pop-up window is a Scene7 URL
(http://s7d4.scene7.com/s7ondemand/zoom/flasht_zoom.jsp). This URL calls the zoom pop-up window (a
JSP page) that contains the Zoom Flash Viewer and master image. The JSP page, Zoom Viewer, and master image are
all located on Scene7 Servers. Replace the Scene7 URL in the code with your zoom URL.
In the URL, notice a SKU parameter (&sku=Backpack1). The string after &sku= is Backpack1. The zoom feature popup link of each product contains a different product SKU that tells the Scene7 JSP page which product image to display.
The user selects the zoom feature link on the product details page that launches the screen.
Copying the embed copy of a Zoom viewer
Using the Embed Code feature lets you review the viewer code for the selected Zoom viewer. You can also copy the
code to the clipboard so you can paste it in your web pages for deployment of the viewer. Editing of the code is not
permitted in the Embed Code dialog box.
To copy the embed code of a Zoom viewer
1 in the Asset Library panel on the left side, navigate to the asset folder that contains the Zoom viewer whose embed
code you want to copy.
2 Above the Asset Browse panel, on the right side of the toolbar, do one of the following:
• Click Grid View. In the Asset Browse panel, double-click a single asset to open it in Detail View. In the URLs
and Embed Code panel on the right, click Embed Code to the right of the viewer you want.
• Click Grid View. In the Asset Browse panel, select a single asset, and then below the thumbnail image, click
Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Embed Code.
• Click List View. In the Asset Browse panel, select a single asset, and then to the right of the thumbnail image,
click Preview > Viewer List.
Last updated 10/9/2014
134
USING SCENE7
Zoom
In the Viewer List page, under the Actions column of the table, click Embed Code.
• Click Grid View, List View, or Detail View. On the same toolbar, click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Embed Code.
3 In the Embed Code dialog box, click Copy to Clipboard.
Editing the code is not permitted in the Embed Code dialog box.
4 Click Close.
Last updated 10/9/2014
135
Chapter 9: eCatalogs
An eCatalog is a digital, web version of print material—a catalog, brochure, flyer, product manual, or advertising
circular, for example. An eCatalog is displayed in an eCatalog Viewer on a web site. This viewer simulates the
experience of reading printed material. Depending on the settings you choose for your eCatalog, viewers can:
• Page forward or backward by clicking the lower-left or lower-right corner of a page, or the Back or Next button.
• Select a page number or page title to go to a specific page.
• Zoom in, zoom out, and pan to examine items on a page.
• Move the pointer over a page region (called an Image Map) to see a pop-up window with information about an item.
• Click a page region to open a new web page with more information about an item.
• Write a sticky note and attach it to an eCatalog page.
• Tap image map icons to launch related web pages or in-context info panels.
• Use gesture interactions, including pinching to zoom and swiping to turn pages.
• Search by keyword for items.
A
B
The eCatalog as it looks to users.
A. eCatalog opening page B. eCatalog turned to page 2
To create an eCatalog, you typically use high-resolution PDF files created in Adobe® Acrobat® or another print
program, but you can also create an eCatalog from image files.
Last updated 10/9/2014
136
USING SCENE7
eCatalogs
As part of creating your eCatalog, you can arrange pages or page spreads in the order you choose. You can also declare
whether you want single pages, double-page spreads, or multi-page spreads. You can create Image Maps for page
regions so that viewers can, for example, click an area on the page and open a new page on your web site. You can
manage the rollover text that appears using InfoPanel settings within the eCatalog screen. You can also configure the
eCatalog Viewer by choosing from more than 100 different configuration options. You can tailor the features and the
appearance of your Viewer for your particular audience.
Quick Start: eCatalog
This eCatalog Quick Start is designed to help you get up and running quickly with eCatalogs. Follow steps 1 through
7. After each step is a cross-reference to a topic heading where you can find more information.
1. Uploading the PDF files
Adobe PDF files are usually the source for an eCatalog. Because they are meant to be printed, PDF files usually contain
CMYK images. The Scene7 Publishing System detects these images and converts them using a standard CMYK color
profile. However, you may have to upload and use a custom color profile.
Select the Upload button on the Global Navigation bar to start uploading PDF files or images for your eCatalog. You
can upload files from your desktop or via FTP; FTP is recommended if you are uploading many files or files larger than
100 MB.
Under PDF Options, the Upload screen provides options for uploading PDF files at the proper resolution and correct
color space. A 150 pixels-per-inch resolution is recommended. You can select the Auto-Generate eCatalog option to
create an eCatalog when you upload a PDF file.
See “Uploading the PDF files” on page 138.
2. Creating an eCatalog
Create your eCatalog by selecting PDF or image files in the Browse Panel, and then clicking the Build button and
choosing eCatalogs. The eCatalog screen opens.
On the Order Pages tab, select a Layout button—1 Up, 2 Up, or Custom—to choose whether you want single, double,
or custom page spreads. You can rearrange pages or spreads by dragging them or, in a large eCatalog, choosing a page
name on the Move To menu.
To add pages, select a folder in the Asset Library, and then drag PDF or image files from into the Order Pages screen.
Instead of default page numbers, you can provide custom page names or import a large number of page names.
Click the Save button, enter a name for your eCatalog, choose an SPS folder for storing it, and select the Save button.
Each time you change the page order or edit your eCatalog, save your changes by clicking the Save button.
See “Creating an eCatalog” on page 139.
3. Creating Image Maps
Image Maps add another dimension to eCatalog pages. An Image Map is a region on a page that delivers more
information about an item. When viewers roll the pointer over an Image Map, they see a description of the item. Clicking
an Image Map activates an external reference that opens a new web page where you can learn more about an item.
To create an Image Map, open the eCatalog screen. Then go to the Map Pages tab of the eCatalog screen, and draw the
or Polygon Image Map tool . You can adjust the position and size of
map with the Rectangle Image Map tool
Image Maps by dragging map borders with the Pan tool .
Last updated 10/9/2014
137
USING SCENE7
eCatalogs
After you draw the Image Map, enter the URL address that you want to go to when you click the Image Map. You can
also enter the rollover text that appears when you move your pointer over the Image Map.
See “Creating eCatalog Image Maps” on page 142.
See “Embedding rich media in an eCatalog” on page 142.
You can set up and manage the image map text using the Info Panel settings in the eCatalog screen.
See “Managing Info Panel content” on page 145.
4. Setting up eCatalog Viewer Presets
End users see your eCatalog in the eCatalog Viewer. If you are an administrator, you can configure the eCatalog
Viewer. You can change its outline color and select a new “skin” to brand your eCatalog. Scene7 comes with several
“best practice” eCatalog Viewer Presets. You can choose one of these presets for displaying your eCatalogs. You can
also create an eCatalog Viewer Preset of your own if you are an administrator.
To create an eCatalog Viewer Preset, click the Setup button on the Global Navigation bar and choose Viewer Presets.
Then click Add, choose a platform, and choose eCatalog > Viewer.
See “Setting up eCatalog Viewer Presets” on page 147.
5. Previewing eCatalogs in the eCatalog Viewer
eCatalog Viewer Presets determine the style and behavior of your eCatalog Viewers.
To find out how eCatalog Viewer Presets display your eCatalog, select your eCatalog in the Browse Panel and click
Preview. The Preview screen opens in the default viewer.
Notice the orientation, color scheme, what the controls for changing pages look like, and what pages look like when
they are turned.
See “Previewing eCatalogs in the eCatalog Viewer” on page 148.
6. Publishing eCatalogs
Publishing your eCatalog places it on Scene7 Image Servers so that it can be delivered to your web site and application.
As part of the publishing process, the Scene7 Publishing System activates the URL string for your eCatalog. Use this
URL to call the eCatalog from Scene7 Image Servers to your web site or application.
After marking your eCatalog for publish in the Browse Panel, select the Publish button on the Global Navigation bar
to initiate a publish. On the Publish screen, click Start Publish.
See “Publishing eCatalogs” on page 148.
7. Linking an eCatalog to a web page
Scene7 activates the URL callout string necessary for displaying your eCatalog when you publish it to Scene7 Image
Servers. You can copy this URL string from the Preview screen and the Browse Panel (in Detail view) by selecting URLs
in the panel. After you copy the URL string, it is available to your web sites and applications.
Work with your IT team to place the link to the eCatalog in the appropriate place in your web page. When users click
the link, the eCatalog Viewer appears and users can browse your eCatalog.
See “Linking an eCatalog to a web page” on page 149.
Last updated 10/9/2014
138
USING SCENE7
eCatalogs
Uploading the PDF files
Typically, Adobe PDF files are the source for an eCatalog; these files contain all image information as well as fonts and
vector graphics. You can build an eCatalog with images as well. After you have prepared your PDF files for uploading,
select the Upload button on the Global Navigation bar to begin uploading the PDFs.
Preparing your PDF files
Prepare your PDF files before uploading them to the Scene7 Publishing System:
• Place all the files in the same folder on your computer or network to make uploading the files easier.
• Name the files in alphanumeric order by page. Ordering the pages will make it easier to place the pages in the proper
order after the files are uploaded.
• Examine the PDF pages to see whether they contain crop marks, registration targets, or color bars. These marks
determine where to cut the paper when documents are printed; they must be removed before your eCatalog is
placed on the web. Scene7 provides options for cropping marks when you upload PDF files.
• If you want viewers to search your eCatalog by keyword, find out whether your PDF files are “flattened.” You
cannot extract search words from flattened PDF files. To find out whether a PDF is flattened, try to select text inside
it. If you can’t select text, the PDF is flattened and viewers cannot search by keyword in your eCatalog.
• Because they are meant to be printed, PDF files usually contain CMYK images. By default, SPS can intelligently
detect these CMYK images and convert them using an internal CMYK color profile. However, if you want to use a
custom color profile to convert CMYK images, you can do so.
See “ICC profiles” on page 315.
Best practice PDF upload options
For detailed information about the different upload methods, see “Uploading your files” on page 83.
Select the files you want to upload, and then select these best practice PDF Options:
Crop Select the Crop menu and choose Manual if the pages contain crop marks, registration marks, or other marks.
Enter the number of pixels to crop from the top, right, bottom, and left sides of pages. Crop marks are usually set to a
half-inch margin. Assuming that you choose 150 as the pixel-per-inch resolution (the recommended setting), entering
75, 75, 75, 75 in the Top, Right, Bottom, and Left text boxes crops a half inch from the margins (at 150 ppi, half of one
inch equals 75 pixels).
Processing Select the Processing menu and choose Rasterize. The PDF file must be rasterized so that all pages and
images can be displayed in the eCatalog.
Extract Search Words (optional) Select this option if you want your viewers to be able to search by keyword in your
eCatalog.
Auto-Generate eCatalog from multiple page PDF (optional) Select this option to automatically create an eCatalog
when you upload. You can go straight to the eCatalog screen and begin working on your eCatalog without having to
first select PDF files and select the Build command. The eCatalog is named after your PDF file.
Resolution Scene7 recommends 150 pixels per inch.
Colorspace Scene7 recommends choosing Detect Automatically. Usually, PDFs created for print output are in CMYK;
PDFs for online viewing are RGB. If a PDF uses both color spaces, you can select a specific color space by choosing
Force As RGB or Force As CMYK. PDFs use both color spaces, for example, when page graphics use a CMYK color
Last updated 10/9/2014
139
USING SCENE7
eCatalogs
space but pictures use RGB. If you uploaded an ICC profile, its name appears on the Colorspace menu and you can
choose it there.
See “ICC profiles” on page 315.
Color Profile Choose a Color Profile option:
• Convert To SRGB Converts to SRGB (Standard Red Green Blue). SRGB is the recommended color space for
displaying images on web pages.
• Keep Original Color Space Retains the original color space.
• Custom From > To Opens menus so you can choose a Convert From and Convert To color space. You can choose
a standard Photoshop color space or a color space you uploaded to SPS.
See “ICC profiles” on page 315.
Note: For details on all PDF options, see “PDF upload options” on page 308.
Creating an eCatalog
Creating an eCatalog entails ordering the pages, choosing the page layout, and linking the pages by drawing Image
Maps and entering rollover and hypertext link data. Optionally, you can customize the TOC so that viewers see page
names rather than page numbers in the eCatalog Viewer.
Creating an eCatalog
You can include image files as well as PDF files in your eCatalog.
When you create an eCatalog, the Publish after save option affects the set and set members in the following ways:
“Publish after save” option selected
before saving?
State of set after saving
State of set members after saving
Yes
Published
Published
No
Unpublished
Set members retain their published or
unpublished state.
See also “Manually publishing assets” on page 89 and “Manually unpublishing assets” on page 89.
To create an eCatalog
1 Begin creating your eCatalog with one of these techniques:
Select the files first In the Browse Panel, select files and then click Build > eCatalogs.
Start from the eCatalog screen Click Build > eCatalogs. Select a folder in the Asset Library and drag files from the
folder into the Order Pages tab of the eCatalog page.
Note: To view the items in the Asset Library by name instead of thumbnail, select the Name option for Default Asset
Library View in Personal Setup.
2 Select an overall layout for your eCatalog. Click the 1 Up button
for single pages, the 2 Up button
for
double-page spreads, or the Custom button
for page spreads of more than two pages. The Change eCatalog
Layout dialog box appears. Select the All Spreads options and click OK.
Last updated 10/9/2014
140
USING SCENE7
eCatalogs
3 Optionally, change the layout of individual pages or page spreads by clicking them and then choosing the 1 Up
button, 2 Up button, or Custom button. The Change eCatalog Layout dialog box appears. Select the Selected
Spreads options and click OK.
4 Reorder the pages as necessary with one of these techniques:
Dragging Drag a page or page spread to a new location. The vertical bar shows you where the page is being moved.
Move To button Select a page or page spread, click the Move To button, and choose the page on the menu that you
want your page to appear before.
Sequence # In List View, enter page numbers in the Sequence # fields.
5 When you are finished, near the lower-right corner of the page, ensure that Publish after save is selected (default).
6 Click Save.
7 In the Save dialog box, select a folder for storing your eCatalog. In the File Name field, enter the spin set name.
8 Click Save.
You can preview your eCatalog, after you save it, by clicking Preview.
Editing an eCatalog
Depending on whether you edit a published set or an unpublished set, the Publish after save option affects the set and
set members in the following ways:
Set already
published?
“Publish after save”
option selected before
saving your edit?
State of set after saving
State of set members after saving
Yes
Yes
Published
Published
Yes
No
Published
Existing set members retain their
published state.
Any new set members that you added
during your edit retain their published
or unpublished state.
No
Yes
Published
Published
No
No
Unpublished
Existing set members and any new set
members that you added during your
edit retain their published or
unpublished state.
See also “Manually publishing assets” on page 89 and “Manually unpublishing assets” on page 89.
To edit an eCatalog
1 Click the eCatalog’s rollover Edit button.
2 Make your changes as necessary.
3 When you are finished editing, near the lower-right corner of the page, ensure that Publish after save is selected
(default).
4 Click Save, select a storage folder, enter a name for the set, and then click Save.
Last updated 10/9/2014
141
USING SCENE7
eCatalogs
Deleting an eCatalog
When you delete a set, the set itself is moved to the Trash. However, the members (or “children”) within that set are
not affected; instead, they each retain their existing published or unpublished state.
See also “Manually publishing assets” on page 89 and “Manually unpublishing assets” on page 89.
To delete an eCatalog
1
In the Grid View, List View, or Details View, select one or more eCatalogs.
2 On the Global Navigation Bar, click File > Delete > Delete.
Customizing the table of contents (TOC)
Scene7 provides default page numbers in your eCatalog on the Order Pages tab of the eCatalog screen. For custom page
names, you can change the page labels that constitute the table of contents (TOC). Renaming the front and back cover
is recommended. For example, the front cover page can read “Cover” instead of “Page 0–1.”
You can create a customized table of contents (TOC) for your eCatalog manually or by importing the page names from
a CSV (Mac only)or XML file.
Note: To restore default page titles, click the TOC Labels button on the Order Pages tab and choose Restore Defaults (All).
Manually entering page names
To manually enter page names one at a time, go to the Order Pages tab of the eCatalog screen. Then click in the page
number field and enter a name. Enter a name for each page you want to name.
Importing page names
Importing page names is recommended if you are dealing with an eCatalog with many pages. You can import the
names from a tab-delimited or XML file.
The TOC label is stored in an image’s User Data field; format this data as a list of name=<value> pairs separated by
two question marks “??”. For example, to set one label for a TOC field named tocEN, set the User Data of the image to:
tocEN=<EN_page_label>
To set separate labels for TOC fields named tocEN and tocFR:
tocEN=<EN_page_label>??tocFR=<FR_page_label>
To import the User Data field in a tab-delimited file, include the field userdata:
IPSID
Userdata
<image_IPS_ID>
tocEN=<EN_page_label>??tocFR=<FR_page_label>
To import the User Data field in an XML file, include the attribute vc_userdata:
<ips>
<ghw_object vc_objectname="<image_IPS_ID>" … vc_userdata="
tocEN=<EN_page_label>??tocFR=<FR_page_label>" … />
</ips>
To import page names from a tab-delimited or XML file, select the TOC Labels button and choose Import. The Upload
Metadata dialog box appears. Click the Browse button and import the CSV file (Mac only) or XML file that associates
each page with a page name.
Last updated 10/9/2014
142
USING SCENE7
eCatalogs
Creating eCatalog Image Maps
An Image Map is a region on an eCatalog page that you can roll over with your mouse or click to trigger actions of
various kinds. When you move the pointer over an Image Map, you see, for example, a rollover-text description of an
item. When you click an Image Map, another action is initiated. For example, you can open a web page so that viewers
can learn more about an item or purchase it or you can launch a video to see an item in use.
Drawing eCatalog Image Maps
For eCatalogs, you draw Image Maps on the Map Pages tab of the eCatalog screen. This screen consists of the Image
Map area where eCatalog pages are displayed and, on the right, the Image Map list. As you create Image Maps, their
names are entered on the Image Map List.
1 Click the eCatalog’s rollover Edit button.
2 Click Map Pages.
3 On the left of the Map Pages screen, select the page you want.
4 In the Image Map area, draw a rectangular or polygonal (many-sided) Image Map:
Rectangular map Select the Rectangle Image Map tool
and drag on the page to create the rectangle.
Polygonal map Select the Polygon Image Map tool
and click as many times as necessary around the perimeter
of the image. As you click, Scene7 draws the borders of the Image Map.
After you draw an Image Map, Scene7 assigns it a name in the Image Map list. To form the name, Scene7 appends
a sequential number to the name of the eCatalog page in which you are working.
5 (Optional) In the Image Map list panel, under the Name column, enter a new name for the Image Map. Do not
include blank spaces in the name you enter.
6 You can have viewers open a new web page when they click the Image Map. In the Image Map list panel, enter the
URL of the web page in the URL column.
Click Edit and enter a template to make entering URLs (Href templates) easier.
See “Using a template to enter JavaScript and URLs” on page 296.
7 (Optional) In the Show drop-down list, click Rollover Text, and then enter the text that you want users to see
onscreen when they move their pointers over the Image Map.
8 (Optional) In the Show drop-down list, click Other Actions, and enter an attribute to trigger a blur or focus action
when users move their pointers over an Image Map.
See “Defining other actions for Image Maps” on page 297.
9 Click Save.
10 (Optional) Click Preview to view the eCatalog with the default eCatalog Viewer preset.
To delete an Image Map, select its name in the Image Map list and click Delete. To temporarily disable an Image Map
on a page without deleting the Image Map, deselect the Image Map’s On option in the Image Map List panel.
Embedding rich media in an eCatalog
You can use eCatalog’s Rich Media option to add videos in MP4 format or spin sets to Image Maps that you have added
to an eCatalog. When a user clicks the Image Map area in the eCatalog, the associated video or spin set pops up. This
functionality is especially helpful if you want customers to see an item in use or see an item from different angles and
perspectives.
Last updated 10/9/2014
143
USING SCENE7
eCatalogs
You can also optionally display tool tip text when customers move their pointers over your Image Map so they know
what they are clicking.
To embed rich media in an eCatalog
1 Draw an eCatalog Image Map.
See “Drawing eCatalog Image Maps” on page 142.
2 In the Show drop-down list, select Rich Media.
3 In the Add Assets panel on the left, navigate to a folder that contains the spin set or video (MP4 format) asset that
you want to embed.
4 Drag the asset onto the Image Map.
5 (Optional) In the Image Map list panel, under the Tool Tip column header, enter the text that you want viewers to
see onscreen when they move their pointer over the Image Map.
6 Click Save.
7 (Optional) On the eCatalog screen, click Preview to preview the eCatalog with the default
eCatalog_PopupViewers_Flash Viewer preset.
Remember that you can edit the pop-up settings for the default eCatalog_PopupViewers_Flash viewer preset to get
the look and feel you want. In particular, you can choose the Flash AS3 video viewer preset that you want to use for
the pop-up video viewer, and the Flash AS3 spin viewer preset that you want to use for the spin set viewer.
See “Adding and editing Viewer presets” on page 38.
Editing eCatalog Image Maps
Starting on the Map Pages tab of the eCatalog screen, use these techniques to edit eCatalog Image Maps:
Adjusting the position Select the Pan tool
and move the pointer near but not over the border of the map. When the
pointer shows a four-headed arrow, drag the entire image map to a new location.
See “Adjusting the position, shape, and size of Image Maps” on page 295.
Changing the shape and size To resize a rectangular Image Map, select the Pan tool. Then move the pointer over a
borderline or a corner, and when you see the double-headed arrow icon, drag. To resize a polygonal Image Map, drag
a square selection handle. To create a selection handle, click the border of the Image Map and drag.
See “Adjusting the position, shape, and size of Image Maps” on page 295.
Deleting Image Maps Select the Pan tool, click the Image Map to select it, and then click Delete.
To remove all Image Maps from an eCatalog, click the Order Pages tab, and then click Clear Maps.
Handling overlapping Image Maps Drag to change the order of Image Maps on the Image Map list.
See “Handling overlapping Image Maps” on page 295.
Copying Image Maps to other pages Select the Copy Maps To button (make sure you are on the Map Pages tab). On
the Select Images screen, select the page or pages where you want to copy the Image Maps, and click the Select button.
See “Copying Image Maps” on page 296.
Note: As well as copying Image Maps to different pages in an eCatalog, you can copy all the Image Maps in an eCatalog
to a different eCatalog. See “Copying Image Maps between eCatalogs” on page 144.
Last updated 10/9/2014
144
USING SCENE7
eCatalogs
Reviewing and importing Image Map data
The Map Summary screen provides metadata about your eCatalog. You can also batch-import Image Map data for
your eCatalog starting on the Map Summary screen. Importing Image Map data this way makes it easier to enter Image
Map URLs and rollover text.
To see the Map Summary screen, on the Map Pages tab of the eCatalog screen click Summary.
Review Image Map data summary
1 On the Map Pages screen, click Summary.
The Map Summary screen displays how many Image Maps, URLs, rollover text descriptions, and other actions are
in your eCatalog.
2 If there are rollover key errors, click the error in the Rollover_Key Error column to see what needs to change in your
spreadsheet to correct the error. You can select and copy the text from this message and paste it into your
spreadsheet.
3 Click Preview to examine a page in the eCatalog Viewer, click the X to close the Summary screen and return to the
Map Pages screen, or click Close to return to Browse.
Import Image Map data
Rather than enter Image Map data on each page, you can import the data for your entire eCatalog into the Map
Summary screen. You import the Image Map data in the form of a tab-delimited file or XML DTD. The fields in your
file must be in the order shown in the Map Summary screen: Name, TOC Labels, Maps, URLs, Rollover Text, Other
Actions, and Search Strings. Importing Image Map data saves you the trouble of entering the data in the Image Map
List as you create each Image Map.
Note: Before importing Image Map data, you must have already created the Image Maps.
Starting on the Map Summary screen, follow these steps to import Image Map data for Image Maps you have created:
1 Click Import Map Data.
2 In the Import Metadata dialog box, click Browse, and then select the tab-delimited or XML DTD file.
3 In the Job Name field, type a name for the file (be careful to retain its extension).
4 Click Upload.
Copying Image Maps between eCatalogs
You can copy all the Image Maps in an eCatalog to a different eCatalog. Copying Image Maps this way is a convenient
method of copying Image Maps between foreign-language translations of the same eCatalog. For the copying to be
successful, Scene7 recommends copying between eCatalogs with the same number of pages and same images.
Important: If the eCatalog to which you copy Image Maps already contains Image Maps, those Image Maps are deleted
when the copy is made.
Follow these steps to copy all the Image Maps in one eCatalog to another eCatalog:
1 Select the eCatalog with the Image Maps you want to copy, and click the eCatalog’s rollover Edit button.
2 On the Order Pages tab, click Copy Maps.
3 In the Select Asset dialog box, select the eCatalog where you want to copy the Image Maps, and then click Select.
Last updated 10/9/2014
145
USING SCENE7
eCatalogs
Scene7 displays a warning message if the target eCatalog (the eCatalog to which you copy Image Maps) has a different
number of pages or images that are a different size. You can click Continue to copy the Image Maps in spite of the
warning.
Managing Info Panel content
In addition to using Image Map text for your rollovers in eCatalogs, you can use an Info Panel to add larger quantities
of rollover text, including links. You can also manage the InfoPanel by using timed caching and scheduling content
updates.
You can manage your InfoPanel setup and data using the following features in Scene7:
• InfoPanel Setup panel lets you specify the template used to display the Info Panel text, a default response for errors,
and the number of hours the information is cached. In addition, you can specify whether the eCatalogs is
automatically published.
• InfoPanel Datafeed panel lets you specify a CSV file containing the text you want to appear in the InfoPanel rollover
text, as well as schedule times for updating the information.
• Import Metadata dialog box (accessed from the Map Pages view) lets you import a tab-delimited TXT file
containing the rollover text information. You can use this TXT option or the Datafeed panel with the CSV file
option for your rollover text.
• Map Pages view provides an option for previewing the xml that appears for specific image maps.
Set up a Response Template
You can select one of three preset response templates for displaying text in an Info Panel. These preset response
templates determine how your information is presented in the Info Panel: how many columns and rows, typeface size,
font, and so on. You can select a preset response template or create one of your own.
Note: You can also set up the Response Template in the Viewer Preset. To use the Response Template in the Viewer Preset
instead, add “fmt=1” to the end of the Information Server URL in the Viewer Preset.
See “Setting up eCatalog Viewer Presets” on page 147.
1 Double-click your eCatalog to open it in Detail View.
2 Click the InfoPanel Setup panel to open it.
3 Select a Response Template:
• Select a preset from the Response Template menu. The XML for the template design appears in the User
Template box.
• Select Custom to create your own response template. Type the template XML definition in the User Template
box. You can use the preset templates as a base for your own.
4 (Optional) In the Default Response box, type the text you want to appear if Scene7 encounters an error in retrieving
information for an image map. For example, if the system receives a company name and an eCatalog name, but no
rollover identifier, this message appears for the user.
5 In the Response TTL box, enter the number of hours you want to wait before caching the data:
• Set a lower number if the data is updated frequently throughout a day.
•
Set a higher number if the data is relatively stable and doesn’t require updating frequently throughout the day.
The default is ten hours.
Last updated 10/9/2014
146
USING SCENE7
eCatalogs
6 Click Publish.
Import source content for the Info Panel
You can use a comma-separated value file (CSV) or tab-delimited file (TXT) for the source text for an Info Panel for
an eCatalog. Tab-delimited files must use UTF16 (Unicode) encoding. You import the different file types using
different methods.
When formatting source content, keep in mind the following guidelines:
• Make sure that the tab- and comma-delimited data contains as many columns as are necessary for the rollover
template.
• Make sure that the first item or column of data is the rollover identifier (associated with the rollover_key value from
the image map URLs).
• Make sure that each tab- or comma-delimited item after the identifier is the item you want substituted into the
response template (so the first column is substituted into $1$, the second column into $2$, and so on).
Import CSV content from an externally hosted location
1 Double-click the eCatalog to open it in Detail View.
2 Click the InfoPanel Datafeed panel to open it.
3 Enter the URL for the CSV file in the Externally Hosted CSV File Location box. You can paste the URL into this
field or type it directly.
4 (Optional) Specify a time to update the content using the Schedule Update menus and click Add. You can select
multiple times for updating. Each update time appears in the Update Times box. (To remove a time, select it and
click Delete.)
5 (Optional) Click Run Update Now to immediately update the content.
Import a tab-delimited or CSV file
1 Double-click the eCatalog to open it in Detail View.
2 Click the InfoPanel Setup panel to open it.
3 Click Upload S7Info Content button.
4 Click Browse, select the tab-delimited TXT file, CSV or SSV file you want to use, and click Open.
5 Click Upload.
Scene7 sends you an e-mail message letting you know if the upload was successful or not.
Preview rollover key text for an Image Map
Using the Map Pages screen, you can easily and quickly view Info Panel text for the Image Maps on a specific page of
your eCatalog.
1 Click the Catalog’s rollover Edit button.
2 Click Map Pages.
3 At the top of the table on the right side of the screen, choose Info Panel from the Show menu.
The rollover-key text appears next to each Image Map that contains Info Panel text.
Last updated 10/9/2014
147
USING SCENE7
eCatalogs
Setting up eCatalog Viewer Presets
eCatalog Viewer Presets determine the style, behavior, and look of eCatalog Viewers. Scene7 provides eCatalog Viewer
Presets, and you can create your own eCatalog Viewer Presets as well if you are an administrator.
To create a new preset, you can start from scratch or start with a Scene7-provided eCatalog Viewer Preset and save it
under a new name. You can create your own eCatalog Viewer Presets to present printed material in your company
colors and set the tone.
eCatalog Viewer Presets offer many settings for going from page to page, zooming, searching, and choosing “skins.”
What these controls look like and what the Viewer itself looks like depends on your choice of eCatalog Viewer Presets.
Follow these steps to create a eCatalog Viewer Preset (you must be an administrator):
1 Click Setup > Viewer Presets.
2 In the Viewer Presets screen, create an eCatalog Viewer Preset by starting anew or by starting from an existing
eCatalog Viewer Preset:
Creating an eCatalog Viewer Preset Click Add. In the Add Viewer Preset dialog box, choose a platform, choose
eCatalog Viewer, and then click Add.
Editing an eCatalog Viewer Preset Select an eCatalog Viewer Preset and click Edit. Click Save As after you finish
creating the preset.
3 On the Configure Viewer screen, enter a name for your eCatalog Viewer Preset.
4 In the Configure Viewer screen, set the options you want.
Click the Info Tip icon
adjacent to the option to see its description.
The preview screen displays the viewer as you update and change settings.
5 (Optional) In the Info Panel Settings, the Information Server URL option can include the following special tokens,
which the viewer substitutes:
Token
Substituted with
Notes
$1$
rollover_key value
The item identifier from the <area> element of the map.
$2$
frame
The sequence number of the currently shown frame in the image set.
$3$
imageroot
The first path element of the first item specified in the image command (typically
the image catalog ID of the catalog entry specifying the image set).
6 (Optional) In the Info Panel Settings, in the Response Template box, type the text you want to appear if Scene7
encounters an error in retrieving information for an image map. For example, if the system receives a company
name and an eCatalog name, but no rollover identifier, this message appears for the user.
Important: To use this Response Template instead of the template defined in the eCatalog itself, add “fmt=1” to the
end of the Information Server URL. For example: HTTP://.../$3$/$4$/$1$/?FMT=1.
7 Click Save.
8 Click Default if you want the eCatalog Viewer Preset you created to be the one that is used to display eCatalogs on
your web page.
To delete an eCatalog Viewer Preset, select it on the Viewer Presets screen and click Delete.
Last updated 10/9/2014
148
USING SCENE7
eCatalogs
More Help topics
“Viewer Presets” on page 32
Previewing eCatalogs in the eCatalog Viewer
You can use Preview to display your eCatalog using different eCatalog Viewer Presets. You can experiment with the
different controls to turn pages, write sticky notes, and browse.
See “Configuring Default Viewers” on page 47.
See “Previewing an asset” on page 102.
To preview eCatalogs in the eCatalog Viewer
1 In the Asset Library panel on the left side, in the Show drop-down list, select a video-based asset type such as Video
or Video Set.
2 In the Asset Library panel on the left side, navigate the Asset folders that contain videos that you want to preview
with an eCatalog Viewer.
3 Do one of the following:
• Above the Assets window, on the right side of the toolbar, click Grid View. In the Asset window, below the
thumbnail image, click Preview > Viewer List.
• Above the Assets window, on the right side of the toolbar, click List View. In the Asset window, select an asset,
and then to the right of the thumbnail image, click Preview > Viewer List.
• Above the Assets window, on the right side of the toolbar, click Detail View. On the same toolbar, click Preview
> Viewer List.
4 In the Viewer List window, in the table, click a viewer link to preview the asset in the selected viewer.
5 Close the displayed viewer to return to the Viewer List screen.
6 In the lower-right corner of the Viewer List window, click Close to return to the Assets screen.
More Help topics
“Setting up eCatalog Viewer Presets” on page 147
Publishing eCatalogs
Publishing places your eCatalog on Scene7 Image Servers so it can be made available to your web site or application.
As part of the publishing process, the Scene7 Publishing System activates the URL string. You can place this URL string
in your HTML web page code.
Make sure your eCatalog is marked for publish in the Browse Panel or Asset Details page before you publish it. To
mark an eCatalog (or any other asset) for publish, select the Mark for Publish icon .
To publish your eCatalog to Scene7 Image Servers:
1 Click Publish on the Global Navigation bar.
2 On the Publish screen, select a When option (One-Time or Recurring).
3 (Optional) Enter a name for the publish job, but keep the time-and-date stamp.
Last updated 10/9/2014
149
USING SCENE7
eCatalogs
4 If you set up your eCatalog so that viewers can perform keyword searches, make sure that the keyword data is
published. Click Advanced to display the Advanced options, select the Publish menu, and choose Full W/ Search
Data. This option is selected by default.
5 Click Start Publish.
More Help topics
“Publishing files” on page 87
Linking an eCatalog to a web page
Your web sites and applications access Scene7 Image Server content, including eCatalogs, by way of URL strings or
embedded code. These URL strings are activated during the publishing process. To place the URL string or embedded
code for your eCatalog in your web pages and applications, you copy it from the Scene7 Publishing System.
Important: The URL is not active until you publish the asset.
Copying an eCatalog URL
1 In the Asset Browse panel, in the Show drop-down list, click Catalog.
2 in the Asset Library panel on the left side, navigate to the asset folder that contains the eCatalog whose embed code
you want to copy.
3 Above the Asset Browse panel, on the right side of the toolbar, do one of the following:
• Click Grid View. In the Asset Browse panel, double-click a single asset to open it in Detail View. In the URLs
and Embed Code panel on the right, click Copy URL to the right of the viewer you want.
• Click Grid View. In the Asset Browse panel, select a single asset, and then below the thumbnail image, click
Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Copy URL.
• Click List View. In the Asset Browse panel, select a single asset, and then to the right of the thumbnail image,
click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Copy URL.
• Click Grid View, List View, or Detail View. On the same toolbar, click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Copy URL.
Adding eCatalog URLs to your web page
The most common way to deploy an eCatalog is to place a link in the form of an eCatalog thumbnail cover page on
your web page. Work with your IT team to make sure that the eCatalog launches in a clean, centered pop-up window.
Ask your IT team to keep the toolbar and address bar in the browser from showing.
The following is an example of HTML code that launches a sample pop-up window eCatalog Viewer. To use this code,
copy your eCatalog URL into this code and place this code on your web site or application.
Last updated 10/9/2014
150
USING SCENE7
eCatalogs
<html>
<head>
<script language="javascript">
<!-function openECatalog(){ window.open("http://s7d4.scene7.com/s7ondemand/brochure/
flash_brochure.jsp?company=YourCo&sku=june06"};
-->
</script>
</head>
<body>
<a href="javascript:openECatalog();">Click Here to View
Your eCatalog</a>
</body>
</html>
Copying the embed code of an eCatalog viewer
Using the Embed Code feature lets you review the viewer code for the selected eCatalog. You can also copy the code
to the clipboard so you can paste it in your web pages for deployment of the viewer. Editing of the code is not permitted
in the Embed Code dialog box.
To copy the embed code of an eCatalog viewer
1 In the Asset Browse panel, in the Show drop-down list, click Catalog.
2 in the Asset Library panel on the left side, navigate to the asset folder that contains the eCatalog whose embed code
you want to copy.
3 Above the Asset Browse panel, on the right side of the toolbar, do one of the following:
• Click Grid View. In the Asset Browse panel, double-click a single asset to open it in Detail View. In the URLs
panel on the right, click Embed Code.
• Click Grid View. In the Asset Browse panel, select a single asset, and then below the thumbnail image, click
Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Embed Code.
• Click List View. In the Asset Browse panel, select a single asset, and then to the right of the thumbnail image,
click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Embed Code.
• Click Grid View, List View, or Detail View. On the same toolbar, click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Embed Code.
4 In the Embed Code dialog box, click Copy to Clipboard.
Editing the code is not permitted in the Embed Code dialog box.
5 Click Close.
Last updated 10/9/2014
151
Chapter 10: Image Sets
Scene7 Image Sets give users an integrated viewing experience. In the dynamic Image Set Viewer, users can see
different views of an item by clicking a thumbnail image. Image Sets allow you to present alternative high-resolution
views of an item.
The Image Set Viewer offers zooming tools for examining images closely. If you want, you can make guided zoom
targets and Image Maps part of your Image Set. Image Sets make for a more concerted, intimate viewing experience.
Quick Start: Image Sets
This Image Sets Quick Start is designed to get up and running quickly with Image Set techniques in Scene7.
1. Uploading your master images for multiple views and swatches
Start by uploading the images for your Image Sets. Because users can zoom on images in the Image Set Viewer, take
zooming into account when you choose images. Make sure that the images are least 2000 pixels in the largest
dimension. Scene7 supports many image file formats, but lossless TIFF, PNG, and EPS images are recommended.
Select the Upload button on the Global Navigation bar to upload files from your computer to a folder on the Scene7
Publishing System.
See “Preparing Image Set assets for upload” on page 152 and “Uploading your files” on page 83.
2. Creating an Image Set
In Image Sets, users click thumbnail images in the Image Set Viewer to see an image from a different side or angle.
To create an Image Set, click the Build button and choose Image Sets. Then, on the Image Set screen, drag your images
onto the screen to compose your Image Set. Organize, add, and delete images as needed.
See “Creating an Image Set” on page 152.
See also “Including zoom targets and Image Maps in Image Sets” on page 154
3. Setting up Image Set Viewer Presets, as needed
Administrators can create or modify Image Set Viewer Presets. Scene7 comes with default Viewer Presets for each rich
media type. Use the Zoom Viewer: Custom > Images or Image Sets/Multiple Views presets to view your Image Sets.
You add or edit Viewer Presets from the Application Setup screen.
See “Adding and editing Viewer presets” on page 38.
4. Previewing an Image Set
Select the Image Set in the Browse Panel, and then click Preview. Your Image Set appears in the Preview screen. Click
the thumbnail icons to examine your Image Set in the selected Viewer. You can choose different Viewers from the
Presets menu.
See “Previewing an asset” on page 102.
Last updated 10/9/2014
152
USING SCENE7
Image Sets
5. Publishing an Image Set
Publishing an Image Set places it on Scene7 servers and activates the URL string.
Note: This step is not necessary if you selected Publish after save (default) at the time you created and saved the Image Set.
Click the Mark for Publish icon
screen, click Start Publish.
to the left of its name in the Browse Panel. Then, click Publish. On the Publish
See “Publishing files” on page 87.
6. Linking an Image Set to your Website
Scene7 creates URL calls for Image Sets, and activates them after you publish. You can copy these URLs from the
Preview screen.
Select the Image Set, and then click the Preview button. The Preview screen opens. Select an Image Set Viewer Preset
and click the Copy URL button.
See “Linking an Image Set to a web page” on page 157.
Preparing Image Set assets for upload
Before uploading the images you need for Image Sets to the Scene7 Publishing System, make sure that the images are
the right size and format.
To create a multiple-view Image Set, you need images that show an item from different points of view or show different
aspects of the same item. The goal is to highlight the important features of an item so viewers have a complete picture
of what it looks like or does.
Because users can zoom images in Image Sets, make sure that the images are at least 2000 pixels in the largest
dimension. Scene7 supports many image file formats, but lossless TIFF, PNG, and EPS images are recommended.
For detailed instructions on uploading assets, see “Uploading files” on page 79.
More Help topics
“Uploading your files” on page 83
“Working with vignette, window covering, and cabinet files” on page 312
Creating an Image Set
To create a multiple-view Image Set, you need images that show an item from different points of view or show different
aspects of the same item. The goal is to present viewers with images of an item so they get a solid idea of what an item
looks like or does.
Creating an Image Set
When you create a set, the Publish after save option affects the set and set members in the following ways:
Last updated 10/9/2014
153
USING SCENE7
Image Sets
“Publish after save” option selected
before saving?
State of set after saving
State of set members after saving
Yes
Published
Published
No
Unpublished
Set members retain their published or
unpublished state.
See also “Manually publishing assets” on page 89 and “Manually unpublishing assets” on page 89.
To create an Image Set
1 Do one of the following:
Select the images first In the Browse Panel, select the images you want for your Image Set, click Build > Image Sets.
Start from the Image Set screen Click Build > Image Sets. The Image Set screen opens. Select a folder in the Asset
Library and drag the images you want for your Image Set onto the Image Set screen.
2 To change the order of images, drag the images to new locations.
3 Near the lower-right corner of the page, ensure that Publish after save is selected (default).
4 Click Save, select a folder for storing your Image Set, enter a name for the set, and then click Save.
5 To see your Image Set in the Image Set Viewer, click Preview on the Image Set screen. You can click swatch
thumbnails in the Image Set Viewer to see how they behave.
Editing an Image Set
Depending on whether you edit a published or an unpublished set, the Publish after save option affects the set and set
members in the following ways:
Set already
published?
“Publish after save”
option selected before
saving your edit?
State of set after saving
State of set members after saving
Yes
Yes
Published
Published
Yes
No
Published
Existing set members retain their
published state.
Any new set members that you added
during your edit retain their published
or unpublished state.
No
Yes
Published
Published
No
No
Unpublished
Existing set members and any new set
members that you added during your
edit retain their published or
unpublished state.
See also “Manually publishing assets” on page 89 and “Manually unpublishing assets” on page 89.
To edit an Image Set
1 In the Grid view, browse to an ImageSet, and then below the image, click Edit.
2 Do any of the following:
• To add an image (published or unpublished), drag it from a folder in Add Assets onto the Image Set’s Views page.
• To remove an image, select it, and then click Delete on the toolbar.
Last updated 10/9/2014
154
USING SCENE7
Image Sets
• To reorder images, drag an image to a new position.
3 When you are finished editing the set, near the lower-right corner of the page, ensure that Publish after save is
selected (default).
4 Click Save, select a storage folder for your set, enter a name for the set, and then click Save.
Deleting an Image Set
When you delete a set, the set itself is moved to the Trash. However, the members (or “children”) within that set are
not affected; instead, they each retain their existing published or unpublished state.
See also “Manually publishing assets” on page 89 and “Manually unpublishing assets” on page 89.
To delete an Image Set
1
In the Grid View, List View, or Details View, select one or more Image Sets.
2 On the Global Navigation Bar, click File > Delete > Delete.
Including zoom targets and Image Maps in Image Sets
If you define zoom targets and Image Maps for the images in your Image Set, these targets and maps appear in the
Image Set Viewer. Users, for example, can click an Image Map in the Image Set Viewer and open a new page on your
web site with information about an item. Users can click a target thumbnail image in the Image Set Viewer and zoom
automatically to part of an image.
If you want to make zoom targets and Image Maps available to users, create zoom targets and Image Maps for the
images in your Image Set. You can do that with the Image Maps or Zoom Targets tools in the Image Set screen or
Browse Panel (in Detail view).
More Help topics
“Creating zoom targets for Guided Zoom” on page 128
“Creating Image Maps” on page 293
Managing info panel content
In addition to using Image Map text for your rollovers in Image Sets, you can use an info panel to add larger quantities
of rollover text, including links. You can also manage the InfoPanel by using timed caching and scheduling content
updates.
You can manage your InfoPanel setup and data using the following features in Scene7 Publishing System:
• InfoPanel Setup panel lets you specify the template used to display the info panel text, a default response for errors,
and the number of hours the information is cached. In addition, you can specify whether the Image Set is
automatically published.
• InfoPanel Datafeed panel lets you specify a CSV file containing the text you want to appear in the info panel rollover
text, as well as schedule times for updating the information.
• Import Metadata dialog box lets you import a tab-delimited TXT file containing the rollover text information. You
can use this TXT option or the InfoPanel Datafeed panel with the CSV file option for your rollover text.
Last updated 10/9/2014
155
USING SCENE7
Image Sets
Setting up a response template
You can select one of three preset response templates for displaying text in an Info Panel. These preset response
templates determine how your information is presented in the Info Panel: how many columns and rows, typeface size,
font, and so on. You can select a preset response template or create one of your own.
To set up a Response Template
1 Double-click your Image Set to open it in Detail View.
2 Click InfoPanel Setup to unfold the panel.
3 In the Response Template drop-down list, do one of the following:
• Select Default to use the default response. The XML for the template design appears, dimmed, in the User
Template text box.
• Select Custom to create your own response template. In the User Template text box, type the template XML
definition. You can use the default template that is already defined in the text box as a base for your own
response.
4 (Optional) In the Default Response box, type the text that you want to appear if Scene7 encounters an error in
retrieving information for an image map. For example, if the system receives a company name and an Image Set
name, but no rollover identifier, this message appears for the user.
5 In the Response TTL text field, enter the number of hours that you want to wait before caching the data.
Set a lower number if the data is updated frequently throughout the day.
Set a higher number if the data is relatively stable and does not require updating frequently throughout the day.
The default is ten hours.
6 Click Upload to upload info panel content, based on the rollover_key values, to s7info.
7 In the S7Info Upload dialog box, browse to the file that you want to use, and then click Upload.
Supported file formats are TAB delimited files with UTF-16 encoding and CSV files with ASCII encoding. For CSV
files, non-ASCII characters must be HTML encoded.
8 In the InfoPanel Setup panel, click Publish.
Importing source content for the info panel
You can use a CSV (Comma-Separated Value) file with ASCII encoding (non-ASCII character must be HTML
encoded) or a tab-delimited file for the source text for an info panel for an Image Set. Tab-delimited files must use
UTF-16 (Unicode) encoding. You import the different file types using different methods.
When formatting source content, keep in mind the following guidelines:
• The tab- and comma-delimited data should contain as many columns as are necessary for the rollover template.
• The first item or column of data should be the rollover identifier (associated with the rollover_key value from the
image map URLs).
• Make sure that each tab- or comma-delimited item after the identifier is the item that you want substituted into the
response template (so the first column is substituted into $1$, the second column into $2$, and so on).
Importing CSV content from an externally hosted location
1 Double-click the Image Set to open it in Detail View.
2 Click InfoPanel Datafeed to unfold the panel.
Last updated 10/9/2014
156
USING SCENE7
Image Sets
3 In the Externally hosted CSV file location (HTTP) text field, enter the URL to the CSV file.
4 (Optional) In the Schedule Update fields, specify a time to update the content, and then click Add.
You can select multiple times for updating. Each update time appears in the Update Times text box. To remove a
scheduled time, select it, and then click Delete.
5 (Optional) Click Run Update to immediately update the content.
Viewing Image Sets
You can view your Image Sets in the Preview window, using your available presets. You use a Zoom Viewer: Custom
Viewer Preset for Image Sets.
Scene7 comes with default Viewer Presets. Administrators can create or modify the Viewer Presets.
More Help topics
“Viewer Presets” on page 32
Setting up Zoom Viewer presets for Image Sets
You can create and customize Viewer Presets to suit your needs.
1 Click the Setup > Viewer Presets.
2 Create or edit a Viewer preset on the Viewer Presets screen by doing one of the following:
Creating Click Add. In the Add Viewer Preset dialog box, choose a platform, choose Zoom Viewer:Custom, and
click Add. You can also create a Zoom Viewer Preset by starting from an existing one. Display the name of the
preset, select it, and then select the Edit button. On the Configure Viewer screen, enter a new name for the preset.
Editing Display the name of a preset, select it, and then click the Edit button.
3 Choose options in the Configure Viewer screen.
To see a description of an option, click the Info Tip icon
adjacent to the option.
The preview screen displays the viewer as you update and change settings.
4 Click Save (or Save As).
Previewing Image Set Assets in a Viewer
You can use Preview to see how an asset appears on particular viewer type platform such as HTML5. Depending on
the asset type and associated viewer that you have selected to preview, not all platforms are available in Preview.
1 In the Asset Library panel on the left side, in the Show drop-down list, select Image Set.
2 In the Asset Library panel on the left side, navigate the asset folders to select the Image Set that you want to preview.
3 Do any one of the following
• Above the Assets window, on the right side of the toolbar, click List View. In the Asset window, hover on an
asset, and then click Preview.
• Above the Assets window, on the right side of the toolbar, click Grid View. In the Asset window, in an asset
thumbnail window, click Preview.
• Above the Assets window, on the right side of the toolbar, click Detail View. On the same toolbar, click Preview.
Last updated 10/9/2014
157
USING SCENE7
Image Sets
• In the Asset window, select an asset. On the toolbar, click File > Preview.
4 (Optional) In the Preview window, in the drop-down list at the bottom, select the URL encoding that you want
applied to the asset’s URL when it is copied.
5 Click a viewer link to preview the asset in the selected viewer.
When you click a given viewer link, its associated URL is automatically copied to the clipboard.
6 Close the displayed viewer to return to the Preview screen.
7 Click Close to return to the Assets screen.
Automated Image Set generation
You can automate set generation as an independent job that is not dependent of an upload.
To automate Image Set generation
1 Click File > Generate Set.
2 In the Generate Set dialog box, specify a job name.
By default, the job is given a name that indicates it is a generated job and when the job was generated.
3 Select the preset that you want to apply.
4 Click Destination Folder and specify the folder that you want to use.
5 Click Submit.
Linking an Image Set to a web page
After you publish an Image Set, you can copy its URL or its embed code for use in your web site or application. Then
you can deploy the URL or paste the embed code as necessary so users can view the Image Set on your web site or
application.
Important: The URL is not active until you publish the asset.
More Help topics
“Publishing files” on page 87
Copying an Image Set URL
1 In the Asset Browse panel, in the Show drop-down list, click Image Set.
2 in the Asset Library panel on the left side, navigate to the asset folder that contains the Image Set whose embed code
you want to copy.
3 Above the Asset Browse panel, on the right side of the toolbar, do one of the following:
• Click Grid View. In the Asset Browse panel, double-click a single asset to open it in Detail View. In the URLs
and Embed Code panel on the right, click Copy URL to the right of the viewer you want.
• Click Grid View. In the Asset Browse panel, select a single asset, and then below the thumbnail image, click
Preview > Viewer List.
Last updated 10/9/2014
158
USING SCENE7
Image Sets
In the Viewer List page, under the Actions column of the table, click Copy URL.
• Click List View. In the Asset Browse panel, select a single asset, and then to the right of the thumbnail image,
click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Copy URL.
• Click Grid View, List View, or Detail View. On the same toolbar, click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Copy URL.
Adding Image Set URLs to your web page
The most common way to deploy Image Sets is to place a link (via a navigation icon) on your web page. When clicked,
the link launches a dynamic page (ASP or JSP) that displays the Image Set in a pop-up zoom window. The zoom link
opens a pop-up window that contains the actual zoom feature. Here is an example of the code:
<script language="javascript">
<!-function zoom_window() {
window.open("http://sample.scene7.com/s7ondemand/zoom/flasht_zoom.jsp?company=S7Web&sku=swea
ter_1_set","",
"toolbar=no,location=no,directories=no,"+
"status=no,menubar=no,scrollbars=yes"+
"resizable=yes,width=500,height=450,top=0,left=0,right=0,bottom=0")
}
-->
</script>
The following URL call to the Scene7 platform follows the same protocol as all zoom viewers, except the SKU
parameter is now the Image Set name.
http://sample.scene7.com/s7ondemand/zoom/flasht_zoom.jsp?company=S7Web&sku=sweater_1_set
In the above URL, notice a SKU number (sku=sweater_1_set). The string after sku= is the Image Set name
(sweater_1_set). The user clicks the zoom feature link that launches a window.
Copying the embed code of an Image Set viewer
Using the Embed Code feature lets you review the viewer code for the selected Image Set. You can also copy the code
to the clipboard so you can paste it in your web pages for deployment of the viewer. Editing of the code is not permitted
in the Embed Code dialog box.
To copy the embed code of an Image Set viewer
1 In the Asset Browse panel, in the Show drop-down list, click Image Set.
2 in the Asset Library panel on the left side, navigate to the asset folder that contains the Image Set whose embed code
you want to copy.
3 Above the Asset Browse panel, on the right side of the toolbar, do one of the following:
• Click Grid View. In the Asset Browse panel, double-click a single asset to open it in Detail View. In the URLs
panel on the right, click Embed Code.
• Click Grid View. In the Asset Browse panel, select a single asset, and then below the thumbnail image, click
Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Embed Code.
Last updated 10/9/2014
159
USING SCENE7
Image Sets
• Click List View. In the Asset Browse panel, select a single asset, and then to the right of the thumbnail image,
click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Embed Code.
• Click Grid View, List View, or Detail View. On the same toolbar, click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Embed Code.
4 In the Embed Code dialog box, click Copy to Clipboard.
Editing the code is not permitted in the Embed Code dialog box.
5 Click Close.
Last updated 10/9/2014
160
Chapter 11: Swatch Sets
Scene7 Swatch Sets give users an integrated viewing experience. In the dynamic Swatch Set Viewer, users can see an
item rendered in a different color, material, texture, finish, or fabric merely by clicking a thumbnail.
Quick Start: Swatch Sets
This Swatch Sets Quick Start is designed to get up and running quickly with Swatch Set techniques in Scene7.
1. Uploading the images and swatch files
Start by uploading the images and swatch files for your Swatch Sets.
Click Upload on the Global Navigation bar to upload files from your computer to a folder on the Scene7 Publishing
System. See “Preparing Swatch Set assets for upload” on page 161and “Uploading your files” on page 83.
2. Creating a Swatch Set
To create a Swatch Set, click Build > Swatch Sets. On the Swatch Set screen, drag images and color swatches onto the
screen. See “Creating a Swatch Set” on page 161.
3. Setting up Swatch Set Viewer Presets
Administrators can create or modify Image Set Viewer Presets. Scene7 comes with default Viewer Presets for each rich
media type. Use the Zoom Viewer: Custom > Image Sets/Color Swatches presets to view your Swatch Sets.
See “Adding and editing Viewer presets” on page 38.
4. Previewing a Swatch Set
Select the Swatch Set in the Browse Panel, and then click Preview. Your Swatch Set appears in this screen. Click the
thumbnail and swatch icons to examine your Swatch Set in the selected Viewer. You can choose different Viewers from
the Presets menu.
See “Previewing an asset” on page 102.
5. Publishing a Swatch Set
Publishing a Swatch Set places it on Scene7 servers and activates the URL string.
Click the Mark For Publish icon
screen, click Start Publish.
to the left of its name in the Browse Panel. Then, click Publish. On the Publish
See “Publishing files” on page 87.
6. Linking a Swatch Set to a web page
Scene7 creates URL calls for Swatch Sets, and activates them after you publish. You can copy these URLs from the
Preview screen.
Select the Swatch Set, and then select the Preview button. The Preview screen opens. Select a Swatch Set Viewer Preset
and select the Copy URL button. See “Linking a Swatch Set to a web page” on page 164.
Last updated 10/9/2014
161
USING SCENE7
Swatch Sets
Preparing Swatch Set assets for upload
Before uploading the images you need, make sure that the images are the right size and format. Also assemble the
swatch files you need.
To create a Swatch Set, you need vignettes or different shots of the same image showing it in different colors, patterns,
or finishes. You also need swatch files that correspond to the different colors, patterns, or finishes. For example, to
present a Swatch Set showing the same jacket in black, brown, and green, you need:
• A black, brown, and green shot of the same jacket.
• A black, brown, and green color swatch.
Because users can zoom images in Swatch Sets, make sure that the images are at least 2000 pixels in the largest
dimension. Scene7 supports many image file formats, but lossless TIFF, PNG, and EPS images are recommended.
For detailed instructions on uploading assets, see “Uploading files” on page 79.
More Help topics
“Working with vignette, window covering, and cabinet files” on page 312
Creating a Swatch Set
A Swatch Set gives users the opportunity to view an item in a different color, pattern, or finish. To create a Swatch Set
with color swatches, you need one image for each different color, pattern, or finish you want to present to users. You
also need one color, pattern, or finish swatch for each color, pattern, or finish.
For example, suppose you want to present images of caps with different color bills; the bills are red, green, and blue.
In this case, you need three shots of the same cap. You need one shot with a red, one with a green, and one with a blue
bill. You also need a red, green, and blue color swatch. The color swatches serve as the thumbnails that users click in
the Swatch Set Viewer to see the red-billed, green-billed, or blue-billed cap.
Creating a Swatch Set
When you create a set, the Publish after save option affects the set and set members in the following ways:
“Publish after save” option selected
before saving?
State of set after saving
State of set members after saving
Yes
Published
Published
No
Unpublished
Set members retain their published or
unpublished state.
See also “Manually publishing assets” on page 89 and “Manually unpublishing assets” on page 89.
To create a Swatch Set
1 Do one of the following:
Select the images first In the Browse Panel, select the images, and then click Build > Swatch Sets.
Start from the Swatch Set screen Click Build > Swatch Sets. Select a folder in the Asset Library and drag the images
onto the Views section of the Swatch Set page.
Last updated 10/9/2014
162
USING SCENE7
Swatch Sets
2 Drag swatch colors, patterns, or finishes into the Swatches placeholder box on the Swatch Set page.
Make sure that the color, pattern, or finish swatch you drag into each placeholder represents the color, pattern, or
finish of the adjacent image.
3 To change the order of images in your Swatch Set, drag the images to new locations.
4 Near the lower-right corner of the page, ensure that Publish after save is selected (default).
5 Click Save, select a folder for storing your color swatch Swatch Set, enter a name for the set, and click Submit.
6 To see your Swatch Set in the Swatch Set Viewer, click Preview on the Swatch Set screen. You can click swatch
thumbnails in the Swatch Set Viewer to see how they behave.
Editing a Swatch Set
Depending on whether you edit a published or an unpublished set, the Publish after save option affects the set and set
members in the following ways:
Set already
published?
“Publish after save”
option selected before
saving your edit?
State of set after saving
State of set members after saving
Yes
Yes
Published
Published
Yes
No
Published
Existing set members retain their
published state.
Any new set members that you added
during your edit retain their published
or unpublished state.
No
Yes
Published
Published
No
No
Unpublished
Existing set members and any new set
members that you added during your
edit retain their published or
unpublished state.
See also “Manually publishing assets” on page 89 and “Manually unpublishing assets” on page 89.
To edit a Swatch Set
1 In the Grid view, browse to an SwatchSet, and then below the image, click Edit.
2 Do any of the following:
• To add an image (published or unpublished), drag it from a folder in Add Assets onto the Swatch Set’s Views page.
• To remove an image, select it, and then click Delete on the toolbar.
• To reorder images, drag an image to a new position.
3 When you are finished editing the set, near the lower-right corner of the page, ensure that Publish after save is
selected (default).
4 Click Save, select a storage folder, enter a name for the set, and then click Save.
Deleting a Swatch Set
When you delete a set, the set itself is moved to the Trash. However, the members (or “children”) within that set are
not affected; instead, they each retain their existing published or unpublished state.
See also “Manually publishing assets” on page 89 and “Manually unpublishing assets” on page 89.
Last updated 10/9/2014
163
USING SCENE7
Swatch Sets
To delete a Swatch Set
1
In the Grid View, List View, or Details View, select one or more Swatch Sets.
2 On the Global Navigation Bar, click File > Delete > Delete.
Including zoom targets and Image Maps in Swatch Sets
If you define zoom targets and Image Maps for the images in your Swatch Set, these targets and maps appear in the
Swatch Set Viewer. Users, for example, can click an Image Map in the Swatch Set Viewer and open a new page on your
web site with information about an item. Users can click a target thumbnail image in the Swatch Set Viewer and zoom
automatically to part of an image.
If you want to make zoom targets and Image Maps available to users, create zoom targets and Image Maps for the
images in your Swatch Set. You can do that with the Image Maps or Zoom Targets tools in the Swatch Set screen or
Browse Panel (in Detail view).
More Help topics
“Creating zoom targets for Guided Zoom” on page 128
“Creating Image Maps” on page 293
Viewing Swatch Sets
You can view your Swatch Sets in the Preview window, using your available presets. You use a Zoom Viewer: Custom
Viewer Preset for Swatch Sets.
Scene7 comes with default Viewer Presets. Administrators can create or modify the Viewer Presets.
More Help topics
“Viewer Presets” on page 32
Setting up Zoom Viewer presets for Swatch Sets
You can create and customize Viewer Presets to suit your needs.
1 Click Setup > Viewer Presets.
The Viewer Presets window opens.
2 Do one of the following:
• To create a new preset, click Add. In the Add Viewer Preset dialog box, choose a platform, choose Swatch Set
Viewer, and click Add.
• To edit an existing Swatch Set Viewer preset, select the preset and click Edit.
The Configure Viewer screen opens.
3 Type a name in the Preset Name box for the Swatch Set Viewer preset.
4 Choose options in the Configure Viewer screen.
To see a description of an option, click the Info Tip icon
adjacent to the option.
Last updated 10/9/2014
164
USING SCENE7
Swatch Sets
The preview screen displays the viewer as you update and change settings.
5 Click Save.
Previewing Swatch Sets in a Viewer
You can use Preview to see how an asset appears on particular viewer type platform such as HTML5. Depending on
the asset type and associated viewer that you have selected to preview, not all platforms are available in Preview.
1 In the Asset Library panel on the left side, in the Show drop-down list, select an Swatch Set-based asset type such
as Swatch Set.
2 In the Asset Library panel on the left side, navigate the Asset folders that contain Swatch Set that you want to
preview with a viewer.
3 Do any one of the following:
• Above the Assets window, on the right side of the toolbar, click List View. In the Asset window, hover on an
asset, and then click Preview.
• Above the Assets window, on the right side of the toolbar, click Grid View. In the Asset window, in an asset
thumbnail window, click Preview.
• Above the Assets window, on the right side of the toolbar, click Detail View. On the same toolbar, click Preview.
• In the Asset window, select an asset. On the toolbar, click File > Preview.
4 (Optional) In the Preview window, in the drop-down list at the bottom, select the URL encoding that you want
applied to the asset’s URL when it is copied.
5 Click a viewer link to preview the asset in the selected viewer.
When you click a given viewer link, its associated URL is automatically copied to the clipboard.
6 Close the displayed viewer to return to the Preview screen.
7 Click Close to return to the Assets screen.
Linking a Swatch Set to a web page
After you publish a Swatch Set, you can use its URL or embed code in your web site or application. Then you can
deploy the URL or embed code as necessary so users can view the Swatch Set on your web site or application.
Important: The URL is not active until you publish the asset.
More Help topics
“Publishing files” on page 87
Copying a Swatch Set URL
1 In the Asset Browse panel, in the Show drop-down list, click Swatch Set.
2 in the Asset Library panel on the left side, navigate to the asset folder that contains the Swatch Set whose embed
code you want to copy.
Last updated 10/9/2014
165
USING SCENE7
Swatch Sets
3 Above the Asset Browse panel, on the right side of the toolbar, do one of the following:
• Click Grid View. In the Asset Browse panel, double-click a single asset to open it in Detail View. In the URLs
and Embed Code panel on the right, click Copy URL to the right of the viewer you want.
• Click Grid View. In the Asset Browse panel, select a single asset, and then below the thumbnail image, click
Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Copy URL.
• Click List View. In the Asset Browse panel, select a single asset, and then to the right of the thumbnail image,
click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Copy URL.
• Click Grid View, List View, or Detail View. On the same toolbar, click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Copy URL.
Adding Swatch Set URLs to your web page
The most common way to deploy Swatch Sets is to place a link (via a navigation icon) on your web page. When clicked,
the link launches a dynamic page (ASP or JSP) that displays the Swatch Set in a pop-up zoom window. The zoom link
opens a pop-up window that contains the actual zoom feature. Here is an example of the code:
<script language="javascript">
<!-function zoom_window() {
window.open("http://sample.scene7.com/s7ondemand/zoom/flasht_zoom.jsp?company=S7Web&sku=swea
ter_1_set","",
"toolbar=no,location=no,directories=no,"+
"status=no,menubar=no,scrollbars=yes"+
"resizable=yes,width=500,height=450,top=0,left=0,right=0,bottom=0")
}
-->
</script>
The following URL call to the Scene7 platform follows the same protocol as all zoom viewers, except the SKU
parameter is now the Swatch Set name.
Note: This URL is intended to serve as an example of syntax only; it is not a live link.
http://sample.scene7.com/s7ondemand/zoom/flasht_zoom.jsp?company=S7Web&sku=sweater_1_set
In the above URL syntax, notice a SKU number (sku=sweater_1_set). The string after sku= is the Swatch Set name
(sweater_1_set). The user clicks the zoom feature link that launches a window.
Copying the embed code of a Swatch Set viewer
Using the Embed Code feature lets you review the viewer code for the selected Swatch Set. You can also copy the code
to the clipboard so you can paste it in your web pages for deployment of the viewer. Editing of the code is not permitted
in the Embed Code dialog box.
To copy the embed code of a Swatch Set viewer
1 In the Asset Browse panel, in the Show drop-down list, click Swatch Set.
2 in the Asset Library panel on the left side, navigate to the asset folder that contains the Swatch Set whose embed
code you want to copy.
Last updated 10/9/2014
166
USING SCENE7
Swatch Sets
3 Above the Asset Browse panel, on the right side of the toolbar, do one of the following:
• Click Grid View. In the Asset Browse panel, double-click a single asset to open it in Detail View. In the URLs
and Embed Code panel on the right, click Embed Code to the right of the viewer you want.
• Click Grid View. In the Asset Browse panel, select a single asset, and then below the thumbnail image, click
Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Embed Code.
• Click List View. In the Asset Browse panel, select a single asset, and then to the right of the thumbnail image,
click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Embed Code.
• Click Grid View, List View, or Detail View. On the same toolbar, click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Embed Code.
4 In the Embed Code dialog box, click Copy to Clipboard.
Editing the code is not permitted in the Embed Code dialog box.
5 Click Close.
Last updated 10/9/2014
167
Chapter 12: Spin Sets
A Spin Set simulates the real-world act of turning an object to examine it. Spin Sets make it possible to view items from
any angle, gaining the key visual details from any angle. A Spin Set simulates a 360-degree viewing experience. Scene7
offers one-dimensional Spin Sets in which viewers can rotate an item, and two-dimensional Spin Sets in which viewers
can rotate and flip the item. Moreover, users can “free-form” zoom and pan any of the views with a few simple mouseclicks. In this way, users can examine an item more closely from a particular viewpoint.
Images for a spin set.
Spin Sets also accept Image Maps. An Image Map is a region on an image within the Spin Set that displays a rollover
panel with text. When the user clicks an Image Map, an action of some kind is triggered. For example, a web page is
launched so that the user can learn more about a product. To call attention to the use of an image map in a Spin Set,
an outline appears around the Image Map itself when the user moves their mouse pointer over it.
See “Creating Image Maps” on page 293.
Quick Start: Spin Sets
This Spin Sets Quick Start is designed to get up and running quickly with Spin Set techniques in Scene7. Follow steps
1 through 7. At the end of each step is a cross-reference to a topic heading where you can find more information if you
need it.
1. Creating and uploading the images
At minimum, you need 8–12 shots of an item for a one-dimensional Spin Set and 16–24 for a two-dimensional Spin
Set. The shots must be taken at regular intervals to give the impression that the item is rotating and being flipped. For
example, if a one-dimensional Spin Set includes 12 shots, rotate the item 30 degrees (360/12) for each shot.
Select the Upload button on the Global Navigation bar to upload spin images from your computer or network to the
Scene7 Publishing System.
See “Guidelines for shooting Spin Set images” on page 169.
Last updated 10/9/2014
168
USING SCENE7
Spin Sets
2. Creating a Spin Set
To create a Spin Set, click the Build button and choose Spin Sets. In the Spin Set Size dialog box, choose how many
rows and cells you want, and click OK. Then drag images into the grid on the Spin Set screen.
See “Creating a Spin Set” on page 168.
3. Editing a Spin Set
To edit a Spin Set, select its Edit rollover button. The Spin Set screen opens. Add, remove, and change the position of
images. You can change the position of rows in two-dimensional spin sets.
See “Editing a Spin Set” on page 170.
4. Setting up Spin Set Viewer Presets
Administrators can create Spin Set Viewer Presets. These presets determine the look of the Spin Set Viewer. To set up
a new Spin Set Viewer Preset, select the Setup button on the Global Navigation bar. On the Setup screen, display
Application Setup options, and then select Viewer Presets.
On the Viewer Presets screen, select the Add menu and choose Spin Set Viewer in the Add Viewer Preset dialog box.
Then choose options in the Configure Viewer screen.
See “Setting up Spin Set Viewer Presets” on page 171.
5. Previewing a Spin Set
Select your Spin Set in the Browse Panel and click its rollover Preview button. On the Preview screen, hold down the
mouse button and drag the pointer left or right to visually “spin” the item.
See “Previewing a Spin Set” on page 171.
6. Publishing a Spin Set
Publishing a Spin Set places it on Scene7 servers so it can be dynamically delivered to your web site or application. It
also activates the URL string that calls the Spin Set from Scene7 Image servers to your web site or application.
To publish a Spin Set, mark it for publish by selecting the Mark for Publish icon
beside its name in the Browse
Panel. Select the Publish button on the Global Navigation bar to initiate a publish. On the Publish screen, click Start
Publish.
See “Publishing a Spin Set” on page 172.
7. Linking a Spin Set to a web page
Scene7 creates URL callout strings for Spin Sets, and activates them after you publish them. You can copy these URLs
from the Preview screen.
Select the Spin Set, and then select the Preview button. The Preview screen opens. Select a Spin Set Viewer Preset. Then
select the Copy URL button.
See “Linking a Spin Set to a web page” on page 173.
Creating a Spin Set
To create an effective Spin Set, make sure that you shoot the images correctly. You can create a Spin Set in Scene7 by
selecting the Build button and choosing Spin Sets. Edit Spin Sets in the Spin Sets screen.
Last updated 10/9/2014
169
USING SCENE7
Spin Sets
Note: Previous versions of Scene7 did not offer two-dimensional Spin Sets. If you created a Spin Set in a previous version
of Scene7, you cannot save your one-dimensional Spin Set without first saving it under a different name. Click Save As
in the Spin Set screen and enter a new name so that you can edit it in Scene7.
Guidelines for shooting Spin Set images
In general, the more images you have in a Spin Set, the better the image spinning effect is. However, including many
images in the set also increases the amount of time it takes for the images to load. Scene7 recommends these guidelines
for shooting images for use in Spin Sets:
• At minimum, use 8–12 images in a one-dimensional spin set and 16–24 images in a two-dimensional Spin Set.
• Use a lossless format; TIFF and PNG are recommended.
• Mask all images so the item appears on a pure white or other high-contrast background. Optionally, add shadows.
• Make sure that product details are well lighted and in focus.
• Take spin images for fashion clothing with a mannequin or model. Often the mannequin is either completely
masked (using a glass mannequin) or a stylized mannequin/dressform is shown in the image. You can create an onmodel spin set by defining the number of angles. Mark each angle with tape on the floor to guide the model to step
and look in the direction of each shot.
Creating a Spin Set
Be aware that the order in which the Spin Set is authored or created in Scene7 Publishing System is important.
Depending on how you order the assets when you drag and drop images into the grid on the Spin Set page, the Spin
Set spins in a certain direction . Therfore, the order in which it is visually displayed in the builder is how the asset is
spun when a user moves their mouse pointer or moves their finger, left to right.
When you create a set, the Publish after save option affects the set and set members in the following ways:
“Publish after save” option selected
before saving?
State of set after saving
State of set members after saving
Yes
Published
Published
No
Unpublished
Set members retain their published or
unpublished state.
See also “Manually publishing assets” on page 89 and “Manually unpublishing assets” on page 89.
After you save a Spin Set, you can use Preview in the Build: Spin Set page to see what your Spin Set looks like in the
default viewer.
To create a Spin Set
1 On the Build drop-down menu, click Spin Sets.
2 In the Spin Set Size dialog box, set the number of rows and cells that you want.
To make a one-dimensional spin set, select one row only.
To make a two-dimensional Spin Set, select two or more rows.
3 Click OK.
4 Drag and drop images into the grid on the Spin Set screen.
5 When you are finished, near the lower-right corner of the page, ensure that Publish after save is selected (default).
Last updated 10/9/2014
170
USING SCENE7
Spin Sets
6 Click Save.
7 In the Save dialog box, select a folder for storing your spin set. In the File Name field, enter the spin set name.
8 Click Save.
More Help topics
“Editing a Spin Set” on page 170
Editing a Spin Set
Depending on whether you edit a published set or an unpublished set, the Publish after save option affects the set and
set members in the following ways:
Set already
published?
“Publish after save”
option selected before
saving your edit?
State of set after saving
State of set members after saving
Yes
Yes
Published
Published
Yes
No
Published
Existing set members retain their
published state.
Any new set members that you added
during your edit retain their published
or unpublished state.
No
Yes
Published
Published
No
No
Unpublished
Existing set members and any new set
members that you added during your
edit retain their published or
unpublished state.
See also “Manually publishing assets” on page 89 and “Manually unpublishing assets” on page 89.
To edit a Spin Set
1 Click the Spin Set’s rollover Edit button.
2 Do any of the following:
Removing images Select the image, and then click Delete.
Adding images Drag the image into a cell.
Reordering rows (two-dimensional Spin Sets) Click a row-selector box (to the left of the row) and then click Move
Row Down or Move Row Up.
Adding rows and cells Enter a number in the Rows box and Cells box to determine the number of rows and the
number of cells in each row.
3 When you are finished editing, near the lower-right corner of the page, ensure that Publish after save is selected
(default).
4 Click Save, select a storage folder, enter a name for the set, and then click Save.
Deleting a Spin Set
When you delete a set, the set itself is moved to the Trash. However, the members (or “children”) within that set are
not affected; instead, they each retain their existing published or unpublished state.
Last updated 10/9/2014
171
USING SCENE7
Spin Sets
See also “Manually publishing assets” on page 89 and “Manually unpublishing assets” on page 89.
To delete a Spin Set
1
In the Grid View, List View, or Details View, select one or more Spin Sets.
2 On the Global Navigation Bar, click File > Delete > Delete.
Setting up Spin Set Viewer Presets
Spin Set Viewer Presets determine the style, behavior, and look of your viewers. Scene7 comes with default Spin Set
Viewer Presets. If you are an administrator, you can create your own Spin Set Viewer Presets as well. You can configure
a Spin Set Viewer Preset with different colors, borders, fonts, and image settings.
Follow these steps to create a Spin Set Viewer Preset:
1 Click Setup > Viewer Presets.
The Viewer Presets window opens.
2 Do one of the following:
• To create a new preset, click Add, and in the Add Viewer Preset dialog box, choose a platform, and choose Spin
Set Viewer.
• To edit an existing Spin Set Viewer preset, select the preset and click Edit.
The Configure Viewer screen opens.
3 Type a name in the Preset Name box for the Spin Set Viewer preset.
4 Specify other options as desired. To see a description of an option, click the Info Tip icon
adjacent to the option.
The preview screen displays the viewer as you update and change settings.
5
Click Save.
Click Make Default to make the Spin Set Viewer Preset you created the company default for showing Spin Sets.
See “Configuring Default Viewers” on page 47.
To delete a Spin Set Viewer Preset, select it on the Viewer Presets screen and click the Delete button.
More Help topics
“Viewer Presets” on page 32
Previewing a Spin Set
You can use Viewer List to preview how an asset appears on particular viewer type platform such as HTML5.
Depending on the asset type and associated viewer that you have selected to preview, not all platforms are available in
Viewer List.
See “Configuring Default Viewers” on page 47.
See “Previewing an asset” on page 102.
Last updated 10/9/2014
172
USING SCENE7
Spin Sets
To preview a Spin Set
1 In the Asset Library panel on the left side, in the Show drop-down list, select the Spin Set asset type.
2 In the Asset Library panel on the left side, navigate the Asset folders that contain the Spin Set that you want to
preview with a viewer.
3 Do one of the following:
• Above the Assets window, on the right side of the toolbar, click Grid View. In the Asset window, below the
thumbnail image, click Preview > Viewer List.
• Above the Assets window, on the right side of the toolbar, click List View. In the Asset window, select an asset,
and then to the right of the thumbnail image, click Preview > Viewer List.
• Above the Assets window, on the right side of the toolbar, click Detail View. On the same toolbar, click Preview
> Viewer List.
4 In the Viewer List window, in the table, click a viewer link to preview the asset in the selected viewer.
5 Close the displayed viewer to return to the Viewer List screen.
6 In the lower-right corner of the Viewer List window, click Close to return to the Assets screen.
More Help topics
“Editing a Spin Set” on page 170
Publishing a Spin Set
Publishing a Spin Set places the images in the set on Scene7 Image Servers, where they are available to your web site
or application. What’s more, during the publishing process, SPS activates the Spin Set URL strings you need for your
web site or application.
More Help topics
“Publishing files” on page 87
Marking a Spin Set for publish
Mark your Spin Set for publish for it to be copied to Scene7 image servers. You can mark your Spin Set for publish in
to the left of its name. All images in the set are marked for
the Browse Panel by selecting the Mark for Publish icon
publish when you mark the Spin Set itself for publish.
Publishing the Spin Set
To publish a Spin Set to Scene7 Image Servers, start by selecting the Publish button on the Global Navigation bar. Then
select a When option, optionally enter a name for the publish job, and select the Start Publish button.
Last updated 10/9/2014
173
USING SCENE7
Spin Sets
Linking a Spin Set to a web page
Web sites and applications access Scene7 Image Server content, including Spin Sets, by way of URL strings or
embedded code. These URL strings are activated during the publishing process. To place the URL string or embed
code for your Spin Set in your web pages and applications, you copy it from the Scene7 Publishing System.
Important: The URL is not active until you publish the asset.
Copying a Spin Set URL
1 In the Asset Browse panel, in the Show drop-down list, click Spin Set.
2 in the Asset Library panel on the left side, navigate to the asset folder that contains the Spin Set whose embed code
you want to copy.
3 Above the Asset Browse panel, on the right side of the toolbar, do one of the following:
• Click Grid View. In the Asset Browse panel, double-click a single asset to open it in Detail View. In the URLs
and Embed Code panel on the right, click Copy URL to the right of the viewer you want.
• Click Grid View. In the Asset Browse panel, select a single asset, and then below the thumbnail image, click
Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Copy URL.
• Click List View. In the Asset Browse panel, select a single asset, and then to the right of the thumbnail image,
click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Copy URL.
• Click Grid View, List View, or Detail View. On the same toolbar, click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Copy URL.
Adding Spin Set URLs to your web page
Spin Sets are deployed like all zoom viewers, by way of a dynamic page (ASP or JSP) that displays the Spin Set in a zoom
window. The URL call to the Scene7 platform follows the same protocol on the zoom viewer. However, the Viewer
Preset name depends on the Preset that your administrator defined as the default Spin Set Viewer Preset. For example,
the following non-live, URL syntax example includes a Preset name called viewer.jsp and the SKU parameter is now
the Spin Set name:
http://sample.scene7.com/s7ondemand/spin/viewer.jsp?company=S7Web&sku=backpack_spin
In this URL syntax example (the link is not live), notice a SKU number (sku=backpack_spin). The string after sku=
is the Spin Set name (backpack spin).
Copying the embed code of a Spin Set viewer
Using the Embed Code feature lets you review the viewer code for the selected Spin Set. You can also copy the code to
the clipboard so you can paste it in your web pages for deployment of the viewer. Editing of the code is not permitted
in the Embed Code dialog box.
To copy the embed code of a Spin Set viewer
1 In the Asset Browse panel, in the Show drop-down list, click Spin Set.
2 in the Asset Library panel on the left side, navigate to the asset folder that contains the Spin Set whose embed code
you want to copy.
Last updated 10/9/2014
174
USING SCENE7
Spin Sets
3 Above the Asset Browse panel, on the right side of the toolbar, do one of the following:
• Click Grid View. In the Asset Browse panel, double-click a single asset to open it in Detail View. In the URLs
and Embed Code panel on the right, click Embed Code to the right of the viewer you want.
• Click Grid View. In the Asset Browse panel, select a single asset, and then below the thumbnail image, click
Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Embed Code.
• Click List View. In the Asset Browse panel, select a single asset, and then to the right of the thumbnail image,
click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Embed Code.
• Click Grid View, List View, or Detail View. On the same toolbar, click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Embed Code.
4 In the Embed Code dialog box, click Copy to Clipboard.
Editing the code is not permitted in the Embed Code dialog box.
5 Click Close.
Last updated 10/9/2014
175
Chapter 13: Template Basics
Template Basics are dynamically created and addressable layered image files like layered files in image-editing
applications such as Adobe® Photoshop®. Unlike a static file containing layers, such as a PSD file, a template can include
parameters. Through parameters, the different aspects of the image can be addressed and customized.
Note: You can also create templates from layout-based designs by using Template Publishing and files from Adobe
Illustrator and InDesign. See “Template Publishing” on page 188.
A template can contain any number of image layers and text layers. You can convert a static file containing layers, such
as a layered PSD file, into a template, as well as create templates in Scene7. You can create text layers in templates using
fonts that you uploaded into SPS. After you add text to a template, you can format it by changing its justification, fonts,
font size, and color.
Using the Parameters screen, you can convert any aspect of a template to an addressable parameter. In so doing, you
can change which layered image to use or what text value to use in your template. Parameters are passed with the URL
string, allowing you to change any parameter to dynamically customize the reply image generated from the image
server.
Quick Start: Template Basics
This Quick Start is designed to get up and running quickly with Template Basics.
1. Upload the files
Start by uploading the PSD file or image file for your template. Scene7 supports many image file formats in addition
to PSD, but lossless TIFF and PNG images are recommended for templates because they allow for transparency.
If you are using a PSD file to build your template, select the Create Template option on the Upload Job Options dialog
box when you upload the PSD file. Also choose a Layer Naming option to tell Scene7 how to name PSD layers when
they are uploaded to the Scene7 Publishing System.
If you are using image files, you can crop the images and also create a mask from clipping paths in the images as you
upload them.
Select the Upload button on the Global Navigation bar to upload a PSD file or other image files from your computer
to a folder on SPS. See “Uploading template files” on page 176.
2. Create a template
To create a template from a PSD file, select the Create Template option when you upload the file. To create a template
from images, choose Build > Template Basics, enter a width and height measurement for the canvas, select either
Designer or Developer, and drag images onto the Template screen. You can also select the images before choosing
Build > Template Basics. The Template screen offers tools for:
• Adding image layers. To add a layer, drag an image into the Template screen.
• Adding text layers. Select the Text tool
and drag to draw a box for the text layer; then format the text with tools
on the Text screen.
• Changing the size and position of layers.
• Changing the order of layers.
Last updated 10/9/2014
176
USING SCENE7
Template Basics
• Applying shadow and glow effects to image and text layers.
See “Creating a template” on page 177.
3. Create template parameters
The next step is to parameterize the properties on layers to determine which layer properties are included in the URL
string. Parameters allow you to use templates with maximum flexibility. After you make a layer property into a
parameter, you can change it dynamically.
To parameterize a layer, open the template in the Template screen and select the Parameters button next to a layer
name. On the Parameters screen, select the option next to each parameter you want to add. See “Creating template
parameters” on page 184.
4. Publish templates
Publishing your template places it on Scene7 Image Servers so that it can be dynamically delivered to your web site or
application. Publishing also activates the URL to call the template from Scene7 Image Servers to your web site or
application.
Be sure to publish all images associated with your template.
To publish a template, mark it for publish and select the Publish button on the Global Navigation bar. Then select the
Start Publish button. See “Publishing templates” on page 186.
5. Link a template to a web page
Scene7 creates URLs for templates, and activates the URLs when you publish templates to Scene7 Image Servers. You
can copy these URL strings from the Template Preview screen.
Select your template in the Browse Panel and click the Preview button to open the Template Preview screen. Then
choose an Image Preset for delivering your template and select the Copy URL button. After you copy the URL from
the Preview screen, you can use it in your web site or application. See “Linking a template to a web page” on page 186.
Uploading template files
Upload the files you need for your template into the Scene7 Publishing System before you begin building the template.
You can build templates from an Adobe® Photoshop® PSD or an image file. TIFF and PNG images are recommended
because they allow for transparency.
Scene7 recommends using transparent TIFF or PSD images in your templates at the exact size you want to display
them on your web site. When you publish the template, call the image with an Image Preset that is also the same size.
Paying attention to size ensures that your template is not resized (resampled) at a size larger or smaller than the size at
which it was designed.
Templates can be created from Adobe Photoshop PSD files or image files.
For detailed instructions on uploading files, see “Uploading files” on page 79. Keep the following in mind when
uploading template files:
• If you’re uploading a PSD file, you can create a template from it. Scene7 creates a separate image for each layer in
the PSD. In the Upload Job Options dialog box, select Photoshop Options, select the Maintain Layers option, and
select the Create Template option. Then choose an option on the Layer Naming menu for naming the images that
Scene7 creates from layers in the PSD. See “PSD upload options” on page 310.
Last updated 10/9/2014
177
USING SCENE7
Template Basics
• If uploading images, you can create a mask from its clipping path. This option applies to images created with imageediting applications in which a clipping path was created. In the Upload Job Options dialog box, select Image
Editing Options and select the Create Mask From Clipping Path option. See “Image editing options at upload” on
page 305.
More Help topics
“Uploading your files” on page 83
“Working with PSD files” on page 310
Creating a template
To create a template, click Build > Template Basics. Select either Designer or Developer. On this page, you can add
image and text layers. You can also reorder layers, change the size and position of layers, and apply shadow and glow
effects to images and text.
Note: If you edit a template created in an earlier version of Scene7 Publishing System, you may receive the a prompt upon
saving asking “Do you want to add a canvas layer?” Choose No to avoid adding a new base layer. If you accidentally
choose Yes, delete the “&allowCanvasPrompt” and “&layer=0” modifiers in the URL and press Enter or Return.
Creating the initial template
When you create a template set, the Publish after save option affects the set and set members in the following ways:
“Publish after save” option selected
before saving?
State of set after saving
State of set members after saving
Yes
Published
Published
No
Unpublished
Set members retain their published or
unpublished state.
See also “Manually publishing assets” on page 89 and “Manually unpublishing assets” on page 89.
You can create a template from an existing template. Open the template, click Save As, and enter a new name in the
Save As dialog box.
To create the initial Temple Set
1 To create your template use one of the following methods:
Select the PSD or images first In the Browse Panel, select the PSD file or images you want for your template, click
Build > Template Basics.
Start from the Template screen Click Build > Template Basics. Select either Designer or Developer.
2 In the Enter Canvas Size dialog box, enter width and height measurements for your template.
3 Select a folder in the Asset Library and drag the PSD file or images you want for your template onto the Template
screen.
4 When you are finished, near the lower-right corner of the page, ensure that Publish after save is selected (default).
5 Click Save.
6 Select a folder for storing your template, enter a name for the template, and click Submit.
Last updated 10/9/2014
178
USING SCENE7
Template Basics
Scene7 shrinks images if necessary to fit them on the canvas, the area on the Template screen for defining your
template.
More Help topics
“Creating image layers” on page 179
“Creating a text layer” on page 179
Editing a Template Set
Depending on whether you edit a published set or an unpublished template set, the Publish after save option affects
the set and set members in the following ways:
Set already
published?
“Publish after save”
option selected before
saving your edit?
State of set after saving
State of set members after saving
Yes
Yes
Published
Published
Yes
No
Published
Existing set members retain their
published state.
Any new set members that you added
during your edit retain their published
or unpublished state.
No
Yes
Published
Published
No
No
Unpublished
Existing set members and any new set
members that you added during your
edit retain their published or
unpublished state.
See also “Manually publishing assets” on page 89 and “Manually unpublishing assets” on page 89.
To edit a Template Set
1 In the Grid view, browse to an Template Set, and then below the image, click Edit.
2 Make changes to the template as necessary.
3 When you are finished editing, near the lower-right corner of the page, ensure that Publish after save is selected
(default).
4 Click Save, select a storage folder, enter a name for the set, and then click Save.
Deleting a Template
When you delete a Template set, the set itself is moved to the Trash. However, the members (or “children”) within that
set are not affected; instead, they each retain their existing published or unpublished state.
See also “Manually publishing assets” on page 89 and “Manually unpublishing assets” on page 89.
To delete a Template
1
In the Grid View, List View, or Details View, select one or more Templates.
2 On the Global Navigation Bar, click File > Delete > Delete.
Last updated 10/9/2014
179
USING SCENE7
Template Basics
Understanding the Template screen
The Template screen offers tools for manipulating and parameterizing layers.
Use these tools on the Template screen to create templates:
Pan tool Allows you to select layers, move them around the canvas, resize them, or rotate them.
Text tool Creates a text layer. Drag on the canvas to create a text layer, and then enter the text in the layer. See
“Creating a text layer” on page 179.
Preview button Opens the Preview screen and shows the template in a Zoom Viewer. You see what the template looks
like to users on your web site or application.
Parameter Summary button Opens the Parameter Summary screen. You can see the name of each layer in a template,
and on each layer, the names of parameters that have been activated.
Text Editor v4.3 and Text Editor v4.2 You can choose to use the latest and most fully featured text editor, Text Editor
v4.3, or the previous text editor, Text Editor v4.2. When creating new templates, Text Editor v4.3 is selected by default.
When editing older templates, Text Editor v4.2 is selected by default. Text Editor v4.3 does not currently support word
wrap, so when editing older templates that use word wrap, use Text Editor v4.2 to keep the template’s fidelity fully
intact. If your older template does not use word wrap, you can choose Text Editor v4.3 to take advantage of the many
new features it offers such as Increase Margins, Decrease Margins, Set Text In All Caps, and Copy Fit Text.
Note: Text Editor v4.2 will eventually be removed as an option in Scene7, so it is recommended that you use Text Editor
4.3 when possible. The Word Wrap option will be incorporated into a future release of the Text Editor.
Designer and Developer Select the option that best describes your role.
Canvas Defines the total available area, in pixels, for defining your template. The default size is 300 x 300 pixels. Layers
are placed on the canvas.
Layers list Lists the name of layers in the template. To select a layer, select its name in the Layers list. The Layers list
offers tools for adding effects to layers, deleting layers, reordering layers, and parameterizing layers. See “Working with
layers” on page 181.
Layer Properties area Offers tools for changing the background color, opacity, size, and position of a layer, as well as
the background color, opacity, and size of the canvas. You can also adjust shadow and glow effects. See “Working with
layers” on page 181.
Creating image layers
❖ Drag the image from the Asset Library to the canvas.
The ID name of the image appears in the Layers list.
Note: If necessary, Scene7 shrinks images to make them fit in the canvas when you create an image layer.
More Help topics
“Working with layers” on page 181
Creating a text layer
1 Select the Text tool
.
2 Drag to create a text box on the canvas or on an image.
Last updated 10/9/2014
180
USING SCENE7
Template Basics
3 In the Text screen that opens, add text by doing any of the following on the Preview tab:
• Type text in the text box. Choose Copy Fit Text to make the text fit n the text box.
• Paste text from the Clipboard into the text box.
4 Click Apply, and then close the Text screen.
Format text
Follow these steps to format text in a text layer:
1 In the Layers list, double-click the name of the text box with text you want to edit. The Text Editor opens.
2 In the text box, select the text you want to format. You can select all the text, portions of the text, as well as individual
characters.
3 Specify any of these formatting options, and then click Apply.
Font Choose a font on the Font menu. If a font you want does not appear on the menu, you can upload it into the
Scene7 Publishing System. See “Fonts” on page 314.
Font Size Choose a font size from the menu, type a specific size in the box, or click the up or down arrows to
increase or decrease the size by two points.
Color Click to choose a color for text.
Bold, Italic, or Underline Select the text, and then click the icon for the type of formatting you want to apply to the text.
All Caps, Superscript, or Subscript Select the text, and then click the icon for the type of formatting you want to
apply to the text.
Alignment Choose an Alignment button to left-align, center, or right-align text in the text layer.
Tracking
Kerning
Line Spacing
Type or select a numeric value by which to adjust the amount of space between words.
Type or select a numeric value by which to adjust the amount of space between characters.
Type or select a numeric value by which to adjust the amount of space between lines.
Baseline Shift
Type or select a numeric value by which to move a selected character up or down relative to the
baseline of the surrounding text. This option is especially useful when you’re hand-setting fractions or adjusting the
position of inline graphics.
Click Undo to reverse your last action. Click Redo if you change your mind about reversing an action after you click
Undo.
Format paragraphs
1 In the Layers list, double-click the name of the text box with text you want to edit. The Text Editor opens.
2 Select the paragraph you want to format.
3 Specify any of these formatting options, and then click Apply.
Alignment Click to specify the type of alignment: align left, align center, align right, or justify.
End of Paragraph Justification Click to specify the type of justification for the last line in the paragraph: last line
aligns left; last line aligns center; and last line aligns right.
Line Spacing
Type or select a numeric value by which to adjust the amount of space between all the lines in the
paragraph.
Indent All
Click to increase the amount the text is indented.
Last updated 10/9/2014
181
USING SCENE7
Template Basics
Remove Indent
Indent First Line
Click to decrease the amount the text is indented.
Specify the amount by which you want to indent the first line of text.
Space Before Paragraph
Specify the amount of space you want to appear above the first line of text in the
paragraph.
Space After Paragraph
Specify the amount of space you want to appear below the last line of text in the
paragraph.
Vertical Align Select where you want the text to appear vertically within the text box: Top, Middle, Bottom.
Text Direction Select the direction in which you want the text to display: Right-To-Left or Left-To-Right.
Adjust text layer properties
1 In the Template Basics screen, select the text box you want to adjust.
2 In the Layer Properties panel, select any of the following:
Shrink Text (Text Editor v4.2 only) Select to shrink the text to fit within the text box.
Word Wrap (Text Editor v4.2 only) Select a wrap option to specify if or how the text wraps:
• Wrap Wraps the text to fit into a text box that is too small horizontally.
• No Wrap Does not wrap the text when the text box is too small horizontally, and instead, cuts off a portion of
the text.
• NB Wrap (Nonbreaking wrap) Wraps text to fit into a textbox, and does not break words.
Position Specifies the location of the text box on the canvas.
Padding Adds margins or crops the layer rectangle. Specify the number of pixels to add or remove for Left, Top,
Bottom, and Right. Enter positive numbers to add a margin; enter negative numbers to crop.
More Help topics
“Changing the size and position of layers and the canvas” on page 182
View and edit text source code
The information provided in Source tab of the Text Editor is for your reference. Edit the text only if you are familiar
with editing source code.
1 In the Layers list, double-click the name of the text box with text you want to edit. The Text Editor opens.
2 Click the Source tab in the Text Editor to reveal the source code for the text.
3 View or edit the text as desired.
Changes remain intact if you switch back and forth between Preview and Source view.
4 Click Apply to render the edits.
Working with layers
Use the Layers list and Layer Properties area to work with layers. You can reorder layers, change their size and position,
rotate layers, and determine the background color, foreground color, opacity, and blend mode of a layer.
You can also change the size of the canvas, choose its background color, and change its opacity setting.
Last updated 10/9/2014
182
USING SCENE7
Template Basics
Reordering layers
Changing layer order can effect appearance, especially when transparency or overprinting is involved. Be sure to
preview the outcome before committing your changes.
❖ Use one of these techniques to reorder the layers in a template:
• Select a layer in the Layers list. Then click the Up or Down button as many times as necessary to place it in the
correct position in the list.
• Drag a layer up or down in the Layers list.
Changing the size and position of layers and the canvas
Layers must be small enough to fit on the canvas. You can change the size of a layer or the canvas manually or by
entering size measurements. You can change the position of a layer manually or by entering offset measurements. You
can also rotate a layer.
Scene7 recommends creating an Image Preset that is the exact size of your template. Matching the Image Preset size
to the template size ensures that the final output size and sharpening options for the template are set correctly. After
you’ve created this Image Preset, you can choose it from the Apply Preset menu on the Template Preview screen. The
screen shows you what the image looks like when it is delivered from the server. See “Setting up Image Presets” on
page 121.
Changing the size of a layer
To change the size of a layer or the canvas, select the layer or canvas on the Layers list and use one of these techniques:
Manually changing size Select and drag a corner of the layer or canvas. With text layers, you can also drag a side of the
layer. Hold down the Shift key as you drag to change size but maintain the aspect ratio (the shape).
Entering layer size measurements Enter pixel measurements in the W (Width) and H (Height) text boxes in the Layer
Properties area.
Beside changing the size of a layer, you can pad it. To do so, enter a Padding measurement in the Left, Right, Top, and
Bottom box of the Layer Properties area. Padding adds a margin to the current layer to offset it from the perimeter of
its base layer. Padding is useful if you add a drop shadow or outer glow effect and you want to make the effect more
visible. Padding increases the size of a layer and displays its background color in the extended, padded area. The base
layer repositions itself relative to the new size of the layer. For example, if the current layer is centered on the base layer,
extending the left side of the layer moves it further to the right of the base layer.
Changing the position of a layer
To change the position of a layer on the canvas, select its name in the Layers list and use one of these techniques:
Manually changing position Move the pointer near to but not over a layer boundary, and when you see the four-
headed arrow cursor, click and start dragging.
Entering position offset measurements Enter X and Y offset measurements in the X and Y text boxes. These
measurements represent the x, y offset of the anchor point in pixels.
Rotating a layer
The Rotate box lists the angle to which the layer was rotated. To rotate a layer, select its name in the Layers list and use
one of these techniques:
Manually rotating Move the cursor near to but not over a corner of the layer. When you see the rotation cursor, drag
the corner of the layer. Hold down the Shift key as you drag to rotate by 15-degree increments.
Last updated 10/9/2014
183
USING SCENE7
Template Basics
Entering a degree measurement Enter the number of degrees to rotate the layer. Rotation is clockwise; to rotate in a
counterclockwise fashion, enter a negative number.
Hiding a layer or a layer effect
You can hide a layer or layer effect by clicking the eye icon
next to a layer name or effect name. Hidden layers do
not appear in previews or output. The layer information is not deleted from the URL. Instead, “hide=1” is added to the
URL to note that the layer is currently hidden from view. For example:
layer=5&src=is{PortalCo/title}&pos=274,192&effect=-1&.effect=Drop Shadow&blendmode
layer=5&src=is{PortalCo/title}&pos=274,192&hide=1&effect=-1&.effect=Drop Shadow&blendmode
Determining the background color, opacity, and blend mode
To choose a background color, opacity, and blend mode for a layer or the canvas, select the layer or canvas and use
these techniques:
Foreground color Click the Foreground Color button
and choose a color swatch to change the color of the
shadow or glow. You can also enter a color-value parameter in the box. The background color applies only to layers
that use transparency. For example, it applies to a partially transparent layer in a price tag or the background of a text
field. Layers that consist of a PSD, TIFF or PNG image with transparency turned on can have transparent backgrounds.
Background color Click the Background Color button
and choose a color swatch to change the color of the
padded areas.
Opacity Drag the Opacity slider to make any layer translucent so that part of the underlying image shows through.
The 100-percent setting is completely opaque; the 0 setting is transparent.
Blend mode Choose an option to simulate one of the blend modes available in Photoshop. The options are Normal,
Dissolve, Lighten, Darken, Multiply, and Screen. These options are available for layers, not the canvas.
Using shadow and glow effects on layers
You can apply a shadow or glow to a layer. The shadow or glow is applied to the perimeter of the layer and extends
inward or outward, depending on the shadow or glow option you choose. If your template originated with a PSD file
with shadow and glow effects, you can adjust these effects in the Scene7 Publishing System.
After you apply a shadow or glow effect, you can adjust its size, color, opacity, and position in the Layer Properties area
of the Template screen.
Applying a shadow or glow effect to a layer
To apply a shadow or glow effect:
1 Select a layer in the Layers list.
2 Select the Add Effect menu and choose an option:
Drop Shadow Applies a shadow to the bottom and right side of the layer.
Inner Shadow Applies a shadow effect inside all edges of the layer.
Outer Glow Applies a glow effect around all edges of the layer.
Inner Glow Applies a glow effect inside all edges of the layer.
An effect name appears on the Layers list after you apply an effect. To delete an effect, select its name on the Layers list
and then select the Delete button.
Last updated 10/9/2014
184
USING SCENE7
Template Basics
Note: You sometimes can’t see the effect of a drop shadow or outer glow if the underlying layer is not large enough to
display it. If you can’t see the shadow or glow, consider adding Padding values to the layer or reordering the layer. See
“Changing the size and position of layers and the canvas” on page 182and “Reordering layers” on page 182.
Adjusting a shadow or glow effect
To adjust a shadow or glow effect, start by selecting its name in the Layers list. Then change its settings in the Layer
Properties area of the Template screen:
Color Select the Color button
and choose a color swatch to change the color of the shadow or glow. You can also
enter a color-value parameter in the box.
Opacity Drag the slider to determine how intense the effect is. Less opaque effects are more transparent.
Blend Mode Choose an option to simulate one of the blend modes available in Photoshop. The options are Normal,
Dissolve, Lighten, Darken, Multiply, and Screen.
Size Enter measurements in the X and Y box to enlarge or shrink the shadow effect. Size options are only available for
inner shadows and drop shadows.
Grow Drag the slider to extend the effect inward or outward.
Blur Drag the slider to control feathering at the edges of the effect. Effects with more blur are more feathered.
Masking layers
The Layers list offers a Mask button that specifies how the mask or alpha channel of a layer is used. Using the Mask
button, you can apply the effect of a background layer to a particular layer or the entire parent layer in your template.
to cycle through these states:
Select a layer in the Layers list and select the Mask button
• The background of the layer is opaque.
• The layer content is inverted and the background of the layer is filled with solid black.
• The background of the layer is filled with solid black.
Creating template parameters
Parameters enable you to use templates with maximum flexibility; they allow you to dynamically customize a template
image. You can decide which text and image layers to include in the template, and in each layer, which parameters to
display. For example, to call attention to a product that is on sale, you can create an On Sale text layer. Later, you can
remove this layer but still retain the rest of the template image by removing the On Sale parameter.
When you create template parameters, you in effect declare which parts of the template to call in a URL string. A URL
constructed with parameters exposes those items in the URL string. With parameters exposed, you can create custom
results from the way the template image is dynamically constructed from the Image Server. In this way, you can change
a template dynamically because you can call some or all of its parameters in a URL.
In text layer parameters, you can also make the text string a dynamic field linked to values in a database. Being able to
link text to a database is useful, for example, in promotions. You can customize template images to make them show
client or customer names. You can also, for example, link a text layer parameter to a prices database to show the price
of an item in a template image.
Last updated 10/9/2014
185
USING SCENE7
Template Basics
You can refer to a parameter more than once. Use the combo box for each command in the parameter dialog box to
select any parameter that matches that particular command. (For example, all size parameters are available for the
size= command, etc). You can reassign the parameter reference to any parameter already in the combo box, and
rename to something not in the combo box. In the the latter case, the name must be unique. Otherwise, an error states
that the parameter already exists. When you delete a parameter reference, the parameter is removed from the URL if
it is not referenced anywhere else.When you change the default value for a text parameter, all references to that
parameter update. You can see the update in the layer table, in the rendering of the template, and in the URL.When
you change a layer attribute by manipulating resize handles or typing in values in the property panel, the parameter
value is updated and all references to the parameter update. For example, if you have parameterized the size of two
layers using one parameter, both layer sizes update when either of the layer sizes are changed. When you preview a
template and change a parameter, all references to that parameter are updated.
Parameterizing a layer
For each layer in your template, follow these steps to create template parameters:
1 In the Layers list, select the Parameters button
next to the name of the layer you want to create parameters for.
The Parameters screen opens. It lists the names of each parameter on the layer, its value, and its type.
2 Select the On option beside the name of each parameter you want to include in the template image.
3 Select the Close button to close the Parameters screen.
You can rename parameters in the Parameters screen. Renaming a parameter makes the parameter easier to identify
in URL strings and easier to use as a database value. To rename a parameter, select its On option, click its name, and
enter a new name in the Name field.
To see a list of the parameters you have created for your template, select the Parameter Summary button on the
Template screen. The Parameter Summary screen opens. It lists the name of each layer, and if you have created
parameters for a layer, the parameter names and values.
Creating dynamic text parameters
For text layers, you can additionally make the text string a dynamic field linked to a database value. Follow these steps:
1 On the Template screen, select the Parameters button
next to the name of the text layer for which you want to
create dynamic text parameters. The Parameters screen opens.
2 Select the On option next to the name of the text attribute (textAttr).
3 Select the Text tab in the Parameters screen.
4 Click the Add Parameter button. A default parameter name appears. You can replace this name by selecting it and
typing over it. The current text string becomes the new name of the parameter.
5 Select the Close button to close the Parameters screen.
To make the parameter name use a database value, append the following string to the Template URL:
?$_2(parameter name)=(database value)
The parameter name will be replaced by names in a database field or Java code indicating, for example, the current
price of an item or a customer name.
Last updated 10/9/2014
186
USING SCENE7
Template Basics
Publishing templates
Publishing your template places it on Scene7 Image Servers, where it is available to your web site and application.
During the publishing process, the Scene7 Publishing System activates the URLs you need for your web site and
application.
Important: To use your template, publish all content that went into making it, including fonts and images. If you don’t
include all the required files, an error message appears when you publish.
Marking templates for publish
Templates and all their support files must be marked for publish in order for them to be placed on Scene7 Image
Servers. You can mark these items for publish in the Browse Panel by selecting the Mark for Publish icon .
More Help topics
“Publish After Uploading” on page 87
Publishing your template
To publish templates to Scene7 Image Servers, start by selecting the Publish button on the Global Navigation bar. Then
select a When option, optionally enter a name for the publish job, and select the Start Publish button.
More Help topics
“Creating a publish job” on page 88
Linking a template to a web page
Your web sites and applications access Scene7 Image Server content via URL strings. After you publish a template,
Scene7 activates a URL string that references the template on Scene7 Image Servers. You can paste this URL in a web
browser for testing.
To place URL strings in your web pages and applications, copy them from the Scene7 Publishing System. To obtain a
Template URL string generated with an Image Preset, go to the Preview screen or the Browse Panel (in Detail view).
Then select an Image Preset and select the copy URL button.
Important: The URL is not active until you publish the asset.
Obtaining a template URL
You can obtain a template URL string generated by an Image Preset from the Template Preview screen. After you copy
the URL, it lands on the Clipboard so you can paste it as necessary. Follow these steps to obtain a template URL string
generated with an Image Preset from the Template Preview screen:
1 Click the template’s rollover Preview button or choose File > Preview. The Preview screen opens.
2 Using the Preset’s menus, choose the Image Preset with which you want to deliver the template image. The Preview
screen shows you what the template looks like when it is delivered from the server.
3 Click the Copy URL button to copy the URL to the Clipboard.
Last updated 10/9/2014
187
USING SCENE7
Template Basics
Adding template URLs to your web page
To add a template to your web page, consult with your web page development team to modify the <IMG> tag in your
HTML web page code using the Scene7 URL string to make a request to Scene7 Image Servers. The commerce engine
or dynamic web page code inserts the template image at the size and with the formatting specification defined by the
Image Preset you choose for your template.
More Help topics
“Adding dynamic images to your web page” on page 124
Managing content variations
Use template sets to manage the way asset variations are published.
Create a template set to manage variations of a template. You can control which variation is used without changing the
code on your site. This helps content managers rotate content without requiring IT to change a URL in the Web code.
Universal URLs are used to display the the template variation that appears on the page, based on the order they are
listed in the set. The template at the top of the template set list is always published.
You can use any image preset URL from the list. Image preset URLs are like universal URLs. There can be more than
one image preset URL.
1 Click Build > Template Sets.
The builder opens.
2 Select a template, then click Add/Preview.
3 Modify the template properties and click Save As to create a new version.
4 Type a name and click Save.
You must publish both the asset and the template.
5 Go to the Detail page to get a copy URL from the URLs section.
You can move a template in the template order (for example, to the top of the list) by dragging it to its new location.
Publish again to submit the new order.
Note: You might need to clear the cache to see the changes. The change only appears on the website after the change has
made its way through the cache cycle.
Last updated 10/9/2014
188
Chapter 14: Template Publishing
Adobe® Scene7® Web-to-Print lets you create professionally branded print content that is easy for your customers,
clients, and staff to customize and personalize. You can maintain corporate content and brand identity throughout the
publishing process. End users can customize the print content — but only the part of the content that you allow them
to customize. Personalized stationary, business cards, posters, greeting cards, labels, checks, gifts, clothing, calendars,
scrapbooks, and photo albums are examples of customized print products that you can deliver. Corporations can
maintain a common brand identity in their signage that can be customized for different regions, franchises, stores, and
branch offices.
You start by designing a template in Adobe Illustrator®. The template carefully defines what is constant and what is
variable — the variable components being the ones that can be customized. For example, after text in an Illustrator file
is parameterized, end users can enter text of their own. Similarly, a background color, after it is parameterized as a
variable component, can be swapped for a different background color.
Scene7 offers two Template Publishing workflows, one for basic use cases and one for advanced use cases. Basic use
cases entail creating a design in Adobe Illustrator, uploading it to Scene7, and defining variable elements with
parameters in SPS. Advanced use cases require a more comprehensive definition of variability. Advanced use cases
entail creating variable elements in Adobe Illustrator, uploading the file to Scene7, and directly manipulating those
elements on a XML-level with URL calls. This scenario is called DOM manipulation.
Note: For more information about Scene7 web-to-print workflows, template creation, parameterization, DOM
manipulation, and more, see the Web-to-Print Workflow Guide here: www.adobe.com/go/learn_s7_webtoprint_en.
Download the Zip file to your local hard drive and extract its contents (the Scene7 Web-To-PrintWorkflow Tutorial
document and tutorial assets).
Quick Start: Template Publishing
This Quick Start describes the basic workflow for using Illustrator files to create high-quality, customizable print
products.
1. Design your Illustrator file for Template Publishing
In Illustrator, design your template. If you want to use the advanced, DOM manipulation method to customize your
template, define s7:elementIDs for variable elements in Illustrator.
See “Create the initial template in Illustrator” on page 189 and “DOM manipulation” on page 196.
2. Convert your template to Scene7 FXG and upload it to Scene7 Publishing System
Adobe Creative Cloud users can use the Adobe Illustrator Plug-in for Web-to-Print. This plug-in converts templates
to Scene7 FXG. If a template contains fonts, corresponding font files must be uploaded to the Scene7 Publishing
System before uploading the FXG file.
See “Upload files for Template Publishing” on page 189.
Last updated 10/9/2014
189
USING SCENE7
Template Publishing
3. View, define, or refine parameters in Scene7
In the Template Publishing Preview and Build screens, you can define and refine variable elements via parameters,
preview the results, and test the results. In these screens, you can:
• Create and modify parameters.
• Specify default values for parameter properties and attributes.
• Click Copy URL to copy the preview URL to the Clipboard and preview the result in a browser window.
See “Parameterizing a template in Scene7” on page 190.
4. Publish the FXG template
After you finish defining and testing parameters and attributes, publish the file. Publishing your FXG template places
it on the Scene7 Image Servers and activates the URL.
Be sure to publish all images and fonts associated with your FXG template.
See “Publish FXG templates” on page 197.
5. Obtain the URL
Via its URL, the template is now ready to be embedded in your web site for end users to personalize variable content.
See “Linking an FXG template to a web page” on page 198.
Create the initial template in Illustrator
Begin by creating the initial artwork and template in Illustrator. Make sure that your Illustrator template meets these
specifications so that it can be successfully parameterized:
• Carefully determine which template components you want to be variable.
• Make sure that layers are in the correct order so that no object is unintentionally obscured.
• Remove unnecessary layers. Removing these layers prevents them from being used mistakenly as parameters.
• Upload all fonts for your template to the Scene7 Publishing System. Do so before you upload your template (and
make sure that the upload job is complete before you upload the template). Scene7 needs these fonts to render text
correctly in the template.
• Set the resolution to 300ppi if you intend to print the final document at high quality.
Upload files for Template Publishing
To create files for Scene7 Template Publishing, convert your Illustrator file to the Scene7 FXG file format and upload
the file to SPS.
More Help topics
“Uploading your files” on page 83
Last updated 10/9/2014
190
USING SCENE7
Template Publishing
Preparing the file for upload
Do the following before you manually upload the Scene7 FXG file to the Scene7 Publishing System:
• Upload fonts separately before you upload the FXG file.
• Upload related images found in the assets folder created by the FXG plug-in.
Defining variability: Parameterization versus DOM
manipulation
Scene7 offers two techniques for managing variable content in a template. With both techniques, you design the initial
template in Illustrator, convert the template to the Scene7 FXG file format, and upload it to SPS. However, the
techniques differ in the degree of control you have over variable elements and the skill required to use them:
Parameterizing in the Scene7 Publishing System This technique entails defining variability in the Template
Publishing Build and Preview screens in SPS, or in the Adobe Illustrator Plug-in for Web-to-Print. Either method
provides the tools for you to create parameters, assign parameter values, and test the results.
Using DOM manipulation This technique lets you take control over the design and the template on an XML level.
Scene7 FXG files are XML. With this approach, you can edit your design template directly by way of its XML DOM
(display object model). In Illustrator you mark variable elements with s7:elementIDs to later manipulate them with
URL commands.
More Help topics
“Parameterizing a template in Scene7” on page 190
“DOM manipulation” on page 196
Parameterizing a template in Scene7
After you upload an Illustrator template that you saved as Scene7 FXG to the Scene7 Publishing System, you can define
its variable elements. Do so by parameterizing variable elements in the Template Publishing Build and Preview
screens. Scene7 offers tools for defining text and object parameters on layers and their respective properties. You can
also create different versions of a template.
Parameterizing an FXG template allows you to customize the variability of text, images, and graphics in the template.
For example, you can parameterize a line of text so that end users can modify the text through a web user interface.
You can define empty text fields as variable so that end users can fill these fields with personalized text. You can also
parameterize the attributes and properties of design elements in the S7 Template Publishing Build screen.
Note: Parameterizing the template in Scene7 is not required if you plan to use DOM manipulation.
More Help topics
“Create the initial template in Illustrator” on page 189
“Upload files for Template Publishing” on page 189
Last updated 10/9/2014
191
USING SCENE7
Template Publishing
Defining parameters in FXG templates
Follow these steps in Scene7 to define parameters for an FXG template:
1 In the Browse window, select the FXG file.
2 Click Build and choose Template Publishing, or click the file’s Edit button.
The Template Publishing screen opens.
A
B
C
D
Parameterizing a template in the Template Publishing screen.
A. Click eye icon to show or hide layer B. Select layer to display its properties C. Assign name to attribute to make it variable D. Specify
default value for attribute
3 In the Layers panel in the Template Publishing screen, select the layer with the elements that you want to
parameterize.
Click the eye icon on and off to make sure that you select the object you want.
4 In the Properties panel, click a parameter in the Name column (to parameterize text) or Parameter column (to
parameterize objects).
Text Click in the text field (scroll to the bottom of the Properties list to find it). The Parameters dialog box appears.
Select the text that you want to parameterize and click Add. You can create multiple parameters from the same text
Last updated 10/9/2014
192
USING SCENE7
Template Publishing
property by selecting different portions of the text and adding parameters for each portion. To change the name of
the parameter, click it, enter a new name, and click Close.
Objects Click a box in the Parameter column. The Edit Parameter dialog box appears. Enter a name and click OK.
To customize multiple attributes at once with the same value, use the same parameter name for each attribute. For
example, if your template has a rectangle and a star, you can type newcolor as the Parameter name for the
SolidColor color attribute of each. Whenever you change the newcolor value, both the rectangle and the star change
to the new color.
5 Specify a default value for the attribute in the Value or Data field. Set all properties for the selected object to specify
the exact appearance you want.
6 (Optional) Repeat steps 3- 5 for all objects or layers that you want to parameterize.
7 Click Save or Save As.
8 Click Preview to open the FXG Preview window and see the parameters you created with their default values.
Show or hide an object or layer in the FXG template
Hidden objects and layers are not visible in preview or output, but are not deleted from the file. You can make them
visible again as desired. Visibility is an attribute that you can make variable. Clicking the eye icon on or off sets the
default value for the visibility of an object or layer.
1 In the Objects panel, click the eye icon next to an object or layer name to hide it in the file.
2 Click again to make the object visible.
Create different versions of a template
You can edit attributes to create different versions of the template for different uses.
In the Template Publishing screen, click Save As to save the file as a new FXG template without overwriting the original
FXG template.
Using stroked text
Stroked text is an example of how you can parameterize attributes. Scene7 supports these stroked text features:
• Width of stroke
• Dashed stroke pattern
• Different join styles
• Different cap end styles
• Overprinting of stroke
• Separate color handling for stroke, including spot color support
This table describes the attributes that support stroked text.
Attribute
Description
s7:fill <Boolean> (S7FXG Only)
Specifies whether fill is enabled for text. Default is true.
s7:stroke <Boolean> (S7FXG Only)
Specifies whether stroke is enabled for text. Default is false.
s7:weight <number> (S7FXG Only)
Specifies the weight of the stroke for text in points. Default is 1 point.
Last updated 10/9/2014
193
USING SCENE7
Template Publishing
Attribute
Description
s7:joints <string> (miter, round, bevel) (S7FXG Only)
Specifies the type of join of the stroke. Default is round.
s7:caps <string> (none, round, square) (S7FXG Only)
Specifies the type of cap of the stroke. Default is round.
s7:miterLimit <number> (S7FXG Only)
Specifies the limit of the miter when join is miter join for the stroke.
Default is 4.
s7:strokeOverprint <Boolean> (S7FXG Only)
Specifies whether the overprint is enabled for stroke. Default is false.
s7:strokeColorName (S7FXG Only)
Same as s7:colorName, except it defines the name of the color for
the stroke.
s7:strokeColorValue (S7FXG Only)
Same as s7:colorValue, except it defines the value of the color
being used for the stroke.
s7:strokeColorspace (S7FXG Only)
Same as s7:colorspace, except it defines the colorspace of the
stroke.
flm:dashPattern <array> (S7FXG Only)
By default there are no patterns for the dashes and gaps. This attribute
defines the dash/gap pattern of the stroke. The first value is the dash
of the stroke. The second is the gap in between the dashes. You can
extend the array for multiple values in the same manner with alternate
values being specified as dash and gap.
Using warped text
Warped text enables you to modify the appearance of text with effects like wave, flag, stretch, and so on.
Warped text is supported for RichText objects. Text can be vertical or horizontal, and can be point text, area text, and
type-on-a-path text. The entire text object must be selected before warped text can be applied.
Warped text can be created in Adobe Illustrator.
When warping text, you can set the following attributes:
• Style
• Direction
• Bend
• Horizontal distortion
• Verticle distortion
Each attribute contains a set of values.
Attribute
Values
Default
Styles7:warpStyle
nonearcarcLowerarcUpperarchbulg
eshellLowershellUpperflagwavefi
shrisefishEyeinflatesqueezetwis
t
none
Directions7:warpDirection
horizontalvertical
horizontal
Last updated 10/9/2014
194
USING SCENE7
Template Publishing
Attribute
Values
Default
Bends7:warpBend
-1 to 1
0.5
Horizontal
Distortions7:warpHorizontalDi
-1 to 1
0
-1 to 1
0
stortion
Verticle
Distortions7:warpVerticalDist
ortion
Note: For inflate and fishEye, changing the s7:warpDirection flag between horizontal and vertical does not have
any effect on the output.
For more information about creating and using warped text, see the Adobe Illustrator documentation.
Preview and update template attributes
The FXG Template Preview screen displays all the parameters you customized for the template. All values reflect the
default attributes. You can change the values for any of the parameters listed, as well as preview and publish the altered
file.
1 If the template is not already open in the FXG Template screen, open the FXG template in Detail view and click Edit.
2 In the Template Publishing screen, click Preview (located at the top of the window).
The template displays using the default parameters.
Last updated 10/9/2014
195
USING SCENE7
Template Publishing
Default parameters in the FXG Template Preview screen.
Note: Click the Up or Down Arrow buttons to go to different pages of a multi-page template.
3 To change the value for a parameter, type a new value in the Value box or select a new value from the menu. To
swap out a graphic, enter the URL for the new graphic.
The file preview dynamically updates to show the new values.
Last updated 10/9/2014
196
USING SCENE7
Template Publishing
New values are dynamically reflected.
4 To view the template using a different preset size, choose the size from the Presets menu.
5 To create a file for previewing, choose PDF or SWF from the Format menu, and then click Apply Format.
6 To copy the URL for the template, click Copy URL.
7 To return to the Template Publishing screen and save your changes, click Edit, or close the FXG Template Preview
screen.
Note: The URL is available for you to copy, but is not active until the template has been published. The URL
automatically includes the selected variable data and preset setting.
DOM manipulation
DOM (document object model) manipulation is a technique for editing a design file by directly manipulating its XML
code. DOM manipulation gives you more control over variable design elements, including changing their content and
appearance; you can even create new elements on an as-needed basis.
Scene7 lets you manipulate the DOM of a Scene7 FXG template by way of URL commands after the template is
published. Design elements in the FXG template are manipulated by passing commands through the URL. In this way,
you can dynamically manipulate and add attributes to graphics.
Last updated 10/9/2014
197
USING SCENE7
Template Publishing
To use DOM manipulation, you create s7:elementIDs in your Illustrator file before converting it to a Scene7 FXG file
and uploading it to SPS.
Important: When using DOM manipulation commands, all values passed in must be URL-encoded.
Note: Illustrator Plug-in for Web-to-Print (for converting Illustrator files) converts to FXG 2.0. For information about
this specification, see www.adobe.com/go/learn_s7_fxg2_en.
More Help topics
“Defining variability: Parameterization versus DOM manipulation” on page 190
Creating s7:elementIDs in Illustrator files
To use DOM manipulation with a design created in Illustrator, create s7:elementIDs in your Illustrator design.
Creating s7:elementIDs enables design elements to be modified with URL commands after the template is published.
Creating s7:elementIDs for DOM manipulation of text
To create an s7:elementID for DOM manipulation of a text object, open the Layers panel in Illustrator. Then, on the
text layer that holds variable text, name the layer with a s7:elementID. To do so, enter the letters id (for identification),
a colon (:), and a name. Following are examples of s7:elementID text layer names:
id:BirthdayBoyName
id:DateofBirth
id:EnterFirstNameHer
Creating s7:elementIDs for DOM manipulation of objects
Create s7:elementIDs for objects when you want end users to be able to change the attributes of objects. Objects can
constitute entire text frames, graphics, and images. A color background is an example of an object element ID. As the
seasons change, the end user can swap out the background color of a poster to make the poster appropriate to the
season.
Before you create an s7:element ID for an object in Illustrator, create a separate layer for the object.
Follow these steps to create an s7:elementID for an object in Illustrator:
1 Select the object.
2 Choose Windows > Layers. The Layers panel opens.
3 Name the object layer with an s7:elementID. To do so, enter the letters id (for identification), a colon (:), and
description to identify the element. Following are examples of s7:elementID object layer names:
id:BackgroundColor
id:RotationPercentage
id:JacketJPG
Publish FXG templates
Publishing your FXG template places it on the Scene7 servers, where it is available to your web site and application.
During the publishing process, the Scene7 Publishing System activates the URLs you need for your web site or
application.
Last updated 10/9/2014
198
USING SCENE7
Template Publishing
Note: To use your FXG template, publish all content that went into making it, including fonts and images. If you don’t
include all required files, an error message appears when you publish.
More Help topics
“Publishing files” on page 87
Mark FXG templates for publish
Templates and all their support files must be marked for publish for them to be placed on Scene7 Image Servers.
1 In the Browse Panel, select the FXG template along with any graphics, images, and fonts used.
2 Click the Mark For Publish icon
.
Publish your FXG template
1 Click the Publish button on the Global Navigation bar.
2 Select a When option, and optionally enter a name for the publish job.
3 Click the Start Publish button.
Text overflow indicator display
A text overflow indicator shows when text exceeds the space allocated for it in a text frame (or in the last text frame in
the case of threaded text). The indicator is a red box with a plus sign in it. Text overflow indicators on SPS are always
enabled.
Text overflow indicators are controlled with the markOverflowingTextFrame modifier. Use the modifier as follows:
Modifier/Values
Description
markOverflowingTextFrame=0,1
The 1 value makes text flow indicators appear. Default is 0. (Although
the default is 0, text overflow indicators in SPS are always enabled.)
Note that the markOverflowingTextFrame modifier is casesensitive.
Linking an FXG template to a web page
After you publish an FXG template, Scene7 activates a URL string that references the FXG template on Scene7 servers.
You can paste this URL in a web browser for testing.
To place URL strings in your web pages and applications, copy them from the Scene7 Publishing System. To obtain an
FXG template URL string generated with an Image Preset for viewing the template at a specific size, go to the FXG
Template Preview screen or the Browse Panel (in Detail view). Then select an Image Preset and click the copy URL
button.
Important: The URL is not active until you publish the asset.
Follow these steps to obtain an FXG template URL string generated with an Image Preset from the FXG Template
Preview screen:
1 Select the FXG template in the Browse Panel.
2 Click the Preview button or choose File > Preview. The FXG Template Preview screen opens.
3 Select the Copy URL button to copy the URL to the Clipboard.
Last updated 10/9/2014
199
USING SCENE7
Template Publishing
Creating a PDF document
The final step in the Web-to-Print process is generating the customized PDF. After end-users personalize the template
using the web application you created, they create a final PDF document. This final PDF is generally sent to a print
service provider for professional-grade printing. To make sure that the final PDF prints as expected, developers use
the correct joboptions file and set up fonts, printer marks, and colors correctly.
Setting up PDF Presets
Specify the PDF compatibility level and printer settings by creating and uploading a PDF joboptions file to the Scene7
Server. For example, you can choose to select PDF/X-4 compliant PDF output (recommended for PDF print
publishing workflows). You can create the joboptions file in your authoring software (such as Adobe Illustrator), or in
Acrobat. Always check with your printer, who can advise you on the appropriate job option settings for your print job.
For more information on creating joboptions files, and for information on creating a joboptions file in Acrobat, see
Adobe Acrobat Help.
To create a joboptions file in Illustrator:
1 Choose Edit > Adobe PDF Presets.
2 In the dialog box, select the preset you want to use.
The following Job Option Settings are supported by Scene7:
General
Images
Fonts
•
Compatibility
•
Object Level Compression
•
Embed thumbnails
•
Optimize for fast web view
•
Downsample
•
Resolution
•
Threshold
•
Compression for color, gray, and mono
•
Embed all fonts (fonts are embedded by
default)
•
Embed OpenType fonts
•
Subset embedded fonts when percent of
characters used is less than:
•
Always Embed List
•
Never Embed List
Last updated 10/9/2014
200
USING SCENE7
Template Publishing
Color
RGB
Gray
•
Color Strategy (Tag only images is
treated as tag everything)
•
Document Rendering Intent
•
Only the following working spaces are
supported for 4.2.5. 4.3 will allow you to
use any customer provide profile that
has been uploaded to IPS.
•
As a workaround you can specify the
destination color space for the artwork to
be converted to using the default color
profiles for the company.
•
e-sRGB
•
scRGB with encoding range [-4.0, 4.0]
•
Lab D50
•
PCS XYZ
•
Flat XYZ
•
Linear ROMM-RGB
•
ROMM-RGB
•
sYCC 8-bit
•
e-sYCC 8-bit
•
Gray Gamma 1.8
•
Gray Gamma 2.2
•
Dot Gain 10%
•
Dot Gain 15%
•
Dot Gain 20%
•
Dot Gain 25%
•
Dot Gain 30%
•
sGray
Preserve
CMYK
values for
calibrated
CMYK color
spaces
Advanced
Preserve OPI comments is always turned on
Standards
Compliance Standard
Note: Scene7 ignores printer mark settings in the joboptions file. Rather, printer marks are configured through the use
of Scene7 URL commands.
3 Click Export, then specify a name and location and click Save.
4 Upload the job options file as an asset to the Scene7 Publishing System.
Last updated 10/9/2014
201
USING SCENE7
Template Publishing
Use it with your published template by referring to it in the URL. For example:
http://yourpublishserver.scene7.com/is/agm/SiliconPublishing/PetNews?&fmt=pdf,cmyk&jobopti
on=SPSfilenameid
Preparing the PDF for print
Before finalizing the PDF for print, make sure you follow the guidelines in this section.
Images
Make sure that all images in your publish job have been uploaded to your Scene7 Server and published.
Fonts
Make sure that all fonts in your publish job have been uploaded to your Scene7 Server and published. Be certain that
you have legal rights to host the fonts if you plan to allow end-users to change them.
Image resolution (pixels per inch)
The resolution of bitmap images is preserved by the Scene7 server in generated print-ready PDFs. Scene7 upscales
image resolution if necessary. For optimal results, leave the resolution at the default value (typically 72 dpi) when
previewing on web. The default resolution for all the images in your company is set in the Publish Settings/Image
Server window in the Default Print Resolution section. Higher resolutions (such as 300dpi) can result in longer
processing time and should only be applied to a print-ready PDF. Use the imageRes= command in the URL to
manually override the default resolution for PDF jobs.
Color Management
Your document and images can use grayscale, CMYK, named spot colors, RGB, or Lab color models. Each can be
either uncalibrated or calibrated by employing an ICC color profile. For best results, embed the profile in the generated
print-ready PDF. The Scene7 Server does this by default. Make sure that all required color profiles have been uploaded
to the Scene7 platform. Preferably, make sure that the color management options set in your design application, match
those set in your Scene7 Server:
Design application color management settings: In the Color Settings of your authoring application (such as Adobe
Illustrator), specify the RGB and CMYK color profiles in the Working Spaces section.
Scene7 color management settings: Typically, the color management settings in the design application should match
the default color profiles in your Scene7 server. You can find these settings in the Publish Setup/Image Server window.
Displaying printer marks
You might create a PDF for either of these cases:
• A finished document
• An intermediate document, such as a film or plate, which may be sent to a printer for production
An intermediate document might contain additional production content, such as bleed margins, printer marks, and
so on. This content is usually shown outside the boundaries of the finished page.
All marks available from the "Add Printer Marks" screen in Acrobat are supported. The printer marks are controlled
with the printerMark parameter. The syntax is &printerMark=trim marks, bleed marks, registration
marks, color bars, page information, style, line weight, layer embed.
• trim marks = 0|1
Last updated 10/9/2014
202
USING SCENE7
Template Publishing
• bleed marks = 0|1
• registration marks = 0|1
• color bars = 0|1
• page information = 0|1
• style = Illustrator | IllustratorJ | QuarkXPress
• line weight = 0.125 | 0.25 | 0.50
• layer embed = 0|1
When preparing a document for print production, printer marks may be needed to help the print service align
separation films for producing proofs, measure film for correct calibration and ink density, trim film to size, and so
on. Printer marks indicate the boundaries of document boxes such as trim boxes and bleed boxes. Production-related
content may include:
Media box The boundaries of the physical medium on which the page will be printed. Content outside the media box
can safely be discarded without affecting the meaning of the file.
Bleed box The region to which the contents of the page are clipped when output in a production environment. The
bleed box may include areas needed to accommodate the physical limitations of cutting, folding, and trimming
equipment. The default value is the page's crop box.
Trim box The intended dimensions of the finished page after trimming. The trim box may be smaller than the media
box to allow for production-related content, such as printing instructions, cut marks, and color bars. The default value
is the page's crop box.
Art box The extent of the page's meaningful content (including potential white space) as intended by the page's
creator. The default value is the page's crop box.
You can use the modifiers shown in this table to replicate the printer marks available in Adobe Illustrator, InDesign,
and Acrobat:
Modifier/Values
Description
bleedMargin=top,left,bottom,right
Specified in Acrobat with the Set Page Boxes option. Select BleedBox,
then specify the margins with the Margin Controls option.
Values represent the distance of the top, left, bottom, and right edges
from the original edges of the artwork (the media box) going inwards.
Values (0–1000) are in points.
New height=original height - (top+bottom)
New width= original width - (left+right)
mediaMargin=top,left,bottom,right
Specified in Acrobat with the Set Page Boxes option. Modify Custom
Page Size under the Change Page Size option.
Values represent the distance of the top, left, bottom, and right edges
from the original edges of the artwork (the media box) going
outwards. Values (0–1000) are in points.
New height=top+bottom+original height
New width=top+bottom+original width
The new height and new width values determine the new page size of
the generated PDF.
Once a new Media Box is defined, all calculations of trim margin and
bleed margin need to consider the new Media Box as the edge of the
artwork.
Last updated 10/9/2014
203
USING SCENE7
Template Publishing
Modifier/Values
Description
trimMargin=top,left,bottom,right
Specified in Acrobat with the Set Page Boxes option. Select Trim Box,
then specify the margins with the Margin Controls option.
Values represent the distance of the top, left, bottom, and right edges
from the original edges of the artwork (the media box) going inwards.
Values (0–1000) are in points.
New height=original height - (top+bottom)
New width=original width - (left+right)
printerMark= trim marks, bleed marks, registration marks, color
bars, page information, style, line weight, layer embed
Values are as follows:
trim marks = 0,1 (default is 0)
bleed marks = 0,1 (default is 0)
registration marks = 0,1 (default is 0)
color bars = 0,1 (default is 0)
page information = 0,1 (default is 0)
style = Default, InDesignJ1, InDesignJ2, Illustrator,
illustratorJ, QuarkXPress (default is Default)
line weight= 0.125–0.2, both values inclusive (default is 0.25)
layer embed = 0, 1, with 1 creating a new layer containing all printer
marks (default is 1)
Depending on what style is used, the marks and color bars appear
different and match with the corresponding styles used by Acrobat.
Note the following about printer marks:
• Specify bleed margins, trim margins, and media margins through URL calls when specifying printer marks.
Specifying printer marks without specifying these margins causes these marks to appear outside the visible region
of the generated PDF. Also, the trim marks and bleed marks overlap.
• Specifying the same margin values for the trim margin and bleed margin results in trim marks and bleed marks
overlapping when both these flags are set to 1 in &printerMark.
• Specifying fmt=swf/image formats through URL calls results in output without any printer marks or margins
because this feature is specific to PDF output.
• Specifying &printerMark= through the URL results in default values being used for all parameters. Specifying
&printerMark=1 results in trim marks being set to 1 and default values for other parameters. But to set the nth
element to ON, all the (n-1) parameters need to be specified through URL.
• Specifying only one value for &trimMargin, &bleedMargin, and &mediaMargin results in that value being applied
to all the top, bottom, left, and right margins of the original artwork.
• Specifying only the top and left values through &trimMargin, &bleedMargin, and &mediaMargin results in the top
value being assigned to the bottom value and the left value being equal to the right.
• Not specifying the right value through &trimMargin, &bleedMargin, and &mediaMargin results in the left value
being assigned to the right.
• For a multi-page PDF, printer marks/margins are applied to all the pages (in Acrobat, users can select page ranges
for printer marks/margins).
• The output of a PDF with printer marks/margins enabled matches exactly with Acrobat X unless otherwise
specified.
Last updated 10/9/2014
204
USING SCENE7
Template Publishing
If you want to create a PDF/X-4 compliant PDF file through the &joboption modifier in the URL, you should be aware
of the limitations related to printer marks specified in the PDF ISO_15930-7-2008.pdf:
• Each Page object of a PDF file includes a MediaBox. Each Page object in a PDF/X-4 conforming file shall include a
TrimBox or an ArtBox, but not both. The MediaBox may be included by inheritance.
• If the BleedBox is present, the ArtBox or the TrimBox shall not extend beyond the boundaries of the BleedBox. If
the CropBox is present, none of the ArtBox, the TrimBox, or the BleedBox shall extend beyond the boundaries of
the CropBox.
• None of the ArtBox, the TrimBox, the CropBox, or the BleedBox shall extend beyond the boundaries of the
MediaBox.
• Some industry practices require the use of the BleedBox. Appropriate trade practices should be followed.
• The use of the TrimBox is recommended over the use of the ArtBox.
• All annotations other than TrapNet and PrinterMark annotations shall have a value for Rect lying completely
outside the BleedBox (or the TrimBox or the ArtBox if no BleedBox is present). All PrinterMark annotations shall
have a value for Rect lying completely outside the TrimBox or ArtBox. A PDF/X-4 conforming reader may
completely ignore annotations except for PDF TrapNet annotations.
• A Rect shall be regarded as completely outside a bounding box if all of the coordinates of the Rect lie either outside
the bounding box or on its edge, and the intersection of the two rectangles is zero.
• If the ViewerPreferences dictionary contains the ViewArea, ViewClip, PrintArea or PrintClip keys, each of these
keys present shall have the value MediaBox or (if a BleedBox is present in all page objects of the file) BleedBox.
Last updated 10/9/2014
205
Chapter 15: Video
Adobe® Scene7 eVideo is an end-to-end solution that makes it easy to publish high-quality Adaptive Video for
streaming across multiple screens, including desktop, iOS, Android, Blackberry, and Windows mobile devices. An
Adaptive Video Set groups versions of the same video that are encoded at different bit rates and formats such as 400
kbps, 800 kbps, and 1000 kbps. The desktop computer or mobile device detects the available bandwidth.
For example, on an iOS mobile device, it detects a bandwidth such as 3G, 4G, or Wi-Fi. Then, it automatically selects
the right encoded video from among the various video bit rates within the Adaptive Video Set. The video is streamed
to desktops, mobile devices, or tablets.
In addition, video quality is dynamically switched automatically if network conditions change on the desktop or on
the mobile device. Also, if a customer enters full-screen mode on a desktop, the Adaptive Video Set responds by using
a better resolution, thereby improving the customer’s viewing experience. Using Adaptive Video Sets provides you
with the best possible playback for customers playing Scene7 video on multiple screens and devices.
The logic that a video player uses to determine which encoded video to play or to select during playback is based on
the following algorithm:
1 Playback is started using the video in the Adaptive Video Set with the bit rate that is closest to the target set for
“Initial Desktop Bitrate” in the video player.
2 Eliminate encoded videos with a height that is greater than 150% of the player height.
3 Eliminate encoded videos with a bit rate that is greater than 70% of the detected download speed.
4 From the remaining encoded videos, select the rendition with the highest bit rate.
5 The video player then checks bandwidth speed every four seconds during playback and adjusts as necessary.
For managing single video and Adaptive Video Sets, Scene7 supports the following:
• Uploading video from numerous supported video formats and audio formats and encoding video to MP4 H.264
format for playback across multiple screens. You can use predefined Scene7 adaptive video presets, single video
encoding presets, or customize your own encoding to control the quality and size of the video.
When an adaptive video set is generated, it includes MP4 videos and F4V videos.
Note: Master/source videos, OGG videos, and any other source format video are not added to an Adaptive Video Set.
• Video captioning in the Univeral_HTML5_Video, Universal_HTML5_MixedMedia_dark, and
Universal_HTML5_MixedMedia_light viewers, or Video_Caption (Flash AS3) viewer, and video chapter
navigation in the Univeral_HTML5_Video, Universal_HTML5_MixedMedia_dark, and
Universal_HTML5_MixedMedia_light viewers.
See “Adding captions to video” on page 229.
See “Adding chapter markers to video” on page 231.
• Organize, browse, and search video with full metadata support for efficient management of video assets.
• Deliver Adaptive Video Sets to the web as well as to desktops, and mobile devices, including the iPhone, iPad,
Android™, Blackberry, and Windows phone.
Adaptive video streaming is supported on a variety of iOS platforms.
See the latest support in the Scene7 Viewers Reference Guide.
Last updated 10/9/2014
206
USING SCENE7
Video
Scene7 supports mobile video playback for MP4 H.264 video. You can find Blackberry devices that support this
video format at the following website:
See Supported video formats on Blackberry.
You can find Windows devices that support this video format at the following:
See Supported video formats on Windows Phone.
• Play back the video using Scene7 Viewer Presets, including the following:
• Single video viewers.
• Mixed Media viewers that combine both video and image content.
• Configure video players to meet your branding needs.
• Integrate video to your website, mobile site, or mobile application with a simple URL or embed code.
See “Quick Start: Video” on page 209.
Working with HTML5 video
While HTML5 is a common standard for delivering mobile video experiences, you will want to consider some of the
following limitations of HTML5 as a platform for delivering your desktop video experiences:
• HTML5 provides only a suboptimal desktop video experience.
There is no video streaming standard across web browsers for HTML5. Therefore, you can only deliver your videos
to customers by way of a progressive download experience. Such an experience means longer load times and longer
seeking in the video. And, a temporary copy of the video is stored on the user’s desktop.
Furthermore, adaptive video streaming is not available. With adaptive video streaming, the video player detects a
user’s network connection and serves the right video quality, dynamically. In other words, a lower quality video is
served for a slow bandwidth and a higher-quality video is served for faster connections. Without this dynamic
streaming, every user experiences a “one-size-fits-all” video playback experience, regardless of their bandwidth.
• More videos for you to encode and manage.
There is no video format and codec that all browsers support. To compensate, you must encode to at least two, and
up to four, different video formats (such as MP4, OGG Theora, and WebM). This encoding is necessary just to get
the same video to play back across Firefox, Chrome, Internet Explorer, Safari, and other web browsers.
•
Limited ability to customize the video player.
Each HTML5 browser has its own default appearance for video player controls. As a result, it is difficult to create a
consistent video viewer experience for users because video player customization is limited.
• Limited reach to users.
Not all desktop browsers are HTML5-compatible. For example, Internet Explorer versions 7 and 8 do not support
HTML5 video tags. This limitation means that you cannot get full reach across desktop users.
The supported system requirements for HTML5 video codecs include the following:
Last updated 10/9/2014
207
USING SCENE7
Video
OGG
MP4
•
Firefox 3.5 or higher (desktop)
•
Internet Explorer 9 or higher (desktop and mobile)
•
Chrome 3.0 or higher (desktop)
•
Android 3.0 or higher (tablet)
•
Android 2.3 or higher (mobile)
•
iOS 3.1 or higher (mobile)
•
Chrome 29 (latest version; Chrome updates
automatically to the latest version)
•
Safari 5.1 (Mac OS only)
See “Uploading and encoding videos” on page 211.
While these limitations are significant, there are two alternatives that you can use, one being a best practice for
delivering your rich media content:
• Use the HTML5 Video viewers in Scene7 Publishing System.
As a best practice, use the Universal_HTML5_Video viewer to solve many of the issues described above regarding
HTML5 video playback. The video viewer is a single player that lets you take advantage of the following two things
at the same time.
1 Design the player’s functionality using HTML5 and CSS.
2 Play back the video using either adaptive streaming or progressive streaming download to reach the majority of
desktop and mobile users - even on browsers that do not support HTML5. The player can dynamically use Flash
or HTML5 playback based on the browser that is used and plug-in compatibility.
See “Best practice: Using the HTML5 Video viewer” on page 207.
See Dynamic video playback.
See also About HTML5 Viewers in the Adobe Scene7 Viewers Reference Guide.
• Use the Universal URL feature.
Use Scene7 Publishing System to set up a universal video profile using the Flash video viewer on desktop and native
device player on mobile and tablet devices.
Note: One of the advantages of using the HTML5 Video viewer–which is a best practice–is that, unlike using the Universal
URL feature, it does not open the video in another window, thereby taking your customers away from your website.
Instead, it keeps the entire playback experience on the same web page. Using the HTML5 Video viewer also means that
you can play the video embedded on a mobile web page and customize the video player for a consistent, branded
experience on both desktop computers and on mobile devices.
See “Using the Universal URL” on page 233.
Best practice: Using the HTML5 Video viewer
The Scene7 HTML5 Video viewer presets are robust video players. You can use them to avoid many common issues
that are associated with HTML5 video playback and issues associated with mobile devices such as lack of adaptive
streaming delivery and limited desktop browser reach.
On the design side of the player, you can design all of the video player’s functionality using standard web development
tools. For example, you can design the buttons, controls, and custom poster image background using HTML5 and CSS
to help you reach your customers with a customized appearance.
Last updated 10/9/2014
208
USING SCENE7
Video
On the playback side of the viewer, it automatically detects the browser’s video capability. It then serves the video using
Flash or Apple streaming (adaptive video streaming). Or, if those delivery methods are not present then HTML5
progressive is used instead.
By combining into a single player the ability to design the playback components using HTML5 and CSS, have
embedded playback, and use adaptive and progressive streaming depending on the browser’s capability, you extend
the reach of your rich media content to both desktop and mobile users and ensure a streamlined video experience.
See also About HTML5 Viewers in the Adobe Scene7 Viewers Reference Guide.
How the HTML5 video viewer works on desktop computers
For desktop adaptive video streaming, the videos used for bit rate switching are based first on all F4V videos in the
Adaptive Video Set. If none exist, then it is based on all MP4 videos in the Adaptive Video Set.
The following table describes the workflow that the HTML5 Video viewer uses to determine how videos are played on
desktop computers.
Question
Answer
Does the desktop browser have Flash player
installed?
The HTML5 Video viewer plays the video with Flash-based HTTP
adaptive streaming that automatically adjusts playback based on
network bandwidth capacity, and also lets the customer seek.
Yes - see description on right.
No - continue to next question below.
Is the desktop browser Apple Safari?
Yes - see description on right.
No - continue to next question below.
Is the desktop browser HTML5 compatible, and
the video uses H.264 codec?
Yes - see description on right.
The HTML5 Video viewer plays the video in Safari using Apple’s iOS
standard for HTTP adaptive video streaming that automatically
adjusts playback based on network bandwidth capacity, and also
lets the customer seek.
The HTML5 Video viewer plays the video using the HTML5
<video> tag. This tag allows the video to be progressively
downloaded and play natively on the desktop without any plugins.
No - continue to next question below.
Flash player is unavailable in either Firefox or
Internet Explorer 8 or earlier?
Unable to play the video.
How the HTML5 video viewer works on mobile devices
For mobile adaptive video streaming, the videos used for bit rate switching are based first on all MP4 videos in the
Adaptive Video Set.
The following table describes the workflow that the HTML5 Video viewer uses to determine how to play videos on
mobile devices.
Last updated 10/9/2014
209
USING SCENE7
Video
Question
Answer
Is the mobile device an iOS-based smartphone or The HTML5 Video viewer plays the video using Apple’s iOS
tablet?
standard for HTTP adaptive video streaming that automatically
adjusts playback based on network bandwidth capacity, and also
Yes - see answer on right.
lets the customer seek.
No - continue to next question below.
Is it a supported Android, Blackberry, or Windows The HTML5 Video viewer plays the video using HTML5
mobile device?
progressive video download.
Yes - see description on right.
No - continue to next question below.
Is it an unsupported device?
Unable to play the video.
Quick Start: Video
The following step-by-step workflow description is designed to help you get up and running quickly with adaptive
video sets in Scene7. After each step is a cross-reference to a topic heading where you can find more information.
1. Uploading and encoding videos
Upload and generate adaptive video sets using one of the following two scenarios:
• Upload pre-encoded videos - If your videos were already encoded outside Scene7, click Upload on the Global
Navigation bar to browse and upload MP4 or F4V video files directly to Scene7 Publishing System. Then, click
Build > Adaptive Video Sets. Browse to your video files. Drag-and-drop the video files you want into the Adaptive
Video Set table, and then save the set.
• Upload master source videos - If your videos are not encoded, click Upload on the Global Navigation bar to
upload master video source files (non-MP4, non-FLV, and non-F4V files) and have Scene7 Publishing System
encode them to MP4 files for you. In the Upload Job Options dialog box, under EVideo Options, select Adaptive
Video Encoding (16:9 or 4:3).
This preferred option lets you create an Adaptive Video Set that automatically applies the correct encoding preset
to the video, whether it is 16:9 or 4:3, to match the dimensions of the video you uploaded. When you submit your
upload job, an Adaptive Video Set is automatically created for you which includes five video encodes in the correct
aspect ratio.
Or, in the same Job Options dialog box, under EVideo Options, expand Single Encoding Presets and select
individual video encoding presets that you want from Desktop, Mobile (iPhone, iPad, Android), and Tablet
(iPad, Android) so that you create the MP4 files.
• Or, you can reprocess a master video using the Reprocess feature. The newly encoded videos are added to the
existing Adaptive Video Set.
See “Uploading and encoding videos” on page 211.
See also
“Best practices for video encoding” on page 215
Optional
Scene7 offers numerous predefined video encoding presets. These predefined presets reflect the most common video
encoding settings used today and are optimized for playback on target screens.
Last updated 10/9/2014
210
USING SCENE7
Video
However, if further customization is needed, administrators can create Video Presets to customize the size and
playback experience of Videos to end users. Administrators can add and manage Video Presets from the Video Presets
page available under Setup > Application Setup > Video Presets > Single Encoding Presets. The Video Presets page
offers options for adding, editing, deleting, and activating Video Presets.
See “Working with video encoding presets” on page 219.
2. Previewing videos in a video viewer
To see how a video plays for end users on a desktop, your website, or on a mobile device, select the video in the Browse
Panel, and then click Preview.
See “Previewing videos in a video viewer” on page 222.
You can play the video on the Preview screen. You can also choose different Video Viewers to find out what your video
looks like in different players. As a best practice, use the HTML5 video player for multi-screen playback on desktop,
tablet, and mobile devices.
Optional
Viewer Preset customization - Scene7 offers predefined Viewer Presets for delivering video. These presets determine
the look of the Viewer and how its playback controls work. To customize the video viewer, Administrators can add
and manage Viewer Presets from the Viewer Presets page. To open this page, in the upper-right corner of the Scene7
Publishing System, click Setup > Viewer Presets. The Viewer Presets page offers commands for adding, editing,
deleting, and activating Viewer Presets.
See “Working with video viewer presets” on page 223.
3. Deploying videos to your websites and mobile sites
To integrate video into your website, you can do either one of the following:
• Display the video in its own pop-up or modal window, in which case you should use the Copy URL feature.
To obtain the URL for a video, in the Grid View or List View, select it in the Browse Panel. Click Preview, and then
click Copy URL to the right of Universal_HTML5_Viewer.
When you click Copy URL, the URL is copied to the Clipboard. Place this code in the HTML of your website,
mobile site, or application.
Note: URLs are activated only after you publish the video or Adaptive Video Set.
• Display the video embedded on the web page, in which case you should use the Embed Code feature.
To obtain the embed code for a video, in the Grid View or List View, select the video in the Browse Panel. Click
Preview > Viewer List. Under the Actions column of the table, click Embed Code to the right of
Universal_HTML5_Video. Editing the code is not permitted.
Click Close and paste the embed code in your web pages.
Note: Embed code is only activated after you publish the video or Adaptive Video Set.
See “Deploying video to your websites and mobile sites” on page 224.
Last updated 10/9/2014
211
USING SCENE7
Video
Uploading and encoding videos
To create single video or adaptive video sets for delivery to the web or mobile devices, you first upload your master
video files to the Scene7 Publishing System. Scene7 encodes videos to MP4 format and it publishes video in the
following file formats:
MP4 Scene7 recommends MP4 as the preferred video file format. Use MP4 files for the following:
• HTTP Dynamic Streaming on desktops.
• HTTP Live Streaming (Apple’s streaming protocol).
• Progressive video delivery to Android, Blackberry, and Windows mobile devices
OGG Theora Use OGV files for progressive video delivery to non-Flash enabled desktops and mobile devices.
Flash FLV and F4V files Use FLV and F4V files for progressive or streaming video delivery to Adobe Flash Players on
the desktop.
Scene7 offers two workflows for uploading video files:
Pre-encoded Videos You upload FLV, F4V, and MP4 files directly to Scene7. With this workflow, files are not encoded
at the time you upload them. The files are pre-encoded in preparation for delivery to the desktop and to mobile devices.
Master source videos Upload master source video files and, at upload, encode these files to MP4 files. Encoded videos
are labeled “Video” in the Browse panel. Scene7 supports the encoding of video files in many formats.
• Make sure the master source video files you want to encode are supported.
See “Supported video file types for encoding” on page 214.
• Choose a video encoding preset.
See “Video presets for encoding video files” on page 26.
See “Best practices for video encoding” on page 215.
Scene7 also generates video thumbnails. You can learn more about video thumbnails, how to obtain their URLs, and
modifying poster frames.
See “Working with video thumbnails” on page 228.
To upload and encode videos
❖ Do one of the following:
Last updated 10/9/2014
212
USING SCENE7
Video
Last updated 10/9/2014
213
USING SCENE7
Video
If your videos are already encoded
1 On the Global Navigation bar, click Upload.
2 In the Upload screen, click From Desktop tab.
3 On the Upload page, in the Select Files for Upload panel, click
Browse, navigate to an MP4 or F4V video file, and then click
Open.
4 In the Choose Folder Destination panel, select a folder for the
uploaded file.
5 On the Upload page, make sure Publish After Uploading is
checked.
6 Click Submit Upload.
If you want to encode your videos
using Scene7 Publishing System
1 On the Global Navigation bar, click Upload.
2 In the Upload screen, click From Desktop tab.
3 In the Select Files to Upload panel, click Browse, navigate to a
master source video file, and then click Open.
4 In the Choose Folder Destination panel, select a folder for the
uploaded file.
5 In the lower-right corner of the page, click Job Options,
6 In the Upload Job Options dialog box, expand EVideo Options.
7 Do one of the following:
• Best practice is to use the following method.
Select Adaptive Video Encoding (16:9 or 4:3).
See “Adaptive Video Encoding (16:9 or 4:3) video presets” on
page 28.
• Optional, if you want to use individual encoding settings, do
the following.
Expand Single Encoding Presets, and then select the encoding
options you want for Desktop, Mobile, and Tablet.
See “Desktop video encoding presets” on page 29, “Mobile
video encoding presets” on page 30, “Tablet video encoding
presets” on page 31.
8 In the Upload Job Options dialog box, click Save.
9 On the Upload page, make sure Publish After Uploading is
checked.
10 On the Upload page, in the lower-right corner, click Submit
Upload.
Last updated 10/9/2014
214
USING SCENE7
Video
If you want to re-encode a video file
that you previously uploaded
1 In Scene7, in the Browse panel, navigate to the video and select it.
2 Click File > Reprocess.
3 In the Reprocess Assets dialog box, expand EVideo Options.
4 Do one of the following:
• Best practice is to use the following method.
Select Adaptive Video Encoding (16:9 or 4:3).
See “Adaptive Video Encoding (16:9 or 4:3) video presets” on
page 28.
• Optional, if you want to use individual encoding settings, do
the following.
Expand Single Encoding Presets, and then select the encoding
options you want for Desktop, Mobile, and Tablet.
See “Desktop video encoding presets” on page 29, “Mobile
video encoding presets” on page 30, “Tablet video encoding
presets” on page 31.
5 In the Reprocess Assets dialog box, click Submit.
When you use an Adaptive Video Encoding preset or you use multiple single encoding presets, the result is an
Adaptive Video Set that is automatically created with multiple video encodings. You can also manually create an
Adaptive Video Set by selecting individual videos.
Only MP4 and M4V file types are created when you generate an Adaptive Video Set either automatically or manually.
More Help topics
“Best practices for video encoding” on page 215
“Working with video encoding presets” on page 219
Supported video file types for encoding
The following table lists video file types (with permitted video codecs) that you can encode to MP4 or OGV format
when you upload files. The table lists file formats and codecs:
Video file formats Similar to a ZIP file, a video file format determines how files are contained in the video file. A video
file usually contains multiple tracks — a video track (without audio) and one or more audio tracks (without video) —
that are interrelated and synchronized. The video file format determines how these different data tracks and metadata
are organized.
Video codecs A video codec describes the algorithm by which a video is encoded. A video player decodes the video
according to its codec and then displays a series of images, or frames, on the screen. Codecs minimize the amount of
information that video files are required to store to play video. Rather than information about each individual frame,
only information about the differences between one frame and the next are stored. Because most videos change little
from one frame to the next, codecs allow for high compression rates, which results in smaller file sizes.
Last updated 10/9/2014
215
USING SCENE7
Video
Video file format
Video codecs
3GP
H.263, H.264
AVI
DivX, DV
F4V
H.264
FLV
H.263
M2P
MPEG-2 PS
M2T
MPEG-2 TS
M2TS
MPEG-2 TS
M2V
MPEG-2 ES
M4V
H.264
MOV
DV, DVCPro 50, H.261, H.263, H.264, Sorenson Video 1
MP4
H.264/MPEG-4 AVC
MPEG
MPEG-2 SS
MPG
MPEG-2 SS
MTS
MPEG-2
ProRes
APCN , APCS, APCO, APCH, AP4H
TS
DVCPro 50
VOB
MPEG-2
WMV/ASF
VC-1, Windows Media Video 7, Windows Media Video 8
Note: The Jobs screen alerts you if you upload and attempt to encode a video file but the file is rejected because it contains
an incompatible codec or file container. For more information, see “Checking job files” on page 93.
Best practices for video encoding
The following are best-practice tips for encoding source video files in Scene7 Publishing System.
For advice about video encoding, see the following:
• Article: Streaming 101: The Basics — Codecs, Bandwidth, Data Rate, and
Resolution:www.adobe.com/go/learn_s7_streaming101_en.
• Video: Video Encoding Basics:www.adobe.com/go/learn_s7_encoding_en.
More Help topics
“Quick Start: Video” on page 209
“Uploading and encoding videos” on page 211
“Working with video encoding presets” on page 219
“Working with video viewer presets” on page 223
Last updated 10/9/2014
216
USING SCENE7
Video
Source video files
When you encode a video file, use a source video file of the highest possible quality. Avoid using previously encoded
video files because these files are already compressed, and further encoding creates a subpar quality video.
The following table describes the recommended size, aspect ratio, and minimum bit rate that your source video files
should have when you encode them:
Size
Aspect ratio
Minimum bit rate
1024 X 768
4:3
4500 kbps for most videos.
1280 X 720
16:9
3000 - 6000 kbps, depending on the amount of motion in
the video.
1920 X 1080
16:9
6000 - 8000 kbps, depending on the amount of motion in
the video.
Obtaining a file’s metadata
You can obtain a file’s metadata by viewing its metadata in Scene7, using a video editing tool, or using an application
designed for obtaining metadata. Following are instructions for using MediaInfo, a third-party application, to obtain
a video file’s metadata:
1 Go to this web page: http://mediainfo.sourceforge.net/en/Download.
2 Select and download the installer for the GUI version, and follow the installation instructions.
3 After installation, either right-click the video file (Windows only) and select MediaInfo, or open MediaInfo and
drag your video file into the application. You see all metadata associated with your video file, including its width,
height, and fps.
Aspect ratio
When you choose or create a video encoding preset for your master video file, make sure that the preset has the same
aspect ratio as the master video file. The aspect ratio is the ratio of the width to the height of the video.
To determine the aspect ratio of a video file, obtain the file’s metadata and note the file’s width and height (see
“Obtaining a file’s metadata” on page 216). Then use this formula to determine the aspect ratio:
width/height = aspect ratio
The following table describes how formula results translate to common aspect ratio choices:
Formula result
Aspect ratio
1.33
4:3
0.75
3:4
1.78
16:9
0.56
9:16
For example, a video that is 1440 width x 1080 height has an aspect ratio of 1440/1080, or 1.33. In this case you choose
a video encoding preset with a 4:3 aspect ratio to encode the video file.
Data rate
The data rate (also called the bit rate) is the amount of data that is encoded to make up a single second of video
playback. The data rate is measured in kilobits per second (Kbps).
Last updated 10/9/2014
217
USING SCENE7
Video
Important: Because all codecs use lossy compression, data rate is the most important factor in video quality. With lossy
compression, the more you compress a video file, the more the quality is degraded. For this reason, all other characteristics
being equal (the resolution, frame rate, and codec), the lower the data rate, the lower the quality of the compressed file.
When you choose a video encoding preset, take into account the target end user’s connection speed. Choose a preset
with a data rate that is 80 percent of that speed. For example, if the target end user’s connection speed is 1000 Kbps,
the best preset is one with a video data rate of 800 Kbps.
This table describes the data rate of typical connection speeds.
Speed (Kbps)
Connection type
256
Dial-up connection.
800
Typical mobile connection. For this connection, target a data rate in the range of 400
to a maximum of 800 for 3G experiences.
2000
Typical broadband desktop connection. For this connection, target a data rate in the
800–2000 Kbps range, with most targets averaging 1200–1500 Kbps.
5000
Typical high-broadband connection. Encoding in this upper range is not
recommended because video delivery at this speed is not available to most
consumers.
Resolution
Resolution describes a video file’s height and width in pixels. Most source video is stored at a high resolution (for
example, 1920 x 1080). For streaming purposes, source video is compressed to a smaller resolution (640 x 480 or
smaller).
Resolution and data rate are two integrally linked factors that determine video quality. To maintain the same video
quality, the higher the number of pixels in a video file (the higher the resolution), the higher the data rate must be. For
example, consider the number of pixels per frame in a 320 x 240 resolution and a 640 x 480 resolution video file:
Resolution
Pixels per frame
320 x 240
76,800
640 x 480
307,200
The 640 x 480 file has four times more pixels per frame. To achieve the same data rate for these two example
resolutions, you apply four times the compression to the 640 x 480 file, which can reduce the quality of the video.
Therefore, a video data rate of 250 Kbps produces high-quality viewing at a 320 x 240 resolution, but not at a 640 x 480
resolution.
In general, the higher data rate you use, the better your video looks, and the higher resolution you use, the higher data
rate you need to maintain viewing quality (compared to lower resolutions).
Because resolution and data rate are linked, you have two options when encoding video:
• Choose a data rate and then encode at the highest resolution that looks good at the data rate you chose.
• Choose a resolution and then encode at the data rate necessary to achieve high-quality video at the resolution you
chose.
When you choose (or create) a video encoding preset for your master video file, use this table to target the correct
resolution:
Last updated 10/9/2014
218
USING SCENE7
Video
Resolution
Height (pixels)
Screen size
240p
240
Tiny screen
300p
300
Small screen typically for mobile devices
360p
360
Small screen
480p
480
Medium screen
720p
720
Large screen
1080p
1080
High-definition large screen
Fps (frames per second)
In the United States and Japan, most video is shot at 29.97 frames per second (fps); in Europe, most video is shot at 25
fps. Film is shot at 24 fps.
Choose a video encoding preset that matches the fps rate of your master video file. For example, if your master video
is 25 fps, choose an encoding preset with 25 fps. By default, all custom encoding uses the master video file’s fps. For
this reason, you do not need to explicitly specify the fps setting when you create a video encoding preset.
Video encoding dimensions
For optimal results, select encoding dimensions such that the source video is a whole multiple of all your encoded
videos.
To calculate this ratio, you divide source width by encoded width to get the width ratio. Then, you divide source height
by encoded height to get the height ratio.
If the resulting ratio is a whole integer, it means that the video is optimally scaled. If the resulting ratio is not a whole
integer, it impacts video quality by leaving leftover pixel artifacts on the display. This effect is most noticeable when
the video has text.
As an example, suppose that your source video is 1920 x 1080. In the following table, the three encoded videos provide
the optimal encoding settings to use.
Video Type
Width x Height
Width Ratio
Height Ratio
Source
1920 x 1080
1
1
Encoded
960 x 540
2
2
Encoded
640 x 360
3
3
Encoded
480 x 270
4
4
Encoded video file format
Adobe Scene7 recommends using MP4 H.264 video encoding presets. Because MP4 files use the H.264 video codec, it
provides high-quality video but in a compressed file size.
Last updated 10/9/2014
219
USING SCENE7
Video
Working with video encoding presets
Master video files created with video production equipment and video-editing software are often too large and not in
the proper format for delivery to online destinations. To convert digital video to the proper format and specifications
for playback on different screens, you can transcode video files (a process also known as encoding). During the
encoding process, the video is compressed to a smaller, efficient file size for optimal delivery to the web and to mobile
devices.
See “Uploading and encoding videos” on page 211.
Scene7 gives you a library of predefined video encoding presets that reflect the most common encoding settings used
today. These encoding presets are optimized for playback on target screens. In addition, administrators can create their
own video encoding presets to customize the size and playback quality of videos to end users. All video encoding
presets, whether out-of-the-box from Scene7, or custom-made, output video in the MP4 file format.
On the Video Presets screen, administrators can set up and manage video encoding. They can do the following:
• Activate and deactivate video encoding presets.
• Create a video encoding preset.
• Edit video encoding presets.
• Delete video presets.
Any video that you upload to Scene7 Publishing System or that you encode in Scene7 Publishing System is treated as
“video”. In other words, this asset classification means that you can deliver the video for playback on desktops, mobile
devices, or both. For example, you can preview these types of videos in Scene7 Publishing System. You can also
generate URLs (using the Copy URL feature) and code that you can embed (using the Embed Code feature) for use
with video players, on websites, and so on.
See “Previewing videos in a video viewer” on page 222.
See “Linking a video URL to a mobile site or a website” on page 225.
See “Embedding the video viewer on a web page” on page 225.
For video assets that you upload and encode in Scene7 Publishing System, you can deliver video in the following file
formats:
MP4 H.264 Scene7 recommends MP4 as the preferred video file format. Use MP4 files for the following:
• HTTP Dynamic Streaming on desktops.
• HTTP Live Streaming (Apple’s streaming protocol).
• Progressive video delivery to Android, Blackberry, and Windows mobile devices.
OGG Vorbis Use OGV files for progressive video delivery to non-Flash enabled desktops.
F4V H.264, FLV VP6, and FLV H.263 Use Flash FLV or F4V files for progressive or streaming video delivery to Adobe
Flash Players on the desktop.
Any other video format and codec that is not in the list above is treated as a “Master Video”. This asset classification
means that the video is a source video file and cannot be used for delivery playback on desktops or mobile devices. For
example, you cannot preview these types of videos in Scene7 Publishing System. You also cannot generate Copy URLs
or Embed Code for use in video players, on websites, and so on.
Filtering the list of video encoding presets
The Video Presets page and the Adaptive Video Presets page consist of a table that lists the active status, preset name,
intended playback device, video dimension, and target data rate of each video preset.
Last updated 10/9/2014
220
USING SCENE7
Video
You can refine the list by choosing to filter on Both, Active, or Inactive, to see all Video Presets or narrow the list to
presets that are active or inactive.
You can also filter based on a playback device option to narrow the list to Video Presets designed for playing videos
on all devices, desktop, mobile, or tablets.
To filter the list of video encoding presets
1 In Scene7, click Setup > Application Setup > Video Presets > Adaptive Video Presets or Single Encoding Presets.
The pages for Adaptive Video Presets and Single Encoding Presets include a table that lists the Active status, Preset
name, intended Playback Device, video dimensions, and Target data rate of each video preset.
2 On the Single Encoding Presets page called Video Presets, on the Video Presets toolbar, use the two drop-down lists
to refine the list of presets in the table based on Active status, and playback device.
• On the first, narrower drop-down list, choose Both to see all Video Presets, or choose Active or Inactive or
narrow the list to presets that are active or inactive.
• On the second, wider drop-down list, choose a playback device option to narrow the list to Video Presets
designed for playing videos on desktops. or for playing videos on mobile or tablet devices.
Activating or deactivating video encoding presets
Activated Video Presets show up in the Upload Job Options dialog box. This is the dialog box that appears when a user
uploads video files during the upload process. They can choose from a list of all activated encoding presets.
To activate or deactivate video encoding presets
1 In Scene7, click Setup > Application Setup > Video Presets.
2 Do one of the following:
• Click Adaptive Video Presets.
• Click Single Encoding Presets.
3 Do one of the following:
• To activate a video preset, on the presets page, under the Active column, select the box next to a preset name.
• To deactivate a video preset, deselect the box next to the video presets that you want to make inactive.
Inactive Video Presets do not appear in the Upload Job Options dialog box.
4 In the lower right corner of the page, click Close.
Adding or editing a video encoding preset
You can create your own custom single encoding video presets and add them to the Video Presets table. You can also
make changes to any pre-defined single encoding Video Presets that came with Scene7, provided you save the edited
preset with a new name.
Scene7 has set maximum limits on the target data rate, resolution height, and resolution width to ensure a proper
playback experience. Warning messages appear if you exceed these limits which are the following:
• For computer playback, the limits are: (Width/16) * (Height/16) < 8192.
• For mobile playback, the limits are: (Width/16) * (Height/16) < 660; target data rate < 4000.
• For tablet playback, the limits are: (Width/16) * (Height/16) < 3600.
To add or edit a video encoding preset
1 In Scene7, click Setup > Application Setup > Video Presets.
Last updated 10/9/2014
221
USING SCENE7
Video
2 Click Single Encoding Presets to open the Video Presets page.
3 In the Video Presets page, do any one of the following:
• On the Video Presets toolbar click Add to add a new Video Preset.
• Select a Video Preset. In the toolbar, click Edit.
You cannot edit Scene7 predefined presets; you can only create a preset from an existing one by choosing Save As.
4 On the Add Video Preset page or the Edit Video Preset page, set the Video Preset options you want.
See “Best practices for video encoding” on page 215 for recommended settings.
Video Preset
option
Description
Preset Name
Enter a descriptive name for the Video Preset. The name you enter appears in the Upload Job
Options dialog box, in which users choose transcoding options.
Description
Describe the Video Preset. What you enter appears as a tool tip when you move the pointer
over the name of the preset in the Upload Job Options dialog box in which users choose
transcoding options.
Playback Device
Choose the device that the video is intended to play back on. The options are Computer
(compatible with Flash 9), Mobile (iPhone, iPad, Android); or Tablet (iPad only). This setting
automatically determines the appropriate video and audio codec that is used during
encoding.
Target Data Rate
Enter the average Internet connection speed (in kilobits per second) of the target end user.
You can enter the rate or drag the slider to enter it. The User Connection Speed spectrum lists
typical speeds for broadband, DSL, mobile, and dial-up connections. This setting
automatically determines the combined video and audio data rate. In other words, the
amount of data that is encoded to make up a single second of video playback. The higher the
data rate, the better the quality of the resulting video. However, data rates that are too high
result in large file sizes that create subpar viewing experiences for users with a low
bandwidth. As a best practice, strike a balance between high and low data rates. Aim to
create an adequate quality playback experience without alienating users who have narrow
bandwidths.
Aspect Ratio
Aspect ratio is the ratio of the width to the height of the video. The first two aspect ratios
listed below are commonly used to display video horizontally:
•
4:3 - Used for almost all standard definition TV broadcast content.
•
16:9 - Used for almost all wide-screen, high-definition TV content (HDTV) and movies.
•
Auto-scale - (Default) A single encoding preset that works with any aspect ratio to create
videos for delivery to mobile, tablet, and desktop. Uploaded source videos that are
encoded with this preset are set with a fixed height. However, the width automatically
scales to preserve the video’s aspect ratio (width to height ratio).
•
Custom - Used when you want to define a non-standard video size.
The aspect ratio you choose determines the width and height settings for the Resolution Size;
the width and height value automatically scale to the proper aspect ratio.
Last updated 10/9/2014
222
USING SCENE7
Video
Video Preset
option
Description
Resolution Size
Resolution size, expressed by the number of pixels wide by the number of pixels high,
determines the dimension. Enter a width and height value in pixels or drag the slider to enter
these values. The Resolution spectrum lists typical resolution sizes. The width and height
values automatically adhere to the aspect ratio you selected. For example, if you select 4:3 as
the aspect ratio and enter 400 for width, 300 is entered automatically for height.
If you selected Auto-scale for the Aspect Ratio setting, then the Width value for the
Resolution Size is automatically set to Auto.
Click Preview to open a browser window and see your resolution choices there.
Encode File
Suffix
Enter a suffix. This suffix is appended to the resulting encoded video file. You can enter a
hyphen and underscore in the name; blank spaces and special characters are not allowed.
Other Settings
Scene7 determines all other encoding settings automatically according to best-practice
encoding guidelines.
5 Do one of the following:
• Click Save if you added or edited a Video Preset.
• Click Save As if you added a Video Preset by starting from an existing preset.
Deleting a video encoding preset
Administrators can delete custom Video Presets. Video presets that come with Scene7 cannot be deleted.
To delete a video encoding preset
1 In Scene7, click Setup > Application Setup > Video Presets.
2 Click Single Encoding Presets to open the Video Presets page.
3 In the Video Presets page, select a Video Preset in the table that you no longer want or need.
4 On the Video Presets toolbar, click Delete.
5 In the Delete Preset dialog box, click Delete.
Previewing videos in a video viewer
You can preview what a video looks like and how it plays in the Video Viewer.
See “Adding and editing Viewer presets” on page 38.
To preview videos in a video viewer
1 In the Asset Library panel on the left side, in the Show drop-down list, select Video (single encoded videos) or
Adaptive Video Set (when the Adaptive Video encoding preset is used, it results in a set of multi-bitrate encoded
videos).
2 In the Asset Library panel on the left side, navigate the asset folders to select the video that you want to preview.
3 Do any one of the following
• Above the Assets window, on the right side of the toolbar, click List View. In the Asset window, hover on an
asset, and then click Preview.
• Above the Assets window, on the right side of the toolbar, click Grid View. In the Asset window, in an asset
thumbnail window, click Preview.
Last updated 10/9/2014
223
USING SCENE7
Video
• Above the Assets window, on the right side of the toolbar, click Detail View. On the same toolbar, click Preview.
• In the Asset window, select an asset. In the toolbar, click File > Preview.
4 (Optional) In the Preview window, in the drop-down list at the bottom, select the URL encoding that you want
applied to the asset’s URL when it is copied.
5 Click the Preview link to preview the asset in the selected viewer.
6 Close the displayed viewer to return to the Preview screen.
7 Click Close to return to the Assets screen.
Note: Scene7 provides a convenient method of previewing MP4 video on the desktop. Use this method to preview mobile
content on the desktop without physically testing it on mobile devices. Be aware, however, that what you see in the desktop
preview does not realistically show what playback looks like on the mobile device. To preview how video looks and plays
on a mobile device, go to the Preview screen, select the Copy URL and enter that URL in the web browser of a mobile
device. For more information, see “Deploying video to your websites and mobile sites” on page 224.
More Help topics
“Best practices for video encoding” on page 215
“Working with video encoding presets” on page 219
Working with video viewer presets
Users watch videos in the Video Viewer. How the Video Viewer behaves, what it looks like, and how its playback
controls work depends on the Viewer Preset you choose for playing the video. You choose a Viewer Preset on the
Preview screen. After you choose a preset, you can obtain the URL or the embed code for playing the video using the
Viewer Preset you chose.
Scene7 comes with many predefined Viewer Presets for playing video, and if you are an administrator, you can create
custom Viewer Presets. There are more than a dozen different settings for configuring the Video Viewer. You can
configure its size, color, video and audio controls, progress bar, user-interface skin, and social features.
See also “Previewing videos in a video viewer” on page 222.
Adding or editing a video viewer preset
You can use Viewer Presets to see various viewer types and their pre-defined settings. You can also add and edit your
own customized viewer presets or edit existing viewer presets that come with Scene7 Publishing System.
In Viewer Presets you can activate, filter, sort, and preview Viewer Presets.
See “Viewer Presets” on page 32.
To add or edit a video viewer preset
1 Near the upper-right corner of Scene7 Publishing System, click Setup > Viewer Presets.
To see only presets for Video Viewers, select Video Viewer from the open the Viewers drop-down list in the toolbar
directly above the table.
2 Add or edit a Viewer Preset for showing video:
Adding Click Add in the toolbar. In the Add Viewer Preset dialog box, choose a platform and viewer from the
respective drop-down lists, and then click Add.
See also “Adding and editing Viewer presets” on page 38.
Last updated 10/9/2014
224
USING SCENE7
Video
Adding by starting from an existing Viewer Preset In the table, select a Video Viewer Preset, and then click Edit in
the toolbar.
After you reconfigure the Video Viewer, click Save As to save the preset using a different name in the Preset Name
text field.
Editing Select a Video Viewer Preset, and then click Edit.
3 In the Configure Viewer screen, in the Preset Name field, enter or edit the preset name.
4 Set the remaining options that you want.
To see a description of an option, click its Info Tip icon
.
5 Do one of the following:
• Click Save As if you added a Viewer Preset by starting from an existing preset.
• Click Save if you added or edited a Viewer Preset.
Deploying video to your websites and mobile sites
Websites, mobile sites, and desktop applications access Scene7 server content, including video, by using URL strings
or embedded code. Scene7 activates these URL strings during the publishing process. To place the URL string or
embed code for your video in your web pages, mobile pages, and desktop applications, copy it from the Scene7
Publishing System.
Important: The URL or embed code is not active until you publish the asset.
Publishing video
Publishing a video enables Scene7 Servers to deliver video to your website, mobile site, or application.
There are two different methods you can use to publish video:
• Publish videos automatically and instantly on upload
As part of the video upload process, Scene7 can automatically publish videos when they are uploaded and encoded.
This ability to instantly publish means that there is no need to publish videos separately after the fact.
• Publish video manually after upload
If you do not want to publish videos immediately, you can manually publish videos at any time.
After you publish videos, the Scene7 Publishing System activates the URL strings for your HTML page or application code.
To publish video
❖ Do one of the following:
• To publish videos automatically and instantly on upload, in the Upload screen, click Publish after uploading.
You have finished; there are no further steps to complete.
• To publish videos manually after upload, in the Browse Panel, select the videos, and then on the Global
Navigation bar, click Publish.
More Help topics
“Publishing files” on page 87
Last updated 10/9/2014
225
USING SCENE7
Video
Linking a video URL to a mobile site or a website
After you publish a video, you can obtain its URL for use in your website, mobile site, or desktop application. Use the
video URL when you want to display video in a pop-up or modal window on top of the web page.
When a customer clicks the link, their device, bandwidth, and screen size are automatically detected. The appropriate
video is displayed for playback in a pre-defined viewer for desktop, or in the mobile device's native video player for
smartphones and tablets.
See also “Embedding the video viewer on a web page” on page 225.
To link a video URL to a mobile site or a website
1 In the Asset Browse panel, in the Show drop-down list, click Video or Adaptive Video Set.
2 in the Asset Library panel on the left side, navigate to the asset folder that contains the video or adaptive video set
you want to link.
3 Above the Asset Browse panel, on the right side of the toolbar, do one of the following:
• Click Grid View or List View. In the Asset Browse panel, double-click the video thumbnail of a single asset to
open it in Detail View. In the URLs and Embed Code panel on the right, under HTTP Streaming, click Copy
URL to the right of the viewer you want. As a best practice, copy the URL associated with the
Universal_HTML5_Video viewer.
• Click Grid View. In the Asset Browse panel, select a single asset, and then below the thumbnail image, click
Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Copy URL. As a best practice, copy the URL
associated with the Universal_HTML5_Video viewer.
• Click List View. In the Asset Browse panel, select a single asset, and then to the right of the thumbnail image,
click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Copy URL. As a best practice, copy the URL
associated with the Universal_HTML5_Video viewer.
• Click Grid View, List View, or Detail View. On the same toolbar, click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Copy URL. As a best practice, copy the URL
associated with the Universal_HTML5_Video viewer.
4 Paste the HTML5 video URL link on your website and mobile site.
Embedding the video viewer on a web page
Use the Embed Code feature when you want to play the video embedded on the web page. You copy the embed code to
the clipboard so you can paste it in your web pages. Editing of the code is not permitted in the Embed Code dialog box.
See also “Linking a video URL to a mobile site or a website” on page 225.
To embed the video viewer on a web page
1 In the Asset Browse panel, in the Show drop-down list, click Video or Adaptive Video Set.
2 in the Asset Library panel on the left side, navigate to the asset folder that contains the video or adaptive video set
whose embed code you want to copy.
Last updated 10/9/2014
226
USING SCENE7
Video
3 Above the Asset Browse panel, on the right side of the toolbar, do one of the following:
• Click Grid View or List View. In the Asset Browse panel, double-click the video thumbnail of a single asset to
open it in Detail View. In the URLs and Embed Code panel on the right, under HTTP Streaming, click Embed
Code to the right of the viewer you want. As a best practice, click Embed Code that is associated with the
Universal_HTML5_Video viewer.
• Click Grid View. In the Asset Browse panel, select a single asset, and then below the video thumbnail image,
click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Embed Code. As a best practice, click
Embed Code that is associated with the Universal_HTML5_Video viewer.
• Click List View. In the Asset Browse panel, select a single asset, and then to the right of the thumbnail image,
click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Embed Code. As a best practice, click
Embed Code that is associated with the Universal_HTML5_Video viewer.
• Click Grid View, List View, or Detail View. On the same toolbar, click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Embed Code. As a best practice, click
Embed Code that is associated with the Universal_HTML5_Video viewer.
4 In the Embed Code dialog box, click Copy to Clipboard.
Editing the code is not permitted in the Embed Code dialog box.
5 Click Close.
6 Paste the embed code in your web pages.
Implementing embed code for using HTML5 video with MP4 and OGG video assets
If you do not use the Scene7 HTML5 video player, but instead want to use the native HTML5 <video> tag with MP4
and OGG video assets, you can use the following embed code sample:
<video poster="S7 video thumbnail URL" controls>
<source src="S7 OGG video asset URL (no player)" type='video/ogg; codecs="theora,
vorbis"'/>
<source src="S7 MP4 mobile progressive video asset URL (no player)" type='video/mp4;
codecs="avc1.4D401E, mp4a.40.2"'/>
<p>This is fallback content</p>
</video>
• Replace "S7
video thumbnail URL" with the video’s thumbnail URL. This is the video’s thumbnail image that a
user sees before they play the video.
See “Obtaining video thumbnail URLs” on page 228.
• Replace "S7
OGG video asset URL (no player)" with the video’s progressive URL for OGG video.
See “Linking a video URL to a mobile site or a website” on page 225.
• Replace "S7
MP4 mobile progressive video asset URL (no player)" with the video’s mobile progressive URL.
See “Linking a video URL to a mobile site or a website” on page 225.
Deploying video using a third-party video player
If you use a third-party video player or a custom built video player instead of a Scene7 video viewer, you can obtain
the direct video URL that works for HTTP and iOS multi-bitrate video streaming or progressive download.
Last updated 10/9/2014
227
USING SCENE7
Video
To deploy video using a third-party video player
1 In Scene7 Publishing System, on the Global Navigation bar, click Setup > Application Setup > General Settings.
2 Depending on the type of URL you want to use, do one of the following tasks:
To generate a direct HTTP
streaming video URL for
desktop (multi-bitrate)
1 On the Application General Settings page, in the Servers group, in the
Published Server Name text field, construct the direct URL using the
following syntax:
server/is/content/company/folder/filename.f4m
For example, suppose the Published server name is
http://s7d9.scene7.com/. Using the syntax in step 2, the direct URL might
look like the following:
2
To generate a direct iOS
streaming video URL
(multi-bitrate)
http://s7d9.scene7.com/is/content/GeoRetail/AdobeRIA-AVS.f4m
❖ On the Application General Settings page, in the Servers group, in the
Published Server Name text field, construct the direct URL using the
following syntax:
server/is/content/company/folder/filename.m3u8
For example, suppose the Published server name is
http://s7d9.scene7.com/. Using the syntax in step 2, the direct URL might
look like the following:
http://s7d9.scene7.com/is/content/GeoRetail/AdobeRIA-AVS.m3u8
To generate a direct HTTP
streaming video URL for
desktop (single bit rate)
1 On the Application General Settings page, in the Servers group, in the
iOS Streaming Server Name text field, replace hls/vod with hds/vod in the
server name.
2 Construct the direct eVideo URL using the following syntax:
server/company/folder/filename.ext.f4m
For example, using the syntax above, an example direct eVideo URL might
look like the following:
http://s7mbrstream.scene7.com/hdsvod/eVideoQA/MBR/ToyStory3_Teaser1_High_iPad_768x432_1296K.mp4.f4m
To generate a direct iOS
streaming video URL
(single bitrate):
❖ On the Application General Settings page, in the Servers group, in the
iOS Streaming Server Name text field, combine
server/company/folder/filename.ext.m3u8with the name of the iOS
streaming server.
For example, suppose the iOS streaming server name is
http://s7mbrstream.scene7.com/hls-vod/. Using the syntax in step 2, the
direct eVideo URL might look like the following:
http://s7mbrstream.scene7.com/hlsvod/eVideoQA/MBR/ToyStory3_Teaser1_High_iPad_768x432_1296K.mp4.m3u8
Last updated 10/9/2014
228
USING SCENE7
Video
To generate a direct
progressive video URL
❖ On the Application General Settings page, in the Servers group, in the
Progressive Video Server Name text field, construct the direct eVideo
URL using the following syntax:
server/company/folder/filename
For example, suppose the progressive video server name is
http://s7d9.scene7.com/e2/. Using the syntax in step 2, the direct eVideo
URL might look like the following:
http://s7d9.scene7.com/e2/GeoRetail/SourceVideo/outdoors.mp4
Working with video thumbnails
Scene7 generates thumbnails for Video Recuts, encoded videos, and pre-encoded videos. You can use video
thumbnails like any image asset. Moreover, you can obtain URLs for the video thumbnails that Scene7 generates and
deploy these URLs outside SPS. For example, you can deploy the thumbnails in search results, related video listings,
and video play lists on a website.
Thumbnails are generated based on the first heterogeneous frame (not an all black frame, or an all white frame, and
so forth) of the video.
See also “Video Recuts” on page 234.
Obtaining video thumbnail URLs
Scene7 generates video thumbnails automatically during the upload process. The thumbnails appear in the Browse
panel in List view and Grid view.
To generate URLs for video thumbnails, perform a publish operation.
See “Publishing video” on page 224.
After publishing, you can obtain video thumbnail URLs in Detail View in the URLs and Embed Code panel. Click
Copy URL to the right of the video thumbnail to copy its URL
Modifying poster frames in video viewers
The poster frame is the initial frame that appears in Video viewers before the video begins playing. Scene7 uses video
thumbnails as poster frames.
You can apply image modifiers to the poster frame. For example, you can crop the poster frame or make it transparent.
To modify the poster frame, open the video viewer configuration screen and enter modifiers in the Poster Image
Modifiers section.
See “Adding or editing a video viewer preset” on page 223.
See www.adobe.com/go/learn_s7_image_server_guide_en.
You can also modify video thumbnails by appending modifiers to video thumbnail URLs.
Last updated 10/9/2014
229
USING SCENE7
Video
Adding captions to video
You can extend the reach of your videos to global markets by adding captioning to single videos or to Adaptive Video
Sets. By adding captioning you avoid the need to dub the audio, or the need to use native speakers to rerecord the audio
for each different language. The video is played in the language that it was recorded. Foreign language subtitles appear
so that people of different languages can still understand the audio portion.
Captioning also allows for greater accessibility by using closed captioning for people who are deaf or hard of hearing.
Note: The video player that is used must support the display of captions.
See “Adding or editing a video viewer preset” on page 223 to configure the Caption Effect and to edit the Caption
Menu itself, including the menu’s text for any of the following viewers:
•
Universal_HTML5_Video viewer (HTML5).
•
Universal_HTML5_MixedMedia_dark viewer (HTML5).
•
Universal_HTML5_MixedMedia_light viewer (HTML5).
•
Video_Caption viewer (Flash AS3).
See also “Adding and editing Viewer presets” on page 38.
See “Adding localization support to a Flash AS3 Viewer preset” on page 39 to add localization support to a video
caption viewer.
If desired, you can create and brand your own custom video viewer with captions instead of using a video viewer preset.
For instructions on creating your own HTML5 viewer with captions, in the Adobe Scene7 Viewer SDK for HTML5
guide, in the Adobe Scene7 Viewer SDK, reference the classes s7sdk.video.VideoPlayer and
s7sdk.common.ClosedCaptionButton.
Or, to create your own Flash AS3 viewer with captions, see the Adobe Scene7 Viewer SDK for Adobe Flash also found
in the Adobe Scene7 Viewer SDK.
The Adobe Scene7 Viewer SDK is available as a download from the following location:
Adobe Developer Connection.
Scene7 has the capability of converting caption files to JSON (JavaScript Object Notation) format. This conversion
means you can embed the JSON text into a web page as a hidden but complete transcript of the video. Search engines
can then crawl and index the content to make the videos more easily discoverable and give customers additional details
about the video content.
See Serving static (non-image) contents in the Scene7 Image Serving API Help for more information about using the
JSON function in a URL.
To add captions to video
1 Using a third-party application outside Scene7 Publishing System, create your video caption file based on the
viewer type that you are using.
Last updated 10/9/2014
230
USING SCENE7
Video
Viewer type
Captioning file
HTML5
If you are using an HTML5 video viewer, ensure that the caption file you create follows the
WebVTT (Web Video Text Tracks) standard. The captioning filename extension is .vtt. You can
learn more information about the WebVTT captioning standard.
See WebVTT: The Web Video Text Tracks format.
There are both free and paid for tools and services that you can use to author caption files
outside Scene7 Publishing System. For example, to create a simple video caption file with no
styling, you can use the following free online caption authoring and editing tool:
WebVTT Caption Maker
For best results, use the tool in Internet Explorer 9 or above, Google Chrome, or Safari.
In the tool, in the Enter URL of video file field, paste the URL of your video file and then click
Load.
For example, if you are using a Scene7 URL for your video file, in SPS, double-click an
individual video asset (not an Adaptive Video Set or a Master Video) to open it in Detail View.
In the right panel of the Detail View, expand URLs and Embed Code. Then under the Mobile
group, to the right of Mobile (Progressive), click Copy URL. This process gives you the URL to
the video file itself which you can then paste into the Enter URL of video file field. Internet
Explorer, Chrome, or Safari can then natively play back the video. Now follow the onscreen
instructions from the site to author and save your WebVTT file. When you have finished, copy
the caption file contents and paste it into a plain text editor and save it with a .vtt filename
extension.
Note: For global support of video captions in languages other than English, be
aware that the WebVTT standard requires that you create separate .vtt files
and calls for each language you want to support.
Generally, you want to name the caption VTT file the same name as the video file, and
append it with captions. By doing so, it can help you with automating the generation of
the video URLs using your existing web content management system.
Flash AS3
If you are using a Flash video viewer, ensure that it follows the DFXP (Distribution Format
Exchange Profile) standard or the SMPTE (Society of Motion Picture & Television Engineers)
standard.
For more information about captioning standards, see the following:
Timed Text DFXP
SMPTE
To learn more about recommended captioning tools and captioning services that support
the necessary formats and standards, see Adobe Flash accessibility design guidelines.
For an example of a caption XML file, see Sample Caption File.
If you have multiple languages that you want to support, your captioning file can have a
language section that repeats for each language. You do not need to create separate
captioning files for each language.
Generally, you want to name the caption XML file the same name as the video file, and
append it with captions. By doing so, it can help you with automating the generation of
the video URLs using your existing web content management system.
2 In Scene7 Publishing System, upload your WebVTT, DFXP, or SMPTE XML caption file.
See “Uploading files” on page 79.
3 In the Asset Library panel on the left side, navigate to the asset folder that contains the video file that you want to
associate with the caption file that you uploaded.
4 In the Asset Browse panel, select a single video asset, and then below the thumbnail image of the asset, click Preview
> Viewer List.
Last updated 10/9/2014
231
USING SCENE7
Video
5
In the Viewer List table, find the HTML5 viewer named Univeral_HTML5_Video,
Universal_HTML5_MixedMedia_dark, or Universal_HTML5_MixedMedia_light, or find the Flash AS3 viewer
named Video_Caption, and then do one of the following:
• For a pop-up video viewer experience, click Copy URL to the far right of the name.
Append the copied URL of the video with the following syntax to associate it with the copied URL to your
caption file:
&captionasset=<full Copy URL path to the caption file .vtt,1>
Note the ,1 at the end of the caption URL path. Immediately following the .vtt filename extension in the path,
you have the option to enable or disable the closed caption button on the video player bar by setting to 1 or 0,
respectively.
• For an embedded video viewer experience, click Embed Code to the far right of the name.
In the Embed Code dialog box, click Copy to Clipboard.
For the Flash AS3 Video_Caption viewer, append the copied embed code with the following:
document.write('<param name="captionasset" value="companyname/captionfilename">');
or
For the HTML5 Universal_HTML5_Video, Universal_HTML5_MixedMedia_dark, or
Universal_HTML5_MixedMedia_light viewers, append the copied embed code with the following:
videoViewer.setParam("caption","<full Copy URL path to the caption file .vtt,1>"
Note the ,1 at the end of the URL path. Immediately following the .vtt filename extension in the URL path, you
have the option to enable or disable the caption button on the video player bar by setting to 1 or 0, respectively.
Adding chapter markers to video
You can make your long form videos easier to watch and navigate by adding chapter markers to single videos or to
Adaptive Video Sets. When a user plays the video, they can click the chapter markers on the video timeline (also known
as the video scrubber) to easily navigate to their point of interest, or immediately jump to new new content,
demonstrations, tutorials, and so on.
Note: The video player that is used must support the use of chapter markers.
See “Adding or editing a video viewer preset” on page 223 to configure the chapter navigation cue points and chapter
title pop-up text for the Universal_HTML5_Video viewer (HTML5).
See also “Adding and editing Viewer presets” on page 38.
If desired, you can create and brand your own custom video viewer with chapters instead of using a video viewer
preset. For instructions on creating your own HTML5 viewer with chapter navigation, in the Adobe Scene7 Viewer
SDK for HTML5 guide, in the Adobe Scene7 Viewer SDK, reference the heading “Customizing Behavior Using
Modifiers” under the classes s7sdk.video.VideoPlayer and s7sdk.video.VideoScrubber.
The Adobe Scene7 Viewer SDK is available as a download from the following location:
Adobe Developer Connection.
Last updated 10/9/2014
232
USING SCENE7
Video
You create a chapter list for your video in much the same way that you create captions. That is, you create a WebVTT
file. Note, however, that this file must be separate from any WebVTT caption file that you may also be using; you
cannot combine captions and chapters into one WebVTT file.
You can use the following sample as an example of the format you use to create a WebVTT file with chapter navigation:
WEBVTT
Chapter 1
00:00.000 --> 01:04.364
The bicycle store behind it all.
Chapter 2
01:04.364 --> 02:00.944
Creative Cloud.
Chapter 3
02:00.944 --> 03:02.937
Ease of management for a working solution.
Chapter 4
03:02.937 --> 03:35.000
Cost-efficient access to rapidly evolving technology.
In the example above, Chapter 1 is the cue identifier and is optional. The cue time of 00:00:000 --> 01:04:364
specifies the start time and end time of the chapter, in 00:00:000 format. That last three digits are milliseconds and can
be left as 000, if preferred. The chapter title of The bicycle store behind it all is the actual description of the
chapter’s contents. The cue identifier, the starting cue time, and the chapter title all appear in a pop-up in the video
player when a user hovers their mouse pointer over a visual cue point in the video’s timeline.
Because you are using an HTML5 video viewer, ensure that the chapter file you create follows the WebVTT (Web
Video Text Tracks) standard. The chapter filename extension is .vtt. You can learn more information about the
WebVTT captioning standard.
See WebVTT: The Web Video Text Tracks format.
To add chapter markers to video
1 Using a simple text editor outside Scene7 Publishing System, create your video chapter file.
Note: For global support of video chapters in languages other than English, be aware that the WebVTT standard
requires that you create separate .vtt files and calls for each language you want to support.
2 Save the .vtt file in UTF8 encoding to avoid problems with character rendition in the chapter title text.
Generally, you want to name the chapter VTT file the same name as the video file, and append it with chapters.
By doing so, it can help you with automating the generation of the video URLs using your existing web content
management system.
3 In Scene7 Publishing System, upload your WebVTT chapter file.
See “Uploading files” on page 79.
4 In the Asset Library panel on the left side, navigate to the asset folder that contains the video file that you want to
associate with the chapter file that you uploaded.
5 In the Asset Browse panel, select a single video asset, and then below the thumbnail image of the asset, click Preview
> Viewer List.
Last updated 10/9/2014
233
USING SCENE7
Video
6
In the Viewer List table, find the HTML5 viewer named Univeral_HTML5_Video, and then do one of the
following:
• For a pop-up video viewer experience, click Copy URL to the far right of the name.
Append the copied URL of the video with the following syntax to associate it with the copied URL to your
caption file:
&navigation=<full Copy URL path to the chapter navigation file .vtt>
• For an embedded video viewer experience, click Embed Code to the far right of the name.
In the Embed Code dialog box, click Copy to Clipboard.
For the HTML5 Universal_HTML5_Video viewer, append the copied embed code with the following:
videoViewer.setParam("navigation","<full Copy URL path to the chapter navigation file
.vtt>"
Exporting source and encoded videos
In the Browse panel, source videos are labeled “Master Video.” Encoded videos are labeled “Video.” You can export
source videos as well as master videos. To export video files, select them in the Browse panel and choose File > Export.
See “Exporting assets from Scene7 Publishing System” on page 113.
More Help topics
“Uploading and encoding videos” on page 211
Using the Universal URL
You can use the following workflow in Scene7 Publishing System for when you want to encode and publish videos to
multiple screens.
Note: While you can use this alternate workflow, the best practice is to use the HTML5 video viewer instead.
• Use Scene7 Publishing System to upload and encode your videos to MP4 H.264.
MP4 is a format that users can play on desktop and mobile screens, including iOS and Android devices. You can
even use an out-of-box adaptive video encoding setting which simplifies encoding with a single checkbox selection.
• Set up a universal video profile to use a Flash video viewer for desktop and default to the native device player on
mobile/tablet.
• Publish your videos using the smart Universal Viewer URL in Scene7.
See also “About Universal Viewers” on page 42.
Last updated 10/9/2014
234
Chapter 16: Video Recuts
In Scene7, you can enhance master videos into Video Recuts by using Adobe Premiere Express technology. This
technology provides easy-to-use editing capabilities to create interactive shopping experiences directly within the
video. For example, you can add clickable product hotspots to provide related information, or add call-to-action
buttons to enable purchase from the video. You create Video Recuts in the Video Recut editor window by combining
video, audio (for secondary soundtracks or voice-overs), photos, graphics (for overlays), text (for titles and captions),
and transitions. You can create Video Recuts for specific promotions or campaigns.
In addition, you can create templates for your Video Recuts. Video Recut Templates allow you to modify contents of
the Video Recut at runtime, enabling targeted and personalized video.
To make your Video Recuts more compelling, you can create pop-up information panels for Video Recuts with
detailed product descriptions and images. The information panel appears when the end user moves the pointer over
the Video Recut screen. An information panel can contain text, images, and URL links.
Quick Start: Video Recuts
The following step-by-step workflow description is designed to get up and running quickly with Video Recuts. After
each step is a cross-reference to a topic heading where you can find more information.
1. Set up Video Presets
Scene7 offers many predefined encoding Video Presets designed specifically for delivering Video Recuts on Adobe
Flash Players in both the Flash and MP4 video format. These predefined presets reflect the most common encoding
settings and have been optimized for playback on target screens. In addition, administrators can create Video Presets
to customize the size and playback experience of Video Recuts to end users.
Administrators can add and manage Video Presets by clicking Setup > Application Setup > Video Presets > Single
Encoding Presets > Add. On the Playback Device drop-down menu, choose Desktop (compatible with Flash 9),
Desktop (compatible with HTML5 OGG), Mobile (iPhone, iPad, Android), or Tablet (iPad, Android). Set or edit the
remaining options as necessary.
See “Video Presets” on page 235.
2. Upload (and transcode) video files
To create Video Recuts, use FLV, F4V, or MP4 files, or transcode other video types to MP4 when you upload the files.
To transcode a file for use as a Video Recut, click Job Options in the Upload screen to open the Job Options dialog box.
Then, under eVideo Options, choose an option.
See “Uploading and transcoding video for Video Recuts” on page 236.
3. Set up Recut Viewer Presets
Recut Viewer Presets determine the look of the viewer and how its playback controls work. Scene7 offers predefined
Recut Viewer Presets for delivering Video Recuts, and you can create your own as well if you are an administrator.
Add and manage Recut Viewer Presets from the Viewer Presets screen. To open this screen, choose Setup > Viewer
Presets.
Last updated 10/9/2014
235
USING SCENE7
Video Recuts
See “Setting up Viewer Presets for Video Recuts” on page 236.
4. Create the Video Recut
Create Video Recuts in the Video Recut window. Drag assets you want to include in the Video Recut into the stage or
timeline. The Video Recut window offers tools for adding image, graphics, audio, backgrounds, borders, captions,
effects, and transitions. You can use sample assets from the Sample eVideo Content panel or add your own assets to
enhance your Video Recuts.
See “Creating Video Recuts” on page 237.
By parameterizing a Video Recut, you can modify it by replacing the content at runtime. You can create templates from
Video Recuts that dynamically update the video, overlays (images, graphics, backgrounds, borders, captions),
soundtracks, effects, and transitions.
See “Create a Video Recut Template” on page 248.
To create pop-up information panels for Video Recuts, create a response template. When the end user moves the
pointer over the Video Recut screen, the information panel appears. It can contain text, images, and URL links.
See “Creating information panels for Video Recuts” on page 249.
5. Preview Video Recuts in a Viewer
To see how a Video Recut plays for end users on your web site, select the video in the Browse Panel. Then click the
Preview button, choose File > Preview, or click the rollover Preview button. The Preview screen opens.
See “Previewing Video Recuts in a Viewer” on page 252.
6. Publish your Video Recut
Publishing a Video Recut places it on Scene7 servers so it can be delivered to your web site. As part of the publishing
process, Scene7 activates the URL string for calling the Video Recut from Scene7 servers to your web site.
Note: Video requires both Image Server and Video Server publishes. You use the Video Server to publish the actual video
asset. And, you use the Image Server to publish related video assets such as the video thumbnail, set information for any
Adaptive Video Set, and the XML file for Video Recuts.
To publish Video Recuts, mark them for publish by selecting the Mark For Publish icon in the Browse Panel. Then
click Start Publish.
See “Publishing a Video Recut” on page 252.
7. Deploy Video Recuts to your web sites
To obtain the URL for a Video Recut, select it in the Browse Panel, click the Preview button, and click Copy URL. After
you click a Copy URL button, the URL is copied to the Clipboard. Place this code in the HTML of your web site.
See “Deploying a Video Recut on your web site” on page 253.
Video Presets
To create Video Recuts, you can use FLV, F4V, or MP4 files, or you can transcode other video types to MP4 when you
upload the files. During the transcoding process, the video is compressed to an optimal size for use as a Video Recut.
Last updated 10/9/2014
236
USING SCENE7
Video Recuts
Scene7 offers a library of predefined encoding presets for Video Recuts that reflect the most common encoding
settings. In addition, administrators can create their own encoding Video Presets to customize the size and playback
quality of Recut Videos to end users.
You can learn more about Video Presets, including how to create them, activate and deactivate them, delete them, and
manage them in the Video Presets screen.
See “Working with video encoding presets” on page 219.
Uploading and transcoding video for Video Recuts
Scene7 offers two options for uploading files for Video Recuts:
Video serving Upload FLV, F4V, or MP4 files directly to Scene7. With this workflow, files are not transcoded at
upload.
Video streaming Upload master/source files and, at upload, transcode these files to MP4 format.
• Make sure the master/source files you want to transcode are supported.
See “Supported video file types for encoding” on page 214.
• Choose an encoding preset when you upload the file. Click the Job Options button in the Upload screen, and in the
Upload Job Options dialog box, display the eVideo Options, and choose a preset. For descriptions of transcoding
options, see “Adaptive Video Encoding (16:9 or 4:3) video presets” on page 28.
More Help topics
“About encoding preset options” on page 27
Thumbnails for Video Recuts
Scene7 generates thumbnails for Video Recuts (as well as encoded videos and pre-encoded videos). You can see these
thumbnails in the Browse panel. To obtain a Video Recut thumbnail, Scene7 uses the first frame of the first video in
the recut. In a Video Recut with more than one video, the first video, first frame is used.
You can obtain Video Recut thumbnail URLs and deploy them outside SPS on websites. Scene7 uses video thumbnails
for poster frames, the initial frame that appears in Video viewers and Video Recut viewers before the video begins
playing. In Flash AS3 Video Recut viewers, you can apply image modifiers to the poster frame.
You can learn more about video thumbnails, obtaining video thumbnail URLs, and modifying poster frames.
See “Working with video thumbnails” on page 228.
Setting up Viewer Presets for Video Recuts
End users watch the Video Recuts you create in a Video Recut Viewer. This viewer determines what the Video Recut
looks like and how its playback controls work. For example, the viewer determines the size, color, video and audio
controls, progress bar, and user-interface skin. You choose a Viewer Preset on the Preview screen. After you choose a
preset, you can click Copy URL to obtain the URL for playing the video using the Viewer Preset you chose.
Last updated 10/9/2014
237
USING SCENE7
Video Recuts
Scene7 comes with many predefined Viewer Presets for playing Video Recuts, and administrators can create custom
presets by choosing from more than a dozen different settings.
Follow these steps to set up a Viewer Preset for showing Video Recuts:
1 Click Setup > Viewer Presets.
The Viewer Presets screen opens. This screen lists Viewer Presets for all types of viewers. To see only presets for
showing Video Recuts, choose Flash AS3 on the Platform menu, and open the Viewers drop-down list and choose
Video Recut Viewer.
You can learn more about activating, filtering, sorting, and previewing Viewer Presets on this screen.
See “Viewer Presets” on page 32.
2 Add or edit a Viewer Preset for showing Video Recuts:
Adding Click Add. In the Add Viewer Preset dialog box, in the Platform drop-down list, click Flash AS3. In the
Viewer drop-down list, click Video Recut Viewer, and then click Add.
Adding by starting from an existing Viewer Preset Select a Video Recut Viewer Preset, and then click Edit. After
you reconfigure the Video Recut Viewer, click Save As to save the preset under a different name.
Editing Select a Video Recut Viewer Preset, and then click Edit.
The Configure Viewer screen appears.
3 Enter (or edit) the preset name.
4 In the Common Settings category, choose a screen size for the Video Recut viewer:
Same as Source Click Same as Source to make the Video Recut Viewer size automatically to the width and height
of the video being previewed.
Custom Size Click Custom Size and enter pixel measurements in the Video Width and Video Height fields to
establish a fixed size for the Video Recut Viewer.
5 Choose options in the Configure Viewer screen.
The preview screen displays the viewer as you update and change settings. To see a description of an option, click
its Info Tip icon .
6 Do one of the following:
• Click Save As if you added a Video Recut Viewer Preset by starting from an existing preset.
• Click Save if you added or edited a Video Recut Viewer Preset.
Creating Video Recuts
Video Recuts are remixes of master video files. You create Video Recuts by using FLV, F4V, or MP4 files and
combining these files with audio, images, graphics, text, and transitions in the Video Recut window. Create Video
Recuts to easily enhance your video to highlight features and targeted promotions.
Users view Video Recuts in a Scene7 Video Recut Viewer, not a Video Viewer (and they must use Flash Player 10 or
later).
Last updated 10/9/2014
238
USING SCENE7
Video Recuts
Assets you can use in Video Recuts
Video Recuts are composed of scenes. Use captions, graphics, visual effects, soundtracks, and other Scene7 assets to
enhance scenes in your Video Recut. Each scene can have six different assets.
Note: Scene7 provides sample assets that you can use in Video Recut, and you can upload your own assets. The sample
assets are available in the Sample eVideo Content panel of the Video Recut window (located, at the bottom of the Asset
Library). To use your own assets, see “Design and tag assets” on page 246 .
Audio Apply a soundtrack to your entire Video Recut. Use the Property Inspector to control the soundtrack volume
in video scenes that contain their own embedded audio.
Background Apply a custom background color to a scene. You can choose from many different colors in the Property
Inspector.
Border Add a graphic overlay that frames a scene as it plays. For example, the Drapes border adds curtains over the
video to give the effect of watching the video in a theater. Borders are not adjustable, and are always the topmost layer.
You can use one border per scene, or apply the same border to all scenes by dragging it to the Global drop zone.
Caption Add a text box that appears onscreen. Scene7 offers different kinds of captions, including bubble captions,
banners, and sticky notes. After you enter text for your caption, choose a font, font size, and font color for the text. If
desired, you can rotate the text. You can use multiple captions per scene, or apply a caption to all scenes by dragging
it to the Global drop zone.
Effect Change the tone or character of a scene. For example, you can blur, lighten, or darken scenes, or add brilliance
or contrast to scenes. Effects apply to entire scenes. After you apply an effect, you can fine-tune it in the Property
Inspector window. You can use multiple effects to obtain your desired result. The effects are stacked as you drag-anddrop them. You can change the order of the effects to apply them on different layers. You can apply an effect to all
scenes by dragging it to the Global drop zone.
Graphic Place a graphic on top of videos or other images by dragging it to the stage or the sceneline. A graphic used
this way is called an overlay. You can use any image as a graphic if you designate it as an overlay. After you place a
graphic on the stage, you can open the Property Inspector window and choose transparency commands, depth level
(z-order), and layer-blending commands for the graphic. You can specify how long the graphic is displayed onscreen
by dragging the image end-time control handle out to as long as 60 seconds (if the overlay is on top of a video, it
appears as long as the video scene). You can use up to six graphics per scene (there is a maximum of six total assets per
scene).
Transition Helps you clearly mark the passage between scenes or ease the transition from one scene to the next. In a
blur transition, for example, the first scene ends in a blur; the next scene begins in a blur and gradually comes into
focus. In the Property Inspector, you can control the duration of transitions as well as make the audio fade in and out
as the transition occurs.
Video Create scenes using uploaded videos that have been encoded with a Scene7 Video preset. You can scrub the
. You can also
video to choose your desired edit point and split the video into two parts using the Scissors button
change the In and Out points of each video to clip a longer video into smaller segments. You can combine multiple
videos into on Video Recut.
Note: You can add a link to any visible asset in your Video Recut. You cannot add links to transitions or video frames.
More Help topics
“Design and tag assets” on page 246
Video Recut window overview
The Video Recut window provides all the tools you need for creating, editing, and previewing a Video Recut.
Last updated 10/9/2014
239
USING SCENE7
Video Recuts
To open the window, click the Build button and choose Video Recuts. Scenes you add to your Video Recut appear on
scene tiles in the sceneline. To add additional assets, display the Add Assets panel on the left side of the window.
A
B
C
D
Video Recut window.
A. Stage B. Sceneline with scene tiles and transition tiles C. Soundtrack drop zone D. Global drop zone
Use the Play
, Rewind
, and Pause
buttons to preview a recut. To move to different parts of a scene
or to different scenes in the recut, drag the playhead . To adjust audio, drag the volume slider or click the Mute
icon .
Note: The volume controls are for playing video in the Video Recut window, not for choosing volume settings. You can
learn more about choosing volume settings for scenes and Video Recuts, see “Adjust volume” on page 243.
The Video Recut window contains the following components.
Stage
Use the stage to create a scene, play a scene, and add or manipulate borders, captions, effects, and overlays in scenes.
Last updated 10/9/2014
240
USING SCENE7
Video Recuts
Sceneline
The sceneline displays one scene tile for each scene in your Video Recut. Use the sceneline to create a scene by dragging
videos or images, add a transition between scenes, change the order of scenes, and play your Video Recut. The timeline
below the sceneline tells you how long your Video Recut is. When you select a scene tile, a portion of the timeline is
filled in. This filled-in portion shows you how much of the video the scene you selected occupies. You can drag the
on the timeline or sceneline to advance or rewind your Video Recut.
Playhead
Soundtrack drop zone
Use the Soundtrack drop zone to choose an audio file to play throughout your Video Recut. Choose an audio file in
the Asset Library and drag it to the Soundtrack drop zone. The audio file loops—it starts from the beginning and
replays after it has finished playing.
See “Adjust volume” on page 243.
Global drop zone
Choose an asset in the Asset Library and drag it to the Global drop zone to apply the asset to every scene in your Video
Recut. For example, to place the same border on every scene, drag a border from the Asset Library to the Global drop
zone. Borders, captions, effects, and graphics can be applied globally to all scenes. Images, videos, and transitions
cannot be applied to the Global drop zone.
Property Inspector
The Property Inspector has various tools for adjusting your scenes. For example, you can control the volume of a scene
or the volume of a soundtrack; or reorder, remove, or adjust the overlays, captions, graphics, and other effects applied
to the scene. You can also use the Property Inspector to add links to scenes, objects, or the entire video. Using the
Property Inspector can be helpful when adjusting an asset or effect that is behind another asset or effect.
To open the Property Inspector, double-click a scene tile or click the Wrench icon
window, click Return To Sceneline
.
. To close the Property Inspector
Property Inspector
You can do any of the following in the Property Inspector:
• Adjust an asset or effects controls. Select an asset or effect from the list on the right to reveal its controls. Its sizing
controls also become available in the video window.
• Add a link and tool tip text to any visible asset in the Video Recut.
Last updated 10/9/2014
241
USING SCENE7
Video Recuts
• Reorder the asset or effects for a scene. Click the Up or Down Arrows next to the selected asset or effect’s icon to
reorder them. Topmost assets and effects in the list are frontmost in the video. The video clip must be at the bottom
of the list.
• Remove an asset. Select it in the list, and then click Trash
.
• Control the video volume and soundtrack volume in a scene. Drag the volume sliders to increase or decrease
volume.
• Add Rollover Key text that appears when a user moves the pointer over the video.
• Parameterize the video, overlay asset, link, tool tip, or rollover key so that you can create a video template.
See “Create a Video Recut Template” on page 248.
Edit Parameter options and dialog box
Use the Edit Parameter dialog box to specify and name the different properties of your Video Recut that you want to
make variable. The Edit Parameter dialog box is accessed through the Property Inspector for the scene containing the
next to their names.
content you want to make variable. Properties that can be made variable have an icon
To open the Edit Parameter dialog box, click the Parameter button
.
See “Create a Video Recut Template” on page 248.
Create and edit Video Recuts
You create a Video Recut by combining video scenes, audio, images, transitions, and other assets. After you create the
initial scene, you can add assets and a soundtrack. A soundtrack is a looping audio file that plays throughout a Video
Recut.
Scene7 includes sample assets in the Sample eVideo Content panel of the Asset Library. However, you can create your
own assets by using Adobe Flash authoring environment, Adobe Photoshop, and Adobe Illustrator.
Important: To use sample eVideo content in Video Recuts, choose Show Sample eVideo Content on the Application
General Settings screen. To open this screen, choose Setup > Application Setup > General Settings.
See “Assets you can use in Video Recuts” on page 238.
See “Asset file types” on page 246.
Create a Video Recut
1 Select a video in the Browse panel, and then click Build and choose Video Recuts.
2 For the Recut Stage size, enter a width and height setting, and then click Apply.
3 In the Video Recut window, drag an FLV file or an image from the Asset Library to the stage or the sceneline.
Dragging an asset to the stage creates a scene at the end of the Video Recut. Dragging an asset to the sceneline
creates the scene at the point in the Video Recut where you drop the asset.
4 To customize the Video Recut, do any of the following:
• To add a colored background scene, select a background from the Asset Library and drag it to the stage or
sceneline. Double-click the scene tile to open the Property Inspector, and select Background. Then click the
and choose a color.
Background Color button
• To add a border, caption, effect, or overlay (an image or graphic), select it in the Asset Library and drag it to the
stage or sceneline. Or, to apply it to all scenes, drag it to the Global drop zone.
Last updated 10/9/2014
242
USING SCENE7
Video Recuts
Note: After you apply these types of assets, you can adjust them in the Property Inspector window. Borders cannot
be adjusted.
• To add a soundtrack, select an audio file in the Asset Library and drag it to the Soundtrack drop zone. You can
use an MP3 file.
• To add a transition, select it in the Asset Library and drag it to a transition tile on the sceneline. Transition tiles
appear between scene tiles on the sceneline.
See “Edit applied assets” on page 244.
Note: Move the pointer over a scene tile to see the name of the video file or image with which it was created.
5 Preview the Video Recut to make sure that it plays as you expect.
6 Click Save.
Open a saved Video Recut for editing
Use these techniques to open a Video Recut for editing:
• Click Edit.
• Double-click the Video Recut in the Browse window. Then, in Detail View, click Edit.
Handle scenes and sounds
The Video Recut window offers controls for handling scenes, sound, changing the length of a scene, splitting a scene,
and removing portions of a scene.
Reorder scenes
❖ Drag scene tiles on the sceneline to change their order.
Scenes are renumbered after you reorder them.
Reorder layers or effects within a scene
❖ In the Property Inspector, click the Up or Down Arrows next to the selected asset or effect’s icon to reorder them.
Topmost assets and effects in the list are frontmost in the video. The video clip must be at the bottom of the list.
You can learn more about changing the depth level (z-order).
See “Change the depth level (z-order) of an overlay or caption” on page 245.
Delete a scene or transition
❖ Select a scene tile or transition tile in the sceneline, and click Trash
.
Add a link
You can add links to visible assets such as images, graphics, and captions. By default, links open in a new browser
window (and always open in a new browser window when previewing), but you can choose to have the link open in
the same window.
1 Do one of the following:
• To apply the link to the entire Video Recut, select an asset in the Global drop zone, and click the Wrench icon
for the asset.
• To apply the link to one scene, select the asset (border, background, caption, or image) within that scene, and
click the Wrench icon
for that asset.
Last updated 10/9/2014
243
USING SCENE7
Video Recuts
2 In the Property Inspector, type the URL for the link in the Link box. Be sure to include the http:// part of the URL.
3 To add a tool tip that appears when the cursor moves over the link in the video, type the text in the Tool Tip box.
4 (Optional) Specify any of the following:
Color Click to choose a color for the tool tip text or tool tip background.
Opacity Drag the slider to specify the level of opacity for the tool tip text.
Open Link In Specify whether the link opens in a new browser window or the same browser window. By default,
the link opens in a new browser window. When previewing in Scene7, the link always opens in a new browser
window, regardless of the option you select.
Size Specify the size of the tool tip text from the list of values.
Adjust volume
In the Video Recut window, you can adjust the volume of a global soundtrack, or the audio included in an individual
scene.
1
Select a scene tile on the sceneline and double-click the scene tile or click its Wrench button
Inspector window opens.
. The Property
2 Do one of the following:
• To adjust the volume for the soundtrack, drag the Soundtrack Volume slider.
• To adjust the volume for the audio in a scene, drag the Video Volume slider.
Note: The volume controls in the lower-left corner of the Video Recut window control the volume level when you play a
video in the Video Recut window. These controls do not affect volume levels in the video itself.
Remove a soundtrack
❖ Click the Soundtrack drop zone to select the audio file, and then click the Trash button
.
Change the length of an image or background scene
❖ Drag the End Point
on the stage timeline.
The stage timeline tells you in seconds how long the scene is. By default, scenes created with images and backgrounds
are 3 seconds long.
Remove or restore a portion of a scene
1 To remove a portion of a scene, do of the following:
• To remove the start of a video scene, drag the start point
on the stage timeline to the right until the entire
segment you want removed turns gray.
• To remove the end of a video scene, drag the end point
on the stage timeline to the left until the entire segment
you want removed turns gray.
• To remove a section from the center of a video scene, split the scene where you want to remove it, and then
remove the beginning or end of one of the split scenes.
2 To restore a removed segment drag the start or end point back over the removed segment (the gray area).
Split a scene
Splitting a scene is necessary if you want to apply assets to different portions of a scene or remove the middle of a scene.
1 In the stage timeline, drag the playhead
to the point at which you want to split the scene.
Last updated 10/9/2014
244
USING SCENE7
Video Recuts
2 Click the Scissors button
.
Two scenes are created, with a segment removed from the end of the first scene and a segment removed from the
start of the second scene.
3 (Optional) To rejoin the video scenes, delete one of them and restore the removed segment in the other scene.
Edit applied assets
You can edit applied captions, overlays, transitions, and effects by using the Property Inspector window. Borders
cannot be edited. You edit transitions as you apply them.
More Help topics
“Design and tag assets” on page 246
Edit an effect
1
Double-click a scene tile or the Global drop zone, or click the Wrench button
to open the Property Inspector.
2 Adjust effect settings as desired. (All effects have different settings.) On the stage, you can see the results of your
option choices.
Edit a transition
❖ Double-click the transition icon and do one of the following:
• Drag the Duration slider to change the length of the transition.
• Select the Fade Audio option to make the audio fade out and in as the transition occurs.
Edit a caption
1 Select the caption on the stage, and enter text for your caption in the caption toolbar that appears.
2 Use the toolbar to choose a font, a font size, and a font color, and to align text.
Note: Fonts are embedded in caption SWF files. For that reason, you can’t choose a font for a caption other than the
fonts that are available on the caption toolbar.
3 Choose transparency and layer-blending settings.
See “Set transparency and layer effects for captions and overlays” on page 245.
4 Resize, reposition, and rotate the caption.
See “Resize, reposition, and rotate captions and overlays” on page 245.
5 Change the depth level (z-order) of the caption.
See “Change the depth level (z-order) of an overlay or caption” on page 245.
Edit an overlay
1
Double-click a scene tile or the Global drop zone, or click the Wrench button
2 Select the name of your overlay.
3 Choose transparency and layer-blending settings.
See “Set transparency and layer effects for captions and overlays” on page 245.
4 Resize, reposition, and rotate the overlay.
Last updated 10/9/2014
to open the Property Inspector.
245
USING SCENE7
Video Recuts
See “Resize, reposition, and rotate captions and overlays” on page 245.
5 Change the depth level (z-order) of the overlay.
See “Change the depth level (z-order) of an overlay or caption” on page 245.
Set transparency and layer effects for captions and overlays
Captions and overlays appear in the forefront of scenes. By default, these assets are 100 percent opaque—they obscure
the assets below them. However, you can choose a transparency setting for these assets as well as a layer-blending
option to make them fit better onscreen.
1 On the stage, select the caption or overlay.
2 Double-click the scene tile or click its Wrench button to open the Property Inspector window. If the caption or
overlay appears in every scene, double-click the Global drop zone to open its Property Inspector window.
3 Choose options for the caption or overlay:
Transparency Drag the slider to choose a setting. At 100 percent, the caption or overlay is completely visible; at 1
percent, it is transparent.
Layer blending Choose an option to define how the caption or overlay blends with the layer below. These options
have different effects depending on the background color and the color and transparency of the caption or overlay.
Move the pointer over an option to see its effect on the stage.
Flip Vertical or Flip Horizontal (Captions only) Select one to flip the caption.
Drop Shadow (Captions only) Select to make the letters cast a faint shadow on the screen.
Resize, reposition, and rotate captions and overlays
1 Select the caption or overlay. Boundaries and selection handles appear.
2 Do any of the following:
• To resize the asset, drag a selection handle at the corner or side of the boundary.
• To reposition the asset, move the pointer over the asset until the cursor changes to a four-headed arrow; then
drag the asset to a new location.
• To rotate the asset, drag the rotation handle.
If the asset you are working with is a global asset—if you placed it in the Global drop zone—the asset is resized,
repositioned, or rotated in all scenes.
Change the depth level (z-order) of an overlay or caption
Overlays and captions can overlap if more than one is in the same scene. Reordering these assets is necessary when
they overlap and you want one asset to appear in front of or behind another.
1 In the sceneline, select the scene tile with the scene that has overlapping assets. Or, if the overlapping assets are
applied globally, select the Global drop zone.
2 Double-click the scene tile (or Global drop zone) or click its Wrench button
. The Property Inspector window
opens. It lists all assets, with the frontmost assets at the top of the list. Arrows appear next to the names of assets
that you can move up or down in the list.
3 Click the Up or Down Arrow to change the z ordering in the list.
Important: Global assets that appear on every scene appear in front of other assets. You cannot move these assets behind
other assets.
Last updated 10/9/2014
246
USING SCENE7
Video Recuts
Remove an asset
You can remove a border, effect, caption, or overlay applied to individual scenes or to all scenes. Assets you place in
the Global drop zone are applied to all scenes.
1 In the sceneline, select the scene containing the asset you want to remove.
2 Select the asset on the stage and click the Trash button
, or drag the asset off the stage.
Note: If you have trouble selecting an asset on the stage, open the Property Inspector window (click the Wrench button
to open), select the asset in the asset list and click the Trash button.
Design and tag assets
Scene7 provides sample audio, backgrounds, borders, captions, effects, graphics, transitions, and video in the Sample
eVideo Content panel of the Asset Library. As well as using these sample assets, you can create your own assets for use
in Video Recuts. You can create your own assets using the Adobe Flash authoring tool, Adobe Photoshop, or Adobe
Illustrator. Publish asset files as Flash 9 or above, ActionScript 3 SWF files.
After you create an asset and upload it to Scene7, tag it as a Video Recut asset. Tagging lets Scene7 recognize it as a
Video Recut asset. (You can’t create an effect or transition on your own; contact Scene7 if you need this capability).
Important: Consider how assets you use in your Video Recut will appear in the viewer that you choose for end users to
watch your video. Most importantly, each asset needs a high enough resolution to display well in the viewer you choose.
Ideally, videos should be the same resolution as the viewer, although they still play if they have a lower resolution. The
aspect ratio of assets should match the viewer you choose.
Asset file types
This table describes asset file types that are used to create Video Recuts.
Asset type
Allowable file type(s)
Audio
MP3
Background
GIF, PNG, SWF
Border
GIF, PNG, SWF (mark as border)
Caption
SWF (mark as caption)
Effect
SWF (use samples from Scene7)
Graphic
GIF, JPG, PNG, SWF (mark SWF files as overlays)
Transition
SWF (use samples from Scene7)
Video
FLV, F4V, MP4
Important: Use Flash Player 9 or above, ActionScript 3 SWF files in Video Recuts. Other types of SWFs are not allowed.
Note: Scene7 provides effect and transition files; you cannot upload these files for use in Video Recuts. Effects and
transitions are available in the Sample eVideo Content panel in the Video Recut window. Contact Scene7 if you want to
design your own effects and transitions.
Last updated 10/9/2014
247
USING SCENE7
Video Recuts
Design and tag a border
You can design borders for your Video Recuts with the Adobe Flash Professional, Adobe Photoshop, Adobe
Illustrator, or Adobe Fireworks®. Scene7 recommends using a SWF file; PNGs and GIFs can show blurriness or
pixelation when they are scaled.
1 Use Adobe Flash Professional, Adobe Photoshop, Adobe Illustrator, or Adobe Fireworks to create a border, and
follow these guidelines:
• Flash Player 9 or above SWF (static or animated), PNG, or GIF file format
• Set SWF files to ActionScript3
• 24 frames per second (fps)
• Do not reference any Document class in a SWF file
2 Create animations in the main timeline only. Do not nest animations within video clips.
If the border doesn’t touch the edges of the stage and you would like that space maintained in the Video Recut,
place a transparent movie clip, the size of your viewer preset, over all layers. Scene7 tries to scale the border to fit
the stage.
3 Upload the border file to Scene7, and open it in Detail view.
4 Open the Metadata panel, open the Recut SWF Type menu, and choose Border.
Design and tag a caption
1 Use Adobe Flash Professional CS3 or later to create captions, and publish them in the Flash Player 9 or above SWF
file format.
Embed the font into the text field on the stage, but specify a character range. Basic Latin is sufficient for captions
in English.
2 Add a dynamic text object to allow for input and display of the caption. In the Properties panel, name the object
inputField. You can set its default font, color, and size in the Properties panel, as well as add additional graphics.
3 Upload the caption to Scene7, and open it in Detail view.
4 Open the Metadata panel, open the Recut SWF Type menu, and choose Flash Caption.
Design and tag an overlay graphic
Use vector graphics to create an overlay to achieve better image quality when scaling. If you’re using bitmap images,
Adobe recommends using PNG files because they produce better transparency, but you can also use JPG and GIF files
for overlays.
1 Use a vector graphics application such as Adobe Flash Professional to create overlays, and follow these guidelines:
• Flash Player 9 or above SWF, JPG, GIF, or PNG file with a transparent canvas (PNG is recommended because
they produce better transparency).
• 24 frames per second.
• You cannot reference any Document class in a SWF file.
• Create animations in the main timeline. Do not nest animations within video clips.
2 Upload the graphic file to Scene7, and open it in Detail view.
3 Open the Metadata panel, open the Recut SWF Type menu, and choose Overlay.
Last updated 10/9/2014
248
USING SCENE7
Video Recuts
Create a Video Recut Template
Video Recut Templates let you create a single recut, and then modify it as desired by replacing the content at runtime.
You can create templates from Video Recuts that dynamically update the overlays, soundtracks, transitions, and even
the video itself.
As with Basic Templates and FXG Templates, in Video Recut Templates, you create parameters for the properties you
want to make variable. You can create parameters for the URL of content, hotspot tool tips and links, rollover key, and
caption text. Creating parameters for the URL of content lets you substitute a different video, image, soundtrack, or
overlay. Creating a parameter to change the URL for a video or image, changes all the instances of that video or image
in the Video Recut. When you replace content that differs in length, the timeframe in the template changes to match
the new content.
You can use the same parameter name for the text in different assets, such as captions, in your Video Recut, to change
the text in all instances at the same time.
Create variable properties
1 Double-click the scene tile, or click the Wrench button
for the scene containing the property you want to make
variable. If the property is global, click the Wrench button in the Global drop zone.
2 In the Property Inspector, click the Parameter button
next to the property.
The Edit Parameter dialog box opens, displaying the default parameter name and value.
3 Click OK to accept the default parameter name, or type a new name in the box, and then click Apply.
Note: Properties are not variable by default. Open the Edit Parameter dialog box and click Apply for any property you
want to make variable.
Remove parameterization from a property
1 In the Property Inspector, click the Parameter button
next to the property.
2 In the Edit Parameter dialog box, click Remove.
Substitute content in variable properties
After you’ve parameterized properties for a Video Recut, you can substitute values for variable properties while
previewing it.
1 In the Video Recut window, click Preview.
The Recut appears in the Preview window, with the variable names and values in a panel along the left side of the
window.
2 To change a variable value, type a new value in the variable’s box or click the Browse button to choose an asset.
The variable value or asset is replaced and appears in the preview.
3 Click Close to return to the Video Recut window.
Last updated 10/9/2014
249
USING SCENE7
Video Recuts
Creating information panels for Video Recuts
You can create information panels for Video Recuts. When the end user moves the pointer over the overlay, the
information panel appears. It can contain text, images, and URL links. Information panels are an excellent way to add
value to your Video Recuts, make them interactive, and make them more compelling.
To create an information panel for a Video Recut, follow these basic steps:
1 Enter rollover key identifiers: In the Video Recut window, open the Property Inspector for an overlay and enter an
identifier name in the Rollover Key field. This identifier name is used to plug in content for the information panel.
See “Enter rollover key identifiers” on page 249.
2 Write the code for the response template: The response template formats the information panel in the Video Recut;
it also provides placeholders for content — for the text, images, and URLs that appear in the panel.
See “Write the code for the response template” on page 250.
3 Create the response template in a Video Recut Viewer Preset: Create or edit a Video Recut Viewer Preset, and in
the Configure Viewer screen, activate the information panel and enter the response template code.
See “Create the response template in a Video Recut Viewer Preset” on page 250.
4 Create a TXT or UTF-16 file: This file lists identifier names from Rollover Key fields in your Video Recuts (the
identifiers you entered in step 1). For each identifier name, the file provides the HTML and XML code that
describes how to fill the placeholders in the response template.
See “Create a TXT or UTF-16 file with information panel content” on page 250.
5 Upload the TXT or UTF-16 file: Upload the file to the Scene7 Publishing System. Uploading the file data makes it
available to the response template.
See “Upload the TXT or UTF-16 file” on page 251.
6 Publish the information panel: Activate a Video Recut’s information panel by publishing it to the Scene7 Publishing
System. In Detail view, open the InfoPanel Setup panel, and click the Publish button.
See “Publish the information panel” on page 251.
You can maintain a master TXT or UTF-16 file with content for all the information panels in your Video Recuts. To
update the content in information panels, you can change the code in the TXT or UTF-16 file and re-import the file.
In this way, you can update information panels for all your Video Recuts from one central location. As your needs
change, you can continue to communicate effectively with your customers in information panels.
Enter rollover key identifiers
On the Video Recut screen, the Property Inspector provides a Rollover Key field for entering identifiers for use in
making information panels. Entering an identifier in this field allows you to associate an asset overlay with code in a
TXT or UTF-16 file. This code, in turn, provides content to the information panel.
Follow these steps in the Video Recut screen to enter an identifier for use in an information panel:
1 Select the scene that you want to have an information panel.
2 Double-click the scene tile or click the Wrench button
to open the Property Inspector.
3 Click the overlay asset to associate it with an information panel. You can use any visible asset overlay, including
images, graphics, and captions.
4 In the Rollover Key field, enter an identifier name. Do not include blank spaces in the name.
Last updated 10/9/2014
250
USING SCENE7
Video Recuts
5 Click the Save button.
Repeat these steps for each overlay asset in the Video Recut that you want to have an information panel.
Write the code for the response template
The response template code formats the information panel and provides placeholders for entering content.
The response template can be divided into two parts: variable default values and response format. The variable defaults
are used in case the rollover key does not have a value. Variable values are demarcated as $1$,$2$,$3$,…. Following
is the syntax used in response template code:
<info><var name='1'></var> <var name='2'></var> <var name='3'>CompanyName/ImageID</var> <var
name='4'></var><![CDATA[<b>Var 1</b> = $1$<br><b>Var 2</b> = $2$<br><b>Var 3<b> =
$3$<br><b>Var 4</b> = $4$]]></info>
This URL is demarcated as follows:
$1$
<info><var name='1'></var> <var
<br><b>Var 2</b> =
name='2'></var> <var
name='3'>CompanyName/ImageID</var> <var
name='4'></var><![CDATA[<b>Var 1</b> =
$2$
$3$
$4$
<br><b>Var 3<b> =
<br><b>Var 4</b> =
]]></info>
Create the response template in a Video Recut Viewer Preset
As a best practice, create a Video Recut Viewer Preset for each Video Recut that has an information panel, and enter
the response template in the preset.
Follow these steps to create the response template in the Viewer Presets screen:
1 Click Setup > Viewer Presets.
2 Add or edit a Video Recut Viewer:
Adding Click Add to add a Video Recut Viewer. In the Add Viewer Preset dialog box, choose a platform, choose
Video Recut Viewer, and then click Add.
Editing Select a Video Recut Viewer, and then click Edit.
3 Select Info Panel Settings.
4 For the Use Information Server setting, select On.
Note: After you click On, a URL appears in the Information Server URL field. Do not change the information server URL.
5 In the Response Template box, enter or paste the response template code.
6 Choose or enter settings to define the border of the information panel. You can click the Info Tip
button for
setting explanations.
7 Click the Save button (or enter a preset name and click Save As if you are editing a Video Recut Viewer Preset).
Create a TXT or UTF-16 file with information panel content
Using Microsoft Excel®, create a spreadsheet with rollover key identifier names in the first column, and to the right of
each name, the variable content that is plugged into the response template. Variable content is mapped to the
$1$,$2$,$3$,… demarcations in the response template.
See “Write the code for the response template” on page 250.
Last updated 10/9/2014
251
USING SCENE7
Video Recuts
This table demonstrates what the spreadsheet looks like when it is formatted correctly. In this example, variable 1 is
the descriptive text; variable 2 is the image thumbnail; and variable 3 is the link URL for the information panel. The
data in each row indicates what will be displayed in the information panel associated with the rollover key.
Rollover key
identifier
$1$
kitchenInfo
Offered in a variety of colors including Pearl Company/p34915z
Metallic and Nickel Pearl, which complement
our Pro Line Series of Appliances
$2$
$3$
<a href="http://bit.ly/9nKA2X">Details ></a>
After you enter the data, save it as a TXT file (Windows® users) or UTF-16 file (Mac® users) in Excel by following these
steps:
1 Click File > Save As.
2 On the Save As Type menu, choose TXT (tab delimited) or UTF-16.
3 Click Save.
Upload the TXT or UTF-16 file
Scene7 gets variable data for information panels from TXT and UTF-16 files. This data is plugged into the response
template. Follow these steps to upload the TXT or UTF-16 file data to the Scene7 Publishing System:
1 Double-click the Video Recut to open it in Detail View.
2 Select the InfoPanel Setup panel.
3 Click Upload, and in the S7 Info Upload dialog box, click Browse and select your TXT or UTF-16 file, and click Open.
4 Click Upload.
Publish the information panel
Activate a Video Recut’s information panel by publishing it to the Scene7 Publishing System. After you publish,
viewers can see the information panel when they play the Video Recut.
Note: Before publishing the information panel, upload the TXT or UTF-16 file with identifier names from Rollover Key
fields. For more information, see “Upload the TXT or UTF-16 file” on page 251.
Follow these steps to publish an information panel:
1 Double-click the Video Recut to open it in Detail view.
2 Select the InfoPanel Setup panel.
3 In Response TTL box, enter the number of hours you want to wait before caching the data:
• Set a lower number if the data is updated frequently throughout a day.
• Set a higher number if the data is relatively stable and doesn’t require updating frequently throughout the day.
The default is ten hours.
4 Click Publish.
Last updated 10/9/2014
252
USING SCENE7
Video Recuts
Previewing Video Recuts in a Viewer
You can use Viewer List to see how an asset appears on particular viewer type platform such as HTML5. Depending
on the asset type and associated viewer that you have selected to preview, not all platforms are available in Viewer List.
See “Configuring Default Viewers” on page 47.
See “Previewing an asset” on page 102.
1 In the Asset Library panel on the left side, in the Show drop-down list, select the Video Recut asset type.
2 In the Asset Library panel on the left side, navigate the Asset folders that contain the Video Recut assets that you
want to preview with a viewer.
3 Do one of the following:
• Above the Assets window, on the right side of the toolbar, click Grid View. In the Asset window, below the
thumbnail image, click Preview > Viewer List.
• Above the Assets window, on the right side of the toolbar, click List View. In the Asset window, select an asset,
and then to the right of the thumbnail image, click Preview > Viewer List.
• Above the Assets window, on the right side of the toolbar, click Detail View. On the same toolbar, click Preview
> Viewer List.
4 In the Viewer List window, in the table, click a viewer link to preview the asset in the selected viewer.
5 Close the displayed viewer to return to the Viewer List screen.
6 In the lower-right corner of the Viewer List window, click Close to return to the Assets screen.
Publishing a Video Recut
Publishing a Video Recut enables Scene7 servers to deliver it to your web site or application.
Note: Video Recuts require that you publish to Video Server and also to Image Server. You use Video Server to publish
the actual videos that you marked for publishing. And, you use Image Server to publish related assets, such as the video
thumbnails, set information for any Adaptive Video Set, and the XML file for Video Recuts.
After you publish a Video Recut, the Scene7 Publishing System activates the URL strings for your HTML page or
application code.
To publish a Video Recut
1 Do one of the following:
• In the Browse Panel, click Mark For Publish
• In the Upload screen, click Mark For Publish
next to each filename that you want to publish.
next to each filename that you want to publish.
2 On the Global Navigation bar, click Publish.
3 Set the scheduling options you want.
4 (Optional) In the Job Name field, type a name for the publish job.
5 In Advanced options, in the Publish To drop-down list, select Video Server.
See “Advanced publish options” on page 89 for additional options you can set.
6 Click Submit Publish.
Last updated 10/9/2014
253
USING SCENE7
Video Recuts
7 Repeat steps 2- 4 above.
8 In Advanced, in the Publish To drop-down list, select Image Server.
See “Advanced publish options” on page 89 for additional options you can set.
9 Click Submit Publish.
More Help topics
“Publishing files” on page 87
Deploying a Video Recut on your web site
Web sites and applications access Scene7 server content, including Video Recuts, by using URL strings or embedded
code. Scene7 activates these URL strings during the publishing process. To place the URL string or embed code for
your Video Recut in your web pages and applications, copy it from the Scene7 Publishing System.
Note: The URL is not active until you publish the asset.
Copying a Video Recut URL
1 In the Asset Browse panel, in the Show drop-down list, click Video Recut.
2 in the Asset Library panel on the left side, navigate to the asset folder that contains the Video Recut whose embed
code you want to copy.
3 Above the Asset Browse panel, on the right side of the toolbar, do one of the following:
• Click Grid View. In the Asset Browse panel, double-click a single asset to open it in Detail View. In the URLs
and Embed Code panel on the right, click Copy URL to the right of the viewer you want.
• Click Grid View. In the Asset Browse panel, select a single asset, and then below the thumbnail image, click
Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Copy URL.
• Click List View. In the Asset Browse panel, select a single asset, and then to the right of the thumbnail image,
click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Copy URL.
• Click Grid View, List View, or Detail View. On the same toolbar, click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Copy URL.
Adding a Video Recut to your web page or application
Deploy Video Recuts by using a dynamic page (ASP or JSP) that displays the video in a Scene7 Video Recut Viewer.
The URL call to the Scene7 platform follows the same protocol. The player serves a video that your web team can
upload to the Scene7 Publishing System for publishing to a Scene7 video server.
Copying the embed code of a Video Recut viewer
Using the Embed Code feature lets you review the viewer code for the selected Video Recut. You can also copy the code
to the clipboard so you can paste it in your web pages for deployment of the viewer. Editing of the code is not permitted
in the Embed Code dialog box.
Last updated 10/9/2014
254
USING SCENE7
Video Recuts
To copy the embed code of a Video Recut viewer
1 In the Asset Browse panel, in the Show drop-down list, click Video Recut.
2 in the Asset Library panel on the left side, navigate to the asset folder that contains the Video Recut whose embed
code you want to copy.
3 Above the Asset Browse panel, on the right side of the toolbar, do one of the following:
• Click Grid View. In the Asset Browse panel, double-click a single asset to open it in Detail View. In the URLs
and Embed Code panel on the right, click Embed Code to the right of the viewer you want.
• Click Grid View. In the Asset Browse panel, select a single asset, and then below the thumbnail image, click
Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Embed Code.
• Click List View. In the Asset Browse panel, select a single asset, and then to the right of the thumbnail image,
click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Embed Code.
• Click Grid View, List View, or Detail View. On the same toolbar, click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Embed Code.
4 In the Embed Code dialog box, click Copy to Clipboard.
Editing the code is not permitted in the Embed Code dialog box.
5 Click Close.
Last updated 10/9/2014
255
Chapter 17: Mixed Media Sets
Scene7 Mixed Media Sets give users an integrated viewing experience. Mixed Media Sets can include images, Image
Sets, Swatch Sets, Spin Sets, and videos. Users can click different tabs within the Mixed Media Viewer to see the items
in the different viewers. If no tabs are specified, all assets are displayed together in the swatch row.
Mixed Media Set Viewer Presets include community options for end users to embed code, copy URLs, and link to the
main web site. Users can use these options to share information about products on their personal web sites or social
networking sites.
Quick Start: Mixed Media Sets
This Mixed Media Sets Quick Start is designed to get up and running quickly with Mixed Media Set techniques in
Scene7.
1. Uploading the images, swatch files, and videos
Start by uploading the images, swatch files, and videos for your Mixed Media Sets. Because users can zoom on images
in the Mixed Media Set Viewer, take zooming into account when you choose images. Make sure that the images are
least 2000 pixels in the largest dimension.
Click Upload on the Global Navigation bar to upload files from your computer to a folder on the Scene7 Publishing
System.
See “Uploading your files” on page 83.
2. Creating media sets for use within the Mixed Media Set
You can add images, Image Sets, Swatch Sets, Spin Sets, and videos to your Mixed Media set. Prepare the media sets
before you add them to the Mixed Media Set.
See “Creating an Image Set” on page 152, “Creating a Swatch Set” on page 161, and “Creating a Spin Set” on page 168.
3. Creating a Mixed Media Set
Click the Build button and choose Mixed Media Sets. Drag the images, Swatch Sets, Image Sets, and videos onto the
Mixed Media Set screen. To add a soundtrack, drag an audio file to the Soundtrack box.
See “Creating a Mixed Media Set” on page 256.
4. Setting up Mixed Media viewer presets
Scene7 comes with default viewer presets for Mixed Media Sets. Administrators can create or modify Mixed Media Set
viewer presets.
When setting up a Mixed Media Set viewer preset, add the viewer presets for all of the other assets in your set. For
example, if your Mixed Media Set includes videos, add a video viewer preset to the Mixed Media Set viewer preset. You
can also add a soundtrack to the viewer. This soundtrack plays while the viewer is open, but does not play when a video
is active.
See “Setting up a Mixed Media Set Viewer Preset” on page 258 and “Adding and editing Viewer presets” on page 38.
Last updated 10/9/2014
256
USING SCENE7
Mixed Media Sets
5. Previewing a Mixed Media Set
Click the Mixed Media Set’s rollover Preview button. The Mixed Media Set appears. You can click the thumbnail and
swatch icons to examine your Mixed Media Set in the Mixed Media Set Viewer. You can choose different Viewers from
the Presets menus.
See “Previewing an asset” on page 102.
6. Publishing a Mixed Media Set
Publishing an Mixed Media Set places it on Scene7 servers and activates the URL string.
Mixed Media Sets require that you publish to Video Server and also to Image Server. You use Video Server to publish
the actual videos that you marked for publishing. And, you use Image Server to publish related assets, such as the video
thumbnails, set information for any Adaptive Video Set, and the XML file for Video Recuts.
See “Publishing a Mixed Media Set” on page 260.
7. Linking a Mixed Media Set to a web page
Scene7 activates URL calls for Mixed Media Sets after you publish them. You can copy these URLs from the Preview
screen.
Select the Mixed Media Set, and click Preview. In the Preview screen, select a Mixed Media Set Viewer Preset and click
the Copy URL button. See “Linking a Mixed Media Set to a web page” on page 260.
Creating a Mixed Media Set
Create a Mixed Media Set when you want to combine multiple types of viewers in one presentation. Make sure your
files, Image Sets, Swatch Sets, and Spin Sets are ready to publish before you add them to the Mixed Media Set.
A
B
C
D
Viewing a Mixed Media Set.
A. Image Set B. Spin Set C. Swatch Set D. Videos
Last updated 10/9/2014
257
USING SCENE7
Mixed Media Sets
Create a Mixed Media Set
When you create a set, the Publish after save option affects the set and set members in the following ways:
“Publish after save” option selected
before saving?
State of set after saving
State of set members after saving
Yes
Published
Published
No
Unpublished
Set members retain their published or
unpublished state.
See also “Manually publishing assets” on page 89 and “Manually unpublishing assets” on page 89.
To create a Mixed Media Set
1 Click Build > Mixed Media Sets.
2 Drag the videos, Image Sets, Spin Sets, and swatches from the Asset Library to the Mixed Media Set screen.
Note: Mixed Media Sets do not support assets with filenames that contain any of the following characters: ( ) { }.
3 Do any of the following:
• To add a soundtrack, drag an audio file from the Asset Library to the Soundtrack box. The soundtrack plays
while images are displayed. It stops when video is played.
• To change the order of sets, drag them to new locations on the Mixed Media Set screen. The order of sets on the
screen determines the left-to-right order in which users see sets in the Mixed Media Set Viewer.
• (Optional) To add a custom thumbnail to represent a video in the Viewer, drag an image file from the Asset
Library to the Thumbnail placeholder box.
4 Near the lower-right corner of the page, ensure that Publish after save is selected (default).
5 Click Save, select a folder for storing your Mixed Media Set, enter a name for the set, and click Save.
Click Preview to see what your combo Image Set looks like in an Image Set Viewer.
Edit a Mixed Media Set
You can edit a Mixed Media Set. If you want to edit a set within a Mixed Media Set, open that set separately, edit it,
and save it. The edits appear in the Mixed Media set.
Depending on whether you edit a published or an unpublished set, the Publish after save option affects the set and set
members in the following ways:
Set already
published?
“Publish after save”
option selected before
saving your edit?
State of set after saving
State of set members after saving
Yes
Yes
Published
Published
Last updated 10/9/2014
258
USING SCENE7
Mixed Media Sets
Set already
published?
“Publish after save”
option selected before
saving your edit?
State of set after saving
State of set members after saving
Yes
No
Published
Existing set members retain their
published state.
Any new set members that you added
during your edit retain their published
or unpublished state.
No
Yes
Published
Published
No
No
Unpublished
Existing set members and any new set
members that you added during your
edit retain their published or
unpublished state.
See also “Manually publishing assets” on page 89 and “Manually unpublishing assets” on page 89.
To edit a Mixed Media Set
1 Click the Mixed Media Set’s rollover Edit button.
2 Do any of the following:
• To remove items, select them and click Delete.
• To reorder items, drag them to new locations.
3 When you are finished editing the set, near the lower-right corner of the page, ensure that Publish after save is
selected (default).
4 Click Save or Save As.
Deleting a Mixed Media Set
When you delete a set, the set itself is moved to the Trash. However, the members (or “children”) within that set are
not affected; instead, they each retain their existing published or unpublished state.
See also “Manually publishing assets” on page 89 and “Manually unpublishing assets” on page 89.
To delete a Mixed Media Set
1
In the Grid View, List View, or Details View, select one or more Mixed Media Sets.
2 On the Global Navigation Bar, click File > Delete > Delete.
Setting up a Mixed Media Set Viewer Preset
Mixed Media Set Viewer Presets determine the style, behavior, and look of your main viewer. When configuring a
preset, you specify which other viewers you want to appear inside the Mixed Media Viewer. For example, if you’ve
included an Image Set in your Mixed Media Set, specify an Image Set Viewer Preset for the Mixed Media Set Viewer.
Last updated 10/9/2014
259
USING SCENE7
Mixed Media Sets
You can choose to include all or some community features in the Mixed Media Set Viewer. The Embed feature adds a
link to the viewer that lets users copy the code required to display the viewer in an external page (such as a blog, web
site, or social networking site). The Link feature provides the URL to the viewer, so users can link back to this viewer.
The Visit feature provides a link to the web site you specify.
1 Click Setup > Viewer Presets.
The Viewer Presets window opens.
2 Do one of the following:
• To create a new preset, click Add. In the Add Viewer Preset dialog box, choose a platform, choose Mixed Media
Set Viewer, and click Add.
• To edit a Mixed Media Set Viewer preset, select it and click Edit.
The Configure Viewer screen opens.
3 Type a name in the Preset Name box for the Mixed Media Set Viewer preset.
4 Specify Tabs or No Tabs. Tabs separate items by type, such as videos, swatches, and spin sets. When you specify no
tabs, all items appear in a row under the preview window.
5 In the Name box, type a name for the viewer you want to add.
For example, if you’re adding a Swatch Set to your Mixed Media Set, type Swatch Set A.
6 From the Viewer menu, choose the type of asset you want to view, such as Swatch Sets.
7 From the Preset menu, choose a preset for the chosen asset type.
For example, if you’re adding a Swatch Set, choose SwatchSet1-Colors.
8 Click Add.
The new Viewer preset appears in the list.
9 Repeat steps 6 - 9 for all the Viewer presets you want to add.
10 To edit the preset list, do any of the following:
• To delete a preset from the list, select it and click Delete.
• To reorder presets in the list, select a preset and click the blue Up or Down arrow.
11 To add community features (Embed, Link, Visit) to the viewer, specify options for any of the following:
Email Click On to enable an Email button in the viewer. When users click the Email button while viewing the set,
an email containing the link to the set opens.
Embed Click Live. In the Embed Button Label box, type the name you want displayed in the viewer for the Embed
Button. If desired, click Browse to locate and select a custom skin for the button.
Link Click Live. In the Link Button Label box, type the name you want displayed in the viewer for the Link Button.
If desired, click Browse to locate and select a custom skin for the button.
Visit Click Live. In the Visit Button Label box, type the name you want displayed in the viewer for the Visit Button.
In the Visit URL box, type the URL to the web site that you want to open when the link is clicked.
12 Specify other options as desired. To see a description of an option, click the Info Tip icon
The preview screen displays the viewer as you update and change settings.
13 Click Save.
Last updated 10/9/2014
adjacent to the option.
260
USING SCENE7
Mixed Media Sets
More Help topics
“Adding and editing Viewer presets” on page 38
Publishing a Mixed Media Set
Create a publish job to publish an Mixed Media Set that you have marked for publish to Scene7 Video Server and
Image Server. Scene7 offers advanced publishing options for publishing to specific servers and options for
republishing assets that have already been published.
Note: Mixed Media Sets require that you publish to Video Server and also to Image Server. You use Video Server to
publish the actual videos that you marked for publishing. And, you use Image Server to publish related assets, such as
the video thumbnails, set information for any Adaptive Video Set, and the XML file for Video Recuts.
Scene7 Publishing System tracks publish jobs on the Jobs screen.
See “Publishing files” on page 87.
To publish a Mixed Media Set
1 Do one of the following:
• In the Browse Panel, click Mark For Publish
• In the Upload screen, click Mark For Publish
next to each filename that you want to publish.
next to each filename that you want to publish.
2 On the Global Navigation bar, click Publish.
3 Set the scheduling options you want.
4 (Optional) In the Job Name field, type a name for the publish job.
5 In Advanced options, in the Publish To drop-down list, select Video Server.
See “Advanced publish options” on page 89 for additional options you can set.
6 Click Submit Publish.
7 Repeat steps 2- 4 above.
8 In Advanced, in the Publish To drop-down list, select Image Server.
See “Advanced publish options” on page 89 for additional options you can set.
9 Click Submit Publish.
Linking a Mixed Media Set to a web page
After you publish a Mixed Media Set, you can obtain its URL for use in your web site or application. Then you can
deploy the URL as necessary so users can view the Mixed Media Set on your web site or application.
More Help topics
“Publishing files” on page 87
Last updated 10/9/2014
261
USING SCENE7
Mixed Media Sets
Obtain a Mixed Media Set URL
1 In the Asset Browse panel, in the Show drop-down list, click Media Set.
2 in the Asset Library panel on the left side, navigate to the asset folder that contains the media set whose embed code
you want to copy.
3 Above the Asset Browse panel, on the right side of the toolbar, do one of the following:
• Click Grid View. In the Asset Browse panel, double-click a single asset to open it in Detail View. In the URLs
and Embed Code panel on the right, click Copy URL to the right of the viewer you want.
• Click Grid View. In the Asset Browse panel, select a single asset, and then below the thumbnail image, click
Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Copy URL.
• Click List View. In the Asset Browse panel, select a single asset, and then to the right of the thumbnail image,
click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Copy URL.
• Click Grid View, List View, or Detail View. On the same toolbar, click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Copy URL.
Add Mixed Media Set URLs to your web page
The most common way to deploy Mixed Media Sets is to place a link (via a navigation icon) on your web page. When
clicked, the link launches a dynamic page (ASP or JSP) that displays the Mixed Media Set in Mixed Media Set Viewer.
Copying the embed code of a Mixed Media Set viewer
Using the Embed Code feature lets you review the viewer code for the selected Mixed Media Set. You can also copy the
code to the clipboard so you can paste it in your web pages for deployment of the viewer. Editing of the code is not
permitted in the Embed Code dialog box.
To copy the embed code of a Mixed Media Set viewer
1 In the Asset Browse panel, in the Show drop-down list, click Mixed Media Set.
2 in the Asset Library panel on the left side, navigate to the asset folder that contains the Mixed Media Set whose
embed code you want to copy.
3 Above the Asset Browse panel, on the right side of the toolbar, do one of the following:
• Click Grid View. In the Asset Browse panel, double-click a single asset to open it in Detail View. In the URLs
and Embed Code panel on the right, click Embed Code to the right of the viewer you want.
• Click Grid View. In the Asset Browse panel, select a single asset, and then below the thumbnail image, click
Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Embed Code.
• Click List View. In the Asset Browse panel, select a single asset, and then to the right of the thumbnail image,
click Preview > Viewer List.
In the Viewer List page, under the Actions column of the table, click Embed Code.
• Click Grid View, List View, or Detail View. On the same toolbar, click Preview > Viewer List.
Last updated 10/9/2014
262
USING SCENE7
Mixed Media Sets
In the Viewer List page, under the Actions column of the table, click Embed Code.
4 In the Embed Code dialog box, click Copy to Clipboard.
Editing the code is not permitted in the Embed Code dialog box.
5 Click Close.
Last updated 10/9/2014
263
Chapter 18: Adobe Analytics
Instrumentation Kit
Adobe Analytics is the industry-leading product that provides marketers with one place where they can measure,
analyze, and optimize integrated data from all online initiatives across multiple marketing channels.
After integrating Adobe Analytics with the Scene7 Publishing System, you can get reports about the behavior of
website visitors using Scene7 viewers on your website. For example, when a website visitor clicks a zoom target in a
Scene7 Zoom Viewer, Adobe Analytics records this action. Adobe Analytics reports can gather cumulative
information about user activity in Scene7 viewers.
Using Adobe Analytics reports, you can get a clear picture of the activity of customers on your website. You can
determine which product presentations lead to conversion and which do not draw customer interest.
See also Measuring Video in Adobe Analytics.
Note: A valid Adobe Analytics account is required to integrate Analytics with the Scene7 Publishing System and generate
Analytics reports.
Enabling Adobe Analytics Video Reports
Using Adobe Analytics heartbeat-based video reporting, you no longer need to enable the four video viewer events
(Play, Pause, Stop, Milestone) when you configure Adobe Analytics in Scene7. Video Heartbeat works with out-of-thebox Scene7 HTML5 Video and MixedMedia viewers. The video player generates tracking data for viewing within
Adobe Analytics Video Reports.
• The integration of Adobe Analytics video reports with Scene7 supports solution variables, but not custom variables.
See Configure Analytics Video Reporting for more information about solution variables and custom variables.
• Out-of-the-box segments of one minute increments is supported. However, custom segment reporting, such as
customer-defined milestones based on time increments, % milestone, or offset milestones, is not supported.
For more information about Video Heartbeat requirements and setup, see Measuring Video in Adobe Analytics using
Video Heartbeat.
If you are customizing your own viewer and want to use Video Heartbeat, see Enabling Adobe Analytics Video Reports
in the Adobe Scene7 HTML5 Viewer SDK available for download through Adobe Developer Connection at
www.adobe.com/go/learn/learn_s7_devresources_en.
Note: If your licensed solution of Adobe Analytics does not include Video Heartbeat, you will need to continue using the
steps described in this chapter to assign Adobe Analytics variables to Scene7 viewer events and variables.
Quick Start: Integrating Scene7 and Adobe Analytics
This Quick Start is designed to get you up and running quickly with Adobe Analytics Instrumentation Kit.
Last updated 10/9/2014
264
USING SCENE7
Adobe Analytics Instrumentation Kit
1. Log in to Adobe Analytics by way of Scene7 and download Adobe Analytics report variables
Note: Before you can configure Adobe Analytics reports and match Adobe Analytics report variables to Scene7 events,
verify that you are added as a member of the Web Service Access group in Adobe Analytics. Members in this group can
access all reports in the specified report suites by way of the Marketing Cloud’s Web Services API regardless of the
permissions set in the interface. To add a member to the group, in Adobe Analytics, click Admin Tools > User
Management > Edit Groups.
After you have verified that you are a member of the Web Service Access group, in Scene7, click Setup > Application
Setup > Adobe Analytics. On the Adobe Analytics Configuration page, click Adobe Analytics Login.
See “Log in to Adobe Analytics” on page 265.
In the Adobe Analytics Login dialog box, type your credentials and then click Login. On the Report Suite drop-down
menu, select the name of the report suite that you want to use.
2. Assign Adobe Analytics report variables to Scene7 viewer events and Scene7 variables
On the Adobe Analytics Configuration page, specify the information you want in Adobe Analytics reports. For each
Scene7 viewer event that you want information about, choose an Adobe Analytics variable (from your report suite)
and a Scene7 variable.
• Viewer events describe the user activity that you want to measure in reports.
• Scene7 variables describe the data about user events that you want the reports to deliver.
The Adobe Analytics Configuration also offers tools for activating, editing, and deleting viewer events.
After you click Save in the Adobe Analytics Configuration screen, customized tracking code for measuring user
activity is inserted in Scene7 viewers. This functionality lets you track user activity in Adobe Analytics reports.
See “Configuring Adobe Analytics reports” on page 265.
3. Publish your Scene7 viewers
Publish your Scene7 viewers so that the viewers (with code for tracking user activity in Adobe Analytics reports) are
loaded on Scene7 servers. After you publish, this information is included in viewers and can be used for analyses by
Adobe Analytics.
See “Publishing Adobe Analytics configuration information” on page 269.
4. Place Scene7 viewers in your website
Place the Scene7 viewers with Adobe Analytics tracking code on your website.
5. Test the Adobe Analytics integration by viewing an Adobe Analytics report
To view Adobe Analytics reports, go to the Adobe Analytics website. The Reporting page lets you view data and
generate graphs and charts to measure user activity with different viewers.
See “Testing the integration by viewing an Adobe Analytics report” on page 270.
Last updated 10/9/2014
265
USING SCENE7
Adobe Analytics Instrumentation Kit
Log in to Adobe Analytics
Before you log in to configure Adobe Analytics reports and match Adobe Analytics report variables to Scene7 events,
verify that you are added as a member of the Web Service Access group in Adobe Analytics. Members in this group
can access all reports in the specified report suites by way of the Marketing Cloud’s Web Services API regardless of the
permissions set in the interface. To add a member to the group, in Adobe Analytics, click Admin Tools > User
Management > Edit Groups.
To log in to Adobe Analytics
1 Click Setup > Application Setup.
2 In the left pane, under Application Setup, click Adobe Analytics.
3 In the Adobe Analytics Configuration screen, click Adobe Analytics Login.
4 In the Login dialog box, enter your company name, user name, and password.
5 Click Login.
6 Choose a report suite, then click OK.
Note: The first time you log in to Adobe Analytics, the Report Suite drop-down list is blank. You do not choose a report
suite the first time you log in. After you log in for the first time, log out, and then return to the Adobe Analytics screen.
Log in again to be able to choose a report suite.
More Help topics
“Configuring Adobe Analytics reports” on page 265
Configuring Adobe Analytics reports
To tell Adobe Analytics what information you want in Adobe Analytics reports, go to the Adobe Analytics
Configuration screen. After you configure reports, this screen lists, for each viewer event you want information about,
a corresponding Adobe Analytics variable and Scene7 variable. These viewer events–Adobe Analytics variable–Scene7
variable combinations determine what information is reported.
As well as associating viewer events with variables, the Adobe Analytics Configuration screen offers tools for
activating, editing, and deleting viewer events.
Important: Whenever you change Adobe Analytics Report settings within Adobe Analytics, be sure you log back on to
Adobe Analytics from within Adobe Scene7 Publishing System, re-save your Adobe Analytics configuration settings, and
then re-publish.
See “Log in to Adobe Analytics” on page 265.
See “Publishing Adobe Analytics configuration information” on page 269.
Assigning Adobe Analytics variables to Scene7 viewer events and variables
Use the Adobe Analytics Configuration screen to associate viewer events with Adobe Analytics variables and Scene7
variables. For each viewer event, choose one Adobe Analytics variable and one Scene7 variable. For instructions about
opening the Adobe Analytics Configuration screen, see “Log in to Adobe Analytics” on page 265.
Last updated 10/9/2014
266
USING SCENE7
Adobe Analytics Instrumentation Kit
To assign Adobe Analytics variables to Scene7 viewer events and variables
1 After you log in to Adobe Analytics from within Scene7 and select a report suite, on the Adobe Analytics
Configuration page, in the far right column of the table, activate a viewer event by clicking Enable.
2 Under the Variables column, display the variable pair chooser by clicking the arrow button for the desired Viewer
Event.
See “Viewer events” on page 266.
3 Add a Scene7 variable.
See “Scene7 variables” on page 268.
4 Add an Adobe Analytics variable.
5 (Optional) To add another variable pair, click Add.
6 Click Save.
After you click Save, the viewer event, its Adobe Analytics variable, and its Scene7 variable, are listed in the Adobe
Analytics Configuration screen.
7 In the lower right corner, click Close.
8 Click Publish > Submit Publish to run an Image Serving publish.
Publishing is necessary so that the information contained in the viewers is available on Scene7 servers.
More Help topics
“Activating, editing, and deleting viewer events” on page 269
Viewer events
Viewer events describe actions that users perform with Scene7 viewers. When a user initiates a certain action, such as
clicking on a thumbnail or starting or stopping a video, the viewer “broadcasts” an event to the web page, along with
data associated with that event.
The following table describes viewer events you can add to the Adobe Analytics Configuration screen.
Viewer event
AS3 Viewer
Platform
support
HTML5 Viewer
Platform
support and
viewers
Description
LOAD
When tracking
manager
component is
integrated into
the viewer.
X (eCatalog,
Flyout, SpinSet,
Video, Zoom)
When a user starts the viewer.
PAGE
When tracking
manager
component is
integrated into
the viewer.
X (eCatalog)
In eCatalogs, when a user turns a page;
in targeted zoom viewers, when a user
clicks a different target or a color swatch.
SWAP
When tracking
manager
component is
integrated into
the viewer.
X (eCatalog,
Flyout, SpinSet,
Video, Zoom)
When a user clicks a different thumbnail
to view a different image.
Last updated 10/9/2014
267
USING SCENE7
Adobe Analytics Instrumentation Kit
Viewer event
AS3 Viewer
Platform
support
HTML5 Viewer
Platform
support and
viewers
Description
ITEM
When tracking
manager
component is
integrated into
the viewer.
X (eCatalog)
In viewers that support Image Maps in
which rollovers are defined, when a user
hovers the pointer over an Image Map to
read the rollover text.
HREF
When tracking
manager
component is
integrated into
the viewer.
X (eCatalog)
In viewers that support Image Maps,
when a user clicks a URL in an Image
Map.
TARGET
When tracking
manager
component is
integrated into
the viewer.
In targeted zoom viewers, when a user
clicks a zoom target to zoom to part of
an image.
SEARCH
When tracking
manager
component is
integrated into
the viewer.
In eCatalogs, when a user conducts a
word search.
PLAY
When tracking
manager
component is
integrated into
the viewer.
X (Video)
When tracking
manager
component is
integrated into
the viewer.
X (Video)
When tracking
manager
component is
integrated into
the viewer.
X (Video)
PAUSE
STOP
In Video viewers, when a user clicks Play
to start playing a video.
As an alternate to enabling this viewer
event, see “Enabling Adobe Analytics
Video Reports” on page 263.
In Video viewers, when a user clicks
Pause to pause a video.
As an alternate to enabling this viewer
event, see “Enabling Adobe Analytics
Video Reports” on page 263.
In Video viewers, when a user clicks Stop
to stop playing a video.
Note: For the HTML5 viewer
platform, this viewer event is only
available for custom HTML5
Viewers that you have created
using the Adobe Scene7 HTML5
Viewer SDK.
As an alternate to enabling this viewer
event, see “Enabling Adobe Analytics
Video Reports” on page 263.
MILESTONE
X
X (Video)
In Video viewers, milestone events are
generated when the user watches 0, 25,
50, 75, or 100 percent of the video.
As an alternate to enabling this viewer
event, see “Enabling Adobe Analytics
Video Reports” on page 263.
Last updated 10/9/2014
268
USING SCENE7
Adobe Analytics Instrumentation Kit
Viewer event
AS3 Viewer
Platform
support
SWATCH
HTML5 Viewer
Platform
support and
viewers
Description
X (Flyout, Zoom)
This viewer event is mapped to the PAGE
viewer event in Scene7 Publishing
System.
Note: This HTML5 platform
viewer event is only available for
custom HTML5 Viewers that you
have created using the Adobe
Scene7 HTML5 Viewer SDK.
ZOOM
PAN
SPIN
X (eCatalog,
SpinSet, Zoom)
Not tracked by Adobe Analytics.
X (eCatalog,
SpinSet, Zoom)
Not tracked by Adobe Analytics.
X (SpinSet)
Not tracked by Adobe Analytics.
Note: This HTML5 platform
viewer event is only available for
custom HTML5 Viewers that you
have created using the Adobe
Scene7 HTML5 Viewer SDK.
Note: This HTML5 platform
viewer event is only available for
custom HTML5 Viewers that you
have created using the Adobe
Scene7 HTML5 Viewer SDK.
Note: This HTML5 platform
viewer event is only available for
custom HTML5 Viewers that you
have created using the Adobe
Scene7 HTML5 Viewer SDK.
Scene7 variables
For each viewer event on Adobe Analytics Configuration screen, choose a Adobe Analytics variable and a Scene7
variable. Scene7 variables represent data you can obtain for a report. For example, the searchTerm variable lists
keywords used in eCatalog searches.
The following table describes Scene7 variables.
Scene7 variable
Description
asset
Scene7 Publishing System asset ID or video path file.
viewerId
An arbitrary number that is assigned to each different viewer type.
pageLabel
In eCatalogs, the page that a viewer displays.
label
The label value (a string).
frame
The page or page reference in an Image Set.
rollover_keyRaw
The entire HREF value, not just any processed part of it.
Last updated 10/9/2014
269
USING SCENE7
Adobe Analytics Instrumentation Kit
Scene7 variable
Description
rollover_keyProc
The ID of an item that is referenced in an Image Map (valid for href and item events).
searchTerm
A term that is used in eCatalog search.
timeStamp
Play, Stop, and Pause chosen in video viewers.
progress
The percentage of a milestone event that is complete.
targetId
The id value (a number).
Activating, editing, and deleting viewer events
On the Adobe Analytics Configuration screen, you can activate, edit, and delete viewer events:
Activating Select or deselect the Active check box activate or deactivate a viewer event.
Editing Select a viewer event and click the Edit button. In the Adobe Analytics Variable dialog box, choose a different
Adobe Analytics variable and Scene7 variable, and click Save. For more information, see “Assigning Adobe Analytics
variables to Scene7 viewer events and variables” on page 265.
Deleting Select a viewer event and click the Delete button.
Publishing Adobe Analytics configuration information
Publish your Scene7 viewers so that information about configuring Adobe Analytics reports is sent to Scene7 servers.
This information is embedded in viewers. Publishing is necessary so that the information contained in the viewers is
available on Scene7 servers. From the servers, it can be relayed to Adobe Analytics after users perform activity on the
viewers.
Important: Whenever you change Adobe Analytics Report settings within Adobe Analytics, be sure you log back on to
Adobe Analytics from within Adobe Scene7 Publishing System, re-save your Adobe Analytics configuration settings, and
then re-publish.
See“Log in to Adobe Analytics” on page 265.
See “Configuring Adobe Analytics reports” on page 265.
To publish configuration information
1 On the Global Navigation bar, click Publish.
2 In the Publish dialog box, click Start Publish.
Instrumenting a viewer using the Adobe Analytics
Instrumentation Kit
You can use the Adobe Analytics Instrumentation Kit to integrate an ActionScript 3.0 (AS3) viewer with Adobe
Analytics.
Last updated 10/9/2014
270
USING SCENE7
Adobe Analytics Instrumentation Kit
If you use any of the predefined Scene7 HTML5 viewer presets, be aware that they already contain all the
implementation code needed to send data to Adobe Analytics--no further instrumentation is required by you.
However, if you choose to create your own custom HTML5 viewers using the HTML5 Viewer SDK, see the Adobe
Scene7 HTML5 Viewer SDK User Guide for instructions on how to use the Adobe Analytics Tracking Manager
component.
The Adobe Scene7 HTML5 Viewer SDK User Guide is available as part of the SDK download from Adobe Developer
Connection.
See www.adobe.com/go/learn/learn_s7_devresources_en.
Set up Adobe Analytics tracking from Scene7 Publishing System
For all AS3 Flash viewers, add the following JavaScript to the HTML container, usually in the <head> element:
<!-- ***** Site Catalyst Tracking ***** --><script type="text/javascript"
src="http://s7d6.scene7.com/s7viewers/s_code.jsp?company=<SPS Company
ID>&preset=companypreset-1"></script>
Company is set to the SPS company name. &preset is optional unless the company preset name is not companypreset.
In such cases, it could be companypreset-1, companypreset-2, and so on. The higher number is a newer instance
of the preset. To determine the correct company preset value name, click Copy URL , and then look at the preset=
parameter to find the company preset name.
Continuing, you will now you add a function that transmits the viewer event to the Adobe Analytics tracking code.
Add the s7ComponentEvent() function to the container HTML (or JSP, or ASPX or other):
function s7ComponentEvent(objectId, componentClass, instanceName, timeStamp, eventData) {
s7track(eventData); }
The function name is case sensitive. The only parameter passed to s7componentEvent that is required is the last one:
eventData. s7track() is defined in s_code.jsp included above. s7track handles all tracking per each event. (To
further customize data transmitted to Adobe Analytics, this area is the place to do it.)
Enabling HREF and ITEM events
You can enable HREF (rollover) and ITEM (mouse clicks/touch) events in the viewers through Image Map editing.
Define the identifiers for the HREF and ITEM within the Image Map that is associated with viewer content. Add a
&rolloverKey= parameter to the HREF value within the Image Map.
Testing the integration by viewing an Adobe Analytics
report
After you have created the necessary variables in Adobe Analytics, linked them to Scene7 events and completed the
necessary implementation steps, then you should test the setup. You can test and verify that the data is being captured,
inside Adobe Analytics itself. If the setup works here, then no further steps are needed. Assuming you followed the
steps above and linked your Scene7 event data to one or more custom traffic variables, then follow this workflow to
test your data inside Adobe Analytics.
Last updated 10/9/2014
271
USING SCENE7
Adobe Analytics Instrumentation Kit
To test the integration by viewing a Adobe Analytics report
1 Launch a Scene7 viewer from your account, particularly one that broadcasts the metric that you want to capture,
and interact with it to create some event data.
For example, if you want to measure the most popular alternative views in an Image Set, then preview an Image Set
and click on the different thumbnails images.
2 Inside Adobe Analytics, go to Custom Traffic > Custom Traffic 1-10 > [Name of prop], selecting your traffic prop
name from the menu choices.
For example, to access the LoadAsset prop in our sample account, the proper menu choice would be Custom Traffic
> Custom Traffic 1-10 > LoadAsset. If you have more than ten custom props, then you may see additional menu
choices as well.
3 View the chart produced by Adobe Analytics. Note that this is typically just the data for a single metric. If you also
want to know with which asset this data is associated (e.g., which video is being watched to only 50%, or which
image in a set is most popular), be sure to capture the asset data of this event as well.
Note: All Scene7 viewer data is displayed and reported in Custom Traffic reports or Custom Conversion reports of Adobe
Analytics.
For more information, see www.adobe.com/go/learn_sc7_sitecatalystguide_en.
Disabling Adobe Analytics tracking
To disable Adobe Analytics tracking
1 Turn off all events in the Adobe Analytics Configuration page in Scene7 Publishing System.
2 Save and publish.
This turns off the support through Scene7 and through URLs obtained from the CopyURL feature. If you implement
custom tracking, disable the Adobe Analytics tracking as set up in the Configuration page to prevent conflicts with the
custom implementation.
Last updated 10/9/2014
272
Chapter 19: Test&Target integration
Adobe® Test&Target™ puts control directly in the hands of marketers to quickly and continually execute multiple A/B
and multivariate tests, measure effectiveness, and increase relevance of online content through segmentation,
targeting, and automated personalization.
The Scene7 Publishing Systems allows you to create offers and offer sets for Test&Target campaigns. For example, you
can create an offer set with three variations of the same rich media asset and have Test&Target determine which asset
provides better conversion lift. You can create offers and offer sets from a Basic Template or from individual images.
After the offer set is pushed, or saved, to Adobe Test&Target, where the offers are associated with mBoxes and
experiences, Test&Target can run campaigns to determine which variation of a web site is likely to perform best for
click-throughs and conversion.
For greater customization of dynamic Scene7 content, use Test&Target HTML offers. See the Test&Target product
documentation for more information.
Note: A valid Adobe Test&Target account is required to use Test&Target with the Scene7 Publishing System.
Quick Start: Test&Target integration
This Quick Start is designed to get you up and running quickly with Test&Target HTML offer sets. Follow steps 1
through 3. After each step is a cross-reference to a topic heading where you can find more information.
1. Enter your Test&Target URL in the Application General Settings screen.
Scene7 needs your Test&Target URL to integrate with Test& Target. Copy the portion of your Test&Target URL up
to and including .com, and enter it in the Scene7 Application General Settings screen. See “Integrating Scene7 with
Test&Target” on page 273.
2. Create the offer set
Use a parameterized template or images to create an offer set. You create HTML offer sets on the Test&Target Offer
Set screen. To open this screen, select your template or images, and choose Build > Test&Target Offer Set.
To create an offer with a template, click the Add & Preview button, and in the Add & Preview screen, change parameter
values.
To create an offer with images, drag images into the Test&Target Offer Set screen. You can click the Preview button
to choose an Image Preset for an image or all the images in the offer set.
Save the offer set after you create it.
See “Creating an offer set” on page 273.
3. Push the offer set to Test&Target
In the Test&Target Offer Set screen, click the Push Offers button, and enter your login credentials in the Test&Target
Login dialog box. See “Pushing offer sets to Test&Target” on page 276.
Last updated 10/9/2014
273
USING SCENE7
Test&Target integration
Integrating Scene7 with Test&Target
Before you can integrate Scene7 with Test&Target, you must enter your Test&Target URL in the Scene7 Application
General Settings screen. Follow these steps to obtain your Test&Target URL and enter it in the Application General
Settings screen:
1 Go to the Test&Target Login window at this address: https://admin.testandtarget.omniture.com.
2 Enter your credentials and click the Login button.
3 After you log in, in your browser’s address bar, copy the URL up to and including .com.
For example, if the fictional URL (URLs paths always contain forward slashes, not back slashes as in these two
examples) in the address bar is https:\\admin16.testandtarget.ommnture.com/admin/home.do, copy this portion
of the fictional URL: https:\\admin16.testandtarget.ommnture.com.
In step 5, you paste the portion of the URL you copied into the Scene7 Application General Settings screen.
4 In Scene7, choose Setup > Application Setup to open the Application General Settings screen.
5 In the Test&Target Server Name field, paste the URL you copied in step 3.
6 Click Close.
Creating an offer set
You can create any of the following types of offer sets:
• Video recut
• Video
• Parameterized template
• Image
For video recuts and templates, click Add and Preview, then set the parameters you choose. The other offer set types
do not include parameters, but you can still customize them by clicking Preview and changing the available presets.
Scene7 offers tools for editing as well as creating offer sets.
Important: Before creating an offer set, be sure you publish all assets that you intend to use for the set to the Scene7
Publishing System. See “Manually publishing assets” on page 89 and “Manually unpublishing assets” on page 89.
More Help topics
“Creating template parameters” on page 184
“Create a Video Recut Template” on page 248
Types of offer sets
Create an offer set from the following types of offer sets:
Images You can assemble images for an offer set. Each image comprises a different offer in the set.
Image template You can parameterize image templates in Scene7 with the Build > Template Basics command.
Through parameters, components of the template — the text in text frames, the different images — can be swapped
out and customized. For an offer set, you can use template parameters to create variations on the same image in your
Last updated 10/9/2014
274
USING SCENE7
Test&Target integration
offer set, for example. For information about creating and parameterizing image templates, see “Creating template
parameters” on page 184.
Video You can assemble video for an offer set. Each video is a different offer in the set.
Video recut You can enhance master videos into Video Recuts to create interactive shopping experiences directly
within the video. For example, you can add clickable product hotspots to provide related information, or add call-toaction buttons to enable purchase from the video.
Creating an offer set with a paremeterized template or video recut
When you create an Offer Set, the Publish after save option affects the set and set members in the following ways:
“Publish after save” option selected
before saving?
State of set after saving
State of set members after saving
Yes
Published
Published
No
Unpublished
Set members retain their published or
unpublished state.
See also “Manually publishing assets” on page 89 and “Manually unpublishing assets” on page 89.
To create an offer set with a parameterized template or video recut
1 Select the template, banner, or video recut.
2 Click Build > Test&Target Offer Set.
The Test&Target Offer Set screen opens. This screen lists offers in the offer set. The first item on the list is the object.
3 Select the object and click Add & Preview.
The left side of the page lists parameters in the template and their values.
4 Change parameter values to create the offer. For example, enter different text in a text field, change the size of a
layer, swap one image for another, or choose a different viewer preset.
5 Click Save or Save As to save the offer as part of the offer set.
The Test&Target Offer Set screen lists the offers you created.
6 Repeat steps 3 through 5 to create more offers for the set.
7 When you are finished, near the lower-right corner of the page, ensure that Publish after save is selected (default).
8 Click Close, enter a name for the offer set, and click Save.
Before closing the Test&Target Offer Set screen, push the offer set to Test&Target. See “Pushing offer sets to
Test&Target” on page 276.
More Help topics
“Editing an Offer Set” on page 275
Creating an offer set with images or videos
When you create an Offer Set, the Publish after save option affects the set and set members in the following ways:
Last updated 10/9/2014
275
USING SCENE7
Test&Target integration
“Publish after save” option selected
before saving?
State of set after saving
State of set members after saving
Yes
Published
Published
No
Unpublished
Set members retain their published or
unpublished state.
See also “Manually publishing assets” on page 89 and “Manually unpublishing assets” on page 89.
To create an offer set with images or videos
1 Assemble images or videos for the offer set by starting in the Test&Target Offer Set screen or in the Grid View or
List View and use one of the following methods:
Test&Target Offer Set screen Click Build > Test&Target Offer Set. Drag images or videos onto the screen. To
create varying sizes of videos or images, drag in multiple copies of the image or video and set each size individually.
Grid or List view Select the images or videos and click Build > Test&Target Offer Set.
2 Optionally, select an image or video and click Preview. On the Preview Offers page, you can change the size and
look of the image or video you selected or all images or videos in the offer set.
• Choose a Preset to change the look and size of the image or video.
• Click the Select Presets to All check box to apply the preset you chose to all the offers in the offer set.
Click Save to save your changes to the image or video offer. Then click Close to return to the Test&Target Offer Set page.
3 After you finish creating offers for the offer set and choosing Image Presets for different images, near the lower-
right corner of the page, ensure that Publish after save is selected (default).
4 Click Save and enter a name for the offer set, and click Save.
Before closing the Test&Target Offer Set screen, push the offer set to Test&Target. See “Pushing offer sets to
Test&Target” on page 276.
Editing an Offer Set
Depending on whether you edit a published set or an unpublished set, the Publish after save option affects the set and
set members in the following ways:
Set already
published?
“Publish after save”
option selected before
saving your edit?
State of set after saving
State of set members after saving
Yes
Yes
Published
Published
Yes
No
Published
Existing set members retain their
published state.
Any new set members that you added
during your edit retain their published
or unpublished state.
No
Yes
Published
Published
No
No
Unpublished
Existing set members and any new set
members that you added during your
edit retain their published or
unpublished state.
Last updated 10/9/2014
276
USING SCENE7
Test&Target integration
See also “Manually publishing assets” on page 89 and “Manually unpublishing assets” on page 89.
To edit an Offer Set
1 To edit an offer set, display the offer set in Grid view or List view and click its Edit rollover button. The Test&Target
Offer Set screen opens.
2 Do any of the following:
Removing an offer Select the offer and click the Delete button to remove an offer from the set.
Adding an offer How you add an offer depends on the type of offer set you’re working with:
• Templates and Video Recuts: Click Add & Preview, and on the Add & Preview Offers page, create another offer.
• Images and videos: Drag an image or video onto the Test&Target Offer Set page.
Note: You cannot delete an offer set that is associated with a campaign. To delete an offer set associated with a
campaign, log on to Test&Target and remove the campaign associations first. Even after un-associating from a
campaign, the asset can only be deleted from Scene7 Publishing System, requiring a login to Test&Target, and not
from within Test&Target.
3 When you are finished editing, near the lower-right corner of the page, ensure that Publish after save is selected
(default).
4 Click Save, select a storage folder, enter a name for the set, and then click Save.
Deleting an Offer Set
When you delete an Offer Set, the set itself is moved to the Trash. However, the members (or “children”) within that
set are not affected; instead, they each retain their existing published or unpublished state.
See also “Manually publishing assets” on page 89 and “Manually unpublishing assets” on page 89.
To delete an Offer Set
1
In the Grid View, List View, or Details View, select one or more Offer Sets.
2 On the Global Navigation Bar, click File > Delete > Delete.
Pushing offer sets to Test&Target
After you create or edit an offer set, push it to Test&Target by following these steps:
1 In the Test&Target Offer Set screen, click the Push Offers button.
2 Enter your login credentials.
3 Click the Login button.
During the transfer to Test&Target, the prefix S7_ is attached automatically to the start of offer names. This prefix is
attached to ensure that you can easily find Scene7 offers in the Test&Target offer list. For example, the offer appears
as S7_<name of offer set>_<offer name>.
Last updated 10/9/2014
277
USING SCENE7
Test&Target integration
SPS pushes into Test&Target widget offers. You can use Widget offers to host your own offer content outside of
Test&Target. Widget offers are similar to a standard offer hosted outside of Test&Target. They allow Test&Target to
deploy offer content that’s stored on your server, allowing for more sophisticated and dynamic usage. Widget offers
retrieve content from a URL, caching and serving that content for approximately two hours.Widget offers provide
some dynamic content generation capabilities that other offers outside of Test&Target do not. If the mbox serving the
offer contains mbox parameters such as mboxProductID and mbox.offerId, the productId=[PRODUCT_ID] and
offerID=[OFFERID] URL parameters are appended to the requested URL. These parameters can be used by a service
available at the Widget offer URL to return content outside of Test&Target that uses product or order information
from your mboxes.The Widget offer is also accessible through the API to programatically create offers outside
Test&Target.
Last updated 10/9/2014
278
Chapter 20: User-generated content
Using UGC (user-generated content) consists of uploading assets to a dedicated Scene7 storage repository and
performing related operations.
UGC supports the following file formats:
• Raster: JPG, PNG, TIFF
• Vector: AI, EPS, PDF (only when the PDF file is previously opened and saved in Adobe Illustrator CS6)
Before uploading assets, you obtain a shared-secret key. You use this key to retrieve an upload token. You submit the
upload token when you upload assets and perform other UGC tasks.
After you retrieve a shared-secret key and upload token, you can perform the following operations for user-generated
content:
• Upload an asset.
See “Uploading an image asset or a vector asset” on page 278.
• Get image asset metadata.
See “Getting asset metadata for images” on page 283.
• Delete an uploaded asset.
See “Deleting an uploaded asset” on page 286.
• Get information about a company’s disk space usage.
See “Getting disk usage information” on page 287.
Uploading an image asset or a vector asset
Before you can upload an image asset, you first request a shared-secret key. You use this shared-secret key to retrieve
an upload token. You then use the upload token to upload image assets or vector assets.
Requesting a shared-secret key
Request a shared-secret key by sending an email to Scene 7 Technical Support at s7support@adobe.com.
In the email message, provide the company name that you want to use to upload image assets. After you receive the
key from Scene7, save it locally for future use.
Retrieving the upload token
The upload token ensures that no one can use the same shared-secret key to upload assets. It ensures that the upload
is legitimate and comes from a trusted source.
The upload token is an alphanumeric string that is available only for a specific amount of time. Use the following URLs,
substituting your shared-secret key, to retrieve the upload token.
• Image
Last updated 10/9/2014
279
USING SCENE7
User-generated content
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc9b99-2e29b78b602
In this example, the shared-secret key is fece4b21-87ee-47fc-9b99-2e29b78b602
• Vector
https://s7ugc1.scene7.com/ugc/vector?op=get_uploadtoken&shared_secret=2d19f60e-890a-4e79a1a5-9ac2875429b9
In this example, the shared-secret key is 2d19f60e-890a-4e79-a1a5-9ac2875429b9
By default, the upload token expires five minutes (300 seconds) after you retrieve it. To request more time, include
expires in the URL and the amount of time you require in seconds. For example, the following sample image URL
retrieves an upload token that is valid for 1800 seconds:
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc9b99-2e29b78b602&expires=1800
The successful response for images looks like the following:
<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<scene7>
<user_generated_content>
<response>
<serviceName>User Generated Content - Images</serviceName>
<version>1.0.0</version>
<operationName>get_uploadtoken</operationName>
<serviceStatus>SUCCESS</serviceStatus>
<title>Upload Token for fece4b21-87ee-47fc-9b99-2e29b78b602</title>
<message>
<uploadtoken>aa2a378a-cd25-4c80-994d-312094e0ef20_1800</uploadtoken>
<expiration_in_seconds>1800</expiration_in_seconds>
</message>
</response>
</user_generated_content>
</scene7>
Save the upload token locally for use with future requests.
You can use the following fields in the query URL string to retrieve an upload token:
URL parameter
Required or optional
Value
op
Required
get_uploadtoken
shared_secret
Required
The shared-secret key for the company that is doing the upload.
expires
Optional
Number of seconds that the upload token is valid. Default is 300 seconds, if
not specified.
Sample image URL:
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc9b99-2e29b78b602&expires=600
Sample vector URL:
http://s7ugc1.scene7.com/ugc/vector?op=get_uploadtoken&shared_secret=2d19f60e-890a-4e79a1a5-9ac2875429b9&expires=5000
Allowed HTTP methods: GET and POST
Last updated 10/9/2014
280
USING SCENE7
User-generated content
You can now upload an image asset.
See “Uploading an image asset” on page 280.
Uploading an image asset
After you retrieve an upload token that is valid for a specific amount of time, you can upload an image asset. You
upload the asset as a multipart/form post while sending the rest of the values as a URL query string, as shown in this
example:
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d312094e0ef20_18000&company_name=000Company
The upload_token and company_name fields are required.
See “Retrieving the upload token” on page 278.
See “Requesting a shared-secret key” on page 278.
You can also send other optional values as URL query strings, as in this example:
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d312094e0ef20_18000&company_name=000Company&file_limit=2000000&file_exts=jpg,gif
Thefile_limit parameter specifies the file-size limit in bytes. The file_exts parameter specifies the filename
extensions that are allowed for upload. Both of these values are optional.
A global limit is set in the application for the file size limit and the filename extensions allowed. If what you send in
the request is a subset of the global limits, it is honored. The global limits are the following:
Global limit
Value
File size for all clients
20 MB
Supported image file formats for upload
BMP, GIF, JPG, PNG, PSD
The following HTML form lets a user upload an asset. The form asks the user to enter the following information:
• A company name
• An upload token
• A file size limit
• A list of filename extensions
• The name of the file to upload
An HTML form for uploading an asset.
Last updated 10/9/2014
281
USING SCENE7
User-generated content
The following HTML code is displayed when you right-click in the browser window, and then click View Source for
the form shown in the illustration. The code shows the corresponding URL query string and the POST method that
are run when the user clicks Submit.
<html>
<body>
<script language="javascript">
function uploadImage()
{
var preserve_colorprofile = "false";
if(document.image_upload.preserve_colorprofile[0].checked == true){
preserve_colorprofile = "true";
}
var preserve_filename = "false";
if(document.image_upload.preserve_filename[0].checked == true){
preserve_filename = "true";
}
document.image_upload.action="https://s7ugc1.scene7.com/ugc/image?op=upload&company_name="+d
ocument.image_upload.company_name.value+"&upload_token="+document.image_upload.upload_token.
value+"&file_limit="+document.image_upload.file_limit.value+"&file_exts="+document.image_upl
oad.file_exts.value+"&preserve_colorprofile="+preserve_colorprofile+"&preserve_filename="+pr
eserve_filename;
return true;
}
</script>
<form method="POST" enctype="multipart/form-data" name="image_upload" id="image_upload"
onSubmit="return uploadImage();">
<table>
<tr><td colspan="2"><strong> UGC Image Upload Test Page: </strong></td></tr>
<tr><td colspan="2"></td></tr>
<tr><td><strong> Company Name</strong></td><td><input type="text" size="40"
name="company_name"></td></tr>
<tr><td><strong> Upload Token </strong></td><td><input type="text" size="40"
name="upload_token"></td></tr>
<tr><td><strong> File Size Limit (in bytes) </strong></td><td><input type="text" size="40"
name="file_limit">&nbsp;bytes</td></tr>
<tr><td><strong> File Extensions allowed </strong></td><td><input type="text" size="40"
name="file_exts"></td></tr>
Last updated 10/9/2014
282
USING SCENE7
User-generated content
<tr><td><strong> Preserve Color Profile</strong></td><td><input type="radio"
name="preserve_colorprofile" value="true">Yes&nbsp;&nbsp;<input type="radio"
name="preserve_colorprofile" value="false" checked>No</td></tr>
<tr><td><strong> Preserve File Name</strong></td><td><input type="radio"
name="preserve_filename" value="true">Yes&nbsp;&nbsp;<input type="radio"
name="preserve_filename" value="false" checked>No</td></tr>
<tr><td colspan="2"></td></tr>
<tr>
<td><strong>File to upload: : </strong></td>
<td><input name="filename" type="file" id="filename" size="58" maxlength="1024" /></td>
</tr>
<tr><td colspan="2"></td></tr>
<tr>
<td><strong>Click Submit to upload your image: </strong></td>
<td><input type="submit" value="Submit"></td>
</tr>
</table>
</form>
</body>
</html>
To view the XML response in Internet Explorer, click View > Source. To view XML response in Firefox, click View >
Page Source. Firefox is recommended for viewing XML responses.
The following is a sample response from a successful upload:
<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<scene7>
<user_generated_content>
<response>
<serviceName>User Generated Content - Images</serviceName>
<version>1.0.0</version>
<operationName>upload</operationName>
<serviceStatus>SUCCESS</serviceStatus>
<title>Your file has been uploaded Successfully.</title>
<message>
<url>http://s7w2p1.scene7.com/is/image/ </url>
<path>000Company/ugc/1442564.tif</path>
<fullurl>http://s7w2p1.scene7.com/is/image/000Company/ugc/1442564.tif </fullurl>
</message>
</response>
</user_generated_content>
</scene7>
Note: The uploaded asset (JPG, GIF, and so on) is converted to the PTIFF format and the response sends a direct link to
that PTIFF asset.
The asset is like any other ImageServing resource; you can apply processing queries to it. For example, the following
URL requests an asset that is stretched to the specified width and height.
http://s7w2p1.scene7.com/is/image/S7WebUGC/ugc/9536356.tif?&wid=800&hei=100&fit=stretch
Send the asset to upload as a multipart/form post while sending the rest of the values as a URL query string. You can
use the following fields in the URL query string to upload an asset:
Last updated 10/9/2014
283
USING SCENE7
User-generated content
URL Parameter
Required or optional
Value
op
Required
upload
upload_token
Required
Upload token for the shared-secret key associated with
the company.
company_name
Required
Name of the company performing the upload.
file_limit
Optional
File size limit, in bytes, for the asset.
file_exts
Optional
List of allowable extensions for the image asset file.
preserve_colorprofile Optional
preserve_filename
Optional
Preserves any embedded color profile while converting
the uploaded file to PTIFF format. Possible values are true
or false. Default is false.
Preserves the filename of the uploaded asset. Possible
values are true or false. Default is false.
Note: You are required to send the asset to be uploaded as the only field in a multipart POST request.
Sample URL:
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d312094e0ef20_18000&company_name=000Company
Allowed HTTP method:
POST
Getting asset metadata for images
You can use image_info to retrieve metadata for an asset that you uploaded, as shown in the following example:
https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b992e29b78b602&image_name=1442564.tif
An example of a successful response looks like the following:
<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<scene7>
<user_generated_content>
<response>
<serviceName>User Generated Content - Images</serviceName>
<version>1.0.0</version>
<operationName>image_info</operationName>
<serviceStatus>SUCCESS</serviceStatus>
<title>More information on 1442564.tif</title>
<message>
File created on Tue Sep 08 19:02:04 CDT 2009, File Size = 243494 bytes
<imageFormat>Tiff</imageFormat>
<colorSpace>Rgb</colorSpace>
<width>686</width>
<height>457</height>
</message>
</response>
</user_generated_content>
</scene7>
You can use the following fields in the URL query string to request information for an asset:
Last updated 10/9/2014
284
USING SCENE7
User-generated content
URL Parameter
Required or optional
Value
op
Required
image_info
shared_secret
Required
The shared-secret key for the company.
image_name
Required
Name of the image.
Sample URL:
https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b992e29b78b602&image_name=1442564.tif
Allowed HTTP method:
GET and POST
Uploading a vector asset
After you retrieve an upload token that is valid for a specific amount of time, you can upload a vector asset. You upload
the asset as a multipart/form post while sending the rest of the values as a URL query string, as shown in this example:
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d312094e0ef20_18000&company_name=000Company
The upload_token and company_name fields are required.
See “Retrieving the upload token” on page 278.
See “Requesting a shared-secret key” on page 278.
You can also send other optional values as URL query strings, as in this example:
https://s7ugc1.scene7.com/ugc/vector?op=upload&upload_token=aa2a378a-cd25-4c80-994d312094e0ef20_18000&company_name=000Company&file_limit=2000000&file_exts=ai,pdf
Thefile_limit parameter specifies the file-size limit in bytes. The file_exts parameter specifies the filename
extensions that are allowed for upload. Both of these values are optional.
A global limit is set in the application for the file size limit and the filename extensions allowed. If what you send in
the request is a subset of the global limits, it is honored. The global limits are the following:
Global limit
Value
File size for all clients
20 MB
Supported vector file formats for upload
AI, EPS, PDF (only when the PDF is
previously opened and saved in Adobe
Illustrator CS6)
The following HTML form lets a user upload an asset. The form asks the user to enter the following information:
• A company name
• An upload token
• A file size limit
• A list of filename extensions
• The name of the file to upload
Last updated 10/9/2014
285
USING SCENE7
User-generated content
An HTML form for uploading an asset.
The following HTML code is displayed when you right-click in the browser window, and then click View Source for
the form shown in the illustration. The code shows the corresponding URL query string and the POST method that
are run when the user clicks Submit.
<body>
<script language="javascript">
function uploadImage()
{
document.image_upload.action="vector?op=upload&company_name="+document.image_upload.company_
name.value+"&upload_token="+document.image_upload.upload_token.value+"&file_limit="+document
.image_upload.file_limit.value+"&file_exts="+document.image_upload.file_exts.value;
return true;
}
</script>
<form method="POST" enctype="multipart/form-data" name="image_upload" id="image_upload"
onSubmit="return uploadImage();">
<table>
<tr><td colspan="2"><strong> UGC Vector Upload Test Page: </strong></td></tr>
<tr><td colspan="2"></td></tr>
<tr><td><strong> Company Name</strong></td><td><input type="text" size="40"
name="company_name"></td></tr>
<tr><td><strong> Upload Token </strong></td><td><input type="text" size="40"
name="upload_token"></td></tr>
<tr><td><strong> File Size Limit (in bytes) </strong></td><td><input type="text" size="40"
name="file_limit">&nbsp;bytes</td></tr>
<tr><td><strong> File Extensions allowed </strong></td><td><input type="text" size="40"
name="file_exts"></td></tr>
<tr><td colspan="2"></td></tr>
<tr>
<td><strong>File to upload: : </strong></td>
<td><input name="filename" type="file" id="filename" size="58" maxlength="1024" /></td>
</tr>
<tr><td colspan="2"></td></tr>
<tr>
<td><strong>Click Submit to upload your Vector: </strong></td>
<td><input type="submit" value="Submit"></td>
</tr>
</table>
</form>
</body>
To view the XML response in Internet Explorer, click View > Source. To view XML response in Firefox, click View >
Page Source. Firefox is recommended for viewing XML responses.
The following is a sample response from a successful upload:
Last updated 10/9/2014
286
USING SCENE7
User-generated content
<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<scene7>
<user_generated_content>
<response>
<serviceName>User Generated Content -Vector</serviceName>
<version>1.0.0</version>
<operationName>upload</operationName>
<serviceStatus>SUCCESS</serviceStatus>
<title>Your file has been uploaded Successfully.</title>
<message>
<url>http://s7w2p1.scene7.com/is/agm</url>
<path>W2PTest/ugc/8875744.fxg</path>
<fullurl>
http://s7w2p1.scene7.com/is/agm/W2PTest/ugc/8875744.fxg
</fullurl>
</message>
</response>
</user_generated_content>
</scene7>
Note: The uploaded asset (AI, EPS, PDF so on) is converted to the FXG format and the response sends a direct link to that
FXG asset.
The asset is like any other Web-to-print resource; you can apply processing queries to it. For example, the following
URL converts an FXG resource into a 500x500 png image.
http://s7w2p1.scene7.com/is/agm/W2PTest/ugc/8875744.fxg?fmt=png&wid=500&hei=500
Send the asset to upload as a multipart/form post while sending the rest of the values as a URL query string. You can
use the following fields in the URL query string to upload an asset:
URL Parameter
Required or optional
Value
op
Required
upload
upload_token
Required
Upload token for the shared-secret key associated with
the company.
company_name
Required
Name of the company performing the upload.
file_limit
Optional
File size limit, in bytes, for the asset.
file_exts
Optional
List of allowable extensions for the asset file.
Note: You are required to send the asset to be uploaded as the only field in a multipart POST request.
Sample URL:
https://s7ugc1.scene7.com/ugc/vector?op=upload&upload_to ken=aa2a378a-cd25-4c80-994d312094e0ef20_18000&company_name=000Company
Allowed HTTP method:
POST
Deleting an uploaded asset
You can use the delete parameter in this format to delete an asset:
Last updated 10/9/2014
287
USING SCENE7
User-generated content
https://s7ugc1.scene7.com/ugc/image?op=delete&shared_secret=fece4b21-87ee-47fc-9b992e29b78b602&image_name=1442564.tif
The following is an example of a response when an image asset is deleted:
<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<scene7>
<user_generated_content>
<response>
<serviceName>User Generated Content - Images</serviceName>
<version>1.0.0</version>
<operationName>delete</operationName>
<serviceStatus>SUCCESS</serviceStatus>
<title>Delete request for1442564.tif</title>
<message>Your file was successfully deleted</message>
</response>
</user_generated_content>
</scene7>
You can use the following fields in the URL query string to delete an asset:
URL parameter
Required/optional
Value
op
Required
delete
shared_secret
Required
The shared-secret key for the company.
•
Required
Name of the asset to delete.
For images:
image_name
•
For Vector:
fxg_name
Sample image URL:
https://s7ugc1.scene7.com/ugc/image?op=delete&shared_secret=fece4b21-87ee-47fc-9b992e29b78b602&image_name=1442564.tif
Sample vector URL:
https://s7ugc1.scene7.com/ugc/vector?op=delete&shared_secret=2160a8fa-cec6-45ba-8d59ca595f6d2b47& &fxg_name=8875744.fxg
Getting disk usage information
You can use the disk_info parameter to retrieve information about a company’s disk space usage, as shown in the
following example:
https://s7ugc1.scene7.com/ugc/image?op=disk_info&shared_secret=d03b7e0b-c9dc-4c6c-af0b419beeea1c63
A sample response looks like the following:
Last updated 10/9/2014
288
USING SCENE7
User-generated content
<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<scene7>
<user_generated_content>
<response>
<serviceName>User Generated Content - Images</serviceName>
<version>1.0.0</version>
<operationName>disk_info</operationName>
<serviceStatus>SUCCESS</serviceStatus>
<title>Disk Information for d03b7e0b-c9dc-4c6c-af0b-419beeea1c63</title>
<message>Total Space available = 1395402342400 bytes. Total Space used = 0
bytes.</message>
</response>
</user_generated_content>
</scene7>
You can use the following fields in the URL query string to get disk usage information:
URL parameter
Required/optional
Value
op
Required
disk_info
shared_secret
Required
The shared-secret key for the company
The following sample code gets disk information for 000Company:
https://s7ugc1.scene7.com/ugc/image?op=disk_info&shared_secret=fece4b21-87ee-47fc-9b992e29b78b9602
Last updated 10/9/2014
289
Chapter 21: Master files
Master files are files you use to create rich-media assets in Scene7. These files include images, PDF files (for creating
eCatalogs), and AI, ID, and PSD files (for creating web-to-print templates). Scene7 also supports SWF files for use as
skins in the different viewer presets—the Zoom Viewer, eCatalog Viewer, and other viewers.
The Scene7 Publishing System offers tools for editing images. You can create Image Maps and zoom targets for images.
You can also crop, sharpen, and adjust images.
Best practices for optimizing the quality of your images
Optimizing image quality can be a time consuming process as many factors contribute to rendering acceptable results. The
outcome is partly subjective because individuals perceive image quality differently. Structured experimentation is key.
Scene7 includes more than 100 image serving commands for tuning and optimizing images and rendering results. The
following guidelines can help you streamline the process and achieve good results quickly using some essential
commands and best practices.
Best practices for image format (&fmt=)
• JPG or PNG are the best choices to deliver images in good quality and with manageable size and weight.
• If no format command is supplied in the URL, Scene7 Image Serving defaults to JPG for delivery.
• JPG compresses at a ratio of 10:1 and usually produces smaller image file sizes. PNG compresses at a ratio of about
2:1, except in some cases, such as when images contain a white background. Typically though, PNG file sizes are
larger than JPG files.
• JPG uses lossy compression, meaning that picture elements (pixels) are dropped during compression. PNG on the
other hand uses lossless compression.
• JPG often compresses photographic images with better fidelity than synthetic images with sharp edges and contrast.
• If your images contain transparency, use PNG because JPG does not support transparency.
As a best practice for image format, start with the most common setting &fmt=JPG.
Best practices for image size
Dynamically reducing image size is one of the most common tasks that Scene7 Image Serving performs. It involves
specifying the size and, optionally, which downsampling mode is used to downscale the image.
• For image sizing, the best and most straightforward approach is to use &wid=<value> and &hei=<value> or just
&hei=<value>. These parameters automatically set the image width in accordance to the aspect ratio.
•
&resMode=<value> controls the algorithm used for downsampling. Start with &resMode=sharp2. This value
provides the best image quality. While using the downsampling value =bilin is faster, it often results in the aliasing
of artifacts.
As a best practice for image sizing, use &wid=<value>&hei=<value>&resMode=sharp2 or
&hei=<value>&resMode=sharp2
Last updated 10/9/2014
290
USING SCENE7
Master files
Best practices for image sharpening
Image sharpening is the most complex aspect of controlling images on your website, and where many mistakes are
made. Take the time to learn more about how sharpening and unsharp masking works in Scene7 by referring to the
following helpful resources:
Best practices white paper Sharpening images in Adobe Scene7 Publishing System and on Image Server.
On Adobe TV, watch Sharpening an image with unsharp mask.
With Scene7, you can sharpen images on ingestion, on delivery, or both. In most cases, however, you should sharpen
images using only one method or the other, but not both. Sharpening images on delivery, on a URL, typically gives you
the best results.
There are two image sharpening methods that you can use:
• Simple sharpening (&op_sharpen) - Similar to the sharpen filter used in Photoshop, simple sharpening applies
basic sharpening to the final view of the image following dynamic resizing. However, this method is not userconfigurable. The best practice is to not use &op_sharpen unless required.
• Unsharp masking (&op_USM) - Unsharp masking is an industry standard sharpening filter. The best practice is to
sharpen images with unsharp masking following the guidelines below. Unsharp masking lets you control the
following three parameters:
•
&op_sharpen=amount,radius,threshold
•
amount (0-5, strength of the effect.)
•
radius (0-250, width of the "sharpening lines" drawn around the sharpened object, as measured in pixels.)
Keep in mind that the parameters radius and amount work against each other. Reducing radius can be
compensated by increasing amount. Radius allows finer control as a lower value sharpens only the edge
pixels, whereas a higher value sharpens a wider band of pixels.
•
threshold (0-255, sensitivity of effect.)
This parameter determines how different the sharpened pixels must be from the surrounding area before
they are considered edge pixels and the filter sharpens them. Threshold helps to avoid over-sharpening areas
with similar colors, such as skin tones. For example, a threshold value of 12 ignores slight variations in skin
tone brightness to avoid adding "noise", while still adding edge contrast to high contrast areas, such as where
eyelashes meet skin.
For more information about how you set these three parameters, including best practices to use with the filter,
see the following resources:
Scene7 Help topic on Sharpening an image.
Best practices white paper Sharpening images in Adobe Scene7 Publishing System and on Image Server.
• Scene7 also lets you control a fourth parameter: monochrome (0,1). This parameter determines if unsharp
masking is applied to each color component separately using the value 0 or to the image brightness/intensity
using the value 1.
As a best practice, start with the unsharp mask radius parameter. Radius settings that you can start with are the
following:
• Website: 0.2-0.3 pixels
• Photographic printing (250-300 ppi): 0.3-0.5 pixels
• Offset printing (266-300 ppi): 0.7-1.0 pixels
Last updated 10/9/2014
291
USING SCENE7
Master files
• Canvas printing (150 ppi): 1.5-2.0 pixels
Gradually increase the amount from 1.75 to 4. If sharpening is still not the way you want, increase the radius by a
decimal point and run the amount again from 1.75 to 4. Repeat as necessary.
Leave the monochrome parameter setting at 0.
Best practices for JPEG compression (&qlt=)
• This parameter controls JPG encoding quality. A higher value means a higher-quality image but a large file size;
alternatively, a lower value means a lower quality image but a smaller file size. The range for this parameter is 0-100.
• To optimize for quality, do not set the parameter value to 100. The difference between a setting of 90 or 95 and 100
is almost imperceptible, yet 100 unnecessarily increases the size of the image file. Therefore, to optimize for quality
but avoid image files becoming too large, set the qlt= value to 90 or 95.
• To optimize for a small image file size but keep image quality at an acceptable level, set the qlt= value to 80. Values
below 70 to 75 results in significant image quality degradation.
• As a best practice, to stay in the middle, set the qlt= value to 85 to stay in the middle.
• Using the chroma flag in qlt=
• The qlt= parameter has a second setting that lets you turn on RGB chromaticity downsampling using the value
,1 or off using the value ,0.
• To keep it simple, start with RGB chromaticity downsampling turned off (,0). This setting usually results in
better image quality, especially for synthetic images with lots of sharp edges and contrast.
As a best practice for JPG compression use &qlt=85,0.
Best practices for JPEG sizing (&jpegSize=)
jpegSize is a useful parameter if you want to guarantee that an image does not exceed a certain size for delivery to
devices that have limited memory.
• This parameter is set in kilobytes (jpegSize=<size_in_kilobytes>). It defines the maximum allowed size for
image delivery.
•
&jpegSize= interacts with the JPG compression parameter &qlt=. If the JPG response with the specified JPG
compression parameter (&qlt=) does not exceed the jpegSize value, the image is returned with &qlt= as defined.
Otherwise, &qlt= is gradually decreased until the image fits in the maximum allowed size, or until the system
determines it cannot fit and returns an error.
As a best practice, set &jpegSize= and add the parameter &qlt= if you are delivering JPG images to devices with
limited memory.
Best practices summary
As a best practice, to achieve a high image quality and small file size, start with the following combination of
parameters:
fmt=jpg&qlt=85,0&resMode=sharp2&op_usm=1.75,0.3,2,0
This combination of settings products excellent results under most circumstances.
If the image requires further optimization, gradually fine-tune sharpening (unsharp masking) parameters by starting
with a radius set to 0.2 or 0.3. Then, gradually increase the amount from 1.75 to a maximum of 4 (equivalent to 400%
in Photoshop). Check to see that the desired result is achieved.
Last updated 10/9/2014
292
USING SCENE7
Master files
If sharpening results are still not satisfactory, increase the radius in decimal increments. For every decimal increment,
restart the amount at 1.75 and gradually increase it to 4. Repeat this process until you achieve the desired result. While
the values above are an approach that creative studios have validated, remember that you can start with other values
and follow other strategies. Whether the results are satisfactory to you or not is a subjective matter, therefore
structured experimentation is key.
As you experiment, you may also find the following general suggestions helpful to optimize your workflow:
• Try out and test different parameters in real time, either directly on a Scene7 URL or using the Scene7 Publishing
System's image adjustment functionality which provides real-time previews for adjustment operations.
• As a best practice, remember that you can group Scene7 Image Serving commands into an image preset. An image
preset is basically URL command macros with custom preset names such as $thumb_low$ and &product_high$.
The custom preset name in a URL path makes a call to these presets. Such functionality helps you manage
commands and quality settings for different usage patterns of images on your website and shortens the overall
length of URLs.
• Scene7 also provides more advanced ways to tune image quality, such as applying sharpening images on ingestion.
For advanced use cases where this may be an option to further tune and optimize rendering results, Adobe
Professional Services can help you with customized insight and best practices.
Editing images
The Scene7 Publishing System offers many tools for creating rich-media effects. These tools are available by clicking
the rollover Edit button and in the Browse Panel in Detail view. You can do the following image-editing tasks in
Scene7:
Create Image Maps Select the Image command or Image Map button
to create an Image Map. An Image Map is a
hotspot on an image, or an eCatalog page, or an image in a SpinSet, that displays a panel with rollover text. Users can
click an Image Map, for example, to launch a new web page. See “Creating Image Maps” on page 293.
Create Zoom targets Select the Zoom Targets command or the Zoom Targets button
to create thumbnail targets.
Users can click a thumbnail target in the Zoom Viewer to zoom directly to a particular part of an image. See “Creating
zoom targets for Guided Zoom” on page 128.
Crop an image Select the Crop command or the Crop button
to crop an image. See “Cropping an image” on
page 299.
Sharpen an image Select the Sharpen command or the Sharpen button
to sharpen an image and make its outlines
less blurry and more distinct. See “Sharpening an image” on page 300.
Adjust an image Select the Adjust command or the Adjust button
to flip, rotate, blur, colorize, or alter the color
balance of an image. See “Adjusting an image” on page 304.
Edit layers Click the Layers tab to display individual, editable layers in a PSD file. When you upload a PSD file, all
layers are uploaded individually as separate files so that you can edit them within Scene7.
As well as using these tools to edit images, you can edit images as you upload them to the Scene7 Publishing System.
For example, you can crop images, create a mask from a clipping path, and select a color profile for an image as you
upload it.
Last updated 10/9/2014
293
USING SCENE7
Master files
Creating Image Maps
An Image Map is a region on an image, an eCatalog page, or an image in a SpinSet, that displays a rollover panel with
text. When the user clicks an Image Map, an action of some kind is triggered. For example, a web page is launched so
that the user can learn more about a product. To call attention to Image Maps, an outline appears around an Image
Map when the user moves the pointer over it.
Besides the ability to create an image map in Scene7, or you can also create image maps when you design a catalog in
Adobe Acrobat or Adobe InDesign.
When you create Image Maps you can do any of the following:
• Enter rollover text.
• Enter JavaScript and URLs for launching web pages.
• Create URL templates for Image Maps.
• Copy Image Maps to other images, or eCatalog pages, or SpinSets.
• Export Image Maps to CSV or to XML.
• Import image metadata from a tab delimited file or from an XML file.
• Define other actions as determined by the World Wide Web Consortium.
• Preview Image Maps.
Drawing and adjusting an Image Map
1 Do one of the following:
• If you are working with an image in the Grid View or List View, in the Edit drop-down list click Image Map. Or,
open it in Detail View, and then click Image Map
above the image.
• If you are working with a SpinSet in the Grid View or List View, click Edit. Or, open it in Detail View, and then
click Edit. Select an image asset, and then click Image Map
.
• If you are working with an eCatalog, in the Grid View, List View, Detail View, click Edit. Click the Map Pages tab.
Last updated 10/9/2014
294
USING SCENE7
Master files
Creating an Image Map.
2 Draw a rectangular or polygonal (many-sided) Image Map:
Rectangular map Select the Rectangle Image Map tool
and drag on the page to create the rectangle. To add a
point to a rectangular map (thus changing it to a polygon map), press Ctrl, then place the insertion tool at the
desired location and click.
Polygonal map Select the Polygon Image Map tool
and click points on the perimeter of the area of the image
you want to enclose. Use the polygon density slider to vary the point density in the polygon. The original density is
remembered if you select other maps. If any point is added, deleted, or moved in the polygon, the original density
is lost and the slider is reset to its maximum value.
3 Enter a name for the Image Map, if desired, in the Image Map list. After you draw an Image Map, Scene7 assigns it
a name.
To create the name, Scene7 appends a sequential number to the name of the image or eCatalog page you are
working with. You can enter a name of your choice.
4 If you want users to open a new web page when they click the Image Map, enter the URL in the Image Map list.
See “Using a template to enter JavaScript and URLs” on page 296.
5 To display rollover text when users move the pointer over your Image Map, enter the text in the Image Map list. In
the Image Map list, select the Show menu and choose Rollover Text. Then enter the text you want users to see
onscreen. You can write the text in a word processor and copy it into the Rollover text field.
6 If you want another action effect to occur when users move the mouse over an Image Map, define the action. In the
Show drop-down list, click Other Actions. Enter the attributes of the action. (Click Show > Both to create rollover
text and an action for an Image Map.)
See “Defining other actions for Image Maps” on page 297.
7 (Optional) Do any of the following:
• Click Preview to preview Image Maps.
Last updated 10/9/2014
295
USING SCENE7
Master files
• To delete an Image Map or polygon vertex, select a shape on the image, and then click Delete. Or, for an
eCatalog, on the Order Pages tab, click Clear Maps to remove Image Maps from all pages.
• To temporarily remove an Image Map from an image, an image in a SpinSet, or an eCatalog page, without
deleting it, deselect the appropriate On option in the Image Map list.
8 Click Save.
Adjusting the position, shape, and size of Image Maps
To change the position, shape, and size of an Image Map, select the Image Map button
and follow these instructions:
. Then select the Pan tool
Changing position Move the pointer near to but not over the border of the Image Map. When you see the four-headed
arrow icon, drag the map to a new location.
Changing the size and shape How you change the shape and size of an Image Map depends on whether you are
working with a rectangular or polygonal Image Map:
• Rectangular Image Map Move the pointer over a side or corner of the Image Map. When you see the doubleheaded arrow icon, start dragging. Hold down the Shift key as you drag to change size but maintain the aspect ratio
(the shape).
• Polygonal Image Map Drag a square selection handle. To create a selection handle, click the border of the Image
Map and start dragging.
You can drag the Size slider at the bottom of the screen to change views and get a better look at your Image Map.
Handling overlapping Image Maps
If your image or eCatalog page includes more than one Image Map and the maps overlap, you can determine how maps
overlap. To do so, change the order of maps on the Image Map list. Drag their names higher or lower on the list. How
high a name is on the list determines whether its Image Map overlaps other Image Maps.
Importing Image Map data
Rather than enter Image Map data on each page, you can import the data for your image, Spin Set, or eCatalog into
the Map Summary screen. You import the Image Map data in the form of a tab-delimited file or XML DTD. The fields
in your file must be in the order shown in the Map Summary screen: Name, TOC Labels, Maps, URLs, Rollover Text,
Other Actions, and Search Strings. Importing Image Map data saves you the trouble of entering the data in the Image
Map List as you create each Image Map.
To import Image Map data
1 Go to the Image Map editor page (for images or images in SpinSets) or the Map Pages tab of the eCatalog editing
screen.
2 Click Import Metadata.
3 In the Upload Metadata dialog box, click Image or Image Map to upload the metadata from desired asset property type.
4 In the Generate File drop-down list, select the type of file that you want to create.
5 (Optional) Click Generate to preview the resulting data based on the type of file you want to create. Click Close to
return to the Upload Metadata dialog box.
6 Browse to the file that you want to upload. In the File Name text field, specify the name of the generated file.
7 (Optional) In the Job Name field, specify a name for the metadata upload job.
Last updated 10/9/2014
296
USING SCENE7
Master files
8 Click Upload.
Copying Image Maps
You can copy Image Maps from an image or an eCatalog page to another. Use Copy Image Map to get a head start
creating them. You can also copy Image Maps to re-create them in images or pages that share the same layout or
mapping structure.
For example, copying Image Maps in an eCatalog is a convenient way to copy all image maps between foreign language
versions of the same eCatalog. For best results, copying is most successful if you copy between eCatalogs with the same
number of pages and same images. If the eCatalog to which you copy already contains Image Maps, be aware that those
Image Maps are deleted when the copy is made.
To copy Image Maps
1 Go to the Image Map editor page (for images or images in SpinSets) or the Map Pages tab of the eCatalog editing
screen.
2 Click Copy Maps to.
3 Do one of the following, based on if you are copying Image Maps from images or copying Image Maps from an
eCatalog:
• (Images) In the Select Images screen, select the images that you want to copy the Image Maps to.
• (eCatalog) In the Select Asset screen, select the images or eCatalog pages that you want to copy the Image Maps to.
4 Click Select.
Using a template to enter JavaScript and URLs
You can define a URL template (also known as an Href template) to make entering Image Map URLs easier and more
efficient. Define a URL template if most of your Image Map URLs share a common, fixed format. By entering the
portion of the URL that is fixed as the URL template, you do not have to enter this portion of the URL each time you
create an Image Map. Your URL Template can also contain JavaScript commands, pathnames, and parameters. By
default, the URL template contains a proprietary Scene7 JavaScript handler called loadProduct that opens the image
in a new window.
Note: Be aware that when you add the Javascript code into the HREF attribute of your image map, the code is run on the
client's computer. Therefore, make sure that the Javascript code is secure.
About URL templates
The URL template works by substituting the contents of the URL column in the Image Map list with the double dollar
signs (‘$$’) in the template:
Javascript:loadProduct('$$');void(0);
You place all of the values that do not change between Image Maps in the URL template. Add only the values that do
change in the URL column in the Image Map list. For example:
• URL template: javascript:loadProduct('http://www.examplesitehere.com/$$');void(0);
• URL value: product.htm
• Actual URL generated:
javascript:loadProduct('http://www.examplesitehere.com/product.html);void(0);
Last updated 10/9/2014
297
USING SCENE7
Master files
By default, the URL template includes a proprietary Scene7 JavaScript handler called loadProduct that opens a new
window with the URL destination. However, you can use any JavaScript code to replace this JavaScript handler or use
one of the following Scene7 handlers:
•
loadProductCW
Displays the URL target specified in the URL column in the current window. This handler is primarily for eCatalogs
that are integrated into a page within a website.
•
loadProductPW
Displays the URL target specified in the URL column in the parent window (the page that opened the current one).
The current window remains open, but the parent window changes to display the URL target.
Note: The handler loadProductPW does not support DHTML and HTML5 viewers.
Creating a URL template
To create a URL template:
1 On the Map Editor screen (images or SpinSets) or the Map Pages tab of the eCatalog screen (eCatalogs), select Edit
next to the URL Template option. The Edit Map Template dialog box opens.
2 Enter the JavaScript code and the complete URL (with the variable portion replaced by dollar signs [$$]). You can
paste the code by right-clicking and choosing Paste.
3 Select the Save button.
Handling URL templates
The Map Editor page (images and SpinSets) and the Map Pages tab of the eCatalog screen (eCatalogs) offer these
commands for handling URL templates:
URL Template option Select the URL Template option to apply your URL template to all the Image Maps on an image
or eCatalog page.
Template option Deselect a Template option in the URL Image Map list if you do not want an individual Image Map
to use the URL template.
Defining other actions for Image Maps
You can select the Show menu and choose Other Actions to trigger actions other than rollover text and web page
launches. When the user moves the pointer over an Image Map, you can initiate an action. These actions are attributes
defined for client-side Image Maps by World Wide Web Consortium HTML specifications. They include:
accesskey Triggers an action when the user presses a designated key on the keyboard.
onfocus Triggers an event when the Image Map receives focus—by the cursor, by tabbing, or by pressing an access
key. For example, you can launch a web page when the Image Map receives focus and close it when your Image Map
loses focus.
onblur Triggers an event when the Image Map loses focus, either by the cursor or by tabbing.
To define other actions for Image Maps
1 On the Map Editor screen (images and SpinSets) or Map Pages tab of the eCatalog screen (eCatalogs), select the
Show menu and choose Other Actions.
2 Using the syntax specified by the World Wide Web Consortium HTML specifications, add the supported attributes
in the Other Actions column of the Image Map list.
Last updated 10/9/2014
298
USING SCENE7
Master files
3 Click Save.
Select the Show menu and choose Both if you want an Image Map to have rollover text as well as an action.
Creating Image Maps in Adobe Acrobat or Adobe InDesign
You can create Image Maps while designing your eCatalog in Adobe Acrobat or Adobe InDesign.
In Acrobat or InDesign, create hyperlink references where you want the Image Maps to appear, and specify URL
locations for the image map. Selecting the Extract Links option when uploading the PDF file into Scene7 automatically
converts the links to Image Maps.
For more information, see InDesign Help or Acrobat Help.
To create Image Maps in Adobe InDesign
1 In InDesign, click Window > Interactive > Hyperlinks to open the Hyperlinks panel.
2 Select the text, frame, or graphic that you want to make into an Image Map.
3 In the Hyperlinks panel, click New Hyperlink from the panel menu.
4 In the New Hyperlink dialog box, choose URL from the Link To menu.
5 Type or paste the product ID in the URL box, and click OK. (Scene7 completes the URL using the Image Map URL
template.)
Note: You do not need to set appearance options in InDesign. You can specify appearance in Scene7.
6 Repeat steps 2 through 5 for all the Image Maps you want to create.
7 Export the file as a PDF.
8 Upload the PDF to Scene7 and select Extract Links from the PDF Options.
To create Image Maps in Adobe Acrobat
1 In Acrobat, choose Tools > Advanced Editing > Link Tool.
2 Drag to create the Image Map. The Create Link box opens.
3 Select Custom Link, and click Next.
Note: You do not need to set appearance options in Acrobat. You can specify appearance in Scene7.
4 In the Link Properties box, click Actions.
5 Select Open A Web Link from the Select Action menu, and then click Add.
6 Type the product ID for the Image Map in the Edit URL box, and click OK. (Scene7 completes the URL using the
image map URL template.)
7 Repeat steps 1 through 7 for all the Image Maps you want to create.
8 Save the file.
9 Upload the PDF to Scene7 and select Extract Links from the PDF Options.
Last updated 10/9/2014
299
USING SCENE7
Master files
Cropping an image
You can crop images in the Scene7 Publishing System. The system retains information about images that were cropped
so you can restore them to their original state. You can also crop an image and save the cropped version under a new
name.
You can crop an image to remove white space around it, or crop an area of the image.
Note: After you crop, you can click the Save As button and save a cropped version of the image under a different name.
In the Save As window, choose Save As New Master to save a second copy of the image. Choose Save As Addition View
Of Master to save the original and its cropped version under a different name. Choose Replace Original to delete the
original file from which you cropped your image. Then enter a name for the image and select the Submit button.
More Help topics
“Image editing options at upload” on page 305
“Cropping white space from a PDF file” on page 309
“Cropping from the sides of PDF pages” on page 309
Crop to remove white space around an image
You can crop off the transparent or solid-color pixels from the edge of an image.
1 To crop an image, click its rollover Edit button and choose Crop, or display it in the Browse Panel in Detail view
and click the Crop button
. The Crop Editor screen opens.
2 Do one of the following:
• To trim color pixels, select the Trim menu and choose Color. The Auto Crop By Color dialog box appears. Select
the Corner menu and choose a corner with the background color to crop away. Then enter a Tolerance setting
from 0 through 1. The 0 setting crops pixels only if they exactly match the color you selected in the corner of the
image. Numbers closer to 1 allow for more color difference. Select the Crop button.
• To trim transparent pixels, select the Trim menu and choose Transparent. The Auto Crop By Transparency
dialog box appears. Enter a tolerance setting from 0 through 1. The 0 setting crops crop pixels only if they are
totally transparent. Numbers closer to 1 allow for more transparency. Select the Crop button.
3 Click Save.
Note: To restore an image to its original state after you’ve cropped it, display the image in the Crop Editor screen and
select the Reset button.
Select an area to crop
1 To crop an image, click its rollover Edit button and choose Crop, or display it in the Browse Panel in Detail view
and click the Crop button
. The Crop Editor screen opens.
2 Place the part of the image you don’t want to crop in the crop box. What appears inside the box remains when you
select the Save button and crop the image.
3 To adjust the crop area, do one of the following:
• Drag a side or corner of the box. Hold down the Shift key as you drag to change size but maintain the aspect
ratio (the shape) of the crop box.
• Enter pixel measurements in the Size boxes.
Last updated 10/9/2014
300
USING SCENE7
Master files
• Drag to move the crop box. Move the pointer inside the boundary of the box. When you see the four-headed
arrow, drag the box to a new location on the image.
4 Click Save.
Note: To restore an image to its original state after you’ve cropped it, display the image in the Crop Editor screen and
select the Reset button.
Sharpening an image
Sharpening is an image-manipulation technique for making the outlines of a digital image look more distinct.
Sharpening increases the contrast between edge pixels and emphasizes the transition between dark and light areas.
Sharpening increases local contrast and brings out fine detail. There is no strict formula for correctly sharpening all
images. Too little sharpening can make for a soft image, but over-sharpening adds halos, artifacts, and noise.
Scene7 highly recommends using Image Presets for all images. This ensures a uniform size, and sharpening is enforced
on any image called with an Image Preset. Furthermore, you can edit and change an Image Preset’s sharpening
parameters quite easily. The next time you publish, all images called with that preset are given the new values.
Scene7 also recommends adding sharpening to Viewer Presets, and then calling a viewer with that preset. This ensures
that images within your viewers are crisp and appealing.
However, whether you use Image Presets and Viewer Presets, or some alternate method of sharpening, the bottom line
is that you should sharpen your images. If you do not, your images (and website) might look soft and fuzzy.
Important: The Sharpen commands override Image Preset settings, including their sharpening effects. An Image Preset
governs the size and formatting with which images are delivered from Scene7 Image Servers. Scene7 highly recommends
using Image Presets to deliver all images to make sure that images are delivered at a uniform size and sharpening. After
the sharpening settings of an individual image have been changed, however, Image Preset sharpening settings no longer
apply to the image. It is delivered without Image Preset sharpening settings.
It is often necessary to sharpen images. Scene7 SPS and Image Servers offer several sharpening options. It is important
to understand what sharpening does to an image and how much sharpening you need. Most images need some
sharpening but the amount required depends upon the image.
Image sharpening increases the contrast of pixels to create the effect of accentuating edges. Humans perceive this
enhanced edge contrast as sharpness. Although it is easy to enhance an image by running sharpening filters on an
image, it is also easy to over-sharpen an image.
Over sharpening an image creates a halo effect, or banding of the edge’s lines.
There are best practices you can follow to optimize the sharpening of your images in Scene7 Publishing System and on
Scene7 Image Server.
See Best practices for sharpening images in Scene7 Publishing System and on Scene7 Image Server.
To sharpen an image
To sharpen an image, click its rollover Edit button and choose Sharpen, or open it in the Browse Panel in Detail view
. The Sharpness Editor screen opens with sharpening commands. Choose commands
and click the Sharpen button
and select the Save button.
Before sharpening an image, you can select the Apply Preset menu and choose an Image Preset to see what its
sharpening effects are. The sharpening effects of an Image Preset may be suitable for your image. The Apply Preset
menu is located on the bottom of the Sharpness Editor screen.
Last updated 10/9/2014
301
USING SCENE7
Master files
Sharpening options
The following table shows the Image Server sharpening options.
Name
URL Protocol
Values
Example
Simple
Sharpening
op_sharpen
0 | 1
op_sharpen=1
Resample Mode
resMode
bilin | bicub | sharp2 | trilin
resMode=sharp2
bilin: Selects standard bi-linear interpolation.
Fastest resampling method; some aliasing artifacts
may be noticeable.
bicub: Selects bi-cubic interpolation. More CPUintensive than bilin, but yields sharper images
with less noticeable aliasing artifacts.
sharp2: Selects a modified Lanczos Window
function as an interpolation algorithm. May
produce slightly sharper results than bi-cubic at a
higher CPU cost.
trilin: Selects a modified trilinear interpolation,
which uses both higher and lower resolutions, if
available. Recommended only when aliasing is an
issue. Reduces JPEG sizes due to reduced high
frequency data.
Unsharp Mask
op_usm
amount, radius, threshold, monochrome
op_usm=1,1,10,0
amount: filter strength factor (real 0…5)
radius: filter kernel radius in pixels (real 0…250)
threshold: filter threshold level (int 0…255)
monochrome: set to 0 to unsharp-mask each color
component separately, set to 1 to unsharp-mask
image brightness (intensity)
Select the Sharpening menu and choose an option:
None Disables sharpening.
Sharpen Runs a simple sharpening pass on the file after it is resized. This is similar to the “Sharpen” filter in Photoshop
and does support any user parameters. Normally, you would use this filter or Unsharp Mask but not both. As a best
practice, this method is not recommended, but it can help compensate for blurriness. (URL: op_sharpen)
Unsharp Mask Allows you to fine-tune a sharpening filter effect on the final downsampled image. You can control
intensity of effect, radius of the effect (measured in pixels) and a threshold of contrast that will be ignored. This effect
uses the same options as Photoshop’s “Unsharp Mask” filter. (URL: op_usm)
Choose these options to fine-tune sharpening with Unsharp Mask:
• Amount Controls the amount of contrast applied to edge pixels. The default is 0.0. For high-resolution images, you
can increase it to as high as 5.0. Think of Amount as a measure of filter intensity. Be aware that the Amount setting in
Scene7 is not the same as the Amount setting in Photoshop. Photoshop uses an amount in the range of 1% to 500%,
whereas Scene7 scales from 0.0 to 5.0. (5.0 is roughly equivalent to 500% in Photoshop, 0.9 is similar to 90%, and so on.)
• Radius Determines the number of pixels surrounding the edge pixels that affect the sharpening. The effect runs on
all pixels in the image and radiates in all directions.
The best radius value depends on the size of the image. A low value sharpens only the edge pixels. A high value
sharpens a wider band of pixels.
Last updated 10/9/2014
302
USING SCENE7
Master files
For example, to get a similar sharpening effect for a 2000 x 2000 pixel image and 500x 500 pixel image, you might set
a radius value of two pixels on the 2000 x 2000 pixel image. Then, set a radius value of one pixel on the 500 x 500 pixel
image (a larger value for an image with more pixels).
• Threshold Determines the range of contrast to ignore when the unsharp mask filter is applied. This option
determines how different the sharpened pixels must be from the surrounding area before they are considered edge
pixels and are sharpened.
Threshold uses a value from 0-255, which is the number of brightness steps in a grayscale image. 0=black, 128=50%
gray and 255=white. For example, a threshold value of 12 ignores slight variations is skin tone brightness, so as not to
add noise, while still adding edge contrast to contrasty areas, such as where eyelashes meet skin.
As an example, suppose you have a photo of someone’s face. The Unsharp Mask affects the parts of the image with the
most contrast and the smooth skin itself. Even the smoothest skin exhibits subtle changes in brightness values. If you
do not use a threshold value, the filter accentuates these subtle changes in skin pixels, creating a noisy effect (probably
undesirable) while also increasing the contrast on the eyelashes, enhancing sharpness (probably desirable). To avoid
this issue, use a threshold value that tells the filter to ignore pixels that do not change contrast dramatically, like smooth
skin. To avoid introducing noise, experiment with values between .02 and 0.2. The default value of 0 sharpens all pixels
in the image.
• Apply To Choose Each Color to apply sharpening separately to each color component; choose Brightness to apply
to sharpening to image brightness areas.
Resampling
Select the Resampling menu and choose an option. These options sharpen the image when it is downsampled:
None Turns off resampling.
Bilinear The fastest resampling method; some aliasing artifacts are noticeable.
Bicubic Increases CPU usage on the Image Server, but yields sharper images with less noticeable aliasing artifacts.
Sharpen2 May produce slightly sharper results than the Bicubic option, but at even higher CPU cost on the Image
Server.
Trilinear Uses both higher and lower resolutions if available; recommended only when aliasing is an issue. This
method reduces JPEG size due to reduced high-frequency data.
Sharpening and image presets
You could mix all three sharpening effects to achieve your final result. However, this is not recommended. Scene7
recommends you save your sharpening effects as part of an Image Preset.Image Presets allow you to package the most
often used image modifiers to create a dynamically resized image in a small text string. An Image Preset contains values
for the file format (usually JPEG for the web), pixel count and image sharpening. Instead of appending the URL with
each image modifier needed to create a specific type of image size, you create a named Image Preset, such as
“thumbnail,” configure the thumbnail Image Preset with the appropriate size, file format, and sharpening options, and
then call the image using the Image Preset name. Image Presets shorten the length of the overall URL.These two URLs
produce the same 350x350 JPEG image with sharpening:
•
http://sample.scene7.com/is/image/S7train/Backpack_A?wid=350&hei=350&fmt=jpeg&qlt=85,0&resM
ode=sharp2&op_usm=0.9,1.0,8,0
•
http://sample.scene7.com/is/image/S7train/Backpack_A?$!_s7product$
Image Presets can be changed and updated at any time. You will see the results of a change to an Image Preset after
you publish and after the cache for the URL clears.
Last updated 10/9/2014
303
USING SCENE7
Master files
If you use one preset for every image in a size category, any Company Administrator can update the definition of that
Image Preset, republish, and affect every image using that format, without changing any web code. As a best practice,
use one Image Preset per unique size on your site. To add an image preset, go to Setup > Application Settings > Image
Presets. Then, Add or Edit an existing preset. The only required field is the name of the preset itself. However, you
should include some level of sharpening in every preset.
JPG Quality
The JPG Quality options control the JPG compression level:
JPG Quality Select this option if you want to control compression levels and chrominance downsampling.
Slider Determines the JPG compression level. This setting affects both file size and image quality. The JPG quality
scale is 1–100.
Enable JPG Chrominance Downsampling Because the eye is less sensitive to high-frequency color information than
high-frequency luminance, JPEG images divide image information into luminance and color components. When a
JPEG image is compressed, the luminance component is left at full resolution, while the color components are
downsampled by averaging together groups of pixels. Downsampling reduces the data volume by one half or one third
with almost no impact on perceived quality. Downsampling is not applicable to grayscale images. This technique
reduces the amount of compression useful for images with high contrast (for example, images with overlaid text).
Setting company-wide sharpening options
If you do not use an Image Preset or pass specific Image Server sharpening protocols along the URL string, then your
image is not sharpened when it is downsampled. However, you may set default sharpening values if this occurs and
then any image will always have some sharpening.
To set your company’s default sharpening options, go to Setup > Application Setup > Publish Setup > Image Server. If
you set the Default Resampling Mode to Sharp2, it will always sharpen the image when downsampling.
Adding sharpening to viewer presets
Unless you add sharpening image modifiers to the preset, the small initial load image can look soft because it is
downsampled to fit into the viewer window without being sharpened.
In SPS, Viewer Presets (like Image Presets) allow you to centralize many options into one location, including choice
of skin and viewer options (such as including a Print button or controlling the speed of the zoom animation). Viewer
Presets are found in the same section as Image Presets, under Setup > Application Settings > Viewer Presets.
The Modifiers option is found under the Core Settings section of all eCatalog, Spin, and Custom Zoom Viewer Presets.
By adding the URL sharpening commands to the Modifiers box, you add sharpening every time that viewer is called
with that viewer preset.
To call the Viewer Preset, use the config= command on the viewer URL. Here is an example of calling an Image Set
(shoes) with a Viewer Preset (FantasticoZoom2009):
http://sample.scene7.com/s7/zoom/flasht_zoom.jsp?company=S7train&sku=shoes&config=S7train/Fa
ntasticoZoom2009&locale=en
The preset here sharpens and changes the default skin of the viewer.
Last updated 10/9/2014
304
USING SCENE7
Master files
Creating image-specific overrides
The last, and least recommended, sharpening method is to create sharpening overrides on an image-by-image basis.
This overrides the sharpening in an Image Preset with its own specific values. However, this overrides all other
sharpening methods at any size. The best use case for this method is if some of your images are not high resolution,
and the values in the Image Presets are too high for these small images. In this case, some per-image sharpening might
be needed.
In SPS, select any image, go to the Detail View (by double-clicking or pressing the Detail View button), and click
Sharpen. Change any parameter, then click Save. This tells the Image Server to use these sharpening parameters rather
than any command you call in the URL, such as a sharpening modifier or Image Preset. You must publish to see the
changes take effect.
Adjusting an image
Scene7 offers various commands for adjusting the appearance of an image. You can flip, rotate, blur, alter the color
balance, and colorize an image. As you experiment with these commands, you can see their effects on the image you
are working with.
See also “Creating an alias for an image” on page 305.
1 Click the image’s rollover Edit button and choose Adjust, or in the Browse Panel, double-click the image to open it
in Detail view.
2 Select a size and Image Preset (in the bottom of the window).
3 Use the commands on the right side of the Adjust Editor window to adjust the image:
• Use the Flip options to flip an image horizontally or vertically.
• Use the Rotate slider to rotate the image. You can enter values in the Rotate field to rotate an image. Positive
values rotate it clockwise; negative values rotate it counterclockwise.
• Use the Blur slider or its corresponding box to blur an image. The higher the value, the more blurry the image
becomes.
• Use the Contrast, Brightness, Saturation, Hue, and Color Balance options to adjust the color and brightness.
These effects are cumulative. For example, changes to the Magenta/Green settings are added to changes made
to the Hue settings.
• Use the Colorize options to colorize an image while preserving shadows and highlights. Changes to the Colorize
options are also cumulative. Choose the Brightness menu and choose No Compensation to disable automatic
brightness compensation. Set the contrast value to 0 to preserve the contrast range of the original image, or
specify a contrast range with a value greater than 0. A value of 100 maximizes the contrast. Typical values are in
the 30–70 range.
4 When you have finished adjusting the image, do one of the following:
• Click Save.
• To replace the original of the image, click Save As.
In the drop-down list, select Replace original, and then click Save.
• To save the image as a new master image, click Save As.
In the drop-down list, select Save as new master.
In the Folder Name list box, select the folder where you want the new master image saved.
Last updated 10/9/2014
305
USING SCENE7
Master files
Click Save.
• To save the image as additional view of the master image. you can create an alias for it. Click Save As.
In the Save As dialog box, in the drop-down list, click Save as additional view of master.
In the Folder Name list box, select the folder where you want the new master image saved.
Click Save.
Creating an alias for an image
When you have adjusted an image, you may want to save it as additional view of the master image. To do so, you can
create an alias for the image by using the Save as additional view of master feature.
1 In the Grid View or List View, in the Edit drop-down list next to an image for which you want to create an alias,
click Adjust.
2 In the lower-right corner of the page, click Save As.
3 In the Save As dialog box, in the drop-down list, click Save as addition view of master.
4 In the Folder Name list box, select the folder where you want to save the aliased image.
5 In the File Name field, type the name you want to use for the alias.
6 Click Save.
Image editing options at upload
When uploading image files, including AI, EPS, and PSD files, you can take the following editing actions in the Upload
Job Options dialog box:
• Crop white space from the edge of images.
• Crop manually from the sides of images.
• Choose a color profile.
• Create a mask from a clipping path.
• Sharpen images with unsharp masking options
• Knockout Background
These options are located on the Upload screen under Image Editing Options.
Cropping white space from images
To automatically crop white-space pixels from an image, select the Crop menu and choose Trim. Then choose these
options:
Trim Away Based On Choose whether to crop based on color or transparency:
• Color Choose the Color option. Then, from the Corner drop-down list, select the corner of the image with the color
that best represents the white-space color you want to crop.
• Transparency Choose the Transparency option.
Last updated 10/9/2014
306
USING SCENE7
Master files
Tolerance Drag the slider to specify a tolerance from 0 through 1:
• Trimming based on color Specify 0 to crop pixels only if they exactly match the color you selected in the corner of
the image. Numbers closer to 1 allow for more color difference.
• Trimming based on transparency Specify 0 to crop pixels only if they are totally transparent; numbers closer to 1
allow for more transparency.
Cropping manually from the sides of images
To manually crop from the sides of an image, select the Crop menu and choose Manual. Then enter the number of
pixels to crop from any side or each side of the image. How much of the image is cropped depends on the ppi (pixels
per inch) setting in the image file. For example, if the image displays 150 ppi and you enter 75 in the Top, Right,
Bottom, and Left text boxes, a half-inch is cropped from each side.
Choosing a color profile
Choose a Color Profile option to select a color space for the image:
Convert To sRGB Converts to sRGB (Standard Red Green Blue). sRGB is the recommended color space for displaying
images on web pages.
Keep Original Color Space Retains the original color space.
Custom From > To Opens menus so you can choose a Convert From and Convert To color space. You can choose a
standard Photoshop color space or a color space you uploaded to SPS.
See “ICC profiles” on page 315.
Creating a mask from a clipping path
Select Create Mask From Clipping Path to create a mask for the image based on its clipping path information. This
option applies to images created with image-editing applications in which a clipping path was created.
Sharpening an image using Unsharpen Mask
This filter lets you fine-tune a sharpening filter effect on the final downsampled image, controlling the intensity of the
effect, the radius of the effect (as measured in pixels), and a threshold of contrast that is ignored.
This effect uses the same options as Photoshop’s Unsharp Mask filter. Contrary to what the name suggests, Unsharp
Mask is a sharpening filter.
Under Unsharp Masking, set the options you want. Setting options are described in the following table:
Last updated 10/9/2014
307
USING SCENE7
Master files
Unsharp Mask
options
Description
Amount
Controls the amount of contrast that is applied to edge pixels.
Think of it as the intensity of the effect. The main difference between the amount values of
Unsharp Mask in SPS and the amount values in Adobe Photoshop, is that Photoshop has an
amount range of 1% to 500%. Whereas, in SPS, the value range is 0.0 to 5.0. A value of 5.0 in SPS
is the rough equivalent of 500% in Photoshop; a value of 0.9 is the equivalent of 90%, and so on.
Radius
Controls the radius of the effect. The value range is 0-250.
The effect is run on all pixels in an image and radiates out from all pixels in all directions. The
radius is measured in pixels. For example, to get a similar sharpening effect for a 2000 x 2000 pixel
image and 500 x 500 pixel image, you would set a radius of two pixels on the 2000 x 2000 pixel
image and a radius value of one pixel on the 500 x 500 pixel image. A larger value is used for an
image that has more pixels.
Threshold
Threshold is a range of contrast that is ignored when the Unsharp Mask filter is applied. This is
important so that no "noise" is introduced to an image when this filter is used. The value range is
0-255, which is the number of brightness steps in a grayscale image. 0=black, 128=50% gray and
255=white.
For example, a threshold value of 12 ignores slight variations is skin tone brightness to avoid
adding noise, but still add edge contrast to contrasty areas such as where eyelashes meet skin.
For example, if you have a photo of someone’s face, the Unsharp Mask affects the contrasty parts
of the image, such as where eyelashes and skin meet to create an obvious area of contrast, and
the smooth skin itself. Even the smoothest skin exhibits subtle changes in brightness values. If
you do not use a threshold value, the filter accentuates these subtle changes in skin pixels. In
turn, a noisy and undesirable effect is created while contrast on the eyelashes is increased,
enhancing sharpness.
To avoid this issue, a threshold value is introduced that tells the filter to ignore pixels that do not
change contrast dramatically, like smooth skin.
In the zipper graphic shown earlier, notice the texture next to the zippers. Image noise is
exhibited because the threshold values were too low to suppress the noise.
Monochrome
Select to unsharp-mask image brightness (intensity).
Deselect to unsharp-mask each color component separately.
See also “Sharpening an image” on page 300.
See also Sharpening images in Scene7 Publishing System and on Image Server.
Knockout Background
You can use Knockout Background to automatically remove the background of an image when you upload it. This
technique is useful to draw attention to a particular object and make it stand out from a busy background.
Last updated 10/9/2014
308
USING SCENE7
Master files
KnockOut
Background
options
Description
Knockout
Background
Select to enable or “turn on” the Knockout Background feature and options..
Corner
Required.
The corner of the image that is used to define the background color to knockout.
You can choose from Upper Left, Bottom Left, Upper Right, or Bottom Right.
Fill Method
Required.
Controls pixel transparency from the Corner location that you set.
You can choose from the following fill methods:
Tolerance
•
Flood Fill - turns all pixels transparent that match the Corner that you have specified and are
connected to it.
•
Match Pixel - turns all matching pixels transparent, regardless of their location on the image.
Optional.
Controls the allowable amount of variation in pixel color matching based on the Corner location
that you set.
Use a value of 0.0 to match pixel colors exactly or, use a value of 1.0 to allow for the greatest
variation.
More Help topics
“Cropping an image” on page 299
Working with PDFs
PDF (Portable Document Format) files are most often used in Scene7 to create eCatalogs. When you upload a PDF
file, Scene7 rasterizes, or rips, the pages by default so that the pages can be used to build rich media.
PDF upload options
When you upload a PDF file, you can format it in various ways. You crop its pages, extract search words, enter a pixelsper-inch resolution, and choose a color space. PDF files often contain a trim margin, crop marks, registration marks,
and other printer’s marks. You can crop these marks from the sides of pages as you upload a PDF file.
Options for uploading PDF files are located on the Upload screen under PDF Options.
Processing
The Processing options are as follows:
Rasterize (Default) Rips the pages in the PDF file and converts vector graphics to bitmap images. Choose this option
to create an eCatalog.
Extract Search Words Extracts words from the PDF file so that the file can be searched by keyword in an eCatalog
Viewer.
Extract Links Extracts links from the PDF files and coverts them to Image Maps that are used in an eCatalog Viewer.
Last updated 10/9/2014
309
USING SCENE7
Master files
Auto-Generate eCatalog With Multiple Page PDF Automatically creates an eCatalog from the PDF file. The eCatalog
is named after the PDF file you uploaded. (This option is only available if you rasterize the PDF file as you upload it.)
Resolution
Determines the resolution setting. This setting determines how many pixels are displayed per inch in the PDF file. The
default is 150.
Color Space
Select the Color Space menu and choose a color space for the PDF file. Most PDF files have both RGB and CMYK color
images. The RGB color space is preferable for online viewing.
Detect Automatically Retains the color space of the PDF file.
Force As RGB Converts to the RGB color space.
Force As CMYK Converts to the CMYK color space.
Force As Grayscale Converts to the Grayscale color space.
Color Profile
Choose a Color Profile option:
Convert To sRGB Converts to sRGB (Standard Red Green Blue). sRGB is the recommended color space for displaying
images on web pages.
Keep Original Color Space Retains the original color space.
Custom From > To Opens menus so you can choose a Convert From and Convert To color space. You can choose a
standard Photoshop color space or a color space you uploaded to SPS.
See “ICC profiles” on page 315.
Cropping white space from a PDF file
1 To automatically crop white-space pixels from a PDF file as you upload it, select the Crop menu and choose Trim.
2 Specify the following options:
Trim Away Based On Choose whether to crop based on color or transparency:
• Color Choose the Color option. Then select the Corner menu and choose the corner of the PDF with the color
that best represents the white-space color you want to crop.
• Transparency Choose the Transparency option.
Tolerance Drag the slider to specify a tolerance from 0 through 1:
• Trimming based on color Specify 0 to crop pixels only if they exactly match the color you selected in the corner
of the PDF. Numbers closer to 1 allow for more color difference.
• Trimming based on transparency Specify 0 to crop pixels only if they are totally transparent; numbers closer to
1 allow for more transparency.
Cropping from the sides of PDF pages
You can manually remove printer’s marks from the sides of the pages in a PDF file as you upload it.
1 Select the Crop menu and choose Manual.
Last updated 10/9/2014
310
USING SCENE7
Master files
2 Enter pixel settings in the Top, Right, Bottom, and Left text boxes to crop from the top, bottom, and sides of pages.
How much of the page is cropped depends on the Resolution PX/Inch setting you enter for the PDF file. For example,
if you enter 150 (the default) as the Resolution PX/Inch setting and you crop 75 pixels from the sides of pages, a halfinch is cropped because, at 150 pixels per inch, 75 pixels equals a half-inch.
Working with PSD files
PSD (Photoshop Document files) are most often used in Scene7 to create templates. When you upload a PSD file, you
can create a Scene7 template automatically from the file (select the Create Template option on the Upload screen).
SPS creates multiple images from a PSD file with layers if you use the file to create a template; it creates one image for
each layer.
PSD upload options
Options for uploading PSD files are located under Photoshop Options in Upload Job Options. You can crop a file,
choose a color profile for it, use it to create a template, and select an anchor.
These options are available when uploading PSD files:
Crop (located under Crop Options.) Choose Trim to automatically crop white space from the edges of a PSD file;
choose Manual to crop sides of the PSD file:
• Trim Select the Trim Away Based On menu and choose Color or Transparency.
If you choose the Color option, select the Corner menu and choose the corner of the PSD with the color that best
represents the white-space color you want to crop.
Drag the slider to specify a tolerance from 0 through 1:
To trim based on color, specify 0 to crop pixels only if they exactly match the color you selected in the corner of the
PSD. Numbers closer to 1 allow for more color difference.
To trim based on transparency, specify 0 to crop pixels only if they are totally transparent; numbers closer to 1 allow
for more transparency.
• Manual Enter the number of pixels to crop from any side or each side of the image. How much of the image is
cropped depends on the ppi (pixels per inch) setting in the image file. For example, if the image displays 150 ppi and
you enter 75 in the Top, Right, Bottom, and Left text boxes, a half-inch is cropped from each side of the image.
Color Profile (Located under Color Profile Options.) Choose an option:
• Convert To sRGB (default) Converts to sRGB (Standard Red Green Blue). sRGB is the recommended color space
for displaying images on web pages.
• Keep Original Color Space Retains the original color space of the image.
• Custom From > To Opens menus so you can choose a Convert From and Convert To color space. You can choose
a standard Photoshop color space or a color space you uploaded to SPS. See “ICC profiles” on page 315.
Maintain Layers Rips the layers in the PSD, if any, into individual assets. The asset layers remain associated with the
PSD. You can view them by opening the PSD file in Detail view and selecting the layer panel. See “Viewing and editing
layers in a PSD file” on page 311.
Create Template Creates a template from the layers in the PSD file.
Extract Text Extracts the text so that users can search for text in a Viewer.
Last updated 10/9/2014
311
USING SCENE7
Master files
Extend Layers To Background Size Extends the size of ripped image layers to the size of the background layer.
Layer Naming Layers in the PSD file are uploaded as separate images. Choose an option to name these images in the
Scene7 Publishing System:
• Layer Name Names the images after their layer names in the PSD file. For example, a layer named Price Tag in the
original PSD file becomes an image named Price Tag. However, if the layer names in the PSD file are default Photoshop
layer names (Background, Layer 1, Layer 2, and so on), the images are named after their layer numbers in the PSD file,
not their default layer names.
• Photoshop and Layer Number Names the images after their layer numbers in the PSD file, ignoring original layer
names. Images are named with the Photoshop filename and an appended layer number. For example, the second layer
of a file called Spring Ad.psd is named Spring Ad_2 even if it had a non-default name in Photoshop.
• Photoshop and Layer Name Names the images after the PSD file followed by the layer name or layer number. The
layer number is used if the layer names in the PSD file are default Photoshop layer names. For example, a layer named
Price Tag in a PSD file named SpringAd is named Spring Ad_Price Tag. A layer with the default name Layer 2 is called
Spring Ad_2.
Anchor Specify how images are anchored in templates that are generated from the layered composition produced
from the PSD file. By default, the anchor is the center. A center anchor allows replacement images to best fill the same
space, no matter the aspect ratio of the replacement image. Images with a different aspect that replace this image, when
referencing the template and using parameter substitution, effectively occupy the same space. Change to a different
setting if your application requires the replacement images to fill the allocated space in the template.
Viewing and editing layers in a PSD file
If you selected the Maintain Layers option when you uploaded your PSD, Scene7 ripped the individual layers into
assets. You can view and edit the asset layers belonging to a PSD file by opening the file in the Browse Panel in Detail
view.
1 Double-click the full PSD file in the Browse Panel to open it in Detail view.
Note: Make sure that you open the full asset and not one of the PSD layers.
2 Click Layers to open the Layers panel. All the layers appear as separate images in the Layers panel.
3 Double-click a layer to open it and do any of the following:
• Click the Image Map icon to create an image map on the layer. (See “Creating Image Maps” on page 293.)
• Click the Zoom Targets icon to create zoom targets on the layer. (See “Creating zoom targets for Guided Zoom”
on page 128.)
• Click the Crop icon to crop the layer. (See “Cropping an image” on page 299.)
• Click Sharpen to sharpen the layer. (See “Sharpening an image” on page 300.)
• Click the Adjust to adjust the layer. (See “Adjusting an image” on page 304.)
4 Click Save or Save As.
5 To view or edit a different layer, click an arrow at the bottom of the layer preview.
6 To exit the layer Detail view, click the Grid view icon.
Last updated 10/9/2014
312
USING SCENE7
Master files
Working with PostScript and Illustrator files
You can use Adobe® PostScript® (EPS) and Adobe® Illustrator® (AI) files in the Scene7 Publishing System. Scene7 offers
commands for configuring these files as you upload them.
When you upload PostScript (EPS) or Illustrator (AI) image files, you can format them in various ways. You can
rasterize the files, convert them to FXG for Template Publishing, maintain the transparent background, choose a
resolution, and choose a color space. Options for formatting PostScript and Illustrator files are available on the Upload
screen under PostScript Options and Illustrator Options in the Upload Job Options box.
Processing Choose Rasterize to convert vector graphics in the file to the bitmap format.
Maintain Transparent Background In Rendered Image Maintains the background transparency of the file.
Resolution Determines the resolution setting. This setting determines how many pixels are displayed per inch in the file.
Color Space Select the Color Space menu and choose a color space:
• Detect Automatically Retains the color space of the file.
• Force As RGB Converts to the RGB color space.
• Force As CMYK Converts to the CMYK color space.
• Force aA Grayscale Converts to the Grayscale color space.
Working with vignette, window covering, and cabinet
files
Users of the Scene7 Image Authoring tool can use vignettes (VNT files), window coverings (VNW files), and cabinets
(VNC files) in Scene 7. These files cannot be created or edited in the Scene7 Publishing System.
Vignettes, window coverings, and cabinets are authored images. Using a different Scene7 program called Image
Authoring, you mask objects in an image so users can see the same image in a variety of textures or colors. For example,
users see a couch upholstered with a variety of fabrics, a window decorated with a variety of window treatments, or a
cabinet finished with different types of wood.
Upload vignettes, window covering, and cabinets as you would any other file.
Working with Viewer SWF files
In the Scene7 Publishing System, SWF files are used as user-interface skins for the different Viewers. When users
configure a viewer, they can choose a SWF skin for it. Viewer SWFs work in combination with the other viewer
configuration settings to determine how a viewer looks and works.
As well as choosing a SWF file that determines the overall look of a viewer, users can choose SWFs that do the
following:
• Display a loading animation when a viewer first appears.
• Determine the appearance of the Help topics available for the viewer.
• Play a waiting animation when a viewer is waiting for a response.
Last updated 10/9/2014
313
USING SCENE7
Master files
Note: The Scene7 Publishing System provides default SWFs for the loading animation and waiting animation. You can
use these default SWFs or choose loading and waiting SWFs of your own. Unless you choose a Help button SWF file for
a viewer, the Help button is hidden by default.
Before you can choose SWFs for a viewer, upload the SWF files to SPS and publish the files.
More Help topics
“Viewer Presets” on page 32
Last updated 10/9/2014
314
Chapter 22: Support files
Support files are files that Scene7 uses to display fonts and convert image files from one color space to another. Support
files also include XML files and various other types of files.
For a complete list of supported file formats, see “Supported asset file formats” on page 79.
Fonts
In some cases, the Scene7 Publishing System requires you to upload a font file to enter or render text in a particular
font. For example, to use a particular font for text on a template layer, upload the font file. To display eCatalog Viewer
page numbers in a particular font, upload the font file.
Scene7 supports these font types:
• All TrueType fonts
• PostScript® fonts
• OpenType/TrueType fonts
• OpenType/PostScript fonts
• PhotoFonts
After a font file has been uploaded, you can change its SPS ID, font name, and type information on the Edit Info screen.
Important: Scene7 recommends uploading all font styles (bold, italic, bold/italic, and regular) if you plan to use fonts in
template layers. Scene7 needs these font styles to process requests. Uploading all PostScript/Adobe Type 1 files associated
with a font is also recommended because some of these fonts contain detailed kerning information.
Uploading font files
Upload font files with the same techniques you use to upload other files. You can store font files in any SPS folder. See
“Uploading your files” on page 83.
Editing font file information
You can change the ID name of a font as well as its type information. Editing a font file can be helpful in searches and
making fonts easier to identify.
In the Browse Panel, select the font file you want to edit in Detail view and choose File > Edit Info. The Edit Info screen
opens. Choose the following options and select the Submit button.
Font Name This name identifies the font when it is published.
PostScript Name This name is the full PostScript name for the font. It usually indicates the weight or style.
RTF Name This name appears on a pop-up menu in the RTF editor where template text layers are created.
Font Family Name This name lists the font name without the style, weight, or font-type indicator.
Font Style The options are Plain, Bold, Italic, and Bold-Italic.
Font Type The options are TrueType and Adobe Type 1. If you call these fonts by another name, you can enter it.
Last updated 10/9/2014
315
USING SCENE7
Support files
Font Type Abbreviation The options are as follows:
• TTF TrueType font files used for PDF/PostScript rendering and image serving.
• AFM Adobe PostScript font files that contain Adobe Font Metrics information and are used for image serving.
• PFM Adobe PostScript font files that contain binary font metric information.
• PFB Adobe PostScript font files that contain binary font outline information and are used for PDF/PostScript
rendering and image serving.
ICC profiles
An ICC (International Color Consortium) profile is a file that describes how to correctly convert image files from one
color space to another. ICC profiles help you to get the correct colors for your images. For example, to correctly display
images designed for printing on a computer monitor, you can choose an ICC profile. This profile converts the image
to a different color space and makes sure that the colors display correctly online.
In the Scene7 Publishing System, you can choose an ICC profile to convert images to a different color space when you
upload the images. All standard Photoshop ICC profiles are available by default on SPS. To see the names of color
profiles on the Upload screen, select the Color Profile menu. Then choose Custom From > To, and choose an ICC
profile name on the Converted From and Converted To menus. See “Image editing options at upload” on page 305.
As well as using the default ICC profiles, you can upload other ICC profiles to SPS and make them available for color
space conversion. Switch to Detail view in the Browse Panel to investigate the profile class, color space type, and PCS
type of an ICC profile.
Uploading ICC profiles
Upload ICC profiles with the same techniques you use to upload files. You can store ICC profiles in any SPS folder.
See “Uploading your files” on page 83.
Examining an ICC profile
To examine an ICC profile, select it in the Browse Panel and display it in Detail view. Detail view provides this
information about ICC profiles:
Profile Class The ICC (International Color Consortium) defines each class to cover a type of application. For example,
Input profiles apply to devices such as digital cameras and scanners, and Output profiles apply to printers.
Color Space Type This number is the "input" color space of the profile, as defined by the ICC. The color space type
defines the number of components of the color space and the interpretation of those components. For example, RGB
is a color space with three components: red, green, and blue. The color space type does not define the particular color
characteristics of the space (for example, the chromaticities of the primaries).
PCS Type This PCS type is the "output" color space of the profile—its profile connection space. For example, a color
profile can convert RGB to the PCS, which then converts it to CMYK.
For an input, display, or output profile useful for tagging colors or images, the PCS type is either XYZ or Lab. Interpret
this profile as the corresponding specific color space defined in the ICC specification.
Last updated 10/9/2014
316
USING SCENE7
Support files
XML files
Web sites that use an XML-based system to manage images and image information can upload XML files to the Scene7
Publishing System. You can designate one of these files as the preprocessing rule set file for Image Serving. This file
restructures the standard Image Serving protocol format to meet the business logic of your commerce server. On the
Setup screen, you can specify an XML file to serve as the rule set definitions file path. This path setting is located under
Catalog Management on the Image Server Publishing screen. See “Image Server” on page 55.
Last updated 10/9/2014