Project configuration

You get there by tapping on the tools button in the project list besides the project name.

This is what the project configuration normally looks like, if you own admin rights for a project:

Via the project configuration you obtain a range of options:

Rename project (1)

In the topmost row of the project configuration the current name of the project is shown. Tapping on the name lets you change the name of the project. The project name is local to your device, i.e. the project can be named differently on each device. It is not synced to other devices.

Change your nickname (2)

the second row shows your nickname currently used in conjunction with this project, i.e. this nickname will show up beneath the change in the log if you change a record. Tap the nickname to change it to another one of your registered nicknames. (Register nicknames under Device settings / Nicknames if you want to register further nicknames.

Changes only apply to future changes! The old nickname stays connected to all of your old changes, the old nickname stays visible in the project's user list (for all users with admin rights). Change the default nickname (in device settings) to the desired one before you create or first replicate with a project, if you want to avoid appearing under other names.

Users (3)

If you share the project with others this list shows the nicknames of all users registered in this project.

Users new to the project need to be approved first. You can identify users that need to be approved by the "info"-icon on the right side of the list. Entries for users to be approved are created the first time the user tries to replicate/sync the project. Approve the user by tapping the info-icon. As long as a user is not approved, the user will see the text "Ao are not yet approved for this project" in his project list and his project configuration will only contain the elements 1 (Project name), 2 (Nickname), 7 (Replication) and 12 (Delete project)

If you tap on a previously approved user, the list of available roles in this project will be shown. Choose, which roles this user belongs to within this project. If the list is empty, create roles for this project first (see below).

As a project admin you can remove a user from a project by swiping left over the user's entry. The user's approval for this project is then removed and will (after his next project sync) see the same message as if he had never been approved. The user entry will then show up as not approved again. You cannot delete your currently active nickname and the project owner's nickname.

Roles (4)

This option is like the above options only of interest, if you share the project with others. If you want different users to see different views you can create and maintain different roles for the project's users.

Roles can be "normal" or "admin" roles. The owner of a project is admin by definition. Other users are admins if they are member of at least one admin role. If a user is not an admin the project configuration will only contain the options regarding the user's own device (these are 1 (Project name), 2 (Nickname), 7 (Replications), 8 (Notifications), 9 (Share), 10 (Backup), 11 (Templates) und 12 (Delete project))

Delete roles by swiping left over the role's name.

BEWARE: As long as a project has no defained roles every user of the project automatically is an admin!

Types (5)

This option lets you configure the project's record types.

Refer to Configuring types

Views (6)

Allows to configure the project's views.

Refer to Configuring viewsn

Replications (7)

Shows the list of currently configured replications for this project. Each entry stands for a replication to a remote server, synchronizing the database to that server. The icon on the right side shows the state of the replication. Tapping on an entry lets you de-/activate or configure the replication. The configuration comprehends the following options:

Notifications (8)

Project-wide settings - Notification modes

This defines the way, other users in a shared project (a project with at least 1 replication) get notified about changes.

It's particularity of SketShDb that you are in full control of your data because the data is only synchronized with the servers YOU configure (not with our or any other servers, if you don't configure it.) When using push notifications (as opposed to local notifications) it is technically impossible to deliver notifications without completely revealing the submitted data to anyone else. Local notifications in turn can only be delivered when the app is active at least in background. Then the synchronization takes place via "background fetch", that means the app gets "woken up" at irregular time intervals and performs pending synchronizations. If changes occurred, a notification will be shown. The time intervals are controlled by the operating system. There are some hybrid modes between local and full-featured push notifications. We leave the decision to you which mode you prefer for which project.

The different notification modes and their menaing are:

Some further notes:

Depending on the notification mode different data will be delivered to our and/or the service provider's notification service. You can find a detailed explanation on this page: Privacy

Device specific settings

These settings define, which events you will get notified about. Events you trigger by yourself you will not be informed, so these settings are only of interest if your project is shared among multiple users.

Note: Regarding mode 3 (Inform about changed data unspecifically), you will get NO notifcations for this project if you disable ALL notification types. If you enable at least one type, you will get ALL notifications. This happens because with this mode we don't even store on our side which notification types you're interested in and cannot distinguish between the types. See above for further explanation.

The settings don't apply to the Log! There you can always see ALL changes made to the projects unless you deleted the respective log entry.

Share (9)

If you synchronize a project wit a server, you can send the server address and if you want server credentials in a simple way via email to a friend. Once your friend has tapped the link in the email, you can start to use the project together.

Before you can send the e-mail, you will be asked if you want to include credentials for the server access into the link.

NOTE: The credentials will be included encrypted into the e-mail. The link will nevertheless contain the server address, username AND password, and therefore any unauthorized person with access to our app and this e-mail would be able to access the server even if not able to read the data personally. It is by far safer to send the credentials on a different, more secure way than e-mail. NEVER include credentials into the link if your project contains confidential data or data which could be harmful to anyone when lost or diclosed!

There are different options for including or not include credentials into the share mail:

The server credentials are only used to access the replication server, not any further.

No data (neither server name, nor username or password) will be included into the e-mail text in plain, readable text (except the project name). All other data is encoded into the link. Username and password are encoded and encrypted.

Sharing database links via email only works if there is a properly configured e-mail account present on the device. However, replication with shared servers will work regardless of any email configuration.

Create a backup (10)

By using this option a backup file containing the entire project will be created on your "iCloud Drive"1. The device's main iCloud account will be used. The backed up data is NOT encrypted in any way! Therefore keep backup files in a safe place. Because the backup is stored on your iCloud Drive, you will be able to access the backup file from any device using the same account. Backups are stored in folder "SketShDb/Backups".

An iCloud account must be properly configured on the device to be able to create backup files.

Create a template (11)

This options creates a template derived from the current project, i.e. all types, views and roles together with their settings are exported. You will first be asked if you want to embed data of one or more types to the template, whih makes sense if you have base types that belong to the project structure and/or are sort of "universal".

Choose the types to be stored with the template, then tap Save in the top right corner.

The template will be saved to your iCloud Drive. Therefore you can access your templates from any of your devices using the same iCloud account. The template file is not encrypted. It is stored into the folder "SketShDb/Template".

An iCloud account must be properly configured on the device to be able to create templates.

Note: Sometimes files created on a device are not visible on other devices using the same iCloud account. This is an issue of how iCloud Drive works and is not under our influence. You can, nevertheless, force iCloud Drive to update the folder contents be creating a new subfolder inside the folder and deleting it again. This is not possible from inside our app, but you can use the default iCloud app ("Files" or "iCloud Drive") for it.

Delete project (12)

By tapping this button you can delete the project including all its data and replications from the device. The project will NOT be deleted from the server! If you want to delete the project/database from your server you have to use the server administration features, because it is not posiible from within the app.

  1. "Apple", "iCloud" und "iCloud Drive" are trademarks of Apple Inc.