modules/Connectors/connectors/sources/ext/soap/hoovers/hoovers.php

Show: inherited
Table of Contents

Constants

Constant  HOOVERS_LOOKUP_MAPPING_FILE = 'custom/modules/Connectors/connectors/sources/ext/soap/hoovers/lookup_mapping.php'

\ext_soap_hoovers

Package:

ext_soap This class is the soap implementation for the connector framework.

Connectors that use SOAP calls should subclass this class and provide a getList and getItem method override to return results from the connector

Parent(s)
\ext_soap < \source

Properties

Propertyprotected  $_client= ''
inheritedInherited from: \ext_soap::$$_client
Details
Type
n/a
Inherited_from
\ext_soap::$$_client  
Propertyprotected  $_config= ''
inheritedInherited from: \source::$$_config\ext_soap::$$_config
Details
Type
n/a
Inherited_from
\source::$$_config  
Inherited_from
\ext_soap::$$_config  
Propertyprotected\_eapm  $_eapm= 'null'
inherited

The ExternalAPI Base that instantiated this connector.

Inherited from: \source::$$_eapm\ext_soap::$$_eapm
Default valuenullDetails
Type
\_eapm
Inherited_from
\source::$$_eapm  
Inherited_from
\ext_soap::$$_eapm  
Propertyprotectedbool  $_enable_in_admin_display= 'true'
inherited

enable_in_admin_display Boolean value marking whether or not this connector should appear in the Enable Connectors viewInherited from: \source::$$_enable_in_admin_display\ext_soap::$$_enable_in_admin_display
Default valuetrueDetails
Type
bool
Inherited_from
\source::$$_enable_in_admin_display  
Inherited_from
\ext_soap::$$_enable_in_admin_display  
Propertyprotectedbool  $_enable_in_admin_mapping= 'true'
inherited

enable_in_admin_mapping Boolean value marking whether or not this connector should be shown in the Modify Mapping viewInherited from: \source::$$_enable_in_admin_mapping\ext_soap::$$_enable_in_admin_mapping
Default valuetrueDetails
Type
bool
Inherited_from
\source::$$_enable_in_admin_mapping  
Inherited_from
\ext_soap::$$_enable_in_admin_mapping  
Propertyprotectedbool  $_enable_in_admin_properties= 'true'
inherited

enable_in_admin_properties Boolean value marking whether or not this connector should appear in the Set Connector Properties viewInherited from: \source::$$_enable_in_admin_properties\ext_soap::$$_enable_in_admin_properties
Default valuetrueDetails
Type
bool
Inherited_from
\source::$$_enable_in_admin_properties  
Inherited_from
\ext_soap::$$_enable_in_admin_properties  
Propertyprotectedbool  $_enable_in_admin_search= 'true'
inherited

enable_in_admin_search Boolean value marking whether or not this connector should appear in the Manage Connector Search viewInherited from: \source::$$_enable_in_admin_search\ext_soap::$$_enable_in_admin_search
Default valuetrueDetails
Type
bool
Inherited_from
\source::$$_enable_in_admin_search  
Inherited_from
\ext_soap::$$_enable_in_admin_search  
Propertyprotectedbool  $_enable_in_hover= 'false'
inherited

enable_in_hover Boolean value marking whether or not a hover link could be applied to the connectorInherited from: \source::$$_enable_in_hover\ext_soap::$$_enable_in_hover
Default valuefalseDetails
Type
bool
Inherited_from
\source::$$_enable_in_hover  
Inherited_from
\ext_soap::$$_enable_in_hover  
Propertyprotectedbool  $_enable_in_wizard= 'true'
inherited

enable_in_wizard Boolean value marking whether or not the connector may appear in the wizard (Get Data) viewsInherited from: \source::$$_enable_in_wizard\ext_soap::$$_enable_in_wizard
Default valuetrueDetails
Type
bool
Inherited_from
\source::$$_enable_in_wizard  
Inherited_from
\ext_soap::$$_enable_in_wizard  
Propertyprotected  $_field_defs= ''
Details
Type
n/a
Inherited_from
\source::$$_field_defs  
Inherited_from
\ext_soap::$$_field_defs  
Propertyprotectedbool  $_has_testing_enabled= 'false'
inherited

