Truxton communication create - Revision history

Sam: /* Sample */

2022-11-01T09:24:49Z

Sample

Sam: /* Remarks */

2021-07-22T09:34:22Z

Remarks

Sam at 09:33, 22 July 2021

2021-07-22T09:33:13Z

Sam at 09:31, 22 July 2021

2021-07-22T09:31:13Z

Sam: /* Sample */

2021-07-22T09:10:20Z

Sample

Sam: /* Sample */

2021-07-22T09:03:11Z

Sample

Sam: /* Sample */

2021-07-21T07:48:26Z

Sample

Sam: Created page with "This creates a communication object that you can populate with information before adding it to Truxton. Some samples of communication are email, sms, mms, chat, etc. =Syntax..."

2021-07-20T19:02:52Z

Created page with "This creates a communication object that you can populate with information before adding it to Truxton. Some samples of communication are email, sms, mms, chat, etc. =Syntax..."

New page

This creates a communication object that you can populate with information before adding it to Truxton.

Some samples of communication are email, sms, mms, chat, etc.

=Syntax=
<source lang="C">
uint64_t truxton_communication_create( uint64_t file_handle );
</source>

=Parameters=
==<code>file_handle</code>==
The Truxton [[Truxton C API#File|file]] this communication was found.

=Return value=
A non-zero value on success, zero on failure.

=Remarks=
The parent file and media identifier will be inherited from the parent file.

=Sample=
<source lang="C" highlight="8">
#define TAG_ORIGIN_AUTOMATIC (1)
#define TAG_ORIGIN_HUMAN (2)

void add_message( uint64_t truxton, uint64_t parent_file )
{
char id[40];

uint64_t communication = truxton_communication_create( parent_file );

FILETIME now;

GetSystemTimePreciseAsFileTime( &now );

ULARGE_INTEGER ticks;

ticks.LowPart = now.dwLowDateTime;
ticks.HighPart = now.dwHighDateTime;

truxton_communication_set_received( communication, ticks.QuadPart );
truxton_communication_set_sent( communication, ticks.QuadPart );
truxton_communication_set_type( communication, MESSAGE_TYPE_SMS );
truxton_communication_set_subject( communication, "Test Message" );

if ( truxton_communication_save( communication ) == 0 )
{
printf( "Failed to add child to Truxton\n" );
truxton_communication_destroy( communication );

return;
}

truxton_communication_get_id( parent_file, id, sizeof(id) );
printf( "Saved as id %s\n", id );

// Now that we have an id, we can add participants.

truxton_communication_add_participant( communication, MESSAGE_PARTICIPANT_FROM, "sam@abc.xyz", NULL, 0 );
truxton_communication_add_participant( communication, MESSAGE_PARTICIPANT_TO, "laura@abc.xyz", NULL, 0 );

truxton_communication_finished( communication );

truxton_communication_tag( communication, "Man Made", "Testing the API", TAG_ORIGIN_HUMAN );
truxton_communication_destroy( communication );
}
</source>

@@ Line 38: / Line 38: @@
     uint64_t communication = truxton_communication_create( parent_file );
-    FILETIME now;
+    uint64_t message_time = truxton_parse_time( "2021-07-29 21:52:53 UTC" );
-   GetSystemTimePreciseAsFileTime( &now );
+    truxton_communication_set_received( communication, message_time );
+    truxton_communication_set_sent( communication, message_time );
     truxton_communication_set_type( communication, MESSAGE_TYPE_MIME );
     truxton_communication_set_subject( communication, "Test Message" );

@@ Line 2: / Line 2: @@
 Some samples of communication are email, sms, mms, chat, etc.
 The process of adding a communication is as follows:
 # Create the communication object.

@@ Line 55: / Line 55: @@
     // Now that we have an id, we can add participants.
-    truxton_communication_add_participant( communication, MESSAGE_PARTICIPANT_FROM, "sam@abc.xyz", NULL, 0 );
+    if ( truxton_communication_add_participant( communication, MESSAGE_PARTICIPANT_FROM, "sam@abc.xyz", NULL, 0 ) == 0 )
     truxton_communication_add_participant( communication, MESSAGE_PARTICIPANT_TO, "laura@abc.xyz", NULL, 0 );
     uint64_t message_body_1 = create_message_body_1( truxton );
     uint64_t message_body_2 = create_message_body_2( truxton );
@@ Line 62: / Line 70: @@
     uint64_t attachment_2 = create_attachment_2( truxton );
-    truxton_communication_add_piece( communication, message_body_1, ORIGIN_EMAIL_BODY, 1 );
+    if ( truxton_communication_add_piece( communication, message_body_1, ORIGIN_EMAIL_BODY, 1 ) == 0 )
     truxton_communication_add_piece( communication, message_body_1, ORIGIN_EMAIL_BODY, 2 );
-    truxton_communication_add_piece( communication, attachment_1, ORIGIN_EMAIL_ATTACHMENT, 1 );
+    if ( truxton_communication_finished( communication ) == 0 )
-    truxton_communication_add_piece( communication, attachment_2, ORIGIN_EMAIL_ATTACHMENT, 2 );
-    truxton_communication_finished( communication );
+    if ( truxton_communication_tag( communication, "Man Made", "Testing the API", TAG_ORIGIN_HUMAN ) == 0 )
     truxton_communication_destroy( communication );
+}
 </source>

@@ Line 25: / Line 25: @@
 =Remarks=
-The parent file and media identifier will be inherited from the parent file.
+The parent file and media identifier will be inherited from the <code>file_handle</code>.
 =Sample=

@@ Line 1: / Line 1: @@
 This creates a communication object that you can populate with information before adding it to Truxton.
-Some samples of communication are email, sms, mms, chat, etc.
+The process of adding a communication is as follows:
 =Syntax=

@@ Line 45: / Line 45: @@
     if ( truxton_communication_save( communication ) == 0 )
+    {
-       printf( "Failed to add child to Truxton\n" );
+       printf( "Failed to add communication to Truxton\n" );
        truxton_communication_destroy( communication );
        return;
+    }