Frequently Asked Questions

1. Start MetaVis,
2. Go to Help> Profile Manager> Global Variables>
3. Find an option called "Enable browser connect" and set that dropdown to 'True'.  Click Apply
4. Close and restart MetaVis
5. After you've re-started MetaVis Click the "Connect to Site" button on the ribbon. 
6. Type in the project name and the url for your site.  Click the Finish button.
7. An authentication box will pop up. Click the "Claims" button and then a browser will pop up.
8. Enter your claims based credentials and you should be connected.

This error is commonly generated when there is a need to specify a different home folder location. For example, when a user has roaming Windows profile or the user home directory does not have letter mapping but accessible by UNC path like \\server\drive\folder\folder. MetaVis does not support this setup and requires letter mapping for user home directory. When these cases are encountered an error similar to the one pictured below is displayed.

1.) Shut down MetaVis, if it is currently running

2.) Create a new folder in your local drive (for example, c:/MetaVis)

3.) Navigate to “c:\Program Files\MetaVis Technologies\metavis\configuration” and open the file “config.ini” *Note* This file may be hidden, so you may need to show hidden files. (open the file using WordPad, not Notepad). You may need to start WordPad using "Run as Administrator" option to overcome Windows security settings.

4.) Edit the last line of this file, changing it:

a) From: osgi.instance.area.default=@user.home/Metavis

b) To: osgi.instance.area.default=c:/MetaVis {or the folder path that was created in step 2} {also note the forward slash instead of the back slash}

5.) Save and close config.ini

6.) Restart MetaVis

By default, MetaVis uses Windows Integrated scheme to connect to SharePoint. In case the SharePoint server supports only basic authentication, MetaVis behavior should be changed via a parameter in the ini file. Please follow these steps to modify this comment:

1) Go to C:\Program Files (x86)\MetaVis Technologies\metavis folder.

2) Edit (WordPad) the MetaVis ini.**

3) Add the following line at the bottom of the file: -Dhttp.auth.preference=Basic

4) Save file and restart Metavis and try to connect

To connect to SharePoint site with Kerberos authentication you need to know two parameters of your network:

1. Kerberos Key Distribution Center (KDC) which in the case of Windows domains is the Windows domain controller
2. Kerberos Realm

KDC server in case of Windows netowork could be detected by running command prompt (Start / Run / cmd) and executing the following command:

echo %logonserver%

Kerberos Realm should be learned from network administrator.

Download ZIP file with MetaVis Kerberos configuration files using this link: http://www.metavistech.com/~metavis/kerberos/KerberosConfiguration.zip . Copy two files:  krb5.conf and login.conf in the root of drive c:. Edit krb5.conf to replace REALM with your Kerberos Realm and DOMAINCONTROLLER with your domain controller. Replace MetaVis.ini file located in MetaVis installation folder on your hard drive (default location is c:\Program Files\MetaVis Technologies\metavis) with the one from archive. In case you copied krb5.conf and login.conf to different locations edit MetaVis.ini file to reflect the new location of these files. In all cases use Wordpad for editing since Notepad would not display new line characters correctly.

After this start MetaVis and try to connect. If connection does not work then add the following registry settings:

HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Lsa\Kerberos\
Value Name: AllowTGTSessionKey
Value Type: REG_DWORD
Value: 0x01

To do this open registry editor (Start / Run / then type regedit ). In the registry editor expand HKEY_LOCAL_MACHINE node, then SYSTEM, then CurrentControlSet / Control / Lsa / Kerberos. Right click on the right side, select New  / DWORD (32 bit) Value, enter name AllowTGTSessionKey, click Ok, double click on new record and enter 1 as a value. It should finally look like this:

For server computers make the same registry entry but in the following registry section:

HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Lsa\Kerberos\Parameters

After registry setting is modified try to connect to the site again. In case it still does not connect check the realm and domain controller information in krb5.conf file and run MetaVis in debug mode to diagnose Kerberos negotiation. To do this right click on MetaVis icon on the desktop and add parameter -consolelog after the double quote character of the Target field of the shortcut properties. After this save the properties and run MetaVis from this shortcut. MetaVis will startup together with black windows that will display the log. Connect to the SharePoint site and send us the content of the black window. To do this, right click on the black window title bar, select Edit / Select All. It will select all text inside this window. Then press <Enter> to copy this text into clipboard. Paste it into the email message ans send it to support@metavistech.com

To fix "Authentication Failure" error that appears during connection to SharePoint change the following setting on the Windows computer that runs MetaVis (Mostly applies to Win7 and Win2008 R2):

