uwdoem/group

Client library for the University of Washington Group Web Services

1.0.13 2017-11-20 18:31 UTC

This package is not auto-updated.

Last update: 2024-11-02 02:27:34 UTC


README

Build Status Latest Stable Version

UWDOEM/Group

Smoothly poll the University of Washington's Person Web Service (PWS) and Student Web Service (SWS) to aggregate data on a given affiliate, using X.509 certificate authentication.

Notice

This is not an official library, endorsed or supported by any party who manages or owns information accessed via GWS. This library is not endorsed or supported by the University of Washington Department of Enrollment Management.

Installation

This library is published on packagist. To install using Composer, add the "uwdoem/group": "1.*" line to your "require" dependencies:

{
    "require": {
        "uwdoem/aliro": "1.*"
    }
}

Of course it is possible to use Aliro without Composer by downloading it directly, but use of Composer to manage packages is highly recommended. See Composer for more information.

Use

You will need a private key and university signed certificate to access the GWS.

You can set the required settings anywhere in your app, but we recommend using a local-settings.php file.

// Intialize the required settings 
define('UW_GWS_BASE_PATH', '/path/to/your/api/'); 
define('UW_GWS_SSL_KEY_PATH', './path/to/your/key'); 
define('UW_GWS_SSL_CERT_PATH', './path/to/your/certificate'); 
define('UW_GWS_SSL_KEY_PASSWD', 'yourpassword'); // Can be blank for no password: '' 
define('UW_GWS_VERBOSE', true); // (Optional) Whether to include verbose cURL messages in error messages.

The terms UW_GWS_SSL_KEY_PATH and UW_GWS_SSL_CERT_PATH correspond to the absolute locations of your private key and university-signed certificate. The UW_GWS_SSL_KEY_PASSWD corresponds to the string which unlocks your private key; if your key does not have a password then use a blank string, eg: ''.

The term UW_GWS_BASE_PATH corresponds to the base URL for the group web service.

Now you can create a group access object, and begin querying the GWS. For more information about which endpoints are available, please refer to the GWS documentation.

$g = new Group("test_group_name"); // You can pass either the group name or id

$memberList = $g->getMembers()

Troubleshooting

X-Act-As

Some endpoints will return an error if you set X-Act-As, while others allow it. Make sure you are using UWDOEM/Connection 3.*, and that you are not including X-Act-As in connection options.

Requirements

  • PHP 7.0
  • uwdoem/connection 3.*