Real Property / Strategic Financial Analysis / Financial Analysis (SC) - Smart Client

Update Analysis Metrics: How to Log Incomplete Asset Data

The Update Analysis Metrics action calculates analysis metrics values for each of your buildings, properties, pieces of equipment and projects for the current fiscal year, as well as for each year of the asset's planned life (for life-cycle analysis metrics).

If background data is incomplete for an asset and fiscal year, then some of the analysis metrics values that use that background data might be zero.

For example, for calculating the Net Present Value (NPV) for the lifetime of the building 'HQ',  the analysis metric "NPV (lifetime)" needs to use the financial parameters "Purchase Date"(finanal_params.date_purchased) and "Planned Life (in Years)" (finanal_params.planned_life) for building HQ.

If those are missing, then the NPV (lifetime) for building HQ and current fiscal year will be calculated to zero.

When you, as the analyst or process owner, run the Update Analysis Metrics, action, the job processing message does not displays details regarding the calculated values of each analysis metric, asset, and fiscal year. If you want deeper information for tracing seeming anomalies, ask your add-in manager to follow the topic below to add this information to the log.

For example, to be able to investigate why the NPV (lifetime) for building HQ and current fiscal year is zero, the Add-in Manager needs to set Archibus to echo which metrics and assets have incomplete data, as described in the following procedure.

Step-by-step procedure to set Archibus to log incomplete asset data

  1. Modify the log4j2.xml file:
    1. Find the file log4j2.xml  which is located in : %your-webcentral-install-folder%\WEB-INF\config\context\logging\log4j2.xml
    2. Edit the log4j2.xml by adding the following lines:

      <!-- Update Analysis Metrics logging -->

      <category name="com.archibus.app.common.finanal">

      <priority value="info" />

      </category>

      For example:

      update_anal_metrics_log.png

    3. Save the changes to the file
  2. Edit the InstallDir\SmartClient\SmartClient.Common.dll.config file to set debug mode to on.
    If you change this setting, the next time the System Administrator restarts the application server, it will be in or out of debug mode, per this setting.
  3. Restart the Archibus servers.
    • " Update Analysis Metrics"  runs by default at startup, and recalculates all the analysis metrics.

    Otherwise, run "Update Analysis Metrics" from Web Central.'s Real Property / Strategic Financial Analysis / Financial Analysis / … Buildings (ab-finanal-aggregate-forecast-costs-bl.axvw)

  4. Open the archibus.log file, and look for the logged results for metrics and assets that have incomplete data. The logged information should look like this:

    update_anal_metrics2.png