Użycie pól obliczeniowych w schemacie

Właściwość pola formula może służyć do dodawania pól obliczeniowych do schematu oprogramowania sprzęgającego.

Pełną listę funkcji obsługiwanych w formułach znajdziesz na liście funkcji. Dodatkowo dostępna jest dodatkowa dokumentacja:

Jeśli w formule odwołujesz się do pola ID z innego pola, poprzedź je prefiksem $. Jeśli na przykład pole ID to t_celsius, powinno ono zostać określone w formule jako $t_celsius.

Type dla pól obliczeniowych

Wartość Type jest obsługiwana w przypadku pól obliczeniowych, ale dane wyjściowe formuły muszą być zgodne z oczekiwanym formatem dla tego parametru Type.

Na przykład dla formuły:

"HYPERLINK($url, $description)"

Wartość Type powinna wynosić HYPERLINK.

aggregation dla pól obliczeniowych

Jeśli formuła obejmuje agregację, właściwość aggregation powinna mieć wartość AUTO. Sprawdź w kolumnie type na liście funkcji, czy funkcja zwraca agregację. Jeśli formuła nie obejmuje agregacji, ustaw dla niej wartość NONE.

Formuła aggregation
"SUM($cost) / SUM($units)" AUTO
"$cost + $units" NONE

Przykłady pól obliczeniowych w schemacie

function getSchema(request) {
  var cc = DataStudioApp.createCommunityConnector();
  var fields = cc.getFields();
  var types = cc.FieldType;
  var aggregations = cc.AggregationType;

  fields.newDimension()
      .setId('date')
      .setName('Date')
      .setDescription('Date of measurement')
      .setType(types.YEAR_MONTH_DAY);

  fields.newMetric()
      .setId('t_celsius')
      .setName('Temperature (Celsius)')
      .setDescription('Temperature in Celsius')
      .setType(types.NUMBER)
      .setAggregation(aggregations.NONE);

  fields.newMetric()
      .setId('t_fahrenheit')
      .setName('Temperature (Fahrenheit)')
      .setDescription('Temperature in Fahrenheit')
      .setFormula('$t_celsius / 5 * 9 + 32')
      .setType(types.NUMBER)
      .setAggregation(aggregations.NONE);

  fields.newMetric()
      .setId('average_temperature (Celsius)')
      .setName('Average Temperature (Celsius)')
      .setDescription('Temperature in Fahrenheit')
      .setFormula('AVG($t_celsius)')
      .setType(types.NUMBER)
      .setAggregation(aggregations.AUTO);

  fields.newMetric()
      .setId('average_temperature (Celsius)')
      .setName('Average Temperature (Celsius)')
      .setDescription('Temperature in Fahrenheit')
      .setFormula('AVG($t_celsius / 5 * 9 + 32)')
      .setType(types.NUMBER)
      .setAggregation(aggregations.AUTO);

  fields.newDimension()
      .setId('feels_like')
      .setName('Feels Like')
      .setDescription('What it feels like outside.')
      .setFormula('CASE WHEN $t_celsius < 0 THEN "Freezing" WHEN $t_celsius > 40 THEN "Too warm" ELSE "Not bad" END')
      .setType(types.TEXT);

  return { 'schema': fields.build() };
}