DreamSparkGettingStartedGuide en
DreamSparkGettingStartedGuide en
for DreamSpark
Program Administrators
2012-10-10
Version 2.5
TABLE OF CONTENTS
Introduction.................................................................................................................................................... 1
Purpose and Target Audience ............................................................................................................ 1
Commonly Used Terms ...................................................................................................................... 1
Additional References ......................................................................................................................... 2
Welcome to ELMS for DreamSpark .............................................................................................................. 3
Registering Your Administration Account ........................................................................................... 4
Getting Help ........................................................................................................................................ 5
Setting Up Your User Verification ................................................................................................................. 6
Guidelines for Importing Users ........................................................................................................... 6
Adding Users to a User Group ................................................................................................. 7
Email List Example ................................................................................................................... 7
Username List Example ........................................................................................................... 7
Adding an Import Batch ...................................................................................................................... 8
Importing Users with Email Addresses ................................................................................... 11
Importing Users With a UID or Username .............................................................................. 11
Checking the Status of an Import ........................................................................................... 12
Viewing and Adding User Verification Types .................................................................................... 13
Adding an Additional Verification Type ................................................................................... 14
WebStore Verification Type Testing Options ......................................................................... 14
Configuring Standard Integrated User Verification (IUV) .................................................................. 15
Managing Users .......................................................................................................................................... 17
Creating a Single User Account ........................................................................................................ 17
Checking a User’s Account Verification History ............................................................................... 18
Changing a User’s Password ........................................................................................................... 20
Adding a User Group to a User’s Account ........................................................................................ 21
Assigning a User to an Administrative Role ..................................................................................... 22
Providing Additional Downloads for an Item in an Order .................................................................. 24
Managing User Groups ............................................................................................................................... 27
Basing a New User Group on an Existing User Group ..................................................................... 27
Deleting User Groups ....................................................................................................................... 28
Managing the Members of a User Group ......................................................................................... 28
Adding Users to a User Group ............................................................................................... 29
Changing the Expiry Date ....................................................................................................... 29
Exporting a List of Users ................................................................................................................... 30
Managing Orders ........................................................................................................................................ 31
Cancelling an Order .......................................................................................................................... 31
Finalizing an Order ............................................................................................................................ 32
Returning an Order ........................................................................................................................... 33
Reshipping an Order ......................................................................................................................... 34
Providing a Replacement Product Key (Voucher) ............................................................................ 34
Impersonating a User for Support Purposes .................................................................................... 36
Placing Bulk Proxy Orders/Issue Licenses ....................................................................................... 37
Windows 7 Ordering Restrictions ........................................................................................... 37
Managing Product Catalogs ........................................................................................................................ 43
Software Catalogs Offered on the WebStore ................................................................................... 43
Adding and Configuring a Campus Hosted Catalog ......................................................................... 45
Configuring Your Hosting Location (Web Server URL) .......................................................... 46
Getting (Downloading) The Files for the Offerings You Want to Host .................................... 47
Selecting the Offerings for Your Campus Hosted Catalog ..................................................... 48
Activating Your Campus Hosted Catalog ............................................................................... 49
Deleting Offerings From a Campus Hosted Catalog .............................................................. 50
Deactivating the Catalog ........................................................................................................ 51
Activating the Catalog ............................................................................................................. 51
Adding and Configuring a Custom Delivery Catalog ........................................................................ 52
Adding a Custom Delivery Catalog......................................................................................... 52
Configuring a Custom Delivery Method .................................................................................. 53
Adding Offerings to Your Custom Delivery Catalog ............................................................... 54
Managing Organization configuration Settings ........................................................................................... 56
Managing WebStore Configuration Settings ............................................................................................... 57
WebStore Details .............................................................................................................................. 57
Previewing the WebStore ................................................................................................................. 58
Adding Custom Text to Your WebStore............................................................................................ 58
Creating Custom Text in Different Languages ....................................................................... 61
Adding a WebStore Welcome Page and Customizing the Content ................................................. 61
Modifying the Custom Text on a Welcome Page ................................................................... 61
Applying a Custom Image to a Welcome Page ...................................................................... 63
Changing the WebStore Logo, Style Sheet and Other Custom Settings ......................................... 64
Changing the WebStore Culture (Language) or Adding Additional Cultures ................................... 66
Adding Featured Products to Your WebStore .................................................................................. 69
Managing Announcements ............................................................................................................... 71
Customizing Support Contact Information ........................................................................................ 73
Reports ........................................................................................................................................................ 76
Running a Report .............................................................................................................................. 76
Printing and Exporting a Report ........................................................................................................ 77
Support ........................................................................................................................................................ 80
Quick Reference Guide for Program Administrators
What do you want to do? Administration menu/tab item What do you want to do? Administration menu/tab item
Register your Administration Account Click the Register link in your Manage Software Catalogs WebStore » Catalogs
deployment email Offered on the WebStore WebStore » Languages
Set up User Verification WebStore » Verification Add and Configure a Campus WebStore » Catalogs
Hosted Catalog
Import Users Users » User Imports Add and Configure a Custom WebStore » Catalogs
Delivery Catalog
Create a Single User Account Users » Users Manage Organization Organization » Organization
Configuration Settings
Check a User’s Account Verification Users » Users Manage WebStore Configuration WebStore » Details
History Settings
Change a User’s Password Users » Change Password Preview the WebStore WebStore » Details »
‘Preview’ link
Add a User Group to a User’s Users » Verifications » User Add Custom Text to the Miscellaneous » Custom Text
Account Groups WebStore
Assign a User to an Administrative Users » Roles Add a WebStore Welcome Page Miscellaneous » Custom Text
Role and Customize the Content WebStore » Attachments
Provide Additional Downloads for an Users » Orders » Items » Add Images and Modify the Style WebStore » Attachments
Item in an Order Usages of the WebStore
Manage User Groups Users » User Groups Change the WebStore culture WebStore » Languages
(language) or Add Additional
Cultures
Provide a Replacement Product Key Users » Orders » Items » Manage Announcements WebStore » Announcements
(Voucher) Vouchers
Impersonate a User WebStore » Preview Customize Support Contact WebStore » Support
Information
Place Bulk Proxy Orders/Issue Orders » Bulk Proxy Orders Run Reports Reports
Licenses
Introduction
PURPOSE AND TARGET AUDIENCE
This document is a quick start user guide to help you with your first few days as a DreamSpark
Administrator in the new ELMS platform. It is intended to be used in parallel with the Help topics in the
Administration website. In addition, training videos are available which cover the topics in this document.
Not all functions available in the Administrator website are covered in this document. As well, some of the
functions described here do not provide complete step-by-step instructions. For detailed information
about a specific function refer to the Administration website Help topics.
This document is aimed primarily at Program Administrators (PA) who have been assigned to the
DreamSpark Administrator role in ELMS.
The WebStore is displayed with a default logo and a style sheet which you may customize later. The
home page by default is the Software page and displays Products (by Major Version) grouped by
categories with their corresponding box shots. By clicking a product, a list of all the Offerings related to
that major version are displayed. The offerings are displayed based on delivery type, platform and
language, if applicable. Available delivery types can include download, mail order (available only in North
America) and custom delivery. As an administrator, you can create your own custom delivery offerings for
your students, faculty and staff.
When your site was first deployed, it was configured to display offerings in the language of your culture
and in English. For example, a German organization would have been deployed a WebStore containing
both German and English versions of the available products. As an administrator, you can choose other
On the left hand side of the WebStore window, the offerings are listed based on the category they belong
to. Products in the Popular category are pre-defined. You have the option to add products to the Featured
category which would be displayed above the Popular category in the category list.
Users can find answers to the most frequently asked questions related to their account, order, download
and other topics by clicking the Help link at the top of the page. If after reading the Help Topics, the user
does not find an answer, they can click the Contact Us link at the bottom of the Help section. By default,
the information on this page only contains a link to a Contact Us form which the user can fill out and
include a screen shot if required. This information is sent to the Administrator’s email address. You can
customize the content on the Contact Us page as well as who the recipient is for receiving questions from
the user.
When users click the Home link, the Software page is displayed by default. You can change the Home
page to be a Welcome page. See more about this feature below.
Note: You will be able to change your password once you are registered.
3. Click the Register button. You are signed into your WebStore and will have access to the
Administration website.
4. Click the Administration link at the top of the WebStore page. The Administration website
opens in a new browser window. The first page displayed is the Welcome page.
GETTING HELP
Additional information about your WebStore is available by viewing the online Help topics. The Help
topics are accessed by clicking the icon. Clicking the icon displays help related to the page you are
currently viewing. In addition, the Help topic window provides access to a searchable Help topic
database.
Therefore, verification methods not only control access to the WebStore but also control access to
products.
Upon deployment, your WebStore was configured to allow User Imports as the method of user
verification. No configuration of this method is required to continue. You need only perform your user
imports.
Note: If you do not assign the import batch to a user group they will only be eligible to order an offering
with no group restrictions.
Jdoe@[Link]
tsmith@[Link]
whoami@[Link]
somebody5@[Link]
The administrator must contact each user manually to notify them about their account and provide details
of how to register.
tsmith
whoami
somebody5
If you are importing a short list, you can enter the usernames or email addresses directly into the
Username List field. See the Guidelines for Importing Users listed above.
2. Click the Import button. The User Import (New) page is displayed.
3. Enter a Name for the import batch.
1. Create the .TXT file for your users using the guidelines listed above.
Important: The number of users in the import file should not exceed 10,000.
o Ensure all users belong to the same user group such as Faculty or Staff or Students.
o Do not use the user groups with two or more options such as Faculty/Staff or
Students/Faculty/Staff.
o In the Import Mode section, click the radio button beside Import from a file.
2. Click the Browse button to locate the .TXT file that you created.
1. In the Import Mode section, click the radio button beside Import From a Text List.
o Ensure all users belong to the same user group such as Faculty or Staff or Students.
o Do not use the user groups with two or more options such as Faculty/Staff or
Students/Faculty/Staff.
3. If the correct Member of Organization is not displayed, search for the organization by clicking
the Select button.
Note: By default, the Member of Organization is the organization that you signed into the administration
website with. If an organization has two departments with the DreamSpark Premium program, for
example, but only one WebStore, they may want to track which users from each department are using the
WebStore. If the users you are importing belong to a different organization than the one you signed in
with, choose a different Member of Organization by clicking the Select button.
Note: When adding users to a user group, ensure all users belong to the same group such as Faculty or
Staff or Students or a user group which you may have created based on these groups. For example, all
users are Students or all users are Faculty. Do not use the user groups with two or more options such as
Faculty/Staff or Students/Faculty/Staff.
5. Click the Import button. The message “The import was successful” is displayed.
This means that the import process has successfully started. Depending on the size of the list, it may take
some time to process all users in the list.
Details such as when the list was imported, who did the import and how many users were attempted to be
imported are displayed.
For more details about this Import, click the import Name link.
Details about the import such as the number of successful account creations that took place are
displayed.
If there are currently no active verification types defined (a new WebStore deployment will have User
Import defined as the default verification type) or if you delete all the existing verification types, the
following message is displayed:
2. Select the verification type you want to add to your WebStore by clicking the check box beside
the Name.
3. Click the OK button.
For the purpose of testing, you can add more than one Standard Integrated User Verification (IUV)
verification type.
By default, when a new verification type is added the status is set to Testing.
All the orders placed using Test WebStore URLs will be test orders. This means that the order details
page will display *Test Order* and will not display any product keys.
Verification type status:
Testing: Verification type can be tested but is not visible to shoppers on your WebStore. Only
one of each Single Sign-On verification type can be in Testing at a time.
Active: Verification type appears on the WebStore. Only one Single Sign-On verification can
be active at a time.
Inactive: Verification type does not appear on the WebStore and is not being tested.
You can have more than one active verification method at the same time, providing the verification
methods belong to a different Class.
To configure IUV:
1. On the WebStore Verification page, click the Standard Integrated User Verification link. The
User Verification Type page is displayed.
3. Under the Details and Settings tabs, enter the required fields.
4. Click Apply.
Figure 14 - Users
The account is now created. On the expiry date above, the user will no longer be able to order software
that has been configured to be eligible to the Students group. The user will, however, be able to log in to
his/her account and download previously ordered software, providing the account is still active.
3. Click the Username link and then click the Verifications tab.
In the example above, this user account was verified using Manual By Administrator and the user
belongs to the Students user group.
To learn details about this verification, click the History link in the Status column. A record of the account
creation/verification is displayed.
The user will have access to the administrative functionalities related to the role:
Role Functionality
User Administrator Access to add/edit users and user groups as well as view orders
and reports.
The selected role is displayed in the user’s account, under the Roles tab.
6. Click the see usages link. Usages are the number of downloads assigned to an order.
7. Select the product by clicking the check box beside the Product Name.
8. Click the Change Allowed Usages button.
The user groups configured for your organization are displayed when you open the User Groups page.
These user groups are public. You cannot delete them or change the name. You can add users to these
public user groups or you can base a new user group on an existing user group.
For example, you may need restrictions based on departments. You could create a Grad Students user
group under the Students user group and members would be able to order offerings restricted to Students
or Grad Students and users who were only members of the Students group would not be able to order
offerings restricted to the Grad Students user group.
To add a user group for Grad Students that is based on the Students user group:
1. Click the New Based On button. The User Group Selection List page is displayed.
2. Click the check box beside the Students user group.
3. Click the OK button to add the user group and return to the previous page. Notice that a new
group named Student 1 has been created.
If you select more than one public user group when creating new user groups based on existing ones, a
new user group will be created for each selection. For example, if you select Students, Faculty and Staff,
three new user groups will be created with the names Students 1, Faculty 1 and Staff 1.
From the Manage Members page, you can add users to the user group and change the expiry dates of
users.
Note: Only the expiry dates for the users within the context of the user group are changed.
If you want to export the list of users and you plan to use it for a user import, be sure to select the Format
for user import option before viewing the report. When checked, only the Username field is displayed.
The list can then be exported and imported again.
To view the report, click the View Report button. To export the report, expand the Export drop-down list
and choose your desired format.
To find an order:
1. On the Main menu, go to:
Orders » Orders
2. Enter the search criteria and click the Search button. You can also find the order from the
User’s account by clicking the Orders tab.
CANCELLING AN ORDER
You can only cancel orders that are in a pending state. If you try to cancel an order that has been
finalized, your request will be rejected.
To cancel an order:
1. Select the order by clicking the check box beside the Order Number.
2. Click the Cancel Order button.
3. You are prompted to enter the reason for cancelling the order. Enter the details and click the OK
button.
FINALIZING AN ORDER
This functionality is used in rare situations when the ordering process is not finalized for some reason
such as a session time-out or a computer freeze. When this happens, the order was not finalized but the
user cannot place another order for the same product until the original order has been finalized.
To finalize an order:
1. Select the order by clicking the check box beside the Order Number.
2. Click the Finalize button.
To return an order:
1. On the Orders page, search for the order you want to return.
2. Click the Items tab.
3. Select the Offering in the order to be returned by clicking the check box beside the Offering
Name.
4. Click the Return button.
5. You are prompted to enter the return reason. For free offerings, you do not have to select any
other option.
Once returned, the order in the Your Account section will not allow the user to download the product or
view the product key. However, the user can order this product again.
RESHIPPING AN ORDER
This functionality is not available to a DreamSpark Program Administrator. If you need to reship a mail
order product, contact DreamSpark@[Link] for assistance.
If you select the offering and click the Reship button, you will get a message that “You are not
authorized to perform this action”.
6. Select the product by clicking the check box beside the Product Name.
7. Click the Issue Replacement Voucher button.
Once a product key has been replaced, the user will only see the new product key in the Your Account
section of the WebStore. The replaced key will be returned to Microsoft and marked for destruction. The
user should not attempt to use the replaced key even if they still know it.
To impersonate a user:
1. On the Main menu, go to:
WebStore » Preview
Note: Make sure to select the tab and not the link on the WebStore Details page.
A browser window opens and you are signed into the WebStore as if you are the selected user. You can
browse the WebStore and you can access his/her account information.
Note: You cannot impersonate a user who has been assigned to an administrative role.
To place a bulk proxy order, the recipients of the order must be imported into ELMS. The users can be
imported into ELMS before your place the bulk proxy order or during the process of placing the bulk proxy
order. Choose Import Batch during the bulk proxy order process. All users who were imported in that
batch will receive orders for the selected software titles. For instructions on importing a list of users, see
the Guidelines for Importing Users section.
On the WebStore, if the user is placing the order themselves and violates these rules, they will receive an
eligibility error message.
During a bulk proxy order, an order for a user contains all offerings that were selected. If one of the rules
is violated for an offering, including the rules above, the entire order for that user will fail during
processing.
10. Click the Proceed With Order button to start the process. The confirmation page is displayed.
Depending on the number of users in the import batch file (should not exceed 10,000) , as well as the
number of offerings you chose for this bulk proxy order, the processing of the entire order could take a
significant amount of time – even hours. Keep checking back to track the progress.
In each of the user’s accounts that you imported, the order is displayed with (proxy order) noted in the
Total Amount column.
If you do not import the list of users before you place a bulk proxy order, you can do it during the batch
order process. Think of it as the import process embedded in the batch proxy process.
2. Click the Import button. The User Imports (New) page is displayed.
3. See the Guidelines for Importing Users section for detailed instructions on importing users.
4. Choose the batch by clicking the radio button beside the Name.
5. Click the OK button.
6. Continue with the bulk proxy order.
To see the default (or current) list of catalogs for your region, go to:
WebStore » Catalogs
The following is an example of the list of catalogs deployed for a North American organization:
These catalogs contain offerings (products) in many different languages. You cannot remove a product
from the catalog, but you can define which language versions you want to make available for your users.
By default, the language of your culture plus the English language offerings are made available.
3. Add or remove languages in this list by using the Add and Remove buttons.
If the offering is available in the selected language, it will be displayed on the WebStore. If there is more
than one language offering available, the different language offerings will be separated in tabs.
Note: The offering language selection you make applies to ALL catalogs on your WebStore.
This catalog is now added to your organization, but it is not yet active.
To make campus hosted offerings available to your community you need to:
1. Configure your hosting location (web server URL).
2. Get (download) the files for the offerings you want to host.
3. Transfer the files to your configured hosting location.
4. Select the Offerings for your Campus Hosted catalog.
5. Activate your Campus Hosted catalog.
The current Offering Count (product count) is zero. The catalog exists but now you must add offerings
that you want to host locally and then activate the catalog.
Note: If you do not see the Get Files link, you have not yet configured the catalog’s hosting
location. See the Configuring Your Hosting Location (Web Server URL) section above.
4. When you finish downloading all the files you need, transfer them to the hosting location you
have configured.
You are now ready to select the offerings from the Campus Hosted catalog and make the catalog active.
3. Select the offering you want to add to this catalog by clicking the check box beside the Name.
Note: If you added one offering, your catalog is now active with an offering count of 1
To delete an offering:
1. On the WebStore Catalogs page, click the Manage Offerings link.
2. Select the Offering you want to delete by clicking the check box beside the Name.
When all offerings are deleted, the Campus Hosted catalog becomes inactive and the Offering count is
back to zero:
If an offering is deleted from a catalog or if the whole catalog is made inactive and a user downloads
software from your account, they will be downloading from the Kivuto hosting location.
If you want to include the offering again or reactivate the catalog, all downloads will again originate from
the campus hosting location that you configured.
The catalog is no longer active, however the offerings that you have selected remain in the catalog. The
next time you want to activate this catalog, you can use the same offering list or you can manage new
offerings.
Important: If you want to activate the catalog with a different list of Offerings, download and host the files
and select those offerings before activating the catalog.
You can add and delete offerings, as required. When all offerings are deleted from this catalog, it
becomes inactive. You can also deactivate the whole catalog by clicking the Deactivate link in the
Actions column.
Based on your deployment, some fields will be filled in. You can modify any information on this page
except the fields that are grayed-out. If you want to change a non-editable field, contact
DreamSpark@[Link] for assistance.
WEBSTORE DETAILS
To customize the configuration of your WebStore, go to:
WebStore » Details
You can also add custom text and images to your WebStore. These functions will be explained later.
A new browser window opens displaying your WebStore with the changes applied.
It is highly recommended that you change the content of this default label as it could cause confusion to
your users.
If the localized content does not exist in the language in which the site is viewed, the content is displayed
in a default language.
You can set localized content and a default language by clicking the Languages button in the Custom
Text window.
The following is an example of the default Welcome page text which you can customize:
At any point, you can display the default text instead of the customized text.
4. Select an image size that will fit the screen without compromising the Welcome text.
5. Click the OK button.
The following is an example of where the Welcome page image is displayed in the WebStore.
By default, the DreamSpark WebStore logo and style sheet are applied:
You can change the logo and the style sheet or add a Welcome page image as well other images. If you
want to replace the current attachment, make sure you delete the existing one first.
To change an attachment:
1. On the WebStore Attachments page, click the New button.
2. From the drop-down list, select the type of attachment you want to add.
In addition to changing some of the default cascading style sheet settings, you can also customize other
The first culture in the list is the default culture for the WebStore for all users. If you offer more than one
WebStore culture, users can select a different language on the WebStore by clicking the current language
at the top of the page. When more than one language is defined for a WebStore, the current language is
a link.
4. Once you have chosen all the products you want to feature, click the OK button.
To create an announcement:
1. On the Main menu, go to
WebStore » Announcements
Some announcements that are displayed on your WebStore are added by Kivuto. These announcements
cannot be modified.
For additional help, users can contact Support by clicking the Contact Us link at the bottom of the page.
By default, the Contact Us page only contains a link to a web form. Once the user fills out the web form,
an email is sent to the Program Administrator for the site.
To customize the information on the Contact Us page as well as define who the web form email
should be sent to:
1. On the Main menu, go to
WebStore » Support
Note: The text at the top of the Contact Us page (Click the Contact Customer Support link below to fill in a
form with your question or issue. This form will be sent to your Program Administrator.) cannot be
changed or removed.
More detailed information as well as specific examples for this feature can be found within the
Administration website Help section.
RUNNING A REPORT
To run a report:
1. Click Reports. The list of available reports is displayed.
2. From the Export drop-down list and choose your desired format. A new window opens.
3. You are prompted to Open, Save or Cancel.
4. Your report is displayed in the selected format.
If you selected the unformatted version of the report, once exported to Excel or CSV, the reports do not
include all the special formatting displayed in Figure 107 above. The unformatted version allows you to
manipulate the data more easily.