domingo, 21 de junio de 2015

API´s disponibles para el Desarrollo de Aplicaciones en SharePoint

Las Interfaces de Programación de Aplicaciones o API en SharePoint tienen su historia y por ello hay una variedad de opciones disponibles hoy en día ningún API se aplica a todos los casos y en necesario conocer su historia para conocer su aplicación.

.NET Server Type o Modelo de Objetos de Servidor para SharePoint

Empecemos con .NET Server Type o el Modelo de Objetos de Servidor para SharePoint.  Esta API nació con la versión SharePoint 2007, la cual emergía de a poco, en Visual Studio 2005 no se tenía ningún plug-in al principio para soportar el desarrollo de soluciones para Extender SharePoint y había que definir manualmente archivos XML que definían las FEATURES que activarían las funcionalidades en los sitios de SharePoint.  Los Elementos web recuerdo eran y son en realidad controles de Usuario de ASP.NET que se enmascaraban a través de un archivo de XML para convertirlo en un elemento Web que reconociera SharePoint.

 

Recomiendo el siguiente enlace:Mejores Prácticas: Problemas comunes cuando utiliza el modelo de objetos de servidor

A continuación segmento de código del Modelo de Objeto de Servidor para SharePoint 2007-2010 y 2013 soluciones de granja (WSP)

sing (SPSite siteCollection = new SPSite("http://intranet.adicodes.com"))
{
  using (SPWeb site = siteCollection.OpenWeb())
  {
    try
    {
      SPList taskList = site.GetList("/Lists/MyTasks");
      Console.WriteLine("Success!");
    //Create a new item
SPListItem newItem = list.Items.Add;
newItem["Title"] = "Created Item " + DateTime.Now.ToLongDateString;
newItem.Update; //NOTE: Update must be called
 
//Read items by binding to grid
SPListItemCollection items = list.Items; //NOTE: This loads all items, folders, and fields!
itemGrid.DataSource = items; // Binding to grid to display items, just for scenario
itemGrid.DataBind;
 
//Delete the first item
list.Items[0].Delete;
 
//Update the first item
//Note the use of a temporary SPListItem
SPListItem updateItem = list.Items[0];
updateItem["Title"] = "Updated Item " + DateTime.Now.ToLongDateString;
updateItem.Update;

    }
    catch(FileNotFoundException)
    {
      Console.WriteLine("List does not exist");
    }
  }
}

CSOM o Client SharePoint Object Model

Este modelo de objetos para SharePoint que se ejecuta de lado del cliente surgió en la versión SharePoint 2010 que introdujo las SandBox Solution que pretendía apoyar la adopción de Silverlight, el cual era un “motor” tipo Java que ejecutaría el código en cualquier dispositivo y sistema operativo, bueno esa era la intención Microsoft desistió al ver nuevas tendencias en el mercado como la nube y saco a Silverlight y como consecuencia el modelo sandbox también marcándolo como obsoleto en las próximas versiones.  El nombre Sandbox solution se le debe a que se ejecuta en una caja cerrada es decir ya no se tiene acceso al servidor sino solamente a la colección de sitios donde se cargue la solución. 

Tiers in the sandboxed solutions service

Una de las interioridades de este tipo de solución es que el empacado era el mismo que las soluciones de granja de solución wsp, pero con el alcance limitado a colección de sitios y que no podía ejecutar código que instanciara el Modelo de Objetos de Servidor de las soluciones de granja del modelo anterior.  En SharePoint 2010, entonces hay dos posibilidades desarrollar soluciones de granja y soluciones Sandbox una consume el modelo de objetos de Servidor y la otra el modelo de objetos cliente.  No todo el modelo de objetos de Servidor se dispone en la versión CSOM ya que el alcance es mucho mas limitado en las soluciones Sandbox y fundamentalmente se tiene acceso al contenido dentro de los sitios de SharePoint, bibliotecas, listas, grupos y usuarios.

// Create ClientContext object

ClientContext ctxObj = new ClientContext("http://mysitecllection/mysite/");

// Get Site Collection object

Site siteObj = ctxObj.Site;

ctxObj.Load(siteObj);

// Get web object

Web webObj = siteObj.RootWeb;

