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
- Select Tools > Options. The Options window appears.
- Select the Rule Engine tab. The Options window displays the Rule Engine tab.
- 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:
- Select Tools > Options > Rule Engine.
Tzunami Deployer - Options window appears, displaying the locations in center of the screen.Figure 68: Options Window
Click Add and browse to the location of the Rule Set.
Or Enter the location in a new line in the Locations area.Select Rule Set and click OK.
- Select Tools > Options > Rule Engine.
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:
- Select Tools > Options in the menu. The Options window appears, displaying the existing Rule Sets in the bottom half of the screen (Figure 69).
- 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.
- Select Tools > Deployment Rules. The Rule Sets Editor appears.
- 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:
- Select the rule you wish to duplicate.
- 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:
- Select the rule you wish to edit.
- 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:
|
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:
|
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:
|
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:
|
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:
|
< Number> | The value (or values) to search for in the item. |
<not including items under sub-containers> |
|
<count sub-containers as items> |
|
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 :
|
<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:
|
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) |
|
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> |
|
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:
|
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.
|
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| | 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:
- 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