Compartir a través de

SP. Método UserCustomActionCollection.add (sp.js)

  • Artículo

Agrega una nueva acción personalizada del objeto SP.UserCustomAction object (sp.js)SP. UserCustomAction object (sp.js) a la colección.

Última modificación: viernes, 13 de diciembre de 2013

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

SP.UserCustomActionCollection.add()

Valor devuelto

Tipo: SP.UserCustomAction

Ejemplo

En el ejemplo siguiente se crea un botón de entrada en una página de aplicación que se agrega un nuevo elemento de menú al menú Acciones del sitio del sitio Web actual.

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

function runCode() {
    var clientContext = new SP.ClientContext();
    var site = clientContext.get_web();
    var UserCustomActions = site.get_userCustomActions();

    var newUserCustomAction = UserCustomActions.add();
    newUserCustomAction.set_location('Microsoft.SharePoint.StandardMenu');
    newUserCustomAction.set_group('SiteActions');
    newUserCustomAction.set_sequence(1000);
    newUserCustomAction.set_title('New Menu Item');
    newUserCustomAction.set_imageUrl('/_layouts/images/myIcon.jpg');
    newUserCustomAction.set_description('Menu item added via ECMAScript');
    newUserCustomAction.set_url('/_layouts/create.aspx');
    newUserCustomAction.update();
    clientContext.executeQueryAsync(Function.createDelegate(this, this.onQuerySucceeded), Function.createDelegate(this, this.onQueryFailed));
}

function onQuerySucceeded(sender, args) {
    alert('New menu item added to Site Actions menu.\n\nTo view the new menu item, refresh the page.');
}

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 crear una acción personalizada de usuario, envíe una solicitud de POST al extremo del UserCustomActions . Para obtener más información, vea recurso UserCustomActionCollection .