Video Screencast Help

SEP components Get Client List

Created: 18 Jun 2013 | 3 comments

Hello -

Anyone have any experience with the SEP 'Get Client List' and/or 'Get Client List Page' components in Workflow?

The 'Get Client List' component has an input variable called 'Record List Input' but I don't know what information I need to provide.

Similarly, the 'Get Client List Page' component has 5 input variables: arg2, arg4, Count, Result ID, and Start Point... but I don't know what any of those are.

Any/all insights are greatly appreciated.  Tnx, Tom

Operating Systems:

Comments 3 CommentsJump to latest comment

reecardo's picture

Per the latest API documentation:

getClientList

public ClientPropertiesList getClientList(RecordListInput recordListInput)
                                   throws SpcFault,
                                          InvalidSessionFault,
                                          InsufficientAccessFault,
                                          BadArgumentFault
Returns the clients information for the specified filters in RecordListInput class. Valid filter values are COMPUTERID, HOSTNAME, IPADDRESS, USERNAME, GROUPID At least one filter is compulsory Start value must be set to 0 To set and get Page size in RecordListInput, there are set and get methods available (setCount and getCount).

 

Parameters:
recordListInput - This input parameter contains filter, start and pagesize.
Returns:
List<ClientPropertiesList> List of objects containing data for each individual client
Throws:
SpcFault - Generic exception for any other error
InvalidSessionFault - if user's session is expired or nonexistent
InsufficientAccessFault - if user try to access the system with insufficient privileges
BadArgumentFault - if an input parameter is invalid
 

getClientListPage

public ClientPropertiesList getClientListPage(java.lang.String resultId,
                                              java.lang.Integer startPoint,
                                              java.lang.Integer count)
                                       throws SpcFault,
                                              BadArgumentFault,
                                              InsufficientAccessFault,
                                              InvalidSessionFault
Gets the cached page for the given resultId as Key

 

Parameters:
startPoint - Integer value for starting Point of the list
count - Integer value of number of client requested
resultId - GUID Key for the results in Map
Returns:
List<ClientPropertiesList> List of objects containing data for each individual client
Throws:
SpcFault - Generic exception for any other error
BadArgumentFault - if the result ID is not found
InsufficientAccessFault - if user had no admin privilege
InvalidSessionFault - if user's session is expired or nonexistent
BadArgumentFault - if value of startPoint is invalid
 
So it looks like these SEP comps are from an old WF version where the comps were written against an old version of SEP (3 arguments to getClientListPage vs 5). In this old version: arg2 is Start Point Specified, and arg4 is Count Specified. So you'd possible specify true if you're supplying these parameters.
TomS's picture

Thanks reecardo!

I've gotten the first component (i.e. 'Get Client List') to work.  I specified the count as 10000 (initially I got an error message indicating valid values for count were from 1 to 10000), and specified the start as 0.  I left both 'result Id' and 'sorting List' blank.  For 'filter List' I specified 'filter Column' as HOSTNAME, and 'filter Value' as the host name of a computer on our network.  The component returned all the detailed information concerning that SEP client, so we're good to go on this one.

I'm still struggling with 'Get Client List Page' though... If I set arg2 and arg4 to False, and leave the Count and Start Points as blank, I get an 'Object reference not set to an instance of an object' error regardless of what I supply as the 'Result ID' (or if I leave the Result ID blank).  On the other hand, if I specify True for arg2 and arg4, and I supply the Count as 10000, and the Start Point as 0, I get an error message stating  'Specified cast is not valid.' regardless of what I put as the Result ID (or if I leave the Result ID blank).  Do you know if the result ID should be a GUID for a SEP group, a SEP client, or something else?  Any additional thoughts on this component?

Thanks again for your help.  Tom

reecardo's picture

resultID is a guid... for what, I don't know (a SEP guy would be helpful here)... one thing to note is that GUIDs for SEP don't have dashes I believe, so if you've been using dashes, take them out.

It's also worth looking at the WSDL for this service and verifying its expecting 5 parameters vs. the 3 in the latest SEP stuff I'm seeing... that also might explain the bad cast.