This chapter describes how to configure Tzunami Deployer settings and covers the following topics:

  • Rule Engine
  • Tzunami Deployer Options

 

Rule Engine

Deployer Rule Engine is a powerful Deployer component that enables you to automate large parts of the deployment process by creating flowcharts of If-Then statements in a rules editor.

A Rule consists of a set of conditions (logical IFs) and Actions (logical THENs). If all conditions are fully met, then the Actions are executed. A Rule Set is a set of rules that define deployment options for a specific Enterprise Content Management (ECM) system.

The Deployer Rule Engine is intended for power users, System Integrators, and Tzunami Deployer specialists. It provides you with a high degree of freedom in regard to the business logic you can create.

The order of the Rules in a Rule Set is important. The Rule Engine processes each container item in the deployed item, evaluating the Rules one after the other against each item. If even one Condition is not met, the Rule is ignored, and the Rule Engine proceeds to the next Rule. If all Conditions are met, the Actions are performed, and the Rule Engine continues handling the next item. No other rule is evaluated for that item. As a result, even if two Rules are valid for a certain item, only the first Rule is evaluated and performed.

The Rule Sets Editor contains several built-in default Rule Sets that define some common deployment logic schemas. You can customize these default Rule Sets to suit your specific deployment needs.

Configuring Rule Engine

You can choose whether to involve the Rule Engine in the deployment process. Tzunami recommends that you start working with Tzunami Deployer without the Rule Engine. After you are familiar with Tzunami Deployer’s behavior and features, you can create a new Rule Set and enable the Rule Engine to generate suggestions.

To set the Rule Engine interaction level

  1. Select Tools > Options. The Options window appears.
  2. Select the Rule Engine tab. The Options window displays the Rule Engine tab.
  3. Select one of the following levels of interaction:
  • Don’t use Rule Engine – The Rule Engine does not take part in the deployment process.
  • Rule Engine provides options – The Rule Engine generates suggestions for the deployment process. The deployment wizard is displayed to the user to validate and acknowledge the options.

4. Click OK.

The Rule Engine interaction level is set.

Opening the Rule Sets

To open the Rule Sets Editor:

  • Select Tools > Deployment Rules.

Or

Press F8.

The Rule Sets Editor appears.

 

Figure 67: Rule Sets Editor

Specifying Rule Set Location

Rule Sets are saved on the file system. The location of each Rule Set must be specified in the Rule Engine.

To specify the locations of Rule Sets:


    1. Select Tools > Options > Rule Engine.

      Tzunami Deployer - Options window appears, displaying the locations in center of the screen.


      Figure 68: Options Window

    2. Click Add and browse to the location of the Rule Set.

      Or Enter the location in a new line in the Locations area.

    3. Select Rule Set and click OK.

 

You can use two special variables in the definition of the location:

@DEPLOYER@ – denotes the Tzunami Deployer installation folder.

@PROJECT@ – denotes the currently open Tzunami Deployer project.

You can delete a location by highlighting the relevant text in the Location area, and deleting it.

 

You can specify that the location of a new Rule Set be automatically added to the list of locations, by clicking Add location to list of rules set locations when you define a new Rule Set (Figure 69).

Rule Sets Editor

You can create multiple Rule Sets for each ECM system. However, at any given time, only one Rule Set can be used during the deployment process. For more information about “Rule Set” see Rule Engine on page 5-132.

To set which Rule Set to use during the deployment process:

  1. Select Tools > Options in the menu. The Options window appears, displaying the existing Rule Sets in the bottom half of the screen (Figure 69).
  2. Select the Rule Set for the ECM to use during the deployment.

 

Creating a New Rule Set

To create a Rule Set:

  • In the Rule Sets Editor (Figure 67), click New Rules set. The New Deployment Rules Set Form appears.

 

Figure 69: New Deployment Rules Set Form

 

  • Enter the following information for the new Rule Set and click OK.

Table 15: New Deployment Rule Set Form Fields

Field

Description

Rules Set Name

Specify a name for the Rule Set.

Type

Select the type of source ECM the Rule Set applies to from the drop-down list.

Filename

Specify where to save the Rule set file.

Add location to list of rules set locations

Select this option if you wish to display the file location in the Locations pane in the Options window (Figure 68).

 

 

If the Rule Set you are creating is very similar to an existing Rule Set, you can duplicate the existing Rule Set and edit its rules. For more information, seeCopying a Rule Set on page 5-96.

 

Copying a Rule Set

To copy a Rule Set:

When you duplicate a Rule Set, it appears with the same name as the original Rule Set, followed by - Copy.

  1. Select Tools > Deployment Rules. The Rule Sets Editor appears.
  2. In the Rule Set Editor toolbar, click Copy.

 

Creating a Rule in a Rule Set

To create a rule in a Rule Set:

1. Click New in the Rules toolbar. The Rule Editor window appears.

 

Figure 70: Rule Editor Window – General Tab

2. In the General tab enter the following information:

Table 16: Rule Editor, General tab – Description of Fields

Field

Description

Title

Enter a name for the rule.

Description

Enter a description for the rule.

Enabled

Select if you want this rule to be processed as part of the Rule Set.

 3. Click the Conditions tab and define the condition(s):

a. Click New. The Conditions Selector window appears, listing all available conditions.

 

These conditions may differ depending on the type of ECM system you specified in the Type field of the Rule Set.

Figure 71: Conditions Selector Window

b. Select the Condition(s) you wish to add and click OK. Each Condition is displayed both in the top pane and the bottom pane. The Condition’s variables are marked in blue and underlined.

Figure 72: Rule Editor Window – Conditions Tab

c. In the bottom pane, select a value for each variable by clicking the variable, and entering or selecting a value. For information about the values to enter or select, see Defining Conditions on page 5-100.

 

If you do not select a value, the rule is considered incomplete, and will not be processed.

 4. Click the Actions tab and define the action(s):

a. Click New. The Actions Selector window appears, listing all available actions. Note that these conditions may differ depending on the type of ECM system you specified in the Type field of the Rule Set.

Figure 73: Actions Selector Window

 

b. Select the Actions you wish to add and click OK. Each Action is displayed both in the top pane and the bottom pane. The Action’s variables are marked in blue and underlined.

Figure 74: Rule Editor Window – Actions Tab

c. In the bottom pane, select a value for each variable by clicking the variable, and entering or selecting a value. For information about the values to enter or select, see Defining Actions on page 5-109.

 

If you do not select a value, the rule is considered incomplete, and will not be processed.

Copying and modifying a Rule in a Rule Set

This option is useful if you wish to create a rule that is similar to an existing one. Instead of creating a new rule from scratch, you can first copy the existing rule, and then edit it.

 

