Autopsy  4.18.0
Graphical digital forensics platform for The Sleuth Kit and other tools.
Classes | Public Member Functions | Static Public Member Functions | Private Attributes | Static Private Attributes | List of all members
org.sleuthkit.autopsy.casemodule.services.TagsManager Class Reference

Inherits Closeable.

Classes

class  TagNameAlreadyExistsException
 

Public Member Functions

BlackboardArtifactTag addBlackboardArtifactTag (BlackboardArtifact artifact, TagName tagName) throws TskCoreException
 
BlackboardArtifactTag addBlackboardArtifactTag (BlackboardArtifact artifact, TagName tagName, String comment) throws TskCoreException
 
ContentTag addContentTag (Content content, TagName tagName) throws TskCoreException
 
ContentTag addContentTag (Content content, TagName tagName, String comment) throws TskCoreException
 
ContentTag addContentTag (Content content, TagName tagName, String comment, long beginByteOffset, long endByteOffset) throws TskCoreException
 
TagName addTagName (String displayName) throws TagNameAlreadyExistsException, TskCoreException
 
TagName addTagName (String displayName, String description) throws TagNameAlreadyExistsException, TskCoreException
 
TagName addTagName (String displayName, String description, TagName.HTML_COLOR color) throws TagNameAlreadyExistsException, TskCoreException
 
TagName addTagName (String displayName, String description, TagName.HTML_COLOR color, TskData.FileKnown knownStatus) throws TagNameAlreadyExistsException, TskCoreException
 
TagSet addTagSet (String name, List< TagName > tagNameList) throws TskCoreException
 
void close () throws IOException
 
void deleteBlackboardArtifactTag (BlackboardArtifactTag tag) throws TskCoreException
 
void deleteContentTag (ContentTag tag) throws TskCoreException
 
List< BlackboardArtifactTag > getAllBlackboardArtifactTags () throws TskCoreException
 
List< ContentTag > getAllContentTags () throws TskCoreException
 
List< TagName > getAllTagNames () throws TskCoreException
 
List< TagSet > getAllTagSets () throws TskCoreException
 
BlackboardArtifactTag getBlackboardArtifactTagByTagID (long tagId) throws TskCoreException
 
List< BlackboardArtifactTag > getBlackboardArtifactTagsByArtifact (BlackboardArtifact artifact) throws TskCoreException
 
List< BlackboardArtifactTag > getBlackboardArtifactTagsByTagName (TagName tagName) throws TskCoreException
 
List< BlackboardArtifactTag > getBlackboardArtifactTagsByTagName (TagName tagName, long dsObjId) throws TskCoreException
 
long getBlackboardArtifactTagsCountByTagName (TagName tagName) throws TskCoreException
 
long getBlackboardArtifactTagsCountByTagName (TagName tagName, long dsObjId) throws TskCoreException
 
long getBlackboardArtifactTagsCountByTagNameForUser (TagName tagName, String userName) throws TskCoreException
 
long getBlackboardArtifactTagsCountByTagNameForUser (TagName tagName, long dsObjId, String userName) throws TskCoreException
 
ContentTag getContentTagByTagID (long tagId) throws TskCoreException
 
List< ContentTag > getContentTagsByContent (Content content) throws TskCoreException
 
List< ContentTag > getContentTagsByTagName (TagName tagName) throws TskCoreException
 
List< ContentTag > getContentTagsByTagName (TagName tagName, long dsObjId) throws TskCoreException
 
long getContentTagsCountByTagName (TagName tagName) throws TskCoreException
 
long getContentTagsCountByTagName (TagName tagName, long dsObjId) throws TskCoreException
 
long getContentTagsCountByTagNameForUser (TagName tagName, String userName) throws TskCoreException
 
long getContentTagsCountByTagNameForUser (TagName tagName, long dsObjId, String userName) throws TskCoreException
 
Map< String, TagName > getDisplayNamesToTagNamesMap () throws TskCoreException
 
List< TagName > getTagNamesInUse () throws TskCoreException
 
List< TagName > getTagNamesInUse (long dsObjId) throws TskCoreException
 
List< TagName > getTagNamesInUseForUser (String userName) throws TskCoreException
 
List< TagName > getTagNamesInUseForUser (long dsObjId, String userName) throws TskCoreException
 
