Developers Guide

Creating departments

To create a department, you must perform the following:

  1. Get the taxonomy manager.
    Get an instance of the TaxonomyManager object.
  2. Get the Departments taxonomy.
    You create the department taxa as children of the Departments taxonomy.
  3. Create a new hierarchical taxon.
    To create a new hierarchical taxon, call the CreateTaxon generic method of the manager and pass HierarchicalTaxon as a generic argument.
  4. Set the properties of the taxon.
    In this example the following properties are set:
    • Name - represents the programmatic name of the department. In this example all unsafe characters are replaced with “-“. You can also pass the name as argument.
    • Title - represents the display name of the department.
    • Description - represents the description of the department. Use it to specify additional information about the department.
    • UrlName - represents the name of the department that is used in URLs.
  5. Set the taxonomy of the department.
    To do this, you must set the Taxonomy property of the department to the instance of the Departments taxonomy.
  6. Set the parent taxon, if available.
    If a parent taxon is specified, get an instance of that taxon and set the Parent property to it.
  7. Save the changes.
    To save the changes, call the SaveChanges method of the manager.

Here is an example:

public static void CreateDepartment(string name, string description, string parent)
{
    TaxonomyManager taxonomyManager = TaxonomyManager.GetManager();
 
    HierarchicalTaxonomy departments = taxonomyManager.GetTaxonomies<HierarchicalTaxonomy>().Where(t => t.Name == "Departments").SingleOrDefault();
 
    if (departments != null)
    {
        HierarchicalTaxon department = taxonomyManager.CreateTaxon<HierarchicalTaxon>();
        department.Name = Regex.Replace(name.ToLower(), @"[^\w\-\!\$\'\(\)\=\@\d_]+", "-");
        department.Title = name;
 
        department.Description = description;
        department.UrlName = department.Name;
 
        department.Taxonomy = departments;
 
        if (!String.IsNullOrEmpty(parent))
        {
            HierarchicalTaxon parentDepartment = departments.Taxa.Where(t => t.Title == parent).SingleOrDefault() as HierarchicalTaxon;
 
            if (parentDepartment != null)
            {
                department.Parent = parentDepartment;
                parentDepartment.Subtaxa.Add(department);
            }
        }
 
        taxonomyManager.SaveChanges();
    }
}

Next steps

+1-888-365-2779
sales@sitefinity.com

Related topics:

Feedback

How useful is this article?

Tell us more

Submit
Your message was successfully sent.

We appreciate your feedback.

Your message could not be sent.

OK