Configurar regras de tarefas no Planner (pré-visualização)

A API do Planner no Microsoft Graph suporta regras que permitem personalizar o que pode ou não ser feito em tarefas. As regras de tarefas podem ser especificadas para tarefas criadas a partir de várias origens, como cenários empresariais.

As regras de propriedade da tarefa são representadas pela entidade plannerTaskPropertyRule e descrevem as ações permitidas ao nível da tarefa e as regras em torno de cada propriedade configurável.

Dependendo da entrada específica, as regras especificam uma coleção de valores ou um objeto fieldRules . As regras de campo especificam uma coleção de valores como predefinição e fornecem uma coleção separada de valores para condições de substituição. Para qualquer coleção de valores, os valores especificados são os permitidos; Não são permitidos valores omitidos.

Neste artigo, irá aprender os comportamentos associados a cada entrada e as condições de substituição suportadas por cada propriedade.

Ações configuráveis

delete

Especifica se a tarefa pode ser eliminada. Os valores aceites são:

• block: não é possível eliminar a tarefa.
• allow: a tarefa pode ser eliminada.

A coleção tem de conter apenas um destes valores.

move

Especifica se a tarefa pode ser movida. Isto inclui apenas uma tarefa que se move entre registos e planos com os mesmos contentores ou contentores diferentes. No entanto, não inclui outras operações semelhantes a movimentações, que podem ser configuradas de forma independente, como atribuições, ordenação da tarefa, percentagem concluída ou prioridade. Os valores aceites são:

• block: não é possível mover a tarefa.
• moveBetweenBuckets: a tarefa só pode ser movida entre os registos do plano em que se encontra.
• moveBetweenPlans: a tarefa pode ser movida entre registos e entre os planos que pertencem ao mesmo contentor.
• allow: a tarefa pode ser movida entre registos e entre planos.

A coleção tem de conter apenas um destes valores.

encomenda

Especifica se a tarefa pode ser reordenada em vistas partilhadas. Os valores aceites são:

• block: não é possível reordenar a tarefa.
• allow: a tarefa pode ser reordenada.

A coleção tem de conter apenas um destes valores.

Propriedades configuráveis

appliedCategories

A propriedade appliedCategories está configurada com fieldRules, fornecendo valores e substituições predefinidos para condições específicas. Os valores aceites são:

• block: as categorias aplicadas não podem ser alteradas.
• allow: as categorias podem ser adicionadas ou removidas.

A coleção tem de conter apenas um destes valores.

Esta propriedade não suporta condições de substituição. As regras têm de ser especificadas na propriedade defaultRules .

assignments

A propriedade atribuições está configurada com fieldRules, fornecendo valores predefinidos e substituições para condições específicas. Os valores aceites são:

• block: as atribuições da tarefa não podem ser alteradas.
• addSelf: os utilizadores podem atribuir a tarefa a si próprios.
• removeSelf: os utilizadores podem remover-se a si próprios como detentores.
• addOther: os utilizadores podem atribuir a tarefa a outras pessoas que não sejam elas próprias.
• removeOther: os utilizadores podem remover detentores que não sejam eles próprios.
• add: os detentores podem ser adicionados.
• remove: os detentores podem ser removidos.
• allow: os detentores podem ser adicionados ou removidos.

A coleção pode especificar um único allow valor ou block qualquer combinação de outros valores.

Esta propriedade suporta as seguintes condições de substituição. Se uma substituição não tiver regras especificadas, aplicam-se os valores especificados para a propriedade defaultRules . As defaultRules têm de ser especificadas.

• userCreated: as regras aplicam-se se a atribuição tiver sido criada por um utilizador.
• applicationCreated: as regras aplicam-se se a atribuição tiver sido criada com permissões de aplicação.

checkLists

A propriedade checkLists está configurada com fieldRules, fornecendo valores predefinidos e substituições para condições específicas. Os valores aceites são:

• block: não é possível alterar a lista de verificação.
• check: os itens da lista de verificação podem ser verificados.
• reorder: os itens da lista de verificação podem ser reordenados.
• add: podem ser adicionados novos itens da lista de verificação.
• update: os itens existentes da lista de verificação podem ser atualizados.
• remove: os itens existentes da lista de verificação podem ser removidos.
• allow: todas as ações da lista de verificação são permitidas.

A coleção pode especificar um único allow valor ou block qualquer combinação de outros valores.

Esta propriedade suporta as seguintes condições de substituição. Se uma substituição não tiver regras especificadas, aplicam-se os valores especificados para a propriedade defaultRules . As defaultRules têm de ser especificadas.

