Infsoft.WPE.App.Services 0.11.17

Workplace Experience (WPE) Services library

This library provides the interfaces of all publicly available services, which can be used in an app implementation.

Services

• IRequestCache Provides an interface for the delegating handler CachingHandler to cache requests.
• ISettingsService Provides access to settings synced across platforms.
• ISettingsProvider Provides access to global app settings like language.
• INavBarChildContent Provides the possibility to set a renderFragemnt as child content in the minimal navBar.
• ITimeZoneService Provides the timeZone information based on subscriptions.
• IAnalyticsService Allows the application to track analytics events.
• INotificationActionService Allows to respond to push notifications.
• INotificationsApi Allows to query or update the handled state of notifications.
• ITermsAndConditionsService Allows to query whether a user has accepted a specific terms and conditions entry.
• IToastService Provides an interface to show toast notifications with configurable content, style, and behavior.
• IDialogService Provides an interface to show dialogs with customizable titles, messages, buttons, and display options.

Delegating handlers

Additionally two delegating handlers are defined.

These serve to use the caching service via CachingHandler and add common headers to every request DefaultHeadersHandler.

Examples

IToastService

var config = ToastConfig.WithTitle("Data Saved")
    .WithSubTitle("Your changes were successfully stored.") // Optional: subtitle text
    .WithIcon("check-circle-36")                            // Optional: icon name or URL
    .WithCloseButton(true)                                  // Optional: show close button
    .CloseAfter(3000)                                       // Optional: auto-close after milliseconds
    .WithAlignment(ToastConfigAlignment.TopRight)           // Optional: position on screen
    .WithColor(ToastConfigColor.Green);                     // Optional: predefined color
    // .WithCustomColor("#00FF99")                          // Optional: use custom HEX instead
    // .NotSelfClosing()                                    // Optional: require manual close

ToastService.Show(config);

IDialogService

var buttons = new List<DialogOptionsButton>
{
    DialogOptionsButton.WithText("Submit")
        .OnClicked(() => DeleteBooking(lockerItem.Item1, lockerItem.Item2))
        .AsPrimary(),

    DialogOptionsButton.WithText("Cancel")
        .AsSecondary()
};

// Create a dialog configuration using the fluent API
var config = DialogOptions.WithTitle("Open locker")
    .WithDescription("Are you sure you want to open this locker?")  // Optional: add one or more message lines
    .WithIcon("delete-36")                                          // Optional: icon name or URL
    .WithButtons(buttons)                                           // Optional: custom button list
    .DisableBackgroundClose();                                      // Optional: disable closing by clicking outside

DialogService.Show(config);