Partager via

Modèle objet côté client (CSOM) pour Project 2013

  • Article

Le Modèle objet côté client (CSOM) de Project Server 2013 implémente la fonctionnalité de serveur courante. Le Modèle objet côté client (CSOM) de Project Server inclut un modèle CSOM Microsoft .NET, un modèle CSOM Microsoft Silverlight, un modèle CSOM Windows Phone 8 et un modèle objet JavaScript (JSOM). Par ailleurs, le modèle CSOM inclut un service OData qui active une interface REST. L’interface REST est principalement conçue pour le développement d’applications sur des plateformes autres que Windows comme iOS et Android.

Remarque

Les solutions pour Project Online doivent utiliser le modèle CSOM. Toutefois, les applications locales peuvent utiliser le modèle CSOM ou l’interface PSI (Project Server Interface). Si le modèle CSOM inclut la fonctionnalité que vous souhaitez utiliser, nous vous recommandons d’utiliser le modèle CSOM pour les nouvelles applications.

Dans les extensions CSOM, l’objet ProjectContext fournit le point d’entrée aux fonctionnalités et au contenu du serveur. Le modèle CSOM .NET, le modèle CSOM Silverlight et le modèle CSOM Windows Phone utilisent l’objet Microsoft.ProjectServer.Client.ProjectContext, et le modèle JSOM utilise l’objet PS.ProjectContext. Les propriétés ProjectContext fournissent un accès direct aux objets Project Server de base dans la collection de sites Project Web App actuelle. Pour plus d’informations sur l’emplacement des assemblys CSOM et du fichier JavaScript, consultez Microsoft.ProjectServer.Client.

Applications et le modèle de sécurité Les applications doivent utiliser le modèle CSOM pour les opérations CRUD (créer, lire, mettre à jour, supprimer) avec Project Server 2013 et Project Online. Les applications Project n’utilisent pas le modèle d’authentification d’application uniquement dans SharePoint 2013. Une application Project Server nécessite une demande d’autorisation spécifique indiquant pour qui les commandes sont exécutées.

Requêtes REST Vous pouvez créer des requêtes REST du service OData du modèle CSOM sans consommer les métadonnées. Certains outils tiers permettent d’utiliser les assemblys .NET pour le modèle CSOM pour développer des applications pour d’autres appareils. Par exemple, rechercher sur Internet des « outils de développement .NET multiplateformes pour iOS ou Android. »

Remarque

Bien que l’option $metadata pour le service de création de rapports ProjectData soit valide ( https://ServerName/pwaName/_api/ProjectData/$metadata), l’option $metadata pour le service ProjectServer du CSOM est supprimée dans la version commerciale de Project Server 2013. Pour trouver les objets et les membres du modèle CSOM qui sont disponibles comme points de terminaison REST, reportez-vous à la rubrique relative à la bibliothèque JavaScript et la référence REST pour Project Server 2013.

Pour voir les entités disponibles dans le CSOM via l’interface REST, vous pouvez utiliser la requête https://ServerName/pwaName/_api/ProjectServer. Pour les requêtes REST, l’entité ProjectServer met étroitement en miroir les propriétés de l’objet ProjectContext dans l’assembly managé Microsoft.ProjectServer.Client.dll et l’objet PS. ProjectContext dans le modèle JSOM. Par exemple, vous pouvez utiliser votre navigateur pour obtenir des informations du CSOM sur les projets dans Project Web App, les affectations dans un projet spécifié et le nom de tâche d’une affectation spécifiée pour une ressource spécifiée, en utilisant les requêtes suivantes (chaque requête utilise le même préfixe d’URL https://ServerName/pwaName/_api). Les GUID sont des exemples de valeurs pour Project.Id, EnterpriseResource.Id et 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

Contrairement à l’interface OData pour le service ProjectData, qui est en lecture seule pour créer des rapports, vous pouvez effectuer des opérations CRUD à l’aide des requêtes REST avec le service ProjectServer. Les requêtes REST pour le modèle CSOM Project Server sont conçues principalement pour des plateformes autres que le bureau Windows, comme Windows RT, iOS et Android. Pour les plateformes de serveur et le bureau Windows, telles que Windows 7, Windows 8 et Windows Server 2008 R2, vous pouvez utiliser les assemblys CSOM managés. Pour les applications web, vous pouvez utiliser PS.js pour JavaScript. Pour plus d’informations sur l’exécution d’opérations CRUD à l’aide de requêtes REST, consultez la rubrique Utiliser les opérations de requête OData dans les demandes REST SharePoint dans le kit de développement logiciel SharePoint 2013. Pour plus d’informations sur l’utilisation du service ProjectData, consultez la rubrique Interrogation des flux de données OData des données de création de rapport Project.

Le tableau 1 répertorie les propriétés ProjectContext qui représentent des objets Project Server. Vous pouvez utiliser ces objets pour récupérer d’autres entités Project Server 2013, telles que des affectations et des tâches.

Tableau 1. Propriétés ProjectContext qui permettent d’accéder aux objets Project Server dans le CSOM et le JSOM

CSOM (.NET, Silverlight et Windows Phone) JSOM
CustomFields
customFields
EnterpriseProjectTypes
enterpriseProjectTypes
EnterpriseResources
enterpriseResources
EntityTypes
entityTypes
EventHandlers
eventHandlers
Événements
événements
LookupTables
lookupTables
Phases
phases
Projects
projects
Stages
stages
WorkflowActivities
workflowActivities
WorkflowDesigner
workflowDesigner

Dans cette section

La section relative à la prise en main du modèle CSOM Project Server et .NET fournit des informations générales sur le modèle CSOM Project Server et .NET, des instructions sur la création d’une extension CSOM .NET simple dans Visual Studio 2012 et des exemples de code connexes.

La section relative à la prise en main du modèle objet JavaScript Project Server 2013 fournit des informations générales sur le modèle JSOM Project Server, des instructions sur la création d’une extension JSOM simple dans Visual Studio 2012 et des exemples de code connexes.

Consultez également les articles suivants, qui illustrent comment utiliser le CSOM :

Remarque

Vous pouvez également utiliser Visual Studio 2010 pour le développement de .NET Framework 4 avec le modèle CSOM.

Référence

Microsoft.ProjectServer.Client

Voir aussi

Architecture de Project Server 2013Choisissez le bon jeu d’API dans SharePoint 2013