asset.py

# -*- coding: utf-8 -*-

"""
    Asset Management Functionality

    http://eden.sahanafoundation.org/wiki/BluePrint/Assets
"""

module = request.controller
resourcename = request.function

if not settings.has_module(module):
    raise HTTP(404, body="Module disabled: %s" % module)

# -----------------------------------------------------------------------------
def index():
    """ Module Home Page """

    module_name = settings.modules[module].name_nice
    response.title = module_name

    return dict(module_name=module_name)

# -----------------------------------------------------------------------------
def create():
    """ Redirect to asset/create """

    redirect(URL(f="asset", args="create"))

# -----------------------------------------------------------------------------
def asset():
    """ RESTful CRUD controller """

    # Use the item() controller in this module to set options correctly
    s3db.asset_asset.item_id.comment = S3AddResourceLink(f="item",
        label=T("Add New Item"),
        title=T("Item"),
        tooltip=T("Type the name of an existing catalog item OR Click 'Add New Item' to add an item which is not in the catalog."))

    # Defined in Model for use from Multiple Controllers for unified menus
    return s3db.asset_controller()

# -----------------------------------------------------------------------------
def brand():
    """ RESTful CRUD controller """

    return s3_rest_controller("supply", "brand")

# -----------------------------------------------------------------------------
def catalog():
    """ RESTful CRUD controller """

    return s3_rest_controller("supply", "catalog",
                              rheader=s3db.supply_catalog_rheader)

# -----------------------------------------------------------------------------
def item():
    """ RESTful CRUD controller """

    if "catalog_item" not in request.args:
        # Filter to just Assets
        table = s3db.supply_item
        ctable = s3db.supply_item_category
        s3.filter = (table.item_category_id == ctable.id) & \
                    (ctable.can_be_asset == True)

        # Limit the Categories to just those which can be Assets
        # - make category mandatory so that filter works
        field = s3db.supply_item.item_category_id
        field.requires = IS_ONE_OF(db,
                                   "supply_item_category.id",
                                   s3db.supply_item_category_represent,
                                   sort=True,
                                   filterby = "can_be_asset",
                                   filter_opts = [True]
                                   )
                    
        field.comment = S3AddResourceLink(f="item_category",
                                          label=T("Add Item Category"),
                                          title=T("Item Category"),
                                          tooltip=T("Only Categories of type 'Asset' will be seen in the dropdown."))

    # Defined in the Model for use from Multiple Controllers for unified menus
    return s3db.supply_item_controller()

# -----------------------------------------------------------------------------
def catalog_item():
    """
        RESTful CRUD controller
        - used for Imports
    """

    return s3_rest_controller("supply", "catalog_item",
                              csv_template=("supply", "catalog_item"),
                              csv_stylesheet=("supply", "catalog_item.xsl"),
                              )

# -----------------------------------------------------------------------------
def item_category():
    """ RESTful CRUD controller """

    table = s3db.supply_item_category

    # Filter to just Assets
    s3.filter = (table.can_be_asset == True)

    # Default to Assets
    field = table.can_be_asset
    field.readable = field.writable = False
    field.default = True
    
    return s3_rest_controller("supply", "item_category")

# -----------------------------------------------------------------------------
def supplier():
    """ RESTful CRUD controller """

    request.get_vars["organisation.organisation_type_id$name"] = "Supplier"

    # Load model
    table = s3db.org_organisation

    # Modify CRUD Strings
    ADD_SUPPLIER = T("Add Supplier")
    s3.crud_strings.org_organisation = Storage(
        title_create=ADD_SUPPLIER,
        title_display=T("Supplier Details"),
        title_list=T("Suppliers"),
        title_update=T("Edit Supplier"),
        title_search=T("Search Suppliers"),
        title_upload=T("Import Suppliers"),
        subtitle_create=ADD_SUPPLIER,
        label_list_button=T("List Suppliers"),
        label_create_button=ADD_SUPPLIER,
        label_delete_button=T("Delete Supplier"),
        msg_record_created=T("Supplier added"),
        msg_record_modified=T("Supplier updated"),
        msg_record_deleted=T("Supplier deleted"),
        msg_list_empty=T("No Suppliers currently registered")
        )

    return s3db.org_organisation_controller()

# END =========================================================================