活動 (ActivityPointer) テーブル

  • [アーティクル]

活動 (ActivityPointer) テーブル には、ユーザーが実行する活動やタスクに関するデータが保存されます。 活動はカレンダーに入力可能なアクションであり、時間領域 (開始時間、停止時間、期限、期間) が存在します。

Dataverse で活動レコードを作成すると、対応する活動ポインター レコードが作成されます。 活動レコードおよびそれに関連付けられた活動ポインター レコードの ActivityId 列は同じ値になります。

ActivityPointer.ActivityTypeCode 列は、活動の種類を定義します。 activitypointer_activitytypecode グローバル オプション セットで、この列に指定可能な値が定義されます。

継承済み statecode および statuscode オプション

活動の列を設定または変更するコードを記述するときは、ActivityPointer 派生型の statecode 列と statuscode 列が、基本の ActivityPointer の statecode と statuscode の列定義とは多少異なる目的を持つことがあることに留意することが重要です。 以下のセクションでは、これらの違いについて説明します。

StateCode オプションの違い

このセクションでは、ActivityPointer と派生型の間の状態コード オプションの違いを確認してみましょう。

ActivityPointer.StateCode は、4 つのオプションを定義します。

ラベル 価値
未完了 12
Completed 6
取り消されました 2
スケジュール 3
  • Appointment、Chat、RecurringAppointmentMaster、およびカスタム活動には、4 つの statecode オプションがすべてあります。
  • Email、Fax、Letter、PhoneCall、Task、および SocialActivity には、最初の 3 つの statecode オプションがあります。 これらの活動タイプの状態を スケジュール済み と設定する有効なオプションはありません。

StatusCode ラベルの違い

statuscode オプションは、レコードの statecode の理由を提供します。 新しい statuscode オプションを追加して、各テーブルに異なるセットを含めることができます。 一部のオプションは、ActivityPointer statuscode と同じ値を持ちますが、ラベルは異なる場合があります。

statuscode オプションのラベルは、行を ActivityPointer として取得するか、Appointment、Email、または Task などの特定の活動の種類として取得するかによって異なります。

例えば、Appointment を表す ActivityPointer 行を取得すると、statuscode 値 1 のラベルは、Free ではなく Open になります。

ラベルは、各テーブルのデフォルト statuscode オプションの定義に一覧表示されます:

日付による活動の並べ替え方法を制御する

活動エンティティのリストを日付順に表示する場合は、ActivityPointer テーブルで定義されている共通の日付列でのみ並べ替えることができます。 しかし、活動の種類によって異なる並べ替えの動作を必要とする場合があります。 たとえば、メール活動を "更新" 日ではなく "送信" 日 で並べ替えることができます。 sortdate 列を使用して、日付による活動の並べ替え方法を制御します。

既定では、sortdate 列の値は null です。 列の値を設定し、ビューに対して定義したクエリで sortdate 列を使用するロジックを含めます。

ワークフローまたはプラグインを使用して sortdate 列の値を設定できます。 一貫した結果を取得するために、あらゆるタイプの活動およびシステム内の既存の活動データに対してこの値を設定する必要があります。

関連項目

アクティビティ テーブル
ActivityPointer table

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。