FieldWorks 8.0.1 Beta 2
Version Date: May 6, 2013
This release has been superseded by a subsequent release.
This is a beta release. Please pay close attention to the Known Issues and instructions on using Send/Receive.
- Send/Receive Project – collaborate with colleagues located anywhere using Send/Receive to sync project data. (Send/Receive Lexicon to collaborate with WeSay users also improved.)
- Type ahead – type in the list reference fields to see a list of items which match what you’ve typed instead of having to use the ellipsis button!
- Bulk Edit Phoneme Features – add a Phonological Feature to multiple Phonemes at a time. Filter Phonemes by their Phonological Features.
- Complex Concordance – perform concordance searches for combinations of requirements e.g. a specific word (or gloss) followed by a word which has a specific grammatical category.
- Semantic Domain Find and Suggest – find relevant semantic domains using a find or have FLEx propose potentially relevant semantic domains based on the gloss, definition and reversal entries of the current sense. See post.
- Configure Collect Words (was Categorized Entry) – many more fields available to display in Collect Words view and ability to enter data into either lexeme or citation form, gloss or definition according to your preference.
- Configure and export Classified Dictionary – configure the fields shown in Classified Dictionary (a semantically classified list of entries) and export this view to XHTML.
- Welcome Dialog – when starting FieldWorks you are offered a number of choices including opening the last project you edited. This dialog will be shown every time unless you opt to have FieldWorks auto-open the last edited project, as it did previously.
You can collaborate on the entire project (advised) or just on the lexicon (LIFT – for use with other programs).
- 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 LIFT.
- 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 might be easiest 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 collaborate using a USB flash drive, an Internet server or Chorus Hub (a special network folder.)
- Before using Send/Receive Internet using the default server, you need to go to languagedepot.org and create a user account. 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. They need the name and ISO code of the language plus whether you will be using the option Send/Receive Project (FLEx only) or Lexicon (for use with other programs).
- 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.
- To use Chorus Hub for local area network, one computer on your network needs to start the Chorus Hub program. Instructions are on the Settings dialog on the Chorus Hub tab.
Concept: all start from one copy of the project. Someone sends it. Others receive it. All can then send/receive.
Someone sends it
The person who already has the project – the master everyone is going to start working with – uses Send/Receive > Project, or Lexicon. This will create the special collaboration “repository” on the destination they choose (USB, Internet, Chorus Hub.)
- What if there were multiple copies of the project already? Can we merge them? No, not automatically. You need to do any importing or exporting you need to do to come up with a master project which is the best version of the project. Delete the now outdated copies of the FieldWorks project from other computers.
Others receive it
- The person who doesn’t yet have the (master) project uses Receive Project from a Colleague on the Welcome dialog or Send/Receive > Get Project from Colleague. This is a one-off step!
- If you want to join a Lexicon (LIFT) repository from a project you already have in FLEx, use Send/Receive > Get and Merge Lexicon with this Project. This is a one-off step!
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).
- Someone sends it
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.
If you have used older-style sharing over a local area network (projects have the extension fwdb), you need to turn off that way of sharing (revert to fwdata format) in order to try Send/Receive for collaborating. You can do this in File > Project Management > Project Locations and Sharing. Uncheck the box labelled “Share projects stored on this computer.”
If you want to track our progress on these and other issues, follow one of the links below and sign up for an account on our JIRA system.
- If you are using Chorus Hub for send/receive, changing the name of a project with which you are collaborating is not advised. You will end up doing send/receive to a different repository than your colleagues and therefore not succeed in collaborating. Workaround: If the name change is required, consult with your colleagues. First ensure you have received all their latest changes. They then need to pause from working on the project. You rename the project. You Send/Receive, which creates a new repository on the Chorus Hub. The colleagues should delete their copy of the project with the original name. The colleagues then use Get Project to start working with the newly named project. LT-14396.
- It is strongly not recommended to restore over (replacing) an existing project with which you are collaborating using send/receive. The subsequent send/receive would send a huge number of changes to all the other team members, effectively restoring the old version of the project on every team member's computer.
- You cannot have non-ASCII characters in the FLEx project name to use Send/Receive.
- If you are exchanging a VERY large number of changes using Send/Receive (e.g. extensive global changes by both users over the course of a month) you may run into a timeout error after 15 minutes during the merge step. LT-14526
- If you add the same Grammatical Category (e.g. Adjective) to both the Grammatical Categories list and the Reversal Index Categories list, Send/Receive will report an error when you try to sync. LT-14511
- Version conflict message sometimes continues to be shown for a while after the problem is solved. LT-14332 May be done. Not completely verified.
- The menu item "Copy (Ctrl+C)" isn’t working on the “Conflict Detail” dialog box. LT-14327
- The Text Chart is changed incorrectly (words are moved to emptied cells) after another user deletes some charted words from the text. LT-14317
- If you are not the administrator on the computer, you might find that “Get Project” gives an error message. This happens if you do not have permission to access all the files in the FieldWorks Projects folder. LT-14301 (Let us know if you encounter this.)
- Crash after stopping and starting and using Chorus Hub LT-14291
- If both users edit the same phonemes, or add inflection features to the same lexical entry, the results may need subsequent editing. E.g. A phoneme may have incompatible phonological features and an entry may have incompatible inflection features.
- If you add a question or add a message to a merger conflict/notification, it is not possible to edit or delete those comments subsequently. LT-14076
- Using any Send/Receive commands in quick succession usually causes a message to pop up which claims that FLExBridge is already running. If it is not (e.g. you closed the Messages window then need to reopen them) wait for 5 seconds and try again.
- Linked media files over 1MB in size are not being transferred. No movie files of any size are being transferred. If a user subsequently removes the link to the file due to the current restrictions, the warning messages continue to be displayed at each send/receive operation if the file is still in the project folder.
- When both users change the properties of the same style, the resulting merge conflict message does not state the conflicting style settings.
Send/Receive Lexicon (LIFT) with e.g. WeSay
- Send/Receive Lexicon should not be used to pass data between two or more FLEx users. You should use Send/Receive Project.
- Send/Receive Lexicon depends on the LIFT standard. Some FLEx data is not handled well yet by this collaboration method. E.g. Which entries belong in which inflection template slots and some other morphological grammar facts stored on a lexical entry. Components of a complex form. Custom lexical relations.
- Using "Get & Merge…." twice in the same project should not be possible, but occasionally is. If it is used twice, there is a crash. LT-14320
- If you created a custom field in WeSay and used a previous version of LIFTBridge with FLEx (e.g. in 2012), FLEx will crash when you try to open the project. Please contact us for help. LT-13850
- After receiving a project from a colleague which was a Lexicon repository, using the Send/Receive toolbar button attempt to do Send/Receive Project not Send/Receive Lexicon. Workaround: use the menu item Send/Receive > Lexicon at least once before subsequently using the toolbar button. LT-14350
- The Sena 3 (sample project) link doesn't work on the new Welcome dialog box the first time the dialog opens. Workaround: Use Open and then select Sena 3. LT-14324
- If you cancel one of the Welcome dialog actions, the last project you edited will automatically open. LT-14148
- Semantic Domain's Suggest feature is too prolific when there is more than one word in the Gloss field. LT-14243
- Import SF Lexicon does not correctly import Example sentences with multiple vernacular writing systems. LT-10683
- It is not possible to disable vernacular spell checking. LT-14150
- If you exclude senses from a Publication using the Publish in field – the shown senses are not renumbered in Dictionary View. LT-14264
- Interlinear SFM import fails with Unicode to Unicode converter. LT-13741
- Right-click menu is inappropriate for Status and Confidence fields. LT-14195
- Unicode Character Editor fails to process code points out of plane 0. LT-14263
- The options Edit Spelling Status and View Incorrect Words are missing from the menu Tools>Spelling. LT-12343
- Alpha headers not correct in Pathway/xhtml export for digraphs at secondary level of collation rules. LT-14260
- Python and Perl encoding converters do not work.
- Type-ahead doesn’t work on custom fields referring to custom lists. LT-13248
- To use Phonology Assistant with this version of FieldWorks, you need to upgrade Phonology Assistant to version 3.4.6.
- FLExTools does not yet work with this version of FieldWorks.
A Full package contains .NET 4.0 and Windows Installer 3.1; a Minimal package does not.
Users will probably need to use a Full package for the first installation of FW 8. (This does not apply to Windows® 8.)
No patch is available for this version.
- Download one of the Full or Minimal installation packages above.
- Double-click the exe file you downloaded. After it extracts files, the first installation screen appears.
- Follow the on-screen instructions. Make sure you allow the SIL Software installer to install FLExBridge and any other required third party software it says is required.
- If you have used FieldWorks 6.0.6 or earlier on this computer before, you may see two further steps:
- Select which if any projects you wish to migrate from FieldWorks 6.0.6 or earlier format.
- Choose whether to uninstall the last version of FieldWorks or its desktop shortcuts. Help.
For more information on upgrading to FieldWorks 7 or 8 from an older version (6 or earlier), see here.
Please check the Known Issues section above.
To install the movies for FLEx:
Note: The movies have not yet been updated since FieldWorks 6.
- Download the movies package (206 MB).
- Double-click the msi file you downloaded.
- A progress bar appears, showing the progress of the installation.
After you download the sample project(s) you want, double-click each one to start the Restore in FieldWorks. If you find that your browser (e.g. I.E.) has renamed the files to .zip, you will need to rename them first to .fwbackup in order for the FieldWorks restore function to work.
Here is the MD5 hash of each of the download packages, should you wish to use this to verify the download completed successfully.
Recommended System Configuration
- Operating system: Microsoft Windows® 7 with Service Pack 1
- Computer and processor: Computer with Intel Core® (or equivalent) processor running at 2.2 gigahertz (GHz) or higher
- Memory: 2 gigabytes (GB) of RAM or more.
Note: The more RAM and the faster the CPU, the better FieldWorks will perform, especially with larger projects.
Minimum System Requirements
- Operating system: Microsoft Windows® XP Professional with Service Pack 3 or later, Windows Vista® with Service Pack 2 or later, Windows® 7 with Service Pack 1, Windows® 8.
- Computer and processor: Computer with Intel Pentium® (or equivalent) processor running at 1.5 gigahertz (GHz).
- Memory: 500 megabytes (MB) of RAM.
- Hard disk: Hard disk space requirements will vary depending on existing machine configuration and custom installation choices. As a guideline figure, you should have at least 1.5 gigabytes free prior to installation. In any case, you are recommended to have at least 10% of your hard drive free in order to allow Windows to run properly.
- Display: 1024 by 768 pixels screen resolution or greater (for laptops, use native display resolution).
- Offline storage: An external USB drive, network drive, or writeable CD-ROM to allow offline data backups.
- Peripherals: Mouse or compatible pointing device.
The latest stable Linux version is 7.0.6. FieldWorks 8.0.1 on Windows can open data from FW 7.0.6 on Linux, but once it has been edited, it can no longer be opened in FW 7.0.6. If you are working on a team with both Linux and Windows versions of FLEx, we recommend version 8.0.3 Beta 4 or later.
Instructions for installing the Linux version are available on the LSDev Linux wiki.