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
addActivity(String parentId, String parentClassName, String className, String[] attributeNames, String[] attributeValues, String sessionId)
Adds an ActivityString
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.String
addProject(String parentId, String parentClassName, String className, String[] attributeNames, String[] attributeValues, String sessionId)
Adds a Projectvoid
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
associateObjectsToProject(String projectClass, String projectId, String[] objectClass, String[] objectId, String sessionId)
Associates a set of objects with a Projectvoid
associateObjectsToService(String[] objectClass, String[] objectId, String serviceClass, String serviceId, String sessionId)
Associates a list of objects (resources) to an existing servicevoid
associateObjectToProject(String projectClass, String projectId, String objectClass, String objectId, String sessionId)
Associates an object to a Projectvoid
associateObjectToProxy(String objectClass, String objectId, String proxyClass, String proxyId, String sessionId)
Associates an inventory object to an inventory proxy.void
associateObjectToService(String objectClass, String objectId, String serviceClass, String serviceId, String sessionId)
Associates an object (a resource) to an existing servicevoid
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(long processInstanceId, long 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.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, int numberOfSpecialObjects, String namePattern, 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 contactlong
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
createPoolItem(String poolId, String className, String[] attributeNames, String[] attributeValues, String templateId, String sessionId)
Creates an object within a poollong
createProcessDefinition(String name, String description, String version, boolean enabled, byte[] structure, String sessionId)
Creates a process definition.long
createProcessInstance(long processDefinitionId, String processInstanceName, String processInstanceDescription, String sessionId)
Creates an instance of a process, that is, starts oneString
createProjectPool(String name, String description, String instanceOfClass, String sessionId)
Creates a Project PoolString
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)RemoteSession
createSession(String username, String password, int sessionType)
Creates a session.String
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.void
deleteActivity(String className, String oid, boolean releaseRelationships, String sessionId)
Deletes an Activityvoid
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 config variablevoid
deleteConfigurationVariablesPool(String poolId, String sessionId)
Deletes a configuration variables pool.void
deleteContact(String contactClass, String contactId, String sessionId)
Deletes a contactvoid
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(long processDefinitionId, String sessionId)
Deletes a process definitionvoid
deleteProject(String className, String oid, boolean releaseRelationships, String sessionId)
Deletes a Projectvoid
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
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
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)void
freeObjectFromProject(String objectClass, String objectId, String projectClass, String projectId, String sessionId)
Releases an object associated to a ProjectRemoteAssetLevelCorrelatedInformation
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<RemoteObjectLight>
getAllProjects(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.RemoteArtifactDefinition
getArtifactDefinitionForActivity(long processDefinitionId, long activityDefinitionId, String sessionId)
Given an activity definition, returns the artifact definition associated to itRemoteArtifact
getArtifactForActivity(long processInstanceId, long 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.RemoteContact
getContact(String contactClass, String contactId, String sessionId)
Gets the whole information about a contactList<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.List<RemoteBackgroundJob>
getCurrentJobs(String sessionId)
Gets the current jobs which are executingList<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(long 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>
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<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<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(long processDefinitionId, String sessionId)
Retrieves a process definitionList<RemoteObjectLight>
getProjectActivities(String projectClass, String projectId, String sessionId)
Gets project activitiesList<RemotePool>
getProjectPools(String sessionId)
Gets the project poolsList<RemoteObjectLight>
getProjectResurces(String projectClass, String projectId, String sessionId)
Gets the resources (objects) associates with a ProjectList<RemoteObjectLight>
getProjectsAssociateToObject(String objectClass, String objectId, String sessionId)
Gets the projects associate to an objectList<RemoteObjectLight>
getProjectsInProjectPool(String poolId, int limit, String sessionId)
Gets the project in a Project poolList<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.List<RemoteObjectLight>
getServiceResources(String serviceClass, String serviceId, String sessionId)
Gets the services associated to a serviceList<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 in the systemList<RemotePool>
getWarehouseRootPools(String sessionId)
Gets the warehouse module root pools.boolean
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
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 contractId, String sessionId)
Releases an inventory object from a contract it was related tovoid
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 targetId, 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
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
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(long processDefinitionId, List<StringPair> properties, byte[] structure, String sessionId)
Updates a process definition, either its standard properties or its structurevoid
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
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 ifsessionId
- 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
-
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
-
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 config variable can not be found
-
deleteConfigurationVariable
public void deleteConfigurationVariable(String name, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a config variable- Specified by:
deleteConfigurationVariable
in interfaceKuwaibaSoapWebService
- Parameters:
name
- The name of the variable to be deletedsessionId
- The session token- Throws:
ServerSideException
- If the config 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 variable
- 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 config variables in the given pool
- Throws:
ServerSideException
- If the pool could not be found
-
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 in the system- 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
-
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: serialNumberfilterValue
- 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: serialNumberfilterValue
- 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, int numberOfSpecialObjects, String namePattern, 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 parentnumberOfSpecialObjects
- Number of special objects to be creatednamePattern
- A pattern to create the names for the new special objectssessionId
- 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.
-
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
-
associateObjectToService
public void associateObjectToService(String objectClass, String objectId, String serviceClass, String serviceId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Associates an object (a resource) to an existing service- Specified by:
associateObjectToService
in interfaceKuwaibaSoapWebService
- Parameters:
objectClass
- Object classobjectId
- Object idserviceClass
- service classserviceId
- service idsessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method 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
-
associateObjectsToService
public void associateObjectsToService(String[] objectClass, String[] objectId, String serviceClass, String serviceId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Associates a list of objects (resources) to an existing service- Specified by:
associateObjectsToService
in interfaceKuwaibaSoapWebService
- Parameters:
objectClass
- Object classobjectId
- Object idserviceClass
- service classserviceId
- service idsessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method 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
-
releaseObjectFromService
public void releaseObjectFromService(String serviceClass, String serviceId, String targetId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Releases an object from a service that is using it- Specified by:
releaseObjectFromService
in interfaceKuwaibaSoapWebService
- Parameters:
serviceClass
- Service classserviceId
- Service idtargetId
- target object idsessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the object can not be found If the class can not be found If the object activity log could no be found
-
getServiceResources
public List<RemoteObjectLight> getServiceResources(String serviceClass, String serviceId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the services associated to a service- Specified by:
getServiceResources
in interfaceKuwaibaSoapWebService
- Parameters:
serviceClass
- Service classserviceId
- Service idsessionId
- Session token- Returns:
- A list of services
- 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
-
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
- Throws:
ServerSideException
- Exception If the class could not be found.
-
getAllClasses
public List<RemoteClassMetadata> getAllClasses(boolean includeListTypes, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves the metadata for the entire class hierarchy as ClassInfo instances- Specified by:
getAllClasses
in interfaceKuwaibaSoapWebService
- Parameters:
includeListTypes
- boolean to indicate if the list should include the subclasses of GenericObjectListsessionId
- Session token- Returns:
- An array with the metadata for the entire class hierarchy as ClassInfo instances
- Throws:
ServerSideException
- Generic exception encapsulating any possible error raised at runtime
-
getAllClassesLight
public List<RemoteClassMetadataLight> getAllClassesLight(boolean includeListTypes, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves the metadata for the entire class hierarchy as ClassInfoLight instances- Specified by:
getAllClassesLight
in interfaceKuwaibaSoapWebService
- Parameters:
includeListTypes
- boolean to indicate if the list should include the subclasses of GenericObjectListsessionId
- Session token- Returns:
- An array with the metadata for the entire class hierarchy as ClassInfoLight instances
- Throws:
ServerSideException
- If GenericListType class does not exist.
-
deleteClass
public void deleteClass(String className, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a class from the data model using its name as key to find it- Specified by:
deleteClass
in interfaceKuwaibaSoapWebService
- Parameters:
className
- Class namesessionId
- Session token- Throws:
ServerSideException
- If there is not a class with de ClassName If the class is a core class, has instances, has incoming relationships or is a list type that is used by another class.
-
deleteClassWithId
public void deleteClassWithId(long classId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a class from the data model using its id as key to find it- Specified by:
deleteClassWithId
in interfaceKuwaibaSoapWebService
- Parameters:
classId
- Class idsessionId
- Session token- Throws:
ServerSideException
- If the class is a core class, has instances, has incoming relationships or is a list type that is used by another class.
-
getPossibleChildren
public List<RemoteClassMetadataLight> getPossibleChildren(String parentClassName, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the possible children of a class according to the containment hierarchy. This method is recursive, and if a possible child is an abstract class, it gets its non-abstract subclasses- Specified by:
getPossibleChildren
in interfaceKuwaibaSoapWebService
- Parameters:
parentClassName
- Class to retrieve its possible childrensessionId
- Session token- Returns:
- A list of possible children as ClassInfoLight instances An array with the metadata for the entire class hierarchy as ClassInfoLight instances
- Throws:
ServerSideException
- If the class can not be found
-
getPossibleSpecialChildren
public List<RemoteClassMetadataLight> getPossibleSpecialChildren(String parentClassName, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the possible special children of a class according to the containment hierarchy. This method is recursive, and if a possible special child is an abstract class, it gets its non-abstract subclasses- Specified by:
getPossibleSpecialChildren
in interfaceKuwaibaSoapWebService
- Parameters:
parentClassName
- Class to retrieve its possible special childrensessionId
- Session token- Returns:
- A list of possible special children as ClassInfoLight instances
- Throws:
ServerSideException
- If the class can not be found
-
getPossibleChildrenNoRecursive
public List<RemoteClassMetadataLight> getPossibleChildrenNoRecursive(String parentClassName, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the possible children of a class according to the containment hierarchy. This method is not recursive, and only returns the direct possible children, even if they're abstract- Specified by:
getPossibleChildrenNoRecursive
in interfaceKuwaibaSoapWebService
- Parameters:
parentClassName
- Class to retrieve its possible childrensessionId
- Session token- Returns:
- An array with the metadata for the entire class hierarchy as ClassInfoLight instances
- Throws:
ServerSideException
- If the class could not be found
-
getPossibleSpecialChildrenNoRecursive
public List<RemoteClassMetadataLight> getPossibleSpecialChildrenNoRecursive(String parentClassName, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the possible special children of a class according to the containment hierarchy. This method is not recursive, and only returns the direct possible special children, even if they're abstract- Specified by:
getPossibleSpecialChildrenNoRecursive
in interfaceKuwaibaSoapWebService
- Parameters:
parentClassName
- Class to retrieve its possible special childrensessionId
- Session token- Returns:
- A List with the metadata for the entire class hierarchy as ClassInfoLight instances
- Throws:
ServerSideException
- If the class could not be found
-
addPossibleChildrenForClassWithId
public void addPossibleChildrenForClassWithId(long parentClassId, long[] newPossibleChildren, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Adds possible children to a given class using its id as argument. If any of the arguments provided are already added, it will abort the operation and rise an exception- Specified by:
addPossibleChildrenForClassWithId
in interfaceKuwaibaSoapWebService
- Parameters:
parentClassId
- Class to attach the new possible childrennewPossibleChildren
- List of new possible children. Abstract classes are de-aggregatedsessionId
- Session token- Throws:
ServerSideException
- If any of the possible children or the parent doesn't exist If any of the possible children classes already are possible children.
-
addPossibleSpecialChildrenWithId
public void addPossibleSpecialChildrenWithId(long parentClassId, long[] possibleSpecialChildren, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Adds possible special children to a given class using its id as argument. If any of the arguments provided are already added, it will abort the operation and rise an exception- Specified by:
addPossibleSpecialChildrenWithId
in interfaceKuwaibaSoapWebService
- Parameters:
parentClassId
- Class to attach the new possible special childrenpossibleSpecialChildren
- List of new possible children. Abstract classes are de-aggregatedsessionId
- Session token- Throws:
ServerSideException
- If any of the possible children or the parent doesn't exist If any of the possible children classes already are possible special children.
-
addPossibleChildren
public void addPossibleChildren(String parentClassName, String[] childrenToBeAdded, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Adds possible children to a given class using its name as argument. If any of the arguments provided are already added, it will abort the operation and rise an exception- Specified by:
addPossibleChildren
in interfaceKuwaibaSoapWebService
- Parameters:
parentClassName
- Class to attach the new possible childrenchildrenToBeAdded
- List of new possible children. Abstract classes are de-aggregatedsessionId
- Session token- Throws:
ServerSideException
- If the parent class or any of the possible children can not be found If any of the given possible children can not be a possible children of parentClassName
-
addPossibleSpecialChildren
public void addPossibleSpecialChildren(String parentClassName, String[] possibleSpecialChildren, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Adds special possible children to a given class using its name. If any of the arguments provided are already added, it will abort the operation and rise an exception- Specified by:
addPossibleSpecialChildren
in interfaceKuwaibaSoapWebService
- Parameters:
parentClassName
- Class to attach the new possible special childrenpossibleSpecialChildren
- List of new possible special children. Abstract classes are de-aggregatedsessionId
- Session token- Throws:
ServerSideException
- If the parent class or any of the possible children can not be found If any of the given possible children can not be a possible children of parentClassName
-
removePossibleChildrenForClassWithId
public void removePossibleChildrenForClassWithId(long parentClassId, long[] childrenToBeRemoved, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Removes a set of possible children for a given class- Specified by:
removePossibleChildrenForClassWithId
in interfaceKuwaibaSoapWebService
- Parameters:
parentClassId
- Class the possible children are going to be removed fromchildrenToBeRemoved
- List of ids of classes to be removed as possible childrensessionId
- Session token- Throws:
ServerSideException
- If any of the ids provided can't be found
-
removePossibleSpecialChildren
public void removePossibleSpecialChildren(long parentClassId, long[] specialChildrenToBeRemoved, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Removes a set of possible special children for a given class.- Specified by:
removePossibleSpecialChildren
in interfaceKuwaibaSoapWebService
- Parameters:
parentClassId
- Parent Class of the possible special children are going to be removed fromspecialChildrenToBeRemoved
- List of ids of classes to be remove as possible special childrensessionId
- Session token- Throws:
ServerSideException
- If any of the ids provided can't be found
-
getUpstreamContainmentHierarchy
public List<RemoteClassMetadataLight> getUpstreamContainmentHierarchy(String className, boolean recursive, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the containment hierarchy of a given class, but upwards (i.e. for Building, it could return City, Country, Continent)- Specified by:
getUpstreamContainmentHierarchy
in interfaceKuwaibaSoapWebService
- Parameters:
className
- Class to be evaluatedrecursive
- do it recursively or not- Returns:
- List of classes in the upstream containment hierarchy
- Throws:
ServerSideException
- If className does not correspond to any existing class
-
getUpstreamSpecialContainmentHierarchy
public List<RemoteClassMetadataLight> getUpstreamSpecialContainmentHierarchy(String className, boolean recursive, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the special containment hierarchy of a given class, but upwards (i.e. for Building, it could return City, Country, Continent)- Specified by:
getUpstreamSpecialContainmentHierarchy
in interfaceKuwaibaSoapWebService
- Parameters:
className
- Class to be evaluatedrecursive
- Do it recursively or notsessionId
- Session id token- Returns:
- List of classes in upstream special containment hierarchy
- Throws:
ServerSideException
- If className does not correspond to any existing class
-
getUpstreamClassHierarchy
public List<RemoteClassMetadataLight> getUpstreamClassHierarchy(String className, boolean includeSelf, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the parent classes of a given class up to RootObject.- Specified by:
getUpstreamClassHierarchy
in interfaceKuwaibaSoapWebService
- Parameters:
className
- The class to get the superclasses fromincludeSelf
- If the result should also include the class in classNamesessionId
- The session token- Returns:
- The list of super classes until the root of the hierarchy
- Throws:
ServerSideException
- If the class provided could not be found
-
isSubClassOf
public boolean isSubClassOf(String className, String allegedParentClass, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Tests if a class is subclass of another.- Specified by:
isSubClassOf
in interfaceKuwaibaSoapWebService
- Parameters:
className
- Class to be tested.allegedParentClass
- Class to be tested against.sessionId
- Session token.- Returns:
- If the tested class is subclass of allegedParentClass or not.
- Throws:
ServerSideException
- In case something goes wrong.
-
bulkUpload
public String bulkUpload(byte[] file, int commitSize, int dataType, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates many objects at once given a well formatted file. See user manual for details on how to format the file- Specified by:
bulkUpload
in interfaceKuwaibaSoapWebService
- Parameters:
file
- The file with size no greatercommitSize
- The records are not committed one by one, but in batch. This number tells Kuwaiba how many records (lines) to commit at once.dataType
- What kind of data contains the file, listTypes, inventory objects, etcsessionId
- Session token.- Returns:
- The result of the operation.
- Throws:
ServerSideException
- If something goes wrong.
-
downloadBulkLoadLog
public byte[] downloadBulkLoadLog(String fileName, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves the log file product of a bulk load operation.- Specified by:
downloadBulkLoadLog
in interfaceKuwaibaSoapWebService
- Parameters:
fileName
- The name of the file (provided by the method that performs the bulk creation)sessionId
- Session token- Returns:
- The contents of the file.
- Throws:
ServerSideException
- If something goes wrong.
-
createTemplate
public String createTemplate(String templateClass, String templateName, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a template.- Specified by:
createTemplate
in interfaceKuwaibaSoapWebService
- Parameters:
templateClass
- The class you want to create a template for.templateName
- The name of the template.sessionId
- Session token.- Returns:
- The id of the newly created template.
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the provided class does not exist If the template class is abstract.
-
createTemplateElement
public String createTemplateElement(String templateElementClass, String templateElementParentClassName, String templateElementParentId, String templateElementName, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates an object inside a template.- Specified by:
createTemplateElement
in interfaceKuwaibaSoapWebService
- Parameters:
templateElementClass
- Class of the object you want to create.templateElementParentClassName
- Class of the parent to the object you want to create.templateElementParentId
- Id of the parent to the object you want to create.templateElementName
- Name of the element.sessionId
- Session token.- Returns:
- The id of the new object.
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the object (or its parent) class could not be found If the parent object could not be found If the class provided to create the new element from is abstract.
-
createTemplateSpecialElement
public String createTemplateSpecialElement(String tsElementClass, String tsElementParentClassName, String tsElementParentId, String tsElementName, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates an special object inside a template.- Specified by:
createTemplateSpecialElement
in interfaceKuwaibaSoapWebService
- Parameters:
tsElementClass
- Class of the special object you want to create.tsElementParentClassName
- Class of the parent to the special object you want to create.tsElementParentId
- Id of the parent to the special object you want to create.tsElementName
- Name of the element.sessionId
- Session token.- Returns:
- The id of the new object.
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the element class are not a possible special child of the element parent class If the element class given are abstract If the element class or element parent class can not be found If the element parent can no be found
-
createBulkTemplateElement
public String[] createBulkTemplateElement(String templateElementClassName, String templateElementParentClassName, String templateElementParentId, String templateElementNamePattern, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates multiple template elements using a given name pattern- Specified by:
createBulkTemplateElement
in interfaceKuwaibaSoapWebService
- Parameters:
templateElementClassName
- The class name of the new set of template elementstemplateElementParentClassName
- The parent class name of the new set of template elementstemplateElementParentId
- The parent id of the new set of template elementstemplateElementNamePattern
- Name pattern of the new set of template elementssessionId
- Session id token- Returns:
- An array of ids for the new template elements
- Throws:
ServerSideException
- If the parent class name or the template element class name cannot be found If the given template element class cannot be a child of the given parent If the parent class name cannot be found If the given pattern to generate the name has less possibilities that the number of template elements to be created
-
createBulkSpecialTemplateElement
public String[] createBulkSpecialTemplateElement(String stElementClass, String stElementParentClassName, String stElementParentId, String stElementNamePattern, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates multiple special template elements using a given name pattern- Specified by:
createBulkSpecialTemplateElement
in interfaceKuwaibaSoapWebService
- Parameters:
stElementClass
- The class name of the new set of special template elementsstElementParentClassName
- The parent class name of the new set of special template elementsstElementParentId
- The parent id of the new set of special template elementsstElementNamePattern
- Name pattern of the new set of special template elementssessionId
- Session id token- Returns:
- An array if ids for the new special template elements
- Throws:
ServerSideException
- If the parent class name or the special template element class name cannot be found If the given special template element class cannot be a child of the given parent If the parent class name cannot be found If the given pattern to generate the name has less possibilities that the number of special template elements to be created
-
updateTemplateElement
public void updateTemplateElement(String templateElementClass, String templateElementId, String[] attributeNames, String[] attributeValues, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Updates the value of an attribute of a template element.- Specified by:
updateTemplateElement
in interfaceKuwaibaSoapWebService
- Parameters:
templateElementClass
- Class of the element you want to update.templateElementId
- Id of the element you want to update.attributeNames
- Names of the attributes that you want to be updated as an array of strings.attributeValues
- The values of the attributes you want to update. For list types, it's the id of the related typesessionId
- Session token.- Throws:
ServerSideException
- If the user is not allowed to invoke the method If any of the classes provided as arguments do not exist If the template element could not be found If the arrays attributeNames and attributeValues have different sizes
-
deleteTemplateElement
public void deleteTemplateElement(String templateElementClass, String templateElementId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes an element within a template or a template itself.- Specified by:
deleteTemplateElement
in interfaceKuwaibaSoapWebService
- Parameters:
templateElementClass
- The template element class.templateElementId
- The template element id.sessionId
- Session token.- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the element's class could not be found. If the element could not be found.
-
getTemplatesForClass
public List<RemoteObjectLight> getTemplatesForClass(String className, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the templates available for a given class- Specified by:
getTemplatesForClass
in interfaceKuwaibaSoapWebService
- Parameters:
className
- Class whose templates we needsessionId
- Session token- Returns:
- A list of templates (actually, the top element) as a list of RemoteOObjects
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the class provided could not be found.
-
copyTemplateElements
public String[] copyTemplateElements(String[] sourceObjectsClassNames, String[] sourceObjectsIds, String newParentClassName, String newParentId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Copy template elements within templates. Should not be used to copy entire templates.- Specified by:
copyTemplateElements
in interfaceKuwaibaSoapWebService
- Parameters:
sourceObjectsClassNames
- Array with the class names of the elements to be copied.sourceObjectsIds
- Array with the ids of the elements to be copied.newParentClassName
- Class of the parent of the copied objects.newParentId
- Id of the parent of the copied objects.sessionId
- Session token.- Returns:
- An array with the ids of the newly created elements in the same order they were provided.
- Throws:
ServerSideException
- If the user is not allowed to invoke the method. If any of the classes could not be found. If any of the source template elements could not be found. If the arrays provided as arguments have different sizes.
-
copyTemplateSpecialElements
public String[] copyTemplateSpecialElements(String[] sourceObjectsClassNames, String[] sourceObjectsIds, String newParentClassName, String newParentId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Copy template special elements within templates. Should not be used to copy entire templates.- Specified by:
copyTemplateSpecialElements
in interfaceKuwaibaSoapWebService
- Parameters:
sourceObjectsClassNames
- Array with the class names of the special elements to be copied.sourceObjectsIds
- Array with the ids of the special elements to be copied.newParentClassName
- Class of the parent of the copied objects.newParentId
- Id of the parent of the copied objects.sessionId
- Session token.- Returns:
- An array with the ids of the newly created special elements in the same order they were provided.
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the arrays provided as arguments have different sizes. If any of the classes could not be found. If any of the source template elements could not be found.
-
getTemplateElementChildren
public List<RemoteObjectLight> getTemplateElementChildren(String templateElementClass, String templateElementId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves the children of a given template element.- Specified by:
getTemplateElementChildren
in interfaceKuwaibaSoapWebService
- Parameters:
templateElementClass
- Template element class.templateElementId
- Template element id.- Returns:
- The template element's children as a list of RemoteBusinessObjectLight instances.
- Throws:
ServerSideException
- If the user is not allowed to invoke the method
-
getTemplateSpecialElementChildren
public List<RemoteObjectLight> getTemplateSpecialElementChildren(String tsElementClass, String tsElementId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves the children of a given template special element.- Specified by:
getTemplateSpecialElementChildren
in interfaceKuwaibaSoapWebService
- Parameters:
tsElementClass
- Template special element class.tsElementId
- Template special element id.- Returns:
- The template element's children as a list of RemoteBusinessObjectLight instances.
- Throws:
ServerSideException
- If the user is not allowed to invoke the method
-
getTemplateElement
public RemoteObject getTemplateElement(String templateElementClass, String templateElementId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrives all the information of a given template element.- Specified by:
getTemplateElement
in interfaceKuwaibaSoapWebService
- Parameters:
templateElementClass
- Template element class.templateElementId
- Template element id.sessionId
- session token- Returns:
- The template element information
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the template class does not exist If the template element could not be found If an attribute value can't be mapped into value
-
createClassLevelReport
public long createClassLevelReport(String className, String reportName, String reportDescription, String script, int outputType, boolean enabled, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a class level report (a report that will be available for all instances of a given class -and its subclasses-)- Specified by:
createClassLevelReport
in interfaceKuwaibaSoapWebService
- Parameters:
className
- Class this report is going to be related to. It can be ab abstract class and the report will be available for all its subclassesreportName
- Name of the report.reportDescription
- Report description.script
- Script text.outputType
- What will be the default output of this report? See ClassLevelReportDescriptor for possible valuesenabled
- If enabled, a report can be executed.sessionId
- Session token- Returns:
- The id of the newly created report.
- Throws:
ServerSideException
- If the user is not allowed to invoke the method. If the class provided could not be found.
-
createInventoryLevelReport
public long createInventoryLevelReport(String reportName, String reportDescription, String script, int outputType, boolean enabled, List<StringPair> parameters, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates an inventory level report (a report that is not tied to a particlar instance or class. In most cases, they also receive parameters)- Specified by:
createInventoryLevelReport
in interfaceKuwaibaSoapWebService
- Parameters:
reportName
- Name of the report.reportDescription
- Report description.script
- Script text.outputType
- What will be the default output of this report? See InventoryLevelReportDescriptor for possible valuesenabled
- If enabled, a report can be executed.parameters
- Optional (it might be either null or an empty array). The list of the names parameters that this report will support. They will always be captured as strings, so it's up to the author of the report the sanitization and conversion of the inputssessionId
- Session token- Returns:
- The id of the newly created report.
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the dummy root could not be found, which is actually a severe problem.
-
deleteReport
public void deleteReport(long reportId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a report- Specified by:
deleteReport
in interfaceKuwaibaSoapWebService
- Parameters:
reportId
- The id of the report.sessionId
- Session token.- Throws:
ServerSideException
- If the user is not allowed to invoke the method. If the report could not be found.
-
updateReport
public void updateReport(long reportId, String reportName, String reportDescription, Boolean enabled, Integer type, String script, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Updates the properties of an existing class level report.- Specified by:
updateReport
in interfaceKuwaibaSoapWebService
- Parameters:
reportId
- Id of the report.reportName
- The name of the report. Null to leave it unchanged.reportDescription
- The description of the report. Null to leave it unchanged.enabled
- Is the report enabled? . Null to leave it unchanged.type
- Type of the output of the report. See LocalReportLight for possible valuesscript
- Text of the script.sessionId
- Session token.- Throws:
ServerSideException
- If the user is not allowed to invoke the method If any of the report properties has a wrong or unexpected format If the report could not be found.
-
updateReportParameters
public void updateReportParameters(long reportId, List<StringPair> parameters, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Updates the value of any of the parameters of a given report.- Specified by:
updateReportParameters
in interfaceKuwaibaSoapWebService
- Parameters:
reportId
- Report id.parameters
- List of pairs attribute-value of the report. Valid values are name, description, script and enabled.sessionId
- Session token.- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the any of the parameters has an invalid name
-
getClassLevelReports
public List<RemoteReportMetadataLight> getClassLevelReports(String className, boolean recursive, boolean includeDisabled, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the class level reports associated to the given class (or its superclasses)- Specified by:
getClassLevelReports
in interfaceKuwaibaSoapWebService
- Parameters:
className
- The class to extract the reports from.recursive
- False to get only the directly associated reports. True top get also the reports associate top its superclassesincludeDisabled
- True to also include the reports marked as disabled. False to return only the enabled ones.sessionId
- Session token.- Returns:
- The list of reports.
- Throws:
ServerSideException
- If the class could not be found If the user is not allowed to invoke the method
-
getInventoryLevelReports
public List<RemoteReportMetadataLight> getInventoryLevelReports(boolean includeDisabled, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the inventory class reports.- Specified by:
getInventoryLevelReports
in interfaceKuwaibaSoapWebService
- Parameters:
includeDisabled
- True to also include the reports marked as disabled. False to return only the enabled ones.sessionId
- Session token.- Returns:
- The list of reports.
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the dummy root could not be found, which is actually a severe problem.
-
getReport
public RemoteReportMetadata getReport(long reportId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the information related to a class level report.- Specified by:
getReport
in interfaceKuwaibaSoapWebService
- Parameters:
reportId
- The id of the report.sessionId
- Session token.- Returns:
- The report.
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the report could not be found.
-
executeClassLevelReport
public byte[] executeClassLevelReport(String objectClassName, String objectId, long reportId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Executes a class level report and returns the result.- Specified by:
executeClassLevelReport
in interfaceKuwaibaSoapWebService
- Parameters:
objectClassName
- The class of the instance that will be used as input for the report.objectId
- The id of the instance that will be used as input for the report.reportId
- The id of the report.sessionId
- Session token.- Returns:
- The result of the report execution.
- Throws:
ServerSideException
- If the class could not be found or if the report could not be found or if the inventory object could not be found or if there's an error during the execution of the report.
-
executeInventoryLevelReport
public byte[] executeInventoryLevelReport(long reportId, List<StringPair> parameters, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Executes an inventory level report and returns the result.- Specified by:
executeInventoryLevelReport
in interfaceKuwaibaSoapWebService
- Parameters:
reportId
- The id of the report.parameters
- List of pairs param name - param valuesessionId
- Session token.- Returns:
- The result of the report execution.
- Throws:
ServerSideException
- If the user is not allowed to invoke the method or If the report could not be found or if the associated script exits with error.
-
createFavoritesFolderForUser
public long createFavoritesFolderForUser(String favoritesFolderName, long userId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a favorites folder for User.- Specified by:
createFavoritesFolderForUser
in interfaceKuwaibaSoapWebService
- Parameters:
favoritesFolderName
- Bookmark folder nameuserId
- User idsessionId
- The session token- Returns:
- The id of the new Bookmark folder
- Throws:
ServerSideException
- If the user is not allowed to invoke the method or If the user can not be found or If the name is null or empty
-
deleteFavoritesFolders
public void deleteFavoritesFolders(long[] favoritesFolderId, long userId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a set of favorites folders- Specified by:
deleteFavoritesFolders
in interfaceKuwaibaSoapWebService
- Parameters:
favoritesFolderId
- Bookmark folder iduserId
- The User idsessionId
- The session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method or If any favorites folder in the array can not be found
-
getFavoritesFoldersForUser
public List<RemoteFavoritesFolder> getFavoritesFoldersForUser(long userId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the list of favorites folders of a given User.- Specified by:
getFavoritesFoldersForUser
in interfaceKuwaibaSoapWebService
- Parameters:
userId
- User idsessionId
- The session token- Returns:
- The list of Bookmarks for user
- Throws:
ServerSideException
- If the user is not allowed to invoke the method or If the user can not be found
-
addObjectsToFavoritesFolder
public void addObjectsToFavoritesFolder(String[] objectClass, String[] objectId, long favoritesFolderId, long userId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Associates a list of objects to an existing favorites folder- Specified by:
addObjectsToFavoritesFolder
in interfaceKuwaibaSoapWebService
- Parameters:
objectClass
- Object class nameobjectId
- Object idfavoritesFolderId
- Bookmark folder iduserId
- The User idsessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the favorites folder can not be found If the object can not be found If the object have a relationship with the favorite folder
-
removeObjectsFromFavoritesFolder
public void removeObjectsFromFavoritesFolder(String[] objectClass, String[] objectId, long favoritesFolderId, long userId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Removes a list of objects from a given favorites folder- Specified by:
removeObjectsFromFavoritesFolder
in interfaceKuwaibaSoapWebService
- Parameters:
objectClass
- Object class nameobjectId
- Object idfavoritesFolderId
- Bookmark folder iduserId
- User id the favorites folder belongs tosessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the favorites folder can not be found If the object can not be found If the object can not be found
-
getObjectsInFavoritesFolder
public List<RemoteObjectLight> getObjectsInFavoritesFolder(long favoritesFolderId, long userId, int limit, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the objects in a to favorites folder- Specified by:
getObjectsInFavoritesFolder
in interfaceKuwaibaSoapWebService
- Parameters:
favoritesFolderId
- Bookmark folder iduserId
- User Idlimit
- Max number of results. Use -1 to retrieve all.sessionId
- Session token- Returns:
- The list of objects
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the favorites folder can not be found
-
getFavoritesFoldersForObject
public List<RemoteFavoritesFolder> getFavoritesFoldersForObject(long userId, String objectClass, String objectId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the favorites folders an object is included into.- Specified by:
getFavoritesFoldersForObject
in interfaceKuwaibaSoapWebService
- Parameters:
userId
- User IdobjectClass
- Object Class nameobjectId
- Object idsessionId
- Session token- Returns:
- The list of bookmarks where an object is associated
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the object can not be found If the object is associated to a bookmark folder but The favorites folder is not associated to the current user
-
getFavoritesFolder
public RemoteFavoritesFolder getFavoritesFolder(long favoritesFolderId, long userId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets a favorites folder- Specified by:
getFavoritesFolder
in interfaceKuwaibaSoapWebService
- Parameters:
favoritesFolderId
- Bookmark folder iduserId
- User idsessionId
- Session token- Returns:
- The Bookmark folder
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the favorites folder can not be found
-
updateFavoritesFolder
public void updateFavoritesFolder(long favoritesFolderId, String favoritesFolderName, long userId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Updates a favorites folder- Specified by:
updateFavoritesFolder
in interfaceKuwaibaSoapWebService
- Parameters:
favoritesFolderId
- Favorites folder idfavoritesFolderName
- Favorites folder nameuserId
- User idsessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the favorites folder can not be found If the name of the favorites folder is null or empty
-
createBusinessRule
public long createBusinessRule(String ruleName, String ruleDescription, int ruleType, int ruleScope, String appliesTo, String ruleVersion, List<String> constraints, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a business rule given a set of constraints- Specified by:
createBusinessRule
in interfaceKuwaibaSoapWebService
- Parameters:
ruleName
- Rule nameruleDescription
- Rule descriptionruleType
- Rule type. See BusinesRule.TYPE* for possible values.ruleScope
- The scope of the rule. See BusinesRule.SCOPE* for possible values.appliesTo
- The class this rule applies to. Can not be null.ruleVersion
- The version of the rule. Useful to migrate it if necessary in further versions of the platformconstraints
- An array with the definition of the logic to be matched with the rule. Can not be empty or nullsessionId
- Session token- Returns:
- The id of the newly created business rule
- Throws:
ServerSideException
- If any of the parameters is null (strings) or leer than 1 or if the constraints array is null or empty
-
deleteBusinessRule
public void deleteBusinessRule(long businessRuleId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a business rule- Specified by:
deleteBusinessRule
in interfaceKuwaibaSoapWebService
- Parameters:
businessRuleId
- Rule idsessionId
- Session token- Throws:
ServerSideException
- If the given rule does not exist
-
getBusinessRules
public List<RemoteBusinessRule> getBusinessRules(int type, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves the business rules of a particular type.- Specified by:
getBusinessRules
in interfaceKuwaibaSoapWebService
- Parameters:
type
- Rule type. See BusinesRule.TYPE* for possible values. Use -1 to retrieve allsessionId
- Session token- Returns:
- The list of business rules with the matching type.
- Throws:
ServerSideException
- If something unexpected happens
-
launchSupervisedSynchronizationTask
public List<RemoteSyncFinding> launchSupervisedSynchronizationTask(long syncGroupId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
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. A supervised sync job needs a human to review the differences and decide what to do, while an automated sync job automatically decides what to do based on built-in business rules. Please note that the execution might take some time, so it is expected that the client to implement an asynchronous call- Specified by:
launchSupervisedSynchronizationTask
in interfaceKuwaibaSoapWebService
- Parameters:
syncGroupId
- The sync group idsessionId
- The session token- Returns:
- A list of differences that require the authorization of a user to be resolved
- Throws:
ServerSideException
- If the sync group could not be found or if
-
launchAutomatedSynchronizationTask
public List<RemoteSyncResult> launchAutomatedSynchronizationTask(long syncGroupId, String providersName, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
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. An automated sync job does not need human intervention it automatically decides what to do based on built-in business rules- Specified by:
launchAutomatedSynchronizationTask
in interfaceKuwaibaSoapWebService
- Parameters:
syncGroupId
- The sync group idsessionId
- The session token- Returns:
- The set of results
- Throws:
ServerSideException
- If the sync group could not be found
-
launchAdHocAutomatedSynchronizationTask
public List<RemoteSyncResult> launchAdHocAutomatedSynchronizationTask(List<Long> synDsConfigIds, String providersName, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
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. An automated sync job does not need human intervention it automatically decides what to do based on built-in business rules- Specified by:
launchAdHocAutomatedSynchronizationTask
in interfaceKuwaibaSoapWebService
- Parameters:
synDsConfigIds
- The sync data source configurations idssessionId
- The session token- Returns:
- The set of results
- Throws:
ServerSideException
- If the sync group could not be found
-
executeSyncActions
public List<RemoteSyncResult> executeSyncActions(long syncGroupId, List<RemoteSyncAction> actions, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Executes the synchronization actions that the user selected after check the list of findings- Specified by:
executeSyncActions
in interfaceKuwaibaSoapWebService
- Parameters:
syncGroupId
- the sync groupIdactions
- the list findings to be processedsessionId
- the session token- Returns:
- the list of results after the actions were executed
- Throws:
ServerSideException
-
getCurrentJobs
public List<RemoteBackgroundJob> getCurrentJobs(String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the current jobs which are executing- Specified by:
getCurrentJobs
in interfaceKuwaibaSoapWebService
- Parameters:
sessionId
- the session id token- Returns:
- The list of the current jobs which are executing
- Throws:
ServerSideException
-
killJob
public void killJob(long jobId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Kills a job given its id- Specified by:
killJob
in interfaceKuwaibaSoapWebService
- Parameters:
jobId
- id of job to killsessionId
- the session id token- Throws:
ServerSideException
- If the job cannot be found
-
createSDHTransportLink
public String createSDHTransportLink(String classNameEndpointA, String idEndpointA, String classNameEndpointB, String idEndpointB, String linkType, String defaultName, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates an SDH transport link (STMX)- Specified by:
createSDHTransportLink
in interfaceKuwaibaSoapWebService
- Parameters:
classNameEndpointA
- The class name of the endpoint A (some kind of port)idEndpointA
- Id of endpoint AclassNameEndpointB
- The class name of the endpoint Z (some kind of port)idEndpointB
- Id of endpoint ZlinkType
- Type of link (STM1, STM4, STM16, STM256, etc)defaultName
- The default name of the transport link.sessionId
- Session token- Returns:
- The id of the newly created transport link
- Throws:
ServerSideException
- If the user is not allowed to invoke the method or If any of the requested objects can't be found or If any of the classes provided can not be found or If any of the objects involved can't be connected.
-
createSDHContainerLink
public String createSDHContainerLink(String classNameEndpointA, String idEndpointA, String classNameEndpointB, String idEndpointB, String linkType, List<RemoteSDHPosition> positions, String defaultName, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates an SDH container link (VCX). In practical terms, it's always a high order container, such a VC4XXX- Specified by:
createSDHContainerLink
in interfaceKuwaibaSoapWebService
- Parameters:
classNameEndpointA
- The class name of the endpoint A (a GenericCommunicationsEquipment)idEndpointA
- Id of endpoint AclassNameEndpointB
- The class name of the endpoint B (GenericCommunicationsEquipment)idEndpointB
- Id of endpoint BlinkType
- Type of link (VC4, VC3, V12, etc. A VC12 alone doesn't make much sense, though)positions
- This param specifies the transport links and positions used by the container. For more details on how this works, please read the "SDH Model: Technical Design and Tools" document. Please note that is greatly advisable to provide them already sorteddefaultName
- the name to be assigned to the new element. If null, an empty string will be usedsessionId
- Sesion token- Returns:
- The id of the newly created container link
- Throws:
ServerSideException
- If the user is not allowed to invoke the method or If any of the requested objects can't be found or If any of the classes provided can not be found or If any of the objects involved can't be connected.
-
createSDHTributaryLink
public String createSDHTributaryLink(String classNameEndpointA, String idEndpointA, String classNameEndpointB, String idEndpointB, String linkType, List<RemoteSDHPosition> positions, String defaultName, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates an SDH tributary link (VCXTributaryLink)- Specified by:
createSDHTributaryLink
in interfaceKuwaibaSoapWebService
- Parameters:
classNameEndpointA
- The class name of the endpoint A (some kind of tributary port)idEndpointA
- Id of endpoint AclassNameEndpointB
- The class name of the endpoint B (some kind of tributary port)idEndpointB
- Id of endpoint BlinkType
- Type of link (VC4TributaryLink, VC3TributaryLink, V12TributaryLink, etc)positions
- This param specifies the transport links and positions used by the container. For more details on how this works, please read the SDH Model: Technical Design and Tools document. Please note that is greatly advisable to provide them already sorted. Please note that creating a tributary link automatically creates a container link to deliver itdefaultName
- the name to be assigned to the new elementsessionId
- Session token- Returns:
- The id of the newly created tributary link
- Throws:
ServerSideException
- If the user is not allowed to invoke the method or If any of the requested objects can't be found or If any of the classes provided can not be found or If any of the objects involved can't be connected.
-
deleteSDHTransportLink
public void deleteSDHTransportLink(String transportLinkClass, String transportLinkId, boolean forceDelete, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a transport link- Specified by:
deleteSDHTransportLink
in interfaceKuwaibaSoapWebService
- Parameters:
transportLinkClass
- Transport Link classtransportLinkId
- Transport link idforceDelete
- Delete recursively all SDH elements transported by the transport linksessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the transport link could not be found
-
deleteSDHContainerLink
public void deleteSDHContainerLink(String containerLinkClass, String containerLinkId, boolean forceDelete, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a container link- Specified by:
deleteSDHContainerLink
in interfaceKuwaibaSoapWebService
- Parameters:
containerLinkClass
- Container link classcontainerLinkId
- Container class idforceDelete
- Delete recursively all SDH elements contained by the container linksessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the container link could not be found
-
deleteSDHTributaryLink
public void deleteSDHTributaryLink(String tributaryLinkClass, String tributaryLinkId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a tributary link and its corresponding container link. This method will delete all the object relationships.- Specified by:
deleteSDHTributaryLink
in interfaceKuwaibaSoapWebService
- Parameters:
tributaryLinkClass
- The class of the tributary linktributaryLinkId
- the id of the tributary linksessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the tributary link could not be found
-
findSDHRoutesUsingTransportLinks
public List<RemoteObjectLightList> findSDHRoutesUsingTransportLinks(String communicationsEquipmentClassA, String communicationsEquipmentIdA, String communicationsEquipmentClassB, String communicationsEquipmentIB, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
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)- Specified by:
findSDHRoutesUsingTransportLinks
in interfaceKuwaibaSoapWebService
- Parameters:
communicationsEquipmentClassA
- The class of one of the route endpointscommunicationsEquipmentIdA
- The id of one of the route endpointscommunicationsEquipmentClassB
- The class of the other route endpointcommunicationsEquipmentIB
- The id of the other route endpointsessionId
- Session token- Returns:
- A sorted list of RemoteObjectLights containing the route. This list includes the transport links and the nodes in between, including the very endpoints
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the given communication equipment is no subclass of GenericCommunicationsEquipment
-
findSDHRoutesUsingContainerLinks
public List<RemoteObjectLightList> findSDHRoutesUsingContainerLinks(String communicationsEquipmentClassA, String communicationsEquipmentIdA, String communicationsEquipmentClassB, String communicationsEquipmentIB, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
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)- Specified by:
findSDHRoutesUsingContainerLinks
in interfaceKuwaibaSoapWebService
- Parameters:
communicationsEquipmentClassA
- The class of one of the route endpointscommunicationsEquipmentIdA
- The id of one of the route endpointscommunicationsEquipmentClassB
- The class of the other route endpointcommunicationsEquipmentIB
- The id of the other route endpointsessionId
- Session token- Returns:
- A sorted list of RemoteObjectLights containing the route. This list includes the transport links and the nodes in between, including the very endpoints
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the given communication equipment is no subclass of GenericCommunicationsEquipment
-
getSDHTransportLinkStructure
public List<RemoteSDHContainerLinkDefinition> getSDHTransportLinkStructure(String transportLinkClass, String transportLinkId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves the container links within a transport link (e.g. the VC4XX in and STMX)- Specified by:
getSDHTransportLinkStructure
in interfaceKuwaibaSoapWebService
- Parameters:
transportLinkClass
- Transportlink's classtransportLinkId
- Transportlink's idsessionId
- Session token- Returns:
- The list of the containers that go through that transport link
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the given transport link is no subclass of GenericSDHTransportLink
-
getSDHContainerLinkStructure
public List<RemoteSDHContainerLinkDefinition> getSDHContainerLinkStructure(String containerLinkClass, String containerLinkId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the internal structure of a container link. This is useful to provide information about the occupation of a link. This is only applicable to VC4XX- Specified by:
getSDHContainerLinkStructure
in interfaceKuwaibaSoapWebService
- Parameters:
containerLinkClass
- Container classcontainerLinkId
- Container IdsessionId
- Session token- Returns:
- The list of containers contained in the container
- Throws:
ServerSideException
- If the user is not authorized to know the structure of a container link, if the container supplied is not subclass of GenericSDHHighOrderContainerLink, if the container could not be found or if the class could not be found
-
getSubnetPools
public List<RemotePool> getSubnetPools(String parentId, String className, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves all the pools of subnets- Specified by:
getSubnetPools
in interfaceKuwaibaSoapWebService
- Parameters:
parentId
- parent id parent id of the pool, -1 to retrieve the pools from the root nodesclassName
- IPv4 or IPv6 subnetsessionId
- the session token- Returns:
- a set of subnet pools
- Throws:
ServerSideException
- if there are not IPAM root nodes or if can't get the pools of a subnet pool
-
getSubnets
public List<RemoteObjectLight> getSubnets(String poolId, int limit, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves the subnets of a given pool id- Specified by:
getSubnets
in interfaceKuwaibaSoapWebService
- Parameters:
poolId
- subnet pool idlimit
- limit of returned subnets, -1 to no limitsessionId
- the session token- Returns:
- a set of subnets
- Throws:
ServerSideException
- if the given subnet pool id is not valid
-
createSubnetPool
public String createSubnetPool(String parentId, String subnetPoolName, String subnetPoolDescription, String className, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a pool of subnets if the parentId is -1 the pool will be created in the default root for pools of subnets- Specified by:
createSubnetPool
in interfaceKuwaibaSoapWebService
- Parameters:
parentId
- subnet parent Id, -1 to if want to create the pool in the root nodesubnetPoolName
- subnet pool namesubnetPoolDescription
- subnet pool descriptionclassName
- if is a IPv4 or an IPv6 subnetsessionId
- session token- Returns:
- id of the created subnet pool
- Throws:
ServerSideException
- if the IPAM root nodes doesn't exists, or if the IPv4 or IPv6 classes doesn't exists
-
createSubnet
public String createSubnet(String poolId, String className, List<StringPair> attributes, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a subnet- Specified by:
createSubnet
in interfaceKuwaibaSoapWebService
- Parameters:
poolId
- The id of the pool that will contain the subnetclassName
- The class name of the subnet (e.g. SubnetIPv4, SubnetIPv6)attributes
- The attributes that will be set on the newly created element as a string-based key-value dictionarysessionId
- Session token.- Returns:
- The id of the new subnet.
- Throws:
ServerSideException
- If something goes wrong, can't find the parent id, IPv4 or IPv6 classes doesn't exists, or some problem with attributes, different size between attribute names and attribute values.
-
deleteSubnetPools
public void deleteSubnetPools(String[] ids, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a set of subnet pools- Specified by:
deleteSubnetPools
in interfaceKuwaibaSoapWebService
- Parameters:
ids
- ids of the pools to be deletedsessionId
- Session token- Throws:
ServerSideException
- Generic exception encapsulating any possible error raised at runtime
-
deleteSubnets
public void deleteSubnets(String className, List<String> oids, boolean releaseRelationships, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a subnet. All subnets must be instances of the same class- Specified by:
deleteSubnets
in interfaceKuwaibaSoapWebService
- Parameters:
className
- The subnet classoids
- The ids of the subnets to be deletedreleaseRelationships
- Should the deletion be forced, deleting all the relationships?sessionId
- Session token- Throws:
ServerSideException
- Generic exception encapsulating any possible error raised at runtime
-
getSubnet
public RemoteObject getSubnet(String id, String className, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the complete information about a given subnet (all its attributes)- Specified by:
getSubnet
in interfaceKuwaibaSoapWebService
- Parameters:
id
- Subnet idclassName
- Subnet class IPv4 o IPv6sessionId
- Session token- Returns:
- a representation of the subnet as a RemoteObject
- Throws:
ServerSideException
- Generic exception encapsulating any possible error raised at runtime
-
getSubnetPool
public RemotePool getSubnetPool(String subnetPoolId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the complete information about a given subnet pool (all its attributes)- Specified by:
getSubnetPool
in interfaceKuwaibaSoapWebService
- Parameters:
subnetPoolId
- Subnet pool idsessionId
- Session token- Returns:
- a representation of the entity as a RemoteObject
- Throws:
ServerSideException
- Generic exception encapsulating any possible error raised at runtime
-
addIPAddress
public String addIPAddress(String id, String parentClassName, List<StringPair> attributesToBeUpdated, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Adds an IP address to a Subnet- Specified by:
addIPAddress
in interfaceKuwaibaSoapWebService
- Parameters:
id
- ipAddres idparentClassName
- the parent class nameattributesToBeUpdated
- IP address attributes as a String based key-value dictionarysessionId
- The session token- Returns:
- the id of the new IP Address
- Throws:
ServerSideException
-
removeIP
public void removeIP(String[] oids, boolean releaseRelationships, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Removes a set of IP Addresses from a subnet. Note that this method must be used only for Subnet objects- Specified by:
removeIP
in interfaceKuwaibaSoapWebService
- Parameters:
oids
- ids of the IPs to be deletedreleaseRelationships
- Should the deletion be forced, deleting all the relationships?sessionId
- Session token- Throws:
ServerSideException
- Generic exception encapsulating any possible error raised at runtime
-
getSubnetUsedIps
public List<RemoteObjectLight> getSubnetUsedIps(String id, int limit, String className, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves the IP addresses of a subnet- Specified by:
getSubnetUsedIps
in interfaceKuwaibaSoapWebService
- Parameters:
id
- subnet idlimit
- limit of returned subnetsclassName
- the class namesessionId
- the session id- Returns:
- a set of IPs
- Throws:
ServerSideException
-
getSubnetsInSubnet
public List<RemoteObjectLight> getSubnetsInSubnet(String id, int limit, String className, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves the sub-subnets of a subnet- Specified by:
getSubnetsInSubnet
in interfaceKuwaibaSoapWebService
- Parameters:
id
- subnet idlimit
- limit of returned subnetsclassName
- the class name if is IPv6 or IPv4sessionId
- The session token- Returns:
- a set of subnets
- Throws:
ServerSideException
-
relateSubnetToVlan
public void relateSubnetToVlan(String id, String className, String vlanId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
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 relationships- Specified by:
relateSubnetToVlan
in interfaceKuwaibaSoapWebService
- Parameters:
id
- Subnet idclassName
- if the subnet has IPv4 or IPv6 IP addressesvlanId
- VLAN idsessionId
- Session token- Throws:
ServerSideException
- Generic exception encapsulating any possible error raised at runtime
-
releaseSubnetFromVlan
public void releaseSubnetFromVlan(String subnetId, String vlanId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
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 relationships- Specified by:
releaseSubnetFromVlan
in interfaceKuwaibaSoapWebService
- Parameters:
subnetId
- Subnet idvlanId
- the VLAN idsessionId
- Session token- Throws:
ServerSideException
- Generic exception encapsulating any possible error raised at runtime
-
releaseSubnetFromVRF
public void releaseSubnetFromVRF(String subnetId, String vrfId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Releases the relation between a subnet and a VRF- Specified by:
releaseSubnetFromVRF
in interfaceKuwaibaSoapWebService
- Parameters:
subnetId
- Subnet idvrfId
- the VRF idsessionId
- Session token- Throws:
ServerSideException
- Generic exception encapsulating any possible error raised at runtime
-
relateSubnetToVrf
public void relateSubnetToVrf(String id, String className, String vrfId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a relation between a subnet and a VRF- Specified by:
relateSubnetToVrf
in interfaceKuwaibaSoapWebService
- Parameters:
id
- Subnet idclassName
- if the subnet is IPv4 or IPv6vrfId
- VRF idsessionId
- Session token- Throws:
ServerSideException
- Generic exception encapsulating any possible error raised at runtime
-
relateIPtoPort
public void relateIPtoPort(String ipId, String portClassName, String portId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a relation between an IP address and a port- Specified by:
relateIPtoPort
in interfaceKuwaibaSoapWebService
- Parameters:
ipId
- IP address idportClassName
- port classportId
- port idsessionId
- Session token- Throws:
ServerSideException
- Generic exception encapsulating any possible error raised at runtime
-
itOverlaps
public boolean itOverlaps(String networkIp, String broadcastIp, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Checks if a new subnet overlaps with an existing one- Specified by:
itOverlaps
in interfaceKuwaibaSoapWebService
- Parameters:
networkIp
- the network ip for the subnetbroadcastIp
- the broadcast ip for the subnetsessionId
- Session token- Returns:
- true if overlaps
- Throws:
ServerSideException
- Generic exception encapsulating any possible error raised at runtime
-
releasePortFromIP
public void releasePortFromIP(String deviceClassName, String deviceId, String id, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Releases the relation between an IP address and a port- Specified by:
releasePortFromIP
in interfaceKuwaibaSoapWebService
- Parameters:
deviceClassName
- port class namedeviceId
- port idid
- Subnet idsessionId
- Session token- Throws:
ServerSideException
- Generic exception encapsulating any possible error raised at runtime
-
associateObjectsToContract
public void associateObjectsToContract(String[] objectClass, String[] objectId, String contractClass, String contractId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Associates a list of objects (instances of a subclass of InventoryObject) to an existing contract (most probably a support contract)- Specified by:
associateObjectsToContract
in interfaceKuwaibaSoapWebService
- Parameters:
objectClass
- Object classobjectId
- Object idcontractClass
- contract classcontractId
- contract idsessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method If any of the objects can't be found If any of the objects involved can't be associated If any of the classes provided can not be found
-
releaseObjectFromContract
public void releaseObjectFromContract(String objectClass, String objectId, String contractId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Releases an inventory object from a contract it was related to- Specified by:
releaseObjectFromContract
in interfaceKuwaibaSoapWebService
- Parameters:
objectClass
- Class of the inventory objectobjectId
- Id of the inventory objectcontractId
- Contract idsessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the object can not be found If the class can not be found
-
createMPLSLink
public String createMPLSLink(String classNameEndpointA, String idEndpointA, String classNameEndpointB, String idEndpointB, List<StringPair> attributesToBeSet, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates an MPLS link- Specified by:
createMPLSLink
in interfaceKuwaibaSoapWebService
- Parameters:
classNameEndpointA
- The class name of the endpoint A (some kind of port)idEndpointA
- Id of endpoint AclassNameEndpointB
- The class name of the endpoint Z (some kind of port)idEndpointB
- Id of endpoint ZattributesToBeSet
- Attributes to be set, e.g. mplsLink's namesessionId
- Session token- Returns:
- The id of the newly created transport link
- Throws:
ServerSideException
- If the given linkType is no subclass of GenericLogicalConnection If any of the requested objects can't be found If any of the classes provided can not be found If any of the objects involved can't be connected
-
getMPLSLinkEndpoints
public RemoteMPLSConnectionDetails getMPLSLinkEndpoints(String connectionId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
The details of a given mpls link- Specified by:
getMPLSLinkEndpoints
in interfaceKuwaibaSoapWebService
- Parameters:
connectionId
- the mpls link idsessionId
- Session token- Returns:
- An array of two positions: the first is the A endpoint and the second is the B endpoint
- Throws:
ServerSideException
- f the given id class name is not MPLS Link If any of the requested objects can't be found If any of the classes provided can not be found If any of the objects involved can't be connected
-
connectMplsLink
public void connectMplsLink(String[] sideAClassNames, String[] sideAIds, String[] linksIds, String[] sideBClassNames, String[] sideBIds, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Connect a given mpls links with a given ports for every side- Specified by:
connectMplsLink
in interfaceKuwaibaSoapWebService
- Parameters:
sideAClassNames
- end point side A class namessideAIds
- end point side A idslinksIds
- mpls links idssideBClassNames
- end point side B class namessideBIds
- end point side B idssessionId
- session token- Throws:
ServerSideException
- If the given ports are not subclass of GenericPort If the given link ids are not of the class MPLSLink If any of the requested objects can't be found If any of the classes provided can not be found If any of the objects involved can't be connected
-
disconnectMPLSLink
public void disconnectMPLSLink(String connectionId, int sideToDisconnect, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
disconnect mpls link- Specified by:
disconnectMPLSLink
in interfaceKuwaibaSoapWebService
- Parameters:
connectionId
- mpls link idsideToDisconnect
- which side will be disconnect 1 side A, 2 side B, 3 both sidessessionId
- session token- Throws:
ServerSideException
- If the given link id is not of the class MPLSLink If any of the requested objects can't be found If any of the classes provided can not be found If any of the objects involved can't be connected
-
deleteMPLSLink
public void deleteMPLSLink(String linkId, boolean forceDelete, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a MPLS link- Specified by:
deleteMPLSLink
in interfaceKuwaibaSoapWebService
- Parameters:
linkId
- the id of the mpls linkforceDelete
- Ignore the existing relationshipssessionId
- 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 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.
-
relatePortToInterface
public void relatePortToInterface(String portId, String portClassName, String interfaceClassName, String interfaceId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Associates any GenericCommunicationsPort to existing BridgeDomainInterface- Specified by:
relatePortToInterface
in interfaceKuwaibaSoapWebService
- Parameters:
portId
- MPLSTunnel or BridgeDomain or FrameRelay or VRF idportClassName
- if is a MPLSTunnel or BridgeDomain or FrameRelay or VRFinterfaceClassName
- network element class nameinterfaceId
- network element idsessionId
- Session token- Throws:
ServerSideException
- Generic exception encapsulating any possible error raised at runtime
-
releasePortFromInterface
public void releasePortFromInterface(String interfaceClassName, String interfaceId, String portId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Release the association between a network element and a MPLSTunnel or BridgeDomain or FrameRelay or VRF- Specified by:
releasePortFromInterface
in interfaceKuwaibaSoapWebService
- Parameters:
interfaceClassName
- network element class nameinterfaceId
- network element idportId
- MPLSTunnel or BridgeDomain or FrameRelay or VRF idsessionId
- Session token- Throws:
ServerSideException
- Generic exception encapsulating any possible error raised at runtime
-
getProjectPools
public List<RemotePool> getProjectPools(String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the project pools- Specified by:
getProjectPools
in interfaceKuwaibaSoapWebService
- Parameters:
sessionId
- Session id token- Returns:
- The list of project pools
- Throws:
ServerSideException
- Generic exception encapsulating any possible error raised at runtime
-
getAllProjects
public List<RemoteObjectLight> getAllProjects(String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves the entire list of projects registered in the Project Manager module.- Specified by:
getAllProjects
in interfaceKuwaibaSoapWebService
- Parameters:
sessionId
- The session token.- Returns:
- The entire list of projects created in the Project Manager module.
- Throws:
ServerSideException
- If something unexpected happens.
-
addProject
public String addProject(String parentId, String parentClassName, String className, String[] attributeNames, String[] attributeValues, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Adds a Project- Specified by:
addProject
in interfaceKuwaibaSoapWebService
- Parameters:
parentId
- Parent IdparentClassName
- Parent class nameclassName
- Class nameattributeNames
- Attributes namesattributeValues
- Attributes valuessessionId
- Session id token- Returns:
- The Project id
- Throws:
ServerSideException
- If any of the attributes or its type is invalid If attributeNames and attributeValues have different sizes. If the class name could not be found
-
deleteProject
public void deleteProject(String className, String oid, boolean releaseRelationships, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a Project- Specified by:
deleteProject
in interfaceKuwaibaSoapWebService
- Parameters:
className
- Class nameoid
- Object idreleaseRelationships
- Release relationshipssessionId
- Session id 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
-
addActivity
public String addActivity(String parentId, String parentClassName, String className, String[] attributeNames, String[] attributeValues, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Adds an Activity- Specified by:
addActivity
in interfaceKuwaibaSoapWebService
- Parameters:
parentId
- Parent IdparentClassName
- Parent class nameclassName
- Class nameattributeNames
- Attributes namesattributeValues
- Attributes valuessessionId
- Session id token- Returns:
- The Activity id
- Throws:
ServerSideException
- If the object's class can't be found If the parent id is not found If any of the attribute values has an invalid value or format If the update can't be performed due to a format issue If attributeNames and attributeValues have different sizes.
-
deleteActivity
public void deleteActivity(String className, String oid, boolean releaseRelationships, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes an Activity- Specified by:
deleteActivity
in interfaceKuwaibaSoapWebService
- Parameters:
className
- Class nameoid
- Object idreleaseRelationships
- Release relationshipssessionId
- Session id 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
-
getProjectsInProjectPool
public List<RemoteObjectLight> getProjectsInProjectPool(String poolId, int limit, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the project in a Project pool- Specified by:
getProjectsInProjectPool
in interfaceKuwaibaSoapWebService
- Parameters:
poolId
- Project pool idlimit
- Max number of results, no limit with -1sessionId
- Session id token- Returns:
- An array of projects in a project pool
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the Project pool is not found
-
getProjectResurces
public List<RemoteObjectLight> getProjectResurces(String projectClass, String projectId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the resources (objects) associates with a Project- Specified by:
getProjectResurces
in interfaceKuwaibaSoapWebService
- Parameters:
projectClass
- Project classprojectId
- Project idsessionId
- Session id- Returns:
- An array of resources
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the project is not subclass of GenericProject
-
getProjectActivities
public List<RemoteObjectLight> getProjectActivities(String projectClass, String projectId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets project activities- Specified by:
getProjectActivities
in interfaceKuwaibaSoapWebService
- Parameters:
projectClass
- Project classprojectId
- Project IdsessionId
- Session Id- Returns:
- An array of activities
- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the project is not subclass of GenericProject If the project class is not found If the project is not found
-
associateObjectsToProject
public void associateObjectsToProject(String projectClass, String projectId, String[] objectClass, String[] objectId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Associates a set of objects with a Project- Specified by:
associateObjectsToProject
in interfaceKuwaibaSoapWebService
- Parameters:
projectClass
- Project classprojectId
- Project idobjectClass
- Object classobjectId
- Object idsessionId
- Session id token- Throws:
ServerSideException
- Generic If the project is not subclass of GenericProject If array sizes of objectClass and objectId are not the same
-
associateObjectToProject
public void associateObjectToProject(String projectClass, String projectId, String objectClass, String objectId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Associates an object to a Project- Specified by:
associateObjectToProject
in interfaceKuwaibaSoapWebService
- Parameters:
projectClass
- Project classprojectId
- Project idobjectClass
- Object classobjectId
- Object idsessionId
- Session id token- Throws:
ServerSideException
- If the project is not subclass of GenericProject
-
freeObjectFromProject
public void freeObjectFromProject(String objectClass, String objectId, String projectClass, String projectId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Releases an object associated to a Project- Specified by:
freeObjectFromProject
in interfaceKuwaibaSoapWebService
- Parameters:
objectClass
- Object classobjectId
- Object idprojectClass
- Project classprojectId
- Project idsessionId
- Session id token- Throws:
ServerSideException
- If the project is not subclass of GenericProject
-
getProjectsAssociateToObject
public List<RemoteObjectLight> getProjectsAssociateToObject(String objectClass, String objectId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the projects associate to an object- Specified by:
getProjectsAssociateToObject
in interfaceKuwaibaSoapWebService
- Parameters:
objectClass
- Object classobjectId
- Object idsessionId
- The session id token- Returns:
- An array of projects
- Throws:
ServerSideException
- If the project is no found If the project class is no found
-
createProjectPool
public String createProjectPool(String name, String description, String instanceOfClass, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a Project Pool- Specified by:
createProjectPool
in interfaceKuwaibaSoapWebService
- Parameters:
name
- Project Pool namedescription
- Project Pool descriptioninstanceOfClass
- Project Pool classsessionId
- Session id token- Returns:
- The id of the new Project Pool
- Throws:
ServerSideException
- If he project pool class is no found
-
getAffectedServices
public RemoteAssetLevelCorrelatedInformation getAffectedServices(int resourceType, String resourceDefinition, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves the services affected when a given network resource is alarmed (or down). The services associated directly to the given resource are returned first, but depending on the resource type, the analysis might be more extensive. If the resource is a link (logical or physical), the services associated to the endpoint ports are also returned. If the the resource is a container (physical or logical), the services associated to the contained links are also returned. If the resource is a network equipment, the services associated directly to the ports contained and their connections are also returned.- Specified by:
getAffectedServices
in interfaceKuwaibaSoapWebService
- Parameters:
resourceType
- Use 1 for hardware and 2 for logical linksresourceDefinition
- A semi-colon (;) separated string. The first segment (mandatory) is the name of the affected element, the second is the number of the slot (optional) and the third is the port (optional). Note that to address a logical connection, the resource definition will contain only the name of such connection.sessionId
- Session token- Returns:
- A compact summary with the full information about the device/interface provided, the related services and their customers
- Throws:
ServerSideException
- If the resource could not be found or if the resource definition/resource type is not valid
-
getSynchronizationProviders
public List<RemoteSynchronizationProvider> getSynchronizationProviders(String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Get the set of sync providers defined in the configuration variables pool called -Sync Providers-- Specified by:
getSynchronizationProviders
in interfaceKuwaibaSoapWebService
- Parameters:
sessionId
- Session token- Returns:
- The set of sync providers defined in the configuration variables pool called -Sync Providers-
- Throws:
ServerSideException
- If the pool could not be found If the value of the variable could not be successfully translated into a java type variable If no configuration variable with that name could be found
-
createSynchronizationDataSourceConfig
public long createSynchronizationDataSourceConfig(String objectId, long syncGroupId, String name, List<StringPair> parameters, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a Synchronization Data Source Configuration. A Sync data source configuration is a set of parameters used to connect to a sync data source (usually IPs, paths, etc)- Specified by:
createSynchronizationDataSourceConfig
in interfaceKuwaibaSoapWebService
- Parameters:
objectId
- Id of the object that the configuration is attached tosyncGroupId
- Id of the sync group this configuration is related toname
- The name of the new sync data source configurationparameters
- The list of parameters to be stored as pairs name/value. Note that the Sync provider provides metadata definition to check if the number and format of the parameters correct, so it can be checked at server sidesessionId
- Session token- Returns:
- The id of the newly created sync configuration.
- Throws:
ServerSideException
- If the sync group could not be found or if the any of the parameters does not comply with the expected format
-
createSynchronizationGroup
public long createSynchronizationGroup(String name, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a Synchronization Group. A Sync Group is a set of Synchronization Configurations that will be processed by the same Synchronization Provider. Take into account that the schedule for the SG to be executed is not configured here, but in Task Manager's task- Specified by:
createSynchronizationGroup
in interfaceKuwaibaSoapWebService
- Parameters:
name
- The name of the new sync groupsessionId
- Session token- Returns:
- The id of the newly created sync group
- Throws:
ServerSideException
- If the name or the sync provider are invalid
-
updateSynchronizationGroup
public void updateSynchronizationGroup(long syncGroupId, List<StringPair> syncGroupProperties, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a Synchronization Group. A Sync Group is a set of Synchronization Configurations that will be processed by the same Synchronization Provider. Take into account that the schedule for the SG to be executed is not configured here, but in Task Manager's task- Specified by:
updateSynchronizationGroup
in interfaceKuwaibaSoapWebService
- Parameters:
syncGroupId
- The name of the new sync groupsyncGroupProperties
- The synchronization group propertiessessionId
- Session token- Throws:
ServerSideException
- If the name or the sync provider are invalid
-
getSynchronizationGroup
public RemoteSynchronizationGroup getSynchronizationGroup(long syncGroupId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets a given sync group- Specified by:
getSynchronizationGroup
in interfaceKuwaibaSoapWebService
- Parameters:
syncGroupId
- The sync group idsessionId
- Session token- Returns:
- The requested sync group
- Throws:
ServerSideException
- If the sync group could not be found
-
getSynchronizationGroups
public List<RemoteSynchronizationGroup> getSynchronizationGroups(String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the available sync groups- Specified by:
getSynchronizationGroups
in interfaceKuwaibaSoapWebService
- Parameters:
sessionId
- Session token- Returns:
- The list of available sync groups
- Throws:
ServerSideException
- If something unexpected goes wrong
-
getSyncDataSourceConfiguration
public RemoteSynchronizationConfiguration getSyncDataSourceConfiguration(String objectId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the synchronization data source configurations for an object- Specified by:
getSyncDataSourceConfiguration
in interfaceKuwaibaSoapWebService
- Parameters:
objectId
- the objectIdsessionId
- Session token- Returns:
- The list of available sync groups
- Throws:
ServerSideException
- If something unexpected goes wrong
-
getSyncDataSourceConfigurations
public List<RemoteSynchronizationConfiguration> getSyncDataSourceConfigurations(long syncGroupId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the synchronization data source configurations for a sync group- Specified by:
getSyncDataSourceConfigurations
in interfaceKuwaibaSoapWebService
- Parameters:
syncGroupId
- the syncGroupIdsessionId
- Session token- Returns:
- The list of available sync groups
- Throws:
ServerSideException
- If something unexpected goes wrong
-
updateSyncDataSourceConfiguration
public void updateSyncDataSourceConfiguration(long syncDataSourceConfigId, List<StringPair> parameters, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Updates a sync data source configuration- Specified by:
updateSyncDataSourceConfiguration
in interfaceKuwaibaSoapWebService
- Parameters:
syncDataSourceConfigId
- the sync source configuration Idparameters
- the updated parameterssessionId
- session token- Throws:
ServerSideException
- If the sync data source could not be found or if the any of the parameters does not comply with the expected format
-
deleteSynchronizationGroup
public void deleteSynchronizationGroup(long syncGroupId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a synchronization group and all the sync configurations associated to it- Specified by:
deleteSynchronizationGroup
in interfaceKuwaibaSoapWebService
- Parameters:
syncGroupId
- The id of the groupsessionId
- Session token- Throws:
ServerSideException
- If the group could not be found
-
deleteSynchronizationDataSourceConfig
public void deleteSynchronizationDataSourceConfig(long syncDataSourceConfigId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a sync data source configuration.- Specified by:
deleteSynchronizationDataSourceConfig
in interfaceKuwaibaSoapWebService
- Parameters:
syncDataSourceConfigId
- The id of the configurationsessionId
- Session token- Throws:
ServerSideException
- If the config could not be found
-
copySyncDataSourceConfiguration
public void copySyncDataSourceConfiguration(long syncGroupId, long[] syncDataSourceConfigurationIds, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates "copy" a relation between a set of sync data source configurations and a given sync group- Specified by:
copySyncDataSourceConfiguration
in interfaceKuwaibaSoapWebService
- Parameters:
syncGroupId
- The Sync Group Id targetsyncDataSourceConfigurationIds
- Set of sync data source configuration idssessionId
- Session Token- Throws:
ServerSideException
- If the sync group cannot be found, or some sync data source configuration cannot be found If the sync group is malformed, or some sync data source configuration is malformed
-
releaseSyncDataSourceConfigFromSyncGroup
public void releaseSyncDataSourceConfigFromSyncGroup(long syncGroupId, long[] syncDataSourceConfigurationIds, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Release a set of sync data source configuration from a given sync group- Specified by:
releaseSyncDataSourceConfigFromSyncGroup
in interfaceKuwaibaSoapWebService
- Parameters:
syncGroupId
- The Sync Group Id targetsyncDataSourceConfigurationIds
- Set of sync data source configuration idssessionId
- Session Token- Throws:
ServerSideException
- If the sync group cannot be found, or some sync data source configuration cannot be found If the sync group is malformed, or some sync data source configuration is malformed
-
moveSyncDataSourceConfiguration
public void moveSyncDataSourceConfiguration(long newSyncGroupId, long[] syncDataSourceConfigurationIds, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Moves a sync data source configuration from a sync group to another sync group- Specified by:
moveSyncDataSourceConfiguration
in interfaceKuwaibaSoapWebService
- Parameters:
newSyncGroupId
- The Sync Group Id target to releasesyncDataSourceConfigurationIds
- Set of sync data source configuration idssessionId
- Session token- Throws:
ServerSideException
- If the sync group cannot be found, or some sync data source configuration cannot be found If the sync group is malformed, or some sync data source configuration is malformed
-
createProcessDefinition
public long createProcessDefinition(String name, String description, String version, boolean enabled, byte[] structure, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates a process definition. A process definition is the metadata that defines the steps and constraints of a given project- Specified by:
createProcessDefinition
in interfaceKuwaibaSoapWebService
- Parameters:
name
- The name of the new process definitiondescription
- The description of the new process definitionversion
- The version of the new process definition. This is a three numbers, dot separated string (e.g. 2.4.1)enabled
- If the project is enabled to create instances from itstructure
- The structure of the process definition. It's an XML document that represents a BPMN process definitionsessionId
- The session token- Returns:
- The id of the newly created process definition
- Throws:
ServerSideException
- If the process structure defines a malformed process or if the version is invalid
-
updateProcessDefinition
public void updateProcessDefinition(long processDefinitionId, List<StringPair> properties, byte[] structure, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Updates a process definition, either its standard properties or its structure- Specified by:
updateProcessDefinition
in interfaceKuwaibaSoapWebService
- Parameters:
processDefinitionId
- The process definition idproperties
- A key value dictionary with the standard properties to be updated. These properties are: name, description, version and enabled (use 'true' or 'false' for the latter)structure
- A byte array withe XML process definition bodysessionId
- The session token- Throws:
ServerSideException
- If the structure is invalid, or the process definition could not be found or one of the properties is malformed or have an unexpected name
-
deleteProcessDefinition
public void deleteProcessDefinition(long processDefinitionId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes a process definition- Specified by:
deleteProcessDefinition
in interfaceKuwaibaSoapWebService
- Parameters:
processDefinitionId
- The process definition to be deletedsessionId
- The session token- Throws:
ServerSideException
- If the process definition could not be found or if there are process instances related to the process definition
-
getProcessDefinition
public RemoteProcessDefinition getProcessDefinition(long processDefinitionId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves a process definition- Specified by:
getProcessDefinition
in interfaceKuwaibaSoapWebService
- Parameters:
processDefinitionId
- The id of the processsessionId
- The session token- Returns:
- The process definition. It contains an XML document to be parsed by the consumer
- Throws:
ServerSideException
- If the process could not be found or if it's malformed
-
createProcessInstance
public long createProcessInstance(long processDefinitionId, String processInstanceName, String processInstanceDescription, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates an instance of a process, that is, starts one- Specified by:
createProcessInstance
in interfaceKuwaibaSoapWebService
- Parameters:
processDefinitionId
- The id of the process to be startedprocessInstanceName
- The name of the new processprocessInstanceDescription
- The description of the new processsessionId
- The session token- Returns:
- The id of the newly created process instance
- Throws:
ServerSideException
- If the process definition could not be found or if it's disabled
-
getNextActivityForProcessInstance
public RemoteActivityDefinition getNextActivityForProcessInstance(long processInstanceId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Requests for the next activity to be executed in a process instance.- Specified by:
getNextActivityForProcessInstance
in interfaceKuwaibaSoapWebService
- Parameters:
processInstanceId
- The running process to get the next activity fromsessionId
- The session id- Returns:
- The activity definition
- Throws:
ServerSideException
- If the process instance could not be found, or if the process already ended
-
commitActivity
public void commitActivity(long processInstanceId, long activityDefinitionId, RemoteArtifact artifact, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Saves the artifact generated once an activity has been completed (for example, the user filled in a form).- Specified by:
commitActivity
in interfaceKuwaibaSoapWebService
- Parameters:
processInstanceId
- The process instance the activity belongs toactivityDefinitionId
- The activity idartifact
- The artifact to be savedsessionId
- The session token- Throws:
ServerSideException
- If the process could not be found, or if the activity had been already executed, or if the activity definition could not be found, or of there's a mismatch in the artifact versions or if the user is not an authorized actor to carry on with the activity
-
getArtifactDefinitionForActivity
public RemoteArtifactDefinition getArtifactDefinitionForActivity(long processDefinitionId, long activityDefinitionId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Given an activity definition, returns the artifact definition associated to it- Specified by:
getArtifactDefinitionForActivity
in interfaceKuwaibaSoapWebService
- Parameters:
processDefinitionId
- The id of the process the activity is related toactivityDefinitionId
- The id of the activitysessionId
- The session token- Returns:
- An object containing the artifact definition
- Throws:
ServerSideException
- If the process or the activity could not be found
-
getArtifactForActivity
public RemoteArtifact getArtifactForActivity(long processInstanceId, long activityId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
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)- Specified by:
getArtifactForActivity
in interfaceKuwaibaSoapWebService
- Parameters:
processInstanceId
- The id of the process instance. This process may have been ended already.activityId
- The id of the activity the artifact belongs tosessionId
- The session token- Returns:
- The artifact corresponding to the given activity
- Throws:
ServerSideException
- If the process instance or activity couldn't be found.
-
getWarehouseRootPools
public List<RemotePool> getWarehouseRootPools(String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Gets the warehouse module root pools.- Specified by:
getWarehouseRootPools
in interfaceKuwaibaSoapWebService
- Parameters:
sessionId
- Session token.- Returns:
- the warehouse module root pools.
- Throws:
ServerSideException
- If the class GenericWarehouse does not exist.
-
associatePhysicalNodeToWarehouse
public void associatePhysicalNodeToWarehouse(String objectClass, String objectId, String warehouseClass, String warehouseId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Associates an object (a resource) to an existing warehouse or virtual warehouse- Specified by:
associatePhysicalNodeToWarehouse
in interfaceKuwaibaSoapWebService
- Parameters:
objectClass
- Object classobjectId
- Object idwarehouseClass
- Warehouse classwarehouseId
- Warehouse idsessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method 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
-
associatesPhysicalNodeToWarehouse
public void associatesPhysicalNodeToWarehouse(String[] objectClass, String[] objectId, String warehouseClass, String warehouseId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Associates a list of objects (resources) to an existing warehouse or virtual warehouse- Specified by:
associatesPhysicalNodeToWarehouse
in interfaceKuwaibaSoapWebService
- Parameters:
objectClass
- Object classobjectId
- Object idwarehouseClass
- Warehouse classwarehouseId
- Warehouse idsessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method 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
-
releasePhysicalNodeFromWarehouse
public void releasePhysicalNodeFromWarehouse(String warehouseClass, String warehouseId, String targetId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Releases an object from a warehouse or virtual warehouse that is using it- Specified by:
releasePhysicalNodeFromWarehouse
in interfaceKuwaibaSoapWebService
- Parameters:
warehouseClass
- Warehouse classwarehouseId
- Warehouse idtargetId
- target object idsessionId
- Session token- Throws:
ServerSideException
- If the user is not allowed to invoke the method If the object can not be found If the class can not be found If the object activity log could no be found
-
moveObjectsToWarehousePool
public void moveObjectsToWarehousePool(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 warehouse pool target object.- Specified by:
moveObjectsToWarehousePool
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
-
moveObjectsToWarehouse
public void moveObjectsToWarehouse(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:
moveObjectsToWarehouse
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
-
getBGPMap
public List<RemoteLogicalConnectionDetails> getBGPMap(List<String> mappedBgpLinksIds, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates/updates a map of the BGPLinks- Specified by:
getBGPMap
in interfaceKuwaibaSoapWebService
- Parameters:
mappedBgpLinksIds
- BGPLinks that are already mapped, it can be an empty array if nothing is mapped of if the whole map should be generated again.sessionId
- The session token- Returns:
- A list of BGPlinks with their endPoints(ports) and the CommunicationsElements parents of the ports
- Throws:
ServerSideException
- If the structure is invalid, or the process definition could not be found or one of the properties is malformed or have an unexpected name
-
createOSPView
public long createOSPView(String name, String description, byte[] content, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Creates an Outside Plant View- Specified by:
createOSPView
in interfaceKuwaibaSoapWebService
- Parameters:
name
- The name of the new viewdescription
- The description of the new viewcontent
- The XML document with the contents of the view. The format of the XML document is consistent with the other viewssessionId
- Session token- Returns:
- The id of the newly created view
- Throws:
ServerSideException
- If the name is empty.
-
getOSPView
public RemoteViewObject getOSPView(long viewId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves the specific information about an existing OSP view- Specified by:
getOSPView
in interfaceKuwaibaSoapWebService
- Parameters:
viewId
- The id of the viewsessionId
- The session token- Returns:
- An object containing the view details and structure
- Throws:
ServerSideException
- If the view could not be found
-
getOSPViews
public List<RemoteViewObjectLight> getOSPViews(String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Retrieves the existing OSP views- Specified by:
getOSPViews
in interfaceKuwaibaSoapWebService
- Parameters:
sessionId
- The session token- Returns:
- The list of existing OSP views
- Throws:
ServerSideException
- If an unexpected error appeared
-
updateOSPView
public void updateOSPView(long viewId, String name, String description, byte[] content, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Updates an existing OSP view- Specified by:
updateOSPView
in interfaceKuwaibaSoapWebService
- Parameters:
viewId
- The id of the viewname
- The new name of the view. Null if to remain unchangeddescription
- The new description of the view. Null if to remain unchangedcontent
- The new content of the view. Null if to remain unchangedsessionId
- The session token- Throws:
ServerSideException
- If the view could not be found or if the new name (if applicable) is empty
-
deleteOSPView
public void deleteOSPView(long viewId, String sessionId) throws ServerSideException
Description copied from interface:KuwaibaSoapWebService
Deletes an existing OSP view- Specified by:
deleteOSPView
in interfaceKuwaibaSoapWebService
- Parameters:
viewId
- The id of the view to be deletedsessionId
- The session token- Throws:
ServerSideException
- If the view could not be found
-
getIPAddress
public String getIPAddress()
Description copied from interface:KuwaibaSoapWebService
Gets the IP address from the client issuing the request- Specified by:
getIPAddress
in interfaceKuwaibaSoapWebService
- Returns:
- the IP address as string
-
-