Compartilhar via

Configurando regras de tarefa no Planner (versão prévia)

  • Artigo

A API Planner no Microsoft Graph dá suporte a regras que permitem a personalização do que pode ou não ser feito em tarefas. As regras de tarefa podem ser especificadas para tarefas criadas de várias fontes, como cenários de negócios.

As regras de propriedade da tarefa são representadas pela entidade plannerTaskPropertyRule e descrevem as ações permitidas no nível da tarefa e 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 padrã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 o que é permitido; valores omitidos não são permitidos.

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

Ações configuráveis

delete

Especifica se a tarefa pode ser excluída. Os valores aceitos são:

  • block: a tarefa não pode ser excluída.
  • allow: a tarefa pode ser excluída.

A coleção deve conter apenas um desses valores.

move

Especifica se a tarefa pode ser movida. Isso inclui apenas uma tarefa que se move entre buckets e planos com os mesmos contêineres ou diferentes. No entanto, ele não inclui outras operações semelhantes a movimentos, que podem ser configuradas de forma independente, como atribuições, ordenação da tarefa, porcentagem concluída ou prioridade. Os valores aceitos são:

  • block: a tarefa não pode ser movida.
  • moveBetweenBuckets: a tarefa só pode ser movida entre os buckets do plano em que está.
  • moveBetweenPlans: a tarefa pode ser movida entre buckets e entre os planos que pertencem ao mesmo contêiner.
  • allow: a tarefa pode ser movida entre buckets e entre planos.

A coleção deve conter apenas um desses valores.

Ordem

Especifica se a tarefa pode ser reordenada em exibições compartilhadas. Os valores aceitos são:

  • block: a tarefa não pode ser reordenada.
  • allow: a tarefa pode ser reordenada.

A coleção deve conter apenas um desses valores.

Propriedades configuráveis

appliedCategories

A propriedade appliedCategories é configurada com fieldRules, fornecendo valores e substituições padrão para condições específicas. Os valores aceitos são:

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

A coleção deve conter apenas um desses valores.

Essa propriedade não dá suporte a nenhuma condições de substituição. As regras devem ser especificadas na propriedade defaultRules .

assignments

A propriedade assignments é configurada com fieldRules, fornecendo valores e substituições padrão para condições específicas. Os valores aceitos são:

  • block: as atribuições da tarefa não podem ser alteradas.
  • addSelf: os usuários podem atribuir a tarefa a si mesmos.
  • removeSelf: os usuários podem se remover como atribuidores.
  • addOther: os usuários podem atribuir a tarefa a outras pessoas que não sejam elas mesmas.
  • removeOther: os usuários podem remover atribuições diferentes de si mesmos.
  • add: atribuições podem ser adicionadas.
  • remove: as atribuições podem ser removidas.
  • allow: atribuições podem ser adicionadas ou removidas.

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

Essa propriedade dá suporte às seguintes condições de substituição. Se uma substituição não tiver regras especificadas, os valores especificados para a propriedade defaultRules serão aplicados. Os defaultRules devem ser especificados.

  • userCreated: as regras se aplicam se a atribuição foi criada por um usuário.
  • applicationCreated: as regras se aplicam se a atribuição foi criada usando permissões de aplicativo.

Listas

A propriedade checkLists é configurada com fieldRules, fornecendo valores e substituições padrão para condições específicas. Os valores aceitos são:

  • block: a lista de verificação não pode ser alterada.
  • check: Itens de lista de verificação podem ser verificados.
  • reorder: Itens de lista de verificação podem ser reordenados.
  • add: novos itens de lista de verificação podem ser adicionados.
  • update: Itens de lista de verificação existentes podem ser atualizados.
  • remove: Itens de lista de verificação existentes podem ser removidos.
  • allow: todas as ações de lista de verificação são permitidas.

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

Essa propriedade dá suporte às seguintes condições de substituição. Se uma substituição não tiver regras especificadas, os valores especificados para a propriedade defaultRules serão aplicados. Os defaultRules devem ser especificados.

  • userCreated: As regras se aplicam se o item de lista de verificação foi criado por um usuário.
  • applicationCreated: As regras se aplicam se o item de lista de verificação foi criado usando permissões de aplicativo.

completionRequirements

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

  • block: a propriedade task completionRequirements não pode ser alterada.
  • add: novos requisitos de conclusão podem ser adicionados.
  • 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 ou block valor ou qualquer combinação de outros valores.

dueDate

Especifica se a data de vencimento da tarefa pode ser alterada. Os valores aceitos são:

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

A coleção deve conter apenas um desses valores.

notes

Especifica se as anotações de tarefa podem ser alteradas. Os valores aceitos são:

  • block: as anotações de tarefa não podem ser alteradas.
  • allow: as anotações da tarefa podem ser alteradas.

A coleção deve conter apenas um desses valores.

percentComplete

Especifica se a propriedade task percentComplete pode ser alterada. Os valores aceitos são:

  • block: a propriedade percentComplete da tarefa não pode ser alterada.
  • setToComplete: a propriedade task percentComplete pode ser definida como depois que 100 os requisitos de conclusão forem atendidos.
  • overrideRequirements: a propriedade task percentComplete pode ser definida como 100 mesmo se os requisitos de conclusão não forem atendidos.
  • setToInProgress: a propriedade task percentComplete pode ser definida como valores de 1 para 99.
  • setToNotStarted: a propriedade task percentComplete pode ser definida como 0.
  • allow: a propriedade percentComplete da tarefa pode ser alterada.

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

previewType

Especifica se o tipo de visualização de tarefa pode ser alterado. Os valores aceitos são:

  • block: o tipo de visualização de tarefas não pode ser alterado.
  • allow: o tipo de visualização de tarefa pode ser alterado.

A coleção deve conter apenas um desses valores.

prioridade

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

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

A coleção deve conter apenas um desses valores.

Referências

A propriedadereferences é configurada com fieldRules, fornecendo valores e substituições padrão para condições específicas. Os valores aceitos são:

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

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

Essa propriedade dá suporte às seguintes condições de substituição. Se uma substituição não tiver regras especificadas, os valores especificados para a propriedade defaultRules serão aplicados. Os defaultRules devem ser especificados.

  • userCreated: as regras se aplicam se a referência de tarefa foi criada por um usuário.
  • applicationCreated: as regras se aplicam se a referência de tarefa foi criada usando permissões de aplicativo.

startDate

Especifica se a data de início da tarefa pode ser alterada. Os valores aceitos 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 deve conter apenas um desses valores.

title

Especifica se o título da tarefa pode ser alterado. Os valores aceitos 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 deve conter apenas um desses valores.

approvalAttachment

A propriedade approvalAttachment é configurada com fieldRules, fornecendo valores e substituições padrão para condições específicas. Os valores aceitos são:

  • block: a aprovação não pode ser alterada.
  • add: uma nova aprovação pode ser adicionada.
  • remove: uma aprovação existente pode ser removida.
  • allow: todas as ações de aprovação são permitidas.

Forms

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

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