Class KuwaibaSoapWebServiceImpl
- java.lang.Object
-
- org.neotropic.kuwaiba.northbound.ws.KuwaibaSoapWebServiceImpl
-
- All Implemented Interfaces:
KuwaibaSoapWebService
@Service public class KuwaibaSoapWebServiceImpl extends Object implements KuwaibaSoapWebService
SOAP-based web service implementation.- Author:
- Charles Edward Bedon Cortazar <charles.bedon@kuwaiba.org>
-
-
Constructor Summary
Constructors Constructor Description KuwaibaSoapWebServiceImpl()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description String
addIPAddress(String id, String parentClassName, List<StringPair> attributesToBeUpdated, String sessionId)
Adds an IP address to a Subnetvoid
addObjectsToFavoritesFolder(String[] objectClass, String[] objectId, long favoritesFolderId, long userId, String sessionId)
Associates a list of objects to an existing favorites foldervoid
addPossibleChildren(String parentClassName, String[] childrenToBeAdded, String sessionId)
Adds possible children to a given class using its name as argument.void
addPossibleChildrenForClassWithId(long parentClassId, long[] newPossibleChildren, String sessionId)
Adds possible children to a given class using its id as argument.void
addPossibleSpecialChildren(String parentClassName, String[] possibleSpecialChildren, String sessionId)
Adds special possible children to a given class using its name.void
addPossibleSpecialChildrenWithId(long parentClassId, long[] possibleSpecialChildren, String sessionId)
Adds possible special children to a given class using its id as argument.void
addUserToGroup(long userId, long groupId, String sessionId)
Adds a user to a groupvoid
associateObjectsToContract(String[] objectClass, String[] objectId, String contractClass, String contractId, String sessionId)
Associates a list of objects (instances of a subclass of InventoryObject) to an existing contract (most probably a support contract)void
associateObjectToProxy(String objectClass, String objectId, String proxyClass, String proxyId, String sessionId)
Associates an inventory object to an inventory proxy.void
associatePhysicalNodeToWarehouse(String objectClass, String objectId, String warehouseClass, String warehouseId, String sessionId)
Associates an object (a resource) to an existing warehouse or virtual warehousevoid
associatesPhysicalNodeToWarehouse(String[] objectClass, String[] objectId, String warehouseClass, String warehouseId, String sessionId)
Associates a list of objects (resources) to an existing warehouse or virtual warehouselong
attachFileToObject(String name, String tags, byte[] file, String className, String objectId, String sessionId)
Attaches a file to an inventory objectString
bulkUpload(byte[] file, int commitSize, int dataType, String sessionId)
Creates many objects at once given a well formatted file.void
closeSession(String sessionId)
Closes a sessionvoid
commitActivity(String processInstanceId, String activityDefinitionId, RemoteArtifact artifact, String sessionId)
Saves the artifact generated once an activity has been completed (for example, the user filled in a form).void
connectMirrorMultiplePort(String aObjectClass, String aObjectId, List<String> bObjectClasses, List<String> bObjectIds, String sessionId)
Connect two ports using a mirrorMultiple relationshipvoid
connectMirrorPort(String[] aObjectClass, String[] aObjectId, String[] bObjectClass, String[] bObjectId, String sessionId)
Connect two ports using a mirror relationshipvoid
connectMplsLink(String[] sideAClassNames, String[] sideAIds, String[] linksIds, String[] sideBClassNames, String[] sideBIds, String sessionId)
Connect a given mpls links with a given ports for every sidevoid
connectPhysicalContainers(String[] sideAClassNames, String[] sideAIds, String[] containersClassNames, String[] containersIds, String[] sideBClassNames, String[] sideBIds, String sessionId)
Connects pairs of elements (of any class except subclasses of GenericPort) using containers (subclasses of GenericPhysicalContainer)void
connectPhysicalLinks(String[] sideAClassNames, String[] sideAIds, String[] linksClassNames, String[] linksIds, String[] sideBClassNames, String[] sideBIds, String sessionId)
Connects pairs of ports (if they are not connected already) using physical linkString[]
copyObjects(String targetClass, String targetOid, String[] objectClasses, String[] objectOids, boolean recursive, String sessionId)
Copy objects from its current parent to a target.void
copyPoolItemToPool(String poolId, String poolItemClassName, String poolItemId, boolean recursive, String sessionId)
Copy a pool item from a pool to another poolString[]
copySpecialObjects(String targetClass, String targetOid, String[] objectClasses, String[] objectOids, boolean recursive, String sessionId)
Copy special objects from its current parent to a target.void
copySyncDataSourceConfiguration(long syncGroupId, long[] syncDataSourceConfigurationIds, String sessionId)
Creates "copy" a relation between a set of sync data source configurations and a given sync groupString[]
copyTemplateElements(String[] sourceObjectsClassNames, String[] sourceObjectsIds, String newParentClassName, String newParentId, String sessionId)
Copy template elements within templates.String[]
copyTemplateSpecialElements(String[] sourceObjectsClassNames, String[] sourceObjectsIds, String newParentClassName, String newParentId, String sessionId)
Copy template special elements within templates.String
createActivity(String projectId, String projectClass, String activityClass, String[] attributeNames, String[] attributeValues, String sessionId)
Creates an Activity inside a project.void
createAttribute(String className, String name, String displayName, String type, String description, boolean administrative, boolean visible, boolean isReadOnly, boolean noCopy, boolean unique, boolean mandatory, boolean multiple, int order, String sessionId)
Adds an attribute to a class using its name as key to find it.void
createAttributeForClassWithId(long ClassId, String name, String displayName, String type, String description, boolean administrative, boolean visible, boolean readOnly, boolean noCopy, boolean unique, boolean mandatory, boolean multiple, int order, String sessionId)
Adds an attribute to a class using its id as key to find it.String[]
createBulkObjects(String className, String parentClassName, String parentOid, String namePattern, String templateId, String sessionId)
Creates multiple objects using a given name patternString[]
createBulkSpecialObjects(String className, String parentClassName, String parentId, String namePattern, String templateId, String sessionId)
Creates multiple special objects using a given naming patternString[]
createBulkSpecialTemplateElement(String stElementClass, String stElementParentClassName, String stElementParentId, String stElementNamePattern, String sessionId)
Creates multiple special template elements using a given name patternString[]
createBulkTemplateElement(String templateElementClassName, String templateElementParentClassName, String templateElementParentId, String templateElementNamePattern, String sessionId)
Creates multiple template elements using a given name patternlong
createBusinessRule(String ruleName, String ruleDescription, int ruleType, int ruleScope, String appliesTo, String ruleVersion, List<String> constraints, String sessionId)
Creates a business rule given a set of constraintslong
createClass(String className, String displayName, String description, boolean isAbstract, boolean isCustom, boolean isCountable, boolean isInDesign, String parentClassName, byte[] icon, byte[] smallIcon, int color, String sessionId)
Creates a class metadata object.long
createClassLevelReport(String className, String reportName, String reportDescription, String script, int outputType, boolean enabled, String sessionId)
Creates a class level report (a report that will be available for all instances of a given class -and its subclasses-)long
createConfigurationVariable(String configVariablesPoolId, String name, String description, int type, boolean masked, String valueDefinition, String sessionId)
Creates a configuration variable inside a pool.String
createConfigurationVariablesPool(String name, String description, String sessionId)
Creates a pool of configuration variables.String
createContact(String contactClass, List<StringPair> properties, String customerClassName, String customerId, String sessionId)
Creates a contactString
createContract(String poolId, String contractClass, String[] attributeNames, String[] attributeValues, String sessionId)
Creates a contract.String
createContractPool(String poolName, String poolDescription, String poolClass, String sessionId)
Creates a contract pool.String
createCustomer(String poolId, String customerClass, String[] attributeNames, String[] attributeValues, String sessionId)
Creates a customerString
createCustomerPool(String poolName, String poolDescription, String sessionId)
Creates a Customer Poollong
createFavoritesFolderForUser(String favoritesFolderName, long userId, String sessionId)
Creates a favorites folder for User.long
createGeneralView(String viewClass, String name, String description, byte[] structure, byte[] background, String sessionId)
Creates a general view (a view that is not associated to any object)long
createGroup(String groupName, String description, List<Long> users, String sessionId)
Creates a grouplong
createInventoryLevelReport(String reportName, String reportDescription, String script, int outputType, boolean enabled, List<StringPair> parameters, String sessionId)
Creates an inventory level report (a report that is not tied to a particlar instance or class.String
createListTypeItem(String className, String name, String displayName, String sessionId)
Creates a list type itemlong
createListTypeItemRelatedView(String listTypeItemId, String listTypeItemClassName, String viewClassName, String name, String description, byte[] structure, byte[] background, String sessionId)
Creates a view for a given list type item.String
createMPLSLink(String classNameEndpointA, String idEndpointA, String classNameEndpointB, String idEndpointB, List<StringPair> attributesToBeSet, String sessionId)
Creates an MPLS linkString
createObject(String className, String parentObjectClassName, String parentOid, String[] attributeNames, String[] attributeValues, String templateId, String sessionId)
Creates a business objectlong
createObjectRelatedView(String objectId, String objectClass, String name, String description, String viewClassName, byte[] structure, byte[] background, String sessionId)
Creates a view an relates it to an existing objectlong
createOSPView(String name, String description, byte[] content, String sessionId)
Creates an Outside Plant ViewString
createPhysicalConnection(String aObjectClass, String aObjectId, String bObjectClass, String bObjectId, String name, String connectionClass, String templateId, String sessionId)
Creates a physical connection (a container or a link).String[]
createPhysicalConnections(String[] aObjectClasses, String[] aObjectIds, String[] bObjectClasses, String[] bObjectIds, String name, String connectionClass, String templateId, String sessionId)
Creates a physical connection (a container or a link).String
createPoolInObject(String parentClassname, String parentId, String name, String description, String instancesOfClass, int type, String sessionId)
Creates a pool that will have as parent an inventory object.String
createPoolInPool(String parentId, String name, String description, String instancesOfClass, int type, String sessionId)
Creates a pool that will have as parent another pool.String
createPoolInWarehouse(String warehouseClass, String warehouseId, String poolName, String poolDescription, String instancesOfClass, String sessionId)
Creates a spare poolString
createPoolItem(String poolId, String className, String[] attributeNames, String[] attributeValues, String templateId, String sessionId)
Creates an object within a poolString
createProcessDefinition(String name, String description, String version, boolean enabled, byte[] structure, String sessionId)
Creates a process definition.String
createProcessInstance(String processDefinitionId, String processInstanceName, String processInstanceDescription, String sessionId)
Creates an instance of a process, that is, starts oneString
createProject(String projectPoolId, String projectClass, String[] attributeNames, String[] attributeValues, String sessionId)
Creates a Project.String
createProjectPool(String poolName, String poolDescription, String poolClass, String sessionId)
Creates a project pool.String
createProxy(String proxyPoolId, String proxyClass, List<StringPair> attributes, String sessionId)
Creates an inventory proxy.String
createProxyPool(String name, String description, String sessionId)
Creates a proxy pool.long
createQuery(String queryName, long ownerOid, byte[] queryStructure, String description, String sessionId)
Creates a query using the Graphical Query BuilderString
createRootPool(String name, String description, String instancesOfClass, int type, String sessionId)
Creates a pool without a parent.String
createSDHContainerLink(String classNameEndpointA, String idEndpointA, String classNameEndpointB, String idEndpointB, String linkType, List<RemoteSDHPosition> positions, String defaultName, String sessionId)
Creates an SDH container link (VCX).String
createSDHTransportLink(String classNameEndpointA, String idEndpointA, String classNameEndpointB, String idEndpointB, String linkType, String defaultName, String sessionId)
Creates an SDH transport link (STMX)String
createSDHTributaryLink(String classNameEndpointA, String idEndpointA, String classNameEndpointB, String idEndpointB, String linkType, List<RemoteSDHPosition> positions, String defaultName, String sessionId)
Creates an SDH tributary link (VCXTributaryLink)String
createService(String poolId, String serviceClass, String[] attributeNames, String[] attributeValues, String sessionId)
Creates a serviceString
createServicePool(String customerClass, String customerId, String poolName, String poolDescription, String sessionId)
Creates a Service PoolRemoteSession
createSession(String username, String password, int sessionType)
Creates a session.String
createSparePart(String poolId, String poolClass, String[] attributeNames, String[] attributeValues, String templateId, String sessionId)
Creates a spare partString
createSpecialObject(String className, String parentObjectClassName, String parentOid, String[] attributeNames, String[] attributeValues, String templateId, String sessionId)
Creates a special business object.String
createSubnet(String poolId, String className, List<StringPair> attributes, String sessionId)
Creates a subnetString
createSubnetPool(String parentId, String subnetPoolName, String subnetPoolDescription, String className, String sessionId)
Creates a pool of subnets if the parentId is -1 the pool will be created in the default root for pools of subnetslong
createSynchronizationDataSourceConfig(String objectId, long syncGroupId, String name, List<StringPair> parameters, String sessionId)
Creates a Synchronization Data Source Configuration.long
createSynchronizationGroup(String name, String sessionId)
Creates a Synchronization Group.long
createTask(String name, String description, boolean enabled, boolean commitOnExecute, String script, List<StringPair> parameters, RemoteTaskScheduleDescriptor schedule, RemoteTaskNotificationDescriptor notificationType, String sessionId)
Creates and schedule a task.String
createTemplate(String templateClass, String templateName, String sessionId)
Creates a template.String
createTemplateElement(String templateElementClass, String templateElementParentClassName, String templateElementParentId, String templateElementName, String sessionId)
Creates an object inside a template.String
createTemplateSpecialElement(String tsElementClass, String tsElementParentClassName, String tsElementParentId, String tsElementName, String sessionId)
Creates an special object inside a template.long
createUser(String userName, String password, String firstName, String lastName, boolean enabled, int type, String email, List<PrivilegeInfo> privileges, long defaultGroupId, String sessionId)
Creates a user.long
createValidatorDefinition(String name, String description, String classToBeApplied, String script, boolean enabled, String sessionId)
Creates a validator definition.String
createWarehouse(String poolId, String poolClass, String[] attributeNames, String[] attributeValues, String templateId, String sessionId)
Creates a warehousevoid
deleteActivity(String activityClass, String activityId, boolean releaseRelationships, String sessionId)
Deletes an activity and delete its association with the related inventory objects.void
deleteAttribute(String className, String attributeName, String sessionId)
Deletes an attribute from a class using the class name as key to find itvoid
deleteAttributeForClassWithId(long classId, String attributeName, String sessionId)
Deletes an attribute from a class using the class id as key to find itvoid
deleteBusinessRule(long businessRuleId, String sessionId)
Deletes a business rulevoid
deleteClass(String className, String sessionId)
Deletes a class from the data model using its name as key to find itvoid
deleteClassWithId(long classId, String sessionId)
Deletes a class from the data model using its id as key to find itvoid
deleteConfigurationVariable(String name, String sessionId)
Deletes a configuration variablevoid
deleteConfigurationVariablesPool(String poolId, String sessionId)
Deletes a configuration variables pool.void
deleteContact(String contactClass, String contactId, String sessionId)
Deletes a contactvoid
deleteContract(String contractClass, String contractId, String sessionId)
Deletes a contract and delete its association with the related inventory objects.void
deleteContractPool(String poolId, String poolClass, String sessionId)
Deletes a contract pool.void
deleteCustomerPool(String poolId, String poolClass, String sessionId)
Deletes a customer poolvoid
deleteCustumer(String customerClass, String customerId, String sessionId)
Deletes a customervoid
deleteFavoritesFolders(long[] favoritesFolderId, long userId, String sessionId)
Deletes a set of favorites foldersvoid
deleteGeneralView(List<Long> oids, String sessionId)
Deletes viewsvoid
deleteGroups(List<Long> oids, String sessionId)
Deletes a list of groupsvoid
deleteListTypeItem(String className, String oid, boolean releaseRelationships, String sessionId)
Deletes a list type itemvoid
deleteListTypeItemRelatedView(String listTypeItemId, String listTypeItemClass, long viewId, String sessionId)
Deletes a view related to a list type itemvoid
deleteMPLSLink(String linkId, boolean forceDelete, String sessionId)
Deletes a MPLS linkvoid
deleteObject(String className, String oid, boolean releaseRelationships, String sessionId)
Deletes a set of objects.void
deleteObjects(String[] classNames, String[] oids, boolean releaseRelationships, String sessionId)
Deletes a set of objects.void
deleteOSPView(long viewId, String sessionId)
Deletes an existing OSP viewvoid
deletePhysicalConnection(String objectClass, String objectId, String sessionId)
Deletes a physical connectionvoid
deletePools(String[] ids, String sessionId)
Deletes a set of poolsvoid
deleteProcessDefinition(String processDefinitionId, String sessionId)
Deletes a process definitionvoid
deleteProject(String projectClass, String projectId, String sessionId)
Deletes a project and delete its association with the related inventory objects.These objects will remain untouched.void
deleteProjectPool(String poolId, String poolClass, String sessionId)
Deletes a project pool.void
deleteProxy(String proxyClass, String proxyId, String sessionId)
Deletes a proxy and delete its association with the related inventory objects.void
deleteProxyPool(String proxyPoolId, String sessionId)
Deletes a proxy pool.void
deleteQuery(long queryOid, String sessionId)
Deletes a queryvoid
deleteReport(long reportId, String sessionId)
Deletes a reportvoid
deleteSDHContainerLink(String containerLinkClass, String containerLinkId, boolean forceDelete, String sessionId)
Deletes a container linkvoid
deleteSDHTransportLink(String transportLinkClass, String transportLinkId, boolean forceDelete, String sessionId)
Deletes a transport linkvoid
deleteSDHTributaryLink(String tributaryLinkClass, String tributaryLinkId, String sessionId)
Deletes a tributary link and its corresponding container link.void
deleteService(String serviceClass, String serviceId, String sessionId)
Deletes a servicevoid
deleteServicePool(String poolId, String poolClass, String sessionId)
Deletes a service poolvoid
deleteSparePool(String poolId, String poolClass, String sessionId)
Deletes a spare poolvoid
deleteSubnetPools(String[] ids, String sessionId)
Deletes a set of subnet poolsvoid
deleteSubnets(String className, List<String> oids, boolean releaseRelationships, String sessionId)
Deletes a subnet.void
deleteSynchronizationDataSourceConfig(long syncDataSourceConfigId, String sessionId)
Deletes a sync data source configuration.void
deleteSynchronizationGroup(long syncGroupId, String sessionId)
Deletes a synchronization group and all the sync configurations associated to itvoid
deleteTask(long taskId, String sessionId)
Deletes a task and unsubscribes all users from itvoid
deleteTemplateElement(String templateElementClass, String templateElementId, String sessionId)
Deletes an element within a template or a template itself.void
deleteUsers(List<Long> oids, String sessionId)
Deletes a list of usersvoid
deleteValidatorDefinition(long validatorDefinitionId, String sessionId)
Deletes a validator definitionvoid
deleteWarehouse(String warehouseClass, String warehouseId, String sessionId)
Deletes a warehousevoid
detachFileFromObject(long fileObjectId, String className, String objectId, String sessionId)
Detaches a file from an inventory object.void
disconnectMPLSLink(String connectionId, int sideToDisconnect, String sessionId)
disconnect mpls linkvoid
disconnectPhysicalConnection(String connectionClass, String connectionId, int sideToDisconnect, String sessionId)
Disconnects a side or both sides of a physical connection (a link or a container)byte[]
downloadBulkLoadLog(String fileName, String sessionId)
Retrieves the log file product of a bulk load operation.byte[]
executeClassLevelReport(String objectClassName, String objectId, long reportId, String sessionId)
Executes a class level report and returns the result.byte[]
executeInventoryLevelReport(long reportId, List<StringPair> parameters, String sessionId)
Executes an inventory level report and returns the result.RemoteResultRecord[]
executeQuery(TransientQuery query, String sessionId)
Executes a complex query generated using the Graphical Query Builder.List<RemoteSyncResult>
executeSyncActions(long syncGroupId, List<RemoteSyncAction> actions, String sessionId)
Executes the synchronization actions that the user selected after check the list of findingsRemoteTaskResult
executeTask(long taskId, String sessionId)
Executes a task on demand.List<RemoteObjectLightList>
findSDHRoutesUsingContainerLinks(String communicationsEquipmentClassA, String communicationsEquipmentIdA, String communicationsEquipmentClassB, String communicationsEquipmentIB, String sessionId)
Finds a route between two GenericcommunicationsEquipment based on the ContainerLinks network map (for more details on how this works, please read the SDH Model: Technical Design and Tools document)List<RemoteObjectLightList>
findSDHRoutesUsingTransportLinks(String communicationsEquipmentClassA, String communicationsEquipmentIdA, String communicationsEquipmentClassB, String communicationsEquipmentIB, String sessionId)
Finds a route between two GenericcommunicationsEquipment based on the TransportLinks network map (for more details on how this works, please read the SDH Model: Technical Design and Tools document)RemoteObject
getActivity(String activityClass, String activityId, String sessionId)
Gets the detailed information about an activity.RemoteAssetLevelCorrelatedInformation
getAffectedServices(int resourceType, String resourceDefinition, String sessionId)
Retrieves the services affected when a given network resource is alarmed (or down).List<RemoteClassMetadata>
getAllClasses(boolean includeListTypes, String sessionId)
Retrieves the metadata for the entire class hierarchy as ClassInfo instancesList<RemoteClassMetadataLight>
getAllClassesLight(boolean includeListTypes, String sessionId)
Retrieves the metadata for the entire class hierarchy as ClassInfoLight instancesList<RemoteConfigurationVariable>
getAllConfigurationVariables(String sessionId)
Gets all the configuration variables in the database, no matter what pool they belong toList<RemoteObjectLight>
getAllContracts(int page, int limit, String sessionId)
Retrieves the entire list of contracts registered in the Contract Manager module.List<RemoteObjectLight>
getAllCustomers(List<StringPair> filters, int page, int limit, String sessionId)
Gets all the customersList<RemoteObjectLight>
getAllProjects(int page, int limit, String sessionId)
Retrieves the entire list of projects registered in the Project Manager module.List<RemoteInventoryProxy>
getAllProxies(String sessionId)
Gets all the inventory proxies in the database.List<RemoteObjectLight>
getAllServices(List<StringPair> filters, int page, int limit, String sessionId)
Gets all the servicesList<RemoteValidatorDefinition>
getAllValidatorDefinitions(String sessionId)
Retrieves all the validator definitions in the systemRemoteArtifactDefinition
getArtifactDefinitionForActivity(String processDefinitionId, String activityDefinitionId, String sessionId)
Given an activity definition, returns the artifact definition associated to itRemoteArtifact
getArtifactForActivity(String processInstanceId, String activityId, String sessionId)
Gets the artifact associated to an activity (for example, a form that was already filled in by a user in a previous, already committed activity)RemoteAttributeMetadata
getAttribute(String className, String attributeName, String sessionId)
Gets a class attribute, using the class name as key to find itRemoteAttributeMetadata
getAttributeForClassWithId(String classId, String attributeName, String sessionId)
Gets a class attribute, using the class id as key to find itList<RemoteLogicalConnectionDetails>
getBGPMap(List<String> mappedBgpLinksIds, String sessionId)
Creates/updates a map of the BGPLinksApplicationLogEntry[]
getBusinessObjectAuditTrail(String objectClass, String objectId, int limit, String sessionId)
Retrieves the log entries for a given [business] objectList<RemoteBusinessRule>
getBusinessRules(int type, String sessionId)
Retrieves the business rules of a particular type.List<RemoteObject>
getChildrenOfClass(String parentOid, String parentClass, String childrenClass, int page, int maxResults, String sessionId)
Gets all children of an object of a given classList<RemoteObjectLight>
getChildrenOfClassLight(String parentOid, String parentClass, String childrenClass, int maxResults, String sessionId)
Gets all children of an object of a given classList<RemoteObjectLight>
getChildrenOfClassLightRecursive(String parentOid, String parentClass, String childrenClass, int maxResults, String sessionId)
Gets recursively all children of an object of a given classRemoteClassMetadata
getClass(String className, String sessionId)
Gets the metadata of a given class using its name as key to find itbyte[]
getClassHierarchy(boolean showAll, String sessionId)
Creates an XML document describing the class hierarchyList<RemoteReportMetadataLight>
getClassLevelReports(String className, boolean recursive, boolean includeDisabled, String sessionId)
Gets the class level reports associated to the given class (or its superclasses)RemoteClassMetadata
getClassWithId(long classId, String sessionId)
Gets the metadata of a given class using its id as key to find itRemoteObjectLight
getCommonParent(String aObjectClass, String aOid, String bObjectClass, String bOid, String sessionId)
Gets the common parent between an a object and b objectRemoteConfigurationVariable
getConfigurationVariable(String name, String sessionId)
Retrieves a configuration variableList<RemoteConfigurationVariable>
getConfigurationVariablesInPool(String poolId, String sessionId)
Gets the configuration variables in a configuration variable poolList<RemotePool>
getConfigurationVariablesPools(String sessionId)
Retrieves the list of pools of configuration variables.List<RemoteConfigurationVariable>
getConfigurationVariablesWithPrefix(String prefix, String sessionId)
Gets the configuration variables with a given prefixRemoteObject
getConfigurationVariableValue(String name, String sessionId)
Retrieves only the value of a configuration variable.RemoteContact
getContact(String contactClass, String contactId, String sessionId)
Gets the whole information about a contactList<RemoteContact>
getContacts(int page, int limit, List<StringPair> filters, String sessionId)
Retrieves the list of contacts that matches the search criteriaList<RemoteContact>
getContactsForCustomer(String customerClass, String customerId, String sessionId)
Retrieves the contacts associated to a given customerList<RemoteObjectLight>
getContainersBetweenObjects(String objectAClass, String objectAId, String objectBClass, String objectBId, String containerClass, String sessionId)
Retrieves the existing containers between two given nodes.RemoteObject
getContract(String contractClass, String contractId, String sessionId)
Gets the detailed information about a contract.RemotePool
getContractPool(String poolId, String poolClass, String sessionId)
Gets the contract pools properties.List<RemotePool>
getContractPools(String sessionId)
Retrieves the contract pool list.List<RemoteObjectLight>
getContractResources(String contractClass, String contractId, String sessionId)
Gets the resources (objects) related to a contract.List<RemoteObjectLight>
getContractsInPool(String poolId, int limit, String sessionId)
Gets the contracts inside a contract pool.List<RemoteBackgroundJob>
getCurrentJobs(String sessionId)
Gets the current jobs which are executingRemoteObject
getCustomer(String customerClass, String customerId, String sessionId)
Gets the detailed information about a customerRemotePool
getCustomerPool(String poolId, String poolClass, String sessionId)
Gets a customer poolList<RemotePool>
getCustomerPools(String sessionId)
Gets the project poolsList<RemoteObjectLight>
getCustomersInPool(String poolId, String className, int page, int limit, String sessionId)
Retrieves the list of customers from a poolList<RemoteObjectLight>
getDeviceLayouts(String sessionId)
Gets the list of template elements with a device layoutbyte[]
getDeviceLayoutStructure(String oid, String className, String sessionId)
Gets the device layout structureRemoteViewObject
getE2View(List<String> linkClasses, List<String> linkIds, boolean includeVlans, boolean includeBDIs, String sessionId)
Returns the structure of a logical connection.RemoteFavoritesFolder
getFavoritesFolder(long favoritesFolderId, long userId, String sessionId)
Gets a favorites folderList<RemoteFavoritesFolder>
getFavoritesFoldersForObject(long userId, String objectClass, String objectId, String sessionId)
Gets the favorites folders an object is included into.List<RemoteFavoritesFolder>
getFavoritesFoldersForUser(long userId, String sessionId)
Gets the list of favorites folders of a given User.RemoteFileObject
getFile(long fileObjectId, String className, String objectId, String sessionId)
Retrieves a particular file from those attached to an inventory object.List<RemoteFileObjectLight>
getFilesForObject(String className, String objectId, String sessionId)
Retrieves the files associated to a given inventory objectRemoteObjectLight
getFirstParentOfClass(String objectClass, String oid, String objectToMatchClassName, String sessionId)
Gets the first occurrence of a parent with a given class (according to the special and standard containment hierarchy) (for example "give me the parent of this port until you find the nearest rack")ApplicationLogEntry[]
getGeneralActivityAuditTrail(int page, int limit, String sessionId)
Retrieves the list of activity log entriesRemoteViewObject
getGeneralView(long viewId, String sessionId)
Gets the information of a particular viewRemoteViewObjectLight[]
getGeneralViews(String viewClass, int limit, String sessionId)
Gets all views that are not related to a particular objectList<GroupInfo>
getGroups(String sessionId)
Retrieves the list of groupsList<GroupInfoLight>
getGroupsForUser(long userId, String sessionId)
Retrieves the groups a user belongs toRemoteClassMetadataLight[]
getInstanceableListTypes(String sessionId)
Retrieves all possible list typesList<RemoteReportMetadataLight>
getInventoryLevelReports(boolean includeDisabled, String sessionId)
Gets the inventory class reports.String
getIPAddress()
Gets the IP address from the client issuing the requestRemoteObject
getLinkConnectedToPort(String portClassName, String portId, String sessionId)
Convenience method that returns the link connected to a port (if any).RemoteObject
getListTypeItem(String listTypeClassName, String listTypeItemId, String sessionId)
Retrieves list type item given its idRemoteViewObject
getListTypeItemRelatedView(String listTypeItemId, String listTypeItemClass, long viewId, String sessionId)
Gets a view related to a list type item, given its id.RemoteViewObjectLight[]
getListTypeItemRelatedViews(String listTypeItemId, String listTypeItemClass, int limit, String sessionId)
Gets all the views related to a list type item.List<RemoteObjectLight>
getListTypeItems(String className, String sessionId)
Retrieves all items for a single list typeRemoteLogicalConnectionDetails
getLogicalLinkDetails(String linkClass, String linkId, String sessionId)
Returns the structure of a logical connection.List<RemoteAttributeMetadata>
getMandatoryAttributesInClass(String className, String sessionId)
Retrieves the mandatory attributes for a given classRemoteMPLSConnectionDetails
getMPLSLinkEndpoints(String connectionId, String sessionId)
The details of a given mpls linkRemoteActivityDefinition
getNextActivityForProcessInstance(String processInstanceId, String sessionId)
Requests for the next activity to be executed in a process instance.RemoteObject
getObject(String objectClass, String oid, String sessionId)
Gets the complete information about a given object (all its attributes)List<RemoteObjectLight>
getObjectChildren(String objectClassName, String oid, int maxResults, String sessionId)
Gets the children of a given object given his class name and object idList<RemoteObjectLight>
getObjectChildrenForClassWithId(String oid, long objectClassId, int maxResults, String sessionId)
Gets the children of a given object given his class id and object idRemoteObjectLight
getObjectLight(String objectClass, String oid, String sessionId)
Gets the basic information about a given object (oid, classname, name)RemoteViewObject
getObjectRelatedView(String oid, String objectClass, long viewId, String sessionId)
Gets a particular view related to an objectList<RemoteViewObjectLight>
getObjectRelatedViews(String oid, String objectClass, int viewType, int limit, String sessionId)
Returns list of views associated to an objectList<RemoteObjectLight>
getObjectsInFavoritesFolder(long favoritesFolderId, long userId, int limit, String sessionId)
Gets the objects in a to favorites folderList<RemoteObjectLight>
getObjectsInSparePool(String poolId, int limit, String sessionId)
Get the objects list inside the spare poolList<RemoteObjectLight>
getObjectsOfClassLight(String className, List<StringPair> attributesToFilter, int page, int limit, String sessionId)
Gets all objects of a given classList<RemoteObjectLight>
getObjectSpecialChildren(String objectClass, String objectId, String sessionId)
Gets the special children of a given object.List<RemoteObjectLight>
getObjectsRelatedToService(String serviceClass, String serviceId, String sessionId)
Gets the objects (resources) associated to a serviceList<RemoteObject>
getObjectsWithFilter(String className, String filterName, String filterValue, String sessionId)
Same asKuwaibaSoapWebService.getObjectsWithFilterLight(java.lang.String, java.lang.String, java.lang.String, java.lang.String)
, but returns RemoteObjects instead of RemoteObjectLightsList<RemoteObjectLight>
getObjectsWithFilterLight(String className, String filterName, String filterValue, String sessionId)
Retrieves a list of light instances of a given class given a simple filter.RemoteViewObject
getOSPView(long viewId, String sessionId)
Retrieves the specific information about an existing OSP viewList<RemoteViewObjectLight>
getOSPViews(String sessionId)
Retrieves the existing OSP viewsRemoteObjectLight
getParent(String objectClass, String oid, String sessionId)
Gets the parent of a given object in the standard and special containment hierarchyRemoteObject
getParentOfClass(String objectClass, String oid, String parentClass, String sessionId)
Gets the first parent of an object which matches the given class in the containment hierarchyList<RemoteObjectLight>
getParents(String objectClass, String oid, String sessionId)
Retrieves all the ancestors of an object in the containment hierarchy.List<RemoteObjectLight>
getParentsUntilFirstOfClass(String objectClass, String oid, String objectToMatchClassName, String sessionId)
Gets the list of parents (according to the special and standard containment hierarchy) until it finds an instance of class objectToMatchClassName (for example "give me the parents of this port until you find the nearest rack")RemoteObjectLight[]
getPhysicalConnectionEndpoints(String connectionClass, String connectionId, String sessionId)
Returns the endpoints of a physical connectionList<RemoteObjectLightList>
getPhysicalConnectionsInObject(String objectClass, String objectId, String sessionId)
Loops through all instances of GenericCommunicationsPort at any level inside the given object and gets the physical path.List<RemoteObjectLight>
getPhysicalPath(String objectClass, String objectId, String sessionId)
Gets the physical trace of connections and ports from a given port.RemoteObjectRelatedObjects
getPhysicalTree(String objectClass, String objectId, String sessionId)
Gets the tree representation of all physical paths.RemotePool
getPool(String poolId, String sessionId)
Retrieves information about a particular poolList<RemoteObjectLight>
getPoolItems(String poolId, int limit, String sessionId)
Gets the objects contained into a poolList<RemotePool>
getPoolsInObject(String objectClassName, String objectId, String poolClass, String sessionId)
Retrieves all the pools that are children of a particular object.List<RemotePool>
getPoolsInPool(String parentPoolId, String poolClass, String sessionId)
Gets the pools contained inside a pool.List<RemotePool>
getPoolsInWarehouse(String objectClassName, String objectId, String sessionId)
Get the spare pool list inside the warehouseList<RemoteClassMetadataLight>
getPossibleChildren(String parentClassName, String sessionId)
Gets the possible children of a class according to the containment hierarchy.List<RemoteClassMetadataLight>
getPossibleChildrenNoRecursive(String parentClassName, String sessionId)
Gets the possible children of a class according to the containment hierarchy.List<RemoteClassMetadataLight>
getPossibleSpecialChildren(String parentClassName, String sessionId)
Gets the possible special children of a class according to the containment hierarchy.List<RemoteClassMetadataLight>
getPossibleSpecialChildrenNoRecursive(String parentClassName, String sessionId)
Gets the possible special children of a class according to the containment hierarchy.RemoteProcessDefinition
getProcessDefinition(String processDefinitionId, String sessionId)
Retrieves a process definitionRemoteObject
getProject(String projectClass, String projectId, String sessionId)
Gets the detailed information about a projectList<RemoteObjectLight>
getProjectActivities(String projectClass, String projectId, String sessionId)
Gets the activities inside a project.RemotePool
getProjectPool(String poolId, String poolClass, String sessionId)
Gets the project pools properties.List<RemotePool>
getProjectPools(String sessionId)
Retrieves the projects pool list.List<RemoteObjectLight>
getProjectResources(String projectClass, String projectId, String sessionId)
Gets the resources (objects) related to a project.List<RemoteObjectLight>
getProjectsInPool(String poolId, int limit, String sessionId)
Gets the projects inside a project pool.List<RemoteObjectLight>
getProjectsRelatedToObject(String objectClass, String objectId, String sessionId)
Gets the projects related to an object.List<RemoteObjectLight>
getProjectsWithFilter(List<StringPair> filters, int page, int limit, String sessionId)
Retrieves the entire list of projects registered in the Project Manager module.List<RemoteInventoryProxy>
getProxiesInPool(String proxyPoolId, String sessionId)
Gets the list of inventory proxies in a given pool.List<RemotePool>
getProxyPools(String sessionId)
Retrieves the list of pools of proxies.RemoteQueryLight[]
getQueries(boolean showPublic, String sessionId)
Retrieves all saved queriesRemoteQuery
getQuery(long queryOid, String sessionId)
Retrieves a saved queryRemoteReportMetadata
getReport(long reportId, String sessionId)
Gets the information related to a class level report.List<RemotePool>
getRootPools(String className, int type, boolean includeSubclasses, String sessionId)
Retrieves the pools that don't have any parent and are normally intended to be managed by the Pool ManagerList<RemoteSDHContainerLinkDefinition>
getSDHContainerLinkStructure(String containerLinkClass, String containerLinkId, String sessionId)
Gets the internal structure of a container link.List<RemoteSDHContainerLinkDefinition>
getSDHTransportLinkStructure(String transportLinkClass, String transportLinkId, String sessionId)
Retrieves the container links within a transport link (e.g.RemoteObject
getService(String serviceClass, String serviceId, String sessionId)
Gets the detailed information about a serviceRemotePool
getServicePool(String poolId, String poolClass, String sessionId)
Gets the detailed information about a service poolList<RemotePool>
getServicePoolsInCostumer(String customerClass, String customerId, String servicePoolClass, String sessionId)
Retrieves the pools associated to a particular customerList<RemoteObjectLight>
getServicesInPool(String poolId, String className, int page, int limit, String sessionId)
Retrieves the list of services from a poolList<RemoteObjectLight>
getSiblings(String objectClassName, String oid, int maxResults, String sessionId)
Returns the siblings of an object in the containment hierarchyList<RemoteObjectLight>
getSpecialAttribute(String objectClass, String oid, String attributeName, String sessionId)
Gets the value of a special attribute, this is, those related to a model, such as cables connected to portsRemoteObjectSpecialRelationships
getSpecialAttributes(String objectClass, String oid, String sessionId)
Returns all the special relationships of a given object as a hashmap whose keys are the names of the relationships and the values the list of related objectsList<RemoteObjectLight>
getSpecialChildrenOfClassLight(String parentOid, String parentClass, String classToFilter, int maxResults, String sessionId)
Returns the special children of a given object as RemoteObjectLight instances.List<RemoteObjectLight>
getSpecialChildrenOfClassLightRecursive(String parentOid, String parentClass, String classToFilter, int maxResults, String sessionId)
Returns the special children of a given object as RemoteObjectLight instances in a recursive fashion.List<RemoteClassMetadataLight>
getSubClassesLight(String className, boolean includeAbstractClasses, boolean includeSelf, String sessionId)
Gets the subclasses of a given classList<RemoteClassMetadataLight>
getSubClassesLightNoRecursive(String className, boolean includeAbstractClasses, boolean includeSelf, String sessionId)
Gets the subclasses of a given classRemoteObject
getSubnet(String id, String className, String sessionId)
Gets the complete information about a given subnet (all its attributes)RemotePool
getSubnetPool(String subnetPoolId, String sessionId)
Gets the complete information about a given subnet pool (all its attributes)List<RemotePool>
getSubnetPools(String parentId, String className, String sessionId)
Retrieves all the pools of subnetsList<RemoteObjectLight>
getSubnets(String poolId, int limit, String sessionId)
Retrieves the subnets of a given pool idList<RemoteObjectLight>
getSubnetsInSubnet(String id, int limit, String className, String sessionId)
Retrieves the sub-subnets of a subnetList<RemoteObjectLight>
getSubnetUsedIps(String id, int limit, String className, String sessionId)
Retrieves the IP addresses of a subnetList<RemoteUserInfoLight>
getSubscribersForTask(long taskId, String sessionId)
Gets the users subscribed to a particular task.RemoteSynchronizationConfiguration
getSyncDataSourceConfiguration(String objectId, String sessionId)
Gets the synchronization data source configurations for an objectList<RemoteSynchronizationConfiguration>
getSyncDataSourceConfigurations(long syncGroupId, String sessionId)
Gets the synchronization data source configurations for a sync groupRemoteSynchronizationGroup
getSynchronizationGroup(long syncGroupId, String sessionId)
Gets a given sync groupList<RemoteSynchronizationGroup>
getSynchronizationGroups(String sessionId)
Gets the available sync groupsList<RemoteSynchronizationProvider>
getSynchronizationProviders(String sessionId)
Get the set of sync providers defined in the configuration variables pool called -Sync Providers-RemoteTask
getTask(long taskId, String sessionId)
Retrieves the information about a particular taskList<RemoteTask>
getTasks(String sessionId)
Gets all the registered tasksList<RemoteTask>
getTasksForUser(long userId, String sessionId)
Gets all the tasks related to a particular userRemoteObject
getTemplateElement(String templateElementClass, String templateElementId, String sessionId)
Retrives all the information of a given template element.List<RemoteObjectLight>
getTemplateElementChildren(String templateElementClass, String templateElementId, String sessionId)
Retrieves the children of a given template element.List<RemoteObjectLight>
getTemplatesForClass(String className, String sessionId)
Gets the templates available for a given classList<RemoteObjectLight>
getTemplateSpecialElementChildren(String tsElementClass, String tsElementId, String sessionId)
Retrieves the children of a given template special element.List<RemoteClassMetadataLight>
getUpstreamClassHierarchy(String className, boolean includeSelf, String sessionId)
Gets the parent classes of a given class up to RootObject.List<RemoteClassMetadataLight>
getUpstreamContainmentHierarchy(String className, boolean recursive, String sessionId)
Gets the containment hierarchy of a given class, but upwards (i.e.List<RemoteClassMetadataLight>
getUpstreamSpecialContainmentHierarchy(String className, boolean recursive, String sessionId)
Gets the special containment hierarchy of a given class, but upwards (i.e.String
getUserNameFromSession(String sessionId)
Finds the user name using the session IdList<RemoteUserInfo>
getUsers(String sessionId)
Retrieves the list of usesList<RemoteUserInfo>
getUsersInGroup(long groupId, String sessionId)
Retrieves the users in a groupList<RemoteValidatorDefinition>
getValidatorDefinitionsForClass(String className, String sessionId)
Retrieves all the validator definitions inside a classList<RemotePool>
getWarehouseRootPools(String sessionId)
Gets the warehouse module root pools.List<RemoteObjectLight>
getWarehousesInPool(String poolId, int limit, String sessionId)
Get the warehouses list inside the poolboolean
hasAttribute(String className, String attributeName, String sessionId)
Checks if a class has a attribute with a given nameboolean
isSubClassOf(String className, String allegedParentClass, String sessionId)
Tests if a class is subclass of another.boolean
itOverlaps(String networkIp, String broadcastIp, String sessionId)
Checks if a new subnet overlaps with an existing onevoid
killJob(long jobId, String sessionId)
Kills a job given its idList<RemoteSyncResult>
launchAdHocAutomatedSynchronizationTask(List<Long> synDsConfigIds, String providersName, String sessionId)
Executes an automated synchronization job, which consist on connecting to the sync data source using the configuration attached to the given sync group and finding the differences between the information currently in the inventory platform and what's in the sync data source.List<RemoteSyncResult>
launchAutomatedSynchronizationTask(long syncGroupId, String providersName, String sessionId)
Executes an automated synchronization job, which consist on connecting to the sync data source using the configuration attached to the given sync group and finding the differences between the information currently in the inventory platform and what's in the sync data source.List<RemoteSyncFinding>
launchSupervisedSynchronizationTask(long syncGroupId, String sessionId)
Executes a supervised synchronization job, which consist on connecting to the sync data source using the configuration attached to the given sync group and finding the differences between the information currently in the inventory platform and what's in the sync data source.void
moveObjects(String targetClass, String targetOid, String[] objectClasses, String[] objectOids, String sessionId)
Moves objects from their current parent to a target object.void
moveObjectsToPool(String targetClass, String targetOid, String[] objectClasses, String[] objectOids, String sessionId)
Moves objects from their current parent to a pool target object.void
moveObjectsToWarehouse(String targetClass, String targetOid, String[] objectClasses, String[] objectOids, String sessionId)
Moves objects from their current parent to a target object.void
moveObjectsToWarehousePool(String targetClass, String targetOid, String[] objectClasses, String[] objectOids, String sessionId)
Moves objects from their current parent to a warehouse pool target object.void
movePoolItemToPool(String poolId, String poolItemClassName, String poolItemId, String sessionId)
Move a pool item from a pool to another poolvoid
moveSpecialObjects(String targetClass, String targetOid, String[] objectClasses, String[] objectOids, String sessionId)
Moves special objects from their current parent to a target object.void
moveSyncDataSourceConfiguration(long newSyncGroupId, long[] syncDataSourceConfigurationIds, String sessionId)
Moves a sync data source configuration from a sync group to another sync groupvoid
reconnectPhysicalConnection(String connectionClass, String connectionId, String newASideClass, String newASideId, String newBSideClass, String newBSideId, String sessionId)
Changes one or both sides (endpoints) of a physical connection (link or container).void
relateIPtoPort(String ipId, String portClassName, String portId, String sessionId)
Creates a relation between an IP address and a portvoid
relateObjectsToContract(String[] objectClass, String[] objectId, String contractClass, String contractId, String sessionId)
Relates a list of objects (instances of a subclass of InventoryObject) to an existing contract (most probably a support contract).void
relateObjectsToProject(String projectClass, String projectId, String[] objectClass, String[] objectId, String sessionId)
Relates a set of objects to a projectvoid
relateObjectsToService(String[] objectClass, String[] objectId, String serviceClass, String serviceId, String sessionId)
Associates a list of objects (resources) to an existing servicevoid
relateObjectToContract(String contractClass, String contractId, String objectClass, String objectId, String sessionId)
Relates an object to a contract.void
relateObjectToProject(String projectClass, String projectId, String objectClass, String objectId, String sessionId)
Relates an object to a project.void
relateObjectToService(String objectClass, String objectId, String serviceClass, String serviceId, String sessionId)
Associates an object (a resource) to an existing servicevoid
relatePortToInterface(String portId, String portClassName, String interfaceClassName, String interfaceId, String sessionId)
Associates any GenericCommunicationsPort to existing BridgeDomainInterfacevoid
relateSubnetToVlan(String id, String className, String vlanId, String sessionId)
Creates a relation between a Subnet and a VLAN, this method is also using to associate VFRs, and BDIs to a VLAN TODO: check the model, there are redundant relationshipsvoid
relateSubnetToVrf(String id, String className, String vrfId, String sessionId)
Creates a relation between a subnet and a VRFvoid
releaseMirrorMultiplePort(String objectClass, String objectId, String sessionId)
Releases a port mirroring multiple relationship between two ports, receiving one of the ports as parametervoid
releaseMirrorPort(String objectClass, String objectId, String sessionId)
Releases a port mirroring relationship between two ports, receiving one of the ports as parametervoid
releaseObjectFromContract(String objectClass, String objectId, String contractClass, String contractId, String sessionId)
Releases an inventory object from a contract it was related tovoid
releaseObjectFromProject(String objectClass, String objectId, String projectClass, String projectId, String sessionId)
Releases an object from project.void
releaseObjectFromProxy(String objectClass, String objectId, String proxyClass, String proxyId, String sessionId)
Releases an inventory previously related to an inventory proxy.void
releaseObjectFromService(String serviceClass, String serviceId, String objectId, String sessionId)
Releases an object from a service that is using itvoid
releasePhysicalNodeFromWarehouse(String warehouseClass, String warehouseId, String targetId, String sessionId)
Releases an object from a warehouse or virtual warehouse that is using itvoid
releasePortFromInterface(String interfaceClassName, String interfaceId, String portId, String sessionId)
Release the association between a network element and a MPLSTunnel or BridgeDomain or FrameRelay or VRFvoid
releasePortFromIP(String deviceClassName, String deviceId, String id, String sessionId)
Releases the relation between an IP address and a portvoid
releaseSubnetFromVlan(String subnetId, String vlanId, String sessionId)
Releases the relation between a subnet and a VLAN, this method is also using to release VFRs, and BDIs from a VLAN TODO: check the model there are redundant relationshipsvoid
releaseSubnetFromVRF(String subnetId, String vrfId, String sessionId)
Releases the relation between a subnet and a VRFvoid
releaseSyncDataSourceConfigFromSyncGroup(long syncGroupId, long[] syncDataSourceConfigurationIds, String sessionId)
Release a set of sync data source configuration from a given sync groupvoid
removeIP(String[] oids, boolean releaseRelationships, String sessionId)
Removes a set of IP Addresses from a subnet.void
removeObjectsFromFavoritesFolder(String[] objectClass, String[] objectId, long favoritesFolderId, long userId, String sessionId)
Removes a list of objects from a given favorites foldervoid
removePossibleChildrenForClassWithId(long parentClassId, long[] childrenToBeRemoved, String sessionId)
Removes a set of possible children for a given classvoid
removePossibleSpecialChildren(long parentClassId, long[] specialChildrenToBeRemoved, String sessionId)
Removes a set of possible special children for a given class.void
removePrivilegeFromGroup(long groupId, String featureToken, String sessionId)
Removes a privilege from a uservoid
removePrivilegeFromUser(long userId, String featureToken, String sessionId)
Removes a privilege from a uservoid
removeUserFromGroup(long userId, long groupId, String sessionId)
Removes a user from a groupList<RemoteValidator>
runValidationsForObject(String objectClass, long objectId, String sessionId)
Runs the existing validations for the class associated to the given object.void
saveQuery(long queryOid, String queryName, long ownerOid, byte[] queryStructure, String description, String sessionId)
Save the query made in the graphical Query builderList<RemoteContact>
searchForContacts(String searchString, int maxResults, String sessionId)
Searches for contacts given a search string, This string will be searched in the attribute values of all contactsvoid
setAttributeProperties(String className, long attributeId, String name, String displayName, String description, String type, Boolean administrative, Boolean mandatory, Boolean multiple, Boolean noCopy, Boolean readOnly, Boolean unique, Boolean visible, Integer order, String sessionId)
Updates a class attribute taking its name as key to find it.void
setAttributePropertiesForClassWithId(long classId, long attributeId, String name, String displayName, String description, String type, Boolean administrative, Boolean mandatory, Boolean multiple, Boolean noCopy, Boolean readOnly, Boolean unique, Boolean visible, Integer order, String sessionId)
Updates a class attribute taking its id as key to find it.void
setClassProperties(long classId, String className, String displayName, String description, byte[] smallIcon, byte[] icon, int color, Boolean isAbstract, Boolean isInDesign, Boolean isCustom, Boolean isCountable, String sessionId)
Updates a class metadata properties.void
setGroupProperties(long oid, String groupName, String description, String sessionId)
Sets the properties for an existing groupvoid
setPoolProperties(String poolId, String name, String description, String sessionId)
Updates pool name and descriptionvoid
setPrivilegeToGroup(long groupId, String featureToken, int accessLevel, String sessionId)
Sets a privilege to a group.void
setPrivilegeToUser(long userId, String featureToken, int accessLevel, String sessionId)
Sets a privilege to a user.void
setUserProperties(long oid, String username, String firstName, String lastName, String password, int enabled, int type, String email, String sessionId)
Sets the properties of a given user using the id to search for itvoid
subscribeUserToTask(long userId, long taskId, String sessionId)
Subscribes a user to a task, so it will be notified of the result of its executionvoid
unsubscribeUserFromTask(long userId, long taskId, String sessionId)
Unsubscribes a user from a task, so it will no longer be notified about the result of its executionvoid
updateActivity(String activityClass, String activityId, List<StringPair> attributes, String sessionId)
Updates one or many activity attributes.void
updateConfigurationVariable(String name, String propertyToUpdate, String newValue, String sessionId)
Updates the value of a configuration variable.void
updateConfigurationVariablesPool(String poolId, String propertyToUpdate, String value, String sessionId)
Updates an attribute of a given configuration variables pool.void
updateContact(String contactClass, String contactId, List<StringPair> properties, String sessionId)
Updates a set of properties of a contactvoid
updateContract(String contractClass, String contractId, List<StringPair> attributes, String sessionId)
Updates one or many contract attributes.void
updateContractPool(String poolId, String poolClass, String poolName, String poolDescription, String sessionId)
Updates the attributes of a contract pool.void
updateCustomer(String customerClass, String customerId, List<StringPair> attributes, String sessionId)
Updates a customervoid
updateCustomerPool(String poolId, String poolClass, String poolName, String poolDescription, String sessionId)
Updates a customer poolvoid
updateFavoritesFolder(long favoritesFolderId, String favoritesFolderName, long userId, String sessionId)
Updates a favorites foldervoid
updateFileProperties(long fileObjectId, List<StringPair> properties, String className, String objectId, String sessionId)
Updates the properties of a file object (name or tags)void
updateGeneralView(long viewId, String viewName, String viewDescription, byte[] structure, byte[] background, String sessionId)
Updates a general view (a view that is not linked to any particular object)void
updateListTypeItem(String className, String oid, List<StringPair> attributesToBeUpdated, String sessionId)
Updates a list type item.void
updateListTypeItemRelatedView(String listTypeItemId, String listTypeItemClass, long viewId, String name, String description, byte[] structure, byte[] background, String sessionId)
Updates a view for a given list type item.void
updateObject(String className, String oid, List<StringPair> attributesToBeUpdated, String sessionId)
Updates attributes of a given objectvoid
updateObjectRelatedView(String objectOid, String objectClass, long viewId, String viewName, String viewDescription, byte[] structure, byte[] background, String sessionId)
Updates an object view (a view that is linked to a particular object)void
updateOSPView(long viewId, String name, String description, byte[] content, String sessionId)
Updates an existing OSP viewvoid
updateProcessDefinition(String processDefinitionId, List<StringPair> properties, byte[] structure, String sessionId)
Updates a process definition, either its standard properties or its structurevoid
updateProject(String projectClass, String projectId, List<StringPair> attributes, String sessionId)
Updates one or many project attributes.void
updateProjectPool(String poolId, String poolClass, String poolName, String poolDescription, String sessionId)
Updates the attributes of a project pool.void
updateProxy(String proxyClass, String proxyId, List<StringPair> attributes, String sessionId)
Updates one or many proxy attributes.void
updateProxyPool(String proxyPoolId, String attributeName, String attributeValue, String sessionId)
Updates an attribute of a proxy pool.void
updateReport(long reportId, String reportName, String reportDescription, Boolean enabled, Integer type, String script, String sessionId)
Updates the properties of an existing class level report.void
updateReportParameters(long reportId, List<StringPair> parameters, String sessionId)
Updates the value of any of the parameters of a given report.void
updateService(String serviceClass, String serviceId, List<StringPair> attributes, String sessionId)
Updates a servicevoid
updateServicePool(String poolId, String poolClass, String poolName, String poolDescription, String sessionId)
Updates a service poolvoid
updateSyncDataSourceConfiguration(long syncDataSourceConfigId, List<StringPair> parameters, String sessionId)
Updates a sync data source configurationvoid
updateSynchronizationGroup(long syncGroupId, List<StringPair> syncGroupProperties, String sessionId)
Creates a Synchronization Group.void
updateTaskNotificationType(long taskId, RemoteTaskNotificationDescriptor notificationType, String sessionId)
Updates a task notification typevoid
updateTaskParameters(long taskId, List<StringPair> parameters, String sessionId)
Updates the parameters of a task.void
updateTaskProperties(long taskId, String propertyName, String propertyValue, String sessionId)
Updates any of these properties from a task: name, description, enabled and scriptvoid
updateTaskSchedule(long taskId, RemoteTaskScheduleDescriptor schedule, String sessionId)
Updates a task schedulevoid
updateTemplateElement(String templateElementClass, String templateElementId, String[] attributeNames, String[] attributeValues, String sessionId)
Updates the value of an attribute of a template element.void
updateValidatorDefinition(long validatorDefinitionId, String name, String description, String classToBeApplied, String script, Boolean enabled, String sessionId)
Updates the properties of a validator.RemoteViewObject
validateSavedE2EView(List<String> linkClasses, List<String> linkIds, RemoteViewObject savedView, String sessionId)
Validates a saved structure of a end to end view.
-
-
-
Method Detail
-
createSession
public RemoteSession createSession(String username, String password, int sessionType) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a session. Only one session per type is allowed. If a new session is created and there was already one of the same type, the old one will be discarded. See RemoteSession.TYPE_XXX for possible session types. System users can not create sessions.- Specified by:
createSession
in interfaceKuwaibaSoapWebService
- Parameters:
username
- user login namepassword
- user passwordsessionType
- The type of session to be created. This type depends on what kind of client is trying to access (a desktop client, a web client, a web service user, etc. See RemoteSession.TYPE_XXX for possible session types- Returns:
- A session object, including the session token
- Throws:
ServerSideException
- If the user does not exist If the password is incorrect or if the user is not enabled.
-
closeSession
public void closeSession(String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Closes a session- Specified by:
closeSession
in interfaceKuwaibaSoapWebService
- Parameters:
sessionId
- Session token- Throws:
ServerSideException
- If the session ID is Invalid or the IP does not match with the one registered for this session
-
getUsers
public List<RemoteUserInfo> getUsers(String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves the list of uses- Specified by:
getUsers
in interfaceKuwaibaSoapWebService
- Parameters:
sessionId
- session token- Returns:
- The list of users
- Throws:
ServerSideException
- If the user is not allowed to invoke the method
-
getUsersInGroup
public List<RemoteUserInfo> getUsersInGroup(long groupId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves the users in a group- Specified by:
getUsersInGroup
in interfaceKuwaibaSoapWebService
- Parameters:
groupId
- The id of the groupsessionId
- Session token- Returns:
- The list of users in the requested group
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the group does not exist or something unexpected happened.
-
getGroupsForUser
public List<GroupInfoLight> getGroupsForUser(long userId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves the groups a user belongs to- Specified by:
getGroupsForUser
in interfaceKuwaibaSoapWebService
- Parameters:
userId
- The id of the usersessionId
- Session token- Returns:
- The list of groups the user belongs to
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the group does not exist or something unexpected happened.
-
getGroups
public List<GroupInfo> getGroups(String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves the list of groups- Specified by:
getGroups
in interfaceKuwaibaSoapWebService
- Parameters:
sessionId
- Session token- Returns:
- A group object list
- Throws:
ServerSideException
- If the user is not allowed to invoke the method or any possible error raised at runtime
-
createUser
public long createUser(String userName, String password, String firstName, String lastName, boolean enabled, int type, String email, List<PrivilegeInfo> privileges, long defaultGroupId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a user. System users can be created but not deleted or modified. Create system users only if you are a developer, as they can only be modified or deleted by accessing directly to the database.- Specified by:
createUser
in interfaceKuwaibaSoapWebService
- Parameters:
userName
- User name. Can't be null, empty or have non standard characters.password
- A password (in plain text, it'll be encrypted later). Can't be null nor an empty stringfirstName
- User's first namelastName
- User's last nameenabled
- Is this user enable by default?type
- The type of the user. See UserProfileLight.USER_TYPE* for possible valuesemail
- User's emailprivileges
- A list privileges that will be granted to this user.defaultGroupId
- Default group this user will be associated to. Users always belong to at least one group. Other groups can be added later.sessionId
- Session token- Returns:
- The new user Id
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the username is null or empty or the username already exists, if the user type is invalid or if the password is an empty string, or if it is attempted to change the user name of the admin user name, or if this operation is attempted on a system user. Also, if the new user type is invalid.
-
setUserProperties
public void setUserProperties(long oid, String username, String firstName, String lastName, String password, int enabled, int type, String email, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Sets the properties of a given user using the id to search for it- Specified by:
setUserProperties
in interfaceKuwaibaSoapWebService
- Parameters:
oid
- User idusername
- New user's name. Use null to leave it unchanged.firstName
- New user's first name. Use null to leave it unchangedlastName
- New user's last name. Use null to leave it unchangedpassword
- New user's password. Use null to leave it unchangedenabled
- 0 for false, 1 for true, -1 to leave it unchangedtype
- User type. See UserProfile.USER_TYPE* for possible values. Use -1 to leave it unchangedemail
- New user's emailsessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the username is null or empty or the username already exists, if the user type is invalid or if the password is an empty string, or if it is attempted to change the user name of the admin user name, or if this operation is attempted on a system user. Also, if the new user type is invalid.
-
addUserToGroup
public void addUserToGroup(long userId, long groupId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Adds a user to a group- Specified by:
addUserToGroup
in interfaceKuwaibaSoapWebService
- Parameters:
userId
- The id of the user to be added to the groupgroupId
- Id of the group which the user will be added tosessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the user is already related to that group or if the user or group can not be found.
-
removeUserFromGroup
public void removeUserFromGroup(long userId, long groupId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Removes a user from a group- Specified by:
removeUserFromGroup
in interfaceKuwaibaSoapWebService
- Parameters:
userId
- The id of the user to be added to the groupgroupId
- Id of the group which the user will be added tosessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the user is not related to that group or if the user or the group could not be found
-
setPrivilegeToUser
public void setPrivilegeToUser(long userId, String featureToken, int accessLevel, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Sets a privilege to a user. If the privilege already exists, the access level is updated, otherwise, the new privilege is added to the user.- Specified by:
setPrivilegeToUser
in interfaceKuwaibaSoapWebService
- Parameters:
userId
- The user IdfeatureToken
- The feature token. See class Privilege for details. Note that this token must match to the one expected by the client application. That's the only way the correct features will be enabled.accessLevel
- The feature token. See class Privilege.ACCESS_LEVEL* for details.sessionId
- Session token- Throws:
ServerSideException
- If the access level is invalid, if the featureToken has a wrong format or if the user already has that privilege or if the user could not be found.
-
setPrivilegeToGroup
public void setPrivilegeToGroup(long groupId, String featureToken, int accessLevel, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Sets a privilege to a group. If the privilege already exists, the access level is updated, otherwise, the new privilege is added to the group.- Specified by:
setPrivilegeToGroup
in interfaceKuwaibaSoapWebService
- Parameters:
groupId
- The user IdfeatureToken
- The feature token. See class Privilege for details. Note that this token must match to the one expected by the client application. That's the only way the correct features will be enabled.accessLevel
- The feature token. See class Privilege.ACCESS_LEVEL* for details.sessionId
- Session token- Throws:
ServerSideException
- If the access level is invalid, if the featureToken has a wrong format or if the group already has that privilege or if the group could not be found
-
removePrivilegeFromUser
public void removePrivilegeFromUser(long userId, String featureToken, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Removes a privilege from a user- Specified by:
removePrivilegeFromUser
in interfaceKuwaibaSoapWebService
- Parameters:
userId
- Id of the userfeatureToken
- The feature token. See class Privilege for details.sessionId
- Session token- Throws:
ServerSideException
- If the feature token is not related to the user or if the user could not be found
-
removePrivilegeFromGroup
public void removePrivilegeFromGroup(long groupId, String featureToken, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Removes a privilege from a user- Specified by:
removePrivilegeFromGroup
in interfaceKuwaibaSoapWebService
- Parameters:
groupId
- Id of the groupfeatureToken
- The feature token. See class Privilege for details.sessionId
- Session token- Throws:
ServerSideException
- If the feature token is not related to the group or if the group could not be found
-
createGroup
public long createGroup(String groupName, String description, List<Long> users, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a group- Specified by:
createGroup
in interfaceKuwaibaSoapWebService
- Parameters:
groupName
- Group namedescription
- Group descriptionusers
- List of user ids to be related to this groupsessionId
- Session token- Returns:
- The group id
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If any of the provided users could not be found
-
setGroupProperties
public void setGroupProperties(long oid, String groupName, String description, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Sets the properties for an existing group- Specified by:
setGroupProperties
in interfaceKuwaibaSoapWebService
- Parameters:
oid
- Group idgroupName
- New group name (null if unchanged)description
- New group description (null if unchanged)sessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method If any of the privileges ids is invalid. If the group could not be found.
-
deleteUsers
public void deleteUsers(List<Long> oids, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a list of users- Specified by:
deleteUsers
in interfaceKuwaibaSoapWebService
- Parameters:
oids
- List of user ids to be deletedsessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method If any of the users is the default administrator, which can't be deleted Generic exception encapsulating any possible error raised at runtime
-
deleteGroups
public void deleteGroups(List<Long> oids, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a list of groups- Specified by:
deleteGroups
in interfaceKuwaibaSoapWebService
- Parameters:
oids
- list of group ids to be deletedsessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the group you are trying to delete contains the default administrator Generic exception encapsulating any possible error raised at runtime
-
getObjectRelatedView
public RemoteViewObject getObjectRelatedView(String oid, String objectClass, long viewId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets a particular view related to an object- Specified by:
getObjectRelatedView
in interfaceKuwaibaSoapWebService
- Parameters:
oid
- Object idobjectClass
- Object classviewId
- The view idsessionId
- Session token- Returns:
- The View object (which is basically an XML document)
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the object or the view can not be found If the corresponding class metadata can not be found If the provided view type is not supported
-
getObjectRelatedViews
public List<RemoteViewObjectLight> getObjectRelatedViews(String oid, String objectClass, int viewType, int limit, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Returns list of views associated to an object- Specified by:
getObjectRelatedViews
in interfaceKuwaibaSoapWebService
- Parameters:
oid
- Object idobjectClass
- Object classviewType
- View typelimit
- Max number of resultssessionId
- Session token- Returns:
- List of objects related to the object
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the object can not be found If the corresponding class metadata can not be found If the provided view type is not supported
-
getGeneralViews
public RemoteViewObjectLight[] getGeneralViews(String viewClass, int limit, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets all views that are not related to a particular object- Specified by:
getGeneralViews
in interfaceKuwaibaSoapWebService
- Parameters:
viewClass
- View class. Used to filterlimit
- Max number if resultssessionId
- Session token- Returns:
- A list of views
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the view class does not exist If the user is not allowed to query for general views
-
getGeneralView
public RemoteViewObject getGeneralView(long viewId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the information of a particular view- Specified by:
getGeneralView
in interfaceKuwaibaSoapWebService
- Parameters:
viewId
- View idsessionId
- Session token- Returns:
- The view
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the requested view
-
createListTypeItemRelatedView
public long createListTypeItemRelatedView(String listTypeItemId, String listTypeItemClassName, String viewClassName, String name, String description, byte[] structure, byte[] background, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a view for a given list type item. If there's already a view of the provided view type, it will be overwritten- Specified by:
createListTypeItemRelatedView
in interfaceKuwaibaSoapWebService
- Parameters:
listTypeItemId
- list type item idlistTypeItemClassName
- list type item class nameviewClassName
- view class namename
- view namedescription
- view descriptionstructure
- XML document with the view structurebackground
- background imagesessionId
- Session token- Returns:
- The id of the new view.
- Throws:
ServerSideException
- If the list type item class can not be found If the view type is not supported
-
updateListTypeItemRelatedView
public void updateListTypeItemRelatedView(String listTypeItemId, String listTypeItemClass, long viewId, String name, String description, byte[] structure, byte[] background, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Updates a view for a given list type item. If there's already a view of the provided view type, it will be overwritten- Specified by:
updateListTypeItemRelatedView
in interfaceKuwaibaSoapWebService
- Parameters:
listTypeItemId
- list type item idlistTypeItemClass
- list type item classviewId
- viewIdname
- view namedescription
- view descriptionstructure
- XML document with the view structurebackground
- Background image. If null, the previous will be removed, if 0-sized array, it will remain unchangedsessionId
- Session token- Throws:
ServerSideException
- If the list type item can not be found If the list type item class can not be found If the view type is not supported
-
getListTypeItemRelatedView
public RemoteViewObject getListTypeItemRelatedView(String listTypeItemId, String listTypeItemClass, long viewId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets a view related to a list type item, given its id. An example of these views is a layout associated to a particular device model- Specified by:
getListTypeItemRelatedView
in interfaceKuwaibaSoapWebService
- Parameters:
listTypeItemId
- list type item idlistTypeItemClass
- list type item classviewId
- view idsessionId
- Session token- Returns:
- The associated view (there should be only one of each type). Null if there's none yet
- Throws:
ServerSideException
- If the list type item or the view can not be found. If the corresponding class metadata can not be found. If the provided view type is not supported.
-
getListTypeItemRelatedViews
public RemoteViewObjectLight[] getListTypeItemRelatedViews(String listTypeItemId, String listTypeItemClass, int limit, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets all the views related to a list type item. An example of these views is a layout associated to a particular device model- Specified by:
getListTypeItemRelatedViews
in interfaceKuwaibaSoapWebService
- Parameters:
listTypeItemId
- list type item idlistTypeItemClass
- list type class namelimit
- max number of resultssessionId
- Session token- Returns:
- The associated views
- Throws:
ServerSideException
- If the corresponding class metadata can not be found If the provided view type is not supported
-
deleteListTypeItemRelatedView
public void deleteListTypeItemRelatedView(String listTypeItemId, String listTypeItemClass, long viewId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a view related to a list type item- Specified by:
deleteListTypeItemRelatedView
in interfaceKuwaibaSoapWebService
- Parameters:
listTypeItemId
- list type item idlistTypeItemClass
- list type class nameviewId
- related view idsessionId
- Session token- Throws:
ServerSideException
- If the list type item class can not be found If the list type item can no be found using the id If the view can not be found
-
getDeviceLayouts
public List<RemoteObjectLight> getDeviceLayouts(String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the list of template elements with a device layout- Specified by:
getDeviceLayouts
in interfaceKuwaibaSoapWebService
- Parameters:
sessionId
- Session id token- Returns:
- the list of template elements with a device layout
- Throws:
ServerSideException
-
getDeviceLayoutStructure
public byte[] getDeviceLayoutStructure(String oid, String className, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the device layout structure- Specified by:
getDeviceLayoutStructure
in interfaceKuwaibaSoapWebService
- Parameters:
oid
- object idclassName
- class of objectsessionId
- Session id token- Returns:
- the structure of the device layout
- Throws:
ServerSideException
-
createObjectRelatedView
public long createObjectRelatedView(String objectId, String objectClass, String name, String description, String viewClassName, byte[] structure, byte[] background, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a view an relates it to an existing object- Specified by:
createObjectRelatedView
in interfaceKuwaibaSoapWebService
- Parameters:
objectId
- Object idobjectClass
- Object classname
- View namedescription
- View descriptionviewClassName
- View class namestructure
- Structure (as an XML document)background
- BackgroundsessionId
- Session id- Returns:
- The id of the newly created view
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the object can not be found If the object class can not be found If the view type is not supported
-
createGeneralView
public long createGeneralView(String viewClass, String name, String description, byte[] structure, byte[] background, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a general view (a view that is not associated to any object)- Specified by:
createGeneralView
in interfaceKuwaibaSoapWebService
- Parameters:
viewClass
- View classname
- View namedescription
- Descriptionstructure
- Structurebackground
- backgroundsessionId
- Session id- Returns:
- The id of the newly created view
- Throws:
ServerSideException
- If the user is not allowed to invoke the method InvalidArgumentException if the view type is invalid
-
updateObjectRelatedView
public void updateObjectRelatedView(String objectOid, String objectClass, long viewId, String viewName, String viewDescription, byte[] structure, byte[] background, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Updates an object view (a view that is linked to a particular object)- Specified by:
updateObjectRelatedView
in interfaceKuwaibaSoapWebService
- Parameters:
objectOid
- Object idobjectClass
- Object classviewId
- View idviewName
- View name. Null to leave unchangedviewDescription
- View description. Null to leave unchangedstructure
- View structure. Null to leave unchangedbackground
- Background. Null to leave unchangedsessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the view type is not supported
-
updateGeneralView
public void updateGeneralView(long viewId, String viewName, String viewDescription, byte[] structure, byte[] background, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Updates a general view (a view that is not linked to any particular object)- Specified by:
updateGeneralView
in interfaceKuwaibaSoapWebService
- Parameters:
viewId
- View idviewName
- View name. Null to leave unchangedviewDescription
- View Description. Null to leave unchangedstructure
- View structure. Null to leave unchangedbackground
- Background. Null to leave unchangedsessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the view type is invalid or if the background could not be saved. If the view couldn't be found
-
deleteGeneralView
public void deleteGeneralView(List<Long> oids, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes views- Specified by:
deleteGeneralView
in interfaceKuwaibaSoapWebService
- Parameters:
oids
- Ids of the views to be deletedsessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the view can't be found
-
createListTypeItem
public String createListTypeItem(String className, String name, String displayName, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a list type item- Specified by:
createListTypeItem
in interfaceKuwaibaSoapWebService
- Parameters:
className
- List type item class namename
- List type item namedisplayName
- List type item display namesessionId
- Session token- Returns:
- the id of the new object
- Throws:
ServerSideException
- If the class provided is not a list type If the class is abstract or marked as in design.
-
updateListTypeItem
public void updateListTypeItem(String className, String oid, List<StringPair> attributesToBeUpdated, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Updates a list type item. Formerly this functionality was provided by updateObject, but the implementation was split in two methods.- Specified by:
updateListTypeItem
in interfaceKuwaibaSoapWebService
- Parameters:
className
- The class of the LTI to be updated. it must be a subclass of GenericObjectListoid
- The id of the LTI to be updated.attributesToBeUpdated
- The attributes to be changed.sessionId
- The session token.- Throws:
ServerSideException
- If the LTI does not exist or if the class provided is not a subclass of GenericObjectList.
-
deleteListTypeItem
public void deleteListTypeItem(String className, String oid, boolean releaseRelationships, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a list type item- Specified by:
deleteListTypeItem
in interfaceKuwaibaSoapWebService
- Parameters:
className
- list type item class nameoid
- list type item idreleaseRelationships
- should the deletion process release the relationships attached to this objectsessionId
- Session token- Throws:
ServerSideException
- If the class provided is not a list type If the user can't delete a list type item
-
getListTypeItems
public List<RemoteObjectLight> getListTypeItems(String className, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves all items for a single list type- Specified by:
getListTypeItems
in interfaceKuwaibaSoapWebService
- Parameters:
className
- The list type classsessionId
- Session token- Returns:
- a list of list type items
- Throws:
ServerSideException
- If className is not an existing class If the class provided is not a list type
-
getListTypeItem
public RemoteObject getListTypeItem(String listTypeClassName, String listTypeItemId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves list type item given its id- Specified by:
getListTypeItem
in interfaceKuwaibaSoapWebService
- Parameters:
listTypeClassName
- The class name of list type itemlistTypeItemId
- The id of list type itemsessionId
- Session token- Returns:
- A RemoteBusinessObject instance representing the item
- Throws:
ServerSideException
- If className is not an existing class If the class provided is not a list type
-
getInstanceableListTypes
public RemoteClassMetadataLight[] getInstanceableListTypes(String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves all possible list types- Specified by:
getInstanceableListTypes
in interfaceKuwaibaSoapWebService
- Parameters:
sessionId
- Session token- Returns:
- A list of list types as ClassInfoLight instances
- Throws:
ServerSideException
- If the GenericObjectList class does not exist
-
executeQuery
public RemoteResultRecord[] executeQuery(TransientQuery query, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Executes a complex query generated using the Graphical Query Builder. Please note that the first record is reserved for the column headers, so and empty result set will have at least one record.- Specified by:
executeQuery
in interfaceKuwaibaSoapWebService
- Parameters:
query
- The TransientQuery object (a code friendly version of the graphical query designed at client side).sessionId
- session id to check permissions- Returns:
- An array of records (the first raw is used to put the headers)
- Throws:
ServerSideException
- If the class to be search is cannot be found If the user is not allowed to invoke the method
-
createQuery
public long createQuery(String queryName, long ownerOid, byte[] queryStructure, String description, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a query using the Graphical Query Builder- Specified by:
createQuery
in interfaceKuwaibaSoapWebService
- Parameters:
queryName
- Query nameownerOid
- OwnerOid. Null if publicqueryStructure
- XML document as a byte arraydescription
- a short descriptions for the querysessionId
- session id to check permissions- Returns:
- a RemoteObjectLight wrapping the newly created query
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the owner could not be found.
-
saveQuery
public void saveQuery(long queryOid, String queryName, long ownerOid, byte[] queryStructure, String description, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Save the query made in the graphical Query builder- Specified by:
saveQuery
in interfaceKuwaibaSoapWebService
- Parameters:
queryOid
- query oid to be updatedqueryName
- query name (the same if unchanged)ownerOid
- owneroid (if unchanged)queryStructure
- XML document if unchanged. Null otherwisedescription
- Query description. Null if unchangedsessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the query can not be found
-
deleteQuery
public void deleteQuery(long queryOid, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a query- Specified by:
deleteQuery
in interfaceKuwaibaSoapWebService
- Parameters:
queryOid
- Query idsessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the query could not be found
-
getQueries
public RemoteQueryLight[] getQueries(boolean showPublic, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves all saved queries- Specified by:
getQueries
in interfaceKuwaibaSoapWebService
- Parameters:
showPublic
- should this method return the public queries along with the private to this user?sessionId
- Session token- Returns:
- A list with the available queries
- Throws:
ServerSideException
- If the user is not allowed to invoke the method Generic exception encapsulating any possible error raised at runtime
-
getQuery
public RemoteQuery getQuery(long queryOid, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves a saved query- Specified by:
getQuery
in interfaceKuwaibaSoapWebService
- Parameters:
queryOid
- Query idsessionId
- Session token- Returns:
- The query
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the query could not be found
-
getClassHierarchy
public byte[] getClassHierarchy(boolean showAll, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates an XML document describing the class hierarchy- Specified by:
getClassHierarchy
in interfaceKuwaibaSoapWebService
- Parameters:
showAll
- should this method return all entity classes or only InventoryObject subclassessessionId
- session identifier- Returns:
- A byte array containing the class hierarchy as an XML document.
- Throws:
ServerSideException
- If one of the core classes could not be found
-
createRootPool
public String createRootPool(String name, String description, String instancesOfClass, int type, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a pool without a parent. They're used as general purpose place to put inventory objects, or as root for particular models- Specified by:
createRootPool
in interfaceKuwaibaSoapWebService
- Parameters:
name
- Pool namedescription
- Pool descriptioninstancesOfClass
- What kind of objects can this pool contain?type
- Type of pool. For possible values see ApplicationManager.POOL_TYPE_XXXsessionId
- The session token- Returns:
- The id of the new pool
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the log root node could not be found
-
createPoolInObject
public String createPoolInObject(String parentClassname, String parentId, String name, String description, String instancesOfClass, int type, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a pool that will have as parent an inventory object. This special containment structure can be used to provide support for new models- Specified by:
createPoolInObject
in interfaceKuwaibaSoapWebService
- Parameters:
parentClassname
- Class name of the parent objectparentId
- Id of the parent objectname
- Pool namedescription
- Pool descriptionCreates a pool that will have as parent an inventory object. This special containment structure can be used to provide support for new modelsinstancesOfClass
- What kind of objects can this pool contain?type
- Type of pool. For possible values see ApplicationManager.POOL_TYPE_XXXsessionId
- The session token- Returns:
- The id of the new pool
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If instancesOfClass is not a valid subclass of InventoryObject If the parent object can not be found
-
createPoolInPool
public String createPoolInPool(String parentId, String name, String description, String instancesOfClass, int type, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a pool that will have as parent another pool. This special containment structure can be used to provide support for new models- Specified by:
createPoolInPool
in interfaceKuwaibaSoapWebService
- Parameters:
parentId
- Id of the parent poolname
- Pool namedescription
- Pool descriptioninstancesOfClass
- What kind of objects can this pool contain?type
- Type of pool. Not used so far, but it will be in the future. It will probably be used to help organize the existing poolssessionId
- The session token- Returns:
- The id of the new pool
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If instancesOfClass is not a valid subclass of InventoryObject If the parent object can not be found
-
createPoolItem
public String createPoolItem(String poolId, String className, String[] attributeNames, String[] attributeValues, String templateId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates an object within a pool- Specified by:
createPoolItem
in interfaceKuwaibaSoapWebService
- Parameters:
poolId
- Id of the pool under which the object will be createdclassName
- Class this object is going to be instance ofattributeNames
- Attributes to be set in the new object. Null or empty array for noneattributeValues
- Attributes to be set in the new object (values). Null for none. The size of this array must match attributeNames sizetemplateId
- Template to be used. Use -1 to not use any templatesessionId
- Session identifier- Returns:
- The id of the newly created object
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If attributeNames and attributeValues have different sizes If the class name could not be found
-
deletePools
public void deletePools(String[] ids, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a set of pools- Specified by:
deletePools
in interfaceKuwaibaSoapWebService
- Parameters:
ids
- Pools to be deletedsessionId
- Session identifier- Throws:
ServerSideException
- If the user is not allowed to invoke the method If any of the pools to be deleted couldn't be found If any of the objects in the pool can not be deleted because it's not a business related instance (it's more a security restriction)
-
getRootPools
public List<RemotePool> getRootPools(String className, int type, boolean includeSubclasses, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves the pools that don't have any parent and are normally intended to be managed by the Pool Manager- Specified by:
getRootPools
in interfaceKuwaibaSoapWebService
- Parameters:
className
- The class name used to filter the results. Only the pools with a className attribute matching the provided value will be returned. Use null if you want to get alltype
- The type of pools that should be retrieved. Root pools can be for general purpose, or as roots in modelsincludeSubclasses
- Usetrue
if you want to get only the pools whoseclassName
property matches exactly the one provided, andfalse
if you want to also include the subclassessessionId
- Session token- Returns:
- A set of pools
- Throws:
ServerSideException
- If the user is not allowed to invoke the method or in case something goes wrong
-
getPoolsInObject
public List<RemotePool> getPoolsInObject(String objectClassName, String objectId, String poolClass, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves all the pools that are children of a particular object.- Specified by:
getPoolsInObject
in interfaceKuwaibaSoapWebService
- Parameters:
objectClassName
- Object class.objectId
- Object id.poolClass
- Type of the pools that are to be retrieved (that is, the class of the objects contained within the pool)sessionId
- Session id.- Returns:
- A list of children pools.
- Throws:
ServerSideException
- If the user is not allowed to invoke the method or if the parent object can not be found or if the argumentpoolClass
is not a valid class.
-
getPoolsInPool
public List<RemotePool> getPoolsInPool(String parentPoolId, String poolClass, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the pools contained inside a pool.- Specified by:
getPoolsInPool
in interfaceKuwaibaSoapWebService
- Parameters:
parentPoolId
- Parent pool id.poolClass
- Class of the objects contained by the desired pool (not the parent pool).sessionId
- Session token.- Returns:
- A list of children pools
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the parent object can not be found
-
getPool
public RemotePool getPool(String poolId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves information about a particular pool- Specified by:
getPool
in interfaceKuwaibaSoapWebService
- Parameters:
poolId
- The id of the poolsessionId
- The session token- Returns:
- The pool object
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the pool could not be found
-
setPoolProperties
public void setPoolProperties(String poolId, String name, String description, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Updates pool name and description- Specified by:
setPoolProperties
in interfaceKuwaibaSoapWebService
- Parameters:
poolId
- Pool Idname
- Pool namedescription
- Pool descriptionsessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method Generic exception encapsulating any possible error raised at runtime
-
getPoolItems
public List<RemoteObjectLight> getPoolItems(String poolId, int limit, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the objects contained into a pool- Specified by:
getPoolItems
in interfaceKuwaibaSoapWebService
- Parameters:
poolId
- Parent pool idlimit
- limit of results. -1 to return allsessionId
- Session identifier- Returns:
- The list of items
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the pool id provided is not valid
-
createTask
public long createTask(String name, String description, boolean enabled, boolean commitOnExecute, String script, List<StringPair> parameters, RemoteTaskScheduleDescriptor schedule, RemoteTaskNotificationDescriptor notificationType, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates and schedule a task. A task is an application entity that allows to run jobs that will be executed depending on certain schedule- Specified by:
createTask
in interfaceKuwaibaSoapWebService
- Parameters:
name
- Task namedescription
- Task descriptionenabled
- Is the task enabled?commitOnExecute
- Should this task commit the changes (if any) after its execution? Handle with extreme care, you are basically running arbitrary code and affecting the dbscript
- The script to be executedparameters
- The parameters for the scriptschedule
- When the task should be executednotificationType
- How the result of the task should be notified to the associated userssessionId
- The session token- Returns:
- The id of the newly created task
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the task is disabled If something goes wrong
-
updateTaskProperties
public void updateTaskProperties(long taskId, String propertyName, String propertyValue, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Updates any of these properties from a task: name, description, enabled and script- Specified by:
updateTaskProperties
in interfaceKuwaibaSoapWebService
- Parameters:
taskId
- Task idpropertyName
- Property name. Possible values: "name", "description", "enabled" and "script"propertyValue
- The value of the property. For the property "enabled", the allowed values are "true" and "false"sessionId
- The session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the task could not be found If the property name has an invalid value
-
updateTaskParameters
public void updateTaskParameters(long taskId, List<StringPair> parameters, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Updates the parameters of a task. If any of the values is null, that parameter will be deleted, if the parameter does not exist, it will be created- Specified by:
updateTaskParameters
in interfaceKuwaibaSoapWebService
- Parameters:
taskId
- Task idparameters
- The parameters to be modified as pairs paramName/paramValue. A null value means that that parameter should be deletedsessionId
- The session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the task could not be found
-
updateTaskSchedule
public void updateTaskSchedule(long taskId, RemoteTaskScheduleDescriptor schedule, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Updates a task schedule- Specified by:
updateTaskSchedule
in interfaceKuwaibaSoapWebService
- Parameters:
taskId
- Task idschedule
- New schedulesessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the task could not be found
-
updateTaskNotificationType
public void updateTaskNotificationType(long taskId, RemoteTaskNotificationDescriptor notificationType, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Updates a task notification type- Specified by:
updateTaskNotificationType
in interfaceKuwaibaSoapWebService
- Parameters:
taskId
- Task idnotificationType
- New notification typesessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the task could not be found
-
getTask
public RemoteTask getTask(long taskId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves the information about a particular task- Specified by:
getTask
in interfaceKuwaibaSoapWebService
- Parameters:
taskId
- Id of the tasksessionId
- Session token- Returns:
- A remote task object representing the task
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the task could not be found
-
getTasks
public List<RemoteTask> getTasks(String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets all the registered tasks- Specified by:
getTasks
in interfaceKuwaibaSoapWebService
- Parameters:
sessionId
- Session token- Returns:
- A list of task objects
- Throws:
ServerSideException
- If the user is not allowed to invoke the method or in case something goes wrong
-
getTasksForUser
public List<RemoteTask> getTasksForUser(long userId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets all the tasks related to a particular user- Specified by:
getTasksForUser
in interfaceKuwaibaSoapWebService
- Parameters:
userId
- User idsessionId
- Session token- Returns:
- A list of task objects
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the user can not be found
-
getSubscribersForTask
public List<RemoteUserInfoLight> getSubscribersForTask(long taskId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the users subscribed to a particular task.- Specified by:
getSubscribersForTask
in interfaceKuwaibaSoapWebService
- Parameters:
taskId
- Task id.sessionId
- Session token.- Returns:
- The list of subscribed users.
- Throws:
ServerSideException
- If the user is not allowed to invoke the method Id the task could not be found
-
deleteTask
public void deleteTask(long taskId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a task and unsubscribes all users from it- Specified by:
deleteTask
in interfaceKuwaibaSoapWebService
- Parameters:
taskId
- Task idsessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the task could not be found
-
subscribeUserToTask
public void subscribeUserToTask(long userId, long taskId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Subscribes a user to a task, so it will be notified of the result of its execution- Specified by:
subscribeUserToTask
in interfaceKuwaibaSoapWebService
- Parameters:
userId
- Id of the usertaskId
- Id of the tasksessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the user is already subscribed to the task
-
unsubscribeUserFromTask
public void unsubscribeUserFromTask(long userId, long taskId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Unsubscribes a user from a task, so it will no longer be notified about the result of its execution- Specified by:
unsubscribeUserFromTask
in interfaceKuwaibaSoapWebService
- Parameters:
userId
- Id of the usertaskId
- Id of the tasksessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the task or the user could not be found
-
executeTask
public RemoteTaskResult executeTask(long taskId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Executes a task on demand.- Specified by:
executeTask
in interfaceKuwaibaSoapWebService
- Parameters:
taskId
- The task idsessionId
- The session token- Returns:
- A RemoteTaskResult object wrapping the task execution messages and details.
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the task doesn't have a script
-
createContact
public String createContact(String contactClass, List<StringPair> properties, String customerClassName, String customerId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a contact- Specified by:
createContact
in interfaceKuwaibaSoapWebService
- Parameters:
contactClass
- The class of the new contact. It must be a subclass of GenericContactproperties
- A dictionary (key-value list) with the set of string-type attributes to be set. No string-type attributes are not currently supported. Attribute name is mandatory.customerClassName
- The class of the customer this contact will be associated tocustomerId
- The id of the customer this contact will be associated tosessionId
- The session token- Returns:
- The id of the newly created contact
- Throws:
ServerSideException
- If the contact class provided is not a valid GenericCustomer, or if the customer does not exist or if any of the properties does not exist or its type is invalid (not a string)
-
updateContact
public void updateContact(String contactClass, String contactId, List<StringPair> properties, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Updates a set of properties of a contact- Specified by:
updateContact
in interfaceKuwaibaSoapWebService
- Parameters:
contactClass
- The class of the contact to be updatedcontactId
- The id of the contact to be updatedproperties
- A set of pairs key-value with the properties to be updatedsessionId
- The session token- Throws:
ServerSideException
- If the contact could not be found or if any of the attributes to be set could not be found or has an invalid value
-
deleteContact
public void deleteContact(String contactClass, String contactId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a contact- Specified by:
deleteContact
in interfaceKuwaibaSoapWebService
- Parameters:
contactClass
- The class of the contact to be deletedcontactId
- The id of the contact to be deletedsessionId
- The session token- Throws:
ServerSideException
- If the contact was not found
-
getContact
public RemoteContact getContact(String contactClass, String contactId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the whole information about a contact- Specified by:
getContact
in interfaceKuwaibaSoapWebService
- Parameters:
contactClass
- The class of the contactcontactId
- The id of the contactsessionId
- The session token- Returns:
- The contact object
- Throws:
ServerSideException
- If the contact could not be found
-
searchForContacts
public List<RemoteContact> searchForContacts(String searchString, int maxResults, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Searches for contacts given a search string, This string will be searched in the attribute values of all contacts- Specified by:
searchForContacts
in interfaceKuwaibaSoapWebService
- Parameters:
searchString
- The string to be searched. Use null or an empty string to retrieve all the contactsmaxResults
- Maximum number of results. Use -1 to retrieve all results at oncesessionId
- The session token- Returns:
- The list of contacts for whom at least one of their attributes matches
- Throws:
ServerSideException
- If the contact could not be found
-
getContactsForCustomer
public List<RemoteContact> getContactsForCustomer(String customerClass, String customerId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves the contacts associated to a given customer- Specified by:
getContactsForCustomer
in interfaceKuwaibaSoapWebService
- Parameters:
customerClass
- The class of the customer to get the contacts fromcustomerId
- The id of the customer to get the contacts fromsessionId
- The session token- Returns:
- The list of contacts associated to the customer
- Throws:
ServerSideException
- If the customer could not be found
-
getContacts
public List<RemoteContact> getContacts(int page, int limit, List<StringPair> filters, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves the list of contacts that matches the search criteria- Specified by:
getContacts
in interfaceKuwaibaSoapWebService
- Parameters:
page
- current pagelimit
- limit of results per page. -1 to retrieve them allfilters
- The response may be filtered by customer (use keycustomer
, value the customer name, a String) by type (use keytype
, value the type name, a String) by contact name (use keycontact_name
, value the contact name, a String) by contact email1 (use keycontact_email1
, value the contact email1, a String) by contact email2 (use keycontact_email2
, value the contact email2, a String)sessionId
- The session token- Returns:
- The list of contacts that matches the search criteria
- Throws:
ServerSideException
- If an error occurs while building the contact objects
-
createConfigurationVariable
public long createConfigurationVariable(String configVariablesPoolId, String name, String description, int type, boolean masked, String valueDefinition, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a configuration variable inside a pool. A configuration variable is a place where a value will be stored so it can retrieved by whomever need it. These variables are typically used to store values that help other modules to work, such as URLs, user names, dimensions, etc- Specified by:
createConfigurationVariable
in interfaceKuwaibaSoapWebService
- Parameters:
configVariablesPoolId
- The id of the pool where the config variable will be putname
- The name of the pool. This value can not be null or empty. Duplicate variable names are not alloweddescription
- The description of the what the variable doestype
- The type of the variable. Use 1 for number, 2 for strings, 3 for booleans, 4 for unidimensional arrays and 5 for matrixes.masked
- If the value should be masked when rendered (for security reasons, for example)valueDefinition
- In most cases (primitive types like numbers, strings or booleans) will be the actual value of the variable as a string (for example "5" or "admin" or "true"). For arrays and matrixes use the following notation:
Arrays: (value1,value2,value3,valueN), matrix: [(row1col1, row1col2,... row1colN), (row2col1, row2col2,... row2colN), (rowNcol1, rowNcol2,... rowNcolN)]. The values will be interpreted as stringssessionId
- The session token- Returns:
- The id of the newly created variable
- Throws:
ServerSideException
- If the parent pool could not be found or if the name is empty, the type is invalid, the value definition is empty
-
updateConfigurationVariable
public void updateConfigurationVariable(String name, String propertyToUpdate, String newValue, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Updates the value of a configuration variable. See ##createConfigurationVariable(long, java.lang.String, java.lang.String, int, boolean, java.lang.String, java.lang.String)
for value definition syntax- Specified by:
updateConfigurationVariable
in interfaceKuwaibaSoapWebService
- Parameters:
name
- The current name of the variable that will be modifiedpropertyToUpdate
- The name of the property to be updated. Possible values are: "name", "description", "type", "masked" and "value"newValue
- The new value as stringsessionId
- The session token- Throws:
ServerSideException
- If the property to be updated can not be recognized or if the configuration variable can not be found
-
deleteConfigurationVariable
public void deleteConfigurationVariable(String name, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a configuration variable- Specified by:
deleteConfigurationVariable
in interfaceKuwaibaSoapWebService
- Parameters:
name
- The name of the variable to be deletedsessionId
- The session token- Throws:
ServerSideException
- If the configuration variable could not be found
-
getConfigurationVariable
public RemoteConfigurationVariable getConfigurationVariable(String name, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves a configuration variable- Specified by:
getConfigurationVariable
in interfaceKuwaibaSoapWebService
- Parameters:
name
- The name of the variable to be retrievedsessionId
- The session token- Returns:
- The configuration variable
- Throws:
ServerSideException
- If the variable could not be found
-
getConfigurationVariableValue
public RemoteObject getConfigurationVariableValue(String name, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves only the value of a configuration variable. Masked values are returned as null.- Specified by:
getConfigurationVariableValue
in interfaceKuwaibaSoapWebService
- Parameters:
name
- The name of the variable. Masked values are returned as null.sessionId
- The session token- Returns:
- The value of the variable as a java object/data type. The numbers are returned as floats.
The arrays and matrixes are returned as
ArrayList<String>
andArrayList
instances respectively - Throws:
ServerSideException
- If the variable could not be found
-
getConfigurationVariablesInPool
public List<RemoteConfigurationVariable> getConfigurationVariablesInPool(String poolId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the configuration variables in a configuration variable pool- Specified by:
getConfigurationVariablesInPool
in interfaceKuwaibaSoapWebService
- Parameters:
poolId
- The id pool to retrieve the variables fromsessionId
- The session token- Returns:
- The list of configuration variables in the given pool
- Throws:
ServerSideException
- If the pool could not be found
-
getConfigurationVariablesWithPrefix
public List<RemoteConfigurationVariable> getConfigurationVariablesWithPrefix(String prefix, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the configuration variables with a given prefix- Specified by:
getConfigurationVariablesWithPrefix
in interfaceKuwaibaSoapWebService
- Parameters:
prefix
- The prefix of the variables namesessionId
- The session token- Returns:
- The list of configuration variables with the given prefix
- Throws:
ServerSideException
- If the prefix could not be found
-
getAllConfigurationVariables
public List<RemoteConfigurationVariable> getAllConfigurationVariables(String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets all the configuration variables in the database, no matter what pool they belong to- Specified by:
getAllConfigurationVariables
in interfaceKuwaibaSoapWebService
- Parameters:
sessionId
- The session token- Returns:
- The list of existing configuration variables
- Throws:
ServerSideException
- In case of an unexpected server side error
-
getConfigurationVariablesPools
public List<RemotePool> getConfigurationVariablesPools(String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves the list of pools of configuration variables.- Specified by:
getConfigurationVariablesPools
in interfaceKuwaibaSoapWebService
- Parameters:
sessionId
- The session token.- Returns:
- The available pools of configuration variables.
- Throws:
ServerSideException
- If an unexpected error occurred.
-
createConfigurationVariablesPool
public String createConfigurationVariablesPool(String name, String description, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a pool of configuration variables.- Specified by:
createConfigurationVariablesPool
in interfaceKuwaibaSoapWebService
- Parameters:
name
- The name of the pool. Empty or null values are not allowed.description
- The description of the pool.sessionId
- The session token.- Returns:
- The id of the newly created pool.
- Throws:
ServerSideException
- If the name provided is null or empty.
-
updateConfigurationVariablesPool
public void updateConfigurationVariablesPool(String poolId, String propertyToUpdate, String value, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Updates an attribute of a given configuration variables pool.- Specified by:
updateConfigurationVariablesPool
in interfaceKuwaibaSoapWebService
- Parameters:
poolId
- The id of the pool to update.propertyToUpdate
- The property to update. The valid values are "name" and "description".value
- The value of the property to be updated.sessionId
- The session token.- Throws:
ServerSideException
- If the pool could not be found or If the property provided is not valid.
-
deleteConfigurationVariablesPool
public void deleteConfigurationVariablesPool(String poolId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a configuration variables pool. Deleting a pool also deletes the configuration variables contained within.- Specified by:
deleteConfigurationVariablesPool
in interfaceKuwaibaSoapWebService
- Parameters:
poolId
- The id of the pool to be deleted.sessionId
- The session token.- Throws:
ServerSideException
- If the pool could not be found.
-
createProxy
public String createProxy(String proxyPoolId, String proxyClass, List<StringPair> attributes, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates an inventory proxy. Inventory proxies are used to integrate third party-applications with Kuwaiba. Sometimes these applications must refer to assets managed by Kuwaiba from another perspective (financial, for example). In these applications, multiple Kuwaiba inventory assets might be represented by a single entity (e.g. a router with slots, boards and ports might just be something like "standard network device"). Proxies are used to map multiple inventory elements into a single entity. It's a sort of "impedance matching" between systems that refer to the same real world object from different perspectives.- Specified by:
createProxy
in interfaceKuwaibaSoapWebService
- Parameters:
proxyPoolId
- The parent pool id.proxyClass
- The proxy class. Must be subclass of GenericProxy.attributes
- The set of initial attributes. If no attributename
is specified, an empty string will be used.sessionId
- Session token.- Returns:
- The id of the newly created proxy.
- Throws:
ServerSideException
- If the parent pool could not be found or if any of the initial attributes could not be mapped or if the proxy class could not be found.
-
deleteProxy
public void deleteProxy(String proxyClass, String proxyId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a proxy and delete its association with the related inventory objects. These objects will remain untouched.- Specified by:
deleteProxy
in interfaceKuwaibaSoapWebService
- Parameters:
proxyClass
- The class of the proxy.proxyId
- The id of the proxysessionId
- Session token.- Throws:
ServerSideException
- If the proxy could not be found or if the proxy class could not be found.
-
updateProxy
public void updateProxy(String proxyClass, String proxyId, List<StringPair> attributes, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Updates one or many proxy attributes.- Specified by:
updateProxy
in interfaceKuwaibaSoapWebService
- Parameters:
proxyClass
- The class of the proxy.proxyId
- The parent pool id,attributes
- The set of initial attributes. If no attributename
is specified, an empty string will be used.sessionId
- Session token.- Throws:
ServerSideException
- If the parent pool could not be found or if any of the initial attributes could not be mapped or if the proxy class could not be found.
-
createProxyPool
public String createProxyPool(String name, String description, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a proxy pool.- Specified by:
createProxyPool
in interfaceKuwaibaSoapWebService
- Parameters:
name
- The name of the pool.description
- The description of the pool.sessionId
- Session token.- Returns:
- The id of the newly created proxy.
- Throws:
ServerSideException
- In case something unexpected happened.
-
updateProxyPool
public void updateProxyPool(String proxyPoolId, String attributeName, String attributeValue, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Updates an attribute of a proxy pool.- Specified by:
updateProxyPool
in interfaceKuwaibaSoapWebService
- Parameters:
proxyPoolId
- The id of the pool to be updated.attributeName
- The name of the pool attribute to be updated. Valid values are "name" and "description"attributeValue
- The value of the attribute. Null values will be ignored.sessionId
- Session token.- Throws:
ServerSideException
- If the pool could not be found or if an unknown attribute name is provided.
-
deleteProxyPool
public void deleteProxyPool(String proxyPoolId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a proxy pool.- Specified by:
deleteProxyPool
in interfaceKuwaibaSoapWebService
- Parameters:
proxyPoolId
- The id of the pool.sessionId
- Session token.- Throws:
ServerSideException
- If the pool could not be found.
-
getProxyPools
public List<RemotePool> getProxyPools(String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves the list of pools of proxies.- Specified by:
getProxyPools
in interfaceKuwaibaSoapWebService
- Parameters:
sessionId
- Session token.- Returns:
- The available pools of inventory proxies.
- Throws:
ServerSideException
- If case something unexpected happened.
-
getProxiesInPool
public List<RemoteInventoryProxy> getProxiesInPool(String proxyPoolId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the list of inventory proxies in a given pool.- Specified by:
getProxiesInPool
in interfaceKuwaibaSoapWebService
- Parameters:
proxyPoolId
- The id of the parent pool.sessionId
- Session token.- Returns:
- The proxies
- Throws:
ServerSideException
- If the parent pool could not be found or if the object in the database can not be mapped into an InventoryProxy instance.
-
getAllProxies
public List<RemoteInventoryProxy> getAllProxies(String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets all the inventory proxies in the database.- Specified by:
getAllProxies
in interfaceKuwaibaSoapWebService
- Parameters:
sessionId
- Session token.- Returns:
- The list of inventory proxy objects.
- Throws:
ServerSideException
- If any proxy node could not be mapped into a Java object.
-
associateObjectToProxy
public void associateObjectToProxy(String objectClass, String objectId, String proxyClass, String proxyId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Associates an inventory object to an inventory proxy.- Specified by:
associateObjectToProxy
in interfaceKuwaibaSoapWebService
- Parameters:
objectClass
- The class of the object.objectId
- The id of the object.proxyClass
- The class of the proxy.proxyId
- The id of the proxy.sessionId
- Session token.- Throws:
ServerSideException
- If the inventory object could not be found or if the proxy could not be found or if the two entities are already related.
-
releaseObjectFromProxy
public void releaseObjectFromProxy(String objectClass, String objectId, String proxyClass, String proxyId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Releases an inventory previously related to an inventory proxy.- Specified by:
releaseObjectFromProxy
in interfaceKuwaibaSoapWebService
- Parameters:
objectClass
- The class of the object.objectId
- The id of the object.proxyClass
- The class of the proxy.proxyId
- The id of the proxy.sessionId
- Session token.- Throws:
ServerSideException
- If the inventory object could not be found or if the proxy could not be found.
-
createValidatorDefinition
public long createValidatorDefinition(String name, String description, String classToBeApplied, String script, boolean enabled, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a validator definition.- Specified by:
createValidatorDefinition
in interfaceKuwaibaSoapWebService
- Parameters:
name
- The name of the validator. It's recommended to use camel case notation (for example thisIsAName). This field is mandatorydescription
- The optional description of the validatorclassToBeApplied
- The class or super class of the classes whose instances will be checked against this validatorscript
- The groovy script containing the logic of the validator , that is, theenabled
- If this validador should be applied or notsessionId
- The session token- Returns:
- The id of the newly created validator definition
- Throws:
ServerSideException
- If the name is null or empty or if the classToBeApplied argument could not be found
-
updateValidatorDefinition
public void updateValidatorDefinition(long validatorDefinitionId, String name, String description, String classToBeApplied, String script, Boolean enabled, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Updates the properties of a validator. The null values will be ignored- Specified by:
updateValidatorDefinition
in interfaceKuwaibaSoapWebService
- Parameters:
validatorDefinitionId
- The id of teh validator definition to be updatedname
- The new name, if any, null otherwisedescription
- The new description, if any, null otherwiseclassToBeApplied
- The new class to be associated to this validator, if any, null otherwisescript
- The new script, if any, null otherwiseenabled
- If the validator should be enabled or not, if any, null otherwisesessionId
- The session token- Throws:
ServerSideException
- If the validator definition could not be found or if the classToBeApplied parameter is not valid or if the name is not null, but it is empty
-
getValidatorDefinitionsForClass
public List<RemoteValidatorDefinition> getValidatorDefinitionsForClass(String className, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves all the validator definitions inside a class- Specified by:
getValidatorDefinitionsForClass
in interfaceKuwaibaSoapWebService
- Parameters:
className
- The class to retrieve the validator definitions from.sessionId
- The session token- Returns:
- The list of validator definitions
- Throws:
ServerSideException
- In case of an unexpected server side error
-
getAllValidatorDefinitions
public List<RemoteValidatorDefinition> getAllValidatorDefinitions(String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves all the validator definitions in the system- Specified by:
getAllValidatorDefinitions
in interfaceKuwaibaSoapWebService
- Parameters:
sessionId
- The session token- Returns:
- The list of all validator definitions
- Throws:
ServerSideException
- In case of an unexpected server side error
-
runValidationsForObject
public List<RemoteValidator> runValidationsForObject(String objectClass, long objectId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Runs the existing validations for the class associated to the given object. Validators set to enabled = false will be ignored- Specified by:
runValidationsForObject
in interfaceKuwaibaSoapWebService
- Parameters:
objectClass
- The class of the objectobjectId
- The id of the objectsessionId
- The session token- Returns:
- The list of validators associated to the object and its class
- Throws:
ServerSideException
- If the object can not be found
-
deleteValidatorDefinition
public void deleteValidatorDefinition(long validatorDefinitionId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a validator definition- Specified by:
deleteValidatorDefinition
in interfaceKuwaibaSoapWebService
- Parameters:
validatorDefinitionId
- the id of the validator to be deletedsessionId
- The session token- Throws:
ServerSideException
- If the validator definition could not be found
-
getObjectChildrenForClassWithId
public List<RemoteObjectLight> getObjectChildrenForClassWithId(String oid, long objectClassId, int maxResults, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the children of a given object given his class id and object id- Specified by:
getObjectChildrenForClassWithId
in interfaceKuwaibaSoapWebService
- Parameters:
oid
- object's idobjectClassId
- object's class idmaxResults
- Max number of children to be returned. O for allsessionId
- Session token- Returns:
- An array of all the direct children of the provided object according with the current container hierarchy
- Throws:
ServerSideException
- If the class could not be found
-
getObjectChildren
public List<RemoteObjectLight> getObjectChildren(String objectClassName, String oid, int maxResults, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the children of a given object given his class name and object id- Specified by:
getObjectChildren
in interfaceKuwaibaSoapWebService
- Parameters:
objectClassName
- object's class nameoid
- Object's oidmaxResults
- Max number of children to be returned. O for allsessionId
- Session token- Returns:
- An array of all the direct children of the provided object according with the current container hierarchy
- Throws:
ServerSideException
- If the class could not be found.
-
getSiblings
public List<RemoteObjectLight> getSiblings(String objectClassName, String oid, int maxResults, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Returns the siblings of an object in the containment hierarchy- Specified by:
getSiblings
in interfaceKuwaibaSoapWebService
- Parameters:
objectClassName
- Object classoid
- Object oidmaxResults
- Max number of results to be returnedsessionId
- Session token- Returns:
- List of siblings
- Throws:
ServerSideException
- If the class does not exist If the object does not exist
-
getChildrenOfClass
public List<RemoteObject> getChildrenOfClass(String parentOid, String parentClass, String childrenClass, int page, int maxResults, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets all children of an object of a given class- Specified by:
getChildrenOfClass
in interfaceKuwaibaSoapWebService
- Parameters:
parentOid
- Parent whose children are requestedparentClass
- Class name of the element we want the children fromchildrenClass
- The type of children we want to retrievepage
- the number of elements to skip in the querymaxResults
- Max number of children to be returned. O for allsessionId
- Session token- Returns:
- An array with the children objects
- Throws:
ServerSideException
- If any of the classes can not be found If parent object can not be found If the database objects can not be correctly mapped into serializable Java objects.
-
getChildrenOfClassLightRecursive
public List<RemoteObjectLight> getChildrenOfClassLightRecursive(String parentOid, String parentClass, String childrenClass, int maxResults, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets recursively all children of an object of a given class- Specified by:
getChildrenOfClassLightRecursive
in interfaceKuwaibaSoapWebService
- Parameters:
parentOid
- Parent whose children are requestedparentClass
- Class name of the element we want the children fromchildrenClass
- The type of children we want to retrievemaxResults
- Max number of children to be returned. O for allsessionId
- Session token- Returns:
- An array with the children objects
- Throws:
ServerSideException
- If any of the classes can not be found If parent object can not be found If the database objects can not be correctly mapped into serializable Java objects.
-
getChildrenOfClassLight
public List<RemoteObjectLight> getChildrenOfClassLight(String parentOid, String parentClass, String childrenClass, int maxResults, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets all children of an object of a given class- Specified by:
getChildrenOfClassLight
in interfaceKuwaibaSoapWebService
- Parameters:
parentOid
- Object oid whose children will be returnedmaxResults
- Max number of children to be returned. O for allsessionId
- Session token- Returns:
- An array with children
- Throws:
ServerSideException
- If any of the classes can not be found If parent object can not be found
-
getSpecialChildrenOfClassLight
public List<RemoteObjectLight> getSpecialChildrenOfClassLight(String parentOid, String parentClass, String classToFilter, int maxResults, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Returns the special children of a given object as RemoteObjectLight instances. This method is not recursive.- Specified by:
getSpecialChildrenOfClassLight
in interfaceKuwaibaSoapWebService
- Parameters:
parentOid
- The id of the parent object.parentClass
- The class name of the parent object.classToFilter
- The superclass/class to be used to filter the results. You can also use abstract superclasses.maxResults
- The max number of results to fetch. Use -1 to retrieve all.sessionId
- The session token.- Returns:
- The list of special children of the given object, filtered using classToFilter.
- Throws:
ServerSideException
- If the parent class name provided could not be found or if the parent object could not be found.
-
getSpecialChildrenOfClassLightRecursive
public List<RemoteObjectLight> getSpecialChildrenOfClassLightRecursive(String parentOid, String parentClass, String classToFilter, int maxResults, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Returns the special children of a given object as RemoteObjectLight instances in a recursive fashion.- Specified by:
getSpecialChildrenOfClassLightRecursive
in interfaceKuwaibaSoapWebService
- Parameters:
parentOid
- The id of the parent object.parentClass
- The class name of the parent object.classToFilter
- The superclass/class to be used to filter the results. You can also use abstract superclasses.maxResults
- The max number of results to fetch. Use -1 to retrieve all.sessionId
- The session token.- Returns:
- The recursive list of special children of the given object, filtered using classToFilter.
- Throws:
ServerSideException
- If the parent class name provided could not be found or if the parent object could not be found.
-
getObject
public RemoteObject getObject(String objectClass, String oid, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the complete information about a given object (all its attributes)- Specified by:
getObject
in interfaceKuwaibaSoapWebService
- Parameters:
objectClass
- Object classoid
- Object idsessionId
- Session token- Returns:
- a representation of the entity as a RemoteObject. The list of attribute values is a hashmap of strings (should be mapped to actual types by the consumer of the service). Single list types are represented by the id of the list type item (a numeric value), while multiple list types are strings wit the ids of the related list type items separated by semicolons (e.g. 123;786576;92332)
- Throws:
ServerSideException
- If the className class could not be found If the requested object could not be found If the object id could not be found
-
getObjectLight
public RemoteObjectLight getObjectLight(String objectClass, String oid, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the basic information about a given object (oid, classname, name)- Specified by:
getObjectLight
in interfaceKuwaibaSoapWebService
- Parameters:
objectClass
- Object class nameoid
- Object oidsessionId
- Session token- Returns:
- a representation of the entity as a RemoteObjectLight
- Throws:
ServerSideException
- Generic exception encapsulating any possible error raised at runtime
-
getObjectsWithFilterLight
public List<RemoteObjectLight> getObjectsWithFilterLight(String className, String filterName, String filterValue, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves a list of light instances of a given class given a simple filter. This method will search for all objects with a string-based attribute (filterName) whose value matches a value provided (filterValue)- Specified by:
getObjectsWithFilterLight
in interfaceKuwaibaSoapWebService
- Parameters:
className
- The class of the objects to be searched. This method support abstract superclasses as wellfilterName
- The attribute to be used as filter. This will work only with String-type attributes. Example: serialNumber. To list type attributes the filter must be applied to the name. Example: filterName: model, filterValue: XYZfilterValue
- The value to be use to match the instances. Example "Serial-12345"sessionId
- The session token- Returns:
- The list of instances that matches the filterName/filterValue criteria
- Throws:
ServerSideException
- if the class provided could not be found
-
getObjectsWithFilter
public List<RemoteObject> getObjectsWithFilter(String className, String filterName, String filterValue, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Same asKuwaibaSoapWebService.getObjectsWithFilterLight(java.lang.String, java.lang.String, java.lang.String, java.lang.String)
, but returns RemoteObjects instead of RemoteObjectLights- Specified by:
getObjectsWithFilter
in interfaceKuwaibaSoapWebService
- Parameters:
className
- The class of the objects to be searched. This method support abstract superclasses as wellfilterName
- The attribute to be used as filter. This will work only with String-type attributes. Example: serialNumber. To list type attributes the filter must be applied to the name. Example: filterName: model, filterValue: XYZfilterValue
- The value to be use to match the instances. Example "Serial-12345"sessionId
- The session token- Returns:
- The list of instances that matches the filterName/filterValue criteria
- Throws:
ServerSideException
- if the class provided could not be found
-
getObjectsOfClassLight
public List<RemoteObjectLight> getObjectsOfClassLight(String className, List<StringPair> attributesToFilter, int page, int limit, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets all objects of a given class- Specified by:
getObjectsOfClassLight
in interfaceKuwaibaSoapWebService
- Parameters:
className
- Class nameattributesToFilter
- attributes to filter forpage
- number of results to skip. Use -1 to retrieve alllimit
- Max number of results. Use -1 to retrieve allsessionId
- Session token- Returns:
- A list of instances of @className
- Throws:
ServerSideException
- If the class can not be found If the class is not subclass of InventoryObject
-
getCommonParent
public RemoteObjectLight getCommonParent(String aObjectClass, String aOid, String bObjectClass, String bOid, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the common parent between an a object and b object- Specified by:
getCommonParent
in interfaceKuwaibaSoapWebService
- Parameters:
aObjectClass
- Object a class nameaOid
- Object a idbObjectClass
- Object b class namebOid
- Object a idsessionId
- Session Id token- Returns:
- The common parent
- Throws:
ServerSideException
- If the requested object can't be found If any of the class nodes involved is malformed If the database object could not be properly mapped into a serializable java object.
-
getParent
public RemoteObjectLight getParent(String objectClass, String oid, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the parent of a given object in the standard and special containment hierarchy- Specified by:
getParent
in interfaceKuwaibaSoapWebService
- Parameters:
objectClass
- Object class of childoid
- Object id for the childsessionId
- Session id- Returns:
- The parent object
- Throws:
ServerSideException
- If the requested object can't be found If any of the class nodes involved is malformed If the database object could not be properly mapped into a serializable java object.
-
getParents
public List<RemoteObjectLight> getParents(String objectClass, String oid, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves all the ancestors of an object in the containment hierarchy. If the provided object is in a pool, the ancestor pools will be returned.- Specified by:
getParents
in interfaceKuwaibaSoapWebService
- Parameters:
objectClass
- Object classoid
- Object id.sessionId
- Session token.- Returns:
- The list of ancestors.
- Throws:
ServerSideException
- In case something goes wrong.
-
getSpecialAttributes
public RemoteObjectSpecialRelationships getSpecialAttributes(String objectClass, String oid, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Returns all the special relationships of a given object as a hashmap whose keys are the names of the relationships and the values the list of related objects- Specified by:
getSpecialAttributes
in interfaceKuwaibaSoapWebService
- Parameters:
objectClass
- Object classoid
- Object idsessionId
- Session token- Returns:
- An object comprising the list of special relationships of the given object and the other end of such relationship
- Throws:
ServerSideException
- If case something goes wrong
-
getParentsUntilFirstOfClass
public List<RemoteObjectLight> getParentsUntilFirstOfClass(String objectClass, String oid, String objectToMatchClassName, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the list of parents (according to the special and standard containment hierarchy) until it finds an instance of class objectToMatchClassName (for example "give me the parents of this port until you find the nearest rack")- Specified by:
getParentsUntilFirstOfClass
in interfaceKuwaibaSoapWebService
- Parameters:
objectClass
- Class of the object to get the parents fromoid
- Id of the object to get the parents fromobjectToMatchClassName
- Class of the object that will limit the search. It can be a superclass, if you want to match many classes at oncesessionId
- Session token- Returns:
- The list of parents until an instance of objectToMatchClassName is found. If no instance of that class is found, all parents until the Dummy Root will be returned
- Throws:
ServerSideException
- If the object to evaluate can not be found or if any of the classes provided could not be found.
-
getFirstParentOfClass
public RemoteObjectLight getFirstParentOfClass(String objectClass, String oid, String objectToMatchClassName, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the first occurrence of a parent with a given class (according to the special and standard containment hierarchy) (for example "give me the parent of this port until you find the nearest rack")- Specified by:
getFirstParentOfClass
in interfaceKuwaibaSoapWebService
- Parameters:
objectClass
- Class of the object to get the parent fromoid
- Id of the object to get the parent fromobjectToMatchClassName
- Class of the object that will limit the search. It can be a superclass, if you want to match many classes at oncesessionId
- The session id token- Returns:
- The the first occurrence of a parent with a given class. If no instance of that class is found, the child of Dummy Root related in this hierarchy will be returned
- Throws:
ServerSideException
- If the object to evaluate can not be found If any of the classes provided could not be found If the object provided is not in the standard containment hierarchy
-
getParentOfClass
public RemoteObject getParentOfClass(String objectClass, String oid, String parentClass, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the first parent of an object which matches the given class in the containment hierarchy- Specified by:
getParentOfClass
in interfaceKuwaibaSoapWebService
- Parameters:
objectClass
- Object classoid
- Object oidparentClass
- Class to be matchedsessionId
- sssion Id- Returns:
- The direct parent of the provided object.
- Throws:
ServerSideException
- Generic exception encapsulating any possible error raised at runtime
-
getSpecialAttribute
public List<RemoteObjectLight> getSpecialAttribute(String objectClass, String oid, String attributeName, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the value of a special attribute, this is, those related to a model, such as cables connected to ports- Specified by:
getSpecialAttribute
in interfaceKuwaibaSoapWebService
- Parameters:
objectClass
- Object's classoid
- object oidattributeName
- attribute's namesessionId
- Session token- Returns:
- A list of the values related to the given object through attributeName. Note that this is a string array on purpose, so the values used not necessarily are not longs
- Throws:
ServerSideException
- Generic exception encapsulating any possible error raised at runtime
-
getObjectSpecialChildren
public List<RemoteObjectLight> getObjectSpecialChildren(String objectClass, String objectId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the special children of a given object. This relationship depends on the model. The relationship between a container and the links in the physical layer model is an example of this kind of relationships.- Specified by:
getObjectSpecialChildren
in interfaceKuwaibaSoapWebService
- Parameters:
objectClass
- The class of the object to be searched.objectId
- The id of the object to be searched.sessionId
- Session token.- Returns:
- A list of special children.
- Throws:
ServerSideException
- If the class could not be found If the object could not be found
-
updateObject
public void updateObject(String className, String oid, List<StringPair> attributesToBeUpdated, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Updates attributes of a given object- Specified by:
updateObject
in interfaceKuwaibaSoapWebService
- Parameters:
className
- object's class nameoid
- Object idattributesToBeUpdated
- A dictionary with pairs key-value, being key, the attribute name, and value, the serialized version of the attribute value. Single list types are represented by the id of the list type item (a numeric value), while multiple list types are strings wit the ids of the related list type items separated by semicolons (e.g. 123;786576;92332)sessionId
- Session token- Throws:
ServerSideException
- If the object class can't be found If the object can't be found If the update can't be performed due a business rule or because the object is blocked If any of the names provided does not exist or can't be set using this method or of the value of any of the attributes can not be mapped correctly.
-
createObject
public String createObject(String className, String parentObjectClassName, String parentOid, String[] attributeNames, String[] attributeValues, String templateId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a business object- Specified by:
createObject
in interfaceKuwaibaSoapWebService
- Parameters:
className
- New object class nameparentObjectClassName
- New object parent's class nameparentOid
- New object parent's idattributeNames
- Names of the attributes to be set at creation timeattributeValues
- Values for those attributestemplateId
- Template id. Use -1 to not use any templatesessionId
- Session token- Returns:
- the id of the new object
- Throws:
ServerSideException
- If the object's class can't be found If the parent id is not found If there's a business constraint that doesn't allow to create the object. If any of the attribute values has an invalid value or format. If the specified template could not be found
-
createSpecialObject
public String createSpecialObject(String className, String parentObjectClassName, String parentOid, String[] attributeNames, String[] attributeValues, String templateId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a special business object. It's a generic method to create objects proper to special models. Parent object won't be linked to the new object through a conventional containment relationship- Specified by:
createSpecialObject
in interfaceKuwaibaSoapWebService
- Parameters:
className
- New object class nameparentObjectClassName
- New object parent's class nameparentOid
- New object parent's idattributeNames
- Names of the attributes to be set at creation timeattributeValues
- Values for those attributestemplateId
- Template id. Use -1 to not use any templatesessionId
- Session token- Returns:
- the id of the new object
- Throws:
ServerSideException
- If the object's class can't be found If the parent id is not found If the update can't be performed due to a format issue If any of the attribute values has an invalid value or format. If the specified template could not be found.
-
deleteObject
public void deleteObject(String className, String oid, boolean releaseRelationships, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a set of objects. Note that this method must be used only for business objects (not metadata or application ones)- Specified by:
deleteObject
in interfaceKuwaibaSoapWebService
- Parameters:
className
- Objects class namesoid
- object id from the objects to be deletedreleaseRelationships
- Should the deletion be forced, deleting all the relationships?sessionId
- Session token- Throws:
ServerSideException
- If the object couldn't be found If the class could not be found If the object could not be deleted because there's some business rules that avoids it or it has incoming relationships.
-
deleteObjects
public void deleteObjects(String[] classNames, String[] oids, boolean releaseRelationships, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a set of objects. Note that this method must be used only for business objects (not metadata or application ones)- Specified by:
deleteObjects
in interfaceKuwaibaSoapWebService
- Parameters:
classNames
- Objects class namesoids
- object id from the objects to be deletedreleaseRelationships
- Should the deletion be forced, deleting all the relationships?sessionId
- Session token- Throws:
ServerSideException
- If the requested object can't be found If the requested object class can't be found If the update can't be performed due a business rule or because the object is blocked or it has relationships and releaseRelationships is false If it was not possible to release the possible unique attributes
-
moveObjectsToPool
public void moveObjectsToPool(String targetClass, String targetOid, String[] objectClasses, String[] objectOids, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Moves objects from their current parent to a pool target object.- Specified by:
moveObjectsToPool
in interfaceKuwaibaSoapWebService
- Parameters:
targetClass
- New parent object idtargetOid
- The new parent's oidobjectClasses
- Class names of the objects to be movedobjectOids
- Oids of the objects to be movedsessionId
- Session token- Throws:
ServerSideException
- If the object's or new parent's class can't be found If the object or its new parent can't be found If the update can't be performed due to a business rule
-
moveObjects
public void moveObjects(String targetClass, String targetOid, String[] objectClasses, String[] objectOids, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Moves objects from their current parent to a target object.- Specified by:
moveObjects
in interfaceKuwaibaSoapWebService
- Parameters:
targetClass
- New parent object idtargetOid
- The new parent's oidobjectClasses
- Class names of the objects to be movedobjectOids
- Oids of the objects to be movedsessionId
- Session token- Throws:
ServerSideException
- If the object's or new parent's class can't be found If the object or its new parent can't be found If the update can't be performed due to a business rule
-
moveSpecialObjects
public void moveSpecialObjects(String targetClass, String targetOid, String[] objectClasses, String[] objectOids, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Moves special objects from their current parent to a target object.- Specified by:
moveSpecialObjects
in interfaceKuwaibaSoapWebService
- Parameters:
targetClass
- New parent object idtargetOid
- The new parent's oidobjectClasses
- Class names of the objects to be movedobjectOids
- Oids of the objects to be movedsessionId
- Session token- Throws:
ServerSideException
- If the object's or new parent's class can't be found If the object or its new parent can't be found If the update can't be performed due to a business rule
-
movePoolItemToPool
public void movePoolItemToPool(String poolId, String poolItemClassName, String poolItemId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Move a pool item from a pool to another pool- Specified by:
movePoolItemToPool
in interfaceKuwaibaSoapWebService
- Parameters:
poolId
- The id of the pool nodepoolItemClassName
- The class name for the pool itempoolItemId
- The id for the pool itemsessionId
- Session token- Throws:
ServerSideException
- If the pool node can not be found If the pool item can not be move to the selected pool If the pool item can not be found If the pool item class name can no be found
-
copyObjects
public String[] copyObjects(String targetClass, String targetOid, String[] objectClasses, String[] objectOids, boolean recursive, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Copy objects from its current parent to a target. This is not a deep copy. Only the selected object will be copied, not the children- Specified by:
copyObjects
in interfaceKuwaibaSoapWebService
- Parameters:
targetClass
- The new parent class nametargetOid
- The new parent oidobjectClasses
- Class names of the objects to be copiedobjectOids
- Oids of the objects to be copiedrecursive
- should the objects be copied recursively? (themselves plus their children)sessionId
- Session token- Returns:
- An array with the ids of the new objects
- Throws:
ServerSideException
- If any of the provided classes couldn't be found If any of the template objects couldn't be found If the target parent can't contain any of the new instances
-
copySpecialObjects
public String[] copySpecialObjects(String targetClass, String targetOid, String[] objectClasses, String[] objectOids, boolean recursive, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Copy special objects from its current parent to a target. This is not a deep copy. Only the selected object will be copied, not the children- Specified by:
copySpecialObjects
in interfaceKuwaibaSoapWebService
- Parameters:
targetClass
- The new parent class nametargetOid
- The new parent oidobjectClasses
- Class names of the objects to be copiedobjectOids
- Oids of the objects to be copiedrecursive
- should the objects be copied recursively? (themselves plus their children)sessionId
- Session token- Returns:
- An array with the ids of the new objects
- Throws:
ServerSideException
- If any of the provided classes couldn't be found If any of the template objects couldn't be found If the target parent can't contain any of the new instances
-
copyPoolItemToPool
public void copyPoolItemToPool(String poolId, String poolItemClassName, String poolItemId, boolean recursive, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Copy a pool item from a pool to another pool- Specified by:
copyPoolItemToPool
in interfaceKuwaibaSoapWebService
- Parameters:
poolId
- The id of the pool nodepoolItemClassName
- The class name for the pool itempoolItemId
- The id for the pool itemrecursive
- If this operation should also copy the children objects recursivelysessionId
- Session token- Throws:
ServerSideException
- If the pool node can not be found If the pool item can not be move to the selected pool If the pool item can not be found If the pool item class name can no be found
-
getMandatoryAttributesInClass
public List<RemoteAttributeMetadata> getMandatoryAttributesInClass(String className, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves the mandatory attributes for a given class- Specified by:
getMandatoryAttributesInClass
in interfaceKuwaibaSoapWebService
- Parameters:
className
- The class namesessionId
- Session token- Returns:
- The list of mandatory attributes in the given class
- Throws:
ServerSideException
- If the class doesn't exist
-
createBulkObjects
public String[] createBulkObjects(String className, String parentClassName, String parentOid, String namePattern, String templateId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates multiple objects using a given name pattern- Specified by:
createBulkObjects
in interfaceKuwaibaSoapWebService
- Parameters:
className
- The class name for the new objectsparentClassName
- The parent class name for the new objectsparentOid
- The object id of the parentnamePattern
- A pattern to create the names for the new objectstemplateId
- the id template to create the object, it can be null if not a template is going to be usedsessionId
- Session id token- Returns:
- A list of ids for the new objects
- Throws:
ServerSideException
- If the className or the parentClassName can not be found. If the className is not a possible children of parentClassName. If the className is not in design or are abstract. If the className is not an InventoryObject. If the parent node can not be found. If the given name pattern not match with the regular expression to build the new object name.
-
createBulkSpecialObjects
public String[] createBulkSpecialObjects(String className, String parentClassName, String parentId, String namePattern, String templateId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates multiple special objects using a given naming pattern- Specified by:
createBulkSpecialObjects
in interfaceKuwaibaSoapWebService
- Parameters:
className
- The class name for the new special objectsparentClassName
- The parent class name for the new special objectsparentId
- The object id of the parentnamePattern
- A pattern to create the names for the new special objectstemplateId
- The template to be used for the new set of objects.sessionId
- Session id token- Returns:
- A list of ids for the new special objects
- Throws:
ServerSideException
- If the className or the parentClassName can not be found. If the parent node can not be found. If the given name pattern not match with the regular expression to build the new object name. If the className is not a possible special children of parentClassName. If the className is not in design or are abstract. If the className is not an InventoryObject. If the template could not be found.
-
connectMirrorPort
public void connectMirrorPort(String[] aObjectClass, String[] aObjectId, String[] bObjectClass, String[] bObjectId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Connect two ports using a mirror relationship- Specified by:
connectMirrorPort
in interfaceKuwaibaSoapWebService
- Parameters:
aObjectClass
- Port A classaObjectId
- Port A idbObjectClass
- Port B classbObjectId
- Port B idsessionId
- Session token- Throws:
ServerSideException
- If any of the objects can't be found If any of the objects involved can't be connected (i.e. if it's not an inventory object) If any of the classes provided can not be found
-
connectMirrorMultiplePort
public void connectMirrorMultiplePort(String aObjectClass, String aObjectId, List<String> bObjectClasses, List<String> bObjectIds, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Connect two ports using a mirrorMultiple relationship- Specified by:
connectMirrorMultiplePort
in interfaceKuwaibaSoapWebService
- Parameters:
aObjectClass
- Port a classaObjectId
- Port a idbObjectClasses
- Port b classesbObjectIds
- Port b idssessionId
- Session token- Throws:
ServerSideException
-
releaseMirrorPort
public void releaseMirrorPort(String objectClass, String objectId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Releases a port mirroring relationship between two ports, receiving one of the ports as parameter- Specified by:
releaseMirrorPort
in interfaceKuwaibaSoapWebService
- Parameters:
objectClass
- Object classobjectId
- Object idsessionId
- Session token- Throws:
ServerSideException
- If the object can not be found If the class can not be found
-
releaseMirrorMultiplePort
public void releaseMirrorMultiplePort(String objectClass, String objectId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Releases a port mirroring multiple relationship between two ports, receiving one of the ports as parameter- Specified by:
releaseMirrorMultiplePort
in interfaceKuwaibaSoapWebService
- Parameters:
objectClass
- Object classobjectId
- Object idsessionId
- Session token- Throws:
ServerSideException
- If the object can not be found If the class can not be found
-
createPhysicalConnection
public String createPhysicalConnection(String aObjectClass, String aObjectId, String bObjectClass, String bObjectId, String name, String connectionClass, String templateId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a physical connection (a container or a link). The validations are made at server side (this is, if the connection can be established between the two endpoints, if they're not already connected, etc)- Specified by:
createPhysicalConnection
in interfaceKuwaibaSoapWebService
- Parameters:
aObjectClass
- "a" endpoint object classaObjectId
- "a" endpoint object idbObjectClass
- "b" endpoint object classbObjectId
- "b" endpoint object idname
- COnnection name. Leave empty if you want to use the one in the templateconnectionClass
- Class used to create the connection. See Constants class for supported valuestemplateId
- Id of the template for class connectionClass. Use -1 if you want to create a connection without templatesessionId
- Session token- Returns:
- The new connection id
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the object's class can't be found If the parent id is not found If the update can't be performed due to a format issue If any of the attribute values has an invalid value or format. If the specified template could not be found. If any of the objects can't be found If any of the objects involved can't be connected (i.e. if it's not an inventory object) If any of the classes provided can not be found
-
createPhysicalConnections
public String[] createPhysicalConnections(String[] aObjectClasses, String[] aObjectIds, String[] bObjectClasses, String[] bObjectIds, String name, String connectionClass, String templateId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a physical connection (a container or a link). The validations are made at server side (this is, if the connection can be established between the two endpoints, if they're not already connected, etc)- Specified by:
createPhysicalConnections
in interfaceKuwaibaSoapWebService
- Parameters:
aObjectClasses
- "a" endpoints object classaObjectIds
- "a" endpoints object idbObjectClasses
- "b" endpoints object classbObjectIds
- "b" endpoints object idname
- COnnection name. Leave empty if you want to use the one in the templateconnectionClass
- Class used to create the connection. See Constants class for supported valuestemplateId
- Id of the template for class connectionClass. Use -1 if you want to create a connection without templatesessionId
- Session token- Returns:
- The new connection id
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the object's class can't be found If the parent id is not found If the update can't be performed due to a format issue If any of the attribute values has an invalid value or format. If the specified template could not be found. If any of the objects can't be found If any of the objects involved can't be connected (i.e. if it's not an inventory object) If any of the classes provided can not be found
-
getPhysicalConnectionEndpoints
public RemoteObjectLight[] getPhysicalConnectionEndpoints(String connectionClass, String connectionId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Returns the endpoints of a physical connection- Specified by:
getPhysicalConnectionEndpoints
in interfaceKuwaibaSoapWebService
- Parameters:
connectionClass
- Connection classconnectionId
- Connection idsessionId
- Session token- Returns:
- An array of two positions: the first is the A endpoint and the second is the B endpoint
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the object can not be found If either the object class or the attribute can not be found
-
getLogicalLinkDetails
public RemoteLogicalConnectionDetails getLogicalLinkDetails(String linkClass, String linkId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Returns the structure of a logical connection. The current implementation is quite simple and the return object simply provides the endpoints and the next ports connected to such endpoints using a physical connection- Specified by:
getLogicalLinkDetails
in interfaceKuwaibaSoapWebService
- Parameters:
linkClass
- The class of the connection to be evaluatedlinkId
- The id of the connection to be evaluatedsessionId
- Session token- Returns:
- An object with the details of the connection and the physical resources associated to it
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the provided connection could not be found
-
validateSavedE2EView
public RemoteViewObject validateSavedE2EView(List<String> linkClasses, List<String> linkIds, RemoteViewObject savedView, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Validates a saved structure of a end to end view. The current implementation provides the endpoints and the next ports connected to such endpoints using a physical connection also adds continuity if a VLAN or a BridgeDomain is found- Specified by:
validateSavedE2EView
in interfaceKuwaibaSoapWebService
- Parameters:
linkClasses
- The class of the connection to be evaluatedlinkIds
- The id of the connection to be evaluatedsavedView
- a given saved view to validatesessionId
- Session token- Returns:
- An object with the details of the connection and the physical resources associated to it
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the provided connection could not be found
-
getE2View
public RemoteViewObject getE2View(List<String> linkClasses, List<String> linkIds, boolean includeVlans, boolean includeBDIs, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Returns the structure of a logical connection. The current implementation is quite simple and the return object simply provides the endpoints and the next ports connected to such endpoints using a physical connection- Specified by:
getE2View
in interfaceKuwaibaSoapWebService
- Parameters:
linkClasses
- The class of the connection to be evaluatedlinkIds
- The id of the connection to be evaluatedincludeVlans
- true to include the bridge domains continuityincludeBDIs
- true to include the bridge domains continuitysessionId
- Session token- Returns:
- An object with the details of the connection and the physical resources associated to it
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the provided connection could not be found
-
getContainersBetweenObjects
public List<RemoteObjectLight> getContainersBetweenObjects(String objectAClass, String objectAId, String objectBClass, String objectBId, String containerClass, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves the existing containers between two given nodes.- Specified by:
getContainersBetweenObjects
in interfaceKuwaibaSoapWebService
- Parameters:
objectAClass
- The class of the object A.objectAId
- The id of the object A.objectBClass
- The class of the object B. (end point B class)objectBId
- The id of the object B (end point B id).containerClass
- The class of the containers to be return.sessionId
- Session token- Returns:
- A list with the common wire containers between the two objects
- Throws:
ServerSideException
- if an objects doesn't exist or if a given class doesn't exist
-
getPhysicalConnectionsInObject
public List<RemoteObjectLightList> getPhysicalConnectionsInObject(String objectClass, String objectId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Loops through all instances of GenericCommunicationsPort at any level inside the given object and gets the physical path. Only the ports with connections (physicalPath.size > 1) are returned- Specified by:
getPhysicalConnectionsInObject
in interfaceKuwaibaSoapWebService
- Parameters:
objectClass
- The class of the object.objectId
- The id of the object.sessionId
- Session token- Returns:
- A list of physical paths from all the ports with connections inside the given object. See
getPhysicalPath
for details about the structure of each entry - Throws:
ServerSideException
- In the same cases asgetChildrenOfClassLightRecursive
andgetPhysicalPath
-
getLinkConnectedToPort
public RemoteObject getLinkConnectedToPort(String portClassName, String portId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Convenience method that returns the link connected to a port (if any). It serves to avoid callingKuwaibaSoapWebService.getSpecialAttribute(java.lang.String,java.lang.String,java.lang.String,java.lang.String)
two times.- Specified by:
getLinkConnectedToPort
in interfaceKuwaibaSoapWebService
- Parameters:
portClassName
- The class of the portportId
- The id of the portsessionId
- The session token- Returns:
- The link connected to the port or null if there isn't any
- Throws:
ServerSideException
- If the port could not be found or if the class provided does not exist or if The class provided is not a subclass of GenericPort
-
getPhysicalPath
public List<RemoteObjectLight> getPhysicalPath(String objectClass, String objectId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the physical trace of connections and ports from a given port.- Specified by:
getPhysicalPath
in interfaceKuwaibaSoapWebService
- Parameters:
objectClass
- Object classobjectId
- Object idsessionId
- Session token- Returns:
- An array containing the sorted elements in the physical path of the given port. The first element is the port from which the trace is generated, while the last is the destination port until which there is physical continuity. If the source port does not have any connection, the physical path will have only one element (that port).
- Throws:
ServerSideException
- If the user is not allowed to invoke the method
-
getPhysicalTree
public RemoteObjectRelatedObjects getPhysicalTree(String objectClass, String objectId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the tree representation of all physical paths.- Specified by:
getPhysicalTree
in interfaceKuwaibaSoapWebService
- Parameters:
objectClass
- Port object classobjectId
- Port object idsessionId
- Session token- Returns:
- A tree representation of all physical paths.
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If any of the objects involved in the path cannot be found If any of the object classes involved in the path cannot be found If any of the objects involved in the path has a malformed list type attribute If any of the objects involved in the path has an invalid objectId or className
-
connectPhysicalLinks
public void connectPhysicalLinks(String[] sideAClassNames, String[] sideAIds, String[] linksClassNames, String[] linksIds, String[] sideBClassNames, String[] sideBIds, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Connects pairs of ports (if they are not connected already) using physical link- Specified by:
connectPhysicalLinks
in interfaceKuwaibaSoapWebService
- Parameters:
sideAClassNames
- The list of classes of one of the sides of the connectionsideAIds
- The list of ids the objects on one side of the connectionlinksClassNames
- the classes of the links that will connect the two sideslinksIds
- The ids of these linkssideBClassNames
- The list of classes of the other side of the connectionsideBIds
- The list of ids the objects on the other side of the connectionsessionId
- Session token- Throws:
ServerSideException
- If the object can not be found If either the object class or the attribute can not be found If any of the objects can't be found If any of the objects involved can't be connected (i.e. if it's not an inventory object) If any of the classes provided can not be found If the object activity log could no be found
-
connectPhysicalContainers
public void connectPhysicalContainers(String[] sideAClassNames, String[] sideAIds, String[] containersClassNames, String[] containersIds, String[] sideBClassNames, String[] sideBIds, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Connects pairs of elements (of any class except subclasses of GenericPort) using containers (subclasses of GenericPhysicalContainer)- Specified by:
connectPhysicalContainers
in interfaceKuwaibaSoapWebService
- Parameters:
sideAClassNames
- The list of classes of one of the sides of the connectionsideAIds
- The list of ids the objects on one side of the connectioncontainersClassNames
- the classes of the containers that will connect the two sidescontainersIds
- The ids of these containerssideBClassNames
- The list of classes of the other side of the connectionsideBIds
- The list of ids the objects on the other side of the connectionsessionId
- Session token- Throws:
ServerSideException
- If any of the provided objects can not be found, if the endpoints are already connected, or if one of the endpoints is a port
-
disconnectPhysicalConnection
public void disconnectPhysicalConnection(String connectionClass, String connectionId, int sideToDisconnect, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Disconnects a side or both sides of a physical connection (a link or a container)- Specified by:
disconnectPhysicalConnection
in interfaceKuwaibaSoapWebService
- Parameters:
connectionClass
- Class of the connection to be editedconnectionId
- Id of the connection to be editedsideToDisconnect
- Side to disconnect. Use 1 to disconnect only the side a, 2 to disconnect only side b and 3 to disconnect both sides at oncesessionId
- Session token- Throws:
ServerSideException
- If the object can not be found If either the object class or the attribute can not be found If the class provided does not exist If any of the relationships is now allowed according to the defined data model If the object activity log could no be found
-
reconnectPhysicalConnection
public void reconnectPhysicalConnection(String connectionClass, String connectionId, String newASideClass, String newASideId, String newBSideClass, String newBSideId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Changes one or both sides (endpoints) of a physical connection (link or container). Use this method carefully in containers, as it does not check if the endpoints of the links inside the container that was reconnected are consistent with its new endpoints. Also note that when used in physical links, the link will NOT be moved (as in the special containment hierarchy) to the nearest common parent of both endpoints. This method can not be used to disconnect connections, to do that use#disconnectPhysicalConnection(java.lang.String, long, int, java.lang.String)
.- Specified by:
reconnectPhysicalConnection
in interfaceKuwaibaSoapWebService
- Parameters:
connectionClass
- The class of the connection to be modifiedconnectionId
- The id of the connection to be modifiednewASideClass
- The class of the new side A of the connection. Use null if this side is not to be changed.newASideId
- The id of the new side A of the connection. Use -1 if this side is not to be changed.newBSideClass
- The class of the new side B of the connection. Use null if this side is not to be changed.newBSideId
- The id of the new side B of the connection. Use -1 if this side is not to be changed.sessionId
- The session token- Throws:
ServerSideException
- If any of the objects provided could not be found or if the new endpoint is not a port (if reconnecting a link) or if it is a port (if reconnecting a container)
-
deletePhysicalConnection
public void deletePhysicalConnection(String objectClass, String objectId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a physical connection- Specified by:
deletePhysicalConnection
in interfaceKuwaibaSoapWebService
- Parameters:
objectClass
- Object classobjectId
- Object idsessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the object couldn't be found If the class could not be found If the object could not be deleted because there's some business rules that avoids it or it has incoming relationships. If the log root node could not be found
-
getBusinessObjectAuditTrail
public ApplicationLogEntry[] getBusinessObjectAuditTrail(String objectClass, String objectId, int limit, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves the log entries for a given [business] object- Specified by:
getBusinessObjectAuditTrail
in interfaceKuwaibaSoapWebService
- Parameters:
objectClass
- Object classobjectId
- Object idlimit
- Max number of results (0 to retrieve all)sessionId
- Session token- Returns:
- The object's audit trail
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the class provided is not subclass of InventoryObject
-
getGeneralActivityAuditTrail
public ApplicationLogEntry[] getGeneralActivityAuditTrail(int page, int limit, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves the list of activity log entries- Specified by:
getGeneralActivityAuditTrail
in interfaceKuwaibaSoapWebService
- Parameters:
page
- current pagelimit
- limit of results per page. 0 to retrieve them allsessionId
- The session id- Returns:
- The list of activity log entries
- Throws:
ServerSideException
- If the user is not allowed to invoke the method, If anything goes wrong
-
attachFileToObject
public long attachFileToObject(String name, String tags, byte[] file, String className, String objectId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Attaches a file to an inventory object- Specified by:
attachFileToObject
in interfaceKuwaibaSoapWebService
- Parameters:
name
- The name of the file. It's more like its title, instead of the file nametags
- A semicolon (";") separated string with the tags associated to this document. These tags can be used to help find documents in a searchfile
- The actual fileclassName
- The class name of the inventory object the file will be attached toobjectId
- The id of the inventory object the file will be attached tosessionId
- Session token- Returns:
- The id of the file object that was created
- Throws:
ServerSideException
- If the file can not be saved or if there's already a file with that name related to the object or if the file exceeds the max size configured
-
detachFileFromObject
public void detachFileFromObject(long fileObjectId, String className, String objectId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Detaches a file from an inventory object. Note that the file will also be deleted.- Specified by:
detachFileFromObject
in interfaceKuwaibaSoapWebService
- Parameters:
fileObjectId
- The id of the file objectclassName
- The class of the object the file will be detached fromobjectId
- The id of the object the file will be detached fromsessionId
- The session token- Throws:
ServerSideException
- If the object or its class could not be found, or if the file object could not be found or if there was a problem physically deleting the file from disk
-
getFilesForObject
public List<RemoteFileObjectLight> getFilesForObject(String className, String objectId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves the files associated to a given inventory object- Specified by:
getFilesForObject
in interfaceKuwaibaSoapWebService
- Parameters:
className
- The class of the object o retrieve the files fromobjectId
- The id of the object o retrieve the files fromsessionId
- The session token- Returns:
- A list of light file objects
- Throws:
ServerSideException
- If the object or its class could not be found
-
getFile
public RemoteFileObject getFile(long fileObjectId, String className, String objectId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves a particular file from those attached to an inventory object. The returned object contains the contents of the file- Specified by:
getFile
in interfaceKuwaibaSoapWebService
- Parameters:
fileObjectId
- The id of the file objectclassName
- The class of the object the file will be detached fromobjectId
- The id of the object the file will be detached fromsessionId
- The session token- Returns:
- The object file encapsulating the contents of the file.
- Throws:
ServerSideException
- If the object or its class could not be found, or if the file object could not be found or if there was a problem physically deleting the file from disk
-
updateFileProperties
public void updateFileProperties(long fileObjectId, List<StringPair> properties, String className, String objectId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Updates the properties of a file object (name or tags)- Specified by:
updateFileProperties
in interfaceKuwaibaSoapWebService
- Parameters:
fileObjectId
- The id of the file objectproperties
- The set of properties as a dictionary key-value. Valid keys are "name" and "tags"className
- The class of the object the file is attached toobjectId
- The id of the object the file is attached tosessionId
- The session token- Throws:
ServerSideException
- If the object file is attached to could not be found or if the file object could not be found or if any of the properties has an invalid name or if the file name is empty or if the class of the object file is attached to could not be found
-
createClass
public long createClass(String className, String displayName, String description, boolean isAbstract, boolean isCustom, boolean isCountable, boolean isInDesign, String parentClassName, byte[] icon, byte[] smallIcon, int color, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a class metadata object. This method is still under testing and might be buggy- Specified by:
createClass
in interfaceKuwaibaSoapWebService
- Parameters:
className
- Class namedisplayName
- Class display namedescription
- Class descriptionisAbstract
- is this class abstract?isCustom
- Is this class part of the core of the application (can not be deleted) or if it's an extension to the default data model. In most cases, this should be "true".isCountable
- NOt used so far. It's intended to be used to mark the classes that are created to make consistent the model, but that are not actual inventory elements, such as SlotsisInDesign
- Says if a class can be instantiated or not. This is useful if you are creating many classes and want to avoid the users to create objects from those classes until you have finished the data model roll-out.parentClassName
- Parent class nameicon
- Icon for views. The size is limited by the value in Constants.MAX_ICON_SIZE and it's typically 32x32 pixelssmallIcon
- Icon for trees. The size is limited by the value in Constants.MAX_ICON_SIZEcolor
- The color to be used to display the instances of this class (depends on the client used)sessionId
- Session token- Returns:
- the id of the new class metadata object
- Throws:
ServerSideException
- If the specified parent class doesn't exist If the reference node doesn't exist If any of the fields of the class definition has an invalid value
-
setClassProperties
public void setClassProperties(long classId, String className, String displayName, String description, byte[] smallIcon, byte[] icon, int color, Boolean isAbstract, Boolean isInDesign, Boolean isCustom, Boolean isCountable, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Updates a class metadata properties. Use null values for those properties that shouldn't be touched- Specified by:
setClassProperties
in interfaceKuwaibaSoapWebService
className
- metadata name. Null if unchangeddisplayName
- New class metadata display name. Null if unchangeddescription
- New class metadata description. Null if unchangedsmallIcon
- New icon for trees. Null if unchanged. The size is limited by the value in Constants.MAX_ICON_SIZEicon
- New icon for views. Null if unchanged. The size is limited by the value in Constants.MAX_ICON_SIZEcolor
- The color of the instances of this class.isAbstract
- is this class abstract?isInDesign
- If the class is in design stage (see createClass).isCustom
- If the class is custom (see createClass).isCountable
- If the class is countable (see createClass).sessionId
- Session token- Throws:
ServerSideException
- If there is any problem retrieving an object, while checking if every created object of the class with an attributes marked as mandatory has value.
-
hasAttribute
public boolean hasAttribute(String className, String attributeName, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Checks if a class has a attribute with a given name- Specified by:
hasAttribute
in interfaceKuwaibaSoapWebService
- Parameters:
className
- Class nameattributeName
- Attribute namesessionId
- Session token- Returns:
- True if the given class has the attribute
- Throws:
ServerSideException
- If there is no a class with such className
-
getAttribute
public RemoteAttributeMetadata getAttribute(String className, String attributeName, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets a class attribute, using the class name as key to find it- Specified by:
getAttribute
in interfaceKuwaibaSoapWebService
- Parameters:
className
- the class namesessionId
- Session token- Returns:
- the class attribute
- Throws:
ServerSideException
- If there is no a class with such className If the attributeName does not exist
-
getAttributeForClassWithId
public RemoteAttributeMetadata getAttributeForClassWithId(String classId, String attributeName, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets a class attribute, using the class id as key to find it- Specified by:
getAttributeForClassWithId
in interfaceKuwaibaSoapWebService
- Parameters:
classId
- Class idattributeName
- Attribute namesessionId
- Session token- Returns:
- The attribute definition
- Throws:
ServerSideException
- If there is no a class with such classId If the attributeName does not exist
-
createAttribute
public void createAttribute(String className, String name, String displayName, String type, String description, boolean administrative, boolean visible, boolean isReadOnly, boolean noCopy, boolean unique, boolean mandatory, boolean multiple, int order, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Adds an attribute to a class using its name as key to find it. If value of a given attribute is null, a default value will be set (except for the name, which is mandatory)- Specified by:
createAttribute
in interfaceKuwaibaSoapWebService
- Parameters:
className
- Class name where the attribute will be attachedname
- attribute namedisplayName
- attribute display nametype
- attribute typedescription
- attribute descriptionadministrative
- is the attribute administrative?visible
- is the attribute visible?isReadOnly
- is the attribute read only?noCopy
- Marks an attribute as not to be copied during a copy operation.unique
- should this attribute be unique?mandatory
- is the attribute mandatory when an object is createdmultiple
- Indicates if the attribute is a multiple selection list type. This flag has no effect in primitive types, such as strings or numbersorder
- Tells the system how to sort the attributes. A call to any method that returns the attributes of a class will return them sorted by order. This is useful to show the attributes in property sheets in order of importance, for example. The default value is 1000sessionId
- session token- Throws:
ServerSideException
- If there is no a class with such className If any of the parameters to create the attribute has a wrong value
-
createAttributeForClassWithId
public void createAttributeForClassWithId(long ClassId, String name, String displayName, String type, String description, boolean administrative, boolean visible, boolean readOnly, boolean noCopy, boolean unique, boolean mandatory, boolean multiple, int order, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Adds an attribute to a class using its id as key to find it. If value of a given attribute is null, a default value will be put in place (except for the name, which is mandatory)- Specified by:
createAttributeForClassWithId
in interfaceKuwaibaSoapWebService
- Parameters:
ClassId
- Class id where the attribute will be attachedname
- attribute namedisplayName
- attribute display nametype
- attribute typedescription
- attribute descriptionadministrative
- is the attribute administrative?visible
- is the attribute visible?readOnly
- is the attribute read only?noCopy
- Marks an attribute as not to be copied during a copy operation.unique
- should this attribute be unique?mandatory
- is the attribute mandatory when an object is createdmultiple
- Indicates if the attribute is a multiple selection list type. This flag has no effect in primitive types, such as strings or numbersorder
- Tells the system how to sort the attributes. A call to any method that returns the attributes of a class will return them sorted by order. This is useful to show the attributes in property sheets in order of importance, for example. The default value is 1000sessionId
- session token- Throws:
ServerSideException
- If any of the parameters to create the attribute has a wrong value
-
setAttributeProperties
public void setAttributeProperties(String className, long attributeId, String name, String displayName, String description, String type, Boolean administrative, Boolean mandatory, Boolean multiple, Boolean noCopy, Boolean readOnly, Boolean unique, Boolean visible, Integer order, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Updates a class attribute taking its name as key to find it. If value of a given attribute is null, the old value will remain unchanged.- Specified by:
setAttributeProperties
in interfaceKuwaibaSoapWebService
- Parameters:
className
- Class the attribute belongs toattributeId
- attribute idname
- attribute namedisplayName
- attribute display namedescription
- attribute descriptiontype
- attribute typeadministrative
- is the attribute administrative?mandatory
- is the attribute mandatory when an object is createdmultiple
- Indicates if the attribute is a multiple selection list type. This flag has no effect in primitive types, such as strings or numbersnoCopy
- can this attribute be copy in copy/paste operation?readOnly
- is the attribute read only?unique
- should this attribute be unique?visible
- is the attribute visible?order
- Tells the system how to sort the attributes. A call to any method that returns the attributes of a class will return them sorted by order. This is useful to show the attributes in property sheets in order of importance, for example. The default value is 1000sessionId
- session token- Throws:
ServerSideException
- If an object can't be find, while it is checking if every object of the class (or subclasses) has a value in an attribute marked as mandatory
-
setAttributePropertiesForClassWithId
public void setAttributePropertiesForClassWithId(long classId, long attributeId, String name, String displayName, String description, String type, Boolean administrative, Boolean mandatory, Boolean multiple, Boolean noCopy, Boolean readOnly, Boolean unique, Boolean visible, Integer order, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Updates a class attribute taking its id as key to find it. If value of a given attribute is null, the old value will remain unchanged.- Specified by:
setAttributePropertiesForClassWithId
in interfaceKuwaibaSoapWebService
- Parameters:
classId
- Class the attribute belongs toattributeId
- attribute idname
- attribute namedisplayName
- attribute display namedescription
- attribute descriptiontype
- attribute typeadministrative
- is the attribute administrative?mandatory
- is the attribute mandatory when an object is createdmultiple
- Indicates if the attribute is a multiple selection list type. This flag has no effect in primitive types, such as strings or numbersnoCopy
- can this attribute be copy in copy/paste operation?readOnly
- is the attribute read only?unique
- should this attribute be unique?visible
- is the attribute visible?order
- Tells the system how to sort the attributes. A call to any method that returns the attributes of a class will return them sorted by order. This is useful to show the attributes in property sheets in order of importance, for example. The default value is 1000sessionId
- session token- Throws:
ServerSideException
- If an object can't be find, while it is checking if every object of the class (or subclasses) has a value in an attribute marked as mandatory
-
deleteAttribute
public void deleteAttribute(String className, String attributeName, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes an attribute from a class using the class name as key to find it- Specified by:
deleteAttribute
in interfaceKuwaibaSoapWebService
- Parameters:
className
- Class nameattributeName
- Attribute namesessionId
- Session token- Throws:
ServerSideException
- If the class could not be found. If the attributes name or creationDate are to be deleted.
-
deleteAttributeForClassWithId
public void deleteAttributeForClassWithId(long classId, String attributeName, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes an attribute from a class using the class id as key to find it- Specified by:
deleteAttributeForClassWithId
in interfaceKuwaibaSoapWebService
- Parameters:
classId
- Class idattributeName
- Attribute namesessionId
- Session token- Throws:
ServerSideException
- If the class could not be found. If the attributes name or creationDate are to be deleted.
-
getClass
public RemoteClassMetadata getClass(String className, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the metadata of a given class using its name as key to find it- Specified by:
getClass
in interfaceKuwaibaSoapWebService
- Parameters:
className
- Class namesessionId
- Session token- Returns:
- The metadata as a ClassInfo instance
- Throws:
ServerSideException
- If there is no class with such className
-
getClassWithId
public RemoteClassMetadata getClassWithId(long classId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the metadata of a given class using its id as key to find it- Specified by:
getClassWithId
in interfaceKuwaibaSoapWebService
- Parameters:
classId
- Class metadata object idsessionId
- session token- Returns:
- The metadata as a ClassInfo instance
- Throws:
ServerSideException
- If there is no class with such classId
-
getSubClassesLight
public List<RemoteClassMetadataLight> getSubClassesLight(String className, boolean includeAbstractClasses, boolean includeSelf, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the subclasses of a given class- Specified by:
getSubClassesLight
in interfaceKuwaibaSoapWebService
- Parameters:
className
- Class nameincludeAbstractClasses
- should the result include the abstract classes?includeSelf
- Should the list include the subclasses and the parent class?sessionId
- Session token- Returns:
- The list of subclasses
- Throws:
ServerSideException
- If the provided class is not a subclass of InventoryObject
-
getSubClassesLightNoRecursive
public List<RemoteClassMetadataLight> getSubClassesLightNoRecursive(String className, boolean includeAbstractClasses, boolean includeSelf, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the subclasses of a given class- Specified by:
getSubClassesLightNoRecursive
in interfaceKuwaibaSoapWebService
- Parameters:
className
- Class nameincludeAbstractClasses
- should the result include the abstract classes?includeSelf
- Should the list include the subclasses and the parent class?sessionId
- Session token- Returns:
- The list of subclasses
-
-