1. Open Control Panel

2. System and Security

3. Administrative Tools

4. Local Security Policy (can take a minute to load)

5. Local Policies

6. Security Options

7. Network security: LAN Manager authentication level 8. Change the setting to be: "Send LM & NTLM - use NTLMv2 session security if negotiated"

After changing this property try to reconnect to the site again.

In the  case Local Security Policy is not available on the computer (for example, in case of Windows 7 Home Premium Edition), run registry editor (type regedit in the command line or in Run... prompt). Find the node:

HKEY_LOCAL_MACHINE / System  / CurrentControlSet / Control / Lsa

Click on Lsa node and create there a New DWORD (32-bit) Value LmCompatibilityLevel with the value 1. It will have the same effect as setting local security policy in Win7 Professional. It should resolve Authentication Failure issue. Below is the picture of registry editor with this value already set.

All products from MetaVis Architect Suite require account credentials to connect to SharePoint.

MetaVis Architect and Migrator require this account to have at least Designer permissions. MetaVis Classifier requires the account to have at least Contributor permissions.

In this case we need to diagnose the issue by looking through your log. Please follow these steps:

1) Go to Help ribbon and turn on Debug Mode
2) Try to connect to SharePoint..
3) Return to the Help ribbon and turn off Debug Mode
4) Press on Log Manager Button and then select a location to store log files.  Then press the Save Environment button. 
5) Please send the zip file created in step 4 back to us at support@metavistech.com or if it too large please use the following drop box: http://dropbox.yousendit.com/MetaVisSupport121114118

If you have valid privileges to your SharePoint environment, but still receiving this error "The Sever sent HTTP status code 401: Unuathorized" then the problem is likely due to MetaVis authentication methodology.

If the workstation on which MetaVis is installed on is logged into a valid domain, the application automatically picks up these credentials and tries to log in. However, if this account does not have sufficient privileges the "Unauthorized" error is shown. There are several work-arounds:

1) Re-start MetaVis under "Run As" - Hold down the shift key and click with your mouse on the MetaVis shortcut. Select Run As and type in either the admin account or any other account that has no rights to the SharePoint environment. If you do the later, you will be prompted to enter credentials when connecting to SharePoint.

See these Resources for further information:
http://support.microsoft.com/kb/294676

2) Relogin into the computer with a local account or a domain account with no SharePoint privileges. You will be prompted to enter credentials when connecting to SharePoint.

If you use MetaVis Architect (either full edition or Trial), the user that you use to connect to SharePoint should have at least Design privileges (Full Control will also work).

If you use MetaVis Classifier or Migrator products (check what it has in the application title bar) then the user that you use to connect to SharePoint should have at least Contribute privileges on the site you connect to (Anything better than Contribute like Design or Full Control will also work).

MetaVis Architect Trial Edition that you receive when you select "Try Now" on www.metavistech.com requires at least Design privileges because it includes Architect product.

MetaVis Architect Products support the following versions of SharePoint

* SharePoint Server 2010: Intranet
* SharePoint Server 2010: Internet/Extranet
* SharePoint Foundation 2010
* Microsoft Office SharePoint Server (MOSS) 2007
* Windows SharePoint Services (WSS) v3
* Microsoft Online (BPOS) and other SharePoint Hosting Providers
* Office 365
* SharePoint Portal Server (SPS) 2003 (source only)
* Windows SharePoint Services (WSS) v2 (source only)
* FAT/NTFS File System (source only)
* Outlook (source only)
* Exchange Public Folders (source only)

Hosted SharePoint environment often has mapping of user email to an internal user names on the provider's local domain. In order to learn the exact user name used by SharePoint do the following:

If you are connecting to Office 365, enter the same email address and password you use to login to Office 365 through your web browser.

If you are connecting to BPOS or other hosted SharePoint
* Login to your hosted Microsoft Online, BPOS or other hosted SharePoint
* Click on your "Welcome " on the top of the page
* Select My Settings
* Look at the Account property
* Use Account as a user on the MetaVis connection wizard to connect to SharePoint
* You can use the complete domain\user account name in the user field or type user in the user field and domain in the domain field

When you run setup.exe to install MetaVis Core Properties service then you pass the setup screens and it sits and waits and writes something like "Waiting...." but before it times out please execute the following command from the command line on each WFE in the farm:

stsadm -o execadmsvcjobs

It will force the timer job to execute immediately and deploy the solution.

