Truxton file create relation - Revision history

Sam at 08:58, 13 February 2021

2021-02-13T08:58:55Z

Sam at 16:56, 4 December 2020

2020-12-04T16:56:10Z

Sam: /* Sample */

2020-06-13T08:24:01Z

Sample

Sam: /* file_handle */

2020-06-10T08:06:29Z

file_handle

Sam: Created page with "This creates a relation object sourced from this file that you can use in the Relation API. A relation object is how you add records to the `..."`


2020-06-10T08:05:03Z
Created page with "This creates a relation object sourced from this file that you can use in the  Relation API. A relation object is how you add records to the <code>..."
New page
This creates a relation object sourced from this file that you can use in the [[Truxton C API#Relation | Relation API.]]

A relation object is how you add records to the <code>[[Relation Table | Relation]]</code> table.

The resulting object will automatically be associated with the file it was created from and with the media the file belongs to.



=Syntax=

<syntaxhighlight lang="C">

uint64_t truxton_file_create_relation( uint64_t file_handle );

</syntaxhighlight>



=Parameters=

==<code>file_handle</code>==



The handle created by the [[truxton_child_file_create]] or [[truxton_file_create_child]] call.



=Return value=

A handle to relation object.



=Sample=



<syntaxhighlight lang="C" highlight="17">

void process_file(uint64_t truxton)

{

   uint64_t file = truxton_file_open_md5(truxton, "9ec8fb6095c35eff2b236863b7caaf10");



   uint64_t artifact_1 = truxton_file_create_artifact(file);



   truxton_artifact_set_type(artifact_1, ENTITY_TYPE_EMAIL_ADDRESS);

   truxton_artifact_set_value(artifact_1, "mdyson@cyberdynesystems.com" );

   truxton_artifact_save(artifact_1);



   uint64_t artifact_2 = truxton_file_create_artifact(file);



   truxton_artifact_set_type(artifact_2, ENTITY_TYPE_PERSON);

   truxton_artifact_set_value(artifact_2, "Miles Dyson" );

   truxton_artifact_save(artifact_2);



   uint64_t relation = truxton_file_create_relation(file);



   char identifier[40];



   truxton_artifact_get_id(artifact_1, identifier, sizeof(identifier));

   truxton_relation_set_a_id(relation, identifier);

   truxton_relation_set_a_type(relation, OBJECT_TYPE_ENTITY);



   truxton_artifact_get_id(artifact_2, identifier, sizeof(identifier));

   truxton_relation_set_b_id(relation, identifier);

   truxton_relation_set_b_type(relation, OBJECT_TYPE_ENTITY);



   truxton_relation_set_relation(relation, RELATION_MESSAGE_ADDRESS);



   truxton_relation_save(relation);



   truxton_relation_destroy(relation);

   truxton_artifact_destroy(artifact_1);

   truxton_artifact_destroy(artifact_2);

   truxton_file_destroy(child);

}

</syntaxhighlight>

Truxton file create relation - Revision history

Sam at 08:58, 13 February 2021

Sam at 16:56, 4 December 2020

Sam: /* Sample */

Sam: /* file_handle */

Sam: Created page with "This creates a relation object sourced from this file that you can use in the Relation API. A relation object is how you add records to the ..."

Sam: Created page with "This creates a relation object sourced from this file that you can use in the Relation API. A relation object is how you add records to the `..."`