TagSet getTagSet (TagName tagName) throws TskCoreException
 
boolean tagNameExists (String tagDisplayName)
 

Static Public Member Functions

static void addTagSetDefinition (TagSetDefinition tagSetDef) throws IOException
 
static boolean containsIllegalCharacters (String tagDisplayName)
 
static String getBookmarkTagDisplayName ()
 
static String getFollowUpTagDisplayName ()
 
static String getNotableTagDisplayName ()
 
static List< String > getNotableTagDisplayNames ()
 
static String getNotableTagLabel ()
 
static List< String > getStandardTagNames ()
 
static Set< String > getTagDisplayNames () throws TskCoreException
 

Private Attributes

final SleuthkitCase caseDb
 

Static Private Attributes

static final Object lock = new Object()
 
static final Logger LOGGER = Logger.getLogger(TagsManager.class.getName())
 
static String PROJECT_VIC_TAG_SET_NAME = "Project VIC"
 

Detailed Description

A per case Autopsy service that manages the addition of content and artifact tags to the case database.

Definition at line 53 of file TagsManager.java.

Member Function Documentation

BlackboardArtifactTag org.sleuthkit.autopsy.casemodule.services.TagsManager.addBlackboardArtifactTag ( BlackboardArtifact  artifact,
TagName  tagName 
) throws TskCoreException

Tags an artifact.

Parameters
artifactThe artifact to tag.
tagNameThe representation of the desired tag type in the case database, which can be obtained by calling getTagNames and/or addTagName.
Returns
A BlackboardArtifactTag object representing the new tag.
Exceptions
TskCoreExceptionIf there is an error adding the tag to the case database.

Definition at line 795 of file TagsManager.java.

Referenced by org.sleuthkit.autopsy.actions.AddBlackboardArtifactTagAction.addTag(), and org.sleuthkit.autopsy.actions.ReplaceBlackboardArtifactTagAction.replaceTag().

BlackboardArtifactTag org.sleuthkit.autopsy.casemodule.services.TagsManager.addBlackboardArtifactTag ( BlackboardArtifact  artifact,
TagName  tagName,
String  comment 
) throws TskCoreException

Tags an artifact.

Parameters
artifactThe artifact to tag.
tagNameThe representation of the desired tag type in the case database, which can be obtained by calling getTagNames and/or addTagName.
commentA comment to store with the tag.
Returns
A BlackboardArtifactTag object representing the new tag.
Exceptions
TskCoreExceptionIf there is an error adding the tag to the case database.

Definition at line 813 of file TagsManager.java.

References org.sleuthkit.autopsy.casemodule.Case.getCurrentCaseThrows(), and org.sleuthkit.autopsy.casemodule.Case.notifyBlackBoardArtifactTagAdded().

ContentTag org.sleuthkit.autopsy.casemodule.services.TagsManager.addContentTag ( Content  content,
TagName  tagName 
) throws TskCoreException

Tags a content object.

Parameters
contentThe content to tag.
tagNameThe representation of the desired tag type in the case database, which can be obtained by calling getTagNames and/or addTagName.
Returns
A ContentTag object representing the new tag.
Exceptions
TskCoreExceptionIf there is an error adding the tag to the case database.

Definition at line 554 of file TagsManager.java.

Referenced by org.sleuthkit.autopsy.casemodule.services.TagsManager.addContentTag(), org.sleuthkit.autopsy.actions.AddContentTagAction.addTag(), and org.sleuthkit.autopsy.actions.ReplaceContentTagAction.replaceTag().

ContentTag org.sleuthkit.autopsy.casemodule.services.TagsManager.addContentTag ( Content  content,
TagName  tagName,
String  comment 
) throws TskCoreException

Tags a content object.

Parameters
contentThe content to tag.
tagNameThe representation of the desired tag type in the case database, which can be obtained by calling getTagNames and/or addTagName.
commentA comment to store with the tag.
Returns
A ContentTag object representing the new tag.
Exceptions
TskCoreExceptionIf there is an error adding the tag to the case database.

Definition at line 572 of file TagsManager.java.

References org.sleuthkit.autopsy.casemodule.services.TagsManager.addContentTag().

ContentTag org.sleuthkit.autopsy.casemodule.services.TagsManager.addContentTag ( Content  content,
TagName  tagName,
String  comment,
long  beginByteOffset,
long  endByteOffset 
) throws TskCoreException

