Skip to content

lib-finMail 库参考 ​

原文: https://finproducts.atlassian.net/wiki/spaces/JIDD3/pages/34793357944/FIN+5.3.1+lib-finMail 中文整理基于 FIN 5.3.1

导读: FIN 电子邮件客户端扩展

以下为 API 参考,保留英文以便对照源码;目录已列出(英文标题便于检索);概述已尽量中译。


目录(导读) ​


概述(中译) ​

FIN 电子邮件客户端扩展


API 正文(英文) ​

tags ​

finMailBodyPresent if the email body is bigger than 1024 chars, it stores to body as Bin
finMailConnMarker tag for finMail connection
finMailConnRefUsed on a proxy object to reference its parent finMailConn
finMailContentThe first 1024 characters of the email content (body)
finMailDEBUGMarker tag to set the mail connection in debug mode
finMailFromComma separated list of From addresses
finMailMaxMsgCountSet the maximum numbers of email records this connector can store
finMailNewMessagesShows the number of unread email
finMailPollFreqApplied to finMailConn to tune the duration between email checks
finMailRecMarker tag for an email message record
finMailReplyToComma separated list of Reply To addresses
finMailSSLMarker tag to set the connection to use SSL
finMailSentDateThe email Sent date
finMailSubjectThe email Subject
finMailToComma separated list of To addresses
finMailTotalMessagesShows the number of email on the inbox folder

funcs ​

finMailPingAsynchronously ping an finMail connector Examples


def ​

finMailBody ​

Present if the email body is bigger than 1024 chars, it stores to body as Bin. Missing otherwise


meta ​

deffinMailBody
isxstr
liblib:finMail

supertypes ​

valData value type
scalarScalar is an atomic value kind
xstrExtended string - type name and string value encoding


def ​

finMailConn ​

Marker tag for finMail connection.


meta ​

deffinMailConn
ismarker
liblib:finMail

supertypes ​

markerMarker labels a dict with typing information


def ​

finMailConnRef ​

Used on a proxy object to reference its parent finMailConn


meta ​

deffinMailConnRef
isref
liblib:finMail

supertypes ​

valData value type
scalarScalar is an atomic value kind
refReference to an entity


def ​

finMailContent ​

The first 1024 characters of the email content (body)


meta ​

deffinMailContent
isstr
liblib:finMail

supertypes ​

valData value type
scalarScalar is an atomic value kind
strUnicode string of characters


def ​

finMailDEBUG ​

Marker tag to set the mail connection in debug mode.


meta ​

deffinMailDEBUG
ismarker
liblib:finMail

supertypes ​

markerMarker labels a dict with typing information


def ​

finMailFrom ​

Comma separated list of From addresses


meta ​

deffinMailFrom
isstr
liblib:finMail

supertypes ​

valData value type
scalarScalar is an atomic value kind
strUnicode string of characters


def ​

finMailMaxMsgCount ​

Set the maximum numbers of email records this connector can store


meta ​

deffinMailMaxMsgCount
isnumber
liblib:finMail

supertypes ​

valData value type
scalarScalar is an atomic value kind
numberInteger or floating point numbers annotated with an optional unit


def ​

finMailNewMessages ​

Shows the number of unread email


meta ​

deffinMailNewMessages
isnumber
liblib:finMail

supertypes ​

valData value type
scalarScalar is an atomic value kind
numberInteger or floating point numbers annotated with an optional unit


def ​

finMailPollFreq ​

Applied to finMailConn to tune the duration between email checks. If not configured it defaults to 1min.


meta ​

deffinMailPollFreq
isnumber
liblib:finMail

supertypes ​

valData value type
scalarScalar is an atomic value kind
numberInteger or floating point numbers annotated with an optional unit


def ​

finMailRec ​

Marker tag for an email message record.


meta ​

deffinMailRec
ismarker
liblib:finMail

supertypes ​

markerMarker labels a dict with typing information


def ​

finMailReplyTo ​

Comma separated list of Reply To addresses


meta ​

deffinMailReplyTo
isstr
liblib:finMail

supertypes ​

valData value type
scalarScalar is an atomic value kind
strUnicode string of characters


def ​

finMailSSL ​

Marker tag to set the connection to use SSL.


meta ​

deffinMailSSL
ismarker
liblib:finMail

supertypes ​

markerMarker labels a dict with typing information


def ​

finMailSentDate ​

The email Sent date


meta ​

deffinMailSentDate
isdateTime
liblib:finMail

supertypes ​

valData value type
scalarScalar is an atomic value kind
dateTimeISO 8601 timestamp followed by timezone identifier


def ​

finMailSubject ​

The email Subject


meta ​

deffinMailSubject
isstr
liblib:finMail

supertypes ​

valData value type
scalarScalar is an atomic value kind
strUnicode string of characters


def ​

finMailTo ​

Comma separated list of To addresses


meta ​

deffinMailTo
isstr
liblib:finMail

supertypes ​

valData value type
scalarScalar is an atomic value kind
strUnicode string of characters


def ​

finMailTotalMessages ​

Shows the number of email on the inbox folder


meta ​

deffinMailTotalMessages
isnumber
liblib:finMail

supertypes ​

valData value type
scalarScalar is an atomic value kind
numberInteger or floating point numbers annotated with an optional unit


def ​

func:finMailPing ​

finMailPing(conn) ​

Asynchronously ping an finMail connector Examples:

read(finMail).finMailPing
finMailPing(finMail)

Side effects:

  • performs async network IO on background thread
  • emailServerName: updated if ping successful
  • emailProtocolName: updated if ping successful

meta ​

admin✓
deffunc:finMailPing
isfunc
liblib:finMail
namefinMailPing

supertypes ​

featureFeature namespace of definitions formatted as feature:name
funcAxon function