There are several reasons why the application does not offer to update itself upon startup:

1. If you run Windows 7 computer you need to start up MetaVis as administrator so it will get the updates. To do this, right click on MetaVis icon on the desktop and select Run As Administrator. Running as administrator will let MetaVis to access its installation folder in Program Files directory.

2. If you have proxy to connect to Internet you need to set up proxy to MetaVis so it will use it to get updates. To do it, open MetaVis Activation / Registration screen using Help / Registration menu item or Help / Activation ribbon button to open registration screen. Use Proxy button on this screen to specify proxy server information. Restart MetaVis to initiate software update. You may run it as administrator (see item (1)) in case you are on Windows 7 computer

3. You can uninstall the software and install it again using the original link you received in the email. It will preserve the current activation and loaded site.

MetaVis Core Properties Service should be installed on the SharePoint farm server which is hosting SharePoint Central Administration application pool. Login to the server using credentials of the central administration application pool owner and install MetaVis Core Properties service. Use IIS Manager to find out the account the Central Administration application pool owner like it is shown on the picture below.

In the event it is impossible to use Central Administration applicaiton pool owner as an account to install Metavis Core Properties Service (for example when it is a technical account and noone knows the password) use different account with the following requirements

1. Account should be SharePoint Farm Administrator

2. Account should be in local Administrators group

3. Account should have access to SharePoint configuraiton database with sysadmin privileges. See the picture below illustrating DB privileges

4. MetaVis Core Proeprties installer should be Run as Administrator

If you received this error, it is likely due to one of two reasons:

1) The trial key could have been copied to the license area instead of the Activation Code area highlighted in the picture. If so, simply paste the activation code and press Activate Automatically button. Once the license is retrieved press the Complete Activation button in the lower left.

2) If you are using Manual Activation, please make sure to include the ----------------LICENSE BEGIN---------------- and ---------------- LICENSE END ---------------- when pasting the activation key.

These applications are intended to run on a workstation and connect to your SharePoint environment remotelly.

The critical parameter for our product is system memory. We recommend 1 Gig of RAM for MetaVis (which is what we reserve by default). If you are running a lot of diagrams and or migrations simultaneously, we would recommend bumping that to 1.5 or 2 Gig (requires a parameter change). The O/S and processor is not as critical, but we would recommend a Dual Core if possible.

After downloading MetaVis product you will receive an email with the link to the product download and the activation code to activate the product. If you did not receive such email please contact MetaVis support at support@metavistech.com or "Contact Us" form on this WEB site.

Install and run the product. The first screen that the product will present will Registration screen. Paste activation code into the activation code text box and press "Activate Automatically" button. The license should appear in the License box and Activation Status should turn green. After this click "Complete Activation" button and proceed to the product.

In case "Activate Automatically" button does not retrieve the license successfully, make sure that the activation code is pasted into the activation code box exactly like it was written in the email and press "Activate Manually" button. This button will popup a browser with the license displayed. Copy the license including the whole lines with the words "LICENSE BEGIN" and "LICENSE END" into License box of the license screen. Then press Check License button. License status should become green.

In case the browser that pops up in response to "Activate Manually" button does not connect to Internet, save the URL in this browser, execute it on the other computer to fetch the license and deliver it back to the License box of the MetaVis License Screen. After this press Check License button. License status should become green.

In case the browser with "Activate Manually" URL run on the other computer still does not fetch the license, email the URL that appears in the browser that pops up after you press "Activate Manually" button to support@metavistech.com. You will receive an email back with the license that you should paste to the License box of the MetaVis License screen and press Check License button. License status should become green.

If the computer you are trying to install a product from MetaVis Architect Suite does not have connection to http://www.metavistech.com WEB Site do the following

1. Download off-line product package from this link: http://www.metavistech.com/designer/product/metavis-win32.win32.x86-offl...
2. Unzip the package to any folder on the local hard drive
3. Run the executable file MetaVis.exe located inside the unzipped folder
4. You may create a desktop icon for the simpler execution
5. Proceed with the product activation and choose "Activate Manually" option

Yes, this can be changed via a parameter in the ini file. Please follow these steps to modify this comment:

1)      Go to C:\Program Files (x86)\MetaVis Technologies\metavis folder.

2)      Edit (WordPad) the MetaVis ini.**

3)      Insert the following line at the top:   -default.version.comment=Your comment goes here with no quotes

4)      Save file and restart Metavis

Here is what the ini file should look like after editing

**The ini file may be protected using security and you will need Admin rights to make a change…