Tags a content object or a section of a content object.

Parameters
contentThe content to tag.
tagNameThe representation of the desired tag type in the case database, which can be obtained by calling getTagNames and/or addTagName.
commentA comment to store with the tag.
beginByteOffsetDesignates the beginning of a tagged section.
endByteOffsetDesignates the end of a tagged section.
Returns
A ContentTag object representing the new tag.
Exceptions
TskCoreExceptionIf there is an error adding the tag to the case database.

Definition at line 592 of file TagsManager.java.

References org.sleuthkit.autopsy.casemodule.Case.getCurrentCaseThrows(), and org.sleuthkit.autopsy.casemodule.Case.notifyContentTagAdded().

TagName org.sleuthkit.autopsy.casemodule.services.TagsManager.addTagName ( String  displayName) throws TagNameAlreadyExistsException, TskCoreException

Adds a tag name entry to the case database and adds a corresponding tag type to the current user's custom tag types.

Parameters
displayNameThe display name for the new tag type.
Returns
A TagName representing the tag name database entry that can be used to add instances of the tag type to the case database.
Exceptions
TagNameAlreadyExistsExceptionIf the tag name already exists in the case database.
TskCoreExceptionIf there is an error adding the tag name to the case database.

Definition at line 462 of file TagsManager.java.

Referenced by org.sleuthkit.autopsy.casemodule.services.TagsManager.addTagName(), and org.sleuthkit.autopsy.actions.GetTagNameDialog.okButtonActionPerformed().

TagName org.sleuthkit.autopsy.casemodule.services.TagsManager.addTagName ( String  displayName,
String  description 
) throws TagNameAlreadyExistsException, TskCoreException

Adds a tag name entry to the case database and adds a corresponding tag type to the current user's custom tag types.

Parameters
displayNameThe display name for the new tag type.
descriptionThe description for the new tag type.
Returns
A TagName object that can be used to add instances of the tag type to the case database.
Exceptions
TagNameAlreadyExistsExceptionIf the tag name already exists in the case database.
TskCoreExceptionIf there is an error adding the tag name to the case database.

Definition at line 481 of file TagsManager.java.

References org.sleuthkit.autopsy.casemodule.services.TagsManager.addTagName().

TagName org.sleuthkit.autopsy.casemodule.services.TagsManager.addTagName ( String  displayName,
String  description,
TagName.HTML_COLOR  color 
) throws TagNameAlreadyExistsException, TskCoreException

Adds a tag name entry to the case database and adds a corresponding tag type to the current user's custom tag types.

Parameters
displayNameThe display name for the new tag type.
descriptionThe description for the new tag type.
colorThe color to associate with the new tag type.
Returns
A TagName object that can be used to add instances of the tag type to the case database.
Exceptions
TagNameAlreadyExistsExceptionIf the tag name already exists.
TskCoreExceptionIf there is an error adding the tag name to the case database.

Definition at line 500 of file TagsManager.java.

References org.sleuthkit.autopsy.casemodule.services.TagsManager.addTagName().

TagName org.sleuthkit.autopsy.casemodule.services.TagsManager.addTagName ( String  displayName,
String  description,
TagName.HTML_COLOR  color,
TskData.FileKnown  knownStatus 
) throws TagNameAlreadyExistsException, TskCoreException

Adds a tag name entry to the case database and adds a corresponding tag type to the current user's custom tag types.

Parameters
displayNameThe display name for the new tag type.
descriptionThe description for the new tag type.
colorThe color to associate with the new tag type.
knownStatusThe knownStatus to be used for the tag when correlating on the tagged item
Returns
A TagName object that can be used to add instances of the tag type to the case database.
Exceptions
TagNameAlreadyExistsExceptionIf the tag name already exists.
TskCoreExceptionIf there is an error adding the tag name to the case database.

Definition at line 521 of file TagsManager.java.

References org.sleuthkit.autopsy.casemodule.services.TagsManager.lock.

TagSet org.sleuthkit.autopsy.casemodule.services.TagsManager.addTagSet ( String  name,
List< TagName >  tagNameList 
) throws TskCoreException

Add a new TagSet to the case database. Tags will be ranked in the order which they are passed to this method.

