Información general sobre la referencia de PSI (traducción automática)

Project Server Interface (PSI) es la API de Microsoft Project Server 2010. Este artículo es una introducción a los ensamblados, espacios de nombres y servicios documentados en PSI. La referencia de bibliotecas de clases y servicios web en el SDK contiene toda la documentación sobre el código administrado para PSI en Project Server 2010.

En este artículo se incluyen las siguientes secciones:

• Introducción a la referencia PSI

  • Utilizando la referencia PSI

• Espacios de nombres y ensamblados de servidor del proyecto

• Servicios Web PSI

Introducción a la referencia PSI

PSI en Project Server 2010 tiene una interfaz dual. Archivos .asmx define la interfaz de ASMX de servicios Web y archivos .svc define la interfaz de Windows Communication Foundation (WCF) para los servicios. En las versiones post-beta de Project Server 2010, puede tener acceso a la interfaz ASMX a través de la dirección URL de Project Web App (por ejemplo https://ServerName/ProjectServerName/_vti_bin/psi/project.asmx?wsdl).

La dirección URL del directorio virtual proyecto aplicación de servicio en la aplicación de servicios Web de SharePoint (por ejemplo https://ServerName:32843/[GUID]/project.asmx) incluye los archivos .asmx. Sin embargo, debido a que la interfaz ASMX se genera mediante la infraestructura WCF, no puede utilizar la dirección URL de back-end para establecer una referencia ASMX. Para desarrollar una aplicación o componente que utiliza el dirección URL de aplicación del servicio de proyecto de back-end, debe utilizar la interfaz WCF. El nombre del directorio de proyecto aplicación de servicio es un valor GUID, que es el mismo que el GUID de la instancia de Project Web App. En la ventana del Administrador de Internet Information Services (IIS) , expanda el nodo de Servicios web de SharePoint , haga clic en el nombre del directorio GUID y, a continuación, haga clic en Configuración avanzada para copiar el valor de la Ruta de acceso Virtual .

Utilizando la referencia PSI

El modelo de objetos PSI es grande y muchas clases y miembros son sólo para uso interno. Como resultado, puede resultar confuso buscar los temas que necesita en la biblioteca de clases y una referencia al servicio Web SDK de la Project 2010. La mayoría de los temas de referencia que se va a utilizar para el desarrollo es en los siguientes grupos:

• Métodos de la clase principal:   Cada servicio de PSI incluye una clase principal que tiene el nombre del servicio. Por ejemplo, el servicio de recursos contiene la clase Resource. Para ver una lista de los métodos disponibles en la clase Resource, expanda el nodo de clase en el panel de contenido de SDK y, a continuación, haga clic en el tema de Los métodos de recursos .

• Propiedades DataRow:   Muchos de los métodos de la clase principal utilizan o devuelven un DataSet. Cada objeto de DataTable en un DataSet contiene datos en uno o varios objetos de DataRow. En la mayoría de los casos, tiene que ver sólo las propiedades de fila, no todos los otros miembros de las clases de DataSet, DataTable o DataRow. Por ejemplo, la clase de ResourceAssignmentDataSet incluye las subclases de la ResourceAssignmentDataTable y la clase ResourceAssignmentDataSet.ResourceAssignmentRow. Para ver una lista de propiedades de la clase ResourceAssignmentRow, expanda el nodo de clase en el panel de contenido de SDK y, a continuación, haga clic en el tema Propiedades de ResourceAssignmentDataSet.ResourceAssignmentRow .

Partes de los tres conjuntos de Project Server que se utilizan en el desarrollo de soluciones de terceros de los documentos de la biblioteca de clases y una referencia al servicio Web. Proporcionamos únicamente la mínima documentación para estos ensamblados. Además, la referencia PSI documenta las clases principales y los miembros de los servicios públicos 22. Servicios PSI seis son sólo para uso interno y no están documentados.

No es necesario desarrollar la mayoría de las aplicaciones en un equipo de Project Server, o establecer referencias a ensamblados de Project Server en la caché de ensamblados global. Puede copiar los ensamblados necesarios de Project Server en el equipo de desarrollo. Project Server 2010 instala a los siguientes ensamblados en \Microsoft Office Servers\14.0\Bin[Archivos de programa]:

• Microsoft.Office.Project.Server.Events.Receivers.dll

• Microsoft.Office.Project.Server.Library.dll

• Microsoft.Office.Project.Server.Workflow.dll

Espacios de nombres para los servicios PSI tienen nombres arbitrarios creados para un ensamblado de proxy PSI, ProjectServerServices.dll, que se genera sólo para el propósito de la documentación y no se incluye en el SDK de Project 2010. En la referencia PSI, cada espacio de nombres tiene un nombre de marcador de posición, como [servicio Web de proyecto] y una referencia Web como, por ejemplo, https://ServerName/ProjectServerName/_vti_bin/psi/Project.asmx.

Espacios de nombres y ensamblados de servidor del proyecto

Muchos ensamblados se instalan al instalar Project Server; se documentan sólo tres de los ensamblados de Project Server. Los desarrolladores de terceros generalmente utilizan sólo algunas clases y miembros en esos tres ensamblados. Los ensamblados sin documentar de Project Server incluyen los espacios de nombres y clases que Project Server se utiliza internamente, como las clases para las entidades empresariales y los datos (DAL) de capa de acceso. Cuando se establece una referencia a uno de los ensamblados de Project Server en Microsoft Visual Studio, puede ver todos los espacios de nombres, clases y miembros en el Examinador de objetos de Visual Studio.

Microsoft.Office.Project.Server.Schema el SDK no incluye el espacio de nombres Microsoft.Office.Project.Server.Schema, que se encuentra en el ensamblado [Windows]\assembly\GAC_MSIL\Microsoft.Office.Project.Schema\14.0.0.0__71e9bce111e9429c\Microsoft.Office.Project.Schema.dll. El espacio de nombres contiene las definiciones de todas las clases de DataSet, DataTable y DataRow utilizadas en PSI, además de muchas otras clases similares que Project Server se utiliza internamente. Las clases públicas que contiene todos los servicios Web de PSI están documentadas en la referencia de servicio Web específica. Por ejemplo, la clase DriverDataSet.DriverRow se documenta en el espacio de nombres WebSvcDriver.

En algunas aplicaciones, es necesario establecer una referencia al ensamblado Microsoft.Office.Project.Schema.dll. Los siguientes son dos ejemplos:

• En un controlador de eventos de OnCreated para campos personalizados, puede utilizar el argumento de evento de e.CustomFieldInformation con una referencia al espacio de nombres Microsoft.Office.Project.Server.Schema. En el siguiente código, las definiciones de CustomFieldDataSet y CustomFieldsRow están en el espacio de nombres Microsoft.Office.Project.Server.Schema:

  using PSLibrary = Microsoft.Office.Project.Server.Library;
  using Microsoft.Office.Project.Server.Schema;
  . . .
  
  // Event handler for the OnCreated event of a custom field.
  public override void OnCreated(
      PSLibrary.PSContextInfo contextInfo, 
      CustomFieldsPostEventArgs e)
  {
      // Get information from the event arguments. 
      string userName = contextInfo.UserName.ToString();
  
      CustomFieldDataSet customFieldDs = e.CustomFieldInformation;
      CustomFieldsRow customFieldRow = customFieldDs.CustomFields.Rows[0];
  
      string customFieldName = customFieldRow["MD_PROP_NAME"].ToString();
      byte customFieldType = (byte)customFieldRow["MD_PROP_TYPE_ENUM"];
      Guid customFieldUid = (Guid)customFieldRow["MD_PROP_UID"];
      . . .
  }
  

• Una actividad de flujo de trabajo personalizado, requiere una referencia a Microsoft.Office.Project.Server.Schema para obtener definiciones de DataSet. Para obtener un ejemplo, consulte PSWorkflowServiceBase.GetPSI(ProjectWorkflowContext).

La biblioteca de clases y una referencia al servicio Web de PSI incluye espacios de nombres de los siguientes tres ensamblados:

• Microsoft.Office.Project.Server.Library.dll a los desarrolladores suelen utilizan enumeraciones como, por ejemplo, CustomField.Type y el PSClientError,PSErrorInfo y las clases de Filter en el espacio de nombres Microsoft.Office.Project.Server.Library.

  Los siguientes son los cuatro espacios de nombres en el ensamblado de Microsoft.Office.Project.Server.Library.dll:

  • Microsoft.Office.Project.Server.Administration La clase y los miembros de este espacio de nombres se utilizan internamente para el registro de diagnóstico.

  • Microsoft.Office.Project.Server.Base Las clases y miembros de este espacio de nombres se utilizan sólo internamente y que no están documentados.

  • Microsoft.Office.Project.Server.Library Este espacio de nombres incluye las clases PSClientError y PSErrorInfo y muchas enumeraciones de.

    El espacio de nombres Microsoft.Office.Project.Server.Library también incluye las siguientes clases de propiedad de siete, con un total de las 3208 subclases:

    • AssignmentProperties

    • CalendarProperties

    • ConstraintProperties

    • LookupTableProperties

    • ProjectProperties

    • ResourceProperties

    • TaskProperties

    Las clases de propiedad se utilizan internamente y no están documentadas. Las clases de propiedad se utilizan para la serialización entre Microsoft Project Professional 2010 y Project Server. Cuando se trabaja con el espacio de nombres Microsoft.Office.Project.Server.Library en Visual Studio, el Examinador de objetos muestra todas las clases de propiedad, lo que es más difícil encontrar las clases que son útiles para el desarrollo de otros fabricantes. El SDK no muestra las clases de propiedad.

  • Microsoft.Office.Project.Server.Library.FilterSchema  Este espacio de nombres se utiliza sólo internamente y no está documentado.

• Microsoft.Office.Project.Server.Workflow.dll este ensamblado incluye los tres espacios de nombres siguientes:

  • Este espacio de nombres deMicrosoft.Office.Project.PWA incluye a un proxy para el PSI, para su uso con Project Web App y con las actividades de flujo de trabajo personalizado; no se ha documentado.

    Una actividad de flujo de trabajo personalizado, requiere una referencia a Microsoft.Office.Project.PWA para acceder a todas las clases de los servicios PSI. Por ejemplo, la clase Microsoft.Office.Project.PWA.PSI incluye la propiedad de ProjectWebService, que obtiene a un proxy para el espacio de nombres WebSvcProject. Para obtener un ejemplo de código, consulte PSWorkflowServiceBase.GetPSI.

  • Microsoft.Office.Project.Server.WebServiceProxy Este espacio de nombres incluye clases de proxy para la clase principal en cada servicio PSI. Los desarrolladores utilizan estas clases para ayudar a crear flujos de trabajo del sitio que ejecuta la suplantación del usuario del flujo de trabajo de Project Server integrado. Con los permisos elevados del usuario de flujo de trabajo, el flujo de trabajo puede llamar a métodos PSI a través de las clases de proxy.

    Cada clase de proxy contiene todos los métodos en el servicio correspondiente. Por ejemplo, la clase Microsoft.Office.Project.Server.WebServiceProxy.Project incluye los métodos CheckOutProject y QueueCreateProject. Estos métodos son los servidores proxy para los métodos CheckOutProject y QueueCreateProject en el servicio de Project, que están disponibles para las aplicaciones externas.

  • Microsoft.Office.Project.Server.Workflow Este espacio de nombres incluye clases que se utilizan para las actividades de flujo de trabajo de Project Server. Las actividades incluyen leer, comparar y actualizar las propiedades del proyecto. Otras clases controlan devoluciones de llamadas de flujo de trabajo cuando se ha cambiado y administración de flujos de trabajo de proyectos.

• Microsoft.Office.Project.Server.Events deMicrosoft.Office.Project.Server.Events.Receivers.dll es el espacio de nombres único en este ensamblado. Incluye receptor de eventos y las clases de argumentos de evento para los servicios PSI y otras clases internas.

  Los desarrolladores escribir controladores de eventos que se derivan de las clases de receptor de eventos. La mayoría de las clases principales de los servicios PSI tienen una clase de receptor de eventos correspondiente. Por ejemplo, la clase ProjectEventReceiver contiene métodos de receptor de eventos previos y que corresponden a los métodos de la clase Project en el PSI. Los métodos OnCreating y OnCreated son los métodos de receptor de eventos previos y posteriores para el método QueueCreateProject.

  Los desarrolladores suelen utilizar las clases de receptor de sucesos siguientes:

  • AdminEventReceiver

  • CalendarEventReceiver

  • CubeAdminEventReceiver

  • CustomFieldsEventReceiver

  • LookupTableEventReceiver

  • ProjectEventReceiver

  • OptimizerEventReceiver

  • ReportingEventReceiver

  • ResourceEventReceiver

  • SecurityEventReceiver

  • StatusingEventReceiver

  • TimesheetEventReceiver

  • UserDelegationEventReceiver

  • WorkflowEventReceiver

  • WssInteropEventReceiver

  Las clases RulesEventReceiver y StatusReportsEventReceiver se utilizan internamente en Project Web App.

Servicios Web PSI

PSI es un conjunto de servicios Web ASMX y los mismos servicios WCF para Project Server 2010. Para utilizar un servicio, establezca una referencia a la dirección URL del archivo .asmx o el archivo .svc con un nombre arbitrario para el NameService de Microsoft Visual Studio 2008 (o posterior). La utilidad wsdl.exe o svcutil.exe genera código fuente del proxy para ese espacio de nombres y el compilador crea un ensamblado de servicio de proxy para incluir en la aplicación.

De los servicios PSI totales 27, Authentication, ExchangeSync, PWA, View y WinProj son para uso interno por parte de Project Web App y Project Professional. El servicio de P12Upgrade tiene una implementación de WCF se utiliza el instalador de Project Server 2010 para actualizar Office Project Server 2007. Aunque puede tener acceso a los servicios internos a través de la dirección URL del directorio virtual ProjectServiceApplication en la aplicación de servicios Web de SharePoint, la referencia PSI no incluye los temas completos del espacio de nombres, clase y miembro de esos servicios.

A continuación es todas las clases que contienen los métodos Web de PSI.

1. Admin Incluye métodos que se utilizan en las páginas de Administración de Project Server en Project Web App define años fiscales. Administra la configuración de moneda y la administración de Estados, informes de períodos, el registro de auditoría y configuración para el servicio de directorio de Active Directory.

2. Archive Incluye métodos para administrar la copia de seguridad y restauración de los proyectos, categorías de seguridad, los campos personalizados, recursos, la configuración del sistema, vistas y el proyecto global de empresa. Lee y actualiza la planificación del archivado. Archiva todos los proyectos o eliminan los proyectos archivados especificados. Copia de seguridad en la base de datos de archiving y restaure la base de datos publicados.

3. Authentication Incluye métodos para uso interno por parte de Project Professional y Project Web App. Acceso al servicio Authentication está disponible sólo a través de la dirección URL ProjectServiceApplication.

4. Calendar Administra las excepciones de calendario de empresa. Desprotege y se comprueba en los calendarios de recursos. Crea, elimina, enumera todos, actualiza o devuelve las excepciones de calendario.

5. CubeAdmin Configuración del cubo de OLAP administra. Obtiene el Analysis Server, el estado de la base de datos y la lista de cubos. Coloca una solicitud de servicio de generación de cubos en la cola. Lee y actualiza las definiciones de miembros calculados y los valores de campo de dimensiones y medidas del cubo.

6. CustomFields Administra campos personalizados de empresa. Desprotege, protege, lee, crea, elimina y se actualiza.

7. Driver Administra controladores de análisis de cartera y asignación de prioridades de controlador para la administración de creación y la demanda del proyecto. Incluye la creación, lectura, actualización y métodos de eliminación (CRUD) para los controladores del proyecto.

8. Events Asociaciones de controlador de eventos administra Project Server. Incluye los métodos CRUD para asociaciones de controlador de eventos de Project Server para un evento específico o para todas las asociaciones de controlador de eventos.

9. ExchangeSync Es un servicio interno de Project Server que controla los eventos de Microsoft Exchange Server. Project Web App utiliza ExchangeSync para sincronizar las asignaciones entre Project Server y Exchange Server, en lugar de hacerlo directamente con el cliente de Microsoft Office Outlook como en Office Project Server 2007 de Microsoft.

   Acceso al servicio ExchangeSync está disponible sólo a través de la dirección URL ProjectServiceApplication. No se admiten las clases de ExchangeSync y miembros para el desarrollo de otros fabricantes.

10. LoginForms Proporciona los métodos Login y Logoff con la autenticación basada en formularios. Acceso al servicio LoginForms está disponible sólo a través de un sitio de Project Web App.

11. LoginWindows Proporciona los métodos Login y Logoff, que se utiliza para la autenticación de Windows en multi-authentication (reclamaciones y basada en formularios) las instalaciones de Project Server 2010.

    Advertencia

    El servicio LoginWindows no se utiliza en aplicaciones de WCF, o para las aplicaciones que se ejecutan en las instalaciones de Project Server que utilizan sólo la autenticación de las reclamaciones; en esos casos, el método Login devuelve siempre false. Autenticación de reclamaciones controla la autenticación integrada de Windows.

12. LookupTable Administra las tablas de búsqueda, tablas de búsqueda de varios idiomas y sus máscaras de código correspondientes. Desprotege, protege, lee, crea, elimina y se actualiza.

13. Notifications Administra las alertas y avisos. Incluye métodos que obtener, establecen, registrar y anular el registro de notificaciones.

14. ObjectLinkProvider Objetos Web administra y vínculos de documentos y elementos de la lista sitios de SharePoint. Crea, elimina o lee la tarea vinculada de objetos de Web, tarea o proyecto, vinculados en el proyecto.

15. PortfolioAnalyses Incluye los métodos CRUD para dependencias del proyecto y las soluciones de Optimizer, Planificador y análisis.

16. Project Administra los proyectos. Desprotege, protege, crea, elimina, lee o actualiza proyectos en la base de datos de borrador o publicada. Coloca un mensaje en la cola para la publicación.

    Crea o elimina las entidades dentro de proyectos (tareas, recursos, asignaciones y así sucesivamente). Obtiene información acerca de o actualiza la dirección del proyecto de equipo o sitio de proyecto. Obtiene el estado, una lista de proyectos en la base de datos de borrador, todas las tareas de resumen de proyectos, tareas disponibles para su asignación a un recurso especificado, o todos los proyectos, en caso de un recurso tiene asignaciones.

    Crea y administra los compromisos, crea pequeños proyectos de listas de tareas de SharePoint o busca las relaciones de proyecto del proyecto y master.

17. PWA Contiene muchos métodos optimizados para Project Web App, incluidos los métodos para las reglas de aprobación de la actualización de tarea y para administrar informes de estado. El Project Web Appmethods a menudo están especializados y redundante en cierto modo en comparación con métodos equivalentes en otros servicios PSI. métodos de Project Web App utilizan o volver a muchos de los mismos conjuntos de datos como los otros métodos PSI.

    Acceso al servicio PWA está disponible sólo a través de la dirección URL ProjectServiceApplication. No se admiten las clases de PWA y miembros para el desarrollo de otros fabricantes.

18. QueueSystem Administra la cola de Project Server. Obtiene el recuento de trabajo, el trabajo y el tiempo de espera de grupo de trabajos, el estado de todos los trabajos, trabajos especificados, trabajos de llamador o para proyectos especificados. Administra la correlación de trabajo y configura la cola.

19. Resource Administra los recursos de empresa. Desprotege, protege, actualiza o crea los recursos o los usuarios de Project Server y su configuración de la autorización; encuentra recursos por nombre o GUID; lee el recurso o los datos de usuario, la estructura detallada de recursos (EDR) y la información de seguridad relacionados; Obtiene todas las asignaciones de un recurso; y restablece las contraseñas de usuario. La clase Resource incluye nuevos métodos CRUD para las delegaciones de usuario.

20. ResourcePlan Administra los planes de recursos. Desprotege, protege, crea, elimina, publica, lee y actualiza los planes de recursos.

21. Security Incluye los métodos CRUD para categorías de seguridad de las plantillas de seguridad, los permisos globales y de organización y los permisos de grupo. La clase Security incluye nuevos métodos para las categorías de proyecto.

22. Statusing Administra las actualizaciones de estado y las asignaciones. Se aplica a las actualizaciones de estado o aprobaciones, envía el estado se actualiza, establece la información de resumen para las actualizaciones enviadas, elimina las actualizaciones de estado Aprobado o historial de aprobación para un usuario específico o elimina toda la información de estado de un conjunto de proyectos. Crea, obtiene o delega asignaciones; establece la duración del trabajo de asignación. Obtiene nuevas asignaciones para el usuario actual; Obtiene la jerarquía de la tarea de resumen, los datos reales de fase temporal o histórico de transacciones de asignación o tarea.

    Muestra una vista previa o importa datos de la parte de horas o lee el trabajo de un usuario y no laborable programación. Busca un registro de transacciones de cambios en una actualización enviada, información enviado actualizaciones o las actualizaciones de estado pendientes. Lecturas de equipo de estado.

23. TimeSheet Administra los partes de horas. Crea, elimina, envía, actualiza, lee o recuperaciones de los partes de horas. Busca partes de horas más tarde o pendiente de aprobación; busca partes de horas por fecha o periodo. Obtiene la lista de aprobadores de partes de horas. Carga previamente los datos reales y valida una línea de parte de horas. La clase TimeSheet incluye los nuevos métodos ReadProjectTimesheetLines y SubmitTimesheetLines.

24. Vista   El servicio de View está diseñado para utilizarse sólo dentro de Project Web App. Métodos de la clase View administración vistas y ver informes y leen los campos en las vistas.

    Acceso al servicio View está disponible sólo a través de la dirección URL ProjectServiceApplication. No se admiten los métodos View para el desarrollo de otros fabricantes.

25. WinProj El servicio WinProj está diseñado para su uso sólo Project Professional. Los desarrolladores de terceros no deben utilizar los métodos de WinProj para programar con Project Server.

    Algunos métodos de WinProj utilizan conjuntos de datos como, por ejemplo, ProjectRelationsDataSet y ResourceDataSet que los servicios de Project y Resource también utilizan, pero requieren propiedades específicas y funciones en Project Professional.

    Acceso al servicio WinProj está disponible sólo a través de la dirección URL ProjectServiceApplication. No se admiten los métodos WinProj para el desarrollo de otros fabricantes.

26. Workflow Incluye los métodos CRUD para tipos de proyecto de empresa y para administrar las etapas y fases del flujo de trabajo. Ejecutar flujos de trabajo, establecer la información de estado y administrar las etapas (PDP) de la página Detalles del proyecto en flujos de trabajo de administración de la demanda.

27. WssInterop Administra sitios de proyecto. Crea y elimina la sitios de proyecto. Obtiene información acerca de y actualiza la configuración de SharePoint y los sitios de administración. Sincroniza y actualiza la pertenencia a sitio de proyecto y los grupos.

Cada espacio de nombres de servicio incluye todas las clases de controlador de eventos y el esquema de DataSet que utiliza el servicio. Por ejemplo, Calendar.asmx (o Calendar.svc para el servicio WCF) describe el servicio de Calendar. Si asigna el nombre de la WebSvcCalendar de referencia Web, el espacio de nombres de proxy contiene la clase principal de Calendar con el Web métodos CheckInCalendars, CheckOutCalendars y así sucesivamente. El espacio de nombres del proxy de WebSvcCalendar también incluye la clase CalendarDataSet y todas sus subclases.

Algunos de los servicios PSI contienen clases de DataSet duplicados. Por ejemplo, los servicios Project y Statusing incluyen la clase ProjectDataSet. Eso es porque las descripciones de los Project.asmx y el Statusing.asmx Web incluyen referencias a la ProjectDataSet y los ensamblados de proxy que se crea al establecer referencias Web y compilar una aplicación incluyen los conjuntos de datos relacionados. Los servicios de Project y Statusing pueden requerir valores para diferentes campos de la clase ProjectDataSet.ProjectRow.

Cuando intenta explorar los espacios de nombres y clases de la referencia PSI, por ejemplo, para ver los métodos Web para el servicio de Project, expanda el espacio de nombres [Servicio Web de proyecto] en la lista de Contenido y a continuación, expanda la clase Project.

Vea también

Otros recursos

Referencias de programación de Project (traducción automática)

Información general sobre Project Server Interface (PSI) (traducción automática)

.NET Framework Developer Center

Historial de cambios