Sun Java™ System Content Delivery Server 5.0 Administration Guide 2005Q4 Sun Microsystems, Inc. www.sun.com Part No.: 819-3209-10 2005Q4 Submit comments about this document at: http://docs.sun.
Copyright © 2005 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. All rights reserved. Sun Microsystems, Inc. has intellectual property rights relating to technology embodied in the product that is described in this document. In particular, and without limitation, these intellectual property rights may include one or more of the U.S. patents listed at http://www.sun.com/patents and one or more additional patents or pending patent applications in the U.S.
Contents Preface 1.
2. Accessing the Administration Consoles 11 ▼ Logging in to the Catalog Manager 11 ▼ Logging in to the Vending Manager 12 Catalog Manager Managing Content 13 13 Managing Content Categories ▼ Viewing Categories 14 ▼ Adding a Category 16 ▼ Editing a Category 17 ▼ Deleting a Category Managing Content Types Content Submissions Content Protection 14 18 19 19 20 Inapplicable Content 21 Using CDS DRM Agents and CDS OMA Forward Lock 21 Using OMA DRM 1.0 23 OMA DRM 1.
▼ Editing a Content Type ▼ Creating a Pricing Option ▼ Editing a Pricing Option 37 ▼ Deleting a Content Type 39 ▼ Disabling a Pricing Option ▼ Registering a MIME Type ▼ Editing a MIME Type ▼ Deleting a MIME Type 34 35 39 40 41 43 Managing Submitted Content 44 ▼ Viewing Submitted Content 44 ▼ Viewing Submitted Editions 47 ▼ Removing an Edition 48 ▼ Searching for Content 49 ▼ Changing the Status of Content 50 ▼ Changing the Status of Editions 52 ▼ Editing Content 52
▼ Editing a Device Library ▼ Deleting a Device Library 73 74 Managing Content Descriptor Templates ▼ Viewing Content Descriptor Templates 76 ▼ Adding a Content Descriptor Template 77 ▼ Editing a Content Descriptor Template 78 Managing Device Definitions Viewing Devices ▼ 78 78 ▼ Adding a Device ▼ Specifying Device Capabilities ▼ Activating New or Quarantined Devices ▼ Mapping MIME Types to a Device ▼ Setting a Compatible Device ▼ Adding Supported Devices to Existing Content ▼
▼ Editing a Vending Manager Account ▼ Deleting a Vending Manager Account Managing Developer Accounts 99 100 101 ▼ Viewing Developer Accounts 101 ▼ Adding a Developer Account 101 ▼ Editing a Developer Account 103 ▼ Deleting a Developer Account 104 Managing Catalog Manager Administrator Accounts 104 ▼ Viewing Catalog Manager Administrator Accounts 104 ▼ Adding a Catalog Manager Administrator Account 105 ▼ Editing a Catalog Manager Administrator Account 106 ▼ Deleting a Catalog M
▼ Adding a Developer Plan 119 ▼ Editing a Developer Plan 120 ▼ Viewing Developer Licensees ▼ Adding a Developer Licensee to a Developer Plan ▼ Removing a Developer Licensee from a Developer Plan ▼ Setting the Default Developer Plan ▼ Deleting a Developer Plan Getting Background Job Status ▼ Getting Job Status 126 Examining Job Details 127 Clearing a Failed Job 3.
Checking the Status of a Stocking Job ▼ Updating the Catalog for Stocked Content Pricing for Content for a Locale ▼ Setting Local Pricing 152 153 153 Price Update Notification ▼ 151 155 Changing the Price of Individual Content Items Managing Stocked Content 156 Viewing Stocked Content 156 ▼ Searching for Stocked Content ▼ Changing the Status of Stocked Content ▼ Unstocking Content ▼ Editing Stocked Content ▼ Editing External Content IDs 156 157 158 Updating Stocked Content 159 16
▼ Creating a Campaign ▼ Specifying a Campaign Type ▼ Specifying Campaign Options and Target Audience ▼ Specifying a Campaign Message ▼ Specifying Content for the Campaign ▼ Specifying Campaign Pricing Characteristics ▼ Specifying Campaign Scheduling ▼ Viewing Campaign Details ▼ Editing a Campaign 193 ▼ Testing a Campaign 193 185 Working with Subscriber Segments 185 187 188 189 190 191 194 ▼ Displaying Subscriber Segments ▼ Creating a Subscriber Segment ▼ Editing a Subscribe
Managing Subscriber Accounts 209 ▼ Viewing Subscriber Accounts 210 ▼ Adding a Subscriber Account 210 ▼ Editing a Subscriber Account 212 ▼ Viewing a Subscriber’s Download History ▼ Managing Subscriber Licenses ▼ Extending Trial Usage ▼ Issuing a Refund ▼ Deleting a Subscriber Account 213 214 215 Managing Subscriber Plans 215 216 ▼ Viewing Subscriber Plans 216 ▼ Adding a Subscriber Plan 217 ▼ Editing a Subscriber Plan 218 ▼ Viewing Subscriber Plan Members ▼ Adding Member
A. ▼ Deleting an MMS Message ▼ Using the MMS Test Log Device Capabilities 230 231 233 Descriptions of the Capabilities System Capabilities 233 233 Mandatory Capabilities 234 Content Delivery Server-Specific Capabilities Browser Capabilities 235 User Interface and Software Capabilities Specifying a Capability Value List 237 Integer Boolean 237 237 Device Specifications Nokia 6310i 237 238 User-Defined Devices B.
Tables TABLE 2-1 DRM Types 20 TABLE 2-2 CDS DRM Agents TABLE 2-3 OMA DRM 1.0 Formats TABLE 2-4 Required MIME Types for OMA DRM 1.
TABLE A-4 Nokia 6310i Device Specifications TABLE A-5 Device Specifications for a User-Defined Device 1 239 TABLE A-6 Device Specifications for a User-Defined Device 2 239 TABLE B-1 Associated DRMs, Content Types, and Pricing Models TABLE B-2 Initial Pricing Set for Items 1 and 2 TABLE B-3 Resulting Pricing for Items 1 and 2 in Scenario 1 244 TABLE B-4 Resulting Pricing for Items 1 and 2 in Scenario 2 244 TABLE B-5 Resulting Pricing for Items 1 and 2 in Scenario 3 245 TABLE B-6 Resulti
Preface This guide provides an overview of the Sun Java™ System Content Delivery Server. It describes how to administer the Catalog Manager and Vending Manager components. It describes the device capabilities and the content pricing models supported by the Sun Java System Content Delivery Server. Before You Read This Document This guide is written for system administrators who are responsible for administering the Catalog Manager or Vending Manager.
■ Chapter 2 describes how to administer the Catalog Manager. It provides instructions on how to review, categorize, and publish content. It describes how to define the mobile devices supported and their capabilities. It also describes how to manage access for developers and Vending Managers. ■ Chapter 3 describes how to administer the Vending Manager. It describes how to stock content, manage Administrator and Subscriber Accounts, and run system reports.
Related Documentation The Sun Java System Content Delivery Server manuals are available as Portable Document Format (PDF) and Hypertext Markup Language (HTML) files. These files are available in the Documentation subdirectory of the directory where the Content Delivery Server is installed as well as online at http://docs.sun.com. The following table summarizes the books included in the Content Delivery Server documentation set.
Accessing Sun Documentation Online The Sun Product Documentation web site enables you to access Content Delivery Server documentation on the web at http://docs.sun.com. Sun Welcomes Your Comments Sun is interested in improving its documentation and welcomes your comments and suggestions. To share your comments, go to http://docs.sun.com and click Send Comments. In the online form, provide the document title and part number.
CHAPTER 1 Introduction This chapter provides an overview of the Sun Java™ System Content Delivery Server. It describes the content lifecycle and provides an overview of the Catalog Manager, Fulfillment Manager, and Vending Manager components. It describes the automatic content validation process that takes place when content is submitted to the Content Delivery Server. This chapter also describes how to log in to the Catalog Manager and Vending Manager administration components.
Content Providers Java Applications Music Operator Ringtones Videos Games Wallpapers Extensible... Java System Content Delivery Server Catalog Manager Vending Manager Vending Manager Subscriber Portal Fulfillment Manager Subscriber Portal Fulfillment Manager Vending Manager Subscriber Portal Fulfillment Manager Subscriber 1. The content provider creates an application and submits it to the Catalog Manager using the web-based Developer Portal. 2. The Catalog Manager validates the content.
3. The Catalog Manager administrator publishes the content, making it available to the Vending Manager. 4. The Vending Manager administrator selects content published from the Catalog Manager and stocks the content, making it available to subscribers. Catalog Manager The Catalog Manager is the content aggregator or warehouse. It manages all the content coming from the developer community. After the content is authorized, the Catalog Manager makes the content available to the Vending Managers.
1. Developers submit content to the Catalog Manager. The Catalog Manager runs an automated validation process on the content to ensure there is no malicious content and that the content matches the supported devices. 2. The content goes to the Submitted Content section of the Catalog Manager for review by the administrator. The administrator reviews the content and, if required, edits the content and modifies the pricing and category assignments. The administrator can accept or reject the content. 3.
Automated Content Validation The Sun Java System Content Delivery Server performs an automated validation of content. If an application fails at any stage of validation, it is not submitted to the Catalog Manager. Note – The default implementation of content validation performs automated validation on MIDlets only. You can customize the validation process to validate other types of content. Content validation includes the following tasks: ■ API Filtering.
■ Submitted Content. The administrator reviews submitted content and, if required, edits the content and modifies the pricing and category assignments. The administrator can accept or reject the content. ■ Published Content. After accepting the content, the administrator publishes the content to make it available to the Vending Manager. ■ Categories. Content categories are central to content management.
■ Vending Plans. Vending Plans define the categories that a Vending Manager can access. Vending Plans can contain a nested hierarchy of other Vending Plans. Each Vending Manager Account is associated with one or more Vending Plans. ■ Developer Plans. Developer Plans define the set of APIs that developers can use in applications that they submit. Profiles define the classes in a specific library that developers can use. A Developer Plan contains one or more Profiles.
The Vending Manager administrator manages the following functions: ■ ■ ■ ■ ■ Stocked content Subscriber access and subscriber licenses Purchase pricing and trial periods Administrator access Statistical reports In addition to the Vending Manager administrator, the Content Delivery Server can have Vending Manager Customer Care Agents. Customer Care Agents have limited administrator privileges.
Vending Manager Processes The previous figure illustrates the Vending Manager processes. The Vending Manager is responsible for the following practices: ■ ■ ■ ■ Content Management Plan Management Account Management Reporting Content Management The Catalog Manager publishes content to the Vending Manager. The Vending Manager is responsible for stocking this content to make it available to the subscriber.
Customer Care Agent for administrators with privileges for viewing content and managing subscribers. Administrator Accounts can be disabled when you do not want an individual accessing the Vending Manager. See “Managing Vending Manager Administrator Accounts” on page 201 for more information. Reporting The Vending Manager provides daily statistical reports that enable you to view and track application download information and usage statistics downloads.
Accessing the Administration Consoles To access the Catalog Manager and Vending Manager administration consoles for the first time, use the default login ID and password that were created when you installed the Sun Java System Content Delivery Server. The default values for the Login ID and Password are admin and admin. Change the password after you initially log in (note that the password is case sensitive).
3. Enter your administrator name and password. 4. Click Log In. ▼ Logging in to the Vending Manager 1. Start the Vending Manager. For information on starting the Vending Manager, see the Sun Java System Content Delivery Server Installation Guide. 2. From a browser window, enter http://localhost/vsadmin/main. The Vending Manager Log In page is displayed. 3. Enter your administrator name and password. 4. Click Log In.
CHAPTER 2 Catalog Manager This chapter describes how to administer the Catalog Manager.
The following content management tasks are described in this section: ■ ■ ■ ■ Managing Managing Managing Managing Content Categories Content Types Submitted Content Published Content When an operation is performed (editing, deleting, adding, and so on), the Content Deliver Server puts a background job notification in the main menu bar. You can click on the notice to see details of jobs that were or are running in the current session. See “Getting Job Status” on page 126 for more information.
3. Click a category to view its subcategories. The Categories page displays a list of the subcategories for the selected category. The menu bar at the top of the page displays the hierarchy level of the selected category.
To return to the list of main categories, click Home in the category navigation bar. To display any level of your current category hierarchy, click the category name in the category navigation bar. 4. Click the arrow keys to move a category up or down the list to change the display order. ▼ Adding a Category 1. From the Categories page, navigate to the level to which you want to add the category. For example, if you want to add a game subcategory to the Entertainment category, click Entertainment. 2.
3. Enter a name and short description of the category. The name must be unique within the category. You cannot have two categories of the same name under the same level of hierarchy. 4. Click Add Category. The Add New Category confirmation page is displayed. Note – You can set the maximum number of category levels that can be added in a session in the CommonConsole.properties file in the $CDS_HOME/deployment/deployment_name/conf/ directory. The default number of levels of categories is set to 10.
The Edit Category page is displayed. 3. Modify the name or short description as needed, and click OK. The category is updated in the database. ▼ Deleting a Category 1. From the Categories page, navigate to the category you want to delete. You can only delete categories that do not contain content. You must either move or delete content in an undesired category before you can delete that category. 2. When the category is displayed, click the Delete Category button .
Managing Content Types The default content types supported by the Content Delivery Server are MIDlets, ring tones, and images. You can define additional content types as needed. Each content type must be associated with one or more MIME types. MIME types specify the format of the content and enable information to be exchanged between applications. The Content Delivery Server provides support for a default set of common MIME types, each of which is associated with one of the default content types.
■ Defining the metadata and price for all content formats is done once ■ Publishing and stocking for all content formats is done once ■ Choosing and delivering compatible content formats to subscribers is automatically done for them For example, a content provider has a ring tone, Melody, to submit. The content is submitted with the ringtone content type. After the content is submitted, the content provider then submits an edition of Melody that has a monophonic format.
Inapplicable Content Short Messaging Service (SMS) content types (monophonic ringtone, operator logo, group logo, and sms picture) are supported in the Content Delivery Server. Due to the delivery format for SMS content, DRM protection cannot be applied. The No DRM option is associated by default for all SMS content types. Remotely hosted copyrighted content also cannot have DRM associated with it.
TABLE 2-2 CDS DRM Agents (Continued) Title Description Small Connected Use and Time Sensitive Supports all pricing models. Note: To prevent runtime errors, do not use this DRM agent with applications that perform the following actions: • Show an alert before calling the startApp method. • List their Record Stores. • Modify or remove the Content Delivery Server Record Store. Midsize Connected Use and Time Sensitive Supports all pricing models.
Using OMA DRM 1.0 OMA DRM 1.0 offers three different formats for applying protection, as described in TABLE 2-3. TABLE 2-3 OMA DRM 1.0 Formats DRM Type Description Forward Lock Content is delivered with basic copy protection. Content cannot be forwarded to another device. Combined Delivery Content is delivered together with basic copy protection and additional usage rights are included. Content cannot be forwarded to another device.
OMA DRM 1.0 and Non-Compliant Devices For devices that are not compliant with OMA DRM 1.0, the Catalog Manager administrator can configure the Content Delivery Server with one of the following options to deliver content with a free always, first download only, or every download pricing model: ■ Deliver all content to non-compliant devices as unprotected original content (that is, content as received from the content provider).
Associating Content Types with DRMs When assigning a DRM type to a content type, be aware that CDS DRM can only be used with MIDlets. Be aware also that SMS content types and remotely hosted copyrighted content cannot be assigned a DRM. Other than these restrictions, the choice of no DRM, CDS OMA DRM 1.0 Forward Lock, and OMA DRM 1.0 can be used with any content type. This release of the Content Delivery Server contains the default associations of DRM types to content types shown in TABLE 2-5.
You can assign the DRM options to the associated content types given in TABLE 2-5 but you are not restricted to those combinations, for instance, you can apply None to all content types if you wish. For steps on how to assign a DRM, see “Adding a Content Type” on page 32. You can change the DRM option for a content type after deployment if needed. See “Enabling and Disabling a DRM” on page 26 for more information.
TABLE 2-6 Content Delivery Server Pricing Models Pricing Model Definition Free always No charge for downloading content. Content can be downloaded any number of times for however long content is available. Trial No charge for content on initial download. Subscriber must purchase content for subsequent downloads. First download only Subscriber is charged for initial download of content. Subscriber is not charged for subsequent downloads.
The Content Delivery Server supports the combinations of DRM options and pricing models as shown in TABLE 2-7. TABLE 2-7 DRM Options and Pricing Models DRM Type Pricing Model None (no DRM protection) Free always First download only Every download CDS DRM Agents Free always Trial First download only Every download Per use Per period Per subscription CDS OMA DRM 1.0 Forward Lock Free always First download only Every download OMA DRM 1.
Pricing Options At the same time that you select a pricing model, you have the option of creating pricing options for it. Having predefined pricing options gives you more control over the pricing of content and can make managing content easier. You can set up predefined pricing options for content providers to choose from instead of having them decide content pricing and usage terms.
■ ■ Edit the pricing option Create a customized price for a published content item Changing the pricing of content is dependent on several factors, such as the content item status, the DRM assigned, and whether the content item is copyrighted. For a copyrighted content item, the pricing options you can choose from are dependent on the item’s content type preferences alone because copyrighted content cannot have a DRM associated with it.
has the content type picture and a pricing option of $0.75 for first download only. You determine that Roses is priced at $.50 for first download only. When you edit the content and change its price, Roses becomes disassociated from other content of type picture with that pricing option. If the purchase price for picture content changes later, Roses is unaffected by the change because it is no longer associated with its original pricing option. Roses is considered to have a custom price.
■ ■ ■ Content Type - The type of content that the MIME type is associated with. MIME Type - The string that identifies the MIME type. File Extensions - The file extensions that are associated with the MIME type. ▼ Viewing Properties for a Supported MIME Type 1. Click the string in the MIME Type column on the MIME Types page. The properties page for the MIME type is displayed.
4. Enter the following information: ■ ■ ■ Content Type - Enter the name of the content type that you are adding. Description - Enter a brief description of the content type. Preview - Choose whether content type of this type can have a preview available for subscribers. If you disable the Preview feature, the Preview field is not displayed in the Content Properties page.
5. Select a DRM. Administrators must know which DRMs are applicable for specific content types. See Appendix B for a table of DRMs and associated pricing models. If an inapplicable DRM is assigned, submission of content with that DRM fails. For instance, if you erroneously assign CDS DRM Agent to the image content type and a content provider attempts to submit a content item of type image, the content provider receives an error message that the submission failed.
■ Pricing Options - This section addresses two items: ■ Required Pricing Options - Enables or disables content providers to set their own pricing options for content. This option is only available when a pricing option is defined for the content type. Clicking the option restricts content providers to selecting the predefined pricing options you have enabled. If you do not check Require Pricing, content providers can create custom pricing for the content being submitted.
The fields displayed are relevant to the selected pricing models on the previous page. If no existing pricing options exist yet for the content type, the Available Pricing Options section is not displayed. 5. Enter a unique Option ID. The Option ID identifies this specific pricing option for this content type. 6. Enter a unique Pricing Option Name. The Option Name is an identifier that external systems can use to identify the pricing option for this content type.
7. Select free usage or non-free usage or enter the number of free trials. The fields shown are dependent on the pricing models you made available for this content type when creating or editing the content type. TABLE 2-6 lists and defines the supported pricing models. 8. Select the Charge option you want to apply to the content type. Unless the pricing model is Always Free, enter a monetary value and enter values for other fields in the option as required. 9.
5. Change the following fields as needed: ■ Option ID - Unique identifier for this option. Values can consists of numbers, characters, or a combination of both. ■ Option Name - Name of option. Values can consists of numbers, characters, or a combination of both. ■ Purchase Price - Monetary value. 6. Click Save to save your changes. The Content Type Preferences page is displayed. Changes to the pricing option are immediate and content using that pricing option are updated in the Catalog Manager.
7. Click Done. 8. Click OK to close the Confirmation page. To create a custom price for an individual item of content, see “Editing Content” on page 52. To create a custom price for multiple content items at once, see “Setting Custom Prices for Published Content” on page 66. ▼ Deleting a Content Type Deleting a content type removes that content type and its associated pricing options from the current deployment of the Content Delivery Server. Use caution when using this command because it cannot be undone.
1. From the Catalog Manager administration console, click Content on the main menu bar. 2. Click the MIME Types tab. The MIME Types page is displayed. 3. Click the content type with the pricing option you want to disable. The Content Type Preferences page is displayed. 4. In the Available Pricing Options section, clear the check box under the Enabled column for the pricing option you want to disable. You can clear more than one option at a time.
4. Enter the following information: ■ Content Type - Select from the list the type of content with which the MIME type is associated. ■ MIME Type - Enter the string that identifies the MIME type, for example, image/jpeg. ■ Description - Enter a brief description of the MIME type. ■ File Extensions - Enter the file extensions associated with the MIME type. Each extension must be preceded by a period (.). To specify more than one extension, separate each entry with a comma (,), for example, .jpg, .
■ ■ application/java-archive application/x-jam When associated with other content types, the MIME types previously listed are treated as any other MIME type. To edit a MIME type, follow these steps: 1. From the Catalog Manager administration console, click Content on the main menu bar. 2. Click the MIME Types tab. The MIME Types page is displayed. 3. Click the MIME type that you want to edit. The properties page for the MIME type is displayed. 4. Click Edit. The MIME Types Definition page is displayed.
7. Click OK. The MIME Type Properties page is displayed. 8. Click OK to close the confirmation message. ▼ Deleting a MIME Type You cannot delete a MIME type if content with that MIME type is submitted or if a device references it. You cannot delete the following MIME types under the conditions listed: ■ When associated with MIDlets, the following MIME types are required by the Content Delivery Server and cannot be edited or deleted: ■ ■ ■ application/java-archive text/vnd.sun.j2me.
Managing Submitted Content Developers submit content in packages that consist of their created content and XML files with support and description information. Developers submit content through the Developer portal. When content is submitted to the Catalog Manager, the Catalog Manager runs an automated validation process on the content to ensure there is no malicious content and the content matches the Catalog Manager’s supported devices.
To view submitted content by state, follow these steps: 1. From the Catalog Manager administration console, click Content on the main menu bar. The Content Database Management page is displayed for submitted content. 2. Click the title of the state that you want to view. For example, click New to view all new content. The Browse and Search Results page shows all submitted content for the selected state.
The following information is displayed for each item: ■ Title - The name of the content. ■ Developer - The name of the developer who submitted the content. ■ Categories - The categories in which the content is defined. ■ Catalog Price - The price specified by the Catalog Manager administrator. By default, this price is the same as the cost until you change it. If the content was submitted for free, the Catalog Price and Cost shows Charge Free always.
▼ Viewing Submitted Editions The Editions Database Management page displays the total number of submitted editions, and, of that total, how many editions are in a New, Pending, or Denied state. 1. From the Catalog Manager administration console, click Content on the main menu bar. The Content Database Management page is displayed for submitted content. 2. Click Edition Updates. The Editions Database Management page is displayed. 3. Click the status that you want to view.
The following information is displayed for each edition: ■ ■ ■ ■ ■ ■ Title - The name of the parent item with which the edition is associated. Edition Name - The name of the edition. Edition Description - A short description of the edition. Version - The version of the edition. Type - The type of content. Select the type from the list of supported types. Developer - The name of the content provider who submitted the edition.
1. From the Submitted Content page, select the status of the edition you want to disable. 2. Click the title of the content. 3. Go to the Editions section of the View Content Properties for the selected content. 4. Click on the instrumented version of the edition. 5. Click Select on the Supported Devices field of the View Content Edition page. 6. Select the option, Force no devices to be selected for this edition (disable edition). 7. Click OK. No devices are associated with the selected edition.
▼ Changing the Status of Content You can change that status of submitted content to one of the types described in TABLE 2-9. TABLE 2-9 Content Status Types Status Definition Published Content available for use by subscribers. Pending Content requiring further review before being made available. Denied Content rejected. Deleted Content removed. Testing Content available for use by testing subscribers.
6. Click GO. The Confirm: Change Status page is displayed. You can enter a message to the developer to provide an explanation of the status of the content. 7. Click OK in the Change Status page to confirm the status change. The status of the content is updated. If there are content items remaining in the selection list, clicking OK displays the Browse and Search Result with the list of content items. Repeat Steps 4 through 6 until you have changed the status of all the remaining content items.
▼ Changing the Status of Editions 1. From the Catalog Manager administration console, click Content on the main menu bar. The Content Database Management page is displayed for submitted content. 2. Select Edition Updates. The Editions Database Management page is displayed. 3. Click the title of the status that contains the edition with which you want to work. For example, click New Editions to work with new editions. 4. Select the editions that you want to change.
3. Click Edit from the View Content Properties page. The Edit Content page is displayed. An asterisk (*) beside a field indicates that it is a required field.
■ General Information - Contains content status and any additional messages displayed to the content provider. ■ Pricing - Shows the price specified by the content provider. The pricing options designated by the content provider are displayed just above the Catalog Price section. You can change the purchase price in the Catalog Price section. TABLE 2-10 describes the pricing options.
■ Create a custom price for this content item. Be aware that by creating a custom price, you are disassociating this item for its pricing option. If you need to reapply a pricing option to the content later, you can do so, however, you must select a pricing model that is compatible with the pricing model used with the custom price. For example, if the custom price used a download pricing model (for instance $0.
Note – If you change a content’s status from Published to another state, the content is removed from the Published Content list and is not included in the list of published categories. ▼ Viewing Published Content 1. From the Catalog Manager administration console, click Content on the main menu bar. 2. Click the Published Content tab. The Published Content page displays a list of the main categories defined. A number beside each category indicates the number of published content packages. 3.
To view the properties for an item, click the title of the item. The View Content Properties page is displayed. If icons, documentation, or screen shots were submitted with the content, click the View button for the item to see what was submitted. If the item is a ring tone and a preview was submitted, you can click the Listen button to hear the preview. ▼ Removing Content You can either make content temporarily unavailable or remove content from the catalog by changing its status. 1.
3. Navigate to the item that you want to work with. You can use the search feature or view the list of content for the category that contains the item. You can sort the display of the content items by clicking on a highlighted column title on the Browse and Search Result page. 4. Click the title of the item. The View Content Properties page is displayed. The list of editions available are shown in the Editions section at the end of the page. 5. Click the name of the edition that you want to view.
3. Click Copy/Move Content. The Copy/Move Content page is displayed. The default selection is Category/Categories. Category and content item names change from gray to black as the categories and content items are loaded. Wait until all items are loaded before making a selection. 4. Select the categories you want to copy or move. Under the source column on the left, select one or more categories to copy or move.
you cannot copy or move a parent category into one of its child categories. You must click the check box to select an item in the tree. See “Copying or Moving Content Items” on page 62 for more information. Note that an X indicates a selected category. A dot (.) indicates that at least one category has been selected in the column. A higher level category with a dot indicates that at least one of its subcategories is selected. 5. Select one or more destination categories.
6. Click Copy or Move. The Copy and Move buttons only become active when at least one selection is made in both the source and destination trees. If one category tree does not have a selection, for instance, if you clear all selections in a tree, the buttons are inactive. 7. Confirm or cancel the operation. If copied, categories and their associated content are duplicated under each destination category.
The preceding figure shows the results of moving the Mobile Mail, Investment, and Accounting categories to the Business and Professional category. All content items in Mobile Mail, Investment, and Accounting were also moved.
▼ Copying or Moving Content Items By selecting Individual items on the Copy/Move Content page, you can select specific content items to copy or move to other categories. Note – When scheduling a copy or move operation, be aware that if large numbers of categories and content are being copied or moved, the operation can take some time to complete. 1. From the Catalog Manager administration console, click Content on the main menu bar. 2. Click the Published Content tab. 3. Click Copy/Move Content.
Category and content item names change from gray to black as the categories and content items are loaded. Wait until all items are loaded before making a selection. 4. Click Individual Items. 5. Select the content items in one or more categories that you want to copy or move. Under the source column on the left, you can select one or more content items to copy or move but you cannot select categories. You can expand a category to see its content items.
6. Select one or more destination categories. Under the source column on the right, the destination categories you select must be terminal categories. A terminal category is the lowest level category and contains only content items. You must click the check box to select an item in the tree. 7. Click Copy or Move. The Copy and Move buttons only become active when at least one selection is made in both the source and destination trees.
The preceding figure shows the results of copying the content items, N_Ringer and Splash Screen to the Personal Productivity category. The content items are still available in the Mobile Mail category. If you copy a content item to a category and decide that you do not want the item in that category, you can edit the content to change the category assignment. See “Editing Content” on page 52 for information.
For instance, if you select the Featured and Entertainment categories, you can change the purchase price for all the content in those categories or specific content items in those categories. You set a specific purchase price, apply a percentage increase or decrease, or increase or decrease the price by a set amount. Note – Setting custom prices has no Undo operation. Before making the change, carefully review all settings to ensure that the correct changes will be applied only to the intended contents.
4. Select the category or subcategories of content or specific contents. To change the purchase price of all the contents of a category, simply click the category itself. To change the purchase price of specific content items in a category, navigate through the category to select individual content items.
5. Change the purchase price in one of the following ways: ■ ■ ■ Enter a new purchase price. Increase or decrease the purchase amount by N per cent. Increase or decrease the purchase price by a dollar amount. The price is applied to all selected content regardless of their pricing models. For example, if SpruceDraw is $5.00 per monthly subscription and Launch Screen is $0.50 per download, increasing the purchase price by 10% results in SpruceDraw being offered at $5.
■ System capabilities - Capabilities primarily used by the Content Delivery Server. They define capabilities that a device must have to perform Content Delivery Server functionality. For instance, system capabilities define whether a device supports Short Message Service (SMS) or Wireless Application Protocol (WAP) Push. ■ Mandatory capabilities - Capabilities that must be defined for a device to accept MIDlet applications.
Device libraries are based on the Java class library. When you define a device library to the Content Delivery Server, you submit the JAR or ZIP file that contains the APIs that you want to support. ▼ Viewing Device Libraries 1. From the Catalog Manager administration console, click Devices on the main menu bar. 2. Click the Libraries tab. The Device Libraries page is displayed, showing the submitted libraries.
2. When you are done viewing the properties, click OK to close the properties page. ▼ Adding a Device Library 1. From the Catalog Manager administration console, click Devices on the main menu bar. 2. Click the Libraries tab. The list of libraries is displayed. 3. Click New Library. The Library Definition page is displayed.
4. Enter the following information: ■ Name - A name for the new library. ■ Description - A brief description of the library and its contents. ■ Select JAR File - The path of the class library that you want to submit or click Browse to locate file. The library file can be either a JAR file or a ZIP file. 5. Click Next. The second page of the library definition process is displayed.
6. Select the items in the tree that you want to include in the library. Clear any items that you do not want to include. To select individual methods, expand the package by clicking the plus sign (+) next to the check box for the package. 7. Click OK to save the new library. A confirmation page is displayed. 8. Click OK to return to the list of libraries. ▼ Editing a Device Library 1. From the Catalog Manager administration console, click Devices on the main menu bar. 2. Click the Libraries tab.
5. Make the necessary changes. You can edit only the name and description of a library that is in use. A library is in use if it is assigned to a device or a Developer Profile. 6. Click OK. A confirmation page is displayed. 7. Click OK to display the library properties. ▼ Deleting a Device Library You cannot delete a library that is in use. A library is in use if it has been assigned to a device or a Developer Profile. To delete a device library, follow these steps: 1.
The Content Delivery Server provides descriptor templates for Content Object Descriptor (COD) and General Content Descriptor (GCD). You can define other templates as needed. TABLE 2-11 shows the Content Delivery Server content attributes that you can use to customize the template for your needs. TABLE 2-11 Content Attributes for Content Descriptor Templates Attribute1 Definition Name The name of the content. Version The version of the content. Size The size of the content.
CODE EXAMPLE 2-1 Sample Content Descriptor Template (Continued) Content-Name: Content-Version: Content-Vendor: Content-URL: Content-Size: Confirm-URL: ▼ Viewing Content Descriptor Templates 1.
▼ Adding a Content Descriptor Template 1. From the Catalog Manager administration console, click Devices on the main menu bar. 2. Click the Templates tab to display the list of templates. 3. Click New Template. The Content Descriptor Template Definition page is displayed. 4. Enter the following information: ■ Template Name - A name for the new library. ■ MIME Type - The string to define the MIME type. ■ Extension - The extension that is associated with the MIME type.
▼ Editing a Content Descriptor Template 1. From the Catalog Manager administration console, click Devices on the main menu bar. 2. Click the Templates tab. The list of templates is displayed. 3. Click the name of the template that you want to edit. The template properties are displayed. 4. Click Edit. 5. Make the necessary changes to the template properties. The fields are the same as those described in “Adding a Content Descriptor Template” on page 77. 6. Click Save. A confirmation page is displayed. 7.
The following information is displayed for each device. ■ Model Name - The name of the device model. ■ Model Number - The model number of the device. ■ Manufacturer - The name of the company that manufactured the device. ■ User-agent - The unique identifier for the device. The user-agent is a regular expression that contains information about the device, such as hardware, browser, and model information.
■ Quarantined - An auto-provisioned device whose capabilities are not completely known and is unavailable to subscribers. Developers cannot submit content to quarantined devices. Determine the device’s capabilities before changing its status. Change the status of a device from Quarantined to Active by clicking the Activate button on the selected quarantined device’s Device View page. ▼ Adding a Device Use the New Device command to add a device to the Content Delivery Server database.
2. Specify the following fields: ■ Name - The name of the device. ■ Description - A description of the device. ■ Manufacturer - The name of the manufacturer. ■ Manufacturer Number - The number of the manufacturer. ■ User-agent - The unique identifier for the device. The user-agent is a regular expression that contains information about the device, such as hardware, browser, and model information.
pattern, SAMSUNG-SGH-E700.*, matches it. The expressions, SAMSUNG-SGHE700 and .*SAMSUNG-SGH-E700, do not match as they only partially match the user-agent coming from the device. ■ Supported Libraries - The libraries that the device supports. Libraries define the API sets supported by the device. To select multiple libraries, hold the Control key down and click the libraries with the left mouse button. Selected libraries are highlighted. ■ Browser Type - The type of browser supported by the device.
▼ Specifying Device Capabilities 1. From the Device Management page, click the device name to select it. The properties page for the device is displayed. 2. Click Edit. The Device Management page for editing device capabilities is displayed. An asterisk (*) beside a field indicates that it is a required field.
If the Edit button is not available, wait a few minutes for the previous edit request to complete before attempting to make more changes. When you change the capabilities of a device, the capability matching process is run to update the list of content that matches the device. If there is a lot of content to check, the process can take a while. 3. Check the capabilities required for the device and edit the properties as needed. If the Push Type is SMS, you must also select an SMS delivery type.
5. Click OK. The Device Management page is displayed that shows the list of devices. ▼ Activating New or Quarantined Devices When you are sure a newly detected device is capable of supporting content, you can make that device available to developers and subscribers by changing its status from New or Quarantined to Active. To activate new or quarantined devices, follow these steps: 1. Click Devices from the Catalog Manager menu bar. 2. Click the new or quarantined device from the list of devices. 3.
■ Identify other MIME types that are accepted as alternatives to the selected MIME type. ■ Indicate the extension associated with the MIME type. ■ Indicate whether the device supports one step or two step download for that MIME type, and indicate if the device supports Multimedia Message Service (MMS). You can select OTA - One Step, OTA - Two Step, Nokia Smart Messaging (NSM) or Enhanced Messaging (EMS).
If the Manage MIME Types button is not available, wait a few minutes for the previous edit request to complete before attempting to make more changes. When you change the MIME types supported by a device, the capability matching process is run to update the list of content that matches the device. If a lot of content must be checked, the process can take a while. 3. Select the MIME types that this device supports.
a. Alternative MIME types to be handled as if they were the MIME type supported for the device. For example, if the device supports ZIP files with the MIME type application/zip, you can specify application/x-compressed as an alternative MIME type. Content that specifies either MIME type is passed to the device with application/zip specified in the content header. b. The extension that the device uses for content of that MIME type. c. The delivery type used for that MIME type.
4. Click OK to save your changes. 5. Click OK in the confirmation page. Note – When a new version of an existing device becomes available, you can add it to the list of devices and designate the previous version of the device as compatible to it. When content is created that specifies the new version, the content can be seen on either the previous version of the device or the new version.
3. Click Modify This Device. A confirmation dialog box asks you to confirm that you want to update the device. 4. Click OK. The Device Management page is displayed that shows the capabilities of the device. 5. Click OK. The Device Management page is displayed that shows the list of devices. ▼ Setting the Default Device The Catalog Manager automatically assigns the default device to all new Subscriber Accounts.
The device is now set as the default device in the database. All new Subscriber Accounts will be assigned this device as a default upon creation. ▼ Deleting a Device You cannot delete the default device. You also cannot delete a device that a subscriber account references. To delete a device, follow these steps: 1. On the Device Management page, click the name of the device model you want to delete. The Device Management page for the selected device is displayed. 2. Click Delete.
4. Click Import. The device is listed on the Device Management page. Unless the Quarantine option was selected, the device has a status of Active. ▼ Exporting Devices To export a device, that is to create a device definition file (in .xml format) for an existing device: 1. From the Catalog Manager administration console, click Devices on the main menu bar. 2. Click the desired device from the list on the Device Management page. 3. Click Export.
3. Enter the language code, the country code, and the name of the language in the empty row for the new locale. A locale code is comprised of the language code and the country code separated by a dash (-), for example, en-US is the locale designation for English, United States while en-AU is the designation for English, Australia. The locale code is created or updated for you. You must enter a valid ISO Language Code. These codes are the lower-case twoletter codes as defined by ISO-639.
▼ Changing a Locale To edit or update a locale or locale information, follow these steps: 1. Select the value for the locale you want to change and enter the new value. For instance, to change the English to Australian English, replace the Country Code with AU and replace the Description with Australian or Australian English. 2. Click Update. Deleting a Locale To remove a locale from the server, click Delete for the locale you want to remove. Do not delete locales that are being used by content or devices.
The Catalog Manager does not administer subscriber accounts; these are administered through the Vending Manager. See “Managing Subscriber Accounts” on page 209 for more information. TABLE 2-12 describes the purpose each account type serves: TABLE 2-12 Account Types Account Type Description Vending Manager A Vending Manager account is for a specifically branded Vending Manager that stocks content from the Catalog Manager. It is associated with one or more Vending Plans.
2. Click Developers or Administrators. The list of defined Developer or Administrator accounts is displayed. Each account type has its own page or view. TABLE 2-13 describes the operations you can perform on any of the three views. TABLE 2-13 Search and Display Operations Operation Implementation Search for an account 1. Enter the search item in the search box. 2. Select the search criteria in the criteria drop-down list. 3. Click Submit.
Managing Vending Manager Accounts Vending Manager accounts define the Vending Managers to which the Catalog Manager publishes content. Because a single Catalog Manager can serve multiple Vending Managers, you can have many Vending Manager accounts. Each Vending Manager account must be assigned to one or more vending plans. Vending Managers are generally configured to serve separate enterprises, so each account generally has a specific Vending Plan.
3. Enter the required information. An asterisk (*) beside a field indicates that it is a required field. ■ Account ID - Specify a unique designation for the account. The Account ID is automatically converted to lowercase. The ID can contain a combination of characters and numbers. Note – The Account ID you assign must be also be used for the vs.account.name property in the deployment configuration file and the vending name in the database configuration file in your cfg directory.
Select the radio button to specify whether the URI contains a domain name or IP address. Use the format hostname:port for domain names. Use the format xxx.xxx.xxx.xxx:port for IP addresses. To avoid data inconsistency or notification failure, ensure that the Network ID specified is a valid address. If the Content Delivery Server is running behind a firewall, set the Network ID to the internal IP address of the host running the web server.
3. Click Edit. The Edit Account Details page displays the same fields as those described in “Adding a Vending Manager Account” on page 97. 4. Modify the fields as required, then click OK. A confirmation page asks whether you want to save the changes. 5. Click OK to close the Confirmation page. ▼ Deleting a Vending Manager Account 1. From the Catalog Manager, click Accounts in the main menu bar. The Vending Manager page is displayed. 2. Click the Vending Manager account you want to delete.
4. Click OK. The account is deleted and it is removed from any vending plan with which it was associated. Managing Developer Accounts Developer accounts are for corporations or individuals that submit content to the Catalog Manager. Each developer is associated with one or more Developer plans. Before you begin creating a Developer account, you might want to ensure an appropriate Developer plan exists that you can assign to the account.
3. Enter the required information. An asterisk (*) beside a field indicates that it is a required field. ■ Login ID - Specify the Login ID, which must be unique. The Login ID is automatically converted to lowercase. ■ Password - Enter a password. ■ Confirm Password - Reenter the password. ■ Status - Leave the status as Enabled, unless you want to postpone access to the Catalog Manager. ■ Developer Plans - Select one or more developer plans that you want to assign to the developer.
6. Click OK again to close the confirmation message. ▼ Editing a Developer Account 1. From the Catalog Manager, click Accounts in the main menu bar, then click Developers. The Accounts page displays a list of Developer accounts. 2. Click the Developer account you want to modify. The Developer Account Details page is displayed. 3. Click Edit Profile. The Edit Account Details page displays the same fields as those described in “Adding a Developer Account” on page 101.
4. Modify the fields as required, then click OK. A confirmation page is displayed asking whether you want to save the changes. ▼ Deleting a Developer Account 1. From the Catalog Manager, click Accounts in the main menu bar, then click Developer. The Accounts page displays a list of Developer accounts. 2. Click the developer account you want to delete. The Developer Account Details page is displayed. 3. Click Delete. A Confirmation page is displayed asking you to confirm you want to delete the account. 4.
▼ Adding a Catalog Manager Administrator Account 1. From the Catalog Manager, click Accounts in the main menu bar, then click Administrators. The Accounts page displays a list of Administrator accounts. 2. Click Add New Account. The Add New Administrator page is displayed. 3. Enter the required information. An asterisk (*) beside a field indicates that it is a required field. 106 ■ Login ID - Specify the Login ID, which must be unique. The Login ID is automatically converted to lowercase.
4. Click OK to add the Administrator account. A confirmation message asks you to confirm you want to add the account. 5. Click OK to confirm the addition. 6. Click OK to close the confirmation message. ▼ Editing a Catalog Manager Administrator Account 1. From the Catalog Manager, click Accounts in the main menu bar, then click Administrators. The Accounts page displays a list of Administrator accounts. 2. Click the Administrator Account you want to modify.
Managing Plans Vending Manager and Developer accounts are assigned to plans. The Catalog Manager uses plans to control content submission for developers and content access for Vending Managers. TABLE 2-14 describes the two types of plans used by the Catalog Manager. TABLE 2-14 Plan Types Plan Type Description Vending Vending plans define content access rights. For example, if you have a Vending Manager branded to sell content to teenagers, you don’t want it stocking adult content.
2. Click a Vending plan name to view the properties of the plan. The Vending Plan Properties page displays the properties of the plan. From this page you can edit, delete, add, or remove members from the Vending plan. ▼ Adding a Vending Plan 1. From the Catalog Manager, click Plans in the main menu bar. The Vending Plans page is displayed by default. 2. Click New Vending Plan. The New Vending Plan page is displayed.
3. Enter the name of the plan and a short description of the plan. 4. Select any existing plans that are to be included in this plan. 5. Specify the categories you want to offer to the Vending Managers that are assigned to this plan. Note – When you select a category, all subcategories for the category are included. 6. Click OK. The new Vending plan is updated to the database. Note – After you create the Vending Plan, you can add Vending Manager accounts to it.
To edit a Vending plan, follow these steps: 1. From the Catalog Manager, click Plans in the main menu bar. The Vending Plans page is displayed by default. 2. Click the plan that you want to modify. The Vending Plans Management page is displayed. 3. Click Edit. The Edit Vending Plans page displays the same fields as those described in “Adding a Vending Plan” on page 108.
4. Modify the fields as required, then click OK. The Properties page appears displaying the changed information. 5. Click OK. The Vending Plan is updated in the database. ▼ Viewing Vending Plan Members Members are the Vending Manager accounts assigned to a vending plan. You can add and remove members from a Vending plan. To view the members associated with a Vending plan, follow these steps: 1. From the Catalog Manager, click Plans in the main menu bar. The Vending Plans page is displayed by default. 2.
2. Click the plan you want to view. The Vending Plan Management page is displayed. 3. Click the Members tab. The list of Vending Manager accounts associated with the Vending plan is displayed. 4. Click Add. A list of Vending Manager accounts is displayed. Vending Manager accounts that are already assigned to the account are not displayed. 5. Check one or more Vending Manager accounts that you want to assign the Vending Plan to, then click OK.
3. Select the plan that you want to set as the default. 4. Click OK. The default plan is assigned to all new Vending Manager accounts until a new Vending plan is assigned. ▼ Deleting a Vending Plan 1. From the Catalog Manager, click Plans in the main menu bar. The Vending Plans page is displayed by default. 2. Click the plan that you want to delete. The Vending Plans Properties page is displayed. The following plans cannot be deleted: ■ The default plan.
Managing Developer Plans Developer plans define the set of APIs that developers can use in applications that they submit. Profiles define the classes in a specific library that developers can use. A Developer plan contains one or more profiles. The Content Delivery Server provides a default Developer plan. You can customize this default Developer plan for your needs, or you can assign a different plan as the default. New Developer accounts are automatically assigned to the default Developer plan.
4. Click a profile name. The Profile Definition page is displayed. ▼ Adding a Profile 1. From the Catalog Manager administration, click Plans in the main menu bar. 2. Click the Developer Plans tab. The Developer Plan Management page is displayed. 3. Click New Profile. The Profile Definition page is displayed. An asterisk (*) beside a field indicates that it is a required field.
4. Provide the information requested. ■ Name - Enter a name for the profile. ■ Description - Enter a description of the profile. ■ Select Library - Select the library that you want to include. 5. Click Next. The second page for defining a profile is displayed.
6. Select the items from the library that you want this profile to support. To select individual methods, expand the package by clicking the plus sign (+) next to the check box for the package. 7. Click Finish. The new profile is added to the database. 8. Click OK to close the Confirmation page. ▼ Editing a Profile 1. From the Catalog Manager administration console, click Plans in the main menu bar. 2. Click the Developer Plans tab. The Developer Plan Management page is displayed. 3.
5. Click Edit. The edit page displays the same fields as those described in “Adding a Profile” on page 115. 6. Modify the profile as required and click OK. 7. Click OK to close the Confirmation page. The Properties page for the profile is displayed. 8. Click OK. The list of profiles is displayed. ▼ Deleting a Profile 1. From the Catalog Manager administration console, click Plans in the main menu bar. 2. Click the Developer Plans tab. The Developer Plan Management page is displayed. 3.
6. Click OK. The profile is deleted from the database and from any developer plans in which it was included. 7. Click OK to close the confirmation message. ▼ Viewing Developer Plans 1. From the Catalog Manager administration console, click Plans in the main menu bar. 2. Click the Developer Plans tab. 3. Select Developer Plans from the drop-down list. The list of Developer plans is displayed. 4. Click a plan name. The Developer Plan Definition page is displayed. ▼ Adding a Developer Plan 1.
4. Specify a name and description for the Developer plan and select the profiles to be included in this plan. 5. Click OK to save the new Developer plan. A confirmation message is displayed. 6. Click OK to close the confirmation message. You can now add Developer accounts to the plan. See “Adding a Developer Licensee to a Developer Plan” on page 122. ▼ Editing a Developer Plan Before you edit a Developer plan, you might want to view the Developer accounts associated with the plan.
4. Click the Developer plan that you want to modify. The Developer Plan Definition page is displayed. 5. Click Edit. The Developer Plan Definition page displays the same fields as those described in “Adding a Developer Plan” on page 119. 6. Change the information as required, then click OK. ▼ Viewing Developer Licensees Developer licensees are the developer accounts assigned to a Developer plan. You can add and remove members from a developer plan.
4. Click the Developer plan that you want to view. The Developer Plan Definition page is displayed. 5. Click the Developer Licensees tab. The list of Developer accounts associated with the Developer plan is displayed. ▼ Adding a Developer Licensee to a Developer Plan 1. From the Catalog Manager administration console, click Plans in the main menu bar. 2. Click the Developer Plans tab. The Developer Plan Management page is displayed. 3. Select Developer Plans from the View drop-down list. 4.
8. Click Add. The Developer accounts are added as licensees of the Developer plan. 9. Click OK to confirm the addition. ▼ Removing a Developer Licensee from a Developer Plan 1. From the Catalog Manager administration console, click Plans in the main menu bar. 2. Click the Developer Plans tab. The Developer Plan Management page is displayed. 3. Select Developer Plans from the View drop-down list. 4. Click the Developer plan that you want to view. The Developer Plan Definition page is displayed. 5.
4. Select the plan that you want to set as the default. 5. Click OK. The default plan is automatically assigned to new Developer accounts until alternative assignments are made. ▼ Deleting a Developer Plan Before you delete a Developer plan, you might want to review the Developer accounts that are associated with the plan. See S“Viewing Developer Licensees” on page 121. To delete a Developer plan, follow these steps: 1. From the Catalog Manager administration console, click Plans in the main menu bar. 2.
6. Click OK to close the confirmation message. The Developer plan is deleted from the database, and the plan is deleted from the Developer accounts to which it was assigned. If a Developer account is not assigned to any other Developer plan, the default Developer plan is assigned. Getting Background Job Status The time it takes for an operation or job such as changing status or editing device characteristics, to complete can vary greatly.
▼ Getting Job Status ● Click on the Background Jobs notice in the main menu bar. The Background jobs listing pages lists the completed, pending, and failed background jobs.
To clear the listing of successfully completed jobs, click Clean completed. Only pending jobs and failed jobs remain in the list. Pending job status changes when the job successfully completes or fails. Clear the jobs listings regularly to reduce memory usage and to make it easier to review the most recent jobs. Clicking OK leaves the job listings as is and displays the list of submitted contents.
If a job has no additional information, the Detailed Information section states that no other information is available. Clearing a Failed Job Failed jobs remain on the jobs listing page until they are manually cleared. You can do this in the following ways: ■ Click Delete this job to remove the job from the list. The intended job is not completed. ■ Click Retry this job. The job you submitted is run again.
CHAPTER 3 Vending Manager This chapter describes the tasks for administering the Vending Manager. There are two administration roles: Administrator and Customer Care agent. The role is assigned when the Administrator account is created.
■ ■ ■ Resetting trials Issuing refunds Managing Subscriber Plans Creating and managing Subscriber plans ■ Viewing Reports Viewing statistical data Customer Care Agents can also edit their own accounts. They cannot edit other Administrator accounts. Administrator Tasks As a Vending Manager administrator, you are responsible for administering all features of the Vending Manager.
2. From the Stocked Content tab, click Manage Categories. The Catalog Management page is displayed showing the Vending Manager Categories. 3. If you want to create a main category, go to Step 4. If you want to define a subcategory of an existing category, click the category name and then proceed to Step 4. For example, if you want to create a category that is a subcategory of “Business and Professional,” click Business and Professional. The Business and Professional category information page is displayed.
Note – The maximum number of category levels that can be added in a session is set in the CommonConsole.properties file in the $CDS_HOME/deployment/deployment_name/conf/ directory. The default number of levels of categories is set to 10. That is, top-level and sublevel categories can be created but sub-sublevel categories cannot. If you modify the property, you must restart the server to enact the change. ▼ Editing a Category 1.
4. If you want to edit a main category, go to Step 5, otherwise, click the category name to navigate to the subcategory you want to edit. For example, if you want to edit the Legal subcategory of the Business and Professional category, click Business and Professional. The Business and Professional category information page is displayed. 5. Click the edit symbol beside the category that you want to modify. The Edit Category page is displayed.
3. Click the delete category button for the category that you want to delete. The category and all its subcategories are deleted and are removed from all plans and content with which they are associated. To delete a subcategory, click the category name to display its list of subcategories. For example, to delete the Small Business subcategory of the Business and Professional category, click Business and Professional. The Business and Professional category information page is displayed.
3. See a list of content by following one of these steps: a. Click a category name that has no subcategories to see the list of content in that category. b. Expand a category with subcategories by clicking the category name, then click the subcategory name to see its content list. c. Click View By Title to see the list of all published content. This view allows you to browse all content alphabetically by title. Initially, the first 20 items are displayed on the first page.
The following information is displayed for each item. Click the Status, the Title, or the Type column title to sort content by that information type. ■ Status - Provides a graphical indication of whether or not the item is stocked and whether an update is available for a stocked item. TABLE 3-1 shows the symbols used.
■ Title - Displays the title of the content in the catalog. ■ Catalog Price - Displays the amount that the Vending Manager has to pay the Catalog Manager for every sale they make to a subscriber. ■ Categories - Displays the multiple categories (and their complete paths) that are assigned to the content in the catalog. ■ Short Description - A short description of the content. ■ Type - Displays the type of content.
■ General Information - Indicates whether the content is stocked, or if an update to the property information associated with the item is available. The following items appear on this page: ■ If the content is not stocked, a Stock Content button is displayed at the top of the page. ■ If the content is stocked, a View Stocked Content button is at displayed the top of the page. ■ If an update is available for a stocked item, an additional link to Update Information is on the Stocked Contents tab.
■ Catalog Description - A description of the content. If icons, documentation, or screen shots were submitted with the content, click the View button for the item to see what was submitted. If the item is a ring tone and a preview was submitted, click the Listen button to hear the preview. ■ Editions - The list of editions submitted for this item. 5. Click OK. ▼ Viewing Editions of Published Content 1. From the Vending Manager administration console, click Content on the main menu bar. 2.
The following information is shown for each edition: ■ ■ ■ ■ ■ ■ Edition ID Name Version Edition Type Original Edition Modified Date The Edition Type, Original, indicates the initally submitted content, while Final indicates the actual content that is delivered to subscribers. If the content item has OMA DRM protection, a Trial type indicates a content item that is delivered to subscribers for trial usage.
6. When you are done viewing the Edition Properties, click OK. If no devices are listed in both the Supported Devices and Matched Devices fields, the Catalog Manager administrator made the edition unavailable to subscribers. Setting Stocking Options From the Catalog tab, you can specify stocking options. The current status of the stocking options is displayed after the title of the tab.
To enable auto-stocking, follow these steps: 1. From the Vending Manager administration console, click Content on the main menu. 2. Click the Catalog tab if it is not the active tab. 3. Click Stocking Options. The Stocking Options page is displayed. 4. Click Auto-stocking On. 5. Click OK to save your changes. To set automated price markups, see “Setting Local Pricing” on page 153.
To stock content, follow these steps: 1. From the Vending Manager administration console, click Content on the main menu bar. 2. Click the Catalog tab if it is not the active tab. The Content Management page displays a list of the main categories. 3. Click View by Title. Use the search feature or view the list of content for the category that contains the item. 4. Click the title of the content that you want to stock. The Content Properties page is displayed.
■ Keyword - You can create a unique keyword to identify this content item. This keyword is used by subscribers when ordering content. Keywords are used when content is requested through mobile originated (MO) push. Keywords can contain spaces, underscores, and dashes, but cannot contain special characters, such as an asterisk (*). Also, keywords consisting only of numeric characters are invalid.
Note – When scheduling a stocking operation, be aware that if large numbers of content are being stocked, the operation can take some time to complete. 1. From the Vending Manager administration console, click Catalog on the main menu bar. 2. Click Stock Content. The Stock Content page is displayed.
An asterisk (*) beside a field indicates that it is a required field. Only unstocked content items are selectable. Category and content item names change from gray to black as the categories and content items are loaded. Wait until all items are loaded before making a selection. 3. Select the categories that you want to stock. Under the catalog categories column on the left, you can select one or more categories of content or individual content items to stock.
4. Select one or more destination categories under the Vending Categories column. Under the Vending Manager categories column on the right, you can select one or more terminal categories in which you want the content to be stocked. A terminal category is the lowest level category and contains only content items. You cannot select higher level categories. 5. Specify the content status and the External Content ID.
6. Click Stock. Click Clear to remove all selections in both trees and reselect categories and content items. Clicking the Cancel button clears all selections and displays the top-level Catalog page. 7. Confirm or cancel the operation. The Stocking Job Status page appears. TBD 8. Click Done. TheStock Content page is displayed.
To stop a stocking job from this page, see the next section. Viewing Stocking Jobs At the bottom of the Stock Content page, you can see a list of executing, pending, and failed stocking jobs: The following information is shown for each job: ■ ■ ■ ■ ID - Content ID Started - Date and time stocking occurred Started By - Administrator who performed the operation Status - Current status of the job: ■ Executing - Stocking operation is in process.
▼ Stopping a Stocking Job You can stop a stocking job with an Executing or Pending status from the Stocking Jobs Status page or the Stocking Jobs section of the Stock Content page. 1. From the Stocking Job Status page, click Stop. 2. Confirm or cancel the stocking job. No undo command is available. Items that are already stocked remain stocked. Any items in Pending or Failed status are not stocked.
Checking the Status of a Stocking Job You can check on the status of a stocking job in one of the following ways: ■ Click Stock to see the status of the current stocking job. ■ Click on a job ID in the Stocking Jobs list to check the status of a specific stocking job.
■ Pending - Number of items that are pending is displayed in the header bar above the columns. ■ Stopped - Number of items that are stocked, failed to stock, or not stocked when the job was stopped is displayed in the header bar above the columns. ■ Content Tile - Name of the content item ■ Vending Categories - Categories containing the content item ■ Status - Current status of the content item.
6. Click OK. The View Content Properties page is displayed showing the updated information. Pricing for Content for a Locale Vending Managers can be widely distributed geographically. In such cases, multiple currencies are involved in pricing content. The system administrator configures the currencies and initial price equivalents for a Vending Manager’s locale. This is known as the General Pricing Rule.
The page displays the following information: 154 ■ General Pricing Rule set by the system administrator at deployment. ■ List of content types. Click the column head to sort the list alphabetically. ■ List of option IDs associated with a content type. Click the column head to sort the list alphabetically. ■ The current purchase price and usage condition set in the Catalog Manager. ■ The current purchase price equivalent in the Vending Manager’s local currency under the General Pricing Rule.
3. Enter the value for your local currency equal to the one currency unit. If the one currency unit is one Euro and your local currency is Yen, enter the current equivalent value in Yen. 4. Enter the percentage markup by which you want to increase the purchase price, if desired. If you do not want to increase the purchase price of content by a percentage, enter 0 or leave the field empty.
1. From the Vending Manager administration console, click Content on the main menu bar. 2. Click the Stocked Content tab. 3. Click View by Title to list all content. 4. Click the content name to go to the content’s property page. 5. Click Edit. 6. Change the vending price. 7. Click OK to save the change. A confirmation message appears. 8. Click OK to close the confirmation message.
3. Enter the search term in the Search field. 4. Select the category that you want to search from the Category drop-down list. 5. Select the status of the content from the Status drop-down list. 6. Click Search. The Stocked Content page shows a list of stocked content that meets the search criteria that you specified. ▼ Changing the Status of Stocked Content Stocked content can have the following three states: ■ Active - Active content is available to subscribers.
1. From the Vending Manager administration console, click Content on the main menu. 2. Click the Stocked Content tab if it is not the active tab. 3. Navigate to the item with which you want to work. You can use the search feature or view the list of content for the category that contains the item. 4. In the first column of the content list, check the content whose status you want to change. 5. From the Change Status To drop-down list, select the status you want. 6. Click GO.
▼ Editing Stocked Content 1. From the Vending Manager administration console, click Content on the main menu. 2. Click the Stocked Content tab if it is not the active tab. 3. Navigate to the stocked item that you want to edit. You can use the search feature or view the list of content for the category that contains the item. 4. From the content list, click the title of the content that you want to edit. The View Content Properties page is displayed. 5. Click Edit. The Edit Content page shows the properties.
You can edit the following fields: ■ Status - Content can be active (available to subscribers) or inactive (unavailable to subscribers). ■ Vending Price - Purchase price for the content item charged to the subscriber. The Catalog Price shows the pricing option for the content item in the Catalog Manager. ■ External Content ID - Information used by your billing system to identify this content.
■ Enter the External Group ID that your billing system uses to identify this content or select it from the list provided. This field can be blank if your system does not use group IDs. ■ Categories - The categories to which the content is assigned. ■ Catalog Description - The properties of the content. ■ Product name and version number. ■ Short content description (maximum of 40 characters). ■ Long content description (maximum of 256 characters).
4. Select the items that you want to edit. 5. Click Edit External ID. The Edit External Content page is displayed. 6. Select the items that you want to change. 7. Enter or select the external content ID and external group ID in the fields for an item to change individual items. To change all selected items to the same external content ID, select Content IDs and enter a value or select the value to be assigned to all items.
▼ Copying or Moving Categories of Content You can move or copy whole categories of content at a single time in the Vending Manager. By copying or moving one or more categories, you are copying or moving all the content items within those categories. Note – When scheduling a copy or move operation, be aware that if large numbers of categories and content are being copied or moved, the operation can take some time to complete. You can also selectively move or copy individual items of content.
Category and content item names change from gray to black as the categories and content items are loaded. Wait until all items are loaded before making a selection. 4. Select the categories you want to copy or move. Under the source column on the left, select one or more categories to copy or move. If you select a higher level category, all of its subcategories, including their content items, are also copied or moved. You cannot select individual items of content.
5. Select one or more destination categories. Under the destination column on the right, you can select one or more higher levelcategories. The destination category you select cannot be a terminal category. A terminal category is the lowest level category and contains only content items. You must click the check box to select an item in the tree. 6. Click Copy or Move. The Copy and Move buttons only become active when at least one selection is made in both the source and destination trees.
7. Confirm or cancel the operation. If copied, categories and their associated content are duplicated under each destination category. If moved, categories and their content are removed from the original location and placed in the destination category. If more than one destination category is selected, categories and content are duplicated under each destination category. The preceding figure shows the results of moving the Investment and Accounting categories to the Business and Professional category.
■ If the category is empty, that is, it contains no content items or subcategories, you can delete the category from its new location. See “Deleting a Category” on page 133 for more information. ■ If the category is not empty, you must remove its subcategories and content items by moving or copying them to another location before you can delete the category.
Category and content item names change from gray to black as the categories and content items are loaded. Wait until all items are loaded before making a selection. 4. Click Individual Items. 5. Select the content items of content in one or more categories that you want to copy or move. Under the source column on the left, you can select one or more items of content to copy or move but you cannot select categories. You must click the check box to select an item in the tree.
6. Select one or more destination categories. Under the source column on the right, the destination categories you select must be terminal categories. A terminal category is the lowest level category and contains only content items. You must click the check box to select an item in the tree. 7. Click Copy or Move. The Copy and Move buttons only become active when at least one selection is made in both the source and destination trees.
The preceding figure shows the results of copying the content items, SpruceClock and Technopop to the Mobile Mail and Instant Messages categories. The content items are still available in the Featured category. If you copy a content item to a category and decide that you do not want the item in that category, you can edit the content to change the category assignment. See “Editing Stocked Content” on page 159 for information.
changing the price in this manner, dissociates the selected content items from their pricing options. See “Disassociating Content From Pricing Options” on page 30 for more information. Note – Customizing content pricing has no Undo operation. Before enacting any changes, be sure to review the changes to ensure that the correct changes apply only to the intended contents. To change the price of content per category, follow these steps: 1. Click Content from the Vending Manager’s main menu. 2.
4. Select the category or subcategories of content or specific contents. To change the purchase price of all the contents of a category, simply click the category itself. To change the purchase price of specific content items in a category, navigate through the category to select individual content items. 5. (Optional) Select the External Content ID filter to apply the pricing change to only those selected contents that have the given ID. Click Choose to select the desired content ID or group ID.
6. Change the purchase price in one of the following ways: ■ ■ ■ Enter a new purchase price. Increase or decrease the purchase amount by N per cent. Increase or decrease the purchase price by a dollar amount. The price is applied to all selected content regardless of their pricing models. For example, if SpruceDraw is $5.00 per monthly subscription and Launch Screen is $0.50 per download, increasing the purchase price by 10% results in SpruceDraw being offered at $5.
■ If the Vending Manager’s Auto-stocking option is turned on, the content is immediately reactivated. The bundle’s property page shows a status of Active for the content and the content is available to subscribers again. ■ If the Auto-stocking option is turned off, you must restock the content in the Vending Manager to reactivate the bundle. See “Editing a Bundle” on page 183, “Stocking Content Manually” on page 142, and “Setting Stocking Options” on page 141 for more information.
■ Per interval - After initial download, the subscriber is not is not charged for using this content item for the stated time interval. Subscriber cannot purchase this item again as it is only offered for a specific time. ■ Per subscription - No content items with this pricing model are allowed in a bundle.
3. Click Create Bundle. The Create Bundle page is displayed.
An asterisk (*) beside a field indicates that it is a required field. 4. Specify the following information: ■ General Information ■ Status - Select whether the bundle is active or inactive to subscribers. Items within a bundle cannot be inactivated. To inactive an item, it must first be removed from the bundle. ■ Content Included in the Bundle - Select content from the category tree, which provides access to all content in the system. A minimum of two contents items are required.
■ Bundle Price ■ ■ Provide the bundle at no charge to the subscriber for the content. Set the bundle purchase price. Bundle price overrides the pricing assigned to individual content items for first download. The pricing models for individual content items still apply. ■ External Content ID This section is available only if your system uses something other than the Content Delivery Server content ID to identify the content.
▼ Viewing Bundle Information 1. Click Content in the Vending Manager administration console’s main menu. 2. Click Bundled Content in the Content Management page. 3. Click View by Title. The Browse Vending Content By Title page is displayed. For each bundle in the list, its status, title, content ID, retail price, and vending categories are displayed. You can also view bundles specific to a category by clicking on a category from the Bundled Content categories list. 4.
Note – If the status of a content item that is part of a bundle is changed to Inactive or Unpublished by the Catalog Administrator, the content is removed from the bundle and is not available to subscribers who purchase the bundle after the status change. Check the status of content in a bundle from the bundle’s properties page by clicking on the title of a bundle.
▼ Deleting a Bundle 1. Click Content in the Vending Manager administration console’s main menu. 2. Click Bundled Content in the Content Management page. 3. Click View By Title. 4. Select the check box for the desired bundle in the list. 5. Click Delete. You cannot delete individual items within a bundle. You must create a new bundle containing only those desired items. 6. Click OK to confirm the unbundling of the content for the selected bundle.
6. Select the items that you want to change. 7. Enter a value or select the External Content ID or the External Group ID in the for each selected bundle. To change all selected items to the same external content ID, select Content IDs and enter a value or select the value to be assigned to all items. To change all selected items to the same external group ID, select Group IDs and enter a value or select the value to be assigned to all items. 8. Click Submit to submit your changes.
▼ Editing a Bundle You can modify a bundle by changing its status, contents, retail price, and so on. To edit a bundle, follow these steps: 1. Click Content in the Vending Manager administration console’s main menu. 2. Click Bundled Content in the Content Management page. 3. Click View by Title. 4. Click on the title of the bundle you want. The View Content Bundle Properties page opens. 5. Click Edit and make your changes. 6. Click OK. 7. Click OK to close the Confirmation page.
▼ Stocking Testing Content If the auto-stocking option is set to OFF, you can manually stock content items with Testing status to make them available to subscribers with testing roles. 1. Click Content on the Vending Manager administration console’s main menu. 2. Click the Content Testing tab. A list of all content with Testing status is displayed. 3. Click Stock for the testing content item you want to stock. The Stock Content page is displayed. 4. Make changes as desired.
▼ Creating a Campaign The Content Download Server provides a wizard to help you define a marketing campaign. The wizard leads you through the steps of specifying the campaign type, the target audience, the marketing message, content and pricing details, and scheduling and duration. To start the Campaign Wizard, follow these steps: 1. Click Campaigns on the Vending Manager administration console’s main menu. 2. Click New on the Campaign List header. The first page of the Campaign wizard is displayed.
▼ Specifying Campaign Options and Target Audience The Campaign Options page lets you define the name and description of the campaign, and the market segment that receives it. You can also assign a coupon to the campaign. If you are creating an event-driven campaign, you can define the event that triggers the campaign. Complete the fields in the Campaign Options page. An asterisk (*) beside a field indicates the field is required. 1. Enter the name of the campaign and a description.
3. Choose the Subscriber Segment from the drop-down list. The Subscriber Segment is the target audience for the campaign. The list contains all of the subscriber segments that are currently defined. See “Creating a Subscriber Segment” on page 195 for more information. Only subscribers who selected the option of “Notify me for update or promotions” through the subscriber portal are included in a subscriber segment. 4. Select a triggering event and activate a campaign. a.
1. Enter the subject of the advertisement. This string is also used as the subject line for advertisements sent as email. Note that though you can enter as much text you like in the Subject and Text fields, a character limit might apply when sending the message depending on the template that might be applied to it (for example, SMS). 2. Enter any message that you want included in the advertisement in the text field. You can leave this blank if you do not want to include a message.
To specify content for a campaign, follow these steps: 1. Set the content in one of the following ways: a. Click All Active Content. This action enables all currently valid content, including newly stocked content, to be included in existing campaigns. b. Open the tree and select the check boxes next to the specific items that you want to include in the campaign. To include all of the content in a category, select the check box next to a category name. 2. Click Next to proceed.
To specify pricing characteristics for a campaign, follow these steps: 1. Select the Discount on Items check box and enter a value by which the price of the item is to be discounted. 2. Set a duration for the discount offer: ■ Offer valid for - Enter the number of days for which the offer is valid. ■ Never expire - Continue the pricing discount as set until the campaign is discontinued. 3. Click Done to complete the campaign definition.
To create a schedule for a campaign, follow these steps: 1. Set up the campaign schedule. Choose one of the following schedules: ■ Process and send the message immediately. ■ Defer processing, in which case, enter the time and date when the message is to be processed and sent. Enter the date and time of processing and sending the campaign in the format shown next to each field. Enter the time based on a 24-hour clock. 2. Click Done. Click OK to return to the list of defined campaign.
This page enables you to review the information for your advertisement. 192 ■ To view the items that are included in the campaign, click View List in the Promotional Content section. ■ To view the subscribers to whom the advertisement is sent, click View List in the Subscriber Segment section.
■ To see the format of the message that is sent to the subscribers, click Preview in the Promotional Message section. The format is determined by the notification template set up by your system administrator. See “Working with Campaign Templates” on page 197 for more information. ■ To see the campaign schedule for outbound campaigns, look in the Scheduling section. 3. Click Send Message to queue the advertisement for processing. A confirmation page is displayed. 4. Click OK. ▼ Editing a Campaign 1.
Working with Subscriber Segments A subscriber segment defines the criteria for separating subscribers into groups. The Subscriber Segment List page displays the current list of subscriber segments, a short description of each segment, and an estimated number of subscribers. The number of subscribers is only an estimate because some segments need to know the content list to determine whether a subscriber matches a criterion.
▼ Displaying Subscriber Segments 1. Click Campaigns in the Vending Manager administration console menu bar. The Campaign List page is displayed. 2. Click the Segments tab in the Campaign List page. The Subscriber Segments page is displayed. ▼ Creating a Subscriber Segment 1. Open the Subscriber Segments page. 2. Click New. The Subscriber Details page is displayed.
3. Specify the following information: ■ Enter a name and description for the subscriber segment. The name must be unique to other segment names and it must not exceed 255 characters. ■ Select the check box if a subscriber must match all of the specified criteria in this page to belong to this segment. If the check box is clear, advertisements are sent to subscribers who meet any of the criteria specified.
■ The subscriber plan to which the subscriber belongs. ■ The device a subscriber uses. ▼ Editing a Subscriber Segment 1. Open the Subscriber Segment List page. See “Displaying Subscriber Segments” on page 195 for more information. 2. Click a subscriber segment name or description. The Segment Details page is displayed. 3. Edit the fields in the Segment Details page. See “Creating a Subscriber Segment” on page 195 for a description of the fields. 4. Click OK when you are finished.
You can write code that presents the same general format for the message but allows for variations suitable for each delivery method. If you define a style sheet for MMS, specify the name of the MMS message to which it applies. 4. Click OK. TABLE 3-2 describes the properties that you can use to customize the template for your needs. TABLE 3-2 198 Properties Available for Notification Templates Property1 Definition Name The name assigned to the campaign.
TABLE 3-2 Properties Available for Notification Templates (Continued) Property1 Definition ID Campaign ID Subject The email subject line. Coupon The defined coupon code. Message The message that the administrator wants to include in the notification. CampaignURL The URL the subscriber should use to purchase from the campaign. DeviceCampaignURL The URL that will take a subscriber to the campaign on the subscriber’s device.
TABLE 3-2 Properties Available for Notification Templates (Continued) Property1 Definition ContentItem/ConfigurationVersion The version of the item. For MIDlets and iAppli applications only. ContentItem/ProfileVersion The API set used in the application. For MIDlets and iAppli applications only. ContentItem/Classname The name of the iAppli application file. For iAppli applications only. 1All property names must be preceded by /CDSNotification/. For example, /CDSNotification/Name.
▼ Editing a Campaign Template 1. Open the Campaign Templates page. See “Displaying Available Campaign Templates” on page 197 for more information. 2. Click the name or description of the template you want to edit. 3. Edit the values in the Campaign Template Details page. 4. Click OK. Managing Vending Manager Administrator Accounts Administrators have access to the Vending Manager.
3. To view an individual Administrator Account, click the administrator name. If you are a Customer Care Agent, you can view your own account by clicking the My Account tab on the Account Management page. The Administrator Account Details page is displayed. From here you can edit or delete an Administrator Account. ▼ Adding a Vending Manager Administrator Account 1. From the Vending Manager, click Accounts on the Main menu. 2. Click the Administrators tab. The list of Administrator Accounts is displayed 3.
Complete the following fields: ■ Login ID - Enter the Login ID the administrator uses to access the Vending Manager. It must be unique and at least three characters. ■ Password - Enter a password of at least four characters. ■ Confirm Password - Reenter the password. ■ Status - Leave the status as Enabled unless you want to suspend access to the Vending Manager. ■ Role - Select the role that you want to assign to the administrator, either Administrator or Customer Care Agent.
▼ Editing a Vending Manager Administrator Account To edit all Administrator Accounts, you must be an administrator. Customer Care Agents can edit only their own account. To edit an Administrator Account, follow these steps: 1. From the Vending Manager administration console, click Accounts on the main menu bar. 2. Click Administrators. The list of Administrator Accounts is displayed. 3. Click an administrator name. The Administrator Account page is displayed. 4. Click Edit.
5. Modify the information as required. 6. Click OK. The Edit Administrator confirmation page is displayed. 7. Click OK again to close the confirmation message. The Administrator Account is updated in the database. ▼ Deleting a Vending Manager Administrator Account 1. From the Vending Manager administration console, click Accounts on the main menu bar. 2. Click the Administrators tab. The list of Administrator Accounts is displayed. 3. Click an administrator name.
▼ Viewing Stocked Content 1. From the Vending Manager administration console, click Content on the main menu bar. The Stocked Content page displays a list of the main categories defined. A number beside each category indicates the number of stocked items. 2. Click a content category or subcategory to view a list of the stocked content for the selected category. To view all content by title, click View By Title. This view allows you to browse content alphabetically by title.
Note – The Edit External ID button appears only if your billing system requires something other than the Content Delivery Server content ID to identify the content. The following information is displayed for each item: ■ Status - The status of the item. It can have the following values: ■ ■ Active - Stocked content is made available to subscribers. Inactive - Stocked content is not made available to subscribers. ■ Title - The title of the content. ■ ID - The content ID.
To set the display of stocked content, follow these steps: 1. From the Vending Manager administration console, click Content on the main menu bar. 2. Click the Stocked Content tab if it is not the active tab. The Vending Preferences page is displayed. 3. Click Preferences.
▼ Viewing Editions of Stocked Content 1. From the Vending Manager administration console, click Content on the main menu bar. 2. Click the Stocked Content tab if it is not the active tab. The Content Management page displays a list of the main categories defined. 3. Navigate to the item that you want to examine. You can use the search feature or view the list of content for the category that contains the item. 4. Click the title of the item. The View Content Properties page is displayed.
▼ Viewing Subscriber Accounts 1. From the Vending Manager administration console, click Accounts on the main menu bar. 2. Click the Subscribers tab. The list of Subscriber accounts is displayed. If no device is specified to be used, the Device field is blank. 3. Click the login ID for the subscriber account that you want to examine. The Subscriber Account page is displayed. From this page you can edit or delete a Subscriber account. 4. Click OK to return to the previous page.
3. Click Add New Subscriber. The Add New Subscriber page is displayed. 4. Enter the required information: An asterisk (*) beside a field indicates that it is a required field. ■ Login ID - Enter the unique subscriber ID that the subscriber uses to log in to the subscriber site. ■ Password - Enter a password of at least four characters. ■ Confirm Password - Reenter the password. ■ Status - Leave the Status as Enabled unless you want to suspend access to the Subscriber Portal for this subscriber.
■ Subscriber’s role - Select Test subscriber for a subscriber who is testing content only. Select Regular subscriber for a subscriber who is accessing published content. ■ Contact Information - Specify contact information for the subscriber. Complete the other fields on the page as desired. 5. Click OK. 6. Click OK again to close the Confirmation page. The new Subscriber account is added to the database. 7. Click OK to close the Information page. ▼ Editing a Subscriber Account 1.
5. Modify the information as required, then click OK. The Edit Subscriber confirmation page is displayed. 6. Click OK again to close the Confirmation page. The Subscriber account Is updated in the database. ▼ Viewing a Subscriber ’s Download History To view the list of content that a subscriber has downloaded, follow these steps: 1. From the Vending Manager administration console, click Accounts on the main menu bar. 2. Click the Subscribers tab. The list of Subscriber accounts is displayed. 3.
3. Click the Login ID for the subscriber account with which you want to work. The Subscriber Account page is displayed. 4. Click Content List. The list of content that the subscriber has downloaded is displayed. 5. Click Edit License for the content with which you want to work. 6. Select the new status from the Status list. 7. Click OK to save the change. 8. Click OK to close the Confirmation page.
▼ Issuing a Refund 1. From the Vending Manager administration console, click Accounts on the main menu bar. 2. Click the Subscribers tab. The list of Subscriber accounts is displayed. 3. Click the login ID for the subscriber that you want to work with. The Subscriber Account Details page is displayed. 4. Click Content List. The list of content that the subscriber downloaded is displayed. 5. Click Edit License for the content with which you want to work. 6. Select Initiate Refund. 7. Click OK.
Managing Subscriber Plans Subscriber accounts are assigned to Subscriber plans. Subscriber plans determine which content a subscriber can access and download. A Subscriber plan is mapped to selected categories in the Vending Manager. The content in the selected categories is made available to plan members. If content is in a category that is not supported by the Subscriber plan, the subscriber cannot access it for download.
■ Parent plan information. Parent plans are listed alphabetically (includes the name of the plan, any subplans it contains, and a description of the plan). ■ The category paths. All category paths associated with the plan are listed in the order in which they appear in the Vending Manager Category. The Members page displays all the Subscriber accounts that are currently members of the Subscriber plan. From this page you can view a Subscriber account and add and remove Subscriber accounts from the plan.
3. Enter the following information ■ Specify a name and description of the plan. ■ Check the plans to be included within the plan. ■ Select the categories you want to offer to subscribers that are assigned to this plan. Content stocked in these categories is made available to the subscribers assigned to this plan. 4. Click OK. Note – You can now add the Subscriber account to a Subscriber plan. See “Adding Members to a Subscriber Plan” on page 220.
3. Click Edit. The Subscriber Plan Management page displays the same fields as those described in “Adding a Subscriber Plan” on page 217. 4. Modify the plan as required, then click OK. The plan is updated in the database. 5. Click OK. The list of subscriber plans is displayed. ▼ Viewing Subscriber Plan Members Members are the Subscriber accounts assigned to a Subscriber plan. After you create a new plan, you can add members. You can also add and remove members from an existing plan.
1. From the Vending Manager administration console, click Plans on the main menu bar. The Subscriber Plan Management page displays all the Subscriber plans defined. 2. Click the plan whose list of members you want to see. The Subscriber Plan Management page for the selected plan is displayed. 3. Click Members. All members subscribing to the selected plan are shown. ▼ Adding Members to a Subscriber Plan 1. From the Vending Manager administration console, click Plans on the main menu bar.
▼ Removing Members from a Subscriber Plan 1. From the Vending Manager administration console, click Plans on the main menu bar. The Subscriber Plan Management page displays all defined Subscriber plans. 2. Click the Subscriber Plan name to view the properties of a Subscriber plan. The Subscriber Plan Properties page is displayed. 3. Click Members. The Members tab displays all Subscriber Accounts that are currently members of the plan. 4.
3. Check the plan you require, then click OK. The default plan is automatically assigned to new Subscriber accounts until alternative plan assignments are made. ▼ Deleting a Subscriber Plan Before you delete a plan, you might want to review the Subscriber accounts that are assigned to the plan. See “Viewing Subscriber Plan Members” on page 219. To delete a Subscriber plan, follow these steps: 1. From the Vending Manager administration console, click Plans on the main menu bar.
▼ Editing Your Administrator Account This function is available only to Customer Care Agents. Vending Manager administrators edit their account the same way that they edit the account of another Vending Manager administrator. See “Editing a Vending Manager Administrator Account” on page 204. To edit your own Customer Care Agent account, follow these steps: 1. From the Vending Manager administration console, click Accounts on the main menu bar. The Accounts Management page is displayed. 2.
2. Select a content type from the Select Content Type drop-down list to display reports for other content types. Reports display the following information: ■ Application Download Reporting - The number of downloads and applications: ■ Total Downloads - The total number of downloads for the application type. ■ Applications in the Field - The total number of applications for the application type. ■ Most Popular Downloads - The top five downloaded applications.
Sending MMS Messages The Vending Manager’s MMS feature lets you send messages containing video, image, and audio files. This section covers the following actions: ■ ■ ■ ■ ■ ■ ▼ Choosing MMS as the Content Delivery System Displaying MMS Messages Creating an MMS Message Editing an MMS Message Testing an MMS Message Using the MMS Test Log Choosing MMS as the Content Delivery System The Content Delivery Server lets you choose MMS as the preferred delivery mechanism for message content.
▼ Creating an MMS Message 1. Click MMS in the main menu of the Vending Manager administration console. 2. Click New MMS Message. The MMS wizard opens and the Edit MMS page is displayed. 3. Enter a name for the message and the message text. A maximum of 256 characters are allowed for the message text. 4. Specify whether you want the text to appear on the top or the bottom of the device’s display area.
5. Select one or more device types in the table. The device type table lists the MMS-capable devices from your chosen list of supported devices. The table has navigation buttons that enables you to display additional device entries. 6. Click Next to proceed. 7. Select the media type you want to include with the message. This page enables you to select any of the media types that are appropriate for the selected devices. If you select both image (or video) and audio, the media types are run serially. 8.
11. Click Save to save the MMS message to the server. Alternatively, you can click Save and Test to save the message and to perform a test send. See “Testing a New MMS Message” on page 229 for more Information. 12. Click OK to close the Confirmation page. ▼ Editing an MMS Message 1. Click MMS on the main menu of the Vending Manager administration console. 2. Click the title or text of a message. The MMS Message wizard is displayed. 3.
4. Click Save to save the MMS message to the server or Save and Test to save the message and to perform a test send. See “Testing an MMS Message” on page 229 for more information. 5. Click OK to close the Confirmation page. ▼ Testing an MMS Message The Test MMS Message page enables you to send a test message to an email address and to a wireless device. You can send a test MMS message when you create it or you can test sending any message in the MMS message list.
Test status is either Passed, Failed, or Not Tested. Enter any comments regarding the test in the Comments field. 6. Click Save. See “Using the MMS Test Log” on page 231 for more information. ▼ Testing an Existing MMS Message To perform a test send of an existing MMS message, follow these steps: 1. Open the MMS Messages page. See “Displaying MMS Messages” on page 225 for instructions on accessing this page. 2. Click the title or text of a message. The MMS Message wizard is displayed. 3.
■ ■ Select the check box next to the messages you want to delete Choose All from the drop-down list 3. Click Delete. 4. Click OK to close the confirmation dialog box. ▼ Using the MMS Test Log The MMS Test Log enables you to record the results of sending a test MMS message for a particular device. You can also record comments about the test. 1. Click Edit MMS Test Log in the Edit MMS page. 2. Select the appropriate test results from the drop down list and enter any comments about the test. 3.
232 Administrator Guide • 2005Q4
APPENDIX A Device Capabilities This appendix describes the device capabilities that you can specify for the devices that you use with the Sun Java System Content Delivery Server. It also provides a sample specification for a common device. See “Managing Devices” on page 68 for information on how to specify device capabilities.
Mandatory Capabilities Mandatory capabilities are capabilities that must be specified for a device to accept MIDlet applications. TABLE A-1 lists the mandatory capabilities for devices used with the Content Delivery Server. TABLE A-1 Mandatory Capabilities Name Type Description Example Value MicroEditionConfiguration String Software Platform specific: Connected Limited Device (CLDC) Configuration version. CLDC-1.
Browser Capabilities Browser capability refers to the browser type specified for a device. A string value specifying the browser that is rendering markup on the device is given. For example, Browser Type can have one of the following values: ■ ■ ■ ■ WML-1_2 XHTML-NokiaSeries40 XHTML-Symbain XHTML-UP User Interface and Software Capabilities The Content Delivery Server uses the user interface and software capabilities to refine the capability matching process.
TABLE A-3 User Interface and Software Capabilities (Continued) Name Type Description Example Value Confirm Capable Boolean Software platform-specific: Confirm Capable Defines whether or not the device sends a confirmation (MIDlet-Install-Notify) after a MIDlet is installed. Yes or No Delivery Type List Software platform-specific: Delivery Type Defines the content delivery mechanism the device supports.
List A list value can contain one or more values. To select multiple values from the list provided, hold the Control key while clicking on each item that you want to include. Each value is shown on a separate line when the items are displayed as a string. For example, Supported Libraries takes a list value that can be either DOJA-1.0, MIDP1.0, or MIDP-2.0. Integer An integer value is a numeric value. The integer must be a whole number. The value does not support decimal points.
Nokia 6310i TABLE A-4 shows the specifications for the Nokia 6310i device. TABLE A-4 238 Nokia 6310i Device Specifications Capability Value Browser Type WML-1_2 Bits Per Pixel 16 Ccpp Accept Language en_US Ccpp Accept String application/java-archive image/gif image/vnd.wap.wbmp text/plain text/vnd.sun.j2me.
User-Defined Devices The following blank tables are provided for you so you can enter information for the devices that you add to the Content Delivery Server.
TABLE A-6 Device Specifications for a User-Defined Device 2 (Continued) Capability Color Capable Confirm Capable Delivery Type Image Capable Input CharSet Maximum Application Size MicroEdition-Profile Number of softkeys Output CharSet Push Type Screen Height Screen Width 240 Administration Guide • 2005Q4 Value
APPENDIX B Content Pricing Content types are assigned a DRM type in the Catalog Manager along with the possible pricing models that can be used for that content type.
TABLE B-1 Associated DRMs, Content Types, and Pricing Models (Continued) DRM Type DRM Agent or Format CDS DRM Agents Disconnected Time Sensitive 242 Content Type midlet Pricing Model Free always First download only Every download Per period Per subscription Disconnected Use Sensitive midlet Free always Trial First download only Every download Per period Per use Disconnected Use and Time Sensitive midlet Free always Trial First download only Every download Per period Per use Per subscription
TABLE B-1 DRM Type Associated DRMs, Content Types, and Pricing Models (Continued) DRM Agent or Format Content Type Pricing Model ringtone image midlet iappli video Free always First download only Every download Forward Lock ringtone image midlet iappli video Free always First download only Every download Combined Delivery ringtone image midlet iappli video Trial Per use Per period Per interval Separate Delivery ringtone image midlet iappli video Trial Per use Per period Per interval CDS OMA
Initial purchase price for Item 1 and Item 2 are shown as they exist in the Catalog Manager and the Vending Manager. The currency type is the same for both the Catalog Manager and Vending Manager ($). The General Pricing Rule is $1.00 is equivalent to $1.00 and no markup is applied. TABLE B-2 Initial Pricing Set for Items 1 and 2 Catalog Manager Vending Manager Item1 $1.00 per Download PO 1A $1.00 per Download PO 1A Item2 $1.00 per Download PO 1A $1.
Scenario 3: Two changes to Item1 occur: ■ The Vending Manager administrator edits the property of Item 1 by changing the purchase price from $1.00 to $0.75. Item 1 is now disassociated from pricing option 1A in the Vending Manager. ■ Later, the Catalog Manager administrator edits pricing option 1A by changing the purchase price from $1.00 to $0.80. In the Catalog Manager, Item 1 and Item 2 are still associated with pricing option 1A.
Scenario 6: Item1 is never associated with a pricing option. The Catalog Manager administrator assigns a price of $2.00 to it. Later the administrator changes the price to $2.50. TABLE B-8 Resulting Pricing for Items 1 and 2 in Scenario 6 Catalog Manager 246 Vending Manager Item1 $2.50 per Download Custom $2.50 per Download Custom Item 2 $1.00 per Download PO 1A $1.
Glossary This glossary defines the terms and acronyms used in the context of this guide. Accounts The individuals who have access to the Sun Java System Content Delivery Server. Four types of accounts are available: Developer Accounts, Vending Manager Accounts, Subscriber Accounts, and Administrator Accounts. Active Content Stocked content that is available to the Vending Manager and to subscribers. The Vending Manager administrator can change the status of content that is active.
Campaign Coupon Capabilities Catalog Manager Catalog Price Category Connected Limited Device Configuration (CLDC) A sequence of characters and numbers used to identify a campaign. With a coupon, a subscriber can purchase content that has been promoted or discounted for a specific campaign. Criteria that the Catalog Manager uses to define the devices that can download specific content.
Content Descriptor Template Content Provider Content Provider Price A description of content other than MIDlets (such as Ring Tones, Pictures, and Symbian applications) similar to the way a JAD File describes a MIDlet. The individual or corporation who submits content to the Catalog Manager. Purchase price of content set or selected by the content provider. The content provider price can be overridden by the Catalog Manager administrator. See Catalog Price and Vending Price.
Locale Mandatory Capabilities MIDlet Mobile Information Device Profile (MIDP) Obfuscation Over-The-Air Protocol (OTA) Pictures Plan Pricing Controls A geographic or political region or community that shares the same language, customs, or cultural convention. In software, a locale is a collection of files, data, and code, which contains the information necessary to adapt software to a specific geographical location. Required capabilities for a device to accept MIDlet applications.
Profile Purchase Price Record Management System (RMS) Ring Tones Short Message Service (SMS) Stocked Item Subscriber A Profile defines a set of APIs that a developer can use in applications submitted to the Content Delivery Server. See also Developer Plans. A monetary value assigned to an item of content. The currency type as seen by subscribers is determined by individual Vending Managers.
Testing Content Unavailable Content Unstocked Content Updated Content User-agent User Interface and Software Capabilities Vending Manager Content currently undergoing or requiring testing prior to being published. The status of Testing is assigned by the Catalog Manager administrator. Testing content is available to Vending Managers for distribution only to subscribers with testing roles (assigned by the Vending Manager).
Glossary 253
254 Administration Guide • 2005Q4
Index A about this guide, xv account management catalog manager, 94 to 106 catalog manager administrator accounts, 104 to 106 developer accounts, 101 to 104 overview catalog manager, 6 vending manager, 9 subscriber accounts, 209 to 215 vending manager accounts, 97 to ?? vending manager administrator accounts, 201 to 205 accounts catalog manager administrator adding, 105 deleting, 106 description, 95 editing, 106 managing, 104 properties, 104 viewing, 104 developer adding, 101 assigning to a developer plan,
managing, 201 searching, 201 viewing, 201 administrator accounts editing own, 223 administrator tasks catalog manager, 3 customer care agent, 8 vending manager, 8 advertisements see customized marketing campaigns API filter, 5 architecture, 1 autoCreate.newDevice property, 78 B background job indicators, 125 background job status, 125 background jobs clearing failed jobs, 128 examining details, 127 getting status, 126 browser capabilities, 235 browser requirements, 10 browser.
editing a pricing option, 37 managing, 19 setting DRM, 32 setting pricing models, 34 submissions, 19 viewing, 31 copying in Catalog Manager, 62 copying in Vending Manager, 167 customer care agent viewing stocked content, 206 digital rights protection, 20 disassociating pricing option from, 30 editing submitted, 52 editions changing the status, 52 properties, 48, 140, 209 viewing, 47, 139, 209 ID, external, 144, 161, 178, 181 managing testing items, 183 MIME type deleting, 43 editing, 41 managing, 19 propert
managing, 19 setting DRM, 32 setting pricing model, 34 viewing, 31 content validation, 5 cost, 207 cost price, 46 customer care agent accounts, 201 tasks overview, 8 customer care agents adding subscriber accounts, 210 adding subscriber members, 220 adding subscriber plans, 217 deleting subscriber accounts, 215 deleting subscriber plans, 222 editing administrator account, 223 editing subscriber accounts, 212 editing subscriber plans, 218, 221 issuing a refund, 215 managing subscriber licenses, 213 managing
new, 79 properties, 89 provisioning of detected devices, 78 quarantined, 79 setting a default, 90 setting compatible devices, 88 specification tables, 237 specifying capabilities, 83 status types, 79 viewing, 78 devices capabilities specifying a value, 236 digital rights protection CDS DRM, 21 CDS DRM agents, descriptions of, 21 CDS OMA DRM 1.0 Forward Lock, 21 Combined Delivery, 23 disabling DRM, 26 enabling DRM, 26 Forward Lock, 23 inapplicable content, 21 non-compliant devices, 24 OMA DRM 1.
managing, 19 mapping to device, 86 properties, 32 registering, 40 supported types for OMA DRM 1.
pricing models defined, 26 Every Download, 27, 54 First Download, 27, 54 Free, 27, 54 Per Interval, 27, 54 Per Period, 27, 54 Per Subscription, 27, 54 Per Use, 27, 54 setting, 34 Trial, 27, 54 pricing options, 29 creating, 35 disassociating, 30 editing, 37 required, 29 profile adding, 115 deleting, 118 editing, 117 properties, 115 viewing, 114 promotional campaign, 185 properties catalog manager administrator account, 104 content descriptor template, 76 developer account, 101 developer plan, 119 device, 89
submitted content Denied, 44 viewing all, 46 viewing by state, 45 subscriber account searching, 209 subscriber accounts adding, 210 deleting, 215 editing, 212 managing, 209 setting default plan, 221 viewing, 210 viewing download history, 213 subscriber download history, 213 subscriber license changing the status, 214 subscriber licenses extending trial, 214 issuing a refund, 215 managing, 213 subscriber plan default, 209, 210, 211, 222 properties, 216 setting the default, 221 subscriber plan members adding,
properties, 97 removing from a vending plan, 112 viewing, 97 vending plan adding, 108 default, 99, 113 deleting, 113 description, 107 editing, 110 managing, 107 members adding, 111 removing, 112 viewing, 111 properties, 108 setting the default, 112 viewing, 107 Index 263
264 Administration Guide • 2005Q4
