TruxtonCommunication - Revision history

Sam: /* sent: datetime | int */

2025-04-16T15:07:58Z

sent: datetime | int

Sam at 15:07, 16 April 2025

2025-04-16T15:07:04Z

Sam: /* Sample */

2023-05-19T12:46:59Z

Sample

Sam at 22:15, 2 May 2023

2023-05-02T22:15:21Z

Sam: /* Attributes and Methods */

2022-10-01T11:14:42Z

Attributes and Methods

Sam: /* Attributes and Methods */

2022-09-17T14:52:37Z

Attributes and Methods

Sam: /* Sample */

2022-09-17T12:11:52Z

Sample

Sam: /* Sample */

2022-09-16T21:03:08Z

Sample

Sam: /* addparticipant(account: str, role: int) -> str */

2022-09-16T20:56:54Z

addparticipant(account: str, role: int) -> str

Sam at 09:02, 14 September 2022

2022-09-14T09:02:46Z

@@ Line 47: / Line 47: @@
 It will return [https://docs.python.org/3.10/library/constants.html#True True] if the record was saved to the database, [https://docs.python.org/3/library/constants.html#False False] if there was an error.
-==<code>sent: [https://docs.python.org/3/library/datetime.html datetime] | int</code>==
+==<code>sent: [https://docs.python.org/3/library/datetime.html datetime]</code>==
 When the message was sent.
 This value can be set with either a datetime value or an integer representing [https://docs.microsoft.com/en-us/windows/win32/api/minwinbase/ns-minwinbase-filetime FILETIME] ticks.

@@ Line 47: / Line 47: @@
 It will return [https://docs.python.org/3.10/library/constants.html#True True] if the record was saved to the database, [https://docs.python.org/3/library/constants.html#False False] if there was an error.
-==<code>sent: [https://docs.python.org/3/library/datetime.html datetime]</code>==
+==<code>sent: [https://docs.python.org/3/library/datetime.html datetime] | int</code>==
 When the message was sent.
 This value can be set with either a datetime value or an integer representing [https://docs.microsoft.com/en-us/windows/win32/api/minwinbase/ns-minwinbase-filetime FILETIME] ticks.

@@ Line 71: / Line 71: @@
 =Sample=
-<source lang="Python" line highlight="3-7,9-10,19,31,36">
+<source lang="Python" highlight="3-7,9-10,19,31,36">
 def add_message(parent_truxton_file):
   communication = parent_file.newcommunication()

@@ Line 38: / Line 38: @@
 This identifier corresponds to the <code>[MediaID]</code> of the <code>[Message]</code> table.
-==<code>received: int</code>==
+==<code>received: [https://docs.python.org/3/library/datetime.html datetime]</code>==
-When the message was received in [https://docs.microsoft.com/en-us/windows/win32/api/minwinbase/ns-minwinbase-filetime FILETIME] ticks.
+When the message was received.
 This corresponds to the <code>[Received]</code> column of the <code>[Message]</code> table.
@@ Line 46: / Line 47: @@
 It will return [https://docs.python.org/3.10/library/constants.html#True True] if the record was saved to the database, [https://docs.python.org/3/library/constants.html#False False] if there was an error.
-==<code>sent: int</code>==
+==<code>sent: [https://docs.python.org/3/library/datetime.html datetime]</code>==
-When the message was sent in [https://docs.microsoft.com/en-us/windows/win32/api/minwinbase/ns-minwinbase-filetime FILETIME] ticks.
+When the message was sent.
 This corresponds to the <code>[Sent]</code> column of the <code>[Message]</code> table.

@@ Line 2: / Line 2: @@
 This will populate the <code>[Message]</code>, <code>[MessageAddress]</code>, and other tables in the database.
 =Attributes and Methods=
 ==<code>addpiece(file: object, origin: int, instance: int) -> boolean</code>==
 This allows you to add a [[TruxtonFileIO|file]] or [[TruxtonChildFileIO|child file]] as part of a communication.
@@ Line 21: / Line 28: @@
 ==<code>finished() -> boolean</code>==
 This should be called after you have finished adding all of the pieces to this message.
-It will return [https://docs.python.org/3/library/constants.html#True True] if the record was saved to the database, [https://docs.python.org/3/library/constants.html#False False] if there was an error.
+It will return [https://docs.python.org/3.10/library/constants.html#True True] if the record was saved to the database, [https://docs.python.org/3.10/library/constants.html#False False] if there was an error.
 ==<code>id: str</code>==
@@ Line 37: / Line 44: @@
 ==<code>save() -> boolean</code>==
 This will commit the information to the <code>[Message]</code> table.
-It will return [https://docs.python.org/3/library/constants.html#True True] if the record was saved to the database, [https://docs.python.org/3/library/constants.html#False False] if there was an error.
+It will return [https://docs.python.org/3.10/library/constants.html#True True] if the record was saved to the database, [https://docs.python.org/3/library/constants.html#False False] if there was an error.
 ==<code>sent: int</code>==
@@ Line 54: / Line 61: @@
 The <code>origin</code> is either <code>TAG_ORIGIN_AUTOMATIC</code> (1) or <code>TAG_ORIGIN_HUMAN</code> (2).
 It will return
-[https://docs.python.org/3.8/library/constants.html?highlight=false#True True] if the tag was associated with the file, [https://docs.python.org/3.8/library/constants.html?highlight=false#False False] on failure.
+[https://docs.python.org/3.10/library/constants.html?highlight=false#True True] if the tag was associated with the file, [https://docs.python.org/3.10/library/constants.html?highlight=false#False False] on failure.
 ==<code>type: int</code>==

@@ Line 6: / Line 6: @@
 The <code>origin</code> parameter should be one of the [[Origin|defined constants.]]
-==<code>addparticipant(account: str, role: int, artifact_type: int) -> str</code>==
+==<code>addparticipant(account: str, name: str, role: int, artifact_type: int) -> str</code>==
 After <code>save()</code> has been called, you add the participants to the message.
 The <code>account</code> is the phone number or email address or account that participated in the message.
 The <code>role</code> parameter is the <code>[[Message Participants|MESSAGE_PARTICIPANT]]</code> constants.
 The <code>artifact_type</code> is used when the underlying function automatically adds the account to the artifacts table.

← Older revision		Revision as of 12:11, 17 September 2022
Line 98:		Line 98:

	communication.finished()		communication.finished()
		+
		+	return None
	</source>		</source>

@@ Line 70: / Line 70: @@
   communication.save()
-  communication.addparticipant("703.555.1212", truxton.MESSAGE_PARTICIPANT_FROM)
+  communication.addparticipant("703.555.1212", truxton.MESSAGE_PARTICIPANT_FROM, truxton.ENTITY_TYPE_PHONE_NUMBER)
-  communication.addparticipant("202.555.1212", truxton.MESSAGE_PARTICIPANT_TO)
+  communication.addparticipant("202.555.1212", truxton.MESSAGE_PARTICIPANT_TO, truxton.ENTITY_TYPE_PHONE_NUMBER)
   body1 = root_file.newchild()