本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在公式表達式中使用變數
<a name="expression-variables"></a>

變數代表公式表達式中的 AWS IoT SiteWise 資產屬性。使用變數來輸入表達式中其他資產屬性的值，以便處理來自常數屬性 ([屬性](attributes.md))、原始資料串流 ([度量](measurements.md)) 和其他公式屬性的資料。

變數可以代表來自相同資產模型或相關聯子資產模型的資產屬性。只有指標公式可以從子資產模型輸入變數。

您可以透過主控台和 API 中的不同名稱來識別變數。
+ **AWS IoT SiteWise 主控台** – 在表達式中使用資產屬性名稱做為變數。
+ **AWS IoT SiteWise API (AWS CLI， AWS SDKs)** – 使用 [ExpressionVariable](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ExpressionVariable.html) 結構定義變數，這需要變數名稱和資產屬性的參考。變數名稱可以包含小寫字母、數字和底線。然後，使用變數名稱來參考表達式中的資產屬性。

變數名稱區分大小寫。

如需詳細資訊，請參閱[定義轉換](transforms.md)和[定義指標](metrics.md)。

## 使用變數來參考屬性
<a name="variable-values"></a>

變數*的值*會定義其參考的屬性。 AWS IoT SiteWise 提供不同的方法來執行此操作。
+ **依屬性 ID：**您可以指定屬性的唯一 ID (UUID) 來識別它。
+ **依名稱：**如果 屬性位於相同的資產模型上，您可以在屬性 ID 欄位中指定其名稱。
+ **依路徑：**變數值可以依其*路徑參考屬性。*如需詳細資訊，請參閱[使用路徑來參考自訂複合模型屬性](custom-composite-models.md#property-paths)。

**注意**  
 AWS IoT SiteWise 主控台不支援變數。 AWS IoT SiteWise API 會使用它們，包括 AWS Command Line Interface AWS CLI) 和 AWS SDKs。

 您在 的回應中收到的變數 AWS IoT SiteWise 包含該值的完整資訊，包括 ID 和路徑。

 不過，當您將變數傳遞至 AWS IoT SiteWise （例如，在「建立」或「更新」呼叫中） 時，您只需要指定其中一個。例如，如果您指定路徑，則不需要提供 ID。