Parameters
nameTag set name.
tagNameListList of TagName in rank order.
Returns
A new TagSet object.
Exceptions
TskCoreException

Definition at line 332 of file TagsManager.java.

static void org.sleuthkit.autopsy.casemodule.services.TagsManager.addTagSetDefinition ( TagSetDefinition  tagSetDef) throws IOException
static

Creates a new TagSetDefinition file that will be used for future cases

Parameters
tagSetDefThe tag set definition.
Exceptions
IOException

Definition at line 248 of file TagsManager.java.

References org.sleuthkit.autopsy.casemodule.services.TagsManager.lock.

void org.sleuthkit.autopsy.casemodule.services.TagsManager.close ( ) throws IOException

Closes the tags manager.

Exceptions
IOExceptionIf there is a problem closing the tags manager.
Deprecated:
Tags manager clients should not close the tags manager.

Definition at line 1040 of file TagsManager.java.

static boolean org.sleuthkit.autopsy.casemodule.services.TagsManager.containsIllegalCharacters ( String  tagDisplayName)
static

Tests whether or not a given tag display name contains an illegal character.

Parameters
tagDisplayNameDisplay name of a tag.
Returns
True or false.

Definition at line 99 of file TagsManager.java.

Referenced by org.sleuthkit.autopsy.actions.GetTagNameDialog.okButtonActionPerformed().

void org.sleuthkit.autopsy.casemodule.services.TagsManager.deleteBlackboardArtifactTag ( BlackboardArtifactTag  tag) throws TskCoreException
void org.sleuthkit.autopsy.casemodule.services.TagsManager.deleteContentTag ( ContentTag  tag) throws TskCoreException
List<BlackboardArtifactTag> org.sleuthkit.autopsy.casemodule.services.TagsManager.getAllBlackboardArtifactTags ( ) throws TskCoreException

Gets all artifact tags for the current case.

Returns
A list, possibly empty, of artifact tags.
Exceptions
TskCoreExceptionIf there is an error getting the tags from the case database.

Definition at line 849 of file TagsManager.java.

List<ContentTag> org.sleuthkit.autopsy.casemodule.services.TagsManager.getAllContentTags ( ) throws TskCoreException

Gets all content tags for the current case.

Returns
A list, possibly empty, of content tags.
Exceptions
TskCoreExceptionIf there is an error getting the tags from the case database.

Definition at line 630 of file TagsManager.java.

List<TagName> org.sleuthkit.autopsy.casemodule.services.TagsManager.getAllTagNames ( ) throws TskCoreException

Gets a list of all tag names currently in the case database.

Returns
A list, possibly empty, of TagName objects.
Exceptions
TskCoreExceptionIf there is an error querying the case database.

Definition at line 343 of file TagsManager.java.

Referenced by org.sleuthkit.autopsy.casemodule.services.TagsManager.getNotableTagDisplayNames(), and org.sleuthkit.autopsy.casemodule.services.TagsManager.getTagDisplayNames().

List<TagSet> org.sleuthkit.autopsy.casemodule.services.TagsManager.getAllTagSets ( ) throws TskCoreException

Get a list of all tag sets currently in the case database.

Returns
A list, possibly empty, of TagSet objects.
Exceptions
TskCoreException

Definition at line 304 of file TagsManager.java.

BlackboardArtifactTag org.sleuthkit.autopsy.casemodule.services.TagsManager.getBlackboardArtifactTagByTagID ( long  tagId) throws TskCoreException

Gets an artifact tag by tag id.

Parameters
tagIdThe tag id of interest.
Returns
The artifact tag with the specified tag id.
Exceptions
TskCoreExceptionIf there is an error getting the tag from the case database.

Definition at line 949 of file TagsManager.java.

List<BlackboardArtifactTag> org.sleuthkit.autopsy.casemodule.services.TagsManager.getBlackboardArtifactTagsByArtifact ( BlackboardArtifact  artifact) throws TskCoreException

Gets artifact tags for a particular artifact.

Parameters
artifactThe artifact of interest.
Returns
A list, possibly empty, of the tags that have been applied to the artifact.
Exceptions
TskCoreExceptionIf there is an error getting the tags from the case database.

Definition at line 999 of file TagsManager.java.

