<< Click here to display Table of Contents >> Navigation: Migrate from GN3:

Exporting GN3 data by GN3Export

Build 1501 on 14/Nov/2017 This topic last edited on: 17/Mar/2016, at 16:49

Contents

GN3Export is a command-line utility that you run in a Command prompt on a GN3 server (that can access to high-res images). It exports GN3 items, creating one or more XML files, that you can import in GN4 database and migrate in that way the configuration and content from GN3 to GN4.

Find GN3Export.exe in GN3EXPORT.ZP on the FTP folders related to GN3. Use the latest version (available in GN3 daily). Extract in a new folder. There's no need to register any, so you can safely run the latest GN3Export also on older and previous GN3 versions.

Usage

GN3export switches

Title specifications (-title, -titleName) (REQUIRED)

-title 0 (specifies all titles)

-title Id1,Id2,...,Idn (specifies title id list)

-titleName Title1,Title2,...,Titlen (specifies title name list)

Node To Export (-node) (REQUIRED)

-node NodeName1, NodeName2,..

With node name can be specified an identifier (id or name) for extract one single object

-node NodeName1:ID=XXX, NodeName2:NAME=nameobj,..

available nodes = justScope', 'hyphenation', 'fontLayout', 'lib', 'libObj', 'font', 'justDef', 'justContext', 'geometry', 'master', 'pageLayer', 'edition', 'editionTemplate', 'editionNumber', 'page', 'media', 'layerType', 'zone', 'section', 'region', 'title', 'workstate', 'folder', 'article', 'img', 'txtGeometry', 'categorySet', 'EditorialConfig', 'user', 'group', 'copyflow'

For 'article' node and 'img' node is also possible use another parameter filter, the BasketId (-node NodeName1:BASKET=XXX).

For 'article' node is also possible use another parameter filter, the EditionId (-node NodeName1:EDITION=XXX).

The 'edition' parameter exports all articles linked in the pages of specified edition (template editions are ignored).

'EditorialConfig' is a node with data to set on EdAdmin4->ClientApplications->EditorialConfig.

For 'hyphenation' node binary files are saved on '.\GN3Export' subfolder.

For 'edition' and 'editionTemplate' node export, the process save in separate files the following related objects: 'master', 'pageLayer', 'page', 'editionNumber', 'article', 'txtGeometry', 'img'

Output file (-out) (REQUIRED)

-out filename (the file where to export xml)

ConfigScope (-cs)

-cs new configScope name ("default" if it's omitted)

Debug (-debug)

-debug exporting with report on screen.

Examples

•Extracting articles linked in pages of the edition with id=341 that belongs to any title, in the file C:\out.xml:

GN3export -title 0 -out C:\out.xml -node article:edition=341

Notes:

▪Use only edition ID - id of Edition Template will be ignored.

▪This parameter should be used for extract only the "article" node; If used in other nodes the parameter will be ignored.

▪The parameter is case-insensitive.

Sample batch to export data from a GN3 system

GN3Export -titlename TR -node justScope -out c:\temp\1_justScope.xml

GN3Export -titlename TR -node title,media,layerType -out c:\temp\2_title_media_layerType.xml

GN3Export -titlename TR -node zone,section,region,workstate -out c:\temp\3_zone_section_region_workstate.xml

GN3Export -titlename TR -node hyphenation -out c:\temp\4_hyphenation.xml

GN3Export -titlename TR -node folder -out c:\temp\5_folder.xml

GN3Export -titlename TR -node justDef -out c:\temp\6_justDef.xml

GN3Export -titlename TR -node justContext -out c:\temp\7_justContext.xml

GN3Export -titlename TR -node fontLayout,font,geometry -out c:\temp\8_fontLayout_font_geometry.xml

GN3Export -titlename TR -node lib -out c:\temp\9_lib.xml

GN3Export -titlename TR -node libObj -out c:\temp\10_libObj.xml

GN3Export -titlename TR -node editionNumber -out c:\temp\11_editionNumber.xml

GN3Export -titlename TR -node edition:ID=2749 -out c:\temp\edition2749\edition.xml

Some tips and tricks

Split in more XML files when exporting formats, style libraries and object libraries

Instead to use:

GN3Export -titlename TR -node libObj -out c:\temp\10_libObj.xml

you may want to split the export by library object ids, to make files smaller.

Split in more XML files when exporting articles and images

Use the basket filter when exporting article and img node.