--- schema_version: "1" id: f31409cb90ae4a3f1fabfa983a748938b20fd60af8ff15802b18762173a4a277 title: Metric collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_metric.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_metric.htm source_site: developer.salesforce.com content_type: documentation content_hash: b9332a1670081f3c42876fb557eb18a5ada65fe86fdb6b666d765451e5a6a229 description: The Metric object represents the components of a goal metric such as its name, metric type, and current value. --- # Metric The Metric object represents the components of a goal metric such as its name, metric type, and current value. ![Note](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/images/icon_note.png) #### Note The original WDC feature is unavailable as of Spring '22. This object isn't available as of API version 54.0. For more information, see [Phased WDC (legacy Work.com) Feature Retirement](https://help.salesforce.com/s/articleView?id=000356306&type=1&language=en_US). ## Supported Calls create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert() ## Fields | Field Name | Details | | --- | --- | | CompletionDate | Type dateTime Properties Create, Filter, Nillable, Sort, Update Description The completion date of the metric. | | CurrentValue | Type double Properties Create, Defaulted on create, Filter, Nillable, Sort, Update Description The current value of the metric. | | Description | Type textarea Properties Create, Nillable, Update Description The description of the metric. The maximum length is 65,535 characters. | | DueDate | Type date Properties Create, Filter, Group, Nillable, Sort, Update Description The due date of the metric. | | GoalId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The ID of the goal the metric is related to. | | InitialValue | Type double Properties Create, Defaulted on create, Filter, Nillable, Sort, Update Description The initial value of the metric. | | IsCompletionMetric | Type boolean Properties Defaulted on create, Filter, Group, Sort Description Read only. If true, the metric measures whether or not the metric is finished. If false, the metric measures how much is finished compared to a targeted value. | | LastComment | Type textarea Properties Create, Filter, Group, Nillable, Sort, Update Description A comment that provides more context about the metric, such as its status or progress. The maximum length is 255 characters. | | LastReferencedDate | Type dateTime Properties Filter, Nillable, Sort Description The timestamp that indicates when a user last viewed a record that is related to this metric. | | LastViewedDate | Type dateTime Properties Filter, Nillable, Sort Description The timestamp that indicates when a user last viewed this metric. If this value is null, this record might have been only referenced (LastReferencedDate) and not viewed. | | Name | Type string Properties Create, Filter, Group, Sort, Update Description The name of the metric. | | OwnerId | Type reference Properties Create, Defaulted on create, Filter, Group, Sort, Update Description ID of the user who owns the metric. | | Progress | Type percent Properties Filter, Nillable, Sort Description Read only. The overall progress of the metric. | | RecordTypeId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description ID of the related record type. | | StartDate | Type date Properties Create, Filter, Group, Nillable, Sort, Update Description The start date of the metric. | | Status | Type picklist Properties Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description The status of the metric. Possible values include: - Not Started - On Track - Behind - Critical - Completed - Postponed - Canceled - Not Completed | | TargetValue | Type double Properties Create, Defaulted on create, Filter, Nillable, Sort, Update Description The target value of the metric. | | Weight | Type double Properties Create, Filter, Nillable, Sort, Update Description The weight of the metric. The sum of the weights should equal 100%. | ## Associated Objects This object has the following associated objects. Unless noted, they are available in the same API version as this object. [MetricFeed](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_feed.htm "StandardObjectNameFeed is the model for all feed objects associated with standard objects. These objects represent the posts and feed-tracked changes of a standard object.") Feed tracking is available for the object. [MetricHistory](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_history.htm "StandardObjectNameHistory is the model for all history objects associated with standard objects. These objects represent the history of changes to the values in the fields of a standard object.") History is available for tracked fields of the object. The original WDC feature is unavailable as of Spring '22. This object isn't available as of API version 54.0. For more information, see [Phased WDC (legacy Work.com) Feature Retirement](https://help.salesforce.com/s/articleView?id=000356306&type=1&language=en_US). [MetricOwnerSharingRule](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_ownersharingrule.htm "StandardObjectNameOwnerSharingRule is the model for all owner sharing rule objects associated with standard objects. These objects represent a rule for sharing a standard object with users other than the owner.") Sharing rules are available for the object. The original WDC feature is unavailable as of Spring '22. This object isn't available as of API version 54.0. For more information, see [Phased WDC (legacy Work.com) Feature Retirement](https://help.salesforce.com/s/articleView?id=000356306&type=1&language=en_US). [MetricShare](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_share.htm "StandardObjectNameShare is the model for all share objects associated with standard objects. These objects represent a sharing entry on the standard object.") Sharing is available for the object.