Referenced by org.sleuthkit.autopsy.datamodel.BlackboardArtifactNode.addTagProperty(), org.sleuthkit.autopsy.datamodel.BlackboardArtifactNode.getAllTagsFromDatabase(), org.sleuthkit.autopsy.centralrepository.eventlisteners.CaseEventListener.BlackboardTagTask.handleTagChange(), and org.sleuthkit.autopsy.centralrepository.eventlisteners.CaseEventListener.TagDefinitionChangeTask.run().

List<BlackboardArtifactTag> org.sleuthkit.autopsy.casemodule.services.TagsManager.getBlackboardArtifactTagsByTagName ( TagName  tagName) throws TskCoreException

Gets artifact tags by tag name.

Parameters
tagNameThe representation of the desired tag type in the case database, which can be obtained by calling getTagNames and/or addTagName.
Returns
A list, possibly empty, of the artifact tags with the specified tag name.
Exceptions
TskCoreExceptionIf there is an error getting the tags from the case database.

Definition at line 966 of file TagsManager.java.

Referenced by org.sleuthkit.autopsy.report.modules.portablecase.PortableCaseReportModule.addArtifactsToPortableCase(), org.sleuthkit.autopsy.datamodel.Tags.BlackboardArtifactTagNodeFactory.createKeys(), org.sleuthkit.autopsy.report.modules.portablecase.PortableCaseReportModule.generateCaseUcoReport(), and org.sleuthkit.autopsy.casemodule.services.TagsManager.getBlackboardArtifactTagsCountByTagNameForUser().

List<BlackboardArtifactTag> org.sleuthkit.autopsy.casemodule.services.TagsManager.getBlackboardArtifactTagsByTagName ( TagName  tagName,
long  dsObjId 
) throws TskCoreException

Gets artifact tags by tag name, for specified data source.

Parameters
tagNameThe representation of the desired tag type in the case database, which can be obtained by calling getTagNames and/or addTagName.
dsObjIddata source object id
Returns
A list, possibly empty, of the artifact tags with the specified tag name, for the specified data source.
Exceptions
TskCoreExceptionIf there is an error getting the tags from the case database.

Definition at line 984 of file TagsManager.java.

long org.sleuthkit.autopsy.casemodule.services.TagsManager.getBlackboardArtifactTagsCountByTagName ( TagName  tagName) throws TskCoreException

Gets an artifact tags count by tag name.

Parameters
tagNameThe representation of the desired tag type in the case database, which can be obtained by calling getTagNames and/or addTagName.
Returns
A count of the artifact tags with the specified tag name.
Exceptions
TskCoreExceptionIf there is an error getting the tags count from the case database.

Definition at line 865 of file TagsManager.java.

Referenced by org.sleuthkit.autopsy.datamodel.Tags.TagNameNode.updateDisplayName(), and org.sleuthkit.autopsy.datamodel.Tags.BlackboardArtifactTagTypeNode.updateDisplayName().

long org.sleuthkit.autopsy.casemodule.services.TagsManager.getBlackboardArtifactTagsCountByTagName ( TagName  tagName,
long  dsObjId 
) throws TskCoreException

Gets an artifact tags count by tag name, for the given data source.

Parameters
tagNameThe representation of the desired tag type in the case database, which can be obtained by calling getTagNames and/or addTagName.
dsObjIddata source object id
Returns
A count of the artifact tags with the specified tag name, for the given data source.
Exceptions
TskCoreExceptionIf there is an error getting the tags count from the case database.

Definition at line 908 of file TagsManager.java.

long org.sleuthkit.autopsy.casemodule.services.TagsManager.getBlackboardArtifactTagsCountByTagNameForUser ( TagName  tagName,
String  userName 
) throws TskCoreException

Gets an artifact tags count by tag name for a specific user.

Parameters
tagNameThe representation of the desired tag type in the case database, which can be obtained by calling getTagNames and/or addTagName.
userName- the user name that you want to get tags for
Returns
A count of the artifact tags with the specified tag name for the specified user.
Exceptions
TskCoreExceptionIf there is an error getting the tags count from the case database.

Definition at line 883 of file TagsManager.java.

References org.sleuthkit.autopsy.casemodule.services.TagsManager.getBlackboardArtifactTagsByTagName().

Referenced by org.sleuthkit.autopsy.datamodel.Tags.TagNameNode.updateDisplayName(), and org.sleuthkit.autopsy.datamodel.Tags.BlackboardArtifactTagTypeNode.updateDisplayName().

long org.sleuthkit.autopsy.casemodule.services.TagsManager.getBlackboardArtifactTagsCountByTagNameForUser ( TagName  tagName,
long  dsObjId,
String  userName 
) throws TskCoreException

Gets an artifact tags count by tag name, for the given data source and user.

Parameters
tagNameThe representation of the desired tag type in the case database, which can be obtained by calling getTagNames and/or addTagName.
dsObjIddata source object id
userName- the user name that you want to get tags for
Returns
A count of the artifact tags with the specified tag name, for the given data source and user.
Exceptions
TskCoreExceptionIf there is an error getting the tags count from the case database.

Definition at line 928 of file TagsManager.java.

References org.sleuthkit.autopsy.casemodule.services.TagsManager.getBlackboardArtifactTagsByTagName().

static String org.sleuthkit.autopsy.casemodule.services.TagsManager.getBookmarkTagDisplayName ( )
static
ContentTag org.sleuthkit.autopsy.casemodule.services.TagsManager.getContentTagByTagID ( long  tagId) throws TskCoreException

Gets a content tag by tag id.

Parameters
tagIdThe tag id of interest.
Returns
The content tag with the specified tag id.
Exceptions
TskCoreExceptionIf there is an error getting the tag from the case database.

Definition at line 731 of file TagsManager.java.

List<ContentTag> org.sleuthkit.autopsy.casemodule.services.TagsManager.getContentTagsByContent ( Content  content) throws TskCoreException
List<ContentTag> org.sleuthkit.autopsy.casemodule.services.TagsManager.getContentTagsByTagName ( TagName  tagName) throws TskCoreException
List<ContentTag> org.sleuthkit.autopsy.casemodule.services.TagsManager.getContentTagsByTagName ( TagName  tagName,
long  dsObjId 
) throws TskCoreException

Gets content tags by tag name, for the given data source.

Parameters
tagNameThe tag name of interest.
dsObjIddata source object id
Returns
A list, possibly empty, of the content tags with the specified tag name, and for the given data source.
Exceptions
TskCoreExceptionIf there is an error getting the tags from the case database.

Definition at line 763 of file TagsManager.java.

long org.sleuthkit.autopsy.casemodule.services.TagsManager.getContentTagsCountByTagName ( TagName  tagName) throws TskCoreException

Gets content tags count by tag name.

Parameters
tagNameThe representation of the desired tag type in the case database, which can be obtained by calling getTagNames and/or addTagName.
Returns
A count of the content tags with the specified tag name.
Exceptions
TskCoreExceptionIf there is an error getting the tags count from the case database.

Definition at line 646 of file TagsManager.java.

Referenced by org.sleuthkit.autopsy.datamodel.Tags.TagNameNode.updateDisplayName(), and org.sleuthkit.autopsy.datamodel.Tags.ContentTagTypeNode.updateDisplayName().

long org.sleuthkit.autopsy.casemodule.services.TagsManager.getContentTagsCountByTagName ( TagName  tagName,
long  dsObjId 
) throws TskCoreException

Gets content tags count by tag name, for the given data source

Parameters
tagNameThe representation of the desired tag type in the case database, which can be obtained by calling getTagNames and/or addTagName.
dsObjIddata source object id
Returns
A count of the content tags with the specified tag name, and for the given data source
Exceptions
TskCoreExceptionIf there is an error getting the tags count from the case database.

Definition at line 690 of file TagsManager.java.

long org.sleuthkit.autopsy.casemodule.services.TagsManager.getContentTagsCountByTagNameForUser ( TagName  tagName,
String  userName 
) throws TskCoreException

Gets content tags count by tag name for the specified user.

Parameters
tagNameThe representation of the desired tag type in the case database, which can be obtained by calling getTagNames and/or addTagName.
userName- the user name that you want to get tags for
Returns
A count of the content tags with the specified tag name for the specified user.
Exceptions
TskCoreExceptionIf there is an error getting the tags count from the case database.

Definition at line 664 of file TagsManager.java.

References org.sleuthkit.autopsy.casemodule.services.TagsManager.getContentTagsByTagName().

