Migratorfornotestosharepoint 6.6 Userguide
Migratorfornotestosharepoint 6.6 Userguide
Migratorfornotestosharepoint 6.6 Userguide
6.6
User Guide
This guide contains proprietary information protected by copyright. The software described in this guide is furnished under a
software license or nondisclosure agreement. This software may be used or copied only in accordance with the terms of the
applicable agreement. No part of this guide may be reproduced or transmitted in any form or by any means, electronic or
mechanical, including photocopying and recording for any purpose other than the purchasers personal use without the written
permission of Dell Inc.
The information in this document is provided in connection with Dell products. No license, express or implied, by estoppel or
otherwise, to any intellectual property right is granted by this document or in connection with the sale of Dell products. EXCEPT
AS SET FORTH IN THE TERMS AND CONDITIONS AS SPECIFIED IN THE LICENSE AGREEMENT FOR THIS PRODUCT, DELL ASSUMES NO
LIABILITY WHATSOEVER AND DISCLAIMS ANY EXPRESS, IMPLIED OR STATUTORY WARRANTY RELATING TO ITS PRODUCTS
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR
NON-INFRINGEMENT. IN NO EVENT SHALL DELL BE LIABLE FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL, PUNITIVE, SPECIAL OR
INCIDENTAL DAMAGES (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF PROFITS, BUSINESS INTERRUPTION OR LOSS
OF INFORMATION) ARISING OUT OF THE USE OR INABILITY TO USE THIS DOCUMENT, EVEN IF DELL HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES. Dell makes no representations or warranties with respect to the accuracy or completeness of
the contents of this document and reserves the right to make changes to specifications and product descriptions at any time
without notice. Dell does not make any commitment to update the information contained in this document.
If you have any questions regarding your potential use of this material, contact:
Dell Inc.
Attn: LEGAL Dept
5 Polaris Way
Aliso Viejo, CA 92656
Refer to our web site (software.dell.com) for regional and international office information.
Trademarks
Dell, the Dell logo are trademarks of Dell Inc. and/or its affiliates. Microsoft, InfoPath, Word, Office 365, Internet Explorer,
SharePoint, Windows, Windows Server, SQL Server are either registered trademarks or trademarks of Microsoft Corporation in
the United States and/or other countries. IBM, Notes, Lotus Notes, Domino, QuickPlace, and Quickr are trademarks or
registered trademarks of International Business Machines ("IBM") Corporation in the United States, other countries, or both.
Other trademarks and trade names may be used in this document to refer to either the entities claiming the marks and names
or their products. Dell disclaims any proprietary interest in the marks and names of others.
Legend
CAUTION: A CAUTION icon indicates potential damage to hardware or loss of data if instructions are not followed.
WARNING: A WARNING icon indicates a potential for property damage, personal injury, or death.
IMPORTANT NOTE, NOTE, TIP, MOBILE, or VIDEO: An information icon indicates supporting information.
Migrator for Notes to SharePoint User Guide
Updated - October 2015
Software Version - 6.6
Contents
Overview of Migrator for Notes to SharePoint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Migrator for Notes to SharePoint Features and Functions . . . . . . . . . . . . . . . . . . . . . . 8
Migrator for Notes to SharePoint Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14
Console Configuration using the Setup Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16
Advanced Configuration Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18
General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20
Discovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23
Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24
SharePoint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25
SQL Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28
Folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
User Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
Group Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
Link Tracking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32
Publish Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32
Database Discovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34
QuickPlace/Quickr Discovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35
Domino.Doc Discovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36
Discover Directory Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36
Import Database Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37
Notes Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39
Database Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40
View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40
Copy to Custom View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40
Export List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40
Assign Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41
Analyze Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42
Recompute Database Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .45
Apply Class Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .45
Migrate to SharePoint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46
Generate InfoPath Form Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47
Generate Third-party Form Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51
Go to Notes Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51
Open Database Design . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52
Open Local Design Copy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52
Create Technical Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52
Export Database Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52
Extract Database Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52
Delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .53
Custom Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .53
Dell Migrator for Notes to SharePoint 6.6
User Guide
iii
Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .54
Advanced Security Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .64
Content Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .66
Migration Jobs Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .68
Migration History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .68
Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .68
Classification Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .68
Classification Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69
New Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69
Export Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69
Import Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70
Export List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70
Assign Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70
Generate InfoPath Form Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71
Go To Reference Notes Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71
Prioritizing a Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71
Creating a New Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71
Editing a Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71
Deleting a Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71
Classification Rule Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .72
General Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .72
Rules Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .72
Class Template Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73
Auto Triage Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74
Assign Effort Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74
Auto Target Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .75
Migration Jobs Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .77
Content Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .77
SharePoint Targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .79
Go To Site Action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .79
Add Sub-Site Action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .79
Provision Planned Sites Action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .80
Databases Targeting This Site Action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .80
Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .81
Standard and Advanced Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .82
Custom Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .84
Task History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .85
Importing Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86
General Rules for Running Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86
Link Analyzer/Updater/Finalizer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .87
Overview Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .87
Analyze Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .88
Update Links Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .88
Link Finalization Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .89
Log Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .90
Migrator for Notes to SharePoint Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .91
Dell Migrator for Notes to SharePoint 6.6
User Guide
iv
DbAnalysisByFormsReportTable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
About Dell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .150
Contacting Dell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
Technical support resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
vi
1
Migrator for Notes to SharePoint
Description
Quickly and easily migrates Lotus Notes and Domino databases, Lotus
QuickPlace/Quickr sites, or Lotus Domino.Doc cabinets
Customizes Notes and SharePoint data access details as well as data mapping rules
Saves customized Data Definitions for future use against other applications based
on the same application template
Allows you to design, edit, test and run migration jobs. The scope of this tool is one
migration job, moving data from one Notes database to one SharePoint list or library or
SQL Server database.
NOTE: For information on choosing a client, see the Installation Guide.
Allows you to look across many databases (potentially all the databases in your
organization), and helps you control the entire migration process from pre-migration
assessment to provisioning and content migration.
For information on choosing a client, see the Installation Guide.
Dell Migrator for Notes to SharePoint 6.6
User Guide
Description
Allows migration jobs to be run from the command line, from batch scripts, and from
scheduling tools. Allows certain job parameters to be overridden for easy automation of
large quantities of similar migration job.
For information on choosing a client, see the Installation Guide.
Allows remote users of Migrator for Notes to SharePoint clients to send exported Notes
documents directly to the SharePoint server.
The Import Service performs the SharePoint provisioning parts of the migration process
and is implemented as a web service that can be accessed seamlessly from remote
clients. It can provision new Lists and Document Libraries or populate existing ones and
leverages many capabilities of SharePoint including content types, folders, versioning,
enhanced HTML, InfoPath forms, and document level security.
The Import Service is architected as a Windows Communication Foundation (WCF) web
service and allows for efficient, secure connections between clients and the SharePoint
server over a variety of protocols. Administrators can configure the Import Service to run
on the network port of their choice, who is allowed to access it, and which SharePoint
sites are to be accessible through this service.
There are two main deployment options for the Import Service.
Install the Import Service on every front-end server so Migrator for Notes to
SharePoint clients can bounce between them.
Dedicate one or two front-end servers to be "Migration Servers" and arrange for all
migration traffic to be sent there. This can be done either by using a non-loadbalanced URL or by configuring the Load Balancer accordingly. In some cases, it
may make sense to keep normal users off the dedicated Migration Servers
completely, which again would be a Load Balancer configuration. A dedicated
Migration Server can be thought of as a "disposable" server and by using it, you
can avoid putting Migrator for Notes to SharePoint code on the "real" production
servers.
NOTE: This mode of operation requires the Migrator for Notes to SharePoints Import
Service and Front-End Services components which are part of Migrator for Notes to
SharePoint Services. For more information, see the Installation Guide.
NOTE: For information on choosing the Import Service or Web Services, see the
Installation Guide.
Description
Supports sending data to remote SharePoint 2010/2013 servers through Microsofts web
services. This means that you can install the Migrator for Notes to SharePoint clients on a
workstation where a Notes client is installed and send exported data directly to the
SharePoint without having to install anything on the SharePoint server. This allows
running a complete migration job at the click of a button, just like the "single computer"
option described below. You will need to use the Microsoft web service for the following
three scenarios:
This migration solution is simpler to deploy than the Import Service since there is no
need to deploy anything on your SharePoint servers. But it appears to be significantly
slower than running migrations using the Import Service. Much of the performance
depends on factors in your environment, but in most cases the jobs will take longer to
run.
The Front-End Services component allows you to configure the Import Service and Link
Tracking Service using the Site Settings page of your SharePoint site collection (site
collection administration rights required). The SharePoint Administration Services
component allows you to do the same configuration using a SharePoint Central
Administration page (central admin access and site collection administration rights
required).
The Link Tracking Service (LTS) is also part of the Front-End Services component. It
ensures that Notes DocLinks continue to work before, during and after the migration
process, regardless of the order of document migration. The service maintains a record
of every document that is ever migrated and guarantees that users clicking on an intradocument link will always be able to find the current location of the document. Users
can view a Link Tracking information page first, or simply be redirected to the desired
page in Notes or SharePoint.
As each document is migrated to SharePoint, its new location is tracked in a SQL Server
database called the LTS database. When migrating Notes rich text fields that contain
DocLinks to other Notes documents, these DocLinks are converted to URL links to a Link
Tracking service that knows how to resolve them. If a SharePoint user clicks on a link to a
document that has not been migrated yet, they will be redirected to the appropriate
document in the Notes client. If the user clicks on that same link after the document is
migrated, they will be redirected to the new copy of the document in SharePoint (which
might be a list item, a document library file, or even an InfoPath form).
Documents can be added to the Link Tracking Service whether the migration is
accomplished via the Import Service or by using Migrator for Notes to SharePoint products
in local mode (running the tool directly on the SharePoint server).
If, after your migrations, you move your SharePoint site to another server or location,
you can update the links in the LTS database using the Link Tracking Finalizer/Updater. If
you have relocated the LTS redirector page, the Link Tracking Finalizer/Updater can also
update all documents that have links to the LTS redirector page in order to look for that
page in the new location. If you would like to remove the Link Tracking Service
completely after the migration is done, the Link Tracking Finalizer/Updater can finalize
the links to allow for its removal.
Migrator for Notes
to SharePoint
Administration
Services
10
Description
Provides a simple diagnostic page for displaying doc link information. Because the
Sandbox-safe Link Redirector page does not connect to an external database, it always
offers to redirect user to Notes, even if the document has been migrated to SharePoint
(Optional).
With this migration solution, there is a different version of the Link Redirector page that
you can choose to use. The classic version that you get when you install the Front-End
Services solution is configured on a per site collection basis, alongside the Dell Import
Service. The alternative version is the Sandbox Link Redirector page. This version is
intended for cases where you do not have the ability to install custom solutions and/or
you cannot establish SQL connections from your server to the shared Link Tracking
database. This solution should be used for a Microsoft Office 365 environment and other
highly secured hosting environments. This page is packaged as a simple SharePoint
solution (Quest.SandboxLinkRedirector.wsp). Because it is a sandbox safe solution, it can
actually be installed by any site collection administrator, even on locked down
environments such as Office 365, without involving your farm administrators at all.
To deploy the Sandbox Redirector Page, see the Installation Guide.
NOTE: If you are migrating to SharePoint 2010/2013 or to SQL Server databases, you do
not need to install any server-side components. Migrator for Notes to SharePoint is
capable of migrating content through the native SharePoint 2010/2013 web services or by
writing directly to SQL Server. For increased performance and additional functionality on
SharePoint 2010/2013, you may install several server components.
Data Definitions
Data Extractions
Allows you to configure the data definitions to map the data when migrating data
from custom Lotus applications or migrating data to custom SharePoint lists. You
can save your customized data definitions for reuse later.
Reads local Notes databases and remote Domino databases. (It can even connect
to Domino servers on non-Windows platforms.) The software's data query engine
can extract items such as document items, view column values, attachments,
embedded images, embedded OLE objects, rich text, DocLinks, multi-valued
items, unread marks, and dynamically computed values.
11
Support for
QuickPlace/Quickr
Description
Converts Notes Rich Text fields to HTML or MIME (MHT) data formats
Selects desired page types or customizes your query by folder, form used, or
applies a selection dynamic formula
Converts rich text fields to standard HTML or MIME (MHT) data formats, including
embedded images and attachments
12
Support for
SharePoint
Description
Has option to extract latest draft versions, latest major versions, or both
Converts Notes Rich Text fields to HTML or MIME (MHT) data formats
Writes List Items using original document creation/modification dates and user
identities
13
2
Migrator for Notes to SharePoint
Console
Overview
Database Discovery
QuickPlace/Quickr Discovery
Domino.Doc Discovery
Notes Databases
Applications
Classification Rules
SharePoint Targets
Reports
Task History
Link Analyzer/Updater/Finalizer
Overview
The Migrator for Notes to SharePoint Console provides a higher level view of your migration process than the
Migrator for Notes to SharePoint Designer. Rather than focusing on designing and running one migration job for
one Notes database, the Console looks across many databases (potentially all the databases in your
organization) and helps you control the entire migration process.
If you are using the Migrator for Notes to SharePoint Console, you can:
select the Migrate to SharePoint action to run the databases migration jobs
14
Pre-Migration Assessment
Triage what to migrate and when (Use rules-based engine and/or override manually)
Develop time & cost estimates (Use rules-based engine and/or override manually)
Assign target SharePoint sites, lists and libraries (Use rules-based engine and/or override manually)
Assign content migration jobs (Use rules-based engine and/or override manually)
Preview your migration plan in the context of your existing SharePoint infrastructure
Perform high-fidelity Content Migration (rich text, embedded elements, special Notes constructs)
Ensure that SharePoint Workflows or SharePoint Event Receivers are disabled/removed before you begin
a migration.
Complete all workflow processes before migrating Notes documents. There should not be any workflows
in an open or in process state.
The Migrator for Notes to SharePoint Console is available as a Microsoft Management Console (MMC) 3 Snap-In.
MMC is a standard interface for all dialog box management tools and can run as a stand-alone tool or inside a
console that includes multiple tools.
The Console consists of three dialog box panes:
15
Description
Console Tree
(left pane)
Results View
(middle pane)
Notes Databases
Classification Rules
SharePoint Targets
Reports
Task History
Tools
Contains a detailed view appropriate to the item currently selected in the Console Tree.
This can be a list of child nodes, a detailed list of selected items such as database
records, or a report. You can perform various actions on the items depending on what
type of node is selected. You can view details about one particular node in the Property
Sheet.
You can customize the results view by:
creating a custom view. For more information, see Custom Views on page 53.
NOTE: To see the entire list of available columns organized by category, see Results View
Data Columns on page 134.
Action
(right pane)
Consists of a list of actions that can be performed to either the entire result set or the
selected items in the result set. The type of actions available depends on what type of
result set is displayed.
If the Action Pane is not visible, enable it by selecting View | Customize and checking the
"Action Pane" option, or selecting the Show/Hide Action Pane button on the console
toolbar.
Right-click Migrator for Notes to SharePoint in the Console tree, and select Setup Wizard.
The introductory screen of the wizard reminds you that all of the settings defined in the wizard can also
be changed in the Global Options dialog box. For more information, see Advanced Configuration Options
on page 18.
Click Next.
Dell Migrator for Notes to SharePoint 6.6
User Guide
16
Enter your Notes ID and password. If you are using an .INI file other than the default, select Browse to
locate the file. Click Next.
NOTE: To support Notes IDs that require more than one password, enter the passwords starting
with a vertical bar character, with a vertical bar character separating each password and ending
with a vertical bar character. For example: |password1|password2|password3|
Select the server where you want to create the repository database.
Click Next.
NOTE: The Migrator for Notes to SharePoint Console uses a Notes database as its Repository in
order to store data that is gathered through analysis and user input. Before using the Migrator for
Notes to SharePoint Console, this database must be created using the QuestlRepository.ntf
template that has been installed in your Notes data directory. Create the Repository database
before running the Notes Database Discovery process.
Click Next.
NOTE: Currently, only a local database is supported for the Repository.
If you want to select a database discovery type, select a scan type. Else, select I dont want to discover
databases at this time. Click Next.
Define the Notes servers that you want scanned in the Discovery process. Add all of the servers that
contain databases that you want analyzed for migration.
To edit an existing server, select the server in the server listing dialog box and click Edit. To delete an
existing server, select the server in the server listing dialog box and click Delete. To add a Notes server,
click Add and the Define Scan Location dialog box will appear. Enter the Notes Server and Path and click
OK.
Define the Notes users you want to exclude from your Notes database analysis. You can add your own
Notes name using the Add Yourself button as well as all known servers using the Add Known Servers
button. Click Next.
17
Select the Migrator for Notes to SharePoint root node in the Console Tree.
General
Notes
Discovery
Analysis
Console
SharePoint
SQL Server
Folder
User Mapping
Group Mapping
Link Tracking
Publish Status
18
General
Table 3. General Tab
Item
Description
Jobs Path
This is the folder where Migrator for Notes to SharePoint stores external migration
job definition files. This will be the default location for importing jobs into and
exporting out of the Migrator for Notes to SharePoint Console. By default, this is
set to a sub-folder of your Migrator for Notes to SharePoint program folder, but you
can change this to be any folder you want.
This is the folder where Migrator for Notes to SharePoint stores all predefined
Source Data Definitions and Target Data Definitions. By default, this is set to a subfolder of your Migrator for Notes to SharePoint program folder, but you can change
this to be any folder you want. For example, you may have a shared location on
your network where Definitions for all the custom templates in your organization
are stored.
This is the folder where Migrator for Notes to SharePoint stores external log files.
This will be the default location for exporting log files out of the Migrator for
Notes to SharePoint Console. By default, this is set to a sub-folder of your Migrator
for Notes to SharePoint program folder, but you can change this to be any folder
you want.
Allow Deletion of
SharePoint records
Select this check box to allow Migrator for Notes to SharePoint to delete the target
record when migrating the same record. This can be fine tuned at the migration
job level using the If Duplicate Found option.
CAUTION: This may cause data loss.
On errors writing to
SharePoint
These check boxes indicate how you want to handle migration errors. To prompt
the user with the migration error, select the Prompt user check box. To log the
error and continue with the migration, select the Log and continue check box.
These two options are not mutually exclusive.
This is the level of logging that you want to be recorded when running migration
jobs and other tasks. There are four levels of logging to choose from.
NOTE: You should avoid VerboseTrace unless you really need it as this can slow
down large migration jobs.
19
Notes
Table 4. Notes Tab
Item
Description
This is the password for your local file. It will be stored in an encrypted format in
the "UserOptions.config" file in the application data directory under: Dell/Migrator
for Notes to SharePoint.
To support Notes IDs that require more than one password, enter the passwords
starting with a vertical bar character, with a vertical bar character separating
each password and ending with a vertical bar character. For example:
|password1|password2|password3|
Override default
Notes.INI file
By default, Migrator for Notes to SharePoint will use the default Notes
configuration file in use by your Notes client. In rare cases, you may wish to
specify an alternate configuration file here
Configure Repository
Database
This button opens the Configure Repository Database dialog box. This dialog box is
where you define the location of the Repository Database. The Repository
Database is a local Notes database where all the data for the Migrator for Notes to
SharePoint Console is stored. If you kept the default during the installation of the
console, it is QuestRepository.nsf.
Database Server: This is always local for the current version of Migrator
for Notes to SharePoint.
NOTE: The current version does not support multi-user access to the Repository
database. You may use your Notes client to replicate your Repository database to a
Domino server but you should not allow multiple users to update the database. A
subsequent version of Migrator for Notes to SharePoint will support concurrent
shared Repository usage.
NOTE: If the name or location of the Repository changes, you must restart the
Console for the changes in these fields to take effect.
NOTE: This button is only available when you open this tab from the Console.
Configure User/Group
Resolution Server
This button opens the Configure Domino Server Location dialog box. The Domino
Directory server listed here is the one used for expanding groups when generating
SharePoint Groups from ACL Groups. For more information, see Migration Targets
Tab on page 63.
To add a server click Add. To edit, select an entry and click Edit. To delete, select
an entry and click Delete.
Both Add and Edit opens the Domino Directory Servers dialog box
Directory Server: Notes name for the server from where you would like to
scan directory information
This property limits all group expansion operations to those groups that are
smaller than the given number. During migrations, groups that are larger than the
Max Group Size will not be written to SharePoint. A warning will be written to the
migration log. The default is 100.
20
Description
When migrating rich text fields that contain URL links to other QuickPlace/Quickr
pages or Domino web pages, Migrator for Notes to SharePoint can detect these
links and convert them to use the Link Tracking Service. Select this check box to
turn this feature on.
When this check box is selected, the Translations button is active. The
Translations button opens the Configure Link Translations dialog box. This is
where you specify the URL prefixes you want to convert and from which Domino
servers.
NOTE: Enabling this feature is useful in cases where you have Notes documents
that link to other Notes documents through Domino URL links rather than true
Notes DocLinks. This is especially common in QuickPlace/Quickr and other web
enabled Domino applications. Migrator for Notes to SharePoint will recognize URL
links that start with the prefix you specify here and will attempt to locate the
actual Notes document on the server you specify. If successful, Migrator for Notes
to SharePoint will process the link as if it were a true Notes DocLink and make sure
that it works correctly with the Link Tracking Service.
NOTE: When performing a Doclink Scan, Quickr links are not included as Doclinks,
even when this feature is enabled.
By default, Migrator for Notes to SharePoint will try to recover from certain errors
while querying. If there is a problem reading an item, it will return NULL and
automatically skip to the next item. If there is a problem reading a document, it
will automatically skip to the next document. If you select this check box, an
exception will be thrown when the first error is encountered. This may be helpful
when trying to debug why certain data items were not processed.
By default Migrator for Notes to SharePoint reads up to 100 records at a time while
sending data to SharePoint. In rare memory-constrained conditions, it may be
helpful to override this setting to less than that (as low as 1). This may impact
performance, but it will help keep the memory footprint down. To change the
default size, select this check box and enter the desired size in the field to the
right.
Compression Exclusions
This option allows you to specify any file extensions that should never be zipped
during migration. This would typically include media files that are already wellcompressed and would not benefit from zipping
Discovery
NOTE: This tab is only available when you open Options from the Console.
Before you can start managing your migration process, Migrator for Notes to SharePoint must identify all of your
Notes databases. The Migrator for Notes to SharePoint Console supports several modes of discovering Notes
databases. Discovery occurs by reading the information in your organization's Database Catalog or Domain
Catalog or by directly scanning the Domino server folders, or both. (For more information, see Database
Discovery on page 34) The configuration on this tab is used during the database discovery process. This tab must
be filled out before you can run this process.
21
Description
Domain/Database
Catalogs
This button opens the Configure Catalog Databases dialog box. This dialog box is
where you define the location of the Database Catalogs or Domain Catalogs that
you want to extract information from. The number on the button shows how many
catalog databases are defined.
To add a catalog click Add. To edit, select an entry and click Edit. To delete,
select an entry and click Delete.
Both Add and Edit opens the Configure Catalog Database dialog box
NOTE: Not all organizations run the Domino Cataloger process, which keeps
catalog.nsf databases updated with current information. If you are not sure,
simply do a direct scan instead.
Direct Server Scan
Locations
This button opens the Configure Scan Locations dialog box. This dialog box is
where you define the location of the servers you want scanned during the
database discovery. The number on the button shows how many items are defined.
To add a server click Add. To edit, select an entry and click Edit. To delete, select
an entry and click Delete. Both Add and Edit opens the Define Scan Location
dialog box
Scan Path: Leave this blank if you want Migrator for Notes to SharePoint to
scan the entire data directory on the specified server.
Known QuickPlace/Quickr This button opens the Known QuickPlace/Quickr Servers dialog box. This dialog
Servers
box is where you define the QuickPlace/Quickr Servers that you want analyzed
during the Discover QuickPlace Organization process. For more information, see
QuickPlace/Quickr Discovery on page 35
To add a server click Add and enter the server name. To edit, select an entry and
click Edit. To delete, select and entry and click Delete.
To add several servers to the Known QuickPlace/Quickr Servers list, copy them to
your clipboard using a comma, semi colon, or a new line to separate each server
name. Click the Paste button to copy them to the list.
Known Quickr Servers
This button opens the Known Quickr Servers dialog box. This dialog box is where
you define the Quickr Servers that you want analyzed during the Discover Quickr
Organization process. For more information, see Domino.Doc Discovery on page 36
To add a server click Add and enter the server name. To edit, select an entry and
click Edit. To delete, select and entry and click Delete.
To add several servers to the Known Quickr Servers list, copy them to your
clipboard using a coma, semi colon or a new line to separate each server name.
Click the Paste button to copy them to the list
Known Domino.Doc
Servers
This button opens the Known Domino.Doc Servers dialog box. This dialog box is
where you define the Domino.Doc Servers that you want analyzed during the
Discover Domino.Doc Organization process. For more information, see Domino.Doc
Discovery on page 36.
To add a server click Add and enter the server name. To edit, select an entry and
click Edit. To delete, select and entry and click Delete.
To add several servers to the Known Domino.Doc Servers list, copy them to your
clipboard using a coma, semi colon or a new line to separate each server name.
Click the Paste button to copy them to the list.-
22
Description
This button opens the Excluded User Names dialog box. Add any user names that
you do not want taken into account during any of the analysis (for example: You
might not want the Administrator sessions or updates by scheduled Server agents
taken into account when reporting on how frequently a database is used). The
number on the button shows how many user names are defined.
To add an excluded user, click Add and enter the user name. To edit, select an
entry and click Edit. To delete, select and entry and click Delete.
To add several users to the Excluded User Names list, copy them to your clipboard
using a coma, semi colon or a new line to separate each user name. Click the
Paste button to copy them to the list.
If you change the excluded user list after doing a data scan, you can use the
Recompute Database Details action to update the data in the Console without
having to re-scan the Notes database.
This button opens the Preferred Notes Servers dialog box. This dialog box is where
you add the servers that you want in the Preferred list. The Preferred list
determines which replica is chosen to be displayed on the Unique Replicas view in
the case where the discovery process has discovered multiple replicas of the same
database on different servers. The number on the button shows how many servers
are defined.
To add a server click Add and enter the server name. To edit, select an entry and
click Edit. To delete, select and entry and click Delete.
To add several servers to the Preferred Notes Servers list, copy them to your
clipboard using a coma, semi colon or a new line to separate each server name.
Click the Paste button to copy them to the list.
Domino Directory Servers This button opens the Domino Directory Servers dialog box. This is where you
define the servers used by the Discover Directory Entries process. This process
scans Domino Directories to collect additional information about the Notes
databases in your environment. In particular, it detects when databases are
configured as Mail-in databases (that is, they have addresses that users can send
mail to). The number on the button shows how many servers are defined.
To add a server, click Add and enter the server name. To edit, select an entry and
click Edit. To delete, select and entry and click Delete.
Analysis
NOTE: This tab is only available when you open Options from the Console.
The upper half of the Analysis tab stores the global option for picking which algorithms you want to use for
automatically assigning database complexities. The following example says that we will use a weighted mix of
Data Complexity (50%) and Design Complexity (100%) to compute the overall complexity recommendation. The
databases overall complexity recommendation is found in the Complexity Tab tab of the Database Properties.
Table 6. Analysis Tab
Item
Description
23
Description
Sets a limit for how much time Migrator for Notes to SharePoint will spend
analyzing one database. If this time is exceeded, the scan will stop and an
exception will occur. If you have Migrator for Notes to SharePoint set to log
exceptions without interruption, it will immediately move on to the next
database.
Defines where the database design copy is stored. For information on created a
design copy, see the Analyze Databases action.
Console
NOTE: This tab is only available when you open Options from the Console.
Description
Global Exclusions
To add several values to one of the above exclusion lists, copy the values to your
clipboard using a coma, semi colon or a new line to separate each value. Click the
Paste button to copy them to the exclusion list.
Automatically set
Migration Status fields as
console operations are
performed
For each of the below tasks that are checked, Migrator for Notes to SharePoint can
automatically set a databases status of the task to complete as it completes the
task for the database.
Design Analyzed
Data Analyzed
Targets Identified
Content Migrated
24
Description
The disposition of a database indicates what you want to do with the database in
the migration process (for example, 'Migrate to standard SharePoint targets' or
'End-of-life'). The databases disposition is set in the Migration Status Tab tab of
the database properties. To edit the list of available database dispositions for a
database, select the Database Disposition button to open the Database Disposition
dialog box.
To create a new disposition, click Add. To edit an existing disposition, select the
disposition from the list and click Edit. To delete an existing disposition, select the
disposition from the list and click Delete.
NOTE: Migrator for Notes to SharePoint does not take the indicated actions, such
as deleting the database, for you automatically. Rather the decisions you make
about each database are recorded and may be used for reporting, filtering and
data export.
Set this higher or lower to limit the number of databases processed by the console
reports. This is a global default for all reports but individual reports may be
customized to increase this limit.This value helps prevent the console from
exhausting the available memory while rendering complex reports against a large
number of databases. The default is 50,000.
Choosing a value of 0, requires each report definition to be customized with its
own upper limit before it will render any result.
SharePoint
The SharePoint tab is where you can define your target SharePoint sites and how you want Migrator for Notes to
SharePoint to connect to them. Migrator for Notes to SharePoint is capable of migrating to local (same machine)
or remote SharePoint servers.
Table 8. SharePoint Tab
Item
Description
Name
The Name field is used to distinguish between defined SharePoint environments if you have
enabled and defined more than one environment. To define more than the standard default,
select the Enable multiple SharePoint environments check box.
Type
Use the Type dropdown to control the mode of operation. The Type dropdown has the
following options:
SharePoint servers using Dell Import Service - Use this option for migrations to a
remote SharePoint server that is running the Dell Import Service.
SharePoint web services (Classic Mode Authentication) - Use this option for
migrations to a remote SharePoint 2010 or 2013 server using Microsoft Web Services
rather than the Dell Import Service.
SharePoint web services (Office 365 Authentication) - Use this option to migrate to
Office 365 SharePoint sites using Microsoft's Windows Identity Foundation. Microsoft's
Windows Identity Foundation must be installed on the client in order to use the Office
365 Authentication environment type.
NOTE: You can use the Forms-Based Authentication environment type to access Office 365
SharePoint sites. The advantage of using the Office 365 Authentication environment type is
that Migrator for Notes to SharePoint can authenticate with SharePoint without user
intervention.
NOTE: If you are using Microsoft Web Services, you must use the client for User and Group
Mapping. For more information, see User Mapping on page 29 and Group Mapping on page 31.
Dell Migrator for Notes to SharePoint 6.6
User Guide
25
Description
Settings
Enable Dell Link Tracking Service - Select this check box to use the Link Tracking
Service.
The options for environments using the Microsoft Web Services are:
SharePoint Online throttling - Specify a value in Incremental back off uses x seconds
between retries to avoid getting throttled to set the time waited after receiving a
429 web exception from SharePoint, before retrying the migration. Specify a value in
Retries x times before reporting throttled error to set the number of times the
migration will be retried. The delay time doubles with each retry. For example, if you
set 30 seconds and 5 retries, the delay between retries will be 30, 60, 120, 240, and
480 seconds. If the migration is not successful after the last retry, throttling is
reported.
Refresh cookies x minutes before they are due to expire - Connections to SharePoint
sites using Forms Based Authentication will automatically renew cookies as needed
during long migration jobs and other operations. The tool will routinely check the
expiration time of the authentication tokens that it holds for the client and, if a token
is due expire within this specified time limit, it will force a new authentication. The
time limit defaults to 30 minutes. Depending on your particular authentication system,
this may appear to the user as a browser prompt forcing the user to re-authenticate. In
other cases, it may appear as a browser that opens briefly and then closes again.
Force cookies to expire x minutes after they are acquired - For SharePoint sites
using Forms Based Authentication where the cookies are issued by authentication
providers other than SharePoint, Migrator for Notes to SharePoint is unable to
determine the expiration of the cookies. This option allows Migrator for Notes to
SharePoint to manage the expiration.
Cache authentication cookies in configuration file - Select this check box to cache
the authentication cookies in the configuration file. If you choose to not cache the
authentication cookies, Migrator for Notes to SharePoint will re-authenticate to get
new cookies every time Migrator for Notes to SharePoint is restarted. If you are using
forms-based authentication, you will have to manually sign in each time.
The options for environments using the Dell Import Service are:
Perform user/group mapping operations on the client - To have the client (Console or
Designer) rather than the Import Service perform the user and group mapping
operations, select this check box. When this is selected, the options configured in the
User Mapping tab and Group Mapping tab will be used rather than the options found on
the Migrator for Notes to SharePoint Services configuration page on the SharePoint
server.
Perform direct writes to the Link Tracking database from clients - To have the client
rather than the Import Service perform the updates to the Link Tracking database,
select this check box. When this is selected, the options configured in the Link
Tracking tab will be used rather than the options found on the Migrator for Notes to
SharePoint Services configuration page on the SharePoint server.
Use shared folder for transferring data - If you do not wish to use the shared folder as
a means of transferring data even though a shared folder has been configured on the
server, do not select this check box. For more information on the shared folder, see the
Configuring Migrator for Notes to SharePoint Services section of the Migrator for Notes
to SharePoint Installation Guide. This check box is only enabled if Remote SharePoint
connections are enabled. Unchecking this check box will force the client to transmit
the data as encrypted bits. Checking this check box will have no effect if a shared
folder has not been configured on the server.
26
Description
Credentials
Click the Credentials link to enter your SharePoint user name and password.
NOTE: For the Forms Based authentication Type, the Credentials link is not active until you
click Add to add the SharePoint site URL to the SharePoint Site Collections list. For all other
Types, the Credentials link is active right away.
If you are using single sign-on and want to use Windows authentication in Migrator for Notes to
SharePoint to be able to authenticate with Office 365, select the Use Windows
authentication radio button.
Home Realm - Enter the Active Directory Federation Services (ADFS) Federation
Service endpoint URL. This should be the same host name that you are using in the
"whr" parameter in your single sign-on SharePoint URLs.
STS application pool identity - Enter the name of the identity that is being used by
the ADFS application pool. It should be in the form of domain\username.
Internal Site - To migrate to the public facing website, enter one of your internal site
collection URLs in this field.
Configure
Click the Add button to add your particular SharePoint site URL to the SharePoint Site
SharePoint Site Collections list and test connectivity to those sites. Note that you do not need to specify each
Collections
sub-site here; Migrator for Notes to SharePoint can discover those automatically.
To add a site, enter the site URL, including "http://" or "https://", and click OK in the Add
SharePoint Site dialog box.
To add your login credentials, click the Credentials link. If you are authenticating using
Forms Based Authentication, the credentials link works a little differently. Click the Not
authenticated link to display the sites configured login screen. Migrator for Notes to
SharePoint saves the resulting authentication as long as possible and then re-prompt the user
when appropriate.
To test a site, select it and click the Test Connections link.
Can you access the site with the address and credentials you supplied? If this test fails,
correct your address and credentials and try again.
Is the site you specified enabled to allow remote import of documents? This requires
that Migrator for Notes to SharePoints Import Service is installed on the remote server
and is enabled and configured for that particular site.
Can you connect to the Migrator for Notes to SharePoint Import Service? If this test
fails, make sure that the Import Service is running and that the service address and
endpoint are correctly configured for that particular site. Also, check that the host
name and port number being used by the Import Service is not being blocked by a
firewall on the client or server.
NOTE: There are valid cases where only test #1 above will succeed. In particular, your
organization may have selected the "Install on separate Import and Export machines"
deployment option (see the Installation Requirements section of the Migrator for Notes to
SharePoint Installation Guide) and would not have installed Migrator for Notes to SharePoint
Import Services on the target SharePoint server. In this case, tests #2 and #3 will fail, as shown
below. You will still be able to connect to the SharePoint server while designing your migration
jobs and you will be able to export extracted data to intermediate files.
27
Description
Enable
multiple
SharePoint
environments
Connection type
If you have multiple SharePoint servers that need different options, using this feature allows
you to save these options and use them as needed.
At migration/provisioning time, the appropriate environment should be selected (and logged)
automatically for that target site.
Blocked Files
Click the Blocked Files button to configure the maximum allowed file size property and
define the list of disallowed file extensions. These settings will be used at Analysis time to
report on which databases have blocked files and oversized attachments. They will also be
used at migration time to improve performance and memory utilization by not extracting such
files from the Notes databases and not sending them to SharePoint. From the Configure
Blocked Files dialog box, you can add your own blocked file extension list or use the list from
SharePoint by clicking the Set to SharePoint defaults link.
SQL Server
Migration of data directly to a SQL Server database can be turned on and configured from this tab.
Table 9. SQL Server Tab
Item
Description
Preferred Servers
List
This button opens the Preferred SQL Server Instances dialog box where you add the SQL
Server instances that you want available in the migration target server list. The
migration target server list will display the instances in the same order as they appear in
this dialog box. Make sure that the server you will be migrating to the most often appears
at the top. The number on the button shows how many servers are defined.
To add a server click Add and enter the server name. To edit, select an entry and click
Edit. To delete, select and entry and click Delete. Click OK to save changes.
To add several servers at once, copy them to your clipboard using a coma, semi colon, or
a new line to separate each server name. Click the Paste button to copy them to the list.
Enable migration
directly to SQL
Server tables
Select this check box to enable migration directly to your SQL Servers. When you select
this check box from Designer, SQL Server becomes available in the Type dropdown.
SQL Server
Authentication
Options
Enter the credentials for your primary SQL Server database. At the time of migration,
this information can be changed depending on which SQL Server database you have
selected as the migration target.
Link Tracking
Options
To use link tracking for your migrated SQL Server data, check the Enable Link Tracking for
SQL Server records check box. Enter the Link Redirector Url you want to use with the
content being migrated to SQL Server. The Database Settings link will take you to the
Link Tracking tab where you can edit the Link Tracking database information.
User/Group
Mapping Options
To perform mappings using the client rather than the server, select this check box. The
Mapping Options link will take you to the User Mapping tab where you can edit the user
mapping information.
28
Folder
This tab allows you to enter a root folder to which to migrate data.
Table 10.
Item
Description
Link Tracking
Options
To use link tracking for your migrated data, check the Enable Link Tracking for files
check box. Enter the root folder you want to use with the migrated content. The
Database Settings link will take you to the Link Tracking tab where you can edit the Link
Tracking database information.
User Mapping
The information on this tab is used only when user mapping is performed on the client. If the mapping is to be
performed remotely by the Import Service, the user mapping settings defined on the Migrator for Notes to
SharePoint configuration page of the SharePoint Server will be used.
SharePoint tracks "users" as numeric indexes into the SharePoint Site Collection Users list. When using the
"Preserve Created/Modified Identities" option in your Job Definition, or when migrating a Notes name field to a
SharePoint User field, Migrator for Notes to SharePoint maps Notes names to Site Collection User identities
based on the configured rules.
29
Description
Input Translation
Allows you to specify a translation option if your input data (from Notes) is in one format
and your XML mapping file or ADSI query is using a different format.
Mapping Notes
Names to Site
Collection Users
Treat input as Login Name - The input data provided must equate to a valid
Windows login name. Simple name translations are provided (for example,
reformat the Notes name Joe Cool/Dell to Dell\Joe Cool".
Use Domino Directory Lookup - This option performs a directory search on the
designated Domino server and includes all address book databases that are
configured to be part of the servers directory.
Server Name: The Domino server to search. Leave blank to search the local
address book.
View Name: The view to search in each configured directory database, which
should be indexed such that it is sorted by the Notes user name. (The $Users view
in standard address book databases do this by default, but you may also specify a
customized view to use.)
Item Name: The item that stores the Domain name (typically an Active Directory
name) that is used for logging into SharePoint.
Use Notes Database Lookup - This option performs a lookup in the selected
Notes database.
Server Name: The Domino server to search. Leave blank to search a local
database book.
Database Name: The database to search.
View Name: The view to search in the database, which should be indexed such
that it is sorted by the Notes user name.
Item Name: The item that stores the Domain name (typically an Active Directory
name) used for logging into SharePoint.
Use ADSI/LDAP Lookup - Use the input data (most likely the Notes Name) as the
basis for an Active Directory (or other LDAP) lookup to find the correct Windows
login name.
ADSI path: Specify the path to the Active Directory (or other LDAP) server that
contains the user mappings. You can actually use any ADSI path here including
"GC://" for the global catalog and "WinNT://" for the local metabase.
Query String: Specify a valid query string for finding the user based on the Notes
Name. For example, if your policy is to store the Notes Name in the Description
field of Person records in Active Directory, you might specify
"(&(ObjectClass=Person)(description={0}))" as the Query String. The {0} part is
replaced with a formatted version of the Notes Name and the entire Query issent
to the directory server. For example, if the Person has a field called
"distinguishedName" and was formatted as Windows names (like "PROD\Joe
Smith"), then you would use a query like:
(&(ObjectClass=Person)(distinguishedName={0}))
Field to use: Indicates the field to use in the directory lookup. By default, the
distinguishedName property is used. This should work in most cases, especially
when the directory you are querying is the same one SharePoint uses. In rare
cases, this name will not work. If there is a different directory property (other
than distinguishedName) that contains a more useful version of the name that
would work in SharePoint, use this field to indicate the different property.
ADSI login name and ADSI password: Specify authentication credentials.
30
Description
Use Text File Lookup - Use the input data (most likely the Notes Name) as the
basis for a lookup in an XML or comma-delimited text file to find the correct
Windows login name. In practice, most organizations that have both Notes and
Active directory will have the mapping of names stored somewhere and it is
usually a simple matter to write a script to generate a simple mapping file. You
can use the Extract Database Users tool to automatically generate this lookup file
for your users in one or more Notes databases.
Format: The mapping file can be formatted as an XML file or a Comma Delimited
file. An example of each format is shown below:
<?xml version="1.0" encoding="utf-8"?>
<identityMappings>
<userMappings>
<user notes="Joe Cool/Dell" sharePoint="DELL\jcool"/>
<user notes="Mike Mulligan/DellTest" sharePoint="BUNTING\mike"/>
</userMappings>
<groupMappings>
<group notes="QuickPlaceAdministratorsSUGroup"
sharePoint="BUILTIN\Administrators"/>
<group notes="Authorized Users" sharePoint="Dell\Team 101"/>
</groupMappings>
</identityMappings>
Joe Cool/Dell, Dell\jcool
Max Smart/Dell, BUNTING\mike
Path: The location of the mapping file.
NOTE: If you have non-ascii characters in your user data, you need to specify the
encoding in your XML declaration and save the user mapping file with that encoding, for
example UTF-8.
Output Translation
Allows you to define a string to format the output of the user mapping. In the string,
"{0}" represents the output of the user mapping. If you want to add "prod\" to each of the
mapped names, enter prod\{0} as the format string.
For example, you have a test domain and a production domain in which all of the user
logins are the same (except for the domain name). You want to create one XML mapping
file that contains just the user logins, and add in the appropriate domain name
(depending on which domain they were currently migrating to) using their user mapping
options.
To test each of the mapping modes, click the Test User Mapping link. Type in a test
Notes name and click Lookup. The resulting mapped user name appears in the After
Name Translation and After Name Lookup fields. Click Validate in SharePoint to resolve
the name that your configured mapping process produces. This capability is only
available when using client-side user mapping and not when configuring server-side
mapping in the Import Service.
NOTE: If connecting to remote SharePoint servers, the User Mapping functions are
controlled at the server and the options are disabled at the client.
NOTE: A good way to understand the steps that Migrator for Notes to SharePoint goes
through when mapping user names is to turn on Verbose logging and see what happens.
Group Mapping
The information on this tab is used only when group mapping is performed on the client. If the mapping is to be
performed remotely by the Import Service, the group mapping settings defined on the Migrator for Notes to
SharePoint configuration page of the SharePoint Server will be used.
31
In addition to the User Mappings, there are several options for mapping Notes Group names to Domain group
names (typically Active Directory group names) for use in SharePoint. This translation may occur in several
scenarios:
Translating a Group listed in a Notes database Access Control List (ACL) so the equivalent Domain group
can be granted access to a SharePoint list or library.
Translating a Group listed in a Notes database Access Control List (ACL) that is a member of a Notes Role
so the equivalent Domain group can be added to the new SharePoint Site Group that corresponds to that
Role.
Translating a Group listed in a Notes document reader/writer field so the equivalent Domain group can
be granted access to a SharePoint list or library.
As with the User Mapping function, Migrator for Notes to SharePoint gives you several choices as to how the
mapping occurs. Each of the options shown here work exactly like the corresponding User Mapping options.
NOTE: If you have non-ascii characters in your user data, you need to specify the encoding in your XML
declaration and save the user mapping file with that encoding, for example UTF-8.
Link Tracking
The Link Tracking Service allows Notes DocLinks to be migrated as dynamic links instead of direct links. As you
click dynamic links, they are automatically redirected to the current location of the target document,
regardless if it has been migrated or not.
To enable link tracking, select the Enable the Dell Link Tracking Service check box. You can also perform the
Link Tracking Finalizer/Updater operations from the Console rather than from the Migrator for Notes to
SharePoint Services configuration page.
NOTE: Performing the Link Tracking Finalizer/Updater operations from the Console is the preferred way
since it is faster and more user friendly.
The following Link Tracking Settings are now available:
Server The SQL Server instance that contains the Link Tracking database.
Database The SQL Server name for the Link Tracking database.
Authentication The credentials that the client should use when accessing the Link Tracking database.
This can be your Windows account, a different users Windows account, or your SQL Server login.
Use default Redirector URL Link Tracking for SharePoint migrations will use the default redirector
page.
User Defined Redirection URL This option allows you to define your own user defined redirection URLs
if you want the redirection to be handled in some other way.
NOTE: Be sure to use the same values for the Link Tracking database as those that were entered for Link
Tracking in the Migrator for Notes to SharePoint Services configuration page. These values were initially
set by the Migrator for Notes to SharePoint Services installer but may have been overridden in the Services
configuration page.
Publish Status
Select the Enable publishing migration status to SharePoint check box to record the migration progress to a
SharePoint list.
32
Description
Type
Allows you to select a SharePoint site which will publish the report list:
SharePoint servers using Dell Import Service - Use this option for migrations to a
remote SharePoint server that is running the Dell Import Service.
SharePoint web services (Classic Mode Authentication) - Use this option for
migrations to a remote SharePoint 2010 or 2013 server using Microsoft Web Services
rather than the Dell Import Service.
SharePoint web services (Office 365 Authentication) - Use this option to migrate to
Office 365 SharePoint sites using Microsoft's Windows Identity Foundation. Microsoft's
Windows Identity Foundation must be installed on the client in order to use the Office
365 Authentication environment type.
Site Url
List name
Allows you to enter the name of a report list to record the full migration progress. The report
list includes:
List name
(Brief info)
Job Name - the job name of the migration. If there is no job name, the default name
would be Migration Job_XXX (XXX is the time when it is created)
Status - the status of the migration; can be either InProgress, Complete, Canceled,
Stopped, Suspended
Target List - the target list name with link to the list
Target Definition - the target definition, such as PDF Documents, Wiki Pages
Created - shows the time the item was created and the when the migration started
Modified - the date and time the item was last updated. The list will be sorted by this
field in descending order by default.
Allows you to enter the name of a report list to record a summary of the migration progress.
Job Name - the job name of the migration. If there is no job name, the default name
would be Migration Job_XXX (XXX is the time when it is created)
Database - the name of the database that was migrated (for Lotus Notes only)
33
Description
Credential
Update
migration
status every X
minutes
Database Discovery
Before you can start managing your migration process, Migrator for Notes to SharePoint must identify all of your
Notes databases. The Migrator for Notes to SharePoint Console supports several modes of discovering Notes
databases. Discovery occurs by reading the information collected by the Domino Cataloger process or by
directly scanning the Domino server folders, or both. If your organization maintains a Database Catalog or
Domain Catalog, that is a great place to start for quick discovery of all your databases. If not, a direct scan
works just as well (although it will not be quite as fast and is subject to the access rights of the person
performing the discovery).
During the discovery process, certain information may be immediately excluded based on the configured
Exclusion and Filtering rules defined in the Console tab of the Configuration dialog box.
Also during the discovery process, Database Classes are assigned according to your configured Classification
Rules. For more information, see Notes Databases on page 39.
The actual discovery process is initiated by the user. All discovered information is stored as part of the database
record in the Repository database and is viewable in database views and the database property sheets.
NOTE: This level of discovery should not be confused with the deeper (and more expensive) data and
design scans offered. It includes high level properties that might be found in the standard Notes domain
catalog (General, Location, Statistics, User Activity, User Access).
Once you have filled out the Discovery tab in the Configuration dialog box, you can run the Database Discovery
process.
To discover databases
1
From the Migrator for Notes to SharePoint Console, select the root node, Migrator for Notes to
SharePoint.
You can also select the Discover Databases action in the Action Pane or the context menu. The Database
Discovery Options dialog box will appear.
This dialog box is where you specify:
Discover from known server locations - Select the check boxes for all the servers that you want to run
this process for. You can click the Select All link to select all check boxes. To deselect all of the check
boxes, click the select none link.
34
Discover from known database/domain catalogs - Select the check boxes for all the database/domain
catalogs for which you want to run this process. You can click the Select All link to select all of the check
boxes. To deselect all of the check boxes, click the Select None link.
NOTE: To scan all the listed servers/databases, click the Select All link.
To scan a specific database on a server, click the Select individual database link. This will open
the Select Database dialog box. Select the server and database path that you want to run the
discovery scan on. To browse all the databases on the server, click the Select button. Once the
server and database path are specified, click OK to run the database discovery process.
To add another server location to the list, click the Manage Locations link. This will open the
Configure Scan Locations dialog box. To add another server, click the Add button. These newly
defined servers will be added to the list of servers to run the discover process against once OK is
clicked.
Scan database headers - Select this check box to run a scan of the usage history on the selected
databases. This will produce detailed usage information like database size, number of reads, writes and
uses by user and by form used. To exclude certain users from this analysis, see Excluded User Names on
page 23. You can view these results in the Usage Analysis Tab tab of the Database Property sheet. This
action is also available as a button on the Usage Analysis Tab tab of the Database property sheet.
Run task in background - Select this check box to run the process in the background. The process will be
displayed as a task under the Task History node of the console. Open the task to view the results of the
process as well as any errors or warnings. If this option is not selected, the process will run in the
foreground. For more information, see General Rules for Running Tasks on page 86. Click OK to run the
process. As databases are discovered, they will appear in the appropriate database views (See For more
information, see Notes Databases on page 39).
QuickPlace/Quickr Discovery
The QuickPlace/Quickr Discovery process browses the configured QuickPlace/Quickr servers and determines
how the various databases used to implement QuickPlace/Quickr sites relate to one another and what roles they
play in the QuickPlace/Quickr application abstraction (sites -> rooms -> sub-rooms). The discovery process also
reads the QuickPlace/Quickr room menu to rebuild the SharePoint Quick Launch menu to mirror it during
migration. During the discovery process, certain information can be excluded based on the configured Exclusion
and Filtering rules defined in the Console tab of the Configuration dialog box.
The result of this process updates the Application information stored under the Applications node of the
Console.
From the Migrator for Notes to SharePoint Console, right-click Migrator for Notes to SharePoint, then
select Discover QuickPlace Organization or Discover Quickr Organization.
Select the check boxes for all the QuickPlace/Quickr servers or places for which you want to run the
process. You can click Select All to select all of the check boxes. To clear all of the check boxes, click
Select None.
Select the Run Tasks in the background check box, and click OK.
35
The process is displayed as a task under the Task History node of the console. Open the task to view the
results of the process as well as any errors or warnings. If this option is not selected, the process runs in
the foreground. For more information, see General Rules for Running Tasks on page 86.
Domino.Doc Discovery
The Domino.Doc Discovery process browses the configured Domino.Doc servers and determines how the various
databases used to implement Domino.Doc libraries relate to one another and what roles they play in the
Domino.Doc application abstraction (libraries -> cabinets -> binders). During discovery, certain information can
be excluded based on the configured Exclusion and Filtering rules defined in the Console tab of the
Configuration dialog box.
The result of this process updates the Application information stored under the Applications node of the
Console.
From the Migrator for Notes to SharePoint Console, right-click Migrator for Notes to SharePoint, then
select Discover Domino.doc Organization.
The Domino.doc Discovery Options dialog box appears. This dialog box is where you specify which
Domino.doc servers to run the discovery against.
Select the check boxes for all the Domino.doc servers or places for which you want to run the process.
You can click Select All to select all of the check boxes. To clear all of the check boxes, click Select
None.
Select the Run Tasks in the background check box, and click OK.
The process is displayed as a task under the Task History node of the console. Open the task to view the
results of the process as well as any errors or warnings. If this option is not selected, the process runs in
the foreground. For more information, see General Rules for Running Tasks on page 86.
Mail Type Database for normal mail-in databases or Resource for resource reservation request
databases
36
From the Migrator for Notes to SharePoint Console, right-click Migrator for Notes to SharePoint, then
select Discover Directory Entities.
The Directory Discovery Options dialog box appears. This dialog box is where you specify which entities
to run the discovery against.
Select the check boxes for all the servers or places for which you want to run the process. You can click
Select All to select all of the check boxes. To clear all of the check boxes, click Select None.
Select the Run Tasks in the background check box, and click OK.
The process is displayed as a task under the Task History node of the console. Open the task to view the
results of the process as well as any errors or warnings. If this option is not selected, the process runs in
the foreground. For more information, see General Rules for Running Tasks on page 86.
From the Migrator for Notes to SharePoint Console, right-click Migrator for Notes to SharePoint, then
select Import Database Records.
Select a CSV file that contains the records you want to import.
Then the Import Database Records dialog box appears.
Map the data from the file to the corresponding columns in the Dell Repository. For each column in the
CSV file, choose one of the available database record properties to which to map it. If your file does not
have a header row, do not select the Treat first row as column headers check box.
This tool can be used to update existing records, or add new ones. There are several methods that you can
choose from for associating an input record with existing database records:
Replica ID only
Database Key
Depending on what options are selected, you can map additional fields. If you have not done this, a warning
message appear sand the OK button is disabled.
When setting values, the related "Locked" flag is set.
Log file entries clearly indicate which databases were updated, added or not found.
Currently, the following database properties are available for mapping:
Server
Dell Migrator for Notes to SharePoint 6.6
User Guide
37
Replica ID
File Path
Database Key
Title
Technical Class
Business Class
Database Owner
Business Owner
Analysis Priority
Analysis Responsible
Migration Priority
Migration Responsible
Disposition
Disposition Comments
Design Analyzed
Data Analyzed
Targets Identified
Targets Provisioned
Targets Finalized
Jobs Assigned
Jobs Finalized
Content Migrated
Migration Verified
Target Site
Complexity
Effort Analysis
Effort Targets
Effort Jobs
Effort Content
Effort Testing
Effort Is Incremental
NOTE: If the column names match exactly, the mapped database property field pre-populates.
38
Notes Databases
The Notes Databases Console Tree node allows you to view and act upon all the Notes databases that were
identified during the Database Discovery process. The nodes below this node provide different filters of the
databases.
Table 13. Notes Databases
Property
Description
Select this node to view all databases and templates in the center pane.
All Databases
Select this node to view the list of all database in the center pane
Unique Replicas
Select this node to view just the unique database replicas in the center pane.
In cases where you have multiple replicas of the same database (that is, they
have the same Replica ID) only one representative of the database will appear
in the view. The ordering of databases in your Preferred Server list will
determine which replica is selected.
By Disposition
This tree node allows you to navigate the databases by the database
dispositions as defined in the Migration Status Tab tab of the database
properties. In cases where you have multiple replicas of the same database
(that is, they have the same Replica ID) only one representative of the
database will appear in the view. The ordering of databases in your Preferred
Server list will determine which replica is selected.
By Server
This tree node allows you to navigate the databases by the known servers
hierarchically
By Technical Class
This tree node allows you to navigate the databases by their technical classes.
In cases where you have multiple replicas of the same database (that is, they
have the same Replica ID) only one representative of the database will appear
in the view. The ordering of databases in your Preferred Server list will
determine which replica is selected.
By Business Class
This tree node allows you to navigate the databases by their business classes as
defined in the Classification Tab tab of the database properties. In cases where
you have multiple replicas of the same database (that is, they have the same
Replica ID) only one representative of the database will appear in the view.
The ordering of databases in your Preferred Server list will determine which
replica is selected.
Notes Templates
Custom Views
This tree node allows you to create your own views of the databases. For more
information, see Custom Views on page 53.
Select a Database in the Results View and in the context menu or in the Action Pane is a list of database actions
that can be selected.
39
Database Actions
Table 14. Database Actions
Property
Description
The actions listed under the All Databases header are actions that are performed
on all of the databases in the Results View.
The actions listed under the database name header are actions that are performed
on the selected databases in the Results View. The header name will change
according to which databases is selected in the Results View.
When performing certain actions for a database that has child databases under it,
you will be asked if would you also like to perform the action on the child databases.
If you answer:
Yes: The action will be performed on the selected database and all of its child
databases
View
This action brings up several submenu items that allow you to customize the Results View. Properties such as
column selection, column ordering and sorting are defined using the View menu item.
Table 15. View
Property
Description
Add/Remove Columns
Select the submenu item Add/Remove Columns to change the views column
selection as well as to reorder and sort the columns.
Select this menu item to show grid lines in the result view. If the grid lines are
already displayed, select this menu item to hide them.
Refresh
Refreshes the data displayed in the console from the data that is stored in the
Repository. When you make a change in one dialog box and save it, the data is saved
to the Repository but some of the views in the console might not reflect the change.
Executing a Refresh will update the views with the new data as well as run the
Classification process.
Customize
This submenu item allows you to show or hide items in the Console dialog box.
Export List
Exports the result set in the center pane to a comma delimited (.cvs) file.
40
Assign Properties
This action allows you to quickly set some of the more common database properties for the selected databases.
This action contains the following:
Table 16. Assign Properties
Property
Description
Lock all
This quick set option will select all of the Locked check boxes in the selected databases
properties. The Locked check boxes keep manual changes from being over-ridden in future
design scans.
Unlock all
This quick set option will deselect all of the Locked check boxes in the selected databases
properties. By de-selecting all of the Locked check boxes, any manual changes made in to the
database properties may be over-ridden in future design scans.
Disposition
This will set the disposition value in the Migration Status Tab tab of the selected databases
properties.
Technical
Class
This will set the Technical Class value in the Classification Tab tab of the selected databases
properties.
Business Class This will set the Business Class value in the Classification Tab tab of the selected databases
properties.
Choose
Target Site
This allows you to define the Target Site in Migration Targets Tab tab of the selected databases
properties.
Clear Target
Site
This allows you to remove the site that is defined in the Target Site property of the Migration
Targets Tab tab of the selected databases properties. The purpose of this is to remove any
specific target site that has been applied either directly or through the application of class
rules.
If any of the databases migration jobs have SharePoint target assignments in them, then this
site would be used when running that particular job. So the job supplied target is the last
resort target. Jobs built within the console do not have a SharePoint target site in the job.
When jobs were created in the designer and imported, then they'd retain whatever target site
was in that job, but that would get overridden by any target set directly to the database or
applied through class rules.
Map Notes
Enable or disable the highlighted databases Map Notes Users to Domain Users option of the
Users to
Migration Targets Tab tab. If enabled, this will cause any Notes users listed in the source
Domain Users database's Access Control List to be added to the target SharePoint list or library. The Notes
user names are mapped to Site Collection identities based on the rules configured in the tool's
User Mapping options and those Users are granted access to the target SharePoint site.
Map Notes
Groups to
Domain
Groups
Enable or disable the highlighted databases Map Notes Groups to Domain Groups option of
the Migration Targets Tab tab. If enabled, this will cause any Notes groups listed in the source
database's Access Control List to be added to the target SharePoint site. The Notes group
names are added to the Site Collection as external groups and are granted access to the target
SharePoint list or library. Each group name must correspond to an actual Domain group.
Expand Notes Enable or disable the highlighted databases Expand Notes Roles to SharePoint Groups option
Roles to
of the Migration Targets Tab tab. If enabled, it causes a new SharePoint Site Collection Group to
SharePoint
be created for each Role defined in the Notes database ACL.
Groups
Expand Notes
Groups to
SharePoint
Group
Enable or disable the highlighted databases Expand Notes Groups to SharePoint Groups
option of the Migration Targets Tab tab. If enabled, it allows you to take what was once a
Domino Directory group (scoped to the entire Notes Domain) and convert it to a SharePoint
group (scoped to just one Site Collection). As part of this conversion, the tool will query the
Domino Directory for any groups listed in the ACL, extract all its members (expanding any subgroups as needed), and add those members to the new SharePoint group.
41
Description
Use Existing
Security
Groups
Enable or disable the highlighted databases Add to existing SharePoint groups option of the
Migration Targets Tab tab. If enabled, Migrator for Notes to SharePoint will provision security by
adding people to one of the predefined SharePoint groups rather than setting permission on the
site members.
Migration
Jobs
This allows you to set various properties in the highlighted databases migration jobs.
Analyze Databases
This action will run various scans on the selected databases. When selected, you will be prompted with options
of which types of scans you want run. This action contains the following:
42
Description
Scan
Database
Headers
Select this to run a scan of the usage history in the selected databases. This will produce
detailed usage information like database size, number of reads, writes and uses by user and by
form used. To exclude certain users from this analysis, see Excluded User Names on page 23.
You can view these results in the Usage Analysis Tab tab of the Database Property sheet. This
action is also available as a button on the Usage Analysis Tab tab of the Database property
sheet.
Scan Data
Documents
Select this to run a direct scan of all the data documents in a database to produce a summary
of data patterns in use there. This action is also available as a button on the Complexity Tab
tab of the Database property sheet.
There are three levels of Data Analysis to choose from:
Analyze Rich Text Full scan reading the rich text identifying Docs with Notes Rich Text,
Docs with MIME, Docs with Images, and Docs with DocLinks.
Analyze Documents Opens each document and counts up documents, but does not read
rich text fields. Up to twice as fast as the full scan.
Data Tally only Counts documents but does not open them. Typically 5 times as fast as
the full scan.
NOTE: In Quickr, many "design elements", including custom pages and custom fields, are stored
as data documents. Similarly, in Domino.Doc, many "design elements", including custom binder
and document type descriptions, are stored as data documents. The data analysis does not
treat these as data documents.
43
Property
Description
Scan Design
Elements
Select this to run a direct scan of all the design elements in a database to produce a summary
of data patterns in use. This action is also available as a button on the Complexity Tab tab of
the Database properties sheet.
NOTE: In QuickPlace/Quickr, many design elements, including custom pages and custom fields,
are stored as data documents. Similarly, in Domino.Doc, many design elements, including
custom binder and document type descriptions, are stored as data documents. The design
analysis process recognizes these documents as constituting the interesting application design
and looks at those abstractions rather than true Notes design elements.
The following options are available for this design scan:
Compare with class templates for best fit: Select this option to do a best fit design
matching in order to recognize which applications are based on similar designs,
regardless of whether or not they are currently inherited from the same application
template. The design of each database is compared with the designs of the technical
class templates you want to compare to. This is similar to the existing feature for
comparing the designs of applications and their assigned templates, but this is many-tomany instead of one-to-one. The best fit for each database is then displayed in two
results view columns (Best Fit Class and Best Fit Percent) as well as on the Design
Analysis Tab tab.
NOTE: For a technical class template to be considered in this Best Fit analysis, its property,
Include in Best Fit testing for all databases, must be checked in the Class Template Tab of
the Technical Class Properties sheet. For a quick way to include all the Notes databases and
templates that you want as technical class templates for Best Fit analysis, use the Create
Technical Class database action. If you have already done the design scan for the database and
the templates, you can adjust the list of things to test for and rerun the comparison using the
Recompute Database Details function.
Assign default templates for database comparison (if none assigned): If selected, this
will automatically set the reference database using the databases default template. To
do this, it uses the databases template name to locate a matching template database.
This reference database is then used in the design analysis for measuring deviations.
Copy database designs to local folder: When enabled, a partial copy of each scanned
Notes database is made on the local machine. While all the design elements are copied,
none of the data documents are. The copies are placed in a folder that defaults to
ProgramData\Dell\Migrator for Notes to SharePoint\Design Copies. This may be
changed on the Analysis tab of the Advanced Configuration Options dialog. The design
copies are named <replica id>.nsf in the file system and the database titles will be
appended with the string "- DESIGN COPY". Since the replica id is the unique identifier
for design copies, they will be shared by all replicas of the database. If you analyze two
servers with replicas of the same database, the second one will not be copied unless the
Override prior copies option is checked. The design copy provides an easy way for a
developer to look deeper into the design when needed.
Scan Doclink
Select this check box to scan all Doclinks in one or more databases. This action is also available
using the Doclink Scan button on the Data Analysis tab of the Database properties sheet. To
see details of the scan, see the Doclinks button in the Data Analysis Tab on page 56.
Scan Design
Scripts
Select this check box to scan all design scripts of one or more databases. To see details of the
scan, see Script Analysis Tab on page 58.
Advanced
Run task in background: If selected, this action will run in the background as a task. To see the
status and log files generated, go to Task History on page 85. If deselected, this action will run
in the foreground with the task properties dialog box displaying progress, status and logs.
44
Description
This action will use the classification rules defined for the selected
database to automatically triage the database. For more information on
these rules and triage, see Auto Triage Tab on page 74.
This action will use the classification rules defined for the selected
database to automatically assign migration effort for the database. For
more information on these rules, see Assign Effort Tab on page 74.
This action will use the classification rules defined for the selected
database to automatically assign migration targets for the database. For
more information on these rules and targets, see Auto Target Tab on page
75.
This action will use the classification rules defined for the selected
database to automatically assign migration jobs. For more information on
these rules, see Migration Jobs Tab on page 77.
Assignment based on
You can choose to run the actions using the Technical Class rules or the
Business Class rules
The Lock selections of the selected database will be ignored. This means
that any locks in the selected databases will be cleared and any database
properties that were set manually will be overridden by the properties
defined in the class rules.
If selected, this action will run in the background as a task. To see the
status and log files generated, go to the Task History node. If deselected,
this action will run in the foreground with the task properties dialog box
displaying progress, status and logs.
45
Migrate to SharePoint
This action will run migration activities for the selected databases. When this action is selected, you will be
prompted with options of which types of migration activities you want performed. Click the Details link to see a
preview of the migration tasks to be performed based on the options you selected.
Table 19. Migrate to SharePoint
Property
Description
Provision planned
SharePoint sites
This action will perform the actual site provisioning of sites and subsites for the
selected databases. The planned sites for a database can be viewed/defined in
the Migration Targets Tab tab of the Database Properties sheet.
Provision site content types This action provisions the content types defined for the selected databases.
These content types can be viewed in the in the Content Types tab of the
Database Properties sheet.
Provision site members
This action will migrate the Access Control List mappings defined for the
database. Migrator for Notes to SharePoint will map various access control
properties of the source Notes database, QuickPlace/Quickr, or Domino.Doc
cabinet to the equivalent constructs in SharePoint. An extensive set of options
are available for mapping various access control properties of the source Notes
database and individual Notes documents to the equivalent security constructs in
SharePoint. These mappings can be viewed in the Migration Targets Tab tab of the
Database Properties Sheet. For more information on ACL mappings, see ACL Entry
Mapping and SharePoint Group Provisioning on page 64.
This action will migrate the QuickPlace/Quickr room menu to the SharePlace
QuickLaunch menu bar as defined by the databases QuickPlace/Quickr tab
properties or the Classification Rules Auto Target Tab properties.
NOTE: Link Tracking needs to be enabled for the provisioning of the site
navigation.
NOTE: If new menu items have been added to the QuickPlace/Quickr room menu
since the last time a QuickPlace/Quickr Discovery or Domino.Doc Discovery
process has been run, you will need to run this discovery process again in order
for this provisioning action to pick up the new items.
This action will run the migration jobs defined for the selected databases. These
job definitions can be viewed in the Migration Jobs Tab tab of the Database
Properties Sheet. You have the option to run the complete job which migrates the
content as well as provisions the lists, columns, content types, and security. You
can also choose to only perform the provisioning or the provisioning and security.
Each running migration job will be displayed as a task under the Task node of the
console. If the selected database had more than one job defined for it, each job
will be displayed as a separate task and there will be a wrapper job called
Content Migration Sequence (#jobs) where # is replaced with the number of jobs
being run for the database. Open the task to view the results of the migration as
well as any errors or warnings. For more information on the Task node refer to
Task History on page 85.
Details: This link will bring up the Migrate to SharePoint Details dialog box. This
dialog box gives you a preview of the migration tasks to be performed based on
the current options and selections. It will show you the subsites that will be
created as well as the databases to be migrated.
Run task in background: If selected, this action will run in the background as a
task. To see the status and log files generated, go to the Task History node. If
deselected, this action will run in the foreground with the task properties dialog
box displaying progress, status and logs.
If there are no migration jobs assigned to the selected databases, you will receive
an error message.
You can assign migration jobs using the Properties.
Dell Migrator for Notes to SharePoint 6.6
User Guide
46
Description
Form Template
compatibility
InfoPath 2007 client: The InfoPath client supports all the InfoPath controls, so
no restriction is placed on the controls being migrated.
Add attachment section Enabling this option will cause a repeating Attachment section to be added after
to rich text controls
every rich text control that is migrated. This is because Rich Text fields in InfoPath
do not support attachments like they do in Notes.
The second page of the wizard is where you select the Notes form elements to be migrated.
Table 21. Notes for elements
Option
Description
47
The third page of the wizard is where you set the default control sizes.
Table 22. Default Control Sizes
Option
Description
Control measurements
Some fields in Notes do not have a specified size, like text fields and dialog
lists. When these controls are mapped to InfoPath controls, they need to be
given a width and sometimes a height. These options specify the default
height/width for controls that do not have a set size in Notes. If the Auto check
box is selected, no width or height value is needed. When set to Auto, the
InfoPath field takes up no screen space until you type into it, then it grows as
necessary, similar to Notes. Not all field types support the Auto feature. Only
the supported field types will have this option available.
If a table cell contains a control that does not have size specified in Notes,
checking this box will cause InfoPath to set the control width to 100%, instead of
the width set in the Control measurements. This may provide a table rendering
closer to the original table in Notes.
The fourth page of the wizard is used to set which Notes fields are migrated to InfoPath, and how those fields
should be mapped when creating a InfoPath document migration job later. For more information, see
Generating InfoPath Forms (post version 5.2) on page 113.
The following is a description of the options:
Table 23. Options
Option
Description
Name of the field on the Notes form to be migrated. This is not modifiable.
Migrate to InfoPath
If checked, the Notes field will be migrated to the new InfoPath form template.
To exclude a field from being migrated, uncheck the corresponding check box.
Setup field for data mapping If checked, the field will be marked available for mapping when this generated
template is used to setup a document migration job.
InfoPath field name
The name of the corresponding InfoPath field that is generated. This name can
be changed if desired.
Options
This is a dropdown list that is dependent on the field type. For date/time field
types, you can specify what part of the date/time to migrate. When the
generated template is used to create a InfoPath document migration job, this
field serves as a hint on what type of data is in the Notes field and how it should
be encoded
The fifth page of the wizard shows you the options you have selected.
Table 24. Options
Option
Description
Enabling this option will create an HTML file in the template's destination folder
named templatename.html. This file is a report of the form migration job,
showing all paragraphs, tables, text, controls and other elements of the Notes
form, and what was done to migrate the element to the InfoPath form
template.
48
Description
The InfoPath XSN file format is comprised of several files archived together in
the Microsoft CAB format. Selecting this option will leave these generated files
on-disk in a folder named template_Migrator for Notes to SharePointiplog, in
the same folder as the completed template. These may be helpful to Customer
Support when diagnosing a problem.
Create developer
documentation version of
the form template
Once the migration is complete, a dialog box will appear with the buttons:
Launch Form Template in Design Mode - launches InfoPath in design mode, so the developer can make
changes to the template
Fill-out the Form - shows a preview of what the generated form would look like to an end-user
View Detailed Migration Report - opens the migration report in the default web browser
The migrated form will appear as a .XSN file in the selected folder. If the option Write migration log files is
checked, in the folder will be a subfolder named formname_Migrator for Notes to SharePointiplog. This folder
contains all the source files that comprise the InfoPath template, and a log file named "Migrator for Notes to
SharePoint_infopath_log.txt" if the form migration failed. These are useful for debugging in case the template
does not load properly in InfoPath.
The newly migrated form can now be used to migrate Notes documents to InfoPath documents. For more
information, see Generating InfoPath Forms (post version 5.2) on page 113.
InfoPath's rendering engine is HTML based, so most of the form's text, fonts, colors, styles, and tables will be
migrated as straight HTML in the same way HTML is generated today. The following Notes properties and fields
are migrated:
Background image - will be the background image of the InfoPath template. These repeat styles are
supported: repeat once, repeat horizontal, repeat vertical, and repeat both.
Computed Text field: 1. Computed OR Computed for Compose: Creates a schema entry and renders an
expression box mapped to the schema entry. 2. Computed for display: Does NOT create a schema entry.
Renders an expression box with nothing displayed. Also, the Notes field will not show up in the list of
fields to migrate.
Date/Time field: will be migrated as Text fields with Data Type set to Date, Time, or DateTime,
depending on the field settings in Notes. If the display value for the date/time field is "User setting", this
means that Notes will use Operating System preferences for displaying the date/time. Notes has eight
"Show" settings for the date when User Setting is used, and not all of these map to an operating system
preference value in InfoPath, so an approximation will be made.
Number: these fields in Notes can be of the following formats: decimal, percent, scientific, and
currency. Currency will map to a currency type in InfoPath. The other three types will map to decimal.
The Notes number field formatting options "parenthesis when negative" and "Punctuated at thousands"
will be migrated to InfoPath
Richtext: these have no set size in Notes but require a fixed size in InfoPath. Size is set in migration
options dialog box.
Radio button
Dell Migrator for Notes to SharePoint 6.6
User Guide
49
check box
Dialog List - This is a popup list selector. InfoPath has no concept of this, so a drop-down list, Combo box,
or Multi-select list box is generated depending on the properties of the dialog list (whether multi-select
is allowed and whether the user can enter new values).
Hidden properties on paragraphs are honored according to the user-defined migration options.
Select the Notes form that you want migrated and the destination filename for the InfoPath Form
Template that is to be created. Click Next.
Do not migrate elements that are: Paragraphs in a Notes Form can be marked hidden based on
several different factors. If unchecked, the paragraphs are migrated regardless of the hide
setting, but the check boxes in this section can be used to honor the hide setting in Notes. So if
"Hidden in Read mode" is checked, then if a paragraph is marked "hide when opened for reading",
the paragraph will NOT be migrated.
Create InfoPath Sections for elements that are: The corresponding check box must be cleared
for this to be enabled. Checking one of these will cause paragraphs hidden by the given method
to be wrapped in an InfoPath "Section" control. This is handy because it allows the InfoPath
developer to refer to the entire hidden area with a single identifier, making show/hide logic
easier.
50
Control measurements: Some fields in Notes do not have a specified size, like text fields and
dialog lists. When these controls are mapped to InfoPath controls, they need to be given a width
and sometimes a height. These options specify the default height/width for controls that do not
have a set size in Notes. If the Auto check box is selected, no width or height value is needed.
When set to Auto, the InfoPath field takes up no screen space until you type into it, then it grows
as necessary, similar to Notes. Not all field types support the Auto feature. Only the supported
field types will have this option available.
Set fields in table cells to 100% width: If a table cell contains a control that does not have size
specified in Notes, checking this box will cause InfoPath to set the control width to 100%, instead
of the width set in the Control measurements. This may provide a table rendering closer to the
original table in Notes.
Select a form template compatibility to determine which type of form will be migrated to the target.
NOTE: For this release, Nintex Forms 2010 and 2013 are supported.
Select a Nintex subform/Form Template to migrate to the SharePoint list, and click Next.
Select the form elements to be migrated. If you want, hide elements that you do not want migrated.
Select a destination filename for the Nintex form template, and click Next.
Customize your mapping options. Customize the schema that will be generated in Nintex and select the
field type that will be migrated to the target template. Click Next.
NOTE: If you used an external job definition to bind SharePoint list columns, mappings between
Nintex fields and SharePoint columns have been established. You can enter additional SharePoint
column names manually.
Enter the default control measurements, in pixels, for the Notes Form Template, and click Next.
10 Review your migration options. You can select to write detailed migration report and/or detailed log
files to the target folder. Click Next.
NOTE: A log file is automatically generated in Task History.
Migration is complete. You can view the form in Nintex form template file or view the detailed migration
report.
NOTE: If you want to customize the Nintex form template further, you can use Nintex Designer.
11 Click Close.
Go to Notes Database
This action will launch Notes if it is not already open and take you to the selected Notes database.
51
The sources of the user names are listed in the view columns. You can filter this list by using the filter options at
the top of the dialog box. Filter by source allows you to filter the sources shown to only list users that came
from certain sources. The list will automatically refresh when a filter option is changed.
The type of user name (Person, Group, Unspecified) is also shown and you can filter based type. Note that
Unspecified users may become specified as you perform certain operations such as group expansion or imports.
Finally, you can manually set the user type by using the combo boxes in the view.
You can also filter by the Notes domain. This is a simple text match against the last part of the abbreviated
name, so either "Westford/IBM" or just "IBM" would select "Kevin MacDonald/Westford/IBM". If is common to
want to select all the users plus all the groups, which the "No domain" check box allows you to do.
52
Users may also be added to the list by expanding Domino groups. If a group is listed in a database, it is
sometimes useful to be able to find all the members of the group. If you press the Expand Groups button,
Migrator for Notes to SharePoint will contact the configured Group Resolution Server (from Advanced
Configuration Options on page 18) and look up every Group and Unspecified entry (in case it really is a group).
Any new members will be added to the list and indicated as "ACL via Group".
Users may also be added to the list by importing existing Migrator for Notes to SharePoint User Mapping XML
files.
To remove users from the list, you can select one or more rows and click Remove.
The last column in the view is the SharePoint names column. You can set these names automatically using the
Import function, using the Set SharePoint Names function, or by typing them in manually.
The Import process loads in users from existing XML User Mapping files and sets the Imported column. Imported
data is merged with existing data but if a SharePoint name is specified in the imported file, it will overwrite the
existing name every time.
The Set SharePoint Names function gives you several ways to automatically assign your SharePoint names.
Lookup value in Domino Directory - use any field in the user's Person document on the Domino directory
as the new SharePoint name
Set Default using format string - Generate a new SharePoint name by substituting the various parts of
the Notes name.
Set Default using the Notes common name - Use the simple common name as the SharePoint name
NOTE: In all these cases, existing SharePoint names will be preserved unless the override SharePoint
names flag is already checked.
Click Export to generate a User Mapping file (either in an XML or comma delimited format).
Delete
Deletes the selected database from the Repository. The database can be added back to the Repository by
running the Database Discovery process.
When a database is deleted in a view, another replica of that database may become the "preferred replica" and
reappear in the view. The replica chosen as the preferred replica is the replica whose server is highest in the
Preferred Notes Server List of the Global Options Discovery tab.
Custom Views
In addition to the standard database views that are provided, users can design their own.
All custom views appear under the Custom Views scope node under the Notes Databases node. The Custom View
node has actions to add, edit or delete custom views.
Description
View Title
53
Description
View Scope
The database scope node that the custom view will be based on. The custom view will
be a filter of this scope nodes result set.
Filters
Select one or more check boxes for the data types you want to filter the result set on.
The data type button on the right of the check box will be enabled. Select the button to
specify the filter. Check one or more of the check boxes that correlate to the data you
want displayed in your view. You can deselect a check box by selecting it again.
Other view properties such as column selection, column ordering and sorting are defined using the View menu
item of the Actions pane. Select the submenu item Add/Remove Columns to change the views column
selection as well as to reorder the columns. The Sort By menu items allow you to change the field that the view
is sorted on.
Properties
This action opens the Database Properties. This is where you can view collected information and manage
migration decisions for the selected database. Migration jobs can be defined and run from here is well.
General Tab
General information about the current database. This information is automatically filled in during the Database
Discovery process.
Table 26. General tab
Property
Description
Title
name of database
Categories
Name of the databases category in the Database Catalog. This can be used in classification
rules to assign the database to a business or technical class
Server
Path
Replica ID
Other Replicas Listing of other databases that are replicas of the current database. It includes the server
of this
name, path and last date modified
database
Database is a
Design
Template
check box that indicates if this database is being used as a design template for other
databases
Template
name
54
Description
Database is
based on a
Design
Template
check box that indicates if this database uses another database as its design template.
Template
name
Database is a
Mail-in
Database
check box that indicates if this database is a Mail-in database. This property is set when the
Discover Directory Entries process is run.
Name
QuickPlace/Quickr
If this is a QuickPlace or Quickr database, the QuickPlace or Quickr tab will be visible. This is where you set
QuickPlace or Quickr specific options.
Select Provision Navigation Links to QuickLaunch Area if you would like to recreate the QuickPlace/Quickr
room menu in the SharePoint QuickLaunch during migration. You can choose to append to the existing
QuickLaunch menu at the top or bottom of the menu or to completely replace the menu. The Replace list
option will delete the current QuickLaunch menu and replace it with the QuickPlace/Quickr room menu being
migrated. The At the top of the list and At the bottom of the list options will delete and then add the links
that contain the same names as those in the migration. This will prevent duplicate menu items.
NOTE: While QuickPlace/Quickr rooms can have several levels of menu items in the navigation hierarchy,
SharePoint can only have two levels. During provisioning of the navigation hierarchy, all levels that are
lower than the second level will be flattened to the second level in SharePoint.
Classification Tab
Table 27. Classification tab
Property
Description
Technical
Classification
Business
Classification
Class: The business classification of the given database. This is automatically populated
by the Classification Rules engine. You can change this value manually by selecting a
different class in the dropdown list box. To keep this manual change from being overridden in future design scans, select the Locked check box. If you do not see the class
you want to assign this database to, you can define a business class using the
Classification Rules node. For more information, see Notes Databases on page 39.
55
Create Date
Last Modified
Design Modified
Last Used
Number if reads, writes and uses for a given length of time. The row, Last xxx days includes all days
for which non-filtered usage information is present in the database. This usually differs between
databases.
The user activity table displays the number of database reads, number of writes and number of uses in the last
24 hours, last week and last month.
Details by user button gives you the number of reads, writes and uses as well as the last read, last write and
last used dates by user. It also displays if the user is part of the Excluded User Names list. A user can be added
or removed from the Global Excluded User Names List using the context menu once the row for the user has
been highlighted. This type of change does require the Data Scan to be re-run it to be picked up in the details.
Figure 3. Activity Details
NOTE: In order to capture user activity for a database, User Activity must be turned on in the Notes
database. To do this, open the User Details of the Database Properties and check the Record Activity check
box.
56
and counts up Attachments, but does not read rich text fields. This is up to twice as fast as the rich text scan.
Click the Doclink Scan button to run a Doclink scan.
This tab contains the following data analysis:
Table 28. Data Analysis tab
Property
Description
Database size
Total size of all documents stored in the database (excluding design elements,
deleted documents and unused database space)
Data Documents
with Attachments
with Objects
with Responses
with MIME/HTML
with Images
with DocLinks
Number of documents with embedded copies of the original Notes form that was used
to create the document. This is useful for seeing how prevalent embedded forms are
in practice.
with Signatures
with Encryption
Profile Documents
Blocked Attachments
Number of attachments that will be blocked by SharePoint and therefore will not be
included in the migration. This number includes files that are larger than the
maximum attachment size allowed as well as files whose extensions are on the
blocked file extension list. To view or define the list of blocked file extensions, see
SharePoint tab of the Advanced Configuration Options dialog box.
Oversized Attachments Number of attachments that are larger than allowed and therefore will not be
included in the migration. To view or define the maximum attachment size, see
SharePoint tab of the Advanced Configuration Options dialog box
Doclinks
Shows the total number of Doclinks in all known databases. Click this button to view
Doclink information for each database, including the number of Doclinks, server, and
last filepath of the database.
NOTE: Quickr links are not included as Doclinks in this view.
By forms used
Gives you statistics around the number of forms used of which type and when. The
number of forms used as document types of actual data documents is typically far
less than the number of forms in the database design. Knowing which forms are used
to create actual data documents is often helpful when planning the equivalent
Content Types in SharePoint.
57
Description
By unique authors
Attachments
Description
Gives details, such as date and time of scan, number of lines of script scanned, and
size of DXL. Click Show Summary to open the Script Scan Viewer so you can see the
scan details of the database design objects.
Allows you to cache database scripts to a path you specify. Click Script Scan to run
the scan again.
58
Design Details
Description
Design Details button opens the Design Element Details dialog box
From the Design Element Details dialog box (click Design Details), you can view
the design elements of the database organized by type.
To exclude particular design elements from the Complexity Tab calculations,
highlight the elements in the dialog box and click Exclude. The elements that have
been flagged for exclusion will have a red X next to them. To re-include an
element, select it and click the Exclude button again. An example for needing to
exclude elements is if you know you are not going to be migrating any web only
design elements. Then you dont want them part of the design complexity analysis
so you would filter out all the web-only design elements. Use the Quick Filter as a
quick way to Exclude multiple elements. You will need to rerun the Recompute
Database Details for the design analysis to be updated for the database.
You can also select a Notes Form that you want migrated to an InfoPath or Nintex
form template. Select the Form you want migrated and click the Export to
InfoPath Template button, or right-click and from the context menu and select
the menu item Export to InfoPath form template.
For detailed information on this process, see Generate InfoPath Form Template on
page 47.
59
Description
This is where you can measure deviations in design between the current database
and another database (typically a design template or another database that you
suspect is based on a common design). Identifying similar databases can be very
useful when planning your migration process. To select a template or similar
database to compare to, check the box and click the Select button. The Default
button will automatically find the template database based on the template name,
if there is one. You can assign the reference database automatically during the
Auto Triage process by setting up a Class Rule and using the fields on the Auto
Triage Tab.
If both databases have had a Design Scan done than you get a comparison of the
two databases immediately. Or, if you press the Scan Design button, both
databases will be scanned immediately.
The Class Template Match Details dialog shows all the partial matches as well as
the best fit match. To associate the technical class of one of the matches to the
current database, highlight the class name and click Set as Technical Class for
Database.
Best Fit: The technical class template that best matches the database in
regards to design.
NOTE: For a technical class template to be considered in the Best Fit analysis, its
property, Include in Best Fit testing for all databases, must be checked in the
Class Template Tab of the Technical Class Properties sheet. For a quick way to
include all the Notes databases and templates that you want as technical class
templates for Best Fit analysis, use the Create Technical Class database action.
Percent Match: Percentage the databases design matches the best fit class
templates design.
Details: To see the class template match details, click this button.
Complexity Tab
Once a design scan and/or data scan is completed, a summary of data patterns in use are displayed in this tab.
The global complexity settings from the Global Options Analysis tab are used in the complexity computations in
this tab.
This tab contains the following:
60
Description
If the Microsoft Design Element Index is defined as a factor to use in the automatic
complexity assignment as defined in the Analysis tab of the Global Options, then
this section will be filled out using the published DEI algorithm.
Calculations: This button will open a dialog box that shows the detail
calculations of the Index
NOTE: The complexity is based on Microsofts published DEI (Design Element Index)
algorithm which tallies the numbers of various types of design elements and
computes a complexity index. For more information on DEI:
http://notes2sharepoint.org/2011/03/10/understanding-dei-and-othercomplexity-metrics/.
Data Complexity
Design Complexity
Overall Complexity
Details: To view the data details click this button. This will take you to the
Data Analysis tab which shows a summary of similar data record counts
summarized by Form Used.
Data Scan: This button runs the data scan against the database to populate
the Data Complexity. This process can also be run from the database actions
list in the database context menu. See For more information, see Scan
Design Elements on page 44.
Details: To view the design details click this button. This will take you to
the Design Analysis tab which shows a list of all interesting design elements
in the database with basic information about each.
Design Scan: This button runs the design scan against the database to
populate the Design Complexity. This process can also be run from the
database actions list in the database context menu. For more information,
see Scan Design Elements on page 44.
This number will be automatically computed and filled in when the Design
and Data Scans are run. A weighted average of the algorithms will be used,
depending on the preferences you set in Advanced Configuration Options.
You should always treat automatic calculation as an approximate indicator
of complexity and perform a detailed analysis of databases before
performing the actual migration.
This number may be assigned by a class rule. If you have already analyzed
the complexity for a particular class of database (for example, a Discussion
database) you can use a class rule to automatically set the Complexity for
all instances of that class. Assignment by class always overrides automatic
calculations and will cause Set by database class rule to be displayed
after the Complexity entry field.
Once you have analyzed the complexity for a particular database, you can
manually change this number if needed. To keep the manual number from
being over-ridden every time a scan is run, select the Locked check box.
61
Description
If checked, the numbers entered below should not reflect the analysis,
development and testing effort that is expected for the original database
template (the reference database on the Design Analysis tab). The effort
estimates for the reference database will be displayed alongside the
incremental effort required for this databases instance. If the database
does not have a reference database defined for it, click the Set database
link to define one
Analysis work
Development of new migration jobs Enter a number that represents the development and content migration
effort.
Provisioning and content migration
Totals
Estimate total
Locked
Select this check box to keep the manual numbers from being overridden every time a scan is run.
Description
Database Owner
From the dropdown list, select the user that is the database owner. If the user is not in
the list, select the edit names entry to add the user.
Business Owner
From the dropdown list, select the user that is the business owner of the database. If the
user is not in the list, select the edit names entry to add the user.
Analysis Priority
Responsible
From the dropdown list, select the user that is the responsible for conducting the analysis
of the database. If the user is not in the list, select the edit names entry to add the user.
Locked
Select this check box to keep the manual selections from being over-ridden every time a
scan is run.
Migration Priority
Responsible
From the dropdown list, select the user that is the responsible for conducting the
migration of the database. If the user is not in the list, select the edit names entry to
add the user.
Locked
Select this check box to keep the manual selections from being over-ridden every time a
scan is run.
Dell Migrator for Notes to SharePoint 6.6
User Guide
62
Description
Disposition
Dropdown list of predefined actions that you want to do with this database (for example,
Migrate to customized SharePoint targets, and End of life). This list can be customized
using the Console tab of the Global Options. This value can be automatically set using
Classification Rules. For details, see Auto Triage Tab of the Classification Rules.
Locked
Select this check box to keep the manual selection from being over-ridden every time a
scan is run.
Comments
Text box
Status
These check boxes allow you to keep track of what has been finished for this database in
the migration process workflow. As each task is completed, check the tasks check box.
Many of these check boxes can be automatically checked as the actions are completed by
the console. The Console tab of the Global Options dialog box is where you can turn on
the automatic management of these statuses.
Design Analyzed
Data Analyzed
Targets Identified
Targets Provisioned
Targets Finalized
Content Migrated
Migration Verified
Description
Target Site
Enter the Url of the SharePoint site you intend to migrate to. This target site will
override the site that may be specified in the individual migration jobs. By clicking
the Select button, the site sector dialog box opens. The site selector shows existing
and planned SharePoint sites and subsites in a tree. The planned sites are indicated
using a green plus sign icon.
To be sure this is the site you want to target, you can open the site by select the site
on the tree and selecting the Go To button.
To indicate new sites that you plan to provision in the future, select the parent site
in the tree and then select the New Sub-Site button. This will bring up the Site
Creation Options dialog box. For information on this dialog box, see Plan a new
SharePoint subsite on page 80 of the SharePoint Targets on page 79 section.
This section shows information about the SharePoint site (if it exists) or information
about the planned site if it has been defined.
63
Description
causes any Notes users listed in the source database's Access Control List to be
added to the target SharePoint list or library. The Notes user names are mapped
to Site Collection identities based on the rules configured in the tool's User
Mapping options and those Users are granted access to the target SharePoint
site.
causes any Notes groups listed in the source database's Access Control List to be
added to the target SharePoint site. The Notes group names are added to the
Site Collection as external groups and are granted access to the target
SharePoint list or library. Each group name must correspond to an actual Domain
group.
causes a new SharePoint Site Collection Group to be created for each Role
defined in the Notes database ACL
allows you to take what was once a Domino Directory group (scoped to the entire
Notes Domain) and convert it to a SharePoint group (scoped to just one Site
Collection). As part of this conversion, the tool will query the Domino Directory
for any groups listed in the ACL, extract all its members (expanding any subgroups as needed), and add those members to the new SharePoint group.
To fine-tune you mapping options, click the Advanced Security Settings link.
adding members to an existing SharePoint group (Migrator for Notes to SharePoint will
provision security by adding people to one of the predefined SharePoint groups rather than
setting permission on the site members. You must fill out the mappings for various ACL
levels to SharePoint Groups on the Group Assignment tab.)
setting explicit SharePoint permissions directly on site members. When "Add to existing
SharePoint groups" is selected (the mappings on the Permission Mapping tab will apply)
Provision SharePoint Groups. This is only active if the Expand Notes Roles to SharePoint Groups
or Expand Notes Groups to SharePoint Groups options have been selected in the Migration
Targets tab.Group name mappings:
64
To override the new SharePoint group name, click the Group name mappings button. The
Security Group Mapping dialog box opens to map Notes Roles or Groups to new or existing
SharePoint groups.
Click Add to add a Notes role or group to an existing SharePoint Group. If you are mapping
to a SharePoint group that is not in this mapping table, a new SharePoint Group with the
old Notes role or group name is created.
To allow only standard SharePoint groups, select the Only allows standard SharePoint
Groups check box.
Select Prevent creation of new SharePoint Groups check box if you want to limit the
number of new groups that are created as a side effect of the user mapping process. If you
leave this clear, the "Expand Notes Roles to SharePoint Groups" and "Expand Notes Groups
to SharePoint Groups" functions will create groups with the same name that was used in
Notes (with the optional prefix). But if you check this option, only the names listed in the
mapping table will be used.
Enter a value for Prefix the names of groups created for roles with: the Expand Notes
Roles to SharePoint Groups option causes a new SharePoint Site Collection Group to be
created for each Role defined in the Notes database ACL. To avoid possible collisions with
existing SharePoint Group names, you can enter a prefix that will automatically be
appended to the beginning of each group name.
Provision document level security. The Provision Document Level Security section is only active
if the Map Reader/Author fields option is selected in the migration jobs Advanced tab.
Select the Add new site collection members if needed to access documents radio button
is selected by default. This ensures that a reader/author that has no access to the site is
still given Limited Access permissions at the list and site level so that they have access
to the document.
Select the Only grant access to documents if member already has access to site
collection radio button so the readers/authors with no permissions at the site level will
not be given Limited Access. They will not be able to access the document.
NOTE: All of the security options have the possible side effect that SharePoint permission
inheritance links may be broken. This means that future changes to site level permissions
would not "trickle down" to the list or library and future changes to list or library level
permissions would not "trickle down" to all the individual documents.
The Provision Document Level Security section is only applicable to job specific security settings.
This dialog is inactive if opened from the Migration Targets tab of the Database Properties sheet.
65
The SharePoint permission level that is selected in the Advanced Security Mapping dialog must match the name
of a permission level on the target SharePoint site. This is true even for the standard SharePoint permission
levels such as "Full Control". In order for the ACL Level mapping to succeed, there must be a SharePoint
permission level on the target site named "Full Control".
This can present a problem when trying to map ACL Levels to a SharePoint site that is not using English. For
example, in a French SharePoint site, the name of the "Full Control" permission level is "Contrle total".
Unchecking the Only allow standard permission levels option will also retrieve the names of the permission
levels from the target SharePoint site. In this case, however, the selections will not be restricted to "Full
Control" and "Design". The names will be in the language of the target SharePoint site. When this check box is
unchecked, the text in the combo boxes can be edited. This allows you to fill in permission levels in case you
cannot access the SharePoint site.
Checking the Only allow standard permission levels option again will restore the standard permission level
selections to the combo boxes, and they will no longer be editable. If you had entered a non-standard name in
the combo box, it will be replaced with the appropriate default for that combo box.
Clicking the Load from SharePoint Site/Refresh link in the dialog retrieves the names of the permission levels
from the target SharePoint site thus bringing in the appropriate permission level name. When this dialog box is
first opened, a target SharePoint site has not been specified, so Migrator for Notes to SharePoint won't know
where to retrieve the permission level values from. The Refresh link will initially be replaced with a Load from
SharePoint site link. Clicking on this link will bring up a site picker that will allow you to choose a SharePoint
site from which to load the permission level values. Once you have loaded the permission levels from a site, the
link will change to Refresh.
Content Types
This tab allows you to define and provision SharePoint Content Types for a SharePoint Site.
You can add Content Type definitions to be provisioned in many ways.
Import: Allows you to add a Content Type definition from a previously exported Content Type definition
file.
From Notes Form: Create a Content Type definition based on a Notes Form.
From Migration Jobs: Allows you to take the fields in the target data definition of a migration job and
use them in a Content Type definition.
From Existing List: Allows you to take a SharePoint List and turn it into a Content Type definition.
66
From Existing Content Types: Create a Content Type definition based on an existing Content Type.
To edit a Content Type definition, select it in the list and click Edit.
To delete a Content Type definition, select it in the list and click Delete.
To provision the list of Content Types shown in the tab, click Provision.
NOTE: If a Content Type in the list already exists in the target site, the existing Content Type definition
will be updated. Any new columns will be added but columns that are in the existing Content Type that
are not part of the Migrator for Notes to SharePoint definition will not be removed. They will be left as is.
Description
Name
Description
Enter the Group that this Content Type should be associated with. Use
the Select button to choose from the Content Type Groups already
defined in the target site. If the Content Type Group you enter does not
exist in the target site during provisioning, the Content Type Group will
be created in the site.
Enter the Parent Content Type for this Content Type. Use the Select
button to choose from the Parent Content Types already defined in the
target site. The Parent Content Type you enter must already exist in the
target site during provisioning.
Associated Forms
Current Status
67
Click Edit.
This will open the job definition in the Job Designer dialog box.
To create a job
Click New.
An empty Job Designer dialog box opens.
To give your job an easily identifiable name, select the Properties button on the Job Designer. You can
define a Job Name and Description which will then be displayed in the Migration Jobs tab.
For detailed information on defining a migration job using the Job Designer, refer to Migrator for Notes to
SharePoint Designer on page 91.
For detailed information on running a migration job, refer to Migration Jobs Tab on page 68.
Migration History
This tab contains the history of all of the migration jobs run for this database. It lists out each job with Date and
Time the job was run, the status of the job and the description of the job. Double Clicking a job will open the
log file for the job. This information is also viewable in the Task History node.
Applications
There are cases where one or more Notes databases can be grouped together as a single "application". This is
particularly useful when treating multiple databases as a single application is important: namely QuickPlace,
Quickr, and Domino.Doc. With these environments, recognizing the patterns of application organization can
drive automatic assignment of migration jobs or automation of actual migration jobs.
Applications are "discovered" by running the Discover Quickr Applications, Discover QuickPlace Applications, and
Discover Domino.Doc Applications actions. Once these applications are discovered, you can expand the
Applications node and drill-down into the Quickr and QuickPlace server/place/room or Domino.Doc
server/library/cabinet application hierarchies.
NOTE: This hierarchy of application nodes can be used to automatically generate a similar hierarchy of
SharePoint sites. To accomplish this, see the Create subsite for every child application option in the
Auto Target Tab of the Classification Rules.
The nodes and sub-nodes displayed here are really just database nodes (the same ones shown in the databases
views) except that they are displayed according to the rules of the application abstraction rather than as "plain"
databases. To view information about the underlying databases, select the Properties action.
Classification Rules
This Console Tree node is where you can classify your Notes databases. Classification is based on a set of rules
which appear as nodes under the Classification Rules node. There are two types of classification, Technical and
Business. Both types are organized as a set of prioritized classes.
Dell Migrator for Notes to SharePoint 6.6
User Guide
68
Each class includes a set of Rules that must match for a particular database in order for that database to be
recognized as a member of the class. Each rule may specify that class members should be recognized by folder
path, file name, template name, database title, database category, a database manager being listed in the
database ACL, any user being listed in the ACL, a design element being used, or membership in a particular
application type. A rule can contain one or more matching values and regular expressions may optionally be
used. If a class contains more than one rule, the user may specify an AND or OR relationship.
The actual classification process occurs as soon as databases are discovered, when database information is
retrieved from the Repository, or when the user refreshes a database view. If you have updated or created new
classification rules, refreshing the database view will update the classes of all the databases using the current
classification rules.
Rules are prioritized (applied in a predefined order); the first one that matches is used and subsequent rules are
not tested. Technical classification and Business classification are computed independently.
Assigned classes are viewable in database views and the database property sheet. If the user manually overrides
a database class, this choice is considered "locked" and should not be updated by the automatic classification
process if the Locked check box is selected.
The console contains a set of predefined Technical classification rules reflecting well-known database types in
typical customer environments. These may be changed or extended. You can also choose at any time to restore
the defaults.
Once classes have been assigned to databases, this may be used as the basis for automatically assigning Triage
decisions (such as the Complexity index of a database or whether the database should be migrated), effort
estimates, target SharePoint destinations, and even the actual content migration jobs that need to be run.
Note that while classes are assigned (or reassigned) every time you refresh your database views, the automatic
Triage, Target Assignment and Migration Job Assignment only occur when the Apply Class Rules action is run by
the user.
Under the Notes Database tree node are by class tree nodes. These nodes display the pre-defined classes and
the databases that are members of each class. The By Technical Class tree node contains all of the defined
technical classes. The By Business Class tree node contains all of the defined business classes. Select a class to
see a list of the member databases in the results view.
NOTE: While all database replicas can be assigned to a class, the "by class" views found under the Notes
Database tree node only show the preferred replica. The preferred replica is determined by the order of
your Preferred Notes Servers as defined in the Discovery tab of the Global Options
Classification Actions
Table 37. Classification Actions
Property
Description
The actions listed under the Technical/Business Classification Rules header are
actions that are performed on all of the classes in the Results View.
The actions listed under the class rule name header are actions that are performed
on the selected classes in the Results View. The header name will change according
to which classes is selected in the Results View.
New Class
This action creates a new class. For detailed instructions, see Creating a New Class on page 71.
Export Classes
This action exports the classes to an XML file.
69
Import Classes
This action imports classes from an XML file.
To restores the default classification rules, delete all the classification rules then reimport from the
DefaultTechnicalClasses.xml file that can be found in the All Users data directory.
Export List
Exports the result set in the center pane to either a tab delimited (.txt) file or a comma delimited (.cvs) file.
Assign Properties
This action allows you to quickly set some of the more common properties for the databases that are classified
under the selected classification rules.
Table 38. Assign Properties
Property
Description
Target Site
This allows you to define the Target Site in Migration Targets Tab tab of the
selected databases properties
Enable or disable the Map Notes Users to Domain Users option of the
Migration Targets Tab tab of the classified databases for the highlighted
classes. If enabled, this will cause any Notes users listed in the source
database's Access Control List to be added to the target SharePoint list or
library. The Notes user names are mapped to Site Collection identities based
on the rules configured in the tool's User Mapping options and those Users are
granted access to the target SharePoint site
Enable or disable the Map Notes Groups to Domain Groups option of the
Migration Targets Tab tab of the classified databases for the highlighted
classes. If enabled, this will cause any Notes groups listed in the source
database's Access Control List to be added to the target SharePoint site. The
Notes group names are added to the Site Collection as external groups and are
granted access to the target SharePoint list or library. Each group name must
correspond to an actual Domain group.
Migration Jobs
This allows you to set various properties in the classified databases Migration
Jobs Tab for the highlighted classes.
70
Prioritizing a Class
When the classification process is being run, the first class in the list whose rules match for a database will be
assigned to that database. Subsequent classes will not be tested once a match is made. To re prioritize a class,
select the class in the center pane and select Move Up from the Action View or context menu to move the class
up the list of classes. Select Move Down from the Action View or context menu to move the class down the list.
Select the classification node for which you want your class to be for: either Technical or Business.
Select New Class from the Action Pane. This will create a new class in the center results pane.
Select the new class and in the context menu or Action Pane, select Properties. This opens the Class
Properties dialog box. The Class Properties dialog box is where you define the class. For more
information, see Classification Rule Properties on page 72.
Select OK to save the changes. Select Cancel to close the dialog box without saving changes.
Editing a Class
To edit a class
1
Select the classification node that contains the class to be edited: either Technical or Business.
Select Edit from the Action Pane. This opens the Class Properties dialog box.
Edit the class definition in the Class Properties dialog box. For more information, see Classification Rule
Properties on page 72.
Select OK to save the changes. Select Cancel to close the dialog box without saving changes.
Deleting a Class
To delete a class
1
Select the classification node that contains the class to be deleted: either Technical or Business.
71
General Tab
Table 39. General Tab
Property
Description
Class Name
Name of class
Description
Description of class
Type
The Type property ensures that a database assigned to this Class has the same type of reference
database. It can be set to QuickPlace, Quickr, or Domino.Doc. The default is blank. Assigning
the class a Type allows Migrator for Notes to SharePoint to do the following:
When you assign a reference database and analyze it in the Class Template Tab of the
Class Properties, it will be analyzed as that type of database.
When you create or edit migration jobs from the Migration Jobs Tab of the Class
Properties, it will assign the reference database with the proper type.
The Type property does not impact how classification works or how rules are applied to
individual databases.
Rules Tab
This tab has the rules that are used when classifying a database. If a database meets the rules defined in this
tab, it will be automatically classified as the given class.
Rules are prioritized (applied in a predefined order); the first one that matches is used and subsequent rules are
not tested. To move a rule higher in the order, select the rule in the list and click the Move Up button. To move
a rule lower in the order, select the rule and click Move Down.
To create a rule, click the Add button on the right. To edit an existing rule, select the rule from the list and
click Edit. To delete a rule, select the rule from the list and click Delete.
You can define as many rules as needed. Select the Match only if All above conditions are met radio button to
create an And condition or select the Match if ANY above conditions are met radio button to create an Or
condition for your rules.
Clicking Add or Edit opens the Database Classification Rule dialog box.
72
Using the Recognize By radio buttons, select the method for identifying databases. The Last Used radio button
allows you to identify databases whose last used date falls within a specified date range.
Select the Use Regular Expressions check box if your rule uses regular expressions for identifying the strings.
Some examples of regular expressions:
^abc - starts with the string "abc"
abc$ - ends with the string "abc"
^abc$ - matches the string "abc" exactly
abc - contains the string "abc"
^ab.*cd$ - starts with "ab" and ends with "cd", with anything in between
^ab...cd$ - starts with "ab" and ends with "cd", with 3 characters in between
For more information on regular expression, see http://www.regular-expressions.info/quickstart.html.
Description
Reference database
The design of each database associated with this class is compared with the
designs of the Reference database. To select a Reference database click
Select.
Automatically assign as
reference database for each
class member
If checked, the reference database will be included in the "Best Fit" "design
matching which recognizes the applications that are based on similar designs,
regardless of whether or not they are currently inherited from the same
application template. For more information on this matching process, see
Analyze Databases on page 42.
73
The design information on the Class Template tab is part of the reference databases properties sheet. It is
visible here for ease of use. This same data is accessible from the databases Design Analysis Tab tab.
Description
Automatically set
Database Owner
Automatically set
Business Owner
Automatically set Analysis Indicates that if a database is assigned this class, it will automatically be assigned
Priority
the given analysis priority number. To automatically assign analysis priority, select
the check box and enter the priority number in the field to the right and select the
user responsible for the analysis in the Assign to dropdown list box.
Automatically set
Migration Priority
Automatically assign
Design Complexity
Automatically set
Disposition
Indicates that if a database is assigned this class, its disposition will automatically
be set to the disposition that is selected in the disposition dropdown list box. To
automatically assign disposition, select the check box and select the desired
disposition from the dropdown list box to the right. The disposition indicates what
you want to do with the database in the migration process (for example, 'Migrate
to standard SharePoint targets' or 'End-of-life').
Description
If checked, the numbers entered below should not reflect the analysis,
development and testing effort that is expected for the original database
template (the reference database on the Class Template Tab).
Analysis work
Development of new migration jobs Enter a number that represents the development and content migration
effort.
Dell Migrator for Notes to SharePoint 6.6
User Guide
74
Description
Totals
Estimated total
Description
If checked, select the Option button to the right in order to define the site
creation options.
If checked, select the Options button to the right in order to define the
subsite creation options. Note that this only applies to databases that have
been identified as part of an application hierarchy using the Discover
QuickPlace/Quickr Organization or Discover Domino.Doc Organization
processes.
Check this if you would like to recreate the QuickPlace/Quickr room menu in
the SharePoint QuickLaunch during migration. You can choose to append to
the existing QuickLaunch menu at the top or bottom of the menu or to
completely replace the menu. The Replace list option will delete the current
QuickLaunch menu and replace it with the QuickPlace/Quickr room menu
being migrated. The At the top of the list and At the bottom of the list
options will delete and then add the links that contain the same names as
those in the migration. This will prevent duplicate menu items.
NOTE: While QuickPlace/Quickr rooms can have several levels of menu items in the navigation hierarchy,
SharePoint can only have two levels. During provisioning of the navigation hierarchy, all levels that are
lower than the second level will be flattened to the second level in SharePoint.
75
Description
Parent Site
Relative Url
Relative Url for new site/subsite. You can use the variables listed at the bottom of the dialog
box to create a dynamic url. For example, if you use {7} in this field it will be substituted
with the actual Application Name for each database you are assigning targets to. For more
information, see Variable Substitution Rules on page 76.
The name of the new site will be displayed in this field taking into account the variables used
in the Relative Url field.
Title
Title of the new site. You can use the variables listed at the bottom of the dialog box to
create a title. For example, if you use {0} in this field it will be substituted with the actual
Database Title for each database you are assigning targets to. For more information, see
Variable Substitution Rules on page 76
Site Description Description of the new site.You can use the variables listed at the bottom of the dialog box to
create a description. For example, if you use {4} in this field it will be substituted with the
actual Technical Class for each database you are assigning targets to. For more information,
see Variable Substitution Rules on page 76.
Site Template
Inherit Parent
Toolbar
If checked the new site will have the same toolbar as the parent site.
Inherit Parent
Permissions
If checked the new site will have the same permissions as the parent site.
Additional
Administrators
This button opens the Additional Administrators dialog box. Add users that you want defined
as Administrators of the new SharePoint site. If none are added, only the user who runs the
migration job will be defined as an administrator.
At the bottom of the dialog box is a list of variables that can be used in any of the above text
boxes. These are valid substitutions that will be used during site creation to dynamically
create urls and site names.
The following illegal whitespace characters are converted to normal spaces: Tab VTab Return Newline
76
Description
If this is checked, assign which migration jobs will be used and any
permissions
Allows you to add the migration jobs that you want each database of this
class to use. The migration jobs that are defined for this class appear in
the Content Migration Jobs list. To create a new job for this class, click
New. To import an existing job definition, click Import. To edit an
existing job, select the job from the list and click Edit. To delete an
existing job, select a job from the list and click Delete. To export the job
definition in order to re-use it for other classification rules or database
migrations, select the job from the list and click Export. This will export
the job to a pmjob file.
Updating a target
To update the target list name for a migration job, select the job from the list and click Target. The Select a
target list dialog box will appear. When entering the target list, variable substitution can be used, as shown by
the helper box in the dialog box. For more information, see Variable Substitution Rules on page 76.
Click Select... to launch the Migrator for Notes to SharePoint's SharePoint List browser and select the desired
List. The Select... button is only enabled if in the Auto Target tab, Enable Automatic Target Identification is
checked, the base site URL is not empty, and the two Create new... check boxes are not checked. If the
Select... button is disabled, you can still type in a list name.
For detailed information on defining a migration job using the Job Designer, see Migrator for Notes to SharePoint
Designer on page 91.
Content Types
This tab allows you to define and provision SharePoint Content Types for a SharePoint Site.
You can add Content Type definitions to be provisioned in many ways.
Import: Allows you to add a Content Type definition from a previously exported Content Type definition
file.
From Notes Form: Create a Content Type definition based on a Notes Form.
From Migration Jobs: Allows you to take the fields in the target data definition of a migration job and
use them in a Content Type definition.
From Existing List: Allows you to take a SharePoint List and turn it into a Content Type definition.
From Existing Content Types: Create a Content Type definition based on an existing Content Type.
Dell Migrator for Notes to SharePoint 6.6
User Guide
77
To edit a Content Type definition, select it in the list and click Edit.
To delete a Content Type definition, select it in the list and click Delete.
To provision the list of Content Types shown in the tab, click Provision.
NOTE: If a Content Type in the list already exists in the target site, the existing Content Type definition
will be updated. Any new columns will be added but columns that are in the existing Content Type that
are not part of the Migrator for Notes to SharePoint definition will not be removed. They will be left as is.
Description
Name
Description
Enter the Group that this Content Type should be associated with. Use
the Select button to choose from the Content Type Groups already
defined in the target site. If the Content Type Group you enter does not
exist in the target site during provisioning, the Content Type Group will
be created in the site.
Enter the Parent Content Type for this Content Type. Use the Select
button to choose from the Parent Content Types already defined in the
target site. The Parent Content Type you enter must already exist in the
target site during provisioning.
Associated Forms
Current Status
78
SharePoint Targets
The SharePoint Targets node allows you to navigate all available SharePoint sites and view any existing Lists and
Libraries. The sites that you see here depend on your SharePoint configuration (see SharePoint on page 25).
An addition to displaying your existing sites and content, Migrator for Notes to SharePoint will also indicate any
planned future sites and content that you have entered into the tool. The planned sites are displayed with a
green plus icon.
Based on the Migration Plan you set up, a preview of the planned SharePoint sites is displayed under the
SharePoint Targets node. These planned sites may have been manually added using the Add Sub-Site action (see
Add Sub-Site Action on page 79), may have been added while specifying the Migration Targets Tab for a
particular database, or may have been assigned automatically based on database classes (see Auto Target Tab
on page 75).
Both planned and existing sites and subsites are displayed. The sites that are planned and do not actually exist
are displayed with a green plus sign icon. Each planned site has a detailed set of Plan a new SharePoint subsite
that may be edited by selecting the Properties action.
Go To Site Action
This action will launch the selected SharePoint Site.
79
Description
Parent Site
Relative Url
Title
Site Description:
Site Template:
If checked, the new site will have the same top link bar as the parent site
Inherit Parent
Permissions
If checked, the new site will have the same permissions as the parent site
Add to QuickLaunch
If checked, the parent's "Sites" QuickLaunch group will have a link to the newly
provisioned site added.
If checked, the new site will have a the TreeView control enabled in the left side
navigation pane.
NOTE: This option can be enabled/disabled manually in SharePoint after a site is
created by altering the Site Actions > Site Settings > Tree View setting.
Additional Administrators This button opens the Additional Administrators dialog box. Add users that you
want defined as Administrators of the new SharePoint site. If none are added,
only the user who runs the migration job will be defined as an administrator.
Assign Properties
Analyze Databases
Migrate to SharePoint
Dell Migrator for Notes to SharePoint 6.6
User Guide
80
Reports
All reports are found under the Reports node. Each report is represented by a tree node. A number of standard
reports are provided that summarize or detail the data collected by the user. The standard reports are found
directly under the Reports node. They cannot be edited or customized within the console.
NOTE: The current version of Migrator for Notes to SharePoint includes only a limited set of standard
reports and charts. Additional reports may be downloaded separately from the Dell web site and from
http://notes2sharepoint.org.
Microsoft Report Viewer 2012 is used by the console for viewing all reports. If this component is not installed,
the reporting functionality will be not enabled. Report Viewer 2012 may be downloaded from the following
location: http://www.microsoft.com/en-us/download/confirmation.aspx?id=35747.
To view a report, select the corresponding report node. The resulting report can be viewed in the Results View.
From the Results View, you can navigate through the pages of the report, print the report or export the report
using the report toolbar on the top of the Results View.
81
Report Definition metadata (.XML) - provides the title, description and data filtering criteria. This is
saved as an XML file in the Standard Reports or Custom Reports folder and is essentially what is
represented by the report tree nodes. Each XML file contains a reference to an RDLC file (see below).
Report Definition file (.RDLC) - supplies the visual formatting, layout of the report and data fields to
render. These are created using a third party RDLC editor. By convention the RDLC will have the same file
name (except for the extension) as the XML file.This is saved in the Standard Reports or Custom Reports
folder.
82
Database By Manager
Databases By Template
DbReportTable - Defines all the reporting fields associated with a database record
DbDesignElementReportTable - Joins DbReportTable with Design scan information about Design Elements
83
The RDLC report files contain the dataset schema needed to design reports. There is no external XSD schema
file provided containing this information. When using the Create New Custom Report feature described below, a
starter RDLC is created containing the dataset schema ready for designing the report in a suitable 3rd party tool
such as Visual Studio Professional.
Custom Reports
In addition to the standard reports that are provided, users can design their own.
All custom reports appear under the Custom Reports scope node under the Reports node. The Custom Reports
node has actions to add, edit or delete Reports.
Select Create new custom report from the Actions pane or context menu.
The Report Definition dialog box will appear.
Description
Report Title
Description
RDLC Template
The report definition file the custom report will be based on. Click the Browse button to
search on all available templates. You can use an existing template from any place on the
network. The default location is the Standard Report folder since this is where the Migrator
for Notes to SharePoint standard report templates are located.
Edit
Click the Edit button to launch the currently installed report editor to design the report. If
the template that you have chosen is sufficient, there is no need to use the Edit button
NOTE: Microsoft's Visual Studio Report Designer is currently the only report designer
supported as the RDLC editor. The Express versions are not supported however. For more
information about this report designer and how to build reports using it, refer to
http://msdn.microsoft.com/en-us/library/ms157166.aspx.
If you do not have a supported report designer installed, clicking Edit will generate an
error message indicating this.
For detailed information on the available reporting dataset columns that you can use in
your custom reports, see Migrator for Notes to SharePoint Reporting Data Tables on page
144.
NOTE: If you want to modify a standard template that is delivered with Migrator for Notes
to SharePoint but for just one particular report, you will need to create a copy of the RDLC
file and have the one report refer to that copy. Use the Copy Report function to do this.
This copy can then be edited in the Report Designer. By changing one of the standard
templates, you will be changing all the reports that use that template.
Database Scope
The database scope node that the custom report will be based on. The custom report will
be a filter of this scope nodes result set
Filters
Select one or more check boxes for the data types you want to filter the result set on. The
data type button on the right of the check box will activate. Select the button to specify
the filter. Check one or more of the check boxes that correlate to the data you want
displayed in your report. You can deselect a check box by selecting it again
84
Copies the report definitions referenced RDLC file and places the uniquely named copy in the Custom
Reports folder. The new custom report definition (the XML file) will refer to the new RDLC file in the
Custom Reports folder.
Copies the selected report definitions XML file and places the uniquely named XML file in the Custom
Reports folder. The RDLC reference in the XML file is updated to point to the newly created RDLC file.
Other view properties such as column selection, column ordering and sorting are defined using the View menu
item of the Actions pane. Select the submenu item Add/Remove Columns to change the reports column
selection as well as to reorder the columns. The Sort By menu items allow you to change the field that the
report is sorted on.
Another way to add a new custom report to the Console is to simply add the reports RDLC and XML files to the
Custom Reports folder. The next time the Console restarts or refreshes, the new report nodes will appear under
the Custom Reports node.
To share a report, you can copy the .XML and .RDLC files from your Custom Reports folder to another users
Custom Reports folder.
With new releases of the Migrator for Notes to SharePoint Console, additional reporting fields and tables may be
provided, or existing ones renamed. Older custom reports may need to be updated in order to be compatible
with the newer dataset schema.
To support this, the Update Report Definition action is available when a custom report is selected. This action
will create a time-stamped backup of the current report RDLC file prior to performing the required upgrade of
the reports dataset definitions. Once the report is updated, new tables and data columns are available for
customizing the report.
The Update Report Definition action is only available for reports within the Custom Reports folder and is
usually only necessary in the following cases:
A previously working custom report generates an error after upgrading to a newer version of Migrator for
Notes to SharePoint.
New Data tables or columns needed for a particular report are not shown when modifying a report in the
third party report designer.
Task History
All long running tasks are managed using a common task management facility found in the Task History node.
When a process is run in the Console, Task Records are created and either dispatched to worker threads that
perform the actual work or added to a task management queue, in which case they are performed serially in a
predetermined order.
When the Task History node is selected, the Results View of the console shows a list of all tasks (pending +
running + recently completed). This view is automatically updated in real time.
The view displays the following information for each task listed:
Status Icon
Dell Migrator for Notes to SharePoint 6.6
User Guide
85
Task Name
Type of Task
Status
Summary
Start Time
Stop Time
Each task record and its details are viewable in the task property sheet. If a running task is being viewed in a
property sheet, the information on the property sheet updates as the task status changes.
Certain tasks such as migration jobs, will generate a log file. The log files are saved as part of the Task Record
in the Repository. When a log file becomes available, additional tabs are displayed in the task property sheet.
These tabs are the summary and detailed versions of the log file similar to the Migrator for Notes to SharePoint
Designer log viewer. For more information, see Migration Job Logging on page 124. Log files can be exported to
the file system by selecting the Export Log task action once the task is selected in the results view.
Additionally, the Task Records that relate to a particular database should be displayed in that database's
Migration History tab of the database property sheet.
Any tasks that are tied together to run sequentially, like running multiple migration jobs for a single database,
are displayed as separate tasks with a wrapper task, for example "Content Migration Sequence".
One or more tasks can be purged from the Repository by selecting the tasks in the results view and the selecting
the Delete action from the Action view.
Importing Tasks
For migration jobs that have been run using Migrator for Notes to SharePoint Designer or the Migrator for Notes
to SharePoint Command Line, the logs can be imported into Task History. This allows the jobs to be visible in the
databases migration history.
You can select one or more log files to import. A record in the Task History view will be created to log the
results of the import.
Only migration logs generated by Migrator for Notes to SharePoint or Migrator for Notes to SharePointCmd will
be imported. Any other log files (including those that may have been exported from the Task History view in the
Console) will be ignored. Log files that have already been imported into the Console, we will ignored as well.
The import will attempt to match up the Notes database that was used for the migration with the database
reference being held in the Repository. If the database reference is found, the Task History record will be
associated with the database, and will show up in the Migration History tab in that database's properties.
86
Link Analyzer/Updater/Finalizer
The Tools node contains the Link Analyzer/Updater/Finalizer child node which allows you to manage your Link
Tracking database.
The Link Tracking Service (LTS) component ensures that Notes DocLinks continue to work before, during and
after the migration process, regardless of the order of document migration. The service maintains a record of
every document that is ever migrated and guarantees that users clicking on an intra-document link will always
be able to find the current location of the document. Users can view a Link Tracking information page first, or
simply be redirected to the desired page in Notes or SharePoint.
As each document is migrated to SharePoint, its new location is tracked in a SQL Server database called the LTS
database. This database is created when you first install Migrator for Notes to SharePoint Services.
When migrating Notes rich text fields that contain DocLinks to other Notes documents, these DocLinks are
converted to URL links to a Link Tracking service that knows how to resolve them. If a SharePoint user clicks on
a link to a document that has not been migrated yet, they will be redirected to the appropriate document in the
Notes client. If the user clicks on that same link after the document is migrated, they will be redirected to the
new copy of the document in SharePoint (which might be a list item, a document library file, or even an
InfoPath form).
NOTE: If you do not want to connect your production SharePoint environment to our Link Tracking
database, you can use the client side Link Tracking where Link Tracking is performed by the Migrator for
Notes to SharePoint Console or Designer rather than by the Migrator for Notes to SharePoint Service. You
will need to configure Link Tracking using the Link Tracking tab of the Global Options dialog box of the
Migrator for Notes to SharePoint client.
Documents can be added to the Link Tracking Service whether the migration is accomplished through the Import
Service or by using Migrator for Notes to SharePoint products in local mode (running the tool directly on the
SharePoint server).
If, after your migrations, you move your SharePoint site to another server or location, you can update the links
in the LTS database using the Link Tracking Finalizer/Updater. If you have relocated the LTS redirector page, the
Link Tracking Finalizer/Updater can also update all documents that have links to the LTS redirector page in
order to look for that page in the new location. If you would like to remove the Link Tracking Service completely
after the migration is done, the Link Tracking Finalizer/Updater can finalize the links to allow for its removal
The Link Tracking database can be configured and managed on the SharePoint server as a Migrator for Notes to
SharePoint Service or in the client using this node of the Console. From this node, you can configure Migrator for
Notes to SharePoint to use the client rather than the server to manage the Link Tracking database.
NOTE: To configure Migrator for Notes to SharePoint to use the SharePoint server for Link Tracking
management, see the Configuring the Link Tracking Service section of the Migrator for Notes to
SharePoint Installation Guide. If the SharePoint server is used, it will need the ability to connect and
update the Migrator for Notes to SharePoint Link Tracking database.
Overview Tab
From the Overview tab, the status of the client managed Link Tracking is indicated. If the client managed Link
Tracking has not been turned on, it will be indicated. To configure client managed Link Tracking, click the
Change Settings link. This will open the Link Tracking tab of the Advanced Configuration Options dialog box.
From this dialog box, you can enable client side link tracking as well as configure it.
The Link Tracking Database Settings section shows the Server, Database and Authentication method currently
in effect.
There are two links:
Change Settings -> This opens the Link Tracking tab of the Advanced Options dialog box where the
settings for Client Side Link Tracking and Finalization features can be configured.
Test Connection -> This Link is enabled once the Link Tracking database settings are filled out. Click this
link to test the connection.
87
The Lower section of this tab is for describing and accessing the Link Tracking Update and Finalization features.
Access to these features is enabled once the Link Tracking database is successfully configured and you have
turned on the Enable Link Updater / Finalizer operations directly from the Migration Console option on the
Link Tracking tab of the Advanced Options dialog box.
Once enabled, click on the Analyze, Update or Finalize links to access the following tabs:
Analyze Tab
Log Tab
Analyze Tab
The Analyze process inspects some or all of the SharePoint documents referenced in the Link Tracking Database
and reports their status.
This tool allows you to select the set of documents that you want to analyze.
Table 49. Analyze Tab
Property
Description
Select this radio button to analyze all migrated documents in the Link Tracking
Database.
Select this radio button to analyze the documents in a particular site collection.
Once you have made your selection, click Analyze. The analysis job will run. The status of the job will be
indicated at the bottom of the tab. The results can be viewed from the Analyzer Results tab.
NOTE: Data can be copied out of the Analyzer Results tab by selecting a Cell, Row or the whole table
(upper Left box in the grid) and using Ctrl-C. It can be pasted into a file or into Excel for analysis.
Description
Enter the URL prefix of the documents as they currently appear in the Link Tracking
database.
Enter the new URL prefix that you want to be the replacement for the above URL
prefix.
88
Description
Update locations of
referring documents
Select this check box to update the table of referring documents (documents that
contain links to other documents) in addition to updating the locations of your
documents. You should only choose this option if the documents at the NEW location
will be reachable by the Link Tracking Finalizer tool. In particular, if you are preparing
to finalize a set of documents before moving them, you should NOT select this option.
If you do, the Finalizer tool will not be able to find them.
Preview
Click this button to preview the current references to documents as stored in the Link
Tracking database and the proposed new references to the documents. When the
Preview button is pressed, he Progress area at the bottom of the form will become
visible if it is not already. The Update Preview tab will appear with the proposed
changes. Note that once the Update Preview tab appears, it will continue to be
available with the last results. These results are not saved.
NOTE: Data can be copied out of the Update Preview tab by selecting a Cell, Row or
the whole table (upper Left box in the grid) and using Ctrl-C. It can be pasted into a
file or into Excel for analysis.
Update
Click this button when you are ready to make the changes in the Link Tracking
database. If you have lots of documents to update, you will see a status page that
updates every few seconds and then a final results page.
Description
Select this radio button to update all migrated documents in the Link Tracking
Database.
Select this radio button to migrate the documents in a particular site collection.
89
Description
Select this check box to modify the links. To leave the Dynamic Links as they
currently are, do not select this check box. If this check box is selected, you have
the following choices:
Finalize Dynamic Links with Direct Links: Click this radio button to
replace the Dynamic Links with direct links that point to the last known
locations of the migrated target documents (that is, their new URLs in
SharePoint)
CAUTION: You should only perform this operation when you are sure that the
documents your links are pointing to are indeed "final" and that they are not
still moving around. If you have moved (or plan to move) these documents or
otherwise change their external addresses, be sure to run the "Update links
in the Link Tracking Database" tool before you finalize your links. This is a
permanent change that cannot be reversed using this tool.
Replace Dynamic Links with this Alternate URL: Click this radio button
to change the Dynamic Link to reference a different Redirector Page or to
a static URL. Be sure to use the {0} notation to encode the unique
identifier of the target document in the link.
Select this check box to modify the links. To leave the Dynamic Links as they
currently are, do not select this check box. This is the recommended option. If
this check box is selected, you have the following choices:
Replace Dynamic Links with this Alternate Url: Click this radio button to
change the Dynamic Link to reference a different Redirector Page or to a
static URL. Be sure to use the {0} notation to encode the unique identifier
of the target document in the link.
Finalize Dynamic Links with Direct Links: Click this radio button to
change these Dynamic Links to Direct Links that point to the original
locations of target documents in Notes/Domino.
You can preview the proposed changes of the operation by clicking this button.
Finalize
Click this button to make the desired changes. The Log tab will display the
results.
Log Tab
This tab displays the results from running the Link Finalization tool.
The Session dropdown allows you to choose the results of a particular finalization run.
NOTE: When viewing an old 5.2/5.3 database, this list may not contain specific results sets.
Table 52. Log Tab
Property
Description
When combined, allows you to locate specific text within the results.
Reduces the current result set to only those items that have error information
present.
90
3
Migrator for Notes to SharePoint
Designer
Introduction
Introduction
The Migrator for Notes to SharePoint Designer allows you to manage complete Job Definitions, set tool options,
and execute migration jobs.
NOTE: Certain functions will be disabled if you are running on a computer that does not have Notes
installed or if you did not select the Notes Support option during installation. See the Installation
Requirements section of the Migrator for Notes to SharePoint Installation Guide for more details.
91
Description
Notes/ QuickPlace/Quickr The data source tab is where you select the Lotus Notes databases,
QuickPlace sites, Quickr sites, or Domino.Doc libraries you want to migrate
Domino.Doc Data Source
data from. It is also where you select (or create) Data Source Definition files
that describe the details of how data should be selected from these data
sources and how it should be converted. A different set of options will appear
depending on whether you are running Migrator for Notes to SharePoint in
Notes, QuickPlace, Quickr, or Domino.Doc mode. To change modes, select the
desired mode from the Type dropdown in the upper right hand corner of the
tab. For more information, see Selecting Data Sources on page 93.
SharePoint Data Target
The "SharePoint" tab is where you select the SharePoint List that will be used as
the destination of data to be migrated. It is also where you select (or create) a
Data Target Definition file that describes how data should be written to this
list.
This is where you select the target SQL Server database and tables that will be
the destination of migrated data. It is also where you select (or create) a Data
Target Definition file that describes how data should be written to this
database.
NOTE: This data target becomes available when you select Enable migration
directly to SQL Server tables check box in the SQL Server tab from Migrator for
Notes to SharePoint Options dialog box. For more information, see SQL Server
on page 28.
The Folder tab allows you to migrate the data to a target folder. The following
document types are supported for migration:
Map Data
The "Map Data" tab is where you describe how the Notes fields in your Data
Source Definition map to the SharePoint fields in your Data Target Definition. In
most cases, the "Auto Map" function will do the mappings for you, but you can
also override the defaults. Other general options that affect the migration
process are available on this tab
The "Advanced" tab contains additional settings for controlling user mapping,
security mapping and DocLink conversion functions
Mapping Data
Click Open.
Dell Migrator for Notes to SharePoint 6.6
User Guide
92
Select a Connection String. Select the database that will be used as the source of data. You can do this
by:
using drag-and-drop. Select a Notes database (NSF file) in Windows Explorer and drag it onto the
Migrator for Notes to SharePoint user interface.
using Migrator for Notes to SharePoint's Notes database browser. Click Select and select the
desired local or server database.
To be sure this is the database to which you want to connect, click Go To Database to open the database
that you have selected. If you wish to type in this connection string directly, refer to the Notes
Connection String Reference on page 125 for details. If you have typed in your own connection string or
have loaded it from an existing Job Definition, you may need to click the Test button to force this
connection to occur.
A title for the Notes database or Quickr/QuickPlace/Domino server (depending on the type selected) is
automatically entered.
The Template used field is automatically entered. It shows the name of the Notes design template that
was originally used as the basis for creating that particular Notes application. This is a key piece of
information that Migrator for Notes to SharePoint uses to recognize what type of Notes application it is.
For example if the Template used is "StdR6WebDocLib", the Migrator for Notes to SharePoint knows it is a
standard Notes version 6 Document Library and can deduce the forms, views, items available.
3
Create a source data definition. For more information, see Creating/Editing Source Data Definitions on
page 93.
Max Records - allows you to limit the number of Notes records to be migrated to a predetermined
number. If you are running Migrator for Notes to SharePoint with a trial license, your migrations
will be automatically limited to 10 records
Skip - allows you to skip a number of Notes records before starting migration. When used in
conjunction with the "Max Records" option, you can migrate data in distinct chunks.
Delete Source Documents when migrated - causes Notes documents to be deleted upon successful
migration of that document. This option is primarily useful in scenarios where you want
documents to be migrated as they are added to the database (for example a mail-in database).
This option may be disabled depending on how your tool Options are set.
This option may cause data loss. Be sure that your Job Definition extracts all the data you will
ever want out of the Notes documents.
This option is only available when you select a Notes from the Type dropdown.
93
From the Definition tab, enter the Name and Description of the Source Data Definition.
If you want to permanently associate this Source Data Definition with one or more templates, you can
enter them in the Templates supported field.
If you want to associate this Source Data Definition with corresponding SharePoint List Types, you can
enter them in the Maps to list types field.
If you want to convert Windows MetaFile images to JPEG, GIF, PNG and BMP, select the Windows MetaFile
check box, then select a format.
IMPORTANT: Converting Windows MetaFile images can cause loss of original images quality and
content.
Type
Then go to
Notes
QuickPlace or Quickr
Domino.doc
Step 7
From the Record Selection tab, select records based on one or more of the following:
View/Folder index
Form Used - This will give you an implicit Fornix selection formula which will be combined with
the explicit selection formula (if any) at migration time. The syntax allows for the selection of
both multiple forms and form aliases. Multiple forms are delimited by a ";" and form aliases are
delimited by a "|". While this works with any two form names, the main purpose is to support
form aliases where a form in Notes may have aliases.
Rich Text Content - Use this to implement one or more of the following policies for document
libraries:
For documents that contain just one attachment (and no other rich text), migrate the
attachment directly to the SharePoint document library with all the appropriate security
and metadata.
"For documents that contain Notes rich text, generate a Word or PDF document and place
it in the same SharePoint document library with all the appropriate security and
metadata.
"For documents containing neither attachments nor rich text, either skip the document or
create a stub entry in the target library.
Selecting the Select documents based on Rich Text Content check box enables a Details
button where you can specify further details.
You must specify one or more rich text items you would like to inspect, then specify the
criteria you would like to use for filtering documents:
Whitespace only
94
The Documents Selection tab allows you to specify which data records should be read from QuickPlace or
Quickr.
NOTE: The Document Selection tab appears only if you use QuickPlace, Quickr, or Domino.Doc.
Content Pages These are the primary types of pages created when users type content into the
QuickPlace user interface. These pages can contain rich text bodies and multiple attachments.
Imported Pages These are pages are created when users import Word files or HTML files. These
pages typically contain the imported file itself, plus an HTML rendering of the file generated by
QuickPlace or Quickr.
Link Pages These pages are simple links to other pages (internal to the QuickPlace or Quickr).
Calendar entries These pages contain fields for scheduling events and contain special fields for
organizing attendees, repeating meetings.
Task entries These pages contain fields for managing to-do items and contain special fields for
organizing due dates and assignees.
Members These pages contain information about the team members who typically use the
QuickPlace.
Orphans These are all the other pages that are not members of any specific view or folder in the
QuickPlace or Quickr (except for the Index). In practice, these pages are often out-of-date or
otherwise not useful (as evidenced by the fact that there is not direct navigation to them) and
they can be omitted in many migration scenarios.
The Publishing section of this tab allows you to control which documents are selected for migration in
terms of the QuickPlace/Quickr concepts of "published/unpublished" versions. The default is to migrate
only published documents. You can choose to migrate only unpublished documents by selecting the
unpublished documents radio button or both types of documents by selecting the all documents
radio button.
IMPORTANT: Some options will select more than one version of a given document for migration. In
this case, the different versions are considered to be the same document and will trigger Migrator
for Notes to SharePoint's Duplicate Document Handling options. In particular, if Create New
Versions is selected, then we are migrating version histories (for example, three versions in
QuickPlace / Quickr should map to three versions in SharePoint).
NOTE: We can not control version numbers in SharePoint so the version numbers are not
guaranteed to match.
For advanced jobs, you can also select documents by Folder, by Form used, or by using a dynamic Notes
formula.
NOTE: While it is possible to extract all the page types at once and migrate them to a single
SharePoint list or library, it is better to differentiate between them and migrate Discussion pages
to a SharePoint Discussion board, Calendar entries to a SharePoint Events list, and so on. This
involves running multiple jobs for each QuickPlace or Quickr (and for each sub room).
7
From the Document Selection tab, select which documents in the current Cabinet should be included in
the query. You can control which types of documents are selected for migration. The default is to
migrate only published documents. You can choose to migrate only unpublished documents by selecting
the unpublished documents radio button or both types of documents by selecting the all documents
radio button. Select the Binders only option to extract Binders instead of Documents. To migrate the
binders to SharePoint folders, select the Migrate mapped data to folders option on the Advanced Tab
of your Target Data Definition.
The Versioning section of this tab allows you to control which documents are selected for migration in
terms of the Domino.Doc and Quickr concepts of major/minor versions. The default is to migrate only
95
current versions. You can choose to migrate all the latest major versions by selecting the latest major
versions radio button or all the versions by selecting the all versions radio button.
CAUTION: Some of the versioning options will select more than 1 version of a given document
for migration. In this case, the different versions are considered to be the same document and
will trigger Migrator for Notes to SharePoint's Duplicate Document Handling options. In
particular, if All Versions is selected, then we are migrating version histories (for example,
three versions in Domino.Doc should map to three versions in SharePoint).
NOTE: We can not control version numbers in SharePoint so the version numbers are not
guaranteed to match.
You can select documents by Binder, by Document Type, or by using a dynamic Notes formula.
NOTE: While it is possible to extract all the page types at once and migrate them to a single
SharePoint list or library, it is better to differentiate between them and migrate Discussion pages
to a SharePoint Discussion board, Calendar entries to a SharePoint Events list, and so on. This
involves running multiple jobs for each Domino.Doc (and for each sub room).
To filter records based on their rich text content, use the Select documents based on Rich Text Content
check box. Use this to implement one or more of the following policies for document libraries:
For documents that contain just one attachment (and no other rich text), migrate the attachment
directly to the SharePoint document library with all the appropriate security and metadata.
For documents that contain Notes rich text, generate a Word or PDF document and place it in the
same SharePoint document library with all the appropriate security and metadata.
For documents containing neither attachments nor rich text, either skip the document or create a
stub entry in the target library.
Selecting the Select documents based on Rich Text Content check box enables a Details button where
you can specify further details.
Specify one or more rich text items you would like to inspect. Specify the criteria you would like to use
for filtering documents:
"Whitespace only
This record selection option allows you to create multiple migration jobs for each document library, each
one implementing one of the rules in the policy.
NOTE: The Migrator for Notes to SharePoint Migration Console makes it easy to sequence multiple
migration jobs for one database, and to automate these jobs for many databases of the same type.
8
Add Data Fields to specify the data columns you want to extract from each row selected. Click Add, and
select a column.
Table 55. Columns
Property
Description
Item
An item in a Notes document. You should specify the internal ItemName (which may be
different than the name you are used to seeing displayed in forms and views).
View
Column
A pre-computed column in a Notes view or folder. You can only select this type if you
specified a view or folder on the Record Selection tab. You can identify columns by
ColumnName or ColumnNumber.
96
Description
Formula
A dynamic value based on the Notes @Formula you specify. You should also specify the
Formula property (for example "@Uppercase(Subject)". A sample use case for this
column type is if you do not want to migrate large attachments from Notes to
SharePoint. To filter out the large attachments, use the following formula as your
selection criteria:
@Attachments = 0 | @AttachmentLengths < 100000
Using this formula, any document with 0 attachments, or any document with attachment
size less than 100,000 bytes will be migrated.
Parent
Item
An item in the current document's parent document. You should specify the internal
ItemName (which may be different than the name you are used to seeing displayed in
forms and views).
Parent
Formula
A dynamic value based on the Notes @Formula you specify. The formula will be
evaluated in the context of the current document's parent document.
RichText
Extract a rich text item value as plain text, HTML, or MIME (MHT) formatted data.
Render
Render each document with the named form and return a Rich Text value. Rendering
basically means taking a snapshot of the way a document is supposed to appear in the
Notes client, and putting the entire thing into a single rich text field. This includes all
the visual elements on the form, including form layout, field labels, graphics, and even
computed for display fields. This can be a nice alternative to migrating all the
individual data elements of a complex Notes application, especially in cases where you
just want to archive the content from old applications and do not want to invest effort
into migrating the applications functionality.
In most cases, set the Option to HTML for mapping to SharePoint. Specifying the
FormName to render with is optional. If you do not specify one, each document will be
rendered with its default form (using the FORM Item in each individual document).
Images, objects, and attachments from the form may be included in your migration job
by using the AttachmentScope property in those source data definition columns. To
accomplish this, the AttachmentScope property includes the choice: RenderWithForm.
If you choose this, you again can specify an optional FormName property. This should
match the FormName you specified with the Render columns.
NOTE: There are limitations with form rendering. As a general rule subforms, computed
subforms, hide-when formulas, and computed text all work fairly well. However, some
complex structures (for example hide-when formulas inside the subforms) will not
always resolve correctly. In some cases it may be necessary to develop a simplified form
to use while rendering documents. You can override the default form in the source data
definition columns.
NOTE: Render is not available if you have selected QuickPlace, Quickr, or Domino types.
97
Description
Attachment
Extract an attachment (or multiple attachments) from the named Rich Text item in each
document and/or document level attachments. In the ItemName field, enter the rich
text item you want to extract attachments from. If you leave the ItemName blank, then
all attachments in each document will be extracted. For further details, see the
AttachmentScope section.
The Compression option, Zip, gives you the ability to compress Notes file attachments
while migrating them to SharePoint. There are a number of good reasons for wanting to
do this:
Get around SharePoint file restrictions (that is, blocked file extensions and/or
size limits)
Eliminate problems (hangs and memory leaks) when embedding certain types of
file attachments inside Word documents
To configure a set of global exceptions to this rule, use the Compression Exclusions
option on the Notes tab of the tool's Options dialog. This option allows you to specify any
file extensions that should never be zipped. This would typically include media files that
are already well-compressed and would not benefit from zipping.
NOTE: Migrating file attachments inside of MS Word documents is not recommended for
large migration jobs. Since Word attachments are implemented as Packager OLE
objects, the migration process is forced to invoke Packager code and the OLE handlers
for the file type (often in separate processes). The problem is that each type of
attachment is handled differently depending on which type of application created the
attachment. So (for example) the first 1000 attachments may work fine and then
document 1001 has a different type of attachment that causes a memory leak when
Microsoft converts it into a Packager object. When migrating attachments and OLE
Objects to embedded objects in MS Word, it is highly recommended that the workstation
performing the migration has native applications installed that can open and edit every
type of attachment that the migration jobs will be encountering during the migration.
You can migrate attachments separately to the SharePoint document library. (The links
from the Word documents to the attachments will be preserved.) or place all
attachments inside ZIP files inside the Word documents.
Attachment
Links
This generates a list of links to the designated set of attachments as a small rich text
area. This gives you a way to navigate to attachments that you may not otherwise be
able to get to. For example, you could append a links section to the bottom of migrated
document so users could link to all the document level attachments that were not in the
main rich text area.
Image
Extract an image (or multiple images) from the named Rich Text item in each document.
Images stored as native Notes bitmaps will be converted to GIF or JPEG formats.
Ole
Object
Extract an embedded object (or multiple embedded objects) from the named Rich Text
item in each document. Whenever possible, objects will be converted to files that can
be subsequently opened by the applications that created them. (For example, an
embedded PowerPoint 2003 slide will be converted to a .PPT file.) Refer to the Release
Notes for details and limitations about this conversion process.
98
Description
Document
Convert the contents of the selected Notes document into an XML document (such as an
InfoPath form).
Additional
Properties
The subsequent properties you can specify will vary depending on the ColumnType you
choose. In most cases, you can specify an Alias for the field and a ReturnType.
You can override the name of any data column by specifying the Alias property.
NOTE: To create the most effective data definition, pay attention to the ReturnType
property of your fields. Notes databases can be difficult to build strict schemas for your
data. By telling Migrator for Notes to SharePoint that you always want to return a
specific data type (for example, String), you guarantee that all the rows in the results
will have a consistent structure.
In some cases, additional options may be available:
Mime - Return Rich Text items, including images and attachments, as a complete
multi-part MIME (MHT) document.
Xml - Return Rich Text items as XML (Lotus DXL format), including images and
attachments.
XmlNoBinary - Return Rich Text items as XML (Lotus DXL format), excluding
images and attachments.
NOTE: Render will only work well with forms designed for the Notes client. Forms
designed to display in a web browser will not work very well. This is especially true with
the default forms you get in QuickPlace or Quickr.
There are also two options for controlling the layout of the AttachmentLinks field for
Notes source (this is not applicable for QuickPlace/Quickr):
Columns - This property controls the number of links that will be shown on one
row. Set to 0 for a pure horizontal format or 1 for a vertical format.
Label - This property allows you to place a text label at the start of the links
area. Note that of Columns = 0, than the label will be displayed in the same
horizontal line, otherwise it will be placed on a separate line.
QuickPlace and Quickr do not use the same mechanism as Notes for displaying an
Attachment Links area. Instead of creating a new source column for Notes, you need to
use the predefined {AttachmentLinks} column.
NOTE: Adding an AttachmentLinks area does NOT guarantee that the attachments
themselves will be migrated. These still need to be explicitly migrated. For targets that
can store attachments - List items, InfoPath documents and Word documents - you can
map them directly. For other targets such as HTML pages, Basic pages, Wiki pages and
Web Part pages you have to map the attachments to an alternate file library location.
99
Figure 7 is an example of a migration job that places multiple AttachmentLinks sections on a Wiki page.
Below is the source document.
Figure 7. Migration Job Example
From the Preview Data Query tab, select Test to execute the Command against live data. Any results
from executing the command will be displayed in the Results dialog box.
NOTE: Binary data columns (images and attachments) and MIME columns will not be shown in the
preview dialog box. Multi-valued items will always be displayed as concatenated strings. To see the
details of large data items, click the item's cell and the full contents will be displayed in a dialog
box.
The Max Records option allows you to limit the number of Notes records to be viewed to a
predetermined number.
The Skip option allows you to skip the first x number of Notes records. When used in
conjunction with the "Max Records" option, you can view distinct chunks of data.
100
SharePoint
SQL Server
Folder
SharePoint
The "SharePoint" tab is where you select the SharePoint List that will be used as the destination for data to be
migrated. It is also where you select (or create) a Data Target Definition file that describes how data should be
written to this list.
Select the Site URL to which you will be migrating data. Navigate the SharePoint Virtual Servers, Sites,
and Sub-Sites (Web Pages). Select the desired list.
NOTE: If you are using the Console, the target on the Migration Targets tab overrides this target in
the migration job definition.
NOTE: If you have previously selected a Source Data Definition that typically maps to a particular
SharePoint List Type, that List Type will be displayed in the Show Lists of Type field and the tree
view will only display Lists of that particular type. If you want to see all types of Lists, select "<All>"
in the Show Lists of Type field.
To be sure this is the correct list, you can open the SharePoint List that you have selected by clicking the
Go To button. Once you have selected the desired list, click OK.
NOTE: Migrator for Notes to SharePoint is now capable of local or remote SharePoint servers. To
control the mode of operation, click Options and go to the SharePoint tab. For details on how to
configure your type of SharePoint connectivity, see Customizing Global Options. If your installation
is configured to access remote SharePoint servers, the list of available sites contains information
about each site's level of connectivity. You can add additional sites to the list by clicking the Sites
button.
Migrator for Notes to SharePoint displays the Site URL and List Name that describe the List location. (If
you prefer, you can type in the Site URL and List values instead of using the SharePoint server browser.)
Migrator for Notes to SharePoint will connect to the SharePoint server and display the List Template used
in the List you selected. (If you have typed in your own Site URL and List values or have loaded them
from an existing Job Definition, you may need to click Test to force this connection to occur.)
If the list does not yet exist and you want the Migrator for Notes to SharePoint migration process to
create the list, you can enter {} substitution variables in the List Name field which will be used to
generate the target list name. If you type {the valid variable substitution list will appear. You can use
the arrow-down key to select an entry, or click an entry with the mouse. If you type any other key, the
list will disappear so you can resume typing into the field.
NOTE: This feature is only available when using the Migrator for Notes to SharePoint Console.
Migrator for Notes to SharePoint displays the Template used to show what type of List it is. For example,
if the Template used is "Discussion Board" Migrator for Notes to SharePoint knows it is a standard
SharePoint Discussion List and can deduce the fields available within and other pertinent information.
The details about what fields, are available in a particular type of List are stored in the Target Data
Definition. For each List you want to migrate, you need to load (or create) a corresponding Target Data
Definition.
101
Migrator for Notes to SharePoint contains predefined Target Data Definitions for most of the standard List
Types that ship with SharePoint (Discussion, Document Library, Events). As soon as you select a List that
is based on a recognized List Type, Migrator for Notes to SharePoint will ask you if you want to
automatically load the corresponding Target Data Definition.
Sometimes the SharePoint List you wish to migrate has been customized or is not based on a recognized
List Type. If you know what the List Type is, you can click the Target Data Definition Load button to
select the appropriate Target Data Definition manually.
NOTE: If you want to generate a new SharePoint list if none exists in the location described on the
SharePoint tab, select Create SharePoint List. The new List will be based on the List Template
identified in your Target Data Definition. This will allow you provision entire SharePoint lists and
document libraries as part of your migration job.
If you want any fields identified in your Target Data Definition but not in the destination List to be
added to the list, select Add or upgrade List Fields. This will allow you to upgrade the schema
SharePoint lists and document libraries as part of your migration job.
If you want Migrator for Notes to SharePoint to automatically add provisioned lists or document
libraries in to the Quick Launch area in the target SharePoint site, select When creating List, Add
to Quick Launch.
If you want Migrator for Notes to SharePoint to enable versioning to the SharePoint list, select
When creating List, enable versioning.
If you want to remove any items previously displayed in the destination list, select Delete Current
List Items. This option may be disabled depending on how your tool Options are set. This option
can cause data loss. Be sure that you really want to remove all existing documents from the
list.
2
From the List Definition tab, enter a name and description for the target data definition.
To allow provisioning of Content Types in the target list, select the Allow management of Content Types
check box. Click the Add button to enter the Content Types that should be added to the target list.
Associate a Notes Form to the Content Type in order to automatically assign the Content Type to all
migrated records that are associated with the Form.
From the Data Fields tab, click Load from SharePoint List. This will automatically create Field
definitions for all the writable fields found in the SharePoint List you selected. Similarly, the Load From
Source Fields button will automatically create Field definitions for all the columns in your Source data
definition.
NOTE: If you select Managed Metadata as target type, ensure you add the terms to the termset
bound to the column, or you set Adding Missing Terms to Term Store to True so the content in
source field can be migrated to the target column.
102
You can also add (or modify) fields one at a time by clicking Add (or selecting an item in the list on the
left of the page) and then editing the properties in the dialog box on the right of the page.
NOTE: When you click Files in the left column, you can specify an alternate folder where files will
be written. You can also specify the maximum number of items in each alternate folder (the
default is 5000). When the maximum number is exceeded, more alternate folders are created with
an incremental value. For example, you can have an alternate folder called Attachments, once a
maximum number of items in the folder is reached, another alternate folder with an incremental
number, is created, called Attachments-0001. If you set the Max Item per Folder to 0, an
incremental alternate folder will not be created.
7
Define a view. From the Advanced tab, click New. The Edit a SharePoint view dialog box allows you to
define the SharePoint view. Only Standard SharePoint views can be defined. Migrator for Notes to
SharePoint does not create other view types like datasheets or calendar views. This editor has all the
same view definition properties as the view editor in SharePoint except it does not contain any mobile
settings.
The Columns tab is where you define the name of the view as well as the columns to include in
the view. Use the arrow buttons to change the order of the columns in the view.
The Group/Sort tab is where you define how the data is grouped and sorted. In SharePoint you
can only group on up to 2 columns.
The Filter tab is where you define a filter. This is optional. Select the radio button Show items
only when the following is true to define your filter. Select the field and its criteria for the
filter. By selecting the Show more columns link, you can add additional criteria to your filter.
The Totals tab is where you specify the calculations you want added to the view. You can
specify only one calculation per column. Different field types can have different possible
calculations, as follows:
Integer, Currency and Number fields also have Average, Maximum, Minimum, Sum,
Standard Deviation, and Variance
The Limits tab is where you define if you want to show items in their folders (hierarchical view)
or show items without their folders (flat view). From this tab you also define how may items to
display at a time as well as which folders to display the view in.
103
Select the view - Select the Notes view that you wish to migrate to SharePoint. The name of
the SharePoint view defaults to the Notes view name. If the Notes view is the default for that
database, the Make this the default view check box is checked. If the view already exists in
the Migrator for Notes to SharePoint target definition Views list, then another check box
appears in red, asking you if you wish to overwrite the view. The Next button is disabled until
you either change this views name or you check the overwrite box.
View columns - You can decide to manually map a Notes existing columns, define a new data
column (which will be added to your migration job), or specify a formula for a new computed
column in SharePoint. For each column in the Notes view, an entry appears in the column list.
The Notes view column is labeled (Untitled x) if it has no title. Below the column name is a
description of the views details: sorting (ascending/descending), categorized, hidden or
response-only. Each column has the following migration options:
Migrate? - Check this check box to migrate this column with the new view.
Hidden? - Check this check box to not display the migrated column. It will be available to use
in filtering but no data will be displayed for the column
New or Existing Column - You can create a new column or select an existing column. All new
columns are added to the target definition when the wizard is done.
When you click Next, some validation will occur: a migrated column must have a name, new
Calculated fields must have a formula, field names cannot be duplicated, and new fields
cannot duplicate those in the target definition. Next to the formula box for new fields there
is an Edit button which will launch the Formula Editor.
Grouping, Sorting and Totals - The SharePoint settings default to the options based on the
Notes view settings, as follows:
Grouping - If, in the previous panel, a Notes view column is set to migrate to the SharePoint
view ('Migrated but not displayed', or 'Display in view'), and it is marked as 'categorized' in
Notes, then the column will be set for grouping in SharePoint, based on the sort method
(ascending/descending). The first two categorized columns will be set this way in SharePoint
(any additional categorized columns will not be grouped - SharePoint's maximum is two
columns).
Sorting - Handled the same as grouping, except applied to the sort setting of the Notes view
columns.
Totals - Notes and SharePoint views both have the concept of showing totals for a column, but
the options are somewhat different. The migration wizard maps the totals as follows:
For Notes setting Average Per Category, Average Per Document: use SharePoint
'Average'.
View Selection Formula - recreate your selection formula in the SharePoint filter editor by
first selecting the Show items only when the following is true radio button. Select the field
and its criteria for the filter. By selecting the Show more columns link, you can add
additional criteria to your filter.
View Migration Complete- launch the completed view in the view editor to fine-tune details
not available in the wizard. Your view definition has been created and added to the migration
job. The migration job needs to be saved for the view definition to be saved.
Select the Migrate attachment icons as image files check box to allow the original attachment icons in
Notes to appear in SharePoint.
From the Migrate mapped data to section, indicate that you want to migrate to a folder or document set
in your target list or library rather than the default list item. Every record you extract from the data
source will result in a folder or document set being created, instead of a document.
This feature only writes new SharePoint folders; it will not update existing ones with the same name.
104
If you choose to migrate to a folder, you must map at least one item to a target column of type
Folder in the Map Data tab. This controls the new folder names. Many of the usual document
migration features will now apply to folders including:
Mapping of permissions (using the "Map Reader/Author fields" check box on your Advanced
tab)
Mapping additional data items to folders (requires creating a new Folder content type).
If you choose to migrate to a document set, a target column of type DocumentSet must be
added and a value mapped to the DocumentSet.Name property in the Map Data tab.
10 Select the Migrate document fields to custom properties check box to migrate any document
properties in the PDF to SharePoint. This is selected by default.
NOTE: The following fields will not appear as custom properties after the document is migrated to
PDF:
The fields from standard properties, including Title, Author, Subject, Keywords, Creator,
Producer, CreationDate, ModDate, and Trapped.
11 Select the names of the SharePoint templates which "match" this data definition. More than one
template can match. Use the Select button to add or remove multiple selections.
The Views list contain all the views that will be created in the SharePoint target, similar to fields, during
the provisioning part of the migration job.
The buttons at the bottom of the list are for importing view definitions from Notes, editing view
definitions, creating new and deleting existing view definitions from the list.
If the If view already exists in SharePoint, overwrite its configuration check box is checked, the view
definition in SharePoint will be overwritten. Otherwise a pre-existing view will not be changed.
12 Click OK.
You are returned to the SharePoint tab.
13 Select an option if a duplicate is found. This situation can occur if you have run the same migration job
twice or if you have two migration jobs that process the same document (for example, a document that
appears in multiple Notes views) or if you are migrating multiple versions of a QuickPlace or Domino.Doc
document (see QuickPlace Publishing and Domino.Doc Publishing for more information). The following
options allow for running the same migration job repeatedly (and as efficiently as possible) while always
yielding the most desirable result. Your choices for this option are:
Write new item - Do not check for duplicates and simply write a new SharePoint record for each
Notes document encountered. This is the fastest option if you expect duplicates to be rare. If you
are migrating QuickPlace or Domino.Doc versions, each version of a document will be created as
a new SharePoint record.
Replace existing item - If a duplicate record is encountered, delete the prior SharePoint version
and then migrate the document again.
Create new version (if modified) - If a duplicate record is encountered and the Notes document
has been modified since it was previously migrated, the new document will be created as a new
version of the old document. If the SharePoint list or library does not support versioning, then the
document will be migrated as a separate record. Use this option to create corresponding versions
of a SharePoint record for each version of the document in QuickPlace or Domino.Doc when you
are migrating multiple versions. If you are migrating to a list that is already created, enable
SharePoint version control.
Skip item - If a duplicate record is encountered, then ignore the Notes document.
105
SQL Server
This is where you select the target SQL Server database and tables that will be the destination of migrated data.
It is also where you select (or create) a Data Target Definition file that describes how data should be written to
this database.
Access the database through Windows or SQL Authentication. To change authentications, click Settings
and select an authentication.
select the Migrate attachment icons as image files check box to allow the original attachment
icons in Notes to appear in SharePoint.
From the Data Fields tab, click Load from SharePoint List. This will automatically create Field
definitions for all the writable fields found in the SharePoint List you selected. Similarly, the Load From
Source Fields button will automatically create Field definitions for all the columns in your Source data
definition.
You can also add (or modify) fields one at a time by clicking Add (or selecting an item in the list on the
left of the page) and then editing the properties in the dialog box on the right of the page.
Folder
This is where you select a target folder created on a local drive to migrate data.
select the Migrate attachment icons as image files check box to allow the original attachment
icons in Notes to appear in SharePoint.
select the Migrate document fields to custom properties check box to migrate any document
properties in the PDF to SharePoint
From the Data Fields tab, click Load from SharePoint List. This will automatically create Field
definitions for all the writable fields found in the SharePoint List you selected. Similarly, the Load From
Source Fields button will automatically create Field definitions for all the columns in your Source data
definition.
Dell Migrator for Notes to SharePoint 6.6
User Guide
106
You can also add (or modify) fields one at a time by clicking Add (or selecting an item in the list on the
left of the page) and then editing the properties in the dialog box on the right of the page.
Mapping Data
The "Map Data" tab is where you describe how the fields in your Data Source Definition map to the SharePoint
fields in your Data Target Definition. In most cases, the Auto Map function will do the mappings for you, but you
can also override the defaults.
If you have selected Source and Target Data Definitions, a default set of field mappings will be generated for
you using the AutoMap Names property for the target data field definitions. You can refresh these mappings by
clicking the Auto Map button.
If you have multiple source fields that you are mapping to one target Note field using the target fields
AllowMultipleSources property, the order of the concatenated fields depends on the order of the fields in this
field mapping table.
Click Add.
The New Field Mapping dialog box will allow you to quickly select from a list of fields defined by your
Target Data Definition. In addition to the fields you explicitly defined, a number of additional meta-data
fields will also be available. These will be identified with {curly braces}.
You can map these data source fields to an unused existing SharePoint field (defined by your Target Data
Definition) or add a new one. For each target data field of type WordDocument, you will see its
metadata fields in the list of predefined fields as well. These are indicated in the list using the field
name defined for the Word document (for example, Field0.Title).
The SourceType property can be set to any of the available types:
Constant - Set the SharePoint field to a constant value. In the Source Value field, enter the
constant value that you want written in SharePoint. If you are mapping a constant to a rich text
field, you can use \n to denote a new line in the Source Value field.
TargetValue - Set the SharePoint field to the target value of a corresponding field. If the
SourceType is set to TargetValue, you need to set the TargetValue option.
Link to Parent Document - Creates a URL field that contains a link to the parent document
when migrating parent/response documents to SharePoint discussion templates. It is
especially useful if you are migrating a database containing parent/response documents to
anything other than a discussion list. Without doing this mapping, you would lose any
correlation between the response documents and their parents.
Link to Primary Document - Creates a URL field that contains a link to the main parent
document when migrating file attachments to alternate SharePoint library locations. The
link uses the parent's Subject field as the display name. Without doing this mapping, you
might not know where the main document for the attachments resides.
Multi Value Disposition - Directs how any multi-valued Notes items should be written to
SharePoint Lists. The options are:
Default - Take the most appropriate action based on the source and target values being
mapped
107
Merge - Take all the values and combine them into a single string separated by commas
All - Take all values and attempt to map them to SharePoint. This will only succeed if the
target column allows multiple values.
Normalize - This option is only available for simple data types (text, date, number, choice) and
only when migrating to a SharePoint list (not a document library, discussion, or calendar).
Migrator for Notes to SharePoint will gather up all the possible values for Normalized mappings
and write out multiple SharePoint list items, one for each value. Any mapping that is not flagged
as Normalized will get copied to each of the resulting records. If more than one of the mappings
is flagged as Normalized, then the one with the greatest number of elements will control the
number of migrated records. For more information, see Normalizing multi-valued items to
multiple documents on page 110.
Transform - Directs how data should be modified when writing to SharePoint Lists. The options
are:
CommonName, AbbreviatedName and Unmappable are useful in cases where you are NOT
using the full User Mapping process, which maps Notes names to Active Directory
accounts. User Mapping is still required when mapping to a User field in SharePoint. These
transform types are useful when targeting "plain" Text fields in SharePoint, Word.
Select the Preserve Created/Modified Dates option to allow the Created and Modified fields to be set
based on the respective properties of the original Notes document.
Select the Preserve Created/Modified Identities option to allows the Author and Editor fields to be set
based on the $UpdatedBy property of the original Notes document. SharePoint tracks users as numeric
indexes into the SharePoint Site Collection Users list. Migrator for Notes to SharePoint will attempt to
map Notes names to Site Collection User identities based on the rules configured in the tool's User
Mapping.)
Select the Preserve Response/Reply Hierarchies option to allow newly written SharePoint items to be
linked with the correct parent items to reflect the parent/response relationships that existed.
Select the Map Event / Recurrence Data option will cause calendar information (appointment type, start
date, repeat information) in Calendar items to be mapped to the equivalent fields in SharePoint Events.
When using the "Preserve Created/Modified Identities" option in your Job Definition
On a per-job basis, you can decide what happens if no user mapping is found for a particular Notes name. The
record can be rejected or defaults can be applied depending on the If user mapping fails setting.
The details of how user mapping occurs is controlled by the Global Options.
Dell Migrator for Notes to SharePoint 6.6
User Guide
108
Migrator for Notes to SharePoint 's security mapping options will map various access control properties of the
source Notes database, QuickPlace, Quickr, or Domino.Doc cabinet to the equivalent constructs in SharePoint.
Select one or more of the five available Security Mapping check boxes of your Job Definition.
The Map Notes Users to Domain Users option will cause any Notes users listed in the source
database's Access Control List to be added to the target SharePoint list or library. The Notes user
names are mapped to Site Collection identities based on the rules configured in the tool's User
Mapping and those Users are granted access to the target SharePoint list or library.
The Map Notes Groups to Domain Groups option will cause any Notes groups listed in the source
database's Access Control List to be added to the target SharePoint list or library. The Notes group
names are added to the Site Collection as external groups and are granted access to the target
SharePoint list or library. Each group name must correspond to an actual Domain group.
NOTE: If either the Map Notes Users to Domain Users or Map Notes Groups to Domain Groups
options are checked in the Migration Targets tab, the Permission Mapping options will
determine how the Notes database access levels (and related flags) are translated into
SharePoint permission levels.
The Expand Notes Roles to SharePoint Groups option causes a new SharePoint Site Collection
Group to be created for each Role defined in the Notes database ACL.
The Expand Notes Groups to SharePoint Groups option allows you to take what was once a
Domino Directory group (scoped to the entire Notes Domain) and convert it to a SharePoint group
(scoped to just one Site Collection). As part of this conversion, the tool will query the Domino
Directory for any groups listed in the ACL, extract all its members (expanding any sub-groups as
needed), and add those members to the new SharePoint group.
NOTE: If both the Map Notes Groups to Domain Groups and Expand Notes Groups to
SharePoint Groups options are selected, Migrator for Notes to SharePoint will first try to find
a mapping for the group name in the directory or mapping file. If it finds a mapping, it will
map to the Domain group. If it doesn't, it will provision a SharePoint group instead.
If the Map Reader/Author fields option is set, then any Reader Names or Author Names items
encountered in a particular Notes document will cause a permission list to be generated on the
corresponding SharePoint record. This new permission list will only grant read access to the users
and groups named in the Reader Names field and will only grant edit access to the users and
groups named in the Author Names field.
To control precisely which security constructs are mapped to Notes, click the Advanced Security
Settings link (this link is available when you select a check box).
Convert to native notes:// URLs (for use with the Notes client) - When generating HTML or MIME
documents from Notes Rich Text fields, any DocLinks, ViewLinks, and DatabaseLinks that are
encountered are converted to "Notes URLs" (for example
notes:///85256B20007EED50/38D46BF5E8F08834852564B500129B2C). On machines where the
Notes client is installed, such a URL allows Notes to open to the correct document, view, or
database.
CAUTION: Unfortunately, SharePoint does not currently allow Notes URLs in HTML fields,
so the feature is not useful in those cases.
Use the Dell Link Tracking Service - This option utilizes the Link Tracking Service, which ensures
that Notes DocLinks continue to work before, during and after the migration process, regardless
of the order of document migration. The service maintains a record of every document that is
ever migrated and guarantees that users clicking on an intra-document link will always get
redirected to the current location of the document.
109
NOTE: This feature requires the use of Migrator for Notes to SharePoints Link Tracking
Service. For details, see the Understanding the Link Tracking Service section in the Migrator
for Notes to SharePoint Installation Guide.
Convert to a link to the specified URL - This option replaces each DocLink with a link to a fixed
generic web page.
Convert to http:// URLs (for use with the Domino server) - This option prompts you for an
additional field URL for Converted DocLinks. To allows you to map the "notes:///" portion of the
Notes URL to point to a Domino web server where the linked-to database exists. For example, if
you specify "http://proposion.com/" in the URL for Converted DocLinks field, the URL would be
changed to "http://proposion.com/85256B20007EED50/38D46BF5E8F08834852564B500129B2C".
110
definition column with the formula "Product_1: Product_2: Product_3: Product_4" to generate a "Products"
array.
Figure 9. Defining source data definition column
NOTE: Documents generated in this manner will not be added to the Link Tracking database, so you
cannot link to them.
The target SharePoint field is one of the types that we support for Normalization (for example, Text).
This option is not available for the following field types:
Note
Attachments
DocumentSet
The target field (SharePoint) is only for the primary list (that is, "AppliesTo" must be set to "PrimaryOnly"
or "ContentTypes")
The source field (Notes) is multi-valued (that is, it must be set to use the "Multi" option)
111
dynamic @formulas for data conversion, multi-valued item handling, author name and access control mapping,
versioning, and much more. The resulting generated XML documents can be saved into SharePoint as Document
Library files, Form Library documents, List Item fields or Web Part Pages.
Add a column of type Document to your Notes Source Data Definition. The DocumentTemplate
property of the column definition should be a complete XML document that contains all the declarations
and tags you want in your generated documents. Users would typically create a sample document in
their target application and use that as the starting point for their Document Template.
NOTE: Applications such as InfoPath can be very sensitive to the schema version and other metadata such
as form template location (that is, the information expressed in the mso-infoPathSolution tag). A
common best practice, therefore, is to first develop your InfoPath form template, publish to SharePoint,
and fully verify the integrated solution. Then create your sample XML document in the context of your
working SharePoint application and use that as the basis for creating a Document Template in Migrator for
Notes to SharePoint.
To generate repeating entries (an array) based on the values in a Notes multi-valued item, add the
multi=repeat attribute to your <ppm:replace> tag. This will cause the surrounding XML tag to be
repeated once for each input value encountered. You can also specify multi='repeatparent' to repeat the
surrounding XML tag and its parent once for every value encountered in the multi-valued item. This
option is useful for encoding multiple attachments (see below) or other repeating group elements in
InfoPath.
To avoid generating tags when the Notes values are null, missing or empty strings, use the
ifempty='remove' or ifempty='removeparent' attribute. This will cause the surrounding XML tag (or its
parent) to only be generated if there is actual data in the source Notes item.
To generate rich text entries, add the encode=xhtml attribute to your <ppm:replace> tag. This will
cause the HTML markup extracted from your Notes documents to be saved into your generated document
as XML tags rather than as plain text.
When using encode='xhtml' you can also add an 'images' attribute. This is similar to the 'src' attribute in
that it should be the name of another source data definition column. The images are encoded right into
the XHTML and you go not need to migrate them separately.
When using encode='xhtml' any Notes DocLink icons that are encountered are converted to encoded icons
in your XML document. To disable this behavior, add the attribute linkicons=false to your
<ppm:replace> tag. This will cause Notes DocLink icons to be replaced with a simple text link instead.
Other possibilities for the encode attribute are 'commonname' and 'abbreviatedname' for formatting
Notes names and 'datetime', 'dateonly' and 'timeonly' for formatting XML Date/Time values.
Dell Migrator for Notes to SharePoint 6.6
User Guide
112
If you wish the source data column to copied as is into the XML document, you can use encode=xml
rather than encode=xhtml. This might be useful if, for example, you have a Notes item that contains
pure XML or you have created a formula column in your source data definition that emits an XML
fragment. If you omit the encode attribute completely, the source data will be encoded as a Text
element by default and any special characters (such as XML angle brackets) will be escaped.
To encode your attachment as an InfoPath attachment (using InfoPaths proprietary format), add the
encode=attachment attribute to your <ppm:replace> tag. To encode your attachment using standard
base64 encoding, add the encode=base64 attribute to your <ppm:replace> tag. This later choice is
useful in some XML applications, but not for InfoPath.
To substitute target information in your XML, use the tag, <ppm:replace target=site>. Currently, the
only supported value is site which yields the complete site URL.
NOTE: To make sure InfoPath attachments display properly, include the <?mso-infoPath-fileattachment-present?> processing instruction at the top of the document.
NOTE: While this release only implements the <ppm:replace> tag, more advanced tags and
attributes are planned for subsequent releases. As a workaround to most limitations you might
encounter, consider using Formula columns to create XML fragments.
NOTE: In this release, a simple drop-down text editor is available for entering multi-line Document
Templates. In practice, many users would prefer to use their favorite XML editor and copy/paste
the results in Migrator for Notes to SharePoint. A more powerful editor/designer is planned for
future releases which will assist with loading a sample XML document, merging source columns,
generating PPM tags.
5
To save your generated XML documents into a Document Library or Forms Library in SharePoint, simply
map your new Document column to a File field in SharePoint, just as you would when extracting
attachments or embedded images. You can also map Document columns to List Item text fields or List
Item attachment fields.
You can control the name of generated XML files by mapping a dynamic source column to a FileName
field in your target data definition.
Create an InfoPath form template from the Notes form. Migrator for Notes to SharePoint can do this
automatically for you. See Generate InfoPath Form Template for detailed instructions on how to do this.
You can also start with your company's existing InfoPath form template.
Use the InfoPath client itself to publish the form template to SharePoint. You do this using the InfoPath
client's File/Publish menu option. For more information, see your InfoPath help guide.
Copy the published form template from the SharePoint document library to your local drive. This
template is what you will use in your Migrator for Notes to SharePoint migration job definition. If the
template is the default template for the document library, you can copy it by changing the
Allitems.aspx in the URL of the document library to template.xsn.
Save it from the pop-up that appears. Be sure to turn of your Pop-up Blocker before doing this. If the
template is not your default, you can copy it by going to the Form Library Advanced Settings page.
Once you have the form template (.xsn file), you can then add it to the Migrator for Notes to SharePoint
migration job using the Target Data Definition.
113
NOTE: You cannot use the template that was generated from the InfoPath Form Template
generation tool. You must use the copy of the template that was published to the document library
in your Migrator for Notes to SharePoint migration job.
6
In the Target Data Definition, add a target column of type InfoPathDocument. You must also specify a
column Name (which is used in the field mapping process).
Specifying a Template is required for InfoPath documents. To specify a template, click the InfoPath
Template property and click the Details button to launch the Map InfoPath template fields dialog.
In the Map InfoPath template fields dialog, import an InfoPath template (.xsn file) using the Load XSN
link. A complete copy of the imported template will be saved as part of your Target Data Definition and
will be used as the basis for any documents that you generate with it.
With some form templates, the XSN importer cannot determine what the HREF (location of template)
should be for a generated document. For instance, if a template was imported into Central Admin,
approved by an administrator, then assigned to a site, where SharePoint automatically created a content
type for it. In this case, the published XSN location is not in the XSN. For these unusual cases, you need
to specify the template location in the Published XSN location field. This field will be automatically
loaded with the location if the XSN importer can determine the HREF.
Once an XSN has been loaded using the Load XSN link, the Export XSN link is enabled. Clicking Export
XSN launches a file save dialog box, allowing you to save the previously-imported XSN back to a file on
disk.
The Map InfoPath template fields dialog also includes a complete list of the available Mappable Fields,
which are the parts of the generated InfoPath form documents that you might want to map Notes data
to. If desired, you can customize how these Mappable Fields appear on the Mapping tab. Recall that
Migrator for Notes to SharePoint maintains the distinction between the reusable Target Data Definitions
that describe the schema of your SharePoint targets and the mapping of source columns to target fields
in a specific migration job. You can clear certain Mappable Fields that you do not want to show on the
Mapping tab. You can also override some of the Mappable Field properties such as the MappableName
that is visible on the Mapping tab and the AutomapNames property that provides a hint as to which Notes
source columns should automatically map to the target field.
If you import a form template (.xsn) with two leaf nodes having the same name, the MappableNames
fields are pre-filled with a fully-qualified path to the node in the tree (that is,
Customers/Customer/name). This prevents duplicates in the target documents.
If a field is inside a field that is repeating, it's Multi property will be auto-set to RepeatParent. All
sibling fields must have this property set to RepeatParent. This prevents the parent element from being
repeated in the generated XML.
You may wish to enable the "Migrate Attachment Icons" feature in your migrated InfoPath form
documents. This will allow the original attachments icons in Notes to appear in SharePoint.
Once you save your Target Data Definition, the various parts of the InfoPath Document field you defined
will be available on the Mapping tab. A special "Field.Part" notation is used here. In the example, we
called the InfoPathDocument field "Doc" so the mappable parts are called "Doc.Body", "Doc.Title",
"Doc.Status" and so on. There is also a special field called "Doc.FileName" that allows you to set the
names of the generated InfoPath files from dynamic Notes data
When you run the job, Migrator for Notes to SharePoint will generate one InfoPath form document for
each Notes document. You can inspect the migration log for any issues.
114
Return Type to HtmlString". For example, some custom Notes applications, especially web-enabled Domino
applications, actually store raw HTML in text fields. Using the HtmlString return type can migrate those to
SharePoint rich text fields "as is".
This is similar to the capability available when generating InfoPath XML documents from Notes documents. You
can use the attribute encode="xml" inside your <ppm:replace> tags to indicate that you want the mapped
source column to be treated as "pass through" XML.
any content
[PPM:PASSTHROUGH]-->
This construct allows encoding of any content that is not legal XML (for example <%@ Page %> tags common in
ASPX pages). This is structured as an XML comment and anything inside that comment will be passed through "as
is" in the generated documents.
<ppm:document> other xml tags </ppm:document>
This construct allows wrapping multiple "top level" tags in a single top level tag, as required in legal XML
documents. The outer <ppm:document> tag is simply removed in the generated documents.
<ppm:replace target="site">
This construct allows you to substitute target information in your XML file. Currently, the only supported value
is "site" which yields the complete site URL.
A common best practice is to first develop a sample ASPX Page in SharePoint that contains all of the layout and
Web Parts that you want in your resulting pages. Then download your ASPX Page and edit it to make certain
parts dynamic (using ppm:replace tags) and escape the parts that are not legal XML (using ppm:document tags
and ppm:passthough sections). You will use this ASPX document to create the XML for the Document Template
property.
NOTE: This Web Part Page is only used to generate the XML that needs to go into the DocumentTemplate
property of the Notes Source Data Definition. Once you have the needed XML, this sample Web Part Page
can be deleted. It is not used during the migration process.
This ASPX document is not a valid XML document so it can not be used in the DocumentTemplate property yet.
To make it a valid XML document, open this ASPX document in your favorite XML editor and modify it by using
the additional tags. Once it is valid XML, copy the XML to the DocumentTemplate field of the Source Data
Definition in Migrator for Notes to SharePoint.
NOTE: In this release, a simple drop-down text editor is available for entering multi-line Document
Templates. In practice, many users would prefer to use their favorite XML editor and copy/paste the
results in Migrator for Notes to SharePoint. A more powerful editor/designer is planned for future releases
which will assist with loading a sample XML document, merging source columns, and generating PPM tags.
115
To save your generated Web Part Pages into a Document Library in SharePoint, simply map your new
Document column to a File field in SharePoint, just as you would when extracting attachments or embedded
images.
To migrate the source data fields into the various Web Parts on the page, you must know each Web Parts
WebPartTitle and PropertyName. You can use your XML editor or SharePoint Designer to identify these.
NOTE: The list of Web Parts that are shipped as part of WSS v3 can be found at
http://msdn.microsoft.com/en-us/library/microsoft.sharepoint.webpartpages.aspx. The MSDN website
also contains detailed information about each Web Part property including the PropertyNames. For
example, the detailed information for the ContentEditorWebPart properties can be found at
http://msdn.microsoft.com/enus/library/microsoft.sharepoint.webpartpages.contenteditorwebpart_properties.aspx.
For each Web Part, add a data field of type WebPartProperty in the Target Data Definition with the
WebPartTitle and PropertyName properties filled out. Then map the source columns to these fields in your
target data definition.
You can control the name of the Web Part Pages by mapping a dynamic source column to a FileName field in
your target data definition.
116
Migrate Notes rich text to new (blank) Word document - In this scenario the user wants to map the rich
text portion of their Notes documents (typically the "Body" field) to Word 2007 documents (DOCX files)
created from scratch. The generated rich text content is pretty much the only thing in the resulting
documents. The fidelity of the migrated content is very high and includes tables, fonts, bullets, images,
doc links, and much more. The known limitations are listed at the end of this document.
Optionally, the user may want to migrate specific Notes data items to Standard Document Properties
such as Author, Category or Description within the generated Word documents.
As these documents are generated, they will be checked into the designated SharePoint library.
A large number of existing Migrator for Notes to SharePoint features apply here, including the ability to
set created/modified metadata, document permissions, target folders, content types, workflow state,
version history, data transformations and more.
Furthermore, the user may want to migrate specific Notes data items to specific metadata columns in
the document library. When the document is opened in SharePoint, these properties will appear as
"Server Properties" in the Word user interface.
Migrate Notes rich text to new Word documents based on existing templates - This scenario is similar to
the one above except that the user can specify the Word 2007 template (DOTX file) they want to start
with. The generated documents will pick up the headers, footers, or backgrounds of the original
template. It the template includes any rich text content, the migrated content will be appended to it.
If the Word template defines Custom Document Properties, the user may want to migrate specific Notes
data items to these Custom Properties as well as to the Standard Properties.
Migrate Notes documents to Word documents with embedded content controls and legacy controls - In
this scenario, the user is using the Word template as a "form" with rich layout and data entry fields (and
possibly data validation rules, computations, actions.). For each Notes document, Migrator for Notes to
SharePoint will generate an equivalent Word document with specific Notes data items mapped to these
controls.
If the user is taking advantage of SharePoint's automatic mapping of SharePoint meta-data columns to
Word content controls (exposed to SharePoint developers as "Quick Parts") then the best approach is to
simply map the Notes data items to the metadata columns in the document library and let SharePoint
synchronize them with Word.
Migrator for Notes to SharePoint can also set the contents of the content controls or legacy controls
directly with the mapped Notes data. They will continue to appear as data entry fields in the document,
but they will not be synchronized with SharePoint metadata columns.
Migrator for Notes to SharePoint can also replace the content controls or legacy controls entirely with
the mapped Notes data. They will no longer appear as data entry fields.
NOTE: The user may still want to map a Notes rich text "Body" field to the document in addition to
populating the controls, as described in the first two scenarios.
117
In the Word Template Options dialog you can optionally import a Microsoft Word 2007 template (.DOTX file)
using the Import button. Note that a complete copy of the imported template will be saved as part of your
Target Data Definition and will be used as the basis for any documents that you generate with it.
If the imported template contains any of the MSWord Content Controls that are supported by Migrator for Notes
to SharePoint, and these controls are not bound to SharePoint columns or XML data, then they will appear as
mappable controls in the Mappable Fields section of the dialog. The content controls that are supported are
RichText, PlainText, DatePicker, ListBox, ComboBox.
Word Template Options dialog also includes a complete list of the available Mappable Fields, which are the parts
of the generated Word documents that you might want to map Notes data to. This list includes the main rich
text Body of the document, all the Standard Properties available in every Word document (Author, Created
date, Subject, Title, Keywords, Category, Status and Revision) and well as any Custom Properties that may have
been defined by the Word template you loaded.
If desired, you can customize how these Mappable Fields appear on the Mapping tab. (Recall that Migrator for
Notes to SharePoint maintains the distinction between the reusable Target Data Definitions that describe the
schema of your SharePoint targets and the mapping of source columns to target fields in a specific migration
job.) You can clear certain Mappable Fields that you do not want to show on the Mapping tab. You can also
override some of the Mappable Field properties such as the MappableName that is visible on the Mapping tab,
the AutomapNames property that provides a hint as to which Notes source columns should automatically map to
the target field, and the AllowMultiple property which controls when mapping of two or more source fields to
one target field should be allowed.
For embedded content control type fields, you can define how the data value will be mapped to the content
control using the Mapping Behavior property. This property has the following options:
Set Value
If the control contains an initial value added by the template designer, this is preserved and then
all mapped values will follow this initial value.
If the control only contains PlaceHolder text (typically shown in gray) and often says something
similar to "Click Here to enter text", this content gets removed prior to adding values.
Replace Control
If multiple fields are mapped to a control with this behavior set, then only the FIRST mapped
value is handled. After that all other mapped values are ignored.
If the control has non-placeholder content added by the template designer, it is discarded with
the control when the control is replaced.
Content controls in MSWord may be data bound to either SharePoint fields or XML data. We do not allow
mapping to any data bound content controls as MSWord would ignore our content in favor of the bound data
resulting in data loss for the user.
Note that your Target Data Definition may well contain additional target fields that are not part of the
generated Word Document. In particular, you can add target columns for any additional metadata properties
that should be written to the SharePoint document library, rather than inside the generated Word documents (as
described in scenario #3).
You may also want to specify Folder names as well as the alternate locations for embedded attachments and
OLE objects that should be migrated separately to SharePoint. These are existing features that are described
elsewhere, but they apply equally well to Notes documents.
One final thing you may wish to enable in your migrated Word documents is the new "Migrate Attachment Icons"
feature. While this is not always desirable when migrating to List Items, it looks pretty nice in Word Documents.
Once you save your Target Data Definition, the various parts of the WordDocument field you defined will be
available on the Mapping tab.
In most cases, you will (at a minimum) want to map the Html version of your Notes documents to the Doc.Body
field and map the Subject (or a similarly descriptive Notes item) to Doc.FileName. You can also add additional
mappings for standard properties and custom properties as needed.
When you run the job, Migrator for Notes to SharePoint will generate one Word document for each Notes
document. You can inspect the migration log for any issues.
Dell Migrator for Notes to SharePoint 6.6
User Guide
118
NOTE: Large images that do not fit within the page margins of the target Word document will be
automatically resized during migration taking the size, orientation and margins of the template into
account.
Mapping of permissions (using the "Map Reader/Author fields" check box on your Advanced tab)
Mapping created/modified metadata to folders (using the "Preserve Created/Modified" check boxes on
the Map Data tab)
Mapping additional data items to folders (requires creating a new Folder content type).
NOTE: Many job features that would apply to document migration will not apply to folder migrations. For
example, document generation and duplicate document handling options would be disallowed in this
context.
119
Figure 10. Document that has been migrated using Migrator for Notes to SharePoint
If we put this page into edit mode, we can see that a great deal of out-of the-box functionality is available with
no development required.
Figure 11. Document that has been migrated using Migrator for Notes to SharePoint
Migrator for Notes to SharePoint supports migrating any Notes content to publishing pages. This is a little more
complex than doing other wiki pages or basic pages and uses the tools unique capability to create pages using
custom ASPX template code.
If you do not already have a publishing site, create one using SharePoint Central Administration and specify one
of the Publishing templates
Next, you need to create a template for generating pages from your Notes documents. Go to your new
SharePoint publishing site and create a sample page by selecting Create Page from the Site Actions menu.t
Select the page layout you want for your new pages. The list of layouts may vary depending on the site template
you started with and may include custom layouts designed by your site owners. Populate the page with a little
sample data and save it.
Dell Migrator for Notes to SharePoint 6.6
User Guide
120
Feel free to experiment with checking the page in and out, versioning it, scheduling its release or submitting it
for approval. These are all powerful features of the SharePoint publishing templates, but you actually do not
need to use them for the task at hand.
For designing a migration job, you need to extract the page to a local file so you can get an example of the ASPX
layout. Select View All Site Content from the Site Actions menu and then go to the Pages document library.
In the Pages library, locate the test page you just created and pick Send To > Download a Copy from the drop
down menu for that page. y
Save the ASPX file to your computer and edit in any text editor. Keep this ASPX file handy, because you will be
using it later.
Digression: ASPX developers may be interested in how this page is constructed. It inherits from a class in the
Microsoft.SharePoint.Publishing namespace, but does not actually specify any HTML markup. Instead the code
behind the pages uses the data in an XML data island to render the page. Notice that the XML parts specify not
only content properties such as PublishingPageContent but also the page layout in the PublishingPageLayout
property.
Now you have what you need to create your Migrator for Notes to SharePoint migration job. You can start from
scratch or customize an existing job.
If you are starting with an existing job, first change the source Notes database to refer to your database and you
may need to customize the source data definition to extract different Notes data items than the default ones
specified (Subject, Body).
You should also change and target SharePoint URL to point to your publishing site. The pre-existing jobs are
already configured to create new pages in the Pages library, place any embedded objects in the Images
library, and place any attachments or embedded objects in the Documents library. This is consistent with the
way things work normally when a SharePoint user created content in a publishing site, so you probably do not
need to change those parts.
If you open the target data definition in the migration job, you will notice that there is a target field of type
PageName and that the PageType property of this field is set to Template. This PageType allows you to
specify your own custom ASPX code in the PageTemplate field.
The ASPX code is what needs to be put into the PageTemplate field. Not all of it though, just the bits that
describe the page structure. The content parts can be left out and, as you will see shortly, we will specify the
content in a different way (mapping the data dynamically from Notes). Your ASPX page may look different, but
generally you want the ASPX tags at the top (which start with <%@) and the <html> tag.
Notice that the target data definition also specifies several fields that allow data to be mapped as content in
the generated pages. Some of these you may recognize as the properties that were specified in the XML data
island (the green part). We included PublishingPageContent for mapping the Notes rich text and
PublishingPageLayout for specifying the page layout. Other page types may require additional properties but
you will find that many of them can be omitted as the defaults are acceptable for migrations. Title and
ApprovalCode allow setting of metadata on the page. ExternalImages and ExternalAttachments allow
mapping of additional files to the appropriate SharePoint libraries.
Press OK to save the target data definition. Next, go to the Mapping tab to review how various fields are set
from the dynamic Notes data. Most of these mappings will make sense to an experienced Migrator for Notes to
SharePoint user, but two deserve special attention.
The PublishingPageLayout is set to a constant value, which is the URL of the appropriate layout page. It is
critical that you replace this value with the address of a layout page on your SharePoint server. Recall that in
the newly created test page in the example, the page layout Article page with body only was selected. In the
resulting ASPX file, this translated to the PublishingPageLayout property in the XML data island (the green bit)
set to http://dell-e52a78ada/sites/publishing/_catalogs/masterpage/PageFromDocLayout.aspx. This is the
URL that you need to use here. If you do not get this part right, your pages will not open.
121
Figure 12. Replacing source value with address of a layout page on your SharePoint server
The jobs are also designed to set any migrated content to the Approved state. This is accomplished by
mapping a constant value to the ApprovalCode field. Of course you can change this to a different constant
value or even make it dynamic depending on the state of your Notes document.
Depending on the page layout you selected, you may need to map other properties as well. When you are ready,
press the Run Job button to start the migration.
122
4
Migration Jobs
If you have access to both SharePoint and Notes on your machine, or if you are connected to a remote
SharePoint server running Migrator for Notes to SharePoint's Import Service, you can run a complete data
migration job all at once. Otherwise, you need to export the intermediate results to an XML file from Notes and
then import intermediate results from an XML file into SharePoint. The following is an example of how you
might use the export/import:
Machine A:
1
Install Migrator for Notes to SharePoint on a machine that has a Notes client (remember that you can still
connect to other Domino servers in your organization).
Define your complete data transfer job (Source Definitions, Target Definitions, and Mappings) or load an
existing job.
Click the Run buttons drop down menu and select Save to Intermediate File to save the results to an
intermediate XML file.
Machine B:
Click the Load Job button to save the Job Definition you saved in step #3.
Change the SharePoint target site, list, and transfer options if needed. However, you should not change
the Data Definitions or Mappings.
123
Click the Run buttons drop down menu and select and Load from Intermediate File to load from the
intermediate XML file you saved in step #4.
If you choose to use an intermediate data transfer file, you should also save the matching Job Definition. See
Managing Migration Jobs on page 125 for more details.
From the Console, you can select multiple databases, right-click, and select Migrate to SharePoint.
To view detail information regarding the jobs before you run them, click the Details link.
If you choose Save to Intermediate File, a dialog comes up that gives you an option to have the attachments
saved to a separate folder rather than the default of the intermediate data file.
There are a couple of benefits to saving the attachments in a separate folder:
If you need to post-process the intermediate data file (either to modify it before you import it into
SharePoint, or to use it for you own purposes) and it is much easier to do this with a smaller XML file.
There are bugs in the .NET serializer for large XML elements. Keeping the attachments in a separate
folder keeps the XML file smaller and therefore should prevent these bugs.
When you choose to save attachments and generated documents to a separate folder, Migrator for Notes to
SharePoint uses the correct file names wherever possible when the attachments and generated documents (but
not images) are saved to the file system.
The name of this separate folder is derived from the name of the intermediate data file with "_Files" appended.
The name or location of this shared folder cannot be changed. You can move the intermediate file and its
corresponding folder, but you cannot rename them, and they must remain in the same relative location to each
other (that is, When reading "journal.xml" we expect that the "journal_Files" folder will be in the same
directory as "journal.xml").
You should see your progress displayed in a task process dialog box. If you are using the Console and chose to run
the job in the background, you can find the task process dialog box in the Task History node of the tree.
To cancel the migration, click Cancel Task or close the dialog box.
When your job is complete, you will have the opportunity to view your log file or go directly to the SharePoint
list or library by clicking Go to List.
124
To open the document for the given log entry in the source Notes database, select Open in Notes.
Select Close to close the Log Entry Details dialog box.
To view the log details for a migrated document, select the document in the Log Summary tab and click the
Show in Log button on the right side of the tab. This will take you to the line item in the Log Details tab that
represents the migration of the selected document.
The Log Details tab contains the detail line items of the log file. While the migration job is running, this
information is updated by clicking the Refresh link in the upper left side of the tab. This link is only visible
while the job is processing.
NOTE: The refresh link is not available when viewing a running job through the Task History node of the
Console.
The data can be sorted by clicking on the column heading you want to sort by.
You can open the Log Entry Details dialog box by double clicking a row in the table.
The Duration column shows how long each task takes to complete. To view the tasks that are taking the longest,
sort by this column.
For migration jobs that have been run using Migrator for Notes to SharePoint Designer or the Command Line, the
logs can be imported into the Console. This allows the jobs to be visible in the databases migration history tab.
See Importing Tasks on page 86 for details.
To open log files from prior jobs, you can select Open Log File from the File Menu.
Latest Log File will open the log from the last time a job was run and Recent Log Files allows you to choose
from a list of logs of the most recent run jobs.
Mapping options
In other words, everything you entered on the "Notes", "SharePoint" and "Map Data" tabs combine to make a Job
Definition.
For an ad-hoc data migration job, you never need to save Job Definitions to disk. However, there are several
reasons you might want to save a Job Definition:
To run the job using Command Line mode (for example, as part of a scheduled task)
125
A
Appendix: Reference Information
Parameters
Database - Path to the desired database, including the ".nsf" extension. Paths should typically be relative to the
Notes/Domino data directory, though full absolute paths can be used to access a local database.
As an alternative to specifying a database path in a connection string, developers can specify "$usermail" as an
alias for mail file of the current user. For example, a connection string may include the parameter
"database=$usermail". If a server is not specified in the connection string, then Migrator for Notes to SharePoint
will attempt to open the users mail file on their default mail server. If a server (or "server=local") is specified,
then Migrator for Notes to SharePoint will attempt to open the users mail file on the specified server first and
then fail over to the users default mail server.
ReplicaID - Replica ID of the database as a 16 digit hexadecimal number. If both the database and replicaid are
specified, multiple attempts to connect will be made before giving up.
Server - Name of server where desired database is located. This can be a short name or fully distinguished
hierarchical name. Use "local" or simply omit this parameter when connecting to local database.
AltServer - Name of alternate server to be tried if database cannot be opened at server. This can be a short
name or fully distinguished hierarchical name. Use "local" when connecting to a local database.
Dell Migrator for Notes to SharePoint 6.6
User Guide
126
ImpersonateName - The fully distinguished user name you wish to use to access databases, for example "Joe
Cool/Proposion" or "CN=Joe Cool/O=Acme". To enable impersonation for server databases, you need to edit the
server's Server document. In the Domino Directory, go to the Security section, and add the user name (from the
Notes ID that your .NET process will be using) to the "Trusted Servers" field. This requires Domino 6.0 or higher.
NameServer - Specifies which server to use for looking up users while validating user names and looking up the
current users mail file. If the "NameServer" parameter is not specified, the default server (where the current
database resides) will be used instead.
CacheSize - The number of records that will be loaded into memory at once by the data reader. This value will
not impact final results but could impact the memory footprint and performance. The default is 10.
Perform a partial migration job using the named XML data file as a
-defaultuser <username>: The If lookup mapping fails user mapping option is overridden
to be Substitute the default user, using the username that is passed as the default
user.
-filesfolder <>: When used, the attachments will be written to a separate "_Files"
folder rather than the default intermediate data file. The abbreviated -ff can be
used as well.
-formula <>: This argument allows whatever formula specified in the current job to be
overridden.
-view <>: This argument allows whatever view specified in the current job to be
overridden.
Dell Migrator for Notes to SharePoint 6.6
User Guide
127
Run a job:
NMSPCMD.exe -job "C:\temp\MigrateContacts.pmjob"
Import from an intermediate XML file and, whenever the automatic user mapping fails, substitute a
specific user.
NMSPCMD.exe -job "C:\temp\MigrateContacts.pmjob" -import "C:\temp\ContactData.xml" du
ACME\JoeUser
128
129
</SourceDefinition>
130
131
Here is an example of a Job Definition file. Notice that Job Definitions contain complete Source Data Definitions
and Target Data Definitions:
<?xml version="1.0" encoding="utf-8"?>
<TransferJob xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" Name="" Description=""
Version="4.0.0.0">
<QuerySource xsi:type="NotesQuerySource">
<ConnectionString>server='local'; database='OnDemandTechNotes.nsf';
zone=utc</ConnectionString>
</QuerySource>
<SourceDefinition Name="Document Library" Description="Standard Notes Document
Library" Templates="StdR6WebDocLib; StdR50WebDocLib" ListTypes="Document Library">
<QuerySpec xsi:type="NotesQuerySpec">
<From />
<Search />
<Formula />
<Column ColumnType="Item" Value="Categories" Alias="Category"
ReturnType="String" Option="Multi" />
<Column ColumnType="Item" Value="Date" ReturnType="Date" />
<Column ColumnType="Item" Value="DocType" ReturnType="String" />
<Column ColumnType="Item" Value="ExpireDate" ReturnType="Date" />
<Column ColumnType="Item" Value="From" ReturnType="String" />
<Column ColumnType="Item" Value="MainID" ReturnType="String" />
<Column ColumnType="Item" Value="ReviewerList" ReturnType="String"
Option="Multi" />
<Column ColumnType="Item" Value="ReviewerLog" ReturnType="String" />
<Column ColumnType="Item" Value="ReviewTime" ReturnType="Number" />
<Column ColumnType="Item" Value="ReviewType" ReturnType="String" />
<Column ColumnType="Item" Value="Status" Alias="StatusCode"
ReturnType="Number" />
<Column ColumnType="Formula" Value="@If(Status=1;'Submitted';Status=2;'In
Review';Status=3;'Approved';'')" Alias="Status" ReturnType="String" />
<Column ColumnType="Item" Value="Subject" ReturnType="String" />
<Column ColumnType="Item" Value="Body" Alias="BodyText" ReturnType="String" />
<Column ColumnType="RichText" Value="Body" Alias="BodyHtml" Option="Html" />
<Column ColumnType="RichText" Value="Body" Alias="BodyMime" Option="Mime" />
<Column ColumnType="Attachment" Value="Body" Alias="BodyAttachments"
Option="Multi" />
<Column ColumnType="Image" Value="Body" Alias="BodyImages" Option="Multi" />
</QuerySpec>
</SourceDefinition>
<SharePointConnection>
<Site>http://bunting</Site>
Dell Migrator for Notes to SharePoint 6.6
User Guide
132
<Web>/</Web>
<List>Tech Notes</List>
</SharePointConnection>
<SharePointTargetDefinition Name="Samples 101" Description="Definition for Samples
101" Templates="Custom List">
<IsDocLib>false</IsDocLib>
<IsDiscussion>false</IsDiscussion>
<IsEvents>false</IsEvents>
<AllowAttachments>true</AllowAttachments>
<Field Name="Title" Type="Text" NotesItems="Title;Subject" />
<Field Name="Category" Type="Text" NotesItems="Category" />
<Field Name="Body" Type="Note" NotesItems="BodyHtml" />
<Field Name="DocType" Type="Text" NotesItems="DocType" />
<Field Name="Attachments1" Type="Attachments" NotesItems="BodyAttachments" />
<Field Name="Attachments2" Type="Attachments" NotesItems="BodyImages" />
</SharePointTargetDefinition>
<JobOptions>
<AutoCreateList>true</AutoCreateList>
<AddListToQuickLaunch>true</AddListToQuickLaunch>
<AutoCreateFields>true</AutoCreateFields>
<PreserveIdentities>true</PreserveIdentities>
<QueryOptions xsi:type="NotesRuntimeQueryOptions">
<DeleteMigratedDocuments>false</DeleteMigratedDocuments>
<ExtractRecurrencePatterns>false</ExtractRecurrencePatterns>
<ExtractDocSecurity>false</ExtractDocSecurity>
</QueryOptions>
<UserMappingOptions>
<MappingFailureSubstitution>CurrentIdentity</MappingFailureSubstitution>
</UserMappingOptions>
<LinkConversionOptions />
</JobOptions>
<SecurityMapping Enabled="false">
<AccessLevelMappings>
<AccessLevelMapping NotesAccessLevel="Reader" SharePointPermissionLevel="Read"
/>
<AccessLevelMapping NotesAccessLevel="Author" SharePointPermissionLevel="Read"
/>
<AccessLevelMapping NotesAccessLevel="Editor"
SharePointPermissionLevel="Contribute" />
<AccessLevelMapping NotesAccessLevel="Designer"
SharePointPermissionLevel="Design" />
133
Column
Category
Description
Migration
Targets
Migration
Targets
Migration
Targets
ACL Map
Designer
Migration
Targets
Classification rules or
Manual Entry
134
Column
Category
Description
Migration
Targets
ACL Map
Manager
Migration
Targets
Migration
Targets
Active Users
Usage
Analysis
Usage
Analysis
Activity Custom
Reads
Usage
Analysis
Activity Custom
Uses
Usage
Analysis
Activity Custom
Writes
Usage
Analysis
The number or database writes in the activity logs Database Header scan
custom reporting days interval (for example, last
301 days).
Activity Day
Reads
Usage
Analysis
The number of database reads in the last 24 hours. Database Header scan
Activity Day
Uses
Usage
Analysis
Activity Day
Writes
Usage
Analysis
The number of database writes in the last 24 hours. Database Header scan
Activity Month
Reads
Usage
Analysis
Activity Month
Uses
Usage
Analysis
Activity Month
Writes
Usage
Analysis
Activity Week
Reads
Usage
Analysis
Activity Week
Uses
Usage
Analysis
Activity Week
Writes
Usage
Analysis
Agent Count
Design
Analysis
Design scan
Agent Delta
Design
Analysis
Design scan
Classification rules or
Manual Entry
135
Column
Category
Description
Analysis Priority
Migration
Status
Analysis
Responsible
Migration
Status
The user that is the responsible for conducting the Classification rules or
analysis of the database. This is set manually in the Manual Entry
Migration Status tab of the db properties sheet.
Application
Children
Application
Tree Node
Application
Name
Application
Tree Node
Application
Siblings
Application
Tree Node
Attachments
Count
Data Analysis
Data scan
w/Document Analysis
Attachments KB
Data Analysis
Data scan
w/Document Analysis
Author Count
Database
Access
Number of users or groups with Author access in the Database Header scan
database.
Average DEI
Complexity
Design scan
Base Effort
Analysis
Migration
Effort
Classification rules or
Manual Entry
Classification rules or
Manual Entry
Base Effort
Targets
Migration
Effort
Classification rules or
Manual Entry
Base Effort
Testing
Migration
Effort
Classification rules or
Manual Entry
Classification rules or
Manual Entry
Base Effort
Content
Migration
Effort
Classification rules or
Manual Entry
Blocked
Attachments
Count
Data Analysis
Classification rules or
Manual Entry
136
Column
Category
Description
Blocked
Attachments KB
Data Analysis
Business Class
Business Class
Locked
Classification Indicates if the Business Class value is locked which Set when data is
keeps a manual Business Class change from being
manually changed
over-ridden in future design scans.
Business Owner
Migration
Status
Classification rules or
Manual Entry
Business Owner
Locked
Migration
Status
Category
General
Complexity
Complexity
Complexity
Assigned
Complexity
Complexity
Locked
Complexity
Computed Data
Complexity
Complexity
Design scan
Computed
Design
Complexity
Complexity
Design scan
Computed
Incremental
Complexity
Complexity
Design scan
Content
Migrated
Migration
Status
Automatic setting or
Manual entry
Convert ACL
Groups
Migration
Targets
Convert ACL
Roles
Migration
Targets
137
Category
Description
Source of
Information
Creation Date
General
Database Discovery
Custom
Reporting Days
Usage
Analysis
Data Analyzed
Migration
Status
Automatic setting or
Manual entry
Data Analysis
Data scan
w/Document Analysis
Data Docs
Data Analysis
Database Key
General
Database Discovery
Classification rules or
Manual Entry
Database Script
Count
Design
Analysis
Design scan
Database Script
Delta
Design
Analysis
Design scan
Database Size
Data Analysis
Depositor Count
Database
Access
Automatic setting or
Manual entry
Design Docs
Design
Analysis
Data Scan
Design Element
Count
Design
Analysis
Design scan
Design Element
Delta
Design
Analysis
Design scan
Design Modified
Design
Analysis
Database Discovery
Designer Count
Database
Access
Disposition
Migration
Status
Classification rules or
Manual Entry
Disposition
Comments
Migration
Status
Manual Entry
138
Column
Category
Description
Disposition
Locked
Migration
Status
Doc Authors
Data Analysis
Data scan
w/Document Analysis
Docs With
Attachments
Data Analysis
Data scan
w/Document Analysis
Docs With
Children
Data Analysis
Data scan
w/Document Analysis
Docs With
Composite
Data Analysis
Data Analysis
Docs With
Encryption
Data Analysis
Data scan
w/Document Analysis
Data Analysis
Data scan
w/Document Analysis
Docs With
Images
Data Analysis
Data Analysis
Docs With
Objects
Data Analysis
Data scan
w/Document Analysis
Docs With
Readers
Data Analysis
Data scan
w/Document Analysis
Docs With
Signatures
Data Analysis
Data scan
w/Document Analysis
Docs With
Writers
Data Analysis
Data scan
w/Document Analysis
Editor Count
Database
Access
Number of users or groups with Editor access in the Database Header scan
database.
Effort Analysis
Migration
Effort
Classification rules or
Manual Entry
Effort Content
Migration
Effort
Classification rules or
Manual Entry
Effort Is
Incremental
Migration
Effort
Classification rules or
Manual Entry
Effort Jobs
Migration
Effort
Classification rules or
Manual Entry
Effort Locked
Migration
Effort
Effort Targets
Migration
Effort
Classification rules or
Manual Entry
139
Category
Description
Source of
Information
Effort Testing
Migration
Effort
Classification rules or
Manual Entry
Effort Total
Migration
Effort
Classification rules or
Manual Entry
Embedded
Forms
Design
Analysis
Design scan
Excluded
Element Count
Design
Analysis
Design scan
Excluded Users
Usage
Analysis
Excluded Users
All Replicas
Usage
Analysis
File Name
General
Database Discovery
File Path
General
Database Discovery
Folder
General
Database Discovery
Folder Count
Design
Analysis
Design scan
Folder Delta
Design
Analysis
Design scan
Form Count
Design
Analysis
Design scan
Form Delta
Design
Analysis
Design scan
Forms Used
Data Analysis
Is Template
General
Database Discovery
Jobs Assigned
Migration
Status
Automatic setting or
Manual entry
Jobs Finalized
Migration
Status
Manual Entry
Last Data
Analysis
Data Analysis
Last Design
Analysis
Design
Analysis
Design scan
Last Doc
Accessed
Usage
Analysis
Date a document was last accessed from within the Data scan
database.
w/Document Analysis
Last Doc
Created
Usage
Analysis
Data scan
w/Document Analysis
140
Category
Description
Source of
Information
Last Doc
Modified
Usage
Analysis
Data scan
w/Document Analysis
Last Usage
Analysis
Usage
Analysis
Last Used
Usage
Analysis
Database Header
scan, Data scan (if
needed)
Usage
Analysis
Database Header
scan, Data scan (if
needed)
Mail Description
General
Domino Directory
scan
Mail Domain
General
Domino Directory
scan
Mail Name
General
Domino Directory
scan
Mail Type
General
Manager Count
Database
Access
Migration
Targets
Max DEI
Complexity
Design scan
Migration Jobs
Count
Migration
Jobs
Classification rules or
Manual Entry
Migration Jobs
Locked
Migration
Jobs
Migration
Locked
Migration
Status
Migration
Priority
Migration
Status
Classification rules or
Manual Entry
Migration
Responsible
Migration
Status
The user that is the responsible for conducting the Classification rules or
migration of the database. This is set manually in
Manual Entry
the Migration Status tab of the db properties sheet.
Migration
Verified
Migration
Status
Modified Date
General
Discovery, Header
Scan, or Data Scan
141
Category
Source of
Information
Description
Number of users or groups explicitly denied access
to the database.
Oversized
Attachments
Count
Data Analysis
Data scan
w/Document Analysis
Oversized
Attachments KB
Data Analysis
Data scan
w/Document Analysis
Page Count
Design
Analysis
Design scan
Page Delta
Design
Analysis
Design scan
Profile Docs
Data Analysis
Reader Count
Database
Access
Recording
Activity
Usage
Analysis
Replica
General
Replica Count
General
Database Discovery
Script Library
Count
Design
Analysis
Design scan
Script Library
Delta
Design
Analysis
Server
General
Site Group
Prefix
Migration
Targets
Style Sheet
Count
Design
Analysis
Design scan
Style Sheet
Delta
Design
Analysis
Design scan
Subform Count
Design
Analysis
Design scan
Subform Delta
Design
Analysis
Design scan
Target Site
Migration
Targets
The Url of the SharePoint site you intend to migrate Classification rules or
to. This target site will override the site that may Manual Entry
be specified in the individual migration jobs.
Target Site
Locked
Migration
Targets
Database Discovery
142
Column
Category
Description
Targets
Finalized
Migration
Status
Manual Entry
Targets
Identified
Migration
Status
Automatic setting or
Manual entry
Targets
Provisioned
Migration
Status
Automatic setting or
Manual entry
Technical Class
Technical Class
Comments
Technical Class
Locked
Template
General
Database Discovery
Template
Database Key
General
Template
General
Database Locked
Template Match
Design
Analysis
Design scan
Title
General
Uri
General
Database Discovery
Use Security
Groups
Migration
Targets
Classification rules or
Manual Entry
View Count
Design
Analysis
Design scan
View Delta
Design
Analysis
Design scan
143
Value Type
Description
DB_FilePath
String
DB_FileName
String
DB_Server
String
DB_TemplateBase
String
DB_IsTemplate
Boolean
DB_Category
String
DB_ModifiedDate
DateTime
DB_DatabaseSize
Int64
DB_DesignDocs
Int64
DB_ActivityDayWrites
Int64
DB_ActivityWeekReads Int64
DB_ActivityWeekUses
Int64
DB_ActivityMonthWrite Int64
s
DB_ActivityCustomRea Int64
ds
Number of times this database was Read from over the custom
timespan defined in DB_CustomReportingDays
DB_ActivityCustomUse Int64
s
DB_ManagerCount
Int32
DB_EditorCount
Int32
DB_ReaderCount
Int32
DB_NoAccessCount
Int32
DB_TechnicalClassLock Boolean
ed
DB_BusinessClassName String
DB_DatabaseOwner
String
DB_BusinessOwner
String
DB_AnalysisPriority
Int32
DB_AnalysisLocked
Boolean
DB_MigrationResponsib String
le
DB_Disposition
String
144
String
Disposition comments.
DB_DesignAnalyzed
Boolean
DB_TargetsIdentified
Boolean
DB_TargetsFinalized
Boolean
DB_JobsFinalized
Boolean
True if the jobs have been finalized and ready for migration
DB_MigrationVerified
Boolean
DB_TargetSiteLocked
Boolean
DB_MapACLGroups
Boolean
DB_SiteGroupPrefix
String
DB_AccessLevelMappin String
gReader
DB_AccessLevelMappin String
gEditor
DB_AccessLevelMappin String
gManager
DB_AccessLevelMappin String
gCanDelete
DB_MigrationJobsLock
ed
Boolean
DB_ApplicationGroup
String
DB_ApplicationSiblings Int32
DB_ComputedDataCom Int32
plexity
DB_ComputedIncreme
ntalComplexity
Int32
DB_MaxDEI
Int32
Max DEI
DB_ComplexityLocked
Boolean
DB_DesignElementCou
nt
Int32
DB_FormCount
Int32
DB_ViewCount
Int32
Number of views
DB_SubformCount
Int32
DB_ScriptLibraryCount Int32
DB_StyleSheetCount
Int32
DB_DesignElementDelt Int32
aCount
DB_ViewDeltaCount
Int32
DB_SubformDeltaCoun Int32
t
DB_ScriptLibraryDelta
Count
Int32
DB_StyleSheetDeltaCo
unt
Int32
DB_TemplateMatch
Int32
145
Boolean
DB_TemplateDatabase
Locked
Boolean
DB_EffortIsIncrementa Boolean
l
DB_EffortTargets
Int32
DB_EffortContent
Int32
DB_EffortTotal
Int32
DB_BaseEffortTargets
Int32
DB_BaseEffortContent
Int32
DB_BaseEffortTotal
Int32
DB_HasDatabaseActivit Boolean
yDetail
DB_DataDocSize
Int64
DB_LastDocModified
DateTime
DB_DocsWithReaders
Int32
DB_DocsWithChildren
Int32
DB_DocsWithImages
Int32
DB_DocsWithMime
Int32
DB_DocsWithSignature Int32
s
DB_FormsUsed
Int32
DB_LastDataAnalysis
DateTime
DB_CatalogDate
DateTime
TasksReportTable
This Data Table provides a row for each entry in the Task History. This table contains no joined database fields.
The prefix for Task Record specific fields is: "TSK_".
DbTasksReportTable
This Data Table joins all Task History Records with Database Records and produces data only for Tasks associated
with a Notes Database. The prefix for Task Record specific fields is: "TSK_" and Database specific fields are
prefixed: "DB_".
Table 58. DbTasksReportTable
Column
Value Type
Description
TSK_StartDateTime
DateTime
TSK_Status
String
TSK_StatusDetails
String
TSK_Description
String
146
TSK_TargetPath
String
TSK_RecordsProcess Int32
ed
TSK_Errors
Int32
String
String
TSK_LogXml
TSK_RunBy
TSK_CatalogUnid
String
DbUserAclsReportTable
Joins User ACL information with each Database record to produce a unique database row for each User or group
specified in the database's ACL list. User access level fields are prefixed: "ACL_" and database specific fields
are prefixed "DB_".
Table 59. DbUserAclsReportTable
Column
Value Type
Description
ACL_IsDesigner
Boolean
ACL_IsAuthor
Boolean
ACL_IsDepositor
Boolean
DbUserActivityReportTable
Joins User Activity Summary information with each Database record to produce a unique database row for each
User or group where activity information has been recorded. Database Activity Summary fields are prefixed:
"DAS_" and database specific fields are prefixed "DB_".
Table 60. DBUserActivityReportTable
Column
Value Type
Description
DAS_ReadCount
Int64
Number of Reads.
DAS_UseCount
Int64
Number of Uses.
DbJobReportTable
Joins Assigned Job information with each Database record to produce a unique database row for each database
migration job. Database Migration Job fields are prefixed: "JOB_" and database specific fields are prefixed
"DB_".
Table 61. DbJobReportTable
Column
Value Type
JOB_SiteUri
String
JOB_Summary
String
JOB_UpdatesQui Boolean
ckLaunch
Description
147
DbDesignElementReportTable
Joins Database Design Elements with Database records to produce a unique database row for each database
design element in the database. Design Element fields are prefixed: "DE_" and database specific fields are
prefixed "DB_".
Table 62. DbDesignElementReportTable
Column
Value Type
Description
DE_Title
String
DE_DesignerVers Double
ion
Designer Version
DE_Unid
String
Unique Notes ID
DE_IsNotesOnly
Boolean
DE_Modified
DateTime
DbDesignElementDifferencesReportTable
Joins Database Design Element comparison records with Database records to produce a unique database row for
each design element difference detected in the database. Design Element Differences are the result of
comparing each database's design against the design of some specified Reference database. Design Element
Difference fields are prefixed: "DED_". Fields from the Target Database Design Element are prefixed: "TDE_".
Fields from the Reference Database Design Element are prefixed: "RDE_" and database specific fields are
prefixed "DB_".
Table 63. DbDesignElementDifferencesReportTable
Column
Value Type
Description
DED_Type
String
DED_IsStandard
Boolean
DED_Language
String
DED_IsWebOnly
Boolean
DED_IsExcluded
Boolean
TDE_Language
String
TDE_IsWebOnly
Boolean
TDE_IsExcluded
Boolean
RDE_IsStandard
Boolean
RDE_Language
String
RDE_IsWebOnly
Boolean
RDE_IsExcluded
Boolean
148
DbAnalysisByAuthorReportTable
Document Summary counts are created for each Author and are stored in Data Tally fields. This report table
joins Data Tally field information for Authors with each Database record to produce a unique database specific
rows for each author. Author Data Tally fields are prefixed: "DTR_" and database specific fields are prefixed
"DB_".
DbAnalysisByFormsReportTable
Document Summary counts are created for each Form and are stored in Data Tally fields. This report table
joins Data Tally field information for Forms with each Database record to produce a unique database specific
rows for each form used. Form Data Tally fields are prefixed: "DTR_" and database specific fields are prefixed
"DB_".
Table 64. DbAnalysisByFormsReportTable
Column
Value Type
Description
DTR_Count
Int64
DTR_LastDocCreated
DateTime
DTR_LastDocAccessed
DateTime
DTR_DocsWithWriters
Int32
DTR_DocsWithAttachments
Int32
DTR_DocsWithObjects
Int32
DTR_DocsWithComposite
Int32
DTR_DocsWithEncryption
Int32
DTR_DocsWithForm
Int32
149
About Dell
Dell listens to customers and delivers worldwide innovative technology, business solutions and services they
trust and value. For more information, visit www.software.dell.com.
Contacting Dell
For sales or other inquiries, visit http://software.dell.com/company/contact-us.aspx or call 1-949-754-8000.
150