Skip to content
background-image background-image

ISDS - Sender

[ | version 3.0]

You are viewing outdated version, see the latest version

Connector

The connector is permitted for use of the platform background agent.

Connector processing type: Row by row!

This connector allows to send messages to CPost messagebox (smaller than 20MB). Attached files will be acquired from Xeelo User instance (identified by ServerUrl, Token and Attachment Hash).

This connecotr includes two functionalities:

  • Sending a new message to a single recipient This connector allows sending messages to CPost messagebox (smaller than 20MB). The attached files will be acquired from Xeelo User instance (identified by ServerUrl, Token, and Attachment Hash).

  • Sending a new message to multiple recipients This service allows you to send the same data message to multiple recipients' mailboxes. The message is sent once from the client, and the system duplicates it for each recipient, assigning unique identifiers to each message. Identification of messages sent at once by calling this service is not possible (only indirectly, e.g., by the same annotation). The number of recipients is limited by a constant, currently set to 50.

More information here.

Apple Users

  • For Apple users, it's essential to compress files via the terminal command to exclude hidden files, ensuring data mailbox compatibility.
  • Use: zip -r newNameForZipFolder.zip SourceFolder -x "*.DS_Store" -x "__MACOSX".

Windows Users

  • For Windows users, standard compression suffices as it does not generate hidden files, making the process straightforward and compatible with data mailboxes.

Configuration

ISDS Connection

Username

Defines the login name that is used for CPost messagebox authentication.

A placeholder can be used for input data.

Password

Defines the password that is used for CPost messagebox authentication.

A placeholder can be used for input data.

Credentials

Supported credential types:

  • ManualInput - login credentials are taken from this configuration properties UserName and Password.
  • TakeFromInput - login credentials are taken foreach input row from input data properties UserName and Password.

ISDS Environment

Testing Environment

When set to true messages are send to testing environment.

ISDS Xeelo Connection

Server URL

Xeelo User instance URL from which attachments will be retrieved using hash links.

Authorization Token

Xeelo User instance authorization token to acquire attachments.


Input & Output Schema

Input

ISDS Sender Input (ver. 1.1.0)

Column Data type Allow null Description
Annotation String Yes Important message text information
Type String Yes Message type - I or O
SenderOrgUnit String Yes Optional sender address data information
SenderOrgUnitNum Integer Yes Optional sender address data information
SenderRefNumber String Yes Message sender reference number
SenderIdent String Yes Message sender file number
RecipientRefNumber String Yes Message recipient reference number
RecipientIdent String Yes Message recipient file number
LegalTitleLaw Integer Yes Message law number information
LegalTitleYear Integer Yes Message law year information
LegalTitleSect String Yes Message law section information
LegalTitlePar String Yes Message law paragraph information
LegalTitlePoint String Yes Message law point information
PersonalDelivery Bool Yes Into their own hands flag
AllowSubstDelivery Bool Yes Allowed to deliver fiction flag
OVM Bool Yes Organ of public power information
OVMSpecified Bool No Organ of public power information flag is specified
PublishOwnID Bool Yes Add sender identity information to message
PublishOwnIDSpecified Bool No Add sender identity information to message flag is specified
Files ISDS Sender File 1.1.0 Yes Attached files
Recipients ISDS Sender Recipient 1.0.1 Yes Recipients
#### ISDS sender file (ver. 1.1.0)
Column Data type Allow null Description
Name String Yes Name of file
MetaType String No Meta type
XeeloAttachmentHash String No Xeelo Attachment Hash for getting attachment from Xeelo
FileGuid String Yes Internal marking information about document
UpFileGuid String Yes Internal marking information about document connection
Format String Yes May contain form name for fill XML data

MetaTypes:

  • main - the first document file
  • enclosure - attachment file
  • signature - digital signature file
  • meta - specific XML data formated file

ISDS Sender Recipient (ver. 1.0.1)

Column Data type Allow null Description
IDRecipient String No Recipient Messagebox identification
ToHands String Yes Information for whom the message is intended
RecipientOrgUnit String Yes Optional recipient address data information
RecipientOrgUnitNum Integer Yes Optional recipient address data information

Output

Result of ISDSSender connector are informations about sended message ID.

ISDS Sender Output (ver. 1.0.1)

Column Data type Allow null Description
ID String No ID of message

Release notes

3.0.9

  • The latest version of the connector now supports seamless file sending suitable for data mailboxes.
  • Find more information about the changes here.

3.0.7

  • Fixed loading dependant WCF libraries.

3.0.6

  • Plugin binaries update as a result of included connector change.

3.0.5

  • Updated package binaries because of changes in another included connector.

3.0.4

  • Fixed shared nuget package versions.

3.0.3

  • Fixed right processing of nullable properties.