Академический Документы
Профессиональный Документы
Культура Документы
User's Guide
Information in this document, including URL and other Internet Web site references, is subject to change
without notice. Unless otherwise noted, the companies, organizations, products, domain names, e-mail
addresses, logos, people, places, and events depicted in examples herein are fictitious. No association
with any real company, organization, product, domain name, e-mail address, logo, person, place, or event
is intended or should be inferred. Complying with all applicable copyright laws is the responsibility of the
user. Without limiting the rights under copyright, no part of this document may be reproduced, stored in
or introduced into a retrieval system, or transmitted in any form or by any means (electronic, mechanical,
photocopying, recording, or otherwise), or for any purpose, without the express written permission of
Microsoft Corporation.
Microsoft may have patents, patent applications, trademarks, copyrights, or other intellectual property
rights covering subject matter in this document. Except as expressly provided in any written license
agreement from Microsoft, the furnishing of this document does not give you any license to these patents,
trademarks, copyrights, or other intellectual property.
Microsoft, MS-DOS, Windows, Windows Server, Windows Vista, Office Excel, Office InfoPath, Office
Outlook, Office PowerPoint, Office Word, and Windows SharePoint Services are either registered
trademarks or trademarks of Microsoft Corporation in the United States and/or other countries.
i
Groove 2007 User’s Guide Table Of Contents
Contact Search........................................................................................................................1
Groove/Messenger integration...................................................................................................1
Starting Groove..........................................................................................................................5
Logging in to Groove...................................................................................................................5
Exiting Groove.........................................................................................................................5
Workspaces panel....................................................................................................................7
Contacts panel.........................................................................................................................8
ii
Groove 2007 User’s Guide Table Of Contents
Common Tasks........................................................................................................................9
Tool area..............................................................................................................................10
Workspace Members...............................................................................................................12
Toolbars................................................................................................................................13
Repositioning toolbars....................................................................................................13
Groove indicators......................................................................................................................15
Chat Indicators......................................................................................................................16
iii
Groove 2007 User’s Guide Table Of Contents
Editing the text display for Groove and Web URL hyperlinks.........................................................18
Removing hyperlinks.....................................................................................................19
Types of workspaces...............................................................................................................22
Workspace limitations.............................................................................................................22
Tool permissions....................................................................................................................25
Managing Workspaces...............................................................................................................26
iv
Groove 2007 User’s Guide Table Of Contents
Deleting a workspace................................................................................................................31
Duplicating a workspace............................................................................................................31
Renaming a workspace..............................................................................................................32
Invitation alerts.....................................................................................................................36
v
Groove 2007 User’s Guide Table Of Contents
Upgrading the Groove version requirement for adding new tools to a workspace...................45
About asking another workspace member to add tools from earlier versions of Groove...........45
vi
Groove 2007 User’s Guide Table Of Contents
Creating a file sharing workspace using the Create New Workspace wizard....................................52
About creating a file sharing workspace from a folder that's already being synchronized in another file
sharing workspace.................................................................................................................53
vii
Groove 2007 User’s Guide Table Of Contents
Renaming the root folder of a file sharing workspace in your Windows file system..........................59
Special cases.........................................................................................................................62
Adding files..............................................................................................................................65
Managing files..........................................................................................................................66
Renaming a folder..................................................................................................................67
viii
Groove 2007 User’s Guide Table Of Contents
Checking out files from a SharePoint document library in a SharePoint Files tool.............................75
Discarding a checkout.............................................................................................................76
ix
Groove 2007 User’s Guide Table Of Contents
Searching in a Discussion...........................................................................................................86
Addressing a message............................................................................................................87
x
Groove 2007 User’s Guide Table Of Contents
From:...................................................................................................................................88
Attachments..........................................................................................................................89
Images.................................................................................................................................89
Determining which Groove contacts are also in your messenger contact list...................................90
xi
Groove 2007 User’s Guide Table Of Contents
Searching in a chat.................................................................................................................95
Editing appointments.................................................................................................................98
Viewing appointments................................................................................................................98
Printing appointments..............................................................................................................101
xii
Groove 2007 User’s Guide Table Of Contents
About meetings.......................................................................................................................106
Adding attachments..............................................................................................................108
Opening attachments............................................................................................................108
Saving attachments..............................................................................................................108
Deleting attachments............................................................................................................108
Viewing notes......................................................................................................................110
xiii
Groove 2007 User’s Guide Table Of Contents
Adding text..........................................................................................................................116
Editing text..........................................................................................................................117
Adding pictures....................................................................................................................119
Viewing pictures...................................................................................................................119
Editing pictures.......................................................................................................................119
Renaming pictures................................................................................................................120
Exporting pictures...................................................................................................................120
Copying pictures.....................................................................................................................120
xiv
Groove 2007 User’s Guide Table Of Contents
Reading a record.....................................................................................................................123
Editing a record......................................................................................................................123
Copying records......................................................................................................................123
Deleting a record.....................................................................................................................124
Changing views.......................................................................................................................125
Printing records.......................................................................................................................126
Print all records that are listed in the currently selected data view.....................................126
Importing records...................................................................................................................127
xv
Groove 2007 User’s Guide Table Of Contents
Exporting records....................................................................................................................129
Running a macro.....................................................................................................................132
Sorting records.......................................................................................................................135
xvi
Groove 2007 User’s Guide Table Of Contents
Form objects...............................................................................................................140
View objects...............................................................................................................140
Scripts.......................................................................................................................140
Styles........................................................................................................................141
Macros.......................................................................................................................141
Importing the 2.5 Forms tool data records into a new Forms tool................................................144
Caveats for importing 2.5 Forms records into a new Forms tool..................................................144
About Custom Tools Created with the Groove InfoPath Forms Tool.................................................144
xvii
Groove 2007 User’s Guide Table Of Contents
InfoPath field data types eligible for promotion and import into a Groove InfoPath tool.........147
Requirements for using Replace Design with custom tools created via InfoPath Forms..........149
Deleting a form....................................................................................................................153
Creating fields......................................................................................................................154
xviii
Groove 2007 User’s Guide Table Of Contents
Changing the row span for a selected field, field group, or tab group..................................161
Duplicating fields..................................................................................................................161
xix
Groove 2007 User’s Guide Table Of Contents
Attachments field........................................................................................................164
Contact field...............................................................................................................165
Currency field.............................................................................................................165
Image field.................................................................................................................168
Modifying an option..........................................................................................169
Deleting an option............................................................................................170
Number field...............................................................................................................170
Modifying an option..........................................................................................172
Deleting an option............................................................................................172
Password field.............................................................................................................172
Text field....................................................................................................................174
xx
Groove 2007 User’s Guide Table Of Contents
Hiding a view..............................................................................................................178
Removing a condition..............................................................................................181
xxi
Groove 2007 User’s Guide Table Of Contents
Hierarchical sorting.................................................................................................185
Flat sorting............................................................................................................185
Grouped sorting.....................................................................................................185
xxii
Groove 2007 User’s Guide Table Of Contents
Modifying a lookup......................................................................................................193
Deleting lookups.........................................................................................................193
Deleting contacts....................................................................................................................196
xxiii
Groove 2007 User’s Guide Table Of Contents
Hiding a contact......................................................................................................................202
Default identity...........................................................................................................203
Managing Identities.................................................................................................................203
Deleting an identity..............................................................................................................206
xxiv
Groove 2007 User’s Guide Table Of Contents
Messenger integration.............................................................................................210
Email options..............................................................................................................210
Renaming a computer..................................................................................................212
Managing Alerts......................................................................................................................213
xxv
Groove 2007 User’s Guide Table Of Contents
Recommendations.......................................................................................................216
Pausing communications.......................................................................................................219
Working offline.....................................................................................................................219
Responding to alerts................................................................................................................220
Suppressing alerts................................................................................................................220
Index.......................................................................................................................................226
xxvi
Chapter 1. Introduction
Microsoft® Office Groove® 2007 is Internet software for making direct connections with the people who
are important to you. With Office Groove 2007, you can bring together team members from both inside
and outside your company, with no IT assistance required and no need to waste time thinking about
firewalls, servers, security, or network access. Additionally, you can enjoy the efficiency of always
knowing each other's virtual location, or online presence, thus allowing for organic and quick
conversation and collaboration.
This topic describes new features and other changes in Microsoft Office Groove 2007.
Contact Search
Office Groove 2007 provides a simplified process for searching for contacts. The search facility now allows
you to simply type in the name or email address you are looking for and click Find. Groove will search all
available directories to find a match for your entry. You can also optionally enable searching in the Public
Groove Directory.
Groove/Messenger integration
If you have Integrate Messenger Contacts enabled in your preferences (the default setting), you can view
Messenger online status for all Groove contacts who also run Messenger, and start Messenger activities
with these contacts, such as text-chatting or voice-over-IP (VOIP). Additionally, the first time you start up
Groove after installation or upgrade, you are prompted to add all Messenger contacts who also have
Groove to your contact list.
The Groove SharePoint Files Tool is an enhanced version of the Groove Files Tool, with features intended
for synchronizing file content between Groove and SharePoint document libraries.
The Groove InfoPath Forms Tool enables application developers to create and lay out most design objects
(forms and the fields that display on forms) in Microsoft InfoPath 2007, and then import the solution into
the Groove InfoPath Forms Tool designer. Alternatively, developers can also use the Groove Forms Tool to
create custom applications.
The Groove Discussion Tool is now a custom Forms tool. It looks and behaves the same as the Discussion
tool from earlier versions of Groove, with the addition of a Category field and views for sorting Discussion
threads either by category or by date.
In the Groove Meetings Tool, the "Participants" tab is renamed to the "Attendees" tab. The tool now
supports assigning permissions to Groove user roles.
1
Groove 2007 User's Guide
The list below describes the features and tools no longer available in this release. The lengthy number of
items mostly reflects adjustments to the feature set as the Groove application becomes part of Microsoft's
Office offerings. Additionally, this release focuses on ensuring the highest quality of the key features that
receive the most use.
• The following tools and toolsets are no longer available for adding to new or existing workspaces:
Contact Manager, Discussion, Document Review, Outliner, Task Manager, Text, Tic-Tac-Toe, Web
Links, Welcome Page, Advanced Project Toolset, and Mobile Workspace for SharePoint.
A new version of the Groove Discussion Tool (as described above) is now available.
The Groove SharePoint Files Tool replaces Mobile Workspace for SharePoint. Note that you can no
longer synchronize data between an existing mobile workspace and its associated SharePoint site.
• Chat-only workspaces. Chat is now available only as part of standard or file sharing workspaces.
• Outlook Calendar integration with the Groove Calendar and Groove Meetings tools.
• Launching Netmeeting.
• XMPP Proxy Server and Client features (i.e., interacting with Jabber users).
• Forms tools created in Groove versions prior to Groove 2.5 will not be accessible.
• Forms tools created in Groove 2.5 will be accessible only for the purpose of exporting data.
Exported data can then be imported into a new Forms tool.
• Groove no longer supports installing new tools via component injection. That is, you can no
longer install new tools in your Groove account by opening a .grv or .gcd file. Additionally, tools
previously installed via component injection will no longer function in existing or new workspaces.
• Groove accounts can no longer be uploaded to groove.net for backup or for setting up use on
multiple computers. Multiple computers usage now requires saving your account file manually.
2
Introduction
Groove provides the following features for helping to keep your data secure:
You can secure your account either with a password or via a certificate stored on a Smart Card.
Passwords encrypt and integrity-protect your account. Groove automatically protects your data
using random keys stored in your account.
• Manual verification, whereby you personally verify the identities of other Groove users.
• Certification, whereby a digital certificate is assigned to a contact identity by a certificate
authority, such as those from VeriSign®. Certification is administrator-managed verification.
• Roles and permissions. Roles are assigned to workspace members and specific permissions, such
as reading or editing privileges.
• Virus scanning. If you have a supported virus scanning program installed on your computer, you
can enable an account preference to scan all incoming and outgoing files for viruses.
• Communications "tagged" with your identity. All of your memberships in workspaces, as well as
any messages or invitations you send, are cryptographically "tagged" with your Groove identity.
Invitation and message recipients can verify your identity based on this information.
• Encrypted communications. All updates you make in a standard workspace are encrypted when
you send them and then decrypted when they are received to ensure that only other members of
the workspace will be able to read them. Instant messages are also encrypted and then
decrypted in the same manner. All information sent and received by Groove is confidentiality
protected.
Note: Security for file sharing workspaces depends on the security measures you have set for your
Windows operating system.
• Encrypted temporarily stored data. Information you send may sometimes be stored temporarily
on a server (for example, if the intended recipient of the information is not currently online), but
that information is always encrypted using keys not known to the server.
• Enterprise policies. Centrally administered policies allow Groove administrators to configure
policies that are then enforced at the client and end user level.
3
Chapter 2. Installation and Setup
The first time you start up Groove, the Groove Account Configuration Wizard opens and displays a
"Welcome to Groove" screen. Complete the wizard as follows:
If you want to use a Groove account you already have on another computer instead of creating a
new account, select Use a Groove account you have already created . See Using your account on
another computer for more information.
2. If prompted, select a certificate for verifying your Groove identity, and click Next.
You see this prompt only if your Groove account is governed by a management policy that requires
a signed verification certificate. Typically, such certificates are used in workplaces that use a
"smartcard" log-in system.
3. If prompted, select an option for the Groove Account Configuration Code prompt and click Next.
• If you already have your Groove Account Configuration Code handy, click I have a
Groove Account Configuration Code
• If you don't know where to find your Groove Account Configuration Code, but you think
an administrator has created one for you, click I need help finding my Groove Account
Configuration Code.
• If you don't have a Groove Account Configuration Code, and you believe you don't
require one for this Groove account, click I don't have a Groove Account Configuration Code.
4. If prompted, enter your Groove Account Configuration Code and the Groove Account
Configuration Server.
Typically, the Groove Account Configuration Server information is filled in for you. If it's not, and
you're unsure of what to enter in this field, ask your Groove administrator.
5. Complete the Enter Groove Account Information screen as follows and click Next:
The name you enter is the contact identity (display name) by which people will recognize you.
Depending on how you obtained Groove, the account name and email address fields may
already be filled out for you and not editable. This is typically the case if you obtained Groove
at your workplace either as part of Microsoft Office or as a separate download.
Note: You cannot use the following characters in an account name: {}=/;
If you selected a verification certificate (from Step 2), you can click the link to use a smartcard
or certificate to secure your account (instead of using a password).
6. Select an option for listing your account identity in the Public Groove Directory.
4
Installation and Setup
Listing your account identity enables other Groove users to find you and start Groove activities
with you.
7. Click Finish.
When you complete the Account Configuration Wizard, Groove creates the account and opens the Groove
Launchbar.
Starting Groove
To start Groove:
1. Click Start, then select All Programs-Microsoft Office-Microsoft Office Groove 2007.
Tip: You can enable an option in your Account Preferences to always start Groove when Windows starts
up.
Logging in to Groove
To log in to Groove:
1. Click the Groove icon in the Windows notification area and select Open Groove.
2. If you log in using a password, enter your password and click Login.
3. If you log in using a smart card certificate, click Login.
Logging off from Groove clears private user information and requires re-entering your Groove log-in
password before you (or anyone else) can view your data.
The Groove icon appears grayed to indicate that your account is currently logged off:
When you log off your account (or exit from Groove), you may get a Temporary File Warning.
Exiting Groove
To exit Groove and log off all accounts, click the Groove icon in the Windows notification area and select
Exit.
5
Groove 2007 User's Guide
In addition to online Help, there's a wealth of other information on using Groove. You can:
You can also send customer feedback to Microsoft about Groove 2007.
The Getting Started movie is an online self-paced, animated tutorial that illustrates key Groove concepts
and features. You can view the entire movie or skip among specific sections of interest.
To send customer feedback to Microsoft, select Help-Customer Feedback Options... and select options in
the Service Options dialog box.
6
Chapter 3. Basic Features
The Groove Launchbar opens when you first start up Groove, unless you change your Groove start-up
options. You can initiate all Groove activities from the Launchbar.
To open the Launchbar, double-click the Groove icon in the Windows notification area, or click the Groove
icon and select Launchbar. If you're not logged into your account, Groove will prompt you to enter your
password before opening the Launchbar.
The Launchbar contains two panels, one for creating and managing workspaces, and the other for
managing Groove contacts.
To switch the layout of the Launchbar between tabbed panels (the default layout) and stacked windows,
select Options-Tabbed View.
The Launchbar includes a Common Tasks pane, with options that change to correspond with your current
activity or selection. For example, if you select a contact in the Contacts panel, you see options to send a
message or invitation to that contact.
Workspaces panel
The Workspaces panel displays a list of your workspaces. You can start activities from the Workspaces
panel as follows:
• Double-click any workspace to open it. The workspace opens into a viewer that corresponds with
its workspace type. For example, standard workspaces open in the Groove Workspace Explorer;
file sharing workspaces open in a special layout in Windows Explorer.
• Right-click any workspace to see menu options for managing the workspace. For example, you
can open workspace properties, rename, pause, or delete the workspace, save a workspace as an
archive or template, and invite people as new members.
• Click New Workspace to create a new workspace.
There are several ways you can list your workspaces. Select Options-View Workspaces By, and select an
option.
7
Groove 2007 User's Guide
Note that within each category, workspaces are sorted top to bottom by "most recently read".
Contacts panel
The Contacts panel lists all people you've added to your personal list. These can include Groove, Microsoft
Communicator, and e-mail contacts. You can start activities from the contacts panel as follows:
• Double-click a Groove contact to open the Groove Send Message window and create a message.
• Drag a contact to a workspace in your Workspaces List to open a workspace invitation addressed
to that contact.
Tip: You can drag contacts to a workspace even if Workspaces and Contacts are separate tabs.
Drag the contact to the Workspaces tab to display that tab and then select the workspace.
• Right-click any contact name to see a menu of activity options. For example, you can send an
invitation to the contact; delete the contact; set alerts; export the contact; and e-mail your
Groove contact information to the contact.
• Click Add Contact to search directories and add new contacts to your list.
There are several ways to list contacts. Select Options-View Contacts By, and select an option.
To immediately go to the workspace, right-click the contact and select Go to Active Workspace. If
the selected member is active in several of your workspaces, a Select Workspace window opens
and displays a list.
An idle indicator is appended to contacts who are online but who have not done activities at their
computer for at least the past 15 minutes. If you want, you can select an option in your
preferences to segregate idle contacts to the bottom of the Online list.
8
Basic Features
You can organize your contacts in folders. You see categories by selecting the option to view folders.
Folders are created at the same level as the selected folder (if any). For example, if you select a
contact that's already in a folder, the new folder will appear hierarchically within that folder.
Click in the status bar to pop up a list of your workspaces. Uncheck or check workspaces to pause or
resume communication activities. Data counters report on the flow of incoming and outgoing data. To do
more Communications Manager activities, click the Communications Manager link.
Common Tasks
The Common Tasks pane lists options that are intended to correspond with your current activity or
selections. For example, if you select a workspace in the Workspaces pane, common task options pertain
to workspaces, such as sending invitations or showing workspace properties.
9
Groove 2007 User's Guide
The Groove Workspace Explorer is the main window where you do most Groove activities, such as
collaborating in workspaces. It consists of the following components:
• Tool area
• Workspaces menu or Workspace List
• Workspace Members
• Status bar with access to the Communications Manager and Message History
Tool area
The tool area contains the tools included in the workspace. You can work with the components of the tool
area as follows:
Workspace tool tabs indicate the number of members who currently have the tool selected. Point
at the tool tab to display a status window.
• Click the Add Tool drop-down icon to add a new tool to the workspace:
Select View-Toolbars-Explorer Toolbar to show or hide the Workspaces drop-down menu in the menu bar.
You can also reposition the Workspaces menu in the menu bar.
The Workspace List is a customizable window that displays to the left of the tool area. Select View-
Show/Hide-Workspace List to show or hide the Workspace List panel. You can also close the Workspace
List by clicking its Close button.
Both the Workspace List and the Workspaces menu list all the workspaces in your account that you can
open in the tool area. Click a workspace title to open that workspace. (File sharing workspaces are listed
only in the Launchbar).
Note: If you are using a Groove account you've added from another computer, the list includes only the
names of your workspaces. You can right-click a workspace to see a list of downloading options.
Select View-Show/Hide-Tools in Workspace List to show or hide a hierarchical list of tools in your
workspaces. Click workspace tool names to go to specific tools in the workspace.
10
Basic Features
Workspaces
Tools in a workspace
Unread marker, indicating new or unread information within the previous seven days, but older than 2
days
Toolset in a workspace
Tools in a toolset
Number of members in the workspace
Drag border to narrow or widen the pane
Point at a workspace to display a status window that lists the last modified date, and members who are
currently in the workspace.
There are several ways you can list your workspaces. Select Options-View Workspaces By, and select an
option.
• Active. Workspaces that you and/or other members currently have open for reading or updating.
• Unread. Workspaces containing new or updated information that you have not yet read.
• Read. Workspaces that do not currently contain any information you have not read.
• Not On This Computer. Workspaces you have on other computers. You can download the
workspace data either from another computer that contains your account or from another
workspace member.
11
Groove 2007 User's Guide
Note that within each category, workspaces are sorted top to bottom by "most recently read."
Workspace Members
Select View-Show/Hide-Members to show or hide the Workspace Members panel. Workspace Members
lists the names of all workspace members with indicators that inform you of their current status.
Indicator Meaning
In the workspace.
Online, but not currently in this workspace.
or The addition of the clock indicator means that the member has not done any computer
activities for at least 15 minutes. Point at the clock indicator to see the exact period of time the
member has been idle.
Offline.
Additionally, member names display in different colors depending on their verification status.
Click the expand and collapse buttons ( ) to expand or collapse member categories, the Chat area, or
the Common Tasks pane. Note that hiding Workspace Members also hides the chat and common tasks
areas.
Drag the left border of the Workspace Members panel to make it wider or narrower.
Right-click in the Workspace Members panel, select View Members By, and select an option:
12
Basic Features
Regardless of their status, you can start new activities with people listed in Workspace Members. Do any
of the following:
• Right-click a name and select Properties to open the selected member's Contact card, then select
activity options.
• Right-click one or more names to display a menu of Groove activities. For example, you can
select several members, right-click and select options to send a message or an invitation to a
new workspace.
• Select from options in the Common Tasks pane.
Toolbars
You can customize the look of the Groove Workspace Explorer tool bar by showing or hiding components
or repositioning them.
To hide or show the Back/Forward navigation buttons, select View-Toolbars-Back and Forward.
To hide or show the explorer toolbar, which includes the navigation buttons and the Workspaces drop-
down menu, select View-Toolbars-Explorer Toolbar.
To reset the toolbar to its default, locked state, select View-Toolbars-Restore Toolbars.
Repositioning toolbars
You can adjust the width and change the position of toolbar components.
13
Groove 2007 User's Guide
Click in the status bar to pop up a list of your workspaces. Uncheck or check workspaces to pause or
resume communication activities. Data counters report on the flow of incoming and outgoing data. To do
more Communications Manager activities, click the Communications Manager link.
You can close the current Groove window by clicking the close box in the upper-right corner.
You can close all currently open Groove windows at once. Click the Groove icon in the Windows
notification area and select Close All Windows.
• Create a synchronized folder in your Windows file system, and then invite other users to share
the contents of this folder.
Synchronized folders can simply be shared across all computers on which you have your Groove
account. In other words, using file sharing workspaces can be much like using a virtual private
network.
Additionally, the Synchronization tab in the Preferences dialog box provides the option to
synchronize Internet Explorer Favorites across all your computers.
14
Basic Features
Groove indicators
Indicator Meaning
A member who's in the workspace.
A member who's in the workspace but who has not done any computer activities for at least the
past 15 minutes.
An "in-workspace" member for whom you have set alerts to "High". An alert displays whenever
the online status of this contact changes. Similar indicators appear for online and offline
members for whom you have set alerts to "High".
An "in-workspace" member who's current status is suspended. Similar indicators appear for
online and offline members of the workspace.
A Groove contact or workspace member who is currently online.
A Groove contact or workspace member who is currently online but who has not done any
computer activities for at least the past 15 minutes.
A Groove contact who's currently offline.
A Groove contact who's online status is currently unknown.
A messenger contact who has set their online status to "Busy".
Indicator Meaning
The workspace contains new or updated content added within the last two days.
The workspace contains new or updated content added within the last seven days.
The workspace contains new or updated content added at least seven days ago.
Indicator Meaning
A standard Groove workspace.
All data transfer is currently paused for this workspace.
A file sharing workspace.
A workspace that does not yet contain content data. You must download data from another
computer or workspace member.
A workspace is no longer maintaining synchronized data for at least one other member. See
Keeping workspace data synchronized for more information.
You are no longer maintaining synchronized data for a workspace. See Keeping workspace data
synchronized for more information.
15
Groove 2007 User's Guide
Indicator Meaning
Groove is logged in to an account.
Groove is logged in and set for working offline.
Groove is logged in and alerts are suppressed.
Groove is logging in and is set for working offline and with alerts suppressed.
Groove is logged in and the account has an unread message.
Groove is not logged in to any accounts.
Groove is not logged in to any accounts and is set for working offline.
Groove is not logged in to any accounts and alerts are suppressed.
Groove is not logged in to any accounts and is set for working offline and with alerts
suppressed.
Chat Indicators
Indicator Meaning
Expand pane
Collapse pane
Microphone
Open in new window.
Indicator Meaning
An unopened message.
An unopened voice message.
An unopened voice message with attached file.
An invitation you've received, but not yet accepted or declined. Also, a sent invitation.
A previously opened message.
A previously opened message with an attached file.
A previously opened voice message.
A previously opened voice message with an attached file.
A sent message.
16
Basic Features
Groove supports rich text editing in most text entry fields. Right-click in any rich text editor window to see
menu options for changing the typeface, size, color, and emphasis of selected text, as well as options for
changing paragraph settings such as alignment, indents, and bullets. Use copy and paste or drag and drop
to add images, hyperlinks and Web URLs to rich text fields.
When selecting a text color, select Default to set the color to the default system color (which is usually
black), or More Colors to display a standard Windows Color dialog box in which you can choose from an
unlimited number of colors.
If you want to do a variety of text formatting at once, select Font-More Fonts... to display a standard
Windows Font dialog box.
Select paragraph options to align text left, right, or center, create bulleted items, and to increase or
decrease paragraph indents.
You can copy and paste images and files into rich text fields. Copy an image or file to the clipboard, right-
click inside the rich text field and select Paste. You can also drag and drop an image or file into a rich text
field.
Images or files you paste into rich text fields may sometimes display as file attachments (instead of the
actual image), depending on the image or file type and your operating system.
Right-click any image or attachment to see menu options. The options you see depend on the file type.
By default, all rich text editing windows in Groove are set to automatically detect a Web address (URL)
and format it as a live link that you and other members can click to open a Web browser and then open
the Web site. The following table shows syntax rules for entering a Web address for automatic detection:
To enable or disable this feature, right-click in the editing window and select Detect URLs.
17
Groove 2007 User's Guide
Editing the text display for Groove and Web URL hyperlinks
You can edit the text that displays for Groove links pasted into rich-text areas or fields as well as detected
URL links.
When you paste a link from a Groove tool item (for example, a link to a Discussion topic, a file in a Files
tool, a record in a Forms tool, or a page in a Notepad tool), the link displays with text that may include
the name of the item (depending on the tool) and the most current editor of the item. For example, a
Forms tool record pasted into a rich text field displays with this format:
You may often want to use different text for the link, especially if the link is part of the running text in
sentence.
1. Use the arrow keys to position the insertion point to the immediate left or right of the link text.
Note: You cannot click within the link text to edit it because doing so will activate the link and navigate to
the link target.
2. Use the SHIFT and arrow keys to highlight the link text. Be careful not to include any leading or
trailing word spaces.
3. Select Edit-Hyperlink.
4. In the Hyperlink dialog box, enter the desired text in the Text to display field.
Note: The Address field should contain the text "<<Address of Groove workspace item>>". If it
does not (for example, if this field is empty), this means you do not have the link text highlighted
correctly. Click Cancel and make sure you've selected ONLY the link text.
5. Click OK.
18
Basic Features
You can enter alternate text to display for Web URL hyperlinks that appear in rich text areas or fields. You
can create an URL with alternate text from the insertion point, or apply alternate text to an existing URL.
1. Click where you want to insert the Web URL or select existing text or an existing Web URL.
Tip: To select an existing Web URL, click to the left or right of the URL and then use the Shift and
arrow keys to highlight it.
2. Select Edit-Hyperlink.
3. In the Hyperlink dialog box, enter the desired text in the Text to display field, and the Web URL
address (if necessary) in the Address field.
If you preselected a Web URL address, this address will automatically appear in both the Text to
display and Address fields, and you simply need replace the content in the Text to display field
with your desired text.
If you preselected text, the text automatically appears in the Text to display field. You must add a
Web URL to the Address field, or select a Web URL from the Browsed Pages list, which contains a
history of the most recently visited Web pages in your Web browser.
If you open the Hyperlink dialog box with no text selected, you must enter the desired text in the
Text to display field and the associated Web URL in the Address field.
4. Click OK.
The hyperlink text is inserted, or replaces the previous existing text, if any.
Removing hyperlinks
You can remove a hyperlink by simply deleting the hyperlink text (and then retyping it, if you still want
the text).
You can create links to Lotus® Notes documents in Groove workspace tools or messages.
Note: Workspace members must have Lotus Notes installed and must have access to the target Notes
database to access and view it.
19
Groove 2007 User's Guide
20
Basic Features
Groove provides spell-checking features in all locations that support rich text. For example, you can check
spelling in a Discussion entry, a Notepad page, a Groove message you're composing, or a chat entry.
You can open the spell checker only while you're editing the specific content.
In most contexts, you can open the Check Spelling dialog box by selecting Edit-Check Spelling or by
pressing CTRL+F7. You can also right-click in any rich-text location and select Check Spelling.
21
Chapter 4. Managing Workspaces, Members, and Tools
A workspace is a place where people with common purposes and goals can share ideas and work
together. A workspace begins with the person who creates it and then invites others to join. Workspace
components include the application tools that members decide to add for their work activities and an
area for chatting.
A workspace is a place where groups or organizations with common purposes and goals can share ideas
and work together.
Workspaces allow members to work with a variety of specific application tools. For example, suppose you
conduct a weekly meeting to discuss developing marketing materials. Activities might involve setting
deadlines, assigning tasks, as well as reviewing completed work. To facilitate this meeting workspace
members might post documents in a Files tool, discuss issues in a Discussion tool, and collaborate on
meeting agendas using a Meetings tool. All members currently online at the same time in the workspace
could interact using real-time chat, or even talk to each other using audio chat (if their computers have
the required audio components).
The Forms tool is notable among the collection of available workspace tools because, unlike all the other
tools, this tool is intended for building custom Groove tools. The complexity and features in a custom tool
can vary widely, depending mostly on the skills and vision of a Forms tool designer. Any designer should
be able to build a simple tool that consists of a variety of data-entry and input fields laid out on a form.
More sophisticated designers can add features as needed by adding scripts, lookups, and so on. Similarly,
tool designers can build custom Groove tools using the InfoPath Forms tool, in conjunction Microsoft
InfoPath.
The data in workspace tools is highly dynamic. All currently connected members see instantly any updates
either they or other members add. Optionally, members can use the Navigate Together feature, which
allows one member to lead others in activities. As the leader navigates in the workspace, or in some
cases, within a tool in the workspace, other members automatically go to the tool or location within the
tool.
Types of workspaces
When you create a new workspace in Groove, you can choose from the following workspace types:
• File Sharing. This workspace type allows you to share the contents of a folder in your Windows
file system across all computers on which you have your Groove account, and with other Groove
users by invitation.
• Standard. This workspace type displays in the Groove Workspace Explorer and initially includes a
Files tool and a Discussion tool. Once created, you can add more workspace tools as needed.
• Custom. This workspace type displays in the Groove Workspace Explorer and allows you to pick
the initial set of tools for the workspace.
Workspace limitations
Although there are no specific size restrictions for workspaces, for optimal performance, we recommend
limiting the size of any standard workspace to 2 GB or less. You can view workspace properties to see the
current workspace size.
22
Managing Workspaces, Members, and Tools
You can create a variety of new workspaces using the Create New Workspace dialog box. You can also
create a new workspace from a template or create a new workspace from an archive.
Note: For detailed instructions on creating a file sharing workspace, see Creating a file sharing workspace.
Read the description of the selected workspace type to see details about its contents and purpose.
The Templates drop-down list includes a "Custom" option in which you can select the initial tools
you want in the workspace.
4. To see additional workspace options, click Options. Note that the Options button is available only
if you have multiple identities in your Groove account.
• Invitees Need At Least. Select the Groove version that all invitees must have to join this
workspace. You might select an earlier version if you know that at least one intended invitee
is running the earlier version. Some workspace tools require members to be running at least
a certain Groove version.
• Your Identity In Workspace. If you have more than one identity in your Groove account,
select the identity you want to use in this workspace.
5. Click OK.
Groove creates the workspace and lists you as the initial member with the role of Manager. You can now
customize the workspace components and send workspace invitations.
If you've saved an existing workspace as a template or have access to workspace templates created by
others, you can use these as the basis for new workspaces.
If the workspace template is stored in the Groove Workspace Templates folder in My Documents (the
default location), you can select it in the Template drop-down menu in the Create New Workspace dialog
box.
If the workspace template is stored in a different folder, you can select it to create a new workspace as
follows:
23
Groove 2007 User's Guide
You can select multiple workspaces using CTRL+CLICK or SHIFT+CLICK. You might do this to
perform administrative tasks such as deleting workspaces or pausing communications in selected
workspaces.
• In the Workspace List in the Groove Workspace Explorer, click the workspace title.
Groove's "Navigate Together" option lets workspace members move in unison among workspace tools.
When you select "Navigate Together," all other members who have this option selected go to whichever
tools you select. Likewise, you go to whichever tool other members select.
Select Options-Navigate Together or press ALT+F9 to enable or disable the option. A checkmark displays
next to the command when the option is enabled.
• Only members who have Navigate Together selected at the same time navigate together. Thus, if
other members already have this option selected when you select it, you immediately navigate to
their location in the workspace. For example, if everyone using Navigate Together were looking
at a Pictures tool, you would automatically navigate to this tool too.
• All members who have this option enabled are listed in the Workspace Members panel under
"Navigating Together."
• Navigate Together stays enabled either until you disable it or close the Groove Workspace
Explorer window.
24
Managing Workspaces, Members, and Tools
To navigate on your own while Navigate Together is turned on, use SHIFT+CLICK instead of just clicking.
You may decide to do this if you want to work briefly with a different tool on your own.
• Manager
• Participant
• Guest
Each role type is granted specific "permissions". Permissions determine the extent to which members can
make changes in a workspace. For example, certain roles may be granted (or disallowed) the permission
to add new workspace tools or invite new members.
If you create a new workspace, you're automatically assigned the role of Manager, and therefore have all
permissions. Other members are assigned roles as they're invited to the workspace. Only members with
the role of Manager can change other members' roles.
By default, members assigned the role of Participant have permission to add new workspace tools and
invite new members. Guests, however, are not granted any permissions.
To view or change the permissions assigned to roles in a workspace, select File-Properties-Workspace, and
select the Permissions tab in the Properties dialog box.
Tool permissions
Most tools within a workspace have their own set of permissions. Tool permissions determine what actions
a Manager, Participant, or Guest can perform in the tool. For example, the Calendar tool has permissions
for adding, editing, or deleting entries. Members assigned the role of Manager can update tool permissions
per role.
To view or change permissions assigned to roles for a selected workspace tool, select File-Properties-Tool,
and select the Permissions tab in the Properties dialog box.
25
Groove 2007 User's Guide
Managing Workspaces
Select Options-Workspace Manager to open the Workspace Manager, which lists all of your workspaces on
all your computers, and shows workspace status information, including the last time a workspace had
unread information. You can do any of the following:
• Click any column header to switch between an ascending and descending sort.
• Rearrange the order of column headers by dragging them.
• Select multiple workspaces using CTRL+CLICK or SHIFT+CLICK.
You might do this to perform administrative tasks such as deleting workspaces or pausing
communications in selected workspaces.
• Right-click any workspace (or a multiple workspace selection) to see a menu with workspace
management options.
26
Managing Workspaces, Members, and Tools
Select File-Properties-Workspace (or File-Workspace Properties in the Launchbar) and click the General
tab to do all of the following activities:
You can view all of the following information about the selected workspace:
To change the version requirement for a workspace, select the version you want from the drop-down
menu.
Every workspace has a Groove version requirement for tools, which is initially set when the workspace is
created. For example, by default, all new workspaces you create use the version of tools supported in the
most current version of Groove. This means all tools that you or any other member add to the workspace
are supported only for members running Groove 2007 or later. Members running an earlier version of
Groove will get prompted to update their software if they select tools added to the workspace that require
the later version. Additionally, invitees to the space who are running an earlier version may be required to
update Groove before accepting the invitation.
Workspace managers can change the Groove version number so that members can add newer versions of
tools to the workspace. However, note the following details about changing version requirements:
• You can only increase the version requirement for a workspace. This also means that once you
increase the version requirement, you cannot set it back to an earlier version.
• Members running an earlier version of Groove may get prompted to upgrade Groove when later
versions of tools are added.
Workspace managers can add or edit text in the Description text box.
27
Groove 2007 User's Guide
If you log into your Groove account on multiple computers (or plan to do so in the future), you might
want to check the option to "Download automatically onto all my computers." If enabled, the workspace
will be automatically downloaded when you log in to the account on another computer.
Select File-Properties-Workspace and click the Permissions tab to view or change permissions assigned to
member roles in the workspace.
Note: In most cases, only Managers can change permissions assigned to roles in a workspace.
The selected permissions change to reflect the permissions currently assigned to the selected role.
You can adjust how Groove alerts you about unread information in a selected workspace.
The alert setting for new workspaces is initially defined in account preferences. However, the alert setting
for existing workspaces does not change if you change the default setting in your account preferences.
You may want to change the alert setting for specific workspaces. For example, for workspaces you visit
infrequently, you may want to set a lower level so that you're not distracted by alerts for information that
doesn't interest you.
• Auto (if available) lets Groove determine the appropriate alert setting for unread information.
For new workspaces or workspaces that you visit at least once a week, this setting is the
same as High. For workspaces or workspace tools you visit infrequently (which implies that
you don't often need information in the workspace or tool), Groove automatically adjusts the
alert setting to Medium so that you're not distracted by alerts in your system tray.
• High displays an unread mark and pops up an alert with an audible chime in the Windows
notification area.
• Medium displays an unread mark only.
• Off ignores unread information and does not alert you.
3. If you want, select or browse for a sound file (.wav) to be played with every alert, if your alert
level is set to High.
28
Managing Workspaces, Members, and Tools
4. If you want, check the option to be notified when members enter the workspace.
5. Click Apply.
You can save a workspace as a template file (in compressed .gsa format) to use as the basis for creating
new workspaces. The saved template file preserves the following workspace features:
Tip: If you accept the default location (the Groove Workspace Templates folder in My Documents),
the template will subsequently display as a Workspace Type option in the Create New Workspace
dialog box. If you place the template file in another folder, you must open it directly in your file
system, or by selecting File-New-Workspace from-Template.
4. Select the options you want in the Template Options dialog box, and click OK.
You can create a link that opens a workspace and displays the tool you most recently visited in that
workspace. You can place a workspace link in any text area that supports rich text.
A link to a workspace works only for people who are members of the workspace.
For example, you could place a link to a workspace in a Discussion entry or Notepad page in
another workspace, in a message, or in a file from another software application, such as Microsoft
Word.
3. Select Edit-Paste.
29
Groove 2007 User's Guide
The link displays with the name of the workspace as the link's target. If you want, you can edit the
link text.
You can save a workspace as a compressed archive file (.gsa) and later open the archived workspace in
Groove. Saving a workspace as an archive preserves:
Note: When you restore the workspace from the archive, all members (other than the member
restoring the workspace) appear as "suspended". You can subsequently re-invite the suspended
members.
Tip: If you accept the default location (the Groove Workspace Archives folder in My Documents),
the archived workspace file will display in the file list when you select File-New-Workspace From-
Archive from the Launchbar. You can also browse for other workspace archive files stored in other
locations by selecting this command.
Note: The identity restoring the workspace assumes the role of manager once the workspace is
restored.
30
Managing Workspaces, Members, and Tools
Tip: You can also open a workspace from an archive by double-clicking the file directly in your file
system.
Deleting a workspace
You can delete a workspace either from the Workspace List in the Groove Workspace Explorer, the
Workspace Manager, or the Launchbar. If you want to delete multiple workspaces at once, use the
Workspace Manager or Launchbar.
• From This Computer: The selected workspace is deleted from your account on this computer.
However, if you've added your Groove account to one or more other computers, the workspace
will continue to be listed under the category "Not On This Computer."
If desired, you could restore the deleted by fetching from another computer.
• From All My Computers: The selected workspace is deleted from all computers on which you
have your account. Your membership in the workspace is terminated unless another member
re-invites you. This option displays only if you have your account on more than one computer.
• For All Members: The selected workspace is deleted for all workspace members' computers. This
option is available only to workspace managers. Use this option only if you are certain that all
members are no longer using the workspace and any essential information has been archived.
Duplicating a workspace
When you duplicate a workspace, you create an exact copy of the original workspace except that the
duplicated copy retains only you as a member.
1. In the Launchbar, Workspace Manager, or in the Workspace List in the Groove Workspace
Explorer, right-click the workspace you want to duplicate.
2. Select Duplicate Workspace....
3. Enter a name for the workspace, and click OK.
Groove creates a copy of the workspace, and displays its title in the Workspace List.
31
Groove 2007 User's Guide
Renaming a workspace
1. In the Launchbar, Workspace Manager, or Workspace List in the Groove Workspace Explorer,
right-click the workspace you want to rename.
2. Select Rename....
3. Type a new name for the workspace, and click OK.
For workspaces you use frequently, you may want to create a shortcut and place it on your Desktop.
1. In the Launchbar, Workspace Manager, or Workspace List in the Groove Workspace Explorer,
right-click the workspace you want to send to the desktop as a shortcut.
2. Select Save Shortcut to Desktop.
Tip: You can also create a shortcut by dragging a workspace to your desktop.
Use drag and drop to place a shortcut to any workspace tool on your desktop. The shortcut name uses the
combination of the workspace and tool name.
You can create folders for organizing your workspaces. To see folders in a workspace list, select View-View
Workspaces By-Folders.
1. Click the location in the Workspaces List where you want to place a new folder.
Folders are created at the same level as the selected item. For example, if you select a workspace
that's already in a folder, the new folder will appear hierarchically within that folder.
Alternatively, right-click the item, select Move to Folder..., select the target folder in the dialog box
and click OK.
32
Managing Workspaces, Members, and Tools
You download workspace data from another computer or workspace member after you restore your
Groove account from a backup or log in to your account on another computer.
References to your workspaces appear in the Launchbar or the Workspace List and are categorized under
"Not On This Computer" if you're sorting the list by status. Regardless of your sort option, the icon for
these workspaces appears dimmed.
The workspace gets downloaded to your computer if any of the following conditions are true:
• Groove is currently online on another computer on which you have your account and this
workspace.
• Another workspace member is online and running Groove.
Groove will always download the workspace from one of your other computers (if available) before
downloading from another workspace member. If there are currently no other computers or
workspace members from which to download the workspace, the request will stay queued until one
or the other is available.
Note: If the selected workspace was created in a version of Groove prior to Groove 2007, you see
a Get Workspace From... drop-down menu with options to get the workspace from another
computer or workspace member.
You can mark an entire workspace read or unread. Marking a workspace read removes all unread markers
from all items among all tools in the workspace. Most commonly, you mark a workspace read the first
time you open it after receiving it via invitation because all items will be marked unread.
1. In the Launchbar, Workspace Manager, or Workspace List in the Groove Workspace Explorer,
right-click the workspace you want to mark read or unread.
2. Select Mark Read or Mark Unread.
33
Groove 2007 User's Guide
Groove keeps workspace data synchronized among members by storing in a log file all changes made by
all members. The size of this log file varies depending on how frequently workspace members run Groove
while online so that they can receive everyone's changes. If one or more members of the workspace fail to
run Groove while online for an extended period of time (three weeks or longer), or if there is a high level
of activity within a workspace, the log file may become unacceptably large for other members, especially
in workspaces that contain large amounts of data (over 100 MB).
If a workspace member fails to keep a workspace sufficiently synchronized, Groove warns all other
members of the problem by posting a yellow alert icon next to the workspace in the Launchbar or in the
Workspace List.
Note: The synchronization alert displays only for workspaces that are larger than 100 MB.
You can select the workspace to see options in the Common Tasks pane for resolving the problem. If
you're a workspace manager, you can:
• Suspend the member. If you suspend members, Groove no longer synchronizes the workspace
for these member(s) even if they go online, and their status in the workspace changes to
"suspended." The suspended member receives a message informing that Groove is no longer
synchronizing their copy of the workspace, and that they must request a re-invitation to the
workspace.
When you select this option, Groove opens a dialog box that lists the names of the members who
are causing the synchronization problem, and asks if you want to continue to suspend membership
activity.
• Uninvite the member. When you select this option, Groove opens a dialog box that lists the
names of the members who are causing the synchronization problem, and asks if you want to
uninvite them.
Groove posts a red alert icon if you are the workspace member causing a synchronization problem, and
therefore have had your membership in the workspace suspended by another member. Additionally, if
workspaces are sorted by status, the workspace is listed as "Suspended." When your membership in a
workspace has been suspended, this means that your copy of the workspace is no longer sending or
receiving updates.
If you have a workspace in this state and want to restore your membership and resume workspace
synchronization, you can do one of the following:
• Request a new invitation to the workspace from another workspace member. You might make
this request simply by sending a message or e-mail.
• Download the synchronized workspace data from another computer (if you have your account on
more than one computer) or from another workspace member.
34
Managing Workspaces, Members, and Tools
Suspended members appear in the Workspace Members list as "Suspended" (if the list is sorted by
status). If you want to re-invite this member to the workspace and restore their synchronization, it's
recommended that you uninvite the member and then send a new invitation.
1. Go to the workspace.
2. In the Workspace Members panel, enter the name or e-mail address of the recipient in the Invite
to Workspace box.
Click More to see more options for adding or finding recipients in the Add Recipients dialog box.
If you are inviting multiple contacts and want to assign different roles, you must send separate
invitations per role.
In addition, unless you're a Manager in the workspace, you can only assign invitees the same role
assigned to you (Participants assign the role of "Participant" and Guests assign the role of
"Guest").
5. If you want to confirm the invitees' invitation acceptance, check Require acceptance confirmation.
Note: This feature is automatically enabled for all invitations sent via e-mail.
Groove does the following depending on the type of recipient(s) you selected:
The message contains instructions both for people who already have Groove, and for those
who don't. People who already have Groove click a link in the message that opens the
invitation. People who don't have Groove click a different link that goes to the Groove
download page. Once an e-mail recipient installs and starts up Groove, the workspace
invitation should open automatically. If the invitation fails to open automatically, the recipient
can return to the e-mail message and open the file attachment to respond to the invitation.
All invitations sent via e-mail require the sender to confirm acceptance before the workspace
is sent to the recipient's computer.
Note: If you don't have a Microsoft Outlook e-mail client, a message displays informing you
that you cannot send the invitation using this feature. The message describes an alternative e-
35
Groove 2007 User's Guide
mail invitation process, which is to copy the invitation to the clipboard and then paste it into
another e-mail or messaging client.
You can also start the invitation process from any workspace list. Select the workspace and click Invite to
Workspace in the Common Tasks pane to open the Send Invitation dialog box.
Invitation alerts
When you send an invitation, Groove keeps you informed about its progress by posting alerts.
Note: For e-mail recipients, you don't see progress alerts until they open file attachment. From the table
below, the first alert you might see is "Inviting Invitee": Opened, waiting for reply..."
Notification Meaning
Inviting "Invitee": Groove cannot yet send the invitation. The sender's computer may be offline or
Waiting to send... may not currently have a live network or relay service connection.
Inviting "Invitee": Groove is sending the invitation either to the invitee's computer or to the relay
Sending, % complete... service (if the invitee's computer is offline).
Inviting "Invitee": Sent, The invitation left the sender's computer and will get delivered if the invitee is
waiting for delivery... online. If the invitee is offline, the invitation is routed to the relay service.
Inviting "Invitee": The invitation has reached the invitee's computer.
Delivered, waiting for
invitee to open...
Inviting "Invitee": The invitee has opened the invitation, and now must decide whether to accept or
Opened, waiting for decline it.
reply...
Inviting "Invitee": The invitee has accepted the invitation but Groove is not yet sending the
Invitation Accepted. workspace because the inviter and all other workspace members are offline. Note
that if the invitee accepts the invitation at a time when the inviter has gone
offline, Groove will attempt to download the workspace from another member
who is currently online, giving preference to members who are online but idle.
Inviting "Invitee": The invitee has accepted the invitation and the workspace is now being sent.
Invitation Accepted:
Sending workspace, %
complete...
Inviting "Invitee": The workspace has left the inviter's computer, though the invitee is still receiving
Workspace sent, waiting it.
for delivery...
Inviting "Invitee": The workspace is successfully delivered to the invitee.
workspace delivered!
Note: If the invitee goes offline before receiving the entire workspace, the
workspace gets sent to the relay service. The next time the invitee goes online,
the workspace is routed from the relay service to his or her computer.
Requiring acceptance confirmation is useful for security purposes. It gives you a chance to verify each
recipient's identity before you send the workspace. If you check this option, then when the message
recipient(s) accept your invitation, Groove displays an alert that prompts you to confirm the invitation.
In the Confirm Acceptance dialog box, do any of the following activities and then click Confirm:
• Click From to open the recipient's contact to verify their identity before sending the workspace.
• Include a message to send when you either confirm or deny the acceptance.
36
Managing Workspaces, Members, and Tools
Groove includes standard features for sending workspace invitations as e-mail messages via a Microsoft
Outlook client. If you do not use a Microsoft Outlook client for your e-mail, then Groove invitations with e-
mail addresses cannot use automated features. If you receive a failure message after attempting to send
an invitation to an e-mail address, you can still send the invitation by copying the invitation to the
clipboard, and then pasting it into the e-mail client or messaging system of your choice.
The pasted message includes the standard boilerplate text sent to recipients that includes
information on downloading Groove, as well as link for accepting the invitation.
To see the roles currently assigned to all members in the workspace, select File-Properties-Workspace,
and click the Roles tab in the Properties dialog box.
You can also point at any name in the Workspace Members list to see that member's role in a status
window:
1. Select File-Properties-Workspace, and click the Roles tab in the Properties dialog box.
2. Select the member whose role you want to change.
3. Click Change Role... to open the Change Role dialog box.
4. Select the role you want and click OK.
5. Click Apply if you want to apply the current role change and do other activities in this dialog box,
or click OK to apply the change and close the dialog box.
Tip: You can change a role for one member quickly from the Workspace Members list: Right-click the
member and select Role to open the Change Role dialog box.
37
Groove 2007 User's Guide
You can send a "Come Here" invitation asking existing members to go to a workspace. Members receive
an alert with your request.
A workspace invitation displays as an alert in the Windows notification area. You might also receive a
workspace invitation as a file attachment or link in an email message.
1. If you receive the invitation as a Groove alert, click the alert to open the invitation.
To decline the invitation without opening it, right-click the alert and select Decline. Groove posts
an alert for the sender saying that you've declined the invitation.
2. If you receive the invitation as an email message, click the link presented for accepting the
invitation.
3. Do any of the following activities:
Note: All invitations received via email require the sender to confirm your acceptance before the
workspace is sent to your computer.
If you click Close, the invitation is stored in your Message History. Choose this option if you're not
ready to accept or decline the invitation yet, but you want to dismiss the invitation notification.
If you accept the invitation, you typically see the following series of alerts, which inform you about
the progress of the workspace delivery:
Alert Meaning
Waiting for Waiting for workspace: Waiting to send acceptance
"workspace": Waiting
to send acceptance...
Waiting for Groove is sending the invitation acceptance to the sender.
"workspace": Sending
acceptance...
Waiting for The invitation acceptance has left your computer.
"workspace":
Acceptance
delivered...
Waiting for Groove is downloading the workspace from the sender's computer. The
38
Managing Workspaces, Members, and Tools
If you go offline before receiving the entire workspace, the workspace gets
routed to the relay service, and will be forwarded to your computer the next
time you go online.
Waiting for Groove is installing the downloaded workspace on your device.
"workspace":
Installing workspace...
"Workspace" ready The workspace is installed and ready. You can go to it by clicking the
(click to open)! notification or by double-clicking in the Launchbar. If you do not click the
notification to go to the workspace, right-click the notification to dismiss it.
You can set alerts for selected contacts or workspace members so that Groove notifies you about online or
idle status changes.
1. Right-click the contact(s) or member(s) you want and select Set Alerts.
If you selected one contact, a Contact dialog box opens with the Alerts tab displayed. If you
selected multiple contacts, an Alerts dialog box opens.
Tip: Click the Play button to sample the sound of the selected .wav file.
4. Click Apply to save your changes and leave the dialog box open, or click OK.
You can set the following additional alerts that respond to workspace member activities:
39
Groove 2007 User's Guide
Verifying the identities of the people you use Groove with is strongly recommended to alleviate the risk of
sharing sensitive information with unintended people. Depending on your Groove installation, many
contact identities may already be verified by an administrator at your organization. Groove indicates
verification status of people in your contact and member lists using the following colors:
The communication policies applied to your account identity determine your ability to interact with other
Groove users depending on their verification status. These policies may do any of the following:
• Prohibit you from communicating with any users who are not verified by an administrator in your
organization.
• Warn you before allowing you to communicate with users whose identities have not been verified.
In this case Groove opens the Contact Verification Alert dialog box described below.
• Allow you to communicate with any contact without any warning or restriction.
Your organization's verification of other Groove users may provide you with enough assurance about their
identities. In some cases, especially if you are working with highly sensitive information, you may also
want to manually verify a user's identity.
The Contact Verification Alert dialog box displays if you try to communicate with users whose identities
have not been verified, and communication policies for your account identity are set to warn you about
such users. You can do any of the following:
• Select users and click Verify Identity. Follow the instructions in the next section for manually
verifying a contact identity.
• Click Properties to view contact properties for a selected user.
• Click Continue to ignore the user verification alert and continue with the activity.
• Click Cancel to cancel the activity you were doing that resulted in a user verification alert.
Groove assigns a unique "digital fingerprint" to each contact identity. A digital fingerprint appears as a
long, random looking string of letters and numbers (with punctuation marks for readability). These digital
fingerprints are used for manually verifying the real-world identities of Groove contacts you see in your
workspaces and contact lists. You can also view the digital fingerprint assigned to your Groove identity.
1. Right-click the contact (or workspace member) you want to verify and select Verify Identity....
The Verify Identity dialog box displays information about your current relationships with the
selected contact, such as workspaces you share, the number of messages you have exchanged,
and your organizational relationship. If you do not have any relationships with the selected
40
Managing Workspaces, Members, and Tools
contact, the Verify Identity dialog box instead provides instructions for verifying the contact's
identity by checking their digital fingerprint.
Note: If Groove detects that there are two or more contacts that have the same, the Verify
Identity dialog posts a warning message that advises you to assign as alias when you verify this
contact.
• If you are sufficiently assured of the contact's identity from the information you see,
click Verify.
In the Verify Identity As dialog box, enter an alternative name for the contact if you think you
need one, and click OK.
• If you are not yet sufficiently assured of the contact's identity, and want to take more
steps to verify their identity, click Still not sure? - Check fingerprint.
Follow the steps in the Verify Identity dialog box for checking the contact's digital fingerprint,
and click Verify.
In the Verify Identity As dialog box, enter an alternative name for the contact if you think you
need one, and click OK.
Although rare, you may occasionally have reason to change the verification status of contacts that you
have manually verified so that they display as not verified.
1. Right-click the contact (or workspace member) you want to unverify and select Verify Identity....
2. Click Unverify.
You can save other peoples' contacts as a file. You could then send the contact file as an attachment in an
email.
To search for and add new contacts to your contact list in the Launchbar, do the following:
41
Groove 2007 User's Guide
You can search using "Full Name", "First Name", "Last Name", "Business E-mail", or "Personal E-
mail". The search will return all contacts in which a match is found in any of the valid fields. For
example, the search string "john" would return contacts named "Andrew Johnson" because "john"
is the first four characters in the "Last Name" field. As a rule of thumb, the more specific you make
the search string (by typing more characters), the more specific and exacting your search result
will be.
You can rearrange the order of the columns in the Find User dialog box by dragging them. You can
also remove columns (except for "Full Name") by right-clicking any column header and unchecking
the name of the column to be removed. You can restore a removed column by right-clicking any
column header and checking the name of the column to be restored. Any changes you make in the
Find User dialog box apply only to the current search session. All defaults settings are restored the
next time you open the Find User dialog box.
3. Optional: Check Include Public Groove Directory if you want Groove to include this directory in
the search.
4. Click Find.
5. If Groove finds a contact match, select it in the list.
Status icons display next to contacts in the list to allow you to see if they're currently online.
However, contact matches found in the Groove Public Directory always initially display with an
"Unknown" status icon until you select them and add them to your contact list.
For example, you might want to take steps to verify the contact's identity.
As new people become members of workspaces you belong to, you may want to add their contacts to your
personal list. Right-click the member you want to add and select Add to My Contacts.
You can view a list of all workspaces in which you and a selected contact are both members.
Depending on your role and permissions in a workspace, you may be able to do management tasks such
as changing member roles or uninviting members. Typically, you can do these activities only if you're a
manager of the workspace.
42
Managing Workspaces, Members, and Tools
If you use your Groove account on more than one computer, you can send the data from any workspace
to your other computers at any time.
If you do not currently have your Groove account on another computer, the Use Account on
Another Computer window opens with instructions for setting up your account for use on another
computer.
If you do have your Groove account on another computer, the workspace data is automatically
downloaded to the other computer immediately, if the other computer is currently online, or the
next time you log in on the other computer.
Note: Inviting a workspace to another computer automatically checks the option Download
automatically onto all my computers in the workspace properties.
Saving a workspace invitation as a file is a powerful and flexible alternative for inviting people to a
workspace. Invitees simply open the invitation file to accept and receive the workspace. For example, with
a saved invitation file you can:
Note: For file invitations to a workspace, the workspace can be sent to people who open and accept the
invitation only by the Groove user who created the workspace invitation file. As such, the workspace
cannot be sent to any invitees unless the invitation file creator is online.
• Click Browse to select a location in which to save the invitation file or type a path in the
filename box.
• Select a role to assign with the invitation.
You can assign only one role in an invitation file. If you are a manager in the workspace, you
can change members' roles later once they join the workspace.
• If you want to require confirming recipients' acceptance of the workspace, click Require
acceptance confirmation.
This feature is useful for security purposes. It gives you a chance to verify each recipient's
identity before you send the workspace.
43
Groove 2007 User's Guide
You can cancel workspace invitations to which recipients have not yet responded. You might do this if
invitees fail to respond to an invitation for a long time period.
Note: This feature is supported only with workspaces created using Microsoft Groove 2007.
Recipients can still open and accept the invitation, but instead of receiving the workspace they will receive
a message informing them that the invitation has been cancelled.
For a variety of reasons, you may sometimes need to revoke someone's membership in a workspace.
Before you do this activity, it's important that you understand the results and consequences of revoking
membership to a workspace:
• The workspace is deleted from all computers where the uninvited members had it installed.
If an uninvited member is currently online, the workspace is deleted immediately. If not, the
workspace is deleted the next time the uninvited member goes online.
Uninvited members are NOT warned about any pending uninvite operation, or about the fact that
they're about to lose the workspace. Instead, they simply receive a notification, after the fact, that
they've been uninvited from the workspace.
As a courtesy, the member performing the uninvite operation may want to send out a warning
message to members who will be affected, stating when the operation will take place, and
recommending options, such as creating a duplicate or a backup copy of the workspace (if the
members to be uninvited care about keeping the data).
• The name(s) of uninvited member(s) are immediately removed from the Member pane.
Note: You can uninvite people from a workspace only if your role has the required permissions.
44
Managing Workspaces, Members, and Tools
If the Add Tool permission is enabled for your workspace role, you can add new tools or toolsets to a
workspace. New tools are added to the right of any existing tools in the workspace. A new toolset is added
as a new "layer" of tools. You can rearrange the order of tools after you add them.
Some tools can be added only to workspaces that were created using the current version of Groove. If you
try to add one of these tools to a workspace created in an earlier version of Groove, a message displays
telling you that the workspace cannot support the tool you are trying to add. You have the following
choices:
• Upgrade the workspace by incrementing the Groove version requirement for adding new tools to
a workspace.
• Ask a member of the workspace who has not yet upgraded to the current version to add the tool.
Upgrading the Groove version requirement for adding new tools to a workspace
Warning: If you upgrade the Groove version requirement for adding new tools to a workspace, all
members will need to have the selected version of Groove in order to see content in new tools added to
the workspace. If you are unsure about whether all members can upgrade Groove at this time, do not
change this setting.
1. Select File-Properties-Workspace.
2. Select the Groove version you want from the drop-down menu under When adding tools, use
those released with Groove version.
3. Click OK.
About asking another workspace member to add tools from earlier versions of Groove
If you want to add an earlier version of a tool, and avoid upgrading the workspace, you can ask a
workspace member who has not yet upgraded to the current version of Groove to add the tool for you.
Consider making this request especially in cases where you know that one or more workspace members
are unable to upgrade Groove at this time.
It is best if the member you select for the request is running the version of Groove that corresponds to the
current version of the workspace. For example, if the Groove version requirement for adding new tools (as
set in workspace properties) is currently set to 3.1, select a workspace member who is currently running
Groove 3.1. You can see the version of Groove a member is running by opening their contact properties:
right-click the member and select Properties. The members current Groove version displays on the
General tab of the Contact dialog box.
To make the request, contact the member via instant message or other means.
More Tools displays a dialog box that lets you do any of the following:
• Add other tools not included in the Add Tool pop-up list.
• Add several new tools to a workspace at once.
• Add a new, custom toolset to the workspace.
• Add tools created in the Groove Forms tool and saved as a tool template.
45
Groove 2007 User's Guide
The More Tools dialog box lists all tools included in your Groove installation as well as any other tools you
have added to Groove by other means such as downloading from vendor Web sites.
To add a tool from the More Tools list, check its checkbox and click OK.
To get information about tools before adding to a workspace, select the tool to highlight it and click
Properties.
Additional tools are available for downloading. Some of these tools are offered free and others must be
purchased.
Caution: Tools created via the Groove Forms Tool in an earlier version of Groove may not function
properly if added to workspaces created in Microsoft Office Groove 2007.
Once the download is complete, the tool should appear among the list of tools in the More Tools
dialog box.
It is generally best to limit the number of visible tools in a workspace to about six or seven, so that other
members can easily read the tool names on tool tabs. If you have a complex workspace in which you want
to add many tools, you can add a new, custom toolset which appears as a new layer of tools. You can add
a new toolset in any workspace layer.
The Workspace List displays workspace toolsets in a hierarchical list. Select View-Show/Hide-Tools in
Workspace List to see a list of all tools in each workspace tool layer.
46
Managing Workspaces, Members, and Tools
1. Select the workspace layer in which you want to add a new toolset.
2. Click the Add Tool icon.
3. Select More Tools...
4. In the More Tools dialog box, check Custom and click OK.
The new toolset is added but the Groove Workspace Explorer window is blank because the new
toolset does not yet contain any tools.
5. Click the Add Tool icon to add the tools you want to the new toolset.
If the permissions assigned to your role allow it, you can delete tools from a workspace.
Caution: Deleting a tool from a workspace removes the tool and all of its data.
You can also delete a tool by selecting it in the Workspace List and pressing DELETE.
You can also rename tools in the Workspace List: Right-click the tool name and select Rename....
47
Groove 2007 User's Guide
You can re-order tools in a workspace by dragging them. When you start dragging a tool, a small tool
outline is appended to the pointer and an I-beam displays between this tool and the next tool in the
direction in which you're dragging.
Once you drag far enough over the next tool , the I-beam shifts to the far side of the next tool.
You can create a link to any workspace tool. A link can go to any tool in any workspace of which you're a
member.
For example, you could place a link to a tool in a Discussion entry or Notepad page in another
workspace, in a message, or in a file from another software application, such as Microsoft Word.
5. Select Edit-Paste.
The link displays with the name of the tool as the link's target. The example below shows a link to
a Calendar tool in a Discussion topic:
Many tools offer additional linking features. For example, you can create a link to a specific date in the
Calendar. For information on the specific types of links you can create in workspace tools, see the related
Help topic for the tool.
48
Managing Workspaces, Members, and Tools
You can open any workspace tool in a new window. This can be useful in a couple of ways:
• You can quickly focus on a specific tool without the distraction of other panes you might have
opened in other windows, such as the Workspace List or Workspace Member.
• You can have several tools open simultaneously even if they belong to different workspaces.
To open a tool in a new window, right-click its tool tab and select Open in New Window....
To show tool properties, right-click the tool tab (or the tool name in the Workspace List) and select
Properties. To see general information about the selected tool, click the General tab.
Information includes the tool version number, the author (that is, the name of the tool developer), a
description of the tool, and Groove version requirements.
To show tool properties, right-click the tool tab (or the tool name in the Workspace List) and select
Properties. Use tool properties to:
Select the Permissions tab to view or change permissions assigned to member roles for the selected
workspace tool.
Note: Usually only managers can change permissions assigned to roles for a workspace tool.
The selected permissions change to reflect the permissions currently assigned to the selected role.
You can save custom tools created via the Groove Forms Tool or Groove InfoPath Forms Tool as a
template file, and then add it as a new tool in other workspaces. This allows you to capture all design
objects, such as forms, fields, views, macros, and scripts, without also including data records. Creating a
tool template provides a way for designers to distribute custom tools for use in workspaces. It also gives
designers a separate development tool for updating production workspace tools using replace design.
Designers can use replace design to update a Forms tool or to update an InfoPath Forms tool.
49
Groove 2007 User's Guide
You can lock the design of a Forms or InfoPath Forms tool application before you save it as a template.
Use this feature if you want to prevent others from updating the design in workspaces they create using
the template.
If you accept the default location, the Groove Tool Templates folder in My Documents, the new tool
will be listed in the More Tools list. To see the More Tools list, select File-New-Tool-More Tools.... If
you place the list in another location, you can browse to it by selecting File-New-Tool-Browse....
4. If you want, set password information in the Template Options dialog box, and click OK.
When you save a Forms or InfoPath Forms tool as a template, and then add it to a workspace, the tool is
automatically upgraded to the latest version, even if the tool template was saved using a tool from an
earlier version of Groove. For example, if you create a tool template from a Groove 3.x Forms tool, and
then use this tool template to add a Forms tool to a new workspace, this Forms tool will automatically be
upgraded to a Groove 2007 tool version.
Additionally, note that Office Groove 2007 does not support adding tools from tool templates to earlier
workspace versions. For example, you cannot add a tool template created from a Groove 3.x Forms tool to
a workspace created in an earlier version of Groove.
A Forms or InfoPath Forms tool template is simply a data file, with a *.gta file extension. As such, you can
distribute it to other Groove users just as you would for any other data file. For example, you can send it
as an email attachment, place it in a Groove Files tool, or place it on a file server or Web site.
To assist other users, you might provide instructions on where to place the template file, such as the
folder location that will allow the tool template to display in the More Tools list: the Groove Tool
Templates folder in My Documents.
You can adjust how Groove notifies you about unread information in the selected workspace tool. The
default setting for workspace tools is Inherit, which means to use the current setting for the workspace.
It's useful to set alerts for a workspace tool when you want it to have a different setting from the
workspace in which it resides.
• Auto (if available) lets Groove determine the appropriate alert setting for unread information. For
new workspaces or workspaces that you visit at least once a week, this setting is the same as
High . For workspaces or workspace tools you visit infrequently (which implies that you don't
often need information in the workspace or tool), Groove automatically adjusts the alert setting
to Medium so that you're not distracted by alerts in your system tray.
• High displays an unread mark and pops up an alert with an audible chime in the Windows
notification area.
• Medium displays an unread mark only.
50
Managing Workspaces, Members, and Tools
3. Click Apply.
51
Chapter 5. Sharing Files in Windows Explorer
A file sharing workspace is a special type of Groove workspace that enables you to share the contents of a
folder in your Windows file system across all computers on which you have your Groove account, and with
other Groove users by invitation.
Note: File sharing workspaces are not supported on computers running a 64-bit operating system.
When you invite people to join a file sharing workspace, they select a folder for sharing on their
computers. All members of a file sharing workspace have access to its contents (files and subfolders).
You can create a file sharing workspace directly from Windows Explorer or by using Create New
Workspace. You can also create a file sharing workspace from a subfolder of an existing file sharing
workspace.
A Groove Synchronization pane displays in the window, replacing the standard Windows task pane.
3. Click Start synchronizing foldername and click Yes at the confirmation prompt.
The folder is made available for synchronizing on all computers on which you have your account.
You can proceed to invite other people to the file sharing workspace and set other options in the
File and Folder Tasks pane.
Creating a file sharing workspace using the Create New Workspace wizard
You can synchronize a folder in a file sharing workspace using the same procedure you use to create
standard Groove workspaces.
1. Select File-New-Workspace.
2. If you want, enter a name for the file sharing workspace.
If you plan to select an existing folder to be synchronized in the file sharing workspace, skip this
step. In this case, the workspace will be named using name of the folder you select.
The folder is made available for synchronizing on all computers on which you have your account.
You can proceed to invite other people to the file sharing workspace and set other options in the
File and Folder Tasks pane.
52
Sharing Files
About creating a file sharing workspace from a folder that's already being
synchronized in another file sharing workspace
Groove allows you to create a file sharing workspace from a folder that's already being synchronized in
another file sharing workspace. Typically, you might do this if you want to share the contents of a specific
folder in a file sharing workspace with a different set of people.
Groove posts a message when you start this activity in order to remind you that the selected folder is
already being synchronized. It's important to keep this in mind for the following reason: Members have
access to ALL data files in a file sharing workspace, even if those files are added or updated in a file
sharing workspace in which they're not members.
You can also send an invitation from the Groove Launchbar: Select the file sharing workspace and click
Invite to Workspace in the Common Tasks pane.
For a variety of reasons, you may sometimes need to revoke someone's membership from a file sharing
workspace. You do so by "uninviting" selected members. Keep in mind that uninvited members retain all
files that were in the folder up to the time they were uninvited. Uninvited members simply lose access to
the file sharing workspace features.
Note: You can uninvite people from a file sharing workspace only if your role has the required
permissions.
1. Right-click the member whose membership you want revoke and select Uninvite.
2. At the confirmation prompt, click Yes to confirm.
You respond to file sharing workspace invitations the same way you do for other Groove workspace
invitations: you receive an invitation message with options to accept or decline the invitation. See
Responding to a workspace invitation for details.
However, unlike with workspaces, the content data in a file sharing workspace is NOT automatically
downloaded from the inviter's computer after you accept the invitation. Instead, you must first specify
options for how to download this data as described below.
53
Groove 2007 User's Guide
When you first navigate to a file sharing workspace, you're prompted to create or select a folder in your
Windows system to be shared with other workspace members.
Additionally, you're prompted to specify an initial download setting: Fetch everything (automatic
download) or Only fetch links to remote files (manual download on demand). If you opt to fetch
everything, all data content in the file sharing workspace is downloaded immediately, provided that
another member who has the content is online. If you opt to only fetch links to remote files, the file
sharing workspace will list links to data files and you can download them later, on demand. You can
change download settings at any time in folder properties.
Note: The default download option you see varies depending on the initial contents of the file sharing
workspace. If the workspace contains at least 100 files, or any one file that's 100MB or larger, then
manual download is presented as the suggested default option.
You can control the activities members can do in individual folders by setting folder permissions.
Note: Your ability to change permissions for a folder depends on your role in the workspace. Typically,
only managers are authorized to change permission settings.
1. If you're setting permissions for a folder in a file sharing workspace, select the folder and click
Show this folder's properties in the File and Folder Tasks pane.
2. If you're setting permissions for a folder in a Groove Files Tool, right-click the folder and select
Properties.
3. Click the Permissions tab in the Properties dialog box.
4. Select the role for which you want to change assigned permissions.
5. Check or uncheck permissions for each selected role.
6. Select an option for applying your changes.
Tip: You can group file sharing workspaces together by sorting the workspace list by Type.
54
Sharing Files
If you're navigating for the first time to a file sharing workspace you received by invitation, you're
prompted to select or create a folder to be synchronized, and to specify initial download settings
(automatic or manual).
• Select any file sharing workspace in your Windows file system, and click the Folder Sync button
in your Windows toolbar to show file sharing workspace options and features.
A synchronization icon is appended to the root folder of the file sharing workspace in your Windows
file system.
Click the Folder Sync button in the Windows toolbar again to display the standard Windows
Explorer File and Folder Tasks panel.
If you select a Manual download setting for a file sharing workspace, note the following details:
• You must manually download all new files that other members add to the folder, as well as new
files you have added to the folder on other computers.
• Optionally, you can set any file to automatically download updates whenever another member
saves file updates: Select the file, click Show this file's properties in the File and Folder Tasks
pane, and then check Automatically keep this file up to date.
• New files display in the file sharing workspace with a download indicator, and are listed with the
file type Groove Remote File. The file extension .gfs is appended to the file name until the
download is complete. For example:
To download files:
Depending on the size of the file(s), you may see status information that shows current download
progress.
55
Groove 2007 User's Guide
If you add your Groove account to another computer, your file sharing workspaces will appear in your
workspaces list under Not on this computer , when the list is sorted by status. To download a file sharing
workspace, select the workspace and click Get Workspace under Common Tasks. The workspace gets
downloaded to your computer if Groove is online on another computer that has your account and this
workspace, or if another workspace member is online and running Groove.
Tip: If you enabled the workspace property Download automatically onto all my computers, the file
sharing workspace will automatically get downloaded to your computer the first time you log in to Groove.
Once the file sharing workspace is downloaded, you can select it to open it. Groove prompts you to specify
the folder location in which to synchronize the workspace data.
If you have not yet added your account to another computer, you can begin this procedure from any file
sharing workspace. Click Invite my other computers in the Synchronization Tasks pane and follow the
instructions in the Use Account on Another Computer dialog box. If you have already added your account
to another computer, clicking Invite my other computers will automatically enable the workspace property
option "Download automatically onto all my computers".
You can change folder properties that specify when to download new or updated files. The initial download
setting for file sharing workspace folders depends on what you selected when prompted when either
creating the workspace or accepting an invitation to the workspace.
If you change download properties for a folder to Manual, this means that you must manually download
any new files that other members place in that folder, as well as re-download any files that are updated
by other members.
1. Select the folder for which you want to change download settings.
2. Click Edit this folder's download settings in the File and Folder Tasks pane.
3. Set the download options you want, and click OK.
Tip: You can set any file to automatically download updates whenever another member saves file
updates: Select the file, click Show this file's properties under File and Folder Tasks, and check
Automatically keep this file up to date.
4. If the folder has subfolders, select an option to apply to subfolders and click OK.
To start Groove activities with members of a files sharing workspace, right-click their names in the
member list and select from the context menu. For example, to open contact properties for a member,
right-click their name and select Properties.
56
Sharing Files
You can also double-click any member name to open the Groove Send Message window.
You change member roles and permissions in a file sharing workspace by selecting options in the
Workspace Properties dialog box.
1. Click Show properties for <root folder name>in the Synchronization Tasks pane to open the
Workspace Properties dialog box.
Alternatively, select the file sharing workspace in the Launchbar and select File-Workspace
Properties.
1. Click Show properties for <root folder name> under Synchronization Tasks to open the
Workspace Properties dialog box.
Alternatively, select the file sharing workspace in the Launchbar and select File-Workspace
Properties.
The selected permissions change to reflect the permissions currently assigned to the selected role.
57
Groove 2007 User's Guide
You can stop synchronizing a file sharing workspace while you are using it, or from the Launchbar.
Click Stop synchronizing <file sharing workspace name> in the Synchronization Tasks pane.
Note: This action affects only the computer on which you select the option. If you want to stop
synchronization for the workspace on all computers on which you have your account, you must select a
workspace deletion option as described below.
• From This Computer: The selected workspace is deleted from your account on this computer.
However, if you have added your Groove account to one or more other computers, the
workspace will continue to be listed under the category "Not On This Computer." If desired, you
could restore the deleted file sharing workspace by fetching it from another computer.
• From All My Computers: The selected workspace is deleted from all computers on which you
have your account. Your membership in the workspace is terminated unless another member
re-invites you. This option displays only if you have your account on more than one computer.
• For All Members: The selected workspace is deleted from all workspace members' computers.
This option is available only to workspace managers. Use this option only if you are certain that
all members are no longer using the workspace and any essential information has been
archived.
Note: You must be a manager in the workspace to delete it for all workspace members. Typically,
only the workspace creator is a manager.
As a general guideline, it's best to avoid moving the folders in a file sharing workspace. However, keep in
mind the following details related to this activity:
• If you move the root folder of a file sharing workspace, it will no longer be synchronized on this
computer. However, it will continue to be synchronized for other workspace members and on
other computers on which you have your account.
You can resume synchronization for the file sharing workspace if you specify a new root folder
location, as described below.
58
Sharing Files
• If you move a subfolder in a file sharing workspace to a location outside of the file sharing
workspace's folder hierarchy, this action will delete the folder and its contents for all other
members of the workspace.
2. Click the option The folder has been moved or renamed. Prompt me for the new folder .
3. Click OK.
4. Browse for and select the new folder location, and click OK.
You can change the "workspace" name of a file sharing workspace, as listed in the Workspace pane of the
Launchbar. You change this name just as you would any other Groove workspace:
Renaming the root folder of a file sharing workspace in your Windows file
system
Renaming the root folder of a file sharing workspace has the effect of deleting the folder and adding it as a
new folder. As a result, the folder stops being synchronized for you (however, the folder continues to be
synchronized among other members who have not changed the folder name).
2. Click The folder has been moved or renamed. Prompt me for the new folder.
3. Click OK.
4. Browse for and select the renamed folder, and click OK.
The effects of renaming subfolders varies for other workspace members depending on whether or not they
are online when the rename occurs.
59
Groove 2007 User's Guide
• Folder renaming has no effect (other than the change to the folder name) for members who are
online when the rename occurs.
• For members who are offline, folder renaming has the effect of deleting the folder and adding it
as a new folder. As a result, all contents (folders and data files) in the folder must be re-
downloaded. Members who use a manual download setting will need to reselect files for
downloading.
The effects of renaming files varies for other workspace members depending on whether or not they are
logged into Groove when the rename occurs.
• File renaming has no effect (other than the change to the file name) for members who are logged
into Groove when the rename occurs. If a workspace member is logged in but working offline, the
name change occurs for this member when he or she returns to working online.
• For members who are not logged in (or for whom Groove is shut down), file renaming has the
effect of deleting the file and adding it as a new file. As a result, the file will get re-downloaded
for all members who use an automatic download setting; members who use a manual download
setting will need to re-select the file for downloading.
You set alert settings for unread behavior in a file sharing workspace by selecting options in the
workspace properties dialog box.
1. Click Show properties for workspacename in the Synchronization Tasks pane to open the
Workspace Properties dialog box.
Alternatively, select the file sharing workspace in the Launchbar and select File-Workspace
Properties.
Tip: Click the Play button to sample the sound of the selected .wav file.
5. If you want, check the option to be notified when members enter the workspace.
6. Click Apply to save your changes and leave the dialog box open, or click OK.
You can change how Groove notifies you about unread information in specific file folders. By default, the
alert setting is Off for individual folders, and Groove will only post alerts according to your current tool (for
a Files tool) and workspace settings. You can change the folder setting to High so that Groove posts alerts
when there are changes in that folder.
60
Sharing Files
1. If you're setting alerts for a folder in a file sharing workspace, select the folder and click Set
alerts for this folder in the File and Folder Tasks pane.
2. If you're setting alerts for a folder in a Groove Files Tool, right-click the folder, select Properties
and click the Alerts tab in the Properties dialog box.
3. To change the alert setting, drag the pointer bar up or down.
• Auto (if available) lets Groove determine the appropriate alert setting for unread information.
For new workspaces or workspaces that you visit at least once a week, this setting is the
same as High. For workspaces or workspace tools you visit infrequently (which implies that
you don't often need information in the workspace or tool), Groove automatically adjusts the
alert setting to Medium so that you're not distracted by alerts in your system tray.
• High displays an unread mark and pops up an alert with an audible chime in the Windows
notification area.
• Medium displays an unread mark only.
• Off ignores unread information and does not alert you.
You can change how Groove notifies you about unread information in specific files. By default, the alert
setting is Off for individual files, and Groove only posts unread alerts according to your current tool and
workspace settings. You can change the file setting to High so that Groove alerts you about changes to
that specific file.
Note: If you are setting alerts for a file in a file sharing workspace, select the file and click Set
alerts for this file in the File and Folder Tasks pane.
• Auto (if available) lets Groove determine the appropriate alert setting for unread information.
For new workspaces or workspaces that you visit at least once a week, this setting is the
same as High. For workspaces or workspace tools you visit infrequently (which implies that
you don't often need information in the workspace or tool), Groove automatically adjusts the
alert setting to Medium so that you're not distracted by alerts in your system tray.
• High displays an unread mark and pops up an alert with an audible chime in the Windows
notification area.
4. Click Apply.
In addition to viewing general workspace properties, you can also view folder synchronization properties
for a file sharing workspace.
61
Groove 2007 User's Guide
The Status tab provides information about file synchronization status and problems. Typically,
synchronization problems might result for the following reasons:
Members of a file sharing workspace can open the same files simultaneously. Depending on editing
permissions, multiple members may also be able to edit the same file simultaneously, and save changes.
If this happens, an editing conflict occurs and Groove takes the following steps to preserve everyone's
work, and to provide a path for resolving the conflict. With most types of files, editing conflicts are
handled as follows:
• The member who first saves changes retains the original file.
• For members who subsequently save changes, the file is saved in a new "conflict" version of the
file. For example, "Karen Berg's copy" in the picture below is a conflict file.
When such editing conflicts occur, members should communicate to determine how they can best resolve
or merge their files.
Special cases
Most software applications place a "lock" on files when users open them for editing. Groove relies on
detecting these locks for handling editing conflicts. Some applications, such as Notepad, do not use this
locking mechanism. In these cases, if multiple people open and edit the same file simultaneously, only the
changes that are saved last are retained, and no conflict document is created.
This topic describes restrictions associated with file sharing workspaces as well as activities that may
result in warning prompts.
Groove disallows sharing the following types of folders in a file sharing workspace:
62
Sharing Files
• If you select the root folder of a computer drive for sharing. This activity is strongly discouraged.
• If you select any folder within the Windows system directory.
• If you select a folder (or parent) folder that you're already synchronizing in another file sharing
workspace.
Although this activity is not discouraged, it's important to be aware of the following security issue:
Folders shared in multiple file sharing workspaces are available to members across all those
workspaces. You should be certain that all members in all file sharing workspaces are authorized to
access all the data in all folders.
The following files and file types cannot be shared in a file sharing workspace: Any file that has a file
name that starts with a ~ character; all files with gfs, tmp, bak, sav, or lnk extension.
Additionally, files with the following attributes cannot be shared in a file sharing workspace: Hidden,
System, Temporary, or Offline.
To see a list of file sharing workspace restrictions, open the Folder Synchronization Properties box.
Groove cannot synchronize any files that are larger than 1 GB. Additionally, Groove will stop synchronizing
any file sharing workspace that exceeds the following file limits: More than 5000 files or a set of files that
exceed 1 GB in total size.
In addition to the file types that are specifically restricted from file sharing, there are other types of files
that may not work well in a file sharing workspace. These include file types that have dependencies on
other files in order to run properly, or files from applications that run properly only on the computer where
the application was originally installed. Examples of these file types include Outlook PST files, Quicken
Quickbook files, and Access database files. In short, some file types are not intended to be shared on
multiple computers.
For optimal performance in a file sharing workspace, keep the following in mind:
These numbers are recommended based on Groove's minimum system requirements. Systems exceeding
the minimum requirements will be able to handle larger numbers of files with less performance
degradation.
• Degree of change to files in the file sharing workspace. The more frequently files are changed,
the more performance is degraded. Larger workspaces can function with less degradation if they
do not have a high degree of change.
63
Groove 2007 User's Guide
• Download settings of workspace members. Members who use manual download settings avoid
requiring other members to send data on each update. This improves overall performance for all
members.
• Starting and stopping Groove frequently. For optimal performance, keep Groove running.
• Running earlier versions of Groove. All members of the workspace should use the latest version
of Groove to ensure optimal performance.
In addition, pausing communications for a workspace also pauses the synchronization of local changes to
the workspace. In larger workspaces, pausing communications until updates are really needed can help
overall performance.
64
Sharing Files
Adding files
You can also copy and paste or drag and drop files into a folder from Windows Explorer.
You can create a new file if you have the application that supports the file type installed on your
computer. For example, to create a new Microsoft Word file, you must have Word installed. To create a
new file:
1. Select the folder in which you would like to create the new file.
2. Select File-New-file type.
You can open a file stored in the Files tool if your computer has an application installed that supports its
file type.
If you try to open unsupported files, you see an Open With dialog box that asks you to specify the
program to use. For more information on the Open With dialog box, see your Windows documentation.
Note that your edits are saved locally in the application, and not yet saved to Groove for all
members of the workspace.
3. To save your edits back to Groove for all workpace members, select a Groove window in the
Windows status bar.
4. When prompted, select options for saving your changes back to Groove.
If you want to save the file back to Groove as a different version, type a new name in the Save File
As box. The default file name is the original file name.
Click Yes to save your changes back to Groove. If you entered a new file name, the new file
displays in the list. The original file (with its original file contents) is also still listed.
65
Groove 2007 User's Guide
Click No to defer saving your changes back to Groove now. You might do this if you want to do
additional editing before sending your changes to all members of the space. Note however, that if
you click No after closing the file, you will lose all edits since the last time the file was saved back
to Groove.
Managing files
In general, you can manage files in the Files tool just as you would in Windows Explorer. Note that some
file management tasks, such as renaming or deleting files, may be governed by the tool permissions
assigned to your role. You can do the following administrative tasks with files in the Files tool:
To copy a file to another folder (either within the Files tool or to a folder in Windows Explorer), use
Edit-Copy and Edit-Paste commands, or CTRL-DRAG the file. To move a file to another folder, use
drag and drop.
Tip: If you drag a file to Microsoft Outlook, this will automatically start a new Outlook message
with the file listed as an attachment.
• Delete files
• Rename files
• Sort files
To change how the files are sorted in the File list, select View-Arrange Icons and then select an
option. You can also click any column header (for example, Name, Size, or Type) to sort the list by
the selected column.
To view a file's properties (for example, file size or create date), right-click it and select Properties.
You can create links to files in the Files tool. You can also create a link that selects the tool. To create a
link to a file:
66
Sharing Files
The Files tool allows all workspace members to open the same files simultaneously. Depending on editing
permissions, multiple members may also be able to edit the same file simultaneously, and save changes
back to Groove. If this happens, an editing conflict occurs and Groove takes the following steps to
preserve everyone's work, and to provide a path for resolving the conflict:
• The member who first saved the edited file back to Groove has his or her changes saved in the
original file.
• All members who subsequently save the file are prompted to save their changes in a new
"conflict" version of the file. For example, "Karen Berg's copy" in the picture below is a conflict
file.
When such editing conflicts occur, members should communicate to determine how they can best resolve
or merge their files.
You can create and arrange file folders in a tree-like structure, just as you would in Windows Explorer. The
Files tool initially contains one folder permanently named "Files," which is always the top-level folder in
the list (analogous to a disk drive name such as (C:\) on your computer). Any folders you add display
hierarchically below "Files."
New folders are always placed hierarchically below the selected folder.
Renaming a folder
You rename folders in the Files tool just as you do in Windows Explorer.
To view a folder's properties, right-click the folder and select Properties. The Folder Properties dialog box
has four tabs, General, Alerts, Permissions, and Download.
67
Groove 2007 User's Guide
You can change how Groove notifies you about unread information in specific file folders. By default, the
alert setting is Off for individual folders, and Groove will only post alerts according to your current tool (for
a Files tool) and workspace settings. You can change the folder setting to High so that Groove posts alerts
when there are changes in that folder.
1. If you're setting alerts for a folder in a file sharing workspace, select the folder and click Set
alerts for this folder in the File and Folder Tasks pane.
2. If you're setting alerts for a folder in a Groove Files Tool, right-click the folder, select Properties
and click the Alerts tab in the Properties dialog box.
3. To change the alert setting, drag the pointer bar up or down.
You can change how Groove notifies you about unread information in specific files. By default, the alert
setting is Off for individual files, and Groove only posts unread alerts according to your current tool and
workspace settings. You can change the file setting to High so that Groove alerts you about changes to
that specific file.
Note: If you are setting alerts for a file in a file sharing workspace, select the file and click Set
alerts for this file in the File and Folder Tasks pane.
Auto (if available) lets Groove determine the appropriate alert setting for unread information. For
new workspaces or workspaces that you visit at least once a week, this setting is the same as
High. For workspaces or workspace tools you visit infrequently (which implies that you don't often
need information in the workspace or tool), Groove automatically adjusts the alert setting to
Medium so that you're not distracted by alerts in your system tray.
High displays an unread mark and pops up an alert with an audible chime in the Windows
notification area.
4. Click Apply.
You can view information details about Files tool folders, such as the number of files it contains, the
combined size of all files, and creation and modified dates.
68
Sharing Files
You can view information details about any file stored in a Files tool, such as its download status, size, and
creation and modified dates.
You can print any file from a Files tool provided you have the application program that supports its file
type.
You can change folder properties that specify when to download new files. By default, a new folder you
create inherits its download settings from its parent folder. The default setting for the Files (Root Folder)
in a new workspace you create is Automatic. If you're invited to a workspace, your initial default settings
are inherited from the member who invited you.
If you change download properties for a folder to Manual, this means that you must manually download
any new files that other members place in that folder. However, once a file is downloaded, all updates to
that file are automatically downloaded, regardless of the folder download setting.
Tip: You can set any file to automatically download updates whenever another member saves file
updates: Select the file, select File-Properties-File, and check Automatically keep this file up to
date.
4. If the folder has subfolders, select an option to apply to subfolders and click OK.
69
Groove 2007 User's Guide
If download properties are set to Manual for Files tool folders, a green arrow indicator appears next to any
files to be downloaded, or folders that contain such files. In addition, the Downloadbutton in the toolbar is
activated.
4. Once the download is complete, select an option for opening or navigating to the file, if available.
To see the permissions currently assigned to member roles, select File-Properties-Tool and click the
Permissions tab.
By default, all members except for Guests have permission to add new files or folders, modify files, and
delete their own files or folders. Managers have all available permissions.
Additionally, in a SharePoint Files tool, all members except for Guests have permission to synchronize with
the SharePoint document library, or to request synchronization control for the tool from the current
synchronizer.
See Changing permissions for workspace tools for more information on modifying the default permissions
for a tool.
You can control the activities members can do in individual folders by setting folder permissions.
Note: Your ability to change permissions for a folder depends on your role in the workspace. Typically,
only managers are authorized to change permission settings.
1. If you're setting permissions for a folder in a file sharing workspace, select the folder and click
Show this folder's properties in the File and Folder Tasks pane.
2. If you're setting permissions for a folder in a Groove Files Tool, right-click the folder and select
Properties.
3. Click the Permissions tab in the Properties dialog box.
4. Select the role for which you want to change assigned permissions.
5. Check or uncheck permissions for each selected role.
6. Select an option for applying your changes.
70
Sharing Files
Most keyboard shortcuts that work in Windows Explorer work in the Files tool. For example, ALT+E
displays the Edit menu and CTRL+C/CTRL+V copies and pastes the selected file. The table below lists
additional keyboard shortcuts.
To Press
Delete CTRL+D
71
Groove 2007 User's Guide
Note: The use of the product name "SharePoint" in the Groove 2007 Help refers to any product that
supports or includes Windows SharePoint Services 3.0 functionality.
Groove SharePoint Files Tool provides the following benefits to organizations storing file content in
SharePoint document libraries:
• Access to file content for selected people outside of the enterprise. Groove and the SharePoint
Files tool provide a convenient and efficient way to collaborate with people who are outside the
corporate firewall. Additionally, the SharePoint Files tool provides a central working environment
for teams that are widely dispersed geographically.
• Offline access to file content. The SharePoint Files tool provides mobile workers, or those who
have limited Internet access, with an environment in which they can access, view, and update file
content while offline.
• SharePoint Files tool users can enjoy its rich application features, in addition to features in other
workspace tools.
Note the following additional details and recommendations about using a Groove SharePoint Files tool to
interact with files stored in a SharePoint document library:
• The SharePoint Files tool can map only to document libraries in Windows SharePoint Services 3.0
or later. An error displays if you attempt to map to a document library in an earlier version of
Windows SharePoint Services.
• It is recommended to have versioning enabled on SharePoint sites from which you take files into
Groove. Versioning helps minimize the risk of data loss that might occasionally occur because of
synchronization errors or conflicts.
• SharePoint document libraries contain meta data that is not supported or maintained in the
Groove SharePoint Files tool.
• The Groove SharePoint Files tool does not recognize views in SharePoint document libraries. As a
result, a SharePoint Files tool may contain more documents than what appears in the document
library where certain files are filtered out by views.
• As a Groove tool, data is synchronized among workspace members in the same fashion as a
standard Groove Files Tool: online workspace members send and receive updates as they are
saved to Groove.
• Updates are sent to or received from the SharePoint site automatically according to a schedule,
or manually when the workspace member who has synchronization control initiates a
synchronization.
72
Sharing Files
A workspace containing a Groove SharePoint tool must include at least one member who has all of the
following credentials:
The minimum permissions for the synchronizer, given standard SharePoint permissions, is "Owner"
with the "Contribute" option enabled. For SharePoint sites that have custom permissions, the
synchronizer must have permissions enabled for adding, editing, and deleting items.
• The required Groove permissions for synchronizing with the SharePoint site. By default, all
members except for Guests have permission to synchronize with the SharePoint document
library, or to request synchronization control for the tool from the current synchronizer.
Note: Although a workspace member with the Participant role can usually act as the synchronizer,
this role usually does not include permission to delete any file. As a result, a synchronizer whose
Groove role is Participant may see synchronization warnings about failed file deletions when they
initiate a synchronization.
A member who has the required SharePoint and Groove permissions can take on the responsibility of the
"synchronizer": that is, the person who either periodically initiates synchronization between Groove and
the SharePoint site, or who enables the SharePoint Files tool for automatic, scheduled synchronization. In
order to accomplish synchronization, the synchronizer must be online and have access to the SharePoint
site.
Only one workspace member can be the synchronizer for the SharePoint Files tool. Other members who
have the required Groove permission can request taking over the synchronizer task. The member who is
currently the synchronizer can then opt to relinquish this role, or decline the request, and retain the
responsibility. The synchronizer cannot initiate passing the synchronizer task to another member; the task
responsibility must be requested by another member.
If the current synchronizer loses their permission to own this task (for example, if the synchronizer's
workspace role is downgraded, or if the synchronizer stops being a member of the workspace),
synchronization control is automatically passed on to another eligible workspace member. If there are no
workspace members who have the required permissions at this time, the SharePoint Files tool can no
longer be synchronized with the SharePoint site and it reverts to standard Files tool.
The name of the current synchronizer displays in the status bar above the tool tab:
The status bar informs the synchronizer when there are unsynchronized changes in the tool. When the
synchronizer clicks Synchronize Now..., a Preview Synchronization window displays showing all pending
updates as well as file conflicts. The synchronizer can take steps to resolve conflicts before proceeding
with synchronization.
The current synchronizer should only honor a request for passing the synchronizer task to another
member who has access to the SharePoint site and the required permissions on the SharePoint site.
In some circumstances, the synchronizer task should be passed to another member. For example, if the
synchronizer will be unable to start a synchronization for a long period of time (perhaps because of a
vacation), he or she should tell another workspace member who has the requisite credentials to send a
request to become synchronizer. Alternatively, the synchronizer could enable automatic synchronization,
on a schedule. But this strategy may be risky because it presumes that the synchronizer's computer will
be able to run and stay online the entire time.
In the status bar, all workspace members see the name of the current synchronizer and can point at the
accompanying folder link icon to display a message box that contains the SharePoint site URL. Workspace
73
Groove 2007 User's Guide
members who have the required credentials can click the folder link icon to open a Web browser and go to
the SharePoint site or select Edit-Go To SharePoint.
The status bar also reports for all members the date and time of the last synchronization. All members can
click the Calendar icon to see information about the synchronization schedule.
The synchronizer can start several activities by selecting options in the status bar, including synchronizing,
changing scheduling options, and resolving synchronization errors.
• Manual synchronization. With this option, the SharePoint Files tool and SharePoint site are
synchronized only when the synchronizer chooses to start a synchronization.
• Scheduled synchronization. With this option, the synchronizer sets a specific time interval for
automatic synchronization.
Note: Depending on factors such as the load of current network traffic, scheduled synchronizations
may sometimes be postponed by the server until the next scheduled time.
Only the synchronizer can do the following SharePoint source control tasks with files in a Groove
SharePoint Files tool:
• Check out files. Checking out a file places a lock on the file on the SharePoint site, thus
preventing users with direct access to the file on the SharePoint site from updating it while it is
simultaneously being updated in Groove.
Note: Checking out a file fetches the most up-to-date version of the file from the SharePoint
document library, unless the current version of the file in Groove has unsynchronized changes. In
other words, if you edit the file in Groove and then do the check out, you will not overwrite the
edited version of the file with the original copy from the SharePoint library.
• Check in files. Checking in a file from the Groove SharePoint Files tool updates the file on the
SharePoint site and removes the checkout lock.
• Cancel a checkout. Canceling a checkout simply removes the lock from the file on the SharePoint
site and makes it available for editing.
You can duplicate workspaces that contain a SharePoint Files tool, or save them as archive or template
files. However, note that the SharePoint Files tool in the duplicated workspace, or in new workspaces you
create from the archive or template files, will not retain its connection to a SharePoint document library,
and will have its functions reduced to that of a standard Files tool.
74
Sharing Files
When you add a SharePoint Files tool to a workspace, a welcome screen displays with instructions for
setting up a connection to a SharePoint Document library. Note that other workspace members initially
see a welcome screen that lists you as the tool creator and asks them to wait for you to set up the
connection.
1. Click Setup... to open the Select a document library or folder dialog box.
With My Network Places selected, this dialog box lists all the SharePoint sites you currently have
mapped in My Network Places. If you do not see the SharePoint site you want, you may want to
first go to My Network Places in Windows and add the site. Alternatively, you can double-click
Entire Network in the dialog box and browse your Windows network.
Note: Entering or pasting in a SharePoint site URL in the Address box is NOT recommended.
However, it is possible to use a pasted URL if you edit it so that it contains only the sections
required for referencing the site. For example: http:\\servername.com\sites\mysitename
2. Double-click the SharePoint site that contains the document library you want to synchronize in
Groove.
The list displays all document libraries and subwebs hosted on the selected SharePoint site.
If the folder you want to synchronize is still further down the folder hierarchy, continue to
double-click folders until you see the folder you want. Select the folder and click Select.
• If you want to synchronize an entire document library into Groove, select it and click
Select.
Groove downloads all files from the selected SharePoint document library or folder. Note that the
workspace member who sets up the connection with the SharePoint document library is also the
synchronizer.
If you are the synchronizer in a Groove SharePoint Files tool, you can perform the following source control
tasks:
Checking out a file in the SharePoint Files tool places a lock on it in the SharePoint document library, thus
preventing users from updating the file directly in SharePoint. Keep in mind that you do not need to check
75
Groove 2007 User's Guide
out files to allow updating them in Groove and sending these updates to the SharePoint document library
during synchronization. Use this feature only when you want to ensure exclusive editing rights in Groove.
If successful, your name appears in the Checked Out To column in the file list. If the checkout is not
successful for one or more files, an error message displays. The most common reasons for failure include:
• The file is already checked out directly from the SharePoint site by another user. Note that the
Groove SharePoint Files tool does not indicate in advance that a file is already checked out from
the SharePoint library.
• The file is new in Groove and has not yet been sent to the SharePoint library.
The Check In to SharePoint dialog box displays and prompts you to describe the changes to the
listed file. If you selected multiple files for checking in, the dialog box lists the first selected file,
and then redisplays for each subsequent file after you click OK. As all selected files are checked in,
all updates are sent to the SharePoint document library.
Alternatively, you can check in all files that are currently checked out: Select Edit-Check In/Check Out-
Check In All My Checkouts.
Discarding a checkout
Discarding a checkout removes the lock on the file on the SharePoint site, and overwrites it with the most
current version from the SharePoint site.
To discard a checkout for files currently checked out to you via Groove:
1. Select the file or files for which you want to discard a checkout.
2. Select Edit-Check In/Check Out-Discard Checkout.
Alternatively, to discard the checkout on all currently checked out files, select Edit-Check In/Check Out-
Discard All My Checkouts.
Periodic synchronizations must occur in order to maintain parallel sets of data between the Groove
SharePoint Files tool and its associated SharePoint site. Every time a synchronization is started, all
changes that have occurred in both locations since the previous synchronization are exchanged. These
changes might include files that were added, deleted, renamed, or moved, as well as updates to file
content.
Only one member of a SharePoint Files tool can be the synchronizer, and therefore this member holds the
responsibility for initiating synchronizations with regular frequency. If you are the synchronizer and will be
unable to perform this task for an extended period, you should pass the responsibility to another member.
76
Sharing Files
Alternatively, you can enable scheduled synchronization so that synchronizations occur automatically at
specified time intervals.
77
Groove 2007 User's Guide
The synchronizer can switch between manual and scheduled synchronization at any time. To see the
current synchronization setting, point at the Calendar icon in the status area. For example:
1. Click the Calendar icon to open the Synchronization Schedule dialog box.
2. Make the changes you want and click OK.
The status area of the Groove SharePoint Files tool displays current synchronization status, but only for
the current synchronizer.
When the synchronizer clicks Synchronize Now... the Preview Synchronization window opens and
describes all pending updates. The Preview Synchronization dialog box also lists any pending changes that
78
Sharing Files
will result in synchronization errors. For synchronization errors that indicate a file conflict, it is
recommended that you take steps to resolve these cases before continuing with the synchronization.
Note: You can continue the synchronization without first resolving conflicts. If you do so, a
Synchronization Errors link will display. You can click this link to open a Synchronization Errors dialog box
that will display a list of the conflicts. However, this dialog box does not contain the automated features
for resolving conflicts that are found in the Preview Synchronization dialog box. You must consequently
take manual steps to resolve all conflicts.
The bottom section of the dialog box provides information about the cause of the conflict.
If your workspace role is participant or manager, you can request synchronization control in a SharePoint
Files tool. You might make this request for a variety of reasons. Most commonly, synchronization control is
passed only in cases in which the current synchronizer will be unable to initiate or manage the schedule
for synchronization for an extended period of time. It is generally not good practice to request
synchronization control if you are not planning to take on this responsibility for an ongoing period.
Instead, if you have an immediate need data to be synchronized, it is best to ask the synchronizer to
initiate a manual synchronization.
Note: For emergency situations, workspace managers can take over as synchronizer without making a
request.
A message window displays with information about synchronizer credentials. Specifically, you
should make this request only if you have direct access to the SharePoint site on a high speed
network. If you don't have direct access to the SharePoint site, you will be unable to run
synchronizations. It's also important to recognize that you're assuming a responsibility, and that
other members of the workspace will subsequently depend on you to run frequent
synchronizations.
2. Click OK.
Groove sends a message to the current synchronizer requesting synchronization control. If the
current synchronizer approves your request, you will become the synchronizer.
79
Groove 2007 User's Guide
If you use your Groove account on more than one computer, you can request synchronization control from
whichever computer currently has it.
Select Edit-Synchronize Now. A message window displays warning you that switching synchronization
control to this computer might take some time. This is because the act of switching computers requires a
full synchronization between Groove and SharePoint. If you choose to continue, the current computer is
immediately granted synchronization control.
If you are the current synchronizer in a SharePoint Files tool, other workspace members might send you a
request to become the synchronizer.
You might receive this request for a variety of reasons. Most commonly, you should transfer
synchronization control only when you will be unable to initiate or manage the schedule for
synchronization for an extended period of time. In some circumstances, you might need to ask another
workspace member to send you a request for synchronization control.
• It can only be transferred via the request of another workspace member. That is, the current
synchronizer cannot initiate transferring synchronization control without receiving a request.
• It should be transferred only to a workspace member who has access to the associated document
library on a selected SharePoint site, and who also has the required permissions for sending and
receiving updates on the SharePoint site.
Note: For emergency situations, workspace managers can take over as synchronizer without making a
request.
When you open the notifier, the Synchronization Control Request dialog box provides options for accepting
the request now or later, and an option for denying the request. It also tells you if there are any files
checked to you. If this is the case, it is strongly recommended that you defer accepting the request by
80
Sharing Files
selecting Accept Later. Once you take care of checking in any files, you can proceed to accept the request.
If you click Accept Later, the dialog box closes but the synchronization request notifier stays in your
taskbar. You can re-open it and select another option at any time.
To see the permissions currently assigned to member roles, select File-Properties-Tool and click the
Permissions tab.
By default, all members except for Guests have permission to add new files or folders, modify files, and
delete their own files or folders. Managers have all available permissions.
Additionally, in a SharePoint Files tool, all members except for Guests have permission to synchronize with
the SharePoint document library, or to request synchronization control for the tool from the current
synchronizer.
See Changing permissions for workspace tools for more information on modifying the default permissions
for a tool.
81
Chapter 8. Engaging in a Discussion
The Groove Discussion Tool lets you engage in a detailed exchange of ideas with other members of the
workspace. A typical discussion includes a main topic with one or more responses, and responses to
responses. Unlike a chat, which displays a running stream of responses in a flat view, a discussion lets
you see the entire "thread" of a conversation in a hierarchical structure.
The Discussion tool has two main windows: The Topics list, where you see only the Subject line of each
topic, and the Body window, where you see the contents of the topic.
Clicking the column headings switches the sort order between ascending or descending chronological
order. Note that regardless of the sort order, response topics always stay with their hierarchical parent
topic.
In addition to clicking the expand (+) or collapse (-) symbols to expand or collapse selected hierarchical
sections, you can expand or collapse all hierarchical sections by clicking the Expand All or Collapse All
icons in the toolbar.
The Groove Discussion tool is a Groove custom tool built using the Groove Forms Tool designer.
Workspace Managers will see a Designer drop-down menu on the toolbar that provides access to the
Groove Forms Tool designer.
Caution: The Groove Forms tool uses script code for some key features and should only be edited by
members familiar with scripting in Groove Forms.
82
Engaging in a Discussion
Depending on the current sort order of the topics list, a new main topic get placed as either the first or
last item in the list.
Right-click anywhere in the body field to see options for formatting text. You can also add other
rich-text features such as images and hyperlinks. Click Attach to add one or more file attachments.
For example, if you're responding to a topic that already has other responses, select the topic
you're responding to, not one of its responses.
You can accept the default response topic title (based on the hierarchical parent topic) or replace it
with a new one.
83
Groove 2007 User's Guide
The file attachment field in a Discussion topic contains the following action buttons:
Click to select one or more files to attach from your file system.
Click to launch the selected attachments. If you have editing permission for the topic, you can edit the
file in its application, and your updates will get saved Groove when you save updates. If you don't have
editing permission for the topic, a read-only version of the file opens in its application.
Click to save the selected attachments to a specified location in your file system.
Click to delete the selected attachments.
The tool permissions assigned to your role in the workspace usually allow you to edit only the topics or
responses you add to a Discussion tool.
Click Update to save your changes and close this topic, Save and Create Another to save and close
this topic and start a new topic, Revert if you want to start over with the original field entries and
selections, or Cancel to revert all changes and close the topic.
The tool permissions assigned to your role in the workspace usually allow you to delete only the topics or
responses you add to the Discussion tool. Keep in mind that deleting a topic also deletes any associated
response topics.
Note: To delete a topic that has responses, you must have the required permissions to delete the
response topics as well as their parent topic.
You can switch the data view in a Discussion to show topics and their responses sorted either By Date or
By Category. Click View by and select the view option you want.
84
Engaging in a Discussion
85
Groove 2007 User's Guide
To create links to discussion topics (or views in a Discussion tool), use the procedure as described in
Creating links for Forms records.
To export topics from a Discussion, use the procedure as described for exporting records from a Groove
Forms Tool.
To import topics into a Discussion, use the procedure as described for importing records into a Groove
Forms Tool.
To print in a Discussion, use the procedure as described for printing records in a Groove Forms Tool.
Searching in a Discussion
To search in a Discussion, use the procedure as described for searching for records in a Groove Forms
tool.
To set Discussion tool permissions, use the procedure as described for Setting permissions in a Forms or
InfoPath Forms tool.
86
Chapter 9. Exchanging Messages
You can send a message to any Groove contact. Your messages can include audio recordings, file
attachments, and Web address (URL) references. If Groove recognizes contacts listed in your contact list
as also being Messenger contacts, you can start Messenger activities with these contacts from Groove.
Note: If your selection includes at least one email contact, your email client will open instead of
the Send Message dialog box, with the email addresses of all selected contacts listed in the To:
field.
• Press Shift-Shift.
Note: If you already have a message alert in your system tray, pressing Shift-Shift opens the
message, not the Send Message dialog box.
Addressing a message
• From. The "From" text box automatically contains your default Groove display name (identity). If
you've created additional identities in your Groove account, you can select a different one from
the drop-down list. You create new Groove identities on the Identities panel of the Preference
dialog box.
• To. The "To" drop-down menu includes all currently "known" Groove contacts: this includes
Groove contacts you've added to your contact list in the Launchbar, as well as any Groove
contacts who are members in one of your workspaces. Click More to open the Add Recipients
dialog box in which you can search for and add other contacts.
You can add text with rich-text features, add audio and attach files to a Groove message.
• Message. Type the message text. Right-click to see formatting options. Click Check Spelling to
check spelling in the text editor.
• Audio features. Click the record button to add an audio message. Click the playback button to
play back the message you record. Click the delete button to delete an audio message.
• File button. Click to browse and select files to attach and send with the message. The name and
size (in bytes) of files you select displays in the Attachments list box.
Note: The total size of all attachments in one message may not exceed 25 MB.
87
Groove 2007 User's Guide
Click Send to send the message. Groove posts alerts (described in the table below) to inform you about
the progress of the message delivery for Groove recipients.
Note: Groove does not post these delivery alerts for Communicator recipients.
Alert Meaning
Message to "sender ": Waiting to send... Groove cannot yet send the message. The sender's
computer may be offline or may not currently have a
live network or relay service connection.
Message to "sender ": Sending... Groove is sending the message either to the recipient's
computer or to the relay service (if the recipient's
computer is offline).
Message to "sender ": Sent, waiting for The message left the sender's computer and will get
delivery... delivered if the recipient is online. If the recipient is
offline, the message is routed to the relay service.
Message to "sender ": Delivered... The message has reached the recipient's computer.
Message to "sender ": Opened The recipient has opened the message.
When you receive a message, Groove displays an alert in the Windows notification area. To open the
message, click the alert:
To delete the message without opening it, right-click the alert and select Delete from the drop-down
menu.
Message alerts disappear after a few seconds, but an envelope image blinks above the Groove icon to
inform you that you have an instant message.
What you decide to do with a message you receive depends on its contents. For example, a message may
contain file attachments and an audio recording for you to play back.
From:
88
Exchanging Messages
If the message contains audio, the notification you receive with the message tells you that it's a "Voice
Message." The audio message plays back automatically when you open the message.
Attachments
You see the Attachments pane in the Read Message window only if the message contains one or more file
attachments.
• Double-click a file name to open it in a supporting program. If your operating system can't
identify a program that supports the file, it displays an Open With dialog box that lets you select
a program.
• Select one or more files, and click Open.
• Select one or more items in the Attachments pane and click Save...
A directory dialog box opens. Select the disk location where you want to save the attachments and
click Save.
• Click Save All... to open a directory dialog box where you can save all the attachments in the list.
Images
You may sometimes see images or file attachment icons as part of message text instead of in the
Attachments: pane. Right-click an image or file attachment to see options.
Tip: If an image is wider than the message window (even when maximized), try copying it into another
program. Right-click the image to see options.
To reply to a message:
The Reply To Message window opens and displays the original message.
Note: If you do not want the original message included with your reply, uncheck Include history in
replies before clicking a reply option.
2. If you want to add additional recipients to the reply, click Add More... to open the Add Recipients
dialog box.
3. Type your message.
4. Click Send.
89
Groove 2007 User's Guide
You can forward a message you're currently reading or a selected message stored in the Message History.
The Forward Message window opens and displays the full content of the original message. Voice
recordings, if any, are stored as file attachments in .wav format.
If the "Integrate Messenger Contacts" option is checked in your account preferences, you can view
Messenger online status for all Groove contacts who also run Messenger, and start Messenger activities
with these contacts, such as text-chatting or VOIP. Additionally, you can address a Groove workspace
invitation to any contact in your Messenger contact list, regardless of whether or not they have Groove.
Note: The "Integrate Messenger Contacts" option is checked by default, unless a management policy
overrides this setting. The first time you start up Groove after installation or upgrade, you're prompted to
add all Messenger contacts who also have Groove to your contact list. If you decline to add these contacts
when prompted, you can add them individually at a later time.
Determining which Groove contacts are also in your messenger contact list
In the Groove Launchbar, you see the same contact awareness icons for contacts who only have Groove
as you see for contacts who have both Groove and Messenger. To determine which contacts are both
Groove and Messengers users, do either of the following:
• Point at the contact to display a status window. If the contact is in your Messenger contact list,
the status window will tell you the person's current status in Messenger. If the person is not in
your Messenger contact list, you won't see any status information for Messenger.
• Right-click the contact. If the contact runs Messenger, you see a Messenger Actions menu with
options for starting Messenger activities plus an icon that indicates the contacts current
awareness in Messenger. In the picture below, the awareness icons indicate that the selected
contact is offline in Groove, and online but idle in Messenger:
90
Exchanging Messages
If the contact is not in your Messenger contact list, you see a grayed menu option: "This contact is
not in your Messenger contact list"
If you're not currently signed in to Messenger, you see the command "Sign in to Messenger". Once
you've signed in, this command changes to "Messenger Actions".
The Message History provides the following options for viewing your messages: Inbox (received
messages), Sent , and All. You can sort the list by clicking the column heads. The text of the selected
message appears in a preview window. You can quickly scan through your messages using the up or down
arrow keys.
91
Groove 2007 User's Guide
Select messages you've sent to see their text in the preview window. You cannot play back audio
or open file attachments in your sent messages.
Open an invitation to display it in a Respond to Invitation window. If you accept or decline the
invitation, it gets deleted from the message history. However, if you close the invitation without
accepting or declining it, it will continue to be stored in the Message History.
If an invitee accepts or declines an invitation and includes a response message, this response
displays in the Message History as an invitation message. You can see the text of invitation
responses only in the preview window.
See Groove indicators to see a description of indicators that appear in the Message History.
You can create new messages, reply to or forward existing messages, change your message list view, and
print messages from the Message History.
In the Message History, you can search for messages that contain specific text.
Groove finds the next or previous message that contains the specified text. If no match is found
for the search text, Groove asks if you want to repeat the search from the beginning of the
message history.
92
Exchanging Messages
To Press
Create a new message CTRL+N
Open a selected message CTRL+O
Reply to a selected message CTRL+R
Forward the selected message CTRL+W
Delete the selected message CTRL+D
Find messages CTRL+F
Print the selected message CTRL+P
Check/uncheck "Include history in replies" CTRL+H
You can view all messages you've exchanged with any selected contact or workspace member.
93
Chapter 10. Chatting
You can chat with other Groove workspace members and contacts using:
• Text chat
• Audio chat
To access chat in a workspace, do one of the following in the Workspace Members panel:
• Click the Chat button to expand or collapse the chat area in the panel:
To create a new text chat entry, type in the text-entry field and press ENTER.
Tip: You can open the Spell Checker to scan for and fix spelling errors before you press ENTER to record a
chat entry. Click:
The text chat editor supports rich text features, such as text formatting, hyperlinks, and graphic images.
These features are available only while you're typing in the text-entry field. You cannot edit a chat entry
once it appears in the chat display window. Right-click in the chat text-entry field to see formatting
options or select options in the toolbar.
Right-click in the text-entry field to see menu options for switching between basic text mode and ink
mode. Ink mode lets you draw chat entries by dragging with the mouse, and provides options for styling
and editing these entries.
Note: Changing the chat editing mode automatically deletes any content you currently have in the chat
text-entry field.
The right click menu (and toolbar options in a Chat window or Chat workspace) correspond to the current
editing mode. If you have Text mode selected, you see the standard editing options you see in all rich-text
tools in Groove. If you have Ink mode selected, you see the following editing options:
94
Chatting
• Ink Thickness. Select a different thickness for a selected drawn object or for subsequent drawn
objects.
If you and other members of a workspace have a microphone connected to your computers, you can use
audio chat features. There are two audio-chatting modes:
• One to all mode. In this mode, the current speaker has first broadcasting privileges. Workspace
members can start talking while another member talks, but their voice entries will be delayed
until the current speaker finishes. There is no menu option for One to all mode. This is the
standard audio-chat mode unless you enable Conference mode.
• Conference mode. In this mode, all workspace members who have enabled this mode can speak
simultaneously. Other members are listeners. To enable (or disable) Conference mode, click the
Options drop-down button and select Chat-Conference Mode.
To use audio-chat, click the Microphone button and start speaking. A message window opens that shows
an audio signal bar that responds to your voice:
If you've enabled Conference mode, the audio message window and audio "channel" stays open until you
click Stop. If you're using "One-to-all" mode, the audio "channel" stays open as long as you continue
talking or until you stop talking for at least 5 seconds.
Note: The first time you try to talk using Groove, the Audio Tuning wizard runs (if necessary) to help you
adjust your system's audio settings so that you can use the Talk feature most effectively.
Groove can notify you about who's currently typing a chat entry or using audio chat.
While another workspace member is typing, a status message displays under the title bar with the name
of person typing the entry.
While another workspace member is talking, a text balloon automatically displays to tell you who's talking.
You can also point at the microphone to display a text window that tells you who's talking.
Searching in a chat
95
Groove 2007 User's Guide
To search in a chat, right-click anywhere in the chat window (or chat area in the Workspace Members
pane) and select Chat-Find in Transcript. Type a search string in the Find dialog box and click Find Next.
To print a chat, right-click anywhere in the chat window (or chat area in the Workspace Members pane)
and select Chat-Print Transcript.
Some chats become lengthy and thus you might want to occasionally delete the chat transcript area to
start over. To delete a chat transcript, right-click anywhere in the chat window (or chat area in the
Workspace Members pane) and select Chat-Delete Transcript.
You can undo or redo keystrokes that your typing in a chat entry by selecting Chat-Undo (CTRL-Z) or
Chat-Redo (CTRL-Y). However, you cannot undo or redo chat entries once you've entered them, and
they appear in the transcript.
You can chat with other members of a file sharing workspace much like you chat with members of other
types of Groove workspaces.
To start chatting:
1. Click the Expand Chat button to open the chat box in the Groove Folder Synchronization pane.
2. Type chat entries in the text entry box.
3. Right-click in the text entry box to open an Options menu. You can:
When you receive a new chat entry, the Chat title bar flashes (unless you've set alerts to Off in the
Workspace Properties dialog box).
The Audio Tuning Wizard helps you to adjust your computer's audio equipment for use with Groove. Keep
in mind that computer systems may have a wide variety of audio components installed in them and
therefore the results may differ from one to another. Still, the Audio Tuner should be effective for setting
up most audio systems.
To run the Audio Tuning Wizard, click the Options button in the chat area of a workspace and select Audio
Tuning Wizard...
Note: If you install other audio software, this may readjust your audio settings. You then may need to
rerun the Audio Tuning Wizard.
96
Chatting
97
Chapter 11. Scheduling Appointments
Groove Calendar Tool lets you mark important dates and build collaborative schedules with other
members of a workspace.
To add an appointment:
Enter the date using MM/DD/YY format or click the Calendar icon and select a date.
Enter the start and end time, or click the arrows to select start and end times.
The Calendar automatically makes time zone adjustments as follows: The Calendar assumes that
the appointment will be held in the time zone that corresponds to the Date and Time properties
currently set for your computer. For members whose computers are set for different time zones,
the appointment time automatically adjusts to reflect their time zone.
For example, if you are in Atlanta and schedule an appointment for 8:00 am, a member in Paris
will probably see this appointment as scheduled for 2:00 pm (depending on regional time zone
settings).
Tip: You can create appointments with pre-selected dates or times. Drag across the range of dates or
times you want and then click New Appointment.
Editing appointments
Unless you're a manager in the workspace, you can usually only edit Calendar appointments you added
yourself.
If you don't have permission to edit a Calendar appointment, the Edit Appointment dialog box
opens as read only.
Tip: You can also change date or time values using drag and drop.
Viewing appointments
98
Scheduling Appointments
The Calendar displays as much of each appointment as will fit within a date cell. You see more or less of
each appointment depending on which view you're using. For example, the Day view usually allows you to
see all information about an appointment, while the Month view only allows you to see a few words.
In any view, you can point at an appointment to display a text window that displays its full date and
details.
To change the Calendar display, select a display option from the View menu or click the Day, Week, or
Month icons.
View Characteristics
Day A detailed view of the selected day's appointments including details (if any).
Appointments for the selected day are displayed below in their appropriate time range.
Week A summary view for the appointments of a standard calendar week.
With more room available than for the Month view, you can usually see the full title of each
appointment. You can also see both the Start and End times of appointments.
As with the Month view, if a single date includes more appointments than will fit in the box, a
More button appears.
Month A summary view for the appointments of a standard calendar month.
If a single date includes more appointments than will fit in the box, a More button appears.
99
Groove 2007 User's Guide
Business The same view as "Week," except that the display allows more space for the business work
Week days.
Business The same view as "Month," except that the display allows more space in each week for
Month business work days.
Click Show Day Pane to show the selected day as a split panel in the Month or Business Month views.
Adjust the widths of the Month and Day panes by dragging the splitter bar left or right.
• To go to the previous or next day, week, or month in the Day, Week, or Month views,
respectively, click the Previous/Next buttons in the Calendar's title bar.
• To go to the previous or next appointment in any Calendar view, click the Navigate Previous
Appointment/Navigate Next Appointment toolbar buttons.
• To go to the previous or next unread appointment in any Calendar view, click the Navigate
Previous Unread/Navigate Next Unread toolbar buttons.
• To go to the current day according to your computer's system clock, click the Today toolbar
button.
• To go to a specific date in a selected view, select View-Go To Date, enter a date and view option
in the Go to Date dialog box, and click OK.
As with other workspace tools, you can create a link to the Calendar tool. In addition, you can create links
that go to specific Calendar appointments. To create an appointment link:
100
Scheduling Appointments
The link appears with the name of the Calendar appointment as the link's target.
You can export Calendar appointments for importing into another Calendar tool.
All exported Calendar data is saved as an .xml file (for example, Calendar.xml).
To import an exported Calendar file into another Calendar tool, do the following:
1. Select the Calendar tool in which you want to import the data.
2. Choose File-Import.
3. In the Import File dialog box, select the exported calendar .xml file and click Open.
To see the permissions currently assigned to member roles, select File-Properties-Tool and click the
Permissions tab.
All members except for Guests have permission to add new appointments, and add or delete their own
appointments. Managers have all available permissions.
See Changing permissions for workspace tools for more information on modifying the default permissions
for a tool.
Printing appointments
101
Groove 2007 User's Guide
Standard Windows keyboard shortcuts (for example, for cut, copy, paste, and delete) apply for the
Calendar. The table below lists other keyboard shortcuts.
To Press
Create a new appointment CTRL+N
View details for a selected ENTER
appointment
Copy an appointment as a link CTRL+L
Mark selected appointment read CTRL+F4
Mark all appointments read CTRL+SHIFT+F4
Go to a specific date CTRL+D
Go to the next/previous day, PGDN/PGUP
week, or month, depending on
the Calender view
102
Chapter 12. Tracking Issues
Groove Issue Tracking Tool is a tool designed using the Groove Forms tool and is useful for managing all
phases of issue reporting and response tracking. Users can create reports, assign ownership, and track
status over time.
• Issue: Use this form to capture the details of an issue, assign ownership and track status.
• Response: Use this form to create a response to an issue record.
All workspace members can create Issue and Response records. In addition, workspace members who
have the required privileges can create special Keyword records that are used to populate pick list fields in
the Issue records. These privileges are defined in the form design and may be granted by member role, or
directly to specific workspace members.
In Response records, the Title field is auto-populated as a reply to the parent issue record’s title.
103
Groove 2007 User's Guide
Depending on your assigned privileges, you may see several Keyword record options in the New drop-
down menu.
Keyword records contain values that display in corresponding drop-down list fields. For example, you
might create three Keywords/Status records to define the values "New", "Open", and "Closed". Then,
when you (or any other workspace member) creates a new Issue record and selects the Status drop-down
list field, these options will appear in the drop-down list.
1. Click New and select the keyword record type you want from the list.
2. Enter the keyword you want in the text box.
3. Save the keyword record.
To view keyword records, select the keyword type view from the view menu. Once you've selected the
view, you can open keyword records for editing.
In the Issue Tracking tool, you can add subkeywords to "Assigned Entities," "Category," and "Originating
Entities" keyword records that populate corresponding drop-down list fields. For example, you can edit
"Category" keyword records to add corresponding keywords for the Subcategory drop-down list field. Or
you can edit "Assigned Entities" keyword records to add corresponding keywords for the Individual field.
To add a subkeyword:
104
Tracking Issues
Below is a description of the different views for displaying records in the Issues tool. Note that all views
have a view filter that filters out keyword records.
All: Shows all records, with ID as the primary column. Click any of the column headings to sort the view.
Assignment: Enables sorting by the organization assigned to the issue. Columns displayed are assigned to
organization and individual, and issue title.
Category: Sort by issue category. Columns included are category, subcategory, priority, status, and title.
My Assignments: Offers a hierarchical sort, using a view filter to only display issues assigned to you.
Originator: Similar to the Assignment view in structure, but rather than displaying and grouping by the
assigned organization, Originator displays and groups by the organization and individual that originated
the issue.
Priority: Records are grouped by their assigned priority. Displayed columns are priority, status, title, and
created on date.
Status: Similar to the priority view, but with status as the primary and grouped-by column.
In addition to the above views, which are viewable by all members of the workspace, members who have
the required privileges have access to keyword views, which lists keyword records (by keyword type).
105
Chapter 13. Running Meetings
The Groove Meetings Tool helps you organize, conduct, and record meetings.
About meetings
Every meeting in the Groove Meetings tool contains the following components:
• Profile. This tab contains the basic details about the meeting, including its start and end times,
location, and a general description of purpose.
• Attendees list. This tab lists which workspace members are invited to attend the meeting, though
all workspace members can see a meeting's proceedings once they are posted. Initially, the
meeting creator is automatically appointed as the meeting "chairperson" and "minutes-taker" but
can assign these responsibilities to other meeting attendees.
The attendees who own the chairperson and minutes-taker tasks simply take on leadership
responsibilities for the meeting. For example, other attendees might ask the chairperson questions
about the purpose of the meeting. Likewise, if there are no minutes posted for a meeting,
attendees can inquire with the minutes-taker about when these will get posted.
• Agenda. This tab contains a time-ordered list of agenda items and an assigned presenter per
item.
• Minutes. This tab contains the meeting minutes. The attendee who records the minutes can
optionally insert the current agenda directly into the minutes.
• Actions. This tab contains a list of action items. The list can be sorted by due date, item, owner,
or priority.
Typically, all workspace members other than guests can create new meetings.
The information you entered in the Meeting Wizard displays on the Profile tab for the meeting. To edit this
information, click Edit, make your changes, and click Save and Close.
Once you have created a meeting, you can add meeting attendees, and start other meeting activities
such as setting the agenda.
106
Running Meetings
Given default permissions, any attendee whose role is participant or higher can add, edit, or move agenda
items, and only the meeting creator or workspace managers can delete agenda items.
To edit an agenda item, select it and click Edit. Make the changes you want and click Save and Close.
To move an agenda topic among the list of topics, select it and click or .
Given default permissions, any attendee whose role is participant or higher can add, edit, or move action
items, and only the meeting creator or workspace managers can delete action items. To add an action
item:
To sort action items, click the column headers. For example, click the "Priority" column header to sort all
action items by priority.
To edit an action item, select it and click Edit. Make the changes you want and click Save and Close.
Given default permissions, any attendee whose role is participant or higher can edit the meeting minutes.
To edit the minutes of a meeting:
1. Select the Minutes tab and click Edit, if necessary, to open the text area for editing.
2. Type in the text area. Optionally, click Insert Agenda to insert the current meeting agenda into
the text area.
3. Select an option to save or discard your work.
Given default permissions, any attendee whose role is participant or higher can edit the Attendees tab for
a meeting.
107
Groove 2007 User's Guide
1. Click the Attendees tab and click Edit, if necessary, to open the Attendees fields.
2. Make the changes you want and click Save and Close.
The meeting profile, agenda topics, and action items can all include file attachments. Typically, only the
meeting creator or workspace managers can add or delete file attachments.
Adding attachments
1. Select the meeting profile, an agenda topic or an action item and click Edit.
2. Click the Attachments drop-down menu and select Add.
3. Select the files to attach and click Open.
4. Save your changes.
Opening attachments
The attachment opens in a supporting application provided you have one installed on your
computer. If your computer does not have a supporting application, a Windows "Open With" dialog
box displays with other options.
Saving attachments
Deleting attachments
1. Select the meeting feature (profile, agenda topic, or action item) that contains the attachment
you want to delete and click Edit.
2. Click the Attachments drop-down menu and select Delete.
3. Select the attachments you want to delete.
4. Click Yes to confirm the deletion.
• Click and select the range of dates you want to display (for example, Day, Week, Month).
• Click the previous/next arrows to navigate to the previous or next date depending on the current
date range selection. For example, if your current date range is "By Week," click the arrows to go
to the previous or next week.
108
Running Meetings
To see the permissions currently assigned to member roles, select File-Properties-Tool and click the
Permissions tab.
By default, all members except for Guests have permission to create or edit meetings, as well as to delete
meetings they create. Managers have all available permissions.
See Changing permissions for workspace tools for more information on modifying the default permissions
for a tool.
The table below lists keyboard shortcuts for the Meetings tool. Available shortcuts depend on the mode in
which you are using the tool.
To Press
Create a new meeting CTRL+N
Create a new agenda item CTRL+T
Create a new action item CTRL+M
View all meetings CTRL+L
View only today's meetings CTRL+D
View the current week's meetings CTRL+W
View the current month's meetings CTRL+O
View the current year's meetings CTRL+R
Copy an agenda topic as a link CTRL+I
Copy an action item as a link CTRL+K
Copy a meeting as a link CTRL+E
109
Chapter 14. Writing in a Notepad
The Groove Notepad Tool is a rich-text editor that allows members to create documents that are saved as
pages.
Click to see a list of the note pages that you (or other members of the workspace) have added to the
Notepad tool. The Note list provides status information about notes, such as their size, modified date, and
last editor.
Viewing notes
To view note pages, click the Previous or Next buttons to move sequentially among note pages, or select a
note in the Note list.
1. Go to the note page you would like to edit and click Edit.
Note: If another workspace member is already editing the selected note page, Groove prompts you
to decide whether you want to edit the note anyway, or wait until the other member is done
editing. See “About editing conflicts” below for more information.
The Edit button in the Notepad displays a number if one or more other members are currently editing the
selected note page. You can point at the Edit button to display a text window that tells you who's currently
editing the note page.
110
Writing in a Notepad
If you click the Edit button while another members is already editing the page, Groove prompts you to
decide whether you want to edit the note anyway, or wait until the other member is done editing. If you
decide to continue and edit the page, Groove saves your changes in a new "conflict" copy of the note
page. A conflict page also includes a link back to the original Notepad page. The picture below shows the
title area of a conflict page:
Likewise, if you are editing a page and another member begins to edit the same page, Groove briefly
displays a message to inform you that another member has started to edit the page. For example:
If this happens, your changes are saved back to the original document and the other member's changes
are saved in a new conflict copy.
Alternatively, click Edit to modify a selected note and type a new name in the title box.
1. Go to the note page you would like to delete and click Delete.
You can also select the note page in the Note list and press the DELETE key.
You can export a selected note page in a Notepad tool as a rich text (.rtf) file. You can then open the
exported rich text file in other programs that support this format, such as Microsoft Word.
111
Groove 2007 User's Guide
3. In the Export to File... dialog box, specify a disk location and file name for the exported file and
click Save.
By default, the Notepad uses the title of the note for the file name.
You can search for text in a selected note page. You can search while a note is open for reading or editing.
However, if a note is open for editing, you must click in the text editing area before you start a search.
• Enter the text you want to search for in the note page.
• If you want, select options to refine the search for case-sensitivity and/or whole word
matching.
• Select the search direction.
Note: The search will proceed in the selected direction to the top or bottom of the note page
and then stop.
As with other workspace tools, you can create a link that selects the tool. In addition, you can create links
that go to note pages.
For example, to paste the link in a discussion, go to the tool, create a topic, right-click in the body
area and select Paste.
Select File-Print to print any note you're currently editing or have selected in the Note list.
To see the permissions currently assigned to member roles, select File-Properties-Tool and click the
Permissions tab.
By default, all members except for Guests have permission to create, edit, and delete note pages.
112
Writing in a Notepad
See Change permissions for workspace tools for information on modifying the default permissions for a
tool.
Standard Windows keyboard shortcuts apply for the Notepad tool. For example, use CTRL+C, CTRL+X,
and CTRL+V to copy, cut, and paste text, respectively. Use CTRL+B, CTRL+I, CTRL+U, and CTRL+K to
format text in bold, italics, underlined, or strike out text. Use CTRL+Z and CTRL+Y to undo/redo your
changes; use CTRL+A to select all text.
The table below lists additional keyboard shortcuts for the Notepad tool. Available shortcuts depend on
whether you are reading or editing a note.
To Press
Create a new page CTRL+N
Save an edited page CTRL+S
Save and close a page open for editing CTRL+W
Cancel an edit ESCAPE
Delete a note CTRL+Del
Copy the selected Notepad page as a link CTRL+L
Edit current page CTRL+E
Move to next page F8
Move to previous page SHIFT+F8
113
Chapter 15. Sketching
The Groove Sketchpad Tool lets workspace members draw together on sketchpad pages.
The table below describes the tools for drawing in the sketchpad.
Tool Action
Selects or deselects one or more drawn objects.
You can also right-click anywhere in the sketchpad to select any of the tools described in the table.
• To select an object that has no fill color, click any border to display a four-way selector icon.
• To select an object that has a fill color, click anywhere in the object.
114
Sketching
• To select all objects, right-click anywhere in the sketchpad and select Select All.
• To deselect one or more selected objects among a group of select objects, shift-click each object
you want to deselect.
• To deselect all selected objects, click an blank space in the sketchpad.
Tip: If you have many drawn objects and you'd like to select most of them quickly, it's often
fastest to first select them all, then deselect the ones you don't want selected.
You can set the line or fill color of new objects you draw, or change the line or fill color of a existing drawn
objects:
1. If you're changing line or fill color, select the drawn object using the Selection tool:
2. Click the Line Color tool or the Fill Color tool from the tool bar, and select a new color.
With either tool you can also select More Colors... to select a custom color.
All subsequent objects you draw use the selected line or fill colors until you change them again.
To move one or more drawn objects in a sketch, drag them with the mouse.
115
Groove 2007 User's Guide
You can use standard cut, copy, and paste commands to cut or copy and paste individual drawn objects or
an entire sketch.
To resize a drawn object, drag any outline handle with the mouse.
Adding text
1. Click and drag the mouse to define a text box area in the sketch.
2. Enter text in the text editing window, and click OK when you're done.
116
Sketching
Tip: The default text box is lined. If you do not want the text box to have a border around it, right-
click the text box and select Line Color-None.
Editing text
• To name a sketch, click in the name box in the upper, left corner of the sketchpad (initially
named "untitled") and type in a name.To begin a new drawing on a clean sketchpad, click New
Sketch.
• To delete an entire sketch, click .
• To add a background image to a sketch, click , select a JPEG (.jpg) or bitmap (.bmp) image
file, and click OK.
• To remove a background image from a sketch, click .
• Click the Previous/Next buttons to move sequentially among sketchpad pages.
To see the permissions currently assigned to member roles, select File-Properties-Tool... and click the
Permissions tab.
By default, all members except for Guests have permission to create, edit, and delete sketches.
See Change permissions for workspace tools for information on modifying the default permissions for a
tool.
To Press
Save text typed in the Type tool to the sketch CTRL+S
Selection tool S
Pencil tool P
Line tool L
117
Groove 2007 User's Guide
Rectangle tool R
Rounded rectangle tool O
Ellipse tool E
Polygon tool G
Text tool T
118
Chapter 16. Sharing Images and Pictures
Add a Groove Pictures Tool to a workspace to display and share picture files in JPEG (.jpg) or bitmap
(.bmp) format.
Click to see a list of the picture files that you (or other members of the workspace) have added to the
Pictures tool. The list provides status information about picture files, such as their size, type, modified
date, and last editor.
Adding pictures
• Click Add Pictures... to open the Open Picture File dialog box, select the picture file you want,
and click Open.
• Drag and drop picture files onto the picture viewing area or into the list.
When you add a new picture using the Open Picture File dialog box, it automatically displays in the
picture viewing area. Likewise, if you drag and drop a picture file in the list, the new picture automatically
displays and the file is added to the end of the list. If you add multiple pictures, the last selected picture
added is displayed.
Note: The Pictures tool automatically scales all pictures you add to fit the current size of the picture viewer
window.
Viewing pictures
To view pictures, click the Previous or Next buttons to move sequentially among pictures or select a
picture in the list.
Editing pictures
You can edit pictures in the Pictures tool if your computer has a picture editing program installed that
supports the selected file type. For example, if you open a JPEG (.jpg) file and you don't have a program
that supports editing this type of file, it will open for display in your Web browser or in a picture viewer.
On most computers, bitmap (.bmp) files will open into Microsoft Paint.
To open one or more picture files into a graphics editing program, right-click them in the list and select
Open. Depending on the graphic program and the operating system, a new window may open for each
file.
When you edit and save a picture, and then return to Groove, you're prompted to save the picture back to
Groove now.
Click Yes to save your changes back to Groove now and send them to all other members of the space.
Click No if you don't want to save changes back to Groove yet, and perhaps want to continue editing the
picture. Note, however, that if you click No after closing the picture in its editor, you will lose your
changes.
119
Groove 2007 User's Guide
Renaming pictures
To rename a selected picture, click in the title box above the picture and type in a new name.
As with other workspace tools, you can create a link that selects the tool. In addition, you can create links
that go to specific pictures.
1. Right-click the picture file you want to be the target for the link, and select Copy as Link.
2. Select the tool in which you want to paste the link.
3. Right-click the rich text location where you want to paste the link and select Paste.
The link displays with the name of the selected picture file.
Exporting pictures
Copying pictures
You can copy pictures from a Pictures tool into another Pictures tool or into a picture editing program.
1. Select the picture you want to copy in the list and click the Copy icon.
2. Open the program in which you want to paste the picture image and use its Paste command.
If you paste the picture into the same Pictures tool (for example, by selecting Edit-Paste or by clicking the
Paste icon in the toolbar), the picture appear in the list under the name "Copy of <picturename>".
However, you can paste the picture into another Pictures tool and it will appear under its original file
name.
To delete one or more pictures, select the pictures in the list, and press DELETE.
To cut a picture but place a copy of the image on the clipboard, select it and click the Cut icon. You can
then paste the image as a bitmap into another program or into another Pictures tool.
120
Sharing Images and Pictures
To see the permissions currently assigned to member roles, select File-Properties-Tool and click the
Permissions tab.
By default, all members except for Guests have permission to add or rename pictures, but only Managers
have permission to delete pictures.
See Change permissions for workspace tools for information on modifying the default permissions for a
tool.
Most standard Windows keyboard shortcuts work in the Pictures tool. For example, use
CTRL+X/CTRL+C/CTRL+V to do Cut/Copy/Paste activities, CTRL+A to select all picture files, and
CTRL+Z/CTRL+Y to undo/redo actions. The table below lists additional keyboard shortcuts.
To Press
121
Chapter 17. Working with Records in Custom Tools
Some tools in your Groove workspaces may be custom tools that were created either via the Groove
Forms tool or the Groove InfoPath tool. These custom tools share a set of common features, but are
customized for collecting and viewing data records in a variety of ways. Workspace members who have
"Designer Access" can further customize these tools. By default, only workspace managers have the
Designer Access enabled.
Note: Some custom tools provide specific concept and usage information about the tool. Most commonly,
you can find this information in the About This Tool window. To open this window, click Help-About This
Tool.
Some tools in your Groove workspaces may be custom tools that were created either via the Groove
Forms tool or the Groove InfoPath tool. These custom tools share a set of common features, but are
customized for collecting and viewing data records in a variety of ways. Workspace members who have
"Designer Access" can further customize these tools. By default, only workspace managers have the
Designer Access enabled.
Note: Some custom tools provide specific concept and usage information about the tool. Most commonly,
you can find this information in the About This Tool window. To open this window, click Help-About This
Tool.
There are two types of forms you might see on this menu, depending on the design of the custom
tool:
• New, main (top-level) forms. A Forms tool must contain at least one main form.
• Response forms. That is, forms for creating records that are hierarchically associated with an
existing "parent" record. Not all custom tools include this type of form. Generally, a
Response form will have a name such as "Response" or "Comment" that tells you about its
form type.
Before creating a Response record, select the main record you are responding to.
Some forms in custom tools contain "form views". A form view enables you to display the form
with a different set of fields in a different layout. To change a form view, select View-Change Form
View-<formviewname>.
122
Working with Records in Custom Tools
Reading a record
Your options for reading a record in a custom tool depend on whether the data view lists records in a
table, or one at a time.
If the data view lists records in a table, do one of the following to read records:
If the data view lists records one at a time, select the record you want to read from the "View by" menu.
Some forms in custom tools contain "form views". A form view enables you to display the form with a
different set of fields in a different layout. To change a form view, select View-Change Form View-
<formviewname>.
Editing a record
The tool permissions assigned to your role in the workspace usually allow you to edit only records you add
to a custom tool.
Some forms in custom tools contain "form views". A form view enables you to display the form
with a different set of fields in a different layout. To change a form view, select View-Change Form
View-<formviewname>.
Note: If you edit file attachments in a custom tool that saves previous versions of records as
responses, the newest version of the file attachment is saved in both the updated record and its
response version.
Copying records
You can copy records in the data view using standard Copy and Paste commands. This is generally useful
when you want to add many records that contain similar information. For example, you can add one
record, fill out all fields, use Copy and Paste to duplicate the record several times, and then open and edit
fields in each duplicate record.
123
Groove 2007 User's Guide
• The target tool is an earlier tool version as reported in the tool properties. For example,
you cannot copy records from a 5.xxx tool to a 4.xxx tool.
• The records copied from the source tool are derived from a form template not found in
the target tool. For example, you cannot copy records from a Discussion tool to an Issue
Tracking tool, or vice versa. In some cases, tools that appear to be similar may contain
records derived from different form templates.
• The target tool was created using a different custom tool designer, such as Forms or
InfoPath Forms. The base custom tool is reported on the General tab of the tool properties.
Click to select one or more files to attach from your file system.
Click to launch the selected attachments. If you have editing permission for the record, you can open
the file for editing in its application. When you reselect a Groove window, Groove prompts you to
update the tool with any edits you have saved in the file. When you update the tool, the edits are sent
to all workspace members. If you don't have editing permission for the record, a read-only version of
the file opens in its application.
Click to save the selected attachments to a specified location in your file system.
Click to delete the selected attachments.
You can double-click the image to open the file in a supporting application. Right-click the image to see
other options.
Deleting a record
The tool permissions assigned to your role in the workspace typically allow you to delete only records
added by you to a custom tool. Keep in mind that deleting a record also deletes any response records
associated with the record.
Note: To delete a record that has responses, you must have the required permissions to delete the
response records as well as their parent record.
124
Working with Records in Custom Tools
Changing views
A custom tool might contain two types of views: Views that allow you to see the current collection of
records in different ways, and views that allow you to see the content of individual records in different
ways. The first type of view is called a data view; the second type of view is called a form view.
Data views in most custom tools display as tables of rows and columns, with each row represent one
record, and each column referencing data fields in each record. A data view might also display only the
content of a single, selected record.
If a custom tool contains multiple data views, you can select a different view at any item from the View by
menu. The currently selected view is marked with a bullet. You can also switch data views from the
Current View drop-down list in the status bar.
If the custom tool lists records one at a time rather than in a table list, you must use the View by menu to
navigate among records.
If a custom tool contains form views, the Change Form View menu command is listed on the View menu.
When you change the form view for a selected records, all records you subsequently select will display
using the currently selected form view. To change a form view:
As with other workspace tools, you can create a link that selects the tool in a custom tool. In addition, you
can create a link that goes to a specific record or view in the custom tool. You can paste a link to a custom
tool record or view into any tool that supports rich text, such as Notepad, Chat, or a rich-text field in
another custom tool record.
Note: Some forms in custom tools may not contain any rich text fields and therefore cannot be used for
creating links.
125
Groove 2007 User's Guide
Printing records
Print all records that are listed in the currently selected data view
• Select File-Print.
• Click Print all records.
• Click the option you want for printing all records and click OK.
• Click Print in your computer system's Print dialog box.
• Select File-Print.
• Click Print view and click OK.
• Click Print in your computer system's Print dialog box.
Some custom tools include special forms that are set up mainly for printing purposes. These forms might
have a layout designed specifically for a print layout, and includes or excludes fields as needed.
Note: If you don't see this option in the Print dialog box, the custom tool you're using does not
support this feature.
126
Working with Records in Custom Tools
Importing records
You can import records into a custom tool via the following types of files:
• Forms Binary XML, as exported from a Groove Forms tool as "Binary XML" or "XML (without
attachments)".
• Comma-delimited (CSV), as exported from a Groove Forms tool as "Comma Delimited" or saved
as a CSV file in another application (such as Microsoft Excel).
• Forms 2.5 XML or Binary, as exported from a 2.5 Forms tool (using Office Groove 2007) as
"Binary XML" or "XML (without attachments)".
Note: If you do not see an Import option in File menu, this means the custom tool does not support the
import feature. Custom tools developed in Microsoft InfoPath do not support importing records.
Imported records can be viewed only if the Forms tool application contains corresponding fields and view
columns. For example, if you import a file exported from a Forms tool application that contains a "Name"
and "Address" field, you see the imported records in the data view only if the target Forms tool also
contains these fields.
If the sort type in the selected data view is "Flat" or "Hierarchical", imported records appear as new
records at the top or bottom of the data view (depending on the current sort order).
If the sort type in the selected data view is "Grouped," imported records are placed within categorized
groups, and sorted in each group depending on the sort order defined for the view.
To import a file exported as either Binary XML or XML (without attachments), do the following:
• Select the form to use for importing records from the drop-down list.
Be sure to select a form that contains fields and data types that match the column headers
and data types in the .csv file.
• If the .csv file was saved in Microsoft Excel, check Microsoft Excel.
• Select the character set used to create the CSV file you are importing from the drop-
down list.
You must select the same character set in which the CSV file was saved.
• Select the locale in which the CSV file you are importing was created from the drop-
down list.
You must select the same locale in which the CSV file was saved.
127
Groove 2007 User's Guide
3. Select the CSV file you want to import and click Open.
You can import files created and saved as CSV in other applications such as Microsoft Excel. However,
keep in mind that column headers must be formatted to match the field names and field types in the
Forms tool application.
Additionally, note the following details about importing CSV files saved in Microsoft Excel:
• Column headers for values to be imported into numeric fields (such as Number or Currency) must
be qualified using the "Double" data type. For example:
Cost:Double
$35.95
• Column headers for values to be imported in text fields can optionally be qualified using the
"String" data type. For example:
City:String
Hoboken
• Column headers for values to be imported into date and date/time fields must be qualified using
the "Date" data type. For example:
Start_Date:Date
March 14, 2005
Additionally, date entries in Excel must use an MM/DD/YY date format, and in English locales,
Date/Time entries must use 12-hour (nonmilitary) time formatting:
3/14/05
03/14/05
3/14/2005
March 14, 2005
3/14/05 1:30 PM
As noted above, when you import a CSV file saved from Excel (or another source application) into a Forms
tool, the column headers in the .csv file must match the exact names of associated fields in the Forms tool
in order for the field values to import properly.
To achieve this exact matching, it is important to know how to correctly identify field names in the Forms
tool, and to remember that field names are usually NOT the same as their associated field labels.
When you select a field in the form layout, the field is also selected in the field list below, which
also lists the associated field name as well as its field type. In the example below, the field labeled
128
Working with Records in Custom Tools
"Event Start" is selected. The field list reveals that this is a Date field with the field name
"Event_32Start".
In Excel, the column header match for this field would be: "Event_32Start:Date".
You can also identify field names and data types by viewing record properties.
In some locales (other than the English (United States)), Excel files saved as CSV use characters other
than a comma as tab delimiters. These files will not import properly into a Groove Forms tool because only
comma-delimited CSV files are allowed for this procedure.
If you are having problems importing CSV, and are uncertain about whether you are experiencing locale
issues, you can try opening the exported CSV file in a text editor such as Wordpad, and changing the tab
delimiters to commas. If you update the file, be careful to avoid changing other punctuation characters. In
the example below, all commas are tab-delimiters except for the commas that are part of the date values.
Note that values that include the tab delimiter character must be enclosed in quotation marks.
Groove 2007 no longer supports Groove Forms tools created using Groove 2.5. If you select a Groove 2.5
Forms tool in Groove 12, you are prompted to export the tool design and records for importing into a new
Forms tool. For information see Migrating from a Groove 2.5 Forms tool.
Exporting records
You can export records from a custom tool as structured text, tab-delimited text, comma-delimited text,
binary XML, XML (without attachments), or Microsoft Excel 2007. Note the following guidelines for
exporting records:
• You can choose between exporting all records in the tool, or all records displayed in the current
view or search result.
• If you opt to export all records in the tool, records get exported in the order in which they were
created, regardless of the current sort order in the selected view.
• If you opt to export all records in the current view, records get exported according to the current
sort order for the view.
129
Groove 2007 User's Guide
• For tabular text and structured text options, the data that gets exported depends on the columns
that are included in the selected view. For example, if the selected view includes only two
columns, the exported data will only include values from the fields referenced in those columns.
1. Select File-Export All Entries, and select the export format you want.
2. Select the options you want for exporting entries, and click OK.
• You can opt to export only the entries listed in the current view, or to export all entries in
the tool.
• You can select a specific form to use from the dropdown menu. The exported data will
only use fields in the selected form.
• When exporting to Microsoft Excel, if you want the export to include all System fields in
the selected form, click Include System Fields. In addition to fields such as "Created By"
and "Modified By", every form contains a lengthy list of other System fields that serve
administrative purposes, and are hidden on the form. In most cases, it is preferable to
exclude these fields when exporting into an Excel spreadsheet. Note that this option is
available only for exporting to Excel.
3. Select a location in which to place the exported file, and click Save.
The following table describes the file formats for exported records:
Note: This export option is used most effectively with records that do not include file
attachments. If records contain file attachments, the contents of these files may be
removed on export.
Comma-delimited Exports records to a comma-delimited .CSV file. This format includes an option for
creating the .CSV file for Microsoft Excel compatibility. Note that the order of columns,
once imported into another application, may differ from the order of columns in the
view.
130
Working with Records in Custom Tools
Excel Opens Microsoft Excel 2007, and displays exported records in a new Excel spreadsheet.
131
Groove 2007 User's Guide
Running a macro
Custom tool designers commonly provide macros that allow you to run processes on all or selected
records in a data view. These processes allow you to do things like change the value of a field in a set of
records at once, or extract field data from a set records.
1. Select the data view in which you want to the run the macro.
2. If appropriate, select the records on which you want to run the macro.
You can also run a macro on Search results. You may sometimes want to search for a set of
specific records for the macro to update.
3. Select the macro you want from the Run Macro drop-down menu.
Note: The Run Macro drop-down menu displays only if the tool contains at least one macro.
1. Find. Use this method to find the next or previous record that contains specific text.
2. Simple search. Use this method to find and list all records that match field values you enter in a
form.
3. Advanced search. Use this method to find and list all records that match one or more logical
expressions.
You can search for the next or previous record in the current data view that contains specific text.
Groove finds the next or previous record that contains the specified text. If no match is found for
the search text, Groove displays the message "No matches found for this search text."
Additionally, the search always continues from the top or bottom of the list, depending on the
direction in which you are searching.
1. Select Edit-Search.
2. Select the form to use for specifying search criteria from the drop-down list.
3. Select or enter search values in the available form fields.
132
Working with Records in Custom Tools
• For fields in which you enter values, you can search using any part of the field value. For
example, you can find all records that contain the name "Baker" by entering the search
criteria "Bak".
• Searches are NOT case-sensitive. For example, entering "Baker" as search criteria is the
same as entering "baker".
Additionally, note that some search forms may include only fields referenced in the custom tool's
view columns.
4. Select an option for how the search should use the specified criteria.
5. Click Search.
The data view shows only the records that match the criteria you specify. To restore the original
data view, click in the toolbar or select Edit-Clear Search Results.
Note: You must clear the search results before starting another search.
The search result will show records created only with the selected forms.
Search expressions test field values, and display records in the data view that match the conditions
stated in the expression. You can add basic expressions or advanced expressions.
4. Click Search.
The data view shows only the records that match the conditions you specify. To restore the original
data view, click in the toolbar or select Edit-Clear Search Results.
Note: You must clear the search results before starting another search.
1. Select the field for which you want to test values from the drop-down list.
• Date/Time fields are not supported in search expressions, and therefore do not appear
in the drop-down list of fields.
• Depending on the tool design, the list of fields may include only fields referenced in the
custom tool's view columns.
133
Groove 2007 User's Guide
The operators you see differ depending on the field type. Text-related fields provide operators that
work with text strings, such as "contains", and "starts-with"; number-related fields provide
comparison operators such as >, >=, <, and <=.
3. Enter the value you want to test for in the text box.
4. Click .
In the following example, the search expression displays all records in which the value in the "City" field is
"Warsaw".
You may sometimes need to test for more than one condition. To do so, you can add an expression that
contains logical operators. You can create an expression that selects records only if ALL conditions are met
(logical AND operator), or if ANY conditions are met (logical OR operator).
1. Select All of the following conditions (logical AND) or Any of the following conditions (logical OR),
depending on how you want to specify criteria for finding records.
2. Add each condition, one at a time.
In the following example, two expressions are added with the "Logical OR" option selected. The result will
display all records in which the value in the "City" field is either "Warsaw" or "Krakow".
1. Select the condition you want to update in the expression display box.
The parts of the condition display in the drop-down lists and value text box.
To remove a condition from an expression, select it in the expression display box and click
134
Working with Records in Custom Tools
Click to see options that enable you to further modify a search expression. You can create expressions
that combine AND and OR logical operators, and group sets of conditions together.
• To change a logical operator, select the condition and click AND or OR.
• To combine conditions so that they're interpreted as a whole in the expression, SHIFT-select
them and click .
In the following example, the AccountNumber field and the City field conditions are combined such
that the expression tests the values in each combined condition separately. In this case, all records
are selected in which the value in the AccountNumber field is >=300 and <=400 AND the value in
the City field is NOT Warsaw and NOT Krakow.
You can use the {UserName} variable to create a search that finds only records created by the current
user. This variable must always be used together with the _CreatedByUrl field.
5. Click Search.
Sorting records
The default sort order for records in a data view is the order in which records where added to the tool. You
may also be able to switch between ascending, descending, and ordinal sort order, on a per-column basis,
depending on the sort options the custom tool designer assigned to each view column. Click column
headers to test their sorting capabilities.
135
Groove 2007 User's Guide
In addition to viewing standard workspace tool information, you can view summary information added by
the custom tool designer.
• Info: Lists information about when and by whom the record was created and modified.
• Fields: Lists all defined form fields in the selected record, as well as all system fields. Select any
field in the list to see its data type and value. A value is listed only if the selected record uses the
selected field on its data form.
• Advanced: Lists the Record ID number for the selected record.
To see the permissions currently assigned to member roles, select File-Properties-Tool and click the
Permissions tab.
By default, Managers have all permissions, Participants can create, edit, and delete their own records, and
Guests have read-only access to records.
See Changing permissions for workspace tools for information on modifying the default permissions for a
tool.
136
Chapter 18. Creating Custom Tools
You can create a custom tool using the following Groove tools:
In the Groove Forms tool, application developers create and lay out all design objects directly in
the Forms tool designer, including forms, fields that display on the forms, views, macros, and
styles.
With the Groove InfoPath Forms tool, tool development tasks are divided between Microsoft
InfoPath 2007 and the Groove InfoPath Forms tool. Application developers define fields and form
layout in Microsoft InfoPath 2007 and then import these objects via an .xsn template file into the
Groove InfoPath Forms tool. Application developers can also use existing InfoPath form templates
as the basis for the custom tools they bring into Groove.
In the Groove InfoPath Forms tool, application developers add features similar to those found in a
Groove Forms tool such as views and macros. Application developers continue to use Microsoft
InfoPath 2007 to modify fields and form layout, and then re-import these updates into the Groove
InfoPath Forms tool.
You can save custom tools created via the Groove Forms Tool or Groove InfoPath Forms Tool as a
template file, and then add it as a new tool in other workspaces. This allows you to capture all design
objects, such as forms, fields, views, macros, and scripts, without also including data records. Creating a
tool template provides a way for designers to distribute custom tools for use in workspaces. It also gives
designers a separate development tool for updating production workspace tools using replace design.
Designers can use replace design to update a Forms tool or to update an InfoPath Forms tool.
You can lock the design of a Forms or InfoPath Forms tool application before you save it as a template.
Use this feature if you want to prevent others from updating the design in workspaces they create using
the template.
If you accept the default location, the Groove Tool Templates folder in My Documents, the new tool
will be listed in the More Tools list. To see the More Tools list, select File-New-Tool-More Tools.... If
you place the list in another location, you can browse to it by selecting File-New-Tool-Browse....
4. If you want, set password information in the Template Options dialog box, and click OK.
137
Groove 2007 User's Guide
When you save a Forms or InfoPath Forms tool as a template, and then add it to a workspace, the tool is
automatically upgraded to the latest version, even if the tool template was saved using a tool from an
earlier version of Groove. For example, if you create a tool template from a Groove 3.x Forms tool, and
then use this tool template to add a Forms tool to a new workspace, this Forms tool will automatically be
upgraded to a Groove 2007 tool version.
Additionally, note that Office Groove 2007 does not support adding tools from tool templates to earlier
workspace versions. For example, you cannot add a tool template created from a Groove 3.x Forms tool to
a workspace created in an earlier version of Groove.
A Forms or InfoPath Forms tool template is simply a data file, with a *.gta file extension. As such, you can
distribute it to other Groove users just as you would for any other data file. For example, you can send it
as an email attachment, place it in a Groove Files tool, or place it on a file server or Web site.
To assist other users, you might provide instructions on where to place the template file, such as the
folder location that will allow the tool template to display in the More Tools list: the Groove Tool
Templates folder in My Documents.
The Groove Forms Tool lets workspace members create records using custom forms which are displayed in
custom views. Click Start Here to start creating the design elements of a new Forms tool application. If
you want, you can save a Forms tool application as a tool template that you and others can add to any
workspace.
• Forms tool designers. Forms tool designers create a workspace that includes a Forms tool, and
define design objects such as fields, forms, and views to be used for collecting and displaying
data records. Once a Forms tool contains at least one form and view, it is ready for contributors
(invited workspace members) to add records using the forms in the design, and then sort and
analyze them in one or more data views.
The Forms tool designer might invite people to become members of the workspace in which the
Forms tool is originally created, and in which he or she is also a member. Alternatively, the Forms
tool designer might save the Forms application as a new tool template to be distributed or made
public.
• Forms tool users. Forms tool users are any Groove users who are invited to a workspace that
contains a tool created using a Forms tool. Their task is usually to create records by filling out the
custom forms created by the Forms designer.
For example, employees in a workgroup might be invited to a workspace with a custom "Status
Report" tool, that is, a workspace that contains a Forms tool with a form designed for filling out
status reports.
138
Creating Custom Tools
Every Groove Forms Tool begins with an idea for a custom application. A Forms tool application developer
creates the custom tool in the Forms tool's "design sandbox" based on a set of requirements. He or she
does the following procedures:
For example, a Human Resources department might want to collect information on job candidates
in a "Hiring Requisition" Forms application. Employees in the department might design the Forms
application themselves, or they might enlist a Forms designer to build the application for them to
their specifications. In this case, the Forms designer can create the required forms and views in
the Forms tool workspace, save the workspace or tool as a template, and then make the
template file available perhaps by email, by posting it on a file server, or by adding it to a Files
tool in a workspace. The Human Resources employee can then browse for the workspace
template when creating a new workspace, or browse for the tool template in existing workspaces.
Forms tool applications are created in the Forms tool "design sandbox." Only workspace members who
have the Designer Access permission can access and make changes in the design sandbox. By default,
workspace managers have Designer Access.
The Forms design sandbox is a rich and flexible environment that allows multiple workspace members to
contribute to the design of an application. For example, one member might add all the fields to be used in
forms, and another might add and layout these fields on the forms. The only limitation imposed on
multiple users is that only one at a time is permitted to access the design sandbox. However, multiple
users can work on their own, individual versions of a Forms design, as described below.
A Web service is available for use with the Forms tool. This Web service comes with full create, read,
update and delete methods for accessing Forms records. Usage scenarios for the forms Web service may
range from integrating structured data from other enterprise applications or databases with Groove, to
building a stand-alone local application that makes use of Groove services and the forms data engine
while controlling the user interface. For more information, see the Forms Programming Documentation.
When you open the design sandbox, the design objects you see represent a copy of the live design. It is a
place where you can preview design changes without sharing them with other workspace members until
all changes are completed. All changes made in the design sandbox remain local on your computer until
you take an action to either publish your changes or discard your changes. You can exit the design
sandbox (or even exit Groove) and return to it later to continue to making changes.
When you publish changes you've made in the design sandbox, you return to the data view of the Forms
tool where you can see the effects of your design changes. Additionally, all design updates are sent to
other workspace members for use with the Forms tool application. Workspace members who have
Designer access can subsequently open the Forms designer, creating a new design sandbox, and view the
updated design objects.
Once you create a design sandbox, you cannot see design changes published by other workspace
members until you first close the sandbox, either by publishing or discarding it, and then creating a new
design sandbox. Keep in mind, however, that changes made by other members might overwrite changes
that you publish and vice versa. For example, if two people update the same design element such as the
properties of a form field, the last person who publishes their changes overwrites the changes from the
person who published earlier. Forms tool designers should be aware of the risks associated with having
139
Groove 2007 User's Guide
multiple people updating the design. Make sure that they communicate effectively about what parts of the
design they are updating, and thus avoid overwriting each other's updates.
If you are already working in a design sandbox, but you want to see design updates published by other
people in your sandbox, do the following:
Forms tool applications have two main design objects: forms and views. Forms are used for collecting data
from members of a workspace. Views are used for presenting this data to all members of the workspace.
Additionally, you can add features to a Forms tool application using scripts, styles, and macros.
Form objects
A form consists of a variety of fields, depending on the information to be collected. For example, there
may be fields for entering text, selecting an item from a list, checking a Yes/No option, and many others.
Each type of field has a corresponding set of editable properties that allow you to provide guidance or set
rules for people who use the forms. For example, you can place an initial value in a text field, set limits for
the number of characters in a field, or make a field required.
With the Forms tool, any field you create in one form gets stored in a field library. The stored field is then
available for adding to any other form in the Forms tool in the current workspace. For example, if you
create a "Last Name" field in one form, you can then add this field to other forms within the same Forms
tool.
Even if you delete a form, all unique fields created in that form remain available to include in other forms
you create.
View objects
Views show the data collected in records and give workspace members ways to sort and interpret the
data. For example, suppose you created a form for collecting administrative data about employees. The
form in that case might have fields for employees to enter their first name, last name, department name,
manager's name, office and phone numbers, equipment serial numbers, and so on. In this case you might
have several views. One might sort the data by last name, another by department name, another by
manager's name, and so on.
• View mode. Records are displayed in table columns where each column represents one form field.
The designer selects the fields to be displayed as view columns and optionally sets up sorting
options for each column.
• Document mode. Records are displayed one at a time in the Forms viewer. The designer can
select specific field values to be listed in the View menu. For example, if a Forms tool contained a
unique record for every employee in the company, you might decide to list the values in a "Last
Name" field in the View menu.
Scripts
140
Creating Custom Tools
You can add script code using JavaScript or VBScript to a selected form and produce effects that go
beyond the standard features currently provided in the Forms tool. For example, you might use script
code to hide or show a set of fields depending on a user action.
Styles
You can apply different styles to any selected form. Styles affect form background settings as well as all
text style settings such as those applied to field labels.
Macros
Macros allow Forms tool users to run processes on all or selected records in a data view. Typically, macros
are used to update field information in a set of records.
When you first add a Groove Forms Tool to a workspace, you see the "Welcome" page which provides a
brief overview of the tool.
Click Start Here... to open the Forms designer where you create all custom tool design elements.
Workspace members who have Designer access can replace a Forms tool design with the design from
another Forms tool. Although Forms tool designers can always update a Forms tool application's design
directly in the tool, designers may sometimes opt to use a "Replace Design" process for the following
reasons:
• It separates the Forms tool design process from the production Forms tool and provides an
environment for updating a Forms tool design without entering the designer in the production
Forms tool.
• Designers can introduce and test design updates more freely, without needing to be immediately
mindful of how the updates will affect users. The designer performs the Replace Design operation
only after a specific set of updates is complete and tested.
• In a Forms tool application in which the design is locked, meaning that access to the designer in
not available, using the Replace Design process is the only option for updating the tool design.
The use of Replace Design is appropriate only under the following circumstances:
Designers who have access to the Forms designer in the production Forms tool should avoid using Replace
Design to introduce smaller, incremental design updates. This is because the Replace Design operation
141
Groove 2007 User's Guide
replaces every design object in the tool, even those that are identical to the ones replacing them.
Depending on the size and complexity of the Forms tool design, this activity may push large numbers of
updates to all workspace members.
Caution: Replace Design literally replaces every single design object in the target Forms tool with a new
version, even though the new versions of most of these design objects are typically exactly the same as
the previous ones. Replacing a Forms design via a Forms tool that contains significantly different design
objects will likely have significant impact on access to and the appearance of existing record data. For
example, if the design used for replacement contains few or none of the fields contained in the original
Forms tool, all data stored in these fields will be lost.
For optimal results, it is best to use the following general steps for setting up a Replace Design process:
1. Do all Forms design work in the production Forms tool until it's ready for deployment: that is,
until it is ready for workspace invitees to become members and start adding records.
2. Before inviting members, save the workspace as a template.
3. Create a new workspace using the workspace template.
You will now have two workspaces, each of which contains Forms tools with identical design
objects. The copy of the Forms tool in the new workspace can be used as the design "master",
meaning that from now on you will make ALL design updates via the Forms designer in this Forms
tool.
4. In the production Forms tool, run the Replace Design process, referencing the workspace that
contains the master Forms tool template.
Alternatively, instead of saving the original workspace as a template, you could save the original Forms
tool as a template. You could then add this Forms tool to another workspace or even to the same
workspace. Some Forms designers might opt to create a workspace that simply contains a set of Forms
tools used as design masters.
When you replace a Forms tool design, you replace the set of design objects (such as forms, views, fields,
macros, scripts, and styles) in the current Forms tool with those of the Forms tool you select in the
Replace Design dialog box. The resulting set of design objects will have these characteristics:
• Any design objects that were not previously in the Forms tool design are added as new objects.
• Any design objects of the same name are simply replaced and use the properties of the
replacement object.
For example, if you replace a Text field named "City" with another Text field named "City", this
field changes only if the replacement field has different field properties.
• Any design objects from the original Forms tool design that are NOT part of the Forms tool used
to do the replace design are deleted from the original Forms tool.
For example, if the original Forms tool contains the text field "City" and you replace design with a
Forms tool that does not contain this field, the "City" field will be deleted. It's important to keep in
mind that if existing records included data in this field, this data will be lost.
In some cases it might be possible to change a field's type using Replace Design. For example, you could
change a Date field to a Date/Time field, or a Text field to a Multiline Text field. However, this practice is
generally not recommended for the following reasons:
142
Creating Custom Tools
• Not all field types are compatible. Changing a field to an incompatible type will result in data loss
for existing records. For example, you cannot change a Text field to a Number field and retain
field values for this field in existing records.
• To change a field type, you must be able to create a new field in the master Forms template that
has the exact same name as the field whose type you want to change in the original Forms tool.
However, if you have created your master template using the Replace Design process described
in this document, you cannot create a new field under the exact same name because the Forms
tool permanently stores field names once fields are created.
For example, suppose you have a Text field named "Cost" in your original Forms tool. In your
master template (created via saving the workspace containing the original Forms tool as a
template), you have the exact same Text field, but you'd prefer if this were a Currency field.
However, you cannot create a new field named "Cost" in this workspace even if you delete the
existing Text field named "Cost" and then re-create it because the Forms tool still stores the name
of the original field. If you create the new field, and type the name "Cost" in the Name property of
the field, the field name will be saved as "Cost0", and subsequently, "Cost1", "Cost2", and so on.
Replace Design is highly effective for making changes to field properties. However, just as with changing
field properties directly in a production Forms tool, some changes to field properties may impact data in
existing records. When making these changes, Forms designers should always be careful to consider
whether the changes may enforce new restrictions on allowable data.
For example, suppose the original Forms tool includes a List Box field that allows multiple selections, but
you update this property in the master Forms tool so that it allows only a single selection, and then
replace your design. Any existing records that previously contained multiple selections in the List Box field
will actually continue to store them, but only until the first time the record is edited. At that time, only one
selection will be allowed in the List Box field, and initially, no values will be selected.
Workspace members who have Designer access can replace a Forms tool design with the design from
another Forms tool. This method of updating a Forms tool design allows Forms designers to keep design
update work separate from the original Forms tool, and makes it easier for designers to experiment with
design options before disseminating them to all workspace members. Additionally, if a Forms tool has a
locked down design, replacing a design is the only available method for updating the tool's design.
For details and recommendations regarding the replace design process, see About replacing a Forms tool
design.
Microsoft Office Groove 2007 no longer supports Groove Forms tools created using Groove 2.5. If you
select a Groove 2.5 Forms tool in this Groove version, you are prompted to export the tool design and
records for importing into a new Forms tool. Once exported, you will have a Forms Database Template
(.fdt) file that contains the Forms tool design, and a Binary XML file that contains the data records.
143
Groove 2007 User's Guide
• Design updates made in an external HTML editor are not retained. For example, if you rearranged the
layout of form fields in an external HTML editor, these changes will be lost when you import the
design into the new Forms tool.
The migration will retain all design objects, including all fields, forms, and views. Thus, you can
restore your original design by selecting and laying out fields in the Microsoft Office Groove 2007
Forms tool.
• Form scripts may not work correctly and may need to be re-created.
All 2.5 Forms design objects should now be present in the new Forms tool.
Importing the 2.5 Forms tool data records into a new Forms tool
All original data records should now appear in the data view.
You can now re-invite members to the new workspace. Note that all members will retain all associations
with records they had originally created or updated.
Caveats for importing 2.5 Forms records into a new Forms tool
If the 2.5 Forms tool design you are importing contains fields that are not currently in the Forms tool
design, new fields will automatically get created for these missing fields. However, all "text-based fields"
(such as Text, Option Buttons, Check Box, List Box, and Drop-down List) will be re-created as Multi-line
Text fields.
Additionally, if a field you are importing has the same name as an existing field in the new Forms tool
design, but is a different data type, an error message will display and the Forms tool data will not get
imported.
About Custom Tools Created with the Groove InfoPath Forms Tool
The Groove InfoPath Tool provides much of the same capabilities as the Groove Forms Tool, for the
purpose of developing Groove workspace application tools. Unlike the Groove Forms tool, in which
application developers design and lay out all design objects, the Groove InfoPath tool enables application
developers to create and lay out most design objects (forms and the fields that display on forms) in
Microsoft InfoPath, and then import the solution into the Groove InfoPath Forms Tool designer. Once
imported, developers can update the form design in InfoPath and then re-import the form. Once in
Groove, application developers add other tool features such as customized views.
144
Creating Custom Tools
To use the Groove InfoPath tool to design a workspace tool application, you must have Microsoft InfoPath
2007 installed on your system. If you add an InfoPath tool to a workspace without having the required
version of InfoPath installed on your system, a warning message displays in the tool window.
Similarly, all users invited to a workspace that contains tools developed with the Groove InfoPath Tool
must have Microsoft InfoPath 2007 installed on their computers in order to use these tools. If users don't
have the required version of InfoPath installed, a warning message displays in the tool window. Once the
user installs Microsoft InfoPath 2007, custom tools developed with the Groove InfoPath Tool will display
when selected. Users who don't install InfoPath can continue to use other tools in Groove workspaces that
contain Groove InfoPath tools.
Note the following design requirements for the InfoPath Forms tool:
• As noted above, InfoPath form templates must be saved in Microsoft InfoPath 2007 or later. That
is, you can use InfoPath form templates designed in earlier versions of InfoPath as long as they
are first read into and saved in InfoPath 2007.
• InfoPath forms must be configured to "submit to hosting environment".
• The security level for the InfoPath form must be set to "Restricted".
• The InfoPath template should include one or more promoted fields. The Groove InfoPath tool
designer only recognizes promoted fields for use in the InfoPath tool design. Additionally, the
selected promoted fields must be field types that are supported in the Groove InfoPath Forms
tool. For example, the Groove InfoPath tool does not recognize Time fields, even if promoted.
• Secondary user interface features, such as a task pane, menu, menu area, or toolbar integration,
are not supported in the Groove InfoPath tool. If an InfoPath forms tool contains these features,
a warning message will display when the form is imported.
• Custom validation settings in InfoPath form fields are not honored in InfoPath form templates
imported into Groove. See the Microsoft InfoPath help for more information on adding or
removing validation settings.
You can see detailed information about designing an InfoPath Form Template in Microsoft InfoPath Help.
To prepare an InfoPath 2007 form template for importing into a Groove InfoPath tool, you must do the
following tasks:
145
Groove 2007 User's Guide
Microsoft InfoPath 2007 comes with a variety of form template samples. You can use any of these sample
templates as the basis for a Groove InfoPath Forms tool, adding your own customization, or use them
without making any design or layout changes.
You can also create a new form template in InfoPath using a blank form.
To use any sample or new form template in Groove, you must complete all the form template
customization tasks described in this topic.
You can see detailed information on laying out an InfoPath Forms template in the Microsoft InfoPath Help.
As you prepare your InfoPath Forms template, consider which form fields you will want to make available
in the Groove InfoPath tool to display on forms, to reference in views, and to make available for use in
view filters and searches. In making this determination, it is also important to be aware of which field
types can be used use in Groove.
Just as you make fields available in a Groove 2007 InfoPath Forms tool by promoting in the Microsoft
InfoPath 2007 form template, you remove fields from the Groove InfoPath tool design by demoting them
in the Microsoft InfoPath form template. To demote fields, use the same procedure as for promoting them,
except click Remove after selecting the field to demote.
You can see detailed information on hosting InfoPath in another application in the Microsoft InfoPath help.
146
Creating Custom Tools
Once you have completed the required field promotion and set form template submit and security options,
you can save the InfoPath form template in the designer. The file will be saved, by default, as an XSN file.
InfoPath field data types eligible for promotion and import into a Groove InfoPath tool
The following table lists the InfoPath field data types that can be promoted and imported for use in a
Groove InfoPath tool.
*Note the following details pertaining to the InfoPath Rich Text (XHTML) field data type:
• When mapped to the Text (String) field data type in Groove, all rich text formatting is stripped
out.
• This field type cannot be demoted.
147
Groove 2007 User's Guide
Other InfoPath field types (such as Duration, Time, gMonth, gDay), will display on the form in the Groove
InfoPath tool, and can be used, but will not be available in the Designer for referencing in views, Web
services, or macros.
When you first add a Groove InfoPath Forms Tool to a workspace, you see the "Welcome" page which
provides a brief overview of the tool.
Click Import Template... to open the InfoPath Forms designer where you import InfoPath Forms templates
and add other custom tool design objects, such as views and macros.
You create a new form in a Groove InfoPath Tool by importing InfoPath form template .xsn files you've
saved in Microsoft InfoPath 2007. In order to import these forms successfully, they must have several
options set in Microsoft InfoPath.
The form template displays in the designer window. All promoted form fields are listed under Fields
in the design object pane. Click any field to display field properties. To modify a field, you must
update it in Microsoft InfoPath and then re-import the form template file.
You can import additional forms into an InfoPath Forms tool by repeating the procedure described in this
topic. However, note that the InfoPath Forms tool automatically renames fields in form templates you
import if they conflict with fields names in existing form templates. For example, if an InfoPath Forms tool
contains a form with a field named "City", and you import another InfoPath forms template that contains a
field named "City", in Groove this field will automatically be renamed "City0".
All design updates to forms in an InfoPath Forms tool are made in Microsoft InfoPath 2007. Once the
updates are ready, you re-import the InfoPath form template file to refresh the form design in the
InfoPath Forms tool.
Workspace members who have Designer access can replace an InfoPath Forms tool design with the design
from another InfoPath Forms tool. Although InfoPath Forms tool designers can always update an InfoPath
148
Creating Custom Tools
Forms tool application's design directly in the tool, designers may sometimes opt to use a "Replace
Design" process for the following reasons:
• It separates parts of the InfoPath Forms tool design process from the "production" InfoPath
Forms tool and provides an environment for updating the tool design without entering the
designer in the production InfoPath Forms tool.
• Designers can introduce and test design updates more freely, without needing to be immediately
mindful of how the updates will affect users. The designer performs the Replace Design operation
only after a specific set of updates are complete and tested.
• In an InfoPath Forms tool application in which the design is locked, meaning that access to the
designer in not available, using the Replace Design process is the only option for updating the
tool design.
Keep in mind that the Replace Design process affects only the design objects that are available for
customizing in the InfoPath Forms tool designer. As such, for an InfoPath Forms tool, the Replace Design
process is effective mostly for managing and updating views and macros. Updates to fields and form
layout must still be imported from Microsoft InfoPath 2007.
The use of Replace Design is most appropriate only under the following circumstances:
• The designer is planning to introduce a significant number of design updates, particularly to views
and macros.
• The design in the production InfoPath Forms tool is locked, and therefore (as noted above), using
Replace Design is the only option.
Designers who have access to the designer in the production InfoPath Forms tool should avoid using
Replace Design to introduce smaller, incremental design updates. This is because the Replace Design
operation replaces every design object that was originally created in the tool (even those that are identical
to the ones replacing them). Depending on the size and complexity of the InfoPath Forms tool design, this
activity may push large numbers of updates to all workspace members. For example, if you update a
single view for an InfoPath Forms tool application that contains multiple views, and then run Replace
Design, the process will replace the design for all views in the tool design.
Requirements for using Replace Design with custom tools created via InfoPath Forms
The source InfoPath Forms tool referenced during the Replace Design process must meet certain
requirements in relation to the target InfoPath Forms tool, as follows:
• The Source InfoPath Forms tool must contain at least all forms found in the target InfoPath
Forms tool.
• The forms in the source and target tools must have originated from the same Microsoft InfoPath
form templates.
• The forms in the source InfoPath Forms tool must be at least the same version as their matching
forms in the target InfoPath Forms tool. For example, you can import an updated version of an
InfoPath form template into the source InfoPath Forms tool and then replace the design of the
target InfoPath Forms tool referencing the source tool. However, if you import an updated
version of an InfoPath form template directly into the target InfoPath Forms tool, you will not be
able to subsequently perform a Replace Design referencing the Source InfoPath Forms tool
because the source tool will contain an earlier version of the form template.
For optimal results, it is best to use the following steps for setting up a Replace Design process:
1. Do the initial form design work in Microsoft InfoPath 2007, and import the design template into a
Groove InfoPath tool.
149
Groove 2007 User's Guide
2. Do the initial InfoPath Forms design work, such as creating views and macros, in the Groove
InfoPath tool until it is ready for deployment.
3. Before inviting members, save the workspace as a template.
4. Create a new workspace using the workspace template.
You will now have two workspaces, each of which contains identical InfoPath Forms tools.
However, you should consider the copy of the InfoPath Forms tool in the new workspace as the
design "master". As such, you will use this tool for importing form template updates from Microsoft
InfoPath 2007, and you will use this tool to do all InfoPath Forms tool updates such as changes to
views and macros.
5. In the production InfoPath Forms tool, run the Replace Design process, referencing the
workspace that contains the master InfoPath Forms tool template.
Alternatively, instead of saving the original workspace as a template, you could save the original InfoPath
Forms tool as a template. You could then add this InfoPath Forms tool to another workspace or even to
the same workspace. Some InfoPath Forms designers might opt to create a workspace that simply
contains a set of InfoPath Forms tools used as design masters.
When you replace an InfoPath Forms tool design, you replace the set of design objects (that is, all views,
macros, and selections under Settings and Options) in the current InfoPath Forms tool with those of the
InfoPath Forms tool you select in the Replace Design dialog box. The resulting set of design objects will
have these characteristics:
• Any design objects that were not previously in the InfoPath Forms tool design are added as new
objects.
• Any design objects of the same name are simply replaced and use the properties of the
replacement object.
For example, if you replace a view named "City" with another view named "City", this view
changes only if the replacement view has different view settings and column properties.
• Any design objects from the original InfoPath Forms tool design that are NOT part of the InfoPath
Forms tool used to do the replace design are deleted from the original Forms tool.
For example, if the original InfoPath Forms tool contains the view "City" and you replace design
with an InfoPath Forms tool that does not contain this view, the "City" view will be deleted.
Workspace members who have designer access can replace an InfoPath Forms tool design with the design
from another InfoPath Forms tool. This method of updating an InfoPath Forms tool design allows InfoPath
Forms designers to keep design update work separate from the original InfoPath Forms tool for design
features created in the InfoPath Forms tool designer, such as views and macros. This process also may
make it easier for designers to experiment with design options before disseminating them to all workspace
members. Additionally, if an InfoPath Forms tool has a locked down design, replacing a design is the only
available method for updating the tool's design.
150
Creating Custom Tools
For details and recommendations regarding the replace design process, see About replacing an InfoPath
Forms tool design.
In custom tools developed in the Forms tool, you create new forms in the Designer. In custom tools
developed in the InfoPath Forms tool, this task is done in Microsoft InfoPath.
Note: If the custom tool uses forms created in and imported from Microsoft InfoPath 2007, you must
create and import all new forms using this method.
Tip: If you include a slash (/) character in the form name, the form will be listed alphabetically
below all other forms that do not include this character in the New drop-down menu in the data
view. This allows you to group certain form types together as shown in the following example:
You can:
151
Groove 2007 User's Guide
You can set up a form such that when a record gets updated, the previous version of the record is saved
as a response to the updated record. You might do this when you want to maintain a history of all updates
to records.
Note: If users edit file attachments in records in a custom tool that uses this feature, the newest version
of the file attachment is saved in both the updated record and its response version.
Note: This feature is not available in custom tools designed in the Groove InfoPath Forms tool.
Users select this type of form to create a response to the selected record. In the data view, response
records display indented below the selected record if view columns are set up to show twisties when the
row is expandable.
Note: This feature is not available in custom tools designed in the Groove InfoPath Forms tool.
It is best to include a field that is referenced in all views in the Forms tool, so that the view can
display a value for the response record.
The purpose for setting a default form is to ensure that all records are always associated with at least one
form. If a form is deleted in the Designer, the default form is used for any records that were created using
the deleted form. Note, however, that the default form may have a different design from the deleted form,
and therefore records may not be able to display the same content.
152
Creating Custom Tools
4. Select an option for returning to the data view, or continue making other design updates in the
design sandbox.
For custom tools developed in the Forms tool, you modify the design of a form as described in this topic.
For custom tools developed in the InfoPath Forms tool, you modify the design of a form in Microsoft
InfoPath 2007 and then re-import the form design.
You can make a form available to members depending on their role. You can also make a form available to
selected members regardless of their role.
• Check the member roles you want to allow to see the form.
• In the Member list, check the members you want to allow to see the form regardless of
their role.
5. Select an option for returning to the data view, or continue making other design updates in the
design sandbox.
Deleting a form
153
Groove 2007 User's Guide
Deleting a form in a custom tool removes it from the forms list in the Designer, as well as the list of forms
Workspace members see in the New drop-down menu in the data view. Note that any records in the
custom tool that were created using the deleted form will automatically use the tool's default form.
However, if the default form has a different design from the deleted form, the records may not be able to
display the same content. For example, the default form may reference a different set of form fields.
To delete a form:
You can assign a programmatic alias to any form or view to be referenced in scripts. For more information
on using a programmatic alias, see the Forms Programming Documentation.
Note: This feature is not available in custom tools designed in the Groove InfoPath Forms tool.
Creating fields
In custom tools developed in the Forms tool, you create fields as described in this topic. In custom tools
developed in the InfoPath Forms tool, this task is done in Microsoft InfoPath.
• Click Save/Create another if you want to save this field and add another new field.
• Click Finish to save only this field.
6. Select an option for returning to the data view, or continue making other design updates in the
design sandbox.
154
Creating Custom Tools
In custom tools developed in the Forms tool, you edit fields as described in this topic. In custom tools
developed in the InfoPath Forms tool, this task is done in Microsoft InfoPath.
You can also edit field properties as you lay out a form. Double-click the field you want to edit in the field
list.
System fields are available in the field list for adding to any new form. You can add the following types of
fields:
Editor fields allow users to create records in which editing privileges are extended to workspace members
whose permissions, as defined in their roles, would normally not allow them to edit those records. For
example, given default settings, a workspace member whose role is Participant can edit only records they
created. However, if selected in an Editor field, this member could edit the selected record even if it was
created by another member.
Note: Workspace members must have at least Edit Own Document permission enabled in order to be
granted editing access to a record via an Editor field. By default, Guests do not have this permission.
If a user makes no selection in the Editor field, then the current tool permissions apply.
Reader fields allow users to create records in which reading privileges are restricted to selected members.
If you select at least one member as a Reader, then other members who are not selected as Readers will
not see the record in the data view.
Note: If you select a member other than yourself as a Reader, and you do not also select yourself as a
Reader, you will not be able to access the record after you create it.
155
Groove 2007 User's Guide
In custom tools developed in the Forms tool, you can select two or more fields to be grouped together on
the form as a single unit. A field group occupies a single table cell in the form design, regardless of the
number of fields included in the field group. In custom tools developed in the InfoPath Forms tool, this
task is done in Microsoft InfoPath.
1. In the Designer, select the form in which you want to add a field group.
2. Make sure all fields you plan to select for the field group are included on the form.
Note: Labels may not be suitable for every field group you add to the form and are therefore
optional.
You can only check fields that are not already included in another field group or tab group.
7. Click OK.
If you want all fields in a field group to be hidden on the form, check "Group is Hidden" in the Edit Field
Group dialog box.
To move an entire field group in the form layout, select it in the preview area by clicking just outside the
field area, and then click the Move Left/Up and Move Right/Down buttons.
To move fields within a field group, click the field you want to move in the preview area, and then click the
Move Left/Up and Move Right/Down buttons:
Depending on your form layout, you may want to set a field group to span multiple columns or multiple
rows.
The form layout in the picture below is set with the following properties:
• Columns is set to 2.
• The first table cell contains a field group that includes the First Name, Last Name and Middle
fields.
156
Creating Custom Tools
• The field group is not assigned a label, but the blank label is set to Top.
A designer might improve the appearance of the form by setting the field group to span 2 columns, as
shown in the picture below:
In custom tools developed in the Forms tool, you can select a collection of fields to be grouped together
on a form as a tab group. Tab groups help you use form fields efficiently and present similar sets of fields
as a single, tabbed unit. In custom tools developed in the InfoPath Forms tool, this task is done in
Microsoft InfoPath.
The following example shows a tab group that allows users to enter work and home address information:
1. In the Designer, select the form in which you want to add a tab group.
2. Check the fields you plan to include in the tab group.
Fields must be included on the form before you can select them for a tab group. Note that you can
also select previously defined field groups in the tab group. Field group names appear in the list of
fields.
157
Groove 2007 User's Guide
Labels may not be suitable for every tab group you add to the form and are therefore optional.
Note that tabs will not display if a tab group contains only one tab.
5. Click the New Tab icon to begin adding the first tab:
6. Type the Tab Label text you want in the text box.
7. Check the fields or field groups to be included in the tab group.
You can only check fields that are not already included in another field group or tab group.
To move a tab group in the form layout, select it and click the Move Left/Up and Move Right/Down buttons
in the Field box as you would for any other form field.
You can rearrange fields within the boundaries of a tab in a tab group. Select the field you want to move
and click the Move Left/Up and Move Right/Down buttons in the Field box as you would for any other form
field.
Depending on your form layout, you may want to set a tab group to span multiple columns or multiple
rows.
You can add columns to any tabs in a tab group in order to lay out fields in multiple columns.
1. Select the tab in which you want to change the number of columns.
2. Click the Column drop-down menu in the Tab box, and select the number of columns you want
for the selected tab.
158
Creating Custom Tools
In custom tools developed in the Forms tool, a form layout is essentially an HTML table in which fields are
placed in table cells. In custom tools developed in the InfoPath Forms tool, this task is done in Microsoft
InfoPath.
To help you visualize the form layout, click the Show Border (preview only) option in the Designer. This
places table rules around all table cells just for layout purposes.
In a new form, the layout initially consists of a one-column table, with fields placed in cells in table rows in
the order in which they are selected in the field list. For example:
You can lay out fields horizontally on the form by increasing the number of table columns. In the example
below, the number of columns in the form is set to 3.
With a multi-column layout, you may want a field to span multiple columns. In the example below, the
number of columns for the Address field is set to 3 so that this field occupies a single row in three-column
form layout.
159
Groove 2007 User's Guide
Form fields display on a form in the order in which they are selected in the field list. You can move form
fields left, right, up, or down depending on their position relative to all other fields. In a form with multiple
table columns, fields are still arranged linearly, from the top-left field to the bottom-right field.
When you select a field you have placed on a form, "move" buttons are enabled depending on the position
of the selected field relative to other fields. If there are other fields either to the right or below the
selected field, the Move Right/Down button is available; if there are fields either to the left or above the
selected field, the Move Left/Up button is available.
If your selection on the form is a field group or tab group, the selection moves as though it were a single
field.
You can click the HTML Source tab in the Forms design to view the HTML source code in the current form
layout. This is especially useful for the purpose of determining object names for use in scripts and macros.
In custom tools developed in the Forms tool, you arrange form fields in the Designer as described in this
topic. In custom tools developed in the InfoPath Forms tool, this task is done in Microsoft InfoPath.
Tip: Click Show border (preview only) to display table rules around all table cells on the form. This will
help you visualize how the form is laid out.
To change the number of columns on a form, click the Columns drop-down menu in the Style box and
select a number.
160
Creating Custom Tools
Changing the row span for a selected field, field group, or tab group
To move fields within a field group or tab group, select the field within the field or group or tab group and
then click the Move Left/Up or Move Right/Down buttons in the Field box.
Duplicating fields
In custom tools developed in the Forms tool, you can create similar types of fields quickly by duplicating
existing fields. For example, if you want to create several Text Box fields that are identical except for their
field names and field labels, you can create duplicates of the original field, and then edit their field labels.
In custom tools developed in the InfoPath Forms tool, this task is done in Microsoft InfoPath.
If you accept the default name, which is the same as the original field name, an incremental
number will automatically be appended to the name. For example, if you duplicate a field named
"Street" and accept the default, the new field will be named "Street0". If you duplicate the Street
field again and accept the default, the new field will be named "Street1".
The new, duplicated field appears in the field list. You can click the duplicated field to see and edit its field
properties.
161
Groove 2007 User's Guide
In custom tools developed in a Forms or InfoPath Forms tool, deleting a field removes it from all forms
and views in the tool.
Note: In custom tools developed in the InfoPath Forms tool, you can also delete the fields in Microsoft
InfoPath and then re-import the form template into the Groove InfoPath Forms tool.
In custom tools developed in the Forms tool, designers can assign a CSS class name to any selected field
placed on a form. This is useful for modifying the style parameters for field labels. You must know the
name of the class from the CSS file that you want to assign. In custom tools developed in the InfoPath
Forms tool, this task is done in Microsoft InfoPath.
In custom tools developed in the Forms tool, you can hide any field you have placed on a form so that
users do not see the field when they create a new record. In custom tools developed in the InfoPath
Forms tool, this task is done in Microsoft InfoPath.
You can display any value stored in a hidden field in the data view, if you reference it in a data view
column.
Hidden fields are useful when referenced by a form script. For example, you might include a script that
shows a hidden field on the form only when specific conditions are met.
Similarly, a hidden field might contain a script that combines the values of other fields. For example, you
might use a hidden field to concatenate the values of an "Area Code" field and a "Telephone Number"
field, and then reference the hidden field in the data view to show the concatenated value.
Tip: You can access and update properties for a hidden field by double-clicking it in the field list. You can
enable the More Properties drop-down menu for a hidden field by selecting the hidden field in the field list.
In custom tools developed in the Forms tool, you can set fields to inherit their initial values from other
fields, or from the same field. Typically, fields in response records are set to inherit fields from their
162
Creating Custom Tools
parent records. However, fields can also be set to inherit values from other fields in the currently selected
record. In custom tools developed in the InfoPath Forms tool, this task is done in Microsoft InfoPath.
Select "Self" if you want to inherit the value from the same field. Inheriting values from the same
field is useful mainly for fields in Response forms. For example, suppose you have a Date field on
parent form, and you would like to automatically show the date value entered in this field on a
response form. In this case, you could add the same Date field to the response form, and set it to
inherit from "Self".
Tip: If you want a field set to inherit values from "Self" to be updated automatically when the field
value changes in the parent record, you must set the field on the parent form to push updates to
responses.
4. Click OK.
In custom tools developed in the Forms tool, you can set fields to automatically push updated values to
the same fields added to response records. This feature works most effectively in conjunction with the
option for inheriting field values. Fields set to inherit values from "Self" are updated automatically to
reflect changes in the parent record field only if the corresponding field on the parent form is set to push
updates to responses. In custom tools developed in the InfoPath Forms tool, this task is done in Microsoft
InfoPath.
2. Select Push Updates to Responses... from the More Properties drop-down menu:
This enables the feature for this field. To disable this feature for the selected field, re-select the
option.
In customs tools developed in the Forms tool, you can set any field you have placed on a form as read-
only. You might use this feature for fields that inherit their values from other fields, and therefore should
not be edited. You also might use this feature with a rich-text field to include formatted display text on the
form. In custom tools developed in the InfoPath Forms tool, this task is done in Microsoft InfoPath.
In custom tools developed in the Forms tool, you can set any field you have placed on a form as a
required field. If you set a field as "Required," users are prompted to supply a value for the field, if
163
Groove 2007 User's Guide
missing, when they save the record. In custom tools developed in the InfoPath Forms tool, this task is
done in Microsoft InfoPath.
In custom tools developed in the Forms tool, you can place a variety of fields on a form. Each type of
field has a corresponding set of editable properties that allow you to provide guidance or set rules for
people who use the forms. For example, you can place an initial value in a text field, set a numeric field
to automatically apply currency formatting, set limits for the number of characters in a field, or make
certain fields "required." In custom tools developed in the InfoPath forms tool, all field related work is
done in Microsoft InfoPath.
Attachments field
An Attachments field allows you to attach files to a record. Note that a form can include only one
Attachments field. Set properties for this field as follows:
• Label. Enter a label and a position setting relative to the field. If you want to apply special text
formatting to the field label, overriding the default style settings, click Rich Text, select the label
text, right-click to open a context menu, and select formatting options.
• Name. Enter a name for this field. You can also leave this property blank and the field name will
automatically be derived from the value entered in the Label property. Field names cannot be
changed once the field is created.
Use only letters and numbers in the field name; other characters may be converted to XML format.
If you enter a name of another existing field, the name will be modified to be unique.
Check boxes allow users to check or uncheck an option, and display a corresponding value for the checked
state, in the data view. Set properties for this field as follows:
• Label. Enter a label and a position setting relative to the field. If you want to apply special text
formatting to the field label, overriding the default style settings, click Rich Text, select the label
text, right-click to open a context menu, and select formatting options.
• Stored Value. (Optional) Enter text to be stored with this field. If left blank, the stored value is
"True". The default display value, the value displayed in a view column when the box is checked,
is the field label. You can change the display value for the field in column properties.
In the check box field below, the field label is "Check to receive our newsletter" and the Stored
Value is set to "Yes". In order to display "Yes" rather than the field label in the view, the display
value is set in the View column properties to "Yes".
The corresponding data view for this example looks like this:
164
Creating Custom Tools
Use only letters and numbers in the field name; other characters may be converted to XML format.
If you enter a name of another existing field, the name will be modified to be unique.
Contact field
A Contact field allows the user to add a Groove contact to a record. Depending on the properties set for
the field, the Groove contact shows its awareness icon and verification color, and provides the standard
right-click context menu. A Contact field is mainly useful when used in combination with a Forms script
that defines an action to be executed with the selected contact. For example, a Forms script might result
in an instant message being sent to the selected contact whenever the record is updated, or when specific
fields in the record are updated.
Users can add only one contact to a contact field. However, a form can contain multiple contact fields.
• Label. Enter a label and a position setting relative to the field. If you want to apply special text
formatting to the field label, overriding the default style settings, click Rich Text, select the label
text, right-click to open a context menu, and select formatting options.
• Hide Awareness Icon. Check if you don't want to show the contact's awareness icon.
• Hide Context Menu. Check if you want to disable the standard right-click context menu.
• Verification Color. Check if you want the contact name text to display with identity verification
colors.
• Name. Enter a name for this field. You can also leave this property blank and the field name will
automatically be derived from the value entered in the Label property. Field names cannot be
changed once the field is created.
Currency field
A Currency field allow users to enter a validated number value that displays in a specified currency format.
Set properties for this field as follows:
• Label. Enter a label and a position setting relative to the field. If you want to apply special text
formatting to the field label, overriding the default style settings, click Rich Text, select the label
text, right-click to open a context menu, and select formatting options.
• Width. Enter a number, which defines the width in characters, or pixels, or percent.
• Maximum Length. Enter the maximum number of characters, including currency symbols and
numeric punctuation, that users can enter in the field. If left blank, the maximum is limited only
by system standards.
• Initial Value. Enter a value to be displayed in the field by default. Users can change this value or
accept it.
165
Groove 2007 User's Guide
• Symbol. Enter or paste in the currency symbol to be displayed with the currency value on the
form. The default currency symbol is taken from the users regional settings.
Tip: You may be able to find the currency symbol you want from the Windows Character Map. To
open the Character Map, click Start-Accessories-System Tools-Character Map.
• Precision. Enter the number of digits to display after the decimal symbol on the form. If you do
not enter a value, the number of digits is 2. Punctuation, such as grouping commas, are
automatically added to the currency value once it is entered.
Value as entered.
Value as displayed.
Note: The number of digits displayed after the decimal symbol for this field in the data view is
determined by its column properties, and not the value you specify here for the form display. The
default precision value for a Currency field in the data view is 0.
• Name. Enter a name for this field. You can also leave this property blank and the field name will
automatically be derived from the value entered in the Label property. Field names cannot be
changed once the field is created.
Use only letters and numbers in the field name; other characters may be converted to XML format.
If you enter a name of another existing field, the name will be modified to be unique.
• Validation. Enter limits for a minimum and/or maximum number or leave either field blank to set
no limit.
If users try to enter a currency value outside the allowed range, a validation error icon displays in
the field. Users can point to the icon to display an explanation of the error. For example:
Users must correct the error before saving the Form record.
166
Creating Custom Tools
Date and Date Time fields allow users to enter or select a date that displays in the specified date format
(for Date fields) or date/time format (for Date Time fields). In addition to display format differences, Date
and Date Time fields provide different options for setting initial values. Set properties for these fields as
follows:
• Label. Enter a label and a position setting relative to the field. If you want to apply special text
formatting to the field label, overriding the default style settings, click Rich Text, select the label
text, right-click to open a context menu, and select formatting options.
• Width. Enter a number, which defines the width in characters, or pixels, or percent.
• Initial Value. Select one of the following options:
• Static. Enter or select a specific date as the initial value.
• Today. (Date field only). The current date, according to your computer's system clock, is
automatically entered in new records.
• Tomorrow. (Date field only). Tomorrow's date, according to your computer's system
clock, is automatically entered in new records.
• Now. (Date Time field only). The current date and time, according to your computer's
system clock, is automatically entered in new records.
• Function. Enter a date function that references a form script to derive the initial value
for the date. For more information on form scripts, see the Groove Development Kit
documentation.
• Formatting. Select a date format.
• Name. Enter a name for this field. You can also leave this property blank and the field name will
automatically be derived from the value entered in the Label property. Field names cannot be
changed once the field is created.
Use only letters and numbers in the field name; other characters may be converted to XML format.
If you enter a name of another existing field, the name will be modified to be unique.
• Validation. Enter an earliest and/or latest allowed date value or leave either field blank to set no
limit.
If users try to enter a date value outside the allowed range, a validation error icon displays in the
field. Users can point to the icon to display an explanation of the error. For example:
Users must correct the error before saving the Form record.
167
Groove 2007 User's Guide
Form Heading lets you display a heading at the top of the form. A Form Heading field always displays at
the top of the form, regardless of its placement within the field list in the Forms Designer. Set properties
as follows:
A horizontal line is useful for separating sections of the form. Set properties as follows:
Image field
Use an Image field to insert an image on the form. Keep in mind that images are placed on the form in
their original pixel size. If you want to insert large images, such as a digital photograph, you may want to
first scale the picture in a graphics editing program.
• Source. Click the Browse icon to open the Add Image To Form dialog box, select the image file
you want and click Open.
• Border. If you want to place a border around the image, enter a width value, in pixels. If left
blank, the image will not have a border.
• Pop-up Text Window. Enter text to appear in a pop-up window when a user points at the image
with the mouse.
• Center. Check to center the image on the form, or leave unchecked to align left.
• Name. Enter a name for this field. You can also leave this property blank and the field name will
automatically be derived from the value entered in the Label property. Field names cannot be
changed once the field is created.
A List Box field allows users to select one or more items from a list of alternatives. A Drop-down List field
allows users to select one item from a list of alternatives, or define and select new items. Set properties
for these fields as follows:
168
Creating Custom Tools
• Label. Enter a label and a position setting relative to the field. If you want to apply special text
formatting to the field label, overriding the default style settings, click Rich Text, select the label
text, right-click to open a context menu, and select formatting options.
• Options. Enter values for each list item as follows:
• Display Value. (Required) Enter text to display in the list on the form.
• Stored Value. (Optional) Enter text to display in views when the list item is selected. If
left blank, the view uses the Display Value.
• Optionally, select one item as the default selected list item.
• Click the check mark button to enter each list item.
Tip: You can override the value displayed in a view for a Drop-down or List Box field by setting
column properties.
• Include Blank. Check to set the first value in a drop-down list or list box as a blank choice.
• User Defined Values. (Drop-down List field only) Check to allow users to add custom values to
the list. The drop-down list includes plus (+) button for adding custom values.
Users who click the plus button are prompted to add a custom entry value.
Unless referenced in a lookup, custom values do not get appended to the field's list of values for
use in future new records. Users must add the same custom value manually in each new record.
Custom tool designers commonly use the lookup property to reference the custom value and thus
allow users to retain these values for subsequent new records.
• Number Visible. (List Box field only) Enter the height of the list box, in lines. The number of
visible items equals the height number you assign. In the example below, Height is set to 3:
• Select Multiple Values. (List Box field only) Check to allow users to select multiple items in the
list.
• Include Member Names. Check to include workspace member names, as listed in the Workspace
Members panel, in the list.
• Lookup. Select options for looking up values in other fields.
• Name. Enter a name for this field. You can also leave this property blank and the field name will
automatically be derived from the value entered in the Label property. Field names cannot be
changed once the field is created.
To select a default option, you must enter the option in the list. Then select the option and click Select by
default. An asterisk displays next to the option to denote that it is the default option.
To select a different option as the default, select it and click Select by default.
Modifying an option
169
Groove 2007 User's Guide
To modify an option, select it in the options list, and click Modify. The currently selected values display in
the Display Value and Stored Value fields. Make the changes you want and click the check mark to
complete the update.
Deleting an option
To delete an option, select it in the options list, and click Delete. The option is deleted from the list.
A Multi-line Text field allows users to enter multiple lines of text. Set properties for this field as follows:
• Label. Enter a label and a position setting relative to the field. If you want to apply special text
formatting to the field label, overriding the default style settings, click Rich Text, select the label
text, right-click to open a context menu, and select formatting options.
• Width. Enter a number, which defines the width in characters, or pixels, or percent.
• Height. Enter a number, which defines the height in the number of lines of text, or in pixels, to be
displayed before the scroll bar is activated. If left blank, the default is 2 lines.
• Initial Value. Enter editable text to be displayed in the field by default.
• Lookup. Select options for looking up values in other fields.
• Name. Enter a name for this field. You can also leave this property blank and the field name will
automatically be derived from the value entered in the Label property. Field names cannot be
changed once the field is created.
• Validation. Select an option from the drop-down list.
You can also set a Multi-Line field as a "Required" field after you place it on a form.
The New Line element inserts a line break in the form. This is useful for creating white space between
form elements.
Number field
A Number field allows users to enter a validated number value that displays in a specified number format.
Set properties for this field as follows:
• Label. Enter a label and a position setting relative to the field. If you want to apply special text
formatting to the field label, overriding the default style settings, click Rich Text, select the label
text, right-click to open a context menu, and select formatting options.
• Width. Enter a number, which defines the width in characters, or pixels, or percent.
• Maximum Length. Enter the maximum number of characters, including numeric punctuation, that
users can enter in the field. If left blank, the maximum is limited only by system standards.
• Initial Value. Enter editable text to be displayed in the field by default.
• Precision. Enter the number of digits to display after the decimal symbol on the form. If you do
not enter a value, the number of digits is 2. Other punctuation, such as grouping commas, are
automatically added to the number once it's entered.
170
Creating Custom Tools
Number as entered.
Number as displayed.
Note: The number of digits displayed after the decimal symbol for this field in the data view is
determined by its column properties, and not the value you specify here for the form display. The
default precision value for a Number field in the data view is 2.
• Name. Enter a name for this field. You can also leave this property blank and the field name will
automatically be derived from the value entered in the Label property. Field names cannot be
changed once the field is created.
Use only letters and numbers in the field name; other characters may be converted to XML format.
If you enter a name of another existing field, the name will be modified to be unique.
• Validation. Enter limits for a minimum and/or maximum number or leave either field blank to set
no limit.
If users try to enter a number value outside the allowed range, a validation error icon displays in
the field. Users can point to the icon to display an explanation of the error. For example:
Users must correct the error before saving the Form record.
An Option Buttons field allows users to select one item from a short list of alternatives. Set properties for
this field as follows:
• Label. Enter a label and a position setting relative to the field. If you want to apply special text
formatting to the field label, overriding the default style settings, click Rich Text, select the label
text, right-click to open a context menu, and select formatting options.
171
Groove 2007 User's Guide
In the example below, the display values "On Salary" and "Hourly" on the form become the
stored values "Exempt" and "Non-exempt" in the data view.
Displayed values
Stored values
Tip: You can override the value displayed in a view for an Option Button field by setting
column properties.
• Name. Enter a name for this field. You can also leave this property blank and the field name will
automatically be derived from the value entered in the Label property. Field names cannot be
changed once the field is created.
Use only letters and numbers in the field name; other characters may be converted to XML format.
If you enter a name of another existing field, the name will be modified to be unique.
To select a default option, you must first enter the option in the list. Then select the option in the list and
click Select by default. An asterisk displays next to the option to denote that it's the default option.
To select a different option as the default, select it and click Select by default. To deselect a default option
without selecting another default option, select it and click Deselect default.
Modifying an option
To modify an option, select it in the options list, and click Modify. The currently selected values display in
the Display Value and Stored Value fields. Make the changes you want and click the check mark to
complete the update.
Deleting an option
To delete an option, select it in the options list, and click Delete. The option is deleted from the list.
Password field
172
Creating Custom Tools
A password field allows the user to enter and save hidden text. All characters the user types in the
password field display as asterisks. However, note that the value entered in a password field is stored as
plain text. The properties for the Password field are the same as for a standard Text field, except for the
following field properties:
Note: If you select a Password field as a view column, the underlying text displays in the data view.
A Rich Text field allows users to enter text with formatting, such as different type sizes, styles (e.g., bold,
italic, underline), fonts, and colors. Alternatively, check the "Read-only" property to use a Rich Text field
to show formatted display text. Set properties for this field as follows:
• Label. Enter a label and a position setting relative to the field. If you want to apply special text
formatting to the field label, overriding the default style settings, click Rich Text, select the label
text, right-click to open a context menu, and select formatting options.
• Width. Enter a number, which defines the width in characters, or pixels, or percent. If left blank,
the width is approximately 20 characters or approximately 200 pixels.
• Height. Enter a number, which defines the height in number of lines or pixels. If left blank, the
height is either 2 lines or approximately 36 pixels.
• Hide Border. Check to hide the field border.
• Searchable. Check to include contents of the field in searches. Additionally, this property must be
enabled in order to select a rich-text field in a view filter.
• Hide Command Bar. Check to hide the command bar that displays at the top of the field.
• Background Color. Do one of the following:
• Click Color and then click Choose color... to select a background color for the field.
• Click Transparent to use the background color of the form.
• Initial Value. Enter text to be displayed in the field by default. Right-click in the text box to see a
menu of rich-text formatting options. You can also paste in any formatted text from another
program.
• Name. Enter a name for this field. You can also leave this property blank and the field name will
automatically be derived from the value entered in the Label property. Field names cannot be
changed once the field is created.
Use only letters and numbers in the field name; other characters may be converted to XML format.
If you enter a name of another existing field, the name will be modified to be unique.
A Script button field allows you to add a button to the form and define its action using Javascript. Set
properties as follows:
173
Groove 2007 User's Guide
Use only letters and numbers in the field name; other characters may be converted to XML format.
If you enter a name of another existing field, the name will be modified to be unique.
Section headings are useful for separating the sections of the form. Set properties as follows:
Use only letters and numbers in the field name; other characters may be converted to XML format.
If you enter a name of another existing field, the name will be modified to be unique.
Use static text to provide information and instructions to users about using the form. For example, you
might use a static text field to advise users on how to enter data or make selections for a specific field.
Use only letters and numbers in the field name; other characters may be converted to XML format.
If you enter a name of another existing field, the name will be modified to be unique.
Text field
A Text field allows users to enter plain, one-line text entries, such as names or addresses. Set properties
for this field as follows:
• Label. Enter a label and a position setting relative to the field. If you want to apply special text
formatting to the field label, overriding the default style settings, click Rich Text, select the label
text, right-click to open a context menu, and select formatting options.
• Width. Enter a number, which defines the width in characters, pixels, or percent.
• Maximum Length. Enter the maximum number of characters, including spaces, that users can
enter in the field. If left blank, the maximum is limited only by system standards.
• Initial Value. Select one of the following options:
• Static. Enter editable text to be displayed in the field by default.
• Unique. Automatically displays a unique text string as the initial value, using the
following syntax: The first four characters are created from the author name using the first
initial of the first name, plus the first two characters and last character of the last name; the
last nine characters are randomly generated based on the current date and time. For
example, a "unique" text field in a record created by an author named Andrew Rath might
have the following initial value:
174
Creating Custom Tools
ARAH-C27C510F4
• User Name. Automatically displays the name of the record creator as the initial value.
• Workspace Name. Automatically displays the name of the workspace as the initial value.
• Tool Name. Automatically displays the name of the Forms tool as the initial value.
• Function. Enter a function that references a form script to derive the initial value. For
more information on form scripts, see the Groove Developer Kit documentation.
• Lookup. Select options for looking up values in other fields.
• Name. Enter a name for this field. You can also leave this property blank and the field name will
automatically be derived from the value entered in the Label property. Field names cannot be
changed once the field is created.
• Validation. Select an option from the drop-down list.
For Text, Multi-line Text, Drop-down list, List Box, and Static Text fields, you can use lookup procedures to
derive values from other fields. The lookup procedure can find field values in the same Forms tool, in a
selected Forms tool in the same workspace, or in a selected Forms tool in another workspace. You can
also add lookups to macros and form scripts.
In the case of a script or macro, you are now ready to paste the lookup string variable into your
code.
Select All to create a lookup that returns all values in a selected view column, or select By Key to
create a lookup that returns field values based on the value of another field.
• Space. If the lookup values are stored in a Forms tool in another workspace, check "Allow looking
up values in another workspace." Then select the Workspace name from the drop-down menu.
Note that only tools that are enabled as lookup targets are listed in the menu.
If you are referencing values in another workspace, all users of this Forms tool must also be
members of the referenced workspace. Note also that this feature is not available for macros.
175
Groove 2007 User's Guide
• Tool. Select the name of the Forms tool that contains the values you are looking up, or select
"This Tool" if appropriate.
• View. Select the name of the view that contains the values you are looking up. Note that only
views that are enabled as lookup targets are listed in the drop-down menu.
• Key Column. (For By Key lookups only). Select the column in the selected view which is read first
before finding a value in the lookup column.
Note: The Key Column must have a sort assigned to it in Column Properties in order to be
displayed in the drop-down list.
• Key Value. (For By Key lookups only). Select the field value that is read first before finding a
value in the lookup column. You can also select a field from which to obtain the value.
• Lookup Column. Select the column that contains the lookup values.
• Return. Select All to return all matching values in the lookup column, including duplicates, or
select Unique to return all values except for duplicates.
• No Cache. Check this option only if you want Groove to refresh the lookup results every time the
form is loaded. This is suitable usually only in cases in which lookup values are constantly
changing. If lookup values are generally static, it is best to keep this option unchecked.
• Return URLs as well as values. (Macro or form script lookups only.) Check this option if you want
the lookup to return URLs so that you can use them to create a link in a rich text field.
• Comment. If you want, enter a comment in the text box. The comment is displayed if the lookup
needs to be resolved at some future time.
Views show the data collected in records by referencing fields. Before you can display a view, you must
first create a form that contains these fields.
The preview window shows the selected fields as view columns in the currently selected order. You
can size view columns by dragging the column splitters in the preview window.
4. Rearrange the column order of the selected fields by moving them up or down in the list.
Columns are ordered left to right, starting with the first selected field from the top.
Note: The initial column header is the same as the field label. However, changing a field label has
no effect on the column header. The only way to change a column header is by editing its title in
the Column Properties dialog box.
176
Creating Custom Tools
• Check Show unread marks if you want to ensure that workspace members always see
unread marks next to new or updated records regardless of their alert settings for the Forms
tool.
• Check Do not show this view in the View menu to disallow selecting this view.
7. Click the Access tab to set options for restricting access to the view.
8. Click the View Filter tab if you want to enter criteria for displaying records in the view.
9. Save your changes.
You can create two types of views that display response records in a hierarchy. You can:
You can create a view in which the original versions of updated records display as hierarchical responses.
You might do this when you want to closely track record updates.
You can create a view that includes a form used for creating a response to a selected record. In the data
view, the response form displays hierarchically below its parent record. You can collapse response records
under their parent records by clicking a minus (-) icon called a "twisty." You can expand hierarchical
records again by clicking a plus (+) twisty icon.
To create this type of view, you must have at least two separate forms: a parent topic form, and a
response form.
177
Groove 2007 User's Guide
• On the Basics tab, check at least one field that's also checked in the main topic form. In
the example above, the main topic and response forms both include the "Summary" field.
• On the Options tab, check Use this form to create responses to the selected record.
3. Create a view in which you select the field shared on both forms.
4. Modify the column properties for the column that references the shared field as follows: On the
Basics tab, check Show a 'twisty' in this column when row is expandable.
5. Save your design changes.
You can set a view to be the first view that displays when new workspace members go to this Forms or
InfoPath Forms tool for the first time. If you do not set a default view, new members see the first view,
alphabetically, in the "View by" menu.
Every view has a default sort order, that is, the initial sort order that displays when you (or other
workspace members) first enter the view. You can select any sort currently applied to a view column as
the default sort order.
Hiding a view
You can prevent a view from being listed in the View menu for all workspace members. This is useful for
views that exist mainly for auxiliary purposes such as generating a list of records to be used in lookups, or
for an Electronic Data Bridge (EDB) process. These views typically provide no other practical purpose for
workspace members.
178
Creating Custom Tools
You can make a view available to members depending on their role. You can also make a view available to
selected members regardless of their role.
• Check the member roles you want to allow to see the view.
• Check members you want to allow to see the view in the Member list, regardless of their
role.
You can select an option to show a view column that lists unread markers for new or updated information.
You can set a minimum or maximum size for rows in the data view of a custom tool. Setting a minimum
or maximum row height is useful mostly for display purposes.
179
Groove 2007 User's Guide
You can use view filters to exclude records from a view based on specified conditions. For example, you
can display records created only with specific forms, or display records only if field values match specific
criteria.
The view will only show records created with the selected forms.
Filter expressions tests field values, and displays records in the data view when the condition(s) stated in
the expression are met. You can add basic expressions and advanced expressions.
1. Select the field for which you want to test values from the drop-down list.
Note: Date/Time fields are not supported in view filter expressions, and therefore do not appear in
the drop-down list of fields. Rich-text fields are available only if their Searchable property is
enabled.
The operators you see differ depending on the field type. Text-related fields provide operators that
work with text strings, such as "contains", and "starts-with"; number-related fields provide
comparison operators such as >, >=, <, and <=.
3. Enter the value you want to test for in the text box.
4. Click
5. Click Apply Filter.
In the example below, the filter expression displays all records in which the value in the "City" field is
"Warsaw".
180
Creating Custom Tools
You may sometimes need to test for more than one condition. To do so, you can add an expression that
contains logical operators. You can create an expression that selects records only if ALL conditions are met
(logical AND operator), or if ANY conditions are met (logical OR operator).
1. Select All of the following conditions (logical AND) or Any of the following conditions (logical OR),
depending on how you want the view to select records.
2. Add each condition, one at a time.
3. Click Apply Filter.
In the example below, two conditions are added with the "Logical OR" option selected. The resulting filter
expression will display all records in which the value in the "City" field is either "Warsaw" or "Krakow".
The parts of the expression display in the drop-down lists and value text box.
Removing a condition
To remove a condition:
Click to see options that enable you to further modify a filter expression. You can create expressions
that combine AND and OR logical operators, and group sets of conditions together.
• To change a logical operator, select the condition and click AND or OR.
• To combine conditions so that they are interpreted as a whole in the expression, SHIFT-select
them and click . In the example below, the AccountNumber field and the City field conditions
are combined such that the expression tests the values in each combined condition separately.
181
Groove 2007 User's Guide
In this case, the expression will select all records in which the value in the AccountNumber field is
>=300 and <=400 AND the value in the City field is not Warsaw and not Krakow.
You can use the {UserName} variable to create a view filter expression that results in the view showing
only records created by the current user. This variable must always be used together with either the
_CreatedByUrl field or the _ModifiedByUrl field.
For security purposes, views in custom tools are initially disabled as targets for lookups from other tools or
workspaces. Note that in addition to enabling a selected view to be a lookup target, the Designer must
also enable the tool be a lookup target.
You can assign a programmatic alias to any form or view to be referenced in scripts. For more information
on using a programmatic alias, see the Forms Programming Documentation.
182
Creating Custom Tools
Note: This feature is not available in custom tools designed in the Groove InfoPath Forms tool.
Tip: You can open properties for any column by clicking its column header in the view preview.
The initial column header is the same as the label property for the referenced field. If the field label is
long, you may want enter a shorter label for the column header.
On the Basics tab of the Column Properties dialog box, enter the new name you want in the Column
Header field.
Note: Changing a field label has no effect on the column header. The only way to change a column header
is by editing it in the Column Properties dialog box.
On the Basics tab of the Column Properties dialog box, you can select AutoFit, or set a custom size for the
column, either as a percentage of the total view width, in pixels, or in points.
If all columns are set to Autofit, the width of any column is equal to the full width of the view divided by
the number of columns. If one or more columns are set to a specific width, then the width of a column set
to Autofit is equal to the remaining measure of the view (after custom-width columns are totaled), divided
by the number of remaining columns.
If you select Custom Size, you must enter either a pixel-width value, a point value, or a percentage value.
For any field type that uses numeric values, such as Number, Unformatted Number, or Currency, you can
enable a column property to total the values in the column and display the total value in the data view.
183
Groove 2007 User's Guide
On the Basics tab of the Column Properties dialog, check Total the values in this column.
If you want to show totals for numeric values in a response hierarchy, check Include all levels of
hierarchy.
The example below shows a column that totals values in a column, including items in response records.
For number and date fields, you can change how values display in the data view by selecting options on
the Basics tab of the Column Properties dialog box.
• For fields with numeric values, select the number of decimal places to display from the Decimal
Places drop-down menu.
• For fields with date values, select the date format to display from the Date Format drop-down
menu.
On the Basics tab of the Column Properties dialog box, check Show a 'twisty' in this column when row is
expandable if this view contains a response form, and you would like to display records in a response
hierarchy. This option must also be checked to show grouped views in a hierarchical structure.
On the Options tab of the Column Properties dialog box, you can select style options for the text that
displays in a view column or for all view columns at once. Select font, size, and color options from the
drop-down menus, check emphasis options, and select justification settings.
Click Apply to All if you want the selected settings applied to all currently selected columns.
Users click view column headers to switch between the sort order set for the column. The default sort
order is the order in which records were created. A view column may also be set to sort in ascending or
descending order.
Ordinal sort
Ascending sort
Descending sort
184
Creating Custom Tools
On the Sorts tab of the Column Properties dialog box, you can choose from among three sort types for a
view column: hierarchical, flat, or grouped. However, only one column can use the "grouped" option. The
following sections describe the sort options.
Note: Hierarchical sorts are not supported in the Groove InfoPath Forms tool.
Hierarchical sorting
This sort type is useful in views that include hierarchical response records as it preserves the parent/child
relationships between main topics and their associated responses. If you set an ascending or descending
sort option for a view with a hierarchical sort, all records sort according to the selected sort option at each
hierarchical level.
Flat sorting
This sort type sorts records in a single list regardless of parent/child relationships. This is useful for cases
in which you simply want to show a list of all records in ascending or descending order. The picture below
shows a view with a flat sort in ascending order.
Grouped sorting
This sort type groups records by the values in a selected field. The grouped values display as expandable,
sorted category names in the view. Additionally, you can sort records within each group by the values of
another field.
In the view example below, the "Country" field is grouped, and ascending order is selected for the group
sort. Records in each group are sorted in ascending order by the values in the "City" field.
185
Groove 2007 User's Guide
All fields other than a Date field must be grouped by unique values. For Date fields, you can select a
different time value from the Group by drop-down list, such as "Months" or "Years."
For field types that require users to make a selection, you can set a column property to substitute a
different value in place of the value stored with the record. These field types include Option Button, Check
Box, Drop-down List, and List Box.
1. Select the Values Options tab of the Column Properties dialog box.
Note: This tab appears only for field types that support this feature.
2. Select the stored value for which you want to set a display value and click Modify.
3. Enter the display value you want in the Display Value text box.
4. Click the checkmark to accept the change.
5. If you want, select other stored values to assign new display values.
6. When you are done assigning new display values, click OK.
Macros are script programs run by the user. Macros perform automated operations on a set of records and
can automate bulk operations that would be inconvenient for the user to perform on many individual
records. Users run macros by selecting them from the Run Macro menu in a data view.
Note: If you don't see a Macros section, check the Show Advanced Design Features box.
This name will display in the Run Macro drop-down menu in the toolbar.
186
Creating Custom Tools
To help you keep your macro code organized, you can add code to the More Code window (Click
More Code). This is useful for setting up code for calling functions and declaring global variables.
You can also add lookup strings: Click Create Lookup String, select your lookup targets in the
dialog box, and click Copy. The Lookup string code is placed on the clipboard. You can then paste it
into your macro code.
Note: You cannot perform a lookup on records stored in a Forms tool in another workspace.
When the user runs a macro, it is called once for each record in the set. Note that global variables are
initialized before the first record in the set and retain their value from one record to the next. The order in
which the macro is called for each record in the set is undefined.
In the macro code, access to the Forms tool record is provided by the i_FormRecord parameter. You can
use the record to read or set the record's fields or to get the parent record. Access to the Forms tool
services is provided through the i_FormsToolUIDelegate parameter. Additional context information is
provided by the global functions in the Public.js script.
A custom tool designer can restrict access to macros in the following ways:
You can make selected macros available to members depending on their roles. You can also make selected
macros available to selected members regardless of their role.
• Check the member roles you want to allow to run the macro.
• In the Member list, check members you want to allow to run the macro regardless of
their role.
In custom tools developed in the Forms tool, you can add script code to forms. These scripts are executed
when the user is accessing the form. Scripts make it possible for you to extend the capabilities of a
187
Groove 2007 User's Guide
custom tool to handle specialized application requirements. To see the basic procedure for writing a form
script, see Adding scripts to a form in a custom tool. In custom tools developed in the InfoPath Forms tool,
scripts are added to forms in Microsoft InfoPath.
In addition to standard HTML DOM script programming, your scripts can do the following:
• Execute on special Groove events, such as form initialization and submitting new or updated
data.
• Access Groove services to get context information such as discovering the members of the
workspace or to perform operations, such as sending an instant message.
• Access data in the underlying Forms tool record.
• Perform lookups on data in the current tool or in other custom tools in the same or other
workspaces.
• Define a function that is executed to provide an initial value for a field.
To provide a function for a standard DOM event, name the function with the field name followed by an _
(underscore) and the event name. For example, if you have a field named Category, you could define
Category_OnFocus, Category_OnClick, and Category_OnChange functions.
When accessing the form, you can use the name GrooveFormBase. For example, in JavaScript the
following are equivalent; both return the value of the PhoneNumber field:
document.forms[0].PhoneNumber.value
document.GrooveFormBase.PhoneNumber.value
If you want to examine the html source of the form, click on the HTML Source tab in the Forms Designer
Preview window. This may be useful in coding or debugging scripts that handle DOM events or that
dynamically update the form.
You can also define functions that are executed before or after the following events:
In the script code, access to the Forms tool record is provided by the GetFormRecord global variable. You
can use the record to read or set the record's fields or to get the parent record. Access to the Forms tool
services is provided through the UIDelegate object returned by the GetApp() global function. These and
other additional context information is provided by the PublicFunctions.js script.
If you are accessing the Forms tool record in your script, you should do it in a Transaction and should
code your script with exception handling. Consequently, scripts that access records should be
implemented in JavaScript, which provides the Try-Catch exception handling statements.
In custom tools developed in the Forms tool, you can add script code to forms. These scripts are executed
when the user is accessing the form. Scripts make it possible for you to extend the capabilities of the
188
Creating Custom Tools
Forms tool to handle specialized application requirements. In custom tools developed in the InfoPath
Forms tool, scripts are added to forms in Microsoft InfoPath.
Note: You can also open the Add Script dialog box by clicking Create New Script in the Design
Object Pane. If you take this path, the scripts you add will not be assigned to a form until you edit
a form later and select the script on the Form Scripts tab.
• Click New to open the Edit Script dialog box, name and enter the script in a selected
language. If you want, click Create Lookup String to use lookup values in the script. Click OK
when the script is ready.
• Click Browse to browse for a script file to add from your file system, and click Open.
In custom tools developed in the Forms tool, you can apply different styles to any selected form. Styles
affect form background settings as well as all layout and text style settings. Form styles are based on CSS
files. In custom tools developed in the InfoPath Forms tool, styles are applied in Microsoft InfoPath.
• Select a style file for a selected form from the options provided in the Forms tool.
• Select a custom style file for a selected form.
189
Groove 2007 User's Guide
The Groove Forms tool offers a set of different style files that you can apply to a selected form.
Note: If you don't see a Styles section, check the Show Advanced Design Features box.
4. Click Browse in the Add Style dialog box to open an Open File dialog box.
5. Select the .css style file you want to add and click Open.
6. Select the style you added from the Style drop-down list to apply it to the selected form.
You can revise any of the style definitions in style files you apply to forms, including the style files that
come with the Forms tool. To do so, you must first add the style file to the Styles section of the Design
Object Pane. Then you can select it and revise it.
Note: If you don't see a Styles section, check the Show Advanced Design Features box.
You can create and apply a new style file directly in the Forms designer.
Note: If you don't see a Styles section, check the Show Advanced Design Features box.
190
Creating Custom Tools
To help get you started, the style editor initially contains a standard set of .css style names.
The new style file is added to the Style list in the Design Object Pane.
7. Select the style you added from the Style drop-down list to apply it to the selected form.
• Uncheck Show preview pane to hide the preview pane when users are selecting records
in a data view.
• Uncheck Show command bar to hide the command bar entirely. If you want to go to the
Forms designer after hiding the command bar, you must select View-Go to Designer.
• Uncheck Allow search to remove the Search button from the command bar.
• Uncheck Allow creating new records to remove the New drop-down menu from the
command bar.
• Uncheck Allow macros to remove the Run Macro drop-down menu from the command
bar.
• Uncheck Allow changing views to remove the View By drop-down menu from the
command bar.
In addition to disabling or enabling user features, you can hide or show advanced design features. You
might hide advanced design features when you intend to use only basic features, and you want to see a
smaller set of options. Hiding design features hides Scripts, Macros, and Styles.
A custom tool can be set up to allow workspace members to add only one record to the tool. This feature
is useful in cases in which you want members to fill out a single record, such as a Person record in an
address book.
191
Groove 2007 User's Guide
You can select an option that locks the design of a Forms or InfoPath Forms tool when it is saved as a
template (.GTA) file. Use this feature when you want to prevent others from updating the design in tools
created from the template file.
You can switch between two modes for displaying records in the data view. You can:
Displaying records in a table ("View mode") is the default setting when you create a new Forms tool
application.
With this viewing mode, users see only one record at a time, opened in the data view. Additionally, you
can list values from a selected field in the View menu. For example, if your custom tool contains employee
names, you might list employee names in the View menu to make it easy for users to select an employee
by name.
You can view and modify all existing lookup references in a custom tool. You can also enable or disable
the tool to be a target for lookups from other tools or workspaces.
192
Creating Custom Tools
Lookup References shows a list of all existing lookups, their parameters, and their status.
Modifying a lookup
Lookups reference precise workspace targets. For example, lookups commonly reference another tool
either in the same or in another workspace. If you save a Forms tool that contains lookups as a new tool
template, and then add the new tool to a workspace, lookup targets do not automatically update and may
be unresolved.
If you have unresolved lookups in a Forms tool, Groove attempts to resolve them when you first add the
tool to a workspace. If unsuccessful, Groove prompts you to manually resolve the lookups. You can also
attempt to resolve lookups on the Lookup References pane in the Forms designer.
Deleting lookups
You can delete lookups you no longer want from the Lookup References pane. For field definitions,
deleting a lookup simply removes all settings from the Lookup property.
Note: If you delete a lookup associated with a form script or macro, it is recommended that you also
remove the script or macro code that references the lookup. If you do not remove this code, script errors
will display in the tool.
For security purposes, custom Groove tools are initially disabled as targets for lookups from other tools or
workspaces. The designer must enable this option to allow views in the tool to be the targets of lookups.
Once enabled for the tool, designers can then enable selected views as targets for a lookup.
Users of custom tools can display descriptive information about the tool by selecting Help-About This
Tool. Tool developers can update this information in the Designer.
193
Groove 2007 User's Guide
5. Click Apply.
6. Save your changes.
The Design Name, Version, and Description provide a mechanism for external applications to identify a
Forms tool and to document the design for end users and forms designers.
External solutions that use Groove Web Services and Groove Databridge use the Design Name and Version
to identify the intended use of the Forms tool and the schemas and business rules of that use.
End-users can open the "About This Tool" dialog box to see the Design Name, Version, and Description.
Including a Design Name, Version, and Description are recommended, but optional. There is no automated
mechanism for incrementing the Design Version number; it is the responsibility of the forms designer to
increment the Version number as needed.
Note the following guidelines for specifying the Forms Design name and incrementing the version number:
• The Design Name is intended to be a unique string that identifies the organization that designed
the Forms tool and the application class or purpose of the Forms tool. We recommend using the
same URI format that is used in Groove to identify other templates. The URI has the general
format of "urn:your-company-namespace:unique-name". If you are modifying a Forms tool
template to create an entire new use for the Forms tool, you should give it a new URI.
• The Design Version provides a mechanism for form designers to document the modifications they
make to a Forms tool template. Once a Forms tool template has been deployed and external
applications have been developed to access the tool, it's important to provide information in the
Design Version number so that application developers can ensure that their solutions are working
with the correct version of the Forms tool. External applications may be affected when fields,
views, and forms are added to the Forms tool, when new ones are added to it, or when an
existing one is modified. Typically, external applications are not affected by modifications that are
purely user interface design, such as moving a field in a form.
The Design Version is an ordered set of 4 digits, delimited by periods and is stored as a string. The
Design Version conforms to the version identification scheme: (0.0.0.0). The four version digits
represent from left to right:
• Major version
• Minor version
• Custom version
• Build number
• Major version: change indicates an incompatible Forms tool schema change. A major version
upgrade of a Forms application should be considered a different application altogether. While
functionally the application remains the same application class, it's completely different from the
perspective of its record data schema.
• Minor version: change indicates that existing external applications should continue to work
because no incompatible schema changes have been made. Note that in a minor version upgrade
you can add new fields, forms, and views to a Forms tool but cannot delete or make schema
modifications to existing ones.
• Custom version: change is used typically to identify an update release for a specific customer,
which has functionality or modifications to serve a specific purpose.
194
Creating Custom Tools
• Build number: change is a designer specified increasing sequence used to associate a particular
software build sequence to the forms application, typically used in build release management.
• The Design Description is the written description to be displayed in the “help/about” user
interface. This is a rich text description, typically used for user help. This field supports styled
fonts and links (both external and internal to Groove).
195
Chapter 19. Managing Contacts
Contacts are the people you interact with. You can add contacts to your personal list in the Launchbar.
To search for and add new contacts to your contact list in the Launchbar, do the following:
You can search using "Full Name", "First Name", "Last Name", "Business E-mail", or "Personal E-
mail". The search will return all contacts in which a match is found in any of the valid fields. For
example, the search string "john" would return contacts named "Andrew Johnson" because "john"
is the first four characters in the "Last Name" field. As a rule of thumb, the more specific you make
the search string (by typing more characters), the more specific and exacting your search result
will be.
You can rearrange the order of the columns in the Find User dialog box by dragging them. You can
also remove columns (except for "Full Name") by right-clicking any column header and unchecking
the name of the column to be removed. You can restore a removed column by right-clicking any
column header and checking the name of the column to be restored. Any changes you make in the
Find User dialog box apply only to the current search session. All defaults settings are restored the
next time you open the Find User dialog box.
3. Optional: Check Include Public Groove Directory if you want Groove to include this directory in
the search.
4. Click Find.
5. If Groove finds a contact match, select it in the list.
Status icons display next to contacts in the list to allow you to see if they're currently online.
However, contact matches found in the Groove Public Directory always initially display with an
"Unknown" status icon until you select them and add them to your contact list.
For example, you might want to take steps to verify the contact's identity.
As new people become members of workspaces you belong to, you may want to add their contacts to your
personal list. Right-click the member you want to add and select Add to My Contacts.
Deleting contacts
196
Managing Contacts
Contacts you delete from the contact list in the Launchbar may still appear in other contact lists, such as
the To: drop-down lists in the Send Message or Send Invitation dialog boxes. This is because Groove
stores contact information for all Groove users with whom you interact in an aggregate list called "Known
Groove Contacts". This includes contacts you've added to your Launchbar contact list, plus members of
your workspaces. Keep in mind that you may commonly have workspace members who are not also in
your contact list.
You cannot delete the contacts who appear in your Known Groove Contacts list. However, you can at least
hide these contacts.
As you use Groove, you build a list of people with whom you interact. In some cases, you build this list
directly, for example, by adding contacts to your personal list. In other cases, you build this list indirectly
via your interactions with members of your workspaces. For example, when you join a workspace as an
invited member, all other members of that workspace immediately become available to you for starting
new activities. Similarly, any person who joins one of your workspaces (either by your invitation or some
else's invitation) immediately become available to you. The aggregate list of all people you interact with
via Groove is your list of Known Groove Contacts.
To see your Known Groove Contacts list, select Options-Contact Manager. In the Manage Contacts
window, you can do the following:
To view the "properties" for any contact, right-click the contact and select Properties. From contact
properties you can:
• View all information the selected contact has provided for their contact identity (for example,
company name, telephone number, and e-mail address).
• Create an alias for the contact to list them under a different display name.
197
Groove 2007 User's Guide
You can send your contact to other people as a file attachment in an e-mail message or in a Groove
message. Use e-mail if you don't yet have the recipient's contact, or if the recipient does not yet have
Groove installed.
Note that the standard text message includes instructions for downloading Groove.
4. Click OK.
You can send others' Groove contact details to other people as a file attachment in an e-mail message or
in a Groove message.
Note that the standard text message includes instructions for downloading Groove, in case
recipients don't have Groove accounts yet.
5. Click OK.
You can save your contact as a file for the purpose of making it available to other Groove users. For
example, you might send the saved contact file as an attachment in an e-mail, place it in a Files tool in
another Groove workspace, or place it on a file server. Note that Groove provides an automated feature
for sending your contact to other people.
5. Click Save.
198
Managing Contacts
You can set alerts for selected contacts or workspace members so that Groove notifies you about online or
idle status changes.
1. Right-click the contact(s) or member(s) you want and select Set Alerts.
If you selected one contact, a Contact dialog box opens with the Alerts tab displayed. If you
selected multiple contacts, an Alerts dialog box opens.
Tip: Click the Play button to sample the sound of the selected .wav file.
4. Click Apply to save your changes and leave the dialog box open, or click OK.
You can set the following additional alerts that respond to workspace member activities:
You can save other peoples' contacts as a file. You could then send the contact file as an attachment in an
email.
You can display any contact (other than your own) under an alias. This is useful if you're having trouble
distinguishing between contacts who have the same name.
199
Groove 2007 User's Guide
The alias name displays in place of the original name. To see the contact's original name you can
open their contact information, or point at the alias name to display a pop-up window that shows
the original name.
Verifying the identities of the people you use Groove with is strongly recommended to alleviate the risk of
sharing sensitive information with unintended people. Depending on your Groove installation, many
contact identities may already be verified by an administrator at your organization. Groove indicates
verification status of people in your contact and member lists using the following colors:
The communication policies applied to your account identity determine your ability to interact with other
Groove users depending on their verification status. These policies may do any of the following:
• Prohibit you from communicating with any users who are not verified by an administrator in your
organization.
• Warn you before allowing you to communicate with users whose identities have not been verified.
In this case Groove opens the Contact Verification Alert dialog box described below.
• Allow you to communicate with any contact without any warning or restriction.
Your organization's verification of other Groove users may provide you with enough assurance about their
identities. In some cases, especially if you are working with highly sensitive information, you may also
want to manually verify a user's identity.
The Contact Verification Alert dialog box displays if you try to communicate with users whose identities
have not been verified, and communication policies for your account identity are set to warn you about
such users. You can do any of the following:
• Select users and click Verify Identity. Follow the instructions in the next section for manually
verifying a contact identity.
• Click Properties to view contact properties for a selected user.
• Click Continue to ignore the user verification alert and continue with the activity.
• Click Cancel to cancel the activity you were doing that resulted in a user verification alert.
Groove assigns a unique "digital fingerprint" to each contact identity. A digital fingerprint appears as a
long, random looking string of letters and numbers (with punctuation marks for readability). These digital
fingerprints are used for manually verifying the real-world identities of Groove contacts you see in your
workspaces and contact lists. You can also view the digital fingerprint assigned to your Groove identity.
200
Managing Contacts
1. Right-click the contact (or workspace member) you want to verify and select Verify Identity....
The Verify Identity dialog box displays information about your current relationships with the
selected contact, such as workspaces you share, the number of messages you have exchanged,
and your organizational relationship. If you do not have any relationships with the selected
contact, the Verify Identity dialog box instead provides instructions for verifying the contact's
identity by checking their digital fingerprint.
Note: If Groove detects that there are two or more contacts that have the same, the Verify
Identity dialog posts a warning message that advises you to assign as alias when you verify this
contact.
• If you are sufficiently assured of the contact's identity from the information you see,
click Verify.
In the Verify Identity As dialog box, enter an alternative name for the contact if you think you
need one, and click OK.
• If you are not yet sufficiently assured of the contact's identity, and want to take more
steps to verify their identity, click Still not sure? - Check fingerprint.
Follow the steps in the Verify Identity dialog box for checking the contact's digital fingerprint,
and click Verify.
In the Verify Identity As dialog box, enter an alternative name for the contact if you think you
need one, and click OK.
Although rare, you may occasionally have reason to change the verification status of contacts that you
have manually verified so that they display as not verified.
1. Right-click the contact (or workspace member) you want to unverify and select Verify Identity....
2. Click Unverify.
When two or more contacts have identical display names, their names display in red in contact lists,
workspace member lists, and on their contact information cards. Groove considers display names identical
if two (or more) names match exactly after removing leading, trailing, and multiple embedded spaces and
converting the name to lowercase text.
For example, "Ann Beebe" and "Ann Beebe" will result in a name conflict. However, "Ann Beebe" and
"AnnBeebe" will not result in a name conflict.
It's important to distinguish between contact names so you don't accidentally start Groove activities with
the wrong contact. To do so, you can create an alias name for any of the conflicting contact names.
Additionally, in some rare cases, a name conflict may result from having obsolete contacts stored with
your account. For example, perhaps a contact has activated a new Groove account, and has abandoned all
activities in the previous one, but used the same display name for both. In this case, you can also hide the
contact as described below so that it no longer displays in any of your contact lists.
201
Groove 2007 User's Guide
• Click View vCard... to see details for the selected contact. This might help you
distinguish between contacts of the same name.
• Click Alias Contact... to open the Alias dialog box where you can enter a unique display
name for the contact.
• Click Verify Identity... to go through the steps of verifying a contact's identity.
3. Click Done.
Hiding a contact
Groove contacts may sometimes become obsolete for a variety of reasons. If you have obsolete contacts,
you can hide them so that they're no longer listed in drop-down menus that show contacts.
Note: Hiding a contact will not automatically resolve an associated name conflict. If a contact you want to
hide appears as a name conflict, see Resolving name conflicts for information.
You can view the diagnostic information for selected contacts. You may occasionally need to see this
information for technical support purposes. If you need to send diagnostic information to a support
technician, you can copy and paste the information in the Diagnostics dialog box into an email.
To copy information from the Contacts pane, right-click and select Select All, then right-click and
select Copy.
To copy information from the Awareness or Network Diagnostics panes, click Copy to Clipboard.
4. Click OK.
202
Chapter 20. Setting Preferences
To use Groove, you must have an account and at least one identity in your account.
A Groove account is a file stored on your computer that contains the following types of information:
• Your Groove identity or identities, and the cryptographic "private keys" that define them.
• Other cryptographic information, such as a "master key" for protecting your workspaces.
• The devices on which you run Groove.
• References to the workspaces in which you are a member.
• Information about the contacts you communicate with.
You take measures to secure access to your account either by setting a log-in password or via a certificate
stored on a smartcard. When you log in to Groove, your password or certificate decrypts your account file
so that you can access the information in it and thereby assume your Groove identities.
Functionally, a Groove account works much like a Groove workspace, in the sense that you can "share"
the same account (and access to the workspaces stored with the account) across multiple computers.
A Groove identity is the "electronic presence" by which other Groove users recognize and interact with
you. An identity can be associated with only one Groove account; it cannot be added to other accounts.
However, as noted in the previous section, you can add the same Groove account to other computers.
Unless you're restricted by policies set by your Groove administrator in a workplace or organization, you
can create multiple identities in your account. This allows you to interact with people using different
personas. For example, you might be "Jane Green" when using Groove for business activities, but
something more familiar such as "JaneG" when using Groove with friends and family. Additional display
names can be whatever you choose, although it is more useful to choose names that make sense in each
context.
Each identity you create is associated with a Contact file that provides identifying information about the
identity. You may supply whatever information you wish in your Contact file (at a minimum, each identity
must have a name and a valid e-mail address). Thus, different Groove users may learn different
information about you depending on which identity they see associated with you. For example, you might
provide only a business address for the identity you use for business activities, but provide your home
address for the identity you use with friends and family.
Default identity
Every account has a default identity. When you create your Groove account, your initial identity (your
account name) is your default identity. You can change your default identity.
Managing Identities
203
Groove 2007 User's Guide
To manage your identity, select Options-Preferences and click the Identities tab in the Preferences dialog
box.
You can add new identities to your account so that you can interact with other Groove users in a manner
that reflects your relationship with them. New identities you add supplement rather than replace any
existing identities. For example, you might use a "professional" identity with work colleagues, but use a
less formal identity with friends and family.
Adding a new identity is like creating a new contact for yourself. Each new identity has its own unique
contact information that you can share with other selected Groove users. When you create a message, or
create a new workspace, you can decide which identity to use for each.
Note: Your Groove administrator may have set policies for your account that restrict you from adding new
identities.
At minimum, you must add valid entries in the "Full Name" field and the "Email" field on either the
Business or Personal tabs. The "Full Name" can include any characters except for the following:
{}=/;. The "Email" field must contain a valid e-mail address.
For the remaining fields, provide any information you think other Groove users will find useful or
that you feel comfortable sharing.
4. Click OK.
5. Optional. Select options for sharing the new identity with other Groove users. You can:
If you create one or more new identities, you can set any of these identities as your new default identity.
Otherwise, your default identity is the identity that Groove created when you created your Groove
account. Your default identity is pre-selected when you create new messages or invitations to a
workspace.
204
Setting Preferences
You can view or edit the information associated with your Groove identity. This is the contact information
other Groove users see when they view your Groove contact. Providing detailed contact information helps
others distinguish you from other Groove users who have the same display name. For example, if your
contact display name is "Ann Beebe," you may want to ensure that other Groove users know you're "Ann
Beebe from Seattle" instead of "Ann Beebe from Glasgow."
Note: Policies applied to your computer or Groove account may prohibit you from editing your identity. For
more information, see you Groove administrator.
All information currently entered for the selected identity displays in the dialog box.
When you configure your Groove account, you see an option for listing your contact in the Groove Public
Directory. The default setting is "No Listing." You can change this setting at any time in your account
preferences. Listing you contact in the Public Groove Directory makes it easier for other Groove users to
find you and start Groove activities with you.
If your computer is connected to a local area network (LAN), your contact is automatically listed in your
LAN directory.
The contact information you show in these directories depends on which fields you fill out in the Edit
Identity dialog box associated with the contact identity. Additionally, you can opt to display only the
Identity display name, or all contact information you provide.
To change how you list your contact information in directories, do the following:
When you make your selection, an alert displays to confirm your action. Note that any subsequent
changes you make to the identity information are immediately synchronized for all Groove users
who have your contact in their contact list or workspaces.
205
Groove 2007 User's Guide
You can set preferences for showing your online presence to other Groove users. The options you choose
affect the status icons that display next to your name in any Groove contact list. For example, you can
"hide" your online presence and thus appear to be offline to other Groove users.
You can save your contact as a file for the purpose of making it available to other Groove users. For
example, you might send the saved contact file as an attachment in an e-mail, place it in a Files tool in
another Groove workspace, or place it on a file server. Note that Groove provides an automated feature
for sending your contact to other people.
5. Click Save.
Deleting an identity
For a variety of reasons, you may decide to delete an identity you have in your Groove account. Keep in
mind that deleting an identity also has the following results:
• All workspaces and messages associated with that identity are also deleted. Thus, you will no
longer see any of the identity's workspaces or messages in the Launchbar, Workspace List, or
Message History.
• If the identity you delete is your account's default identity, Groove selects another identity as the
new default.
Note: You cannot delete the last identity in your Groove account.
To delete an identity:
206
Setting Preferences
• To manage your account, select Options-Preferences and click the Account tab.
It's strongly recommended that you strengthen the security of your Groove account by setting a log-in
password. You can set a log-in password either when you initially set up your groove account, or any time
later.
To select a strong password, use a word or combination of words and characters that you yourself can
easily memorize and type, but that others will be unable to guess. For the strongest possible security, use
8-10 random words (not merely random characters).
Note: The log-in password you set applies only to the Groove account you're using on that computer. You
must set passwords separately on each computer on which you add your Groove account. You can set the
same password on each computer, or set different passwords.
Keep in mind that password hints are only intended to remind you of your password. For security reasons,
it will never reveal the actual password. An effective hint will remind you (and only you) of your password.
It should not enable others to guess your password.
You may see an option to "remember" your password. If you don't see this option it means that a device
policy for your account does not allow this action. See your Groove administrator for more information.
If you select this option, you (or anyone else) can log in to Groove without entering your log-in password.
Use this option only if you're sure that no unauthorized people have access to your computer.
If you forget your password, and if your password hint (if you set one) doesn't help you remember it, you
can run the Password Reset process in order to obtain a new password.
Depending on your installation type, you're prompted to set a log-in password or select a smart card log-
in certificate during the account configuration process.
207
Groove 2007 User's Guide
3. Check Remember password if you want to log in to your account later without typing your
password.
This option may not be available according to device policies set for your account. See your Groove
administrator for more information.
4. Check Enable password reset if you want to be able to request a new password (or smart card
certificate) from your Groove administrator.
This option may not appear depending on how your account is governed by device or identity
policies as set by your workplace. If this option is unchecked (or if this option is not available), you
may still be able to reset a log-in password (or reset a smart card certificate) as described in the
section below.
5. Click OK.
For security reasons, Groove does not provide features for recovering a forgotten password or a smart
card certificate (if you've lost your smart card). However, Groove does provide one or more of the
following features to assist you in case you've forgotten your password or need a new smart card
certificate:
• For passwords, you can set a hint to remind you of your password. For security reasons, it will
never reveal the actual password. An effective hint will remind you (and only you) of your
password. It should not enable others to guess your password.
• Depending on device or identity policies set for your account, you may be able to run the
Password Reset or the Smart Card Certificate Reset process from the account login window.
1. In the Groove log-in window, click the Forgot your password? link.
If you set a password hint, the Password Hint dialog box opens and displays it. If the password
hint reminds you successfully, click OK and proceed with the login.
2. If the password hint doesn't help you remember your password, click Reset Password.
Note: If you don't see this option, contact your Groove administrator.
Depending on your account type, you see one of the following results:
• Groove displays a prompt telling you that a new temporary password has been sent to
your e-mail address.
Note: If you have more than one e-mail address registered with your account (for example,
different e-mail addresses registered with different identities), Groove displays a prompt
asking you to select which e-mail address you want to receive the new temporary password.
• Groove displays a Reset Password dialog box that lists a password reset access code.
Your Groove administrator may ask you to verify the password reset access code before
resetting your password. Keep the password Reset window open so that you'll be able to
supply this information.
3. If you get the Reset Password option, click Request Reset when your Groove administrator tells
you to do so.
208
Setting Preferences
4. When the Request Password Reset window appears, follow the instructions to enter and confirm a
new password, and click OK.
If your password meets the requirements set by your Groove administrator, you'll be logged into
your Groove account.
1. In the Groove log-in window, click the Request Smart Card Login Reset link.
Note: If you don't see this option, contact your Groove administrator.
2. Depending on your account type, you see one of the following results:
• Groove displays a prompt telling you that a new temporary password has been sent to
your e-mail address. Once you log in using the temporary password, a Change Password
dialog box displays with options for selecting smart card certificates.
Note: If you have more than one e-mail address registered with your account (for example,
different e-mail addresses registered with different identities), Groove displays a prompt
asking you to select which e-mail address you want to receive the new temporary password.
• Groove displays a Request Smart Card Login Reset dialog box that lists a smart card
login reset access code. Your Groove administrator may ask you to verify the smart card
login reset access code issuing you a new certificate. Keep the Request Smart Card Login
Reset window open so that you will be able to supply this information.
3. If you get the Request Smart Card Login Reset option, click Request Reset when your Groove
administrator tells you to do so.
4. Select new certificates when prompted and click Finish.
If you're currently logging into Groove using a password, but you've obtained a smart card setup and wish
to begin logging in via a smart card, do the following:
Similarly, if you're currently logging in via a smart card and wish to switch to password login, open the
Change Password Dialog box, select Use a Password, enter the password and hint information when
prompted, and click OK.
Select Options-Preferences and select the Options tab to set account preferences for:
• Startup
• Messenger integration
• Email
• Restricting messages from unknown contacts
• Virus scanning
209
Groove 2007 User's Guide
To automatically start up Groove whenever you start up your system, check Launch Groove when
Windows starts up.
Messenger integration
To integrate Messenger contacts with your Groove contacts, check Integrate messenger contacts. This
option is enabled by default unless a management policy is set to disable it. Messenger integration enables
the following features:
• The first time you start up Groove after a new or upgrade installation, Groove prompts you to
add all users from your Messenger contact list to your Groove contact list. You can click the
Advanced button to selectively add Messenger contacts.
• You can view awareness information for Messenger users who are in your Groove contact list.
• You can start Messenger activities with Messenger users in your Groove contact list.
• You can invite your Messenger contacts to join a Groove workspace, even if they are not also
Groove users.
You can set the Launchbar to automatically open when you startup Groove, and to always display on top
of other application windows.
You can set Workspace Explorer to automatically open when you startup Groove. Additionally, you can set
options for how to open windows when you open a workspace, as well as options for showing a Contacts
list in the menu bar and showing all workspace types in the Workspace List.
Email options
Check "Send email invitations using Microsoft Outlook" if you want Groove to always use this email
program for creating and sending invitations initiated from Groove. For example, if you check this option,
Groove will open and use Outlook when you send a workspace invitation.
You can synchronize your Internet Explorer Favorites across all computers on which you have your
account.
210
Setting Preferences
You can also check the option to create shortcuts to your file sharing workspaces in "My Documents".
You can add your account to other computers on which the Groove software is installed, and your
workspaces will be synchronized across your computers. As a guideline, it's strongly recommended that
you add your account to no more than 5 computers.
Note: Your Groove administrator may have set policies for your account that restrict you from adding it to
other computers.
To add your account to another computer, you must do the following tasks:
• Save your account file, and make it available for use on the other computer.
• Run the account configuration wizard on the other computer, and select the saved account file.
When you save your account file, you can opt to send it automatically to yourself as a file attachment in
an email, or save it to disk locally for copying to other computers.
Once you've saved your account file and made the file available on another computer, you can use the
Account Configuration Wizard to add your account on the other computer.
• Click I saved my account to a file if you have local access to your account file. Click the
Browse button, navigate to the location where you placed the saved account file and click
Open.
• Click I e-mailed my account file to myself if the saved account file is in your e-mail
program's inbox. If this is the case, click Finish, go to your email, and double-click the .grv
file attached to the e-mail.
The Groove Login window should now display allowing you to log in to your account. Once you log in, you
can proceed to download your workspace data.
211
Groove 2007 User's Guide
You can see a list of the computers on which you're synchronizing your Groove account, as well as the
status of your account on each computer. To see this information, select Options-Preferences, and click
the Account tab. You can do the following account management tasks:
Renaming a computer
Groove lists the names of the computers on which you have your account. You can change the names
listed for these computers. New names will display in this window for all computers that contain your
Groove account.
If a computer that contains your account displays a synchronization alert, this means that your workspace
data on that computer is no longer being synchronized. In this case, the best course of action is to remove
the computer, and then take steps for adding your account to another computer (if you still want to use
your account on this computer).
If you add your Groove account to multiple computers, Groove synchronizes your workspace data
provided that you go online on all computers with reasonable frequency (at minimum, about once every
three weeks). If you're offline on any one of the computers synchronizing your account for an excessive
period of time, Groove stops synchronizing data for this computer, and posts a synchronization alert.
1. Delete the unsynchronized copy of the account from the computer where it resides.
2. Run the process for using an existing account on another computer to re-add the deleted
account.
To guard against losing your account and access to your workspaces in case of disk failure or other
computer problems, you can save your Groove account so it can be restored later.
You can also use a saved account file to add your account on another computer.
When you save your Groove account, information about your preferences, settings, contacts, and
workspaces is stored in a file. You can place this file in a location where you can reliably retrieve it later,
such as a network file server.
Saving your account does NOT also back up your workspace data. You'll need to download the data in
your workspaces later: either from another computer on which you have the same account, or from other
212
Setting Preferences
members of your workspaces. You cannot download data for a workspace if you're its only member and if
you do not have the workspace on another computer that has your account on it.
1. Select Options-Preferences.
2. Click the Account tab.
3. Click Save.
4. In the Save Account As dialog box, select the location in which to save your account file.
5. Click Save.
Restoring an account gives you a reference list of your workspaces in the Launchbar or Workspaces menu.
You must download the content data for your workspaces from another computer that has your account,
or from other workspace members.
To restore an account from a backup copy run the Account Configuration Wizard.
1. Start Groove.
2. Click the Groove icon in your task bar and select New Account.
3. Click Use a Groove Account you have already created, and click Next.
4. Click Restore My Account.
5. Click I saved my account to a file.
6. Click Browse.
7. Find and select the account backup file (for example, myaccountfile.grv).
8. Click Open.
The account is added and the Launchbar opens. You can now proceed to download your workspace
data.
To delete an account:
Groove asks you to confirm that you really want to delete this account. Click Yes to confirm. The
account is immediately deleted from this computer.
Note: The account will NOT be automatically deleted from other computers on which you have the
account.
Managing Alerts
213
Groove 2007 User's Guide
You can adjust the default setting for how Groove notifies you about unread information in new
workspaces you create. You can override this setting later in any individual workspace, tool, or folder or
file in a Files tool or file sharing workspace.
2. Select the number of days you want for Automatic Alert Removal from the drop-down menu.
If you receive a large number of unread alerts, you may want to set a shorter number days after
which they're automatically removed.
4. Click Apply.
Click Restore Default to restore Groove alert settings to their system defaults.
To set security options for a selected identity, select Options-Preferences and click the Security tab in the
Preferences dialog box. You can:
Groove assigns a unique "digital fingerprint" to each identity you create in your account. A digital
fingerprint appears as a long, random looking string of letters and numbers (with punctuation marks for
readability). Other Groove users may ask you to tell them your digital fingerprint in order to verify your
identity before they share information with you. You can also use digital fingerprints to verify the identities
of other Groove users.
To see the digital fingerprint associated with any of your Groove identities:
If you have only one identity in your account, which is typical, you won't see a drop-down menu.
Communication policies help you verify the identities of the people you communicate with using Groove.
For example, policies can signal Groove to warn you before you communicate with people who don't have
the required verification, or simply disallow communication in this case.
214
Setting Preferences
Note: An administrator may have already set fixed communication policies for your identity.
You can select an option that applies the following workspace version restrictions:
• You can only create workspaces that can be used in the current or a later version of Groove.
• You can only be invited to workspaces that were created in the current or a later version or
Groove.
You might enable this option if you want to ensure that you use only the most current and secure Groove
tools.
Note: Policies applied to your identity may prevent you from changing the current setting of this option.
For more information, see your Groove administrator.
For security purposes, you can enforce restricting certain types of files from Groove Files tools or as
attachments in other tools such as Discussion or messages. The types of allowed file types are the same
as those specified in Microsoft Office as "safe for sharing".
Note: Management policies may not allow you to disable this option.
To see a list of the restricted file types, click View restricted types.
3. Click OK.
215
Groove 2007 User's Guide
You can select options for restricting the delivery of Groove messages from other Groove users. You might
do this if you want to restrict the Groove messages you receive to only known Groove contacts, that is,
contacts who are either in your contact list, verified by you or your administrator, or members of at least
one of your workspaces. Enable this feature only if you are receiving a disruptive number of unwanted
messages from unknown contacts.
To restrict messages:
• Messages from contacts who don't match any of the criteria described above will be discarded
and cannot be recovered.
• If you send a Groove invitation via email to restricted people, they will be unable to receive the
workspace because you will be unable to receive the "Acceptance Confirmation" message that is
automatically sent on acceptance of email invitations.
This issue similarly applies to saved invitation files you make available, and that might be opened
and accepted by restricted people.
• If you use your account on more than one computer and you enable this feature, it is strongly
recommended that you download all workspace content on all of your computers. This will ensure
that all computers maintain the same lists of known and verified contacts.
Recommendations
Given the risks of data loss described in the previous section, use of this feature is intended only as a
temporary measure for users who are deluged with unwanted messages from unknown contacts. The
following course of action is recommended as a more permanent remedy: Add a new identity in your
account, migrate your existing workspaces to the new identity by sending workspace invitations to the
new identity, and then delete the identity receiving the unwanted messages. If workspace permissions do
not allow you to send invitations to some of your workspaces, ask other members of the workspace to
send the invitation to the new identity.
You can enable a security option in your preferences so that all incoming and outgoing files in Groove are
scanned to protect against viruses.
Groove's virus scanning feature is supported if you're running Norton AntiVirus Personal Edition 2002 or
higher. Other anti-virus software applications may also support this feature, but have not yet been tested.
Note: The virus scanning feature is not supported if you're running Norton AV Corporate Edition or Sophos
Anti-Virus.
216
Setting Preferences
217
Chapter 21. Managing Groove Communications
Select Options-Communications Manager to display the Communications Manager dialog box. Here you
can do any of the following:
• View the data exchange activity for your workspaces, messages, and invitations.
• Pause the data transfer for a selected workspace or activity, or for all workspaces and activities
at once.
Tip: You can also click the status bar on the Workspaces tab of the Launchbar or the Groove Workspace
Explorer to pop up a communications panel. The Launchbar communications pop-up menu includes file
sharing workspaces as well as other Groove workspaces.
The Communications Manager reports on the overall communications status, as well as the
communications status of individual workspaces and other activities such as messages and invitations.
Data counters at the top of the dialog box track amount of data you're currently transmitting and
receiving. A status message (to the left of the data counters) reports on the current state of
communications. The following table describes the status messages you might see.
In the Activity table, the Communications Manager provides status information about your workspaces,
messages and invitations, and about other accounts you might have on this computer.
The table below lists the activities and the status messages you might see.
Activity Status
218
Managing Groove Communications
Paused: < Data> left to transmit; <Data> left to receive-You paused the
messaging feature with data left to send or receive.
Miscellaneous <Data> left to transmit; <Data> left to receive-The amount of data being sent
communications or received outside of workspaces and messaging activities.
Pausing communications
You can pause communications for a selected workspace or for messages and invitations. You might want
to do this if want to postpone sending or receiving large quantities of data.
To pause communications for a workspace or activity, uncheck its checkbox. The status message for the
workspace or activity changes to "Paused." To resume communications, re-check the checkbox.
You can also click Pause All to pause communications for all workspaces and message activity at once.
This feature is most useful if you have a large number or workspaces, and you'd like to pause
communication for all but one (or a few) of them. In that case, you can select Pause All and then resume
communications for only selected workspaces.
Tip: You can also pause communications for a workspace by selecting it in a workspace list and selecting
Options-Pause Communications. You can pause or resume communications for all workspaces by selecting
Options-Pause All Communications or Options-Resume All Communications.
If you pause a workspace or communication activity, you will still receive incoming data if Groove clients
are communicating via static IP address mode and:
• Another member of the workspace you paused is running an earlier version of Groove.
• A contact running an earlier version of Groove sends you a message or invitation.
Note: If Groove clients communicate through a relay server and you pause a workspace or communication
activity, you will not receive incoming data.
Working offline
219
Groove 2007 User's Guide
Working offline suspends all Groove data communications, and displays your online status as "offline" to
other Groove users.
Working offline is most useful when you want to just work locally, and when you prefer that others view
you as temporarily unavailable.
To start working offline, click Work Offline. The Groove icon in the Windows notification area changes to
look like this: .
Responding to alerts
Groove displays alerts to notify you about new messages or invitations, and (depending on current tool or
workspace property settings for alerts) unread information in a workspace or workspace tool. Groove also
displays alerts to track the status of messages you've sent and workspace invitations you've sent or
accepted.
Click the alert text to go to the associated information. For example, click the text in a new message alert
to open the message. For alerts that only provide status information, click the alert text to close the alert.
You can also right-click an alert to see the menu options described below:
If you decline an invitation, the sender receives an alert to notify them that you've declined their
invitation.
• For an unread information alert, select Open to go to the tool that contains the unread
information, or select Dismiss to simply close the alert.
• For alerts that track the status of messages or invitations, select Stop Tracking to close these
alerts permanently.
Suppressing alerts
You can prevent Groove from showing alerts. This is useful if you're receiving a high volume of alerts and
are finding it distracting.
To suppress alerts, select Options-Suppress Alerts. The Groove icon in the Windows notification area
changes to indicate that alerts are currently suppressed:
You'll still receive data (such as new messages and invitations) while alerts are suppressed, except that
the alert indicator will simply blink above the Groove icon in the Windows notification area, and no alerts
will display.
220
Managing Groove Communications
You can view the network settings and diagnostic information for the identities in your Groove account
from the Communications Manager. You may occasionally need to see this information for technical
support purposes. You can also switch your network address between an automatic (a device URL
assigned automatically for your computer) and static (a device URL you specify).
To display and copy the network settings used by your identity to communicate with other Groove users:
The Advanced Network Settings dialog box displays the network settings for the selected identity.
To view the network settings for another identity, select it from the drop-down menu.
3. Click Copy to Clipboard to copy all of the list of network settings so you can paste them into
another application.
4. Click OK.
The Advanced Network Settings dialog box also allows you to modify the network address of your
computer.
1. Select the setting Network address for <Computer Name> (This Computer) and click Modify.
2. Select Automatic (default) or Static. If you select static, enter the new address in the space
provided.
Note: if you select static, all your devices must use a static IP address.
3. Click OK.
Groove validates the static address and warns you if it is invalid. If the address is valid, the list of
devices in the Advanced Network Settings dialog will be refreshed to reflect you change.
4. Click OK.
If you decide to switch to an automatic IP address, Groove removes the static IP address, restores the
presence devices for the computer, and restores the previous relay server information.
221
Microsoft Office Groove 2007 Glossary
acceptance confirmation
A security feature that pauses the workspace invitation process to let you verify an invitee's
identity before sending the workspace.
account
An account is a file stored on your computer that contains your Groove identity or identities and
the cryptographic "private keys" that define them, the computer systems on which you run
Groove, references to the workspaces in which you are a member, and information about the
people you communicate with.
alerts
Notifications that appear at the lower, right corner of the screen for a few seconds. Alerts inform
you of a variety of events taking place in Groove such as delivering or receiving messages and
invitations. You can redisplay alerts by point at the Groove icon in the Windows notification area.
alias
A name you give a contact in order to distinguish it when two or more contacts have the same
name.
audio tuner
Wizard that helps you adjust your speaker and microphone settings so you can use Groove's
audio features most effectively.
binary files store
Groove stores data for workspaces in local databases. Some of this data, specifically files in the
Files tool, Pictures tool, or Discussion tool (where entries contain file attachments), is stored as
binary files on disk. Groove stores all such files in a single disk location called the binary files
store. The binary file store provides efficient file management, allowing unneeded files to be
deleted as soon as possible.
bot
An automated agent that acts as a proxy member in a workspace, under the context of a unique
identity that performs specific functions related to the role assigned.
bot server
A bot server is like a bot, except that it runs on its own machine and interacts with other bots
that are in a workspace to perform automated tasks. Bot servers can also connect to external
systems using data that a Groove user would not need.
certificate
Term used in security contexts to mean a data structure that contains a public key and
identifying information for a domain, device or identity, which is digitally signed with the private
key of the CA which issued it.
certificate authority (CA)
Term used in security contexts to mean an entity which creates and assigns certificates. In a
managed Groove environment, the management server can be the certificate authority.
certification
Term used in security contexts to mean the deployment and assignment of public keys by a
certification authority (CA) to a domain, device, identity. In a managed Groove environment, the
management server can be the certification authority.
chat
Way of doing instant communicating in Groove. Groove supports text- and audio-chatting.
conference mode
A Groove audio-chat feature that allows all members who enable it to talk at the same time.
When disabled, only one member at a time can use the audio-chat feature to talk to other
workspace members.
default identity
The user identity assumed for all subsequent workspaces (those created after the default is set).
When a user creates an account using the account configuration code provided by their domain
administrator, that identity becomes the default identity for workspaces that the user creates
from then on. Depending on management and device policies, users may be able to create
another identity in their accounts and set this as their default identity.
device
A device is a client (user) computer that is running Groove. Devices are automatically associated
with users during the initial Groove installation. Administrators can manage these devices by
applying a registry setting (a pointer to the domain) to the devices. This makes the devices part
of a management domain. Once devices are registered with a domain, administrators can
manage Groove use on these devices by setting device policies, for example, to control password
creation or regulate Groove component downloads on these devices.
222
Glossary
digital fingerprint
A long, random-looking string of letters and numbers (with punctuation marks for readability)
that are used to verify the real world identities of Groove contacts you see in workspaces and
contact lists.
domain member
A Groove user who creates an account identity using a specific account configuration code
provided to them by a Groove domain administrator. This Groove identity is subject to
management policies applied to this domain. Domain members gain access to domain licenses,
subject to domain policies, and are directed to domain relay servers (if registered on the
management server).
file conflict
An error condition in which two workspace members edit and save the same file. For example, if
two workspace members simultaneously edit and save the same file in a Files tool, this will result
in a file conflict. In this case, the member who attempts to save the file last is prompted to save
it in a new "conflict" version of the file.
firewall
A computer or application that prevents unauthorized access to private data (as on a company's
local area network or intranet) by outside computer users.
GDK
Groove Development Kit. A software development kit for the Groove client with various API's,
code samples, instructions, and other information for writing tools for the Groove platform.
Groove Manager
A Web-based application, available as a component of the Microsoft Office Groove Server or as a
service via Groove Enterprise Services, that provides a centralized environment for managing
Groove use in an enterprise. The application resides on an IIS server supported by a SQL server.
With an onsite Groove Manager, server administrators can install, configure, and monitor the
server, as well as manage Groove users, set user identity and device policies, assign Groove
Relay servers, and monitor Groove usage.
identity
A Groove identity is the "digital persona" by which other Groove users recognize and interact with
you.
invitation
The way you ask others to join a workspace and become a workspace member.
Known Groove contacts
The aggregate list of all people you interact with via Groove. This includes all Groove users you
have added to your contact list, plus all Groove users who are members of any of your
workspaces or with whom have sent or received any Groove message.
LAN (local area network)
A data communications network that is geographically limited (typically to a 1 km radius)
allowing easy interconnection of terminals, microprocessors, and computers within adjacent
buildings.
LAN DPP (local area network device presence protocol)
A UDP message broadcast on a LAN to establish awareness (announce presence). LAN DPP is
used when there are multiple Groove clients on the same subnet of a LAN. DPP determines the
presence or absence of clients on the network for making connections.
management domain
A management domain is the topmost manageable entity on a Groove Manager. Each
management domain contains a collection of member groups, identity policy templates, device
policy templates, and relay server sets. A Groove Manager may contain multiple management
domains, and an administrator may only have access to specific domains.
member
A Groove user who belongs to a workspace.
member pane
Pane in the Groove Workspace Explorer that lists all members of a workspace and their current
status.
multiple computers option
This option allows users to install and use their Groove account from more than one location
(device).
name conflict
Term used when two or more contacts have identical display names. Display names are
considered identical if they match exactly after removing all non-alphanumeric characters,
leading, trailing, and multiple embedded spaces, and converting the name to lowercase text.
one-to-all mode
A Groove audio-chat in which the current speaker has first broadcasting privileges. Workspace
members can start talking while another member talks, but their voice entries will be delayed
223
Groove 2007 User's Guide
until the current speaker finishes. There is no menu option for One to all mode. This is the
standard audio-chat mode unless you enable Conference mode.
password
The word or (preferably) set of words you use to cryptographically protect your account file.
permissions
Permissions provide access to specific Groove features such as inviting contacts to a workspace,
adding or deleting tools to or from a workspace, as well as access to specific activities within
workspace tools.
policy
A rule applied to all managed identities in a domain or group, or to all managed devices in a
domain or group. Restricting publication of managed identity contact information is an example of
an identity policy. Restricting downloads of Groove components on managed devices to a specific
source (such as a specified onsite server) is an example of a device policy.
private key
One half of a key pair, kept private by the owner and used in conjunction with a matched public
key. This strictly private key is used to decrypt messages that have been encrypted by a public
key.
provisioning server
New Groove account identities for unmanaged users are automatically connected to a
provisioning server for the purpose of assigning a contact record and allowing the user to publish
this contact in a global directory. The provisioning server also automatically assigns other
network settings for the account identity such as a Relay Server URL.
public key
One half of a key pair, used to verify signatures created with a matched private key and to
encrypt messages which can only be decrypted using the matched private key. This publicly-
listed key is associated with a user or device and is available to other users and devices for
sending encrypted messages to the public key owner. The public key owner then uses a private
key to decrypt the message. A public key is usually stored in a certificate (.cer) file along with
other identifying information.
purge
The act of clearing the Groove "delta" log by suspending members of a workspace. You may need
to do this if one or more members do not log into their Groove accounts to receive updates for an
extended period of time, thus causing the delta log to exceed acceptable limits.
relay server
A relay server is the computer that provides the "store-and-forward" system described in the
next entry.
relay service
A "store-and-forward" system that manages the transmission of Groove-related content when
Groove users are not all online at the same time.
role
The assigned level of permissions a member has in a workspace. In Groove there are three roles:
Manager, Participant, and Guest.
spoofing
A technique used to gain unauthorized access to computers, where a person is able to fake
another's identity.
subnet
A portion of a network, which may be a physically independent network segment, and which
shares a network address with other portions of the network and is distinguished by a subnet
number.
suspended member
A workspace member for whom updates to workspace content are no longer being synchronized.
This member must receive and accept a new invitation to the workspace in order to resume
seeing synchronized content. See also "purge."
synchronization
Groove keeps workspace data synchronized among members by storing in a log file all changes
made by all members. Whenever members go online and use Groove, they receive all updates
via the log file, and the log file is cleared.
synchronization alert
A synchronization alert displays for a workspace if one or more members fail to synchronize
updated content for an extended period of time (typically, three weeks or longer). The
synchronization alert is intended to inform other members that a member has an increasingly
large amount of pending data updates, which may compromise the performance of data
synchronization in the workspace for all members.
tools
Tools are used in workspaces to perform tasks and share information.
toolset
224
Glossary
225
Index
A CSS Classes .............................................162
226
Index
Glossary ..................................................222 K
H Calendar ...............................................102
I L
227
Groove 2007 User's Guide
Links............................................................. Moving..........................................................
228
Index
229
Groove 2007 User's Guide
230
Index
U Workspaces...................................................
V chatting in ..............................................94
231
Groove 2007 User's Guide
232