When to check files in and out

The rules for checking files in and out can vary between and within companies, depending on the number of people involved in a project's development, so it is hard to give rules about when to check files in and out. This topic suggests some ways of making it easier to understand the process.

If you are worried about losing work, remember that all the time you have a project locked, very few of the project files are available to any user who does not have administrative privileges. However, do not keep a project locked indefinitely as this can be counterproductive.

When you work on a project, you always work on files in your personal User folder. Activities such as Build, that create questionnaires, look for files in your User folder first, and open those files if they exist. If an activity cannot find the files that it needs in your User folder, it looks for them in the Shared folder. If the activity finds the files it wants in the Shared folder, it copies them into your User folder and opens them. If the files are not in your User folder or the Shared folder, the activity creates a new file in your User folder and opens it.

Certain options within activities create files in the Shared folder as well as in your User folder. For example, if you activate a questionnaire from Build, the project's .mdd is checked into the Shared area as part of the activation process. However, as long as you have the project locked, no one else can access the files in the Shared folder, so you can continue working on the project, knowing that nobody else has access to the files.

You can check files in to and out of the Shared folder whenever you want by running Files. If you are the only person working on a project, it is not important when you check files in because you will always have the files you need in your User folder. This is not the case when you are working on a project with other people. In that situation, it is important that you check files in and out regularly and at the appropriate points in the project's development cycle, as this ensures that each user has access to the latest versions of the project's files.

The following recommendations should ensure that everyone working on a project has access to the latest versions of the project files.

▪When you start work on an existing project, always run Files to see whether there are any project files in the Shared folder. If so, check these files out. This puts copies of those files in your User folder.

▪When you start work on a new project, check your files in regularly. For example, if you are designing a new questionnaire using Build, you might want to check your files in when you have finished the first draft of the questionnaire.

▪If you have finished working on the project for the time being and have checked all your files in, unlock the project so that other users know that they can use the files.

▪It is possible to unlock a project without checking in files, but this is bad practise as this is how newer files can be overwritten with out of date ones. If you unlock a project that already has files in the Shared folder, and you are interrupted before you have time to check in your latest files, someone else might check out the old files from the Shared folder. If you then check in your files, they will be overwritten when the other person checks in their changes, and your changes will be lost. Get into the habit of checking in files and then unlocking the project. If in doubt, do not unlock the project.

▪As soon as you run an activity on a project, the project is locked and other users will not be able to access the files. If you are ready to work on a project but cannot run an activity straight away, lock the project to prevent other users using the files.

Here is an example that illustrates how an questionnaire designer, a translator, and a scriptwriter can all work on a project together.

1 The questionnaire designer creates the project and runs Build to build the basic questionnaire. It takes the designer two days to complete the first draft of the questionnaire. The project is automatically locked by questionnaire designer, so the translator and scriptwriter cannot access any of the files that Build creates. (In any case, until the questionnaire designer checks the files in manually or tests or activates the questionnaire, the files exist only in the User folder.)

2 The questionnaire designer tests the questionnaire, which automatically copies files from the User folder into the Shared folder. However, because the project is still locked, no one else can access these files.

3 The questionnaire designer continues the cycle of testing and modifying the questionnaire. Because no one else has yet worked on the project, and because Build always uses the files in the User folder if they exist, there is no need for the questionnaire designer to check in the files during this process.

4 At the end of the second day, the questionnaire designer has finished all that they can do on the questionnaire and is ready to pass it to the scriptwriter for the final changes to be made prior to translation. Therefore, they use Files to check all the files in her User folder into the Shared folder, and then unlocks the project. At this stage, the files in the Shared folder become available to the scriptwriter and the translator.

5 On the third day, the scriptwriter checks the project files out from the Shared folder into their User folder. Because they will not be able to work on the files immediately, they lock the project to ensure that no one else can check out the Shared files and start working on them.

6 Later that day, the scriptwriter makes some additions to the questionnaire and runs some final tests. They do not check the files in after every change because they has the project locked and knows that no one else can access the Shared files. When the scriptwriter is satisfied that the questionnaire is finished, they check all the project files that are in her User folder into the Shared folder and unlocks the project. This makes the files in the Shared folder available to other users.

7 The translator checks out the .mdd file and locks the project, even though they cannot use Translation Utility through UNICOM Intelligence Interviewer - Server Admin. Then they download the file onto their computer and translates the texts. When they have finished, they use Files to upload the translated file into her User folder and then checks it in to the Shared folder. Finally, they unlock the project.

8 The scriptwriter checks all the project files out into her User folder and runs some final tests to ensure that the script appears correctly in the various translations. They work on the project as soon as they have checked out the files, so they let UNICOM Intelligence Interviewer - Server Admin lock the project for her automatically.

9 The scriptwriter activates the project in Active mode, and the project becomes available for live interviewing. If the scriptwriter made any changes to the questionnaire, they check the files back in before unlocking the project.

If you have permission to unlock other people’s projects, be careful when you use it and what you do with the project files after you have unlocked the project.