has_testing_enabled Boolean value marking whether or not the connector should display the test button in administration viewInherited from: \source::$$_has_testing_enabled\ext_soap::$$_has_testing_enabled
Default valuefalseDetails
Type
bool
Inherited_from
\source::$$_has_testing_enabled  
Inherited_from
\ext_soap::$$_has_testing_enabled  
Propertyprivate  $_lookupMap= 'array()'
Default valuearray()Details
Type
n/a
Propertyprotected  $_mapping= ''
inheritedInherited from: \source::$$_mapping\ext_soap::$$_mapping
Details
Type
n/a
Inherited_from
\source::$$_mapping  
Inherited_from
\ext_soap::$$_mapping  
Propertyprotected  $_required_config_fields= 'array()'
Default valuearray()Details
Type
n/a
Inherited_from
\source::$$_required_config_fields  
Inherited_from
\ext_soap::$$_required_config_fields  
Propertyprotected  $_required_config_fields_for_button= 'array()'
Default valuearray()Details
Type
n/a
Inherited_from
\source::$$_required_config_fields_for_button  
Inherited_from
\ext_soap::$$_required_config_fields_for_button  
Propertyprivate  $_soapHeader= ''
Details
Type
n/a
Propertyprotected  $config_decrypted= 'false'
Default valuefalseDetails
Type
n/a
Inherited_from
\source::$$config_decrypted  
Inherited_from
\ext_soap::$$config_decrypted  
Propertypublic  $wrapperName= ''
inherited

The name of an wrapper to use if the class wants to provide an override

Inherited from: \source::$$wrapperName\ext_soap::$$wrapperName
Details
Type
n/a
Inherited_from
\source::$$wrapperName  
Inherited_from
\ext_soap::$$wrapperName  

Methods

methodpublic__call(  $function,  $args ) : void

__call

Parameters
Name Type Description
$function
$args
methodpublic__construct( ) : void

methodpublic__destruct( ) : void
inherited

Default destructor

Inherited from: \source::__destruct()\ext_soap::__destruct()
methodprivatecreatePayloadOverride(  $function,  $args ) : void

createPayloadOverride

Parameters
Name Type Description
$function
$args
methodpublicfilterAllowedModules( array $moduleList ) : array
inherited

Filter which modules are allowed to connect

Inherited from: \source::filterAllowedModules()\ext_soap::filterAllowedModules()
Parameters
Name Type Description
$moduleList array
Returns
Type Description
array Allowed modules
methodprivateformatListResult( Array $data ) : Array

formatListResult This is a private helper function to ensure that list results are correctly matched to the vardef key entries

Parameters
Name Type Description
$data Array

data entry for list result from parseListResult function

Returns
Type Description
Array formatted data entry with the correct vardef keys
methodpublicgetConfig( ) : void
inherited

Inherited from: \source::getConfig()\ext_soap::getConfig()
methodpublicgetEAPM( ) : void
inherited

Inherited from: \source::getEAPM()\ext_soap::getEAPM()
methodpublicgetFieldDefs( ) : void
methodpublicgetFieldsWithParams( string $param_name, string $param_value ) : array
inherited

Given a parameter in a vardef field, return the list of fields that match the param and value

Inherited from: \source::getFieldsWithParams()\ext_soap::getFieldsWithParams()
Parameters
Name Type Description
$param_name string
$param_value string
Returns
Type Description
array
methodpublicgetItem( \$args $args = array(), \$module $module = null ) : \$result

getItem This is the Hoovers implementation of the getItem method

Parameters
Name Type Description
$args \$args

Array of input/search parameters

$module \$module

String value of the module we are mapping input arguments from

Returns
Type Description
\$result Array of result based on the search results from the given arguments
methodpublicgetList( \$args $args = array(), \$module $module = null ) : \$result

getList This is the Hoovers implementation of the getList method

Parameters
Name Type Description
$args \$args

Array of input/search parameters

$module \$module

String value of the module we are mapping input arguments from

Returns
Type Description
\$result Array of results based on the search results from the given arguments
methodprivategetLookupValue( String $category = '', String $value = '' ) : String

getLookupValue This method returns the lookup value used by Hoovers based on the mapping file of the search parameters created

Parameters
Name Type Description
$category String

String value of the category (countries, states)

$value String

String value of the value to lookup

Returns
Type Description
String $lookupValue String value that should be used for lookup
methodpublicgetMapping( ) : void
methodpublicgetOriginalMapping( ) : void
methodpublicgetProperties( ) : void
methodpublicgetProperty(  $name ) : void
Parameters
Name Type Description
$name
methodpublicgetRequiredConfigFields( ) : \$fields
inherited

getRequiredConfigFields This method returns an Array of the configuration keys that are required for the Connector.

Inherited from: \source::getRequiredConfigFields()\ext_soap::getRequiredConfigFields()

Subclasses should set the class variable _required_config_fields to return an Array of keys as specified in the Connector's config.php that are required.

Returns
Type Description
\$fields Array of Connector config fields that are required
methodpublicgetRequiredConfigFieldsForButton( ) : \$fields
inherited

getRequiredConfigFieldsForButton This method returns an Array of the configuration keys that are required before the "Get Data" button will include the Connector. We use it as a subset of the $this->_required_config_fields Array.

Inherited from: \source::getRequiredConfigFieldsForButton()\ext_soap::getRequiredConfigFieldsForButton()
Returns
Type Description
\$fields Array of Connector config fields that are required to be set for the "Get Data" button to appear
methodpublichasTestingEnabled( ) : \enabled
inherited

hasTestingEnabled This method is used to indicate whether or not a data source has testing enabled so that the administration interface may call the test method on the data source instance

Inherited from: \source::hasTestingEnabled()\ext_soap::hasTestingEnabled()
Returns
Type Description
\enabled boolean value indicating whether or not testing is enabled
methodpublicinit( ) : void

methodpublicinitConfig( ) : void
inherited

Initialize config - decrypt encrypted fields

Inherited from: \source::initConfig()\ext_soap::initConfig()
methodprotectedinitLookupMap( ) : void

methodpublicisEnabledInAdminDisplay( ) : boolean
inherited

isEnabledInAdminDisplay This method indicates whether or not the connector should be shown in the Enable Connectors view.

Inherited from: \source::isEnabledInAdminDisplay()\ext_soap::isEnabledInAdminDisplay()

The Admin views call each source's isEnabledInAdminDisplay method to verify whether or not the connector should be displayed. Connectors that do not have any administrative display settings should set the protected class variable _enable_in_admin_display to false.

Returns
Type Description
boolean value indicating whether or not the connector is enabled for admin views
methodpublicisEnabledInAdminMapping( ) : boolean
inherited

isEnabledInAdminMapping This method indicates whether or not the connector should be shown in the Map Connector Fields view.

Inherited from: \source::isEnabledInAdminMapping()\ext_soap::isEnabledInAdminMapping()

The Admin views call each source's isEnabledInAdminMapping method to verify whether or not the connector should be displayed. Connectors that do not have any administrative mapping properties should set the protected class variable _enable_in_admin_mapping to false.

Returns
Type Description
boolean value indicating whether or not the connector is enabled for admin views
methodpublicisEnabledInAdminProperties( ) : boolean
inherited

isEnabledInAdminProperties This method indicates whether or not the connector should be shown in the Set Connector Properties view.

Inherited from: \source::isEnabledInAdminProperties()\ext_soap::isEnabledInAdminProperties()

The Admin views call each source's isEnabledInAdminProperties method to verify whether or not the connector should be displayed. Connectors that do not have any administrative properties should set the protected class variable _enable_in_admin_properties to false.

Returns
Type Description
boolean value indicating whether or not the connector is enabled for admin views
methodpublicisEnabledInAdminSearch( ) : boolean
inherited

isEnabledInAdminSearch This method indicates whether or not the connector should be shown in the Manage Connectors Search view.

Inherited from: \source::isEnabledInAdminSearch()\ext_soap::isEnabledInAdminSearch()

The Admin views call each source's isEnabledInAdminSearch method to verify whether or not the connector should be displayed. Connectors that do not have any administrative search settings should set the protected class variable _enable_in_admin_search to false.

