Compilateur pour les objets Data
.
Voici un exemple d'utilisation du générateur. Les données sont importées à partir d'une feuille de calcul Google Sheets.
function doGet() { // This example creates two table charts side by side. One uses a data view // definition to restrict the number of displayed columns. // Get sample data from a spreadsheet. const dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1%3AF' + '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=4&headers=-1'; // Create a chart to display all of the data. const originalChart = Charts.newTableChart() .setDimensions(600, 500) .setDataSourceUrl(dataSourceUrl) .build(); // Create another chart to display a subset of the data (only columns 1 and // 4). const dataViewDefinition = Charts.newDataViewDefinition().setColumns([0, 3]); const limitedChart = Charts.newTableChart() .setDimensions(200, 500) .setDataSourceUrl(dataSourceUrl) .setDataViewDefinition(dataViewDefinition) .build(); const htmlOutput = HtmlService.createHtmlOutput(); const originalChartData = Utilities.base64Encode( originalChart.getAs('image/png').getBytes(), ); const originalChartUrl = `data:image/png;base64,${encodeURI(originalChartData)}`; const limitedChartData = Utilities.base64Encode( limitedChart.getAs('image/png').getBytes(), ); const limitedChartUrl = `data:image/png;base64,${encodeURI(limitedChartData)}`; htmlOutput.append('<table><tr><td>'); htmlOutput.append(`<img border="1" src="${originalChartUrl}">`); htmlOutput.append('</td><td>'); htmlOutput.append(`<img border="1" src="${limitedChartUrl}">`); htmlOutput.append('</td></tr></table>'); return htmlOutput; }
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
build() | Data | Crée et renvoie l'objet de définition de la vue de données créé à l'aide de ce compilateur. |
set | Data | Définit les indices des colonnes à inclure dans la vue des données, ainsi que les informations sur les colonnes de rôle. |
Documentation détaillée
build()
Crée et renvoie l'objet de définition de la vue de données créé à l'aide de ce compilateur.
Renvois
Data
: objet de définition de la vue de données créé à l'aide de cet outil de création.
set Columns(columns)
Définit les indices des colonnes à inclure dans la vue des données, ainsi que les informations sur les colonnes de rôle. Ce sous-ensemble d'indices de colonne fait référence aux colonnes de la source de données à partir de laquelle la vue de données est dérivée.
Un rôle de colonne décrit l'objectif des données de cette colonne: par exemple, une colonne peut contenir des données décrivant le texte d'une info-bulle, des annotations de points de données ou des indicateurs d'incertitude. Pour en savoir plus, consultez la section Rôles de table
Supposons que la feuille de calcul contienne les données suivantes dans les cellules A1 à C3 :
'abc', 20, 'blue'; 'def', 30, 'red'; 'ghi', 40, 'orange';
const COLUMN_SPEC = [ 0, // categories 1, // counts {sourceColumn: 2, role: 'style'}, ]; function roleColumnChart() { const spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); const sheet = spreadsheet.getActiveSheet(); const viewSpec = Charts.newDataViewDefinition().setColumns(COLUMN_SPEC).build(); const chartBuilder = sheet.newChart() .setChartType(Charts.ChartType.BAR) .setDataViewDefinition(viewSpec) .setOption('useFirstColumnAsDomain', true) .setPosition(5, 1, 0, 0) .setOption('hAxis', {title: 'Counts'}) .setOption('vAxis', {title: 'Categories'}) .addRange(sheet.getRange('A1:C3')); sheet.insertChart(chartBuilder.build()); }
Paramètres
Nom | Type | Description |
---|---|---|
columns | Object[] | Tableau d'indices de colonne ou de descriptions de colonne (un objet) à inclure dans la vue des données. Les descriptions de colonne définissent un rôle de colonne. La table de données et l'énumération des colonnes de la vue des données sont basées sur zéro. |
Renvois
Data
: ce compilateur est utile pour le chaînage.