De 0 a 60 con Project Online

2023-04-04

Un desarrollador de aplicaciones puede personalizar un sitio de Project Online (hospedado en SharePoint) mediante aplicaciones independientes o complementos de Project. Es posible una gran cantidad de aplicaciones que van desde satisfacer las necesidades de los implicados en un proyecto hasta las funciones de soporte de PMO, como cualquiera de las siguientes:

Entrada de datos de tarjeta de tiempo simplificada para los trabajadores
Aprobación eficaz de tarjetas de tiempo para supervisores
Supervisión de los permisos (adquisición y estado) necesarios para un proyecto
Estado/Comprobación de estado de los proyectos activos
Informe de problemas
Informe de estado de administración de cambios

Project Online incluye compatibilidad con api para dar cabida a los siguientes escenarios:

Para un complemento hospedado de Project (SharePoint):
- Código (JavaScript, HTML, CSS) hospedado en SharePoint Online
- Recursos que se descargan en el explorador y se ejecutan en SharePoint Online.
- Lógica de negocios que se encuentra en JavaScript
- Acceda a los datos que están en o almacenados en Project Online o SharePoint, como (pero no se limita a):
- Campos personalizados
- Listas
Para un complemento hospedado por el proveedor de Project (SharePoint):
- Código que existe en un sitio externo al sitio Project Online
- Un sitio externo, que puede ser (pero no está limitado a):
- Otro sitio de SharePoint
- Web App/Service basado en cualquier plataforma
- El sitio externo contiene lógica de negocios
- El explorador se redirige desde Project Online al sitio externo con tokens de acceso a Project Online
- El sitio externo puede realizar llamadas a SharePoint y Project Online
Para un complemento externo o independiente:
- El usuario ejecuta una aplicación en su dispositivo
- La aplicación se autentica y llama directamente a las API de Project Online

Tipo de aplicación	Implementación de API	Entorno de destino	Ejemplos de aplicación
Proyecto hospedado	JSOM (modelo de objetos de script de Java) REST	Explorador	Entrada de tarjeta de tiempo Aprobación de tarjeta de tiempo Estado de proyecto Informe de problemas
Proveedor de proyectos hospedado	Biblioteca cliente de CSOM	Sitio web o aplicación de Azure Entorno que no es de Windows (LAMP, etc.)	Validador del parte de horas externo Importador de proyectos
Externo o independiente	REST CSOM	REST: cualquier plataforma CSOM: cualquier plataforma compatible con .NET	Entrada de tarjeta de tiempo Migración de proyectos a un nuevo sitio Cambiar estado de administración.

¿Qué se requiere para empezar a desarrollar aplicaciones para Project Online?

Los elementos comunes necesarios para desarrollar aplicaciones Project Online son una cuenta de Project Online y datos de prueba (proyectos e información relacionada con proyectos que incluyen asignaciones, tareas, recursos y campos personalizados). También se necesita un entorno de desarrollo, pero los detalles del entorno de desarrollo dependen del tipo de aplicación y de la interfaz de API necesaria para la aplicación. En las secciones siguientes se describen las necesidades de desarrollo de las tres interfaces de API.

En la documentación de referencia se describe el modelo de objetos que es común para las tres interfaces, así como un mapa de entidades que muestra las relaciones entre los componentes del modelo de objetos.

Entorno de desarrollo de complementos hospedados en project

Un complemento hospedado es un complemento que reside en el servidor y se descarga en un explorador para su ejecución en tiempo de ejecución. Los complementos hospedados pueden usar las interfaces JSOM o REST y se escriben en JavaScript. Project Online proporciona referencias a la biblioteca JSOM para la ejecución en tiempo de ejecución. Suponiendo que el desarrollo se realiza en una plataforma Windows, los recursos necesarios siguen estos pasos:

Visual Studio 2015 (preferido) o Visual Studio 2013
Herramientas de desarrollo de Office para Visual Studio
Lenguaje JavaScript

Visite https://github.com/OfficeDev/Project-JSOM-Copy-Work-Packages una aplicación de ejemplo.

Puede descargar y ejecutar el ejemplo en unos sencillos pasos:

Descarga y apertura de la aplicación de ejemplo
Actualice SiteURL en el ventana Propiedades

Project Online examina tanto el ámbito de aplicación del complemento como los permisos de usuario para controlar el acceso a la información sobre el host de Project Online. Si el acceso se deniega explícitamente en cualquiera de las dos configuraciones, Project Online deniega el acceso a la información. De lo contrario, se concede acceso.
Habilite la instalación local en el sitio.
Cree el proyecto.
Ejecute el proyecto.

Entorno de desarrollo de complementos hospedado por el proveedor de proyectos

Los complementos hospedados por el proveedor son aplicaciones escritas y que residen en cualquier plataforma web. Pueden conectarse y realizar operaciones de datos mediante la API REST (o CSOM para plataformas de Microsoft). Cualquier lenguaje y entorno que admita la interfaz REST se puede usar para el desarrollo.

Un ejemplo del entorno de desarrollo de Windows para este tipo de aplicación incluye los siguientes elementos:

Visual Studio 2015 (preferido) o Visual Studio 2013
Herramientas de desarrollo de Microsoft Office para Visual Studio (proporcionadas con las ediciones Visual Studio 2015 Professional y Enterprise)
.NET Framework 4.0 o posterior
Paquete CSOM de SharePointOnline (para llamadas CSOM)
Un lenguaje de programación, como C#

Visite https://github.com/OfficeDev/Project-Add-in-REST-BasicDataOperations los scripts de ejemplo de trabajo.

Puede ejecutar el ejemplo en algunos pasos:

Descarga y apertura de la aplicación de ejemplo
Actualice SiteURL en el ventana Propiedades

Project Online examina tanto el ámbito de aplicación del complemento como los permisos de usuario para controlar el acceso a la información sobre el host de Project Online. Si el acceso se deniega explícitamente en cualquiera de las dos configuraciones, Project Online deniega el acceso a la información. De lo contrario, se concede acceso.
Habilite la instalación local en el sitio.
Cree el proyecto.
Ejecute el proyecto.

Entorno de desarrollo de aplicaciones externo o independiente

Una aplicación independiente puede llamar a Project Online mediante el modelo de objetos del lado cliente (CSOM) o REST para comunicarse con Project Online para crear, recuperar, actualizar y eliminar información que resida en el servidor. Se trata de una aplicación cliente independiente que depende del nivel de acceso del usuario que se va a ejecutar.

Un ejemplo del entorno de desarrollo de Windows para este tipo de aplicación incluye los siguientes elementos:

Visual Studio 2015 (preferido) o Visual Studio 2013
Herramientas de desarrollo de Microsoft Office para Visual Studio (proporcionadas con las ediciones Visual Studio 2015 Professional y Enterprise)
.NET Framework 4.0 o posterior
Paquete CSOM de SharePointOnline (para llamadas CSOM)
Un lenguaje de programación, como C#

Visite https://github.com/OfficeDev/Project-CSOM-Read-Enterprise-CustomFields una aplicación de ejemplo.

Puede ejecutar el ejemplo en algunos pasos:

Descarga de la aplicación de ejemplo
Realice un par de cambios para acceder a su sitio Project Online: el nombre del sitio, la cuenta de usuario y la contraseña.

Asegúrese de que el usuario tiene acceso a todos los proyectos. Project Online usa permisos de usuario para controlar el acceso a la información del almacén de datos.
Agregue el ensamblado de SharePoint a las referencias mediante la consola del Administrador de paquetes Nuget, disponible en el menú Herramientas; para ello, escriba lo siguiente en la consola de Nuget:

Install-Package Microsoft.SharePointOnline.CSOM
Cree el proyecto.
Ejecute el proyecto.

Pasos siguientes

Cada aplicación de ejemplo tiene un artículo para explicar los aspectos más destacados de trabajar con la API de Project individual. Los artículos aparecen en la lista siguiente, junto con algunos artículos que describen las relaciones de entidad, la información sobre el sistema de consulta y el acceso a campos personalizados.

Vea también

Para conocer la documentación y los ejemplos relacionados con Project Online y el desarrollo de aplicaciones con CSOM, consulte el Portal de desarrollo del proyecto.