Documentation and help portal

SDK commandline referance

Calling-Conventions

The regify_client.exe can be called without any parameter. Upon this, the standard-dialog for creating a new regify-file and send it by SMTP mail opens up.

Additionally, some other special functions are possible:

option parameter

-h

Show help information.

-l

Specifies log file to log to. No logging will be done without this.

-v

Verbose mode. Increases log level to verbose. Requires -l.

-b

All given string(!) parameters are utf8 and then base64 encoded (command line input)

-C

Open/show configuration Dialog.

-D

Decrypt and display regimail in regify GUI.

-E

Extract regimail/regipay to destination folder.

-G

Get regify configuration.

-I

Invite user for regify.

-M

Create regimail.

-P

Open compose dialog in regify GUI.

-R

Request transaction information.

Many functions require additional parameters. See individual function description below for details.

All parameters should be encoded in UTF-8. In case there is an empty space in the parameter, you have to use quotation-marks (ASCII 34) to enclose the parameter.

By using the -b option, you have to encode all string parameters in utf-8 and then base64 encode. By this, no commandline or shell issues will come up for encoding.
This is the prefferred method!

Without -b option, it is strongly recommended to enclose every string parameter in quotation-marks except of the command itself and the numeric fields. Better to use -b option!

Information about the used configuration

Using the regify_client.exe in commandline-mode is the most simple option to use regify from within other software or in batch process jobs. By calling the regify_client.exe, the configuration is taken from the current users regify configuration settings. You can edit theese settings by calling the regify client manually and pressing the settings-button or by calling it using the -C option.

Functions Reference

-D command - Decrypt

Using the -D command allows you to open a received regify-file or a regify identity-file using a comfortable graphical userinterface. This is the default behavior if only one RGF file is given.

The -D command has one mandatory parameter:

Parameter Information

regify-file
or
identity-file
or
-i regify-file
or
-i identity-file

Use the complete regify-file filename or identity-file filename as parameter to open the displaying interface.

Calling-examples

Both calls open the regify-file for display:

regify_client.exe -D -i "c:\my_regify-file.rgf"
regify_client.exe "c:\my_regify-file.rgf"

Opens a regify identity-file for display:

regify_client.exe -D -i "c:\my_identity.rif"

-M command - Create

The -M command allows you to create a new regify-file without showing any dialog. The complete client-configuration is used. Upon this, there are not many additional information needed to generate a new regify-file.

This function is mentioned for application-environments without user intervention.

The -M command has several parameters:

Parameter Information

-o destination-containername

The name of the destination container has to end with .rgf. If you implementing for Outlook, Novell Groupwise or Lotus Notes, the filename should be regify-file.rgf. This file is not allowed to exist in the moment the program is called.

The letters TNR (uppercase!) can be used as a filename-placeholder for the transaction id(s). The file will be renamed automatically after creation.

-i textfile with body-message

The given textfile has to contain the complete message-body in plain ASCII-format (UTF-8 encoded) or HTML. Please name the ascii message with .txt extension and the HTML message with .hml extension.

-s subject

