Troubleshooting

Some of my users see scroll bars on individual days of a calendar roll-up and some do not. Why?

If some of your users utilize Firefox and others utilize Internet Explorer, you may find that your IE users see a scroll bar on the calendar for days that contain more items than can be displayed in the available space. Firefox users will not see the scroll bar.

I recently upgraded to Fall 2007. I have a color-coded calendar, but it doesn’t print in color. Why not?

If your calendar utilizes color-coding, your browser configuration may prevent the colors from printing correctly. To ensure that all appropriate items on the calendar are printed in color, follow these steps:

1.  Within your browser, select Tools.

2.  Select Internet Options. The Internet Options window is displayed.

3.  Click on the Advanced tab.

4.  Scroll down to the Printing section.

5.  Select the Print background colors and images option.

6.  Click OK.

I tried to color-code some of the items on my calendar, but they aren’t showing up the way I expect them to.

Make sure that the field you are using to define the color-coding is part of the schema. Out of the box, the calendar roll-up supports the schemas listed in the Supported Schemas section of this help. Alternatively, you can use the Roll-Up Wizard to create a custom schema.

I don't see an event that I created six months into the future in the calendar.

The calendar roll-up web part utilizes the "Current Events" view, so only the next 50 upcoming events will be displayed on the calendar. This is by design, so as not to overload the server at web part implementation. If you want to see more than 50 upcoming events, you can modify the "Current Events" view to display more than 50 events at a time. This is the only acceptable change permitted to the "Current Events" view.

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

This is because you do not have the same rights as someone else. You can only see those sites which you have permission to access.

I created an event list and added a new column. I pointed the calendar roll-up to this list and configured it to look at this new column as a search field. It creates a drop-down list as I expected for the search, but it doesn’t work consistently. Why?

The out-of-the-box event calendar roll-up can only search on the Title and Date columns. The search described above looks for data from another column. If you want to do this, you will need to use the Roll-Up Wizard to create a custom calendar roll-up that includes the new column as a searchable field.

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.

The calendar doesn't display any items.

This indicates one or more 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 items from 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.

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 Roll-Up Advanced - Documents)?

No, it does not. You must make sure that the list in question was created with the proper list template and that the fields required are within it. Outside of that, you can name the list anything that you want.

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 CAML to filter the list before the data is returned. Collaborative Application Markup Language (CAML) is an XML-based language used in SharePoint. Pre-filtering performed through CAML reduces the number of list items received by the roll-up. You can build a CAML filter on the Filtering tab of the administration interface.

      Since the information returned by a calendar roll-up comes directly from the "Current Events" view, the total number of events returned and distributed into the calendar display will decrease your performance once you have 200 events or more. This is due to your browser and bandwidth, not the web part. Because your browser can only handle so much information and rendering at a given time, it will begin to slow down the rendering when too many events exist. To deal with this issue, you can control how many items are returned in the "Current Events" view to cut down the response so that it will not overload the browser.