Metavis keeps all offline data in the folder "c:\Documents and Settings\< user >\Metavis" (or "c:\Users\< user >\Metavis" in case of Vista or Win2008 Server). Since site data may be as large as 0.5-2M this space may grow in size. It is posible however to move it to the other folder possibly on the other drive.

First, you need to find new location for Metavis workspace. Let's say you will create a folder d:\Metavis. It is good to create this folder because we could be sure that the application will have permission to write there.

Then you need to edit this file (I assume that you have MetaVis installed on drive D:):

"D:\Program Files\MetaVis Technologies\metavis\configuration\config.ini"

Some folders are hidden in this path so you may want to either unhide them when you look or type (paste) this path to Wordpad Open command. You can use Wordpad instead of Notepad to edit this file since Notepad will not show it properly.

It is a simple text file. The last line there is

osgi.instance.area.default=@user.home/Metavis

you can make it like this:

osgi.instance.area.default=d:/Metavis

Note that slashes between folders are like this: / Basically, you can have any path over there, just keep in mind that the application should have permission to write there. Then restart Metavis and it will use this new folder to store its files. It will ask for the activation code again because it stores license file over there too. You can use the same activation code that you used to activate the product first time.

There is a file "c:\Program Files\MetaVis Technologies\metavis\MetaVis.ini" (path could be slightly different if you installed Metavis in the other location). There is a line in this file

-Xmx1024M

It is a memory cap on what Metavis can use (1024M by default). It could be changed to something like

-Xmx1536M

(1536M is the maximum for a 32-bit system) MetaVis Architect should be restarted after this.

This setting could be lowered as low as 512M if you need to limit the amount of memory MetaVis uses.

In case some WEB Parts did not copy during site copy please perform the following actions that would help us to troubleshoot the case

1. Open MetaVis

2. Load both source and target sites so you can see them in MetaVis Navigation tree

3. Right click on the source site in the MetaVis navigation tree and select Show WEB Parts

4. Confirm that all WEB Parts are visible in MetaVis content browser on the right

5. Select all (or some) WEB Parts and copy / paste or drag-n-drop them to the target site in MetaVis Navigation Tree. Confirm the copy in the copy wizard

6. Confirm that WEB Parts copy to the target site

7. If something goes wrong please ZIP and send us log folder located in [User Profile]\Metavis\.metadata

Mass (Bulk) Delete by Report

This feature is accessible from the Ribbon and Tools menu and provides the unique functionality of deleting contents from a site or site collection based on the Site/List Content report.  The content may reside in any site, sub-site and list. 

STEP 1)      Generate a Site/List Contents Report. Edit the report in Excel to filter out any items that are to be deleted from SharePoint.  A convenient way to do this is using the Filtering option in Microsoft Excel.

STEP 2)      When you are satisfied that the items remaining are the ones that should not be deleted from SharePoint, highlight them and delete them from the report.   The remaining items in the report will be processed by the Mass Delete feature.

STEP 3)      Save the file in a convenient place.

STEP 4)      Select the Mass Delete by Report feature and browse to the .csv filed saved in the previous step.

STEP 5)      Check the Delete folders option if you wish to have the folders removed as well.

STEP 6)      Press Finish to begin the process.

To clear the fields of the selected items do the following:

• Select items in the SharePoint list like usual
• Right click on selected items
• Select Tag option in the menu.
• Click Down-Arrow button next to the field to clear value in. Metavis will popup its regular field mapping dialog.
• Select "Make value empty" checkbox in this dialog and confirm it with Ok button.
• Repeat this procedure with other fields.
• After you will finish this wizard the values for the selected fields will be cleared for the selected items.

MetaVis Classifier/Migrator for SharePoint allows loading of files from file system to SharePoint document libraries. It also allows to set document fields during the file load or to pick up values for library fields from certain file properties like Modified Date, Owner or Keywords. The file load process also preserves folder structure in case the whole folder from file system is imported into SharePoint.

Folder structure is one of the few ways to classify files on the file system. In SharePoint, however, it is preferable to maintain document properties in list fields. Using fields instead of folders in SharePoint libraries facilitates flexible content navigation, search and workflows.

It is sometimes desirable to preserve folder information in certain fields of the document library at the time of the file import process. This approach works at its best in cases when files on file system are located in well structured folder hierarchies. The example of such folder tree is the following file path: N:\Network Share\Corporate Documents\Product Support\Company\Project\Phase\Document Name. In this example N:\Network Share\Corporate Documents is the documents storage location, Product Support is a company division, Company is the specific client, Project is the project and Phase is the project phase. MetaVis Migrator allows to grab any element of the folder tree (like Company or Project) and make it as a document field at the time of importing file.

