EcoResCategory::lookupCategoryHierarchyRole Method

Creates and displays a lookup from which the user can select a category ID from a specified category hierarchy role.

Syntax

Note

The syntax of this method varies based on the version of Microsoft Dynamics AX that you are using.

  Microsoft Dynamics AX 2012 R3
          client public static Common lookupCategoryHierarchyRole(
            FormReferenceControl _formReferenceControl, 
            EcoResCategoryNamedHierarchyRole _ecoResCategoryNamedHierarchyRole, 
           [boolean _leafNodeOnlySelect, 
            boolean _showActiveNodesOnly, 
            boolean _showCommodityCodeWithName, 
            EcoResCategorySelectionValidator _ecoResCategorySelectionValidator, 
            RefRecId _buyingLegalEntity, 
            RefRecId _receivingOperatingUnit, 
            ProcCategoryOrganizationOption _organizationOption, 
            RecId _purchAgreementHeaderRecId])

  Microsoft Dynamics AX 2012 R2 (SYS)
          client public static Common lookupCategoryHierarchyRole(
            FormReferenceControl _formReferenceControl, 
            EcoResCategoryNamedHierarchyRole _ecoResCategoryNamedHierarchyRole, 
           [boolean _leafNodeOnlySelect, 
            boolean _showActiveNodesOnly, 
            boolean _showCommodityCodeWithName, 
            EcoResCategorySelectionValidator _ecoResCategorySelectionValidator, 
            RefRecId _buyingLegalEntity, 
            RefRecId _receivingOperatingUnit, 
            ProcCategoryOrganizationOption _organizationOption, 
            RecId _purchAgreementHeaderRecId])

  Microsoft Dynamics AX 2012 Feature Pack (SYS)
          client public static Common lookupCategoryHierarchyRole(
            FormReferenceControl _formReferenceControl, 
            EcoResCategoryNamedHierarchyRole _ecoResCategoryNamedHierarchyRole, 
           [boolean _leafNodeOnlySelect, 
            boolean _showActiveNodesOnly, 
            boolean _showCommodityCodeWithName, 
            EcoResCategorySelectionValidator _ecoResCategorySelectionValidator, 
            RefRecId _buyingLegalEntity, 
            RefRecId _receivingOperatingUnit, 
            ProcCategoryOrganizationOption _organizationOption, 
            RecId _purchAgreementHeaderRecId])

  Microsoft Dynamics AX 2012 (FPK)
          client public static Common lookupCategoryHierarchyRole(
            FormReferenceControl _formReferenceControl, 
            EcoResCategoryNamedHierarchyRole _ecoResCategoryNamedHierarchyRole, 
           [boolean _leafNodeOnlySelect, 
            boolean _showActiveNodesOnly, 
            boolean _showCommodityCodeWithName, 
            EcoResCategorySelectionValidator _ecoResCategorySelectionValidator, 
            RefRecId _buyingLegalEntity, 
            RefRecId _receivingOperatingUnit, 
            ProcCategoryOrganizationOption _organizationOption])

  Microsoft Dynamics AX 2012 (SYS)
          client public static Common lookupCategoryHierarchyRole(
            FormReferenceControl _formReferenceControl, 
            EcoResCategoryNamedHierarchyRole _ecoResCategoryNamedHierarchyRole, 
           [boolean _leafNodeOnlySelect, 
            boolean _showActiveNodesOnly, 
            boolean _showCommodityCodeWithName, 
            EcoResCategorySelectionValidator _ecoResCategorySelectionValidator, 
            RefRecId _buyingLegalEntity, 
            RefRecId _receivingOperatingUnit, 
            ProcCategoryOrganizationOption _organizationOption])

Run On

Client

Parameters

• _formReferenceControl
  Type: FormReferenceControl Class
  The calling form reference control.

• _ecoResCategoryNamedHierarchyRole
  Type: EcoResCategoryNamedHierarchyRole Enumeration
  An EcoResCategoryNamedHierarchyRole enumeration value that indicates the category hierarchy from which to get the categories.

• _leafNodeOnlySelect
  Type: boolean
  A Boolean value that indicates whether only the leaf categories are selectable; optional.

• _showActiveNodesOnly
  Type: boolean
  A Boolean value that indicates whether only the active categories are shown in the tree view or not; optional.

• _showCommodityCodeWithName
  Type: boolean
  A Boolean value that indicates whether to show the commodity code and the category name in the tree view; optional.

• _ecoResCategorySelectionValidator
  Type: EcoResCategorySelectionValidator Interface
  An object that implements the EcoResCategorySelectionValidator interface that is used for validating the category selection; optional.

• _buyingLegalEntity
  Type: RefRecId Extended Data Type
  The legal entity reference record ID in the CompanyInfo table for which the category availability can be retrieved; optional.

• _receivingOperatingUnit
  Type: RefRecId Extended Data Type
  The operating unit reference record ID in the OMOperatingUnit table for which the category availability can be retrieved; optional.

• _organizationOption
  Type: ProcCategoryOrganizationOption Enumeration
  The ProcCategoryOrganizationOption enumeration gives an option to the user to find the category ID.

• _purchAgreementHeaderRecId
  Type: RecId Extended Data Type
  The PurchAgreementHeaderRecId (RefRecId) in the PurchAgreement table for which the category availability should be retrieved; optional.

Return Value

Type: Common Table
The selected record for record mode selection; otherwise nullNothingnullptrunita null reference (Nothing in Visual Basic).

Remarks

The category ID can be found by buying the legal entity, which considers only buying the legal entity, by receiving the operating unit, which considers buying the legal entity and receiving the operating unit, and by both, which considers both buying the legal entity, and buying the legal entity and receiving the operating unit combined.

See Also

Reference

EcoResCategory Table