Question
活動予定の作成や活動の報告を行ったときに、[行動]のどの項目にどのような値が保存されるかを確認したい。
Answer
[行動]に保存される値は、操作するアプリケーションと操作の順序によって異なります。以下のシミュレーターで、実際の操作の流れに沿って保存される値を確認できます。
保存される値を確認する
1.[UPWARDモバイルアプリの設定]で、ご利用の設定に合わせてON / OFFを切り替えます。
2.[フロントアプリ]で操作するアプリケーションを選択します。操作の途中で切り替えることもできます。
3.[次に行う操作]から実行する操作を選択します。現在の状態で実行できない操作は、理由とともにグレーアウトされます。
操作するごとに[行動]の各項目が更新され、値が変わった項目が強調表示されます。[ひとつ戻る]で直前の操作を取り消して、別の操作を試すことができます。
UPWARDモバイルアプリの設定
[滞在の検知] をOFFにすると、活動予定を含めたすべての滞在が検知されません。[滞在の記録] をOFFにした場合は、活動予定のある活動先でのみ滞在検知が作動します。滞在検知先を制限したい
[UPWARD Web] > [組織設定] > [全般]で[すべてのユーザーで固定]がONになっている場合には、[UPWARDモバイルアプリ]の[メニュー] > [設定]に該当の設定は表示されません。このシミュレーターの設定は常に操作できます。
フロントアプリ
次に行う操作
操作履歴
「ー」は値が保存されないことを示します。活動ステータスの表示ラベルは確認中です。
保存対象の項目
シミュレーターで扱う[行動]の項目は以下のとおりです。
| 分類 | 項目名 | API参照名 |
|---|---|---|
| 行動(Event) | 開始 | StartDateTime |
| 行動(Event) | 終了 | EndDateTime |
| 位置・活動開始/終了情報 | 実施場所(緯度) | ogg__WorkLatitude__c |
| 位置・活動開始/終了情報 | 実施場所(経度) | ogg__WorkLongitude__c |
| 位置・活動開始/終了情報 | 活動開始日時 | ogg__StartTime__c |
| 位置・活動開始/終了情報 | 活動開始緯度 | ogg__StartLatitude__c |
| 位置・活動開始/終了情報 | 活動開始経度 | ogg__StartLongitude__c |
| 位置・活動開始/終了情報 | 活動終了日時 | ogg__FinishTime__c |
| 位置・活動開始/終了情報 | 活動終了緯度 | ogg__FinishLatitude__c |
| 位置・活動開始/終了情報 | 活動終了経度 | ogg__FinishLongitude__c |
| ステータス | 活動ステータス | ogg__ActivityStatus__c |
活動ステータスの値
| 値 | 状態 | 保存されるタイミング |
|---|---|---|
| 0 | 未実施 | 活動予定を作成した直後。活動が開始されていない状態。 |
| 1 | 活動中 | 活動予定に対して滞在を検知し、活動が開始された状態。 |
| 2 | 実施済み | 滞在の検知が終了した、または報告が完了した状態。 |
活動予定がない場合に値が格納されるタイミング
活動予定を作成せずに滞在を検知した場合、行動レコードには自動的に値が格納されません。
[報告]を行った時点で、滞在の検知結果が行動レコードに格納されます。
[予定外の活動を自動報告]をONにしている場合は、活動先からの移動を検知した時点で自動的に報告が行われ、そのタイミングで値が格納されます。
情報
シミュレーターの[UPWARDモバイルアプリの設定]は、[UPWARDモバイルアプリ]の実際の設定に対応しています。
設定の変更方法は関連記事をご確認ください。
[UPWARD Web]>[組織設定:
]>[全般]で[すべてのユーザーで固定]がONになっている場合には、[UPWARDモバイルアプリ]の[メニュー:
]>[設定:
]に該当の設定は表示されません。
録音を開始した場合の活動終了日時
[メニュー:
]から手動で録音を開始し、[録音停止]をタップして録音を終了した場合、活動終了日時には[録音停止]をタップした時刻が保存されます。
録音の自動停止
録音は、活動先からの移動(=滞在終了の検知)とともに自動的に停止します。
この動作は、録音開始時の操作方法(手動 / 通知経由)、活動予定の有無、[予定外の活動を自動報告]のON/OFFには依存しません。
同一の活動先に複数の活動予定がある場合の紐づけ先
同一の活動先に対して当日中に複数の活動予定(=行動レコード)を作成している場合、滞在の検知結果は、取得した行動リストの先頭1件に紐づけられます。
行動レコードの取得には並び替えの指定がなく、レコードの作成日時が早い順に取得されます。
活動予定の開始時刻と滞在を検知した時刻の近さは判定に使用されないため、滞在を検知した時刻に最も近い活動予定ではなく、先に作成した活動予定に紐づきます。
スケジュールの時刻表示の基準
UPWARDのスケジュール機能は[活動開始日時]・[活動終了日時]を基準に、Salesforceの[カレンダー]は標準の[開始]・[終了]を基準に、それぞれ時刻を表示します。[UPWARDモバイルアプリ]もUPWARDと同じ基準です。
報告の編集時は[開始]・[終了]の値を変更せず、[活動開始日時]・[活動終了日時]のみを更新します。
このため、報告済みの行動の時刻を変更した場合、UPWARDとSalesforceの[カレンダー]で表示位置が異なります。
| 時刻を変更した対象と画面 | UPWARDでの表示 | Salesforceの[カレンダー]での表示 |
|---|---|---|
| 活動予定の時刻を変更 | 変更した時刻の位置に表示 | 変更した時刻の位置に表示 |
| 報告済みの行動を、UPWARD側で変更 | 変更した時刻の位置に表示 | 初回登録時の時刻の位置を保持 |
| 報告済みの行動を、Salesforce側で変更 | 初回登録時の時刻の位置を保持 | 変更した時刻の位置に表示 |