Call SEAL OP-CLI Built-In Scripts¶
The built-in scripts are located in the following directory:
-
Windows:
C:\Program Files\SEAL Systems\seal-opcli\lib\script\builtin -
Linux:
/opt/seal/seal-opcli/lib/script/builtin
Print Documents (print-docs)¶
The print-docs built-in script uploads a single file or all files in a directory to SEAL Operator and outputs them via PLOSSYS 4.
opcli script exec print-docs --localfile <fileOrDirectory> -p printer=<printerName> -p service-id=<serviceId> [-p cleanup] [-p <printParamKey>=<PrintParamValue>]+
-
--localfile <fileOrDirectory>: Local file to be printed or local directory containing files to be printed; wildcards are supported; mandatory -
-p printer=<printerName>: Parameter passed to theprint-docsscript: Name of the printer on which the local files are output; mandatory -
-p service-id=<serviceId>: Parameter passed to theprint-docsscript; type of the connector for uploading the file; available values:operator-p4and other connectors possibly configured in SEAL Operator; mandatory -
-p cleanup: Parameter passed to theprint-docsscript: Flag that the local files are deleted after running theprint-docsscript successfully -
-p <printParamKey>=<printParamValue>: Parameter passed to theprint-docsscript; arbitrary key-value pair passed as print parameter to PLOSSYS 4, for examplePLS_PLOTCOPYorPLS_DUPLEX
Example - output the local file, myFile.txt, to the myPrinter printer, duplex and with 3 copies
opcli script exec print-docs --localfile myFile.txt -p service-id=operator-p4 -p printer=myPrinter -p PLS_DUPLEX=LONG_SIDE -p PLS_PLOTCOPY=2
Upload to Shopping Cart (shopping-cart)¶
The shopping-cart built-in script uploads a single file or all files in a directory to SEAL Operator. It creates a shopping cart task unless one already exists. It adds the uploaded documents to the shopping cart task. Unless a shopping cart panel for operator-p4 exists (PLOSSYS Pool), the panel is created. The shopping cart task is added to the panel. If no user interface session is open, the default Web browser is started and the shopping cart panel is displayed.
opcli script exec shopping-cart --localfile <fileOrDirectory> -p service-id=<serviceId> [-p type=<panelType>] [-p printer=<printerName>] [-p url=<uiURL>] [-p cleanup]
-
--localfile <fileOrDirectory>: Local file to be uploaded or local directory containing files to be uploaded; wildcards are supported; mandatory -
-p service-id=<serviceId>: Parameter passed to theshopping-cartscript; type of the connector for storing the file; available values:operator-p4and other connectors possibly configured in SEAL Operator; mandatory -
-p type=<panelType>: Parameter passed to theshopping-cartscript; type of the panel if the backend system supports more than one panel -
-p printer=<printerName>: Parameter passed to theshopping-cartscript: Name of the printer on which the files are output if the backend system has printers -
-p url=<uiURL>: Parameter passed to theshopping-cartscript: URL of the user interface; default:https:\\localhost:3000 -
-p cleanup: Parameter passed to theshopping-cartscript: Flag that the local files are deleted after running theshopping-cartscript successfully
Example - upload the files contained in the myShopping directory to the shopping cart panel, add the files to the PLOSSYS 5 panel, set the printer to myPrinter and delete the local files afterwards
opcli script exec shopping-cart --localfile myShopping -p service-id=operator-p5 -p printer=myPrinter -p cleanup
Upload Documents (upload-docs)¶
The upload-docs built-in script uploads a single file or all files in a directory to SEAL Operator. It creates a new panel which contains the uploaded files. If no user interface session is open, the default Web browser is started.
opcli script exec upload-docs --localfile <fileOrDirectory> -p service-id=<serviceId> [-p cleanup] [-p name=<panelName>]
-
--localfile <fileOrDirectory>: Local file to be uploaded or local directory containing files to be uploaded; wildcards are supported; mandatory -
-p service-id=<serviceId>: Parameter passed to theupload-docsscript; type of the connector for uploading the file; available values:operator-p4and other connectors possibly configured in SEAL Operator; mandatory -
-p cleanup: Parameter passed to theupload-docsscript: Flag that the local files are deleted after running theupload-docsscript successfully -
-p name=<panelName>: Parameter passed to theupload-docsscript: Name of the panel; default: generated UUID
Example - upload the files contained in the myDirectory directory to the myPanel panel and delete the local files afterwards
opcli script exec upload-docs --localfile myDirectory -p service-id=operator-p4 -p name=myPanel -p cleanup
Upload a Repro List (upload-rli)¶
The upload-rli built-in script uploads a repro list file to SEAL Operator. It creates a new panel with the content of the uploaded repro list file. If no user interface session is open, the default Web browser is started.
opcli script exec upload-rli --localfile <reproListFile> -p service-id=<serviceId> [-p cleanup] [-p name=<panelName>]
-
--localfile <reproListFile>: Repro list file to be uploaded; wildcards are supported; mandatory -
-p service-id=<serviceId>: Parameter passed to theupload-rliscript; type of the connector for uploading the repro list file; available values:operator-p4and other connectors possibly configured in SEAL Operator; mandatory -
-p cleanup: Parameter passed to theupload-rliscript: Flag that the local repro list file is deleted after running theupload-rliscript successfully -
-p name=<panelName>: Parameter passed to theupload-rliscript: Name of the panel; default: generated UUID
Example - upload the myReproList.rli repro list file to the myPanel panel
opcli script exec upload-rli --localfile myReproList.rli -p service-id=operator-p4 -p name=myPanel
Create a Web Portal Share (create-webportal)¶
The create-webportal built-in script creates a Web Portal share in SEAL Operator and adds files to it.
opcli script exec create-webportal --localfile <fileOrDirectory> [--localfileformat <format>] [--owner <owner>] -p name=<name> [-p description=<description>] [-p shared-with=<shared-with>] [-p expiration=<expiration>] [-p access-notification=<Y|N>] [-p cleanup]
-
--localfile <fileOrDirectory>: Local file or local directory containing files to be added to the share; wildcards are supported; mandatory -
--localfileformat <format>: The file specified in--localfileis interpreted as an order file containing the file names and additional parameters; available value:json; optional -
--owner <owner>: Impersonated owner; optional -
-p name=<name>: Parameter passed to thecreate-webportalscript; name of the share to be created; mandatory -
-p description=<description>: Parameter passed to thecreate-webportalscript; description of the share; optional -
-p shared-with=<shared-with>: Parameter passed to thecreate-webportalscript; space separated list of email addresses of users to share the share with; optional -
-p expiration=<expiration>: Parameter passed to thecreate-webportalscript; expiration date in msec from 1.1.1970; default: 10 days after creation of the share; optional -
-p access-notification=<Y|N>: enables or disables share access notifications - default is Y'; optional -
-p cleanup: Parameter passed to thecreate-webportalscript; flag; if set the local files used for the share will be deleted after running thecreate-webportalscript successfully; optional
Example - share for a single recipient with no access notification, expires 10 days after creation
opcli script exec create-webportal -p name="Nice documents" -p shared-with="anna@karenina.com" -p description="A bunch of nice documents" -p expiration=10d -p access-notification=N --localfile blabla.pdf
Example - share with access notification and owner, expires 12 hours after creation, local file will be deleted after the successful creation of the share
opcli script exec create-webportal -p name="Nice documents" -p shared-with="anna@karenina.com" -p description="A bunch of nice documents" -p expiration=12h -p access-notification=Y -p cleanup --owner "fjodor" --localfile blabla.pdf
Example - share for multiple recipients, documents to add provided by a JSON file; expires on Dec. 31 2023, at 10:00 am
opcli script exec create-webportal -p name="Nice documents" -p shared-with="anna@karenina.com gregor@samsa.com" -p description="A bunch of nice documents" -p expiration=1704013200 -p access-notification=Y --owner "fjodor" --localfileformat json --localfile files.json