ctxObj.Load(webObj);

// Build query to the list "EmployeeList"

List empListObj = webObj.Lists.GetByTitle("EmployeeList");

ctxObj.Load(empListObj);

// Execute the query against ClientContext

ctxObj.ExecuteQuery();

// Get the Title

Console.WriteLine(empListObj.Title);

// Build a query for all items in the list

CamlQuery query = new CamlQuery();

query.ViewXml = "<View/>";

ListItemCollection allEmploys  = empListObj.GetItems(query);

ctxObj.Load(allEmploys);

// Execute the query against ClientContext

ctxObj.ExecuteQuery();

// Get all the results

foreach (ListItem listItem in allEmploys) {

Console.WriteLine("Id: {0} - Firstname: {1} - LastName: {2} - Department: {3}",

listItem["ID"],

listItem["FirstName"],

listItem["LastName"],

listItem["Department"]

);

}

REST endpoint

También en la versión SharePoint 2010 vino una implementación de Rest para el contenido de SharePoint, también limitado al contenido de SharePoint como su contraparte CSOM.   Pero no fue sino hasta la versión 2013 que ya vino incluido desde su edición original.  La intención de Microsoft es proveer un protocolo de comunicación standard para que el contenido de SharePoint fuese consumido por cualquier tipo de aplicación.

PartsDataContext context = new PartsDataContext(
new Uri("http://localhost/sites/sharepointlist/_vti_bin/listdata.svc"));
var partsQuery = (DataServiceQuery<PartsItem>)
context.Parts.Where(p => p.SKU.StartsWith(SearchSku))
.Select(p => new PartsItem { Title = p.Title,
SKU = p.SKU,
Id = p.Id,
Description = p.Description
});

// Execute query.
query.BeginExecute(DisplayParts, query);
 

JSOM object


Con el advenimiento de la versión SharePoint 2013 trabajo consigo un nuevo modelo de desarrollo llamado App Model o Modelo de Aplicación, esto para apoyar la estrategia de Microsoft en la nube y proveer un modelo de extensibilidad de SharePoint en la nube a través de Office 365.  Para la versión SharePoint 2013 en premisas persiste el modelo de solución de granja que tiene acceso total a los recursos del servidor y el modelo Apps.  Pero para la versión en la nube solo esta disponible el modelo de Aplicación.  



Fundamentalmente solo se pueden desarrollas dos tipos de aplicaciones bajo este nuevo modelo  SharePoint Hosted y Provider Hosted.   La primera básicamente consume el contenido de SharePoint por medio de javascript y este modelo provee un conjunto de librerías de Json para consumir el contenido de SharePoint el cual devuelve los resultados en formato Json.  Si elegimos el Modelo Provider Hosted podemos utilizar cualquiera de las API Cliente (Csom, Jsom o Rest) pero el código debe de hospedarse fuera de SharePoint.


Ejemplo:

function createListItem(siteUrl,listName, itemProperties, success, failure) {

var itemType = getItemTypeForListName(listName);
itemProperties["__metadata"] = { "type": itemType };

$.ajax({
url: siteUrl + "/_api/web/lists/getbytitle('" + listName + "')/items",
type: "POST",
contentType: "application/json;odata=verbose",
data: JSON.stringify(itemProperties),
headers: {
"Accept": "application/json;odata=verbose",
"X-RequestDigest": $("#__REQUESTDIGEST").val()
},
success: function (data) {
success(data.d);
},
error: function (data) {
failure(data);
}
});
}


// Get List Item Type metadata
function getItemTypeForListName(name) {
return "SP.Data." + name.charAt(0).toUpperCase() + name.split(" ").join("").slice(1) + "ListItem";
}
//specify item properties
var itemProperties = {'Title':'Order task','Description': 'New task'};
//create item
createListItem(_spPageContextInfo.webAbsoluteUrl,'Tasks',itemProperties,
function(entity){
console.log('New task ' + entity.Title + ' has been created');
},
function(error){
console.log(JSON.stringify(error));
}
);

API disponibles en SharePoint para el desarrollo de Aplicaciones.











































































































































































































































































































































































