Configuración de reglas de tareas en Planner (versión preliminar)

La API de Planner de Microsoft Graph admite reglas que permiten personalizar lo que se puede y no se puede realizar en las tareas. Las reglas de tareas se pueden especificar para las tareas creadas a partir de diversos orígenes, como escenarios empresariales.

Las reglas de propiedad de tarea se representan mediante la entidad plannerTaskPropertyRule y describen las acciones permitidas en el nivel de tarea y las reglas en torno a cada propiedad configurable.

En función de la entrada específica, las reglas especifican una colección de valores o un objeto fieldRules . Las reglas de campo especifican una colección de valores de forma predeterminada y proporcionan una colección independiente de valores para las condiciones de invalidación. Para cualquier colección de valores, los valores especificados son lo que se permite; no se permiten los valores omitidos.

En este artículo, aprenderá los comportamientos asociados a cada entrada y las condiciones de invalidación admitidas por cada propiedad.

Acciones configurables

delete

Especifica si se puede eliminar la tarea. Los valores aceptados son:

• block: no se puede eliminar la tarea.
• allow: se puede eliminar la tarea.

La colección debe contener solo uno de estos valores.

move

Especifica si se puede mover la tarea. Esto solo incluye una tarea que se mueve entre cubos y planes con los mismos contenedores o diferentes. Sin embargo, no incluye otras operaciones similares a los movimientos, que se pueden configurar de forma independiente, como asignaciones, ordenación de la tarea, porcentaje completado o prioridad. Los valores aceptados son:

• block: no se puede mover la tarea.
• moveBetweenBuckets: la tarea solo se puede mover entre los cubos del plan en el que se encuentra.
• moveBetweenPlans: la tarea se puede mover entre cubos y entre los planes que pertenecen al mismo contenedor.
• allow: la tarea se puede mover entre cubos y entre planes.

La colección debe contener solo uno de estos valores.

Orden

Especifica si la tarea se puede reordenar en vistas compartidas. Los valores aceptados son:

• block: la tarea no se puede reordenar.
• allow: la tarea se puede reordenar.

La colección debe contener solo uno de estos valores.

Propiedades configurables

appliedCategories

La propiedad appliedCategories se configura con fieldRules, lo que proporciona valores predeterminados e invalidaciones para condiciones específicas. Los valores aceptados son:

• block: las categorías aplicadas no se pueden cambiar.
• allow: las categorías se pueden agregar o quitar.

La colección debe contener solo uno de estos valores.

Esta propiedad no admite ninguna condición de invalidación. Las reglas deben especificarse en la propiedad defaultRules .

assignments

La propiedad assignments se configura con fieldRules, proporcionando valores predeterminados e invalidaciones para condiciones específicas. Los valores aceptados son:

• block: las asignaciones de la tarea no se pueden cambiar.
• addSelf: los usuarios pueden asignar la tarea a sí mismos.
• removeSelf: los usuarios pueden quitarse a sí mismos como asignados.
• addOther: los usuarios pueden asignar la tarea a personas distintas de sí mismas.
• removeOther: los usuarios pueden quitar usuarios asignados que no sean ellos mismos.
• add: se pueden agregar asignados.
• remove: se pueden quitar los asignados.
• allow: los asignados se pueden agregar o quitar.

La colección puede especificar un valor único allow o block , o cualquier combinación de otros valores.

Esta propiedad admite las siguientes condiciones de invalidación. Si una invalidación no tiene reglas especificadas, se aplican los valores especificados para la propiedad defaultRules . Se debe especificar defaultRules .

• userCreated: se aplican reglas si un usuario creó la asignación.
• applicationCreated: se aplican reglas si la asignación se creó con permisos de aplicación.

Listas

La propiedad checkLists se configura con fieldRules, proporcionando valores predeterminados e invalidaciones para condiciones específicas. Los valores aceptados son:

• block: no se puede cambiar la lista de comprobación.
• check: se pueden comprobar los elementos de lista de comprobación.
• reorder: los elementos de lista de comprobación se pueden reordenar.
• add: se pueden agregar nuevos elementos de lista de comprobación.
• update: se pueden actualizar los elementos de lista de comprobación existentes.
• remove: se pueden quitar los elementos de lista de comprobación existentes.
• allow: se permiten todas las acciones de lista de comprobación.

La colección puede especificar un valor único allow o block , o cualquier combinación de otros valores.

Esta propiedad admite las siguientes condiciones de invalidación. Si una invalidación no tiene reglas especificadas, se aplican los valores especificados para la propiedad defaultRules . Se debe especificar defaultRules .

