Tabela de Atividades (ActivityPointer)

A tabela Atividade (ActivityPointer) armazena dados sobre atividades ou tarefas que um usuário executa. Uma atividade é qualquer ação que você pode inserir em um calendário e tem dimensões de tempo, como hora de início, hora de parada, data de conclusão e duração.

Quando você cria um registro de atividade no Dataverse, ele cria um registro de ponteiro de atividade correspondente. O registro de atividade e seu registro de ponteiro de atividade correspondente têm o mesmo valor na coluna ActivityId.

A ActivityPointer.ActivityTypeCode coluna define o tipo da atividade. Os valores possíveis para esta coluna são definidos no conjunto de opções activitypointer_activitytypecode global.

Opções de código de estado e código de status herdados

Ao escrever código que define ou modifica colunas de atividade, tenha em mente que as colunas statecode e ActivityPointer de tipos derivados de ActivityPointer podem ter uma finalidade diferente das definições das colunas base statecodestatuscode e statuscode. As seções a seguir descrevem essas diferenças.

Diferenças de opção do StateCode

Esta seção analisa as diferenças nas opções de códigos de estado entre ActivityPointer e os tipos derivados.

ActivityPointer.StateCode define quatro opções:

Label	Valor
Abrir	0
Completed	1
Cancelado	2
Scheduled	3

• Compromisso, Chat, RecurringAppointmentMaster e atividades personalizadas têm as quatro statecode opções.
• Email, Fax, Carta, PhoneCall, Tarefa e SocialActivity têm as três statecode primeiras opções. Não há nenhuma opção válida para definir o estado desses tipos de atividade como Agendado.

Diferenças nos rótulos de StatusCode

As opções statuscode explicam o statecode do registro. Você pode adicionar novas statuscode opções para que cada tabela tenha um conjunto diferente. Algumas opções compartilham o mesmo valor que o ActivityPointerstatuscode, mas os rótulos podem ser diferentes.

Os rótulos das statuscode opções variam de acordo com se você está recuperando linhas como um ActivityPointer ou como um tipo de atividade específico, como um Compromisso, Email ou Tarefa.

Por exemplo, se você recuperar uma linha ActivityPointer que representa um Appointment, o rótulo do valor 1 de statuscode é Aberto em vez de Livre.

Você pode encontrar os rótulos na definição das opções padrão statuscode para cada tabela:

• Opções de ActivityPointer.StatusCode
• Opções de Appointment.StatusCode
• Opções de Chat.StatusCode
• Opções de Email.StatusCode
• Opções de Fax.StatusCode
• Opções de Letter.StatusCode
• Opções de PhoneCall.StatusCode
• Opções de RecurringAppointmentMaster.StatusCode
• Opções de Task.StatusCode
• Opções de SocialActivity.StatusCode

Controlar como as atividades são classificadas por data

Ao exibir uma lista de entidades de atividade na ordem de data, você só pode classificar as colunas de data comuns definidas na tabela ActivityPointer . No entanto, às vezes, você deseja comportamentos de classificação diferentes dependendo do tipo de atividade. Por exemplo, talvez você queira classificar as atividades de e-mail pela data de envio em vez da data de modificação. Use a sortdate coluna para controlar como as atividades são classificadas por data.

Por padrão, o valor da sortdate coluna é nulo. Inclua uma lógica para definir um valor para a coluna e, em seguida, use a coluna sortdate na consulta definida para a exibição.

Você pode definir o valor da sortdate coluna usando um fluxo de trabalho ou um plug-in. Para resultados consistentes, defina esse valor para cada tipo de atividade e quaisquer dados de atividade existentes no sistema.

Consulte também

Tabelas de atividades
tabela ActivityPointer