Sun Microsystems 5 manuale d’uso

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.0 Administration Guide 2005Q4 P ar t No .: 819-3209-10 2005Q4[...]

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. In particular , and without limitation, these intellectual property rights may include [...]

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 6 Account Management 6 Plan Management 6 Fulfillment Manager 7 Vending Manager 7 V ending Manager Pr ocesses 9 Content Management 9 Plan Management 9[...]

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. Catalog Manager 13 Managing Content 13 Managing Content Categories 14 ▼ V iewing Categories 14 ▼ Adding a Category 16 ▼ Editing a Category 17 ▼ Deleting a Category 18 Managing Con[...]

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 ype 40 ▼ Editing a MIME T ype 41 ▼ Deleting a MIME T ype 43 Managing Submitted Content 44 ▼ V iewing Submitted Content 44 ▼ V iewing Submitted E[...]

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 Content Descriptor T emplate 77 ▼ Editing a Content Descriptor T emplate 78 Managing Device Definitions 78 V iewing Devices 78 ▼ Adding a Device 8[...]

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 101 ▼ Editing a Developer Account 103 ▼ Deleting a Developer Account 104 Managing Catalog Manager Administrator Accounts 104 ▼ V iewing Catalog Ma[...]

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 ▼ Removing a Developer Licensee from a Developer Plan 123 ▼ Setting the Default Developer Plan 123 ▼ Deleting a Developer Plan 124 Getting Background[...]

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 ▼ Changing the Price of Individual Content Items 156 Managing Stocked Content 156 V iewing Stocked Content 156 ▼ Searching for Stocked Content 156[...]

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 ▼ Specifying Content for the Campaign 188 ▼ Specifying Campaign Pricing Characteristics 189 ▼ Specifying Campaign Scheduling 190 ▼ V iewing Campaign D[...]

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 History 213 ▼ Managing Subscriber Licenses 213 ▼ Extending T rial Usage 214 ▼ Issuing a Refund 215 ▼ Deleting a Subscriber Account 215 Managing Sub[...]

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 Capabilities 234 Content Delivery Server-Specif ic Capabilities 234 Browser Capabilities 235 User Interface and Software Capabilities 235 Specifying a Ca[...]

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 and Content Types 25 T ABLE 2-6 Content Delivery Server Pricing Models 27 T ABLE 2-7 DRM Options and Pricing Models 28 T ABLE 2-8 Content Status Types 4[...]

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 Device 2 239 T ABLE B-1 Associated DRMs, Content Types, and Pricing Models 241 T ABLE B-2 Initial Pricing Set for Items 1 and 2 244 T ABLE B-3 Result[...]

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. Befor e Y ou Read This Document This guide is[...]

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. It also describes how to manage access for developers and V ending Managers. ■ Chapter 3 des[...]

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.sun.com . Th[...]

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. T o share your comme[...]

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. It describes the automatic content validation process that takes place when content is submitted t[...]

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... Catalog Manager Java System Content Delivery Server Subs[...]

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. Catalog Manager The Catalog Manager is the content aggregator or war e[...]

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. 2. The content goes to the Submitted Content section of the Catalog Manager for review by the admi[...]

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 . Y o[...]

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. After accepting the content, the administrator publishes the content to make it availab[...]

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. ■ Developer Plans. Developer Plans define the set of APIs that developers can use [...]

8 Administrator Guide • 2005Q4 The V ending 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 V ending Manager administrator , the Content Delivery Server can have V endi[...]

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 . The V[...]

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. Reporting The V[...]

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. The default values for the Login ID and Password ar e admin and admin[...]

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 . 2. From a browser window , enter http:// localhost /vsadmin/m[...]

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 ■ Accepting or rejecting content submitted by developers ■ Creating and managing categories ■ Creating and managing MIME types ■ Publishing content[...]

