|
Multiple instances of Venice can reside on one machine, but only one instance
of the same COM server can be registered. Therefore, only the Exact Venice
SDK of the last installed Venice is registered (by the setup). It's up to the
user to choose which instance of Venice will be used for the Exact Venice
SDK.
To register the SDK for a particular instance of Venice, logon in Windows as an
Administrator (or a user who has change rights in HKEY_LOCAL_MACHINE of the
registry). At a command prompt, make the Bin directory under the Venice System
directory the current. Run RegClSdk.exe and provide the alternative setting for
this instance of Venice. Example: 'RegClSdk Development'.
|
|
When using the Exact Venice SDK you can explicitly logon with a user
identifier, language, etc. or you can activate an
automatic logon.
In this case you provide for each PC and each user the data that can be used to
logon automatically. Especially for Scripting languages this is an interesting
feature because you don't have to provide a user identifier, language,
password, etc. in your script. This gives more security and lets your script
without any changes run on different PC's and by different users.
To enable this feature you logon in Windows as the Windows user who needs
automatic logon. Start Venice, choose 'Settings' - 'Configuration' – 'Development Kit'
in the Venice-button. This item is not visible if you haven't
registered the SDK in the previous step. Select 'Allow automatic logon' and
fill in the data to use to logon automatically. If the option 'Access
management' is enabled, only a valid Venice logon name (not a Windows name)
must be provided. Without this option, the initials, name and function of the
Venice user must be specified.
Even if automatic logon is enabled, it is still possible to logon explicitly
from the client application, but leaving the name (and password) parameters
empty will execute an automatic logon.
Leave the edit control for 'Profile configuration file' blank, it is an
advanced feature used in ASP (Application Service Provider) environments only.
Remark
|
|
|
There are several ways to hide passwords.
|
In the dialog of the module Users (option 'Access Management') in
your Venice installation, clear 'Logon with password' and specify a Windows
user that must be logged on. That way, only a username must be provided to
logon in an SDK application.
|
|
The SDK application can pop up a logon dialog and let the user
enter his name and password.
|
|
If an SDK application is started from within Venice, it is
possible to logon in the SDK application as the user currently logged on in
Venice.
|
|
|
|
|
If the SDK will be used in an ASP (Active Server Pages) Web application or a
Web Service, the SDK operates under the credentials of a system account (ASPNET
for instance). In other words, the SDK does NOT operate under the currently
logged on Windows user and the activation of the SDK for the CURRENT USER makes
no sense.
Therefore a special registry file is provided in the SDK directory
('ClSdkLM.reg') which must be edited and imported in HKEY_LOCAL_MACHINE. This
registry file consists of several sections:
|
|
section 1: |
This setting is normally initialized by the setup or by running
RegClSdk.exe in System\Bin.
|
section 2: |
This setting must be edited and imported if the SDK is running as a
service on an ASP (Application Service Provider) platform.
|
section 3: |
These settings must be edited and imported if the SDK is running as
a service to allow automatic logon in Venice if the Venice option 'Access
Management' is not installed.
|
section 4: |
These settings must be edited and imported if the SDK is running as
a service to allow automatic logon in Venice if the Venice option 'Access
Management' is installed.
|
section 5: |
When the SDK operates as a service, then special system accounts
are used. In order to recognize these accounts, the SDK maintains a list of all
known system accounts. Modify this list if your application uses a different
account. Make sure to separate each name with semicolons (;).
|
|
|
The '@' is used for remarks, remember to remove the '@' in front of each
setting you want to modify. After editing the registry file, double click it to
import it into the registry.
|