Send/Receive begins with a ‘master’ copy of the project. Someone sends it. Others receive it. Then everyone can share changes with each other.
- If multiple copies of the project exist, use imports and exports to come up with a master project which is the best version of the project. Delete the outdated copies of the FieldWorks project from other computers.
You can share all the data in the project, or just the lexicon (that is, dictionary entries). Sharing the entire project is recommended. Sharing only the lexicon uses the LIFT format and is intended for sharing with other programs that use the LIFT format such as WeSay and Lexique Pro.
- The Send/Receive Lexicon option is designed for collaborating with team members who use WeSay. Using the Send/Receive Lexicon option for sharing lexical data between FLEx users when there are no WeSay users in the team is not recommended. FLEx users should use Send/Receive Project to share the full data set, rather than using the more limited Send/Receive Lexicon, which is limited to what is covered by the LIFT format.
- You can use both kinds of Send/Receive if you are working in a team which uses both FLEx and WeSay. In this situation, it is recommended to have only one FLEx member use Send/Receive Lexicon, and then use the Send/Receive Project to share that data with the other FLEx team members.
You can share data using a USB flash drive, the Language Depot Internet server, or Chorus Hub (a shared network folder). The setup for each of these is different.
- There is minimal setup if using a USB. You must have a USB drive that can be passed around between those who are sharing data.
- To use Chorus Hub for local area network, one computer on your network needs to start the Chorus Hub program. For more information, look at the document Technical Notes on FieldWorks Send/Receive on this page. You can read more about Chorus Hub on their website.
- The remaining steps outline the requirements to set up Language Depot.
- Before using Send/Receive Internet, you need to go to languagedepot.org and create a user account (by clicking ‘Register’ in the upper right corner of this page).
- Each person collaborating on the project will need an ID on the website or the manager of the project can create a ‘team’ ID that the contributors to the project can share.
- For each project you want to Send/Receive, you also need to contact firstname.lastname@example.org so they can create an online repository for you. The required information is listed on the home page of languagedepot.org.
- After the repository has been created, the manager should sign into Language Deport and add members (under the settings tab) to the project so others will be able to use this repository. Members can be found based on the first and last name of the ID they will be using on Language Depot. (Refer to the second bullet of this section).
Once the setup has been completed, you are ready to go.
Someone sends it
The person who has the master project clicks Send/Receive > Send this Project (or Lexicon) for the first time. On the Send/Receive project dialog box, they will need to select where the project should be sent. When using Send/Receive Internet for the first time, you need to click the Settings button before you can use it, in order to enter the details of the remote server and the project’s repository id, etc.
If you want to join a Lexicon (LIFT) repository to a project you already have in FLEx, use Send/Receive > Get Lexicon and Merge with this Project.
This will create the special collaboration “repository” on the destination they choose (USB, Internet, Chorus Hub.)
Others receive it
People who want to collaborate with the master project should delete all old copies of the project on their machine and click Send/Receive -> Get Project from Colleague.
Everyone uses send/receive to collaborate
Once the project has been sent, and each collaborator received it the first time, all collaborators can continue to work together and share data using Send/Receive > Project, or Lexicon. The settings are saved and do not need to be re-entered. There is a toolbar button which will open the Send/Receive dialog to the last type of Send/Receive you did (project or lexicon).
The Messages (a.k.a. Conflict Report) will be displayed after Send/Receive if there are new messages to review. You can also open it at any time with Send/Receive > View Project Messages, or View Lexicon Messages, as appropriate.
- Many merge-related messages are hard to understand. This is probably going to be an ongoing area of improvement, depending on feedback – how problematic the messages are in practice.
- Send/Receive does a really good job of automatically merging data when users have changed different parts of the project. When two people have edited the same or very closely related data in the same sync cycle, send/receive keeps the data entered by the current user. A conflict message is generated and includes information of the other user’s change for comparison. If you prefer the other user’s change, you will need to copy and paste the data manually into the appropriate place in FLEx; there is not yet a tool to select one change over another and have the FLEx project automatically updated.
- If one user adds word glosses to a text at the same time as another user adds word categories to it, this will not be merged conveniently because in the FLEx database these separate pieces of data are both part of a word’s analysis.
- If one user modifies an entry, sense, etc. at the same time as another user deletes that same item, send/receive will keep the modification rather than the deletion.
If a team needs to use the global change tools in FLEx, such as Bulk Edit, merge conflicts will be reduced if the team first does a series of Send/Receives to get all sync’ed to the same state. Then one user can do the global changes, and the team then re-syncs to get those changes and continue on with their tasks.
Send/Receive is possible because of a piece of add-in software called FLEx Bridge. It cannot be used outside of FLEx. Look at its webpage for more information.