14 Administrator Guide • 2005Q4 The following content management tasks are described in this section: ■ Managing Content Categories ■ Managing Content T ypes ■ Managing Submitted Content ■ Managing Published Content When an operation is performed (editing, deleting, adding, and so on), the Content Deliver Server puts a background job noti[...]

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 . ▼ Adding a Catego[...]

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. Note – Y ou can set the maximum number of category leve[...]

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. Y ou can only delete categories that do not contain content. Y ou must eith[...]

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. MIME types specify the format of the content and enable information to be e[...]

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. The cont[...]

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. The No DRM option is associated by default for all SMS conten[...]

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.0 in the Content Delivery Server is Disabled. Y ou can enable this DRM after deploymen[...]

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 Server with one of the following options to deliver content with a free always, f irst download only , or every download pricing model: ■ Deliver all con[...]

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. Other than these restrictions, the choice of no DRM, CDS OMA DRM 1.0 Forward Lock,[...]

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 . Y ou can change the DRM option for[...]

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 ). Upon purchase, a grace period allows additiona[...]

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. For instance, if you associate a CDS DRM Agent with MIDlets, you can elect to enable all the availab[...]

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 . Y ou can set up predef ined pricing options for content providers to choos[...]

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. For a copyrighted content item, the pricing options you can choose f[...]

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. If the purchase price for pic[...]

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. ▼ V iewing Pr operties for a Supported MIME T ype 1. Click the string in the MIME T ype colum[...]

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. If you disable the Preview featur e, the Pr[...]

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. For instance, if you erroneously assign CDS DRM Agent to the image content[...]

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. Clicking the option restricts content pr oviders to selecting the[...]

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. The Option ID identifies this specif ic pricing option for this content type. 6[...]

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. 8. Select the Charge option you want to apply to [...]

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. ■ Purchase Price - Monetary value. 6. Click [...]

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 . ▼ Deleting a Content T ype Del[...]

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. The Content T ype Preferences page is displayed. 4. In the A vailable Pricing Options secti[...]

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 . ■ Description - Enter a brief description of the MIME type. ■ File Extensions - Enter the[...]

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 . 2. Click the MIME T yp[...]

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. Y ou cannot delete the following MIME types under the conditions listed: ■ When a[...]

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. Developers submit content thr ough the Developer portal. When content is submitted to the Catalog Manager , the Catalog Manager runs an automated validation [...]

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 . For example, click New to view all new content[...]

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. ■ Catalog Price - The price specified by the Catalog Manager administrator . By default,[...]

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 . The Content Database Management pa[...]

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. ■ V ersion - The version of the edition. ■ T ype - The type of content[...]

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. 5. Click Select on the Supported Devices f ield of the [...]

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 . For more information on notifications sent to the pr ovider , see the Sun J[...]

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. The status of the content is updated. If there ar e content items remaining in the selection li[...]

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. The Editions Database Management page is displayed. 3. Click the title of the status that c[...]

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. This page allows you to edit the following fields:[...]

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. Y ou can change the purchas[...]

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. 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 [...]

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. From the Catalog Manager administration console, click Content on the main menu bar . 2. Cli[...]

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. If the item is a ring tone and a preview was submitted, you can click[...]

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. 4. Click the title of the item. The[...]

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. 4. Select the categories you want to co[...]

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 . A dot (.) indicates that at least one category has been s[...]

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. 7. Conf irm or cancel the operation. If copied[...]

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. If you copy or move a category to another category and decide you no longer want that cat[...]

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. Note – When scheduling a copy or move operation, be aware that if lar ge numbers of categories and content are being copied or moved, the operation[...]

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. Under the source column on the left, [...]

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. Y ou must click the check box to select an item in the tree. 7. Click Copy or Move. The [...]

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 . 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 e[...]

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. Y ou set a specific purchase price, apply a per centage increase or decr ease, or increase or decrease the price by a set amount[...]

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. For example, if Spruce[...]

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 . For instance, system capabilities define whether a device supports Short Message Service (SMS) or W ireless Application Pr otocol [...]

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. From the Catalog Manager administration console, click Devices on the main menu bar . 2.[...]

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. The list of libraries is displayed. 3. Click New Library . The Library Definition page [...]

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. The library file can be either a JAR file or a ZIP f ile. 5. Clic[...]

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. 7. Click OK to save the new library . A confirmation page is displayed. 8.[...]

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. 7. Click OK to display the library properties. ▼ Deleting a Device Library Y ou cannot delete[...]

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. The following co[...]

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. The following information is displayed for each template: ■ T em[...]

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. 4. Enter the following information: [...]

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. The template properties ar e displayed. 4. Click Edit. 5. Make the [...]

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. ■ User-agent - The unique identif ier for the device. The user-agent is a r egular expr[...]

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. Change the status of a device from Quarantined to Active by clicking the A[...]

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 . ■ User-agent - The unique identif ier for the device. The user-agent is a r egular expres[...]

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. Libraries define the API sets supported by the device. T o select multi[...]

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. An asterisk (*) beside a field indicates that it is a r equired field.[...]

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. If there is a lot of content to check, th[...]

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 device is capable of supporting content, you can make that device available to developers and subscribers by changing its status from New or Quarantined [...]

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). Y ou can se[...]

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. If a lot of con[...]

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. Content that specifies either MIME type is passed to the device with app[...]

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. When content is created that specif ies the new version, the conte[...]

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. ▼ Setting the Default Devi[...]

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. T o delete a device, follow these ste[...]

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 .xml format) for an existing device: 1. From the Catalog Manager administration con[...]

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 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 Eng[...]

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. For instance, to change the English to Australian English, replace the Country Code with AU and replace the Description with Australian or Australian[...]

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. T ABLE 2-12 describes the purpose each account type serves: The following account management tasks are described in this sectio[...]

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. T ABLE 2-13 Search and Display Operations Operation Implementation Search for an accoun[...]

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. Each V ending Manager account must be assigned to one or more [...]

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. The ID can contain a combination of characters and numbers. Note – The Account ID you assign m[...]

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. If the Con[...]

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. 5. Click OK to close the Conf irmation page. ▼ Deleting a V [...]

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 . Each developer is associated with one or mor e Developer plans. Before you begin[...]

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. ■ Conf irm Password - Reenter the password. ■ Status - Leave the[...]

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. 2. Click the Developer account you want to modify . The Developer Account Details[...]

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 . The Accounts page displays a list of Developer accounts. 2. Click th[...]

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. The Add New Administrator page is displayed. 3. Enter the required information. An[...]

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. From the Catalog Manager , click Accounts in the main menu b[...]

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 . The following device management tasks are de[...]

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. ▼ Adding a V ending Plan 1. From the Catalog Manager , click Plans in the main menu bar . The V [...]

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. Note – When you select a category , all subcategories for the category are inc[...]

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. 3. Click Edit. The Edit V ending Plans page displays the same field[...]

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. Y ou can add and remove members fr om[...]

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. V ending Manager accounts that are already assigned to the [...]

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 . The V ending Plans page is displayed by default[...]

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. The Content Delivery Server provides a default Developer plan. Y ou can c[...]

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. 3. Click New Prof ile. The Prof ile Definition page is display[...]

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. 8. Click OK to close the Conf irmation page. ▼ Editing a [...]

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. 8. Click OK. The list of prof iles is displayed. ▼ Deletin[...]

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 . 2. Click the Developer Plans tab. 3. Sele[...]

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. Y ou can now add Developer accounts to the plan. See “Adding a Developer Licen[...]

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 . 6. Change the information as required, then click OK. ▼ V iewing De[...]

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. From the Catalog Manager administration consol[...]

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 . 2. Click the Developer Plans tab. The Developer Pla[...]

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. ▼ Deleting a Developer Plan Before you delete a Developer plan, you might want to r eview the Developer accounts that are associated with th[...]

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. Getting Backgr ound Job Status [...]

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. The following information for each job is available: ■ The job number , which is a unique ID automatically assigned to the job at the time o[...]

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. Pending job status changes when the job successfully completes or fails. Clear the jobs listings regularly to r educe memory usage and to make it easier to review the most r ecent jobs[...]

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. The role is assigned when the Administrator account is created. Only V ending Manager administrators can perform the following tasks: ■ Managing Categories Creating, a[...]

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. Administrator T asks As a V ending Manager administrator[...]

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 . For ex[...]

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. That is, top-level and sublevel categories can be created but sub-sublev[...]

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. The Business and Professional category informat[...]

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. For example, to delet[...]

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. c. Click V iew By T itle to see the [...]

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. T ABLE 3-1 shows the symb[...]

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 . ■ Categories - Displays the multiple categories (and their complete paths) that are assigned to the content in the[...]

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. ■ If the content is stocke[...]

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 . ■ Editions - The list[...]

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. If the content item ha[...]

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. Setting Stocking Options From the Catalog tab, you can specify stocking options. The curr ent[...]

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. 4. Click Auto-stocking On. 5. Click OK to save your changes. T [...]

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. 3. Click V iew by T itle. Use the search featur e or view the list o[...]

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. Keywords can contain spaces, underscores, and dashes, but cannot contain special characters, su[...]

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 . 2. Click Stock Content. The Stock Content page is displayed.[...]

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. W ait until all items are loaded befor e making a selection. 3. Select the categories that y[...]

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. A terminal category is the lowest level category and contains only content items. Y o[...]

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. The Stocking Job Status page appears. 8. Click Done. TheStock Content page is[...]

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, and failed stocking jobs: The following information is shown for each job: ■ ID - Content ID ■ Started - Date and time stocking occurred ■ Starte[...]

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. 2. Conf irm or cancel the stocking job. No undo command is available. Items that[...]

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. The Stocking Job Status page is displayed sho[...]

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. ■ Content T ile - Name of the content item ■ V ending Categ[...]

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. The system administrator conf igures the currencies and initial[...]

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. Click the column head to sort the list alphabetically . ■ [...]

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. If you do not want to increase the p[...]

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. 5. Click Edit. 6. Change the vending price. 7. Click OK to save the change. A [...]

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. 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[...]

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. 4. In the f ir[...]

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. Y ou can use the search feature or view the list of content for the category that contain[...]

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 . The Catalog Price shows the pricing option for the content item in the Catalog Manager . [...]

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. ■ Catalog Description - The properties of the content. ■ Prod[...]

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. T o change all selected items to th[...]

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. Note – When scheduling a copy or move operation, be aware tha[...]

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. Under the source column on the left, select one or more categories to copy or move. If you select [...]

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. Y ou must click the check box[...]

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 . If more than one destination category is selected, categor[...]

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. 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 a[...]

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. Under the source column on[...]

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. Y ou must click the check box to select an item in the tree. 7. Click Copy or Move. Th[...]

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. The content items are still available in the Featur ed category . If you copy a content item to a category and decide that you do not want the item in that category ,[...]

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. Before enacting any changes, be sure to r eview the changes to ensure[...]

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. 5. [...]

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. For example, if Spruc[...]

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. ■ If the Auto-stocking option is turned off, you must restock the content in the V [...]

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. ■ Per subscription - No content items with this pricing model are allowed in a bundle. Subsc[...]

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. T o inactive an item, it must first be removed fr om the bundle.[...]

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 . ■ External Content ID This section [...]

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. For each bundle in the list, its status, title, content ID, retail [...]

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. Check the status of content in a bundle fr om the bundl[...]

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. 5. Click Delete. Y ou cannot delete individual items within a bundle. Y ou[...]

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. T o change a[...]

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. 2. Click Bundled Content in the Content Management page. 3. Click V iew by T itle. 4. Click on [...]

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. 2. Click the Content T esting tab. A list of [...]

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. T o start the Campaign W izard, [...]

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. If you are cr eating an event-driven campaign, you can define the event that triggers the [...]

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. Only subscribers who selected the option of ?[...]

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. Note that though you can enter as much text you like in the Subject and T ext fields, a character limit might apply when sending the message depending on the template that might be applied to i[...]

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. b. Open the tree and select the check boxes next to the specif ic[...]

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. ■ Never ex[...]

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. Enter the date and time of processi[...]

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. ■ T o see the campaign sc[...]

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. The number of subscribers is only an es[...]

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. ▼ Creating a Subscriber Segment 1. Open the Subscriber Segments page. 2.[...]

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. If the c[...]

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. 2. Click a subscriber segment name or description. The Segment Details page is[...]

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. 4. Click OK. T ABLE 3-2 describes the properties that you can use to customize the tem[...]

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. DeviceCampaignURL The URL that will take a subscriber to the campaign on the subs[...]

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. ContentItem/ConfigurationVersion The version of the item. For MID[...]

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. 3. Edit the values in the Campaign T emplate Details page. 4. Click OK. Managing V ending Manag[...]

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. From here you can edit or delete an Administrator Accou[...]

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. ■ Conf irm Password - Reenter the password. ■ Status - Leave the status as Enabled u[...]

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. From the V ending Manager administration console, click Accounts on the main menu[...]

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. From the V ending Manager administration consol[...]

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. 2. Click a content category or subcategory to view a l[...]

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. It can have the following values: ■ Active - Stocked conte[...]

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. 3. Click Preferences. Select one of the following display [...]

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. 3. Navigate to the item that you want to examine. [...]

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. 3. Click the login ID for the subscriber account [...]

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. ■ Password - Enter a password of a[...]

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 . Complete the other fields on the page as desir ed. 5. Click OK[...]

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. The Subscriber account Is updated in the database. ▼ V iewing a Subscriber ’s Download History T o view the list of content that a subscriber has downloaded, [...]

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. 6. Select the new status from the St[...]

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. The Subscriber Account Details page is displayed. 4. Click Con[...]

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 . The content in the selected categories is made available to plan members. If co[...]

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 . The Members [...]

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. Content stocked in these categories is made available to the subscribers assigned to this[...]

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. 5. Click OK. The list of subscriber plans is displayed. ▼ V iewing Subscriber Plan Members[...]

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. The Subscriber Plan Management page for the selected plan is displayed. 3. Click Members. A[...]

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. The Subscriber Plan Properties p[...]

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. See “V iewing [...]

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 . See “Editing a V ending Manager Administrator Account” on page 204 . T o edit your [...]

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. This section covers the following actions: ■ Choosing MMS as the Content Delivery System ■ Displaying MMS Messages ■ Creating an MMS Message ■ Editing an MMS Message ■ T esting an MMS M[...]

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. A maximum of 256 characters are allowed for the message text. 4. Specif[...]

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. 6. Click Next to proceed. 7. Select the media type you want to include with the messag[...]

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. 12. Click OK to close the Conf irmation page. ▼ Editing an MMS Message 1. Click MMS on the ma[...]

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. ▼ T esting an MMS Message The T est MMS Message page enables you to send a test messag[...]

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. Open[...]

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. Y ou can a[...]

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. Descriptions [...]

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. Content Delivery Server-Specif ic Capabilities Content Delivery Server-specific capabilit[...]

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. For example, Browser T ype can have one of the following values: ■ WML-1_2 ■ XHTML-NokiaSeries40 ■ XHTML-Symbain ■ XHTML-UP Us[...]

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. Yes or No Deliver[...]

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. For example, Supported Libraries takes a list value that [...]

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.wap.wbmp text/plain text/vnd.sun.j2me.app-de[...]

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. T ABLE A-5 Device Specifications for a User -Defined Device 1 Capability V alue Browser T ype Bits Per Pixel Ccpp Accept String Ccpp Accept Language Micr[...]

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 Screen Height Screen W idth T ABLE A-6 Device Specifications for a User -Defined Device 2 (Continued) Capability V alue[...]

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. T ABLE B-1 lists the possible pricing models that can be used for content types with the corresponding DRM types: T ABLE B-1 Associated DRMs, Content T ypes, and Pricing Models DR[...]

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 always T rial First download only Every download Per period Per use Disconnected Use and T ime Sensitive midlet Free always T rial First download onl[...]

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.00 pe[...]

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.00 is equivalent to $1.00 and no markup is applied. T able notation: ■ PO - [...]

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 . ■ Later , the Catalog Manager administrator edits pricing option 1A by changi[...]

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.50 per Download Custom $2.50 per[...]

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 . Active Content Stocked conte[...]

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. Capabilit[...]

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 . Content Provider Price Purchase price of content set or selec[...]

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. Mandatory Capabilities Required cap[...]

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. The monetary value is initially [...]

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). Una[...]

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 manager, 9 subscriber accounts, 209 to 215 vending manager accounts, 97 to ?? vending manager administrator accounts, 201 to 205 accounts catalog manage[...]

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.newDevice property, 78 B background job indicators, 125 ba[...]

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 care agent viewing stocked content, 20 6 digital rights protection, 20 disassociating pricing option from, 30 editing submitted, 5 2 editions changing th[...]

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, 8 customer care agents adding subscriber accounts, 2 10 adding subscriber members, 22 0 adding subscriber plans, 2 17 deleting subscriber accounts, [...]

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 status types, 79 viewing, 78 devices capabilities specifying a value, 2 36 digital rights protection CDS DRM, 21 CDS DRM agents, descriptions of, 21 CDS O[...]

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 messages, 226 deleting new messages, 23 0 displaying, 225 editing, 228 test logs, 2 31 testing new messages, 229, 230 multimedia message service (MMS)[...]

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 rial, 27, 54 pricing options, 29 creating, 35 disassociating, 30 editing, 37 requir ed, 2 9 profile adding, 1 15 deleting, 1 18 editing, 1 17 properti[...]

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 managing, 209 setting default plan, 2 21 viewing, 210 viewing download history, 2 13 subscriber download history, 2 13 subscriber license changing the st[...]

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 removing, 1 12 viewing, 1 1 1 properties, 108 setting the default, 112 viewing, 107[...]

264 Administration Guide • 2005Q4[...]