Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Registration of the ProClaim components should be performed using the regsvr32.exe application provided with Windows, e.g.

Code Block
nonenone
linenumberstrue
regsvr32 WeaveProclaimLink.dll
regsvr32 WeaveMapLink.dll

...

The installation can be undone by using regsvr32 with the "/u" parameter, e.g.

true
Code Block
nonenonelinenumbers
regsvr32 /u WeaveProclaimLink.dll
regsvr32 /u WeaveMapLink.dll

...

Firstly the proclaim namespace must be added to the config.xml file header (or a separate proclaim.xml file can be created and included into config.xml)

true
Code Block
xmlxmllinenumbers
<?xml version="1.0" encoding="UTF-8"?>

<config xmlns="urn:com.cohga.server.config#1.0" xmlns:proclaim="urn:com.cohga.proclaim#1.0">
...
</config>

then the proclaim configuration must be setup to provide the connection information required for ProClaim and to tell Weave what entities to allow the transfer for.

true
Code Block
xmlxmllinenumbers
<?xml version="1.0" encoding="UTF-8"?>

<config xmlns="urn:com.cohga.server.config#1.0" xmlns:proclaim="urn:com.cohga.proclaim#1.0">

  <proclaim:config id="production">
    <datasourcename>DSN</datasourcename>
    <server>Server</server>
    <database>Database</database>
    <username>Username</username>
    <password>ENCSEMPKCCSFQTJBFMPABFJEBZJAKFCXGME</password>
    <from>Weave</from>
    <to>ProClaim</to>
    <entity id="property"/>
    <entity id="street"/>
  </proclaim:config>

</config>

...

Note

In the above example the password has been encrypted using encrypt osgi command.


Name

Description

datasourcename

The ODBC datasource (not an Weave data source) used to connect to the ProClaim database, possibly ‘ProClaim’ or ‘Protege’.
The value is determined by ProClaim, but you should be able to determine what it might be by looking at the ODBC Administrator on a client PC, where there should be a datasource (either system or user) defined that points to the relevant database.

server

The server that contains the ProClaim database, site specific machine name.
This is the host name of the server that is running the ProClaim database.
If using SQL Server this may require the instance name, for example SQLSERVER2008\SQLEXPRESS.
This is optional if the ODBC data source already specifies the server.

database

The name of the ProClaim database, possibly ‘ProClaim’ or ‘Protege’.
This is the name of a database that’s running on the server specified by proclaim.server.
This is optional if the ODBC data source already specifies the database name.

from

The ProClaim source application id, possibly 'Weave' or 'WEAVE'.
This is the application id that the Weave application is registered under in ProClaim.

to

The ProClaim destination application id.
This is the application id that the target ProClaim application is registered under in ProClaim.

username

The username to connect to the database.
This must be the userid of a valid account on the ProClaim database that has read access to the ProClaim configuration tables.

password

The password to connect to the database.
This is the password for the account specified by username.

entity

Each entity tag is a link between Weave and ProClaim

The 'entity' tags setup sources for data to send to ProClaim and targets for data sent from ProClaim.
When setting up a linkage in ProClaim to go from Weave to ProClaim the source entity should be set to the 'id' attribute of the entity tag.
When setting up a linkage in ProClaim to go from ProClaim to Weave the destination entity should be set to the 'id' attribute of the entity tag.

...

Once the server have been configured the ProClaim action can be added to a toolbar in the client configuration.

Code Block
xmlxml
linenumberstrue
<item action="com.cohga.proclaim.Send" version="production"/>

...

If you need to filter the values before sending them to ProClaim, because ProClaim uses different identifiers for the entity than Weave does, then you can specify a filter when seting up the entities in the config details and add the definition for the filter. Note the addition of the new xmlns:filter="urn:com.cohga.selection.filter#1.0" namespace.

true
Code Block
xmlxmllinenumbers
<?xml version="1.0" encoding="UTF-8"?>

<config xmlns="urn:com.cohga.server.config#1.0" xmlns:proclaim="urn:com.cohga.proclaim#1.0" xmlns:filter="urn:com.cohga.selection.filter#1.0">

  <proclaim:config id="production">
    <datasourcename>proclaim</datasourcename>
    <server>SQLSERVER2008\SQLEXPRESS</server>
    <database>ProProd</database>
    <username>proclaim</username>
    <password>ENCSEMPKCCSFQTJBFMPABFJEBZJAKFCXGME</password>
    <from>WEAVE</from>
    <to>CES</to>
    <entity id="property" filter="proclaim.production.property"/>
    <entity id="street"/>
  </proclaim:config>

  <filter:db id="proclaim.production.property">
    <datasource>proclaim</datasource>
    <table>GEMS_LINK</table>
    <keycolumn>PID</keycolumn> <!-- column used in spatial database -->
    <idcolumn>PRUPI</idcolumn> <!-- column required for proclaim -->
  </filter:db>

</config>

...

Only Direct Relation criteria type are currently supported.

Client Test Script

The following script can be saved to a file on a client PC as "proclaim.vbs" and run from a command prompt using "cscript proclaim.vbs" to test if the required components are installed and available

Code Block
languagevb
titleproclaim.vbs
on error resume next

dim o

set o = CreateObject("Weave.Link")
if o is nothing then
	WScript.Echo("Don't have Weave.Link")
else
	WScript.Echo("Have Weave.Link")
end if
set o = Nothing

set o = CreateObject("WeaveMapLink.WeaveMapAutomation")
if o is nothing then
	WScript.Echo("Don't have WeaveMapLink.WeaveMapAutomation")
else
	WScript.Echo("Have WeaveMapLink.WeaveMapAutomation")
end if
set o = Nothing

set o = CreateObject("WeaveProclaimLink.ProclaimFactory")
if o is nothing then
	WScript.Echo("Don't have WeaveProclaimLink.ProclaimFactory")
else
	WScript.Echo("Have WeaveProclaimLink.ProclaimFactory")
end if
set o = Nothing

set o = CreateObject("ProAppLink.Linkages")
if o is nothing then
	WScript.Echo("Don't have ProAppLink.Linkages")
else
	WScript.Echo("Have ProAppLink.Linkages")
end if
set o = Nothing


Code Block
languagetext
themeMidnight
titlecscript proclaim.vbs output
C:\temp>cscript proclaim.vbs
Microsoft (R) Windows Script Host Version 5.812
Copyright (C) Microsoft Corporation. All rights reserved.

Have Weave.Link
Have WeaveMapLink.WeaveMapAutomation
Have WeaveProclaimLink.ProclaimFactory
Have ProAppLink.Linkages