Compartir a través de

Modelo de objetos de cliente (CSOM) para Project 2013

  • Artículo

El modelo de objetos de cliente (CSOM) de Project Server 2013 implementa la funcionalidad de servidor común. El modelo de objetos de cliente de Project Server incluye un CSOM de Microsoft. NET, un CSOM de Microsoft Silverlight, un CSOM de Windows Phone 8 y un modelo de objetos de JavaScript (JSOM). Además, el CSOM incluye un servicio OData que habilita una interfaz REST. La interfaz REST va dirigida principalmente al desarrollo de aplicaciones en plataformas que no son de Windows, como iOS y Android.

Nota:

Las soluciones de Project Online deben utilizar el modelo de objetos de cliente. Sin embargo, con las aplicaciones locales puede usar el CSOM o la interfaz de Project Server (PSI). Si el CSOM incluye la funcionalidad que va a usar, se recomienda usarlo para las nuevas aplicaciones.

En las extensiones de CSOM, el objeto ProjectContext proporciona el punto de entrada al contenido y las funciones del servidor. El CSOM .NET, el CSOM Silverlight y el CSOM de Windows Phone usan el objeto Microsoft.ProjectServer.Client.ProjectContext; el JSOM usa el objeto PS. ProjectContext. Las propiedades ProjectContext proporcionan acceso directo a los objetos principales de Project Server en la colección de sitios actual de Project Web App. Para obtener información acerca de la ubicación de los ensamblados de CSOM y el archivo de JavaScript, vea Microsoft.ProjectServer.Client .

El modelo de seguridad y las aplicaciones Las aplicaciones deben usar el CSOM para las operaciones CRUD (crear, leer, actualizar y eliminar) con Project Server 2013 y Project Online. Las aplicaciones de proyecto no usan el modelo de autenticación solo de aplicación en SharePoint 2013. Una aplicación de Project Server requiere un ámbito de solicitud de permisos específicos que especifica en el nombre de quién se ejecutan los comandos.

Consultas REST Puede crear consultas REST del servicio OData de CSOM sin consumir los metadatos. Algunas herramientas de terceros habilitan el uso de los ensamblados de .NET para el CSOM para desarrollar aplicaciones para otros dispositivos. Por ejemplo, realice la siguiente búsqueda en Internet: "herramientas de desarrollo multiplataforma de .NET para iOS o Android".

Nota:

Aunque la opción $metadata para el servicio de informes ProjectData es válida ( https://ServerName/pwaName/_api/ProjectData/$metadata), la $metadata opción para el servicio ProjectServer del CSOM se quita en la versión publicada de Project Server 2013. Para encontrar los objetos y los miembros CSOM que están disponibles como puntos de conexión REST, vea la biblioteca de JavaScript y la referencia REST para Project Server 2013.

Para ver las entidades disponibles en el CSOM a través de la interfaz REST, puede usar la https://ServerName/pwaName/_api/ProjectServer consulta. Para las consultas REST, la entidad ProjectServer refleja estrechamente propiedades del objeto ProjectContext en el ensamblado administrado de Microsoft.ProjectServer.Client.dll y el objeto PS. ProjectContext del JSOM. Por ejemplo, puede usar el explorador para obtener información del CSOM sobre los proyectos de Project Web App, las asignaciones de un proyecto especificado y el nombre de tarea de una asignación especificada para un recurso especificado, mediante las siguientes consultas (cada consulta usa el mismo https://ServerName/pwaName/_api prefijo de dirección URL). Los GUID son valores de ejemplo de Project.Id, EnterpriseResource.Id y Assignment.Id.

/ProjectServer/Projects
/ProjectServer/Projects('263fc8d7-427c-e111-92fc-00155d3ba208')/Assignments
/ProjectServer/EnterpriseResources('28eeb2b5-fe74-4efc-aa35-6a64514d1526')/Assignments('a2eafeb5-437c-e111-92fc-00155d3ba208')/Task?$select=Name

A diferencia de la interfaz de OData para el servicio ProjectData, que es de solo lectura para los informes, puede realizar operaciones CRUD con consultas REST con el servicio ProjectServer. Las consultas REST para el CSOM de Project Server están diseñadas principalmente para plataformas distintas del escritorio de Windows, como Windows RT, iOS y Android. Para las plataformas de escritorio y servidores Windows, como Windows 7, Windows 8 y Windows Server 2008 R2, puede usar los ensamblados administrados de CSOM. Para las aplicaciones web, puede usar PS.js para JavaScript. Para obtener información acerca de las operaciones CRUD con consultas REST, consulte el artículo Usar operaciones de consulta de OData en solicitudes REST de SharePoint en el SDK de SharePoint 2013. Para obtener información sobre el uso del servicio ProjectData, consulte Consulta de fuentes OData de datos de informes de Project.

La tabla 1 enumera las propiedades ProjectContext que representan los objetos de Project Server. Puede usar estos objetos para recuperar otras entidades de Project Server 2013, como tareas.

Tabla 1. Propiedades de ProjectContext que brindan acceso a objetos de Project Server en el CSOM y JSOM

CSOM (.NET, Silverlight y Windows Phone) JSOM
CustomFields
customFields
EnterpriseProjectTypes
enterpriseProjectTypes
EnterpriseResources
enterpriseResources
EntityTypes
entityTypes
EventHandlers
eventHandlers
Events
eventos
LookupTables
lookupTables
Phases
fases
Projects
proyectos
Stages
etapas
WorkflowActivities
workflowActivities
WorkflowDesigner
workflowDesigner

En esta sección

Getting started with the Project Server CSOM and .NET proporciona información general sobre .NET y el CSOM de Project Server, instrucciones sobre cómo crear una simple extensión del CSOM de .NET en Visual Studio 2012 y ejemplos de códigos de ayuda.

Getting started with the Project Server 2013 JavaScript object model proporciona información general sobre el JSOM de Project Server, instrucciones sobre cómo crear una simple extensión de JSOM en Visual Studio 2012 y ejemplos de códigos de ayuda.

Consulte también estos artículos que muestran cómo usar el CSOM:

Nota:

También puede usar Visual Studio 2010 para el desarrollo de .NET Framework 4 con el CSOM.

Referencia

Microsoft.ProjectServer.Client

Vea también

arquitectura de Project Server 2013Elija el conjunto de API adecuado en SharePoint 2013