Modelo de objeto do cliente (CSOM) para o Project 2013
O modelo de objeto do cliente do Project Server 2013 (CSOM) implementa funcionalidade de servidores comuns. O Project Server CSOM inclui um Microsoft .NET CSOM, um Microsoft Silverlight CSOM, um Windows Phone 8 CSOM e um modelo de objeto do JavaScript (JSOM). Além disso, o CSOM inclui um serviço de OData que habilita uma interface REST. A interface REST destina-se principalmente ao desenvolvimento de aplicativos em plataformas que não são do Windows como iOS e Android.
Observação
Soluções para o Project Online devem usar o CSOM. No entanto, os aplicativos no local podem usar o CSOM ou o Project Server Interface (PSI). Se o CSOM inclui a funcionalidade que você planejar usar, é recomendável usar o CSOM para novos aplicativos.
Nas extensões do CSOM, o objeto ProjectContext fornece o ponto de entrada para o conteúdo e funcionalidade do servidor. O CSOM .NET ,o CSOM Silverlight e o Windows Phone CSOM usam o objetoMicrosoft.ProjectServer.Client.ProjectContexte a JSOM usa o objetoPS ProjectContext. As propriedadesProjectContextfornecem acesso direto ao objetos principais do Project Server no atual conjunto de sites do Project Web App. Para obter informações sobre o local dos assemblies CSOM e o arquivo JavaScript, consulte Microsoft.ProjectServer.Client.
Os aplicativosAplicativos e o modelo de segurançadevem usar o CSOM para as operações CRUD (criar, ler, atualizar e excluir) com o Project Server 2013 e no Project Online. Aplicativos de projeto não usam o modelo de autenticação somente aplicativo no SharePoint 2013. Um aplicativo do Project Server requer um escopo de solicitação de permissão específico que especifica qual comandos estão sendo executados.
Consultas REST criar consultas do REST do serviço OData do CSOM sem consumir metadados. Algumas ferramentas de terceiros habilitam usando assemblies .NET para que o CSOM desenvolva aplicativos para outros dispositivos. Por exemplo, pesquise na Internet "ferramentas de desenvolvimento multiplataforma .NET para iOS ou Android."
Observação
Embora a $metadata opção para o serviço de relatórioProjectData seja válida (https://ServerName/pwaName/_api/ProjectData/$metadata), a opção $metadata para o serviço ProjectServer do CSOM é removida na versão lançada do Project Server 2013. Para localizar os objetos do CSOM e membros que estão disponíveis como pontos de extremidade do REST, confira areferência de biblioteca JavaScript biblioteca e REST para o Project Server 2013.
Para ver as entidades disponíveis no CSOM por meio da interface do REST, você pode usar a consulta https://ServerName/pwaName/_api/ProjectServer. Para consultas REST, a entidade semelhanteProjectServerespelha propriedades do objetoProjectContext na montagem gerenciada Microsoft.ProjectServer.Client.dll e no objetoPS ProjectContext JSOM. Por exemplo, você pode usar o navegador para obter informações do CSOM sobre projetos no Project Web App, as tarefas em um projeto específico e o nome da tarefa de uma tarefa especificada para um recurso específico, usando as seguintes consultas (cada consulta usa o mesmo prefixo URL https://ServerName/pwaName/_api). Os GUIDs são valores de exemplo para Project.Id, EnterpriseResource.Id, e 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
Ao contrário da interface do OData para o serviço ProjectData,que é somente leitura para relatórios, você pode fazer operações CRUD usando consultas REST com o serviço ProjectServer. Consultas REST para o Project Server CSOM destinam-se principalmente para plataformas de trabalho diferentes do Windows, como Android, iOS e Windows RT. Para o Windows desktop e para as plataformas de servidor, como o Windows 7, Windows 8 e Windows Server 2008 R2, você pode usar conjuntos gerenciados CSOM. Para aplicativos web, você pode usar PS.js para JavaScript. Confira informações sobre como fazer operações CRUD usando consultas REST emUsar operações de consulta OData nas solicitações REST no SharePoint em tópicos SDK do SharePoint 2013. Para saber mais sobre como usar o serviço ProjectData, confira consultar feeds OData dos dados dos relatórios do Project.
A tabela 1 lista as propriedades ProjectContextque representam objetos do Project Server. Você pode usar esses objetos para recuperar outras entidades do Project Server 2013, como tarefas.
Tabela 1. Propriedades projectContext que fornecem acesso a objetos do Project Server no CSOM e JSOM
| CSOM (.NET Silverlight e Windows Phone) | JSOM |
|---|---|
| CustomFields |
customFields |
| EnterpriseProjectTypes |
enterpriseProjectTypes |
| EnterpriseResources |
enterpriseResources |
| EntityTypes |
entityTypes |
| EventHandlers |
EventHandlers |
| Eventos |
eventos |
| LookupTables |
lookupTables |
| Fases |
fases |
| Projetos |
Projetos |
| Estágios |
Estágios |
| WorkflowActivities |
WorkflowActivities |
| WorkflowDesigner |
workflowDesigner |
Nesta seção
A introdução ao Project Server CSOM e .NET fornece uma visão geral sobre o Project Server CSOM e .NET, instruções sobre como criar uma extensão .NET CSOM simples no Visual Studio 2012 e exemplos de código de suporte.
A introdução ao objeto de modelo JavaScript do Project Server 2013 fornece uma visão geral sobre o Project Server CSOM e .NET, instruções sobre como criar uma extensão .NET CSOM simples no Visual Studio 2012 e exemplos de código de suporte.
Além disso, confira estes artigos que mostram como usar o CSOM:
Observação
Você também pode usar o Visual Studio 2010 para o desenvolvimento do .NET Framework 4 com o CSOM.
Referências
Microsoft.ProjectServer.Client
Confira também
Arquitetura do Project Server 2013Escolha o conjunto de APIs correto no SharePoint 2013