View a markdown version of this page

Cree una definición de atributo calculada personalizada de Connect Customer Profiles - Amazon Connect Customer
Paso 1: crear un archivo JSONPaso 2: Llama CreateCalculatedAttributeDefinition

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Cree una definición de atributo calculada personalizada de Connect Customer Profiles

Con la CreateCalculatedAttributeDefinition API de perfiles de clientes, puede crear mediante programación su propio atributo calculado en función de un tipo de objeto personalizado.

En este tema mostramos cómo crear un atributo calculado mediante un archivo JSON personalizado.

Paso 1: crear un archivo JSON

Cree un archivo JSON con el siguiente contenido:


{
"DomainName": "your-domain-name", 
   "CalculatedAttributeName": "your-calculated-attribute-name",
   "UseHistoricalData": true,
   "DisplayName": "your-display-name",
   "Description": "your-description",
   "AttributeDetails": {
"Attributes": [
         {
            "Name": "your-attribute-name"
         }
       ],
       "Expression": "{your-object-type.your-attribute-name}"
   },
    "Statistic": "your-statistic",
    "Conditions": {
       "Range": {
        "ValueRange"
        {
            "Start": your-range-start
            "End": your-range-end
        },
        "TimestampSource": "{your-object-type.your-timestamp-source}",          
        "Unit": "days"
        },
        "ObjectCount":  your-object-count,
        "Threshold": {
           "Value": "your-threshold-value",
           "Operator": "your-threshold-operator"
        }
   }  
}

Para personalizar el código JSON con sus propios valores, siga estas indicaciones:

  • Attributes: debe contener el nombre del campo del tipo de objeto que desea utilizar para el atributo calculado. Se admiten dos atributos a los que se haga referencia en esta lista.

  • Expression: se admiten expresiones matemáticas básicas para realizarlas entre atributos. Si solo tiene un atributo, este campo debería ser {ObjectTypeName.AttributeName}; de lo contrario, si tiene en mente una expresión matemática, este campo debe contener ambos atributos.

  • Statistic: es la operación que se realiza cuando se llama a una de las API de cálculo que realmente realiza la operación de agregación. La mayoría se explican por sí mismas, pero hemos agregado explicaciones para las que no lo son.

    Estadísticas admitidas

    • FIRST_OCCURRENCE devuelve el atributo especificado en la expresión del primer objeto ingerido.

    • LAST_OCCURRENCE devuelve el atributo especificado en la expresión del último objeto ingerido.

    • COUNT devuelve el recuento de los datos seleccionados.

    • SUM devuelve la suma de los datos seleccionados.

    • MINIMUM devuelve el mínimo de los datos seleccionados.

    • MAXIMUM devuelve el máximo de los datos seleccionados.

    • AVERAGE devuelve el promedio de los datos seleccionados.

    • MAX_OCCURRENCE devuelve el valor que aparece con más frecuencia especificado en la expresión.

  • Rango:

    • Units: actualmente solo admiten unidades DIARIAS.

    • ValueRange: especifique números positivos en los campos ValueRange de inicio o final para indicar cuántos días hace que comience y números negativos para indicar cuántos días en el futuro debe comenzar.

    • TimestampSource: una expresión que especifica el campo de tu objeto JSON desde el que se debe analizar la fecha. La expresión debe seguir la estructura de\ "{ObjectTypeName. <Location of timestamp field in JSON pointer format>}\». Por ejemplo, si tu tipo de objeto es MyType y el JSON de origen es{"generatedAt": {"timestamp": "1737587945945"}}, entonces TimestampSource debería serlo"{MyType.generatedAt.timestamp}".

  • ObjectCount: Indica en cuántos objetos se debe basar el cálculo de los atributos calculados.

  • Threshold: si en lugar del valor exacto del atributo calculado quiere saber si, por ejemplo, es mayor que un valor determinado, puede utilizar un umbral.

    El valor de umbral puede ser cualquier cadena y se admiten los siguientes operadores de umbral.

    • GREATER_THAN

    • LESS_THAN

    • EQUAL_TO

    • NOT_EQUAL_TO

  • UseHistoricalData: Si los datos históricos ingeridos antes de crear el atributo calculado deben incluirse en los cálculos.

Paso 2: Llama a la API CreateCalculatedAttributeDefinition

Una vez que hayas creado y personalizado el archivo JSON con tus valores, llama a la CreateCalculatedAttributeDefinition API, como se muestra en el siguiente ejemplo:

aws customer-profiles create-calculated-attribute-definition --cli-input-json file:///custom_calculated_attribute_cli.json --region region_name

También puede utilizar el siguiente punto de conexión:

https://profile.your-region.amazonaws.com/domains/your-domain-name/calculated-attributes