To copy a rule in a Rule Set:

  1. Select the rule you wish to duplicate.
  2. Click Copy in the Rule toolbar. The Rule Editor window appears, displaying the new rule.

You can now edit the information in the General, Conditions, and Actions tabs of the rule, as described in Creating a Rule in a Rule Set on page 5-97.

 

To edit a rule in a Rule Set:

  1. Select the rule you wish to edit.
  2. Click Edit in the Rule toolbar.

Or Double-click the rule.

The Rule Editor window appears, displaying the selected rule.

You can now edit the information in the General, Conditions, and Actions tabs of the rule, as described in Creating a Rule in a Rule Set on page 5-97.

 

Defining Conditions

This section provides descriptions of the various Conditions you can define. Each description includes the relevant variables, as well as general remarks, if applicable.

 

If you specify multiple Conditions in a rule, Tzunami Deployer arranges them in the order in which they will be evaluated. You cannot change this order.

If you define contradicting Conditions in a Rule, the Rule will never be executed, because there will never be a case when all Conditions are met.

You can define a Rule with no conditions. This rule will apply to all items. However, note that only this rule will be executed. This rule is useful with theExecute the following Rules <Rules> action. For more information, see Execute the following Rules <Rules> on page 5-120.

 

Parent is of type <Parent Type>

Check if the designated (new) parent of the item is of a certain type.

Variables

Variable

Description

<Parent Type>

The type of the designated parent. The type can be one of the following values:

  • Web Application
  • Site Collection
  • Sub Site
  • Area – The Portal Area used in a SharePoint 2003 Server
  • Site – Automatically adjust between Root site, WSS, or Area
  • Document Library
  • Image Library
  • List – A list of any type, including Document Library and Image Library
  • Folder/List. Note that lists are also recognized as folders
  • Area Listing – The List used in a SharePoint 2003 Server

 

Items is at level <Level> of parent <Parent Type>

Check if the Items hierarchy is at same level of designated parent type items.

Variables

Variable                       

Description

<Level>

The value (or values) to search for in the item.

<Parent Type>

The type of the designated parent. The type can be one of the following values:

  • Web Application.
  • Site Collection.
  • Sub Site.
  • Area – The Portal Area used in a SharePoint 2003 Server.
  • Site – Automatically adjust between Root site, WSS, or Area.
  • Document Library.
  • Image Library.
  • List – A list of any type, including Document Library and Image Library
  • Folder/List. Note that lists are also recognized as folders
  • Area Listing – The List used in a SharePoint 2003 Server

 

Source Parent is of type <Source Type>

Checks the source type of the parent of current item

 

Variables

Variable

Description

<Source Type>

The type of the designated parent. The type can be one of the following values:

  • Web Application
  • Site Collection
  • Sub Site
  • Area – The Portal Area used in a SharePoint 2003 Server
  • Site – Automatically adjust between Root site, WSS, or Area
  • Document Library
  • Image Library
  • List – A list of any type, including Document Library and Image Library
  • Folder/List. Note that lists are also recognized as folders
  • Area Listing – The List used in a SharePoint 2003 Server

 

Remarks

This condition is only available if you specified SharePoint 2003, SharePoint 2007, SharePoint 2010 and SharePoint 2013 in the Type field of the Rule Set.

 

 

Source is of type <Source Type>

Checks the source type of the current item

Variables

Variable

Description

<Source Type>

The type of source. The type can be one of the following values:

  • Web Application
  • Site Collection
  • Sub Site
  • Area – The Portal Area used in a SharePoint 2003 Server
  • Site – Automatically adjust between Root site, WSS, or Area
  • Document Library
  • Image Library
  • List – A list of any type, including Document Library and Image Library
  • Folder/List. Note that lists are also recognized as folders
  • Area Listing – The List used in a SharePoint 2003 Server

Remarks             

This condition is only available if you specified SharePoint 2003, SharePoint 2007, SharePoint 2010 or SharePoint 2013 in the Type field of the Rule Set.

 

Source Server Template is <Server Template>

Check if the source list is based on a specific list definition type (server template).

Variables

Variable                

Description

<Server Template>

Server template ID of the source list. In MOSS/WSS3.0 it is also referred to as Base Template. This can be one or several of the values in Table 16, or any custom Server Template ID.

Table 17: Standard Template IDs

ID

Template Name

ID

Template Name

0

No List Template

202

Meeting Attendees List

100

Generic List

204

Decision

101

Document Library

204

Meeting Decisions List

102

Survey

207

Meeting Objective

103

Links

207

Meeting Objectives List

104

Announcements

210

Text Box

105

Contacts

210

Meeting Text Box

106

Events

211

Things To Bring

107

Tasks

211

Meeting Things To Bring List

108

Discussion Board

212

Home Page Library

109

Picture Library

212

Meeting Workspace Pages List

110

Data Sources

300

Portal Sites List

111

Web Template Catalog

301

Posts

112

User Information

302

Comments

113

Web Part Catalog

303

Categories

114

List Template Catalog

402

Facility

115

XML Form

403

Whereabouts

116

Master Page Catalog

404

Call Track

117

No Code Workflows

405

Circulation

118

Workflow Process

420

Timecard

119

Web Page Library

421

Holidays

120

Custom Grid

499

IMEDic

121

Solution Catalog

600

External List

122

No Code Public

850

Publishing Page Library

130

Data Connection Library

1100

Issue Tracking

140

Workflow History

1200

Admin Tasks

150

Gantt Tasks

1220

Health Rule

200

Meetings

1221

Health Reports

200

Meeting Series List

1301

Translation Lists

200

Area Document Library

2002

Personal Document Library

201

Agenda

2003

Private Document Library

201

Meeting Agenda List

-1

Invalid Type

202

Meeting User

 

 

 

 Remarks

  • You can enter any custom Server Template ID in order to support customized lists.
  • This condition is only available if you specified SharePoint 2003, SharePoint 2007, SharePoint 2010 or SharePoint 2013 in the Type field of the Rule Set.

 

Source Item is a Document Workspace

Check if the source item is a document workspace

 

Expected target parent is a Meeting Workspace

Check if the expected target parent is a Meeting Workspace.

 

Source item is a Meeting Workspace

Check if the source item is a meeting workspace

 

Source parent item's <'Property Name'> property equals <Values>

Checks if the value of the current item’s source parent item property equal certain value.

Variables

Variable

Description

<Property Name>

The display name of the property (case sensitive).

<Value>

The value (or values) to search for in the item.

 

Remarks

If property name is entered in <Property Name>, then the Condition is true only if the value matches the current items source parent property name.

 

 

