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