Broadworks::OCIP - API for communication with Broadworks OCI-P Interface
version 0.09
use Broadworks::OCIP; my $ocip = Broadworks::OCIP->new(params); my $res = $ocip->SystemSoftwareVersionGetRequest();
Broadworks::OCIP is a perl interface to the Broadworks OCI-P Provisioning interface. The functions provided reflect the AS OCI-P. The methods supported are documented in the Broadworks::OCIP::Methods module, which is autogenerated from the Broadworks schemas.
The host that is being connected to - either a host name or an IP address.
The username to authenticate with on the remote system.
An authentication hash to use for authenticating the username. Alternatively the password attribute can be set and this is transformed into an appropriate authhash (and the password deleted).
Broadworks version - currently defaults to 17sp4.
17sp4
The character set to use - currently defaults to ISO-8859-1.
ISO-8859-1
A character set encoder - uses an instance of Encode returned by "find_encoding" in Encode.
The protocol to implement - always OCI.
OCI
The port number to connect to - default 2208.
2208
The target to connect to - consists of the host and port linked by a colon.
The timeout within the connection in seconds - defaults to 8 can be changed during the session.
8
The connection socket - automatically set.
A select object on the connection socket.
The session identifier for the session - defaults to a Data::UUID string.
Are we authenticated. Checking this forces authentication. If authentication fails then we throw an exception.
The last sent XML document.
Are we tracing. If this is true then we output sent and received data to STDERR.
Standard Moose BUILDARGS function. If a single argument is passed this is treated as a config filename (opened with Config::Any) if it is a scalar, or assumed to be a hash reference, which is expanded up.
BUILDARGS
If a config filename is passed this is opened, and any Broadworks::OCIP is taken as the overall config.
Broadworks::OCIP
Any password attribute is removed from the config and an authhash is put in its place. This means dumping the object will not reveal the password.
password
Sends an XML document to the Broadworks remote over the socket. Convert the passed string to the correct character set.
Receive an XML response from the Broadworks remote over the socket. Decode the received string and pass to the Broadworks::OCIP::Response constructor.
Builds an XML command document from the command passed and the parameters (which are passed as an array ref of pairs).
When the document has been created it is send using the send method.
Sends an XML command to the Broadworks remote over the socket, and receives and passes back the expected response document. Throws an exception if the reply type is returned.
Sends an XML command to the Broadworks remote over the socket, and receives and passes back the expected SuccessResponse document. An exception is not thrown if the wrong reply type is returned, however the status_ok attribute should be checked for this.
SuccessResponse
status_ok
On object destruction, if the system has authenticated, sends a LogoutRequest command and then tears down the socket connection.
LogoutRequest
Nigel Metheringham <Nigel.Metheringham@redcentricplc.com>
Copyright 2014-2020 Recentric Solutions Limited. All rights reserved.
Nigel Metheringham <nigelm@cpan.org>
This software is copyright (c) 2020 by Nigel Metheringham.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Broadworks::OCIP, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Broadworks::OCIP
CPAN shell
perl -MCPAN -e shell install Broadworks::OCIP
For more information on module installation, please visit the detailed CPAN module installation guide.