Uso de la API de escenarios empresariales en Microsoft Graph para integrarse con Planner (versión preliminar)

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

La API de escenarios empresariales permite la creación de Planner tareas con directivas controladas por escenarios, en un destino especificado.

configuración de Planner

Las aplicaciones pueden configurar Planner entidades de dos maneras cuando usan la API de escenarios empresariales. A continuación se enumeran las formas admitidas:

• Configuración del plan que define los elementos de los planes creados para hospedar tareas de escenario
• Configuración de tareas que controla cómo se comportan las tareas creadas para usuarios y aplicaciones

Configuración del plan

La configuración del plan se representa mediante la entidad plannerPlanConfiguration . En la configuración del plan, la aplicación puede configurar los cubos que aparecen en el plan, el orden de estos cubos, así como el título del plan y el nombre de los cubos. Cada cubo se identifica mediante un identificador externo que se puede usar al crear o actualizar tareas para colocarlas en el cubo correcto. Los cubos configurados en la configuración del plan no especifican los nombres que se van a usar, sino que esta información forma parte de los nombres localizados. La configuración del plan también especifica nombres localizados para el plan y los cubos, así como el código de idioma predeterminado. Actualmente, los elementos creados usan el idioma predeterminado.

Configuración de tareas

La configuración de la tarea se representa mediante la entidad plannerTaskConfiguration . En la configuración de tareas, la aplicación puede configurar las directivas que restringen el acceso a las aplicaciones y usuarios que usan las tareas administradas por el escenario. Las directivas se agrupan por roles. Cada rol identifica un grupo de llamadores y cada grupo puede tener reglas diferentes especificadas para ellos. Las reglas que se aplican a una llamada específica se seleccionan en el orden siguiente. Solo se aplican las primeras reglas especificadas cuando una solicitud modifica una tarea.

• taskAssignees: se aplica si la tarea de destino se asigna al usuario que realiza la llamada.
• groupOwners: se aplica si el usuario que realiza la llamada es propietario del contenedor en el que se encuentra el plan de la tarea de destino.
• groupMembers: se aplica si el usuario que realiza la llamada es miembro del contenedor en el que se encuentra el plan de la tarea.
• applications: se aplica si el autor de la llamada es permisos de aplicación, por lo que la llamada no está asociada a un usuario.
• defaultRules: se aplica cuando ninguna de las demás condiciones coincide.

Nota: Estas reglas restringen lo que el autor de la llamada puede hacer, pero no pueden permitir que el autor de la llamada realice operaciones a las que, de lo contrario, no se les permitiría.

Cada rol especifica una regla predeterminada y reglas para acciones y campos específicos de la tarea. La regla predeterminada debe ser allow o block. Si una acción o un campo no tiene una regla definida para ella, la regla predeterminada se usa para mantenerla sin restricciones para allowo para impedir que se use para block. Tenga en cuenta que esto se aplica cuando hay nuevas propiedades y acciones disponibles para configurarse, pero la configuración del escenario aún no se actualiza para especificar reglas para ellas.

Para obtener más información sobre cómo usar reglas, consulte Configuración de reglas de tareas en Planner.

Cómo dirigirse a tareas

Las tareas creadas se colocan en planes en función del destino especificado cuando se crean. En la versión actual, se puede establecer como destino un grupo . La tarea se coloca en el plan asociado al escenario de ese grupo. Si el grupo no tiene un plan para el escenario, se crea un nuevo plan en función de la configuración del plan.

Comportamiento y metadatos de tareas

Como parte de las tareas, se requieren las propiedades del escenario . Estas propiedades incluyen el identificador externo de la tarea, que se debe especificar para cada tarea. Este valor debe ser único dentro del inquilino. Si crea una segunda tarea con el mismo identificador externo, hace que la primera tarea se devuelva sin modificaciones. También puede usar el identificador externo como clave alternativa al trabajar con tareas. Además, puede especificar un identificador de contexto para cada tarea. Este valor se puede usar para consultar las tareas con el mismo identificador de contexto, lo que permite a las aplicaciones agrupar tareas entre planes.