openlp/documentation
1
0
Fork 0
mirror of https://gitlab.com/openlp/documentation.git synced 2024-12-22 12:32:48 +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 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 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 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". utility called "TurboDB Data Exchange".
1. Locate your ZionWorx songs database. ZionWorx lets you define the location in First, locate your ZionWorx songs database. ZionWorx lets you define the
:guilabel:`File > Preferences`. The database folder will contain a collection location in :guilabel:`File > Preferences`. The database folder will contain a
of files such as Data.tdbd and MainTable.dat 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 Download `TurboDB Data Exchange
<http://www.dataweb.de/en/support/downloads.html>`_ from dataWeb. The utility <http://www.dataweb.de/en/support/downloads.html>`_ from dataWeb. The utility
will be downloaded as an archive file: 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 In the command prompt window that opens, type these commands (replacing
into your ZionWorx database folder. ``database-folder`` with your actual location), followed by
4. Open a command-line: :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 **Linux**:
: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`::
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 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 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 .. 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 After clicking :guilabel:`Next` your import will be complete.
imported from ZionWorx.
Creating or Editing a Song Slide Creating or Editing a Song Slide
================================ ================================