Using XML to Configure Groove

Using XML to Configure Groove
by Brian Buehling | Pages: 1, 2, 3

What follows are descriptions of each of the XML configuration files required to inject the XML Example tool into the Groove environment.

Injector File: XMLExample.grv

Although injector files can be used for other purposes, such as sending invitations to shared workspaces, XMLExample.grv (shown below) is configured to provide all of the information necessary to inject the XML Example tool into a user account. This file is interpreted by Groove and identified as tool message through the MessageType attribute of the MessageHeader element. Its main objective is to pass the appropriate tool TemplateDescriptorURL to Groove, by pointing to the tool's OSD file as shown in bold below.

Groove Injector File -- XMLExample.grv

<?xml version='1.0'?>
<?groove.net version='1.0'?>
<g:fragment
xmlns:g="urn:groove.net">

<g:InjectorWrapper
  AccountGUID="grooveIdentity:///DefaultIdentity"
  MessageID="d7g4v4pbmpqdu2wk6bs3hsvqsx4meamiwtk6s7c"
  ResourceURL="grooveIdentityMessage:///ToolMessage;Version=3,0,0,0"
  LocalDeviceURLs="Injector">
   
  <g:IdentityMessageHeader>
    <g:MessageHeader MessageType="ToolMessage"
      MessageID="d7g4v4pbmpqdu2wk6bs3hsvqsx4meamiwtk6s7c"
      Version="1,0,0,0" CreateTime="9/24/00 7:41 PM"
      CreatorDeviceURL="dpp://friends.groove.net/0sGnePZSnu-AY-fe
PpNqEqzwSOPo9910">
           
      <g:SenderContact/>
      <g:RecipientContact/>
    </g:MessageHeader>
    <g:MessageBody BodyName="MessageBody">
      <g:ToolMessage>
        <g:ToolMessageHeader
           ToolURL="grooveAccountTool:;CategoryName=grooveToolCategory://
Account/ToolTemplateList,ComponentName=ToolTemplateList"/>
        <g:ToolMessageBody>
                   
          <g:TemplateDescriptorList>
            <g:TemplateDescriptorURL
              URL="http://www.dakotasystems.net/Groove/XMLExample/
XMLExample.osd?Package=net.dakotasystems.Groove.XMLExample.XMLExample_
XML&amp;Version=0&amp;Factory=Open"/>
          </g:TemplateDescriptorList>
        </g:ToolMessageBody>
      </g:MessageBody>
    </g:ToolMessage>
  </g:IdentityMessageHeader>
</g:InjectorWrapper>
</g:fragment>

Once users click on the XMLExample.grv file, Groove follows the TemplateDescriptorURL to access XMLExample.osd, which is used to find the tool description (XMLExample.xml). Groove then registers the tool in the current user account, as shown below.

Figure 1. Registering the tool in the current user account

Pages: 1, 2, 3

Next Page