<< Click to Display Table of Contents >>
[N] Parameters for PLC Tag Addressing |
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). |
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 |