[N] Parameters for PLC Tag Addressing

<< Click to Display Table of Contents >>

 

[N] Parameters for PLC Tag Addressing

Reading or Writing

 

N1

Function for this Driver. For more information, please check the next table

N2

Sub-function for this Driver. For more information, please check the next table

N3

Additional parameter, if needed

N4

Not used

 

The Tags containing all supported operations are available to users via Tag Browser. If users want to directly configure these Tags, use the functions described on the next table.

Available functions for this Driver

N1

N2

N3

Mode

Description

0

0 (zero)

Not used

Reading and Writing

Text for the To (recipient) field. For more than one recipient, separate e-mail addresses with a comma or a semicolon

1 (one)

Not used

Reading and Writing

Text for the CC (carbon copy) field. For more than one recipient, separate e-mail addresses with a comma or a semicolon

2

Not used

Reading and Writing

Text for the BCC (blind carbon copy) field. For more than one recipient, separate e-mail addresses with a comma or a semicolon

1

Not used

Not used

Reading and Writing

Text for the Subject field

2

Not used

Not used

Reading and Writing

Text for an e-mail's body

3

0 (zero)

Not used

Write-Only

Defines a priority level and sends a message. Writing values to define an e-mail priority are 0: Normal, 1: High, or 2: Low. The N2 parameter changes the format for sending a message. Possible values are 0: Text without formatting (Plain Text) or 1: Text in HTML format. For more information, please check the next table

1 (one)

Not used

Write-Only

4

Not used

Not used

Reading and Writing

When reading, generates a log with configurations of the e-mail server. When writing, specifies a path, full or relative, to a file or to several files separated by a vertical bar to send as attachments of an e-mail. For example, to send an attached file, use AttachTag equal to "file1.txt". To send two attached files, use AttachTag equal to "file1.txt | file2.txt"

5

Not used

Not used

Write-Only

Name of the user used for SMTP authentication. Writing is available when the Secure Authentication option is not selected on this Driver's properties window

6

Not used

Not used

Write-Only

Password of a user or application used for SMTP authentication. For more information, please check this article about two-factor authentication on Elipse Knowledgebase. Writing is available when the Secure Authentication option is not selected on this Driver's properties window

7

Not used

Not used

Reading and Writing

Text for the sender's name

8

Not used

Not used

Reading and Writing

Text for the sender's e-mail address

9

Not used

Not used

Reading and Writing

Text for the SMTP server's address

10

Not used

Not used

Reading and Writing

Number of the TCP/IP port of an SMTP server

11

0 (zero)

0 (zero)

Reading and Writing

Name of an external text file, with content saved in ANSI standard, to fill an e-mail's body

0 (zero)

1 (one)

Reading and Writing

The first line of the external text file fills e-mail's Subject field

1 (one)

0 (zero)

Reading and Writing

Name of an external text file, with content saved in Unicode standard, to fill e-mail's body

1 (one)

1 (one)

Reading and Writing

The first line of the external text file fills the Subject field of an e-mail

90 (only for Elipse E3, Elipse Power, or Elipse Water)

Not used

Not used

Read-Only

Tag exclusive for Elipse E3, Elipse Power, or Elipse Water used to monitor the status of asynchronous writing operations using the Tag's WriteEx method with the WriteSyncMode parameter equal to 2 (two). Returns the values 0: Initial status, received when triggering an asynchronous writing using the Tag's WriteEx method with the WriteSyncMode parameter equal to 2 (two), 1: Result of a successful asynchronous writing, or Error Code: Result of a failed asynchronous writing. For more information, please check topic Error Codes for Writing Tags

 

NOTES

For the N1 parameter equal to 11, the name of the external text file must be informed in ANSI standard, regardless of whether its content is saved in ANSI or Unicode standard. For content saved in Unicode standard, its byte order must be in the UTF-16 Little Endian format.

Sending a message occupies an application for a few seconds. To prevent this, asynchronous writings must be performed using the WriteSyncMode parameter of the WriteEx method with the value 2 (two) in Tags with the N1 parameter equal to 3 (three) or configuring the WriteSyncMode property of this Driver with the value 2 (two, wsmAsyncUnconfirmed).

 

Examples of HTML Tags

HTML TAG

DESCRIPTION

USAGE

RESULT

<b>

Bold text

Text in <b>bold</b>

Text in bold

<i>

Italic text

Text in <i>italic</i>

Text in italic

<u>

Underlined text

<u>Underlined</u> text

Underlined text

<h1> to <h6>

Defines different levels of headings, in which the level 1 (one) is the most important

<h1>Main title</h1>

Main title

<p>

Define a paragraph of text

<p>This is an example paragraph</p>

This is an example paragraph

<br>

Inserts a line break within a paragraph

<p>This is an example text.<br>And it has a line break.</p>

This is an example text.

It has a line break.

<a>

Creates a link to another page or resource

<a href="Path">Link</a>

Link

<img>

Inserts an image

<img src="Image path" alt="Image description">

(The image to be displayed)

<hr>

Inserts a horizontal line that separates content

<p>Paragraph 1</p>

<hr>

<p>Paragraph 2</p>

Paragraph 1


Paragraph 2

 

NOTE

To change the color of any text, insert a style attribute in the HTML Tag with a color value in Hexadecimal or RGB (Red, Green, and Blue) format, according to the next examples:

<p style='color:#9BBB59;'>This is an example paragraph</p>: This is an example paragraph

<p style='color:rgb(247, 150, 70);'>This is an example paragraph</p>: This is an example paragraph

Was this page useful?