psdi.app.recontask.engine.dataset

Class DPADataSet

  • All Implemented Interfaces:
    DataSet


    public class DPADataSet
    extends CommonDataSet
    recon data set for Deployed Assets.
    • Field Detail

      • RECON_LINK_DOMAIN_EXCLUDE

        public static final java.lang.String[] RECON_LINK_DOMAIN_EXCLUDE
      • OTHER_DOMAIN_EXCLUDE

        public static final java.lang.String[] OTHER_DOMAIN_EXCLUDE
      • DPA_ATTRIBUTES_EXCLUDE

        public static final java.lang.String[] DPA_ATTRIBUTES_EXCLUDE
    • Constructor Detail

      • DPADataSet

        public DPADataSet()
    • Method Detail

      • getMainObjectName

        public java.lang.String getMainObjectName()
        Description copied from interface: DataSet
        The data set class needs to implement this method to provide the name of its main object that will be reconciled. The name can be in either upper case or lower case or mixed.
        Returns:
        The main object name of this data set.
      • getTaskFilterAttributesDomainID

        public java.lang.String getTaskFilterAttributesDomainID()
        Description copied from interface: DataSet
        The available attributes of task filters for any data set are defined by synonym domain. The data set class provides the ID of the domain using this method. This method must be implemented by all data set classes. It is used in both the recon engine and the recon taks filter application.
        Notice that the attributes defined in the domain may or may not be from the main table, and their names may or may not be the same as the corresponding column names in the database tables.
        Returns:
        The synonyn domain ID that defines the list of filter attributes.
      • getObjectNameDomainID

        public java.lang.String getObjectNameDomainID()
        Description copied from interface: DataSet
        All objects, including class spec objects, that can be linked or compared with the data set must be defined in a synonym domain. The recon GUI and engine will call this method to get the ID of this domain.
        Returns:
        The object names domain ID.
      • getTableJoinWhereClauseForComparison

        public java.lang.String getTableJoinWhereClauseForComparison(java.lang.String tableName,
                                                                     java.util.Map uidKeys)
                                                              throws MXException,
                                                                     java.rmi.RemoteException
        Description copied from class: CommonDataSet
        Throws IllegalArgumentException exception
        Specified by:
        getTableJoinWhereClauseForComparison in interface DataSet
        Overrides:
        getTableJoinWhereClauseForComparison in class CommonDataSet
        Parameters:
        tableName - The name of the table from which data is to be retrieved.
        uidKeys - The key values of the main table. this should at least include the unique IDs and primary key values. This parameter maps attribute names to attribute values.
        Returns:
        The where clause that joins the table and the main object table.
        Throws:
        MXException
        java.rmi.RemoteException
        See Also:
        DataSet.getTableJoinWhereClauseForComparison
      • getReconResultAttributeNamesForComparison

        public ResultTableAttributes getReconResultAttributeNamesForComparison(boolean isDataSet1)
        Description copied from interface: DataSet
        The data set uses this method to map database table columns that are specific to the data set to the ones in the RECONRESULT table for the successful or unsuccessful results of the comparison phase. The values of these columns are copied from attributes of the objects that are involved during the comparison process.
        The names are provided in the form of a ResultTableAttributes object which maintains a list of attribute names and the reconciliation result table (RECONLINK and RECONRESULT) column names they map to. The data set class normally instantiates a ResultTableAttributes, adds the attributes and returns it.
        Returns:
        The data set specific RECONRESULT table columns.
        See Also:
        ResultTableAttributes
      • getReconLinkAttributeNamesForLink

        public ResultTableAttributes getReconLinkAttributeNamesForLink(boolean isDataSet1)
        Returns the mapping between the actual columns in the reconlink table and this data set's proxy names for them.
        Returns:
        ResultTableAttributes - the mapping between the actual link table columns and the data set's equivalents of them - for link.
        See Also:
        ResultTableAttributes
      • getReconResultAttributeNamesForLink

        public ResultTableAttributes getReconResultAttributeNamesForLink(boolean isDataSet1)
        Returns the mapping between the actual columns in the reconresult table and this data set's proxy names for them.
        Returns:
        ResultTableAttributes - the mapping between the actual result table columns and the data set's equivalents of them - for link.
        See Also:
        ResultTableAttributes
      • getTableColumnNameForTaskFilter

        public java.lang.String getTableColumnNameForTaskFilter(java.lang.String attributeName)
        Returns the column name based on an attribute name encountered in the task filter being used with the data set.
        Specified by:
        getTableColumnNameForTaskFilter in interface DataSet
        Overrides:
        getTableColumnNameForTaskFilter in class CommonDataSet
        Parameters:
        - - String the column name.
        Returns:
        the column name based on an attribute name encountered in the task filter being used with the data set.
        See Also:
        DataSet.getTableColumnNameForTaskFilter
      • getTableJoinWhereClauseForTaskFilter

        public java.lang.String getTableJoinWhereClauseForTaskFilter(java.lang.String tableName)
        Returns the joining clause for task filter based on a table name.
        Specified by:
        getTableJoinWhereClauseForTaskFilter in interface DataSet
        Overrides:
        getTableJoinWhereClauseForTaskFilter in class CommonDataSet
        Parameters:
        the - name of the table to get the joining table for.
        Returns:
        the joining clause.
        See Also:
        DataSet.getTableJoinWhereClauseForTaskFilter
      • getTableNameForTaskFilter

        public java.lang.String getTableNameForTaskFilter(java.lang.String attributeName)
        Returns the table name in which the passed in attribute name resides.
        Specified by:
        getTableNameForTaskFilter in interface DataSet
        Overrides:
        getTableNameForTaskFilter in class CommonDataSet
        Parameters:
        attributeName - - the String the column name.
        Returns:
        - String the table name.
        See Also:
        DataSet.getTableNameForTaskFilter
      • getRootSpecMaxVar

        public java.lang.String getRootSpecMaxVar(java.lang.String objectname)
        Description copied from class: CommonDataSet
        In many cases the root classstructure id for class specs of a data set is defined in a maxvar. If so the classs can make use of the implementation of the getRootClassstructureID in CommonDataSet. Data set classes that extends the CommonDataSet will only need to implement this method to provide the name of the maxvar. It won't have to implement the getRootClassstructureID method itself.
        Specified by:
        getRootSpecMaxVar in class CommonDataSet
        Returns:
        The name of the maxvar which defines the root class structure id
      • getAttributesExcludeList

        public java.lang.String[] getAttributesExcludeList(java.lang.String objectname)
        Description copied from interface: DataSet
        Not all attributes of an object may be available for linking, comparison filtering, or comparison. This method is used by the data set to exclude some attributes from the attribute list in the GUI when an object is selected.
        Returns:
        names of attributes to exclude from the attribute list, null if none is to be excluded.
        See Also:
        getObjectNameDomainID
      • getObjectSpecPairs

        public java.lang.String[][] getObjectSpecPairs()
        Description copied from interface: DataSet
        If the reconciliation can be performed on a class specification of an object, the recon engine will read in the spec object data along with that of the master object. The data set does not need to provide a SQL where clause of how to join the spec objects to their master objects. It only need to implement this method to pair up all the master objects and their spec objects.
        The master and spec object pairs are provided as an array, with every element of the array lists one pair. Each element in turn is a String array with 2 elements. The 1st element is the master object name and the 2nd element is the spec object name.
        Returns:
        The object-spec pairs, or null if spec is not used in this data set.
      • getObjectNameDomainExcludeList

        public java.lang.String[] getObjectNameDomainExcludeList(java.lang.String objectName)
        Returns a list of elements to exclude from the domain.
        Parameters:
        objectName - Name of object that uses the domain.
        Returns:
        Elements to exclude from the domain.
        See Also:
        getObjectNameDomainID
      • isUnitOfMeasureAllowed

        public boolean isUnitOfMeasureAllowed(java.lang.String objectName)
        Determines whether the dataset allows use of the "Unit of Measure" attribute for all or part of its subtypes.
        Specified by:
        isUnitOfMeasureAllowed in interface DataSet
        Overrides:
        isUnitOfMeasureAllowed in class CommonDataSet
        Parameters:
        objectName - The name of a subset.
        Returns:
        boolean Whether or not the use of the "Unit of Measure" attribute is allowed.