MetaVis Classifier/Migrator allows you to drag and drop (or copy and paste) files of folders from file system to SharePoint document library. This operation displays Properties screen that allows you to select fields for imported documents. Select a Content Type, define or map values for any fields on this screen. Pick a field that should contain folder information. Click Down-Arrow button for this field to map it to a property of the source files. The source properties will include folder values. In our example given above "Folder 1 in File Path" will have Network Share value, "Folder 2 in File Path" - Corporate Documents, "Folder 3 in File Path" - Product Support and so on. After field is mapped to the correct Folder and import process is started, MetaVis Migrator for each loaded file will set correct folder value for the mapped field.

It is usually a good strategy to perform load of one file in MetaVis Data Analysis Mode to understand better the values for "Folder in File Path" properties. In this mode MetaVis Migrator will show values for the selected field on the source property pick up dialog. To enable this mode select menu item Edit / MetaVis Data Analysis Mode. Remember which "Folder in File Path" property should be used during mapping or save the complete mapping in MetaVis Copy Template. To save time, disable MetaVis Data Analysis Mode when performing actual file import and use MetaVis Copy Template or remembered "Folder in File Path" field during field mapping.

Once the folder information is loaded into fields of each SharePoint item there is no more need for folders. There are other tools that exist in SharePoint which could be employed to simplify navigation to better find SharePoint content. List views with group by criteria and faceted search are just two examples of dynamically changing navigation systems. MetaVis Migrator optionally allows to get rid of folders during file load from file system. Just check "Remove folder Structure" check-box on the Summary page of the File Load wizard and MetaVis will load all files from all subfolders into one selected location (list or folder) in SharePoint

Each SharePoint item and document has special Created By, Created At, Modified By and Modified At properties that can be seen on the item's View Properties screen. These properties are not editable with SharePoint GUI but sometimes it is desirable to keep these properties while copying document from one location to the other one, uploading a file from file system or re-classifying the document with new content type or field values.

Below are some typical cases that would benefit from maintaining original values for these "core" properties at the time of moving, copying or uploading an item:

• Created At property could be used to enforce document retention policy. During its life-cycle document may travel from file system to a list in SharePoint and to another SharePoint site. In this case it would be nice to keep the created date of the original document instead of the date of moving to its last location.
• Created By property could be used in a navigational list view with grouping that include original document author. Unless this property will be preserved during document copy, the document would not be found in the author category it belongs.
• Modified At property could be an indicator of items that have been recently changed. The change would trigger a special workflow for an item or cause a notification. In case of maintenance (not business related) changes such business related activities should be waved. These maintenance changes may include mass enhancement of metadata of simple copying items to another location.

MetaVis Classifier and Migrator products optionally allow user to maintain Created By, Created At, Modified By and Modified At properties during item tag, copy or file upload to SharePoint. To enable this functionality a special product called MetaVis Core Properties Service has to be installed on the destination SharePoint server - the one where these properties values should be maintained.

After MetaVis Core Properties Service has been installed on the destination SharePoint server, MetaVis Classifier and Migrator products detect it automatically during items copy. In this case MetaVis displays all four created / modified properties on the Copy Wizard Properties screen. By default these properties are set up to keep original value they had on the source item but there are several other possibilities listed below for defining their values during items copy or tag. Note that any of these cases could be applied to any of four core properties independently.

• Copy value to the property from the same property of the source item (Create At to Create At, Modified By to Modified By, etc). This is the default choice on the Properties screen of the Copy Wizard. This choice maintains the original created / modified property value as it was in the source item whether it was located in other SharePoint site or on file system.
• Copy value to the property from the other property of the source item. This option allows to set Modified At field to the value of the Created At field of the original item or to copy a value from a custom Person or Group column to a Created By field.
• Let SharePoint set this property. This option does not copy any values. After the item copy, Created At and Modified At properties of a newly copied items will be set to the current time, Created By and Modified By fields will be set to the current user. After tag or copy to the new version only Modified properties would be set to current time and user.
• Set certain value for this property. A user for Created By or Modified By fields could be selected from the list of users. Date and time for Created At or Modified At fields could be selected using calendar control.

When bulk list or site copy is performed instead of item level copy MetaVis Migrator will preserve all four created / modified properties from the original source item. MetaVis Migrator will also preserve all four created / modified properties if "Keep Original Content Type" option is selected on the Properties screen of the Copy / Tag Wizard during item level copy.

