Local user

Applies to: Skype for Business 2015

Local user

Using the mePerson object

The MePerson object is retrieved through the application.personsAndGroupsManager.mePerson property. For example, the following JavaScript code sample sets the availability of the signed in user to online.

// tell the mePerson to change the availability state

app.personsAndGroupsManager.mePerson.status.set('Online').then(function () {
    alert('The status of mePerson has been changed');
}).then(null, function (error) {
    // and if could not be changed, report the failure
    alert(error || 'The server has rejected this availability state.');
});

MePerson properties which can be set

Property Description
location Gets or sets the location of the signed in user.
note.text Gets or sets the personal note of the signed in user.
status Gets or sets the availability of the signed in user.

Note

When the above values contain special characters such as <, >, and they will be padded with zero width whitespace. This can cause equality operations to fail unexpectedly. One option for handling this situation is to filter out these special values so they are not used.

MePerson properties which are read-only

Property Description
department Gets the work department of the signed in user.
email Gets the primary email address of the signed in user.
emails Gets the email addresses associated with the signed in user.
displayName Gets the display name of the signed in user.
avatarUrl Gets the photo URL of the signed in user.
title Gets the business title of the signed in user.
id Gets the SIP URI of the signed in user.
// retrieve local user details
const mePerson = app.personsAndGroupsManager.mePerson;
photo.src = mePerson.avatarUrl();
window.setTimeout(function (photo: HTMLImageElement) {
    // if the photo isn't set revert back to a default
    if (photo.naturalWidth === 0 || photo.naturalHeight === 0) {
        photo.src = './images/samples/default.png';
    }
}, 1000, photo);
name.innerHTML = mePerson.displayName();
status.src = getStatusPath(mePerson.status());
message.innerHTML = mePerson.note.text();
location.innerHTML = mePerson.location();

See also

Concepts

Show a person's information

Other resources

MePerson