The subject of this e-mail (UTF-8 if possible). If you need quotation-marks (") in your subject, you can encode them with #CM#. The regify client will reconvert this into quotation-marks. Better encode with -b and base64.

-r recipient

Recipients have to be given as clean mailaddressess and are not allowed to contain special characters or other text (for a bad example: "Klaus Müller <k.mueller@inter.net>". For a good example: "k.mueller@inter.net").

Multiple recipient-addresses should be divided by comma (,) with no spaces (Example: "aaa@abc.de,bbb@abc.de").

-d reminder-days

The number of days to remind of this message if it was not opened. The range is 1 to 30. This field should be filled with one of the given values: 1,2,3,5,7,10

-c address

Optional communication e-mail address (similar to sender address). Overrides settings!

-n address

Optional sender name. Overrides settings!

file1 - fileN

The complete filenames (including the full path each) of the files for including as attachment. Divide multiple attachments with a single space character (like the other parameters).

Calling-example

Creates a regify-file and starts transaction.

regify_client.exe -M -o "c:\temp\regify-file_TNR.rgf" -i "c:\temp\Message.txt" -s "This is a Test" -r "empfaenger@inter.net" -d 10 "c:\temp\Attach1.jpg" "c:\temp\Attach2.doc"

Output description

If the given containerfile is existing after termination of the regify_client.exe, everying has been fine. The e-mail can be processed now. If the containerfile does not exist, there has been an error and the data must be kept in the original state and not sent!

-C command - Config

Using the -C command allows you to display the GUI for configuring the regify_client.exe. The only dialog displayed will be the configuration-dialog. As there are two ways to use the regify_client.exe, you can choose between a SMTP enabled mode and SMTP disabled mode. For future functionality, other parameters may follow.

Parameter Information

{none}

Leaving the parameter empty (no parameter) will open the configuration-dialog including the complete SMTP account settings.

OUTLOOK

This parameter disables the SMTP account settings pane and the signature settings pane. The user can only manage non smtp- e-mail specific data.

This is meant for all external calls that need to prevent the user from entering smtp specific data (for example Outlook, Lotus Notes etc.).

Calling-example

Opens the regify configuration dialog without SMTP settings:

regify_client.exe /CONFIG OUTLOOK

-I command - Invite

By using the -I command, the regify client invokes a little browser-window that opens up a special website for user invitement. The website called is defined in the customize.ini file in your regify client installation folder. The value-name is InviteUserURL. If this is empty or not set, calling this command will result in an error-message.

-E command - Extract

You can use the regify_client.exe to extract a regify-file without any user-interaction. For this functionality, the -E command is intended.

Parameter Information

-i regify-file

The regify-file to be extracted. Please use a complete path.

-o output-folder

Please insert an existing, empty folder as parameter. This is the path wich will get used for content extraction of the given regify-file.

Output description

The /EXTRACT function will extract the complete content into the given output-folder. All attached files will extract with the identical filenames. The regify-specific content will get special filenames:

Filename Description

_r_Body.asc

The body of the message in ASCII format. This file is only created, if the message content has been created in ASCII format.

_r_Body.html

The body of the message in HTML format. This file is only created, if the message content has been created in HTML format.

_r_Subject.asc

The subject of the message in ASCII format.

_r_Sender.asc

The sender addresses in ASCII format.

_r_Recipient.asc

The recipient addresses in ASCII format.

_r_CreationDate.asc

The message creation date in the following format: YYYY/MM/DD HH/MM/SS

This is the time of the sending computer while creation process of the regify-file. It is not a certified date.

Calling-example

Opens the regify-file and extracts the content into path:[c:\temp\regify\]:

regify_client.exe /EXTRACT "c:\my_file.rgf" "c:\temp\regify\"
The output-folder needs to be empty before calling /EXTRACT.
Please ensure, that your application deletes the content of the output-folder after work.

-P command - Compose

By using the -P command, you are aple to open the regify-Client in edit-mode with pre-defined content. The user is able to manipulate the content after this.

The -P command has several parameters that need to be assigned in exactly this order

Parameter Information

-i textfile with body-message

The given textfile has to contain the complete message-body in plain ASCII-format.

There is no HTML or RTF allowed.

-s subject

The subject of this e-mail (UTF-8 if possible). If you need quotation-marks (") in your subject, you can encode them with #CM#. The regify client will reconvert this into real quotation-marks.

-r recipient

Recipients have to be given as clean mailaddressess and are not allowed to contain special characters or other text (for a bad example: "Klaus Müller <k.mueller@inter.net>". For a good example: "k.mueller@inter.net").

Multiple recipient-addresses should be divided by comma (,) with no spaces (Example: "aaa@abc.de,bbb@abc.de").

-d reminder-days

The number of days to remind of this message if it was not opened. The range is 1 to 30. This field should be filled with one of the given values: 1,2,3,5,7,10

file1 - fileN

The complete filenames (including the full path each) of the files for including as attachment.

Calling-example

Opens regify compose dialog and pre-fills GUI:

regify_client.exe -P -i "c:\temp\Message.txt" -s "This is a Test" -r "empfaenger@inter.net" -d 10 "c:\temp\Attach1.jpg"

-G command – Get Configuration

The -G command is for regify internal use only. It offers to store regify provider configuration on a place you can need it.

Parameter Information

-e address

E-mail address registered with regify. Optional if URL is specified.

-p password

regify account password. Optional if URL is specified.

-U url

The URL to reach the regify service
(like https://portal.regify.com).

Optional if email and password are specified.

-o path

The complete filename incl. path to the result file to create (overwrite!).

-R command – Request Transaction Information

Using the -R command allows you to get the status of a given regify transaction (must be yours!)

Parameter Information

-i list

A list of transaction id’s you want to get information about.

The list is seen as string and needs to divide multiple numbers by commas or semicolon.

-o

The complete filename incl. path to the result JSON file to create (overwrite!).