取得單一特性

feature = appconfig_client.get_feature('online-check-in')  # feature can be None incase of an invalid feature id

if feature is not None:
   print(f'Feature Name : {0}'.format(feature.get_feature_name()))
   print(f'Feature Id : {0}'.format(feature.get_feature_id()))
   print(f'Feature Data Type : {0}'.format(feature.get_feature_data_type()))
   if feature.is_enabled():
      # feature flag is enabled
   else:
      # feature flag is disabled

取得所有特性

features_dictionary = appconfig_client.get_features()

特性評估

您可以使用 feature.get_current_value(entity_id, entity_attributes) 方法來評估特性旗標的值。 此方法會根據評估傳回其中一個「已啟用」、「已停用」或「已置換」值。 回覆值的資料類型符合特性旗標的資料類型。

entity_id = "john_doe"
entity_attributes = {
   'city': 'Bangalore',
   'country': 'India'
}
feature_value = feature.get_current_value(entity_id=entity_id, entity_attributes=entity_attributes)

• entity_id: 實體的 ID。 這是與用來評估特性的實體相關的字串 ID。 例如，實體可能是在行動式裝置上執行的應用程式實例、在雲端上執行的微服務，或執行該微服務之基礎架構的元件。 若要讓任何實體與 App Configuration互動，它必須提供唯一實體 ID。

• entity_attributes: JSON 物件，由定義指定實體的屬性名稱及其值組成。 如果特性旗標未配置任何目標定義，則這是選用參數。 如果已配置目標，則應該提供 entity_attributes 以進行規則評估。 屬性是用來定義區段的參數。 SDK 會使用屬性值來判斷指定的實體是否滿足目標規則，並傳回適當的特性旗標值。

取得單一內容

property = appconfig_client.get_property('check-in-charges')  # property can be None incase of an invalid property id
if property is not None:
   print(f'Property Name : {0}'.format(property.get_property_name()))
   print(f'Property Id : {0}'.format(property.get_property_id()))
   print(f'Property Data Type : {0}'.format(property.get_property_data_type()))

取得所有內容

properties_dictionary = appconfig_client.get_properties()

內容評估

您可以使用 property.get_current_value(entity_id=entity_id, entity_attributes=entity_attributes) 方法來評估內容的值。 此方法會根據評估傳回預設內容值或其置換值。 回覆值的資料類型符合內容的資料類型。

entity_id = "john_doe"
entity_attributes = {
   'city': 'Bangalore',
   'country': 'India'
}
property_value = property.get_current_value(entity_id=entity_id, entity_attributes=entity_attributes)

• entity_id: 實體的 ID。 這是與評估內容所依據的實體相關的字串 ID。 例如，實體可能是在行動式裝置上執行的應用程式實例、在雲端上執行的微服務，或執行該微服務之基礎架構的元件。 若要讓任何實體與 App Configuration互動，它必須提供唯一實體 ID。

• entity_attributes: JSON 物件，由定義指定實體的屬性名稱及其值組成。 如果內容未配置任何目標定義，則這是選用參數。 如果已配置目標，則應該提供 entity_attributes 以進行規則評估。 屬性是用來定義區段的參數。 SDK 會使用屬性值來判斷指定的實體是否滿足目標規則，並傳回適當的內容值。

內容

property = appconfig_client.get_property('json-property')
property.get_property_data_type() // STRING
property.get_property_data_format() // JSON
property.get_current_value(entityId, entityAttributes) // returns single dictionary object or list of dictionary object

// Example Below
// input json :- [{"role": "developer", "description": "do coding"},{"role": "tester", "description": "do testing"}]
// expected output :- "do coding"

tar_val = property.get_current_value(entityId, entityAttributes)
expected_output = tar_val[0]['description']

// input json :- {"role": "tester", "description": "do testing"}
// expected output :- "tester"

tar_val = property.get_current_value(entityId, entityAttributes)
expected_output = tar_val['role']

property = appconfig_client.get_property('yaml-property')
property.get_property_data_type() // STRING
property.get_property_data_format() // YAML
property.get_current_value(entityId, entityAttributes) // returns dictionary object

// Example Below
// input yaml string :- "---\nrole: tester\ndescription: do_testing"
// expected output :- "do_testing"

tar_val = property.get_current_value(entityId, entityAttributes)
expected_output = tar_val['description']

設定特性和內容資料變更的接聽器

SDK 提供當特性旗標或內容配置變更時即時通知您的機制。 您可以使用相同的 appconfig_client 來訂閱配置變更。

def configuration_update(self):
   print('Received updates on configurations')
   # **add your code**
   # To find the effect of any configuration changes, you can call the feature or property related methods

   # feature = appconfig_client.getFeature('online-check-in')
   # new_value = feature.get_current_value(entity_id, entity_attributes)

appconfig_client.register_configuration_update_listener(configuration_update)

提取最新資料

appconfig_client.fetch_configurations()