Returns
Type Description
boolean value indicating whether or not the connector is enabled for admin views
methodpublicisEnabledInHover( ) : \$enabled
inherited

isEnabledInHover This method indicates whether or not the connector should be enabled for the hover links Connectors that do not provide a formatter implementation should not set the protected class variable _enable_in_hover to true.

Inherited from: \source::isEnabledInHover()\ext_soap::isEnabledInHover()
Returns
Type Description
\$enabled boolean variable indicating whether or not the connector is enabled for the hover links
methodpublicisEnabledInWizard( ) : \$enabled
inherited

isEnabledInWizard This method indicates whether or not the connector should be enabled in the wizard Connectors that do not support the getList/getItem methods via API calls should set the protected class variable _enable_in_wizard to false.

Inherited from: \source::isEnabledInWizard()\ext_soap::isEnabledInWizard()
Returns
Type Description
\$enabled boolean variable indicating whether or not the connector is enabled for the wizard
methodpublicisRequiredConfigFieldsForButtonSet( ) : \$set
inherited

isRequiredConfigFieldsForButtonSet This method checks the configuration parameters against the required config fields for the "Get Button" to see if they are set

Inherited from: \source::isRequiredConfigFieldsForButtonSet()\ext_soap::isRequiredConfigFieldsForButtonSet()
Returns
Type Description
\$set boolean value indicating whether or not the required config fields are set
methodpublicisRequiredConfigFieldsSet( ) : \$set
inherited

isRequiredConfigFieldsSet This method checks the configuration parameters against the required config fields to see if they are set

Inherited from: \source::isRequiredConfigFieldsSet()\ext_soap::isRequiredConfigFieldsSet()
Returns
Type Description
\$set boolean value indicating whether or not the required config fields are set
methodpublicloadConfig( ) : void
inherited

Load config.php for this source

Inherited from: \source::loadConfig()\ext_soap::loadConfig()
methodpublicloadMapping( ) : void
methodpublicloadVardefs( ) : void
inherited

Load source's vardef file

Inherited from: \source::loadVardefs()\ext_soap::loadVardefs()
methodprotectedlog( string $log_data ) : void
inherited

Allow data sources to log information

Inherited from: \source::log()\ext_soap::log()
Parameters
Name Type Description
$log_data string
methodpublicobj2array( \$obj $obj ) : \$out
inherited

obj2array Given an object, returns the object as an Array

Inherited from: \ext_soap::obj2array()
Parameters
Name Type Description
$obj \$obj

Object to convert to an array

Returns
Type Description
\$out Array reflecting the object's properties
methodprivateparseListResults( \$result $result ) : \$result

parseListResults Internal private method to handle distinguishing the Hoovers SOAP call results.

There are subtle differences when one company result is returned versus multiple company results.

Parameters
Name Type Description
$result \$result

Array of results in list format

Returns
Type Description
\$result Formatted results
methodpublicpropertyExists( string $name ) : bool
inherited

Check if certain property contains non-empty value

Inherited from: \source::propertyExists()\ext_soap::propertyExists()
Parameters
Name Type Description
$name string
Returns
Type Description
bool
methodpublicsaveConfig( ) : void
inherited

Save source's config to custom directory

Inherited from: \source::saveConfig()\ext_soap::saveConfig()
methodpublicsaveMappingHook(  $mapping ) : void
Parameters
Name Type Description
$mapping
methodpublicsetClient( object $client ) : void

Set client implementation for tests

Parameters
Name Type Description
$client object
methodpublicsetConfig(  $config ) : void
inherited

Inherited from: \source::setConfig()\ext_soap::setConfig()
Parameters
Name Type Description
$config
methodpublicsetEAPM(  $eapm ) : void
inherited

Inherited from: \source::setEAPM()\ext_soap::setEAPM()
Parameters
Name Type Description
$eapm
methodpublicsetMapping(  $mapping ) : void
Parameters
Name Type Description
$mapping
methodpublicsetProperties(  $properties = array() ) : void
Parameters
Name Type Description
$properties
methodpublictest( ) : boolean

test This method is called from the administration components to make a live test call to see if the configuration and connections are available

Returns
Type Description
boolean result of the test call false if failed, true otherwise
Documentation was generated by DocBlox 0.18.1.