.NET Server type
CSOM typeJSOM objectREST endpoint
SPAttachmentCollectionAttachmentCollectionSP.AttachmentCollection object (sp.js)…/_api/web/lists('<list id>')/items(<item id>)/attachmentfiles
SPBasePermissionsBasePermissionsSP.BasePermissions object (sp.js) 
SPCalendarTypeCalendarTypeSP.CalendarType enumeration (sp.js) 
SPChangeCollectionChangeCollectionSP.ChangeCollection object (sp.js)…/_api/web/getchanges(changequery)
SPChangeSiteChangeSiteSP.ChangeSite enumeration (sp.js) 
 ClientContextSP.ClientContext object (sp.js)…/_api/contextinfo
SPContentTypeContentTypeSP.ContentType object (sp.js)…/_api/web/contenttypes('<content type id>')
SPContentTypeCollectionContentTypeCollectionSP.ContentTypeCollection object (sp.js)…/_api/web/contenttypes
SPContext SP.RequestContext object (sp.js) 
SPEventReceiverDefinitionEventReceiverDefinitionSP.EventReceiverDefinition object (sp.js)…/_api/web/eventreceivers
SPEventReceiverDefinitionCollectionEventReceiverDefinitionCollectionSP.EventReceiverDefinitionCollection object (sp.js)…/_api/web/eventreceivers(eventreceiverid)
SPEventReceiverDefinitionCreationInformationEventReceiverDefinitionCreationInformationSP.EventReceiverDefinitionCreationInformation object (sp.js) 
SPEventReceiverTypeEventReceiverTypeSP.EventReceiverType enumeration (sp.js) 
SPFeatureFeatureSP.Feature object (sp.js)…/_api/web/features(featureid)
SPFeatureCollectionFeatureCollectionSP.FeatureCollection object (sp.js)…/_api/web/features
SPFeatureDefinitionScopeFeatureDefinitionScopeSP.FeatureDefinitionScope enumeration (sp.js) 
SPFieldFieldSP.Field object (sp.js)…/_api/web/fields('<field id>')
SPFieldCalculatedFieldCalculatedSP.FieldCalculated object (sp.js)…/_api/web/fields('<field id>')
SPFieldChoiceFieldChoiceSP.FieldChoice object (sp.js)…/_api/web/fields('<field id>')
SPFieldCollectionFieldCollectionSP.FieldCollection object (sp.js)…/_api/web/fields
SPFieldComputedFieldComputedSP.FieldComputed object (sp.js)…/_api/web/fields('<field id>')
SPFieldCurrencyFieldCurrencySP.FieldCurrency object (sp.js)…/_api/web/fields('<field id>')
SPFieldLinkFieldLinkSP.FieldLink object (sp.js)…/_api/web/contenttypes('<content type id>')/fieldlinks('<field link id>')
SPFieldLookupValueFieldLookupValueSP.FieldLookup object (sp.js) 
SPFieldMultiChoiceFieldMultiChoiceSP.FieldMultiChoice object (sp.js)…/_api/web/fields('<field id>')
SPFieldMultiLineTextFieldMultiLineTextSP.FieldMultiLineText object (sp.js)…/_api/web/fields('<field id>')
SPFieldNumberFieldNumberSP.FieldNumber object (sp.js)…/_api/web/fields('<field id>')
SPFieldTextFieldTextSP.FieldText object (sp.js)…/_api/web/fields('<field id>')
SPFieldUrlFieldUrlSP.FieldUrl object (sp.js)…/_api/web/fields('<field id>')
SPFieldUrlValueFieldUrlValueSP.FieldUrlValue object (sp.js) 
SPFieldUserFieldUserSP.FieldUser object (sp.js)…/_api/web/fields('<field id>')
SPFileFileSP.File object (sp.js)…/_api/web/getfilebyserverrelativeurl('/<folder name>/<file name>')
SPFileCollectionFileCollectionSP.FieldCollection object (sp.js)…/_api/web/getfolderbyserverrelativeurl('/<folder name>')/files
SPFolderFolderSP.Folder object (sp.js)…/_api/web/getfolderbyserverrelativeurl('/<folder name>')
SPFormFormSP.Form object (sp.js)…/_api/web/lists(guid'<list id>')/forms('<form id>')
SPGroupGroupSP.Group object (sp.js)…/_api/web/sitegroups(<group id>)
SPGroupCollectionGroupCollectionSP.GroupCollection object (sp.js)…/_api/web/sitegroups
SPLanguageLanguageSP.Language object (sp.js) 
SPListListSP.List object (sp.js)…/_api/web/lists(guid'<list id>')
SPListCollectionListCollectionSP.ListCollection object (sp.js)…/_api/web/lists
SPListDataSourceListDataSourceSP.ListDataSource object (sp.js) 
SPListItemListItemSP.ListItem object (sp.js)…/_api/web/lists(guid'<list id>')/items(<item id>)
SPListItemCollectionListItemCollectionSP.ListItemCollection object (sp.js)…/_api/web/lists(guid'<list id>')/items
SPListTemplateTypeListTemplateTypeSP.ListTemplateType enumeration (sp.js) 
SPNavigationNavigationSP.Navigation object (sp.js)…/_api/web/navigation
SPNavigationNodeNavigationNodeSP.NavigationNode object (sp.js) 
SPPrincipalPrincipalSP.Principal object (sp.js) 
SPQuery   
SPRecycleBinItemRecycleBinItemSP.RecycleBinItem object (sp.js)…/_api/web/RecycleBin(recyclebinitemid)
SPRecycleBinItemCollectionRecycleBinItemCollectionSP.RecycleBinItemCollection object (sp.js)…/_api/web/RecycleBin
SPRegionalSettingsRegionalSettingsSP.RegionalSettings object (sp.js)…/_api/web/RegionalSettings
SPRoleAssignmentRoleAssignmentSP.RoleAssignment object (sp.js)…/_api/web/roleassignments(<principal id>)
SPRoleAssignmentCollectionRoleAssignmentCollectionSP.RoleAssignmentCollection object (sp.js)…/_api/web/roleassignments
SPRoleDefinitionRoleDefinitionSP.RoleDefinition object (sp.js)…/_api/web/roledefinitions(<role definition id>)
SPRoleTypeRoleTypeSP.RoleType enumeration (sp.js) 
SPSecurableObjectSecurableObjectSP.SecurableObject object (sp.js) 
SPSiteSiteSP.Site object (sp.js)…/_api/site
SPTimeZoneTimeZoneSP.TimeZone object (sp.js)…/_api/web/RegionalSettings/TimeZones(timzoneid)
SPTimeZoneCollectionTimeZoneCollectionSP.TimeZoneCollection object (sp.js)…/_api/web/RegionalSettings/TimeZones
SPUserUserSP.User object (sp.js)…/_api/web/siteusers(@v)?@v='<login name>'
SPUserCollectionUserCollectionSP.UserCollection object (sp.js)…/_api/web/sitegroups(<group id>)/users
SPUtilityUtilitySP.Utilities.Utility object (sp.js) 
SPViewViewSP.View object (sp.js)…/_api/web/lists(guid'<list id>')/views('<view id>')
SPViewCollectionViewCollectionSP.ViewCollection object (sp.js)…/_api/web/lists(guid'<list id>')/views
SPViewFieldCollectionViewFieldCollectionSP.ViewFieldCollection object (sp.js)…/_api/web/lists(guid'<list id>')/views('<view id>')/fields
SPWebWebSP.Web object (sp.js)…/_api/web
SPWebCollectionWebCollectionSP.WebCollection object (sp.js)…/_api/web/webs
SPWebInfoWebInformationSP.WebInformation object (sp.js)…/_api/web/webinfos('<web information id>')
SPWebTemplateWebTemplateSP.WebTemplate object (sp.js)…/_api/web/GetAvailableWebTemplates(languageid,includecrosslanguage)/getbyname(templatename)
SPWebTemplateCollectionWebTemplateCollectionSP.WebTemplateCollection object (sp.js)…/_api/web/GetAvailableWebTemplates(languageid,includecrosslanguage



https://msdn.microsoft.com/EN-US/library/office/dn268594.aspx









Espero les sea de utilidad para elegir las diferentes API según lo escenarios con que estan desarrollando soluciones para las diferentes versiones de SharePoint.


Hasta la Proxima!,


Juan Manuel Herrera Ocheita