Search

5.4 File System Resources

5.4.1 ThruPublicFolderInfo Structure

ThruPublicFolderInfo structure contains information about folder in Thru file system.

Item Name	Data Type	Sample Value	Comments
FolderID	Integer	0QN8H2VKTGIWE	Unique identification number for the folder in Thru file system
ParentFolderID	Integer	11ETULS0966VI	Unique identification number of the parent folder for the file in Thru file system. Root folder contains NULL as a value of ParentFolderID field
Name	String	Admin	Name of the folder
Path	String	FOLDERS/HOME/Admin	Path to the folder in folder tree
Description	String		Description of the folder
Tags	Collection		Collection of keywords associated with the current folder
Size	Long	2450294218	Size of the folder
EffectivePermission	Integer	254	Permissions that describe the rights of the current authenticated user over the folder. Each right is linked with the corresponding bit of the EffectivePermission field value in a binary code: None = 0×00 Show = 0×01 Read = 0×02 Create = 0×04 Download = 0×08 Distribute = 0×010 Manage = 0×020 Modify = 0×040 Delete = 0×080 For example, full control over a folder is equal to the EffectivePermission value of 0×00FF
DateCreated	DateTime	/Date(1337174868623)/	Date and time when file has been created in Thru file system (UTC)
DateModified	DateTime	/Date(1337174868623)/	Date and time when file last has been updated (UTC)
CreatedByUserID	Integer	1Q1OBQWVHTROE	Unique identification number of the user that has added file to Thru file system
ModifiedByUserID	Integer	1Q1OBQWVHTROE	Unique identification number of the user that last accessed the file
InFavorite	Boolean	false	Indicates is folder marked as favorite
FolderType	Integer	0	0 – a regular folder 1 – root folder 2 – home folder 3 – a user’s “My Documents” folder 4 – a user’s drop box folder 5 – root folder for common folders/files 6 – root folder for home folders

Sample XML

<ThruPublicFolderInfo xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<FolderId>0QN8H2VKTGIWE</FolderId>
<ParentFolderId>11ETULS0966VI</ParentFolderId>
<Name>Admin</Name>
<Path>FOLDERS/HOME/Admin</Path>
<Tags></Tags>
<Size>2450294218</Size>
<EffectivePermission>254</EffectivePermission>
<DateCreated>/Date(1337174868623)/</DateCreated>
<DateModified>/Date(1337174868623)/</DateModified>
<CreatedByUserId>1Q1OBQWVHTROE</CreatedByUserId>
<ModifiedByUserId>1Q1OBQWVHTROE</ModifiedByUserId>
<InFavorite>false</InFavorite>
<FolderType>0</FolderType>
</ThruPublicFolderInfo>

Data Transfer Object

public class ThruPublicFolderInfo
{
public string FolderId
public string ParentFolderId
public string Name
public string Description
public string Path
public string[] Tags
public long? Size
public int? EffectivePermission
public ThruServerDateTime DateCreated
public ThruServerDateTime DateModified
public string CreatedByUserId
public string ModifiedByUserId
public bool? InFavorite;
public int? FolderType;
}

5.4.2 ThruPublicFileInfo Structure

ThruPublicFileInfo structure contains information about file in Thru file system.

Item Name	Data Type	Sample Value	Comments
FileID	Integer	2OMFYXLA6BP9D	Unique identification number for the file in Thru file system
ParentFolderID	Integer	1UTXM50KW0ISP	Unique identification number of the parent folder for the file in Thru file system
Name	String	2.html	Name of the file
Description	String		Description of the file
Path		FOLDERS/HOME/Admin/My Documents/2.html	Path to the file in folder tree
Tags	Collection		Collection of keywords associated with the current folder
Size	Long	198	Size of the file
EffectivePermission	Integer	254	Permissions that describe the rights of the current authenticated user over the file. Each right is linked with the corresponding bit of the EffectivePermission field value in a binary code: None = 0×00 Show = 0×01 Read = 0×02 Create = 0×04 Download = 0×08 Distribute = 0×010 Manage = 0×020 Modify = 0×040
DateCreated	DateTime	/Date(1346072694480)/	Date and time when file has been created in Thru file system (UTC)
DateModified	DateTime	/Date(1346072694480)/	Date and time when file last has been updated (UTC)
CreatedByUserID	Integer	1Q1OBQWVHTROE	Unique identification number of the user that has added file to Thru file system
ModifiedByUserID	Integer	1Q1OBQWVHTROE	Unique identification number of the user that last accessed the file
IsQuarantined	Boolean	false	Indicates is file has been quarantined
InFavorite	Boolean	false	Indicates is file marked as favorite

