Property Documentation

accountConfiguration : QVariantMap

This property holds the account configuration settings which will be associated with the account to be created.

The configuration consists of a map of service names to settings map. The global account configuration settings are associated with the empty service name.

For example, to add some new keys to the current configuration:

 // Get the current account configuration
 QVariantMap config = accountProvisioner.accountConfiguration();

 // Amend the current global configuration
 QVariantMap globalConfig = config.value(QString()).toMap();     // global configuration is identified by an empty service name
 globalConfig.insert(QStringLiteral("created_by_mdm"), true);
 config.insert(QString(), globalConfig);

 // Amend the current email configuration
 QVariantMap emailConfig = config.value(QStringLiteral("email").toMap();
 emailConfig.insert(QStringLiteral("signature"), QStringLiteral("Sent by my Sailfish OS device"));
 config.insert(QStringLiteral("email"), emailConfig);

 // Update the account configuration
 accountProvisioner.setAccountConfiguration(config);

Access functions:

Notifier signal:

accountDisplayName : QString

This property holds the display name of the account to be provisioned.

Access functions:

Notifier signal:

accountLimited : bool

This property holds true if the account is in limited mode.

Only the password of such accounts can be set outside MDM API.

The default value of this setting for accounts is false.

Access functions:

Notifier signal:

accountReadOnly : bool

This property holds true if the account is in read-only mode.

Such accounts may only be edited or deleted via MDM API.

The default value of this setting is false.

Access functions:

Notifier signal:

canCreateAccount : const bool

This property holds true if enough settings have been provided for account creation to succeed.

Access functions:

Notifier signal:

lastTransactionUuid : const QString

This property holds the UUID of the last queued transaction or an empty string.

When queued transaction is made (i.e. user is not 0 and they are not logged in), this contains universally unique identifier (UUID) of that transaction. It is valid until the next queued transaction happens. If queued transaction fails or none has been made, this is an empty string.

Access functions:

Notifier signal:

providerName : QString

This property holds name of the provider of the account to be provisioned.

Every account is provided by a specific provider, which is identified by the provider name. In order to create an account, a valid provider name must be set.

Providers are installed by accounts framework extension plugins.

Access functions:

Notifier signal:

queuedTransactionUsed : const bool

This property holds whether last operation used queued transaction.

This is true if the last operation stored queued transaction. It must be checked if user is not 0 and the operation supports queued transactions. The value is valid until next operation.

This is true even if queued transaction failed and nothing was stored.

Access functions:

Notifier signal:

user : int

This property holds user's UID or 0 if not specified.

When account change is directed to Unix user on device, this must be used to specify user identifier (UID). If the user is not currently logged in, the transaction is queued and run once user logs in next time. Note that this is not available on all interfaces.

This does not check if the user exists. It is caller's responsibility to check which users exist on device. It can be also used for users that have not been created yet.

Access functions:

Notifier signal: