Difference between revisions of "TruxtonInvestigationEvent"
(Created page with "This class lets you add an investigation event to Truxton. =Attributes and Methods= ==<code>color: int</code>== Sets the color of the flag to paint on the timeline. This corr...") |
(→Sample) |
||
| (4 intermediate revisions by the same user not shown) | |||
| Line 7: | Line 7: | ||
==<code>id: str</code>== | ==<code>id: str</code>== | ||
| − | A [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] for the investigation. | + | A [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] for the investigation event. |
This corresponds to the <code>[ID]</code> column of the <code>[InvestigationEvent]</code> table. | This corresponds to the <code>[ID]</code> column of the <code>[InvestigationEvent]</code> table. | ||
| Line 32: | Line 32: | ||
This corresponds to the <code>[InvestigationEventTypeID]</code> column of the <code>[InvestigationEvent]</code> table. | This corresponds to the <code>[InvestigationEventTypeID]</code> column of the <code>[InvestigationEvent]</code> table. | ||
| + | ==<code>when: [https://docs.python.org/3/library/datetime.html datetime]</code>== | ||
| + | When the event happened. | ||
| + | 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. | ||
| + | This corresponds to the <code>[When]</code> column of the <code>[InvestigationEvent]</code> table. | ||
=Sample= | =Sample= | ||
| − | <source lang="Python" highlight=" | + | <source lang="Python" highlight="22-25"> |
import sys | import sys | ||
sys.path.append('C:/Program Files/Truxton/SDK') | sys.path.append('C:/Program Files/Truxton/SDK') | ||
import truxton | import truxton | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
def create_investigation(t): | def create_investigation(t): | ||
| Line 101: | Line 57: | ||
def main(): | def main(): | ||
t = truxton.create() | t = truxton.create() | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
investigation = create_investigation(t) | investigation = create_investigation(t) | ||
| − | + | investigation_event = investigation.createevent() | |
| − | + | investigation_event.text = "I did this" | |
| − | + | investigation_event.when = truxton.parsetime("2016-08-15T12:05:00-05:00") | |
| − | + | investigation_event.save() | |
| − | |||
| − | |||
| − | + | return None | |
if __name__ == "__main__": | if __name__ == "__main__": | ||
| − | main() | + | sys.exit(main()) |
</source> | </source> | ||
Latest revision as of 15:10, 27 January 2024
This class lets you add an investigation event to Truxton.
Contents
Attributes and Methods
color: int
Sets the color of the flag to paint on the timeline.
This corresponds to the [Color] column of the [InvestigationEvent] table.
id: str
A GUID for the investigation event.
This corresponds to the [ID] column of the [InvestigationEvent] table.
investigationid: str
A GUID for the investigation this event belongs to.
This corresponds to the [ID] column of the [Investigation] table and is
stored in the [InvestigationID] column of the [InvestigationEvent] table.
status: int
This is the status of the investigation.
It should be a value that appears in the [ID] column of a row in the InvestigationStatus table.
This corresponds to the [InvestigationStatusID] column of the [InvestigationEvent] table.
save() -> boolean
This will commit the information to the [InvestigationEvent] table.
It will return True if the record was saved to the database, False if there was an error.
text: str
The text to display on the event flag.
This corresponds to the [Text] column of the [InvestigationEvent] table.
type: int
The type of investigation event. 1 - Status change, 2 - Comment.
This corresponds to the [InvestigationEventTypeID] column of the [InvestigationEvent] table.
when: datetime
When the event happened.
This value can be set with either a datetime value or an integer representing FILETIME ticks.
This corresponds to the [When] column of the [InvestigationEvent] table.
Sample
import sys
sys.path.append('C:/Program Files/Truxton/SDK')
import truxton
def create_investigation(t):
investigation = t.newinvestigation()
investigation.name = "Collusion"
investigation.description = "United States vs. John Smith"
investigation.case = "DC-SNAFU-2016.2020"
investigation.status = truxton.INVESTIGATION_STATUS_OPEN
investigation.type = truxton.INVESTIGATION_TYPE_FRAUD
investigation.save()
return investigation
def main():
t = truxton.create()
investigation = create_investigation(t)
investigation_event = investigation.createevent()
investigation_event.text = "I did this"
investigation_event.when = truxton.parsetime("2016-08-15T12:05:00-05:00")
investigation_event.save()
return None
if __name__ == "__main__":
sys.exit(main())
