# Config::LotusNotes::Configuration - Represents one Lotus Notes/Domino configuration

- NAME
- VERSION
- SYNOPSIS
- DESCRIPTION
- PROPERTIES
- METHODS
- BUGS AND LIMITATIONS
- EXAMPLES
- LICENCE AND COPYRIGHT
- AUTOR

# NAME

Config::LotusNotes::Configuration - Represents one Lotus Notes/Domino configuration

# VERSION

This documentation refers to `Config::LotusNotes::Configuration` 0.31, released Feb 25, 2008.

# SYNOPSIS

      $factory = Config::LotusNotes->new();

      # access default installation
      $conf = $factory->default_configuration();

      # basic information about a configuration
      print "Version: ", $conf->version, "\n";
      print "This is a server.\n" if $conf->is_server;

      # getting and setting environment values
      $data = $conf->get_environment_value('Directory');
      $conf->set_environment_value('$NotesEnvParameter', 'value');

# DESCRIPTION

A `Config::LotusNotes::Configuration` object represents the configuration of a local Lotus Notes/Domino installation from the view of the file system. It lets you read and modify the Lotus Notes configuration file, notes.ini, where Notes stores its environment. See The Lotus Notes environment in the Config::LotusNotes manpage for more information on exchanging data with Lotus Notes via the Notes environment.

`Config::LotusNotes::Configuration` objects also give you access to some basic information like install paths and the Notes version number.

To create these objects, use the default_configuration() and all_configurations() methods of Config::LotusNotes.

# PROPERTIES

`notespath()`;

  Returns the path where the program files are stored.

`datapath()`;

  Returns the path where the data files are stored.

`notesini()`;

  Returns the full path (including file name) of the notes.ini file.

`version()`;

  Returns the Lotus Notes version number, e.g. 7.0 or 5.0.13a.

`is_client()`;

  Returns true if the configuration belongs to a client (workstation) installation.

`is_server()`;

  Returns true if the configuration belongs to a server installation.

# METHODS

new(path => $path);

  Constructor, returns a `Config::LotusNotes::Configuration` object representing the installation at the specified path.

  The recommended way to create `Config::LotusNotes::Configuration` objects is to use the default_configuration() and all_configurations() methods of Config::LotusNotes.

`get_environment_value($item_name)`;

  Gets the value of the parameter named `$item_name` from notes.ini. If there is no such parameter, `undef` is returned.

  In order to access values that were written by Lotus Notes via the environment functions, prefix the parameter name with "$".

set_environment_value($item_name, $value);

  Writes a parameter/value pair to notes.ini. If the entry exists, it will be updated with the new value. If the value is `undef`, the whole entry is removed.

  If you want the parameter to be accessible to Lotus Notes via the environment functions, prefix its name with "$".

  If you write to a notes.ini file with this function, its entries will be saved in random order.

# BUGS AND LIMITATIONS

See BUGS AND LIMITATIONS in the Config::LotusNotes manpage.

# EXAMPLES

See EXAMPLES in the Config::LotusNotes manpage.

# LICENCE AND COPYRIGHT

Copyright (C) 2006 HS - Hamburger Software GmbH & Co. KG. All rights reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

This library is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantibility or fitness for a particular purpose.

# AUTOR

Harald Albers, albers@cpan.org

See the Changes file for the change history.