• userCreated: se aplican reglas si un usuario creó el elemento de lista de comprobación.
• applicationCreated: se aplican reglas si el elemento de lista de comprobación se creó con permisos de aplicación.

completionRequirements

Especifica si se puede cambiar la propiedad completionRequirements de la tarea. Los valores aceptados son:

• block: no se puede cambiar la propiedad task completionRequirements .
• add: se pueden agregar nuevos requisitos de finalización.
• edit: se pueden editar los requisitos de finalización existentes.
• remove: se pueden quitar los requisitos de finalización existentes.
• allow: se puede cambiar la propiedad task completionRequirements .

La colección puede especificar un valor único allow o block , o cualquier combinación de otros valores.

dueDate

Especifica si se puede cambiar la fecha de vencimiento de la tarea. Los valores aceptados son:

• block: no se puede cambiar la fecha de vencimiento de la tarea.
• allow: la fecha de vencimiento de la tarea se puede cambiar, agregar o quitar.

La colección debe contener solo uno de estos valores.

notas

Especifica si se pueden cambiar las notas de la tarea. Los valores aceptados son:

• block: las notas de las tareas no se pueden cambiar.
• allow: se pueden cambiar las notas de las tareas.

La colección debe contener solo uno de estos valores.

percentComplete

Especifica si se puede cambiar la propiedad task percentComplete . Los valores aceptados son:

• block: no se puede cambiar la propiedad task percentComplete .
• setToComplete: la propiedad task percentComplete se puede establecer en 100 después de cumplir los requisitos de finalización.
• overrideRequirements: la propiedad task percentComplete se puede establecer 100 en incluso si no se cumplen los requisitos de finalización.
• setToInProgress: la propiedad task percentComplete se puede establecer en valores de 1 a 99.
• setToNotStarted: la propiedad task percentComplete se puede establecer en 0.
• allow: se puede cambiar la propiedad task percentComplete .

La colección puede especificar un valor único allow o block , o cualquier combinación de otros valores.

previewType

Especifica si se puede cambiar el tipo de vista previa de la tarea. Los valores aceptados son:

• block: no se puede cambiar el tipo de vista previa de tareas.
• allow: se puede cambiar el tipo de vista previa de tareas.

La colección debe contener solo uno de estos valores.

priority

Especifica si se puede cambiar la prioridad de la tarea. Los valores aceptados son:

• block: la prioridad de la tarea no se puede cambiar.
• allow: se puede cambiar la prioridad de la tarea.

La colección debe contener solo uno de estos valores.

Referencias

La propiedadreferences se configura con fieldRules, proporcionando valores predeterminados e invalidaciones para condiciones específicas. Los valores aceptados son:

• block: no se pueden cambiar las referencias de tareas.
• add: se pueden agregar nuevas referencias.
• remove: se pueden quitar las referencias existentes.
• allow: se permiten todas las acciones de referencia de tareas.

La colección puede especificar un valor único allow o block , o cualquier combinación de otros valores.

Esta propiedad admite las siguientes condiciones de invalidación. Si una invalidación no tiene reglas especificadas, en su lugar se aplican los valores especificados para la propiedad defaultRules . Se debe especificar defaultRules .

• userCreated: se aplican reglas si un usuario creó la referencia de tarea.
• applicationCreated: se aplican reglas si la referencia de tarea se creó con permisos de aplicación.

startDate

Especifica si se puede cambiar la fecha de inicio de la tarea. Los valores aceptados son:

• block: no se puede cambiar la fecha de inicio de la tarea.
• allow: se puede cambiar la fecha de inicio de la tarea.

La colección debe contener solo uno de estos valores.

title

Especifica si se puede cambiar el título de la tarea. Los valores aceptados son:

• block: no se puede cambiar el título de la tarea.
• allow: se puede cambiar el título de la tarea.

La colección debe contener solo uno de estos valores.

approvalAttachment

La propiedad approvalAttachment se configura con fieldRules, lo que proporciona valores predeterminados e invalidaciones para condiciones específicas. Los valores aceptados son:

• block: no se puede cambiar la aprobación.
• add: se puede agregar una nueva aprobación.
• remove: se puede quitar una aprobación existente.
• allow: se permiten todas las acciones de aprobación.

Formas

La propiedad forms se configura con fieldRules, lo que proporciona valores predeterminados e invalidaciones para condiciones específicas. Los posibles valores son:

• block: Forms no se puede cambiar.
• addResponse: las respuestas se pueden agregar al formulario.
• add: se pueden agregar nuevos formularios.
• update: se pueden actualizar los formularios existentes.
• remove: se pueden quitar los formularios existentes.
• allow: se permiten todas las acciones de formularios.