Instruction/ maintenance manual of the product 5 Sun Microsystems
Go to page of 283
Sun Microsystems, Inc. www .sun.com Submit comments about this document at: http://docs.sun.com/app/docs/form/comments Sun J av a™ System Content Deliv er y Ser v er 5.
Copyright © 2005 Sun Microsystems, Inc., 4150 Network Cir cle, Santa Clara, California 95054, U.S.A. All rights reserved. Sun Microsystems, Inc. has intellectual pr operty rights relating to technology embodied in the product that is described in this document.
iii Contents Preface xv 1. Introduction 1 Sun Java System Content Delivery Server 1 Catalog Manager 3 Catalog Manager Processes 4 Automated Content V alidation 5 Content Management 5 Device Management.
iv Administrator Guide • 2005Q4 Accessing the Administration Consoles 1 1 ▼ Logging in to the Catalog Manager 1 1 ▼ Logging in to the V ending Manager 12 2.
Contents v ▼ Editing a Content T ype 34 ▼ Creating a Pricing Option 35 ▼ Editing a Pricing Option 37 ▼ Deleting a Content T ype 39 ▼ Disabling a Pricing Option 39 ▼ Registering a MIME T yp.
vi Administrator Guide • 2005Q4 ▼ Editing a Device Library 73 ▼ Deleting a Device Library 74 Managing Content Descriptor T emplates 74 ▼ V iewing Content Descriptor T emplates 76 ▼ Adding a .
Contents vii ▼ Editing a V ending Manager Account 99 ▼ Deleting a V ending Manager Account 100 Managing Developer Accounts 101 ▼ V iewing Developer Accounts 101 ▼ Adding a Developer Account 10.
viii Administrator Guide • 2005Q4 ▼ Adding a Developer Plan 1 19 ▼ Editing a Developer Plan 120 ▼ V iewing Developer Licensees 121 ▼ Adding a Developer Licensee to a Developer Plan 122 ▼ R.
Contents ix Checking the Status of a Stocking Job 151 ▼ Updating the Catalog for Stocked Content 152 Pricing for Content for a Locale 153 ▼ Setting Local Pricing 153 Price Update Notification 155 .
x Administrator Guide • 2005Q4 ▼ Creating a Campaign 185 ▼ Specifying a Campaign T ype 185 ▼ Specifying Campaign Options and T arget Audience 186 ▼ Specifying a Campaign Message 187 ▼ Spec.
Contents xi Managing Subscriber Accounts 209 ▼ V iewing Subscriber Accounts 210 ▼ Adding a Subscriber Account 210 ▼ Editing a Subscriber Account 212 ▼ V iewing a Subscriber ’s Download Histo.
xii Administrator Guide • 2005Q4 ▼ Deleting an MMS Message 230 ▼ Using the MMS T est Log 231 A. Device Capabilities 233 Descriptions of the Capabilities 233 System Capabilities 233 Mandatory Cap.
xiii T ables T ABLE 2-1 DRM Types 20 T ABLE 2-2 CDS DRM Agents 21 T ABLE 2-3 OMA DRM 1.0 Formats 23 T ABLE 2-4 Required MIME Types for OMA DRM 1.0 24 T ABLE 2-5 DRM Options and Associated DRM Types an.
xiv Administrator Guide • 2005Q4 T ABLE A-4 Nokia 6310i Device Specifications 238 T ABLE A-5 Device Specifications for a User-Defined Device 1 239 T ABLE A-6 Device Specifications for a User-Defined.
xv Pr eface This guide provides an overview of the Sun Java™ System Content Delivery Server. It describes how to administer the Catalog Manager and V ending Manager components. It describes the device capabilities and the content pricing models supported by the Sun Java System Content Delivery Server.
xvi Administrator Guide • 2005Q4 ■ 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.
Preface xvii 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 subdir ectory of the directory wher e the Content Delivery Server is installed as well as online at http://docs.
xviii Administrator Guide • 2005Q4 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 W elcomes Y our Comments Sun is interested in impr oving its documentation and welcomes your comments and suggestions.
1 CHAPTER 1 Intr oduction 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 , Fulf illment Manager , and V ending Manager components.
2 Administrator Guide • 2005Q4 1. The content provider cr eates an application and submits it to the Catalog Manager using the web-based Developer Portal. 2. The Catalog Manager validates the content. Content Providers Java Applications Ringtones W allpapers Games Music Videos Extensible.
Chapter 1 Introduction 3 3. The Catalog Manager administrator publishes the content, making it available to the V ending Manager . 4. The V ending Manager administrator selects content published from the Catalog Manager and stocks the content, making it available to subscribers.
4 Administrator Guide • 2005Q4 1. Developers submit content to the Catalog Manager . The Catalog Manager runs an automated validation process on the content to ensure ther e is no malicious content and that the content matches the supported devices.
Chapter 1 Introduction 5 Automated Content V alidation 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 .
6 Administrator Guide • 2005Q4 ■ Submitted Content. The administrator reviews submitted content and, if requir ed, edits the content and modifies the pricing and category assignments. The administrator can accept or reject the content. ■ Published Content.
Chapter 1 Introduction 7 ■ V ending Plans. V ending Plans define the categories that a V ending Manager can access. V ending Plans can contain a nested hierarchy of other V ending Plans. Each V ending Manager Account is associated with one or more V ending Plans.
8 Administrator Guide • 2005Q4 The V ending Manager administrator manages the following functions: ■ Stocked content ■ Subscriber access and subscriber licenses ■ Purchase pricing and trial pe.
Chapter 1 Introduction 9 V ending Manager Processes The previous f igure illustrates the V ending Manager processes. The V ending Manager is responsible for the following practices: ■ Content Management ■ Plan Management ■ Account Management ■ Reporting Content Management The Catalog Manager publishes content to the V ending Manager .
10 Administrator Guide • 2005Q4 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 V ending Manager . See “Managing V ending Manager Administrator Accounts” on page 201 for more information.
Chapter 1 Introduction 11 Accessing the Administration Consoles T o access the Catalog Manager and V ending Manager administration consoles for the first time, use the default login ID and password that wer e created when you installed the Sun Java System Content Delivery Server.
12 Administrator Guide • 2005Q4 3. Enter your administrator name and password. 4. Click Log In. ▼ Logging in to the V ending Manager 1. Start the V ending Manager . For information on starting the V ending Manager , see the Sun Java System Content Delivery Server Installation Guide .
13 CHAPTER 2 Catalog Manager This chapter describes how to administer the Catalog Manager . Following ar e some of the responsibilities of the Catalog Manager administrator: ■ Managing Content ■ A.
14 Administrator Guide • 2005Q4 The following content management tasks are described in this section: ■ Managing Content Categories ■ Managing Content T ypes ■ Managing Submitted Content ■ M.
Chapter 2 Catalog Manager 15 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 .
16 Administrator Guide • 2005Q4 T o return to the list of main categories, click Home in the category navigation bar . T o display any level of your current category hierar chy , 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 .
Chapter 2 Catalog Manager 17 3. Enter a name and short description of the category . The name must be unique within the category . Y ou 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.
18 Administrator Guide • 2005Q4 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.
Chapter 2 Catalog Manager 19 Managing Content T ypes The default content types supported by the Content Delivery Server are MIDlets, ring tones, and images. Y ou can define additional content types as needed. Each content type must be associated with one or more MIME types.
20 Administrator Guide • 2005Q4 ■ 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.
Chapter 2 Catalog Manager 21 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.
22 Administrator Guide • 2005Q4 When no DRM agent is selected, only the download-based (free always, f irst download only , and every download) pricing model is supported. No code is added. Each agent handles license validation differ ently . For further details of these types, see the Sun Java System Content Delivery Server Installation Guide .
Chapter 2 Catalog Manager 23 Using OMA DRM 1.0 OMA DRM 1.0 offers thr ee different formats for applying protection, as described in T ABLE 2-3 . For a thorough discussion of OMA DRM 1.0, go to http://www.openmobilealliance.org/ . The default setting for OMA DRM 1.
24 Administrator Guide • 2005Q4 OMA DRM 1.0 and Non-Compliant Devices For devices that are not compliant with OMA DRM 1.0, the Catalog Manager administrator can configur e the Content Delivery Serve.
Chapter 2 Catalog Manager 25 Associating Content T ypes 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 r emotely hosted copyrighted content cannot be assigned a DRM.
26 Administrator Guide • 2005Q4 Y ou can assign the DRM options to the associated content types given in T ABLE 2-5 but you are not r estricted 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 T ype” on page 32 .
Chapter 2 Catalog Manager 27 The former usage pricing model of X downloads in Y days is no longer available by default. That pricing model is now used, optionally , as a grace period. A grace period, if configur ed at deployment, can be attributed to the Every Download pricing model (see T ABLE 2-10 ).
28 Administrator Guide • 2005Q4 The Content Delivery Server supports the combinations of DRM options and pricing models as shown in T ABLE 2-7 . Y ou determine whether to enable all the available pricing models for a content type or just a subset.
Chapter 2 Catalog Manager 29 Pricing Options At the same time that you select a pricing model, you have the option of creating pricing options for it. Having predef ined pricing options gives you more control over the pricing of content and can make managing content easier .
30 Administrator Guide • 2005Q4 ■ 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.
Chapter 2 Catalog Manager 31 has the content type picture and a pricing option of $0.75 for first download only . Y ou 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.
32 Administrator Guide • 2005Q4 ■ Content T ype - The type of content that the MIME type is associated with. ■ MIME T ype - The string that identifies the MIME type. ■ File Extensions - The file extensions that ar e associated with the MIME type.
Chapter 2 Catalog Manager 33 4. Enter the following information: ■ Content T ype - 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.
34 Administrator Guide • 2005Q4 5. Select a DRM. Administrators must know which DRMs are applicable for specif ic 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.
Chapter 2 Catalog Manager 35 ■ 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.
36 Administrator Guide • 2005Q4 The fields displayed ar e relevant to the selected pricing models on the previous page. If no existing pricing options exist yet for the content type, the A vailable Pricing Options section is not displayed. 5. Enter a unique Option ID.
Chapter 2 Catalog Manager 37 7. Select free usage or non-free usage or enter the number of free trials. The fields shown ar e dependent on the pricing models you made available for this content type when creating or editing the content type. T ABLE 2-6 lists and defines the supported pricing models.
38 Administrator Guide • 2005Q4 5. Change the following f ields as needed: ■ Option ID - Unique identifier for this option. V alues can consists of numbers, characters, or a combination of both. ■ Option Name - Name of option. V alues can consists of numbers, characters, or a combination of both.
Chapter 2 Catalog Manager 39 7. Click Done. 8. Click OK to close the Conf irmation page. T o create a custom price for an individual item of content, see “Editing Content” on page 52 . T o create a custom price for multiple content items at once, see “Setting Custom Prices for Published Content” on page 66 .
40 Administrator Guide • 2005Q4 1. From the Catalog Manager administration console, click Content on the main menu bar . 2. Click the MIME T ypes tab. The MIME T ypes page is displayed. 3. Click the content type with the pricing option you want to disable.
Chapter 2 Catalog Manager 41 4. Enter the following information: ■ Content T ype - Select from the list the type of content with which the MIME type is associated. ■ MIME T ype - Enter the string that identifies the MIME type, for example, image/jpeg .
42 Administrator Guide • 2005Q4 ■ application/java-archive ■ application/x-jam When associated with other content types, the MIME types previously listed ar e treated as any other MIME type. T o edit a MIME type, follow these steps: 1. From the Catalog Manager administration console, click Content on the main menu bar .
Chapter 2 Catalog Manager 43 7. Click OK. The MIME T ype Properties page is displayed. 8. Click OK to close the conf irmation message. ▼ Deleting a MIME T ype Y ou cannot delete a MIME type if content with that MIME type is submitted or if a device refer ences it.
44 Administrator Guide • 2005Q4 Managing Submitted Content Developers submit content in packages that consist of their created content and XML files with support and description information.
Chapter 2 Catalog Manager 45 T o 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 .
46 Administrator Guide • 2005Q4 The following information is displayed for each item: ■ T itle - The name of the content. ■ Developer - The name of the developer who submitted the content. ■ Categories - The categories in which the content is defined.
Chapter 2 Catalog Manager 47 ▼ V iewing 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 .
48 Administrator Guide • 2005Q4 The following information is displayed for each edition: ■ T itle - 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.
Chapter 2 Catalog Manager 49 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 V iew Content Properties for the selected content. 4. Click on the instrumented version of the edition.
50 Administrator Guide • 2005Q4 ▼ Changing the Status of Content Y ou can change that status of submitted content to one of the types described in T ABLE 2-9 . When a content’s status is changed, a notification of the change in status is sent to the content provider .
Chapter 2 Catalog Manager 51 6. Click GO. The Confirm: Change Status page is displayed. Y ou 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 conf irm the status change.
52 Administrator Guide • 2005Q4 ▼ 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.
Chapter 2 Catalog Manager 53 3. Click Edit from the V iew Content Properties page. The Edit Content page is displayed. An asterisk (*) beside a field indicates that it is a requir ed field.
54 Administrator Guide • 2005Q4 ■ General Information - Contains content status and any additional messages displayed to the content provider . ■ Pricing - Shows the price specified by the content pr ovider . The pricing options designated by the content provider ar e displayed just above the Catalog Price section.
Chapter 2 Catalog Manager 55 ■ Create a custom price for this content item. Be aware that by cr eating a custom price, you are disassociating this item for its pricing option.
56 Administrator Guide • 2005Q4 Note – If you change a content’s status from Published to another state, the content is removed fr om the Published Content list and is not included in the list of published categories. ▼ V iewing Published Content 1.
Chapter 2 Catalog Manager 57 T o view the properties for an item, click the title of the item. The V iew Content Properties page is displayed. If icons, documentation, or scr een shots were submitted with the content, click the V iew button for the item to see what was submitted.
58 Administrator Guide • 2005Q4 3. Navigate to the item that you want to work with. Y ou can use the search feature or view the list of content for the category that contains the item. Y ou can sort the display of the content items by clicking on a highlighted column title on the Browse and Sear ch Result page.
Chapter 2 Catalog Manager 59 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. W ait until all items are loaded befor e making a selection.
60 Administrator Guide • 2005Q4 you cannot copy or move a parent category into one of its child categories. Y ou 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 .
Chapter 2 Catalog Manager 61 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 tr ees. If one category tree does not have a selection, for instance, if you clear all selections in a tree, the buttons ar e inactive.
62 Administrator Guide • 2005Q4 The preceding f igure 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.
Chapter 2 Catalog Manager 63 ▼ 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.
64 Administrator Guide • 2005Q4 Category and content item names change from gray to black as the categories and content items are loaded. W ait until all items are loaded befor e making a selection. 4. Click Individual Items. 5. Select the content items in one or more categories that you want to copy or move.
Chapter 2 Catalog Manager 65 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.
66 Administrator Guide • 2005Q4 The preceding f igure shows the results of copying the content items, N_Ringer and Splash Screen to the Personal Pr oductivity category .
Chapter 2 Catalog Manager 67 For instance, if you select the Featured and Entertainment categories, you can change the purchase price for all the content in those categories or specif ic content items in those categories.
68 Administrator Guide • 2005Q4 4. Select the category or subcategories of content or specif ic contents. T o change the purchase price of all the contents of a category , simply click the category itself. T o change the purchase price of specific content items in a category , navigate through the category to select individual content items.
Chapter 2 Catalog Manager 69 5. Change the purchase price in one of the following ways: ■ Enter a new purchase price. ■ Increase or decr ease the purchase amount by N per cent. ■ Increase or decr ease the purchase price by a dollar amount. The price is applied to all selected content regar dless of their pricing models.
70 Administrator Guide • 2005Q4 ■ System capabilities - Capabilities primarily used by the Content Delivery Server. They define capabilities that a device must have to perform Content Delivery Server functionality .
Chapter 2 Catalog Manager 71 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. ▼ V iewing Device Libraries 1.
72 Administrator Guide • 2005Q4 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.
Chapter 2 Catalog Manager 73 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 f ile.
74 Administrator Guide • 2005Q4 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. T o select individual methods, expand the package by clicking the plus sign (+) next to the check box for the package.
Chapter 2 Catalog Manager 75 5. Make the necessary changes. Y ou 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 Prof ile. 6. Click OK. A confirmation page is displayed.
76 Administrator Guide • 2005Q4 The Content Delivery Server provides descriptor templates for Content Object Descriptor (COD) and General Content Descriptor (GCD). Y ou can define other templates as needed. T ABLE 2-1 1 shows the Content Delivery Server content attributes that you can use to customize the template for your needs.
Chapter 2 Catalog Manager 77 ▼ V iewing Content Descriptor T emplates 1. From the Catalog Manager administration console, click Devices on the main menu bar . 2. Click the T emplates tab. The Content Descriptor T emplates page is displayed, showing the currently defined templates.
78 Administrator Guide • 2005Q4 ▼ Adding a Content Descriptor T emplate 1. From the Catalog Manager administration console, click Devices on the main menu bar . 2. Click the T emplates tab to display the list of templates. 3. Click New T emplate. The Content Descriptor T emplate Definition page is displayed.
Chapter 2 Catalog Manager 79 ▼ Editing a Content Descriptor T emplate 1. From the Catalog Manager administration console, click Devices on the main menu bar . 2. Click the T emplates tab. The list of templates is displayed. 3. Click the name of the template that you want to edit.
80 Administrator Guide • 2005Q4 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.
Chapter 2 Catalog Manager 81 ■ 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.
82 Administrator Guide • 2005Q4 2. Specify the following f ields: ■ 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 .
Chapter 2 Catalog Manager 83 pattern, SAMSUNG-SGH-E700.* , matches it. The expr essions, SAMSUNG-SGH- E700 and .*SAMSUNG-SGH-E700, do not match as they only partially match the user-agent coming fr om the device. ■ Supported Libraries - The libraries that the device supports.
84 Administrator Guide • 2005Q4 ▼ 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.
Chapter 2 Catalog Manager 85 If the Edit button is not available, wait a few minutes for the previous edit r equest to complete before attempting to make mor e 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.
86 Administrator Guide • 2005Q4 5. Click OK. The Device Management page is displayed that shows the list of devices. ▼ Activating New or Quarantined Devices When you are sur e a newly detected dev.
Chapter 2 Catalog Manager 87 ■ 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).
88 Administrator Guide • 2005Q4 If the Manage MIME T ypes button is not available, wait a few minutes for the previous edit r equest 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.
Chapter 2 Catalog Manager 89 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.
90 Administrator Guide • 2005Q4 4. Click OK to save your changes. 5. Click OK in the conf irmation 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.
Chapter 2 Catalog Manager 91 3. Click Modify This Device. A confirmation dialog box asks you to conf irm 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.
92 Administrator Guide • 2005Q4 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 Y ou cannot delete the default device. Y ou also cannot delete a device that a subscriber account refer ences.
Chapter 2 Catalog Manager 93 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 T o export a device, that is to create a device definition f ile (in .
94 Administrator Guide • 2005Q4 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 th.
Chapter 2 Catalog Manager 95 ▼ Changing a Locale T o 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.
96 Administrator Guide • 2005Q4 The Catalog Manager does not administer subscriber accounts; these are administered thr ough the V ending Manager . See “Managing Subscriber Accounts” on page 209 for more information.
Chapter 2 Catalog Manager 97 2. Click Developers or Administrators. The list of defined Developer or Administrator accounts is displayed. Each account type has its own page or view . T ABLE 2-13 describes the operations you can perform on any of the three views.
98 Administrator Guide • 2005Q4 Managing V ending Manager Accounts V ending Manager accounts define the V ending Managers to which the Catalog Manager publishes content. Because a single Catalog Manager can serve multiple V ending Managers, you can have many V ending Manager accounts.
Chapter 2 Catalog Manager 99 3. Enter the required information. An asterisk (*) beside a field indicates that it is a r equired field. ■ Account ID - Specify a unique designation for the account. The Account ID is automatically converted to lowercase.
100 Administrator Guide • 2005Q4 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. T o avoid data inconsistency or notification failure, ensur e that the Network ID specified is a valid addr ess.
Chapter 2 Catalog Manager 101 3. Click Edit. The Edit Account Details page displays the same fields as those described in “Adding a V ending Manager Account” on page 97 . 4. Modify the f ields as required, then click OK. A confirmation page asks whether you want to save the changes.
102 Administrator Guide • 2005Q4 4. Click OK. The account is deleted and it is removed fr om 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 .
Chapter 2 Catalog Manager 103 3. Enter the required information. An asterisk (*) beside a field indicates that it is a r equired field. ■ Login ID - Specify the Login ID, which must be unique. The Login ID is automatically converted to lowercase. ■ Password - Enter a password.
104 Administrator Guide • 2005Q4 6. Click OK again to close the conf irmation 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.
Chapter 2 Catalog Manager 105 4. Modify the f ields 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 .
106 Administrator Guide • 2005Q4 ▼ 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.
Chapter 2 Catalog Manager 107 4. Click OK to add the Administrator account. A confirmation message asks you to conf irm you want to add the account. 5. Click OK to conf irm the addition. 6. Click OK to close the conf irmation message. ▼ Editing a Catalog Manager Administrator Account 1.
108 Administrator Guide • 2005Q4 Managing Plans V ending Manager and Developer accounts are assigned to plans. The Catalog Manager uses plans to control content submission for developers and content access for V ending Managers. T ABLE 2-14 describes the two types of plans used by the Catalog Manager .
Chapter 2 Catalog Manager 109 2. Click a V ending plan name to view the properties of the plan. The V ending Plan Properties page displays the properties of the plan. From this page you can edit, delete, add, or remove members fr om the V ending plan.
110 Administrator Guide • 2005Q4 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 V ending Managers that are assigned to this plan.
Chapter 2 Catalog Manager 111 T o edit a V ending plan, follow these steps: 1. From the Catalog Manager , click Plans in the main menu bar . The V ending Plans page is displayed by default. 2. Click the plan that you want to modify . The V ending Plans Management page is displayed.
112 Administrator Guide • 2005Q4 4. Modify the f ields as required, then click OK. The Properties page appears displaying the changed information. 5. Click OK. The V ending Plan is updated in the database. ▼ V iewing V ending Plan Members Members are the V ending Manager accounts assigned to a vending plan.
Chapter 2 Catalog Manager 113 2. Click the plan you want to view . The V ending Plan Management page is displayed. 3. Click the Members tab. The list of V ending Manager accounts associated with the V ending plan is displayed. 4. Click Add. A list of V ending Manager accounts is displayed.
114 Administrator Guide • 2005Q4 3. Select the plan that you want to set as the default. 4. Click OK. The default plan is assigned to all new V ending Manager accounts until a new V ending plan is assigned. ▼ Deleting a V ending Plan 1. From the Catalog Manager , click Plans in the main menu bar .
Chapter 2 Catalog Manager 115 Managing Developer Plans Developer plans define the set of APIs that developers can use in applications that they submit. Prof iles define the classes in a specific library that developers can use. A Developer plan contains one or more pr ofiles.
116 Administrator Guide • 2005Q4 4. Click a prof ile name. The Prof ile Definition page is displayed. ▼ Adding a Prof ile 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.
Chapter 2 Catalog Manager 117 4. Provide the information requested. ■ Name - Enter a name for the prof ile. ■ Description - Enter a description of the prof ile. ■ Select Library - Select the library that you want to include. 5. Click Next. The second page for defining a pr ofile is displayed.
118 Administrator Guide • 2005Q4 6. Select the items from the library that you want this prof ile to support. T o select individual methods, expand the package by clicking the plus sign (+) next to the check box for the package. 7. Click Finish. The new prof ile is added to the database.
Chapter 2 Catalog Manager 119 5. Click Edit. The edit page displays the same fields as those described in “Adding a Pr ofile” on page 11 5 . 6. Modify the prof ile as required and click OK. 7. Click OK to close the Conf irmation page. The Properties page for the pr ofile is displayed.
120 Administrator Guide • 2005Q4 6. Click OK. The prof ile is deleted from the database and from any developer plans in which it was included. 7. Click OK to close the conf irmation message. ▼ V iewing Developer Plans 1. From the Catalog Manager administration console, click Plans in the main menu bar .
Chapter 2 Catalog Manager 121 4. Specify a name and description for the Developer plan and select the prof iles 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 conf irmation message.
122 Administrator Guide • 2005Q4 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 f ields as those described in “Adding a Developer Plan” on page 11 9 .
Chapter 2 Catalog Manager 123 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.
124 Administrator Guide • 2005Q4 8. Click Add. The Developer accounts are added as licensees of the Developer plan. 9. Click OK to conf irm the addition. ▼ Removing a Developer Licensee from a Developer Plan 1. From the Catalog Manager administration console, click Plans in the main menu bar .
Chapter 2 Catalog Manager 125 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.
126 Administrator Guide • 2005Q4 6. Click OK to close the conf irmation message. The Developer plan is deleted from the database, and the plan is deleted fr om 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.
Chapter 2 Catalog Manager 127 ▼ 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.
128 Administrator Guide • 2005Q4 T o clear the listing of successfully completed jobs, click Clean completed. Only pending jobs and failed jobs remain in the list.
Chapter 2 Catalog Manager 129 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 ar e manually cleared. Y ou can do this in the following ways: ■ Click Delete this job to remove the job fr om the list.
129 CHAPTER 3 V ending Manager This chapter describes the tasks for administering the V ending Manager . Ther e are two administration roles: Administrator and Customer Care agent.
130 Administrator Guide • 2005Q4 ■ Resetting trials ■ Issuing refunds ■ Managing Subscriber Plans Creating and managing Subscriber plans ■ V iewing Reports V iewing statistical data Customer Care Agents can also edit their own accounts. They cannot edit other Administrator accounts.
Chapter 3 V ending Manager 131 2. From the Stocked Content tab, click Manage Categories. The Catalog Management page is displayed showing the V ending 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 .
132 Administrator Guide • 2005Q4 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.
Chapter 3 V ending Manager 133 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.
134 Administrator Guide • 2005Q4 3. Click the delete category button for the category that you want to delete. The category and all its subcategories are deleted and are r emoved from all plans and content with which they are associated. T o delete a subcategory , click the category name to display its list of subcategories.
Chapter 3 V ending Manager 135 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.
136 Administrator Guide • 2005Q4 The following information is displayed for each item. Click the Status, the T itle, or the T ype 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.
Chapter 3 V ending Manager 137 ■ T itle - Displays the title of the content in the catalog. ■ Catalog Price - Displays the amount that the V ending Manager has to pay the Catalog Manager for every sale they make to a subscriber .
138 Administrator Guide • 2005Q4 ■ 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.
Chapter 3 V ending Manager 139 ■ Catalog Description - A description of the content. If icons, documentation, or screen shots wer e submitted with the content, click the V iew 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 .
140 Administrator Guide • 2005Q4 The following information is shown for each edition: ■ Edition ID ■ Name ■ V ersion ■ Edition T ype ■ Original Edition ■ Modified Date The Edition T ype, Original, indicates the initally submitted content, while Final indicates the actual content that is delivered to subscribers.
Chapter 3 V ending Manager 141 6. When you are done viewing the Edition Properties, click OK. If no devices are listed in both the Supported Devices and Matched Devices f ields, the Catalog Manager administrator made the edition unavailable to subscribers.
142 Administrator Guide • 2005Q4 T o enable auto-stocking, follow these steps: 1. From the V ending 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.
Chapter 3 V ending Manager 143 T o stock content, follow these steps: 1. From the V ending 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.
144 Administrator Guide • 2005Q4 ■ Keyword - Y ou can create a unique keyword to identify this content item. This keyword is used by subscribers when or dering content. Keywords are used when content is requested thr ough mobile originated (MO) push.
Chapter 3 V ending Manager 145 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 V ending Manager administration console, click Catalog on the main menu bar .
146 Administrator Guide • 2005Q4 An asterisk (*) beside a field indicates that it is a requir ed field. Only unstocked content items are selectable. Category and content item names change from gray to black as the categories and content items ar e loaded.
Chapter 3 V ending Manager 147 4. Select one or more destination categories under the V ending Categories column. Under the V ending Manager categories column on the right, you can select one or more terminal categories in which you want the content to be stocked.
148 Administrator Guide • 2005Q4 6. Click Stock. Click Clear to remove all selections in both tr ees and reselect categories and content items. Clicking the Cancel button clears all selections and displays the top-level Catalog page. 7. Conf irm or cancel the operation.
Chapter 3 V ending Manager 149 T o stop a stocking job from this page, see the next section. V iewing Stocking Jobs At the bottom of the Stock Content page, you can see a list of executing, pending, a.
150 Administrator Guide • 2005Q4 ▼ Stopping a Stocking Job Y ou can stop a stocking job with an Executing or Pending status fr om the Stocking Jobs Status page or the Stocking Jobs section of the Stock Content page. 1. From the Stocking Job Status page, click Stop.
Chapter 3 V ending Manager 151 Checking the Status of a Stocking Job Y ou 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.
152 Administrator Guide • 2005Q4 ■ 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.
Chapter 3 V ending Manager 153 6. Click OK. The V iew Content Properties page is displayed showing the updated information. Pricing for Content for a Locale V ending Managers can be widely distributed geographically . In such cases, multiple currencies ar e involved in pricing content.
154 Administrator Guide • 2005Q4 The page displays the following information: ■ 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.
Chapter 3 V ending Manager 155 3. Enter the value for your local currency equal to the one currency unit. If the one currency unit is one Eur o and your local currency is Y en, enter the current equivalent value in Y en. 4. Enter the percentage markup by which you want to increase the purchase price, if desired.
156 Administrator Guide • 2005Q4 1. From the V ending Manager administration console, click Content on the main menu bar . 2. Click the Stocked Content tab. 3. Click V iew by T itle to list all content. 4. Click the content name to go to the content’ s property page.
Chapter 3 V ending Manager 157 3. Enter the search term in the Search f ield. 4. Select the category that you want to search from the Category drop-down list.
158 Administrator Guide • 2005Q4 1. From the V ending 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. Y ou can use the search feature or view the list of content for the category that contains the item.
Chapter 3 V ending Manager 159 ▼ Editing Stocked Content 1. From the V ending 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.
160 Administrator Guide • 2005Q4 Y ou can edit the following fields: ■ Status - Content can be active (available to subscribers) or inactive (unavailable to subscribers). ■ V ending Price - Purchase price for the content item char ged to the subscriber .
Chapter 3 V ending Manager 161 ■ Enter the External Group ID that your billing system uses to identify this content or select it from the list pr ovided. This field can be blank if your system does not use group IDs. ■ Categories - The categories to which the content is assigned.
162 Administrator Guide • 2005Q4 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 f ields for an item to change individual items.
Chapter 3 V ending Manager 163 ▼ Copying or Moving Categories of Content Y ou can move or copy whole categories of content at a single time in the V ending Manager . By copying or moving one or more categories, you ar e copying or moving all the content items within those categories.
164 Administrator Guide • 2005Q4 Category and content item names change from gray to black as the categories and content items are loaded. W ait until all items are loaded before making a selection. 4. Select the categories you want to copy or move.
Chapter 3 V ending Manager 165 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.
166 Administrator Guide • 2005Q4 7. Conf irm 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 fr om the original location and placed in the destination category .
Chapter 3 V ending Manager 167 ■ If the category is empty , that is, it contains no content items or subcategories, you can delete the category from its new location.
168 Administrator Guide • 2005Q4 Category and content item names change from gray to black as the categories and content items are loaded. W ait 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.
Chapter 3 V ending Manager 169 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.
170 Administrator Guide • 2005Q4 The preceding f igure shows the results of copying the content items, SpruceClock and T echnopop to the Mobile Mail and Instant Messages categories.
Chapter 3 V ending Manager 171 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.
172 Administrator Guide • 2005Q4 4. Select the category or subcategories of content or specif ic contents. T o change the purchase price of all the contents of a category , simply click the category itself. T o change the purchase price of specific content items in a category , navigate through the category to select individual content items.
Chapter 3 V ending Manager 173 6. Change the purchase price in one of the following ways: ■ Enter a new purchase price. ■ Increase or decr ease the purchase amount by N per cent. ■ Increase or decr ease the purchase price by a dollar amount. The price is applied to all selected content regardless of their pricing models.
174 Administrator Guide • 2005Q4 ■ If the V ending Manager ’s Auto-stocking option is turned on, the content is immediately reactivated. The bundle’s pr operty page shows a status of Active for the content and the content is available to subscribers again.
Chapter 3 V ending Manager 175 ■ 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 offer ed for a specific time.
176 Administrator Guide • 2005Q4 3. Click Create Bundle. The Create Bundle page is displayed..
Chapter 3 V ending Manager 177 An asterisk (*) beside a field indicates that it is a requir ed 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.
178 Administrator Guide • 2005Q4 ■ Bundle Price ■ Provide the bundle at no char ge 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 .
Chapter 3 V ending Manager 179 ▼ V iewing Bundle Information 1. Click Content in the V ending Manager administration console’ s main menu. 2. Click Bundled Content in the Content Management page. 3. Click V iew by T itle. The Browse V ending Content By T itle page is displayed.
180 Administrator Guide • 2005Q4 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 fr om the bundle and is not available to subscribers who purchase the bundle after the status change.
Chapter 3 V ending Manager 181 ▼ Deleting a Bundle 1. Click Content in the V ending Manager administration console’ s main menu. 2. Click Bundled Content in the Content Management page. 3. Click V iew By T itle. 4. Select the check box for the desired bundle in the list.
182 Administrator Guide • 2005Q4 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. T o 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.
Chapter 3 V ending Manager 183 ▼ Editing a Bundle Y ou can modify a bundle by changing its status, contents, retail price, and so on. T o edit a bundle, follow these steps: 1. Click Content in the V ending Manager administration console’ s main menu.
184 Administrator Guide • 2005Q4 ▼ Stocking T esting Content If the auto-stocking option is set to OFF , you can manually stock content items with T esting status to make them available to subscribers with testing roles. 1. Click Content on the V ending Manager administration console’ s main menu.
Chapter 3 V ending Manager 185 ▼ Creating a Campaign The Content Download Server provides a wizard to help you def ine a marketing campaign. The wizard leads you thr ough the steps of specifying the campaign type, the target audience, the marketing message, content and pricing details, and scheduling and duration.
186 Administrator Guide • 2005Q4 ▼ Specifying Campaign Options and T arget Audience The Campaign Options page lets you define the name and description of the campaign, and the market segment that receives it. Y ou can also assign a coupon to the campaign.
Chapter 3 V ending Manager 187 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 curr ently defined. See “Creating a Subscriber Segment” on page 195 for more information.
188 Administrator Guide • 2005Q4 1. Enter the subject of the advertisement. This string is also used as the subject line for advertisements sent as email.
Chapter 3 V ending Manager 189 T o 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.
190 Administrator Guide • 2005Q4 T o 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.
Chapter 3 V ending Manager 191 T o 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.
192 Administrator Guide • 2005Q4 This page enables you to review the information for your advertisement. ■ T o view the items that are included in the campaign, click V iew List in the Promotional Content section. ■ T o view the subscribers to whom the advertisement is sent, click V iew List in the Subscriber Segment section.
Chapter 3 V ending Manager 193 ■ T o see the format of the message that is sent to the subscribers, click Pr eview in the Promotional Message section. The format is determined by the notification template set up by your system administrator . See “W orking with Campaign T emplates” on page 197 for more information.
194 Administrator Guide • 2005Q4 W orking 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.
Chapter 3 V ending Manager 195 ▼ Displaying Subscriber Segments 1. Click Campaigns in the V ending 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.
196 Administrator Guide • 2005Q4 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.
Chapter 3 V ending Manager 197 ■ 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.
198 Administrator Guide • 2005Q4 Y ou 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.
Chapter 3 V ending Manager 199 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 fr om the campaign.
200 Administrator Guide • 2005Q4 T o see examples of campaign notification templates, follow these steps: 1. Open the Campaign T emplates page. 2. Click the name or description of the default notif ication template. An example of a template is provided for each type of style sheet.
Chapter 3 V ending Manager 201 ▼ Editing a Campaign T emplate 1. Open the Campaign T emplates page. See “Displaying A vailable Campaign T emplates” on page 197 for more information. 2. Click the name or description of the template you want to edit.
202 Administrator Guide • 2005Q4 3. T o view an individual Administrator Account, click the administrator name. If you are a Customer Car e 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.
Chapter 3 V ending Manager 203 Complete the following fields: ■ Login ID - Enter the Login ID the administrator uses to access the V ending Manager . It must be unique and at least three characters. ■ Password - Enter a password of at least four characters.
204 Administrator Guide • 2005Q4 ▼ Editing a V ending Manager Administrator Account T o edit all Administrator Accounts, you must be an administrator . Customer Car e Agents can edit only their own account. T o edit an Administrator Account, follow these steps: 1.
Chapter 3 V ending Manager 205 5. Modify the information as required. 6. Click OK. The Edit Administrator confirmation page is displayed. 7. Click OK again to close the conf irmation message. The Administrator Account is updated in the database. ▼ Deleting a V ending Manager Administrator Account 1.
206 Administrator Guide • 2005Q4 ▼ V iewing Stocked Content 1. From the V ending 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.
Chapter 3 V ending Manager 207 Note – The Edit External ID button appears only if your billing system requir es 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.
208 Administrator Guide • 2005Q4 T o set the display of stocked content, follow these steps: 1. From the V ending Manager administration console, click Content on the main menu bar . 2. Click the Stocked Content tab if it is not the active tab. The V ending Pr eferences page is displayed.
Chapter 3 V ending Manager 209 ▼ V iewing Editions of Stocked Content 1. From the V ending 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.
210 Administrator Guide • 2005Q4 ▼ V iewing Subscriber Accounts 1. From the V ending 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 f ield is blank.
Chapter 3 V ending Manager 211 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 requir ed field. ■ Login ID - Enter the unique subscriber ID that the subscriber uses to log in to the subscriber site.
212 Administrator Guide • 2005Q4 ■ Subscriber ’ s role - Select T est 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 .
Chapter 3 V ending Manager 213 5. Modify the information as required, then click OK. The Edit Subscriber confirmation page is displayed. 6. Click OK again to close the Conf irmation page.
214 Administrator Guide • 2005Q4 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.
Chapter 3 V ending Manager 215 ▼ Issuing a Refund 1. From the V ending 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.
216 Administrator Guide • 2005Q4 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 V ending Manager .
Chapter 3 V ending Manager 217 ■ Parent plan information. Par ent 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 V ending Manager Category .
218 Administrator Guide • 2005Q4 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.
Chapter 3 V ending Manager 219 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.
220 Administrator Guide • 2005Q4 1. From the V ending 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.
Chapter 3 V ending Manager 221 ▼ Removing Members from a Subscriber Plan 1. From the V ending Manager administration console, click Plans on the main menu bar . The Subscriber Plan Management page displays all def ined Subscriber plans. 2. Click the Subscriber Plan name to view the properties of a Subscriber plan.
222 Administrator Guide • 2005Q4 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 r eview the Subscriber accounts that are assigned to the plan.
Chapter 3 V ending Manager 223 ▼ Editing Y our Administrator Account This function is available only to Customer Care Agents. V ending Manager administrators edit their account the same way that they edit the account of another V ending Manager administrator .
224 Administrator Guide • 2005Q4 2. Select a content type from the Select Content T ype drop-down list to display reports for other content types. Reports display the following information: ■ Application Download Reporting - The number of downloads and applications: ■ T otal Downloads - The total number of downloads for the application type.
Chapter 3 V ending Manager 225 Sending MMS Messages The V ending Manager ’s MMS feature lets you send messages containing video, image, and audio files.
226 Administrator Guide • 2005Q4 ▼ Cr eating an MMS Message 1. Click MMS in the main menu of the V ending 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.
Chapter 3 V ending Manager 227 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.
228 Administrator Guide • 2005Q4 1 1. Click Save to save the MMS message to the server . Alternatively , you can click Save and T est to save the message and to perform a test send. See “T esting a New MMS Message” on page 229 for more Information.
Chapter 3 V ending Manager 229 4. Click Save to save the MMS message to the server or Save and T est to save the message and to perform a test send. See “T esting an MMS Message” on page 229 for more information. 5. Click OK to close the Conf irmation page.
230 Administrator Guide • 2005Q4 T est status is either Passed, Failed, or Not T ested. Enter any comments regarding the test in the Comments field. 6. Click Save. See “Using the MMS T est Log” on page 231 for more information. ▼ T esting an Existing MMS Message T o perform a test send of an existing MMS message, follow these steps: 1.
Chapter 3 V ending Manager 231 ■ Select the check box next to the messages you want to delete ■ Choose All from the dr op-down list 3. Click Delete. 4. Click OK to close the conf irmation dialog box. ▼ Using the MMS T est Log The MMS T est Log enables you to record the r esults of sending a test MMS message for a particular device.
232 Administrator Guide • 2005Q4.
233 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.
234 Administration Guide • 2005Q4 Mandatory Capabilities Mandatory capabilities are capabilities that must be specified for a device to accept MIDlet applications. T ABLE A-1 lists the mandatory capabilities for devices used with the Content Delivery Server.
Appendix A Device Capabilities 235 Br owser Capabilities Browser capability r efers to the browser type specified for a device. A string value specifying the browser that is r endering markup on the device is given.
236 Administration Guide • 2005Q4 Specifying a Capability V alue Depending on the capability , you can specify the value as a List, Integer , or Boolean. Confirm Capable Boolean Software platform-specif ic: Confirm Capable Defines whether or not the device sends a confirmation (MIDlet-Install-Notify) after a MIDlet is installed.
Appendix A Device Capabilities 237 List A list value can contain one or more values. T o select multiple values from the list provided, hold the Contr ol 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.
238 Administration Guide • 2005Q4 Nokia 6310i T ABLE A-4 shows the specifications for the Nokia 6310i device. T ABLE A-4 Nokia 6310i Device Specifications Capability V alue Browser T ype WML-1_2 Bits Per Pixel 16 Ccpp Accept Language en_US Ccpp Accept String application/java-archive image/gif image/vnd.
Appendix A Device Capabilities 239 User -Def ined Devices The following blank tables are pr ovided for you so you can enter information for the devices that you add to the Content Delivery Server.
240 Administration Guide • 2005Q4 Color Capable Confirm Capable Delivery T ype Image Capable Input CharSet Maximum Application Size MicroEdition-Pr ofile Number of softkeys Output CharSet Push T ype.
241 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.
242 Administration Guide • 2005Q4 CDS DRM Agents Disconnected T ime Sensitive midlet Free always First download only Every download Per period Per subscription Disconnected Use Sensitive midlet Free.
Appendix B Content Pr icing 243 Pricing Scenarios The pricing scenarios given here show the ef fect on content in both the Catalog Manager and the V ending Manager when changes are made to the pur chase price of content. All scenarios are based on the following existing conditions: ■ Pricing option 1A is defined in the Catalog Manager as $1.
244 Administration Guide • 2005Q4 Initial purchase price for Item 1 and Item 2 are shown as they exist in the Catalog Manager and the V ending Manager . The curr ency type is the same for both the Catalog Manager and V ending Manager ($). The General Pricing Rule is $1.
Appendix B Content Pr icing 245 Scenario 3: T wo changes to Item1 occur: ■ The V ending Manager administrator edits the property of Item 1 by changing the purchase price fr om $1.00 to $0.75. Item 1 is now disassociated from pricing option 1A in the V ending Manager .
246 Administration Guide • 2005Q4 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. T ABLE B-8 Resulting Pricing for Items 1 and 2 in Scenario 6 Catalog Manager V ending Manager Item1 $2.
247 Glossary This glossary defines the terms and acr onyms 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 , V ending Manager Accounts , Subscriber Accounts , and Administrator Accounts .
248 Administration Guide • 2005Q4 Campaign Coupon A sequence of characters and numbers used to identify a campaign. W ith a coupon, a subscriber can purchase content that has been pr omoted or discounted for a specific campaign. Capabilities Criteria that the Catalog Manager uses to define the devices that can download specific content.
Glossary 249 Content Descriptor T emplate A description of content other than MIDlets (such as Ring T ones , Pictures , and Symbian applications) similar to the way a JAD File describes a MIDlet . Content Provider The individual or corporation who submits content to the Catalog Manager .
250 Administration Guide • 2005Q4 Locale A geographic or political region or community that shar es the same language, customs, or cultural convention. In software, a locale is a collection of f iles, data, and code, which contains the information necessary to adapt software to a specific geographical location.
Glossary 251 Prof ile A Prof ile defines a set of APIs that a developer can use in applications submitted to the Content Delivery Server . See also Developer Plans . Purchase Price A monetary value assigned to an item of content. The currency type as seen by subscribers is determined by individual V ending Managers.
252 Administration Guide • 2005Q4 T esting Content Content currently under going or requiring testing prior to being published. The status of T esting is assigned by the Catalog Manager administrator . T esting content is available to V ending Managers for distribution only to subscribers with testing roles (assigned by the V ending Manager).
Glossary 253.
254 Administration Guide • 2005Q4.
255 Index A about this guide, xv account management catalog manager, 94 to 106 catalog manager administrator accounts, 104 to 106 developer accounts, 101 to 10 4 overview catalog manager, 6 vending ma.
256 Administration Guide • 2005Q4 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 architectur e, 1 autoCreate.
Index 257 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 V ending Manager, 16 7 customer car.
258 Administration Guide • 2005Q4 managing, 19 setting DRM, 3 2 setting pricing model, 3 4 viewing, 31 content validation, 5 cost, 207 cost price, 46 customer care agent accounts, 201 tasks overview.
Index 259 new, 79 properties, 89 provisioning of detected devices, 78 quarantined, 79 setting a default, 90 setting compatible devices, 8 8 specification tables, 23 7 specifying capabilities, 83 stat.
260 Administration Guide • 2005Q4 managing, 19 mapping to device, 86 properties, 32 registering, 40 supported types for OMA DRM 1.0, 24 viewing, 31 multimedia message service choosing, 225 creating .
Index 261 pricing models defined, 26 Every Download, 27 , 54 First Download, 27 , 54 Free, 27, 5 4 Per Interval, 2 7, 54 Per Period, 2 7, 54 Per Subscription, 27 , 54 Per Use, 27 , 54 setting, 34 T r.
262 Administration Guide • 2005Q4 submitted content Denied ,4 4 viewing all, 46 viewing by state, 4 5 subscriber account searching, 209 subscriber accounts adding, 210 deleting, 215 editing, 212 man.
Index 263 properties, 97 removing fr om a vending plan, 1 1 2 viewing, 97 vending plan adding, 108 default, 9 9, 1 1 3 deleting, 1 13 description, 107 editing, 1 10 managing, 107 members adding, 1 1 1.
264 Administration Guide • 2005Q4.
An important point after buying a device Sun Microsystems 5 (or even before the purchase) is to read its user manual. We should do this for several simple reasons:
If you have not bought Sun Microsystems 5 yet, this is a good time to familiarize yourself with the basic data on the product. First of all view first pages of the manual, you can find above. You should find there the most important technical data Sun Microsystems 5 - thus you can check whether the hardware meets your expectations. When delving into next pages of the user manual, Sun Microsystems 5 you will learn all the available features of the product, as well as information on its operation. The information that you get Sun Microsystems 5 will certainly help you make a decision on the purchase.
If you already are a holder of Sun Microsystems 5, but have not read the manual yet, you should do it for the reasons described above. You will learn then if you properly used the available features, and whether you have not made any mistakes, which can shorten the lifetime Sun Microsystems 5.
However, one of the most important roles played by the user manual is to help in solving problems with Sun Microsystems 5. Almost always you will find there Troubleshooting, which are the most frequently occurring failures and malfunctions of the device Sun Microsystems 5 along with tips on how to solve them. Even if you fail to solve the problem, the manual will show you a further procedure – contact to the customer service center or the nearest service center
