public VerifiedParticipationPage(Protocol protocol, ParticipationRewardDatum participationRewardDatum)
{
Title = "Participation Verification";
StackLayout contentLayout = new StackLayout
{
Orientation = StackOrientation.Vertical,
VerticalOptions = LayoutOptions.FillAndExpand,
Padding = new Thickness(0, 25, 0, 0)
};
string requiredParticipationPercentage = Math.Round(protocol.RewardThreshold.GetValueOrDefault() * 100, 0) + "%";
string participationPercentage = Math.Round(participationRewardDatum.Participation * 100, 0) + "%";
if (protocol.RewardThreshold == null)
{
contentLayout.Children.Add(
new Label
{
Text = "Verified Participation Level",
FontSize = 20,
HorizontalOptions = LayoutOptions.CenterAndExpand
});
contentLayout.Children.Add(
new Label
{
Text = participationPercentage,
FontSize = 50,
HorizontalOptions = LayoutOptions.CenterAndExpand
}
);
}
else
{
bool reward = participationRewardDatum.Participation >= protocol.RewardThreshold.GetValueOrDefault();
contentLayout.Children.Add(
new Image
{
HorizontalOptions = LayoutOptions.FillAndExpand,
Source = ImageSource.FromFile(reward ? "check.png" : "x.png")
});
contentLayout.Children.Add(
new Label
{
Text = "Participant should " + (reward ? "" : "not ") + "be rewarded. This study requires " + requiredParticipationPercentage + " participation, and the participant is at " + participationPercentage + ".",
FontSize = 20,
HorizontalOptions = LayoutOptions.CenterAndExpand
});
}
Content = new ScrollView
{
Content = contentLayout
};
}
public ProtocolsPage()
{
Title = "Your Studies";
_protocolsList = new ListView(ListViewCachingStrategy.RecycleElement);
_protocolsList.ItemTemplate = new DataTemplate(typeof(TextCell));
_protocolsList.ItemTemplate.SetBinding(TextCell.TextProperty, nameof(Protocol.Caption));
_protocolsList.ItemsSource = SensusServiceHelper.Get()?.RegisteredProtocols;
_protocolsList.ItemTapped += async(o, e) =>
{
if (_protocolsList.SelectedItem == null)
{
return;
}
Protocol selectedProtocol = _protocolsList.SelectedItem as Protocol;
#region add actions
List <string> actions = new List <string>();
actions.Add(selectedProtocol.Running ? "Stop" : "Start");
if (!string.IsNullOrWhiteSpace(selectedProtocol.ContactEmail))
{
actions.Add("Email Study Manager for Help");
}
if (selectedProtocol.Running)
{
actions.Add("Status");
}
actions.Add("View Data");
if (selectedProtocol.Running)
{
actions.Add("Display Participation");
}
if (selectedProtocol.RemoteDataStore?.CanRetrieveWrittenData ?? false)
{
actions.Add("Scan Participation Barcode");
}
actions.AddRange(new string[] { "Edit", "Copy", "Share" });
List <Protocol> groupableProtocols = SensusServiceHelper.Get().RegisteredProtocols.Where(registeredProtocol => registeredProtocol != selectedProtocol && registeredProtocol.Groupable && registeredProtocol.GroupedProtocols.Count == 0).ToList();
if (selectedProtocol.Groupable)
{
if (selectedProtocol.GroupedProtocols.Count == 0 && groupableProtocols.Count > 0)
{
actions.Add("Group");
}
else if (selectedProtocol.GroupedProtocols.Count > 0)
{
actions.Add("Ungroup");
}
}
if (!selectedProtocol.Running && selectedProtocol.ScheduledStartCallback != null)
{
actions.Remove("Start");
actions.Insert(0, "Cancel Scheduled Start");
}
actions.Add("Delete");
#endregion
#region process selected action
string selectedAction = await DisplayActionSheet(selectedProtocol.Name, "Cancel", null, actions.ToArray());
// must reset the protocol selection manually
SensusContext.Current.MainThreadSynchronizer.ExecuteThreadSafe(() =>
{
_protocolsList.SelectedItem = null;
});
if (selectedAction == "Status")
{
List <Tuple <string, Dictionary <string, string> > > events = await selectedProtocol.TestHealthAsync(true);
await Navigation.PushAsync(new ViewTextLinesPage("Status", events.SelectMany(healthEventNameProperties =>
{
return(healthEventNameProperties.Item2.Select(propertyValue => healthEventNameProperties.Item1 + ": " + propertyValue.Key + "=" + propertyValue.Value));
}).ToList(), null, null));
}
else if (selectedAction == "Start")
{
selectedProtocol.StartWithUserAgreementAsync(null);
}
else if (selectedAction == "Cancel Scheduled Start")
{
if (await DisplayAlert("Confirm Cancel", "Are you sure you want to cancel " + selectedProtocol.Name + "?", "Yes", "No"))
{
selectedProtocol.CancelScheduledStart();
}
}
else if (selectedAction == "Stop")
{
if (await DisplayAlert("Confirm Stop", "Are you sure you want to stop " + selectedProtocol.Name + "?", "Yes", "No"))
{
await selectedProtocol.StopAsync();
}
}
else if (selectedAction == "Email Study Manager for Help")
{
await SensusServiceHelper.Get().SendEmailAsync(selectedProtocol.ContactEmail, "Help with Sensus study: " + selectedProtocol.Name,
"Hello - " + Environment.NewLine +
Environment.NewLine +
"I am having trouble with a Sensus study. The name of the study is \"" + selectedProtocol.Name + "\"." + Environment.NewLine +
Environment.NewLine +
"Here is why I am sending this email: ");
}
else if (selectedAction == "View Data")
{
await Navigation.PushAsync(new ProbesViewPage(selectedProtocol));
}
else if (selectedAction == "Display Participation")
{
CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();
// pop up wait screen while we submit the participation reward datum
SensusServiceHelper.Get().PromptForInputsAsync(
null,
new[] { new InputGroup {
Name = "Please Wait", Inputs = { new LabelOnlyInput("Submitting participation information.", false) }
} },
cancellationTokenSource.Token,
false,
"Cancel",
null,
null,
null,
false,
async() =>
{
ParticipationRewardDatum participationRewardDatum = new ParticipationRewardDatum(DateTimeOffset.UtcNow, selectedProtocol.Participation);
participationRewardDatum.ProtocolId = selectedProtocol.Id;
bool writeFailed = false;
try
{
await selectedProtocol.RemoteDataStore.WriteDatumAsync(participationRewardDatum, cancellationTokenSource.Token);
}
catch (Exception)
{
writeFailed = true;
}
if (writeFailed)
{
await SensusServiceHelper.Get().FlashNotificationAsync("Failed to submit participation information to remote server. You will not be able to verify your participation at this time.");
}
// cancel the token to close the input above, but only if the token hasn't already been canceled.
if (!cancellationTokenSource.IsCancellationRequested)
{
cancellationTokenSource.Cancel();
}
await SensusContext.Current.MainThreadSynchronizer.ExecuteThreadSafe(async() =>
{
// only show the QR code for the reward datum if the datum was written to the remote data store and if the data store can retrieve it.
await Navigation.PushAsync(new ParticipationReportPage(selectedProtocol, participationRewardDatum, !writeFailed && (selectedProtocol.RemoteDataStore?.CanRetrieveWrittenData ?? false)));
});
},
inputs =>
{
// if the prompt was closed by the user instead of the cancellation token, cancel the token in order
// to cancel the remote data store write. if the prompt was closed by the termination of the remote
// data store write (i.e., by the canceled token), then don't cancel the token again.
if (!cancellationTokenSource.IsCancellationRequested)
{
cancellationTokenSource.Cancel();
}
});
}
else if (selectedAction == "Scan Participation Barcode")
{
try
{
Result barcodeResult = await SensusServiceHelper.Get().ScanQrCodeAsync(Navigation);
if (barcodeResult == null)
{
return;
}
SensusContext.Current.MainThreadSynchronizer.ExecuteThreadSafe(() =>
{
CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();
// pop up wait screen while we get the participation reward datum
SensusServiceHelper.Get().PromptForInputsAsync(
null,
new[] { new InputGroup {
Name = "Please Wait", Inputs = { new LabelOnlyInput("Retrieving participation information.", false) }
} },
cancellationTokenSource.Token,
false,
"Cancel",
null,
null,
null,
false,
async() =>
{
// after the page shows up, attempt to retrieve the participation reward datum.
try
{
ParticipationRewardDatum participationRewardDatum = await selectedProtocol.RemoteDataStore.GetDatumAsync <ParticipationRewardDatum>(barcodeResult.Text, cancellationTokenSource.Token);
// cancel the token to close the input above, but only if the token hasn't already been canceled by the user.
if (!cancellationTokenSource.IsCancellationRequested)
{
cancellationTokenSource.Cancel();
}
// ensure that the participation datum has not expired
if (participationRewardDatum.Timestamp > DateTimeOffset.UtcNow.AddSeconds(-SensusServiceHelper.PARTICIPATION_VERIFICATION_TIMEOUT_SECONDS))
{
await SensusContext.Current.MainThreadSynchronizer.ExecuteThreadSafe(async() =>
{
await Navigation.PushAsync(new VerifiedParticipationPage(selectedProtocol, participationRewardDatum));
});
}
else
{
await SensusServiceHelper.Get().FlashNotificationAsync("Participation barcode has expired. The participant needs to regenerate the barcode.");
}
}
catch (Exception)
{
await SensusServiceHelper.Get().FlashNotificationAsync("Failed to retrieve participation information.");
}
finally
{
// cancel the token to close the input above, but only if the token hasn't already been canceled by the user. this will be
// used if an exception is thrown while getting the participation reward datum.
if (!cancellationTokenSource.IsCancellationRequested)
{
cancellationTokenSource.Cancel();
}
}
},
inputs =>
{
// if the prompt was closed by the user instead of the cancellation token, cancel the token in order
// to cancel the datum retrieval. if the prompt was closed by the termination of the remote
// data store get (i.e., by the canceled token), then don't cancel the token again.
if (!cancellationTokenSource.IsCancellationRequested)
{
cancellationTokenSource.Cancel();
}
});
});
}
catch (Exception ex)
{
string message = "Failed to scan barcode: " + ex.Message;
SensusServiceHelper.Get().Logger.Log(message, LoggingLevel.Normal, GetType());
await SensusServiceHelper.Get().FlashNotificationAsync(message);
}
}
else if (selectedAction == "Edit")
{
ExecuteActionUponProtocolAuthentication(selectedProtocol, () =>
{
SensusContext.Current.MainThreadSynchronizer.ExecuteThreadSafe(async() =>
{
ProtocolPage protocolPage = new ProtocolPage(selectedProtocol);
await Navigation.PushAsync(protocolPage);
});
});
}
else if (selectedAction == "Copy")
{
// reset the protocol id, as we're creating a new study
selectedProtocol.CopyAsync(true, true);
}
else if (selectedAction == "Share")
{
Action ShareSelectedProtocol = new Action(() =>
{
// make a deep copy of the selected protocol so we can reset it for sharing. don't reset the id of the protocol to keep
// it in the same study. also do not register the copy since we're just going to send it off.
selectedProtocol.CopyAsync(false, false, async selectedProtocolCopy =>
{
// write protocol to file and share
string sharePath = SensusServiceHelper.Get().GetSharePath(".json");
selectedProtocolCopy.Save(sharePath);
await SensusServiceHelper.Get().ShareFileAsync(sharePath, "Sensus Protocol: " + selectedProtocolCopy.Name, "application/json");
});
});
if (selectedProtocol.Shareable)
{
ShareSelectedProtocol();
}
else
{
ExecuteActionUponProtocolAuthentication(selectedProtocol, ShareSelectedProtocol);
}
}
else if (selectedAction == "Group")
{
SensusServiceHelper.Get().PromptForInputAsync("Group",
new ItemPickerPageInput("Select Protocols", groupableProtocols.Cast <object>().ToList(), "Name")
{
Multiselect = true
},
null, true, "Group", null, null, null, false,
input =>
{
if (input == null)
{
SensusServiceHelper.Get().FlashNotificationAsync("No protocols grouped.");
return;
}
ItemPickerPageInput itemPickerPageInput = input as ItemPickerPageInput;
List <Protocol> selectedProtocols = (itemPickerPageInput.Value as List <object>).Cast <Protocol>().ToList();
if (selectedProtocols.Count == 0)
{
SensusServiceHelper.Get().FlashNotificationAsync("No protocols grouped.");
}
else
{
selectedProtocol.GroupedProtocols.AddRange(selectedProtocols);
SensusServiceHelper.Get().FlashNotificationAsync("Grouped \"" + selectedProtocol.Name + "\" with " + selectedProtocols.Count + " other protocol" + (selectedProtocols.Count == 1 ? "" : "s") + ".");
}
});
}
else if (selectedAction == "Ungroup")
{
if (await DisplayAlert("Ungroup " + selectedProtocol.Name + "?", "This protocol is currently grouped with the following other protocols:" + Environment.NewLine + Environment.NewLine + string.Concat(selectedProtocol.GroupedProtocols.Select(protocol => protocol.Name + Environment.NewLine)), "Ungroup", "Cancel"))
{
selectedProtocol.GroupedProtocols.Clear();
}
}
else if (selectedAction == "Delete")
{
if (await DisplayAlert("Delete " + selectedProtocol.Name + "?", "This action cannot be undone.", "Delete", "Cancel"))
{
await selectedProtocol.DeleteAsync();
}
}
};
#endregion
Content = _protocolsList;
#region add toolbar items
ToolbarItems.Add(new ToolbarItem(null, "plus.png", async() =>
{
List <string> buttons = new string[] { "From QR Code", "From URL", "New" }.ToList();
string action = await DisplayActionSheet("Add Study", "Back", null, buttons.ToArray());
if (action == "From QR Code")
{
Result result = await SensusServiceHelper.Get().ScanQrCodeAsync(Navigation);
if (result != null)
{
Protocol.DeserializeAsync(new Uri(result.Text), Protocol.DisplayAndStartAsync);
}
}
else if (action == "From URL")
{
SensusServiceHelper.Get().PromptForInputAsync(
"Download Protocol",
new SingleLineTextInput("Protocol URL:", Keyboard.Url),
null, true, null, null, null, null, false, input =>
{
// input might be null (user cancelled), or the value might be null (blank input submitted)
if (!string.IsNullOrEmpty(input?.Value?.ToString()))
{
Protocol.DeserializeAsync(new Uri(input.Value.ToString()), Protocol.DisplayAndStartAsync);
}
});
}
else if (action == "New")
{
Protocol.Create("New Protocol");
}
}));
ToolbarItems.Add(new ToolbarItem("ID", null, async() =>
{
await DisplayAlert("Device ID", SensusServiceHelper.Get().DeviceId, "Close");
}, ToolbarItemOrder.Secondary));
ToolbarItems.Add(new ToolbarItem("Log", null, async() =>
{
await Navigation.PushAsync(new ViewTextLinesPage("Log", SensusServiceHelper.Get().Logger.Read(200, true),
async() =>
{
string sharePath = null;
try
{
sharePath = SensusServiceHelper.Get().GetSharePath(".txt");
SensusServiceHelper.Get().Logger.CopyTo(sharePath);
}
catch (Exception)
{
sharePath = null;
}
if (sharePath != null)
{
await SensusServiceHelper.Get().ShareFileAsync(sharePath, "Log: " + Path.GetFileName(sharePath), "text/plain");
}
},
() => SensusServiceHelper.Get().Logger.Clear()));
}, ToolbarItemOrder.Secondary));
#if __ANDROID__
ToolbarItems.Add(new ToolbarItem("Stop", null, async() =>
{
if (await DisplayAlert("Confirm", "Are you sure you want to stop Sensus? This will end your participation in all studies.", "Stop Sensus", "Go Back"))
{
SensusServiceHelper.Get().StopProtocols();
(SensusServiceHelper.Get() as Android.IAndroidSensusServiceHelper)?.StopAndroidSensusService();
}
}, ToolbarItemOrder.Secondary));
#endif
ToolbarItems.Add(new ToolbarItem("About", null, async() =>
{
await DisplayAlert("About Sensus", "Version: " + SensusServiceHelper.Get().Version, "OK");
}, ToolbarItemOrder.Secondary));
#endregion
}
public ParticipationReportPage(Protocol protocol, ParticipationRewardDatum participationRewardDatum, bool displayDatumQrCode)
{
Title = protocol.Name;
#if __IOS__
string howToIncreaseScore = "You can increase your score by opening Sensus more often and responding to questions that Sensus asks you.";
#elif __ANDROID__
string howToIncreaseScore = "You can increase your score by allowing Sensus to run continuously and responding to questions that Sensus asks you.";
#elif WINDOWS_PHONE
string userNotificationMessage = null; // TODO: How to increase score?
#elif LOCAL_TESTS
string howToIncreaseScore = null;
#else
#warning "Unrecognized platform."
string howToIncreaseScore = "You can increase your score by opening Sensus more often and responding to questions that Sensus asks you.";
#endif
StackLayout contentLayout = new StackLayout
{
Orientation = StackOrientation.Vertical,
VerticalOptions = LayoutOptions.FillAndExpand,
Padding = new Thickness(0, 25, 0, 0),
Children =
{
new Label
{
Text = "Participation Level",
FontSize = 20,
HorizontalOptions = LayoutOptions.CenterAndExpand
},
new Label
{
Text = Math.Round(participationRewardDatum.Participation * 100, 0) + "%",
FontSize = 50,
HorizontalOptions = LayoutOptions.CenterAndExpand
},
new Label
{
Text = "This score reflects your participation level over the past " + (protocol.ParticipationHorizonDays == 1 ? "day" : protocol.ParticipationHorizonDays + " days") + "." +
(displayDatumQrCode ? " Anyone can verify your participation by tapping \"Scan Participation Barcode\" on their device and scanning the following barcode:" : ""),
FontSize = 20,
HorizontalOptions = LayoutOptions.CenterAndExpand
}
}
};
if (displayDatumQrCode)
{
Label expirationLabel = new Label
{
FontSize = 15,
HorizontalOptions = LayoutOptions.CenterAndExpand
};
contentLayout.Children.Add(expirationLabel);
Timer timer = new Timer(1000);
timer.Elapsed += (o, e) =>
{
SensusContext.Current.MainThreadSynchronizer.ExecuteThreadSafe(() =>
{
int secondsLeftBeforeBarcodeExpiration = (int)(SensusServiceHelper.PARTICIPATION_VERIFICATION_TIMEOUT_SECONDS - (DateTimeOffset.UtcNow - participationRewardDatum.Timestamp).TotalSeconds);
if (secondsLeftBeforeBarcodeExpiration <= 0)
{
expirationLabel.TextColor = Color.Red;
expirationLabel.Text = "Barcode has expired. Please reopen this page to renew it.";
timer.Stop();
}
else
{
--secondsLeftBeforeBarcodeExpiration;
expirationLabel.Text = "Barcode will expire in " + secondsLeftBeforeBarcodeExpiration + " second" + (secondsLeftBeforeBarcodeExpiration == 1 ? "" : "s") + ".";
}
});
};
timer.Start();
Disappearing += (o, e) =>
{
timer.Stop();
};
contentLayout.Children.Add(new Image
{
Source = SensusServiceHelper.Get().GetQrCodeImageSource(protocol.RemoteDataStore.GetDatumKey(participationRewardDatum)),
HorizontalOptions = LayoutOptions.CenterAndExpand
});
}
contentLayout.Children.Add(new Label
{
Text = howToIncreaseScore,
FontSize = 20,
HorizontalOptions = LayoutOptions.CenterAndExpand
});
if (!string.IsNullOrWhiteSpace(protocol.ContactEmail))
{
Button emailStudyManagerButton = new Button
{
Text = "Email Study Manager for Help",
FontSize = 20
};
emailStudyManagerButton.Clicked += (o, e) =>
{
SensusServiceHelper.Get().SendEmailAsync(protocol.ContactEmail, "Help with Sensus study: " + protocol.Name,
"Hello - " + Environment.NewLine +
Environment.NewLine +
"I am having trouble with a Sensus study. The name of the study is \"" + protocol.Name + "\"." + Environment.NewLine +
Environment.NewLine +
"Here is why I am sending this email: ");
};
contentLayout.Children.Add(emailStudyManagerButton);
}
Button viewParticipationDetailsButton = new Button
{
Text = "View Participation Details",
FontSize = 20
};
viewParticipationDetailsButton.Clicked += async(o, e) =>
{
await Navigation.PushAsync(new ParticipationReportDetailsPage(protocol));
};
contentLayout.Children.Add(viewParticipationDetailsButton);
Content = new ScrollView
{
Content = contentLayout
};
}
public ProtocolsPage()
{
Title = "Your Studies";
_protocolsList = new ListView();
_protocolsList.ItemTemplate = new DataTemplate(typeof(TextCell));
_protocolsList.ItemTemplate.SetBinding(TextCell.TextProperty, new Binding(".", converter: new ProtocolNameValueConverter()));
_protocolsList.ItemTemplate.SetBinding(TextCell.TextColorProperty, new Binding(".", converter: new ProtocolColorValueConverter()));
_protocolsList.ItemTapped += async(o, e) =>
{
if (_protocolsList.SelectedItem == null)
{
return;
}
Protocol selectedProtocol = _protocolsList.SelectedItem as Protocol;
List <string> actions = new List <string>();
actions.Add(selectedProtocol.Running ? "Stop" : "Start");
if (!string.IsNullOrWhiteSpace(selectedProtocol.ContactEmail))
{
actions.Add("Email Study Manager for Help");
}
actions.Add("View Data");
if (selectedProtocol.Running)
{
actions.Add("Display Participation");
}
if (selectedProtocol.RemoteDataStore?.CanRetrieveCommittedData ?? false)
{
actions.Add("Scan Participation Barcode");
}
actions.AddRange(new string[] { "Edit", "Copy", "Share" });
List <Protocol> groupableProtocols = SensusServiceHelper.Get().RegisteredProtocols.Where(registeredProtocol => registeredProtocol != selectedProtocol && registeredProtocol.Groupable && registeredProtocol.GroupedProtocols.Count == 0).ToList();
if (selectedProtocol.Groupable)
{
if (selectedProtocol.GroupedProtocols.Count == 0 && groupableProtocols.Count > 0)
{
actions.Add("Group");
}
else if (selectedProtocol.GroupedProtocols.Count > 0)
{
actions.Add("Ungroup");
}
}
if (selectedProtocol.Running)
{
actions.Add("Status");
}
if (!selectedProtocol.Running && selectedProtocol.ScheduledStartCallback != null)
{
actions.Remove("Start");
actions.Insert(0, "Cancel Scheduled Start");
}
actions.Add("Delete");
string selectedAction = await DisplayActionSheet(selectedProtocol.Name, "Cancel", null, actions.ToArray());
// must reset the protocol selection manually
Device.BeginInvokeOnMainThread(() =>
{
_protocolsList.SelectedItem = null;
});
if (selectedAction == "Start")
{
selectedProtocol.StartWithUserAgreementAsync(null, () =>
{
// rebind to pick up color and running status changes
Refresh();
});
}
else if (selectedAction == "Cancel Scheduled Start")
{
if (await DisplayAlert("Confirm Cancel", "Are you sure you want to cancel " + selectedProtocol.Name + "?", "Yes", "No"))
{
selectedProtocol.CancelScheduledStart();
// rebind to pick up color and running status changes
Refresh();
}
}
else if (selectedAction == "Stop")
{
if (await DisplayAlert("Confirm Stop", "Are you sure you want to stop " + selectedProtocol.Name + "?", "Yes", "No"))
{
selectedProtocol.StopAsync(() =>
{
// rebind to pick up color and running status changes
Refresh();
});
}
}
else if (selectedAction == "Email Study Manager for Help")
{
SensusServiceHelper.Get().SendEmailAsync(selectedProtocol.ContactEmail, "Help with Sensus study: " + selectedProtocol.Name,
"Hello - " + Environment.NewLine +
Environment.NewLine +
"I am having trouble with a Sensus study. The name of the study is \"" + selectedProtocol.Name + "\"." + Environment.NewLine +
Environment.NewLine +
"Here is why I am sending this email: ");
}
else if (selectedAction == "View Data")
{
await Navigation.PushAsync(new ProbesViewPage(selectedProtocol));
}
else if (selectedAction == "Display Participation")
{
CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();
// pop up wait screen while we submit the participation reward datum
SensusServiceHelper.Get().PromptForInputsAsync(
null,
new[] { new InputGroup {
Name = "Please Wait", Inputs = { new LabelOnlyInput("Submitting participation information.", false) }
} },
cancellationTokenSource.Token,
false,
"Cancel",
null,
null,
null,
false,
async() =>
{
// add participation reward datum to remote data store and commit immediately
ParticipationRewardDatum participationRewardDatum = new ParticipationRewardDatum(DateTimeOffset.UtcNow, selectedProtocol.Participation);
bool commitFailed;
try
{
commitFailed = !await selectedProtocol.RemoteDataStore.CommitAsync(participationRewardDatum, cancellationTokenSource.Token);
}
catch (Exception)
{
commitFailed = true;
}
if (commitFailed)
{
SensusServiceHelper.Get().FlashNotificationAsync("Failed to submit participation information to remote server. You will not be able to verify your participation at this time.");
}
// cancel the token to close the input above, but only if the token hasn't already been canceled.
if (!cancellationTokenSource.IsCancellationRequested)
{
cancellationTokenSource.Cancel();
}
Device.BeginInvokeOnMainThread(async() =>
{
// only show the QR code for the reward datum if the datum was committed to the remote data store and if the data store can retrieve it.
await Navigation.PushAsync(new ParticipationReportPage(selectedProtocol, participationRewardDatum, !commitFailed && (selectedProtocol.RemoteDataStore?.CanRetrieveCommittedData ?? false)));
});
},
inputs =>
{
// if the prompt was closed by the user instead of the cancellation token, cancel the token in order
// to cancel the remote data store commit. if the prompt was closed by the termination of the remote
// data store commit (i.e., by the canceled token), then don't cancel the token again.
if (!cancellationTokenSource.IsCancellationRequested)
{
cancellationTokenSource.Cancel();
}
});
}
else if (selectedAction == "Scan Participation Barcode")
{
try
{
Result barcodeResult = await SensusServiceHelper.Get().ScanQrCodeAsync(Navigation);
if (barcodeResult == null)
{
return;
}
SensusContext.Current.MainThreadSynchronizer.ExecuteThreadSafe(() =>
{
CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();
// pop up wait screen while we get the participation reward datum
SensusServiceHelper.Get().PromptForInputsAsync(
null,
new[] { new InputGroup {
Name = "Please Wait", Inputs = { new LabelOnlyInput("Retrieving participation information.", false) }
} },
cancellationTokenSource.Token,
false,
"Cancel",
null,
null,
null,
false,
async() =>
{
// after the page shows up, attempt to retrieve the participation reward datum.
try
{
ParticipationRewardDatum participationRewardDatum = await selectedProtocol.RemoteDataStore.GetDatum <ParticipationRewardDatum>(barcodeResult.Text, cancellationTokenSource.Token);
// cancel the token to close the input above, but only if the token hasn't already been canceled by the user.
if (!cancellationTokenSource.IsCancellationRequested)
{
cancellationTokenSource.Cancel();
}
// ensure that the participation datum has not expired
if (participationRewardDatum.Timestamp > DateTimeOffset.UtcNow.AddSeconds(-SensusServiceHelper.PARTICIPATION_VERIFICATION_TIMEOUT_SECONDS))
{
await SensusContext.Current.MainThreadSynchronizer.ExecuteThreadSafe(async() =>
{
await Navigation.PushAsync(new VerifiedParticipationPage(selectedProtocol, participationRewardDatum));
});
}
else
{
SensusServiceHelper.Get().FlashNotificationAsync("Participation barcode has expired. The participant needs to regenerate the barcode.");
}
}
catch (Exception)
{
SensusServiceHelper.Get().FlashNotificationAsync("Failed to retrieve participation information.");
}
finally
{
// cancel the token to close the input above, but only if the token hasn't already been canceled by the user. this will be
// used if an exception is thrown while getting the participation reward datum.
if (!cancellationTokenSource.IsCancellationRequested)
{
cancellationTokenSource.Cancel();
}
}
},
inputs =>
{
// if the prompt was closed by the user instead of the cancellation token, cancel the token in order
// to cancel the datum retrieval. if the prompt was closed by the termination of the remote
// data store get (i.e., by the canceled token), then don't cancel the token again.
if (!cancellationTokenSource.IsCancellationRequested)
{
cancellationTokenSource.Cancel();
}
});
});
}
catch (Exception ex)
{
string message = "Failed to scan barcode: " + ex.Message;
SensusServiceHelper.Get().Logger.Log(message, LoggingLevel.Normal, GetType());
SensusServiceHelper.Get().FlashNotificationAsync(message);
}
}
else if (selectedAction == "Edit")
{
ExecuteActionUponProtocolAuthentication(selectedProtocol, () =>
{
Device.BeginInvokeOnMainThread(async() =>
{
ProtocolPage protocolPage = new ProtocolPage(selectedProtocol);
protocolPage.Disappearing += (oo, ee) => Bind(); // rebind to pick up name changes
await Navigation.PushAsync(protocolPage);
});
});
}
else if (selectedAction == "Copy")
{
// reset the protocol id, as we're creating a new study
selectedProtocol.CopyAsync(true, true);
}
else if (selectedAction == "Share")
{
Action ShareSelectedProtocol = new Action(() =>
{
// make a deep copy of the selected protocol so we can reset it for sharing. don't reset the id of the protocol to keep
// it in the same study. also do not register the copy since we're just going to send it off.
selectedProtocol.CopyAsync(false, false, selectedProtocolCopy =>
{
// write protocol to file and share
string sharePath = SensusServiceHelper.Get().GetSharePath(".json");
selectedProtocolCopy.Save(sharePath);
SensusServiceHelper.Get().ShareFileAsync(sharePath, "Sensus Protocol: " + selectedProtocolCopy.Name, "application/json");
});
});
if (selectedProtocol.Shareable)
{
ShareSelectedProtocol();
}
else
{
ExecuteActionUponProtocolAuthentication(selectedProtocol, ShareSelectedProtocol);
}
}
else if (selectedAction == "Group")
{
SensusServiceHelper.Get().PromptForInputAsync("Group",
new ItemPickerPageInput("Select Protocols", groupableProtocols.Cast <object>().ToList(), "Name")
{
Multiselect = true
},
null, true, "Group", null, null, null, false,
input =>
{
if (input == null)
{
SensusServiceHelper.Get().FlashNotificationAsync("No protocols grouped.");
return;
}
ItemPickerPageInput itemPickerPageInput = input as ItemPickerPageInput;
List <Protocol> selectedProtocols = (itemPickerPageInput.Value as List <object>).Cast <Protocol>().ToList();
if (selectedProtocols.Count == 0)
{
SensusServiceHelper.Get().FlashNotificationAsync("No protocols grouped.");
}
else
{
selectedProtocol.GroupedProtocols.AddRange(selectedProtocols);
SensusServiceHelper.Get().FlashNotificationAsync("Grouped \"" + selectedProtocol.Name + "\" with " + selectedProtocols.Count + " other protocol" + (selectedProtocols.Count == 1 ? "" : "s") + ".");
}
});
}
else if (selectedAction == "Ungroup")
{
if (await DisplayAlert("Ungroup " + selectedProtocol.Name + "?", "This protocol is currently grouped with the following other protocols:" + Environment.NewLine + Environment.NewLine + string.Concat(selectedProtocol.GroupedProtocols.Select(protocol => protocol.Name + Environment.NewLine)), "Ungroup", "Cancel"))
{
selectedProtocol.GroupedProtocols.Clear();
}
}
else if (selectedAction == "Status")
{
if (SensusServiceHelper.Get().ProtocolShouldBeRunning(selectedProtocol))
{
await selectedProtocol.TestHealthAsync(true);
Device.BeginInvokeOnMainThread(async() =>
{
if (selectedProtocol.MostRecentReport == null)
{
await DisplayAlert("No Report", "Status check failed.", "OK");
}
else
{
await Navigation.PushAsync(new ViewTextLinesPage("Protocol Status", selectedProtocol.MostRecentReport.ToString().Split(new string[] { Environment.NewLine }, StringSplitOptions.RemoveEmptyEntries).ToList(), null, null));
}
});
}
else
{
await DisplayAlert("Protocol Not Running", "Cannot check status of protocol when protocol is not running.", "OK");
}
}
else if (selectedAction == "Delete")
{
if (await DisplayAlert("Delete " + selectedProtocol.Name + "?", "This action cannot be undone.", "Delete", "Cancel"))
{
selectedProtocol.DeleteAsync();
}
}
};
Content = _protocolsList;
ToolbarItems.Add(new ToolbarItem(null, "plus.png", async() =>
{
List <string> buttons = new string[] { "From QR Code", "From URL", "From Scratch" }.ToList();
string action = await DisplayActionSheet("Add Study", "Back", null, buttons.ToArray());
if (action == "From QR Code")
{
Result result = await SensusServiceHelper.Get().ScanQrCodeAsync(Navigation);
if (result != null)
{
Protocol.DeserializeAsync(new Uri(result.Text), Protocol.DisplayAndStartAsync);
}
}
else if (action == "From URL")
{
SensusServiceHelper.Get().PromptForInputAsync(
"Download Protocol",
new SingleLineTextInput("Protocol URL:", Keyboard.Url),
null, true, null, null, null, null, false, input =>
{
// input might be null (user cancelled), or the value might be null (blank input submitted)
if (!string.IsNullOrEmpty(input?.Value?.ToString()))
{
Protocol.DeserializeAsync(new Uri(input.Value.ToString()), Protocol.DisplayAndStartAsync);
}
});
}
else if (action == "From Scratch")
{
Protocol.Create("New Protocol");
}
}));
Bind();
System.Timers.Timer refreshTimer = new System.Timers.Timer(1000);
refreshTimer.Elapsed += (sender, e) =>
{
Refresh();
};
Appearing += (sender, e) =>
{
refreshTimer.Start();
};
Disappearing += (sender, e) =>
{
refreshTimer.Stop();
};
}
public ProtocolsPage()
{
Title = "Your Studies";
_protocolsList = new ListView();
_protocolsList.ItemTemplate = new DataTemplate(typeof(TextCell));
_protocolsList.ItemTemplate.SetBinding(TextCell.TextProperty, new Binding(".", converter: new ProtocolNameValueConverter()));
_protocolsList.ItemTemplate.SetBinding(TextCell.TextColorProperty, new Binding(".", converter: new ProtocolColorValueConverter()));
_protocolsList.ItemTapped += async(o, e) =>
{
if (_protocolsList.SelectedItem == null)
{
return;
}
Protocol selectedProtocol = _protocolsList.SelectedItem as Protocol;
List <string> actions = new List <string>();
actions.Add(selectedProtocol.Running ? "Stop" : "Start");
actions.Add("View Data");
if (selectedProtocol.Running)
{
actions.Add("Display Participation");
}
if (selectedProtocol.RemoteDataStore?.CanRetrieveCommittedData ?? false)
{
actions.Add("Scan Participation Barcode");
}
actions.AddRange(new string[] { "Edit", "Copy", "Share" });
List <Protocol> groupableProtocols = SensusServiceHelper.Get().RegisteredProtocols.Where(registeredProtocol => registeredProtocol != selectedProtocol && registeredProtocol.Groupable && registeredProtocol.GroupedProtocols.Count == 0).ToList();
if (selectedProtocol.Groupable)
{
if (selectedProtocol.GroupedProtocols.Count == 0 && groupableProtocols.Count > 0)
{
actions.Add("Group");
}
else if (selectedProtocol.GroupedProtocols.Count > 0)
{
actions.Add("Ungroup");
}
}
if (selectedProtocol.Running)
{
actions.Add("Status");
}
if (!selectedProtocol.Running && selectedProtocol.ScheduledStartCallbackId != null)
{
actions.Remove("Start");
actions.Insert(0, "Cancel Scheduled Start");
}
actions.Add("Delete");
string selectedAction = await DisplayActionSheet(selectedProtocol.Name, "Cancel", null, actions.ToArray());
// must reset the protocol selection manually
Device.BeginInvokeOnMainThread(() =>
{
_protocolsList.SelectedItem = null;
});
if (selectedAction == "Start")
{
selectedProtocol.StartWithUserAgreementAsync(null, () =>
{
// rebind to pick up color and running status changes
Refresh();
});
}
else if (selectedAction == "Cancel Scheduled Start")
{
if (await DisplayAlert("Confirm Cancel", "Are you sure you want to cancel " + selectedProtocol.Name + "?", "Yes", "No"))
{
selectedProtocol.CancelScheduledStart();
// rebind to pick up color and running status changes
Refresh();
}
}
else if (selectedAction == "Stop")
{
if (await DisplayAlert("Confirm Stop", "Are you sure you want to stop " + selectedProtocol.Name + "?", "Yes", "No"))
{
selectedProtocol.StopAsync(() =>
{
// rebind to pick up color and running status changes
Refresh();
});
}
}
else if (selectedAction == "View Data")
{
await Navigation.PushAsync(new ProbesViewPage(selectedProtocol));
}
else if (selectedAction == "Display Participation")
{
CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();
// pop up wait screen while we submit the participation reward datum
SensusServiceHelper.Get().PromptForInputsAsync(
null,
new [] { new InputGroup {
Name = "Please Wait", Inputs = { new LabelOnlyInput("Submitting participation information.", false) }
} },
cancellationTokenSource.Token,
false,
"Cancel",
null,
null,
null,
false,
async() =>
{
// add participation reward datum to remote data store and commit immediately
ParticipationRewardDatum participationRewardDatum = new ParticipationRewardDatum(DateTimeOffset.UtcNow, selectedProtocol.Participation);
bool commitFailed;
try
{
commitFailed = !await selectedProtocol.RemoteDataStore.CommitAsync(participationRewardDatum, cancellationTokenSource.Token);
}
catch (Exception)
{
commitFailed = true;
}
if (commitFailed)
{
SensusServiceHelper.Get().FlashNotificationAsync("Failed to submit participation information to remote server. You will not be able to verify your participation at this time.");
}
// cancel the token to close the input above, but only if the token hasn't already been canceled.
if (!cancellationTokenSource.IsCancellationRequested)
{
cancellationTokenSource.Cancel();
}
Device.BeginInvokeOnMainThread(async() =>
{
// only show the QR code for the reward datum if the datum was committed to the remote data store and if the data store can retrieve it.
await Navigation.PushAsync(new ParticipationReportPage(selectedProtocol, participationRewardDatum, !commitFailed && (selectedProtocol.RemoteDataStore?.CanRetrieveCommittedData ?? false)));
});
},
inputs =>
{
// if the prompt was closed by the user instead of the cancellation token, cancel the token in order
// to cancel the remote data store commit. if the prompt was closed by the termination of the remote
// data store commit (i.e., by the canceled token), then don't cancel the token again.
if (!cancellationTokenSource.IsCancellationRequested)
{
cancellationTokenSource.Cancel();
}
});
}
else if (selectedAction == "Scan Participation Barcode")
{
Result barcodeResult = null;
try
{
if (await SensusServiceHelper.Get().ObtainPermissionAsync(Permission.Camera) != PermissionStatus.Granted)
{
throw new Exception("Could not access camera.");
}
#if __ANDROID__ || __IOS__
ZXing.Mobile.MobileBarcodeScanner scanner = SensusServiceHelper.Get().BarcodeScanner;
if (scanner == null)
{
throw new Exception("Barcode scanner not present.");
}
scanner.TopText = "Position a Sensus participation barcode in the window below, with the red line across the middle of the barcode.";
scanner.BottomText = "Sensus is not recording any of these images. Sensus is only trying to find a barcode.";
scanner.CameraUnsupportedMessage = "There is not a supported camera on this phone. Cannot scan barcode.";
barcodeResult = await scanner.Scan(new ZXing.Mobile.MobileBarcodeScanningOptions
{
PossibleFormats = new BarcodeFormat[] { BarcodeFormat.QR_CODE }.ToList()
});
#endif
}
catch (Exception ex)
{
string message = "Failed to scan barcode: " + ex.Message;
SensusServiceHelper.Get().Logger.Log(message, LoggingLevel.Normal, GetType());
SensusServiceHelper.Get().FlashNotificationAsync(message);
}
if (barcodeResult != null)
{
CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();
// pop up wait screen while we get the participation reward datum
SensusServiceHelper.Get().PromptForInputsAsync(
null,
new [] { new InputGroup {
Name = "Please Wait", Inputs = { new LabelOnlyInput("Retrieving participation information.", false) }
} },
cancellationTokenSource.Token,
false,
"Cancel",
null,
null,
null,
false,
async() =>
{
try
{
ParticipationRewardDatum participationRewardDatum = await selectedProtocol.RemoteDataStore.GetDatum <ParticipationRewardDatum>(barcodeResult.Text, cancellationTokenSource.Token);
// cancel the token to close the input above, but only if the token hasn't already been canceled.
if (!cancellationTokenSource.IsCancellationRequested)
{
cancellationTokenSource.Cancel();
}
// ensure that the participation datum has not expired
if (participationRewardDatum.Timestamp > DateTimeOffset.UtcNow.AddSeconds(-SensusServiceHelper.PARTICIPATION_VERIFICATION_TIMEOUT_SECONDS))
{
Device.BeginInvokeOnMainThread(async() =>
{
await Navigation.PushAsync(new VerifiedParticipationPage(selectedProtocol, participationRewardDatum));
});
}
else
{
SensusServiceHelper.Get().FlashNotificationAsync("Participation barcode has expired. The participant needs to regenerate the barcode.");
}
}
catch (Exception)
{
SensusServiceHelper.Get().FlashNotificationAsync("Failed to retrieve participation information.");
}
finally
{
// cancel the token to close the input above, but only if the token hasn't already been canceled. this will be
// used if an exception is thrown while getting the participation reward datum.
if (!cancellationTokenSource.IsCancellationRequested)
{
cancellationTokenSource.Cancel();
}
}
},
inputs =>
{
// if the prompt was closed by the user instead of the cancellation token, cancel the token in order
// to cancel the datum retrieval. if the prompt was closed by the termination of the remote
// data store get (i.e., by the canceled token), then don't cancel the token again.
if (!cancellationTokenSource.IsCancellationRequested)
{
cancellationTokenSource.Cancel();
}
});
}
}
else if (selectedAction == "Edit")
{
ExecuteActionUponProtocolAuthentication(selectedProtocol, () =>
{
Device.BeginInvokeOnMainThread(async() =>
{
ProtocolPage protocolPage = new ProtocolPage(selectedProtocol);
protocolPage.Disappearing += (oo, ee) => Bind(); // rebind to pick up name changes
await Navigation.PushAsync(protocolPage);
});
}
);
}
else if (selectedAction == "Copy")
{
selectedProtocol.CopyAsync(true, true);
}
else if (selectedAction == "Share")
{
Action ShareSelectedProtocol = new Action(() =>
{
// make a deep copy of the selected protocol so we can reset it for sharing. don't reset the id of the protocol to keep
// it in the same study. also do not register the copy since we're just going to send it off.
selectedProtocol.CopyAsync(false, false, selectedProtocolCopy =>
{
// write protocol to file and share
string sharePath = SensusServiceHelper.Get().GetSharePath(".json");
selectedProtocolCopy.Save(sharePath);
SensusServiceHelper.Get().ShareFileAsync(sharePath, "Sensus Protocol: " + selectedProtocolCopy.Name, "application/json");
});
});
if (selectedProtocol.Shareable)
{
ShareSelectedProtocol();
}
else
{
ExecuteActionUponProtocolAuthentication(selectedProtocol, ShareSelectedProtocol);
}
}
else if (selectedAction == "Group")
{
SensusServiceHelper.Get().PromptForInputAsync("Group",
new ItemPickerPageInput("Select Protocols", groupableProtocols.Cast <object>().ToList(), "Name")
{
Multiselect = true
},
null, true, "Group", null, null, null, false,
input =>
{
if (input == null)
{
SensusServiceHelper.Get().FlashNotificationAsync("No protocols grouped.");
return;
}
ItemPickerPageInput itemPickerPageInput = input as ItemPickerPageInput;
List <Protocol> selectedProtocols = (itemPickerPageInput.Value as List <object>).Cast <Protocol>().ToList();
if (selectedProtocols.Count == 0)
{
SensusServiceHelper.Get().FlashNotificationAsync("No protocols grouped.");
}
else
{
selectedProtocol.GroupedProtocols.AddRange(selectedProtocols);
SensusServiceHelper.Get().FlashNotificationAsync("Grouped \"" + selectedProtocol.Name + "\" with " + selectedProtocols.Count + " other protocol" + (selectedProtocols.Count == 1 ? "" : "s") + ".");
}
});
}
else if (selectedAction == "Ungroup")
{
if (await DisplayAlert("Ungroup " + selectedProtocol.Name + "?", "This protocol is currently grouped with the following other protocols:" + Environment.NewLine + Environment.NewLine + string.Concat(selectedProtocol.GroupedProtocols.Select(protocol => protocol.Name + Environment.NewLine)), "Ungroup", "Cancel"))
{
selectedProtocol.GroupedProtocols.Clear();
}
}
else if (selectedAction == "Status")
{
if (SensusServiceHelper.Get().ProtocolShouldBeRunning(selectedProtocol))
{
await selectedProtocol.TestHealthAsync(true);
Device.BeginInvokeOnMainThread(async() =>
{
if (selectedProtocol.MostRecentReport == null)
{
await DisplayAlert("No Report", "Status check failed.", "OK");
}
else
{
await Navigation.PushAsync(new ViewTextLinesPage("Protocol Status", selectedProtocol.MostRecentReport.ToString().Split(new string[] { Environment.NewLine }, StringSplitOptions.RemoveEmptyEntries).ToList(), null, null));
}
});
}
else
{
await DisplayAlert("Protocol Not Running", "Cannot check status of protocol when protocol is not running.", "OK");
}
}
else if (selectedAction == "Delete")
{
if (await DisplayAlert("Delete " + selectedProtocol.Name + "?", "This action cannot be undone.", "Delete", "Cancel"))
{
selectedProtocol.DeleteAsync();
}
}
};
Content = _protocolsList;
ToolbarItems.Add(new ToolbarItem(null, "gear_wrench.png", async() =>
{
double shareDirectoryMB = SensusServiceHelper.GetDirectorySizeMB(SensusServiceHelper.SHARE_DIRECTORY);
string clearShareDirectoryAction = "Clear Share Directory (" + Math.Round(shareDirectoryMB, 1) + " MB)";
List <string> buttons = new string[] { "New Protocol", "View Log", "View Points of Interest", clearShareDirectoryAction }.ToList();
// stopping only makes sense on android, where we use a background service. on ios, there is no concept
// of stopping the app other than the user or system terminating the app.
#if __ANDROID__
buttons.Add("Stop Sensus");
#endif
buttons.Add("About Sensus");
string action = await DisplayActionSheet("Other Actions", "Back", null, buttons.ToArray());
if (action == "New Protocol")
{
Protocol.Create("New Protocol");
}
else if (action == "View Log")
{
await Navigation.PushAsync(new ViewTextLinesPage("Log", SensusServiceHelper.Get().Logger.Read(200, true),
() =>
{
string sharePath = null;
try
{
sharePath = SensusServiceHelper.Get().GetSharePath(".txt");
SensusServiceHelper.Get().Logger.CopyTo(sharePath);
}
catch (Exception)
{
sharePath = null;
}
if (sharePath != null)
{
SensusServiceHelper.Get().ShareFileAsync(sharePath, "Log: " + Path.GetFileName(sharePath), "text/plain");
}
},
() => SensusServiceHelper.Get().Logger.Clear()));
}
else if (action == "View Points of Interest")
{
await Navigation.PushAsync(new PointsOfInterestPage(SensusServiceHelper.Get().PointsOfInterest));
}
else if (action == clearShareDirectoryAction)
{
foreach (string sharePath in Directory.GetFiles(SensusServiceHelper.SHARE_DIRECTORY))
{
try
{
File.Delete(sharePath);
}
catch (Exception ex)
{
string errorMessage = "Failed to delete shared file \"" + Path.GetFileName(sharePath) + "\": " + ex.Message;
SensusServiceHelper.Get().FlashNotificationAsync(errorMessage);
SensusServiceHelper.Get().Logger.Log(errorMessage, LoggingLevel.Normal, GetType());
}
}
}
#if __ANDROID__
else if (action == "Stop Sensus" && await DisplayAlert("Confirm", "Are you sure you want to stop Sensus? This will end your participation in all studies.", "Stop Sensus", "Go Back"))
{
SensusServiceHelper.Get().StopProtocols();
(SensusServiceHelper.Get() as Android.IAndroidSensusServiceHelper)?.StopAndroidSensusService();
}
#endif
else if (action == "About Sensus")
{
await DisplayAlert("About Sensus", "Version: " + SensusServiceHelper.Get().Version, "OK");
}
}));
Bind();
System.Timers.Timer refreshTimer = new System.Timers.Timer(1000);
refreshTimer.Elapsed += (sender, e) =>
{
Refresh();
};
Appearing += (sender, e) =>
{
refreshTimer.Start();
};
Disappearing += (sender, e) =>
{
refreshTimer.Stop();
};
}
public ProtocolsPage()
{
Title = "Your Studies";
_protocolsList = new ListView(ListViewCachingStrategy.RecycleElement);
_protocolsList.ItemTemplate = new DataTemplate(typeof(TextCell));
_protocolsList.ItemTemplate.SetBinding(TextCell.TextProperty, nameof(Protocol.Caption));
_protocolsList.ItemTemplate.SetBinding(TextCell.DetailProperty, nameof(Protocol.SubCaption));
_protocolsList.ItemsSource = SensusServiceHelper.Get()?.RegisteredProtocols;
_protocolsList.ItemTapped += async(o, e) =>
{
if (_protocolsList.SelectedItem == null)
{
return;
}
Protocol selectedProtocol = _protocolsList.SelectedItem as Protocol;
#region add protocol actions
List <string> actions = new List <string>();
if (selectedProtocol.State == ProtocolState.Running)
{
actions.Add("Stop");
if (selectedProtocol.AllowPause)
{
actions.Add("Pause");
}
}
else if (selectedProtocol.State == ProtocolState.Stopped)
{
actions.Add("Start");
}
else if (selectedProtocol.State == ProtocolState.Paused)
{
actions.Add("Resume");
}
if (selectedProtocol.AllowTagging)
{
actions.Add("Tag Data");
}
if (selectedProtocol.State == ProtocolState.Stopped && selectedProtocol.AllowParticipantIdReset)
{
actions.Add("Reset ID");
}
if (!string.IsNullOrWhiteSpace(selectedProtocol.ContactEmail))
{
actions.Add("Email Study Manager for Help");
}
if (selectedProtocol.State == ProtocolState.Running && selectedProtocol.AllowViewStatus)
{
actions.Add("Status");
}
if (selectedProtocol.AllowViewData)
{
actions.Add("View Data");
}
if (selectedProtocol.State == ProtocolState.Running)
{
if (selectedProtocol.AllowSubmitData)
{
actions.Add("Submit Data");
}
if (selectedProtocol.AllowParticipationScanning)
{
actions.Add("Display Participation");
}
}
if (selectedProtocol.AllowParticipationScanning && (selectedProtocol.RemoteDataStore?.CanRetrieveWrittenData ?? false))
{
actions.Add("Scan Participation Barcode");
}
actions.Add("Edit");
if (selectedProtocol.AllowCopy)
{
actions.Add("Copy");
}
if (selectedProtocol.Shareable)
{
actions.Add("Share Protocol");
}
if (selectedProtocol.AllowLocalDataShare && (selectedProtocol.LocalDataStore?.HasDataToShare ?? false))
{
actions.Add("Share Local Data");
}
List <Protocol> groupableProtocols = SensusServiceHelper.Get().RegisteredProtocols.Where(registeredProtocol => registeredProtocol != selectedProtocol && registeredProtocol.Groupable && registeredProtocol.GroupedProtocols.Count == 0).ToList();
if (selectedProtocol.Groupable)
{
if (selectedProtocol.GroupedProtocols.Count == 0 && groupableProtocols.Count > 0)
{
actions.Add("Group");
}
else if (selectedProtocol.GroupedProtocols.Count > 0)
{
actions.Add("Ungroup");
}
}
if (selectedProtocol.State == ProtocolState.Stopped && selectedProtocol.StartIsScheduled)
{
actions.Remove("Start");
actions.Insert(0, "Cancel Scheduled Start");
}
if (selectedProtocol.State == ProtocolState.Running && selectedProtocol.AllowTestPushNotification)
{
actions.Add("Request Test Push Notification");
}
actions.Add("Delete");
#endregion
#region process selected protocol action
string selectedAction = await DisplayActionSheet(selectedProtocol.Name, "Cancel", null, actions.ToArray());
// must reset the protocol selection manually
_protocolsList.SelectedItem = null;
if (selectedAction == "Start")
{
await selectedProtocol.StartWithUserAgreementAsync();
}
else if (selectedAction == "Cancel Scheduled Start")
{
if (await DisplayAlert("Confirm Cancel", "Are you sure you want to cancel " + selectedProtocol.Name + "?", "Yes", "No"))
{
await selectedProtocol.CancelScheduledStartAsync();
}
}
else if (selectedAction == "Stop")
{
if (await DisplayAlert("Confirm Stop", "Are you sure you want to stop " + selectedProtocol.Name + "?", "Yes", "No"))
{
await selectedProtocol.StopAsync();
}
}
else if (selectedAction == "Pause")
{
await selectedProtocol.PauseAsync();
}
else if (selectedAction == "Resume")
{
await selectedProtocol.ResumeAsync();
}
else if (selectedAction == "Tag Data")
{
await Navigation.PushAsync(new TaggingPage(selectedProtocol));
}
else if (selectedAction == "Reset ID")
{
selectedProtocol.ParticipantId = null;
await SensusServiceHelper.Get().FlashNotificationAsync("Your ID has been reset.");
}
else if (selectedAction == "Status")
{
List <AnalyticsTrackedEvent> trackedEvents = await selectedProtocol.TestHealthAsync(true, CancellationToken.None);
await Navigation.PushAsync(new ViewTextLinesPage("Status", trackedEvents.SelectMany(trackedEvent =>
{
return(trackedEvent.Properties.Select(propertyValue => trackedEvent.Name + ": " + propertyValue.Key + "=" + propertyValue.Value));
}).ToList()));
}
else if (selectedAction == "Email Study Manager for Help")
{
await SensusServiceHelper.Get().SendEmailAsync(selectedProtocol.ContactEmail, "Help with Sensus study: " + selectedProtocol.Name,
"Hello - " + Environment.NewLine +
Environment.NewLine +
"I am having trouble with a Sensus study. The name of the study is \"" + selectedProtocol.Name + "\"." + Environment.NewLine +
Environment.NewLine +
"Here is why I am sending this email: ");
}
else if (selectedAction == "View Data")
{
await Navigation.PushAsync(new ProbesViewPage(selectedProtocol));
}
else if (selectedAction == "Submit Data")
{
try
{
if (await selectedProtocol.RemoteDataStore?.WriteLocalDataStoreAsync(CancellationToken.None))
{
await SensusServiceHelper.Get().FlashNotificationAsync("Data submitted.");
}
else
{
throw new Exception("Failed to submit data.");
}
}
catch (Exception ex)
{
await SensusServiceHelper.Get().FlashNotificationAsync("Error: " + ex.Message);
}
}
else if (selectedAction == "Display Participation")
{
CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();
// pop up wait screen while we submit the participation reward datum
IEnumerable <InputGroup> inputGroups = await SensusServiceHelper.Get().PromptForInputsAsync(
null,
new InputGroup[] { new InputGroup {
Name = "Please Wait", Inputs = { new LabelOnlyInput("Submitting participation information.", false) }
} },
cancellationTokenSource.Token,
false,
"Cancel",
null,
null,
null,
false,
async() =>
{
ParticipationRewardDatum participationRewardDatum = new ParticipationRewardDatum(DateTimeOffset.UtcNow, selectedProtocol.Participation)
{
ProtocolId = selectedProtocol.Id,
ParticipantId = selectedProtocol.ParticipantId
};
bool writeFailed = false;
try
{
await selectedProtocol.RemoteDataStore.WriteDatumAsync(participationRewardDatum, cancellationTokenSource.Token);
}
catch (Exception)
{
writeFailed = true;
}
if (writeFailed)
{
await SensusServiceHelper.Get().FlashNotificationAsync("Failed to submit participation information to remote server. You will not be able to verify your participation at this time.");
}
// cancel the token to close the input above, but only if the token hasn't already been canceled.
if (!cancellationTokenSource.IsCancellationRequested)
{
cancellationTokenSource.Cancel();
}
await SensusContext.Current.MainThreadSynchronizer.ExecuteThreadSafe(async() =>
{
// only show the QR code for the reward datum if the datum was written to the remote data store and if the data store can retrieve it.
await Navigation.PushAsync(new ParticipationReportPage(selectedProtocol, participationRewardDatum, !writeFailed && (selectedProtocol.RemoteDataStore?.CanRetrieveWrittenData ?? false)));
});
});
// if the prompt was closed by the user instead of the cancellation token, cancel the token in order
// to cancel the remote data store write. if the prompt was closed by the termination of the remote
// data store write (i.e., by the canceled token), then don't cancel the token again.
if (!cancellationTokenSource.IsCancellationRequested)
{
cancellationTokenSource.Cancel();
}
}
else if (selectedAction == "Scan Participation Barcode")
{
try
{
string barcodeResult = await SensusServiceHelper.Get().ScanQrCodeAsync(QrCodePrefix.SENSUS_PARTICIPATION);
if (barcodeResult == null)
{
return;
}
await SensusContext.Current.MainThreadSynchronizer.ExecuteThreadSafe(async() =>
{
CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();
// pop up wait screen while we get the participation reward datum
IEnumerable <InputGroup> inputGroups = await SensusServiceHelper.Get().PromptForInputsAsync(
null,
new InputGroup[] { new InputGroup {
Name = "Please Wait", Inputs = { new LabelOnlyInput("Retrieving participation information.", false) }
} },
cancellationTokenSource.Token,
false,
"Cancel",
null,
null,
null,
false,
async() =>
{
// after the page shows up, attempt to retrieve the participation reward datum.
try
{
ParticipationRewardDatum participationRewardDatum = await selectedProtocol.RemoteDataStore.GetDatumAsync <ParticipationRewardDatum>(barcodeResult, cancellationTokenSource.Token);
// cancel the token to close the input above, but only if the token hasn't already been canceled by the user.
if (!cancellationTokenSource.IsCancellationRequested)
{
cancellationTokenSource.Cancel();
}
// ensure that the participation datum has not expired
if (participationRewardDatum.Timestamp > DateTimeOffset.UtcNow.AddSeconds(-SensusServiceHelper.PARTICIPATION_VERIFICATION_TIMEOUT_SECONDS))
{
await SensusContext.Current.MainThreadSynchronizer.ExecuteThreadSafe(async() =>
{
await Navigation.PushAsync(new VerifiedParticipationPage(selectedProtocol, participationRewardDatum));
});
}
else
{
await SensusServiceHelper.Get().FlashNotificationAsync("Participation barcode has expired. The participant needs to regenerate the barcode.");
}
}
catch (Exception)
{
await SensusServiceHelper.Get().FlashNotificationAsync("Failed to retrieve participation information.");
}
finally
{
// cancel the token to close the input above, but only if the token hasn't already been canceled by the user. this will be
// used if an exception is thrown while getting the participation reward datum.
if (!cancellationTokenSource.IsCancellationRequested)
{
cancellationTokenSource.Cancel();
}
}
});
// if the prompt was closed by the user instead of the cancellation token, cancel the token in order
// to cancel the datum retrieval. if the prompt was closed by the termination of the remote
// data store get (i.e., by the canceled token), then don't cancel the token again.
if (!cancellationTokenSource.IsCancellationRequested)
{
cancellationTokenSource.Cancel();
}
});
}
catch (Exception ex)
{
string message = "Failed to scan barcode: " + ex.Message;
SensusServiceHelper.Get().Logger.Log(message, LoggingLevel.Normal, GetType());
await SensusServiceHelper.Get().FlashNotificationAsync(message);
}
}
else if (selectedAction == "Edit")
{
if (await AuthenticateProtocolAsync(selectedProtocol))
{
await SensusContext.Current.MainThreadSynchronizer.ExecuteThreadSafe(async() =>
{
ProtocolPage protocolPage = new ProtocolPage(selectedProtocol);
await Navigation.PushAsync(protocolPage);
});
}
}
else if (selectedAction == "Copy")
{
// reset the protocol id, as we're creating a new study
await selectedProtocol.CopyAsync(true, true);
}
else if (selectedAction == "Share Protocol")
{
await selectedProtocol.ShareAsync();
}
else if (selectedAction == "Share Local Data")
{
await selectedProtocol.LocalDataStore?.ShareLocalDataAsync();
}
else if (selectedAction == "Group")
{
Input input = await SensusServiceHelper.Get().PromptForInputAsync("Group", new ItemPickerPageInput("Select Protocols", groupableProtocols.Cast <object>().ToList(), textBindingPropertyPath: nameof(Protocol.Name))
{
Multiselect = true
}, null, true, "Group", null, null, null, false);
if (input == null)
{
await SensusServiceHelper.Get().FlashNotificationAsync("No protocols grouped.");
return;
}
ItemPickerPageInput itemPickerPageInput = input as ItemPickerPageInput;
List <Protocol> selectedProtocols = (itemPickerPageInput.Value as List <object>).Cast <Protocol>().ToList();
if (selectedProtocols.Count == 0)
{
await SensusServiceHelper.Get().FlashNotificationAsync("No protocols grouped.");
}
else
{
selectedProtocol.GroupedProtocols.AddRange(selectedProtocols);
await SensusServiceHelper.Get().FlashNotificationAsync("Grouped \"" + selectedProtocol.Name + "\" with " + selectedProtocols.Count + " other protocol" + (selectedProtocols.Count == 1 ? "" : "s") + ".");
}
}
else if (selectedAction == "Ungroup")
{
if (await DisplayAlert("Ungroup " + selectedProtocol.Name + "?", "This protocol is currently grouped with the following other protocols:" + Environment.NewLine + Environment.NewLine + string.Concat(selectedProtocol.GroupedProtocols.Select(protocol => protocol.Name + Environment.NewLine)), "Ungroup", "Cancel"))
{
selectedProtocol.GroupedProtocols.Clear();
}
}
else if (selectedAction == "Request Test Push Notification")
{
try
{
PushNotificationRequest request = new PushNotificationRequest(SensusServiceHelper.Get().DeviceId + ".test", SensusServiceHelper.Get().DeviceId, selectedProtocol, "Test", "Your test push notification has been delivered.", "default", PushNotificationRequest.LocalFormat, DateTimeOffset.UtcNow, Guid.NewGuid());
await SensusContext.Current.Notifier.SendPushNotificationRequestAsync(request, CancellationToken.None);
await DisplayAlert("Pending", "Your test push notification was sent and is pending delivery. It should come back within 5 minutes.", "OK");
}
catch (Exception ex)
{
await DisplayAlert("Error", "Failed to send test push notification: " + ex.Message, "OK");
}
}
else if (selectedAction == "Delete")
{
if (await DisplayAlert("Delete " + selectedProtocol.Name + "?", "This action cannot be undone.", "Delete", "Cancel"))
{
await selectedProtocol.DeleteAsync();
}
}
#endregion
};
Content = _protocolsList;
#region add toolbar items
ToolbarItems.Add(new ToolbarItem(null, "plus.png", async() =>
{
string action = await DisplayActionSheet("Add Study", "Back", null, new[] { "From QR Code", "From URL", "New" });
if (action == "New")
{
await Protocol.CreateAsync("New Study");
}
else
{
string url = null;
if (action == "From QR Code")
{
url = await SensusServiceHelper.Get().ScanQrCodeAsync(QrCodePrefix.SENSUS_PROTOCOL);
}
else if (action == "From URL")
{
Input input = await SensusServiceHelper.Get().PromptForInputAsync("Download Study", new SingleLineTextInput("Study URL:", Keyboard.Url), null, true, null, null, null, null, false);
// input might be null (user cancelled), or the value might be null (blank input submitted)
url = input?.Value?.ToString();
}
if (url != null)
{
Protocol protocol = null;
Exception loadException = null;
// handle managed studies...handshake with authentication service.
if (url.StartsWith(Protocol.MANAGED_URL_STRING))
{
ProgressPage loadProgressPage = null;
try
{
Tuple <string, string> baseUrlParticipantId = ParseManagedProtocolURL(url);
AuthenticationService authenticationService = new AuthenticationService(baseUrlParticipantId.Item1);
// get account and credentials. this can take a while, so show the user something fun to look at.
CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();
loadProgressPage = new ProgressPage("Configuring study. Please wait...", cancellationTokenSource);
await loadProgressPage.DisplayAsync(Navigation);
await loadProgressPage.SetProgressAsync(0, "creating account");
Account account = await authenticationService.CreateAccountAsync(baseUrlParticipantId.Item2);
cancellationTokenSource.Token.ThrowIfCancellationRequested();
await loadProgressPage.SetProgressAsync(0.3, "getting credentials");
AmazonS3Credentials credentials = await authenticationService.GetCredentialsAsync();
cancellationTokenSource.Token.ThrowIfCancellationRequested();
await loadProgressPage.SetProgressAsync(0.6, "downloading study");
protocol = await Protocol.DeserializeAsync(new Uri(credentials.ProtocolURL), true, credentials);
await loadProgressPage.SetProgressAsync(1, null);
// don't throw for cancellation here as doing so will leave the protocol partially configured. if
// the download succeeds, ensure that the properties get set below before throwing any exceptions.
protocol.ParticipantId = account.ParticipantId;
protocol.AuthenticationService = authenticationService;
// make sure protocol has the id that we expect
if (protocol.Id != credentials.ProtocolId)
{
throw new Exception("The identifier of the study does not match that of the credentials.");
}
}
catch (Exception ex)
{
loadException = ex;
}
finally
{
// ensure the progress page is closed
await(loadProgressPage?.CloseAsync() ?? Task.CompletedTask);
}
}
// handle unmanaged studies...direct download from URL.
else
{
try
{
protocol = await Protocol.DeserializeAsync(new Uri(url), true);
}
catch (Exception ex)
{
loadException = ex;
}
}
// show load exception to user
if (loadException != null)
{
await SensusServiceHelper.Get().FlashNotificationAsync("Failed to get study: " + loadException.Message);
protocol = null;
}
// start protocol if we have one
if (protocol != null)
{
// save app state to hang on to protocol, authentication information, etc.
await SensusServiceHelper.Get().SaveAsync();
// show the protocol to the user and start
await Protocol.DisplayAndStartAsync(protocol);
}
}
}
}));
ToolbarItems.Add(new ToolbarItem("ID", null, async() =>
{
await DisplayAlert("Device ID", SensusServiceHelper.Get().DeviceId, "Close");
}, ToolbarItemOrder.Secondary));
ToolbarItems.Add(new ToolbarItem("Log", null, async() =>
{
Logger logger = SensusServiceHelper.Get().Logger as Logger;
await Navigation.PushAsync(new ViewTextLinesPage("Log", logger.Read(500, true), logger.Clear));
}, ToolbarItemOrder.Secondary));
#if __ANDROID__
ToolbarItems.Add(new ToolbarItem("Stop", null, async() =>
{
if (await DisplayAlert("Confirm", "Are you sure you want to stop Sensus? This will end your participation in all studies.", "Stop Sensus", "Go Back"))
{
// stop all protocols and then stop the service. stopping the service alone does not stop
// the service, as we want to cover the case when the os stops/destroys the service. in this
// case we do not want to mark the protocols as stopped, as we'd like them to start back
// up when the os (or a push notification) starts the service again.
await SensusServiceHelper.Get().StopAsync();
global::Android.App.Application.Context.StopService(AndroidSensusService.GetServiceIntent(false));
}
}, ToolbarItemOrder.Secondary));
#endif
ToolbarItems.Add(new ToolbarItem("About", null, async() =>
{
await DisplayAlert("About Sensus", "Version: " + SensusServiceHelper.Get().Version, "OK");
}, ToolbarItemOrder.Secondary));
#endregion
}
