Share via


SP. Objeto de usuario (Object sp.js)

Representa un usuario de spfnvlongMicrosoft SharePoint Foundation.

Última modificación: lunes, 9 de marzo de 2015

Hace referencia a: apps for SharePoint | SharePoint Foundation 2013 | SharePoint Server 2013

var object = new SP.User()

Miembros

El objeto User tiene los siguientes miembros.

Constructor

El objeto User tiene el siguiente constructor.

Constructor

Descripción

Usuario

Inicializa una nueva instancia del objeto SP.User.

Métodos

El objeto User tiene los siguientes métodos.

Método

Descripción

initPropertiesFromJson

actualización

Actualiza el usuario con los cambios realizados en sus propiedades.

Propiedades

El objeto User tiene las siguientes propiedades.

Propiedad

Descripción

correo electrónico

Obtiene o establece la dirección de correo electrónico del usuario.

grupos

Obtiene la colección de grupos a los que pertenece el usuario.

isSiteAdmin

Obtiene o establece un valor booleano que especifica si el usuario es administrador de la colección de sitios.

userId

Obtiene la información del usuario que contiene el identificador del nombre del usuario y el emisor del identificador del nombre del usuario.

Ejemplo

En el ejemplo siguiente se crea un botón de entrada en una página de aplicación que agrega el usuario actual al grupo visitantes en el sitio Web actual.

<asp:Content ID="Main" ContentPlaceHolderID="PlaceHolderMain" runat="server">
<script type="text/ecmascript" language="ecmascript">

var user;
var visitorsGroup;

function runCode() {

     var clientContext = new SP.ClientContext();
     var groupCollection = clientContext.get_web().get_siteGroups();
     // Get the visitors group, assuming its ID is 4.
     visitorsGroup = groupCollection.getById(4);
     user = clientContext.get_web().get_currentUser();
     var userCollection = visitorsGroup.get_users();
     userCollection.addUser(user);

     clientContext.load(user);
     clientContext.load(visitorsGroup);
     clientContext.executeQueryAsync(Function.createDelegate(this, this.onQuerySucceeded), Function.createDelegate(this, this.onQueryFailed));

}

function onQuerySucceeded() {
    alert(user.get_title() + " added to group " + visitorsGroup.get_title());
}

function onQueryFailed(sender, args) {
    alert('Request failed. ' + args.get_message() + '\n' + args.get_stackTrace());
}

</script>

    <input id="Button1" type="button" value="Run Code" onclick="runCode()" />

</asp:Content>

Extremo del recurso de REST

Para obtener más información, vea recursos de usuario .

Estructura de URI de extremo

http://<sitecollection>/<site>/_api/web/sitegroups(groupid)/users(loginname)

Solicitudes HTTP

Este recurso admite los siguientes comandos HTTP:

Sintaxis de DELETE

DELETE http://<sitecollection>/<site>/_api/web/sitegroups(groupid)/users(loginname)

Sintaxis de MERGE

MERGE http://<sitecollection>/<site>/_api/web/sitegroups(groupid)/users(loginname)

Sintaxis de POST

POST http://<sitecollection>/<site>/_api/web/sitegroups(groupid)/users(loginname)

Sintaxis de PUT

PUT http://<sitecollection>/<site>/_api/web/sitegroups(groupid)/users(loginname)