Central Participant Database/sl

Predstavitev

To access this feature: Configuration -> Central Participant Database:

Ta nova funkcija omogoča uporabniku anketnega sistema shranjevanje informacij o anketirancih v osrednjo tabelo, ki je neodvisna od katere koli tabele žetonov. Glavne prednosti tega so:

• Osrednja tabela deluje kot varnostna kopija anketirancev. Tako uporabnik, ki ustvari novo anketo za enake anketirance, ne rabi več skozi težave pri izvažanju anketirancev v CSV datoteko in jih potem uvažati nazaj v novo anketo.
• Uporabniki bodo morali le dodati anketirance v osrednjo tabelo in potem bodo lahko te anketirance dodali v nove ankete, kolikor bodo želeli.
• V primeru večjega števila skrbnikov se lastnik posameznega seznama anketirancev lahko odloči za deljenje njegovih anketirancev z drugimi in prav tako lahko določi pravice dostopa do njih.

Skupaj s tem je na voljo napredna kontrola atributov in še nekaj drugih funkcij.

Plošča z orodji za upravljanje anketirancev

The following options are available:

• Display CPDB (Central Participant Database) participants
• Info
• Import
• Blacklist settings
• Attributes
• Share panel
• Export all participants

Prikaz anketirancev

To je glavni del plošče za anketirance. Tukaj lahko opravite večino dela kot je dodajanje, brisanje in izvažanje anketirancev, dodajanje anketirancev v ankete itd.

Opis možnosti iz zaslonske slike:

• Edit this participant
• Delete this participant
• Share this participant
• List active surveys
• Add participant to survey

Before accessing the options mentioned above, you must have users listed in your database. To create them, click the Add new participant button, located in the upper-right part of the window.

Dodajanje anketiranca

Z lahkoto lahko dodate posameznega anketiranca s klikom na znak v obliki plusa v vrstici pod tabelo. Za urejanje že dodanega anketiranca lahko enostavno dvokliknete anketiranca in po zaključenem urejanju uporabite gumb "Enter" ter tako shranete vse narejene spremembe.

A dialog box with the following basic attributes will then appear:

• First name
• Last name
• E-mail
• Blacklist user
• Owner: Any user of LimeSurvey defined in the user control management page can be an owner.

Custom attributes can be added. For further details, see the attributes and examples sections.

Edit participant

To edit the basic and/or custom attributes of a participant, click the first button (from left to right) located in the Action column (). A window with all the available attributes will be displayed.

Enostavno označite posameznega anketiranca, ki ga želite odstraniti ali izberite vse anketirance v tabeli. Na voljo so trije načini brisanja anketiranca.

When you delete the participant(s), three options are available to you:

1. Izbriši anketiranca(e) le iz osrednje tabele anketirancev

2. Izbriši anketiranca(e) iz osrednje tabele anketirancev in tabele žetonov

3. Izbriši anketiranca(e) iz osrednje tabele anketirancev, tabele žetonov in vseh povezanih odzivov

Pri uporabi vseh treh možnosti se izbrišejo tudi vse povezave, ki so bile narejene z namenom vzdrževanja poročila o delu anketiranca.

Ponovno naloži tabelo

This is another important feature of the Central Participant Database. You can share your participants with other users. You just have to select the participant(s) you want to share and click either the green right-arrow icon () or the Selected participant(s)... button located in the bottom left part of the participants table. A modal box will open which will allow you to select the user with whom you want to share the respective participant(s). You can also set whether the user who shares your participant can edit those participants. If you set it to No, they will get an access denied error when trying to edit the entries of the shared participant.

Ponovno naloži in prikaže osvežen seznam anketirancev iz strežnika.

If you click the next icon (), all the active surveys where the respective participant has been added to will be listed.

Izvozi v datoteko CSV

