The
exportDimensionValueIdMappings
task exports dimension
value Id mappings from a Dimension Value Id Manager to a CSV file. You may want
to run this task to back up dimension value Id mappings to a file or to copy
dimension value Id mappings across environments.
The syntax for this task is:
cas-cmd exportDimensionValueIdMappings [-h HostName] [-l true|false] -m dvalmgr [-p PortNumber] -f mappings.csv
Where:
-h
(or--host
) specifies the host where the CAS Service is running. If the flag is omitted, the default is the value of thecom.endeca.itl.cas.server.host
property incommandline.properties
. If the property is not set, the value then defaults tolocalhost
. Optional.-l
(or--isPortSsl
) specifies whether to communicate with the service using an HTTPS connection. A value oftrue
uses HTTPS and treats thecom.endeca.itl.cas.server.port
property as an SSL port. A value offalse
uses HTTP and treatscom.endeca.itl.cas.server.port
as a non-SSL port. Specifyfalse
if you enabled redirects from a non-SSL port to an SSL port. Optional.-m
(or--dimension_value_id_manager
) specifies name of the Dimension Value Id Manager. Required.-p
(or--port
) specifies the port of the CAS Service. If the flag is omitted, the default is the value of thecom.endeca.itl.cas.server.port
property incommandline.properties
, in<install path>
\CAS\workspace\conf<install path>
/CAS/workspace/conf8500
. Optional.-f
(or--file_name
) specifies the path of the CSV file, which must be accessible to the CAS Service process (not just accessible to the host running the CAS Service). The file is encoded as UTF-8. The accessibility requirement has implications for files that reside on mapped network drives. For details, see the following note. Required.
Note
For Windows, you should specify network drives by universal naming convention (UNC) syntax rather than by using the letter of a mapped drive. For UNIX, you can specify mounted or local drives using standard file path syntax.
Examples of local folders on Windows:
Examples of syntax for network drives:
To export dimension value Id mappings:
Example 13. Examples of exporting dimension value Id mappings
This Windows example exports mappings to a local drive:
C:\Endeca\CAS\<version>\bin>cas-cmd.bat exportDimensionValueIdMappings -m dvalmgr -f C:\temp\mappings.csv Successfully exported mappings from C:\temp\mappings.csv
This Windows example exports mappings from a mapped network drive:
C:\Endeca\CAS\<version>\bin>cas-cmd.bat exportDimensionValueIdMappings -m dvalmgr -f \\jsmith-t60\tmp\mappings.csv Successfully exported mappings from \\jsmith-t60\tmp\mappings.csv