Number of subitems <Great/Equals/Less than> <Number> <not including items under sub-containers> and <count sub-containers as items>

Check if the number of sub items of item is greater than/equals to/ less than the total number of sub-containers as items excluding item under sub-container.

 

Variables

Variable

Description

<Great/Equals/Less than >

The type of the Operators. The type can be one of the following values:

  • Greater Than
  • Equal
  • Less Than

< Number>

The value (or values) to search for in the item.

<not including items under sub-containers>

  • Including items under sub-containers (recursively) – Select number of sub-items under sub-containers (recursively)
  • Not including items under sub-containers – Do not select the number of sub-items under sub-containers 

<count sub-containers as items>

  • Count sub-containers as items – Count number of sub-items in sub-containers as items
  • Do not count sub-containers as items– Do not Count number of sub-items in sub-containers.

 

Source Item’s <Property Name> property equals <Value>

Checks the value of the source item’s property

Variables

Variable

Description

<Property Name>

The display name of the property (case sensitive).

<Value>

The value (or values) to search for in the item.

 

Remarks

If property name is entered in <Property Name>, then the Condition is true only if the value matches the current items property name.

 

Container <is/is not empty>

Check if the container is empty or not.

Variables

Variable

Description

is

A keyword indicating that the container does not have items

Is not empty

A keyword indicating that the container has items

 

Source item's <'Property Name'> property contain <'Value'>

Check if the source item’s property name contains a value.

Variables

Variable

Description

<Property Name>

The display name of the property (case sensitive).

<Value>

The value (or values) to search for in the item.

 

Source item's children have <all> of the properties <Values>

Check if the children of the current item have certain property value.

Variables

Variable

Description

<all>

The display all or any value of the property

<Values>

The value (or values) to search for in the item.

 

Parent Deployment option <Property Name> equals <Value>

Check if the deployment option of the current item’s parent property has a certain value.

Variables

Variable

Description

<Property Name>

The deployment option property to check. This can be one of the following values, described in Defining the Deployment Structureon page 4-65 :

  • Invalid
  • Description
  • Language Id
  • Language Name
  • List Template Name
  • List Template Server template
  • List Template Base type
  • URL
  • Owner login name
  • Owner display name
  • Site Template name
  • Title
  • Deploy Files
  • Deploy Hierarchy
  • Flat Deploy

<Value>

The value to search for in the deployment options of the item.

Deployment option <Property Name> equals <Value>

Check if the deployment option of the current item property has a certain value.

Variables

Variable

Description

<Property Name>

The deployment option property to check. This can be one of the following values, described in Defining the Deployment Structure on page 4-65:

  • Invalid
  • Description
  • Language Id
  • Language Name
  • List Template Name
  • List Template Server template
  • List Template Base type
  • URL
  • Owner login name
  • Owner display name
  • Site Template name
  • Title
  • Deploy Files
  • Deploy Hierarchy
  • Flat Deploy

Value

The value to search for in the deployment options of the item.

 

Source Item {Does | Does not have} unique permissions

Checks if a source item has unique permissions or it inherited/has the same permissions as the parent.

Parameters

Parameter

Description

Does

A keyword indicating that the source item has unique permissions.

Does not have

A keyword indicating that the source item does not have unique permissions.

 

Any of the subitems' <'Property Name'> property equal <Values> (Do not look recursively in sub-containers)

Check if property of sub-item of item has certain property values but don’t look recursively in sub-containers of item

 

Parameter

Parameter

Description

All

The display any or all properties

Value

The value to search for in the deployment options of the item.

(Do not look recursively in sub-containers)

  • Look recursively in sub-containers
  • Do not look recursively in sub-containers

 

All sub-items’ <Property Name> property equals <Value> (using <flags>)

Check if the property of all sub-items of item has certain value using the provided flag.

Variables

Variable

Description

<Property Name>

The display name of the property (case sensitive).

<Value>

The value (or values) to search for in the item.

<flags>

  • Consider folders – Selecting this flag will consider subfolder of folder containing subfolders and items.
  • Look recursive – Selecting this flag will recursively look for items or folders in containers.
  • Accept empty containers– Selecting this flag will accept empty containers
  • Ignore already deployed items– Selecting this flag will help to ignore which is already deployed.

 

Remarks

  • If a property name of each sub-items of item is entered in <Property Name>, then the Condition is true only if the values of all sub-items of item include value defined in the Condition using the flag.
  • This Condition will also check the items and files of the currently checked container.

 

 

Defining Actions

This section provides descriptions of the various Actions you can define. Each description includes the relevant variables, as well as general remarks if applicable.

 

If you specify multiple Actions in a rule, Tzunami Deployer arranges them in the order in which they will be evaluated. You cannot change this order.

If you define illogical combinations of Actions; the Actions are performed in the order determined by Tzunami Deployer, and invalid Actions are ignored.

 

Deploy as <Type>

Sets the deployment options to deploy as a certain type

Variables

Variable

Description

<Type>

The type to deploy as. This can be one of the following values:

  • Web Application
  • Site Collection
  • Sub Site
  • Area – The Portal Area used in a SharePoint 2003 Server
  • Site  – Automatically adjust between Root site, WSS, or Area
  • Document Library
  • Image Library
  • List – A list of any type, including Document Library and Image Library
  • Folder/List. Note that lists are also recognized as folders
  • Do not Deploy – Using during the deployment process
  • Area Listing - The List used in a SharePoint 2003 Server

 

Set <Deploy Option> to <Value>

Sets a deploy option to a certain value.

Variables

Variable

Description

<Deploy Option>

The name of the deployment option. This can be one of the following values, described in Defining the Deployment Structureon page 4-65.

  • Invalid
  • Description
  • Language Id
  • Language Name
  • Title
  • Deploy Files
  • Deploy Hierarchy
  • Flat Deploy
  • Enable Quick Launch
  • Inherit Navigation
  • On Top Navigation bar

Value

The value to set for the deployment option.

 

Set the best-matching workspace template

When an item is deployed as a site, this action matches the template of the deployed site to best matching available site templates.

 

Set Template to <Site Template>

When an item is deployed as a site, this action sets the site template to a certain template.

Variables

Variable

Description

<Site Template>

The name of the site template. For example: Team Site, Blank Site, and so on.

 

Remarks

This Action is valid only when an item is deployed as a site.

 

Set Template using the following <mapping>

When an item is deployed as a site, this action sets the site template according to the specified site mapping.

Variables

Variable

Description

<Mapping>

A mapping of source templates to target templates. See Table 18and Table 19 for a list of standard source template IDs and standard target template Name#IDs.

 

Table 18: Standard source values (Template base type IDs)