These flexible choices allow to plan each copy or tag process with respect to the intended use of a document or an item during its life-cycle.

Item Level Tag or Copy allows to select one or several items in a list and copy all of them at once to another folder, list, site, site collection or SharePoint server. During this process it is possible to change content type, replace values for certain fields or to specify new values for the selected fields. All these changes to the field values will be applied to all items selected for the bulk tag or copy.

The function to replace field values offers two possibilities for any field:

• Specify new value for the selected field. The new value will be applied to all items selected for the tag or copy operation. Use Left-Arrow button on MetaVis Properties Screen of Copy/Tag Wizard to unlock the field and enter the new value to the unlocked field. MetaVis will present free editable box for fields of String, Text, Number, Currency and other field types that allow free text entry. MetaVis will display drop-down control with populated values for the selection for Choice, Lookup or Person or Group fields. Drop-down control will allow selection of multiple values for fields that allow that (like Check-boxes of multi-selection lookups). Multiple values could be selected by using Shift-Click or Control-Click mouse actions
• Specify the source field for the copy / tag operation. Using this function MetaVis will copy value from the source field to the destination field. The source field could be selected from the list of all fields available in the source list or content type. Use Down-Arrow button on MetaVis Properties Screen of Copy/Tag Wizard to display selection list with the source fields

It is worth to note that while selecting source field during field mapping it is possible to select a field of a different field type that the field from the destination. It allows not only to map string field to the string one or number field to number one but also to map string field to a lookup one or lookup field to choice. It opens an opportunity to replace fields with other fields of different field type.

This article discusses various cases of copying data in SharePoint by MetaVis Migrator. MetaVis Migrator offers wide variety of functions from a fine control over each field value while copying few selected items in a large list to a bulk copying of many lists or even sites at a time preserving object properties and all items metadata. Below is the list of different methods of copying SharePoint objects with the explanations what they do and how and when they should be used.

• Item Level Copy allows to select one or several items in a list or file system folder and copy all of them at once to another folder, list, site, site collection or SharePoint server. Item level copy could be applied to documents, non-document items or pages. During this way of copy items of different content types could be selected and copied at the same time. The copy will preserve content type and values for all fields while copying the data. To activate item level copy in MetaVis Copy Items Wizard select "Keep Original" in Content Type box on the Properties page of the wizard. Item level copy should be used when some items in a list or library should be copying to the new location.
  
• Item Level Copy with Fields Mapping allows to select one or several items in a list or a folder on a file share and copy all of them at once to another folder, list, site, site collection or SharePoint server. Item level copy could be applied to documents, non-document items or pages. During this way of copy items of different content types could be copied at the same time but only one content type could be selected as a destination. User may define a mapping for fields so that values will be copied from the source fields to the new fields of the destination item. MetaVis Migrator supports wide variety of field mapping strategies like mapping of Choice or String fields to Lookup field which make MetaVis Migrator a perfect tool for the content re-classification and enhancement of content metadata. To activate fields mapping during item level copy select destination content type on the Properties page of MetaVis Copy Items Wizard. In this mode new values for fields could be selected by using Left-Arrow or Down-Arrow buttons located near each field.
  
• Data Analysis Mode for Item Level Copy enables preview of field values during field mapping. It is often beneficial to see all possible values that appear in certain field for all items selected for item level copy. One of the values could be selected as a value for the selected field in the destination item. Enable menu item "Edit / Data Analysis Mode" to activate this mode and use Down-Arrow button on the Properties page of MetaVis Copy Items Wizard to preview field values for the selected field during mapping. Data Analysis Mode could be used to understand current data in source SharePoint lists prior to the migration project and build MetaVis migration templates to facilitate repeatability during migration.
• Folder Copy initiates item level copy for all items in the selected folder in SharePoint or on a file share. Folder copy will also include all sub-folders of the selected folder into a copy operation. To activate a folder copy the folder could be copied or dragged from the Navigator or Content Views into the other folder or a list on the Navigator or Content Views. This mode of copying could be used to mass copy items located in folders.
• List Copy allows to select a list or several lists in a certain site and copy them all to another location. In the process MetaVis Migrator will create each list in the target site together with all required fields and content types and optionally will copy content, list views and list permissions. MetaVis Migrator will copy items preserving their content type and field values as they were in the source list. This mode of copy could be activated by copying of a list node in the Navigator View and pasting it on the site, dragging and dropping list node in the Navigator View or using List Copy Wizard available in the Tools menu. This mode of copying could be used to mass copy lists with items or to copy list structures and views.
• Site Copy will allow users to copy sites from one location to the other one or to copy certain site objects to the existing sites. This function will optionally allow to include all sub-sites into a single copy operation, optionally support copying of the lists, list views, list items and site permissions. This function will later be extended to include other site objects like master and layout pages, web parts, security groups, etc. Site Copy could be activated by copying a site node and pasting it to the other site in the Navigator View or by using Copy Site Wizard available in the Tools menu. Site Copy could be used to bulk copy the site hierarchies without changing site structures.

