sábado, 15 de diciembre de 2012

Variables/objectos/métodos útiles de javascript disponibles en Sharepoint

Muchas de estos métodos, objectos, variables son generados desde los archivos init.js, core.js , por lo cual es necesario que esté el link a los js anteriormente mencionados.

_spUserId

Esta variable guarda el ID del usuario logueado. Para obtener más información del usuario logueado con esta variable podemos usar el siguiente método definido en el siguiente link:

http://sharepointjavascript.wordpress.com/2011/09/18/accessing-user-profile-information-in-sharepoint-with-javascript-updated-version/

Ej: escribe en la barra de navegación el siguiente script: javascript:alert(_spUserId);

L_Menu_BaseUrl

La url base del site / subsite. Nos ayuda crear paths absolutos. Ej: document.location = L_Menu_BaseUrl + ‘lists/task/allitems.aspx’ //nos redirigue a Task List

L_Menu_LCID

El LCID del site actual. Útil para determinar el lenguaje del site. En este site (http://msdn.microsoft.com/en-US/goglobal/bb964664.aspx) podrán encontrar todos los LCID´s disponibles. Ej: 1033  (Inglés)

L_Menu_SiteTheme

El nombre del theme que se aplica al site. Ej: Lacquer. Si no tiene un theme aplicado, devolverá vacio.

_spPageContextInfo


Es un objecto que tiene muchas propiedades:
    a. webServerRelativeUrl (url relativa para la web actual. Ej: \u002fsites\u002fTestSite\u002WebSite)
    b. siteServerRelativeUrl (current site collection url. Ej: \u002fsites\u002fTestSite)
    c. webLanguage (Ej: 1033)
    d. currentLanguage (Ej: 1033)
    e. webUIVersion (Ej: 4)
    f. userId (Current user, mismo valor que _spUserId: ej: http://www.jbmurphy.com/2012/12/05/using-_sppagecontextinfo-ajax-and-samaccountname-to-show-a-hidden-item-in-a-sharepoint-page/)
    g. alertsEnabled (Si está habilitado las alertas para la página)
    h. allowSilverlightPrompt (Si se permite preguntar por silverlight o no. Ej: true)
    i. pageItemId (Guid del item actual)
    j. pageListId (Guid de la lista que contiene el item actual)
   

Ej: verificar si estoy en el root web del site collection
var siteUrl = _spPageContextInfo.siteServerRelativeUrl;
var webUrl = _spPageContextInfo.webServerRelativeUrl;
var isRootWeb = siteUrl == webUrl;

g_wsaSiteTemplateId
Informa sobre el current site template del site. Ej:  'BLOG#0'

JSRequest
Es un  objecto que nos permite tomar información de la página actual, más que nada los valores presentes en la url.

//Primero se debe llamar al método EnsureSetup
JSRequest.EnsureSetup();

var q = JSRequest.QueryString["itemId"]; //  "page.aspx?ItemId=5" nos devolverá 5
var f = JSRequest.FileName; // Ej: default.aspx
var p = JSRequest.PathName; // url relativa del servidor. Ej: "/website/pages/default.aspx"

_spBodyOnLoadFunctionNames
Array de de funciones de javascript que se ejecuta después de que el DOM esté completamente cargado. Si desea ejecutar su función una vez que la página esté completamente cargada, use este array. Por ejemplo _spBodyOnLoadFunctionNames.push ("MiFuncion");

function MiFuncion() {
   alert('Esta función se ejecutara en el evento onload de la  página');
}

browseris
Este objeto tiene varias propiedades para detectar el nombre del navegador, la versión, versión del sistema operativ.
Por ejemplo, si usted quiere saber si el navegador actual es Internet Explorer o no compruebe browseris.ie

g_ExtensionDefaultForRead

Un arreglo de extensiones de archivos que son siempre checked out como Read only. Ej: jpg, jpeg, bmp

g_ExtensionNotSupportCheckoutToLocal

Un arreglo de extensiones que no son permitidos hacer checkout localmente.Ej: aspx, ascx, cmd

GetUrlKeyValue()
Es una función de javascript que permite obtener parámetros de query string de la url del navegador o de una url pasada como parámetro.

alert(GetUrlKeyValue('query', false, 'www.demo.com?query=te%20st'));
Devolverá ‘te st’. Se especificó una url específica.

alert(GetUrlKeyValue('query', false));
Busca el valor del query string 'query' y nos devuelve el valor decodificado (parámetro false)

alert(GetUrlKeyValue('query'));
Busca el valor del query string 'query, sin decodificar.

escapeProperly
Esta función retorna un valor codificada
var valor = escapeProperly("hola mundo!!"); //valor = "hola%20mundo%21%21"

unescapeProperly

Esta función decodifica un string codificado
var valor = unescapeProperly("hola%20mundo%21%21"); //valor = "hola mundo!!"

STSHtmlEncode(htmlString)
Esta función codifica un texto html

var valor = STSHtmlEncode("<p>ejemplo texto</p>");
//valor = "&lt;p&gt;ejemplo texto&lt;/p&gt;"

TrimSpaces(str)
Remueve los espacios en blanco del principio y final.No remueve caracteres especiales tales como ‘\n’, \t’, para ello se puede usar TrimWhiteSpaces.

var valor = TrimSpaces("   Hola   Mundo!!    "); //valor = "Hola   Mundo!!"

LoginAsAnother(url, bUseSource)
Permite loguearse con otro nombre de usuario.Permite definir la url a donde se enviará el usuario después del login.

<a href="#" onclick="javascript:LoginAsAnother('\u002f_layouts\u002fAccessDenied.aspx?loginasanotheruser=true', 0)">Log on como otro usuario</a>

No hay comentarios:

Publicar un comentario