Skip to main content
Skip table of contents

OPC-UA Interface Guide (Press Emulator)

PrePress Plugin v4.11.6782.0, Copyright (c) 2024 Global Graphics Software. All rights reserved.

Overview

The PrePress Plugin allows you to work on files before it goes to the press.

When the Open Platform Communications (OPC) server in PrePress Plugin is enabled an OPC node tree is published. The nodes in this tree represent grouped areas of state and functionality.

Default address: opc.tcp://localhost:26842/spc-prepress

Certificates

Communication between OPC UA clients and servers require both parties to possess their own application certificate. To enable further communication each party must trust the opposing certificate. This trust can be established automatically, programmatically or manually depending on the application's configuration or implementation. The certificate for Pre-Press plugin can be found in %programdata%\Global Graphics Software Ltd\PrePress Plugin\App Certificates\certs should you need to copy it to the Trusted Peer Certificate folder. In this release it will be a Self Signed Certificate issued by and for Pre-Press plugin.

OPC Methods

Any methods listed in this documentation will include details about their required parameters (if any), and return value.

In the event of an error please see the application log file for more information.

OPC Client Library

The following documentation provides guidance on using the Traeger Industry Components GmbH OPC client library for software developers working with PrePress Plugin.

Configuring Custom Message Sizes

The default maximum message sizes used by OPC clients to communicate to the server are sufficient for most use cases. However, to ensure transfer of larger data packets (such as retrieving some job thumbnail images) it may be necessary to configure the OPC client with custom values.

For example:

CODE
	Client = new OpcClient();
	Client.Transport.MaxArrayLength = 1024 * 1024 * 50;
	Client.Transport.MaxBufferSize = 1024 * 1024 * 50;
	Client.Transport.MaxMessageSize = 1024 * 1024 * 50;
	Client.Transport.MaxStringLength = 1024 * 1024 * 50;

See here for more information.

Adjusting Communication Timeouts

OPC clients regularly verify the responsiveness of the connection to the OPC server. However, in certain circumstances where the system is under heavy load, maintaining a responsive connection might not always be possible. To mitigate potential issues under such conditions, it is recommended to increase the default communication timeouts.

The example below demonstrates how to adjust the default values:

CODE
	var defaultTimeOut = (int)TimeSpan.FromMinutes(10).TotalMilliseconds;
	Client = new OpcClient
	{
	    // Don't auto-disconnect - Dispose the client to explicitly disconnect.
	    DisconnectTimeout = int.MaxValue,
	    KeepAlive = { Interval = defaultTimeOut },
	    SessionTimeout = defaultTimeOut,
	    OperationTimeout = defaultTimeOut,
	    ReconnectTimeout = defaultTimeOut
	};

Please note that the provided examples serve as illustrations, and it's important to tailor the configuration to your specific requirements.

PrePressSet

The top-level set containing all available OPC nodes.

Immediately underneath this root-level node are a categorized collection of sub-nodes, each encapsulating a different area of behavior.

Section Name

Description

HotFolders

This node tree provides access to the hot folder functionality, enabling external systems to monitor their count, media assignments, and if they are enabled.

PdfEditor

This node tree provides access to the selected PDF editor and the PDF arguments.

PrePressFolder

This node tree provides access to the PrePress folder functionality, to see the location and if it is enabled.

PrePressJobs

This node tree provides access to the jobs in the PrePress plugin.

SingleHotFolder

Describes the collection of nodes representing a single hot folder, positioned as a child of the 'HotFolder' node.

SingleJob

Describes the collection of nodes representing a single PrePress job, positioned as a child of the 'PrePressJobs' node.

WorkFlowFolder

This node tree provides access to the work flow folder functionality, the user can see the location of the folder and if it is enabled.

HotFolders

This node tree provides access to the hot folder functionality, enabling external systems to monitor their count, media assignments, and if they are enabled.

Details

These OPC nodes are fully populated to a consistent state when the OPC server starts, apart from hot folder nodes - These nodes are dynamically added and removed as hot folders are added and removed to/from the workflow.
(If there are already hot folders in the workflow, these will exist when the OPC server starts.)

Properties

Name

Type

Writable

Description

HotFoldersEnabled

Boolean

No

This indicates whether the hot folders are enabled.

PdfEditor

This node tree provides access to the selected PDF editor and the PDF arguments.

Properties

Name

Type

Writable

Description

PdfEditor

String

No

The location of the PDF editor.

PdfEditorArguments

String

No

The arguments for the PDF editor.

PrePressFolder

This node tree provides access to the PrePress folder functionality, to see the location and if it is enabled.

Properties

Name

Type

Writable

Description

PrePressFolder

String

No

The PrePress folder location.

PrePressJobs

This node tree provides access to the jobs in the PrePress plugin.

Details

These OPC nodes are fully populated to a consistent state when the OPC server starts, apart from PrePress job nodes - These nodes are dynamically added and removed as PrePress jobs are added and removed to/from the workflow.
(If there are already PrePress jobs in the workflow, these will exist when the OPC server starts.)

Properties

Name

Type

Writable

Description

LabelStudioIsOpen

Boolean

No

Whether any jobs have been opened in Label Studio.

SingleHotFolder

Describes the collection of nodes representing a single hot folder, positioned as a child of the 'HotFolder' node.

Properties

Name

Type

Writable

Description

ConfigName

String

No

The config name. This is either Label Studio file name or media name depending on which is used to configure the hot folder.

Copies

Int32

No

The number of copies to print when any file is put into hot folder.

Description

String

No

The description of Label Studio file. Empty if using media.

Guid

String

No

Unique hot folder descriptor.

Location

String

No

The location of the hot folder.

TargetMedia

String

No

The target media for the hot folder.

SingleJob

Describes the collection of nodes representing a single PrePress job, positioned as a child of the 'PrePressJobs' node.

Properties

Name

Type

Writable

Description

Guid

String

No

Unique job descriptor.

Name

String

No

This is the name of the job.

Status

String

No

This indicates the status of the job.

Values: Good, FailedToSendToWaitingQueue, FailedToSendToWorkflow, FailedToRemove

WorkFlowFolder

This node tree provides access to the work flow folder functionality, the user can see the location of the folder and if it is enabled.

Properties

Name

Type

Writable

Description

Location

String

No

The location of the work flow folder.

WorkflowEnabled

Boolean

No

This indicates whether the work flow is enabled.

WorkFlowFolderEnabled

Boolean

No

This indicates whether the work flow folder is enabled.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.