Sample XML

<?xml version="1.0" encoding="utf-8" ?>
<ThruPublicFileInfo xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<FileId>2OMFYXLA6BP9D</FileId>
<ParentFolderId>1UTXM50KW0ISP</ParentFolderId>
<Name>2.html</Name>
<Path>FOLDERS/HOME/Admin/My Documents/2.html</Path>
<Tags></Tags>
<Size>198</Size>
<EffectivePermission>254</EffectivePermission>
<DateCreated>/Date(1346072694480)/</DateCreated>
<DateModified>/Date(1346072694480)/</DateModified>
<CreatedByUserId>1Q1OBQWVHTROE</CreatedByUserId>
<ModifiedByUserId>1Q1OBQWVHTROE</ModifiedByUserId>
<IsQuarantined>false</IsQuarantined>
<InFavorite>false</InFavorite>
</ThruPublicFileInfo>

Data Transfer Object

public class ThruPublicFileInfo
{
public string FileId;
public string ParentFolderId;
public string Name;
public string Description;
public string Path;
public string[] Tags;
public long? Size;
public int? EffectivePermission;
public ThruServerDateTime DateCreated;
public ThruServerDateTime DateModified;
public string CreatedByUserId;
public string ModifiedByUserId;
public bool? IsQuarantined;
public bool? InFavorite;
}

5.4.3 ThruPublicContentResult Structure

ThruPublicContentResult structure contains information about the content of the Thru folder.

Item Name	Data Type	Sample Value	Comments
Files	Collection< ThruPublicFileInfo >		Collection of file information structures
Folders	Collection< ThruPublicFolderInfo >		Collection of folder information structures

Sample XML

<?xml version="1.0" encoding="utf-8" ?>
<ThruPublicContentResult xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Folders>
<ThruPublicFolderInfo>
<FolderId>16LTFSCFLMF01</FolderId>
<ParentFolderId>1UTXM50KW0ISP</ParentFolderId>
<Name>test</Name>
<Path>FOLDERS/HOME/Admin/My Documents/test</Path>
<Tags></Tags>
<Size>470968940</Size>
<ChildFoldersCount>1</ChildFoldersCount>
<ChildFilesCount>4</ChildFilesCount>
<EffectivePermission>254</EffectivePermission>
<DateCreated>/Date(1348146557730)/</DateCreated>
<DateModified>/Date(1348146557730)/</DateModified>
<CreatedByUserId>1Q1OBQWVHTROE</CreatedByUserId>
<ModifiedByUserId>1Q1OBQWVHTROE</ModifiedByUserId>
<InFavorite>false</InFavorite>
<FolderType>0</FolderType>
</ThruPublicFolderInfo>
</Folders>
<Files>
<ThruPublicFileInfo>
<FileId>2OMFYXLA6BP9D</FileId>
<ParentFolderId>1UTXM50KW0ISP</ParentFolderId>
<Name>2.html</Name>
<Path>FOLDERS/HOME/Admin/My Documents/2.html</Path>
<Tags></Tags>
<Size>198</Size>
<EffectivePermission>254</EffectivePermission>
<DateCreated>/Date(1346072694480)/</DateCreated>
<DateModified>/Date(1346072694480)/</DateModified>
<CreatedByUserId>1Q1OBQWVHTROE</CreatedByUserId>
<ModifiedByUserId>1Q1OBQWVHTROE</ModifiedByUserId>
<IsQuarantined>false</IsQuarantined>
<InFavorite>false</InFavorite>
</ThruPublicFileInfo>
</Files>
</ThruPublicContentResult>

Data Transfer Object

public class ThruPublicContentResult
{
public ThruPublicFolderInfo[] Folders;
public ThruPublicFileInfo[] Files;
}