Document Properties: Destination
The Destination properties page specifies the title
for the document and the destinations where iSiloX copies
the converted document.
Document Title
Each document must have a title. The title may be up
to 31 characters long. You should make sure that you give
each document a unique title.
There are a couple of important points you need to be
aware of with regard to the requirement that the title
you assign a document should be unique.
- By default, the file name used for the converted document
is based on the title. So if you have more than one document
converted using the same title and written to the same
destination area, then the last such document will be the
only one left since each subsequent one overwrites the
previous one with the same file name.
- A file that is a document in iSilo™ format
uses the Palm OS® database format as the top-level container
format so that the document can be installed to the internal
memory of a Palm OS® device. The title is stored internally
within the database as the name of the database. The name
uniquely identifies the database, so if you have two databases
with the same name, one will overwrite the other.
Dynamic title components
In addition to static characters in the title, the title
can also have dynamic components such as the date of conversion
or the title of the first source file. Dynamic components always
begin with the two-character sequence consisting of a backslash
and an uppercase X, followed by the component name. If the component
has additional parameters, a question mark follows the component
name and the parameters follow the question mark. A semicolon
marks the end of a component.
The following table lists the available title components:
| Component
| Description
|
\Xdate;
| Text: The date the conversion starts.
Default format: A six character sequence in the
format Y2M2D2, where Y2 is the last two digits of the year,
M2 is the two digit month, and D2 is the two digit day.
Parameters: Any of the following parameters can be
provided in any order. Additional characters may also be
interspersed between the parameters as separators that are
included in the resulting text.
Y: The year in natural format (e.g., 1999, 2004)
Y2: The year in two-digit format (e.g., 99, 04)
M: The month in natural format (e.g., 8, 12)
M2: The month in two-digit format (e.g., 08, 12)
D: The day of the month in natural format (e.g., 9, 31)
D2: The day of the month in two-digit format (e.g., 09, 31)
|
\Xtime;
| Text: The time the conversion starts.
Default format: A four character sequence in the
format H2M2, where H2 is the two digit hour in 24-hour format
and M2 is the two digit minute.
Parameters: Any of the following parameters can be
provided in any order. Additional characters may also be
interspersed between the parameters as separators that are
included in the resulting text.
H: The hour in 24-hour natural format (e.g., 2, 23)
H2: The hour in 24-hour two-digit format (e.g., 02, 23)
M: The minute in natural format (e.g., 8, 51)
M2: The minute in two-digit format (e.g., 08, 51)
S: The second in natural format (e.g., 9, 38)
S2: The second in two-digit format (e.g., 09, 38)
|
\Xtitle;
| Text: The title of the first source file.
Parameters: This component has no parameters.
|
Example titles with dynamic components
| Title Specification
| Description
|
\Xdate; Short Stories of Yore
| If the date of conversion is December 25, 2004, this
title specification sets the title to "041225 Short Stories of Yore".
This title uses the default date format.
|
\Xdate?M-D-Y; Short Stories of Yore
| If the date of conversion is December 25, 2004, this title
specification sets the title to "12-25-2004 Short Stories of Yore".
Notice the inclusion of hyphens between the month, day, and year
parameters, which result in the insertion of hyphens between
those parts in the same places in the resulting title.
|
Short Stories of \Xdate?D-M-Y2; Yore
| If the date of conversion is March 1, 2005, this title
specification sets the title to "Short Stories of 1-3-05 Yore".
|
Short Stories of \Xdate?D2-M2-Y2; Yore
| If the date of conversion is March 1, 2005, this title
specification sets the title to "Short Stories of 01-03-05 Yore".
|
Adding HotSync® Destinations
If you have HotSync® installed, then you can add HotSync®
users to the destination list. After iSiloX converts
the document, it queues the document for installation to the
listed users so that the next time the user performs a
HotSync®, the document is installed to the user's device.
HotSync® destinations appear in the destination list
with the HotSync® icon .
Adding a HotSync® user destination
To add one or more HotSync® destinations, click the
HotSync®... button. This presents
the HotSync® Users dialog. Select one or more
users from the list, select one of the Destination
options (described next), then click OK to add the
user(s) to the destination list.
Handheld device memory
Selecting Handheld device memory for the Destination
option installs the document to the internal storage memory of the
Palm OS® device.
External memory card
Selecting External memory card for the Destination
option installs the document to the /Palm/Programs/iSilo/
folder of the first memory card with enough free space for the document.
Note that some Palm OS® devices may have built-in memory
cards and that the order in which the HotSync® Manager presents
the memory cards to the iSilo™ Install conduit
may differ from one HotSync® operation to the next. For specific
control over exactly which memory card the document installs to,
use the Path destination option described next.
Path
Selecting Path for the Destination option installs
the document to the path entered in the adjacent field. The path
specifies the memory card and location on the card to which to install
the document and must be a full path with slashes as path component
separators. Either forward slashes or backslashes may be used as
path component separators.
The first component of the path must be the volume name or label
of the memory card. If the volume name is empty or not that of a
mounted memory card at the time of HotSync®, the document
installs to the first memory card with available space.
Following the volume name component is the path of the folder
to which to install the document. If the full path ends in a slash,
the filename is based on the document title as described above.
Otherwise, the last component of the path is the file name the
document takes on the memory card.
If any of the folders in the path do not exist at the time
of installation, the iSilo™ Install conduit
creates them.
Following are some example paths:
| Example Path
| Description
|
/Johns Card/Documents/iSilo/Diary for September.pdb
|
Volume: Johns Card
Folder: /Documents/iSilo/
File name: Diary for September.pdb
|
/128M/Entertainment/
|
Volume: 128M
Folder: /Entertainment/
File name: based on document title
|
//Documents/iSilo/
|
Volume: first one with enough free space
Folder: /Documents/iSilo/
File name: based on document title
|
//My Hobbies/Fishing/Laws and Regulations/DeepFish
|
Volume: first one with enough free space
Folder: /My Hobbies/Fishing/Laws and Regulations/
File name: DeepFish
|
Note that the path must begin with a slash and that the characters
listed in the table below can not be used for any part of the folder
path or file name. However, there may be additional characters
that can not be used and are dependent on the file system of the card.
Using invalid characters will result in problems or errors during
installation of the document:
|
Disallowed characters in paths
|
| Character | Description
|
| " | Double-quote
|
| * | Asterisk
|
| : | Colon
|
| < | Less than
|
| > | Greater than
|
| ? | Question mark
|
| | | Vertical bar
|
Removing HotSync® destinations
To remove one or more HotSync® destinations, select
the destinations to remove and then click the
Remove button. iSiloX presents
a dialog for you to confirm that you want to remove
the selected users.
Changing the HotSync® destination
You can right-click any HotSync® entry in the list to get
a context menu to change the specific destination. In the
context menu, a bullet appears next to the currently selected
destination. Click the desired destination in the menu to change it.
If you click Path and the current destination is already
a path, you can edit the current path. Otherwise, if the
current destination is either Handheld device memory
or External memory card, selecting Path allows
you to change the destination to be a path and to enter the
specific path for the document.
You can not directly change an added destination to another
user. Just remove the entry you want to change and add the
new one in the normal manner.
Notes
In order for iSiloX to be able to install
documents to the external memory card, HotSync® Manager
version 4.0 or greater with the VFS Manager must be present.
If it is not, iSiloX disables the External memory card option.
If you choose External memory card or Path
and the user does not have an external memory card,
then the document will not install to the user's device
when the user performs a HotSync®.
Adding ActiveSync® Destinations
If you have ActiveSync® installed, then you can add ActiveSync®
devices to the destination list. After iSiloX converts
the document, it queues the document for installation to the
listed devices so that the next time the device connects through
ActiveSync®, the document is installed to the device.
ActiveSync® destinations appear in the destination list
with the ActiveSync® icon .
Adding an ActiveSync® device destination
To add one or more ActiveSync® destinations, click the
ActiveSync®... button. This presents
the ActiveSync® Devices dialog. Select one or more
devices from the list, select one of the Destination
options (described next), then click OK to add the
device(s) to the destination list.
Handheld device memory
Selecting Handheld device memory for the Destination
option installs the document to the iSilo subfolder
of the default folder for documents on the internal storage memory
of the device. The exact path depends on the device, but for English
language devices, the full path of the destination folder is usually
\My Documents\iSilo\.
External memory card
Selecting External memory card for the Destination
option installs the document to the iSilo subfolder
of the default folder for documents on the first memory card
with enough free space for the document. Note that some devices
may have built-in memory cards and that the order in which the
operating system on the device presents the memory cards to the
iSilo™ ActiveSync® service provider may differ
from one ActiveSync® connection to the next. For specific
control over exactly which memory card the document installs to,
use the Path destination option described next.
The exact destination path depends on the device, but for English
language devices, the full path of the destination folder is usually
\Storage Card\My Documents\iSilo\.
Path
Selecting Path for the Destination option installs
the document to the path entered in the adjacent field. The path
must be a full path with slashes as path component separators.
Either forward slashes or backslashes may be used as path component
separators.
If any of the folders in the path do not exist at the time
of installation, the iSilo™ ActiveSync®
service provider creates them.
If the full path ends in a slash,
the filename is based on the document title as described above.
Otherwise, the last component of the path is the file name the
document takes.
Following are some example paths:
| Example Path
| Description
|
\Documents\iSilo\Diary for September.pdb
|
Folder: \Documents\iSilo\
File name: Diary for September.pdb
|
\Storage Card\Entertainment\
|
Folder: \Storage Card\Entertainment\
File name: based on document title
|
\Storage Card2\
|
Folder: \Storage Card2\
File name: based on document title
|
\My Hobbies\Fishing\Laws and Regulations\DeepFish
|
Folder: \My Hobbies\Fishing\Laws and Regulations\
File name: DeepFish
|
Note that the path must begin with a slash and that the characters
listed in the table below can not be used for any part of the folder
path or file name. However, there may be additional characters
that can not be used and are dependent on the file system of the card.
Using invalid characters will result in problems or errors during
installation of the document:
|
Disallowed characters in paths
|
| Character | Description
|
| " | Double-quote
|
| * | Asterisk
|
| : | Colon
|
| < | Less than
|
| > | Greater than
|
| ? | Question mark
|
| | | Vertical bar
|
Removing ActiveSync® destinations
To remove one or more ActiveSync® destinations, select
the destinations to remove and then click the
Remove button. iSiloX presents
a dialog for you to confirm that you want to remove
the selected devices.
Changing the ActiveSync® destination
You can right-click any ActiveSync® entry in the list
to get a context menu to change the specific destination.
In the context menu, a bullet appears next to the currently
selected destination. Click the desired destination in the
menu to change it.
If you click Path and the current destination is already
a path, you can edit the current path. Otherwise, if the
current destination is either Handheld device memory
or External memory card, selecting Path allows
you to change the destination to be a path and to enter the
specific path for the document.
You can not directly change an added destination to another
device. Just remove the entry you want to change and add the
new one in the normal manner.
Notes
If you choose Handheld device memory, the document
installs to the "\My Documents\iSilo" folder of your device's
internal storage memory.
If you choose External memory card, the document
installs to the "\My Documents\iSilo" folder of the first
mounted storage card with enough space for the document.
If you choose External memory card and the devices does
not have an external memory card at the time of connection,
then the document will not be installed.
Adding a Folder Destination
To have the converted document copied to a folder, click the
Folder... button. This presents the
Browse for Folder dialog from where you select the
destination folder. After selecting the destination folder
and clicking OK, iSiloX adds the full path of the
folder to the destination list. The path name has
a backslash appended to indicate that it is a folder.
Folder destinations appear in the destination list
with a folder icon .
iSiloX copies the converted document to the folder with a file name
based on the Document Title and with an extension of .pdb.
Specifying the file name
If you want to give the destination file a specific file name,
right-click the entry to get the context menu, then click Edit.
Type the file name after the last backslash and click OK
to accept the change or Cancel to cancel the change.
If you change a folder destination to a file destination, the
icon of the entry changes to that for a file
.
Removing folder destinations
To remove one or more folder destinations, select
the folder destination entries to remove and then click the
Remove button. iSiloX presents
a dialog for you to confirm that you want to remove
the selected destination folders.
Notes
iSiloX automatically overwrites the destination file without
prompting, so make sure you are aware of this.
Remember that if the file name ends in a backslash, then iSiloX
assumes that it is a folder and uses a destination file name based
on the Document Title and appended with a .pdb extension.
All folders in the path leading to the destination file must exist
or iSiloX will not be able to copy the converted document to its
destination.
Adding a File Destination
To have the converted document copied to a file, click the
File... button. This presents the
Save As dialog for you to specify the destination
file name. After specifying the destination file name
and clicking OK, iSiloX adds the full path of the
file to the destination list.
File destinations appear in the destination list
with a file icon .
Editing the file name
To edit a file destination entry in the list, right-click the entry
to get the context menu, then click Edit.
Make your changes and click OK to accept or Cancel to cancel
any changes. If you change a file destination to a folder destination
(e.g., a folder destination ends with a backslash), the
icon of the entry changes to that for a folder
.
Removing folder destinations
To remove one or more file destinations, select
the file destination entries to remove and then click the
Remove button. iSiloX presents
a dialog for you to confirm that you want to remove
the selected file destinations.
Notes
iSiloX automatically overwrites the destination file without
prompting, so make sure you are aware of this.
Remember that if the file name ends in a backslash, then iSiloX
assumes that it is a folder and uses the Document Title with
an extension of .pdb as the name of the destination file.
All folders in the path leading to the destination file must exist
or iSiloX will not be able to copy the converted document to its
destination.