Documents data source (1)

  Previous topic Next topic Print this topic Mail us feedback on this topic!

  Default  
  Web part control ID: Serves as an identifier for the web part. This ID must be unique within the context of each page template. The value of this property may only contain alphanumeric characters and the underscore character ( _ ).  
  Web part title: Title of the web part displayed on the Design tab of CMS Desk and in on-site editing mode. If empty, the value of the Web part control ID property is used for this purpose.  
   

  Content  
  Path: Specifies the path of the documents that should be selected. If empty, the path will be set to all child documents under the page on which the web part is placed. Use '.' for current document selection.  
   

  Content filter  
  Document types: Determines which document types should be loaded, specified by a list of code names separated by semicolons (;). The * wildcard can be used as a substitute for a random sequence of characters. For example Product.* would include document types such as Product.Camera, Product.CellPhone, Product.Computer etc. If left empty, the web part will retrieve all document types by default. Please note that in this case (empty value), only the common data columns from View_CMS_Tree_Joined will be available. The specific fields of individual document types will not be included, so please consider this when writing transformations, WHERE conditions etc.  
  Category name: Code name of the category. Documents from this category and its subcategories will be filtered out.  
  Combine with default culture: Indicates if the default language version of a document should be used as a replacement if a given document is not translated to the currently selected language. If the 'Use site settings' option is selected, the value is taken from 'Site Manager -> Settings -> Content -> Combine with default culture'.  
  Culture code: Indicates which culture version of the specified documents should be used.  
  Maximum nesting level: Specifies the maximum number of content tree sub-levels from which content should be loaded. This number is relative, i.e. counted from the start of the path specified for the content of the web part. Entering -1 causes all sub-levels to be included.  
  ORDER BY Expression: Sets the value of the ORDER BY clause in the SELECT statement used to retrieve the content.  
  Select only published: Indicates if only published documents should be loaded.  
  Select top N documents: Specifies the maximum amount of documents to be loaded. If empty, all possible documents will be selected.  
  Site name: Sets the website (specified by its code name) from which the content should be loaded. If left empty, the current site is used.  
  WHERE condition: Sets the value of the WHERE clause in the SELECT statement used to retrieve the content.  
  Columns: Lists the database columns which should be loaded along with the given objects, separated by commas (,). If empty, all columns will be loaded. Specifying a list without unnecessary columns may significantly improve performance.  
  Filter out duplicates: Indicates if the retrieved data should be filtered to contain documents only once, even if they are linked multiple times.  
  Enable selected item: If checked, the datasource will provide only the currently selected document - if its type is included in the 'Document types' property.  
  Filter name: Sets the name of the Filter web part that should be connected.  
   

  System settings  
  Check permissions: Indicates if the permissions of the current user should be checked for the content of the web part. If enabled, only documents for which the user has the "read" permission will be loaded.  
  Cache item name: Sets the name of the cache key used for the content of the web part. If not specified, this name is generated automatically based on the site, document path, Web part control ID and current user. A cache key can be shared between multiple web parts with the same content on different pages in order to avoid keeping redundant data in the memory.  
  Cache minutes: Sets the number of minutes for which the content of the web part should remain cached before its latest version is reloaded from the database. If left empty, the value entered into the Site Manager -> Settings -> System -> Performance -> Cache content (minutes) setting will be used instead. If set to 0, caching will be disabled for the web part.  
  Cache dependencies: Contains a list of cache keys on which the partial cache of the web part depends. When the specified cache items change, the partial cache of the web part is deleted. Each line may contain a single item only. If the 'Use default cache dependencies' box is checked, the default dependencies will be used, which include all possible object changes that could affect the specific web part.  
   

  Performance  
  Disable view state: Indicates if view state should be disabled for this web part.  
  Disable macros: If checked, macros contained in the values of the web part's properties will no longer be resolved.  
   

Help URL: http://devnet.kentico.com/docs/webparts/index.html?DocumentsDataSource_1_properties.htm