Referenced by org.sleuthkit.autopsy.datamodel.Tags.TagNameNode.updateDisplayName(), and org.sleuthkit.autopsy.datamodel.Tags.ContentTagTypeNode.updateDisplayName().

long org.sleuthkit.autopsy.casemodule.services.TagsManager.getContentTagsCountByTagNameForUser ( TagName  tagName,
long  dsObjId,
String  userName 
) throws TskCoreException

Gets content tags count by tag name, for the given data source and user

Parameters
tagNameThe representation of the desired tag type in the case database, which can be obtained by calling getTagNames and/or addTagName.
dsObjIddata source object id
userName- the user name that you want to get tags for
Returns
A count of the content tags with the specified tag name, and for the given data source and user
Exceptions
TskCoreExceptionIf there is an error getting the tags count from the case database.

Definition at line 710 of file TagsManager.java.

References org.sleuthkit.autopsy.casemodule.services.TagsManager.getContentTagsByTagName().

Map<String, TagName> org.sleuthkit.autopsy.casemodule.services.TagsManager.getDisplayNamesToTagNamesMap ( ) throws TskCoreException
static String org.sleuthkit.autopsy.casemodule.services.TagsManager.getFollowUpTagDisplayName ( )
static

Returns the Follow Up tag display string.

Returns

Definition at line 228 of file TagsManager.java.

static String org.sleuthkit.autopsy.casemodule.services.TagsManager.getNotableTagDisplayName ( )
static

Returns the Notable tag display string.

Returns

Definition at line 237 of file TagsManager.java.

static List<String> org.sleuthkit.autopsy.casemodule.services.TagsManager.getNotableTagDisplayNames ( )
static

Gets the set of display names of notable (TskData.FileKnown.BAD) tag types. If a case is not open the list will only include only the user defined custom tags. Otherwise the list will include all notable tags.

Returns

Definition at line 160 of file TagsManager.java.

References org.sleuthkit.autopsy.casemodule.services.TagsManager.getAllTagNames(), org.sleuthkit.autopsy.casemodule.Case.getCurrentCaseThrows(), org.sleuthkit.autopsy.casemodule.Case.getServices(), and org.sleuthkit.autopsy.casemodule.services.Services.getTagsManager().

Referenced by org.sleuthkit.autopsy.centralrepository.eventlisteners.CaseEventListener.isNotableTagName().

static String org.sleuthkit.autopsy.casemodule.services.TagsManager.getNotableTagLabel ( )
static

Get String of text which is used to label tags as notable to the user.

Returns
Bundle message TagsManager.notableTagEnding.text

Definition at line 119 of file TagsManager.java.

Referenced by org.sleuthkit.autopsy.report.modules.html.HTMLReport.addThumbnailRows(), org.sleuthkit.autopsy.actions.AddTagAction.TagMenu.createMenutItem(), and org.sleuthkit.autopsy.report.infrastructure.TableReportGenerator.ArtifactData.getOrderedRowDataAsStrings().

static List<String> org.sleuthkit.autopsy.casemodule.services.TagsManager.getStandardTagNames ( )
static

Returns a list of names of standard/predefined tags

Returns
list of predefined tag names

Definition at line 191 of file TagsManager.java.

References org.sleuthkit.autopsy.casemodule.Case.getCurrentCaseThrows(), and org.sleuthkit.autopsy.casemodule.Case.getSleuthkitCase().

Referenced by org.sleuthkit.autopsy.actions.GetTagNameAndCommentDialog.display().

static Set<String> org.sleuthkit.autopsy.casemodule.services.TagsManager.getTagDisplayNames ( ) throws TskCoreException
static

Gets the set of display names of the currently available tag types. This includes the display names of the standard tag types, the current user's custom tag types, and the tags in the case database of the current case (if there is a current case).

Returns
A set, possibly empty, of tag type display names.
Exceptions
TskCoreExceptionIf there is a current case and there is an error querying the case database for tag types.

Definition at line 134 of file TagsManager.java.

References org.sleuthkit.autopsy.casemodule.services.TagsManager.getAllTagNames(), org.sleuthkit.autopsy.casemodule.Case.getCurrentCaseThrows(), org.sleuthkit.autopsy.casemodule.Case.getServices(), and org.sleuthkit.autopsy.casemodule.services.Services.getTagsManager().

