|
|
| (14 intermediate revisions by 2 users not shown) |
| Line 1: |
Line 1: |
| <blockquote style="font-size:14pt">
| | __TOC__ |
| How can you share Grooper objects, like '''[[Content Model]]s''', '''[[Batch Process]]es''', '''[[Batch]]es''' and more, with other Grooper users?
| |
| </blockquote>
| |
|
| |
|
| == About ==
| | This page is a redirect. Depending on your version of Grooper, you may be looking for one of the following pages: |
|
| |
|
| Grooper allows you to export Grooper objects from a Grooper Repository as a zip archive file. You can then bring in those objects into a Grooper Repository (such as one you are ''not'' connected to) by importing the zip file. | | * Version 2021 and older: [[2021:Import or Export Grooper Objects]] |
| | * Version 2022: [[2022:Import or Export Grooper Objects]] |
| | * Version 2023 and later: [[Download or Upload Grooper Objects]] |
|
| |
|
| The process is straightforward, but there are a few things to watch out for.
| | === === |
| | |
| == How To == | |
| | |
| === Export Grooper Objects to a Zip File === | |
| | |
| <tabs style="margin:20px">
| |
| <tab name="Exporting a Single Object" style="margin:20px">
| |
| === Exporting a Single Object ===
| |
| | |
| {|cellpadding=10 cellspacing=5
| |
| |valign=top style="width:40%"|
| |
| For this example, we have an '''[[IP Profile]]''' batch named "Sample IP Profile - Layout Data" that we want to export from this Grooper repository and import it into another.
| |
| | |
| # To export a single object, all you need to do is right click the object in the Node Tree you want to export.
| |
| #* Here, we have right clicked the '''IP Profile''' named "Sample IP Profile - Layout Data"
| |
| # Select "Share..." and "Export to Zip Archive..."
| |
| # The following window will pop up to configure your export.
| |
| # Use the '''''Filename''''' property to name the zip file and choose the folder location where you want to save it.
| |
| #* The filename will default to the name of the object you are exporting.
| |
| |
| |
| [[File:Import-and-Export-Grooper-Objects-01.png]]
| |
| |-
| |
| |valign=top style="width:40%"|
| |
| The following window will appear.
| |
| | |
| # Choose the folder location you want to save your zip file.
| |
| # Name the file whatever you would like.
| |
| #* The filename will default to the name of the object you are exporting.
| |
| #* It's generally a good idea to at least include the major version of Grooper you are using in the filename (i.e. 2.80 or 2.90). You ''cannot'' import an exported Grooper zip of differing major versions.
| |
| # Press the "Save" button.
| |
| |
| |
| [[File:Import-and-Export-Grooper-Objects-02.png]]
| |
| |-
| |
| |valign=top style="width:40%"|
| |
| You will then return to the previous window.
| |
| | |
| # Press the "Execute" button to export the file to the zip archive.
| |
| # The following window will appear, indicating the export was successful. Press "Ok".
| |
| |
| |
| [[File:Import-and-Export-Grooper-Objects-03.png]]
| |
| |-
| |
| |valign=top style="width:40%"|
| |
| You can find the zip file wherever you chose to save it.
| |
| |
| |
| [[File:Import-and-Export-Grooper-Objects-04.png]]
| |
| |}
| |
| </tab>
| |
| <tab name="Exporting Multiple Objects" style="margin:20px">
| |
| === Exporting Multiple Objects ===
| |
| {|cellpadding=10 cellspacing=5
| |
| |valign=top style="width:40%"|
| |
| You can also easily export multiple objects to a single zip archive.
| |
| | |
| For example, what if we wanted to export the "Sample IP Profile - Layout Data" '''IP Profile''' as well as this '''Batch''' named "Sample Batch"?
| |
| |
| |
| [[File:Import-and-Export-Grooper-Objects-05.png]]
| |
| |-
| |
| |valign=top style="width:40%"|
| |
| The starting point is much like an export of a single object.
| |
| | |
| # Right click one of the objects you want to export.
| |
| #* Here, we are right clicking the '''IP Profile'''.
| |
| # Select "Share" and "Export to Zip Archive..."
| |
| # Select the '''''Items to Export''''' property.
| |
| # Press the ellipsis button at the end
| |
| |
| |
| [[File:Import-and-Export-Grooper-Objects-06.png]]
| |
| |-
| |
| |valign=top style="width:40%"|
| |
| This will bring up a window allowing you to select multiple objects in your Node Tree.
| |
| | |
| # Expand out the Node Tree to find the location of the object you want to export.
| |
| #* Here, we have a '''Test Batch''' located in the following location
| |
| #* <code>Batch Processing > Batches > Test</code>
| |
| # Check the box next to the object you want to export.
| |
| #* Here, we checked the box next to the '''Batch''' named "Sample Batch".
| |
| #* You may select as many objects as you wish to export. Simply repeat the process of finding them in the Node Tree and checking the box next to the object.
| |
| # Press the "Ok" button when finished.
| |
| |
| |
| [[File:Import-and-Export-Grooper-Objects-07.png]]
| |
| |-
| |
| |valign=top style="width:40%"|
| |
| # Use the '''''Filename''''' property to name the zip file and choose the location where you want to save it.
| |
| # Press the "Execute" button to export the objects to the zip file in the location you chose.
| |
| |
| |
| [[File:Import-and-Export-Grooper-Objects-08.png]]
| |
| |}
| |
| </tab>
| |
| <tab name="Exporting Objects with References" style="margin:20px">
| |
| === Exporting Objects with References ===
| |
| | |
| Grooper makes use of references in a variety of different ways. '''Data Fields''' often reference '''Data Type''' extractors to populate fields in a '''Data Model'''. A '''Recognize''' step in a '''Batch Process''' will reference an '''OCR Profile'''. References are a fantastic way to get reusability out of the objects you create and configure.
| |
| | |
| When you export an object referencing an external object (one that is in a different location in the Node Tree) by default, Grooper will ''also'' include that object in zip file export. However, depending on your situation, you may want to export the referenced object or you may not.
| |
| | |
| {|cellpadding=10 cellspacing=5
| |
| |valign=top style="width:40%"|
| |
| # For this example, we will export the '''Content Model''' named "Sample Content Model - Cow App".
| |
| | |
| Note, the "Docket Number" '''Data Field''' uses a ''Read Zone'' extractor in order to populate the field. The ''Read Zone'' extractor allows you to (among other things) anchor a rectangular zone from a text label on the document. Any text falling within that zone will be extracted as the '''Data Field's''' result. The ''Read Zone'' extractor also allows you to optionally re-process the text's OCR result with the '''''OCR Profile''''' property.
| |
| | |
| #<li value=2> Here, the '''''OCR Profile''''' property references the '''OCR Profile''' named "Tesseract Cell OCR" in the '''OCR Profiles''' folder of the '''Global Resources''' folder.
| |
| |
| |
| [[File:Import-and-Export-Grooper-Objects-09.png]]
| |
| |-
| |
| |valign=top style="width:40%"|
| |
| # We're starting this export by right clicking the "Sample Content Model - Cow App" '''Content Model'''.
| |
| #* One of its child objects (the "Docket Number" '''Data Field''') contains a reference to an external object (the "Tesseract Cell OCR" '''OCR Profile''')
| |
| # Select "Share" and "Export to Zip Archive..."
| |
| # Note the '''''Items to Export''''' property lists Sample Content Model - Cow App ''+ 1 reference''. This indicates that external '''OCR Profile''' is already included in this export!
| |
| # You can verify or change this by pressing the ellipsis button at the end of the property.
| |
| |
| |
| [[File:Import-and-Export-Grooper-Objects-10.png]]
| |
| |-
| |
| |valign=top style="width:40%"|
| |
| Notice in the "References to Include" window the referenced '''OCR Profile''' named "Teseract Cell OCR" is included in this list of items. This window will list all referenced objects of the object (or objects) you have selected for export.
| |
| | |
| By default the box next to these references is checked, indicating it will be included in the export. However, if you wish to exclude a referenced object from the export, simply uncheck the box next to the listed object.
| |
| |
| |
| [[File:Import-and-Export-Grooper-Objects-11.png]]
| |
| |}
| |
| </tab>
| |
| </tabs>
| |
| | |
| === Importing Grooper Objects from a Zip File ===
| |
| | |
| <tabs style="margin:20px">
| |
| <tab name="Importing All Objects" style="margin:20px">
| |
| === Importing All Objects from a Zip Zile ===
| |
| | |
| {|cellpadding=10 cellspacing=5
| |
| |valign=top style="width:40%"|
| |
| This tutorial will start us off with the most basic import. This import will bring all Grooper objects into your Grooper Repository, ''even if copies of those objects exist in your repository''. We will look at how to deal with selectively importing objects and resolving duplicate object conflicts in the next tabs of this tutorial.
| |
| | |
| # To import a Grooper zip, right click the root node of your Grooper Repository.
| |
| # Select "Import" and "Compressed Archive..."
| |
| # A file browser window will appear. Locate the location of the Grooper zip file you wish to import.
| |
| # Select the file, here named "Sample Grooper Export (2.90)".
| |
| # Press the "Open" button.
| |
| |
| |
| [[File:Import-and-Export-Grooper-Objects-12.png]]
| |
| |-
| |
| |valign=top style="width:40%"|
| |
| # Press the "Execute" button to import the objects into your Grooper Repository.
| |
| #* A word of caution, without configuring the import this will create a new object if it does not exist in your Grooper Repository. However, if it ''does'' exist (and the object has the same GUID), it will ''overwrite'' that object. We will go over selectively importing objects and resolving duplicates in the next tabs.
| |
| # Upon successful import the following message box will appear. Press the "Ok" button to get back to Grooper.
| |
| |
| |
| [[File:Import-and-Export-Grooper-Objects-13.png]]
| |
| |-
| |
| |valign=top style="width:40%"|
| |
| All objects in that zip file will be copied to your Grooper Repository. The objects imported for our example are highlighted.
| |
| | |
| Their property information will be stored in this repository's database, and their files will be stored in the associated filestore.
| |
| |
| |
| [[File:Import-and-Export-Grooper-Objects-14.png]]
| |
| |}
| |
| </tab>
| |
| <tab name="Selectively Importing Objects" style="margin:20px">
| |
| COMING SOON
| |
| </tab>
| |
| </tabs>
| |