ID

Template Name

Description

1

STS

Template for Team Site, Blank site and Document workspace

2

MPS

Meeting Workspaces Template

3

CENTRALADMIN

Central Admin Site

4

WIKI

Wiki Site

9

BLOG

Blog

20

SPS

SharePoint Portal Server Site (Obsolete)

21

SPSPERS

SharePoint Portal Server Personal Space

22

SPSMSITE

Personalization Site

30

SPSTOC

Contents area Template (Obsolete)

31

SPSTOPIC

Topic area template (Obsolete)

32

SPSNEWS

News Site Template (Obsolete)

33

SPSNHOME

News Site Template

34

SPSSITES

Site Directory

36

SPSCOMMU

Community area template

38

SPSREPORTCENTER

Report Center

39

CMSPUBLISHING

Publishing Site

47

SPSPORTAL

Collaboration Portal

50

SRCHCEN

Search Center with Tabs

51

PROFILES

Profiles

52

BLANKINTERNETCONTAINER

Publishing Portal

53

BLANKINTERNET

Publishing site Template

54

SPSMSITEHOST

My Site Host

 

Table 19: Standard target values (Template name#Configuration ID)

Template Name#ConfigurationID

Title

STS#0

Team Site

STS#1

Blank Site

STS#2

Document Workspace

MPS#0

Basic Meeting Workspace

MPS#1

Blank Meeting Workspace

MPS#2

Decision Meeting Workspace

MPS#3

Social Meeting Workspace

MPS#4

Multipage Meeting Workspace

CENTRALADMIN#0

Central Admin Site

WIKI#0

Wiki Site

BLOG#0

Blog

SPS#0

SharePoint Portal Server Site (this template is obsolete)

SPSPERS#0

SharePoint Portal Server Personal Space

SPSMSITE#0

Personalization Site

SPSTOC#0

Contents area Template (this template is obsolete)

SPSTOPIC#0

Topic area template (this template is obsolete)

SPSNEWS#0

News Site (this template is obsolete)

SPSNHOME#0

News Site

SPSSITES#0

Site Directory

SPSCOMMU#0

Community area template (this template is obsolete)

SPSREPORTCENTER#0

Report Center

CMSPUBLISHING#0

Publishing Site

SPSPORTAL#0

Collaboration Portal

SRCHCEN#0

Search Center with Tabs

PROFILES#0

Profiles

BLANKINTERNETCONTAINER#0

Publishing Portal

BLANKINTERNET#0

Publishing Site

BLANKINTERNET#1

Press Releases Site

BLANKINTERNET#2

Publishing Site with Workflow

SPSMSITEHOST#0

My Site Host

 

Remarks

  • This Action is valid only when an item is deployed as a site.
  • This Action is available only if you specified SharePoint 2003, SharePoint 2007, SharePoint 2010 or SharePoint 2013 in the Type field of the Rule Set.

 

 

 

 

  • In the Rule Sets Editor, the following window appears for defining the mapping:

 

Figure 75: Site Template Mapping Editor Window

  •  Enter a source template ID in the left hand field under Add mapping entries, and enter a target template Name#ID in the right hand field under Add mapping entries. Click Add to add this entry to the list of source and target values.
  • The source value “%OTHER%” can be used as a placeholder, signifying “any other template”. This can be used as a default mapping, instead of defining mappings for all source options.
 
 
 
Use List Template having server template <Server Template>ID

When an item is deployed as a list, this action sets the List Template based on a Server Template ID.

Variables

Variable

Description

<Server Template>

The server template ID. You can enter a standard template ID (seeTable 17 for a list of standard template IDs), or any custom Server Template ID.

 

Remarks

  • You can enter any supported Server Template ID, in order to support lists and libraries.
  • This Action is valid only when item is deployed as a list.
  • This Action is based on the SharePoint recommendation, in which each list template has a unique Server Template ID.

 

Use List Template <Server Template Name>

When an item is deployed as a list, this action sets the List Template based on the list template’s Name.


 

Variables

Variable

Description

<Server Template Name>

The server template Name. You can enter a standard template name (such as Document Library, Contacts, and so on, see Table 17 for a list of standard template IDs) or any custom Server Template name.

 

Remarks

You can enter any supported Server Template Name, in order to support lists or libraries.

 

Set List Template using the following <mapping>

While an item is deployed as a list, this action maps template ID number from source to target according to the specified list template mapping.

Variables

Variable

Description

<mapping>

A mapping of source template IDs to target template IDs. You can enter standard source and target template IDs (see Table 17 for a list of standard source and target template IDs), or any custom Server Template ID.

 

Remarks

  • This Action is available only if you specified SharePoint 2003, SharePoint 2007, SharePoint 2010 or SharePoint 2013 in the Type field of the Rule Set.
  • In the Rule Sets Editor, the following window appears for defining a mapping:

 

Figure 76: List Template Mapping Editor Window

  • Enter a source list template ID in the left hand field under Add mapping entries, and a target list template ID in the right hand field under Add mapping entries.
  • Click Use Existing to specify that if the site template includes this list type, it will be used and set true to existing column.
  • Click Add to add this entry to the list of source and target values.

 

Set List Template using the following <mapping> (automatic)

While an item is deployed as a list, this action automatically maps template ID number from source to target according to the specified list template mapping.

Variables

Variable

Description

<mapping>

A mapping of source template IDs to target template IDs. You can enter standard source and target template IDs (see Table 17 for a list of standard source and target template IDs), or any custom Server Template ID.

 

Remarks

  • This Action is available only if you specified SharePoint 2003, SharePoint 2007 SharePoint 2010 or SharePoint 2013 in the Type field of the Rule Set.
  • In the Rule Sets Editor, the following window appears for defining a mapping:

 

Figure 77: List Template Mapping Editor Window

  • Enter a source list template ID in the left hand field under Add mapping entries, and a target list template ID in the right hand field under Add mapping entries.
  • Click Add to add this entry to the list of source and target values.
 
 
 
Use <property mapping file> and <add required target properties>

Sets an XML document as the property mapping to be used for the item, and specifies whether to add required target properties.

Variables

Variable

Description

<mapping>

The path to on XML file that defines the property mapping. SeeSample Property Mapping XML Fileon page 5-116.

Add required target properties|
Don’t add required target properties

Required target properties are the properties that are required in the target item but are not present in property mapping XML file.

Use these keywords to specify whether to add missing properties to the target.

 

Sample Property Mapping XML File

<PropertyMapping SourceSet=“Tasks Column Set” TargetSet=“Tasks Column Set 2”>

  <Pair>

    <Source DisplayName=“Created” Name=“Created”

            PropertyType=“DateTime” />

    <Target DisplayName=“Created” Name=“Created Date”

            PropertyType=“DateTime” />

  </Pair>

  <Pair>

    <Source DisplayName=“Approval Status” Name=“_ModerationStatus”

            PropertyType=“ModStat” />

    <Target DisplayName=“Approval Status” Name=“_ModerationStatus”

            PropertyType=“ModStat” />

  </Pair>

  <Pair>

    <Source DisplayName=“Name” Name=“D996E646-5C05-45b7-B24A-9AFAF5B21503”

            PropertyType=“Text” />

    <Target DisplayName=“Name” Name=“D996E646-5C05-45b7-B24A-9AFAF5B21503”

            PropertyType=“Text” />

  </Pair>

  <Pair>

    <Source DisplayName=“Modified By” Name=“Editor” PropertyType=“User” />

    <Target DisplayName=“Modified By” Name=“Editor” PropertyType=“User” />

  </Pair>

  <Pair>

    <Source DisplayName=“Created By” Name=“Author” PropertyType=“User” />

    <Target DisplayName=“Created By” Name=“Author” PropertyType=“User” />

  </Pair>

  <Pair>

    <Source DisplayName=“Start Date” Name=“StartDate”

            PropertyType=“DateTime” />

    <Target DisplayName=“Start Date” Name=“StartDate”

            PropertyType=“DateTime” />

  </Pair>

  <Pair>

    <Source DisplayName=“Due Date” Name=“DueDate” PropertyType=“DateTime” />

    <Target DisplayName=“Due Date” Name=“DueDate” PropertyType=“DateTime” />

  </Pair>

  <Pair ValueMapping=“@DEPLOYER@\Rules\Mappings\Value Mapping - Tasks - Priority.xml”>

    <Source DisplayName=“Priority” Name=“Priority” PropertyType=“Choice” />

    <Target DisplayName=“Priority” Name=“Priority” PropertyType=“Choice” />

  </Pair>

  <Pair>

    <Source DisplayName=“% Complete” Name=“PercentComplete”

            PropertyType=“Number” />

    <Target DisplayName=“% Complete” Name=“PercentComplete”

            PropertyType=“Number” />

  </Pair>

  <Pair>

    <Source DisplayName=“Modified” Name=“Modified” PropertyType=“DateTime” />

    <Target DisplayName=“Modified” Name=“Modified” PropertyType=“DateTime” />

  </Pair>

  <Pair>

    <Source DisplayName=“Created” Name=“Created” PropertyType=“DateTime” />

    <Target DisplayName=“Created” Name=“Created” PropertyType=“DateTime” />

  </Pair>

  <Pair>

    <Source DisplayName=“Assigned To” Name=“AssignedTo” PropertyType=“User” />

    <Target DisplayName=“Assigned To” Name=“AssignedTo” PropertyType=“User” />

  </Pair>

  <Pair>

    <Source DisplayName=“Description” Name=“Body” PropertyType=“Note” />

    <Target DisplayName=“Description” Name=“Body” PropertyType=“Note” />

  </Pair>

  <Pair>

    <Source DisplayName=“Title” Name=“Title” PropertyType=“Text” />

    <Target DisplayName=“Title” Name=“Title” PropertyType=“Text” />

  </Pair>

  <Pair ValueMapping=“@DEPLOYER@\Rules\Mappings\Value Mapping - Tasks - Status.xml”>

    <Source DisplayName=“Status” Name=“Status” PropertyType=“Choice” />

    <Target DisplayName=“Status” Name=“Status” PropertyType=“Choice” />

  </Pair>

  <Pair>

    <Source DisplayName=“Modified” Name=“Modified”

            PropertyType=“DateTime” />

    <Target DisplayName=“Modified” Name=“Last Modified”

            PropertyType=“DateTime” />

  </Pair>

</PropertyMapping>

 

Where;

DisplayName is the Properties Display name.

Name is the SharePoint internal name.

PropertyType can be one of the following: DateTime, ModStat, User, Choice, and Text.

 

Sample Value Mapping XML File

Note that the sample mapping file includes references to two external XML files that contain value mappings (highlighted in the sample): Status and Priority. The Status value mapping file for this example is:

<ValueMapping>

  <Pair Source=“Issue” Target=“Waiting on someone else” />

  <Pair Source=“Completed” Target=“Completed” />

  <Pair Source=“{D3A98B62-323C-4130-AA18-2CA791C9E57D}” Target=“Not Started” />

  <Pair Source=“{D3A98B62-323C-4130-AA18-2CA791C9E57C}” Target=“{D3A98B62-323C-4130-AA18-2CA791C9E57A}” />

</ValueMapping>

 

Where value mapping provides a few “placeholder” values:

{D3A98B62-323C-4130-AA18-2CA791C9E57C} – Empty Source.

{D3A98B62-323C-4130-AA18-2CA791C9E57D} – Default Source.

{D3A98B62-323C-4130-AA18-2CA791C9E57A} – Target Map to Empty.

{D3A98B62-323C-4130-AA18-2CA791C9E57B} – Target Map to Keep Original.

These values match the values available to users in the Value Mapping step of the deployment wizard.

 

Remarks

You can create the mapping file manually, but it is recommended to export a property mapping during a regular deployment, and use the exported mapping. For more information, see Importing and Exporting Userson page 4-55.

 

Set Title to <Title>

Sets the title of the new item to the selected value

Variables

Variable

Description

<Title>

The title of the item.

 

Use unique permissions

When an item is deployed as a site, this action sets the site to use unique permissions.

Remarks

This Action is valid only when an item is deployed as a site.

 

Set owner to <user>

When an item is deployed as a site, this action sets the owner to a certain value.

Variables

Variable

Description

<User>

The username of the user who is being assigned as owner.

The username is case sensitive. It should be the full user logon name (pre-Windows 2000: DOMAIN\user).

 

Remarks

This Action is valid only when an item is deployed as a root site (site collection).

 

Set Description to <Description>

Sets the description of the new item to the selected value

Variables

Variable

Description

<Description>

The description of the item.

 

Add the missing properties [except]

Adds the missing properties of the item except selected property

Variables

Variable

Description

<except>

The description of the item value.

 

Add the missing properties [except of type]

Adds the missing properties of the item except selected property type

Variables

Variable

Description

<Description>

The description of the item type value.

 

Execute the following Rules <Rules>

Executes selected rules of the current Rule Set

Variables

Variable                          

Description

<rules>

The rules to execute.

 

Remarks

  • It is considered good practice to disable Rules that are meant to be executed as part of this Action.

Usually, Rules that are executed by this Action are small, zero, or one condition Rules. These are often created as Rules only to prevent duplication of their logic in multiple Rules.

 

 

Tzunami Deployer Options

Tzunami Deployer allows you to configure its behavior via the Options window

To define the Tzunami Deployer options:

  1. Select Tools > Options…. The Options window appears.

General

 

Figure 78: Options Window – General

Table 20: Deployer Options - General

Option

Description

Select what version Deployer will migrate

Enables you to specify which document versions are deployed into the target SharePoint:

All versions – All document versions are deployed.

Only last <#> versions – Only the specified number of previous versions is deployed.

Deploy only approved versions – Deploy only those versions marked as approved in the source are deployed.

Deploy Security

Enables you to specify whether to deploy security (users, groups and roles).

Enable metadata warning of empty and required field

Select this option to enable metadata warning of empty and required fields.

InfoPath Form Template Deployment Level

Specify the location for deployment of InfoPath form template in the target SharePoint.

 

SharePoint Connectivity

 

Figure 79: Options Window – SharePoint Connectivity

Table 21: Deployer Options - SharePoint Connectivity

Option

Description

Enable self-hosting of the Remote Service

 

Self-host Deployer Remote Service and force connecting to the Remote Service using TCP or HTTP.

Use authentication cookie from Internet Explorer

Enables you to use the authentication cookie from Internet Exporter cookie cache.

Cache the Remote Service for improved performance

Enable the proxy object to the Tzunami Deployer Remote Service is cached and not created from scratch for each request. It improves performance while working with MOSS 2007, SharePoint 2010 and SharePoint 2013 server.

Use WCF Service Endpoint Identity when connecting to Remote Service.

Specify the endpoint identity mode to use when connecting to the remote service using WCF.

Language filter for reading site templates. Separate multiple entries with commas

Specify filtering the reading of site template based language. For Example the value: '1033: English’. Multiple entries are allowed, separated with commas (,) such as '1033:English, 1049:Russian'.

Specify the port used to connect to the SharePoint 2003 DB Server

Controls the ports used to connect to the SharePoint 2003 DB Server.

 

SharePoint Timeouts

 

Figure 80: Options Window – SharePoint Timeouts

 

Table 22: Deployer Options – SharePoint Timeouts

Option

Description

Reading root site timeout

Specify the amount of time, in milliseconds, that Tzunami Deployer tries to connect to the specified Active Directory domains before it times out the connection.

Root sites creating timeout

Specify the root site creation timeout value in milliseconds

Timeouts for the XML HTTP Web Requests

 

Connection timeout

Specify the connect timeout value in milliseconds

Send timeout

Specify the send timeout value in milliseconds

Receive timeout

Specify the receive timeout value in milliseconds

Resolve timeout

Specify the resolve timeout value in milliseconds

 

SharePoint Read Settings

 

Figure 81: Options Window – SharePoint Read Settings

Table 23: Deployer Options– SharePoint Read Settings

Option

Description

Specify the path to the Custom Global Templates mapping file

Enables you to specify the path to the Custom Global Template mapping file.

Specify advanced site read settings

 

Read folder metadata

Set this flag to ‘True’ to load metadata of folders while loading the target.

Allow Deployer to load the same site collection in source and target

Enables you to connect to the same SharePoint Site Collection in both as a source and target.

Read SPS2003 Portal Area as Windows SharePoint Service Sites

Allows Tzunami Deployer to read Areas as regular sites in order to get also non Area sub-sites under a parent Area.

Specify advanced list read settings

 

List Item Collection Position  Next

The index of an item in each list from which to read onwards.

List Item Order by Filename

The field name used to sort items while reading from SharePoint lists or folders.

Max Item Count in Lists

The maximum number of items to be read from each list or folder.

Number of List Items to Read

The number of list items to reach in each request to SharePoint.

Throughput while reading SharePoint

Enables you to specify how intensely Tzunami Deployer will interact with the SharePoint server during connection and reading from the server. When using a higher level of usage, SharePoint performances might be influenced.

 

SharePoint Commit Settings

 

Figure 82: Options Window – SharePoint Commit Settings

Table 24: Deployer Options – SharePoint Commit Settings

Option

Description

Delete automatically created list properties

Enables you to delete auto created properties and content types from the target list.

Do not upload files without first checking them in

Enables you to prevent items from being uploaded as check-out. If this flag is enabled, items which fail to publish will not be uploaded to SharePoint. An error will be provided during the commit and items will be available for commit at a later time.

Preserve approval status of uploaded items

Enables you to preserve information about approval from the source.

Fail creating a list if a list with same URL already exists

Stops creating a list if a list with same URL already exist in the target.

Prevent Deployer from modifying SharePoint database directly

Prevents Tzunami Deployer to modify SharePoint Database directory.

Navigation Migration

 

Migrate site quick launch

Enables you to update the Quick Lunch Bar of the target site.

Migrate top navigation

Enables you to update the Top Navigation bar of the target site.

Specify how Deployer will migrate view

Specify how to migrate the Source views into target SharePoint.

Abort commit when error occurs

Select this option to quit commit when error occurs during commit

Abort upload of list items if attachment size exceeds the SharePoint maximum

Enables you to abort uploading of list items if attachment size exceeds the SharePoint maximum limit.

File size notification mode

Set file size notification mode as Silent/Loud/None as required. This refers to whether you want to let the user/log know if a file size which was uploaded is different than the original file size.

Maximum file upload time

Specify the timeout used when uploading files to SharePoint. If you plan to migrate large files, it is recommended to increase this value.

 

Deployment

 

Figure 83: Options Window – Deployment

 

Table 25: Deployer Options – Deployment

Option

Description

Specify Entity Mapping Suggestors  (separate individual values by commas)

Configure the Suggestors for entity mapping. These are used to suggest entity mappings. Following suggestors are provided:

ById èSuggest by ID

ByNameè Suggest by Name

ByRegexè Suggest by Regular Expression

ByProvider è Suggest by Membership Provider

ByDisplayName è Suggest by Display Name

ByLoginToDisplay è Suggest by Login Name to Display Name

Specify Group Mapping Suggestor (separate individual value by commas)

Configure the Suggestors for group mappings. These are used to suggest group mappings:

ById è Suggest by ID

ByName èSuggest by Name

ByDisplayName è Suggest by Display Name

ByeRoomName è Suggest by eRoom Name – useful when source is eRoom

Specify the source property to check for duplicates

Enter Unique Property Name of any Folder/Item/Documents of source property during the first migration, later Deployer identifies and uses these in a delta/incremental migration to find the matching existing Folder/Item/Documents based on that retained property.

Specify the target property to check for duplicates

Enter Unique Property Name of any Folder/Item/Documents of target property during the first migration, later Deployer identifies and uses these in a delta/incremental migration to find the matching existing Folder/Item/Documents based on that retained property

Specify the source properties in commit reports

List of source properties separated by ',' whose values would be written as 'Source URL' in commit report. If no value or [Default] is specified, usual values as returned by Deployer will be used.

Specify the target property in commit report

Target properties whose value would be written as 'Target URL' in commit report. If no value or [Default] is specified, usual values as returned by Deployer will be used.

Allow deployment of zero byte file versions

Select this flag to enable deployment of file versions with zero byte length. Allowing deploying the zero byte versions of file would fail commit of the file as SharePoint does not allow zero byte file.

Allow deployment of corrupt file versions

Select this flag to enable deployment of corrupt or physically not existing file version. If this option is not selected, Deployer prevents to deploy corrupted or physically not existing file versions.

 

Mappings

 

Figure 84: Options Window – Mappings

Table 26: Deployer Options – Mappings

Option

Description

Show Value Mapping Dialogs

Enables you to specify whether the deployment wizard will display (or skip) Value Mapping steps:

  • Always – Always display Value Mapping steps.
  • When there are unmapped values – Display Value Mapping steps only if some of the source values are not mapped.
  • Only when default value is not mapped – Display Value Mapping steps only if the default source value is not mapped.

Special

Show mapping for Yes/No (Boolean) properties – Select this option to display value mapping for Boolean properties.

Show mapping for Approval Status properties – Select this option to display value mapping for Approval Status properties.

Show only relevant values – Select this option to display value mapping for relevant values.

Property Mapping Dialogs

Enables you to specify whether the deployment wizard will display (or skip) Property Mapping steps:

  • Show Always – Always display Property Mapping steps.
    • Hide for empty container – Check this option to skip Property Mapping steps for the empty container.
  • Hide if provided by Rule Engine – Skip Property Mapping steps that are filled using the Rule Engine.
  • Hide Always – Always skip Property Mapping steps.
    • Exceptions:
      • Unless there are missing properties – Do not skip Property Mapping steps if there are missing properties.
      • Unless there are unmapped target properties – Do not skip Property Mapping steps if any of the target properties is unmapped.

 

Security

 

Figure 85: Options Window – Security

 

Table 27: Deployer Options – Security

Option

Description

Show Security Mapping Dialogs

Enables you to specify whether the deployment wizard will display (or skip) Security Mapping steps:

  • Always – Always display Security Mapping steps.
  • When there are unmapped values – Display Security Mapping steps only if some of the source values are not mapped.
  • Only when default value is not mapped – Display Security Mapping steps only if the default source value is not mapped.

Add Site’s name to groups as a part of a deployment process

Select this option to add site’s name to group as a part of a deployment process 

Map “unmapped” group to Create New Groups

Select this option to map “unmapped” group to create new group.

Show warning if there are any unmapped roles

Select this option to display warnings if there are any unmapped roles.

Advanced Security Settings

 

Break security inheritance for empty ACLs

Select this option to break inheritance even when created ACL is empty.

Fix invalid ACL entries

Select this option to automatically fix ACLs by removing entries of invalid entities.

Ignore invalid user type values

Select this option to upload item in case a user property value is of user which cannot be resolved. Empty value will be used instead resulting in the Deployer user value in SharePoint.

Prioritize Group

Select this option to specify not to assign permissions to an entity if it receives similar permission by being a member of a group that already has permission on that item.

Optimize Security

If this option is set, an item will inherit permission if its ACL is same as its parent's ACL when a TDX is loaded.

Flat group members

Select this option to specify not to assign permissions to an entity if it receives similar permission by being a member of a group that already has permission on that item.

Security deployment logic

Enables you to specify the security deployment. Set this value to 2 if break in security inheritance should result in items to have a copy of parent ACL, otherwise, a value of 1 will result in blank ACL.

 

Active Directory

 

Figure 86: Options Window – Active Directory

Table 28: Deployer Options – Active Directory

Field

Description

Ignore disabled users when reading from active directory.

Select this option to ignore disabled users while reading users from active directory

Active Directory connectivity timeout

Specify the timeout used when checking Active Directory connectivity.

Active Directory connectivity timeout

Configure how long (in minutes) a thread should wait for another thread to complete reading and caching of AD. If the operation is not completed in this time, the thread will start reading the AD directory. Note that this time should be less than Remote Service Timeout.

Advanced Active Directory Settings

 

The number of AD entities to return from the Remote Service in one call

Configure how may Active Directory entities to return from the Remote Service in one call. Large size might cause WCF buffer overflow.

The number of domains Deployer will read in parallel

Configure how many Domains to read in parallel based on resource availability on the Remote Server machine. This operation is memory intensive.

The number of AD entities to read from domain in one request.

Configure how many entities to read from an Active Directory domain at a time. Maximum allowed size is 100. Decrease in case AD overflow errors are seen while reading.

 

Rule Engine

 

Figure 87: Options Window – Rule Engine

Table 29: Deployer Options - Rule Engine

Option

Description

Rule Sets File Paths

Enter the Rule Set File Paths.

Select rule set to use for each system

Allows you to select the rule set to use for each system.

 

Auto Fixes

 auto_fixes.png

Figure 88: Options Window - Auto Fixes

Table 30: Deployer Options - Auto Fixes

Option

Description

Lookup conversion to choice property

 

When a list containing a lookup column is deployed without the list to which the lookup column is pointing to, then that column is changed into a choice type in SharePoint after commit. Deployer allows you to decide the format of the corresponding choice value in the target SharePoint with the help of the following two options:

  1.          i.            Leave values as is (containing source item id): If you select this option, the choice value in target appears as:

“Item id;* Item Value”, where “Item id” is the lookup id and “Item Value” is the lookup value.

  1.         ii.            Modify values (remove source item id): If you select this option the choice value in target appears as:

“Item Value”, which is the lookup value.

Properties Values

 

Automatically fix Date/Time values

Select this option to let Deployer fix Date/Time values that are out of valid range, to valid SharePoint values.

Automatically fix Numeric values

Select this option to let Deployer fix numeric values that are out of valid range (Maximum or Minimum values), to the valid values.

Automatically fix Hyperlink Values to include a default protocol

Specify whether to automatically add a protocol to values of properties of type Hyperlink, in order to meet SharePoint restrictions.

Automatically truncate the long Hyperlink values

Select this option to truncate the long URLs.

Automatically fix Event Occurrences greater than 999

Select this option to let Deployer fix event occurrences greater than 999 times

Illegal Characters

Select map illegal characters in SharePoint to valid values

Blocked Extensions

Do not deploy files with a blocked extension – Select this option to stop deploying files with blocked extensions.

Long Files and Folders Names

 

Automatically Truncate Long File Names

Select this option to automatically truncate long file names while deploying.

Automatically Truncate Long Folder Names

Select this option to automatically truncate long folder names while deploying.

Max file name length

The default number of characters in a file's name is 128. You can change this value in order to truncate file names that exceed the limit you set.

 

Others

 

Figure 89: Options Window – Others

Table 31: Deployer Options - Others

Field

Description

Restore message boxes

Enables display of message boxes hidden by “Don’t show me again” checkbox – This will result in all message boxes being displayed to the user.

Exporter

 

Specify the property prefix to remove when exporting from Hyperwave

Set the language prefix to remove from any property value. This prefix will be used in case the HW_Langauge property was not provided by HyperWave.

Specify the number of items that the Lotus Notes exporter will export.

Set the limitation of the Tzunami Deployer Lotus Notes exporter to export the specified number of items.

 

Link Registration

 LR.png

Figure 90: Options Window – Link Registration

Table 32:  Deployer Options – Link Registration

Field

Description

Use Link Resolver Service

Controls if Deployer will register committed items to redirector service.

Specify the timeout for registration of the source URL with the Link Resolver service

The timeout in milliseconds for registration of the source URL in Redirector service.

 

 

Logging

 

Figure 91: Options Window – Logging

Table 33: Deployer Options – Logging

Option

Description

Keep log history for

Enables you to specify for how long Tzunami Deployer retain log files in the open project.

Log stack trace

Specify whether to include additional information in the log files.

Logging Level

Specify the verbosity of the logs. The higher the level you select, the more verbose the logs will be. It is recommended to leave this to Debug level.

Specify the maximum size for the WCF log file

Enables you to set WCF Log file size.

 

The default WCF log file size is 1 GB.

 

 

 

 

Folder and File Naming Considerations

To ensure the smooth management of a SharePoint migration project, you should ensure that your folder and file names and pathnames conform to the following guidelines and other constraints.

Folder Path and Fully Qualified File Name Lengths

A fully qualified file name consists of two parts:

  1. File name including the file base name and file extension.
  2. Folder path for the fully qualified file name.

The file name is the last component of a fully qualified file name. The folder path for a fully qualified file name starts with the drive letter and includes everything up to the file name and the last folder character (such as \ or /).

 

Restrictions

Microsoft Windows:

The fully qualified file name can have a maximum length of 260 characters.

The maximum length of a folder path portion of a fully qualified file name is 248 characters.

Microsoft SharePoint:

The fully qualified file name can have a maximum length of 255 characters in Windows.

 

Normally, it is not possible to create folder paths and fully qualified file names that are too long when using Windows Explorer or a Windows application. However, it is possible under the following scenarios:

A subfolder one or more levels below the root of the file system is shared as a UNC file share. In this case, it is possible to create an entire new folder hierarchy under the root of the file share that can store files using fully qualified file name that are a further 260 characters long.

Similarly, the subset command can be used to anchor a drive letter at a subfolder one or more levels below the root of the file system.

Using Unicode fully qualified file names prefixed with the letters: \\?\. When this approach is used, fully qualified path names can be 32,000 characters in length.

Naming Considerations

Files

The following characters are not supported in Windows SharePoint Services:

/\:*?”<>|#{}%&~ or tab characters and multiple periods.

File names cannot be longer than 127 characters.

 

Tzunami Deployer automatically replaces invalid characters with an underscore (“_”).

Tzunami Deployer automatically replaces multiple periods with a single period.

Tzunami Deployer automatically truncates the file name to 127 characters.

 

Folders

The following characters are not supported:

~#%&*{}:"\|/<>? or tab characters.

Folder names cannot end with a blocked extension (configurable in SharePoint) or with one of the following:

  • archivos
  • _arquivos
  • _bestanden
  • _bylos
  • -Dateien
  • _datoteke
  • _dosyalar
  • _elemei
  • _failid
  • _fails
  • fajlovi
  • _ficheiros
  • _fichiers
  • -filer
  • .files
  • _files
  • _file
  • _fitxers
  • _fitxategiak
  • _pliki
  • soubory
  • _tiedostot

Folder names cannot be longer than 127 characters.

 

Tzunami Deployer automatically replaces invalid characters with an underscore (“_”).

Tzunami Deployer automatically replaces multiple periods with a single period.

Tzunami Deployer automatically truncates the file name to 127 characters.

Lists

Lists differentiate between a list’s internal name (used for the URL) and the list’s title. The name of a list is calculated based on its title. If the list title contains any of the following invalid characters, that character is omitted. If all the characters are invalid, a generic name is given to the list:

~!@#$%^&*{}[]-=+\:"'|<>,?/. or tab characters.

Lists names cannot contain multiple periods.

Lists names cannot be longer than 50 characters.

Libraries

Libraries differentiate between a library’s internal name (used for the URL) and the library’s title. The name of a library is calculated based on its title. If the library title contains any of the following invalid characters, the character is omitted. If all the characters are invalid, a generic name is given to the library:

~!@#$%^&*{}[]-=+\:"'|<>,?/. or tab characters.

Libraries names cannot contain multiple periods.

Libraries names cannot be longer than 50 characters.

Folder names cannot end with any of the following:

  • _archivos
  • _arquivos
  • _bestanden
  • _bylos
  • -Dateien
  • _datoteke
  • _dosyalar
  • _elemei
  • _failid
  • _fails
  • _fajlovi
  • _ficheiros
  • _fichiers
  • -filer
  • .files
  • _files
  • _file
  • _fitxers
  • _fitxategiak
  • _pliki
  • _soubory
  • _tiedostot

 

Sites

Sites differentiate between a site’s internal name (used for the URL) and the site title. A site URL cannot contain any of the following invalid characters; the character is replaced by an underscore (“_”):

/\:*?”<>|#{}%&~+ or tab characters.

Sites names cannot contain multiple periods.

Sites names cannot start or end with a period (“.”).

Sites names cannot be longer than 127 characters.

Sites names cannot start with an underscore (“_”).

Sites names cannot be any of the following:

  • PRN
  • AUX
  • NUL
  • COM1
  • COM2
  • COM3
  • COM4
  • COM5
  • COM6
  • COM7
  • COM8
  • COM9
  • CON
  • LPT1
  • LPT2
  • LPT3
  • LPT4
  • LPT5
  • LPT6
  • LPT7
  • LPT8
  • LPT9
  • Wpresources

 

Groups

A group name cannot contain any of the following invalid characters:

"/\[]:|<>+=;,?*'@ or tab characters.