Obter recurso único

import { useFeature } from 'ibm-appconfiguration-react-client-sdk';

const feature = useFeature('featureId'); // returns undefined incase the featureId is invalid or doesn't exist

if (feature !== undefined) {
  console.log(`Feature Name ${feature.getFeatureName()} `);
  console.log(`Feature Id ${feature.getFeatureId()} `);
  console.log(`Feature Type ${feature.getFeatureDataType()} `);
  console.log(`Is feature enabled? ${feature.isEnabled()} `);
}

Obter todos os recursos

import { useFeatures } from 'ibm-appconfiguration-react-client-sdk';

const features = useFeatures();
const feature = features['featureId'];

if (feature !== undefined) {
  console.log(`Feature Name ${feature.getFeatureName()} `);
  console.log(`Feature Id ${feature.getFeatureId()} `);
  console.log(`Feature Type ${feature.getFeatureDataType()} `);
  console.log(`Is feature enabled? ${feature.isEnabled()} `);
}

Avaliar um recurso

É possível usar o método feature.getCurrentValue(entityId, entityAttributes) para avaliar o valor da sinalização do recurso. Este método retorna um valor Ativado / Desativado / Substituído com base na avaliação. O tipo de dados do valor retornado corresponde ao sinalizador do recurso. Passe um entityId exclusivo como o parâmetro para executar a avaliação do sinalizador de recurso.

const entityId = 'john_doe';
const entityAttributes = {
  city: 'Bangalore',
  country: 'India',
};

const feature = useFeature('featureId');
const featureValue = feature.getCurrentValue(entityId, entityAttributes);

Em que:

• entityId: ID da Entidade. Será um identificador de sequência relacionado à Entidade com relação à qual o recurso é avaliado. Por exemplo, uma entidade pode ser uma instância de um aplicativo que é executado em um dispositivo móvel ou um usuário que acessa o aplicativo da Web. Para que qualquer entidade interaja com o App Configuration, ela deve fornecer um ID de entidade exclusivo.
• entityAttributes: um objeto JSON que consiste no nome do atributo e seus valores que definem a entidade especificada. Este é um parâmetro opcional se o sinalizador de recurso não estiver configurado com nenhuma definição de destino Se o destino estiver configurado, então entityAttributes deverá ser fornecido para a avaliação de regra Um atributo é um parâmetro que é usado para definir um segmento. O SDK usa os valores de atributo para determinar se a entidade especificada satisfaz as regras de destino e retorna o valor da sinalização de recurso apropriado.

Enviar métricas personalizadas

Registre métricas personalizadas usando o gancho " useTrack na experimentação.

import { useTrack } from 'ibm-appconfiguration-react-client-sdk';

export default MyComponent = function () {
    const trackEvent = useTrack();
    return (
        <button onClick={() => trackEvent('clicked', 'user123')}>Buy</button>
    )
}

Obter propriedade única

import { useProperty } from 'ibm-appconfiguration-react-client-sdk';

const property = useProperty('propertyId'); // returns undefined incase the propertyId is invalid or doesn't exist

if (property !== undefined) {
  console.log(`Property Name ${property.getPropertyName()} `);
  console.log(`Property Id ${property.getPropertyId()} `);
  console.log(`Property Type ${property.getPropertyDataType()} `);
}

Obter todas as propriedades

import { useProperties } from 'ibm-appconfiguration-react-client-sdk';

const properties = useProperties();
const property = properties['propertyId'];

if (property !== undefined) {
  console.log(`Property Name ${property.getPropertyName()} `);
  console.log(`Property Id ${property.getPropertyId()} `);
  console.log(`Property Type ${property.getPropertyDataType()} `);
}

Avaliar uma propriedade

Use o método property.getCurrentValue(entityId, entityAttributes) para avaliar o valor da propriedade. Esse método retorna o valor da propriedade padrão ou seu valor substituído, com base na avaliação. O tipo de dados do valor retornado corresponde àquele da propriedade..

const entityId = 'john_doe';
const entityAttributes = {
  city: 'Bangalore',
  country: 'India',
};

const property = useProperty('propertyId');
const propertyValue = property.getCurrentValue(entityId, entityAttributes);

Em que:

• entityId: ID da Entidade. Este será um identificador de sequência relacionado à Entidade na qual a propriedade é avaliada. Para que qualquer entidade interaja com o App Configuration, ela deve fornecer um ID de entidade exclusivo.
• entityAttributes: um objeto JSON que consiste no nome do atributo e seus valores que definem a entidade especificada. Este é um parâmetro opcional se a propriedade não estiver configurada com nenhuma definição de destino Se o destino estiver configurado, então entityAttributes deverá ser fornecido para a avaliação de regra Um atributo é um parâmetro que é usado para definir um segmento. O SDK usa os valores de atributo para determinar se a entidade especificada satisfaz as regras de destino e retorna o valor da propriedade apropriado..

Usando valores de fallback com o React Client SDK

No caso de um erro de conexão com o App Configuration, o SDK se baseia nos valores de sinalizador avaliados mais recentemente e mantidos na memória. No entanto, se não houver valores anteriores na memória, é aconselhável que os usuários estabeleçam valores de fallback em seu código, garantindo uma operação tranquila. Um exemplo que mostra essa abordagem de fallback é fornecido pelo exemplo a seguir.

import { useFeatures } from 'ibm-appconfiguration-react-client-sdk';

export default function App {
  const features = useFeatures();
  const defaultFlagValues = {
    'flight-booking': false
  }
  const entityId = 'john_doe';
  const entityAttributes = {
    city: 'Bangalore',
    country: 'India',
  };

  const getAppConfigurationFlags = (featureID, features) => {
    if (Object.keys(features).length === 0 && features.constructor === Object) {
      return defaultFlagValues[featureID];
    }

    return feature[featureID]
      ? feature[featureID].getCurrentValue(entityId, entityAttributes)
      : defaultFlagValues[featureID];
  };

  return getAppConfigurationFlags('flight-booking', features) ? <div>Flight Booking</div> : '';
}