openlp/documentation
1
0
Fork 0
mirror of https://gitlab.com/openlp/documentation.git synced 2024-12-22 04:22:49 +00:00
Code Issues Projects Releases Wiki Activity

Improved ZionWorx import instructions to be more user friendly

Browse Source
This commit is contained in:
Samuel Findlay 2012-06-21 22:22:11 +10:00
parent 836746da5c
commit d3679f5032
1 changed files with 53 additions and 49 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

72
manual/source/songs.rst
View File

@ -114,59 +114,64 @@ Importing from ZionWorx
ZionWorx (version 2.5/2.6) stores your songs in a proprietary database format
which OpenLP is unable to access directly. Thus you will first need to convert
it to a CSV text file, which OpenLP and other tools (such as spreadsheet
applications) are able to access. This can be achieved via a free 3rd-party
applications) are able to access. This can be achieved via a free third-party
utility called "TurboDB Data Exchange".
1. Locate your ZionWorx songs database. ZionWorx lets you define the location in
:guilabel:`File > Preferences`. The database folder will contain a collection
of files such as Data.tdbd and MainTable.dat
First, locate your ZionWorx songs database. ZionWorx lets you define the
location in :guilabel:`File > Preferences`. The database folder will contain a
collection of files such as Data.tdbd and MainTable.dat
Default location on Windows XP::
Default location on Windows XP::
C:\Documents and Settings\All Users\ZionWorx\2.6\Data
C:\Documents and Settings\All Users\ZionWorx\2.6\Data
Default location on Windows Vista / Windows 7::
Default location on Windows Vista / Windows 7::
C:\ProgramData\ZionWorx\2.6\Data
C:\ProgramData\ZionWorx\2.6\Data
2. `Download TurboDB Data Exchange
<http://www.dataweb.de/en/support/downloads.html>`_ from dataWeb. The utility
will be downloaded as an archive file:
Download `TurboDB Data Exchange
<http://www.dataweb.de/en/support/downloads.html>`_ from dataWeb. The utility
will be downloaded as an archive file:
Windows::
**Windows**:
tdbdataX.zip
Open ``tdbdataX.zip`` and copy ``TdbDataX.exe`` into your ZionWorx
database folder.
Linux::
Press the keyboard combination :kbd:`Windows key + R` to open the
:guilabel:`Run` window.
tdbdatax.tar.gz
Type ``cmd`` and click :guilabel:`OK`.
3. Extract the single executable file contained in the archive file and copy it
into your ZionWorx database folder.
4. Open a command-line:
In the command prompt window that opens, type these commands (replacing
``database-folder`` with your actual location), followed by
:kbd:`Enter`::
Windows:
cd "database-folder"
tdbdatax MainTable.dat songstable.csv -fsdf -s, -qd
1. Press the keyboard combination :kbd:`Windows key + R` to open the
:guilabel:`Run` window.
2. Type ``cmd`` and click :guilabel:`OK`.
3. In the command prompt window that opens, type this command (replacing
``database-folder`` with your actual location) and press
:kbd:`Enter`::
**Linux**:
cd "database-folder"
Right click on ``tdbdatax.tar.gz`` and select :guilabel:`Unpack` or
:guilabel:`Extract`. Then right click on ``tdbdatax``, select
:guilabel:`Properties`, and make sure the :guilabel:`executable` option
is checked.
Linux:
Alternatively, in the terminal::
Open a terminal and ``cd`` to your ZionWorx database folder.
tar xvzf tdbdatax.tar.gz
chmod u+x tdbdatax
5. Run this command at the command-line::
Copy ``tdbdatax`` into your ZionWorx database folder.
tdbdatax MainTable.dat songstable.csv -fsdf -s, -qd
Finally, open a terminal and ``cd`` to your ZionWorx database folder.
Type this command and press :kbd:`Enter`::
You should see some feedback indicating success, such as::
./tdbdatax MainTable.dat songstable.csv -fsdf -s, -qd
Batch move has moved 1223 records.
You should see some feedback indicating success, such as::
Batch move has moved 408 records.
Your ZionWorx songs database has now been converted to a CSV text file. Run the
Song Importer in OpenLP, select :guilabel:`ZionWorx (CSV)`, and locate the
@ -174,8 +179,7 @@ Song Importer in OpenLP, select :guilabel:`ZionWorx (CSV)`, and locate the
.. image:: pics/songimporter_zionworx.png
After clicking :guilabel:`Next` your import will be complete. Then press :guilabel:`Finish` and OpenLP will be ready to use the songs that you have
imported from ZionWorx.
After clicking :guilabel:`Next` your import will be complete.
Creating or Editing a Song Slide
================================