Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Implementar elementos web de SharePoint estándares preconfigurados para los usuarios.
Se aplica a: SharePoint 2013 | Complementos de SharePoint | SharePoint Online
Puede cargar elementos web de SharePoint estándares preconfigurados para que los usuarios los añadan a sus sitios de SharePoint. Por ejemplo, puede cargar los siguientes elementos preconfigurados:
Elemento web editor de scripts que usa archivos JavaScript en la web remota.
Elemento web de búsqueda de contenido.
Este artículo describe configurar previamente el elemento web editor de scripts que usa archivos JavaScript en la web remota para realizar la personalización de la interfaz de usuario. Use esta solución para:
Usar archivos de script de la web remota en los elementos web, en lugar de hacer referencia a scripts de la lista Activos del sitio en la web del host.
Implementar elementos web preconfigurados en el proceso de aprovisionamiento de su sitio personalizado. Por ejemplo, como parte del proceso de aprovisionamiento del sitio personalizado, puede interesarle mostrar al usuario la información de la política de uso del sitio cuando se crea un sitio nuevo.
Cargar automáticamente contenido filtrado en los elementos web para los usuarios. Por ejemplo, el archivo de script puede mostrar información de las noticias locales obtenidas desde un sistema externo.
Permitir a los usuarios agregar funciones adicionales a su sitio mediante elementos web de la Galería de elementos web.
Antes de empezar
Para empezar, descargue el complemento de ejemplo Core.AppScriptPart del proyecto de procedimientos y patrones para desarrolladores de Office365 en GitHub.
Usar el complemento de Core.AppScriptPart
Cuando ejecuta el código de ejemplo y elige Ejecutar escenario:
Elija Volver al sitio.
Elija PÁGINA>Editar>INSERTAR>Elemento Web.
En Categorías, elija Elemento script del complemento y luego elija Información de perfil de usuario.
Seleccione Agregar.
En la lista desplegable, en la esquina superior derecha del elemento web Información de perfil de usuario, elija Editar elemento web.
Elija EDITAR FRAGMENTO DE CÓDIGO.
Revise el elemento <SCRIPT>.
Observe que el atributo src se vincula a un archivo JavaScript en la web remota. El elemento <SCRIPT> está establecido por la propiedad Contenido en el Core.AppScriptPartWeb\userprofileinformation.webpart, como se muestra en el ejemplo siguiente. El archivo JavaScript al que vincula el atributo src es Core.AppScriptPartWeb\Scripts\userprofileinformation.js. Userprofileinformation.js lee la información de perfil del usuario actual desde el servicio de perfiles de usuario y, después, muestra esta información en el elemento web.
Nota:
El código de este artículo se proporciona tal cual, sin garantía de ningún tipo, expresa o implícita, incluidas las garantías implícitas de aptitud para un propósito particular, comerciabilidad o ausencia de infracción.
<property name="Content" type="string">&lt;script type="text/javascript" src="https://localhost:44361/scripts/userprofileinformation.js"&gt;&lt;/script&gt;
&lt;div id="UserProfileAboutMe"&gt;&lt;div&gt;
</property>
Elija Cancelar.
Elija Guardar.
Nota:
Si no se muestra la imagen de perfil del usuario, abra el sitio de OneDrive para la Empresa y, después, vuelva a la web del host.
En Core.AppScriptPartWeb\Pages\Default.aspx, Ejecutar escenario ejecuta btnScenario_Click, que hace lo siguiente:
Obtiene una referencia a la carpeta de la Galería de elementos web.
Usa FileCreationInformation para crear el archivo userprofileinformation.webpart y cargarlo desde el complemento hospedado por el proveedor a la Galería de elementos web. El método folder.Files.Add agrega el archivo a la Galería de elementos web.
Recupera todos los elementos de lista de la Galería de elementos web y, a continuación, busca userprofileinformation.webpart.
Cuando se encuentra userprofileinformation.webpart, asigna el elemento web a un grupo personalizado denominado Elemento Script de complemento.
protected void btnScenario_Click(object sender, EventArgs e)
{
var spContext = SharePointContextProvider.Current.GetSharePointContext(Context);
using (var clientContext = spContext.CreateUserClientContextForSPHost())
{
var folder = clientContext.Web.Lists.GetByTitle("Web Part Gallery").RootFolder;
clientContext.Load(folder);
clientContext.ExecuteQuery();
// Upload the "userprofileinformation.webpart" file.
using (var stream = System.IO.File.OpenRead(
Server.MapPath("~/userprofileinformation.webpart")))
{
FileCreationInformation fileInfo = new FileCreationInformation();
fileInfo.ContentStream = stream;
fileInfo.Overwrite = true;
fileInfo.Url = "userprofileinformation.webpart";
File file = folder.Files.Add(fileInfo);
clientContext.ExecuteQuery();
}
// Update the group that the Web Part belongs to. Start by getting all list items in the Web Part Gallery, and then find the Web Part that was just uploaded.
var list = clientContext.Web.Lists.GetByTitle("Web Part Gallery");
CamlQuery camlQuery = CamlQuery.CreateAllItemsQuery(100);
Microsoft.SharePoint.Client.ListItemCollection items = list.GetItems(camlQuery);
clientContext.Load(items);
clientContext.ExecuteQuery();
foreach (var item in items)
{
// Create new group.
if (item["FileLeafRef"].ToString().ToLowerInvariant() == "userprofileinformation.webpart")
{
item["Group"] = "add-in Script Part";
item.Update();
clientContext.ExecuteQuery();
}
}
lblStatus.Text = string.Format("add-in script part has been added to Web Part Gallery. You can find 'User Profile Information' script part under 'App Script Part' group in the <a href='{0}'>host web</a>.", spContext.SPHostUrl.ToString());
}
}