Adding a participant to a survey can be done by clicking the last icon () from the Action column. If you wish to add more than one participant to a survey, mark them and select the Share option from the Selected participant(s)... dialog box (located in the bottom-left part of the central table).

Please note that if you wish to add participants from the central database to a survey, the respective survey needs to contain a survey participants table! For further details, please continue reading the following wiki section.

The title of the dialog box will show you the number of participants that are going to be added to the respective survey. Besides that, there is also a checkbox, that if checked, it will take you to the survey participants table of the survey to which you are adding the participants to.

After clicking 'Next', you will be taken to the attribute map page.

The attribute map page contains four tables and uses an advanced drag-and-drop functionality:

• The first table, Unmapped participant attributes, shows all the attributes that are present in the central participant database. They are currently unmapped - not present in the survey participants table. These unmapped attributes can either be moved into the Token attributes to create table which creates new attributes in the survey participants table or they can be merged with the existing token attributes by dragging the unmapped attributes into the Existing token attributes table, besides the existing token attribute you wish to be merged with.

• The second table, Token attributes to create, helps you copy unmapped participant attributes into the survey participants table, creating new columns. Drag the attribute(s) you wish to add to the survey participants table and drop them into the second table. In this way, new columns/attributes will be added to the survey participants table.

• The third table, Existing token attributes, displays the current attributes existing in the survey participants table. Drop the unmapped attributes here if you wish to copy the data from the unmapped attributes into the one of the existing token attributes (see screenshot below)

• The fourth table, the Standard token fields, displays the standard token fields that can be merged with unmapped participant attributes. The only standard token field from a survey participants table that can be edited is the Token one. This is important when you wish, for example, to easily copy token codes across different LimeSurvey installations.

You can also overwrite the existing token attribute values from the survey participants table if a participant already exists. Use this option cautiously in order not to lose any important data on survey respondents.

After you have mapped all the attributes, you can click Continue. After processing the participants, a summary page will be displayed, telling you how many participants were successfully copied. If you have previously asked for redirection, you will be redirected to the survey participants table, otherwise you will be redirected to the CPDB main page.

Informacija

To okno prikaže statistiko osrednje zbirke podatkov o anketirancih. Prikaže vam povzetek o

1. Številu vseh anketirancev v osrednji tabeli

2. Številu anketirancev, ki so v vaši lasti

3. Številu anketirancev, ki so v skupni rabi z vami

4. Številu anketirancev, ki ste jih vi dali v skupno rabo

5. Številu anketirancev, ki so v seznamu črne liste

6. Številu atributov v osrednji tabeli

Z uporabo spustnega seznama lahko izberete število prikazanih vnosov in z uporabo navigacijskih gumbov lahko prehajate med zaporednimi stranmi ali pa prikažete določeno stran. Vedite, da se bo število strani zmanjšalo, če povečate število prikazov na eni strani. Prav tako iskanje in urejanje tabele ni odvisno od vidnih zapisov v tabeli v določenem času, pač pa se to naredi nad celotno osrednjo tabelo anketirancev.

If you wish to add participants via the import function, click the Import button that is located on the main toolbar of the Central participant database page:

The following options are available:

Steps to import

1) Select a file to import and specify the settings associated with it.

2) Map the attributes from the CSV file. Import the attribute data either into an existing attribute from the central participant database or into a new column by creating a new attribute. The newly created attribute will be of text box type - the format can be changed later.

In the screenshot from above, a new attribute called "New Age" will be created. The data from attribute "Sex" was mapped and copied into the existent "Sex" attribute from the central participant database.

3) Click continue, and wait for the process to be done. At the end, a short summary will be displayed.

Clicking OK will redirect you to the participants screen, showing you the newly imported participants.

Navigacijska vrstica

The Blacklist settings button is available on the main toolbar of the Central participant database page. Once you click it, the following page will be displayed.

The following Yes/No options are available:

• Blacklist all current surveys for participant once the global field is set: If set to Yes, the blacklisted participant(s) cannot be added to any survey.
• Blacklist participant for any new added survey once the global field is set: If new surveys are created, the respective participant(s) cannot be added to them (if Yes is picked up). However, they can still be added to those surveys created earlier.
• Allow blacklisted participants to be added to a survey: Even if a participant is blacklisted, they can still be added to a survey.
• Hide blacklisted participants: Useful function when you would like to hide participant for a specific amount of time and then make them available for the rest of users with whom those blacklisted participants have been shared with.
• Delete globally blacklisted participants from the database: If Yes, the blacklisted participants will be deleted from the database.
• Allow participant to un-blacklist himself/herself: If Yes, participants can un-blacklist themselves without the help of a LimeSurvey user.

Attributes

To access the Attributes management panel, click the Attributes button located on the main toolbar of CPDB main page:

The attribute management facilitates the addition of three types of attributes: text box, date, and drop-down list. To add a new attribute, click tAdd new attribute located in the upper-right part of the window:

When adding a new attribute, the following options are available:

• Defaultname: It will be used by LimeSurvey to name the attribute in case no other English name is provided.
• Attribute type: You can choose either of the attribute types and the associated user interface will be presented to you while editing.
• Should this attribute be visible on the panel?: It can be Yes or No. This function determines whether the attribute is visible in the CPDB table or not. This can be later edited from the Visible column that is located in the main attributes table.
• Languages: If you would like LimeSurvey not to use the defaultname as the name of the attribute, type here the desired name. Please note that the attribute management has multilingual support. Click on the plus sign after you have selected the language. A new field will appear below the English/default language.

Once the changes are done, click Save.

We recommend tha you write the name of the attribute in the corresponding language box even if you use only one language (the base language). The reason for this is that when you map attributes and you wish to add them to different survey participants table, the defaultname of the attribute is not displayed in the respective panel - only the name you give in the corresponding language box is shown.

In the attributes table, two actions are available (see the Action column):

If you click the first icon, a dialog box will be displayed. It includes the basic settings of the selected attribute that can be edited according to your needs.

To delete an attribute from the table, click on the red trash button, located next to the edit button. Clicking the delete button will not only delete the attribute, but also the associated values from the CPDB.

Share panel

The share panel shows all the information related to the shared participants. Please note that this panel shows only the shared participants owned by that particular user.

This panel shows values like:

1) Last name

2) First name

3) Email address

4) Shared by

5) Owner

6) Date added

7) Can edit?

This information is for viewing/sorting purposes. Only the Can Edit field is editable for the user. The Can edit field allows you to determine whether to allow the respective participant to be editable by the user with whom that participant was shared with or not. Clicking on the check box will make an AJAX call and save the changes on the server.

Export participants

Kadar izvažate v datoteko CSV, se vam prikaže okno, v katerem je potrebno označiti dodatne atribute, ki jih želite izvoziti. Na voljo imate tudi možnost filtriranja atributov. Prikazani bodo vsi atributi, ki so na voljo v osrednji tabeli (vidni/nevidni).

When exporting to CSV, you are presented with a dialog box that asks you to mark the attributes you wish to export.

Možnost izvoza v datoteko CSV deluje v dveh načinih:

• None of the additional attributes

• All the additional attributes

• Certain additional attributes

Podatki bodo izvoženi v datoteko z imenom central_'trenutni časovni žig'.csv .

Export filtered participants

To export filtered participants, use first the search filters. Then. click the checkbox located on the left side of the Action column (to select all the filtered participants). Then, click the Selected participant(s)... button located at the bottom-right side of the table and select the export function. In this way, only the filtered participants will be exported.

Napredno iskanje

If you wish to filter the users from your database, use the search/dropdown boxes located below each column title:

Enter information in the search fields or select from the dropdown lists (when possible) the participants you want to be listed after the filtering process.

Additional information

Additional (technical) information is available in the Central participants database (User panel) Development wiki.