Troubleshooting

I just executed a search and now I don’t see the number of items in each group in the roll-up display. Why?

In order to address an issue with list item counts, the action-enabled roll-ups do not display the number of items for each group after a search has been performed. However, if a search has not been run, the item count will still be shown.

I see the message "Please Execute a Search..." and no items are returned.

This is because the web part in question is set to not show results until a search has been executed. Please enter a searchable text entry into the search box, or choose a search entry from a search list and then press the Search button. Once you have done this, you should see the results displayed or a message stating that no items were found.

I see the message "Requested Result Has Timed Out" and no items are returned.

This is because the web part in question has multi-threading enabled and the current setup of your Web.Config file won't support the amount of time required to return the data from SharePoint. Multi-threading is enabled and disabled on the Other tab (Summer 05 and later releases) or in the Administration Properties section of the web part tool pane (previous releases).

I do not see the same sites that someone else does.

This is because you do not have the same rights as someone else. Only those sites which you have permission to access will be presented to you.

I receive the error "The format of the URL you specified is incorrect."

This means that the URL you entered in the web part’s "Status Properties" field can not be understood. Please go to the Status Properties field and double-check how you specified the URL. The format of the URL must be either http://Site-URL or http://Site-URL/Sub-Site-Name.

I receive the error "The URL you specified was incorrect and the site cannot be found."

This means that the URL you entered in the web part’s Status Properties field can not be understood. Please go to the Status Properties field and double-check how you specified the URL. The format of the URL must be either http://Site-URL or http://Site-URL/Sub-Site-Name.

I receive the error "No Lists Found"

This indicates that no lists have been found for the site and levels chosen. You should make sure that you have access to the sites you would like search and that you have entered a numerical value in the "Levels Returned" text box on the Sites and Lists tab (Summer 05 and later releases) or the administrative window (previous releases).

I receive the error "The List Being Returned XML is incorrectly formatted."

This indicates that manual administration of the shared web part property "Lists Being Returned" was attempted. Please remove and add the web part to the page and then select the lists to be returned again.

I receive the error "No Items Found..."

This indicates one of the following:

· The search criteria and/or filter criteria is incorrect

· The user doesn't have access to the list(s) selected

· The list or site no longer exists

· There is no data within any of the lists you have searched

To test your search text, try searching for text taken directly from one of your target lists to see if anything is returned. To test your filter criteria, try choosing a different filter field and searching for the same text to see if anything is returned.

If your search continues to yield no results, check that your target lists are populated, that your target lists and sites still exist, and that you have access to them.

I don't see a list that I know exists within the site.

This can occur for a few reasons:
1) The list must have all of the List Template Required Fields within one of the List Templates Supported (see the Supported Schemas help topic)
2) The list must have been created utilizing the proper list template.

My roll-up does not include documents in some of my folders. Why not?

When the Filter Builder is used to apply a filter to an action-enabled roll-up, documents in the root folder and folders one level deep are shown. However, documents in folders below the first level are not shown. If you must include items in multiple levels of folders, you will need to do one of the following:

· Do not apply a filter OR

· Use either a Spreadsheet or a Tree View roll-up and manually define a basic filter (not CAML-based, not created with the Filter Builder).

How must a list be set up in order to be returned by the web part?

Lists should be created via SharePoint’s default list template, or with a CorasWorks-generated list like Updated Contacts, to be returned within the web part for selection.

Does the list returned have to be named the same as the Web Part (i.e., Document Actions - Documents)?

No, you can name a list anything you want. However, you must make sure that your list was created with the proper list template, and contains the proper fields.

The response time seems slow. Does CorasWorks have any suggestions for improvement?

The following suggestions apply to all roll-ups:

· Do not put more than one roll-up web part on a page. Since roll-ups are processed serially, adding several roll-ups to a page can cause a considerable delay in returning the page to the user, although this depends on the configuration of the web parts.

· While roll-ups can be set to pull data from an unlimited number of levels, users will experience the best performance if you configure the roll-up to look no more than 6 or 7 levels deep. As the number of levels increases, the number of sites and lists queried also increases exponentially.

· Limit the number of lists queried.

· Limit the number of fields returned.

· If you have no choice but to hit a large number of sites and lists, use the Filter Builder to filter the list before the data is returned. The Filter Builder converts all filter to Collaborative Application Markup Language (CAML), an XML-based language used in SharePoint. Pre-filtering performed through CAML reduces the number of list items received by the roll-up. The Filter Builder is on the Filtering tab of the administration interface.

Some of my users cannot see the actions I made available on a roll-up.

The roll-up will only display the actions from the action libraries to which the user has at least Read access. If the user does not have at least Read access to a particular action library, those actions will not be displayed to that user.

One of the actions I made available on a roll-up always fails.

The action may not be compatible with the schemas of both the source lists included in the roll-up and the destination list. For example, if you are working with an event roll-up, you do not want to select an action that updates the status of a task (or any action that references a column that does not exist in the affected list).

If you enable an incompatible action for the roll-up and a user selects that action, it will always fail. You need to be sure that the columns that are populated or updated exist in both the source list and the destination list. Naming your action definitions clearly goes a long way toward avoiding this potential problem.

Also, if you are working with a version before the Winter 2006 Update, you should not activate a Create List Item or Modify List Item-type action on a document roll-up. These two types of actions did not support document libraries until the Wsinter 2006 Update.

Why are some of the properties on the Sites & Lists tab grayed out?

When Central Configuration is enabled, some of the properties that are usually managed via the Sites & Lists tab are managed instead by the entries in the Central Configuration List. As a result, those properties will be grayed out (unavailable).