Copying items between SharePoint lists or file system shares could be performed using MetaVis Classifier, Migrator or Architect Studio. If you use MetaVis Architect Suite switch to Classifier mode by pressing yellow tag in the application toolbar.

Connect to source and target SharePoint sites before starting to copy items. It will display site hierarchies, lists and folders in the left side Navigator View. Double clicking of a list or a folder in the Navigator View will display folders, items and documents in the right side Content View. There is also My File System View that displays drives and folders. Double clicking of a folder in My File System View will display folders, items and documents in the right side Content View.

There are several ways to initiate copy operation that will move items between SharePoint sites or load files from file system shares.

• Select source items, copy them into clipboard and paste them to the destination list or folder
• Select source items and drag and drop them to the destination list or folder
• Select source items in the Content View, right-mouse click on the Content View and select "Copy To..." menu item which will display a "Copy Items" wizard. Select destination site, list and folder on the first page of the wizard and proceed to the properties and copy pages
• Open second MetaVis Window by selecting Window / New Window menu item or by pressing Crtl-N keyboard shortcut. Arrange windows on the screen (to auto-arrange, right click on the Windows Task Bar and select Arrange menu item). Copy / Paste or Drag and Drop items between MetaVis windows
• Open Tools / Copy Lists and Libraries wizard and follow its pages to copy lists and libraries and (optionally) their content (items or documents) between the sites and site collections
• Open Tools / Compare Sites wizard and follow its pages to copy lists and libraries structures between the sites and site collections. This method does not allow to copy content (items or documents) but it does allow to copy definitions to multiple destination sites

The following items could be copied or dragged:

• SharePoint items, folders or documents in Contents View
• File System files or folders in Content View
• SharePoint lists and folders in Navigator View
• File System folders in Navigator View
• File System folders in My File System View

The following items could be used as target containers where the selected items could dropped or pasted

• SharePoint folders in Contents View
• SharePoint lists and folders in Navigator View

Use the following shortcuts to select multiple items. A item could be a SharePoint item, folder, document or file system file in the Content View, List or Folder in the Navigator View or a Folder in My File System View.

• Mouse Click selects an item and clears previous selection
• Crtl-Mouse Click adds an item to the existing selection or removes existing item from the selection
• Shift-Mouse Click adds a group of items to the existing selection or removes a group of items from the selection
• Ctrl-A selects all items in the Content View

There are several ways to copy and paste items after they selected

• Right mouse click and select Copy or Paste
• Select menu item Edit and then Copy or Paste
• Use keyboard shortcuts Crtl-C / Ctrl-V

MetaVis Architect Custom Column Types Profile Manager (Profile Manager) Profile Manager is designed to define custom column types for use by MetaVis Architect. Once the initialization is completed, Architect can understand, display and provision these column to SharePoint. Please note, that in order to complete the configuration you must understand how the column was initially constructed in SharePoint. Profile Manager can be invoked by selecting File / Custom Columns Profiler. Press the Create button to begin initializing a custom column type. After profile is created is should be saved by "Save Profile" button. Existing column type profiles could be edited by selecting profile in Profile drop down box. Profiles may be distributed among multiple MetaVis Architect installations by using Export and Import functionality. Column type profile contains the following properties:

• .Column Icon. This icon will be used by MetaVis Architect to display corresponding columns on the diagram and in the Palette. Column icons can be chosen from one of the predefined options or can be uploaded into the profile
• .XML Name. This is your column type internal name. This should be available as part of a feature.xml distribution.
• .Display Name. This name will be displayed wherever the column is used in MetaVis Architect
• .Scope. Defines where this column will be provisioned in SharePoint (e.g. site, list or both).
• .Vendor Information. Optional field containing custom column type vendor data

