Page History
...
Export-JS7InventoryItem
SYNOPSIS
Export Exports inventory objectsitems, e.g. workflows, schedules etc. from JOC Cockpit
...
Export-JS7InventoryItem [[-Path] <String>] [[-Type] <String[]>] [[-Folder] <String>] [-Recursive] [-Releasable] [-Deployable] [-WithoutDraftsNoDraft] [-WithoutReleasedNoReleased] [-WithoutDeployedNoDeployed] [-Latest] [-Valid] [-WithoutRemovedNoRemoved] [-ForSigning] [[-ControllerId] <String>] [[-FilePath] <String> ] [[-Format] <String>] [[-AuditComment] <String>] [[-AuditTimeSpent] <Int32>] [[-AuditTicketLink] <Uri>] [<CommonParameters>]
...
This cmdlet exports inventory objects items that are stored with JOC Cockpit.
* Deployable Objects: use of the -Deployable parameter
** Inventory objects items such as workflows are deployed to a JS7 Controller. The -Type parameter can be used to restrict object types.
** When exporting deployable objects then either a draft version can be used or the latest deployed version is requested by use of the -Deployed parameter.
* Releasable Objects: use of the -Releasable parameter
** Inventory objects items such as calendars and schedules are not deployed to a Controller but are used by JOC Cockpit.
** When exporting releasable objects then either a draft version can be used or the latest released version is requested by use of the -Released parameter.
An export is performed either to backup deployable and releasable objects that later on can be imported,
or to export objects for signing and later deployment with a JOC Cockpit operated in security level "high"HIGH.
The process to export objects for signigng includes the following steps:
* export deployable objects to a compressed archive (.zip, .tar.gz),
* unzip the archive to the local file system,
* manually sign objects,
* zip signed objects and signature files to a compressed archive,
* import the archive and deploy the signed objects.
The following REST Web Service API resources are used:
* /inventory/deployable
* /inventory/deployables
* /inventory/releasable
* /inventory/releasables
* /inventory/export
PARAMETERS
Path
-Path <String>
Specifies the path and name of an individual inventory object item that should be exported, e.g. a workflow.
...
-Type <String[]>
Optionally restricts the object type to export which is one of:
* Any Object Type
** FOLDER
* Deployable Object Types
** WORKFLOW
** FILEORDERSOURCE
** JOBRESOURCE
** NOTICEBOARD
** LOCK
* Releasable Object Types
** INCLUDESCRIPT
** WORKINGDAYSCALENDAR
** NONWORKINGDAYSCALENDAR
** SCHEDULE
The -Type parameter can be used to restrict either deployable or releasable object types to be exported.
Without specifying this parameter objects of any type within the areas of releasable or and deployable objects are exported
depending on use of the -Releasable and -Deployable parameters.
...
-Folder <String>
Optionally specifies the folder for which all included inventory objects items should be exported.
This parameter is used alternatively to the -Path parameter that specifies export of an individual inventory objectitem.
| Required? | false | |
| Position? | 3 | |
| Default value | / | |
| Accept pipeline input? | true (ByPropertyName) | |
| Accept wildcard characters? | false |
...
-Releasable <SwitchParameter>
Specifies that only releasable objects should be exported that include the object types:
* INCLUDESCRIPT
* WORKINGDAYSCALENDAR
* NONWORKINGDAYSCALENDAR
* SCHEDULE
If none of the parameters -Releasable or -Deployable is used then both releasable and deployable inventory objects items are exported.
| Required? | false |
| Position? | named |
| Default value | False |
| Accept pipeline input? | true (ByPropertyName) |
| Accept wildcard characters? | false |
...
-Deployable <SwitchParameter>
Specifies that only deployable objects should be exported that include the object types:
** WORKFLOW
** FILEORDERSOURCE
** JOBRESOURCE
** NOTICEBOARD
** LOCK
If none of the parameters -Releasable or -Deployable is used then both releasable and deployable inventory objects items are exported.
| Required? | false |
| Position? | named |
| Default value | False |
| Accept pipeline input? | true (ByPropertyName) |
| Accept wildcard characters? | false |
...
NoDraft
-WithoutDrafts NoDraft <SwitchParameter>
Specifies that no draft versions of releasable or deployable objects will be exported but only released/deployed versions.
Without this parameter the draft version of the inventory object item will be exported if available.
If this switch is in place then depending on the presence of the -Latest parameter for deployable objects either the only the latest
deployed version or depending on availabilitywill be used for export.
| Required? | false |
| Position? | named |
| Default value | False |
| Accept pipeline input? | true (ByPropertyName) |
| Accept wildcard characters? | false |
...
NoReleased
-WithoutReleased NoReleased <SwitchParameter>
Specifies that no released versions of the releasable objects will be exported but only draft versions if available.
Without this parameter any draft versions and released versions of inventory objects will be exported.
| Required? | false |
| Position? | named |
| Default value | False |
| Accept pipeline input? | true (ByPropertyName) |
| Accept wildcard characters? | false |
...
NoDeployed
-WithoutDeployed NoDeployed <SwitchParameter>
Specifies that no deployed versions of deployable objects will be exported but only draft versions.
Without this parameter the draft version of the inventory object will be exported if available.
...
-Latest <SwitchParameter>
Specifies that for deployable objects the latest deployed version is eligible for export.
| Required? | false |
| Position? | named |
| Default value | False |
| Accept pipeline input? | true (ByPropertyName) |
| Accept wildcard characters? | false |
...
| Required? | false |
| Position? | named |
| Default value | False |
| Accept pipeline input? | true (ByPropertyName) |
| Accept wildcard characters? | false |
...
NoRemoved
-WithoutRemoved NoRemoved <SwitchParameter>
Optionally specifies that no removed objects should be added to the export file. Such objects are marked for deletion, however,
deletion has not yet been confirmed by a deploy/release operation that permanently erases objects.
...
-ForSigning <SwitchParameter>
Specifies that deployable objects are exported for external signing and later import into a JOC Cockpit
instance operated for security level "high"HIGH.
* The export file cannot include releasable objects as such objects are not subject to signing.
* The export file must be created from the same JOC Cockpit instance to which it will be imported for deployment.
* The process of export/signing/import must not exceed the max. idle time that is configured for a user's JOC Cockpit session.
Without this parameter the export file is created for backup purposes and can include any deployable and releasable objects.
...
-FilePath <String>
Specifies the path to the archive file that the exported inventory objects are written to.
If no file path is specified then an octet stream is returned by the cmdlet.
| Required? | falsetrue |
| Position? | 5 |
| Default value | |
| Accept pipeline input? | true (ByPropertyName) |
| Accept wildcard characters? | false |
...
PS > Export-JS7InventoryItem | Out -File /tmp/export.zip
Exports all inventory objects to a zipped octet-stream that is written to a file. This includes deployable and releasable inventory objects. By default draft versions and deployed or released versions are used.
-------------------------- EXAMPLE 2 --------------------------
PS > Export-JS7InventoryItem -Folder /some_folder -FilePath /tmp/export.tar.gz -Format TAR_GZ
Exports any objects from the given folder to a compressed tar file. This includes deployable and releasable inventory objects. By default draft versions and deployed or released versions are used.
-------------------------- EXAMPLE 3 2 --------------------------
...
-------------------------- EXAMPLE 4 3 --------------------------
...
-------------------------- EXAMPLE 5 4 --------------------------
...
-------------------------- EXAMPLE 6 5 --------------------------
PS > Export-JS7InventoryItem -Folder /some_folder -Deployable -File FilePath /tmp/export.zip
Exports any deployable inventory objects items such as workflows, resource locks etc. that are available from the specified folder to a zipped file. The latest deployed version of the workflow objects is used.
Overview
Content Tools