Internet2 is investigating a security incident involving a compromise to a confluence server that affected https://spaces.at.internet2.edu on April 10, 2019, which was successfully mitigated on April 12, 2019. If you did not receive an email from us, it’s unlikely that any of the content you submitted to the Internet2 Spaces Wiki needs to be re-entered. We apologize for any inconvenience this may have caused. Should you have any questions or require further assistance, please email collaboration-support@internet2.edu.
Child pages
  • Get Subjects
Skip to end of metadata
Go to start of metadata

Grouper Web Services

Description

Get subjects will retrieve subject objects by subject lookups (source (optional), id or identifier), or by search string (free-form string that sources can search on), and optionally a list of sources to narrow the search.

Features

  • Can search by subject lookup(s): e.g. by subjectId, by subjectIdentifier, by subjectId and source, by subjectIdentifier and source
  • Can search by freeform search string: e.g. search for "Chris Hyzer" and the jdbc2 source will find all subjects with chris and hyzer in the description
  • Can actAs another user
  • Can filter by list of sources for freeform search string
  • Can filter for member of group, though this is not exact, will get the list of subjects, then see which are in the group.  If the number of subjects found is more than a limit, it will not allow the search
  • In 2.1.6+ you can search for members in a group that will be efficient since it uses a member search field.  If you pass in the param SearchStringEnumZeroIndexed with a value of 0-4 (if there are 5 search fields), then that is the search field it will use, otherwise the default search field will be used

Get subjects Lite service

  • Accepts one subjectLookup or one search string and optional source.  Also a group lookup for filtering
  • Documentation: SOAP (click on getSubjectsLite), REST (click on getSubjectsLite)
  • For REST, the request can put data in query string (in URL or request body)
  • REST request (colon is escaped to %3A):
    • GET /grouper-ws/servicesRest/v1_6_000/subjects/12345
    • Note: if passing data in request body e.g. actAs, use a POST
  • (see documentation above for details): Request object, response object
  • Response codes
  • Samples (all files with "Lite" in them, click on "download" to see file)

Get subjects service

  • Accepts multiple subject lookups or a search string and option source id.  Also a group lookup for filtering
  • Documentation: SOAP (click on getSubjects), REST (click on getSubjects)
  • REST request (colon is escaped to %3A):
    • POST /grouper-ws/servicesRest/v1_6_000/subjects
  • (see documentation above for details): Request object, response object
  • Response codes overall
  • Returns an overall status
  • Samples (all files without "Lite" in them, click on "download" to see files)
  • No labels