Beruflich Dokumente
Kultur Dokumente
ii
MicroStrategy Objects, MicroStrategy OLAP Provider, MicroStrategy SDK, MicroStrategy Support, MicroStrategy
Telecaster, MicroStrategy Transactor, MicroStrategy Web, MicroStrategy Web Business Analyzer, MicroStrategy World,
Application Development and Sophisticated Analysis, Best In Business Intelligence, Centralized Application Management,
Information Like Water, Intelligence Through Every Phone, Intelligence To Every Decision Maker, Intelligent E-Business,
Personalized Intelligence Portal, Query Tone, Rapid Application Development, MicroStrategy Intelligent Cubes, The
Foundation For Intelligent E-Business, The Integrated Business Intelligence Platform Built For The Enterprise, The Platform
For Intelligent E-Business, The Scalable Business Intelligence Platform Built For The Internet, Office Intelligence,
MicroStrategy Office, MicroStrategy Report Services, MicroStrategy Web MMT, MicroStrategy Web Services, Pixel Perfect,
Pixel-Perfect, MicroStrategy Mobile, MicroStrategy Integrity Manager and MicroStrategy Data Mining Services are all
registered trademarks or trademarks of MicroStrategy Incorporated.
All other company and product names may be trademarks of the respective companies with which they are associated.
Specifications subject to change without notice. MicroStrategy is not responsible for errors or omissions. MicroStrategy
makes no warranties or commitments concerning the availability of future products or versions that may be planned or under
development.
Patent Information
This product is patented. One or more of the following patents may apply to the product sold herein: U.S. Patent Nos.
6,154,766, 6,173,310, 6,260,050, 6,263,051, 6,269,393, 6,279,033, 6,567,796, 6,587,547, 6,606,596, 6,658,093,
6,658,432, 6,662,195, 6,671,715, 6,691,100, 6,694,316, 6,697,808, 6,704,723, 6,741,980, 6,765,997, 6,768,788,
6,772,137, 6,788,768, 6,798,867, 6,801,910, 6,820,073, 6,829,334, 6,836,537, 6,850,603, 6,859,798, 6,873,693,
6,885,734, 6,940,953, 6,964,012, 6,977,992, 6,996,568, 6,996,569, 7,003,512, 7,010,518, 7,016,480, 7,020,251,
7,039,165, 7,082,422, 7,113,993, 7,127,403, 7,174,349, 7,181,417, 7,194,457, 7,197,461, 7,228,303, 7,260,577,
7,266,181, 7,272,212, 7,302,639, 7,324,942, 7,330,847, 7,340,040, 7,356,758, 7,356,840, 7,415,438, 7,428,302,
7,430,562, 7,440,898, 7,486,780, 7,509,671, 7,516,181, 7,559,048, 7,574,376, 7,617,201, 7,725,811, 7,801,967,
7,836,178, 7,861,161, 7,861,253, 7,881,443, 7,925,616, 7,945,584, 7,970,782, 8,005,870, 8,051,168, 8,051,369,
8,094,788, and 8,130,918. Other patent applications are pending.
Various MicroStrategy products contain the copyrighted technology of third parties. This product may contain one or more
of the following copyrighted technologies:
Graph Generation Engine Copyright 1998-2012. Three D Graphics, Inc. All rights reserved.
Actuate Formula One. Copyright 1993-2012 Actuate Corporation. All rights reserved.
XML parser Copyright 2003-2012 Microsoft Corporation. All rights reserved.
Xalan XSLT processor. Copyright 1999-2012. The Apache Software Foundation. All rights reserved.
Xerces XML parser. Copyright 1999-2012. The Apache Software Foundation. All rights reserved.
FOP XSL formatting objects. Copyright 2004-2012. The Apache Software Foundation. All rights reserved.
Portions of Intelligence Server memory management Copyright 1991-2012 Compuware Corporation. All rights reserved.
ASIHTTPRequest library. Copyright 2007-2012, All-Seeing Interactive. All rights reserved.
This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit. (http://www.openssl.org/)
International Components for Unicode
Copyright 1999-2012 Compaq Computer Corporation
Copyright 1999-2012 Hewlett-Packard Company
Copyright 1999-2012 IBM Corporation
Copyright 1999-2012 Hummingbird Communications Ltd.
Copyright 1999-2012 Silicon Graphics, Inc.
Copyright 1999-2012 Sun Microsystems, Inc.
Copyright 1999-2012 The Open Group
All rights reserved.
Real Player and RealJukebox are included under license from Real Networks, Inc. Copyright 1999-2012. All rights
reserved.
iii
iv
Contents
Application Designer Overview xxi
Organization xxi
Reference materials xxii
Task list xxii
Section I
vi
Contents
Contents
vii
viii
Contents
Section II
Contents
ix
Contents
Contents
xi
xii
Contents
Contents
xiii
Section III
Contents
xv
Section IV
xvi
Contents
Contents
xvii
Example to dynamically rename the file using Region attribute (in the row) based on
the attribute element name 486
Example to dynamically rename the file based on the report filter name 489
Example to dynamically rename the file based on the report attribute name in the
page-by field 491
Dynamically renaming the zip file and files within the zip file in file attachments 492
Syntax to change the name of zip file and files within the zip file in the file
attachment 493
Example 493
Syntax rules 493
xviii
Contents
Section V
Index 533
Contents
xix
xx
Contents
INTRODUCTION
Application Designer
Overview
Organization
The information in this guide is divided into three main sections:
ConceptsThis section provides you with the key concepts about the
product components and features with which you are working.
InterfacesRefer to this section for interface-specific information.
This section explains the interfaces you use to develop and test services.
How do I...?This is where the procedural information is found. This
section provides the answers to the how do I? questions you might
have while using Narrowcast Server.
xxi
Reference materials
Before you begin developing an application, you should read the
Narrowcast Server Getting Started Guide, which serves as an introduction
to the features and functionality of MicroStrategy Narrowcast Server. The
Getting Started Guide also provides you with the basic terminology and
information resources that can help you navigate the software and
accompanying documentation.
Task list
A task list is shown below which identifies the application design tasks for
the roles of application designer, subscription administrator, and portal
administrator.
When designing services for a new system, you perform the application
designer tasks in the appropriate order.
When setting up subscription information for a new system, you
perform the subscription administrator tasks in the appropriate order.
When setting up a subscription portal for a new system, you perform the
portal administrator tasks in the appropriate order.
You might perform additional tasks during the course of designing your
application, but the following lists the basic tasks.
Task
Application Designer:
1. Design and create services
3. Test services
xxii
Task
Subscription Administrator:
4. Create, modify, delete users in the Subscription
Book
Portal Administrator:
7. Select a Portal Repository
Task list
xxiii
xxiv
SECTION I
Application Designer
Concepts
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
C H A PT E R
1.
Creating Services
C
O
N
C
E
P
T
S
A service is the fundamental tool that you use to deliver information using
Narrowcast Server. A service defines some set of information that should
be delivered, how this information should be delivered, a set of users who
want to receive this information, and the schedule on which they would
like to receive it. Thus, a service is the entity that defines who should
receive content, what content they should receive, how they should receive
it, and when they should receive it. When you define a service you
therefore answer these same questions. The Service Wizard is the
recommended way to create services. It should satisfy your needs for most
application design requirements. The Service Wizard guides you through
the process of designing a service by having you define the following:
The delivery methods by which a service should be delivered, such as
e-mail, wireless, and over the Web
The content that should be delivered, such as an HTML e-mail with
several reports or a wireless plain text service for a wireless service
The recipients who should receive this information and their
preferences
The schedule on which the information should be delivered
The following sections include the following: cover each of these topics in
greater detail.
C
O
N
C
E
P
T
S
Publications
Each delivery method is supported by a single publication, which specifies
the content to be delivered. Since each delivery method corresponds to an
information transmitter, each publication is in turn created for a single
information transmitter. It is the information transmitter for a publication
that specifies which content sections the publication provides to the
application designer and which types of content each section can accept.
For example, the E-mail (SMTP) information transmitter informs
publications for the E-mail (SMTP) delivery method that a message
subject, message body, and a section for attachments should be provided.
The E-mail (SMTP) information transmitter also dictates that the subject
can only accept one text document, while the attachments section can
accept any number of documents of any type. Other information
transmitters specify their own content sections and their own rules for what
types of content these sections can accept.
In addition to this role of containing message content, publications also
specify the locales and devices the publication supports. As discussed in
chapter 8, Supporting Diverse User Populations, locales specify the
regional characteristics of messages while devices control how messages
are formatted for end user devices. When creating services using the
Service Wizard, all of this functionality might not be immediately
apparent. This is because the Service Wizard is designed to guide you
through a streamlined application design process. For example, when you
select a delivery method, a publication is automatically created that is
4
embedded within the service. Similarly, when you click a content section
for one of these delivery methods, an editor opens. Using this editor, you
can create a document which is then embedded within the publication. You
might not even be aware that you are creating embedded publications with
multiple embedded documents, but this is in fact what is occurring.
In addition, the Service Wizard automatically ensures that each publication
supports all devices that exist for the corresponding information
transmitter and the system locale. You can change these selections by
clicking Set Devices and Locales within each content section.
Furthermore, if you wish to create reusable documents that are reused by
one or more services or by multiple delivery methods within a service, you
can do this by creating a document within Narrowcast Administrator and
then choosing to use an existing document for the content pane in the
Service Wizard.
However, in addition to serving the content specification role as described
above, publications also support a content selection role. To understand
how this works, consider that each publication supports a single locale and
a set of devices. Similarly, each user chooses a locale for which they would
like to receive content and each address for a user is created for a specific
device. Thus, when a service is delivered Narrowcast Server matches
subscriptions with the appropriate content.
For example, a service can contain a publication with German content and
a publication with French content. Each user can then specify a locale for
which he wants to receive content using the Subscription Portal, or an
administrator can define user locales using the User Properties Editor.
When a service is executed, a German user subscribed to this service
receives German content, and a French user subscribed to this service
receives French content. The same selection behavior occurs with devices.
A service can contain a publication with content defined for PDAs and a
publication with content defined for a specific set of e-mail clients. Each
address must specify the type of the device for which it should receive
content. Thus, when a service is executed, subscribers accessing data
through both PDAs and e-mail clients receive appropriate content even
though they have both subscribed to the same service. The advantage to
this selection of content based on devices and locales is that one service
can be defined for an intended purpose (for example, a stock alert, a
weather update, or an inventory alert), and any user who wishes to receive
this information can subscribe to this service using his preferred device
and locale.
As a result, when designing a service, it is important to design publications
considering the devices and locales the service is intended to support. For
services intended for users requiring the same language and using devices
that have the same capabilities (for example, a corporation in which every
address belongs to a Microsoft Outlook e-mail client), a simple service
Choosing delivery methods
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
with one publication that supports the appropriate devices handles the
requirement. By default, the Service Wizard supports all devices for an
information transmitter and the system locale, and all users are created
using the system locale. Thus, for simple services that do not require
multilocale support, locales should not be changed in the content
specification process.
However, for complex services that are intended to support multinational
or multilanguage user communities, or multiple devices with varying
capabilities, it is important to consider both publication content and how
publication design impacts the content selection role of determining
which users receive which publications. As noted above, a subscription
only receives a publication if the locale and device used by the subscription
are supported by the publication. The one exception to this rule is the
system locale, which can be used to create a backup, or failover,
publication. If a publication is defined for the system locale, it is delivered
to a subscription if the device used by the subscription is supported by the
publication (regardless of locale), and no publication is found that
supports both the locale and device used by the subscription.
This is best clarified by the following example.
Address1 uses Device1 and exists for a user who uses Locale1.
Service1 contains the following three publications:
Publication1: Supports Device1, Locale2
Publication2: Supports Device2, Locale1
Publication3: Supports Device2, Locale2
If subscribed to a subscription set used by Service1, Address1 receives
nothing.
Service2 contains the following three publications:
Publication4: Supports Device1, Locale2
Publication5: Supports Device2, Locale1
Publication6: Supports Device1, System Locale
If subscribed to a subscription set used by Service2, Address1 receives
Publication6 since no publication supports Device1 and Locale1 but
Publication6 supports the system locale and Device1.
Service3 contains the following three publications:
Publication7: Supports Device1, Locale2
Publication8: Supports Device1, Locale1
Publication9: Supports Device2, SystemLocale
C
O
N
C
E
P
T
S
Go to first
publication
Go to next
publication
Publication
supports user's
device?
no
yes
Publication
supports user's
locale?
yes
More
publications?
no
Go to first
publication
no
Go to next
publication
yes
Publication is used to
determine service
content for user
Publication
supports user's
device?
no
End
More
publications?
yes
Publication
supports user's
system locale?
yes
no
no
Subscription not
supported by service
definition. No
message generated.
End
C
O
N
C
E
P
T
S
Content sections noted as advanced are sections that are not needed for
basic applications, but can provide additional power and flexibility for
advanced applications. These sections are typically execution control
documents that provide additional flexibility to control how messages are
delivered. For example, the contents of a MicroStrategy report can be used
to dynamically control the sender that appears in e-mail messages sent by
Narrowcast Server. The properties that are controlled by execution control
documents vary from one information transmitter to the next. For more
information on execution control documents for the e-mail and wireless
(SMTP) information transmitters, see E-mail and Wireless (SMTP) ITM
Execution Control Documents. For more information on execution control
documents for the File information transmitter, see Changing File Names
and Extensions: Execution Control Documents. For more information on
execution control documents for the SMS (SMPP) information transmitter,
see SMS (SMPP) ITM Execution Control Documents.
In addition, for the Wireless (SMTP) information transmitter, an HTML
message body section is also provided as an advanced content section. This
is for advanced devices that support HTML content. For the e-mail
(SMTP) information transmitter, a text message body section is also
provided as an advanced content section. If only a text message body and
no HTML message body is specified, text e-mails are delivered. If both
text and HTML message bodies are provided, a multi-part MIME message
is delivered. Multipart MIME allows one e-mail message to contain both
text and HTML bodies so that MIME-compatible e-mail clients can
display the best content type that they support. MIME is an extension to
the standard SMTP e-mail protocol that allows HTML messages,
attachments and other content beyond plain ASCII text to be sent via email.
Within each content section, error handling can be used to control whether
or not messages are sent to individual recipients if there is an error with any
documents formatted for a particular recipient. Each document within a
service can either be removed or can cause no content to be delivered to
this recipient if an error is encountered.
For the E-mail (SMTP) delivery method, you define the content by adding
documents to the following content sections:
Subject
Message body (HTML)
Attachments: includes Excel, HTML, and text, as well as zip and other
imported files
Execution control (advanced): overrides the default information
transmitter settings. For information about using an execution control
document in an E-mail (SMTP) delivery method, see E-mail and
Wireless (SMTP) ITM Execution Control Documents.
Message body (text) (advanced)
Wireless (SMTP) delivery method
For the Wireless (SMTP) delivery method, the following content sections
hold the service content:
Subject
Message body (text)
Attachments: includes Excel, HTML, and text, as well as zip and other
imported files
Execution control (advanced): overrides the default information
transmitter setting. For information about using an execution control
document in a Wireless (SMTP) delivery method, see E-mail and
Wireless (SMTP) ITM Execution Control Documents.
Message body (HTML) (advanced)
Print delivery method
For the Print delivery method, the following content sections hold the
service content:
Cover page: can include one or more text or HTML documents; these
are printed first in the order they appear in the interface
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
For the File delivery method, the following content sections hold the
service content:
Saved documents: requires at least one document of any type; one or
more are allowed
Execution control (advanced): can include only one text document; this
document is optional. For information about using an execution control
document in a File delivery method to add or overwrite file properties,
see Changing File Names and Extensions: Execution Control
Documents.
SMS (SMPP) delivery method
For the SMS (SMPP) delivery method, the following content sections hold
the service content:
Message body: required and limited to one plaintext document
Execution control document (advanced): overrides the default
information transmitter settings; this document is optional and limited
to one plaintext document. For information about using an execution
control document in a SMS (SMPP) delivery method to complement or
overwrite message properties, see SMS (SMPP) ITM Execution Control
Documents.
Web (Portal) delivery method
For the Web (Portal) delivery method, the following content sections hold
the service content:
Document body: can be one HTML or one plaintext document
Attachments: can be any number and any type of documents)
Link rendering style: an XSL stylesheet file that transforms ITMgenerated XSML into hyperlinks. These hyperlinks are then added to
the bottom of the HTML message body for Subscription Portal
messages. By using a different XSL stylesheet, the appearance of these
hyperlinks can be changed.
10
Documents
When content sections in a service such as a subject or message body are
added for a delivery method, a document is created. Documents define the
fully-formatted content that end users receive. Documents combine static
content such as text, HTML, and static images with dynamic content such
as reports returned from MicroStrategy Intelligence Server, personalized
files, and personalized Web hyperlinks. Multiple types of documents are
available to support different types of content such as HTML, text, and
Excel. Each delivery method, such as e-mail or wireless, supports one or
more content sections such as the subject or message body of an e-mail
message. In the Service Wizard, content is defined by clicking a content
section for the desired delivery method. This opens a document editor to
define the appropriate type of content for the selected content section or
opens a dialog box so that you can select the information source containing
a MicroStrategy Desktop document to include. Using this process, you can
easily create and select the appropriate documents to serve as service
content.
The export formats you can select in Narrowcast depend on the export
formats set while creating the document. For details to define export
formats for a document, see the Desktop Report Services Document
Creation Guide.
For more information on working with HTML, Excel, and text documents,
see Working with Documents. This chapter provides in-depth information
on how to create powerful, high-quality content within Narrowcast Server
as well as techniques for working with each type of document. Also,
information on how to link to MicroStrategy Desktop documents and
include them in Narrowcast Server services is provided. An additional
section on XSL stylesheets provides comprehensive information on using
XSL stylesheets with Narrowcast Server.
Both documents embedded within services and reusable documents saved
within Narrowcast Administrator can be given names to help you identify
them and remember their purpose. However, when naming documents to
be used as attachments, you need to avoid the use of characters that could
cause an invalid file name when files are sent as attachments. Invalid
11
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
* ? < > |
Document elements
A document element consists of one or more information objects plus
error handling settings and XSL stylesheet selection. A document element
is essentially a place holder or container for one or more information
objects, which allow dynamic content to be added to a document, and for
the same formatting and error handling conditions to be applied to all
information objects within this document element. This also allows an
information object to be changed without changing the stylesheet or error
handling settings. Its ability to hold multiple information objects permits
several information objects to be merged by one XSL stylesheet. Each
information object must have the same type, such as text, XML, or HTML.
Error handling
In MicroStrategy Narrowcast Server, the error handling properties that
govern the delivery of dynamic content are defined at the document
element level, the document level, and the publication level.
Document element-level error handling
12
13
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
so that the recipient receives no message. These error handling settings can
be defined for each document within a publication using either the Service
Wizard or the Publication Wizard. In the Service Wizard, click Error
Handling to set the desired delivery method.
Error handling and alerts
Error handling is also available at the document formatter level for the
Excel document formatting module. No error handling is available for the
HTML or Plaintext document formatting modules. For information about
using Excel documents in a service, see Excel documents.
14
Compressed documents
Delivering large documents in Narrowcast Server services can adversely
affect the speed and performance of various downstream systems and can
require large amounts of storage space. For example, this might occur
when large Microsoft Excel workbooks are delivered via e-mail, published
to the Subscription Portal, or saved to network locations.
Compressing, or zipping, documents is one way to reduce the size of files
generated by Narrowcast Server. File compression advantages include:
Reduced traffic across corporate networks
Reduced storage in mail systems
Reduced download times from the Subscription Portal
Faster, more efficient transfer between mail systems and client
machines
Reduced database storage space requirements when storing
Subscription Portal documents in a database
Any information transmitter that can accept imported documents can send
compressed documents. This includes the E-mail (SMTP), Wireless
(SMTP), and Web (Portal) information transmitters that are provided with
Narrowcast Server. The SMS (SMPP) information transmitter, which does
not accept imported documents, also does not allow documents to be
compressed. Custom information transmitters follow the same rule: if it
accepts imported documents, it can send compressed documents.
Narrowcast Servers file compression technology includes the following
compression levels:
Maximum: This level is the slowest to produce a compressed file;
however, it produces the smallest files. As a result, the performance of
other processes, such as saving files to databases for use by the
Subscription Portal, can be greatly improved.
Creating service contents
15
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
16
Schedules
A schedule sets the times or frequencies a service is executed and
represents a recurrence pattern, not a fixed date on which to send the
service. For example, although you can be specific with the service start
date, for example, April 4, 2000, at 2:30 PM, it is still a recurring schedule,
most likely on a yearly recurrence. Execution intervals are calculated by
combining the start date of a service with the interval specification of a
schedule to arrive at a set of dates and times when the service runs.
All schedules are built using the standard Gregorian calendar, as opposed
to a fiscal calendar. Schedules are defined relative to time zones, to
automatically account for daylight savings time, date boundaries, and
other time zone specific issues. To allow subscribers throughout the world
to receive services at specific local times, each service can use more than
one schedule.
Since Narrowcast Server is driven by the calendar, use of other calendars,
such as merchandising calendars and fiscal calendars, must be simulated.
Similarly, holidays present disruptions in schedules which should be
handled carefully.
17
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
18
C
O
N
C
E
P
T
S
Who?
(Who will receive this information?)
Subscription Set
What?
(What information will be sent?)
Publication, Document, Information Object,
Question Object
When?
(When will this information be sent?)
Schedule
Where?
(Where will the user receive the information?)
Device
How?
(How will this information be formatted?)
XSL File, Locale
19
C
O
N
C
E
P
T
S
20
21
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
22
Next steps
If you have read this chapter, you now understand how services work and
how to create them. The next logical place to go is to the next chapter,
Dynamic Content and Personalization, to learn how to add dynamic
content such as reports to your service and how to personalize users so that
each user receives content that is relevant to them. Once you complete this
chapter, you can learn more about user management options in the User
Management chapter, or explore other functionality within Narrowcast
Server in the subsequent sections.
Next steps
23
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
24
C H A PT E R
2.
C
O
N
C
E
P
T
S
Dynamic content
After reading the chapter on Creating Services, you understand that service
content is created using documents. These documents are created by
entering content such as HTML or text into an editor. This content that is
entered directly into the editor is called static content since it is not
determined at service execution time and does not change from one
recipient to the next or from one service execution to the next. However,
the true power of Narrowcast Server comes from content that is
determined at service execution time and can vary from recipient to
recipient or from execution to execution. This type of content is called
dynamic content. Like static content, dynamic content is added to
documents, but dynamic content may be personalized so that each
recipient receives information that is relevant for him. This section
provides an overview of dynamic content and how Narrowcast Server uses
Information Objects to retrieve dynamic content from external sources
such as MicroStrategy projects, database queries, or external systems.
Information objects
A key feature of Narrowcast Server is the ability to gather and use
information from external sources. This information can be used for
message contents or for subscription set information. This information can
be retrieved from diverse locations such as a relational database, on the
Web, in a flat file, and so on. In Narrowcast Server information objects
play this crucial role of gathering information from external sources. An
information object is a set of instructions specifying how to get data from
an external information source.
This section provides an overview of how information objects work and
how you can use them to create powerful applications. For information on
best practices to be followed while creating an information object, see Best
practices for creating an information object outside the service.
25
C
O
N
C
E
P
T
S
26
Segment information objects are optional and are used to return a set of
segment boundary values in a predefined format. These segment boundary
values specify the ID for the first subscription in each segment of the
subscription set for the service.
When designing a segment information object, you must assign a prompt
object to be used to control the segment size. The Information Object
Wizard restricts your options at this stage, allowing you to select only
those reports that have the correct prompt objects.
For more information about the segmentation process, see Slicing and
segmentation.
Information objects
27
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
Not every document type (text, Excel) supports each information object
type. Specifically, text documents and Excel documents do not support
image information objects. However, HTML documents do support all
information object types.
When you insert a certain kind of information object (for example, a
MicroStrategy Grid report), into a document, the information object type
is automatically determined and you need not take any action other than to
follow the instructions to define the information object correctly. Thus,
you typically only need to be aware that different XSL stylesheets can be
chosen for XML information objects to change formatting, and that images
are not available in text or Excel documents.
The related information objects are listed for each document type.
Excel: MicroStrategy Grid reports, user information, subscription
information
HTML: MicroStrategy Grid and MicroStrategy Graph reports, user
information, subscription information
Imported: These are containers for imported files and do not use
information objects
Text: MicroStrategy Grid reports, user information, subscription
information
Additional kinds of information objects might be available if your system
administrator has added a different kind of information source. For
example, an ODBC information source might allow for a database query
information object. These additional information objects will only be
available in the appropriate types of documents.
28
Information objects
29
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
30
In addition, you can create your own user information properties that can
be personalized by end users through the Subscription Portal and inserted
into message contents. Do this by selecting Edit User Information
Available from the Tools menu in Narrowcast Administrator. This user
information property now appears on the Insert menu in the document
editors along with all the other user information properties.
You can combine user information with data from other information
objects by inserting the desired user information into a document element
with another information object such as a MicroStrategy report and using
a stylesheet to format the combined data from both sources. You can also
combine multiple pieces of user information and format them as desired by
selecting the Custom Combination option and using stylesheets.
Subscription information
Narrowcast Server also provides the ability to insert information about the
subscription that is being processed. This is typically used for message
tracking purposes such as inserting a unique message identifier into a Web
hyperlink to track which messages have been viewed or inserting other
information such as address or subscription ID into message contents.
Another example is for use with pagers, wherein a pager company requires
that a PIN be inserted in the message subject. The format required is shown
below:
To: name@company.com
Subject: <PIN number of my pager>
The following subscription information is available by default in
Narrowcast Server:
Address ID
Address Display
Device ID
Locale ID
Physical address
PIN
Subscription ID
Subscription set ID
User ID
All subscription data
Unique message identifier
31
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
Personalization
In MicroStrategy Narrowcast Server, personalization refers to the process
of providing different content to different subscribers within the same
service execution by having information objects return content that is
tailored for each user. The use of personalization in Narrowcast Server
enables the following functionality:
Users can provide their preferences and receive only the information
that is relevant to them.
Administrators can control user access to information and prevent users
from accessing sensitive information.
Narrowcast Server can gather information from external sources using
the identity of individual users to integrate with the security features
of external systems.
Personalization can be defined either after creating an information object
or by creating and selecting a question object.
Types of personalization
In MicroStrategy Narrowcast Server, personalization of dynamic content
exists in four forms: preferences, authentication, security, and locale
selection.
Preferences allow users to define the information they want to receive.
For example, a user might specify that he wants to receive weather
information for Boston. Note that preferences can be defined at the user
level or for individual subscriptions. Preferences defined at the user
level are applied by default to all services to which the user subscribes,
while preferences defined at the subscription level can only be applied
to a specific subscription. Subscription preferences always override
user preferences if both are defined. Preferences are defined by
providing answers to either an information object or a question object,
which can contain a set of questions. For this reason, information
objects and question objects are sometimes referred to as personalized
objects in Narrowcast Administrator. Answering these questions
specifies the information the user wants to receive. A user can define
preferences for all available personalized objects. For example, a user
might provide preferences for a What City? question object and a
What Item? prompted information object. For detailed information
about the type of preferences defined for a user, see User and
subscription preferences.
32
Personalization
33
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
multiple subscriptions so that the same question object does not need to be
answered multiple times. Subscription preferences cannot be reused for
other subscriptions.
Advanced techniques
User and subscription preferences can be defined in their simplest form by
answering the prompts within an information object. However, in some
cases this results in a less than ideal application design.
For example, suppose you need five reports that contain a prompt object
on region and some other prompt object. You obviously cannot reuse the
same information object since the report is not the same. However, when
users define preferences, they will be forced to answer the same which
region prompt five times.
Furthermore, suppose you create a service with an information object
prompting on region, then suppose you have your entire user population
provide preferences for this information object. Now suppose you need to
change the report to a different report which still prompts on region. You
certainly do not want to lose preferences for all your regions.
Question objects provide solutions to this kind of problem by providing an
independent template for which users can define their preferences. This
section explains how to use question objects.
34
Question objects
It is important to understand why question objects exist and how they are
helpful. A question object allows the structure for providing preferences (a
set of questions) to exist without linking this structure to any one specific
information object or requiring any specific information object to exist
without changing. This is powerful because it allows users to:
Define preferences that can be reused across multiple information
objects
Define their preferences and maintain those preferences even if an
information object changes
Thus, if the concept of a question object did not exist, and the structure
required for user preferences was always stored within information
objects, users would not be able to ensure their preferences were reusable
across multiple information objects or maintainable as application designs
change.
Prerequisites
Personalization
35
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
Other considerations
If two subscribers have the same personalization and are subscribed to the
same service, they do not necessarily receive the same content. This is
because there are two other ways to control the content that subscribers
receive. Personalization, as described above, refers to different ways to
control how information objects return information. In addition, it is also
possible to control which content users receive and thus which
36
information objects are executed for each subscriber. This can be done
through the use of locales and devices. Thus, five factors control what
information subscribers retrieve when a service is executed in
MicroStrategy Narrowcast Server:
Preference
Authentication
Security
Locale
Device
As noted above, personalization controls how information objects are
executed and is determined by a users preference, authentication, security,
and locale. Locales and devices impact the content subscribers receive
differently than preference, authentication, and security definitions.
Locales and devices control which publication is executed to deliver
content for a given subscriber and hence which information object is
executed.
This has to do with the way users describe the type of information they
want to receive and the type of information that services are designed to
provide. On the user side of the equation, each user selects one locale for
which the user wants to receive content, and each address is defined for
one device on which the user wants to receive content. In the service
design, each service can contain multiple publications, and each
publication is designed to support only one locale and a specific set of
devices. In addition, each publication has its own content and can either
share documents or information objects, or have independent documents
and information objects. During service execution, publications are
delivered to subscriptions based on the locale and devices supported by the
publication. Therefore, different subscribers receive content from different
information objects if:
A service contains multiple publications supporting different locales
and devices,
The publications contain different information objects, and
A service contains subscriptions for these different locales and devices.
To fully understand personalization, it is necessary to understand how
question objects and information objects work.
Personalization
37
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
38
Information sources
If security is defined using a security object prompt on an SAPbased attribute, then personalization for content using that
information source must be defined using attributes from the
same SAP dimension. For more information on SAP BW, see
the Desktop MicroStrategy Advanced Reporting Guide.
Once the security object prompt and default security object have been
selected in the information source, it is necessary to properly design
information objects and question objects, if created and used, to support
security.
39
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
40
object and question object depends on which of the two roles for security
you want to achieve. These roles and their requirements for information
objects and question objects are described in the following sections.
41
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
42
Once an information object and question object have been created and
contain the appropriate prompt objects, the question object must be
associated with the information object.
The security object (either at the user or information source level) must
be defined for information objects that contain the security object
prompt. This ensures that it is applied whenever the information object
is executed, whether or not users define any preferences. However, the
information object must contain the security object prompt. A few
potential scenarios related to this functionality are worth considering.
For each of the scenarios below, the information object and question
object associated with this information object contain the same prompt
objects as described below.
A security object can also be used to limit the choices available to users
when they define their preferences. In other words, the security object
definition for a user can limit the choices available to the user when
43
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
Once the information source, information objects, and question objects are
properly defined to support security, it is necessary to set security for each
user. Do this by defining security objects for users within the Subscription
Book or Static Subscription Set Editor. Note that unlike preferences,
security can only be defined at the user level, and not at the subscription
level. Remember that security objects are only applied if they are defined
before a users preferences are defined. If users define their preferences
before a security object is defined, the security object is not applied for
these users.
To learn about...
...tasks involving publications, information objects, and related objects,
see the following topics in the How Do I...? section:
Creating Information Objects and Question Objects
Creating Publications and Content Section Documents
...the editors and wizards used to create and edit publications and their
related objects, see the following topics in the Interfaces section:
Excel Document Editor
Imported Document Editor
HTML Document Editor
Import File Dialog Box
Information Object Wizard
Plaintext Document Editor
Publication Wizard
Question Object Dialog Set
To learn about...
45
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
46
C H A PT E R
Working with
Documents
3.
C
O
N
C
E
P
T
S
HTML documents
Narrowcast Server allows application designers to leverage the full power
of HTML to create beautifully formatted messages with individually
personalized data and formatting. Using the Narrowcast Server HTML
Document Editor, an easy-to-use HTML authoring interface, you can enter
text, define formatting, add images, provide personalized user
information, and insert information objects, such as MicroStrategy reports,
quickly and easily. However, HTML documents also offer a number of
advanced, more subtle features. This section provides instructions to use
Narrowcast Server to deliver high-quality, full-featured HTML content.
47
C
O
N
C
E
P
T
S
HTML templates and for making simple changes. This mode is opened by
default unless you have added information objects that are inserted into
HTML tags and, hence, are not rendered and displayed in the Editor mode.
The second mode is the Preview mode. This mode is similar to the Editor
mode except that it shows your HTML content exactly as it will appear in
Microsoft Internet Explorer Web browsers and it does not allow you to
modify the HTML content.
The third mode is the Source mode. This mode provides direct access to
the HTML source. This mode is displayed by default if you have inserted
information objects into HTML tags such that, as a result, the information
objects can only be displayed in this mode. This mode is powerful because
it provides direct access to the source HTML and using which you copy
and paste HTML templates that were developed in external tools or
provided by other parties such as a graphics department. In this way,
complex template files can be created in the preferred HTML authoring
tool and added to Narrowcast Server to add personalized formatting and
dynamic content.
48
3.
Once this is done, edit the document elements and select the desired
XSL stylesheets and apply the desired error handling conditions.
For more information on document element error handling, see Error
handling.
HTML documents
49
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
Helpful techniques
Several techniques are listed below.
Using tables to control the layout of information objects
within the HTML content
50
Edit the HTML source and add an image link referring to the correct
file name but without any file path.
To see an example of how this works, edit a message with a MicroStrategy
Graph report using a text editor (drag Service 1a onto Notepad). Find the
image link for the Graph report (search for src) and then find the image
with the name (now converted to a long stream of letters and numbers) at
the end of the message.
Using information objects within HTML tags
For this technique, information objects are used such that the information
object results are not rendered directly as content but rather control how
the HTML functions to render content. One example of this is the use of
report data to personalize image links as discussed above and illustrated in
MicroStrategy Tutorial for Narrowcast Server Service 3b. A second
example is the use of subscription information in links to provide
recipient-level read message tracking. In this case, a unique message
identifier is inserted into an image link (or Active Server Page or Java
Server Page link) on a remote server. The inclusion of this unique message
identifier allows the Web server to determine which messages have been
opened and to log this information to a relational database where it can be
joined with recipient-level delivery status information logged using
transmission recording.
For more information on transmission recording, see the Recording
transmission information section in the Administering Systems chapter of
the Narrowcast Server System Administrator Guide. For more information
on inserting unique message identifiers into message contents, see the
Service 3a Customer Significant Buyer Retention section and the
corresponding content in the Narrowcast Server Getting Started Guide.
HTML documents
51
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
Excel documents
MicroStrategy Narrowcast Server can leverage the full power of Microsoft
Excel 97 or 2000 by including Excel content within services. As with other
forms of content in Narrowcast Server, Excel workbooks are delivered
using documents. As a result, any delivery method that supports Excel
documents, such as E-mail (SMTP), Wireless (SMTP), or Web (Portal),
can deliver Excel documents. This section introduces you to the
capabilities that can be achieved using Excel workbooks in Narrowcast
Server and provides tips for getting the most out of your Excel
implementation.
General strategy
To use Excel workbooks with Narrowcast Server, you should first
understand how Narrowcast Server uses them. Narrowcast Server Excel
documents first start with a template file that is created by importing an
Excel workbook from outside of Narrowcast Server. Narrowcast Server
can then insert static text or dynamic content, such as grid reports, into this
template file.
The true power of Narrowcast Server is its ability to preserve all aspects of
the original template file while only modifying the data values and the cell
formatting on specific cells. Thus, you can generate complex, highly-
52
Excel documents
53
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
54
C
O
N
C
E
P
T
S
Excel documents
55
C
O
N
C
E
P
T
S
A hyperlink behind each of the EIS buttons enables one-click access to any
of the three available sheets. This is illustrated in the tutorial services in the
attachment in Service 1a.
56
C
O
N
C
E
P
T
S
For example, the user would see the following screen after clicking the
Sports Equipment button:
Excel documents
57
C
O
N
C
E
P
T
S
58
This table is not easy to work with because the data is not cross-tabulated,
meaning that it is not grouped in any meaningful way. Excels pivot table
functionality can be used to cross-tabulate the data in a way that makes it
understandable.
In the example below, a pivot table has been sent to the end user which
groups sales by day of week for every state and class of item. Additionally,
one or more stores can be selected from the Store drop-down list, which
then adjusts the totals within the cells to reflect sales for the selected stores.
The end user can easily refine the pivot table by selecting those attributes
that should be used as filtering criteria. The pivot table below allows
filtering across multiple dimensions simultaneously, as determined by the
user. The key is that this method provides users access to actual data on
which they can perform any additional offline analyses they require.
However, the benefit of Excel is that, unlike in many business intelligence
interfaces, the data is provided in an extremely common easy-to-use
interface with which most end users are already familiar. This reduces
training costs and deployment times significantly.
Excel documents
59
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
In the above example, the user is looking at the data for basketball sales at
the Greenville store, and is in the process of switching to the Greenwich
store. With pivot tables, it is easy to give the end user the ability to add or
remove levels of detail from a report and provide substantial analytical
power with minimal complexity.
Pivot tables require very little code; refer to the Excel documentation for
more information.
60
Once a macro has been recorded, it can be associated with an Excel event.
While this continues the automatic chart example, the principles apply to
any situation in which macros need to be run.
Macro source code can be viewed and edited via the Tools, Macro, Visual
Basic Editor menu item in Excel. All macros are contained in module
folders, which can be opened by double-clicking them. For more
information about using macros in Microsoft Excel, see Associate a macro
with an event in Microsoft Excel.
Creating automatically-executed macros
Excel documents
61
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
This macro does not have to be run each time the workbook is opened. By
running this macro once and saving the workbook, the altered formatting
for column C is saved.
62
Error handling
Error handling for Excel documents is set in the following locations: the
Document Element Properties dialog box within the Excel Document
Editor, the Error Handling area of the Document Properties dialog box,
and the Excel Document Formatter. It is important to understand the
differences between the two locations in Narrowcast Administrator that
control error handling for the execution of Excel documents with dynamic
content.
Document Element Properties dialog box within the Excel
Document Editor: These settings control the execution of specific
document elements and handle errors in creating properly imported
document elements. For example, these settings apply when no data is
returned by an information object, if an information object returns an
error, or when there is a problem formatting document elements
correctly. Thus, these errors occur when creating a document element,
and apply to a specific document element but not to an entire Excel
document.
Excel documents
63
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
Text documents
Due to the nature of text content, working with text documents in
Narrowcast Server is often less involved than working with either HTML
or Excel documents. As with HTML and Excel documents, using the
Plaintext Document Editor, you to insert dynamic content such as
MicroStrategy reports or user information. However, information objects
used in text documents must be in text or XML format, since information
objects in image format, such as MicroStrategy Graph reports, are not
supported. You can also cut, copy, and paste text from within the document
editor or from other sources. This is useful, for example, if you have a text
template that you want to use as the basis for your text document.
However, other advanced functionality associated with HTML and Excel
documents, such as viewing different modes in HTML documents or
working with Excel macros, does not apply due to the nature of text
content. You should, however, ensure that the length of text messages is
less than the maximum allowable character length for the types of devices
you want to support. For example, most SMS providers and most wireless
devices allow only a very limited number of characters to be delivered.
Despite the relative simplicity of working with the Plaintext Document
Editor, it is important to understand how Narrowcast Server devices can be
used to ensure that text messages are formatted correctly for all end user
64
Text documents
65
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
You can also specify the width (typically in pixels) for each character
that might be shown on a device. By choosing characters that show up
as blank or similarly (for example, the underscore character) and that
have a variety of widths, you can enable Narrowcast Server to
approximately align the data in each column of grid reports. This,
combined with the use of text-registration characters such as Tab, can
ensure that the data in each cell of a column aligns correctly for a tabular
report. As the capabilities of devices differ widely, not all devices
support either text-registration or cell padding.
When using cell padding for either fixed width or proportional fonts, you
should ensure that characters used for cell padding will be interpreted as a
non-breaking spaces. The reason for this is that some receiving devices
compress repeated white space characters such as the Space character
(ASCII 32), the Carriage Return character (ASCII 13), and the Linefeed
character (ASCII 10) into a single Space character. They might also break
lines at white space characters so that table rows are continued on the next
line. To avoid these problems, ensure that the character used for cell
padding is interpreted correctly as a nonbreaking white space. Many
character sets use the character ASCII 160 as a nonbreaking space. If this
character is not interpreted correctly, and you do not know which
characters would be interpreted correctly by the intended character set,
trial and error can be used to determine which character to use as a
nonbreaking space character.
Finally, Narrowcast Server devices enable string substitutions. String
substitutions can be used to avoid characters that are not supported by
certain devices. For example, some devices do not support ASCII
characters 13 (CR) and 10 (LF). As a result, when these characters are used
in text documents, you can replace these characters and use alternate
characters for devices that do not support these characters.
For more information on character sets, see the Narrowcast Server System
chapter in the System Administrator Guide.
66
Imported documents
Imported documents allow you to import various types of files into a
Narrowcast Server system from the Microsoft Windows file system for use
in Narrowcast Server services. These files are imported manually by the
Narrowcast Server system administrator or application designer and are
delivered as static content, which is not personalized or retrieved from
outside Narrowcast Server at the time services are executed. When
creating imported documents, it is important to correctly define the
imported file used by the imported document. First, you must set the file
type correctly so that the file is identified correctly when it is delivered by
the information transmitter. For example, for e-mail delivery, the MIME
type is determined by this setting.
You must also ensure that the correct character set is chosen when the file
is imported into the Narrowcast Server system. Files can be stored in the
Windows file system in a number of different character sets, but files are
always stored in the Narrowcast Server system using the Unicode
character set. As a result, Narrowcast Server must know from which
character set to translate the document into Unicode. You should always
select the character set that was used to create the document, which is
typically the default language for the machine on which it was created. For
the United States and most Western countries, this is the Latin1 character
set.
For more information on locales and character sets, see the Locales section
in the MicroStrategy Narrowcast Server chapter of the Narrowcast Server
System Administrator Guide.
Desktop documents
Using Narrowcast Server, you can take advantage of the following fullyformatted documents created in MicroStrategy Desktop:
Report Services documents include both static items such as lines and
images, and dynamic items such as fields, columns, grids, and graphs
that make up the data of a report.
HTML documents are the standard containers in MicroStrategy
Desktop for formatting, displaying, and distributing reports on the same
page or at the same time within a project.
In Narrowcast Server, you can create links to these documents and then
include them in your services. You cannot open or modify them from
within Narrowcast Server. But you can create the links from anywhere in
Narrowcast Server that documents are created, including Narrowcast
Imported documents
67
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
The export formats you can select in Narrowcast depend on the export
formats set while creating the document. For details to define export
formats for a document, see the Report Services Document Creation
Guide.
68
69
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
70
71
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
72
In the report, if the metric is used in the rows, then the Metric
column is not removed by using the
MSTR7ToHTMLOverlapGridTitles.xsl stylesheet described
above.
73
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
74
75
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
Text documents
76
77
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
results in most cases and provides consistency with Narrowcast Server 7.2
and previous versions. (An alternate XSL stylesheet is available that
provides the ability to fit reports to the entire available window.)
For Excel documents, you can either use column widths defined in the
Excel template file (as is possible in Narrowcast Server 7.2 and previous
versions) or use column widths defined in the report. You can set this in the
document properties within the Excel Document Editor. If the XSL
stylesheet does not support column widths (for example, if stylesheets are
not upgraded), the column widths defined in the Excel template are always
preserved. If two different reports occupy the same column or row in an
Excel sheet, the Excel column width or row height is set to match that of
the largest report column or row occupying this space.
Implications for upgraded systems
For systems upgraded from Narrowcast Server 7.2 and previous versions,
an option is provided during upgrade to either upgrade and use the new
default XSL stylesheets or to maintain existing versions. Existing versions
should only be maintained if you have customized these stylesheets. If you
do choose to upgrade these stylesheets, column widths are preserved by
default, and the following stylesheets are upgraded to the latest versions
and applied by default:
MSTR7ToHTML-DefaultFormatting
MSTR7ToExcel-DefaultFormatting
The original stylesheets are backed up as follows and are not applied to any
documents:
72_MSTR7ToHTML-DefaultFormatting
72_MSTR7ToExcel-DefaultFormatting
If you do not upgrade these stylesheets, column widths are not preserved
by default, and the following new stylesheets, which do preserve column
widths, are added to this system but are not applied by default:
721_MSTR7ToHTML-DefaultFormatting
721_MSTR7ToExcel-DefaultFormatting
78
79
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
80
C H A PT E R
4.
User Management
C
O
N
C
E
P
T
S
81
C
O
N
C
E
P
T
S
The login ID is a unique string that can be used to identify a user. The login
ID is displayed in the Subscription Book and Subscription Set editors and
can be used as a login for self-subscribing interfaces. Login IDs must be
unique, which makes user management easier.
Password
It is possible for users to expire. If a user has an expiration date, the user
stops receiving services after the expiration date has elapsed.
82
Locale
Status includes three settings: active, inactive, and invalid. The settings
identify whether a user can receive services. If a user is inactive or invalid,
no services are sent to any addresses for this user.
Addresses
An address tells MicroStrategy Narrowcast Server how to send services to
a particular subscriber. Each address can be associated with one and only
one user, and a user can have multiple addresses. The address properties
are as follows:
Address name
Physical address
Address display
Delivery method
Device
PIN
83
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
Status
Expiration date
Delivery window
An address is added to subscription set to create a subscription to the
chosen service.
Address name
The address name is used to identify an address for a given user. The
address name is displayed in the Subscription Book and Subscription Set
editors. Although address names do not have to be unique for a given user,
it is preferable to keep the address names unique for a given user to
facilitate administration.
Physical address
The physical address is where the service is sent when using this address.
For example, in e-mail services, this is an e-mail address such as
yourname@yourcompany.com. For SMS services, the physical address
is a mobile devices telephone number such as 44.1753.8261.00.
Address display
The address display is used when sending services to devices that support
a recipient display name. For example, in e-mail services, the address
display is what appears in the To: field, such as Last Name, First
Name. Address display is not currently used for SMS services.
Delivery method
84
Status includes three settings: active, inactive, and invalid. The settings
identify whether an address can receive services. If an address is inactive
or invalid, no services are sent to this address.
Expiration date
The delivery window specifies when this address can receive messages. It
specifies the hours each day during which messages can be transmitted to
the address. The time zone specifies which international time zone should
be used as a reference for the selected times. Time zones take regional
customs such as daylight savings into account. If a service is executed
outside a recipients delivery window, the recipient does not receive a
message for the service execution.
Governing
Governing is used to restrict the number of items that are retrieved when
you open the Subscription Book. This allows Narrowcast Server to work
more efficiently when you have a large subscription book and do not want
to risk long waiting times when you open it. Governing can be set for both
users and addresses. For example, if you set a limit of 5,000 users to
retrieve for the Subscription Book and 10,000 users are in the Subscription
Book, only the first 5,000 are retrieved. Governing can be used in
conjunction with filtering to restrict the items that are retrieved.
Users and addresses
85
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
Subscriptions
A subscription is a request to Narrowcast Server for a user to receive a
certain service with a certain personalization and at a certain address. It is
created when a users address is subscribed to or added to a subscription
set. A user receives a particular service by subscribing to a subscription set
used by the service. Subscription data for static subscription sets is stored
in the Subscription Book.
Subscriptions have the following properties:
Status
Expiration date
Subscription Preferences
Transmission
Notification
Status
Status includes three settings: active, inactive, and invalid. The settings
identify whether a subscription can receive services. If a subscription is
inactive or invalid, no services are sent to the subscription.
Expiration date
When you create a file or print service, you have the option to send
notification through e-mail when the service has been delivered.
87
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
88
89
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
Delivery window
Time zone
Transmission properties
Personalization
When you create dynamic subscription sets, an information object is
defined to return subscription information from an external source. As a
result, your job is to ensure that any required data exists in the external
source (for example, you cannot assign user devices if device information
is not in the desired source), and to map this information to the appropriate
subscription properties required by Narrowcast Server for service
execution. Since Narrowcast Server has an open architecture, any
information source can be used to return subscription information and the
application design process for mapping external information to
subscription properties will be information source-specific. When
subscription information is available in a MicroStrategy project, the
MicroStrategy information source can be used to map attribute forms in the
desired project to the subscription information used by Narrowcast Server.
To do this, edit the MicroStrategy information source for the desired
project and select the check box to support dynamic subscriptions. You can
then select an attribute form, apply a constant, or use information in the
Subscription Book for the required subscription properties. You can select
more than one item for each property, such as providing content for testing
purposes and selecting two different attribute forms for e-mail addresses
that might be applied. For steps to edit the information source using the
Information Source Wizard, see the Information Source Wizard chapter of
the Narrowcast Server System Administrator Guide.
You can use constants for all properties other than Subscription ID; use
blank constants for Transmission Properties and PIN. Subscription ID,
User ID, and Address ID can all use the same attribute form. You should
not elect to use information in the Subscription Book unless you have
designed your Subscription Book and MicroStrategy project such that
Subscription IDs are synchronized between the two.
Once you complete this mapping, these properties are available whenever
you define a subscription information object for this information source. If
you have chosen more than one item for any property, you can choose
which item you want to use for this subscription information object. Thus,
the information source makes a group of properties available for future
use, and the subscription information object determines which items to use
for a specific subscription set. When defining the information object, you
can also select an optional filter. This filter limits the subscriptions
returned for the subscription set.
90
91
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
For the latest information on the certified databases for pre- and
post-SQL, refer to the Narrowcast Server section of the
MicroStrategy readme file. To access the MicroStrategy readme
files, from the Windows Start menu, point to Programs, then to
MicroStrategy, and then choose ReadMe.
92
When you make the selection for an empty result set to cancel a
service, this is logged as an information-level message but not
as an error. However, whenever a SQL error is used to cancel a
service, this is logged as an error. To avoid logging an error
when services are cancelled using pre-SQL, you must select this
check box to stop the service if no data is returned and design
your SQL query to return no data when services should be
cancelled.
The pre- and post-SQL statements can contain multiple statements that can
be executed against multiple databases. A SQL statement definition
contains the following information:
Name: name used to identify the SQL statement
Connection information: data source name (DSN), user ID, password,
and database (optional) to be used when connecting to the database
against which the statement is executed
Requirement: whether the execution should stop if the execution
returns a false condition
The SQL statements can also be personalized to contain information about
the service being executed. By using the macros described in the table
below, SQL statements can be written such that they vary based on the
execution.
Variable
Macro
Description
Datatype
Maximum Width
External service
execution ID
\E
char, varchar
32 characters
Service execution ID
\F
char, varchar
32 characters
93
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
Variable
Macro
Description
Datatype
Maximum Width
Service ID
\S
char, varchar
32 characters
Execution priority
\P
integer
Service execution
timestamp
\C
date-time
Service expiration
timestamp
\R
date-time
Subscription Set ID
\D
char, varchar
32 characters
Current timestamp
\T
date-time
\\
Escaped character
char, varchar
1 character
94
95
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
Synchronize users
Synchronizing users is useful for updating existing users and addresses
when information for these users and addresses has changed outside of
Narrowcast Server. The following tasks are involved:
Adding new users
Deleting obsolete users
Remapping users
When new users are found in the synchronization file that are not found in
the Subscription Book, those users can be added or remapped to other
users. Similarly, users who no longer exist in the synchronization file can
be removed from the Subscription Book or remapped to new users in the
synchronization file. Thus, new users can be mapped to obsolete users no
longer in the synchronization file. For example, if a user name has changed
so that a different distinguished name results in the synchronization file,
the user should still maintain all subscriptions and have the same
preferences.
96
97
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
Click Next.
Synchronization Options page
3.
In the File Location box enter the full path to the provided sample
file SynchronizationTutorial1.ldif.
4.
4.
1.
Note that three new users from the synchronization file appear in the
Add Users list.
2.
Click Next.
1. Note that any existing users in the subscription book appear in the Do
Not Remove Users list.
98
2.
Click Next.
Review page
1.
Note that the three new users appear under Users to Add.
2.
Click Next.
Finish page
1.
2.
Click Finish.
Narrowcast Administrator
1.
2. Edit the users that have been added by the Subscription Book
Synchronization Wizard and note their properties.
After the synchronization process
Edit the LDIF file and study its structure. Note how the attributes present
in the file correspond to the users and user properties created during the
synchronization process.
99
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
Click Next.
Synchronization Settings dialog box
4.
5.
100
8.
Change the File Location box to the full path of the second sample
LDIF file: SynchronizationTutorial2.ldif.
9.
5.
Subscriptions page
1.
Click Next.
101
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
1. Note that the user Smith, Sarah appears in the Add Users list. She
has changed her name and, as a result, her distinguished name has changed
in the synchronization file. It is desirable to preserve this user and all
associated properties in the Subscription Book and remap the new Sarah
Smith to her previous identity Sarah Brown. To do this, click her name
and the click the lower arrow button to move her to the Make Users
Available for Mapping list.
2.
Click Next.
1.
Note that the user Brown, Sarah now appears in the Do Not
Remove Users list. Click her name and then click the lower arrow button
to move her to the User Mapping list.
2.
In this list, click the right column of the row that has Brown, Sarah
in the left column and select her new name Smith, Sarah. This remaps
the Sarah Brown user in the Subscription Book to this new user Sarah
Smith in the synchronization source. As a result, any preferences,
subscriptions and other properties defined in the Subscription Book can be
preserved, but the mapping to the external source is not broken. This
allows future updates while preserving any changes made in the
Subscription Book.
3.
Click Next.
Review page
1.
Click Next.
Finish page
1.
2.
Click Finish.
Narrowcast Administrator
1.
2. Edit the subscription sets SubSet1 and SubSet2 and verify that new
subscriptions have been added.
102
Edit both LDIF files and study their structures. Note how the attributes
present in the files correspond to the actions that were taken during
synchronization and in the final results in the Subscription Book and
subscription sets. Note especially the new addresses that are present in the
second file and how certain attributes are used to indicate which users
should be subscribed to which subscription sets.
103
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
104
C H A PT E R
Alert-Based
Applications
5.
C
O
N
C
E
P
T
S
105
C
O
N
C
E
P
T
S
106
In some cases, the data in the data store must be updated once the
service has been delivered to acknowledge that the recipients have been
sent the alert information. This data store update ensures that the
Narrowcast Server does not send duplicate alert notifications (post-service
execution SQL functionality).
107
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
the service (as described in step 2 in the process flow) or (b) have the
service itself check some condition in the data warehouse and execute the
service only if that condition is met (as described in step 3 in the process
flow). Narrowcast Server can use pre-service execution SQL to check for
alerting conditions in any data warehouse before a service is executed.
Narrowcast Server can be scheduled to check for alerting conditions at a
minimum time interval of every minute. If the requirements demand
information delivery more quickly than within one minute of an event or
data warehouse load, the external system has to trigger the Narrowcast
Server service through the MicroStrategy Narrowcast Server API.
108
109
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
110
111
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
2.
Insert a value into this table using SQL such as the following:
3.
112
4.
C
O
N
C
E
P
T
S
exec SProcedure
5.
113
C
O
N
C
E
P
T
S
114
The RunService function accepts string input for the service identification
(ID) and the subscription set ID, and then executes the service. To get the
service ID and the subscription set ID for a specific service and
subscription set, a query can be run against the Narrowcast Server
Repository such as the following:
Application design for alert-based implementations
115
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
116
117
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
object would return no data and the document would fail. In the
Publication Wizard or Service Wizard, you must indicate that the
document that contains the alert information object is required for this
publication. Thus, when the document fails, the publication fails to be
delivered to any recipients for which the information object returns no
data.
Dynamic subscriptions
should receive an alert notification. Also, any prompt object that can be
created in the MicroStrategy Desktop interface can be used in Narrowcast
Server to personalize the messages that are generated.
In many implementations, the use of dynamic subscription services
requires the collection of information from end users. For example, it is
necessary to know information such as under which conditions or
thresholds they would like to receive a message (for example, user John
Smith would like to be notified if a stock goes up or down 20%). This
information needs to be stored in the data warehouse since it is used in
conjunction with other information in the data warehouse (for example,
stock movement information) to determine which recipients need to
receive the dynamic subscription service. For example, to know whether
to send an alert to John Smith it is necessary to perform calculations based
on both John Smiths alerting criteria and the current and historical stock
prices. To get this alert threshold information into the data warehouse, the
Narrowcast Server Subscription Portal provides support for dynamic
subscriptions. Thus, Narrowcast Server Subscription Portal can write user
information directly into the appropriate table in the data warehouse. This
is powerful functionality as it enables a wealth of alert-driven information
services that were not supported with the MicroStrategy Broadcast Server
6.x platform. This dynamic subscription process is discussed further in
chapter 9, Advanced Subscription Portal Configuration.
119
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
You can use the post-service SQL to clear out the snapshot table and
perhaps put an indicator that it can be used again into another table. This
is useful if you have a fixed number of snapshot tables, and want to ensure
that a long-running service does not have its snapshot table overwritten in
the middle of service execution by a subsequent run of the same service.
120
Summary
MicroStrategy Narrowcast Server implements a number of features that
enable alerting functionality. These features support a wide variety of
requirements and uses. If the event status exists in the database or an
external application, it is probable that MicroStrategy Narrowcast Server
can support the required alert-based service.
Summary
121
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
122
C H A PT E R
Page Personalization
and Dynamic
Subscriptions
6.
C
O
N
C
E
P
T
S
Introduction
Personalized page execution
Personalized page execution allows Narrowcast Server to retrieve
personalized content for many subscriptions at once by executing a single
report. Personalized page execution is now supported for consolidation in
the page-by field and for Report Services documents in Flash format. To
understand the significance of this, it is important to understand that
Narrowcast Server can gather MicroStrategy reports in one of two ways:
personalized report execution or personalized page execution. When using
123
C
O
N
C
E
P
T
S
It is important to note these two methods do not only differ in the way
reports are retrieved, but also in the way recipients provide
personalization. For personalized report execution, recipients indicate
their preferences by answering one or more prompts, while in personalized
page execution, recipients indicate their preferences by selecting a specific
page of content. It is this key differenceone method of personalization
allows recipients to select part of a single report while the other allows
users to customize their own reportthat allows these two methods to
execute reports differently. One method, personalized report execution,
provides greater control over personalization since reports can be fully
customized using multiple prompt objects of any type, while personalized
page execution, provides limited control since recipients select which page
of content they would like to receive by selecting an attribute value from a
list of available attribute values that represent available pages.
Personalized report execution provides a flexible method of
personalization for basic use cases and also provides an easier application
design process. As a result, personalized report execution is selected by
124
Dynamic subscription
Dynamic subscription is a process that allows Narrowcast Server to
retrieve a list of recipients and related subscription information from an
external source such as a data warehouse. This is done by executing an
information object which returns some or all subscription information.
When used to gather subscription information stored in a MicroStrategy
project, a subscription information object can gather subscription
information from a MicroStrategy report or directly from attributes in the
project. This information from the data warehouse can then be used
directly or joined with information in the Subscription Book Repository to
define a subscription set. If the list of recipients changes, dynamic
subscriptions can be used for alerting applications by determining at the
time of service execution who should receive the service, and what alert
information they should receive.
To understand how personal page execution and dynamic subscriptions
can be used together, consider the case where the data warehouse holds
both subscription information, such as a subscription ID and a physical
address, and user preferences, for example, some attribute value which
indicates user preference, such as customer region. In this case, dynamic
subscriptions can be used to return both subscription information and
personalization from the data warehouse. This personalization information
can then be used to personalize information objects executed using
personalized page execution. This is beneficial because dynamic
subscriptions return a single attribute value for user preferences, while
information objects executed using personalized page execution require a
single attribute value to define preferences for each user.
Introduction
125
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
126
This can become a resource drain in the execution process which can slow
service execution. It can also consume a significant amount of system
resources on both the database and Intelligence Server machines.
Personalized page execution can remedy this problem by increasing the
efficiency of the service execution process.
Personalized page execution does this by executing one report that returns
content for all subscriptions in the segment that the execution engine is
processingdespite the fact that these subscriptions may have many
different personalizations. This can speed up the report execution process
since only one report request is made per segment.
Execution
Engine
One multipage report is
executed for all subscriptions
in a segment and then sliced
by the execution engine to
gather content for
subscriptions with different
personalization.
Execution
Engine
Intelligence
Server
127
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
128
Region ID
1
2
3
4
1
3
2
3
4
2
1
1
Report Content
A
B
C
D
Readers familiar with SQL will recognize that this is very similar to a
database join. Indeed, it can be thought of as a zero or one (result page) to
zero, one, or many (subscriptions) join that is performed in memory by the
Narrowcast Server. The allowance for the choice of which piece of
information from a subscription set is used to choose a page from the report
provides for a powerful Narrowcast Server feature. It enables different
pieces of content within a service to be personalized at different levels in
129
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
130
Distribution
Manager
Segment
Executor
Distribution Manager
passes only IDs for
subscriptions in each
segments to each
Segment Executor
Segment
Executor
Segment #1
Intelligence
Server
Segment #2
C
O
N
C
E
P
T
S
Subscription IDs
129857109235
Segment #1
298367102895
243523424535
145153451354
Segment #2
125145632365
125457625671
734756757868
Segment #3
457437568754
374373476347
375347347347
Segment #4
345623453254
356236234656
Segment Executor
gathers only content
for subscriptions in
current segments
from Intelligence
Server
Report Structure
Conceptual Result:
Multiple Pages
Segmentation processes
When a large subscription set is executed for a service, this represents a
potentially tremendous amount of work. For each subscription, content
must be gathered, formatted, and delivered. Each of these processes can
potentially take a long amount of time and can consume significant
machine resources. To allow this process to be scalable so that a large
number of subscriptions can be executed in a reasonable time, it is
necessary to divide this workload and distribute it across multiple
machines (called execution engines). As described previously,
Slicing and segmentation
131
C
O
N
C
E
P
T
S
132
133
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
134
135
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
136
Address ID
Address display
Physical address
Device
Transmission properties
PIN
Time zone
Delivery window
user information
User ID
Locale ID
137
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
138
139
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
140
Subscription ID requirements
The Subscription ID is significant among all other subscription
information because the Subscription ID is the attribute form that is used
to identify the list of subscriptions when dynamic subscriptions are used.
In addition, the Subscription ID is significant because this attribute form
may also be used to join subscription information in the data warehouse
with subscription information in the Subscription Book. (For example,
Subscription ID and physical address might be returned from the data
warehouse, while personalization and Device ID might be returned from
the Subscription Book.) As a result of these two roles, the requirements for
Subscription IDs vary according to how the Subscription ID is used.
If the Subscription ID is used to join information in the data warehouse
with information in the Subscription Book, subscription IDs from the data
warehouse must correspond to Subscription IDs in the Subscription Book.
It is important to note that Subscription IDs stored in the Subscription
Book Repository are always integers that start at a very large negative
number and are incremented by one for each subscription.
Thus, it is not possible to join data from the data warehouse to information
in Subscription Book Repository unless one of the following is true:
The Subscription Portal is used to create the Subscription IDs in the data
warehouse. This is discussed further in chapter 9, Advanced
Subscription Portal Configuration.
The data warehouse is integrated with the Subscription Book
Repository such that the same Subscription IDs are shared between the
data warehouse and the Subscription Book Repository.
Some external system is used to synchronize Subscription IDs between
the Subscription Book Repository and the data warehouse.
However, if all subscription information is returned from the data
warehouse and no information is stored in the Subscription Book, then
Subscription IDs in the data warehouse does not need to correspond to
Subscription IDs in the Subscription Book. In this case, the only
requirements on Subscription ID are that it is an integer value which is
unique for each subscription.
141
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
This is a very commonly used scenario and is the scenario used in most
basic use cases. Reports are personalized using prompts and subscription
information is stored in the Subscription Book. No subscription
information object is used and subscription information including
personalization information is stored in the Subscription Book and
returned in a static subscription set. One or more content information
objects executed using personalized report execution are then personalized
using the personalization information stored in the Subscription Book
Repository. Since information objects executed using personalized report
execution are personalized by answering one or more prompts, the
Subscription Book Repository is ideally suited to store answers to prompts
in XML format.
142
143
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
the report other than the page axis content is ignored. The content
information object must contain the slicing attribute as the first attribute on
the page axis. Each page on the report is used as a page of content for a
group of subscribers. The following image demonstrates proper report
design.
Subscription Information Content*
Subscription ID
Other subscription
information (physical
address, etc.)
144
C
O
N
C
E
P
T
S
145
C
O
N
C
E
P
T
S
This scenario is used less commonly than the other scenarios since
personalization for prompted reports is not typically stored in the data
warehouse. In this scenario, subscription information including
personalization is stored in the data warehouse. A subscription information
object is used to return subscription information including subscription ID
and personalization information. One or more content information objects
executed using personalized report execution are then personalized using
the personalization information returned in the subscription information
object. Since information objects executed using personalized report
execution are personalized by answering one or more prompts, the
personalization stored in the data warehouse must stored as prompts
answers in XML format. It is also important to note that the use of
Intelligence Server reports to return subscription information restricts the
length of the XML string returned. As a result, when this method is used,
you must take care to ensure that all XML stored in the data warehouse is
less than the maximum allowable length. Thus, since personalization must
be stored in a short XML format in a data warehouse, this scenario often
has limited practical use.
Required reports and report design
146
C
O
N
C
E
P
T
S
147
C
O
N
C
E
P
T
S
2.
6.
148
Click OK.
Choose only the tables from which the fact will be used in ranking.
This is likely the table with the most subscriber information, such as
LU_CUSTOMER.
149
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
3.
4. Create the Report Limit metric. This metric returns the first
subscription of each segment by calculating the Subscription IDs for which
rank number divided by the segment size has a remainder of 1.
150
Drag the same prompt into the parentheses after the comma.
5.
Click Modify.
151
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
Click OK.
6.
Create a new filter which limits the subscribers you want, for
example, Sub Set = X, Customer(ID) < 10 (for testing), MetricX>20.
7.
Update the project schema or the fact you created will not be
recognized and report execution will fail.
8. Run the report to verify that it functions correctly. When prompted,
enter a reasonable segment size (100 is the default for Services). Ensure
that the report returns a table of data such as the following (segment size
of 50 is shown):
1
51
101
151
152
153
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
154
C H A PT E R
7.
C
O
N
C
E
P
T
S
155
C
O
N
C
E
P
T
S
The Portal Administrator Wizard is the tool that provides full control over
the Subscription Portal configuration and allows you to create site
definitions, publish services and device types, and specify information
source properties and default portal preferences.
The following diagram illustrates the four panes available in the Portal
Administrator Wizard and the tasks that can be performed in each pane.
S ystem C onfiguration
S elect or create a
S ubscription P ortal
C reate or edit a site definition
S ite Preferences
S ervices C onfiguration
D efine channels
S pecify device types
S elect default devices
S elect device settings
C hoose inform ation source
settings
C onfigure other site
properties
P ick a service
C onfigure page-by questions
for static subscription sets
C onfigure page-by questions
for dynam ic subscription sets
S et storage m appings for
dynam ic subscription sets
Before you begin, you should be familiar with these basic concepts:
Subscription Portal system
Database connections
Site definition
Services configuration
156
Portal Repository
A Portal Repository is a specific set of tables defined by the Subscription
Portal, located in a database, and identified by a certain table prefix. The
tables for each Portal Repository can be given a unique table prefix, so that
multiple Portal Repositories can exist in the same physical database
instance. Each Portal Repository can store the definitions of one or more
sites. Multiple Subscription Portal systems can also share the same set of
Portal Repository tables.
Table prefixes for the Portal Repository
When you select the database connection that corresponds to the database
you will use for the Portal Repository, you can enter a table prefix that will
be used to prefix the names of all the Portal Repository tables in this
database. This is useful if you want to have multiple independent Portal
Repositories in the same physical database. If you are selecting a database
in which Portal Repository tables have already been created and you want
to reuse those tables, enter the same table prefix as the existing tables. If
you enter a table prefix for which Portal Repositories tables have not been
created, Subscription Portal creates those tables in the selected database.
Database connections
The first time you configure Subscription Portal, you must create a
database connection for each of the databases to which you will connect.
Subscription Portal connects to the following information repositories:
Portal Repository
Object Repository
Subscription Book Repository
These information repositories, which can reside in the same database or
separate databases, are described in detail in their corresponding sections.
Database connections
157
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
When you create a new database connection, the information entered is the
same for all the aforementioned repositories:
A name by which you want to refer to the connection you are creating
The type of the database (SQL Server, Oracle, DB2, or Teradata)
The name of the machine on which SequeLink is installed and running
The name of the ODBC DSN on the SequeLink machine that
corresponds to the database to which you want to connect
The login ID and password that the Subscription Portal should use when
it accesses that database
For steps to add new database connections in Subscription Portal, see
Adding Database Connections in Subscription Portal.
Table prefixes
Table prefixes are useful if you have multiple independent repositories in
the same physical database. If you are selecting a database in which tables
have already been created and you want to reuse those tables, be sure to
enter the same table prefix as on the existing tables.
This is always the case when selecting an Object Repository or a
Subscription Book Repository because Subscription Portal does not create
those tables.
When selecting a Portal Repository, if you enter a table prefix for which
tables have never been created, Subscription Portal creates those tables for
you in the selected database.
Site definition
A site identifies a set of services that are made available through a portal
for access by end users. A site is defined by a connection to a single Object
Repository and Subscription Book Repository.
In addition, the definition of a site contains a collection of channels plus a
set of properties that define certain characteristics of the Subscription
Portal. Since each site is associated with a single Object Repository,
multiple sites must be created to provide access to services in multiple
Object Repositories.
The definition of a site and its related channels is stored in a Portal
Repository. A site can only be made available to end users through a portal,
but multiple portals can provide access to the same site.
158
The properties contained within the site definition include the following:
Portal
Site name and description
Object Repository
Subscription Book Repository
Channels
Device types
Devices
Device settings
Information sources
Preferences
Portal
A portal defines the Web location (URL) through which end users access
Subscription Portal services and subscriptions. A portal is defined by a
Web server virtual directory and provides access to one and only one site.
Two or more portals can, however, provide access to the same site. This is
most typically done on different Web servers so that clustering can be used
to provide increased system performance for a high number of concurrent
users. The definition of each portal and which site it accesses are defined
and saved in the file system of the machine running the Subscription Portal
Web server.
Deleting a Subscription Portal
Deleting a portal means the site is no longer accessible through that virtual
directory. It does nothing to the site definition or properties that were
configured through the site. The site would still be available for viewing
through another portal, once that Subscription Portal has been configured
to point to the site definition.
Site definition
159
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
If you delete a site it does not delete the subscriptions users have created.
However, it cuts off access to those subscriptions. End users cannot edit,
add, or delete subscriptions from their list of services. Also, any portal
using the deleted site definition must be reconfigured to use a different site
definition.
Object Repository
The site definition includes the location of the Object Repository. This
information repository is created using Narrowcast Administrator and
stores services, documents, publications, scheduling information, and
device definitions.
If you edit the location of the Object Repository, you have redefined the
site definition, which means that services might no longer be available.
You might be better served to create a new site and point it to a different
database connection. The option to change the location of the Object
Repository after the site has been defined is most useful if the new
repository is an exact copy of the original repository.
For additional information about Object Repository properties refer to the
About Narrowcast Server System chapter of the Narrowcast System
Administrator Guide.
Table prefixes for the Object Repository
When you select the database connection that corresponds to the database
you will use for the Object Repository, you can enter a table prefix to prefix
the names of all the Object Repository tables in this database.
If you used a table prefix when creating the Object Repository tables
through Narrowcast Administrator, you must enter that same table prefix
here.
160
location of the Subscription Book Repository after the site has been
defined is most useful if the new repository is an exact copy of the original
repository.
For more information on the Subscription Book Repository refer to the
Microstrategy Narrowcast Server Architecture chapter of the Narrowcast
Server System Administrator Guide.
Table prefixes for the Subscription Book Repository
When you select the database connection that corresponds to the database
you use for the Subscription Book Repository, you can enter a table prefix
to prefix the names of all the Subscription Book Repository tables in this
database.
If you used a table prefix when creating the Subscription Book Repository
tables through Narrowcast Administrator, you must enter that same table
prefix here.
Channels
A channel is a grouping of services available to end users within the
Subscription Portal. Channels are created through the Narrowcast Server
Subscription Portal Administrator Wizard and deployed through the
Subscription Portal.
A channel is defined by a folder of services from an Object Repository.
Multiple channels can be defined within one site to group different sets of
services. Each channel appears as a tab in the Subscription Portal interface.
Each user subscription that is created through the Subscription Portal can
be accessed only through the channel through which it was created. A site
without at least one channel does not provide any functionality to end
users.
When a folder is selected in a Narrowcast Server system to define a
channel, this selection provides the structure of the channel in terms of
what services are available and how these services are arranged in
subfolders within the Subscription Portal. Each subfolder under the folder
chosen to define the channel appears as a folder in the Subscription Portal
and services are arranged within these folders just as they are within
Narrowcast Administrator. In other words, the folder structure and service
location in Narrowcast Administrator completely controls how services
are arranged and grouped within the Subscription Portal. Thus, application
design in Narrowcast Administrator should be carefully considered to
ensure that services are logically arranged into folders so that the channels
and their structure appears as desired in the Subscription Portal.
Site definition
161
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
Channel folders are the means by which services are grouped. Services
can be published at any level within the folder structure. End users
navigate through the Subscription Portal and select channel folders
containing the services to which they want to subscribe.
Channel name and description
Once a folder has been selected from the Object Repository, a channel
name and description must be entered. The name and description are
visible to the end user through the Subscription Portal.
Device types
In addition to defining channels, the portal administrator determines what
devices are available to end users when they create addresses. Narrowcast
Server can deliver content to a large variety of devices, and each service is
designed to deliver content to some subset of these devices such as desktop
e-mail clients or wireless devices. Thus, when users create addresses and
subscribe to services via the Subscription Portal, they must be allowed to
select devices that are supported by the services to which they are
subscribing. This is controlled by the portal administrator using device
types.
A device type is a grouping of devices defined in a Subscription Portal to
make it easier for a user to find a certain device. For example, all e-mail
devices are in a grouping called E-mail.
A device type is defined by selecting one or more folders of devices from
the Object Repository. Each service defined in the Object Repository
supports a specific list of devices. There is no need to allow users to create
addresses using devices that are not supported in any services in your
Narrowcast Server system.
162
Devices
A device is a format for receiving information content sent from
Narrowcast Server to the subscriber of a specific service. These formats
include settings such as Outlook 98, Outlook 2000, and a specific pager
brand and model. New devices can be added to your system using
Narrowcast Administrator.
Each address that a user creates in the portal is designed for use with only
one device.
Refer to the Configuring Machines chapter of the Narrowcast Server
System Administrator Guide for more information on devices.
Site definition
163
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
Device settings
Each subscription site can define which device is used as the device to
deliver content to the My Reports page and which device is used by
default when new addresses are created during subscription creation.
Default device
Information sources
Each Narrowcast Server system supports a set of information sources.
When Narrowcast Server connects to an information source to obtain
content information, it uses authentication credentials that are specific to
the information source. For example, when connecting to a MicroStrategy
project, Narrowcast Server needs a login ID and password for that project.
Narrowcast Server allows each user account to specify its own
authentication credentials for each information source. If an authentication
is specified for a certain user, that authentication is used for all connections
to the specified information on behalf of that user. The definition of each
information source also includes a default authentication that is used for all
connections of any users for which no user-level authentication has been
specified.
164
Using the Portal Administrator Wizard, you can specify whether user
accounts created through the Subscription Portal interface are allowed to
enter their own authentication credentials for each information source, or
if the default credentials for that information source should be used
instead.
For each information source, you can select from the following options:
Use Project Credentials
Use User Credentials (required)
Use User Credentials (optional)
Use Project Credentials
Site definition
165
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
user creating the account can choose to leave the login ID and password
blank, in which case the new account uses the default authentication
credentials as specified in the definition of the information source.
Preferences
The Preferences feature controls how the default values are set for users
of the portal interface. It includes settings for the following:
Enabling/disabling creation of new users
Selecting default user account expiration settings (Expired users no
longer receive messages from the services to which they have
subscribed.)
Designating default values for DHTML settings
Specifying the location of temporary files (Subscription Portal can
optionally create temporary files for performance purposes. If these
files are needed, you should periodically delete any files that have not
been cleaned up automatically. In most cases, temporary files are
deleted after a subscription is created. However, if a user cancels before
a subscription is complete, these files might not be cleaned up correctly
in all cases.)
Providing administrative contact information
Specifying available and supported user login modes
Specifying prompt governing settings
Additional information on these settings is included in the Interface section
of this book.
Login Mode
two ISA options is enabled, you need to enter the name of the
MicroStrategy Intelligence Server to be used for user authentication. Any
combination of the three login options (Narrowcast Server Normal,
MicroStrategy Intelligence Server Normal, or MicroStrategy Intelligence
Server NT) can be enabled together or independently.
Depending on which of the three login modes are enabled, the Subscription
Portal login page is modified to reflect the available options. If either
Narrowcast Server authentication or MicroStrategy Intelligence Server
Normal, or both are enabled, the login page shows text boxes for login ID
and password, and a login button. If NT authentication is enabled, a link is
displayed along with the text boxes and the login button.
For example, the user types in a login ID and password and clicks Login.
If MicroStrategy Intelligence Server Normal is enabled, the Subscription
Portal passes the credentials that the user entered to the MicroStrategy
Intelligence Server for authentication. If the Intelligence Server
authenticates this user, the user is logged on to the Subscription Portal and
a new Narrowcast Server user is created. If the authentication on the
Intelligence Server fails (for example, the login ID that was entered is not
a recognized login ID on the Intelligence Server), or if Narrowcast Server
login mode is enabled, the Subscription Portal attempts to log the user on
to the portal directly using the credentials entered. If that login fails, or if
normal Narrowcast Server login mode is disabled, the user sees a message
indicating that the login attempt failed. If MicroStrategy Intelligence
Server Normal mode is not enabled, the Subscription Portal attempts to log
the user on to the portal directly using the credentials entered.
Alternatively, the option to log on using MicroStrategy Intelligence Server
NT is enabled, and the user clicks on the option to log on using NT, then
the Subscription Portal requests the Intelligence Server to authenticate the
user using the current NT credentials (see the MicroStrategy System
Administration Guide for information about how to configure NT
Authentication mode using Intelligence Server and MicroStrategy Web.) If
the Intelligence Server authenticates this user, the user is logged on to the
Subscription Portal and a new Narrowcast Server user is created. If the
authentication on the Intelligence Server fails (for example, the NT user
does not correspond to any recognized Intelligence Server user), the user
sees a message indicating that the log on attempt failed.
Site definition
167
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
168
Services configuration
The diagram below illustrates the steps necessary to configure services
with page-by questions.
Pick a service
Configure page-by
questions for static
subscription sets
Configure page-by
questions for dynamic
subscription sets
Services configuration
169
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
For each service that uses page-by questions, you must indicate to the
Subscription Portal the value to use as the preference object for each pageby question in the service.Using the Services Configuration area of the
Portal Administrator Wizard, you can indicate the values to be used
through the settings described below.
Answer to another question
The most typical setting to use is Answer to another question. Using this
setting, you can select a question object, called an alternate question, that
prompts the end user when a subscription is created. This alternate
question collects the user's personalization for this subscription. You can
select how and where the answer to that question is stored. This choice also
determines whether the value that is used as the preference object for the
page-by question is the ID of the attribute element that the user selects or
the ID that references the answer object as stored in the warehouse.
Subscription Book Repository: If you choose the option to store the
answer to the alternate question in the Subscription Book Repository
(SBR), the ID of the attribute element that the user selects in the prompt
is written in the subscription as the preference object for the page-by
question. This value then determines which page of data the
subscription receives.
170
This option is only appropriate when the personalization for the content
information object is on a single attribute and the user is restricted to
selecting a single attribute element. The attribute on which the user is
prompted should be the same attribute that is used in the page-by area
of the content information object. To allow the user to personalize on
multiple attributes or to select more than one attribute element, you
must use the storage mapping approach described below.
The SBR storage option is only available in two situations. First, the
alternate question that is selected must contain only a single prompt
object, which is an attribute element prompt, and the prompt definition
is not set to require the selection of more than one element. Second, it
could contain a single, constant value prompt. Additionally, user
preferences are disabled for this question, so users are not able to save
and reuse their answers to this question.
When the SBR storage option is used with a dynamic subscription set,
it does not mean that the user's answer is only stored in the SBR. The ID
of the attribute element that the user selects can also be written to the
warehouse when defining the mapping of the subscription information.
To understand more about dynamic subscription sets, see Dynamic
subscription sets.
For examples about using this option, see Scenario 1: Basic
personalized page execution in the Advanced Subscription Portal
Configuration chapter.
Use a Storage Mapping: If you choose to store the answer to the
prompt question in the warehouse using a storage mapping, the actual
value or values that the user selects can be written to the warehouse. The
ID given to that answer is written in the subscription as the answer to
the page-by question. The storage mapping is defined to write to the
same warehouse that contains the information content for the content
information object. The ID of the answer object that corresponds to the
users selections for each subscription is used to select the page of data
that the subscription receives. The attribute on which the content
information object is paged by should correspond to the column in the
warehouse to which the answer ID is written.
Using this approach, you can do the following:
The question object that is selected can contain any number of prompt
objects, but each must be either an attribute element prompt or a
constant value prompt.
Services configuration
171
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
User preferences are enabled for questions that use storage mappings,
so user answers are reusable. If the user picks an existing answer, or
preference, to answer the prompt for a subscription, nothing new is
written to the warehouse. The ID of the selected answer object is written
as the answer to the page-by question in that subscription. The
subscription ID is typically not included in the mapping of a question to
the warehouse table, but if it is included, user preferences functionality
is disabled for that question.
For an example using this option, see Scenario 3: Page-by Answer ID
in chapter 9, Advanced Subscription Portal Configuration.
Subscription ID
Services configuration
173
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
174
The next step is to define how and where the subscription information for
the current dynamic subscription set is written to the warehouse. As
mentioned before, the exact information that needs to be written to the
warehouse depends on how the dynamic subscription set is defined. The
information that the Subscription Portal can write to the warehouse for
each subscription includes the standard subscription fields, other fields
from the MSTRSubscriptions table in the SBR, and the answer value or
answer for each alternate or additional question in the service.
The standard subscription fields are:
SUBSCRIPTION_ID: Integer ID used to uniquely identify a
subscription. This value is used when the Subscription ID is used as the
answer to a page-by question. This field references an object in the
SBR.
USER_ID: Globally unique identifier (GUID) used to identify the user
to whom this subscription belongs. This field references an object in the
SBR.
ADDRESS_ID: GUID used to identify the address to be used for this
subscription. This field references an object in the SBR.
The remaining fields from the MSTRSubscriptions table in the
Subscription Book Repository, which reference an object in the Object
Repository unless otherwise noted, are:
CREATED_BY: Narrowcast Server account that created this
subscription. This field is set to SUBSCRIPTIONS_PORTAL if it was
created by the Subscription Portal.
CREATED_DATE: Time stamp indicating when the subscription was
created.
EXPIR_DATE: Time stamp indicating when the subscription expires.
LAST_ACC_DATE: Time stamp indicating the last time this
subscription was retrieved in a subscription set resolution.
LAST_MOD_BY: Narrowcast Server account that last modified this
subscription. This field is set to SUBSCRIPTIONS_PORTAL if it was
last modified by the Subscription Portal.
LAST_MOD_DATE: Time stamp indicating when the subscription
was last modified.
STATUS: Status, either valid or invalid, of this subscription.
SUB_ACCOUNT_ID: GUID used to identify an external account ID.
This field currently is not used by the Subscription Portal.
SUB_GUID: Alternate ID (GUID) used to identify a subscription
internally.
Services configuration
175
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
176
C H A PT E R
Supporting Diverse
User Populations
8.
C
O
N
C
E
P
T
S
177
C
O
N
C
E
P
T
S
The Service Wizard should support most of your needs when creating
services to support different devices. The one limitation is that you can
only create one publication per delivery method. For example, you cannot
create one publication for Microsoft clients and a second publication for
Internet-based clients and use the same information transmitter. If you
need to implement this type of functionality, you can either use the Service
Editor, which can add multiple publications for the same information
transmitter, or you can create multiple information transmitters and create
the appropriate devices for each information transmitter.
178
Overview
Each user specifies a locale for which the user wants to receive content.
This is done through the Subscription Portal when users subscribe
themselves or it can be set in an advanced options tab in the User
Properties Editor when an administrator controls users and subscriptions.
Additional steps may be necessary to set up language support. See the
steps below for details required to send content in multiple languages to
different users. When a publication is created, either using the Service
Wizard or using the Publication Wizard, a specific locale is chosen. This
is called the selection locale. Users are then matched to publications based
on their chosen locale. In addition, each document is created to support one
locale. This is called the execution locale and is set in the Properties dialog
box for the document.
The execution locale controls how information sources, document
formatters, and information transmitters gather, format, and deliver
content for this document. Thus, if one document is created for the English
execution locale and a second document is created for a French execution
locale, information sources can retrieve content in the correct language and
character set and format numbers and dates according to the appropriate
regional characteristics for each document. Note that the MicroStrategy
information source supports locales, but it is up to the MicroStrategy
Desktop administrator to ensure that content in the appropriate languages
is available. Numbers and dates are formatted correctly automatically.
You must add appropriate static content for each language in documents.
As a result, locales typically require the use of multiple publications (one
for each locale) for the same information transmitter. This type of
application is best accomplished through the use of the Service Editor
since the Service Wizard can only create one publication per information
transmitter. For more information on using the Service Editor, see Service
Editor.
Locale concepts
The following concepts related to locales are used in Narrowcast Server:
Locale (administrative object): defined by the System Administrator
to specify how information should be retrieved, formatted, and
transmitted for a particular region.
Selection locale for a publication (administrative setting): locale
selected within a service or publication to determine which content is
delivered to users from a service. If the users selected locale matches
the selection locale for the publication, the user receives that localized
content.
179
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
Locale processes
Locales are used in two processes within Narrowcast Server:
Selection determines who receives what content. The Application
Designer designs one service with multiple sets of content defined for
different sets of users with different regional preferences. If the
selection locale for a publication in the service definition matches the
user locale, the users receive that content.
Execution specifies how localized content is retrieved, formatted, and
delivered. The execution locale in a document refers to the locale
administrative object, which controls how information sources,
document formatters, information transmitters, and compression (zip)
processes handle regional characteristics.
Using locales
The following steps illustrate how locales can be configured and how they
work with respect to multiple languages and locales.
1. Create two locales using the Locale Editor, one for English (US) and
one for French.
2. For each locale, define the appropriate available settings for
information sources, document formatters, information transmitters, and
compression to control retrieval, formatting, and delivery.
180
3.
When document formatters are used (no settings are available for
PDF, HTML, plain text, or Excel)
181
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
selection process
execution process
selection process
execution process
selection process
selection process
default if locale is
not fully defined
Locales
Locale 1: French
Information Source setting: French
execution process
execution process
Locale 2: English
182
execution process
execution process
C H A PT E R
Advanced
Subscription Portal
Configuration
9.
C
O
N
C
E
P
T
S
Warehouse setup
2.
3.
6.
183
C
O
N
C
E
P
T
S
Narrowcast Server:
The following table summarizes the scenarios that are covered in this
section.
Scenario
Number
Scenario
Name
Subscription
Set
Page-By?
Alternate/
Additional
Question
Object?
Writing to
Warehouse?
User
Preference
Support?
Scenario 1:
Basic
personalized
page
execution
Static
On any content-related
attribute (not Subscription
ID or Answer ID); in this
example, Country
Yes
No
No
Scenario 2:
Page-by
Subscription
ID
Static
Yes
Yes; Subscription No
ID and the
alternate
question object
answer value
(Subscription_ID,
threshold)
Scenario 3:
Page-by
Answer ID
Static
Yes
Yes; Answer ID
and the alternate
question object
answer value
(Answer_ID,
Symbol)
Yes
Scenario 4:
Nonpersonalized
dynamic
subscription
Dynamic
None
No
Yes; Subscription
ID, Address ID,
and User ID
N/A
184
Scenario
Number
Scenario
Name
Subscription
Set
Page-By?
Alternate/
Additional
Question
Object?
Writing to
Warehouse?
User
Preference
Support?
Scenario 5:
Personalized
dynamic
subscription
Dynamic
Subscription ID
Yes
Yes; Subscription
ID, Address ID,
User ID, and the
alternate
question object
answer value
No
185
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
4.
7.
186
3.
Browse for the alternate question and choose the Question Object 1.1
Alternate Question Object.
5.
For storage of the alternate question, select the option to Use the
Subscription Book Repository (as opposed to defining a storage
mapping).
6.
Try it!
1.
2.
3.
4. On the Subscriptions page, you see that there are now two
subscriptions to the service.
5.
6.
How it works
1. When a user subscribes to this service through Subscription Portal,
Subscription Portal determines that there is an alternate question object
defined for this service. Subscription Portal retrieves the definition of the
attribute element prompt from MicroStrategy Intelligence Server and
shows that prompt to the user.
187
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
2.
188
You can choose this approach because you want to take advantage of the
performance of personalized page execution (only execute one query
against the warehouse). In this case, the user's personalization needs to be
stored in the warehouse. You might also want to have easy access to each
subscriber's personalization values, which is only feasible when the
personalization information is stored in the warehouse. In this case, you
choose to page by Subscription ID because that allows the personalization
to be at the subscription level, but the threshold value is not reusable (that
is, the User Preferences feature is disabled for this question in the
Subscription Portal interface).
This example assumes that your warehouse contains a populated table with
a list of stock symbols and associated facts. The table is assumed to have
the following columns:
SYMBOL, LAST_TRADE_PRICE, and PCT_CHANGE
189
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
4.
190
Try it!
1.
2.
3.
4. On the Subscriptions page, you see that there is now one subscription
to the service.
5.
191
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
How it works
1. When a user subscribes to this service through Subscription Portal,
Subscription Portal determines that there is an additional question object
defined for this service. Subscription Portal retrieves the definition of the
value prompt from MicroStrategy Intelligence Server and shows that
prompt to the user (the threshold prompt).
2.
192
193
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
7.
194
4.
3.
On the Configure Subscription Set page, mark the page-by question
(1.3 Page-by Information Object) as Page-by: Answer to another
question.
4. Browse for the alternate question and choose the question object 1.3
Alternate Question Object.
5. For storage of the alternate question, choose to create a new storage
mapping.
6. Select the database connection that corresponds to your warehouse
and select the REL_ANSWER_SYMBOL table created for this example.
195
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
Try it!
1.
2.
3.
4. On the Subscriptions page, you see that there is now one subscription
to the service.
5. If you view the contents of the REL_ANSWER_SYMBOL table in
the warehouse, you see that a record has been inserted for each of the
selected stocks in the subscription you just created.
6.
7.
How it works
1. When a user subscribes to this service through Subscription Portal,
Subscription Portal determines that there is an alternate question object
defined for this service. Subscription Portal retrieves the definition of the
stock symbol prompt from MicroStrategy Intelligence Server and shows
that prompt to the user.
2. The user answers the prompt by selecting one or more stock symbols
from the list.
3.
196
197
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
information from sources other than Narrowcast Server. It also allows the
Narrowcast Server system administrator a large amount of flexibility in
determining the structure of the tables that will hold the subscription
information, which is not possible using static subscription sets.
2.
Create attributes based on the Subscription ID, Address ID, User ID,
and Subscription Set ID columns of the WH_SUBSCRIPTIONS table.
3.
4.
198
C
O
N
C
E
P
T
S
1.
2.
3.
199
C
O
N
C
E
P
T
S
Optional: Using the Custom Value field, map the string SS for Example
4 to the MR_SUB_SET_ID column. This makes it possible for the
subscription information object report to filter on only those subscriptions
that were created using this dynamic subscription set.
Try it!
1.
2.
How it works
1. When a user subscribes to this service through Subscription Portal,
Subscription Portal determines that there are no question objects defined
for this service, so the user does not need to answer any prompts.
200
201
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
terms of the process of signing up for the service. However, since this
example uses a dynamic subscription set, Narrowcast Server retrieves the
list of subscriptions from a warehouse report instead of from the
Subscription Book Repository.
You can choose this approach because you want to take advantage of the
performance of personalized page execution (only execute one query
against the warehouse). In this case, the user's personalization needs to be
stored in the warehouse. You might also want to have easy access to each
subscriber's personalization values, which is only feasible when the
personalization information is stored in the warehouse. Finally, storing the
subscription information in the warehouse has many advantages, such as
the ability to manage, analyze, filter, or even populate and modify
subscription information from sources other than Narrowcast Server. It
also allows the Narrowcast Server system administrator a large amount of
flexibility in determining the structure of the tables that hold the
subscription information, which is not possible using static subscription
sets.
This example assumes that your warehouse contains a populated table with
a list of stock symbols and associated facts. The table is assumed to have
the following columns:
SYMBOL, LAST_TRADE_PRICE, and PCT_CHANGE
2.
202
C
O
N
C
E
P
T
S
203
C
O
N
C
E
P
T
S
5.
204
Optional: Using the Custom Value field, map the string SS for Example
5 to the MR_SUB_SET_ID column. This makes it possible for the
subscription information object report to filter on only those subscriptions
that were created using this dynamic subscription set.
Try it!
1.
4. On the Subscriptions page, you see that there is now one subscription
to the service.
5.
205
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
6.
How it works
1. When a user subscribes to this service through Subscription Portal,
Subscription Portal determines that there is an additional question object
defined for this service. Subscription Portal retrieves the definition of the
value prompt from MicroStrategy Intelligence Server and shows that
prompt to the user (the threshold prompt).
2.
206
207
C
O
N
C
E
P
T
S
C
O
N
C
E
P
T
S
208
SECTION II
Application Designer
Interfaces
II
I
N
T
E
R
F
A
C
E
209
I
N
T
E
R
F
A
C
E
210
Section II
C H A PT E R
10
Choose Subscription
Sets Dialog Box
10.
10
211
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
212
C H A PT E R
11
Desktop Document
Selector Dialog Box
11.
11
Using the Desktop Document Selector dialog box, you can select an
existing MicroStrategy Desktop document to send in a Narrowcast Server
service. These documents are already formatted and ready to be included.
You cannot open or edit a Desktop document from within Narrowcast
Server.
For more information on how to use MicroStrategy Desktop documents
within the services of your Narrowcast Server, see Creating Publications
and Content Section Documents, Documents, and Desktop documents.
Accessing the Desktop Document Selector dialog box
From the New Document dialog box, select the option to link to an existing
MicroStrategy Desktop document. Then, select the appropriate
information source. Or from the Select Information Source dialog box,
select the appropriate source. Click OK.
213
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
214
Chapter 11
215
I
N
T
E
R
F
A
C
E
General tab
Choose the All Layout option to send all the layouts of a multi-layout
document to different Excel sheets.
If the Expand all pages check box is selected, the users receive all the
pages of the report or document, when the service is executed.
The Each page on a different worksheet check box is enabled only if
the document format is Excel and if the Expand all pages check box is
selected. This check box allows you receive each page of the report on
a different worksheet in the Excel report. This feature is available only
for Excel 2002 and later.
The Report Execution tab is displayed only if you link a report to the
service. It has the following areas:
216
Chapter 11
In the Intelligence Server cache area, select one or both of the following
check boxes:
Use cached report if available from MicroStrategy Intelligence
Server: If the report has been cached, use it; otherwise rerun the report.
Update MicroStrategy Intelligence Server cache with execution
result if cache is not used or unavailable: Run the report and cache it
for future use.
Personalization Mode
217
I
N
T
E
R
F
A
C
E
The Document Execution tab is available only if you link a report services
document to a service. This tab has the following areas:
Document cache properties
I
N
T
E
R
F
A
C
E
Document execution
Segmentation Properties
Document cache properties
In the Document cache properties area, you can select the Use report
cache during document execution check box. This applies only to
existing MicroStrategy Desktop documents that are linked to from
Narrowcast Administrator. Using the document cache speeds up document
execution, but limits the data to what has already been cached.
Document execution
The settings on the Error handling tab allow you to specify error handling
rules for the selected report or document. If the report or document returns
partial data, you can choose to either fail the document or use the partial
results. This tab is displayed only for File delivery services.
218
Chapter 11
219
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
220
Chapter 11
C H A PT E R
12
Dynamic Subscription
Set Wizard
12.
12
The Dynamic Subscription Set Wizard lets you to create and edit dynamic
subscription sets in the Subscription Book. You can specify SQL
statements to be executed before and after a dynamic subscription set
executes.
For more information on which information objects you want to include
for segmentation and subscription resolution, see Creating and Managing
Subscription Sets. For information on the SQL statements you want to
include for pre-processing and post-processing, see Subscription
Preferences.
Accessing the Dynamic Subscription Set Wizard
I
N
T
E
R
F
A
C
E
Introduction
The Introduction page provides you with a summary of what you can do in
the Dynamic Subscription Set Wizard. Each step is identified on this page.
Subscription Selection
Browse through the folders and click the information object to use for
subscription. Click Clear to remove a selected information object. You can
also create a subscription information object from the Dynamic
Subscription Set Wizard.
Segmentation
Browse through the folders and click the information object to use for
segmentation. Click Clear to remove a selected information object. You
can also create a segmentation information object from the Dynamic
Subscription Set Wizard. For more information about the use of
segmentation information objects, see Information objects.
222
Summary
The Summary page provides you with a summary of the definition for this
dynamic subscription set.
223
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
224
C H A PT E R
13
Document Element
Properties Dialog Box
13.
13
Using the Document Element Properties dialog box, you can select a
different stylesheet and specify error handling rules for the selected
document element.
You can use these error handling rules to fail documents. When these
documents are set as required in the Publication Wizard, these rules can
be used to control whether or not publications are delivered to individual
recipients based on the data returned by information objects. For more
information, see Error handling.
Accessing the Document Element Properties dialog box
Before you begin using the Document Element Properties dialog box, you
must have created a document.
225
I
N
T
E
R
F
A
C
E
Stylesheet selection
By default, MicroStrategy information objects use a stylesheet that
preserves the formatting defined in the MicroStrategy Desktop or Web
products. Information objects from information sources other than the
MicroStrategy information source prompt you if a stylesheet is required.
The following stylesheets are available by default:
I
N
T
E
R
F
A
C
E
Text documents:
226
HTML documents:
227
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
In the report, if the metric is used in the rows, then the Metric
column is not removed by using the
MSTR7ToHTMLOverlapGridTitles.xsl stylesheet described
above.
Excel documents:
228
MSTR7ToExcel-WithoutColumnAxisHeaders.xsl: This
stylesheet does not display the column axis headers on the report
template. The column axis headers describe the items on the report
columns. Column axis headers typically display the title Metrics or
the names of any attributes that are present on the report columns. In
Narrowcast Server 7.1 and previous versions, the column axis
headers were not shown by default, so this stylesheet is necessary to
achieve the default formatting provided by these product versions.
229
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
User information
When user information (first name, last name, and so on) is inserted in a
document, an appropriate stylesheet is automatically selected. You do not
need to select a stylesheet.
Subscription information
Error handling
Error handling rules can be applied to the following three events:
An information object returns no data
An information object returns an error
The document formatter is unable to format the document element
In each case, you can choose one out of the following options:
Fail the document
Use string
230
If you choose to fail the document, the document element raises an error
so that the document fails to be returned to the publication. If you choose
to use string, you can enter a string that is displayed in the document
contents in place of the information object results in the case of this event.
I
N
T
E
R
F
A
C
E
231
I
N
T
E
R
F
A
C
E
232
C H A PT E R
14
Document Properties
Dialog Box
14.
14
Before you begin using the Document Properties dialog box, you must
have created a document and understand the purpose of execution locales
and error handling.
For more information about error handling in documents, see Error
handling.
For information on locales, see the Locales in the Narrowcast Server
System Administrator Guide.
233
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
General
The Document Properties dialog box allows you to select an execution
locale from a list of all available locales for your document. An execution
locale tailors the format of content such as numbers, date, and currency
according to regional preferences. For example, if your system
administrator defined French and German locales to gather information in
the appropriate languages, you can select one of these locales as the
execution locale for a document. All dynamic content in this document is
then retrieved using the corresponding language.
234
235
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
236
C H A PT E R
15
Excel Document
Editor
15.
15
Before you begin using the Excel Document Editor, you should:
Understand how documents are used in publications
Know what document elements, information objects, and XSL
stylesheets are
Understand the concept of imported files and know how to import them
For more information on the above topics, see Publications.
For information on the formats of the XML structures, see Appendix D,
XML for Narrowcast Server Objects.
237
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
Open a document
238
Absolute means the item is offset from the top of the sheet.
Relative Top means the item is offset from the top of another row.
Relative Bottom means the item is offset from the bottom of another
row.
Row Reference: the row to use as the starting point for the offset; not
used for absolute row positioning, which is always offset from the top
of the sheet
Row Offset: the number of rows the item is offset from the top of the
sheet, if absolute row positioning is used, or from the Row Reference
Column Positioning: how the content item is placed in a column:
Absolute means the item is offset from the left of the sheet.
Relative Left means the item is offset from the left side of another
column.
Relative Right means the item is offset from the right side of another
column.
Column Reference: the column to use as the starting point for the
offset; not used for absolute column positioning, which is always offset
from the left of the sheet
Column Offset: the number of columns the item is offset from the left
of the sheet, if absolute column positioning is used, or from the Column
Reference
You can resize the width of the columns to view the entire contents of the
cells.
Once you add a template file, you can insert information objects into it by
right-clicking in the body of the template and selecting from the resulting
menu to create a certain kind of information object or to insert an existing
information object.
Note the tabs that allow you to access different spreadsheets, if the
template file contains multiple spreadsheets. The sheet names default to
those of the template files. You can also change the name for each
spreadsheet independently in either of the following ways:
Double-click the spreadsheets tab and enter a new name.
239
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
Menu bar
The File and Insert menu bar options contain items unique to Narrowcast
Server. The following tables describe the contents of each.
File menu options
240
Menu option
Function
New Document
Open Document
Save
Save As
Properties
Close
Function
List of available
information sources,
for example,
MicroStrategy Tutorial
or User Information
New Information
Object
Existing Information
Object
Static Text
241
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
242
C H A PT E R
16
16.
16
The Filter and governing editor dialog box allows you to restrict the
number of users or addresses, and the number of subscriptions to retrieve
when you open the Subscription Book or a subscription set. It also allows
you to define filters for the Users and addresses list as well as the
Subscription list.
For steps to create and use the Subscription Set, see Creating and
Managing Subscription Sets. For steps to use the Subscription Book, see
Managing a Subscription Book.
Accessing the Filter and governing editor
Before you begin using the Filter and governing editor dialog box, you
should:
Know the total number of items in your Subscription Book.
Know the total number of items in your largest static subscription set.
Determine the maximum number of users or addresses you can retrieve
at a given time.
For more information on the above topics, see Subscriptions and
subscription sets and The Subscription Book.
243
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
You can then set the filter conditions for address names, login IDs, and
physical addresses.
Maximum number of addresses/users to retrieve: Specify the
maximum number of users or addresses to retrieve for the Subscription
Book. If the total number of users and addresses available in the
Subscription Book exceeds the number in the governing setting, a
message is displayed that only the number of users and addresses
indicated in the governing setting will be retrieved.
Maximum number of subscriptions to retrieve: Specify the
maximum number of subscriptions to retrieve for all subscription sets.
The default value for both the Subscription Book and Subscription Set
sections is 100, which is also the smallest number allowed for these
settings.
244
If you open this dialog box from the Subscription Book Editor,
you can see the Define filter and Subscription Book options, but
not the Subscription Set option.
C H A PT E R
17
HTML Document
Editor
17.
17
The HTML Document Editor allows you to create and format HTML
documents to include in services.
Using the HTML Document Editor you can:
Add multiple XML information objects with the same stylesheet in a
document
Edit an HTML document
Select a different XSL stylesheet for an XML information object
For more information on how to add documents to the service, see
Creating Publications and Content Section Documents.
Accessing the HTML Document Editor
Before you begin using the HTML Document Editor, you should:
understand how documents are used in publications
know what document elements, information objects, and XSL
stylesheets are
For more information on the above topics, see Publications.
245
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
Menu bar
The File, View, Insert, Format, and Table menu bar options contain items
unique to Narrowcast Server. The following tables describe the contents of
each.
246
Menu option
Function
New Document
Open Document
Save
Save As
Properties
Close
Function
Document Element
List
Editor
Source
Preview
247
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
Menu option
Function
List of available
information sources,
for example,
MicroStrategy Tutorial
or User Information
New Information
Object
Existing Information
Object
Picture
Hyperlink
Function
Font...
Choose
Bold
Italic
Underline
Alignment...
248
Left
Center
Right
Menu option
Function
Outdent
Indent
Foreground Color
Opens the Color dialog box to set the color of the text
Background Color
Opens the Color dialog box to set the background color of the
text
Numbered List
Bulleted List
Function
Create
Insert Row
Delete Rows
Insert Column
Delete Column
Insert Cell
Delete Cell
Merge Cells
Split Cell
Toolbar
The formatting and table menu options are replicated on the toolbar as
icons. Their use is described below.
Toolbar icon
Function
Open
Cut
249
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
Toolbar icon
Function
Copy
Paste
Insert
250
Bold
Italic
Underline
Choose Font
Choose Foreground
Color
Opens the Color dialog box to set the color of the text
Choose Background
Color
Left Align
Center
Right Align
Outdent
Indent
Toggle Hidden
Formatting Tags
Create Table
Insert Row
Delete Rows
Insert Column
Delete Columns
Insert Cell
Toolbar icon
Function
Delete Cells
Merge Cells
Split Cell
251
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
252
C H A PT E R
18
Imported Document
Editor
18.
18
Before you begin using the Imported Document Editor, you should:
Understand how documents are used in publications
Understand that imported files must be associated with a document
before they can be used in a publication
Understand how locales can be set for documents (locales are necessary
when an imported document contains a file that was imported using a
character set other than the system default)
For more information on the above topics, see Publications.
I
N
T
E
R
F
A
C
E
Use an existing file object, which means that you will create a document
from a file you already imported into the system
The task flow changes depending on which option you select.
254
C H A PT E R
19
19.
19
The Import File dialog box imports a file to use as a stylesheet, template,
or attachment. An XSL stylesheet is applied at the document element level
and transforms the XML returned by an information object into a format
that can be used in a document. A template is used as the basis for creating
a new document. For example, an Excel template file sets the number of
worksheets in the document and can provide Excel macros as well.You can
import a zip file, associate it to a document, and then attach it to a
publication.
For steps to import files, see Creating Publications and Content Section
Documents.
Accessing the Import File dialog box
Before you begin using the Import File dialog box, you should:
Understand how imported files are used in the Delivery Engine.
Know the location of the file to import.
Know the character set that was used to create the file if it differs from
your system character set.
For more information, see Creating Services.
255
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
The character set that was used when creating the file should be
selected, because this character set is used to interpret the file and store
it in the Narrowcast Server Object Repository. When this file object is
used within an imported document, the locale for the document should
be set to a locale whose character set for relevant ITMs is the same as
or compatible to the character set that was selected when the file was
imported.
You need to select a locale with this same character set (or a
compatible character set) for any imported document that
contains this file in the future for the file to be decoded
correctly.
Click OK to continue.
for imported files in a folder or the entire system and refresh all the
imported files.The Refresh Imported File dialog box displays the status of
file import, summary of the file import and errors, if any.
Right-click the required files and select Refresh Imported File to open
the Refresh Imported File dialog box.
I
N
T
E
R
F
A
C
E
Click Open Log File to view a summary of the file import. The
summary details includes the date and time stamp, and the status,
summary, and error details of the import process.
Click OK to continue.
257
I
N
T
E
R
F
A
C
E
258
C H A PT E R
20
Information Object
Wizard
20.
20
259
I
N
T
E
R
F
A
C
E
Prerequisites
Before you begin using the Information Object Wizard, you should:
Understand what an information object is
Know the difference between the various kinds of information objects
I
N
T
E
R
F
A
C
E
260
Click Next to go to the next page of the wizard. Click Back to go to the
previous page. Click Cancel at any time to exit the wizard without saving
any changes.
Role page
Choose how this information object should be used:
Content Information Object: The report results are used as content in
document elements.
Subscription Information Object: The report results provide the
subscription set, within a particular segment.
Segment Information Object: The report results define segment
boundaries for subscriptions.
261
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
You can navigate to the desired report and select it. Or you can open a
folder, type some or all of the report name in the Find box, and click the
Find in list button to list all reports with the typed characters in their
names.
You can create a new report or filter by clicking the New Report or New
Filter button. You can edit an existing report or filter by clicking Edit
Object. You can refresh the list of objects by clicking Refresh browser.
262
263
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
264
The Report Execution tab has multiple areas. In some cases, not all areas
are available or visible. The following areas may appear:
Intelligence Server cache
Personalization Mode
Segmentation Properties
Intelligence Server cache
In the Intelligence Server cache area, select one or both of the following
check boxes:
Use cached report if available from MicroStrategy Intelligence
Server: If the report has been cached, use it; otherwise rerun the report.
Update MicroStrategy Intelligence Server cache with execution
result if cache is not used or unavailable: Run the report and cache it
for future use.
265
I
N
T
E
R
F
A
C
E
Personalization Mode
I
N
T
E
R
F
A
C
E
266
Format page
The Format page is used for content information objects only.
Report results can be returned in either a tabular format, ready for further
processing, or in a graphical format, which is a GIF file. If graphical is
selected, the image size can be customized.
267
I
N
T
E
R
F
A
C
E
This page defines which fields in the report results map to which pieces of
subscription information, including the Address ID, User ID, Locale ID,
Security, and Personalization. The option you select for one ID affects the
options available for the next ID. The following sections explain the
operations:
Address and User Information
I
N
T
E
R
F
A
C
E
268
Address ID
User ID
Locale ID
Subscription
Book
Subscription
Book
Subscription
Book
Report
Subscription
Book
Subscription Book,
report, or constant
Report
Subscription Book,
report, or constant
Constant
Subscription Book,
report, or constant
269
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
Address ID
User ID
Authentication
and Security
Preference
Subscription
Book
Subscription
Book
Subscription
Book
Subscription
Book or report
Report
Subscription
Book
Subscription
Book
Subscription
Book or report
Report
Subscription
Book or report
Subscription
Book or report
Constant
Subscription
Book or report
Subscription
Book or report
Preferences page
The Preferences page is displayed only if personalization was set to be
generated by the report, on the User Properties and Personalization
page.
270
Summary page
This page provides a summary of the selections you made while building
the information object. Review the information and click Finish. The Save
XML Information Object dialog box appears so you can save the
information object and return to the Narrowcast Administrator.
271
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
272
C H A PT E R
21
Modify Schedule
Queue Parameters
Dialog Box
21.
21
The Modify Schedule Queue Parameters dialog box allows you to change
the following parameters for the Delivery Engines scheduled services
queue:
How long to calculate the queue for each service.
The maximum number, up to 999, of scheduled executions to display.
For steps to modify the Schedule Queue Parameters, see Creating and
Managing Services and Schedules.
Accessing the Modify Schedule Queue Parameters dialog
box
Before you begin using the Modify Schedule Queue Parameters dialog
box, services must be scheduled.
273
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
274
C H A PT E R
22
22.
22
The New Document dialog box allows you to choose whether to create a
new Narrowcast Server document or to link to an existing MicroStrategy
Desktop Report Services document. You can create an Excel, HTML,
imported, or plaintext document.
For steps to create a document, see Creating Publications and Content
Section Documents.
Accessing the New Document dialog box
Before you begin using the New Document dialog box, you should:
Understand how documents are used in publications.
Know what document elements, information objects, and XSL
stylesheets are.
For more information, see Publications and Documents.
275
I
N
T
E
R
F
A
C
E
276
C H A PT E R
23
Portal Administrator
Wizard
23.
23
277
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
The Add a new database connection page allows you to create a new
database connection. To create a new database connection, click Add
database connection. This page displays the following fields:
Field
Description
Database
User name
Password
Confirm password
Summary page
The Summary page helps you to review the steps you completed in the
System Configuration section. Click Next to advance to the Site
Management section.
279
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
Summary page
These pages are explained in detail in the following sections.
Overview page
The Select or Create Portal page lets you select an existing Subscription
Portal or create a new portal.
280
After you create a new portal, the Site Definition page appears
again.
The Site Name and Description page allows you to enter a Name and
Description for the site. Click Next to continue.
Object Repository page
The Object Repository page displays the list of existing Object Repository
database connections. You can select an existing database connection or
create a new database connection.
To select an existing database connection, enter the table prefix for the
database in the Tables prefix field and click Next.
To create a new database connection, click Add a new database
connection.
The Subscription Book Repository page displays the list of the existing
Subscription Book Repository database connections. You can select or
delete an existing database connection or create a new database
connection.
To select an existing database connection, enter the table prefix for the
database in the Tables prefix field and click Next.
To create a new database connection, click Add a new database
connection.
To delete a database connection, click Delete next to the database
connection to be deleted.
281
I
N
T
E
R
F
A
C
E
Summary page
The Summary page helps you to review the steps you completed on the
Site Management section. Click Next to proceed to the Site Preferences
section.
I
N
T
E
R
F
A
C
E
The Site Preferences Overview page provides an overview of the task you
will perform in this section.
Channels page
The Channels page lists all the channels for site definition.
To edit the channel folder name or description, click Edit next to the
channel.
To delete the channel from the Subscription Portal, click Delete next to
the channel.
To select a new service folder for the Subscription Portal, click Add a
new channel.
The Channels page consists of the following pages:
Select the Channels Folder page
Channel Name and Description page
282
The Select the Channels Folder page allows you to select a service folder
for the channel. Click Next to continue.
Channel Name and Description page
The Channel Name and Description page displays the default channel
name and description.
To change the name and description of the channel, enter a Name and
Description.
To enable the channel and make it visible to the user through the
Subscription Portal, select the Channel Enabled check box.
Device Types page
The Device Types page displays a list of the device types defined for the
current site.
To edit the name of the device type, click rename next to the device
type.
To edit the properties of the device type, click definition next to the
device type.
To delete the device type from the options available to the user, click
Delete next to the device type.
To edit the device folders of the device type, click edit device folders
next to the device type.
To create a new device type, click Create a new device type.
The Device Types page consists of the following pages:
New Definition page
Device Folders page
New Definition page
The New Definition page displays information relating to the device type.
This page is the same for editing a device type definition; however, when
editing a device type definition, you cannot edit the device type name. This
page provides the following options:
Device Type Name: Enter the name of the device type. The name
should accurately describe the group of devices, for example, faxes,
pager, and e-mail.
Large icon URL: Enter the path of the large icon to be displayed on the
Addresses page of the Subscription Portal.
283
I
N
T
E
R
F
A
C
E
Small icon URL: Enter the path of the small icon to be displayed on the
Addresses page of the Subscription Portal.
Address format: Select the appropriate validation to be applied to
addresses created for devices within this device type. Validation occours
when the subscriber enters an address in the Subscription Portal.
I
N
T
E
R
F
A
C
E
E-mail requires that all addresses created for this device type follow
the standard e-mail address format, for example,
yourname@company.extension.
Numeric requires the user to enter an address for the device type
using only numbers, parentheses, and dashes.
Address Name shows the name given to each address by the user, for
example, My Email.
Style displays the specific device for which the address was created.
Address Value allows the user to enter the physical value of the
address (cannot be disabled).
Style allows the user to select the device for which the address is
defined (cannot be disabled).
Delivery Window allows the user to enter a start time and an end
time during which services can be delivered to the address.
The Device Folders page displays the list of available and selected devices
in the device type folder.
284
To activate the folder for the specific device type, select the check box
next to the folder or folders.
Use the toggle button to the move selected folders to the Selected side
of the table.
Any given device folder can only be used for one device type.
Once the folder is used for one device type, it is no longer
available for other device types.
The Device Settings page displays the default settings for the devices.
To set the address format for a device, select the appropriate option from
the Address format list.
To select a another device, click Change.
To disable the device, click Disable next to the device.
When you select the Default Device, you must select the
validation for the address format. For more information about
the options of the address format, see New Definition page.
The Preferences page displays the list of default values set for the users of
the portal interface. You can modify the following settings on the
Preferences page:
Project Settings
Enable creation of new accounts: Select Yes or No from the dropdown list to allow or prohibit the creation of new accounts through the
Subscription Portal interface.
New account expiration: Set the expiration date for a new user account
created in Narrowcast Administrator.
285
I
N
T
E
R
F
A
C
E
after (nn) days: Enter a valid number in this box to indicate that all
new user accounts expire after the given number of days.
Interface Settings
Default use DHTML: Select one of the following options to determine
the use of DHTML on the users Web browser:
I
N
T
E
R
F
A
C
E
Yes: Enables the use of DHTML even if the browsers do not support
DHTML.
Only when there is more than one question displays the Summary
page only if multiple questions are asked by the user.
Administrator information
E-mail allows you to enter the e-mail address of the Technical Support.
Telephone number allows you to enter the telephone number of the
Technical Support.
286
Login mode
Narrowcast Server Normal (User Name and Password): Select this
mode if the Subscription Portal users will use Narrowcast Server
credentials (NOT Intelligence Server logins or NT authentication).
MicroStrategy Intelligence Server Normal (User Name and
Password): Select this mode if the Subscription Portal users use
Intelligence Server credentials (NOT Narrowcast Server credentials or
NT authentication).
MicroStrategy Intelligence Server NT (NT User Name): Select this
mode if the Subscription Portal users use NT authentication (NOT
Narrowcast Server or Intelligence Server credentials)
Intelligence Server name: Provide a MicroStrategy Intelligence Server
name if you select the MicroStrategy Intelligence Server Normal or the
MicroStrategy Intelligence Server option.
The login mode feature allows existing users of MicroStrategy Intelligence
Server to use the Subscription Portal interface without creating a new
Narrowcast Server user. When this feature is enabled, the Intelligence
Server user can log on to the Subscription Portal using the same login
method that they use to log on to MicroStrategy Web. The first time a user
logs on to Subscription Portal, a Narrowcast Server user is created and the
two user accounts are linked together. This happens transparently to the
user, so the user is never aware of the fact that there are technically two
user definitions. For more information about the login mode feature, see
Login Mode.
287
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
Prompt settings
Number of items to be returned for element prompts: Specify the
maximum number of elements returned by an element prompt. The
default is 30.
Number of items to be returned for object prompts: Specify the
maximum number of elements returned by an object prompt. The
default is 30.
Summary page
The Summary page helps you to review the steps you completed in the Site
Preferences section. Click Next to proceed to the Services Configuration
section.
288
The Services page displays the list of services that are configured.
To add a new service with personalization, click Configure another
service.
To edit a service configuration, click Edit next to the service.
To delete a service configuration, click Clear next to the service.
The Services page consists of the following pages:
Select Services page
Static Subscriptions page
Configure Subscription Set page
Select Question page
Select Storage page
Dynamic Subscriptions page
Select Tables page
Select Columns page
289
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
You only use the Services page when you are configuring a
service with page-by questions or dynamic subscription sets. If
you do not have any services with page-by questions or
dynamic subscription sets, click Next to proceed to the Finish
page.
The Select Services page displays the list of folders and services that you
can configure. Navigate through the folders to select the service to be
configured.
Static Subscriptions page
The Static Subscriptions page displays the list of the Static Subscription
sets associated with the service. This page allows you to configure and edit
the default settings of the Static Subscription set.
To configure the default settings, click configure.
To edit the default settings, click Edit.
To clear the default settings, click Clear.
Configure Subscription Set page
The Configure Subscription Set page displays the list of the page-by
questions. This page allows you to select how the page-by question will be
answered from the drop-down list. You can also select additional question
prompts.
The page-by questions can be answered in one of the following ways:
User_ID writes the unique user ID of the subscriber to the Subscription
Book Repository as the answer to the page-by question.
Subscription_ID writes the unique subscription ID to the Subscription
Book Repository as the answer to the page-by question.
Address_ID writes the unique address ID of the selected address to the
Subscription Book Repository as the answer to the page-by question.
Answer to another question writes data to the Subscription Book
Repository based on the information that the subscriber provides
through a prompt in the Subscription Portal. The answer to the page-by
question is either the value of the users answer to the alternate question
or the ID of the preference object generated for that answer.
290
Once you are done configuring the page-by questions for static
subscription sets, you are returned to this page. Click OK to proceed.
Select Question page
The Select Question page displays the list of the alternate question objects.
Select the alternate question that needs to be shown to the subscriber, and
click Next to proceed.
You need to navigate through the services folders until you find
the question object that corresponds to the specific question you
want to use.
The Select Storage page displays the list of database connections and
storage mappings. It allows you to select the Subscription Book
Repository or create a new storage mapping for the Subscription Set.
To select the storage mapping, select the appropriate option from the
Database connections list.
To create a new storage mapping, click Add a new storage mapping.
Click Next to proceed.
Dynamic Subscriptions page
The Select Tables page allows you to select the tables from the data
warehouse where you store the answers or the subscription information for
dynamic subscription sets. Use the toggle button to move the selected
tables to the Selected Tables side of the table.
291
I
N
T
E
R
F
A
C
E
You can use the Filter table names box to restrict the list of
table names that is returned. Use the percent sign (%) after the
letter or string to return all entries beginning with that letter or
series.
I
N
T
E
R
F
A
C
E
The Select Columns page defines how the questions are stored each time a
subscriber answers the question through the Subscription Portal and how
the dynamic subscriptions get written to the warehouse. This page also
displays the storage mapping name.
To change the current storage mapping name, edit the name in the
Storage Mapping name field.
To add the answer components, drag the components to the columns in
the table.
Summary page
292
C H A PT E R
24
Plaintext Document
Editor
24.
24
The Plaintext Document Editor allows you to create and format a plaintext
document. You can add multiple XML information objects with the same
stylesheet in a document and also select a different XSL stylesheet for an
XML information object.
For steps to create a plaintext document, see Creating Publications and
Content Section Documents.
Accessing the Plaintext Document Editor
Before you begin using the Plaintext Document Editor, you should:
Understand how documents are used in publications
Know what document elements, information objects, and stylesheets
are
For more information on the above topics, see Publications.
293
I
N
T
E
R
F
A
C
E
A menu bar that offers standard Windows menus (Edit, View, and
Help) as well as File and Insert menus that contain Delivery Enginespecific options
A toolbar that provides the ability to:
I
N
T
E
R
F
A
C
E
Open a document
In addition, some of the same options are offered via the right-click menu.
If you right-click in the content definition pane, you can insert information
objects. Also, you can double-click the objects in the document element
pane. If you double-click Document Element 1, Document Element 2,
and so forth, the Document Element Properties dialog box appears. If you
double-click the name of an inserted object, the Information Object
Wizard appears.
The Choose XML Information Object Destination dialog box is accessed
only when you select a document element containing an XML information
object and then add another XML information object.
Menu bar
The File and Insert menu bar options contain items unique to the Delivery
Engine. The following tables describe the contents of each.
File menu options
294
Menu option
Function
New Document
Open Document
Save
Save As
Menu option
Function
Properties
Close
Function
List of available
information sources,
for example,
MicroStrategy Tutorial
or User Information
New Information
Object
Existing Information
Object
295
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
296
C H A PT E R
25
Subscription Set
Properties Dialog Box
25.
25
The Subscription Set Properties dialog box allows you to add, remove, or
modify SQL statements to be used before and after subscription sets are
executed. Pre- and Post-SQL statements are optional for subscription set
execution. You can also enable one-time immediate delivery for
subscriptions that is similar to the Send Now functionality in
MicroStrategy Web.
For steps to create and use the subscription sets, see Creating and
Managing Subscription Sets.
Accessing the Subscription Set Properties dialog box
You can access the Subscription Set Properties dialog box from the Static
Subscription Set Editor or the Dynamic Subscription Set Wizard.
In the Static Subscription Set Editor, from the Edit menu, select
Subscription Set Properties.
Or
In the Dynamic Subscription Set Wizard, on the Pre- and Post-SQL
Definition page, click Define.
Prerequisites
Before you begin using the Subscription Set Properties dialog box, you
should:
Identify the SQL statements needed before segmentation and after
service execution.
Determine the name, connection information, number of necessary
retries, service execution impact, and the SQL definition for these SQL
statements.
For more information, see Subscriptions and subscription sets.
297
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
298
Description
Statement Name
Connection
Data Source Name
Login name
Password
Database
Test Connection
SQL Retries
Number of retries for failed
SQL statement executions
Pre SQL
Post SQL
Optional
Required
299
I
N
T
E
R
F
A
C
E
Box/Button Name
Description
Error
I
N
T
E
R
F
A
C
E
SQL Definition
SQL Statement
Insert Parameter
300
C H A PT E R
26
Question Object
Dialog Set
26.
26
The Question Object dialog set is a series of dialog boxes that allow you to
quickly create a new question object, either from a MicroStrategy or User
Information Source. A question object is a set of questions that the end user
answers to personalize the content of an information object. They allow
services to be personalized at the information object, or report, level.
Before you begin using the Question Object dialog set, you should:
Understand what a question object is and how it is used.
Ensure that the system administrator has defined an information source.
Ensure that, in the project source, a report has been set up to be
associated with the question object.
I
N
T
E
R
F
A
C
E
302
You can create two kinds of question objects. Each has its own potential
problems.
Question object using personalized report execution
Question object using personalized page execution
Question object using personalized report execution
303
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
304
C H A PT E R
27
Service Editor
27.
27
The Service Editor allows you to create a new service or modify the
properties of an existing service. It provides access to all service-level
settings and is more robust and flexible than the Service Wizard, which
provides a simplified but less powerful way to build services.
Use the Service Editor to do the following:
Add multiple publications to a service to support more than one set of
devices per delivery method or more than one locale
Use existing publications, schedules, and subscription sets
Create new publications, schedules, and subscription sets on the fly
Set service properties such as start and end dates, service priority
segment size, and service expiration
Edit an existing service, whether it was created through the Service
Editor or Service Wizard
For steps to create a service using the service editor, see Creating and
Managing Services and Schedules.
Use the Service Wizard to:
Create new documents, schedules, and subscription sets on the fly
Be guided step by step through the process of creating a new service
using multiple delivery methods and the default devices and locale
For more information on the Service Wizard, see Service Wizard.
Accessing the Service Editor
Before you begin using the Service Editor, it is recommended that you
understand how services integrate with publications and subscriptions
For more information, see Creating Services.
305
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
General Properties
Service Execution Timeout
Save Service dialog box
It also has a Menu bar that contains the File, View, Edit, and Help menu
items.
Menu bar
The File and Edit menu bar options contain items that are unique to the
Delivery Engine. The following tables describe the contents of each.
File menu options
Menu option
Function
New...
306
Service
Publication
Schedule
Subscription Set
Open Service
Allows you to save and close the service you are currently
defining and open a different existing service
Menu option
Function
Definition
Message Contents
The locale drop-down list displays the list of devices and publications
supporting the devices for that locale in the display pane. This is useful for
quickly determining what publications support a particular device for the
locale.
If multiple publications use the same ITM and device, only the
one with the highest priority is displayed in the
ITM/Device/Publications grid. A subscriber receives the
highest-priority publication with a locale and device that
matches the locale and device defined in the subscription. An
icon is displayed next to the publication to warn of a possible
conflict.
307
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
You can also right-click within the Available Subscription Sets and
Schedules tree to create a new subscription set or schedule or to edit an
existing subscription set or schedule. See chapter 12, Dynamic
Subscription Set Wizard and chapter 30, Static Subscription Set Editor for
more information on creating or editing a subscription set. See chapter 29,
Defining when a service is sent: Schedule Wizard for more information on
creating or editing a schedule.
You can Add or Remove them from the Selected Subscription Sets and
Schedules grid to pair subscription sets and schedules. A pair is valid
when it contains one schedule and one subscription. A green check means
the pair is valid; a yellow and red X means that it is not valid. One
subscription set can be paired with multiple schedules.
You can sort paired subscription sets and schedules by clicking the
Subscription Set or the Schedule column header. This is useful when you
want to view all schedules paired with a subscription set or all subscription
sets paired with a schedule.
General Properties
The General Properties tab allows you to define the following:
Start Date and End Date (optional): The service executes between
these two dates on the interval determined by its schedule; if they are
not changed, the service starts today and runs indefinitely.
The service execution period determines when a service will run
automatically as scheduled. Outside of this time period, the service is
not executed even if scheduled.
Priority: Determines which services will be executed first; higher
priority services run before lower priority ones.
Segment Size: The number of recipients per segment; at run time, the
total number of recipients will be divided into segments of this size.
Description: A description, up to 5000 characters, of the service.
Segment Execution Timeout: Specifies the timeout period for each
segment in this service; the default is 1 hour.
308
The segment expiration period should be set according to how long the
service content is expected to take to be sent to the number of recipients
a segment can have. The purpose is to avoid hanging the system if a
segment does not execute. The system retries up to the number of times
set in the System Governing Settings dialog box. (For more
information, refer to the Narrowcast Server System Administrator
Guide.)
A services start date and its schedule interact with each other to determine
an overall schedule for the service. Schedules define particular
periodicities (every week, every second Tuesday, every third month), and
a services start date is the starting point for the calculation of these
periodicities. Thus, two services that use the same schedule but have
different start dates can have very different overall schedules.
For example, a quarterly update service that uses an Every Three Months
schedule and starts on January 1, generates messages on April 1, July 1,
October 1, and January 1. The same service starting on February 1,
generates messages on May 1, August 1, November 1, and February 1. The
only difference between these two services is that they have different start
dates, thus changing the starting point of the schedule calculation. Note
that in the case above, the best implementation of a quarterly schedule is
to build a schedule that explicitly states the months in which to run, thereby
avoiding the issue of having execution times that depend on the start date.
To verify that a service start date and schedule are interacting as expected,
activate the service. Then view the Scheduled Services folder under the
Administration folder when the system is running to see when the service
will be triggered in the future.
309
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
310
C H A PT E R
28
Publication Wizard
28.
28
311
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
Delivery Method
Selection Locale
Supported Devices
Message Contents
Delivery Method Rules
Summary
Click Next to advance to the next page of the wizard. Click Back to go
back to the previous page. Click Cancel at any time to exit the wizard
without saving any changes.
Welcome
This page provides a brief summary of the steps required to create a
publication. You can choose not to display this page again in the future.
Delivery Method
This page provides a list of every information transmission module (ITM)
registered in the system. Choose the Delivery Method that will deliver the
service. Once the publication has been saved, you cannot change the ITM
without redoing the entire publication definition. In effect, it is same as
deleting the publication and starting a new one.
Selection Locale
This page provides a list of locales available in the system. Choose the
Selection Locale that this publication will support. This locale defines
which users will receive the content of this publication. It must match the
312
Supported Devices
The available devices for the delivery method chosen previously are listed
in the Available column. The Add button moves the selected device from
the Available column to the Selected column. The Remove button moves
the selected device from the Selected column to the Available column. The
devices in the Selected column are used for the publication.
Message Contents
The Available Documents browser on the left displays the Applications
folder. On the right, the Content Sections are listed, which are place
holders provided by the ITM. For each Publication area, select one or more
documents, which define the content of the publication.
You can create a new document by clicking anywhere in Available
Documents and clicking New. The New Document dialog box opens.
You can edit an existing document in both browsers by selecting it and
clicking Edit. The appropriate document editor opens.
When you select a document from the browser, the areas to which it can be
added are displayed in bold type. Choose an area and click Add. If the Add
button is unavailable, the selected document-section combination is not
allowed by the ITM. For more details, click Rules to display the Content
Definition Rules dialog box. This summarizes the rules specified by the
ITM. Until these rules are satisfied, the Next button is not enabled and you
cannot complete the publication. For example, if the E-mail (SMTP) ITM
Publication Wizard layout
313
I
N
T
E
R
F
A
C
E
must have at least one document in the Subject, Plaintext Body, or HTML
Body sections, the Next button is not enabled until you add a document to
one of those sections.
Once a document has been added to a section, you can select the Do not
deliver if document fails check box under the Document Sections tree. If
this option is chosen, and the document cannot retrieve content from its
information source or the content cannot be formatted, the publication is
not sent.
I
N
T
E
R
F
A
C
E
The Remove button deletes the selected document from the document
section.
The Publication Sections available for the E-mail (SMTP) ITM are as
follows:
Subject
Message body (Text)
Message body (HTML)
Text and binary attachments: used to attach any binary files such as
WAV, zip, and the like
Execution control (advanced): overrides the default information
transmitter settings; see Appendix A: E-mail and Wireless (SMTP) ITM
Execution Control Documents for more information
For the E-mail (SMTP) ITM, one document is required, but this
document can go into any Publication Section.
The Publications Sections available for the Print ITM are as follows:
cover page: allows one or more text or HTML documents; these are
printed first in the order they appear in the interface
314
The Publications Sections available for the File ITM are as follows:
saved documents: requires at least one document of any type; one or
more are allowed
execution control (advanced): allows only one text document; this
document is optional. For more information, see Appendix B: Changing
File Names and Extensions: Execution Control Documents.
SMS (SMPP) ITM Publication Sections
The Publication Sections available for the SMS (SMPP) ITM are
message body: required and limited to one plaintext document)
execution control document (advanced): overrides the default
information transmitter settings; this document is optional and limited
to one plaintext document. For more information, see Appendix C: SMS
(SMPP) ITM Execution Control Documents
Web (Portal) ITM Publication Sections
The Publication Sections available for the Web (Portal) ITM are as
follows:
document body: can be one HTML or one plaintext document
attachments: can be any number and any type of documents)
link rendering style: an XSL stylesheet file that transforms ITMgenerated XSML into hyperlinks. These hyperlinks are then added to
the bottom of the HTML message body for Subscription Portal
messages. By using a different XSL stylesheet, the appearance of these
hyperlinks can be changed.
Wireless (SMTP) ITM Publication Sections
The Publication Sections available for the Wireless (SMTP) ITM are as
follows:
subject
message body (Text)
message body (HTML)
315
I
N
T
E
R
F
A
C
E
text and binary attachments: used to attach any binary files such as
WAV, zip, and the like
execution control (advanced): overrides the default information
transmitter settings; see Appendix A: E-mail and Wireless (SMTP) ITM
Execution Control Documents for more information
I
N
T
E
R
F
A
C
E
Summary
This page provides a summary of the selections you made while building
the publication. Review the information and click Finish to create the
publication.
316
C H A PT E R
29
Defining when a
service is sent:
Schedule Wizard
29.
29
The Schedule Wizard allows you to quickly create a new schedule or edit
an existing schedule, which is the definition of the times or frequencies a
service is executed.
The Schedule Wizard does not define a services start and end
dates; these are defined using the Service Editor.
317
I
N
T
E
R
F
A
C
E
Click Next to advance to the next page of the wizard. Click Back to go
back to the previous page. Click Cancel at any time to exit the wizard
without saving any changes.
Introduction
I
N
T
E
R
F
A
C
E
Recurrence Pattern
This page lets you to set the Recurrence Pattern, which is a schedule set
to run the service. This schedule can be set at daily, weekly, monthly, or
yearly level. Also, select a Start date for this schedule.
If the start date is a valid execution day for the schedule, the
schedule is triggered beginning on that day. For example, if you
specify the schedule to run every Tuesday starting on Tuesday,
October 17th, 2000, the schedule runs on that day and every
Tuesday thereafter.
When you specify a schedule to run on the 29th, 30th, or 31st
day for every x number of months, if the month does not have a
29th, 30th, or 31st day, the schedule is triggered on the last day
of the month.
Interval
Time zone
This page lets you select a Time zone to use as a reference point for the
service execution time. Choose the services Frequency and Starting
Time:
If the Executes once a day option is selected, the service frequency is
set to once a day. You must also enter the service start time.
318
For Send Now schedules, select the On Demand Schedule check box.
Select this check box for a Send Now schedule so that service execution is
stopped before the segmentation of a service is performed. Segmentation
is performed only when there is a subscription associated with the schedule
that is fired. This prevents unnecessary loading of the Distribution
Manager.
319
I
N
T
E
R
F
A
C
E
Summary
This page provides a summary of the selections you made while building
the schedule. The next 20 occurrences that the service will run are also
listed. Review the information and click Finish to create the schedule.]
I
N
T
E
R
F
A
C
E
320
C H A PT E R
30
Static Subscription
Set Editor
30.
30
The Static Subscription Set Editor allows you to create a static subscription
set, and add and delete subscriptions to and from a subscription set. You
can also specify SQL statements to be executed before and after a static
subscription set executes, set properties for individual users and
subscriptions, and enable one-time immediate delivery similar to Send
Now in MicroStrategy Web.
For steps to operate the Static Subscription Set Editor, see Creating and
Managing Subscription Sets.
Accessing the Static Subscription Set Editor
Before you begin using the Static Subscription Set Editor, you should:
Identify which addresses you want to include
Identify which subscriptions you want to remove
Know the SQL statements you want to include for pre-processing and
post-processing (if any)
For more information, see Subscriptions and subscription sets. For more
information on the Subscription Book, see The Subscription Book.
321
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
A menu bar that includes Subscription Set, Edit, View, Tools, and
Help menus
A toolbar that lets you:
Add users
Delete users
Add addresses
Delete addresses
Add subscriptions
Delete subscriptions
You can sort addresses and subscriptions using a column by clicking the
desired column header. Clicking the column header a second time reverses
the sort order.
In addition, buttons appear between the Subscription Set and Subscription
Book lists.
Select Subscribe Addresses to move the subscriptions in the
Subscription Set.
Select Delete Subscriptions to move the subscriptions out of the
Subscription Set.
The following topics discuss menu bar and toolbar options available in the
Static Subscription Set Editor.
322
Function
Save
Exit
Function
Subscribe Addresses
Delete Subscriptions
Edit
Subscription Set
Properties
New User
Delete Users
New Address
Delete Addresses
323
I
N
T
E
R
F
A
C
E
Menu option
Function
Status Bar
Refresh
Function
Sort...
Ascending
Descending
Remove Filter
The toolbar
The Toolbar contains the most frequently used menu options. The details
of the options are as follows:
Save and Close saves and closes the subscription set.
New User opens the User Properties Editor, allowing you to add a
new user to the Subscription Book.
Delete Users deletes the selected user.
New Address opens the User Properties Editor for the selected user,
allowing you to add a new address for that user in the Subscription
Book.
Delete Addresses deletes the selected address.
Subscribe Addresses adds the address highlighted in the Subscription
Book to the subscription set.
324
325
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
326
C H A PT E R
31
Service Wizard
31.
31
The Service Wizard guides you through the steps of creating a new service,
including selecting a delivery method, developing documents with
dynamic content, and defining a schedule and subscription set. The Service
Wizard allows you to select as many delivery methods as are available in
your system. The resulting service will support users using the system
locale and all devices for the chosen delivery methods.
The Service Wizard creates a fully-functional service and all supporting
application objects required for a fully-functional Narrowcast Server
application. The following objects are created:
Service: A service is created with the name and description entered on
the Service Name page.
Documents: Any documents required to provide the chosen content can
either be created or selected using an object browsing interface.
Schedules: Schedules can be created or selected using an object
browsing interface.
Subscription Sets: Subscription sets can be created or selected using an
object browsing interface.
Use the Service Wizard to:
Create new documents, schedules, and subscription sets on the fly
Be guided step by step through the process of creating a new service
using multiple delivery methods and the default devices and locale
edit existing service
Use the Service Editor to:
Add multiple publications to a service to support more than one set of
devices per delivery method or more than one locale
Use existing publications, schedules, and subscription sets
Create new documents, schedules, and subscription sets on the fly
327
I
N
T
E
R
F
A
C
E
Set service properties such as start and end dates, service priority
segment size, and service expiration
Edit an existing service, whether it was created through the Service
Editor or Service Wizard
For more information on the Service Editor, see Service Editor.
I
N
T
E
R
F
A
C
E
328
Help information about the current page is displayed in the help window
on the right. For more in-depth information about the page, click Get more
help at the bottom of the window. To close the help window, click the
question mark in the far right. Clicking it again reopens the help window.
Welcome
This section contains one page, Welcome. The Service Wizard guides you
through creating a service in three steps:
Selecting the delivery method
Specifying message contents
Defining subscription sets and schedules
You can select whether to display this page in the future.
Delivery Methods
This section contains one page, Delivery Methods. Select one or more
delivery methods. The following are always available:
E-mail (SMTP)
Web (Portal)
Wireless (SMTP)
SMS (SMP)
Print
File
Message Contents
This section contains the Message Contents page and a page for each
delivery method selected in the previous section. Each of these pages is
named <Delivery Method> Content, where <Delivery Method> is the
name of the selected method, for example E-mail (SMTP) Content.
329
I
N
T
E
R
F
A
C
E
Each content page allows you to specify the content for each delivery
method selected. For each delivery method, you can create new
documents, insert existing documents, edit existing documents, save the
document for use outside this service, verify the rules for content, and
specify error handling. Each delivery method must have a certain amount
and type of content specified for it.
I
N
T
E
R
F
A
C
E
330
You can elect to include a compressed, or zipped, file for one content
section using the selected delivery method. Several settings must be
specified to produce the zipped file. For more information, see
Compression Properties dialog box.
Below the box listing the sections a message appears that tells you the type
of content that must be included for this delivery method. Once you add
the appropriate content, the message disappears.
Select the Show advanced content sections check box to see additional
content sections. These are sections not needed for basic applications, but
which can provide additional power and flexibility for advanced users. For
more information, see Creating Publications and Content Section
Documents.
To edit a document already inserted, highlight it and click Edit. You can
also right-click on a document to access the same functionality as that
provided in the toolbar.
For more information on the rules and error handling settings, see the
following topics:
Delivery Method Rules
Error Handling dialog box
331
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
Save As: Click to save the selected subscription set or schedule and
make it reusable in another service. By default, new subscription sets
and schedules are embedded and not available for other services.
You can insert multiple subscription sets and schedules into a service.At
least one schedule must be associated with each subscription set
For more information on the Schedule Wizard, see Defining when a service
is sent: Schedule Wizard.
For more information on working with subscription sets, see the following
Interfaces topics:
Dynamic Subscription Set Wizard
Static Subscription Set Editor
Use an existing schedule dialog box
This dialog box allows you to select an existing schedule to insert into the
service. By default, the existing schedules in the Schedules folder are
displayed. Select a schedule and click OK to insert the schedule, and close
the dialog box.
Use an existing subscription set dialog box
The Use an existing subscription set dialog box lists the subscription sets
that you can add to a service. Select a subscription and click OK to use the
subscription, and close the dialog box.
Save As dialog box
The Save As dialog box lets you to save the selected subscription set or
schedule. Choose the folder in which to save the file. Enter a name and
click Save.
332
Service Summary
This section includes one page, Service Summary. This page provides an
overview of the service definition, including a list of the content,
subscriptions and schedules, and general settings. If any red text appears,
you must go back to the appropriate wizard pages and complete the service
definition as directed. You cannot continue without doing this.
To change general settings for this service, click Modify General
Settings. The General Service Settings dialog box opens.
If no red text appears in the service definition, click Finish and save the
service and return to the Narrowcast Administrator. To run the service
immediately, highlight the service and click Run Immediately.
For more information on service settings, see General Service Settings
dialog box.
333
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
Medium
Minimum
None
Maximum (slowest) is selected by default.
For more information, see Compressed documents.
Click OK to save your changes and return to the delivery method content
page.
335
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
Configuring the timeout too low will cause the service to fail
unnecessarily.
The system tries to re-execute the segment for the number of times
specified in the Maximum failover count in the System Settings dialog
box. However, if this time taken exceeds the segment execution
timeout, the service fails.
For example, you have a service in which you have set the Segment
Execution Timeout as 10 minutes, and the Maximum failover count as
10. When the segment is assigned for the first time, it takes 10 minutes
to execute. If it fails and is reassigned, the segment time is reset. The
failover segment can use the whole segment timeout time, which is 100
minutes, to execute. As a result, the service has a total of 110 minutes to
successfully execute the segment.
The Information Transmission Modules are not affected by the
timeouts. They have an expiration by date for User, Address, or
Subscription. If a user, address or subscription expires while a service is
being executed, the service expires.
For more information on the System Settings dialog box, refer to the
Narrowcast Server System Administrator Guide.
Service Execution Status - specifies the service should be failed if any
of the segment fails and the remaining service segments should also be
failed.
The Fail service if any segment fails check box causes the service to
fail if any of the segment fails. The Cancel remaining service
segments check box causes the remaining service segments to be
cancelled.
337
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
338
C H A PT E R
32
Subscription Book
Editor
32.
32
Before you begin using the Subscription Book Editor, you should:
Ensure that your system administrator has set up the appropriate
information transmitters and devices.
Ensure that your system administrator has set up the information
sources.
Collect the appropriate user information, including login ID, locale, and
personalization.
Collect the appropriate address information, including physical address,
device, and delivery window.
For more information on the above topics, see The Subscription Book.
339
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
A menu bar that includes Subscription Book, Edit, View, Tools, and
Help menus.
A toolbar that lets you:
The following topics address the menu bar and toolbar options available in
the Subscription Book Editor.
Menu bar
The Subscription Book, Edit, View, and Tools menus contain items
unique to the Subscription Book Editor. The following tables describe the
function of these menu options.
Subscription Book menu options
Menu option
Function
Exit
340
Menu option
Function
New User
Delete Users
Menu option
Function
New Address
Delete Addresses
Edit
I
N
T
E
R
F
A
C
E
Function
Status Bar
Refresh
Function
Sort...
Ascending
Descending
Remove Filter
Removes the filter from the list for the selected field
Toolbar
The most frequently used menu options are placed on the toolbar where
they are accessible by clicking buttons. The use of these buttons is
described below.
New User opens the User Properties Editor. This editor allows you to
add a new user to the Subscription Book, and define personalization and
other characteristics for the user.
Delete Users deletes the selected user or users.
Subscription Book Editor layout
341
New Address opens the User Properties Editor for the selected user,
allowing you to add a new address for that user in the Subscription
Book.
Delete Addresses deletes the selected address.
Edit opens the User Properties Editor for the selected user, in which you
can edit the user login, address, preference, authentication and security,
and user information for this user.
I
N
T
E
R
F
A
C
E
342
C H A PT E R
33
Subscription Book
Synchronization
Wizard
33.
33
343
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
344
Welcome
This page provides you with a summary of what you can do in the
Subscription Book Synchronization Wizard. Each step is described on this
page.
I
N
T
E
R
F
A
C
E
Synchronization Options
This page allows you to:
Select the source for synchronization
Select the type of synchronization
The Source Type section allows you to specify the source for
synchronization information. This can be one of two types of flat files:
Lightweight Directory Interchange Format (LDIF) File
CSV File
Select the source type from the Source Type drop-down list. Then browse
to and select your source file in the File Location box, or enter the path
and file name.
If you select CSV File as the source type, you can select a separator,
including a comma, space or tab from the Separator Character dropdown list. You can specify the column to use for the distinguished name.
Two types of synchronization are available in the Synchronization Type
section, which are represented by two radio buttons:
First-time import. Enter name for user synchronization tables: By
default, this option is selected, the first time you use this wizard. Enter
the prefix to use for the user synchronization table.
Reimport using previous synchronization table: Use this whenever
you import using the same synchronization table you have used for
previous imports. This is selected by default the second and succeeding
times you use this wizard. Select the prefix to use for the user
synchronization table.
In addition, you need to select the appropriate import settings. Click
Synchronization Settings to access the Synchronization Settings dialog
box.
345
I
N
T
E
R
F
A
C
E
The first table lists all user properties in the Subscription Book User
Properties column such as name, locale, activate and expire status,
password, and password hint. The Source File Attributes column
provides a drop-down list in each row. Each drop-down list contains all
source file attributes where only one attribute can be specified for each
row. For first-time synchronizations, blank is selected by default. For
resynchronizations, the items are preselected to represent the mapping
used during the last synchronization. If nothing is selected and a user is
created, the user is created with the same default settings used in
Narrowcast Administrator.
At runtime, all mapped user attributes are imported. If nothing is selected
for optional user attributes, these attributes will not be imported. If this is
an existing user and nothing is selected for a given attribute, existing
attribute is not overwritten unless you select to replace existing users in the
Synchronization Settings dialog box. If this is a new user and nothing is
selected for a given attribute, the default used when creating users through
Narrowcast Administrators will be applied.
If the Enable Smart User Remapping check box is selected, the
Subscription Book Synchronization Wizard:
Identifies users in the synchronization file who are not mapped to
Subscription Book users.
Identifies unmapped users in the Subscription Book.
Determines which unmapped Subscription Book users have the same
user name as unmapped synchronization file users.
346
If the user names match, users in the synchronization file are automatically
moved to the Users Available for Remapping table on the User Addition
or Mapping page. Users in the Subscription Book with matching names are
also moved to the Users Available for Remapping table and mapped to the
corresponding new users in the synchronization file in the Remove Users
table on the User Removal or Mapping page. This is useful when a large
number of users should be remapped as the process is then more
automated. However, each mapping can be changed or not performed, as
needed, on the appropriate wizard page.
In the Address Property Mappings section, the Address Mappings dropdown list allows you to map address attributes to one of several addresses.
This list includes address mappings that represent the action of gathering
information from the synchronization source and mapping it to one
address.
Click Create Address Mapping to create a new entry in the list.
Creating a new address mapping resets the table to its defaults
(described below) so that source file attributes can be mapped to address
properties for this address.
Click Delete Address Mapping to delete an address mapping.
Physical Address and Address Name are required but the same attribute
can be used for both. The attribute name specified for the physical address
should be used along with the users distinguished name to synchronize the
address. Thus a table is created mapping address IDs in the Subscription
Book Repository to a concatenation of the users distinguished name and
the attribute name specified to contain the physical address. This mapping
is stored for each address mapping so that it is available for
resynchronizations. If this is a resynchronization, all existing address
mappings should be shown. Address Display is also required.
The Subscription Book address property mappings table lists all
address properties in the first column, including name, transmitter, device,
and so forth. The Source File Attributes column provides a drop-down
list in each row. Each list contains all source file attributes where only one
attribute can be specified for each row. If this is a first-time
synchronization for the chosen address, Not mapped is selected by
default. If this is a resynchronization for the chosen address, these items
are preselected to represent the mappings used during the last
synchronization for the chosen address. If an address is invalid, this
information is logged to the log file and the address is skipped.
Addresses are mapped by their names. If an address already exists with a
same name as the address being imported, the older address will be
overwritten with the new address. Existing addresses will be preserved
unless you select to delete unmapped addresses in the Synchronization
Settings dialog box.
Subscription Book Synchronization Wizard layout
347
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
Subscriptions
Subscriptions can be synchronized by defining subscriptions for the
available address mappings. The Subscriptions page allows you to
synchronize user subscriptions. If you choose to synchronize this
information, the import file subscription information is always used and
the chosen address is subscribed to the subscription sets indicated.
The Address Mapping drop-down list displays all address mappings
defined on the User and Address Properties page. You must select an
address mapping to reset the default on the table (described below) and
map subscriptions in the table below. An address mapping must exist on
the User and Address Properties page to synchronize user subscriptions.
This page also provides a table to indicate which addresses should be
subscribed to which subscription sets. The details of the columns are:
Subscription Set: Lists all subscription sets in the Subscription Book.
Source File Attributes: Provides a drop-down list in each column.
Each list contains all synchronization file attributes where only one can
be selected for each row. For first-time synchronizations, nothing is
selected by default. For resynchronizations, these items are preselected
to represent the mappings used during the last synchronization for the
chosen address mapping.
Attribute Value Indicating Subscription: This column is enabled only
if a mapping is chosen in the second column. You can enter a string
representing the value that indicates that the selected address should be
subscribed to this subscription set. For example, if you want to
subscribe a particular user to a subscription set, you could select the
attribute givenname and enter givenname=name (where name equals
the users given name. If you want to subscribe a group of users to a
subscription set, you could select a common attribute such as language
and enter language=English (if those users share that value for the
language attribute).
348
At run time, all addresses indicated (by selecting an address mapping) are
subscribed to the indicated subscription sets. Existing subscriptions of the
subscription sets are preserved unless you select Delete subscriptions
from the subscription book that are not found in the synchronization
source in the Synchronization Settings dialog box.
Preferences
User preferences can be synchronized by mapping synchronization file
attributes to each question object. The Preferences page allows you to
synchronize user preferences. This does not allow a user-by-user
specification of whether to use import file preferences information. If you
choose to synchronize this information, the latest information is always
used. The details of the columns are as follows:
Information Source: Lists all information sources.
Object Personalized: Lists all the question objects for the information
sources.
Attribute Containing Preference: Provides a drop-down list in each
row. Each list contains all synchronization file attributes where only one
can be specified for each row. For first-time synchronizations, Not
mapped is selected by default. For resynchronizations, these items are
preselected to represent the mappings used during the last
synchronization. The string returned by the specified synchronization
file attribute is passed in directly as the user preference.
The fourth column provides a drop-down list in each row. This column
is enabled only after the third column is successfully mapped. Each list
contains all synchronization file attributes where only one can be
specified for each row. For first-time synchronizations, nothing is
selected by default. For resynchronizations, these items are preselected
to represent the mappings used during the last synchronization. The
string returned by the specified synchronization file attribute is passed
in directly as the user preference name. The string returned by the
specified synchronization file attribute is passed in directly as the user
preference string, something recognized only by the particular
information source.
Following is a sample preference string for the MicroStrategy information
source.
<rsl>
<pa pt="7" pin="0" did="A20C9CF311D60AE310008BB3D1CEE6A4"
tp="10">
<mi>
<es>
349
I
N
T
E
R
F
A
C
E
<at did="8D679D4B11D3E4981000E787EC6DE8A4"
tp="12"/>
<e emt="1"
ei="8D679D4B11D3E4981000E787EC6DE8A4:1" art="1"
disp_n="Northeast"/>
</es>
</mi>
</pa>
</rsl>
I
N
T
E
R
F
A
C
E
The IDs represented here are IDs for report, attribute, and
attribute element. For more information on the MicroStrategy
information source preference string, refer to Appendix E,
Synchronization Data Types.
Security
User security objects can be synchronized by mapping a synchronization
file attribute to each information source. The Security page allows you to
import user security. If you choose to import this information, the latest
information is always used. This is accomplished in the table, in which the
first column lists all information sources sorted alphabetically, and the
second column provides a drop-down list in each row. Each list contains
all synchronization file attributes where only one can be specified for each
row. For first-time synchronizations, nothing is selected by default. For
resynchronizations, these items are preselected to represent the mappings
used during the last synchronization. The string returned by the specified
synchronization file attributes is passed in directly as the security object.
At run time, the indicated security objects are created. If this is an existing
user, all existing user security objects are deleted.
Following is a sample security string for the user information source.
Authentication:AuthUserName="administrator"
AuthUserPwd="ODEJQGGC"
AuthUserID="54F3D26011D2896560009A8E67019608"
Security:SecurityObject="8D679D3811D3E4981000E787EC6DE8A4:5"
SecurityObjName="Country = Germany"
UserDetailPref:<UserDetail><First_Name Name="First Name"
Default="0"/><Last_Name Name="Last Name" Default="0"
Value="Eberle"/><Middle_Initial Name="Middle Initial"
Default="0"/><Suffix Name="Suffix" Default="0"/><Salutation
Name="Salutation" Default="0"/><Zip_Code Name="Zip Code"
Default="0"/><Title Name="Title" Default="0"/></UserDetail>
350
Authentication
User authentication can be synchronized by mapping a synchronization
file attribute to each information source. The Authentication page allows
you to import user authentication. If you choose to import this information,
the latest information is always used. This is accomplished in the table in
which the first column lists all information sources and the second column
provides a drop-down list in each row. Each list contains all
synchronization file attributes where only one can be specified for each
row. For first-time synchronizations, Not mapped is selected by default.
For resynchronizations, these items are preselected to represent the
mappings used during the last synchronization. The string returned by the
specified synchronization file attribute is passed in directly as the
authentication object. In other words, for a MicroStrategy Intelligence
Server information source, this string is a concatenation of user and
password.
At run time, the indicated authentication objects are created. If this is an
existing user, all existing authentication objects are deleted.
351
I
N
T
E
R
F
A
C
E
Review
A summary of all changes to be made appears on this page. The lists
display all users to be added, removed, and remapped. The User Removal
or Mapping list has two columns for existing and new users, which shows
you how existing users are going to be remapped. Review the summary of
changes and click Next to commit these changes or click Back to modify
these changes.
Finish
The Finish page indicates that you have successfully synchronized or
imported users. Click Finish to close the Subscription Book
Synchronization Wizard.
352
User Settings
353
I
N
T
E
R
F
A
C
E
the source file are updated. Other user properties in the Subscription
Book are maintained and are not reset based on the Subscription Book
Synchronization Wizards default user property values. The Add or
Map Users, Remove or Map Users, and Review pages of the
Subscription Book Synchronization Wizard do not appear if this is
selected.
I
N
T
E
R
F
A
C
E
354
Address Settings
355
I
N
T
E
R
F
A
C
E
356
Preference Settings
357
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
Authentication Settings
358
Default Attribute Values File: This setting points to the file that
specifies the default values for attributes when either no specific
attribute mapping is specified for the attribute or no value is found in the
source file and the attribute is not required. This file can be modified to
give different default values to attributes that are mapped to attributes in
the source file. For example, you can change the devices of addresses
by replacing the value in this file.
Log File: This setting points to the location of the log file if the log file
is generated.
Logging Level: This setting determines how much logging is
performed when the Subscription Book Synchronization Wizard
imports or synchronizes the subscription book information. Select one
of the following:
Log errors and information: logs all actions taken and errors
encountered
359
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
The following list identifies the information and its use in the Subscription
Book Attribute file.
The first item before the colon (:) is the option that appears in the
Subscription Book Synchronization Wizard.
The second item is the user or address property that is available for
synchronization. You can add or remove items from this list to control
what user and address properties are available for synchronization.
The third item controls whether the option is required (true=required,
false=optional). If an item is required, a mapping must be provided in
the Subscription Book Synchronization Wizard. You cannot continue
unless you map all required properties to source file attributes. By
default, User Name, Address Name, Physical Address, and Address
Display are required. All other user and address properties do not need
to be provided and constants in the Default Attribute Values File can be
used.
The fourth item determines which user and address properties are used
to uniquely identify addresses once they are synchronized. This value
should generally not be changed and there must be only one True
value among all address properties and only one True value among all
user properties.
Default Attribute Values File
360
MR_PASSWORD:password
MR_PWD_HINT:password hint
MR_LOCALE_ID:FBBF7C1E37EC11D4887C00C04F48F8FD
MR_STATUS:1
MR_EXPIR_DATE:12/30/9999
ADDR_MR_DEVICE_ID:1D2E6D168A7711D4BE8100B0D04B6F0B
ADDR_MR_PIN:0000
ADDR_MR_DELIVERY_WIN:0x0000000000000000000000000000000000000
00000000000
ADDR_MR_TIMEZONE_ID:21
ADDR_MR_STATUS:1
ADDR_MR_EXPIR_DATE:12/30/9999
The following list identifies the information and its use in the Default
Attribute Values file.
The first item before the colon (:) is the user or address property for
which a default value is being provided.
The second item provides the default value to be used if the
synchronization source file does not provide a value.
Incomplete Records in Source Files
By default, if the synchronization source file does not contain a user name,
physical address, address display name, or address name for a particular
user or address, the synchronization of the corresponding user or address
fails (not for all users or addresses, just for the user or address that is
missing information) and is logged. This is controlled by the fact that
SBRAttributeDefaultValues.txt does not contain default
values for the following properties:
MR_USER_NAME
ADDR_MR_NAME
ADDR_MR_PHYSICAL_ADD
ADDR_MR_DISPLAY
If the synchronization source file does not contain these properties, the
user (for MR_USER_NAME) or address (for all other properties)
synchronization fails and is logged. For addresses, no address is added or
updated. For users, the user does not appear on the User Addition or
Mapping page and is subsequently ignored.
However, you can change this behavior and assign a default physical
address, display name, and address name by adding the corresponding
lines to the SBRAttributeDefaultValues.txt file:
ADDR_MR_NAME:Default Address
ADDR_MR_PHYSICAL_ADD:Physical Address
ADDR_MR_DISPLAY:Address Display
361
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
362
specified comma separated values (CSV) file. Once the export is complete,
the Status message becomes Status: XXX users exported to file where
XXX is the number of users exported.
Click Exit to close the MicroStrategy Intelligence Server User Export
Tool.
The CSV file that is created includes the following types of information for
each user: user name, password, address name, address display, physical
address, Web portal device ID, e-mail device ID, and authentication. Some
or all of this information can be used by the Subscription Book
Synchronization Wizard, depending on the needs of your application. For
more information, see Synchronization with external sources.
363
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
364
C H A PT E R
34
Subscription
Properties Editor
34.
34
Before you begin using the Subscription Properties Editor, you should:
Determine the appropriate preferences for this subscription.
Determine the correct transmission properties for this subscription.
Determine the appropriate status for this subscription.
For more information on the above topics, see Subscriptions and
subscription sets.
365
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
Status tab
Notification tab
Preference tab
When you create a service using the Service Wizard and insert a
subscription set (new or existing subscription set), you can edit the
subscription properties. The Preference tab allows you to specify
preferences for this subscription based on the information objects used in
your services delivery methods. You can specify settings for these
subscription preferences, and also modify or delete each setting.
The default user preference for each personalized object is listed next to
the information source if a default user preference exists for the
personalized object. Subscription preferences apply only to one
subscription, but they override any existing user preferences.
To create a subscription preference, highlight the appropriate personalized
object and click Define Subscription Preference.
If the personalized object is executed using personalized page execution,
the Select Attribute Form dialog box appears. In the Select Attribute Form
dialog box, select an attribute form from a list of available attributes so that
only the content corresponding to that attribute is sent to the subscription
recipient.
If the personalized object is executed using personalized report execution,
the Prompt Resolution Wizard appears.The Prompt Resolution Wizard
allows you to select elements that govern the options that are available
when selecting preferences and to set the first level of information
filtering. You answer a series of prompts to define the subscription
preference.
Transmission tab
Using the Transmission tab you can specify transmission properties that
govern certain information transmitter settings. The transmission
properties depend on the transmitter used by the subscription.
366
For the e-mail transmitter, the transmission properties specify whether the
recipient name should be put in the To:, CC:, or BCC: fields. Click
the button next to the desired setting in the Recipient Field box to specify
where the recipient name should be displayed. By default, the recipient
name is entered in the BCC: field.
For the file transmitter, the transmission properties include the following
selections:
Overwrite files with the same name: Select this check box to
overwrite files when they have the same name. If it is not selected, the
file transmitter uses the device settings (specified by the system
administrator). If these settings are not available, the service fails.
Create required folders: Select this check box to create any folders
that are needed. If it is not selected, the file transmitter uses the device
settings (specified by the system administrator). If these settings are not
available, the service fails.
Append timestamp to file name: Select this check box to add the time
the file is saved to the end of the file name.
There are no subscription-level properties for the print transmitter, the
SMS transmitter or the Portal transmitter.
Status tab
Using the Status tab, you can specify the following:
Status: whether this subscription is active or inactive
Expiration date: whether this subscription has an expiration date
Notification tab
Using the Notification tab, you can notify the user that a file or print
delivery service is complete. Choose from the following:
No notification required: Select this option if user notification is not
required.
E-mail: Select this option if a notification is to be sent through e-mail.
By default, the system sends the e-mail to the address of the user you
have specified in the User Properties Editor.
367
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
368
C H A PT E R
35
Subscription Dialog
Box
35.
35
The Subscription dialog box allows you to select the type of subscription
set you want to create: Static Subscription Set or Dynamic Subscription
Set. For steps to create and use a subscription set, see Creating and
Managing Subscription Sets.
Accessing the Subscription dialog box
Before you begin using the Subscription dialog box, you should know
which type of subscription set you want to create.
For more information about subscriptions, see Subscriptions and
subscription sets.
369
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
370
C H A PT E R
36
36.
36
The User Properties Editor allows you to add users and address in the
Subscription Book, as well as define the personalization for a user. You can
also:
Add addresses to the Subscription Book
Edit users in the Subscription Book
Edit addresses in the Subscription Book
Delete addresses from the Subscription Book
Define personalization for a user
Assign a password for the user
Edit user information
For instructions on completing one of the above tasks, see Managing a
Subscription Book.
Accessing the User Properties Editor
From the Tools menu, select Open Subscription Book. The Subscription
Book Editor opens. From the Edit menu, select New User.
Prerequisites
Before you begin using the User Properties Editor, you should:
Ensure that your system administrator has set up the appropriate
information transmitters and devices.
Ensure that your system administrator has set up the information
sources.
Collect the appropriate user information, including login ID, locale, and
personalization.
Collect the appropriate address information, including physical address,
device, and delivery window.
For more information on the above topics, see The Subscription Book.
371
I
N
T
E
R
F
A
C
E
Login tab
The Login tab allows you to specify the following:
Login ID: An ID of your choice. It must be unique and limited to 127
characters. The \ character is not permitted. The default is New
User.
Password: A password for the user. This is especially useful for selfsubscription applications to preserve user account integrity.
Hint: A hint for the user to help remember the password.
Click Advanced Properties to open the Advanced Properties for New
User dialog box to specify additional user properties.
Advanced Properties for New User dialog box
The Advanced Properties for New User dialog box allows you to specify
the following:
Locale: Defines the type of content that a user receives from a service
which content the user will receive. The locale is used to control
character sets, number formats, date formats, and time formats. Your
system might support multiple locales, but a given user may only have
one locale. This locale must match the selection locale for a given
publication to receive it. The default is System locale.
Status: Allows you to select either to Activate this user or to Expire
this user on, with an expiration date that you specify. When a user
expires, no services are sent to any addresses for this user.
372
It also displays Information showing when the user was created and
modified, and by whom.
Addresses tab
The Addresses tab allows you to create, delete, and rename addresses. To
create a new address, click New Address. To delete an address, select it
and click Delete Address. To rename an address, select it and click
Rename Address.
The Addresses tab allows you to specify the following:
Address Name: A name of your choice. The name is limited to 250
characters. The \ character is not allowed. The address name is
displayed under Available Addresses. The default is New Address 1.
Physical Address: The actual address where the message is sent to the
user. An example is yourname@yourcompany.com. The address is
limited to 250 characters. The \ character is not permitted. The default
is Physical Address.
Address Display: Appears in the To: field in e-mail services. An
example is Last Name, First Name. The address format is limited to 250
characters. The \ character is not allowed. The default is Display
Name.
Delivery Method: The way messages are delivered to this address. The
default is E-mail (SMTP). When you select this, the set of devices
associated with the selected delivery method becomes available.
Device: The device to use to format and transmit to a specific receiver
type. The default is Generic e-mail client.
Click Advanced Properties to open the Advanced Properties for Address
dialog box to specify additional address properties.
Advanced Properties for Address dialog box
The Advanced Properties for Default Portal Address dialog box allows you
to specify the following:
Locale: Selects the Locale of the user to receive the publications.
Status: Indicates whether this address is the default for this user (must
have one default address per user), whether this address is activated, or
whether this address should be expired and the date for the expiration.
373
I
N
T
E
R
F
A
C
E
Delivery Window: Indicates the hours each day during which messages
can be transmitted to this address and the time zone being used for the
delivery window for this address. The default time zone is the time zone
specified in the local machine. In this manner, a user can specify that no
messages should be delivered until 9:00 A.M. Eastern time, and the
delivery window automatically takes into effect time changes resulting
from Daylight Savings Time.
I
N
T
E
R
F
A
C
E
Preference tab
The Preference tab allows you to specify user preferences for the selected
user. All information objects with question objects selected and all
question objects are listed, along with the corresponding information
sources and any previously-defined user preferences. You can create new
user preferences, modify existing ones, or delete user preferences that are
no longer needed.
Specifying preferences uses interfaces supplied by the information source.
Though these interfaces vary for each information source, the
MicroStrategy Information Source provides the following:
Define User Preference dialog box to define user preferences
Prompt Resolution Wizard to specify preferences for personalized
objects that contain prompts
Select Attribute Form dialog box to specify preferences for other
personalized objects
Multiple user preferences can be defined for a given personalized object.
After preferences are defined, you are asked to provide a name for this user
preference. As user preferences are defined, they are added to a drop-down
list next to the question object to which they belong. The default user
preference is identified in the drop-down list with a (default) next to its
name.
User preferences apply to all subscriptions for this user.
If user preferences have already been set, select the user preference you
want from the drop-down list and click Modify to update it or click Delete
to remove it from the selected question object.
374
On the Define User Preference dialog box, click Answer to display the
Prompt Resolution Wizard. This dialog box opens only for personalized
objects with prompts.
The Prompt Resolution Wizard allows you to select elements that govern
the options that are available when selecting preferences and to set the first
level of information filtering. You answer a series of prompts to define
your user preferences.
On the Define User Preference dialog box, click Answer to display the
Select Attribute Form dialog box.
The Select Attribute Form dialog box allows you to select the attribute
elements for an attribute. When the service is executed, the recipients
receive only the page of content that corresponds to the element that you
have selected. Click Purge cache to clear the Intelligence Server's element
cache.
375
I
N
T
E
R
F
A
C
E
I
N
T
E
R
F
A
C
E
376
I
N
T
E
R
F
A
C
E
Middle Initial
Last Name
Suffix
Title
Salutation
Street Address
City
State
Zip Code
Country
You can add or remove user properties within Narrowcast Administrator
by selecting Edit Available User Properties from the Tools menu.
377
I
N
T
E
R
F
A
C
E
378
SECTION III
Application Designer
How Do I...?
III
H
O
W
D
O
I
379
H
O
W
D
O
I
380
C H A PT E R
37
Managing a Channel
37.
37
Click Next.
4.
5.
6.
To display this channel to the end user, select the Channel Enabled
check box.
7.
Click Edit next to the channel of the folder that you want to change.
381
D
O
I
Click Next.
Delete a channel
Steps
1. In the Site Preferences section, click Channels. The Channels page
opens.
H
O
W
2.
3.
D
O
I
382
C H A PT E R
38
Managing Device
Types
38.
38
This chapter describes procedures to create and manage device types used
in services. A device type is a grouping of devices defined in a
Subscription Portal to make it easier for a user to find a certain device. For
a detailed explanation of all device types and their uses, see Device types.
H
O
W
D
O
Steps
1.
Click Create new device type. The New Definition page opens.
3.
4. Type the URLs of the large and small image icons for the device. The
default image icons are available in the
MicroStrategy\Narrowcast Server\Subscription
Portal\asp\images folder. For example, for the Pager device type,
type images\big_pager.gif for large icon, and
images\pager.gif for small icon.
5.
6. Select the Display and Edit fields to display and edit the addresses of
the device type.
7.
383
Click edit device folders... next to the device type of the folders you
want to edit. The Device Folders: <device name> page opens.
3. Select the device folders in the Available list, that you want to activate
for this device type.
4.
H
O
W
5.
D
O
I
Use the toggle switch and move the selected folders to the Selected
list.
Click Next to proceed to the Name and Description page.
3.
384
3. Type the URLs of the large and small image icons for the device. The
default image icons are available in the
MicroStrategy\Narrowcast Server\Subscription
Portal\asp\images folder. For example, for the Pager device type,
type images\big_pager.gif for large icon, and
images\pager.gif for small icon.
4.
5. Select the Display and Edit fields to display and edit the addresses of
the device type.
6.
H
O
W
Steps
D
O
1.
3.
4.
Click Rename.
385
H
O
W
D
O
I
386
C H A PT E R
39
Creating Information
Objects and Question
Objects
39.
39
To make an information object reusable, you may want to create a standalone information object in the following situations:
A service that uses an information object has more than one delivery
method.
The information object is used for other services.
387
H
O
W
D
O
I
H
O
W
D
O
3.
5.
8.
388
9.
report. If you choose to segment it, the report must contain two
segmentation prompts.
11. Click OK to save your changes and return to the Report page.
12. Click Next. The Format page opens. If you have chosen to segment
D
O
I
Select the prompt from the drop-down list to use as the Segment
beginning prompt.
Select the prompt from the drop-down list to use as the Segment end
prompt.
13. On the Format page, select whether to return the report results in a
tabular or graphical format.
14. If you choose graphical format, you can also customize the image
size. Select the appropriate check box and type the width and height of the
image in pixels.
15. Click Next. The Summary page opens.
16. Review the information on the Summary page and click Finish to
create the new information object. If you have chosen the Tabular format
option, the Save XML Information Object dialog box opens. If you have
chosen the Graphical format option, the Save Image Information Object
dialog box opens.
17. Choose a folder to save the object. Type a name for the new
information object and click Save.
H
O
W
389
H
O
W
3.
D
O
I
4.
5.
6.
Click Advanced Options. The Advanced Properties dialog box
opens.
7.
8.
390
9.
10. Click OK to save your changes and return to the Report page.
11. Click Next. The Format page opens.
12. Select whether to return the report results in a tabular or graphical
format.
13. If you choose graphical format, you can also customize the image
size. Select the appropriate check box and type the width and height of the
image in pixels.
14. Click Next. The Summary page opens.
15. Review the information on the Summary page and click Finish to
create the new information object. If you have chosen the Tabular format
option, the Save XML Information Object dialog box opens. If you have
chosen the Graphical format option, the Save Image Information Object
dialog box opens.
16. Choose a folder to save the object. Type a name for the new
information object and click Save.
391
H
O
W
D
O
I
5.
Make the appropriate selection and click Next. One of the following
pages opens:
H
O
W
D
O
I
Click the General tab. Enter the Name and Description of the new
subscription information object.
9. Click the Report Execution tab. To set the cache properties of the
intelligence server, make the appropriate selections in the Intelligence
Server cache section.
392
report. If you choose to segment it, the report must contain two
segmentation prompts.
11. Click OK. You are returned to the Report page.
12. Click Next. The User Properties and Personalization page opens.
13. Select whether the Address ID is generated by the report or retrieved
from the subscription book.
14. Select whether the User ID is generated by the report, retrieved from
393
H
O
W
D
O
I
17. Review the information on the Summary page and click Finish to
create the new information object. The Save XML Information Object
dialog box opens.
18. Choose a folder to save the object. Type a name for the new
information object and click Save.
H
O
W
D
O
5.
Select the report that contains the segment boundaries. The report
must have at least one prompt for segmentation by size.
6.
394
8. Click the Report Execution tab. To set the cache properties of the
intelligence server, make the appropriate selections in the Intelligence
Server cache section.
9.
D
O
13. Review the information on the Summary page and click Finish to
create the new segment information object. The Save XML Information
Object dialog box opens.
14. Choose a folder to save the object. Type a name for the new
4.
5.
395
If the selected report is not valid for this type of question object,
an error message is displayed next to the menu. If the report is
valid, a green check mark is displayed. For more information on
report validation, see Information object validation.
H
O
W
D
O
7.
Click OK. You are returned to the New Question Object dialog box.
8.
9. Choose a folder to save the object. Type a name for the new question
object and click Save.
2.
3. Select an existing question object or create a new one and click OK.
You are returned to the Report page.
396
3.
4.
H
O
W
D
O
Steps
1. On the Information Object Wizards Address Properties page, select
a source for each piece of delivery information. The options include
retrieve from subscription book, generate by report, or apply a constant.
The delivery information fields are listed below:
Address Display
Physical Address
Device
Transmission Properties
PIN
Time Zone
Delivery Window
397
4.
7. Once the Summary page opens, return to the previous How Do I...?
topic to continue creating an information object.
Steps
D
O
1.
2.
3.
398
C H A PT E R
40
Adding Database
Connections in
Subscription Portal
40.
40
D
O
The first time you create a Subscription Portal, the list of database
connections for the Portal Repository, Object Repository, and Subscription
Book Repository is blank. You need to create a new database connection
for each of these databases.
Steps
1.
H
O
W
4.
5. In the SequeLink Server name field, type the name of the computer
on which SequeLink is running .
6. In the ODBC data source name field, type the ODBC DSN as
defined on the computer on which the SequeLink server is running.
399
7.
Type the User name that the Subscription Portal should use to
connect to this database.
8.
9.
10. In the Number of pooled connections field, type a number to set the
11. Click Add database connection to add the new database connection
with the specified detalis. You are returned to the Portal Repository page.
H
O
W
D
O
Steps
3. Select the Use the same database connection for the Subscription
Book Repository check box if the Subscription Book Repository and
Object Repository is stored in the same database location.
4.
400
2.
3.
4.
3.
H
O
W
D
O
I
401
H
O
W
D
O
I
402
C H A PT E R
41
Creating Publications
and Content Section
Documents
41.
41
D
O
Steps
1.
If you are working in the Excel Document Editor and you click
on a spreadsheet tab before this step, the information object
becomes the name of the spreadsheet.
Select an information object and click OK. You are returned to the
document editor and a document element is automatically created.
H
O
W
Only XML information objects can be placed into the same document
element, and therefore be formatted by the same stylesheet. You can add
any number of XML information objects to the same document element.
D
O
Steps
404
7.
8.
D
O
Steps
1.
2.
3. Click and drag the mouse on the worksheet Assign macro dialog box
is displayed.
4. Assign a macro to the new button by choosing from the list of
available macros.
5.
H
O
W
Click OK.
From this point on, whenever you click the new button, the macro is
executed. By incorporating the Excel workbook into a MicroStrategy
Narrowcast Server service, this macro can be sent to all subscribers for
quickly charting the data. For more information on importing this newly
created Excel workbook as a template in MicroStrategy Narrowcast
Server, see Import a file.
405
From the View menu, select Document Element List. This works as a
toggle, hiding and revealing the Document Elements pane on the left.
H
O
W
D
O
2.
3.
8.
Click the Document Excution tab. Set the cache properties of the
document from the Document cache properties section.
9.
10. Click OK in the Desktop Document Selector dialog box. The Save
Desktop Linked Document dialog box opens.
11. Type a new name in the Object Name field.
406
H
O
W
2.
Enter a name for the macro, press ENTER, and note that a recorder
symbol appears. Excel records all actions performed until you click the
recorders Stop button.
3.
Launch the Chart Wizard by selecting Chart from the Insert menu.
4.
Click the recorders Stop button to end the recording session and
save the macro.
To verify that a chart is correct, you can place dummy data that
closely matches the structure and content of the real data in the
appropriate cell ranges. This data should be removed from the
template/workbook before saving.
407
D
O
I
3. Click Browse in the Excel Template area. The Open Excel Imported
File dialog box opens.
H
O
W
4.
Select an Excel document to use as the template and click OK. You
are returned to the Excel Document Editor. The Name and Description of
the template is displayed in the Excel Template area.
D
O
5.
Relative Top: The item is offset from the top of another document
item. Type the number of rows to offset by in the Row Offset cell.
Select the document item number in the Row Reference cell.
408
9.
Relative Top and Relative Bottom are not available for the first
content element in a spreadsheet.
Relative Left: The item is offset from the left side of another
Relative Right: The item is offset from the right side of another
Relative Left and Relative Right are not available for the first
content element in a spreadsheet.
Right-click the sheet tab and select Insert New Information Object.
The Select Information Source dialog box opens. Create a new
information object to supply the sheet name. This setting is the same
as creating a new information object and adding it to the spreadsheet.
For instructions, Create a new information object in a document.
11. Click Save and Close. The Save Excel Document dialog box opens.
12. Choose a folder in which to save the document. Type a name for the
409
H
O
W
D
O
I
3.
D
O
I
You can format the text, using the options in the Format menu.
They are similar to standard Windows formatting choices, such
as font selection, indents, and lists.
4.
7.
410
To insert an image,
From the Insert menu, select Picture. The Picture dialog box opens.
Click Browse, select the image file, and click Open. You are returned
to the Picture dialog box.
From the Insert menu, select Hyperlink. The Hyperlink dialog box
opens.
8.
To create a table,
H
O
W
From the Table menu, select Create. The Create Table dialog box
opens.
D
O
Edit the Table Tag Attributes, if required, to change the size of the
border, cell padding, and cell spacing.
Click OK. You are returned to the HTML Document Editor. The
table is displayed in the Content Definition pane.
You can enter text, document elements, or images into the tables
cells.
You can resize any item, except for static text, by clicking and
dragging one of the items handles. You can also move any
item, except for static text, by clicking on it and dragging it to
the new position.
9. Click Save and Close. The Save HTML Document dialog box
opens.
10. Choose a folder in which to save the document. Type a name for the
new document and click Save.
411
Choose Create a new imported file and click OK. The Import File
dialog box opens.
H
O
W
4.
5.
The file type is automatically set, but you can change it by selecting
a File Type from the drop-down list.
D
O
6.
Click the browse button to locate the file. The Open dialog box
opens.
You can click Modify to select the character set that was used
when the file was created. By default, the System Character Set
(ANSI) is selected. The file is imported using the selected
character set.
7. Select the file to be imported and click Open. You are returned to the
Import File dialog box.
8.
9.
Choose a folder in which to save the imported file. Type a name and
click Save. The Save Imported Document As dialog box opens.
10. Choose a folder in which to save the document. Type a name for the
new document and click Save.
412
413
H
O
W
D
O
I
To add a static text item, type the text in the content definition pane.
H
O
W
D
O
7. Click Save and Close. The Save Plaintext Document dialog box
opens.
8. Choose a folder in which to save the document. Type a name for the
new document and click Save.
Create a publication
Steps
1. Right-click the Applications folder, point to New, and then select
Publication. The Publication Wizard opens at the Welcome page.
2.
Read the introduction and click Next. The Name and Description
page opens.
3.
4.
414
6.
7.
From the Selection Locale drop-down list, select the locale that this
publication will support.
8.
9. From the Available list, select the devices to use and click Add to
add them to the Selected list.
10. Click Next. The Message Contents page opens.
11. Select a document in the Available Documents list on the left. To
create a new document, click New to open the New Document dialog box
and create a document. To edit an existing document, select it and click
Edit to open the appropriate document editor. When you select a document
from the list, the sections to which the document can be added are
displayed in bold in the Content Sections list on the right.
12. Select a section to which to add this document. If the documentcontent section combination is valid, the Add button becomes available.
Refer to the tips area at the bottom of the page for helpful
information on the status of your selections.
13. Click Add to assign the selected document to the selected section.
14. Select the Do not deliver message if document fails check box, if
required. If this option is chosen and the document cannot retrieve content
from its information source or the formatting fails, the publication will not
be sent.
415
H
O
W
D
O
I
17. Review the information and click Finish to create the new
Import a file
Steps
1. Right-click the Applications folder, point to New, and then select
Imported File. The Import File dialog box opens.
H
O
W
2.
3.
The file type is automatically set, but you can change it by selecting
a File Type from the drop-down list.
D
O
4.
Click the Browse button to locate the file. The Open dialog box
opens.
You can click Modify to select the character set that was used
when the file was created. By default, the System Character Set
(ANSI) is selected. The file is imported using the selected
character set.
5. Select the file to be imported and click Open. You are returned to the
Import File dialog box.
6.
7.
Select a folder in which to save the file. Type a name and click Save.
416
2.
From the View menu, select Preview. The content definition pane, on
the right, displays a preview of the HTML document.
3.
Double-click the file to reimport. The Import File dialog box opens.
2.
Click the Browse button to locate the file. The Open dialog box
opens.
3.
Select the file to be imported and click Open. You are returned to the
Import File dialog box.
4.
Click OK.
D
O
You cannot change the File Type and Character Set of the file.
H
O
W
3.
5.
417
Steps
1. Create a new document (Excel, HTML, or plain text) or edit an
existing document.
2. In the document editor, double-click on a document element (on the
words Document Element 1or Document Element 2, for example, in
the Document Element pane). The Document Element Properties dialog
box opens.
3.
4.
5.
H
O
W
D
O
This applies to Excel, HTML, and plain text documents, and also to PDF
documents in Web subscription services.
Steps
1. Create a new document (Excel, HTML, or plain text) or edit an
existing document.
2. In the document editor, from the File menu, select Properties. The
Document Properties dialog box opens.
3. Click the Document-Level Error Handling tab, and choose Cancel
this document if all selected information objects fail. Then select one of
the following:
418
One or more check boxes in the list of information objects. All the
selected information objects must fail for error handling to apply to
this document.
4. Select the appropriate check boxes to specify how to apply this error
handling rule:
Return no data: Select to apply the rule for information objects that
return no data.
Return an error: Select to apply the rule for information objects that
fail.
5.
6.
D
O
I
5.
419
H
O
W
D
O
2.
Type
Owner
Creation Time
Modification Time
Description
Determine which reports you want to use for stylesheet testing. If you
plan to use reports with many different characteristics such as subtotals,
thresholds, different arrangements of metrics and attributes in the rows and
columns, and so on, select a representative sample of reports.
3.
Edit the document elements containing these reports and apply the
MSTR7ToHTML-ReturnXML.xsl stylesheet.
4.
Set the information transmitter used for this service to save messages
to file only.
5.
Execute the service and edit the message that is saved to file.
6. Copy the XML structures from this service and save to files with .xml
extensions.
7.
8. In the XML window, click Load and then browse for one of the XML
files that you created.
9.
In the XSL window, click Load and then browse for the stylesheet
that you want to test.
10. Click Transform and then View Source.
11. Repeat steps 8 through 10 for as many reports (XML files) and XSL
H
O
W
D
O
I
421
H
O
W
D
O
I
422
C H A PT E R
42
Creating and
Managing Services
and Schedules
42.
42
Create a service
H
O
W
D
O
You can create a service using either the Service Wizard or the Service
Editor. You may find the Service Wizard easier to use, if you have never
created a service before. If you want more control over how to create a
service, use the Service Editor. The Service Wizard also allows you to
select multiple delivery methods which are available in your system.
Best practices
You may want to create a dynamic subscription in the following situations:
The subscription set varies from one service execution to the next. A
dynamic subscription dynamically generates a list of recipients who
should receive the service.
The subscription is for an alert-driven service. A dynamic service
delivers content to recipients only when a certain criteria is met. For
example, managers are alerted when the performance of their
employees falls below 50%.
The subscription information is created or updated by an external
system. A dynamic service evaluates whether a given parameter has
reached a critical value before a service is executed.
423
From the Welcome page, review the information and click Next. The
Delivery Method page opens.
H
O
W
3.
D
O
4.
Click Next. The first page of the Message Contents section opens. A
list of pages to follow appears on the left, one for each delivery method
chosen in the previous section.
8.
9.
424
H
O
W
D
O
I
3.
4.
5.
Create a service
425
H
O
W
D
O
I
7.
8.
426
In the Service Execution Period section, select the check boxes and
choose the dates from the calender drop-down list to change Start
Date and End Date.
In the Service Priority section, set Priority and Segment Size for
the service.
9.
Time Out at Specific Time, and enter the time and time zone
Offset Timeout from Service Execution Start, and enter the length
of time, in days, hours, or minutes, to run the service
H
O
W
10. When you complete all the tabs, click Save and Close. The Save
Service dialog box opens.
D
O
11. Select a folder in which to save the new service. Type a name for the
Steps
1.
427
H
O
W
D
O
I
For reports subscribed through Narrowcast Server, edit the service that is
used to deliver Excel file attachments:
The steps listed below are applicable to services for both file
and email deliveries.
1. Right-click the service and select Edit with Service Wizard. The
Service Wizard opens.
2. On the Message Contents section, browse to the Excel file
attachment.
3.
Right-click the Excel file attachment and select Edit. The Desktop
Document Selector dialog box opens.
4. Click Advanced Properties. The Advanced Properties dialog box
opens.
5. On the General tab, clear the Include report title check box and
click OK to return to the Desktop Document Selector dialog box.
6.
7.
For reports subscribed through MicroStrategy Web, edit the service that
supports report deliveries for MicroStrategy Web.
428
D
O
Create a schedule
Steps
1. Right-click the Applications folder, point to New, then select
Schedule. The Schedule Wizard opens.
2.
Read the introduction and click Next. The Name and Description
page opens.
3.
H
O
W
429
4.
5.
H
O
W
Daily: The service will run every x number of days or every weekday.
Weekly: The service will run every x number of weeks for any given
days.
Monthly: The service will run any given day or date every x number
of months.
Yearly: The service will run any given day or date in any given
month on an annual basis.
D
O
I
6.
7.
8.
Select the time zone on which to base the service execution time.
9.
Select how frequently your service will run during the day:
Executes once a day: The service will run once a day at the specified
time.
Executes multiple times a day: The service will run multiple times
at the specified interval between the selected start and end times.
Executes all day: The service will run all day at the specified
interval.
box.
430
13. Review the summary information and click Finish to create the new
H
O
W
D
O
3. Select the number and unit of measure to set how far into the future
the service queue shows service executions.
4.
999.
5.
Click OK.
4. If the service has only one subscription set, the service runs
automatically using the subscription set.
431
1.
2.
D
O
I
432
C H A PT E R
43
Configuring
Subscription Sets
43.
43
D
O
Steps
1.
3. On the Select Services page, navigate through the folders until you
locate the application object that represents the service to be configured.
Select the service and click Next to proceed to the Static Subscriptions
page.
4.
433
H
O
W
6.
Set the options for the page by questions and click Next.
D
O
7. Select the warehouse and tables in which you want to store the
subscriptions for the selected subscription set. Click Next.
8.
9. Repeat steps 5 through 9 for all dynamic subscription sets you wish
to configure.
10. Having configured all dynamic subscriptions sets, click Next to
434
3. On the Select Services page, navigate through the folders until you
locate the application object that represents the service to be configured.
Select the service and click Next to proceed to the Static Subscriptions
page.
4.
5.
6.
7.
Configure any additional questions you want the user to answer when
creating a subscription (optional).
8. Click Next to proceed to the Select Tables page and then proceed
with mapping the subscription information to the data warehouse tables.
3. On the Select Services page, navigate through the folders until you
locate the application object that represents the service to be configured.
Select the service and click Next to proceed to the Static Subscriptions
page.
4. Click the configure link in Static subscription sets default settings
table.
5.
D
O
I
Steps
2.
H
O
W
435
6. Configure any additional questions you want the user to answer when
creating a subscription (optional).
7. Click OK and then click Next to proceed to the Dynamic
Subscriptions page.
D
O
2.
3. Select whether you would like to store the answers to this question in
the Subscription Book Repository or in a warehouse.
4. To store the answers in a warehouse, you can either select an existing
storage mapping that has previously been created for this question object,
or you can create a new storage mapping.
5. Continue with the steps to Select tables for question mappings and
subscription mappings and Map question object information to data
warehouse tables and return to this screen
6.
436
4. Using the arrows move the tables to the left and right until all the
required tables are present in the Selected Tables list.
You can use the Filter table names field to restrict the list of
tables names that is returned. You must use the percent (%) sign
after the letter, that is, a%, to return all entries beginning with
that letter or series of letters.
H
O
W
Steps
D
O
1.
2. Select one or more question components and drag them each to one
of the table columns on the right.
437
H
O
W
D
O
2. Select one or more general components and drag each of them to one
of the table columns on the right.
3.
438
H
O
W
D
O
I
439
H
O
W
D
O
I
440
C H A PT E R
44
Creating and
Managing Sites and
Subscription Portal
44.
44
D
O
2.
3.
2.
3.
Click OK.
H
O
W
441
H
O
W
D
O
2.
Click Edit.
3.
4.
Click Next.
5.
6.
Click Next.
7.
Steps
1.
2.
3.
4.
Click Next.
5.
6.
7.
8.
442
Click Next.
Click OK.
H
O
W
D
O
I
1.
3.
Click Delete.
4.
443
H
O
W
D
O
I
444
C H A PT E R
45
Creating and
Managing
Subscription Sets
45.
45
D
O
Steps
H
O
W
3.
445
H
O
W
2. In the Subscription Set Properties dialog box, click the Postexecution SQL Specification tab.
D
O
I
3.
4.
446
4.
H
O
W
D
O
5. On the Name and Description page, type a Name for the subscription
set and then type a description (optional), and click Next.
6. On the Subscription Selection page, select the information object to
be used for subscription, and click Next.
7.
447
H
O
W
D
O
I
5.
Click Save and Close. The Save Subscription Set dialog box opens.
6.
Type a name for the subscription set and select a folder to save it in.
7.
2.
448
Click Yes.
3.
4.
H
O
W
Steps
D
O
In the Subscription Set Properties dialog box, click the Send Now
tab.
3. Select the Enable send now delivery check box to enable one-time
immediate delivery. By default, this check box is cleared.
If you select the Enable send now delivery check box, select a
schedule that has the On Demand Schedule property enabled.
Otherwise, it can result in slower performance due to loading of
the service.
4.
449
5.
D
O
7.
Make the appropriate selections and click Finish. You are returned to
the Subscription Properties Editor - Preference tab.
3.
450
4.
1.
D
O
3.
3.
4.
By default, the expiration date is set to two years from the current
date. Click the down drop-down list to select a different expiration date on
a calendar.
451
H
O
W
3. In the Static Subscription Set Editor, from the Tools menu, select
Filter and governing editor. The Filter and governing editor opens.
D
O
5.
6.
You can also open the Filter and governing editor from the
Subscription Book Editor by selecting Filter and governing
editor from the Tools menu. However, you will not see the
Subscription Set section.
452
C H A PT E R
46
Managing a
Subscription Book
46.
46
D
O
Steps
1.
2.
3.
Select the user for whom you want to add a new address.
4.
From the Edit menu, select New Address. The User Properties
Editor - Addresses tab opens.
5.
H
O
W
9.
Select a delivery method from the list in the Delivery Method box.
453
Start box.
16. To change the delivery window end time, select from the list in the
End box.
17. To change the time zone, select from the list in the Time Zone box.
18. To add a Personal Identification Number for this address, enter a
number in the Enter PIN box. Enter the same number to confirm the PIN
in the Confirm PIN box.
19. Click OK to save your changes and return to the Addresses tab.
20. Click OK to finish and return to the Subscription Book Editor. You
might not see the new address if the filter being applied to the list excludes
it.
H
O
W
D
O
21. From the Subscription Book menu, select Exit to return to the
Narrowcast Administrator console.
2.
3.
4.
On the Login tab, enter a login ID for the user in the Login ID box.
5.
To provide a password hint for the user, enter text in the Hint box.
7.
8. Select a locale from the list in the Select locale box or use the default
suggested.
9.
To deactivate this user, clear the Activate this user check box.
10. To specify an expiration date, select the Expire this user on check
454
11. Click OK to save your changes and return to the Login tab.
12. To add an address for this user, click the Addresses tab. See Add an
address to the Subscription Book.
13. To specify preference personalization settings, click the Preference
H
O
W
D
O
2.
3. Double-click the user you want to modify, or create a new user. The
User Properties Editor opens.
4.
455
8.
9. Make the appropriate selections and click Next to go to the next page
of the wizard.
10. Make the appropriate selections and click Finish. The wizard closes
2.
3. Double-click the user you want to modify, or create a new user. The
User Properties Editor opens.
4.
7.
456
10. Make the appropriate selections and click Finish. The wizard closes
H
O
W
Steps
1.
D
O
2.
From the Tools menu, select Open Subscription Book. The Open
Subscription Book editor opens.
3.
4.
5.
2. From the Tools menu, select Open Subscription Book. The Open
Subscription Dialog box opens.
3.
457
4.
5.
In the Confirm Deletion of user(s) dialog box, click Yes to delete the
user.
6. From the Subscription Book menu, select Exit to return to the
Narrowcast Administrator console.
Steps
D
O
2. From the Tools menu, select Open Subscription Book. The Open
Subscription Book editor opens.
3.
4.
5.
1.
6.
From the Available Addresses list, select the address you want to
modify.
7.
8.
458
4.
5.
6.
D
O
Steps
1.
2.
3.
4.
7.
Wizard.
H
O
W
459
H
O
W
D
O
To add all the users to the Subscription Book, do nothing; leave them
in the Add Users table.
To exclude any users in the import file from being added to the
Subscription Book, select and move them to the Do Not Add Users
table.
460
2.
3.
4.
authentication.
13. Under Security Settings, select Do not define information source
security.
14. Click OK to return to the Subscription Book Synchronization
Wizard.
15. Click Next to go to the Authentication page.
16. Select an import file attribute for each information source.
17. Click Next to go to the Review page.
18. Review the information and click Next to run the synchronization
and go to the Finish page.
19. Click Finish to return to the Narrowcast Administrator console.
461
H
O
W
D
O
I
2.
3.
4.
5.
H
O
W
6.
D
O
8.
Wizard.
15. Click Next to go to the Preferences page.
462
2.
3.
4.
7.
D
O
I
H
O
W
463
16. Select an import file attribute to use for each information source.
17. Click Next to go to the Review page.
18. Review the information and click Next to run the synchronization
and go to the Finish page.
19. Click Finish to return to the Narrowcast Administrator console.
1.
2.
D
O
I
3.
4.
5.
6.
7.
464
security.
14. Click OK to return to the Subscription Book Synchronization
Wizard.
15. Click Next to go to the Subscriptions page to define subscriptions for
H
O
W
D
O
20. Review the information and click Next to run the synchronization
2. From the Tools menu, select Open Subscription Book. The Open
Subscription Book Editor opens.
3. From the Tools menu, select Filter and governing editor. The Filter
and governing editor opens.
4. In the Subscription Book section, specify the maximum number of
users and addresses to retrieve for the Subscription Book.
5.
465
Synchronize users
Steps
1.
2.
3.
4.
H
O
W
type.
5.
D
O
6.
466
To add all the users to the Subscription Book, do nothing; leave them
in the Add Users table.
To exclude any users in the import file from being added to the
Subscription Book, highlight and move them to the Do Not Add
Users table.
H
O
W
D
O
I
Synchronize users
467
H
O
W
D
O
I
468
SECTION IV
Application Designer
Appendixes
IV
A
P
P
E
N
D
I
X
E
S
469
A
P
P
E
N
D
I
X
E
S
470
Appendixes
APPENDIX
A.
where,
CustomHeaderList is a control line feed-delimited list of custom headers.
A custom header should always include a field name, a colon, and an
optional text field.
Example
CustomHeaders=X-FirstHeader: This is a sample header,
add any information you want here
x-SecondHeader: more data
X-EmptyHeader:
471
A
P
P
E
N
D
I
X
E
S
Syntax Rules
The following syntax rules are applicable for the CustomHeaders property
in an execution control document:
The field name always starts with X- or x-, followed by any
printable character except a space, tab, or colon. Only ASCII characters
from 33 to 126 are allowed.
The text field can be any text including space, tab, and colon characters.
A maximum of 75 characters per line is recommended to prevent an old
SMTP gateway from truncating the text.
Multiple lines are allowed to extend a text field to any length. Each new
line must start with a tab or space.
The message fails if any of the headers in the list is malformed.
A
P
P
E
N
D
I
X
E
S
where,
Addresses List
Example
CC='mymail1@server.com;mymail2@server.com'
Control line feeds, spaces, and tabs are not accepted in this list.
Syntax Rules
The following syntax rules are applicable for the CC property in an
execution control document:
All syntax rules for an email address are applicable to the semicolonseparated email addresses in Addresses List.
472
where,
Addresses List
Example
BCC=rcver@server1.com;rcver2@server2.com
Control line feeds, spaces, and tabs are not accepted in this list.
Syntax Rules
The following syntax rules are applicable for the BCC property in an
execution control document:
All syntax rules for an email address are applicable to semicolonseparated email addresses in Addresses List.
The semicolon-separated email addresses in Addresses List should
have same properties in the Information Transmission Module as any
subscription address, except that the Execution Engine does not have
knowledge of them.
473
A
P
P
E
N
D
I
X
E
S
This section is not applicable to rename the zip files. For more
information on dynamically renaming a zip file, see
Dynamically renaming the zip file and files within the zip file in
email attachments.
where,
is the original current name and extension of
the attachment that requires a name change.
Original_file_name.Ext1
New_File_name.Ext2
Example
ChangeAttachmentName=MyAttachments.txt=Sales Report.txt
ChangeAttachmentName=MyAttachments.txt=Sales Report.csv
A
P
P
E
N
D
I
X
E
S
where,
Original_Doc_Name1.Ext1 is the current name and extension of the first
New_File_Name1.Ext2
attachment.
Original_Doc_Name2.Ext1
New_File_Name2.Ext2
attachment.
Example
ChangeAttachmentName=MyAttachments.txt=Sales
Report.xls|MyExcelAtachments.xls=Profit Report.txt
474
Syntax Rules
The following syntax rules are applicable for the ChangeAttachmentName
property in an execution control document:
Single quotes are used, not double quotes.
Document names are case sensitive.
The separator for renaming multiple documents is the pipe symbol (|).
Invalid characters in the new name are replaced with underscore
characters.
Renaming a non-existent attachment has no effect.
Creating more than one ChangeAttachmentName entry in the control
document causes the service to fail.
Renaming the new document into an empty name causes the document
to be given an automatically-generated new name.
475
A
P
P
E
N
D
I
X
E
S
A
P
P
E
N
D
I
X
E
S
where,
My Saved Documents.html
[IO]
476
2.
ChangeAttachmentName=MyAttachments.html=[IO].html
When you execute the service, the attachment is created with the name
Region.Northeast.html.
2.
A
P
P
E
N
D
I
X
E
S
ChangeAttachmentName=MyAttachments.html=[IO].html
When you execute the service, the file is created with the name
Manager.Aoter.Barbara.html.
Dynamically renaming the zip file and files within the zip file in email attachments
477
where,
My Attachment.xls is the current name of the file within the My Zipped
File.zip file that requires a name change.
NewName.xls
My Zipped File.zip
name change.
NewZipName.zip
A
P
P
E
N
D
I
X
E
S
Example
ChangeAttachmentName = My Attachment.xls=MonthlySales.xls |
My Attachment.pdf=[IO].pdf | My Zipped
File.zip=MonthlySales.zip
Syntax Rules
The following syntax rules are applicable for the ChangeAttachmentName
property in an execution control document:
Single quotes are used, not double quotes.
Document names are case sensitive.
The separator for renaming multiple documents is the pipe symbol (|).
Invalid characters in the new name are replaced with underscore
characters at run-time.
Renaming a non-existent attachment has no effect.
478
Other properties
Each of the following properties overwrites the corresponding property
defined in the SMTP ITM properties. The one exception is Importance;
there is no corresponding SMTP ITM property for it to overwrite.
Syntax
SenderDisplayName=XXX
SenderEmailAddress=XXX
ReplyToDisplayName=XXX
ReplyToEmailAddress=XXX
Importance=normal/high/low
DeliveryStatusNotificationEmailAddress=XXX
RequestDeliveryStatusNotificationOnSuccess=yes/no
RequestDeliveryStatusNotificationOnFailure=yes/no
A
P
P
E
N
D
I
X
E
S
Examples
SenderDisplayName=MicroStrategy
ReplyToDisplayName=MicroStrategy
Importance=high
RequestDeliveryStatusNotificationOnSuccess=yes
RequestDeliveryStatusNotificationOnFailure=no
Syntax Rules
The syntax is a subset of the XML definition for tag attribute lists, the part
that is inside tags:
Single quotes are used, not double quotes.
Text is case sensitive.
White space can be any character, including tabs, spaces, carriage
returns, or line feeds.
The order of parameters is arbitrary.
Not all parameters have to be included.
Other properties
479
Escaping rules apply only in decimal format, for example, 	 but not
<.
Replace the XXX in the SenderEmailAddress, ReplyToEmailAddress,
and DeliveryStatusNotificationEmailAddress properties with an e-mail
address in the format name@company.
A
P
P
E
N
D
I
X
E
S
480
APPENDIX
B.
where,
OldFileName.html
NewFileName.html
change.
Example
SaveDocumentAs=HTMLDocument1.html=Sales Report.html
481
A
P
P
E
N
D
I
X
E
S
where,
OldFileName1.html
NewFileName1.html
name change.
name change.
NewFileName2.html
Example
SaveDocumentAs=HTMLDocument1.html=Sales
Report1.html|HTMLDocument2.html=Sales Report2.html
A
P
P
E
N
D
I
X
E
S
Syntax rules
The following syntax rules are applicable for the SaveDocumentAs
property in an execution control document:
Single quotes are used, not double quotes.
File names are case sensitive.
Invalid characters in the new name are replaced with underscore
characters.
Renaming a non-existent file has no effect.
Creating more than one SaveDocumentAs entry in the execution control
document causes the service to fail. If you need to rename multiple files,
use the pipe symbol (|) to separate the files, as shown in the syntax
above for multiple files.
Renaming the new file to a blank name causes the file to be given an
automatically-generated new name.
482
This section is used to rename the file name and extension only
for zip file and the files within the zip file that use the file
delivery method.
where,
A
P
P
E
N
D
I
X
E
S
OldFileName.zip
NewFileName.doc
Example
SaveDocumentFileExtensionAs=
HTMLFileName.zip=SalesReport.doc
483
where,
OldZipFileName.zip is the current name and extension of the zip file that
requires a name change.
NewZipFileName.doc
OldFileName.xls is the current name and extension of the file within the
OldZipFileName.zip file that requires a name change.
NewFileName.doc is the new
NewZipFileName.doc file.
Example
SaveDocumentFileExtensionAs=
FileNameOne.zip=SalesReportOne.doc|XLSFileName.xls=
SalesReportTwo.doc
When you execute the service, the attached FileNameOne.zip file and the
XLSFileName.xls within the attached zip file are renamed as
SalesReportOne.doc and SalesReportTwo.doc.
Syntax rules
A
P
P
E
N
D
I
X
E
S
Information Objects use Narrowcast XSL stylesheets that change the name
of the file. When you create a service that uses an Information Object to
dynamically name a file based on a report object within the report, you
select the appropriate stylesheet to be applied to ensure correct name
change. Stylesheets work to dynamically change the file name as follows:
For a report attribute element, the name of the file is changed to the
name of the attribute element returned by the report filter.
For example, if the Information Object contains a report filter named
Region : Northeast, the file name is changed to Northeast.
For a report attribute in the page-by field, the name of the attached file
is changed to Attributename. Elementname.
For example, if the Information Object contains a report attribute named
Manager in the page-by field and the first attribute element displayed is
Barbara Aoter, the file name is changed to Manager.Aoter.Barbara.
The sample XSL stylesheets are installed in the Delivery
Engine\XSL\TextDocuments folder. The XSL stylesheet details are as
follows:
MSTR8ToText-PageByInfoOnly.xsl for report attribute in the page-by
field.
MSTR8ToText-NoRowHeader.xsl for the report attribute element name.
MSTR8ToText-FilterNameOnly.xsl for the report filter.
where,
My Saved Documents.html
name change.
[IO]
485
A
P
P
E
N
D
I
X
E
S
A
P
P
E
N
D
I
X
E
S
3.
Create a new service for file delivery using the Service Wizard,
which uses the Information Object you created to dynamically name the
file. For more information on how to create a service, refer to the Creating
and Managing Services and Schedules chapter.
4.
486
A
P
P
E
N
D
I
X
E
S
where [IO] is the placeholder for the Information Object icon. For more
information on how to insert the Information Object in the syntax used
in the execution control document, refer to the Creating Publications
and Content Section Documents chapter.
8. Right-click the [IO] icon in the execution control document and
select Edit Information Object. The Information Object Wizard is
displayed.
9. Click Advanced Options. The Advanced Properties dialog box is
displayed.
487
10. Ensure the Include report filter information with report results
check box is cleared.
A
P
P
E
N
D
I
X
E
S
488
15. Define the subscription set and schedule for the service. For more
information on adding a subscription set and schedule, refer to the
Creating and Managing Services and Schedules chapter.
By default, the date and time stamp is appended to the file name.
To remove the date and time stamp from the file name, clear the
Append timestamp to filename check box in the Transmission
tab of the Subscription Properties Editor dialog box.
When you execute the service, the attached file is automatically named as
Northeast.pdf.
You can use special characters such as :, /, *, ?, <, and > in the
name of the filter, except for =.
Create a service designed for file delivery using the Service Wizard,
which uses the Information Object you created to dynamically name the
file. For more information on how to create a service, refer to the Creating
and Managing Services and Schedules chapter.
5.
489
A
P
P
E
N
D
I
X
E
S
where [IO] is the placeholder for the Information Object icon. For
more information on how to insert the Information Object in the syntax
used in the execution control document, refer to the Creating
Publications and Content Section Documents chapter.
9. Right-click the [IO] icon in the execution control document and
select Edit Information Object. The Information Object Wizard is
displayed.
10. Click Advanced Options. The Advanced Properties dialog box is
displayed.
11. Ensure the Include report filter information with report results
13. Right-click the [IO] icon in the execution control document and
select Edit Document Element. The Document Element Properties dialog
box is displayed.
14. From the Document Element Properties dialog box, select
MSTR8ToText-FilterNameOnly stylesheet to retrieve the required
information from the report filter. For more information on how to select a
stylesheet for an execution control document, refer to the Creating
Publications and Content Section Documents chapter.
15. Click Next. The Subscription and Schedule page is displayed.
16. Define the subscription set and schedule for the service. For more
information on adding a subscription set and schedule, refer to the
Creating and Managing Services and Schedules chapter.
By default, the date and time stamp is appended to the file name.
To remove the date and time stamp from the file name, clear the
Append timestamp to filename check box in Transmission tab
of the Subscription Properties Editor dialog box.
When you execute the service, the attached file is automatically named as
Region.Northeast.pdf.
490
where [IO] is the placeholder for the Information Object icon. For more
information on how to insert the Information Object in the syntax used
in the execution control document, refer to the Creating Publications
and Content Section Documents chapter.
8.
491
A
P
P
E
N
D
I
X
E
S
By default, the date and time stamp is appended to the file name.
To remove the date and time stamp from the file name, clear the
Append timestamp to filename check box in Transmission tab
of the Subscription Properties Editor dialog box.
A
P
P
E
N
D
I
X
E
S
When you execute the service, the attached file is automatically named as
Manager.Aoter.Barbara.pdf.
492
where,
OldZipFileName.zip
NewZipFileName.zip
name change.
the
within the
Example
A
P
P
E
N
D
I
X
E
S
You want to create a service to dynamically rename a zip file and files
within the zip file based on the attribute element name returned by the
report filter.
SaveDocumentAs =My Zipped File.zip=MonthlySales.zip|My
Saved Document.pdf=[IO].pdf
Syntax rules
The following syntax rules apply to execution control documents:
Single quotes are used, not double quotes.
File names are case sensitive.
Invalid characters in the new name are replaced with underscore
characters at run-time.
Dynamically renaming the zip file and files within the zip file in file attachments
493
A
P
P
E
N
D
I
X
E
S
494
APPENDIX
C.
where,
XXX
is the actual value of the TON you want to use. Valid TON values are
listed in the table below.
YYY
Description
Unknown
International
National
495
A
P
P
E
N
D
I
X
E
S
Description
Network Specific
Subscriber
Alphanumeric
Abbreviated
Reserved
ZZZ is the actual value of the NPI you want to use. Valid NPI values are
listed in the table below :
A
P
P
E
N
D
I
X
E
S
Description
Unknown
ISDN/Telephone
(E.164/E.163)
Data (X.121)
Telex
National
Private
10
15
Reserved
Example
ReturnAddress=60000
TON=1
NPI=1
496
In this interface, all time/date related values are in ASCII with the
following format:
YYMMDDhhmmsstnnp
Description
YY
MM
month (01-12)
DD
day (01-31)
hh
hour (00-23)
mm
minute (00-59)
ss
second (00-59)
nn
p-+
where,
is the actual expiration date you want to be used by the SMSC for all
messages sent in the publication that contains your execution control
document.
XXX
Example
Expire=081201000000+
497
A
P
P
E
N
D
I
X
E
S
where,
XXX
A
P
P
E
N
D
I
X
E
S
498
4
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
3
0
0
0
0
0
0
0
0
1
1
1
1
1
1
1
1
2
0
0
0
0
1
1
1
1
0
0
0
0
1
1
1
1
1
0
0
1
1
0
0
1
1
0
0
1
1
0
0
1
1
0
0
1
0
1
0
1
0
1
0
1
0
1
0
1
0
1
Meaning Notes
SMSC Default Alphabet
IA5 (CCITT T.50)/ASCII (ANSI X3.4) b
Octet unspecified (8-bit binary) b
Latin 1 (ISO-8859-1) b
Octet unspecified (8-bit binary) a
JIS (X 0208-1990) b
Cyrllic (ISO-8859-5) b
Latin/Hebrew (ISO-8859-8) b
UCS2 (ISO/IEC-10646) a
Pictogram Encoding b
ISO-2022-JP (Music Codes) b
reserved
reserved
Extended Kanji JIS(X 0212-1990) b
KS C 5601 b
reserved
1
0
1
0
1
1
x
x
x
x
1
x
x
x
x
1
x
x
x
x
1
x
x
x
x
reserved
GSM MWI control; see [GSM 03.38] d
GSM MWI control; see [GSM 03.38] d
reserved
GSM message class control; see [GSM 03.38] e
Example
DataEncoding=00000000
where,
XXX
Example
Priority =1
499
A
P
P
E
N
D
I
X
E
S
A
P
P
E
N
D
I
X
E
S
500
APPENDIX
D.
This appendix describes the format of the XML structures used by various
components of Narrowcast Server. This information can be used to
develop custom modules such as information source modules, and to write
custom XSL stylesheets that control how information is rendered and
delivered by Narrowcast Server. The term tag is used instead of the XML
term element to avoid confusion with MicroStrategy object elements.
XML is used throughout Narrowcast Server to share information between
modules. The MicroStrategy Information Source Module uses XML to
represent reports that are displayed in grid mode. The plaintext and Excel
document formatting modules expect XML in a certain format that
represents how data should be rendered or arranged in the documents they
produce. The Web (Portal) Information Transmitter uses XML to
communicate the attached documents for which links need to be provided.
By using custom XSLs that handle these specific XML formats, you gain
more control over how information is rendered and how it is delivered.
For information on the format of the XML structure for the MicroStrategy
Information Source Module, see the Narrowcast Server SDK online help,
available in the MicroStrategy Developer Library, which is sold as part of
the MicroStrategy SDK.
Organization
This appendix provides the following pieces of information about each
XML specification:
Overview: a list of all of the tags in the specification and a diagram
showing how they relate to each other in the XML tree structure
Tags: detailed information about each tag, including the attributes that
apply and whether the tag or any of these attributes are required
Example: a fragment of XML meeting the specification
501
A
P
P
E
N
D
I
X
E
S
Overview
This section summarizes the XML representation of document elements
expected by the plaintext DFM. It details the characteristics of each tag and
the attributes within it.
A plaintext XML document element can have two types of content: text
and table. The only processing performed on text content is character
replacement. For example, if a specific pager cannot support the
<Carriage Return> character, it might be useful to replace that
character with a blank space to maintain the white space arrangement of
the content. This replacement process is applied to both text and table
content.
A
P
P
E
N
D
I
X
E
S
row
Tags
All the tags allowed in a plaintext XML document element are listed
below, along with their meanings. None of the tags have attributes.
Tag Name
Purpose
pt-container
text
table
503
Tag Name
Purpose
row
cell
pt-container
None
Child tags
text, table
text
A
P
P
E
N
D
I
X
E
S
Parent tags
pt-container
Child tags
None
table
pt-container
Child tags
row
504
row
An individual row of data in a table. There must be at least one row in each
table. At least one of the rows in each table must contain at least one cell.
A row with no cells can represent a blank row.
Parent tags
table
Child tags
cell
cell
An individual field or cell of data in a row. Cells with the same ordinal
position in different rows are considered to be part of the same column.
There must be at least one cell in each table.
Parent tags
row
Child tags
A
P
P
E
N
D
I
X
E
S
None
Example
This is an example of a valid plaintext XML document element.
<pt-container>
<text>Northeast Sales Report</text>
<table>
<row>
<cell />
<cell>2000</cell>
<cell>1999</cell>
</row>
<row>
<cell>New York</cell>
<cell>$150k</cell>
<cell>$138k</cell>
</row>
<row>
<cell>Boston</cell>
505
<cell>$82k</cell>
<cell>$86k</cell>
</row>
<row>
<cell>Providence</cell>
<cell>$91k</cell>
<cell>$76k</cell>
</row>
</table>
</pt-container>
A
P
P
E
N
D
I
X
E
S
2000
1999
New York
$150k
$138k
Boston
$82k
$86k
Providence
$91k
$76k
Overview
This section provides an overview of the XML representation of document
elements expected by the Excel DFM. It details the characteristics of each
tag and the attributes within it.
506
507
A
P
P
E
N
D
I
X
E
S
pt-container
table
fonts
font
styles
style
formats
format
row
cell
A
P
P
E
N
D
I
X
E
S
Tags
This section lists all the tags that are allowed in an Excel XML document
element, their meanings, and the attributes each tag can have.
508
Tag Name
Purpose
pt-container
table
fonts
font
styles
style
formats
Tag Name
Purpose
format
row
cell
pt-container
None
Parent tags
None
Child tags
table
table
A collection of data cells arranged in rows and columns, along with the
formatting instructions for each cell. There must be exactly one table and
it must be a child of the pt-container tag. This table must contain at least
one non-empty row and cell. It must also contain exactly one fonts, one
styles, and one formats tag.
Optional attributes
pt-container
Child tags
509
A
P
P
E
N
D
I
X
E
S
fonts
None
Parent tags
table
Child tags
font
font
The definition of a specific font including typeface, size, color, weight, and
modifiers. There can be any number of font tags.
Required attributes
name = the name that a style in this document element uses to reference
this font. It can be any XML-compliant string that does not include the
following characters: &, <, >, ", ', space.
A
P
P
E
N
D
I
X
E
S
color = A number between 8 and 63. If not specified, the default font
color for the cell is used.
size = A number between 1 and 409 representing the font size in points.
If not specified, the value 10 is used.
style = A string representing the modifiers to the font such as italics.
Possible values may include any combination of: ["italic", "strikeout"].
If not specified, no modifiers are used. The strikeout attribute overrides
this attribute.
underline = A string representing the type of underline to apply.
Possible values: ["none" | "single" | "double" | "single accounting" |
"double accounting"]. If not specified, the value "none" is used.
weight = A string representing the weight of the font. Possible values:
["bold" | "normal"]. If not specified, the value "normal" is used.
strikeout = A string indicating whether or not the strikeout modifier
should be applied. Possible values: ["yes" | "no"]. This attribute
overrides the style attribute.
510
Parent tags
fonts
Child tags
None
styles
None
Parent tags
table
Child tags
style
style
name = the name that a cell in this document element uses to reference
this style. It can be any XML-compliant string that does not include the
following characters: &, <, >, ", ', space.
Optional attributes
511
A
P
P
E
N
D
I
X
E
S
A
P
P
E
N
D
I
X
E
S
styles
Child tags
None
formats
513
A
P
P
E
N
D
I
X
E
S
Attributes
None
Parent tags
table
Child tags
format
format
A
P
P
E
N
D
I
X
E
S
Examples of valid format string values and their effects on numeric data:
Positive Number
Negative Number
Format String
1234.567
-1234.567
1235
-1235
#,##0
1,235
-1,235
0.00; (0.00)
1234.57
(1234.57)
0%
123457%
-123457%
00.0,
01.2
-01.2
# ??/??
1234 55/97
-1234 55/97
For date and time formatting, the following character combinations have
special meanings:
"m" represents months as 1-12 and minutes as 0-59
"mm" represents months as 01-12 and minutes as 00-59
"mmm" represents months as a three-character string such as "Jan"
514
formats
Child tags
None
row
None
Parent tags
table
Excel XML format
515
A
P
P
E
N
D
I
X
E
S
Child tags
cell
cell
An individual field or cell of data in a row. Cells with the same ordinal
position in different rows are considered to be part of the same column.
There must be at least one non-empty cell in each table.
Optional attributes
A
P
P
E
N
D
I
X
E
S
type = A number indicating the type of data being returned by the cell.
Possible values:
1 is not used
2 is a two-byte integer
3 is a four-byte integer
6 is not used
7 is a date
8 is a string
Parent tags
row
516
Child tags
None
Color definition
Color is defined three ways for Excel XML.
Excel color index
RGB color
Named color
Excel color index
Colors are predefined in Excel. Each of them has an index. The numbers
you can use are from 8 to 63, as shown below:
A
P
P
E
N
D
I
X
E
S
517
8-Black
9-White
10-Red
11-Bright
Green
12-Blue
13-Yellow
14-Pink
15Turquoise
16-Dark
Red
17-Green
18-Dark
Blue
19-Dark
Yellow
20-Violet
21-Teal
22-Gray25%
23-Gray50%
40-Sky
Blue
41-Light
Turquoise
42-Light
Green
43-Light
Yellow
44-Pale
Blue
45-Rose
46Lavender
47-Tan
48-Light
Blue
49-Aqua
50-Lime
51-Gold
52-Light
Orange
53-Orange
54-Bluegray
55-Gray40%
56-Dark
Teal
57-Sea
Green
58-Olive
Green
59-Olive
Green
60-Brown
61-Plum
62-Indigo
63-Gray80%
RGB color
RBG color uses values from 0 to 255. The following syntax is used:
"rgb(RED,GREEN,BLUE)"
where RED,GREEN,BLUE are the desired values of red, green, and blue.
A
P
P
E
N
D
I
X
E
S
Named color
You can use named values instead of indexes. The names correspond to the
indexes in the table in Excel color index. An example using named colors
is:
border-top-color = "bright green"
Example
Here is an example of a valid Excel XML document element.
<pt-container>
<table>
<fonts>
<fontname="Header"
color="8"
family="Arial"
size="12"
weight="bold"
style="italic"
underline="none" />
518
<fontname="Body"
size="10"
weight="normal" />
</fonts>
<styles>
<stylename="CHeader"
background-color="22"
align="right"
border-bottom="style:medium;color:8"
font="Header" />
<stylename="RHeader"
background-color="22"
align="left"
border-right="style:thin;color:8"
font="Body" />
<stylename="data"
align="right"
font="Body" />
</styles>
<formats>
<format id="1">0000</format>
<format id="2">$?,??0, k</format>
</formats>
<row>
<cell style="CHeader" />
<cell style="CHeader" type="2"
format="1">2000</cell>
<cell style="CHeader" type="2"
format="1">1999</cell>
</row>
<row>
<cell style="RHeader" type="8">New York</cell>
<cell style="data" type="5"
format="2">1350300.0</cell>
<cell style="data" type="5"
format="2">1338100.0</cell>
</row>
<row>
<cell style="RHeader" type="8">Boston</cell>
<cell style="data" type="5"
format="2">820200.0</cell>
A
P
P
E
N
D
I
X
E
S
519
1999
New York
$1,350 k
$1,388 k
Boston
$ 820 k
$ 861 k
Providence
$ 913 k
$ 760 k
Overview
The XML structure used to represent the attachment list is a fairly simple
one. Two tags make up this XML specification:
The atts tag is the root-level tag. This tag is required.
520
Tags
All the tags allowed in an attachment list XML are listed below, along with
their meanings.
Tag Name
Purpose
atts
att
atts
A
P
P
E
N
D
I
X
E
S
None
Child tags
att
att
atts
Child tags
None
Web (Portal) XML format
521
Example
This is an example of a valid attachment list XML.
<atts>
<att name='doc1.txt' type='text/plain' docId='12345'
index='1' />
<att name='doc2.htm' type='text/html' docId='23456'
index='2' />
</atts>
A
P
P
E
N
D
I
X
E
S
Example
522
<UniqueMsgID>0AC6A72F989D4184B13E34BCA30D0D2F23
</UniqueMsgID>
</SubsInfo>
Example
A
P
P
E
N
D
I
X
E
S
523
A
P
P
E
N
D
I
X
E
S
524
APPENDIX
Synchronization Data
Types
E.
A
P
P
E
N
D
I
X
E
S
Authentication
Security
Time zone constants
User properties
Login ID
Password
Data type:
text
Restrictions:
Sample:
user1
Data type:
text
Restrictions:
250 characters
Sample:
pwd
Default:
password
525
Password hint
Locale
User status
A
P
P
E
N
D
I
X
E
S
Data type:
text
Restrictions
250 characters
Sample:
hint
Default:
password hint
Data type:
GUID
Restrictions:
32 characters
Object Repository
Sample:
FBBF7C1E37EC11D4887C00C04F48F8FD
Default:
FBBF7C1E37EC11D4887C00C04F48F8FD
Data type:
Boolean
Restrictions:
0 (inactive) or 1 (active)
Sample:
Default:
Data type:
date
Sample:
12/30/9999
Default:
12/30/9999
Address properties
Address name
Physical address
526
Data type:
text
Restrictions:
250 characters
Sample:
work e-mail
Default:
Default Address
Data type:
text
Restrictions:
250 characters
Sample:
user1@work.com
Default:
Physical Address
Address display
Device
PIN
Delivery window
Time zone
Address status
Data type:
text
Restrictions
250 characters
Sample:
User 1
Default:
Address Display
Data type:
GUID
Restrictions:
32 characters
Object Repository
Sample:
1D2E6D168A7711D4BE8100B0D04B6F0B
Default:
1D2E6D168A7711D4BE8100B0D04B6F0B
Data type:
text
Restrictions:
250 characters
Sample:
5555
Default:
0000
Data type:
binary
Sample:
0x000000000000000000000000000000000000000000000000
Default:
0x000000000000000000000000000000000000000000000000
Data type:
integer
Restrictions:
Sample:
21
Default:
21
Data type:
boolean
Restrictions:
0 (inactive) or 1 (active)
Sample:
Default:
Address properties
A
P
P
E
N
D
I
X
E
S
527
Data type:
date
Sample:
12/30/9999
Default:
12/30/9999
Subscription set
Subscription set
Data type:
text
Sample:
finance department
Data type:
xml
Sample:
Preference
Preference
A
P
P
E
N
D
I
X
E
S
Authentication
Authentication
528
Data type:
xml
Sample:
AuthUserName="Administrator" AuthUserPwd="pwd"
AuthUserID="54F3D26011D2896560009A8E67019608"
Security
Security
Data type:
xml
Sample:
SecurityObject="A6DE4BA111D3ADA0C0002B91E22B284F:8"
SecurityObjName="Sector Group = T"
City
Constant
(GMT+04:00)
(GMT+09:30)
Adelaide
(GMT-09:00)
Alaska
(GMT+06:00)
Almaty, Dhaka
10
(GMT+01:00)
40
(GMT-07:00)
Arizona
55
(GMT+02:00)
26
(GMT-04:00)
(GMT+12:00)
Auckland, Wellington
(GMT-01:00)
(GMT+03:00)
(GMT+04:00)
Baku, Tbilisi
(GMT+07:00)
(GMT+08:00)
15
(GMT+01:00)
12
(GMT-05:00)
43
(GMT+05:30)
30
A
P
P
E
N
D
I
X
E
S
37
5
46
Security
529
A
P
P
E
N
D
I
X
E
S
530
Time zone
City
(GMT-03:00)
Brasilia
20
(GMT+01:00)
11
(GMT+10:00)
Brisbane
18
(GMT+01:00)
58
(GMT+02:00)
Bucharest
19
(GMT-03:00)
42
(GMT+02:00)
Cairo
22
(GMT+10:00)
50
(GMT-04:00)
Caracas, La Paz
44
(GMT)
Casablanca, Monrovia
28
(GMT-06:00)
14
(GMT+06:00)
Colombo
49
(GMT+09:30)
Darwin
(GMT-05:00)
21
(GMT+05:00)
Ekaterinburg
23
(GMT-12:00)
Eniwetok, Kwajalein
16
(GMT+12:00)
24
(GMT)
27
(GMT+10:00)
60
(GMT+02:00)
Harare, Pretoria
48
(GMT-10:00)
Hawaii
29
(GMT+02:00)
25
(GMT+10:00)
Hobart
52
(GMT-05:00)
Indiana (East)
54
(GMT+05:00)
59
(GMT+02:00)
Israel
32
Constant
Time zone
City
Constant
(GMT+04:30)
Kabul
(GMT+11:00)
13
(GMT-06:00)
34
(GMT-02:00)
Mid-Atlantic
35
(GMT-11:00)
45
(GMT+03:00)
41
(GMT-07:00)
36
(GMT+03:00)
Nairobi
17
(GMT-03:30)
Newfoundland
38
(GMT+09:00)
53
(GMT-08:00)
39
(GMT+08:00)
Perth
57
(GMT-06:00)
Saskatchewan
(GMT+09:00)
Seoul
33
(GMT+08:00)
Singapore
47
(GMT+08:00)
Taipei
51
(GMT+03:30)
Tehran
31
(GMT+10:00)
Vladivostok
56
(GMT+09:00)
Yakutsk
61
A
P
P
E
N
D
I
X
E
S
531
A
P
P
E
N
D
I
X
E
S
532
Index
A
activating subscriptions 445
adding
addresses 453
channels, new 381
documents, zipped 427
dynamic text to documents 403
personalization to users 455, 456
site definitions, new 442
SQL for post-service execution 446
SQL for pre-service execution 446
subscriptions to subscription sets 445
users 454
XML information objects, multiple 404
zipped documents 427
additional questions option, Portal Administrator Wizard 172
Address IDs, as preference object 172
addresses
adding 453
deleting 457
display 84
editing 458
formats 284, 285
names 84
overview 83
properties 526
user property 83
Advanced Properties dialog box 264
advanced segmentation control techniques 149
alert-based applications 105
alert-based services
application design 109
importance 105
process flow 106
alerting, edge-triggered 92
alternate questions 170, 176
alternate questions, selecting 436
answer to another question setting, Portal Administrator
Wizard 170
application design
hierarchy 18
requirements 142
application designer tasks xxii
applications, defining with security 38
architecture, component-based 18
associating
macros with events 405
question objects to information objects 396
attachment names, changing 473
attributes, importing user and address 459
authentication 33, 528
authentication and security
adding to users 455
authentication, importing user 461
automatic charts, creating 407
B
Best practice for creating a dynamic subscription service 423
Best practice for creating an information object outside the
service 387
blind carbon copy (BCC) list 473
C
changing
device folders associated with device types 384
folders of services associated with channels 381
views in document editors 406
channels
adding new 381
deleting 382
description 161
folders 162
names and descriptions 162, 283
selecting folder 283
Site Preferences page 282
chart creation in Excel documents 54
charts, creating automatic 407
Choose Subscription Sets dialog box 211
clearing question objects from information objects 397
clients see devices
column widths
in MicroStrategy Web or Desktop 77
setting 235
upgraded systems 78
compressed documents 15
Compression Properties dialog box 334
configuring
dynamic subscription sets 433
page-by questions for dynamic subscription sets 434
Index
I
N
D
E
X
533
D
I
N
D
E
X
534
Index
objects 397
deleting
addresses 457
channels 382
device types 384
site definitions 443
Subscription Portal 443
subscription sets 449
subscriptions 448
users 457
delivery information, defining for subscription information
objects 397
delivery methods
definition 84
E-mail (SMTP) 9
File 10
multiple 177
overview 3
Print 9
SMS (SMPP) 10
Web (Portal) 10
Wireless (SMTP) 9
delivery windows 85
Desktop Document Selector dialog box 213
Desktop documents
creating links to 406
overview 67
device type definitions, reconfiguring 384
device types
changing device folders for 384
creating new 383
deleting 384
name 283
new 163
new definition 283
overview 162
renaming 385
specifying 283
devices
content selection 5
default 164
definition 84, 163
description 22
device file 178
folders 163, 284
multiple end-user 177
multiple sets 177
portal 164
settings 164
Devices and Locale Support dialog box 333
dynamic subscriptions
description 125
implementing 147
non-personalized 197
personalization 108, 116
personalized 201
dynamic text, adding to documents 403
E
edge-triggered alerting 92
edit fields 284
editing
addresses 458
site definitions 442
users 458
EIS interfaces, building in Excel 56
E-mail (SMTP) delivery method 9
E-mail (SMTP) ITM Publication Sections 314
E-mail and wireless (SMTP) ITM execution control
documents 471
blind carbon copy (BCC) list 473
changing attachment names 473
custom e-mail headers 471
other properties 479
e-mail headers, custom 471
e-mail transmitters, transmission properties 367
error handling
alerts 14
document element-level 12
document-level 13, 234
Excel documents 14, 63
properties 12
publication-level 13
specifying rules for document elements 419
specifying rules for documents 418
Error Handling dialog box 335
event-triggered service execution 107, 109, 110
event-triggered services 105
Excel Document Editor 237
Excel documents
accommodating reports of different sizes 62
automatic chart creation 54
building EIS interfaces 56
building pivot tables 58
converting URLs into hyperlinks 61
creating 408
data placement and formatting 53
editor 237
Index
I
N
D
E
X
535
error handling 63
overview 52
preserving leading zeros 62
reports from Intelligence Server 63
strategy 52
using macros 60
VBA macros and viruses 62
Excel XML
color definition 517
formats 506
tags 508
execution control documents
E-mail and Wireless (SMTP) ITM 471
File ITM 481
SMS (SMPP) ITM 495
execution locales 179, 180, 234
execution periods see schedules
Executive Information System 56
expiration 82, 85, 86, 367
expiration dates, setting for subscriptions 451
expiration/validation dates 496
external sources 89
F
File delivery method 10
File ITM execution control documents 481
File ITM Publication Sections 315
file transmitters, transmission properties 367
files
imported versus document 14
importing 416
reimporting to update 417
folders, changing for services associated with channels 381
G
General Service Settings dialog box 335
governing 85, 94
setting limits for subscriptions 452
setting limits for users and addresses 465
H
I
N
D
E
X
536
Index
I
image information objects 27
Import File dialog box 255
import tasks 95
Imported Document Editor 253
imported documents
creating from new imported files 412
overview 67
versus imported files 15
imported files 14
importing
files 416
user and address attributes 459
user authentication 461
user preferences 462
user security 463
user subscriptions 464
users and addresses 95
information delivery platforms xxi
Information Object Wizard 259
information objects
adding multiple XML 404
content 26, 129
creating 28
creating content information objects with personalized page
execution 388
creating content information objects with personalized report
execution 390
creating in documents 413
creating segment information objects 394
creating subscription information objects 392
description 22
error handling 398
image 27
limiting information returned 41
overview 25
role in execution 40
roles 26
segment 27, 149
subscription 26
text 27
types 27
XML 27
information sources
overview 164
security 38
site preferences 285
Use Project Credentials 165
Use User Credentials 165
information transmission modules 164
information transmitters 4, 177
ITM see information transmission modules
modifying
schedule queue parameters 431
subscription preferences for each information source 449
transmission properties for address display 450, 451
MSTRSubscriptions table 175
N
Narrowcast Server SDK 113
nationalities, multiple 178
New Document dialog box 275
NPI see numbering plan indicator property
numbering plan indicator property 495
L
languages see locales
languages, multiple 178
large icon URL 283
leading zeros in Excel documents 62
links to Desktop documents, creating 406
locale objects 179
locales
advanced user properties 372
content 5
description 22
execution 180
multiple languages and nationalities 178
objects 179
selecting for documents 417
selection 33, 179, 180
user 83, 180
using 180
login IDs 82
Login Information dialog box 376
M
macros
associating with events 405
in Excel documents 60
mapping
dynamic subscription information to data warehouse
tables 437
question object information to data warehouse tables 438
messages see services
MicroStrategy Intelligence Server User Export Tool 362
Modify Schedule Queue Parameters dialog box 273
O
Object Repository
overview 160
Portal Administrator Wizard page 281
objects
devices 22
documents 21
information objects 22
locales 22
publications, description 21
question objects 23
schedules 21
services 20
subscription sets 21
viewing properties 420
XSL files 22
organization of guide xxi
P
page-by
answer ID 193
questions 169
subscription ID 188
page-by questions
configuring for dynamic subscription sets 434
configuring for static subscription sets 435
passwords 82
personal identification numbers 85
personalization
adding to users for authentication and security 455
adding to users for preference 456
advanced techniques 34
description 32
Index
I
N
D
E
X
537
I
N
D
E
X
538
Index
Q
Question Object Browser dialog box 302
Question Object dialog box 302
Question Object dialog set 301
question object information, mapping to data warehouse
tables 438
question objects
advanced techniques 35
advantages 35
associating to information objects 396
R
recipients see subscriptions
reconfiguring device type definitions 384
reference material xxii
regional preferences 178
reimporting files to update 417
renaming device types 385
report delivery methods see information transmitters
Report Services documents 67
report sizes in Excel documents 62
report types see documents
reports from Intelligence Server
Excel documents 63
reports see information objects
repositories
selecting Portal Repository 400
selecting Subscription Book Repository 401
Return Address property 495
rules, error handling - specifying for document elements 419
running services immediately 431
S
Save Desktop Linked Document dialog box 219
scalability 130
schedule queue parameters, modifying 273, 431
Schedule Wizard 317
scheduled services, viewing 432
schedules
creating 429
definition 21
delivery, specifying 17
overview 17
security
description 33
importing user 463
information objects 39
information sources 38, 39
objects 43
question objects 39
Index
I
N
D
E
X
539
I
N
D
E
X
sites
definitions 158
names and descriptions 159, 281
preferences 166
slicing and segmentation 130
slicing attributes 136
small icon URL 284
SMS (SMPP) delivery method 10
SMS (SMPP) ITM execution control documents
data encoding scheme 498
expiration/validation dates 496
NPI 495
overview 495
priority 499
return address 495
TON 495
SMS (SMPP) ITM Publication Sections 315
specifying
error handling rules for document elements 419
error handling rules for documents 418
SQL statements 92, 297
adding for post-service execution 446
adding for pre-service execution 446
SQL statements dialog box 299
static content 25
Static Subscription Set Editor 321
static subscription sets
creating 448
description 88
for storage mapping 173
introduction 16
overview 81
status
addresses 85
advanced user properties 372
subscriptions 86, 367
users 83
storage mappings 171, 173
stylesheet files, selecting for documents 417
subscription administrator tasks xxiii
Subscription Book 81
Subscription Book Editor 339
Subscription Book Governing dialog box 243
Subscription Book Repository
additional questions setting 173
answer to another question setting 170
overview 160, 161
Portal Administrator Wizard page 281
selecting 401
Subscription Book synchronization tutorial
540
Index
adding addresses 99
creating subscriptions 99
importing users and addresses 97
introduction 97
remapping users 99
updating users 99
Subscription Book Synchronization Wizard 343
Subscription dialog box 369
Subscription ID
as preference object 172
requirements 141
versus slicing attribute 136
subscription imports see synchronization
subscription information
description 137
location 137
overview 31
store in the Subscription Book Repository 125
subscription information objects
creating 392
overview 26
personalizing content information objects 129
Subscription Portal
advanced configuration 183
application 157
configuring different 441
creating new 441
deleting 443
site, default 155
system 156
user self subscription 155
subscription preferences 33
Subscription Properties Editor 365
subscription sets
concepts 86
configuring 290
configuring page-by questions 434, 435
creating dynamic 447
creating static 448
definition 21
deleting 449
dynamic 89
introduction 16
SQL statements 92
static 87, 88
synchronization data type 528
subscriptions 16, 86
activating 445
adding to subscription sets 445
deactivating 445
deleting 448
importing user 464
subscriptions and subscription sets 86
supporting diverse user populations 177
synchronization
importing or updating users and addresses 95
overview 95
synchronizing users 96
tutorial 97
updating user personalization and subscription 96
with external sources 94
synchronization data types
address properties 526
authentication 528
preferences 528
security 529
subscription set 528
time zone constants 529
user properties 525
Synchronization Settings dialog box 353
synchronizing users 466
System Configuration Wizard 155
System Configuration, Portal Administrator Wizard 278
system performance 34
T
table prefixes
description 158
Object Repository 160
Portal Repository 157
Subscription Book Repository 161
tables, selecting for question and subscription mappings 436
tasks
application designer xxii
overview xxii
portal administrator xxiii
subscription administrator xxiii
text documents
creating 414
overview 64
text information objects 27
time zone constants 529
TON see type of number property
touch points see devices
transmission properties
e-mail transmitters 87, 367
file transmitters 87, 367
modifying for address display 450, 451
overview 87
print transmitters 87
Subscription Properties Editor 366
transmissions see services
Tutorial configuration process 155
type of number property 495
U
updating users and addresses 95
URLs in Excel documents 61
user and address attributes, importing 459
user authentication, importing 461
User IDs, as preference object 172
user locales 180
user preferences, importing 462
User Properties Editor 371
user security, importing 463
user subscriptions, importing 464
users
adding 454
credentials 165
deleting 457
editing 458
export tool 362
information 30
login IDs 82
management 81
overview 82
preferences 33, 172
properties 525
self subscription 155
synchronizing 466
V
VBA macros and viruses in Excel documents 62
viewing
object properties 420
scheduled services 432
XSL stylesheet results 420
views, changing in document editors 406
I
N
D
E
X
Index
541
X
XML
Excel 506
for Narrowcast Server objects 501
format 501
information objects 27
plaintext 502
XML information objects, adding multiple 404
XSL files 22
XSL stylesheets
advantages 68
default Excel documents 74
default HTML documents 70
default stylesheets provided 70
default Subscription Portal attachments 77
default text documents 76
developing and testing 78
using 68
viewing results 420
XML for Narrowcast Server object 501
Z
zipped documents
adding to services 427
overview 15
I
N
D
E
X
542
Index