• userCreated: as regras aplicam-se se o item da lista de verificação tiver sido criado por um utilizador.
• applicationCreated: as regras aplicam-se se o item da lista de verificação tiver sido criado com permissões de aplicação.

completionRequirements

Especifica se a propriedade task completionRequirements pode ser alterada. Os valores aceites são:

• block: a propriedade task completionRequirements não pode ser alterada.
• add: podem ser adicionados novos requisitos de conclusão.
• edit: os requisitos de conclusão existentes podem ser editados.
• remove: os requisitos de conclusão existentes podem ser removidos.
• allow: a propriedade task completionRequirements pode ser alterada.

A coleção pode especificar um único allow valor ou block qualquer combinação de outros valores.

dueDate

Especifica se a data para conclusão da tarefa pode ser alterada. Os valores aceites são:

• block: a data para conclusão da tarefa não pode ser alterada.
• allow: a data para conclusão da tarefa pode ser alterada, adicionada ou removida.

A coleção tem de conter apenas um destes valores.

notes

Especifica se as notas de tarefa podem ser alteradas. Os valores aceites são:

• block: as notas de tarefa não podem ser alteradas.
• allow: as notas de tarefa podem ser alteradas.

A coleção tem de conter apenas um destes valores.

percentComplete

Especifica se a propriedade percentagem da tarefaComplete pode ser alterada. Os valores aceites são:

• block: a propriedade percentComplete da tarefa não pode ser alterada.
• setToComplete: a propriedade percentComplete da tarefa pode ser definida como 100 após os requisitos de conclusão serem cumpridos.
• overrideRequirements: a propriedade percentComplete da tarefa pode ser definida como 100 mesmo que os requisitos de conclusão não sejam cumpridos.
• setToInProgress: a propriedade percentagem de tarefaComplete pode ser definida para valores de 1 para 99.
• setToNotStarted: a propriedade percentagem de tarefaComplete pode ser definida como 0.
• allow: a propriedade percentComplete da tarefa pode ser alterada.

A coleção pode especificar um único allow valor ou block qualquer combinação de outros valores.

previewType

Especifica se o tipo de pré-visualização da tarefa pode ser alterado. Os valores aceites são:

• block: o tipo de pré-visualização da tarefa não pode ser alterado.
• allow: o tipo de pré-visualização da tarefa pode ser alterado.

A coleção tem de conter apenas um destes valores.

prioridade

Especifica se a prioridade da tarefa pode ser alterada. Os valores aceites são:

• block: a prioridade da tarefa não pode ser alterada.
• allow: a prioridade da tarefa pode ser alterada.

A coleção tem de conter apenas um destes valores.

referências

A propriedadereferences (referências ) está configurada com fieldRules, fornecendo valores e substituições predefinidos para condições específicas. Os valores aceites são:

• block: as referências de tarefas não podem ser alteradas.
• add: podem ser adicionadas novas referências.
• remove: as referências existentes podem ser removidas.
• allow: todas as ações de referência de tarefas são permitidas.

A coleção pode especificar um único allow valor ou block qualquer combinação de outros valores.

Esta propriedade suporta as seguintes condições de substituição. Se uma substituição não tiver regras especificadas, aplicam-se os valores especificados para a propriedade defaultRules . As defaultRules têm de ser especificadas.

• userCreated: as regras aplicam-se se a referência de tarefa tiver sido criada por um utilizador.
• applicationCreated: as regras aplicam-se se a referência de tarefa tiver sido criada com permissões de aplicação.

startDate

Especifica se a data de início da tarefa pode ser alterada. Os valores aceites são:

• block: a data de início da tarefa não pode ser alterada.
• allow: a data de início da tarefa pode ser alterada.

A coleção tem de conter apenas um destes valores.

title

Especifica se o título da tarefa pode ser alterado. Os valores aceites são:

• block: o título da tarefa não pode ser alterado.
• allow: o título da tarefa pode ser alterado.

A coleção tem de conter apenas um destes valores.

aprovaçãoAnexação

A propriedade approvalAttachment está configurada com fieldRules, fornecendo valores e substituições predefinidos para condições específicas. Os valores aceites são:

• block: não é possível alterar a aprovação.
• add: pode ser adicionada uma nova aprovação.
• remove: uma aprovação existente pode ser removida.
• allow: todas as ações de Aprovação são permitidas.

formulários

A propriedade forms está configurada com fieldRules, fornecendo valores predefinidos e substituições para condições específicas. Os valores possíveis são:

• block: os formulários não podem ser alterados.
• addResponse: as respostas podem ser adicionadas ao formulário.
• add: podem ser adicionados novos formulários.
• update: os formulários existentes podem ser atualizados.
• remove: os formulários existentes podem ser removidos.
• allow: todas as ações de formulários são permitidas.