In addition to general profile properties described above, Profile Manager can be used to define unique characteristics for the custom column type. You may define these by selecting a column type profile and pressing the "Create" button in "Column Characteristics" area. Each characteristic has the following properties:

• . XML Name. The is your characteristic internal name. This should be available as part of a feature.xml distribution.
• . Display Name. This name will be displayed in the Properties Tab for the this column type.
• . Data Type. This value will be displayed in the Data Type field for this column type property in the Properties Tab.
• . Do Not Use. This indicator is used to signify that the characterisitic should be excluded from the MetaVis Architect Properties View.

After defining characteristic properties the characteristic should be saved by using "Save Characteristic" button. Note that this button does not save the whole profile. A profile may contain many characteristics.

A selected characteristic may be removed, but the whole profile should be saved using "Save Profile" button after any changes in characteristics are made.

MetaVis Architect is an offline application. After you added objects to a diagram and decided that this is right time to provision them in the SharePoint site, right click on the site icon in the Navigation Tree, select "Compare With... / Last Loaded Version" or "Compare With... / Latest from SharePoint" that will display a Compare Report. Select some, all or group of records in the Compare Report, right click and select "Update SharePoint". This command will actually start creating objects in SharePoint site. Look for update status that will be displayed in the Compare Report.

There are two ways to make MetaVis to pick up new objects created in SharePoint:

1. Right click on the site icon in the Navigation Tree and select “Compare With … / Latest from SharePoint”. It will download latest SharePoint structure and show compare report where you will see new object. Right click on the object in the Compare Report and select “Update Diagram” so this list will appear in MetaVis. You may need to right click on “Lists” (or Content Types) icon to refresh the view after this.

2. You can do the same things faster by doing this: Right click on the site icon in the Navigation Tree and select Refresh. When you do it for the site, MetaVis will connect to SharePoint and retrieve new site structure. At the end it will ask you whether you want to replace the local data and you should say Yes. It does it because it assumes that you may make changes in the local site diagram (like add new content type or a column) so it confirms that it is fine to overwrite them with the latest data from SharePoint site. You may need to right click on “Lists” icon in the Navigation Tree after this to refresh the view.

For effective indexing and throttling, SharePoint, by default, limits the amount of items and lookups allowed per query. If you have received either of the above messages, then you have encountered this limitation and will need to perform these steps for resolution.

1.) Login into SharePoint's "Central Administration"
2.) Navigate to "Application Management" and then "Manage web applications"
3.) Select the Web application that you would like to modify and then click the General Settings drop down located in the Ribbon.
4.) Select Resource Throttling
5.) Scroll down and locate the option called "List View Lookup Threshold" and increase this value. (Default value is 8).
6.) Click OK to save the change.

For effective indexing and throttling, SharePoint, by default, limits the amount of items and lookups allowed per query. When that limit is exceeded the query fails and the message "No Data Found" is displayed.

If you have received this message and are sure there is actually content in the selected list, then you have encountered this limitation and will need to perform these steps for resolution.

1.) Login into SharePoint's "Central Administration"
2.) Navigate to "Application Management" and then "Manage web applications"
3.) Select the Web application that you would like to modify and then click the General Settings drop down located in the Ribbon.
4.) Select Resource Throttling
5.) Scroll down and locate the option called "List View Lookup Threshold" and increase this value. (Default value is 8).
6.) Click OK to save the change.

I have been unable to resolve an issue or feel that a MetaVis product is functioning incorrectly, we welcome your feedback.

There are several items that we ask you to provide us so we can diagnose any issues in a timely manner.

- Log files - there are log files generated by the system that can provide us clues about the issue.  An additional level of logging is also available under Debug mode.  Please see instrucitons on sending us log files below.

- Screen shots - a picture is worth a thousand words :-).  If you can take some screenshots and send them along with the logs, that would be very helpfull

How to collect logs:

1. Go to Help ribbon and turn on Debug Mode.
2. Repeat the operation that is causing the issue.  Try to limit this to as few items as possible.  So for example, if you are having an issue copying 20 files, just use one of them for this test.  This will reduce the amount of data we need to review.
3. Return to the Help ribbon and turn off Debug Mode.
4. Press the Log Manager Button and then select a location to store log files. 
5. Then press the Save Environment button.  
6. Please send the zip file (along with any screenshots) created in step 4 back to us at support@metavistech.com or if it too large please use the following drop box: http://dropbox.yousendit.com/MetaVisSupport121114118

This message appears when you are running MetaVis as Administrator. To overcome the message, exit MetaVis and relaunch using the Windows user account that is configured within Outlook.