- Use the get(), add(),
delete(), and update()
methods to manipulate Address Manager entities. This example shows the
addition of a new configuration with a shared
network:
# Add a new configuration with a shared network my $configuration = APIEntity->new( "id" => 0, "name" => "Test Configuration", "type" => ObjectTypes::Configuration, "properties" => ObjectProperties::sharedNetwork."=".$existingSharedNetwork1-> get_id()."|" ); my $configurationId = $service->addEntity( SOAP::Data->type( 'long' )-> name( 'parentId' )-> value( 0 )-> attr({xmlns => ''}), SOAP::Data->type( 'APIEntity' )->name( 'entity' )-> value( $configuration )-> attr({xmlns => ''}) )-> result; print "New Configuration id = ".$configurationId.->get_id()."\n";
- Use the getUserDefinedFields() method to find the
user-defined fields with their settings and values in Address Manager. For
example:
my @udfs= $service->getUserDefinedFields( SOAP::Data->type( 'string' )->name( 'type' )->value( ObjectTypes::Device )->attr({xmlns => ''}), SOAP::Data->type( 'boolean' )->name( 'requiredFieldsOnly' )->value( 'false' ) ->attr({xmlns => ''}) ) ->valueof('//getUserDefinedFieldsResponse/return/item'); print"number of fields=".@udfs."\n"; for my $eachUDF ( @udfs ) { my $udf = BAMConnection->blessAPIUserDefinedField( "object" => $eachUDF ); print"Object----------------------\n"; print $udf->get_name()."\n"; print "Name=".$udf->get_name()."\n"; print "DisplayName=".$udf->get_displayName()."\n"; print "Type=".$udf->get_type()."\n"; print "defaultValue=".$udf->get_defaultValue()."\n"; print "Validator Properties=".$udf->get_validatorProperties()."\n"; print "PredefinedValues=".$udf->get_predefinedValues()."\n"; print "Required=".$udf->get_required()."\n"; print "Hide from search=".$udf->get_hideFromSearch()."\n"; print "Radio=".$udf->get_renderAsRadioButton()."\n"; }
For almost all object types, the add() and most get() methods require parentID, which is the ID of the parent object. The following objects can take 0 (zero) as the parentID: Configuration, TagGroup, User, UserGroup, and Authenticator.