List<TagName> org.sleuthkit.autopsy.casemodule.services.TagsManager.getTagNamesInUse ( ) throws TskCoreException

Gets a list of all tag names currently in use in the case database for tagging content or artifacts.

Returns
A list, possibly empty, of TagName objects.
Exceptions
TskCoreExceptionIf there is an error querying the case database.

Definition at line 355 of file TagsManager.java.

Referenced by org.sleuthkit.autopsy.datamodel.Tags.TagNameNodeFactory.createKeys(), and org.sleuthkit.autopsy.report.modules.portablecase.PortableCaseReportModule.generateReport().

List<TagName> org.sleuthkit.autopsy.casemodule.services.TagsManager.getTagNamesInUse ( long  dsObjId) throws TskCoreException

Selects all of the rows from the tag_names table in the case database for which there is at least one matching row in the content_tags or blackboard_artifact_tags tables, for the given data source object id.

Parameters
dsObjIddata source object id
Returns
A list, possibly empty, of TagName data transfer objects (DTOs) for the rows.
Exceptions
TskCoreException

Definition at line 398 of file TagsManager.java.

List<TagName> org.sleuthkit.autopsy.casemodule.services.TagsManager.getTagNamesInUseForUser ( String  userName) throws TskCoreException

Gets a list of all tag names currently in use in the case database for tagging content or artifacts by the specified user.

Parameters
userName- the user name that you want to get tags for
Returns
A list, possibly empty, of TagName objects.
Exceptions
TskCoreExceptionIf there is an error querying the case database.

Definition at line 369 of file TagsManager.java.

Referenced by org.sleuthkit.autopsy.datamodel.Tags.TagNameNodeFactory.createKeys().

List<TagName> org.sleuthkit.autopsy.casemodule.services.TagsManager.getTagNamesInUseForUser ( long  dsObjId,
String  userName 
) throws TskCoreException

Selects all of the rows from the tag_names table in the case database for which there is at least one matching row in the content_tags or blackboard_artifact_tags tables, for the given data source object id and user.

Parameters
dsObjIddata source object id
userName- the user name that you want to get tags for
Returns
A list, possibly empty, of TagName data transfer objects (DTOs) for the rows.
Exceptions
TskCoreException

Definition at line 416 of file TagsManager.java.

TagSet org.sleuthkit.autopsy.casemodule.services.TagsManager.getTagSet ( TagName  tagName) throws TskCoreException

Gets the tag set a tag name (tag definition) belongs to, if any.

Parameters
tagNameThe tag name.
Returns
A TagSet object or null.
Exceptions
TskCoreExceptionIf there is an error querying the case database.

Definition at line 317 of file TagsManager.java.

Referenced by org.sleuthkit.autopsy.actions.GetTagNameAndCommentDialog.display(), and org.sleuthkit.autopsy.tags.TagUtils.getDecoratedTagDisplayName().

boolean org.sleuthkit.autopsy.casemodule.services.TagsManager.tagNameExists ( String  tagDisplayName)

Checks whether a tag name with a given display name exists in the case database.

Parameters
tagDisplayNameThe display name.
Returns
True or false.
Deprecated:
Not reliable for multi-user cases.

Definition at line 1022 of file TagsManager.java.

References org.sleuthkit.autopsy.casemodule.services.TagsManager.getDisplayNamesToTagNamesMap().

Member Data Documentation

final SleuthkitCase org.sleuthkit.autopsy.casemodule.services.TagsManager.caseDb
private

Definition at line 56 of file TagsManager.java.

final Object org.sleuthkit.autopsy.casemodule.services.TagsManager.lock = new Object()
staticprivate
final Logger org.sleuthkit.autopsy.casemodule.services.TagsManager.LOGGER = Logger.getLogger(TagsManager.class.getName())
staticprivate

Definition at line 55 of file TagsManager.java.

String org.sleuthkit.autopsy.casemodule.services.TagsManager.PROJECT_VIC_TAG_SET_NAME = "Project VIC"
staticprivate

Definition at line 60 of file TagsManager.java.


The documentation for this class was generated from the following file:

Copyright © 2012-2021 Basis Technology. Generated on: Thu Jul 8 2021
This work is licensed under a Creative Commons Attribution-Share Alike 3.0 United States License.