github-mirrors/kibana
1
0
Fork 0
mirror of https://github.com/elastic/kibana.git synced 2025-04-23 09:19:04 -04:00
Code Issues Projects Releases Packages Wiki Activity

[7.x] [Canvas][Docs] Merge Canvas function references (#38300) (#40917)

Browse source 
* [Canvas][Docs] Merge Canvas function references (#38300)

* Synced up docs with function defs

* Updated docs with changes from PR #37305

* Merged canvas function ref into a single doc

* Fixed arg order

* Fixed typo

* Added alphabet links

* Added alphabet headers

* Removed B header

* Added missing args from

* Added edits from PR #37614

* Updated containerStyle

* Removed metafields. ESSQL doesn't support retrieving metafields

* Edits to function copy

* More edits

* More edits

* Final round of edits

* Fixed i18n errors

* Addressing feedback

* Fixed jest test

* Fixed missing import

* Fixed i18n error

* Restored metaFields arg in esdocs

* Extracted i18n string constants

* Fixed i18n errors

* Updated translation files

* Fixes Canvas doc headers (#40921)
This commit is contained in:
Catherine Liu 2019-07-11 17:14:05 -07:00 • committed by GitHub
parent cb0e472cd1
commit 5287d1ef5b
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
100 changed files with 3213 additions and 2642 deletions
Download patch file Download diff file Expand all files Collapse all files

6
docs/canvas.asciidoc
View file

@ -34,10 +34,4 @@ include::canvas/canvas-workpad.asciidoc[]
include::canvas/canvas-function-reference.asciidoc[]
include::canvas/canvas-common-functions.asciidoc[]
include::canvas/canvas-server-functions.asciidoc[]
include::canvas/canvas-client-functions.asciidoc[]
include::canvas/canvas-tinymath-functions.asciidoc[]

79
docs/canvas/canvas-client-functions.asciidoc
View file

@ -1,79 +0,0 @@
[role="xpack"]
[[canvas-client-functions]]
=== Canvas client functions
These functions must execute in a browser. They are only available
from within the Canvas application, not via the Canvas HTTP API. These functions must
execute in the browser because they use browser specific APIs, such as location,
or interact with the workpad to read filters.
A *** denotes a required argument.
[float]
=== asset
Uses Canvas workpad asset objects to provide argument values. Usually images.
*Accepts:* null
[cols="3*^<"]
|===
|Argument |Type |Description
|_Unnamed_*
|string
|The ID of the asset value to return
|===
*Returns:* string
[float]
=== browser
Forces the interpreter to return to the browser.
*Accepts:* Anything or nothing
*Returns:* Depends on your input and arguments
[float]
=== filters
Collects element filters on the workpad, usually to provide them to a data source.
*Accepts:* null
*Returns:* filter
[float]
=== location
Uses the browser's location functionality to get your current location. Usually
quite slow, but fairly accurate.
*Accepts:* null
*Returns:* datatable
[float]
=== urlparam
Accesses URL parameters and use them in expressions. This will always return a string.
*Accepts:* null
[cols="3*^<"]
|===
|Argument |Type |Description
|_Unnamed_* (Aliases: `var`, `variable`)
|string
|The URL hash parameter to access
|default
|string
|Return this string if the url parameter is not defined (default: `""`)
|===
*Returns:* string

1421
docs/canvas/canvas-common-functions.asciidoc
View file

File diff suppressed because one or more lines are too long

2185
docs/canvas/canvas-function-reference.asciidoc
View file

File diff suppressed because one or more lines are too long

199
docs/canvas/canvas-server-functions.asciidoc
View file

@ -1,199 +0,0 @@
[role="xpack"]
[[canvas-server-functions]]
=== Canvas server functions
These functions can only execute on the server. This may be for performance
or security reasons, or because the function uses an API only available on the
{kib} server. If the expression is executing in the browser, it will transfer to
the server when it hits one of these functions.
A *** denotes a required argument.
[float]
=== demodata
A mock data set that includes project CI times with usernames, countries, and run phases.
*Accepts:* filter
[cols="3*^<"]
|===
|Argument |Type |Description
|_Unnamed_ (Alias: `type`)
|string
|The name of the demo data set to use (default: `ci`)
|===
*Returns:* datatable
[float]
=== esdocs
Queries {es} and gets back raw documents. Specify the fields you want to receive,
especially if you are asking for a lot of rows.
*Accepts:* filter
[cols="3*^<"]
|===
|Argument |Type |Description
|index
|string
|Specify an index pattern, for example, "logstash-*" (default is `_all`)
|_Unnamed_ (Aliases: `query`, `q`)
|string
|A Lucene query string (default: `_index:.kibana`)
|sort
|string
|Sort directions as "field, direction", for example, "@timestamp, desc" or "bytes, asc"
|fields
|string
|Comma separated list of fields. Fewer fields will perform better
|metaFields
|string
|Comma separated list of meta fields, for example, "_index,_type"
|count
|number
|The number of docs to pull back. Smaller numbers perform better (default: `100`)
|===
*Returns:* datatable
[float]
=== escount
Queries {es} for a count of the number of hits matching a query.
*Accepts:* filter
[cols="3*^<"]
|===
|Argument |Type |Description
|index
|string
|Specify an index pattern, for example, "logstash-*" (default: `all`)
|_Unnamed_ (Alias: `query`, `q`)
|string
|A Lucene query string (default: `"-_index:.kibana"`)
|===
*Returns:* number
[float]
=== essql
Specifies an {es} SQL.
*Accepts:* filter
[cols="3*^<"]
|===
|Argument |Type |Description
|_Unnamed_* (Alias: `query`, `q`)
|string
|An SQL query
|count
|number
|The default is `1000`
|===
*Returns:* datatable
[float]
=== pointseries
Turns a datatable into a point series model. Currently Canvas differentiates measure
from dimensions by looking for a <<canvas-tinymath-functions, Tiny Math function>>. If you enter a TinyMath
expression in your argument, Canvas treats that argument as a measure. Otherwise, it
is a dimension. Dimensions are combined to create unique keys. Measures are
then deduplicated by those keys using the specified TinyMath function.
*Accepts:* datatable
[cols="3*^<"]
|===
|Argument |Type |Description
|x
|string
|The values along the X-axis
|y
|string
|The values along the Y-axis
|color
|string
|An expression to use in determining the mark's color
|size
|string
|For elements that support it, the size of the marks
|text
|string
|For use in charts that support it, the text to show in the mark
|===
*Returns:* pointseries
[float]
=== server
Forces the interpreter to return to the server.
*Accepts:* Anything or nothing
*Returns:* Depends on your input and arguments
&nbsp;
[float]
=== timelion
Uses Timelion to extract one or more time series from many sources.
*Accepts:* filter
[cols="3*^<"]
|===
|Argument |Type |Description
|_Unnamed_ (Aliases: `query`, `q`)
|string
|A Timelion query (default: `".es(*)"`)
|interval
|string
|Bucket interval for the time series (default: `auto`)
|from
|any
|{es} date math string for the start of the time range (default: `now-1y`)
|to
|any
|{es} date math string for the end of the time range (default: `now`)
|timezone
|any
|Time zone for the time range (default: `UTC`)
|===
*Returns:* datatable

28
src/legacy/core_plugins/interpreter/public/functions/font.ts
View file

@ -49,7 +49,7 @@ export function font(): ExpressionFunction<'font', null, Arguments, Style> {
aliases: [],
type: 'style',
help: i18n.translate('interpreter.functions.fontHelpText', {
defaultMessage: 'Create a font style',
defaultMessage: 'Create a font style.',
}),
context: {
types: ['null'],
@ -58,14 +58,14 @@ export function font(): ExpressionFunction<'font', null, Arguments, Style> {
align: {
default: 'left',
help: i18n.translate('interpreter.functions.font.args.alignHelpText', {
defaultMessage: 'Horizontal text alignment',
defaultMessage: 'The horizontal text alignment.',
}),
options: Object.values(TextAlignment),
types: ['string'],
},
color: {
help: i18n.translate('interpreter.functions.font.args.colorHelpText', {
defaultMessage: 'Text color',
defaultMessage: 'The text color.',
}),
types: ['string'],
},
@ -82,7 +82,7 @@ export function font(): ExpressionFunction<'font', null, Arguments, Style> {
italic: {
default: false,
help: i18n.translate('interpreter.functions.font.args.italicHelpText', {
defaultMessage: 'Italicize, true or false',
defaultMessage: 'Italicize the text?',
}),
options: [true, false],
types: ['boolean'],
@ -90,27 +90,21 @@ export function font(): ExpressionFunction<'font', null, Arguments, Style> {
lHeight: {
aliases: ['lineHeight'],
help: i18n.translate('interpreter.functions.font.args.lHeightHelpText', {
defaultMessage: 'Line height ({px})',
values: {
px: 'px',
},
defaultMessage: 'The line height in pixels',
}),
types: ['number', 'null'],
},
size: {
default: 14,
help: i18n.translate('interpreter.functions.font.args.sizeHelpText', {
defaultMessage: 'Font size ({px})',
values: {
px: 'px',
},
defaultMessage: 'The font size in pixels',
}),
types: ['number'],
},
underline: {
default: false,
help: i18n.translate('interpreter.functions.font.args.underlineHelpText', {
defaultMessage: 'Underline the text, true or false',
defaultMessage: 'Underline the text?',
}),
options: [true, false],
types: ['boolean'],
@ -118,9 +112,13 @@ export function font(): ExpressionFunction<'font', null, Arguments, Style> {
weight: {
default: 'normal',
help: i18n.translate('interpreter.functions.font.args.weightHelpText', {
defaultMessage: 'Set the font weight, e.g. {examples}',
defaultMessage: 'The font weight. For example, {list}, or {end}.',
values: {
examples: Object.values(FontWeight).join(', '),
list: Object.values(FontWeight)
.slice(0, -1)
.map(weight => `\`"${weight}"\``)
.join(', '),
end: `\`"${Object.values(FontWeight).slice(-1)[0]}"\``,
},
}),
options: Object.values(FontWeight),

8
x-pack/legacy/plugins/canvas/canvas_plugin_src/functions/common/alterColumn.ts
View file

@ -33,15 +33,15 @@ export function alterColumn(): ExpressionFunction<'alterColumn', Datatable, Argu
required: true,
help: argHelp.column,
},
name: {
types: ['string'],
help: argHelp.name,
},
type: {
types: ['string'],
help: argHelp.type,
options: ['null', 'boolean', 'number', 'string', 'date'],
},
name: {
types: ['string'],
help: argHelp.name,
},
},
fn: (context, args) => {
if (!args.column || (!args.type && !args.name)) {

24
x-pack/legacy/plugins/canvas/canvas_plugin_src/functions/common/axisConfig.ts
View file

@ -29,15 +29,18 @@ export function axisConfig(): ExpressionFunction<'axisConfig', null, Arguments,
name: 'axisConfig',
aliases: [],
type: 'axisConfig',
help,
context: {
types: ['null'],
},
help,
args: {
show: {
types: ['boolean'],
help: argHelp.show,
default: true,
max: {
types: ['number', 'string', 'null'],
help: argHelp.max,
},
min: {
types: ['number', 'string', 'null'],
help: argHelp.min,
},
position: {
types: ['string'],
@ -45,13 +48,10 @@ export function axisConfig(): ExpressionFunction<'axisConfig', null, Arguments,
options: Object.values(Position),
default: 'left',
},
min: {
types: ['number', 'string', 'null'],
help: argHelp.min,
},
max: {
types: ['number', 'string', 'null'],
help: argHelp.max,
show: {
types: ['boolean'],
help: argHelp.show,
default: true,
},
tickSize: {
types: ['number', 'null'],

1
x-pack/legacy/plugins/canvas/canvas_plugin_src/functions/common/columns.ts
View file

@ -26,6 +26,7 @@ export function columns(): ExpressionFunction<'columns', Datatable, Arguments, D
},
args: {
include: {
aliases: ['_'],
types: ['string'],
help: argHelp.include,
},

36
x-pack/legacy/plugins/canvas/canvas_plugin_src/functions/common/containerStyle.ts
View file

@ -25,24 +25,12 @@ export function containerStyle(): ExpressionFunction<
return {
name: 'containerStyle',
aliases: [],
type: 'containerStyle',
help,
context: {
types: ['null'],
},
type: 'containerStyle',
help,
args: {
border: {
types: ['string'],
help: argHelp.border,
},
borderRadius: {
types: ['string'],
help: argHelp.borderRadius,
},
padding: {
types: ['string'],
help: argHelp.padding,
},
backgroundColor: {
types: ['string'],
help: argHelp.backgroundColor,
@ -51,17 +39,25 @@ export function containerStyle(): ExpressionFunction<
types: ['string'],
help: argHelp.backgroundImage,
},
backgroundRepeat: {
types: ['string'],
help: argHelp.backgroundRepeat,
default: 'no-repeat',
options: Object.values(BackgroundRepeat),
},
backgroundSize: {
types: ['string'],
help: argHelp.backgroundSize,
default: 'contain',
options: Object.values(BackgroundSize),
},
backgroundRepeat: {
border: {
types: ['string'],
help: argHelp.backgroundRepeat,
default: 'no-repeat',
options: Object.values(BackgroundRepeat),
help: argHelp.border,
},
borderRadius: {
types: ['string'],
help: argHelp.borderRadius,
},
opacity: {
types: ['number'],
@ -73,6 +69,10 @@ export function containerStyle(): ExpressionFunction<
options: Object.values(Overflow),
default: 'hidden',
},
padding: {
types: ['string'],
help: argHelp.padding,
},
},
fn: (_context, args) => {
const { backgroundImage, backgroundSize, backgroundRepeat, ...remainingArgs } = args;

2
x-pack/legacy/plugins/canvas/canvas_plugin_src/functions/common/date.ts
View file

@ -20,10 +20,10 @@ export function date(): ExpressionFunction<'date', null, Arguments, number> {
return {
name: 'date',
type: 'number',
help,
context: {
types: ['null'],
},
help,
args: {
value: {
aliases: ['_'],

2
x-pack/legacy/plugins/canvas/canvas_plugin_src/functions/common/exactly.ts
View file

@ -20,10 +20,10 @@ export function exactly(): ExpressionFunction<'exactly', Filter, Arguments, Filt
name: 'exactly',
aliases: [],
type: 'filter',
help,
context: {
types: ['filter'],
},
help,
args: {
column: {
types: ['string'],

2
x-pack/legacy/plugins/canvas/canvas_plugin_src/functions/common/filterrows.ts
View file

@ -23,10 +23,10 @@ export function filterrows(): ExpressionFunction<
name: 'filterrows',
aliases: [],
type: 'datatable',
help,
context: {
types: ['datatable'],
},
help,
args: {
fn: {
resolve: false,

8
x-pack/legacy/plugins/canvas/canvas_plugin_src/functions/common/__tests__/join_rows.test.js → x-pack/legacy/plugins/canvas/canvas_plugin_src/functions/common/join_rows.test.js
View file

@ -4,10 +4,10 @@
* you may not use this file except in compliance with the Elastic License.
*/
import { joinRows } from '../join_rows';
import { functionWrapper } from '../../../../__tests__/helpers/function_wrapper';
import { getFunctionErrors } from '../../../strings/functions';
import { testTable } from './fixtures/test_tables';
import { functionWrapper } from '../../../__tests__/helpers/function_wrapper';
import { getFunctionErrors } from '../../strings';
import { testTable } from './__tests__/fixtures/test_tables';
import { joinRows } from './join_rows';
const errors = getFunctionErrors().joinRows;

20
x-pack/legacy/plugins/canvas/canvas_plugin_src/functions/common/join_rows.ts
View file

@ -40,21 +40,21 @@ export function joinRows(): ExpressionFunction<'joinRows', Datatable, Arguments,
required: true,
help: argHelp.column,
},
separator: {
aliases: ['sep'],
types: ['string'],
default: ',',
help: argHelp.separator,
distinct: {
types: ['boolean'],
help: argHelp.distinct,
default: true,
},
quote: {
types: ['string'],
default: `"'"`,
help: argHelp.quote,
default: `"'"`,
},
distinct: {
types: ['boolean'],
default: true,
help: argHelp.distinct,
separator: {
aliases: ['sep', 'delimiter'],
types: ['string'],
help: argHelp.separator,
default: ',',
},
},
fn: (context, { column, separator, quote, distinct }) => {

1
x-pack/legacy/plugins/canvas/canvas_plugin_src/functions/common/lt.ts
View file

@ -37,7 +37,6 @@ export function lt(): ExpressionFunction<'lt', Context, Arguments, boolean> {
return false;
}
// @ts-ignore #35433 This is a wonky comparison for nulls
return context < value;
},
};

1
x-pack/legacy/plugins/canvas/canvas_plugin_src/functions/common/lte.ts
View file

@ -37,7 +37,6 @@ export function lte(): ExpressionFunction<'lte', Context, Arguments, boolean> {
return false;
}
// @ts-ignore #35433 This is a wonky comparison for nulls
return context <= value;
},
};

47
x-pack/legacy/plugins/canvas/canvas_plugin_src/functions/common/pie.ts
View file

@ -82,41 +82,25 @@ export function pie(): ExpressionFunction<'pie', PointSeries, Arguments, Render<
types: ['pointseries'],
},
args: {
palette: {
types: ['palette'],
help: argHelp.palette,
default: '{palette}',
},
seriesStyle: {
multi: true,
types: ['seriesStyle'],
help: argHelp.seriesStyle,
},
radius: {
types: ['string', 'number'],
help: argHelp.radius,
default: 'auto',
font: {
types: ['style'],
help: argHelp.font,
default: '{font}',
},
hole: {
types: ['number'],
default: 0,
help: argHelp.hole,
},
labels: {
types: ['boolean'],
default: true,
help: argHelp.labels,
options: [true, false],
},
labelRadius: {
types: ['number'],
default: 100,
help: argHelp.labelRadius,
},
font: {
types: ['style'],
help: argHelp.font,
default: '{font}',
labels: {
types: ['boolean'],
default: true,
help: argHelp.labels,
},
legend: {
types: ['string', 'boolean'],
@ -124,6 +108,21 @@ export function pie(): ExpressionFunction<'pie', PointSeries, Arguments, Render<
default: false,
options: Object.values(Legend).concat(false),
},
palette: {
types: ['palette'],
help: argHelp.palette,
default: '{palette}',
},
radius: {
types: ['string', 'number'],
help: argHelp.radius,
default: 'auto',
},
seriesStyle: {
multi: true,
types: ['seriesStyle'],
help: argHelp.seriesStyle,
},
tilt: {
types: ['number'],
default: 1,

28
x-pack/legacy/plugins/canvas/canvas_plugin_src/functions/common/plot/index.ts
View file

@ -41,22 +41,12 @@ export function plot(): ExpressionFunction<'plot', PointSeries, Arguments, Rende
types: ['pointseries'],
},
args: {
seriesStyle: {
multi: true,
types: ['seriesStyle'],
help: argHelp.seriesStyle,
},
defaultStyle: {
multi: false,
types: ['seriesStyle'],
help: argHelp.defaultStyle,
default: '{seriesStyle points=5}',
},
palette: {
types: ['palette'],
help: argHelp.palette,
default: '{palette}',
},
font: {
types: ['style'],
help: argHelp.font,
@ -68,16 +58,26 @@ export function plot(): ExpressionFunction<'plot', PointSeries, Arguments, Rende
default: 'ne',
options: Object.values(Legend).concat(false),
},
yaxis: {
types: ['boolean', 'axisConfig'],
help: argHelp.yaxis,
default: true,
palette: {
types: ['palette'],
help: argHelp.palette,
default: '{palette}',
},
seriesStyle: {
multi: true,
types: ['seriesStyle'],
help: argHelp.seriesStyle,
},
xaxis: {
types: ['boolean', 'axisConfig'],
help: argHelp.xaxis,
default: true,
},
yaxis: {
types: ['boolean', 'axisConfig'],
help: argHelp.yaxis,
default: true,
},
},
fn: (context, args) => {
const seriesStyles: { [key: string]: SeriesStyle } =

2
x-pack/legacy/plugins/canvas/canvas_plugin_src/functions/common/ply.ts
View file

@ -40,8 +40,6 @@ export function ply(): ExpressionFunction<'ply', Datatable, Arguments, Return> {
aliases: ['exp', 'fn', 'function'],
help: argHelp.expression,
},
// In the future it may make sense to add things like shape, or tooltip values, but I think what we have is good for now
// The way the function below is written you can add as many arbitrary named args as you want.
},
fn: (context, args) => {
if (!args) {

60
x-pack/legacy/plugins/canvas/canvas_plugin_src/functions/common/progress.ts
View file

@ -45,47 +45,47 @@ export function progress(): ExpressionFunction<'progress', number, Arguments, Re
types: ['number'],
},
args: {
barColor: {
default: `#f0f0f0`,
help: argHelp.barColor,
types: ['string'],
},
barWeight: {
default: 20,
help: argHelp.barWeight,
types: ['number'],
},
font: {
default: `{font size=24 family="${openSans.value}" color="#000000" align=center}`,
help: argHelp.font,
types: ['style'],
},
label: {
default: true,
help: argHelp.label,
types: ['boolean', 'string'],
},
max: {
default: 1,
help: argHelp.max,
types: ['number'],
},
shape: {
aliases: ['_'],
default: 'gauge',
types: ['string'],
help: argHelp.shape,
options: Object.values(Shape),
default: 'gauge',
},
barColor: {
types: ['string'],
help: argHelp.barColor,
default: `#f0f0f0`,
},
barWeight: {
types: ['number'],
help: argHelp.barWeight,
default: 20,
},
font: {
types: ['style'],
help: argHelp.font,
default: `{font size=24 family="${openSans.value}" color="#000000" align=center}`,
},
label: {
types: ['boolean', 'string'],
help: argHelp.label,
default: true,
},
max: {
types: ['number'],
help: argHelp.max,
default: 1,
},
valueColor: {
default: `#1785b0`,
help: argHelp.valueColor,
types: ['string'],
help: argHelp.valueColor,
default: `#1785b0`,
},
valueWeight: {
default: 20,
help: argHelp.valueWeight,
types: ['number'],
help: argHelp.valueWeight,
default: 20,
},
},
fn: (value, args) => {

18
x-pack/legacy/plugins/canvas/canvas_plugin_src/functions/common/repeatImage.ts
View file

@ -36,25 +36,25 @@ export function repeatImage(): ExpressionFunction<
types: ['number'],
},
args: {
emptyImage: {
types: ['string', 'null'],
help: argHelp.emptyImage,
default: null,
},
image: {
types: ['string', 'null'],
help: argHelp.image,
default: elasticOutline,
},
size: {
types: ['number'],
default: 100,
help: argHelp.size,
},
max: {
types: ['number'],
help: argHelp.max,
default: 1000,
},
emptyImage: {
types: ['string', 'null'],
help: argHelp.emptyImage,
default: null,
size: {
types: ['number'],
default: 100,
help: argHelp.size,
},
},
fn: (count, args) => {

14
x-pack/legacy/plugins/canvas/canvas_plugin_src/functions/common/shape.ts
View file

@ -49,6 +49,13 @@ export function shape(): ExpressionFunction<'shape', null, Arguments, Return> {
types: ['null'],
},
args: {
shape: {
types: ['string'],
help: argHelp.shape,
aliases: ['_'],
default: 'square',
options: Object.values(Shape),
},
border: {
types: ['string'],
aliases: ['stroke'],
@ -60,13 +67,6 @@ export function shape(): ExpressionFunction<'shape', null, Arguments, Return> {
help: argHelp.borderWidth,
default: 0,
},
shape: {
types: ['string'],
help: argHelp.shape,
aliases: ['_'],
default: 'square',
options: Object.values(Shape),
},
fill: {
types: ['string'],
help: argHelp.fill,

4
x-pack/legacy/plugins/canvas/canvas_plugin_src/functions/common/string.ts
View file

@ -7,7 +7,7 @@ import { ExpressionFunction } from 'src/legacy/core_plugins/interpreter/public';
import { getFunctionHelp } from '../../strings';
interface Arguments {
value: string[];
value: Array<string | number | boolean>;
}
export function string(): ExpressionFunction<'string', null, Arguments, string> {
@ -24,7 +24,7 @@ export function string(): ExpressionFunction<'string', null, Arguments, string>
args: {
value: {
aliases: ['_'],
types: ['string'],
types: ['string', 'number', 'boolean'],
multi: true,
help: argHelp.value,
},

2
x-pack/legacy/plugins/canvas/canvas_plugin_src/functions/common/timefilter.ts
View file

@ -47,7 +47,7 @@ export function timefilter(): ExpressionFunction<'timefilter', Filter, Arguments
},
filterGroup: {
types: ['string'],
help: 'Group name for the filter',
help: 'The group name for the filter',
},
},
fn: (context, args) => {

2
x-pack/legacy/plugins/canvas/canvas_plugin_src/functions/server/demodata/index.ts
View file

@ -6,7 +6,7 @@
import { sortBy } from 'lodash';
import { ExpressionFunction } from 'src/legacy/core_plugins/interpreter/public';
// @ts-ignore
// @ts-ignore unconverted lib file
import { queryDatatable } from '../../../../common/lib/datatable/query';
import { DemoRows, getDemoRows } from './get_demo_rows';
import { Filter, Datatable, DatatableColumn, DatatableRow } from '../../../../types';

10
x-pack/legacy/plugins/canvas/canvas_plugin_src/functions/server/escount.ts
View file

@ -26,17 +26,17 @@ export function escount(): ExpressionFunction<'escount', Filter, Arguments, any>
types: ['filter'],
},
args: {
index: {
types: ['string'],
default: '_all',
help: argHelp.index,
},
query: {
types: ['string'],
aliases: ['_', 'q'],
help: argHelp.query,
default: '"-_index:.kibana"',
},
index: {
types: ['string'],
default: '_all',
help: argHelp.index,
},
},
fn: (context, args, handlers) => {
context.and = context.and.concat([

26
x-pack/legacy/plugins/canvas/canvas_plugin_src/functions/server/esdocs.ts
View file

@ -31,33 +31,35 @@ export function esdocs(): ExpressionFunction<'esdocs', Filter, Arguments, any> {
types: ['filter'],
},
args: {
index: {
types: ['string'],
default: '_all',
help: argHelp.index,
},
query: {
types: ['string'],
aliases: ['_', 'q'],
help: argHelp.query,
default: '-_index:.kibana',
},
sort: {
types: ['string'],
help: argHelp.sort,
count: {
types: ['number'],
default: 100,
help: argHelp.count,
},
fields: {
help: argHelp.fields,
types: ['string'],
},
index: {
types: ['string'],
default: '_all',
help: argHelp.index,
},
// TODO: This arg isn't being used in the function.
// We need to restore this functionality or remove it as an arg.
metaFields: {
help: argHelp.metaFields,
types: ['string'],
},
count: {
types: ['number'],
default: 100,
help: argHelp.count,
sort: {
types: ['string'],
help: argHelp.sort,
},
},
fn: (context, args, handlers) => {

2
x-pack/legacy/plugins/canvas/canvas_plugin_src/functions/server/essql.ts
View file

@ -22,10 +22,10 @@ export function essql(): ExpressionFunction<'essql', Filter, Arguments, any> {
return {
name: 'essql',
type: 'datatable',
help,
context: {
types: ['filter'],
},
help,
args: {
query: {
aliases: ['_', 'q'],

16
x-pack/legacy/plugins/canvas/canvas_plugin_src/functions/server/pointseries/index.ts
View file

@ -55,14 +55,6 @@ export function pointseries(): ExpressionFunction<
types: ['datatable'],
},
args: {
x: {
types: ['string'],
help: argHelp.x,
},
y: {
types: ['string'],
help: argHelp.y,
},
color: {
types: ['string'],
help: argHelp.color, // If you need categorization, transform the field.
@ -75,6 +67,14 @@ export function pointseries(): ExpressionFunction<
types: ['string'],
help: argHelp.text,
},
x: {
types: ['string'],
help: argHelp.x,
},
y: {
types: ['string'],
help: argHelp.y,
},
// In the future it may make sense to add things like shape, or tooltip values, but I think what we have is good for now
// The way the function below is written you can add as many arbitrary named args as you want.
},

35
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/constants.ts Normal file
View file

@ -0,0 +1,35 @@
/*
* Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
* or more contributor license agreements. Licensed under the Elastic License;
* you may not use this file except in compliance with the Elastic License.
*/
export const BASE64 = '`base64`';
export const BOOLEAN_FALSE = '`false`';
export const BOOLEAN_TRUE = '`true`';
export const CANVAS = 'Canvas';
export const CONTEXT = '_context_';
export const CSS = 'CSS';
export const CSV = 'CSV';
export const DATEMATH = '`datemath`';
export const DATATABLE = '`datatable`';
export const ELASTICSEARCH = 'Elasticsearch';
export const FONT_FAMILY = '`font-family`';
export const FONT_WEIGHT = '`font-weight`';
export const ISO8601 = 'ISO8601';
export const JS = 'JavaScript';
export const LUCENE = 'Lucene';
export const MARKDOWN = 'Markdown';
export const MOMENTJS = 'MomentJS';
export const NUMERALJS = 'NumeralJS';
export const SQL = 'SQL';
export const SVG = 'SVG';
export const TINYMATH = '`TinyMath`';
export const TINYMATH_URL =
'https://www.elastic.co/guide/en/kibana/current/canvas-tinymath-functions.html';
export const TYPE_BOOLEAN = '`boolean`';
export const TYPE_NULL = '`null`';
export const TYPE_NUMBER = '`number`';
export const TYPE_STRING = '`string`';
export const URL = 'URL';
export const UTC = 'UTC';

9
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/all.ts
View file

@ -8,14 +8,19 @@ import { i18n } from '@kbn/i18n';
import { all } from '../../functions/common/all';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { BOOLEAN_TRUE } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof all>> = {
help: i18n.translate('xpack.canvas.functions.allHelpText', {
defaultMessage: 'Return true if all of the conditions are true',
defaultMessage: 'Returns {BOOLEAN_TRUE} if all of the conditions are met. See also {anyFn}.',
values: {
anyFn: '`any`',
BOOLEAN_TRUE,
},
}),
args: {
condition: i18n.translate('xpack.canvas.functions.all.args.conditionHelpText', {
defaultMessage: 'One or more conditions to check',
defaultMessage: 'The conditions to check.',
}),
},
};

19
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/alterColumn.ts
View file

@ -8,23 +8,32 @@ import { i18n } from '@kbn/i18n';
import { alterColumn } from '../../functions/common/alterColumn';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { DATATABLE_COLUMN_TYPES } from '../../../common/lib';
export const help: FunctionHelp<FunctionFactory<typeof alterColumn>> = {
help: i18n.translate('xpack.canvas.functions.alterColumnHelpText', {
defaultMessage: 'Converts between core types (eg {examples}) and rename columns',
defaultMessage:
'Converts between core types, including {list}, and {end}, and rename columns. ' +
'See also {mapColumnFn} and {staticColumnFn}.',
values: {
examples: ['string', 'number', 'null', 'boolean', 'date'].join(','),
list: Object.values(DATATABLE_COLUMN_TYPES)
.slice(0, -1)
.map(type => `\`${type}\``)
.join(', '),
end: Object.values(DATATABLE_COLUMN_TYPES).slice(-1)[0],
mapColumnFn: '`mapColumn`',
staticColumnFn: '`staticColumn`',
},
}),
args: {
column: i18n.translate('xpack.canvas.functions.alterColumn.args.columnHelpText', {
defaultMessage: 'The name of the column to alter',
defaultMessage: 'The name of the column to alter.',
}),
name: i18n.translate('xpack.canvas.functions.alterColumn.args.nameHelpText', {
defaultMessage: 'The resultant column name. Leave blank to not rename',
defaultMessage: 'The resultant column name. Leave blank to not rename.',
}),
type: i18n.translate('xpack.canvas.functions.alterColumn.args.typeHelpText', {
defaultMessage: 'The type to convert the column to. Leave blank to not change type',
defaultMessage: 'The type to convert the column to. Leave blank to not change type.',
}),
},
};

10
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/any.ts
View file

@ -8,14 +8,20 @@ import { i18n } from '@kbn/i18n';
import { any } from '../../functions/common/any';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { BOOLEAN_TRUE } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof any>> = {
help: i18n.translate('xpack.canvas.functions.anyHelpText', {
defaultMessage: 'Return true if any of the conditions are true',
defaultMessage:
'Returns {BOOLEAN_TRUE} if at least one of the conditions is met. See also {all_fn}.',
values: {
all_fn: '`all`',
BOOLEAN_TRUE,
},
}),
args: {
condition: i18n.translate('xpack.canvas.functions.any.args.conditionHelpText', {
defaultMessage: 'One or more conditions to check',
defaultMessage: 'The conditions to check.',
}),
},
};

9
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/as.ts
View file

@ -8,14 +8,19 @@ import { i18n } from '@kbn/i18n';
import { asFn } from '../../functions/common/as';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { DATATABLE } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof asFn>> = {
help: i18n.translate('xpack.canvas.functions.asHelpText', {
defaultMessage: 'One or more conditions to check',
defaultMessage: 'Creates a {DATATABLE} with a single value. See also {getCellFn}.',
values: {
DATATABLE,
getCellFn: '`getCell`',
},
}),
args: {
name: i18n.translate('xpack.canvas.functions.as.args.nameHelpText', {
defaultMessage: 'A name to give the column',
defaultMessage: 'A name to give the column.',
}),
},
};

26
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/axisConfig.ts
View file

@ -9,39 +9,45 @@ import { axisConfig } from '../../functions/common/axisConfig';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { Position } from '../../../types';
import { ISO8601 } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof axisConfig>> = {
help: i18n.translate('xpack.canvas.functions.axisConfigHelpText', {
defaultMessage: 'Configure axis of a visualization',
defaultMessage: 'Configures the axis of a visualization. Only used with {plotFn}.',
values: {
plotFn: '`plot`',
},
}),
args: {
max: i18n.translate('xpack.canvas.functions.axisConfig.args.maxHelpText', {
defaultMessage:
'Maximum value displayed in the axis. Must be a number or a date in {ms} or {iso} string',
'The maximum value displayed in the axis. Must be a number or a date in milliseconds since epoch or {ISO8601} string.',
values: {
ms: 'ms',
iso: 'ISO8601',
ISO8601,
},
}),
min: i18n.translate('xpack.canvas.functions.axisConfig.args.minHelpText', {
defaultMessage:
'Minimum value displayed in the axis. Must be a number or a date in {ms} or {iso} string',
'The minimum value displayed in the axis. Must be a number or a date in milliseconds since epoch or {ISO8601} string.',
values: {
ms: 'ms',
iso: 'ISO8601',
ISO8601,
},
}),
position: i18n.translate('xpack.canvas.functions.axisConfig.args.positionHelpText', {
defaultMessage: 'Position of the axis labels: {examples}',
defaultMessage: 'The position of the axis labels. For example, {list}, or {end}.',
values: {
examples: Object.values(Position).join(', '),
list: Object.values(Position)
.slice(0, -1)
.map(position => `\`"${position}"\``)
.join(', '),
end: Object.values(Position).slice(-1)[0],
},
}),
show: i18n.translate('xpack.canvas.functions.axisConfig.args.showHelpText', {
defaultMessage: 'Show the axis labels?',
}),
tickSize: i18n.translate('xpack.canvas.functions.axisConfig.args.tickSizeHelpText', {
defaultMessage: 'Increment size between each tick. Use for number axes only',
defaultMessage: 'The increment size between each tick. Use for `number` axes only',
}),
},
};

30
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/case.ts
View file

@ -8,28 +8,40 @@ import { i18n } from '@kbn/i18n';
import { caseFn } from '../../functions/common/case';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { CONTEXT } from '../constants';
const IF_ARG = '`if`';
const WHEN_ARG = '`when`';
export const help: FunctionHelp<FunctionFactory<typeof caseFn>> = {
help: i18n.translate('xpack.canvas.functions.caseHelpText', {
defaultMessage: 'Build a case (including a condition/result) to pass to the {switch} function',
defaultMessage:
'Builds a {case}, including a condition and a result, to pass to the {switchFn} function.',
values: {
switch: 'switch',
case: '`case`',
switchFn: '`switch`',
},
}),
args: {
if: i18n.translate('xpack.canvas.functions.case.args.ifHelpText', {
defaultMessage:
'This value is used as whether or not the condition is met. It overrides the unnamed argument if both are provided.',
}),
when: i18n.translate('xpack.canvas.functions.case.args.whenHelpText', {
defaultMessage:
'This value is compared to the context to see if the condition is met. It is overridden by the "{if}" argument if both are provided.',
'The value compared to the {CONTEXT} to see if they are equal. The {WHEN_ARG} argument is ignored when the {IF_ARG} argument is also specified.',
values: {
if: 'if',
CONTEXT,
IF_ARG,
WHEN_ARG,
},
}),
if: i18n.translate('xpack.canvas.functions.case.args.ifHelpText', {
defaultMessage:
'This value indicates whether the condition is met, usually using a sub-expression. The {IF_ARG} argument overrides the {WHEN_ARG} argument when both are provided.',
values: {
IF_ARG,
WHEN_ARG,
},
}),
then: i18n.translate('xpack.canvas.functions.case.args.thenHelpText', {
defaultMessage: 'The value to return if the condition is met',
defaultMessage: 'The value to return if the condition is met.',
}),
},
};

7
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/clear.ts
View file

@ -8,10 +8,15 @@ import { i18n } from '@kbn/i18n';
import { clear } from '../../functions/common/clear';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { CONTEXT, TYPE_NULL } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof clear>> = {
help: i18n.translate('xpack.canvas.functions.clearHelpText', {
defaultMessage: 'Clears context and returns null',
defaultMessage: 'Clears the {CONTEXT}, and returns {TYPE_NULL}.',
values: {
CONTEXT,
TYPE_NULL,
},
}),
args: {},
};

17
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/columns.ts
View file

@ -8,18 +8,29 @@ import { i18n } from '@kbn/i18n';
import { columns } from '../../functions/common/columns';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { DATATABLE } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof columns>> = {
help: i18n.translate('xpack.canvas.functions.columnsHelpText', {
defaultMessage:
'Include or exclude columns from a data table. If you specify both, this will exclude first',
'Includes or excludes columns from a {DATATABLE}. ' +
'When both arguments are specified, the excluded columns will be removed first.',
values: {
DATATABLE,
},
}),
args: {
include: i18n.translate('xpack.canvas.functions.columns.args.includeHelpText', {
defaultMessage: 'A comma separated list of column names to keep in the table',
defaultMessage: 'A comma-separated list of column names to keep in the {DATATABLE}.',
values: {
DATATABLE,
},
}),
exclude: i18n.translate('xpack.canvas.functions.columns.args.excludeHelpText', {
defaultMessage: 'A comma separated list of column names to remove from the table',
defaultMessage: 'A comma-separated list of column names to remove from the {DATATABLE}.',
values: {
DATATABLE,
},
}),
},
};

34
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/compare.ts
View file

@ -8,22 +8,41 @@ import { i18n } from '@kbn/i18n';
import { compare, Operation } from '../../functions/common/compare';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import {
CONTEXT,
TYPE_BOOLEAN,
TYPE_NUMBER,
TYPE_STRING,
BOOLEAN_TRUE,
BOOLEAN_FALSE,
TYPE_NULL,
} from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof compare>> = {
help: i18n.translate('xpack.canvas.functions.compareHelpText', {
defaultMessage:
'Compare the input to something else to determine true or false. Usually used in combination with `{if}`. ' +
'This only works with primitive types, such as {examples}.',
'Compares the {CONTEXT} to specified value to determine {BOOLEAN_TRUE} or {BOOLEAN_FALSE}. Usually used in combination with `{ifFn}` or `{caseFn}`. ' +
'This only works with primitive types, such as {examples}. See also `{eqFn}`, `{gtFn}`, `{gteFn}`, `{ltFn}`, `{lteFn}`, `{neqFn}`',
values: {
if: '{if}',
examples: ['number', 'string', 'boolean'].join(', '),
CONTEXT,
BOOLEAN_TRUE,
BOOLEAN_FALSE,
ifFn: 'if',
caseFn: 'case',
examples: [TYPE_NUMBER, TYPE_STRING, TYPE_BOOLEAN, TYPE_NULL].join(', '),
eqFn: 'eq',
gtFn: 'gt',
gteFn: 'gte',
ltFn: 'lt',
lteFn: 'lte',
neqFn: 'neq',
},
}),
args: {
op: i18n.translate('xpack.canvas.functions.compare.args.opHelpText', {
defaultMessage:
'The operator to use in the comparison: {eq} (equal to), {gt} (greater than), {gte} (greater than or equal to)' +
', {lt} (less than), {lte} (less than or equal to), {ne} or {neq} (not equal to)',
', {lt} (less than), {lte} (less than or equal to), {ne} or {neq} (not equal to).',
values: {
eq: Operation.EQ,
gt: Operation.GT,
@ -35,7 +54,10 @@ export const help: FunctionHelp<FunctionFactory<typeof compare>> = {
},
}),
to: i18n.translate('xpack.canvas.functions.compare.args.toHelpText', {
defaultMessage: 'The value to compare the context to, usually returned by a subexpression',
defaultMessage: 'The value compared to the {CONTEXT}.',
values: {
CONTEXT,
},
}),
},
};

71
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/containerStyle.ts
View file

@ -8,70 +8,73 @@ import { i18n } from '@kbn/i18n';
import { containerStyle } from '../../functions/common/containerStyle';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { CSS } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof containerStyle>> = {
help: i18n.translate('xpack.canvas.functions.containerStyleHelpText', {
defaultMessage:
'Creates an object used for describing the properties of a series on a chart. You would usually use this inside of a charting function',
defaultMessage: `Creates an object used for styling an element's container, including background, border, and opacity.`,
}),
args: {
border: i18n.translate('xpack.canvas.functions.containerStyle.args.borderHelpText', {
defaultMessage: 'Valid {css} border string',
values: {
css: 'CSS',
},
}),
borderRadius: i18n.translate(
'xpack.canvas.functions.containerStyle.args.borderRadiusHelpText',
{
defaultMessage: 'Number of pixels to use when rounding the border',
}
),
padding: i18n.translate('xpack.canvas.functions.containerStyle.args.paddingHelpText', {
defaultMessage: 'Content distance in pixels from border',
}),
backgroundColor: i18n.translate(
'xpack.canvas.functions.containerStyle.args.backgroundColorHelpText',
{
defaultMessage: 'Valid {css} background color string',
defaultMessage: 'A valid {CSS} background color.',
values: {
css: 'CSS',
CSS,
},
}
),
backgroundImage: i18n.translate(
'xpack.canvas.functions.containerStyle.args.backgroundImageHelpText',
{
defaultMessage: 'Valid {css} background image string',
defaultMessage: 'A valid {CSS} background image.',
values: {
css: 'CSS',
},
}
),
backgroundSize: i18n.translate(
'xpack.canvas.functions.containerStyle.args.backgroundSizeHelpText',
{
defaultMessage: 'Valid {css} background size string',
values: {
css: 'CSS',
CSS,
},
}
),
backgroundRepeat: i18n.translate(
'xpack.canvas.functions.containerStyle.args.backgroundRepeatHelpText',
{
defaultMessage: 'Valid {css} background repeat string',
defaultMessage: 'A valid {CSS} background repeat.',
values: {
css: 'CSS',
CSS,
},
}
),
backgroundSize: i18n.translate(
'xpack.canvas.functions.containerStyle.args.backgroundSizeHelpText',
{
defaultMessage: 'A valid {CSS} background size.',
values: {
CSS,
},
}
),
border: i18n.translate('xpack.canvas.functions.containerStyle.args.borderHelpText', {
defaultMessage: 'A valid {CSS} border.',
values: {
CSS,
},
}),
borderRadius: i18n.translate(
'xpack.canvas.functions.containerStyle.args.borderRadiusHelpText',
{
defaultMessage: 'The number of pixels to use when rounding the corners.',
}
),
opacity: i18n.translate('xpack.canvas.functions.containerStyle.args.opacityHelpText', {
defaultMessage:
'A number between 0 and 1 representing the degree of transparency of the element',
'A number between 0 and 1 that represents the degree of transparency of the element.',
}),
overflow: i18n.translate('xpack.canvas.functions.containerStyle.args.overflowHelpText', {
defaultMessage: 'Sets overflow of the container',
defaultMessage: 'A valid {CSS} overflow.',
values: {
CSS,
},
}),
padding: i18n.translate('xpack.canvas.functions.containerStyle.args.paddingHelpText', {
defaultMessage: 'The distance of the content, in pixels, from border.',
}),
},
};

6
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/context.ts
View file

@ -8,12 +8,16 @@ import { i18n } from '@kbn/i18n';
import { context } from '../../functions/common/context';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { CONTEXT } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof context>> = {
help: i18n.translate('xpack.canvas.functions.contextHelpText', {
defaultMessage:
'Returns whatever you pass into it. This can be useful when you need to use ' +
'context as argument to a function as a sub-expression',
'{CONTEXT} as argument to a function as a sub-expression.',
values: {
CONTEXT,
},
}),
args: {},
};

14
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/csv.ts
View file

@ -8,26 +8,28 @@ import { i18n } from '@kbn/i18n';
import { csv } from '../../functions/common/csv';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { DATATABLE, CSV } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof csv>> = {
help: i18n.translate('xpack.canvas.functions.csvHelpText', {
defaultMessage: 'Create datatable from {csv} input',
defaultMessage: 'Creates a {DATATABLE} from {CSV} input.',
values: {
csv: 'CSV',
DATATABLE,
CSV,
},
}),
args: {
data: i18n.translate('xpack.canvas.functions.csv.args.dataHelpText', {
defaultMessage: '{csv} data to use',
defaultMessage: 'The {CSV} data to use.',
values: {
csv: 'CSV',
CSV,
},
}),
delimiter: i18n.translate('xpack.canvas.functions.csv.args.delimeterHelpText', {
defaultMessage: 'Data separation character',
defaultMessage: 'The data separation character.',
}),
newline: i18n.translate('xpack.canvas.functions.csv.args.newlineHelpText', {
defaultMessage: 'Row separation character',
defaultMessage: 'The row separation character.',
}),
},
};

18
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/date.ts
View file

@ -8,26 +8,30 @@ import { i18n } from '@kbn/i18n';
import { date } from '../../functions/common/date';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { ISO8601, MOMENTJS, JS } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof date>> = {
help: i18n.translate('xpack.canvas.functions.dateHelpText', {
defaultMessage:
'Returns the current time, or a time parsed from a string, as milliseconds since epoch',
'Returns the current time, or a time parsed from a specified string, as milliseconds since epoch.',
}),
args: {
value: i18n.translate('xpack.canvas.functions.date.args.valueHelpText', {
defaultMessage:
'An optional date string to parse into milliseconds since epoch. Can be either a valid ' +
'Javascript Date input or a string to parse using the format argument. Must be an {iso} ' +
'string or you must provide the format',
'An optional date string that is parsed into milliseconds since epoch. The date string can be either a valid ' +
'{JS} {date} input or a string to parse using the {formatArg} argument. Must be an {ISO8601} ' +
'string, or you must provide the format.',
values: {
iso: 'ISO8601',
JS,
date: '`Date`',
formatArg: '`format`',
ISO8601,
},
}),
format: i18n.translate('xpack.canvas.functions.date.args.formatHelpText', {
defaultMessage: 'The {moment} format for parsing the optional date string (See {url})',
defaultMessage: 'The {MOMENTJS} format used to parse the specified date string. See {url}.',
values: {
moment: 'momentJS',
MOMENTJS,
url: 'https://momentjs.com/docs/#/displaying/',
},
}),

4
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/demodata.ts
View file

@ -13,14 +13,14 @@ import { DemoRows } from '../../functions/server/demodata/get_demo_rows';
export const help: FunctionHelp<FunctionFactory<typeof demodata>> = {
help: i18n.translate('xpack.canvas.functions.demodataHelpText', {
defaultMessage:
'A mock data set that includes project {ci} times with usernames, countries and run phases',
'A mock data set that includes project {ci} times with usernames, countries, and run phases.',
values: {
ci: 'CI',
},
}),
args: {
type: i18n.translate('xpack.canvas.functions.demodata.args.typeHelpText', {
defaultMessage: 'The name of the demo data set to use',
defaultMessage: 'The name of the demo data set to use.',
}),
},
};

15
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/do.ts
View file

@ -8,18 +8,25 @@ import { i18n } from '@kbn/i18n';
import { doFn } from '../../functions/common/do';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { CONTEXT } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof doFn>> = {
help: i18n.translate('xpack.canvas.functions.doHelpText', {
defaultMessage:
'Runs multiple sub-expressions. Returns the passed in context. Nice for running ' +
'actions producing functions.',
'Executes multiple sub-expressions, then returns the original {CONTEXT}. ' +
'Use for running functions that produce an action or a side effect without changing the original {CONTEXT}.',
values: {
CONTEXT,
},
}),
args: {
fn: i18n.translate('xpack.canvas.functions.do.args.fnHelpText', {
defaultMessage:
'One or more sub-expressions. The value of these is not available in the root ' +
'pipeline as this function simply returns the passed in context',
'The sub-expressions to execute. The return values of these sub-expressions are not available in the root ' +
'pipeline as this function simply returns the original {CONTEXT}.',
values: {
CONTEXT,
},
}),
},
};

8
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/dropdownControl.ts
View file

@ -11,21 +11,21 @@ import { FunctionFactory } from '../../../types';
export const help: FunctionHelp<FunctionFactory<typeof dropdownControl>> = {
help: i18n.translate('xpack.canvas.functions.dropdownControlHelpText', {
defaultMessage: 'Configure a drop down filter control element',
defaultMessage: 'Configures a drop-down filter control element.',
}),
args: {
filterColumn: i18n.translate(
'xpack.canvas.functions.dropdownControl.args.filterColumnHelpText',
{
defaultMessage: 'The column or field to attach the filter to',
defaultMessage: 'The column or field that you want to filter.',
}
),
valueColumn: i18n.translate('xpack.canvas.functions.dropdownControl.args.valueColumnHelpText', {
defaultMessage:
'The datatable column from which to extract the unique values for the drop down',
'The column or field from which to extract the unique values for the drop-down control.',
}),
filterGroup: i18n.translate('xpack.canvas.functions.dropdownControl.args.filterGroupHelpText', {
defaultMessage: 'Group name for the filter',
defaultMessage: 'The group name for the filter.',
}),
},
};

11
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/eq.ts
View file

@ -8,14 +8,21 @@ import { i18n } from '@kbn/i18n';
import { eq } from '../../functions/common/eq';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { CONTEXT } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof eq>> = {
help: i18n.translate('xpack.canvas.functions.eqHelpText', {
defaultMessage: 'Return if the context is equal to the argument',
defaultMessage: 'Return whether the {CONTEXT} is equal to the argument.',
values: {
CONTEXT,
},
}),
args: {
value: i18n.translate('xpack.canvas.functions.eq.args.valueHelpText', {
defaultMessage: 'The value to compare the context to',
defaultMessage: 'The value compared to the {CONTEXT}.',
values: {
CONTEXT,
},
}),
},
};

17
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/escount.ts
View file

@ -8,25 +8,26 @@ import { i18n } from '@kbn/i18n';
import { escount } from '../../functions/server/escount';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { ELASTICSEARCH, LUCENE } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof escount>> = {
help: i18n.translate('xpack.canvas.functions.escountHelpText', {
defaultMessage: 'Query {es} for a count of the number of hits matching a query',
defaultMessage: 'Query {ELASTICSEARCH} for the number of hits matching the specified query.',
values: {
es: 'elasticsearch',
ELASTICSEARCH,
},
}),
args: {
index: i18n.translate('xpack.canvas.functions.escount.args.indexHelpText', {
defaultMessage: 'Specify an index pattern. Eg "{example}"',
query: i18n.translate('xpack.canvas.functions.escount.args.queryHelpText', {
defaultMessage: 'A {LUCENE} query string.',
values: {
example: 'logstash-*',
LUCENE,
},
}),
query: i18n.translate('xpack.canvas.functions.escount.args.queryHelpText', {
defaultMessage: 'A {lucene} query string',
index: i18n.translate('xpack.canvas.functions.escount.args.indexHelpText', {
defaultMessage: 'An index or index pattern. For example, {example}.',
values: {
lucene: 'Lucene',
example: '`"logstash-*"`',
},
}),
},

61
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/esdocs.ts
View file

@ -8,48 +8,51 @@ import { i18n } from '@kbn/i18n';
import { esdocs } from '../../functions/server/esdocs';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { ELASTICSEARCH, LUCENE } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof esdocs>> = {
help: i18n.translate('xpack.canvas.functions.esdocsHelpText', {
defaultMessage:
'Query {es} and get back raw documents. We recommend you specify the fields you want, ' +
'especially if you are going to ask for a lot of rows',
'Query {ELASTICSEARCH} for raw documents. Specify the fields you want to retrieve, ' +
'especially if you are asking for a lot of rows.',
values: {
es: 'elasticsearch',
ELASTICSEARCH,
},
}),
args: {
index: i18n.translate('xpack.canvas.functions.esdocs.args.indexHelpText', {
defaultMessage: 'Specify an index pattern. Eg "{example}"',
values: {
example: 'logstash-*',
},
}),
query: i18n.translate('xpack.canvas.functions.esdocs.args.queryHelpText', {
defaultMessage: 'A {lucene} query string',
defaultMessage: 'A {LUCENE} query string.',
values: {
lucene: 'Lucene',
},
}),
sort: i18n.translate('xpack.canvas.functions.esdocs.args.sortHelpText', {
defaultMessage: 'Sort directions as "{directions}". Eg "{example1}" or "{example2}"',
values: {
directions: ['field', 'direction'].join(', '),
example1: ['@timestamp', 'desc'].join(', '),
example2: ['bytes', 'asc'].join(', '),
},
}),
fields: i18n.translate('xpack.canvas.functions.esdocs.args.fieldsHelpText', {
defaultMessage: 'Comma separated list of fields. Fewer fields will perform better',
}),
metaFields: i18n.translate('xpack.canvas.functions.esdocs.args.metaFieldsHelpText', {
defaultMessage: 'Comma separated list of meta fields, eg "{example}"',
values: {
example: '_index,_type',
LUCENE,
},
}),
count: i18n.translate('xpack.canvas.functions.esdocs.args.countHelpText', {
defaultMessage: 'The number of docs to pull back. Smaller numbers perform better',
defaultMessage:
'The number of documents to retrieve. For better performance, use a smaller data set.',
}),
fields: i18n.translate('xpack.canvas.functions.esdocs.args.fieldsHelpText', {
defaultMessage: 'A comma-separated list of fields. For better performance, use fewer fields.',
}),
index: i18n.translate('xpack.canvas.functions.esdocs.args.indexHelpText', {
defaultMessage: 'An index or index pattern. For example, {example}.',
values: {
example: '`"logstash-*"`',
},
}),
metaFields: i18n.translate('xpack.canvas.functions.esdocs.args.metaFieldsHelpText', {
defaultMessage: 'Comma separated list of meta fields. For example, {example}.',
values: {
example: '`"_index,_type"`',
},
}),
sort: i18n.translate('xpack.canvas.functions.esdocs.args.sortHelpText', {
defaultMessage:
'The sort direction formatted as {directions}. For example, {example1} or {example2}.',
values: {
directions: `\`"${['field', 'direction'].join(', ')}"\``,
example1: `\`"${['@timestamp', 'desc'].join(', ')}"\``,
example2: `\`"${['bytes', 'asc'].join(', ')}"\``,
},
}),
},
};

20
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/essql.ts
View file

@ -8,30 +8,34 @@ import { i18n } from '@kbn/i18n';
import { essql } from '../../functions/server/essql';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { ELASTICSEARCH, SQL, ISO8601, UTC } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof essql>> = {
help: i18n.translate('xpack.canvas.functions.essqlHelpText', {
defaultMessage: '{essql}',
defaultMessage: 'Queries {ELASTICSEARCH} using {ELASTICSEARCH} {SQL}.',
values: {
essql: 'Elasticsearch SQL',
ELASTICSEARCH,
SQL,
},
}),
args: {
query: i18n.translate('xpack.canvas.functions.essql.args.queryHelpText', {
defaultMessage: '{sql} query',
defaultMessage: 'An {ELASTICSEARCH} {SQL} query.',
values: {
sql: 'SQL',
ELASTICSEARCH,
SQL,
},
}),
count: i18n.translate('xpack.canvas.functions.essql.args.countHelpText', {
defaultMessage: 'The number of docs to pull back. Smaller numbers perform better',
defaultMessage:
'The number of documents to retrieve. For better performance, use a smaller data set.',
}),
timezone: i18n.translate('xpack.canvas.functions.essql.args.timezoneHelpText', {
defaultMessage:
'Timezone to use for date operations, valid {iso} formats and {utc} offsets both work',
'The timezone to use for date operations. Valid {ISO8601} formats and {UTC} offsets both work.',
values: {
iso: 'ISO',
utc: 'UTC',
ISO8601,
UTC,
},
}),
},

10
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/exactly.ts
View file

@ -11,17 +11,17 @@ import { FunctionFactory } from '../../../types';
export const help: FunctionHelp<FunctionFactory<typeof exactly>> = {
help: i18n.translate('xpack.canvas.functions.exactlyHelpText', {
defaultMessage: 'Create a filter that matches a given column for a perfectly exact value',
defaultMessage: 'Creates a filter that matches a given column to an exact value.',
}),
args: {
column: i18n.translate('xpack.canvas.functions.exactly.args.columnHelpText', {
defaultMessage: 'The column or field to attach the filter to',
defaultMessage: 'The column or field that you want to filter.',
}),
value: i18n.translate('xpack.canvas.functions.exactly.args.valueHelpText', {
defaultMessage: 'The value to match exactly, including white space and capitalization',
defaultMessage: 'The value to match exactly, including white space and capitalization.',
}),
filterGroup: i18n.translate('xpack.canvas.functions.dropdownControl.args.filterGroupHelpText', {
defaultMessage: 'Group name for the filter',
filterGroup: i18n.translate('xpack.canvas.functions.exactly.args.filterGroupHelpText', {
defaultMessage: 'The group name for the filter.',
}),
},
};

17
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/filterrows.ts
View file

@ -8,16 +8,27 @@ import { i18n } from '@kbn/i18n';
import { filterrows } from '../../functions/common/filterrows';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { DATATABLE, TYPE_BOOLEAN, BOOLEAN_TRUE, BOOLEAN_FALSE } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof filterrows>> = {
help: i18n.translate('xpack.canvas.functions.filterrowsHelpText', {
defaultMessage: 'Filter rows in a datatable based on the return value of a subexpression.',
defaultMessage: 'Filter rows in a {DATATABLE} based on the return value of a sub-expression.',
values: {
DATATABLE,
},
}),
args: {
fn: i18n.translate('xpack.canvas.functions.filterrows.args.fnHelpText', {
defaultMessage:
'An expression to pass each rows in the datatable into. The expression should return a ' +
'boolean. A true value will preserve the row, and a false value will remove it.',
'An expression to pass into each row in the {DATATABLE}. ' +
'The expression should return a {TYPE_BOOLEAN}. ' +
'A {BOOLEAN_TRUE} value preserves the row, and a {BOOLEAN_FALSE} value removes it.',
values: {
BOOLEAN_FALSE,
BOOLEAN_TRUE,
DATATABLE,
TYPE_BOOLEAN,
},
}),
},
};

14
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/formatdate.ts
View file

@ -8,22 +8,24 @@ import { i18n } from '@kbn/i18n';
import { formatdate } from '../../functions/common/formatdate';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { ISO8601, MOMENTJS } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof formatdate>> = {
help: i18n.translate('xpack.canvas.functions.formatdateHelpText', {
defaultMessage:
'Format a valid date string or number of {ms} since epoch using {moment} (see {url})',
'Formats an {ISO8601} date string or a date in milliseconds since epoch using {MOMENTJS}. See {url}.',
values: {
ms: 'ms',
moment: 'momentJS',
url: 'https://momentjs.com/',
ISO8601,
MOMENTJS,
url: 'https://momentjs.com/docs/#/displaying/',
},
}),
args: {
format: i18n.translate('xpack.canvas.functions.formatdate.args.formatHelpText', {
defaultMessage: '{moment} Format with which to bucket (See {url})',
defaultMessage: 'A {MOMENTJS} format. For example, {example}. See {url}.',
values: {
moment: 'momentJS',
MOMENTJS,
example: `"MM/DD/YYYY"`,
url: 'https://momentjs.com/docs/#/displaying/',
},
}),

13
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/formatnumber.ts
View file

@ -8,19 +8,24 @@ import { i18n } from '@kbn/i18n';
import { formatnumber } from '../../functions/common/formatnumber';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { NUMERALJS } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof formatnumber>> = {
help: i18n.translate('xpack.canvas.functions.formatnumberHelpText', {
defaultMessage: 'Turn a number into a string using a {numeralJS} format',
defaultMessage: 'Formats a number into a formatted number string using {NUMERALJS}. See {url}.',
values: {
numeralJS: 'NumeralJS',
NUMERALJS,
url: 'http://numeraljs.com/#format',
},
}),
args: {
format: i18n.translate('xpack.canvas.functions.formatnumber.args.formatHelpText', {
defaultMessage: '{numeralJS} format string {url}',
defaultMessage:
'A {NUMERALJS} format string. For example, {example1} or {example2}. See {url}.',
values: {
numeralJS: 'NumeralJS',
example1: `"0.0a"`,
example2: `"0%"`,
NUMERALJS,
url: 'http://numeraljs.com/#format',
},
}),

12
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/getCell.ts
View file

@ -8,17 +8,23 @@ import { i18n } from '@kbn/i18n';
import { getCell } from '../../functions/common/getCell';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { DATATABLE } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof getCell>> = {
help: i18n.translate('xpack.canvas.functions.getCellHelpText', {
defaultMessage: 'Fetch a single cell in a table',
defaultMessage: 'Fetchs a single cell from a {DATATABLE}.',
values: {
DATATABLE,
},
}),
args: {
column: i18n.translate('xpack.canvas.functions.getCell.args.columnHelpText', {
defaultMessage: 'The name of the column value to fetch',
defaultMessage:
'The name of the column to fetch the value from. ' +
'If not provided, the value is retrieved from the first column.',
}),
row: i18n.translate('xpack.canvas.functions.getCell.args.rowHelpText', {
defaultMessage: 'The row number, starting at 0',
defaultMessage: 'The row number, starting at 0.',
}),
},
};

11
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/gt.ts
View file

@ -8,14 +8,21 @@ import { i18n } from '@kbn/i18n';
import { gt } from '../../functions/common/gt';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { CONTEXT } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof gt>> = {
help: i18n.translate('xpack.canvas.functions.gtHelpText', {
defaultMessage: 'Return if the context is greater than the argument',
defaultMessage: 'Returns whether the {CONTEXT} is greater than the argument.',
values: {
CONTEXT,
},
}),
args: {
value: i18n.translate('xpack.canvas.functions.gt.args.valueHelpText', {
defaultMessage: 'The value to compare the context to',
defaultMessage: 'The value compared to the {CONTEXT}.',
values: {
CONTEXT,
},
}),
},
};

11
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/gte.ts
View file

@ -8,14 +8,21 @@ import { i18n } from '@kbn/i18n';
import { gte } from '../../functions/common/gte';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { CONTEXT } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof gte>> = {
help: i18n.translate('xpack.canvas.functions.gteHelpText', {
defaultMessage: 'Return if the context is greater than or equal to the argument',
defaultMessage: 'Returns whether the {CONTEXT} is greater or equal to the argument.',
values: {
CONTEXT,
},
}),
args: {
value: i18n.translate('xpack.canvas.functions.gte.args.valueHelpText', {
defaultMessage: 'The value to compare the context to',
defaultMessage: 'The value compared to the {CONTEXT}.',
values: {
CONTEXT,
},
}),
},
};

11
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/head.ts
View file

@ -8,21 +8,22 @@ import { i18n } from '@kbn/i18n';
import { head } from '../../functions/common/head';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { DATATABLE } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof head>> = {
help: i18n.translate('xpack.canvas.functions.headHelpText', {
defaultMessage: 'Get the first {n} rows from the {datatable}. Also see `{tail}`',
defaultMessage: 'Retrieves the first {n} rows from the {DATATABLE}. See also {tailFn}',
values: {
n: 'N',
datatable: 'datatable',
tail: 'tail',
DATATABLE,
tailFn: '`tail`',
},
}),
args: {
count: i18n.translate('xpack.canvas.functions.head.args.countHelpText', {
defaultMessage: 'Return this many rows from the beginning of the {datatable}',
defaultMessage: 'The number of rows to retrieve from the beginning of the {DATATABLE}.',
values: {
datatable: 'datatable',
DATATABLE,
},
}),
},

26
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/if.ts
View file

@ -8,6 +8,7 @@ import { i18n } from '@kbn/i18n';
import { ifFn } from '../../functions/common/if';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { BOOLEAN_TRUE, BOOLEAN_FALSE, CONTEXT } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof ifFn>> = {
help: i18n.translate('xpack.canvas.functions.ifHelpText', {
@ -16,16 +17,31 @@ export const help: FunctionHelp<FunctionFactory<typeof ifFn>> = {
args: {
condition: i18n.translate('xpack.canvas.functions.if.args.conditionHelpText', {
defaultMessage:
'A boolean true or false, usually returned by a subexpression. If this is not ' +
'supplied then the input context will be used',
'A {BOOLEAN_TRUE} or {BOOLEAN_FALSE} indicating whether a condition is met, ' +
'usually returned by a sub-expression. When unspecified, the original {CONTEXT} is returned.',
values: {
BOOLEAN_TRUE,
BOOLEAN_FALSE,
CONTEXT,
},
}),
then: i18n.translate('xpack.canvas.functions.if.args.thenHelpText', {
defaultMessage: 'The return value if true',
defaultMessage:
'The return value when the condition is {BOOLEAN_TRUE}. ' +
'When unspecified and the condition is met, the original {CONTEXT} is returned.',
values: {
BOOLEAN_TRUE,
CONTEXT,
},
}),
else: i18n.translate('xpack.canvas.functions.if.args.elseHelpText', {
defaultMessage:
'The return value if false. If else is not specified, and the condition is false ' +
'then the input context to the function will be returned',
'The return value when the condition is {BOOLEAN_FALSE}. ' +
'When unspecified and the condition is not met, the original {CONTEXT} is returned.',
values: {
BOOLEAN_FALSE,
CONTEXT,
},
}),
},
};

28
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/image.ts
View file

@ -8,25 +8,35 @@ import { i18n } from '@kbn/i18n';
import { image, ImageMode } from '../../functions/common/image';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { URL, BASE64 } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof image>> = {
help: i18n.translate('xpack.canvas.functions.imageHelpText', {
defaultMessage: 'Display an image',
defaultMessage:
'Displays an image. Provide an image asset as a {BASE64} data {URL}, or pass in a sub-expression.',
values: {
BASE64,
URL,
},
}),
args: {
dataurl: i18n.translate('xpack.canvas.functions.image.args.dataurlHelpText', {
defaultMessage: 'The HTTP(S) URL or base64 data of an image.',
defaultMessage: 'The {https} {URL} or {BASE64} data {URL} of an image.',
values: {
BASE64,
https: 'HTTP(S)',
URL,
},
}),
mode: i18n.translate('xpack.canvas.functions.image.args.modeHelpText', {
defaultMessage:
'`{contain}` will show the entire image, scaled to fit. ' +
'`{cover}` will fill the container with the image, cropping from the sides or ' +
'bottom as needed. ' +
'`{stretch}` will resize the height and width of the image to 100% of the container',
'{contain} shows the entire image, scaled to fit. ' +
'{cover} fills the container with the image, cropping from the sides or bottom as needed. ' +
'{stretch} resizes the height and width of the image to 100% of the container.',
values: {
contain: ImageMode.CONTAIN,
cover: ImageMode.COVER,
stretch: ImageMode.STRETCH,
contain: `\`"${ImageMode.CONTAIN}"\``,
cover: `\`"${ImageMode.COVER}"\``,
stretch: `\`"${ImageMode.STRETCH}"\``,
},
}),
},

8
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/join_rows.ts
View file

@ -15,16 +15,16 @@ export const help: FunctionHelp<FunctionFactory<typeof joinRows>> = {
}),
args: {
column: i18n.translate('xpack.canvas.functions.joinRows.args.columnHelpText', {
defaultMessage: 'Column to join values from',
defaultMessage: 'The column to join values from',
}),
separator: i18n.translate('xpack.canvas.functions.joinRows.args.separatorHelpText', {
defaultMessage: 'Separator to use between row values',
defaultMessage: 'The separator to use between row values',
}),
quote: i18n.translate('xpack.canvas.functions.joinRows.args.quoteHelpText', {
defaultMessage: 'Quote character around values',
defaultMessage: 'The quote character around values',
}),
distinct: i18n.translate('xpack.canvas.functions.joinRows.args.distinctHelpText', {
defaultMessage: 'Removes duplicate values if enabled',
defaultMessage: 'Removes duplicate values?',
}),
},
};

9
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/location.ts
View file

@ -12,8 +12,13 @@ import { FunctionFactory } from '../../../types';
export const help: FunctionHelp<FunctionFactory<typeof location>> = {
help: i18n.translate('xpack.canvas.functions.locationHelpText', {
defaultMessage:
"Use the browser's location functionality to get your current location. " +
'Usually quite slow, but fairly accurate',
'Find your current location using the {geolocationAPI} of the browser. ' +
'Performance can vary, but is fairly accurate. ' +
'See {url}.',
values: {
geolocationAPI: 'Geolocation API',
url: 'https://developer.mozilla.org/en-US/docs/Web/API/Navigator/geolocation',
},
}),
args: {},
};

11
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/lt.ts
View file

@ -8,14 +8,21 @@ import { i18n } from '@kbn/i18n';
import { lt } from '../../functions/common/lt';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { CONTEXT } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof lt>> = {
help: i18n.translate('xpack.canvas.functions.ltHelpText', {
defaultMessage: 'Return if the context is less than the argument',
defaultMessage: 'Returns whether the {CONTEXT} is less than the argument.',
values: {
CONTEXT,
},
}),
args: {
value: i18n.translate('xpack.canvas.functions.lt.args.valueHelpText', {
defaultMessage: 'The value to compare the context to',
defaultMessage: 'The value compared to the {CONTEXT}.',
values: {
CONTEXT,
},
}),
},
};

11
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/lte.ts
View file

@ -8,14 +8,21 @@ import { i18n } from '@kbn/i18n';
import { lte } from '../../functions/common/lte';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { CONTEXT } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof lte>> = {
help: i18n.translate('xpack.canvas.functions.lteHelpText', {
defaultMessage: 'Return if the context is less than or equal to the argument',
defaultMessage: 'Returns whether the {CONTEXT} is less than or equal to the argument.',
values: {
CONTEXT,
},
}),
args: {
value: i18n.translate('xpack.canvas.functions.lte.args.valueHelpText', {
defaultMessage: 'The value to compare the context to',
defaultMessage: 'The value compared to the {CONTEXT}.',
values: {
CONTEXT,
},
}),
},
};

17
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/mapColumn.ts
View file

@ -8,20 +8,29 @@ import { i18n } from '@kbn/i18n';
import { mapColumn } from '../../functions/common/mapColumn';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { CANVAS, DATATABLE } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof mapColumn>> = {
help: i18n.translate('xpack.canvas.functions.mapColumnHelpText', {
defaultMessage: 'Add a column calculated as the result of other columns, or not',
defaultMessage:
'Adds a column calculated as the result of other columns. ' +
'Changes are made only when you provide arguments.' +
'See also {mapColumnFn} and {staticColumnFn}.',
values: {
mapColumnFn: '`mapColumn`',
staticColumnFn: '`staticColumn`',
},
}),
args: {
name: i18n.translate('xpack.canvas.functions.mapColumn.args.nameHelpText', {
defaultMessage: 'The name of the resulting column',
defaultMessage: 'The name of the resulting column.',
}),
expression: i18n.translate('xpack.canvas.functions.mapColumn.args.expressionHelpText', {
defaultMessage:
'A canvas expression which will be passed each row as a single row {datatable}',
'A {CANVAS} expression that is passed to each row as a single row {DATATABLE}.',
values: {
datatable: 'datatable',
CANVAS,
DATATABLE,
},
}),
},

19
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/markdown.ts
View file

@ -8,25 +8,34 @@ import { i18n } from '@kbn/i18n';
import { markdown } from '../../functions/browser/markdown';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { MARKDOWN, CSS } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof markdown>> = {
help: i18n.translate('xpack.canvas.functions.markdownHelpText', {
defaultMessage:
'An element for rendering {markdown} text. Great for single numbers, metrics or paragraphs of text.',
'Adds an element that renders {MARKDOWN} text. TIP: Use the {markdownFn} function for single numbers, metrics, and paragraphs of text.',
values: {
markdown: 'markdown',
MARKDOWN,
markdownFn: '`markdown`',
},
}),
args: {
content: i18n.translate('xpack.canvas.functions.markdown.args.contentHelpText', {
defaultMessage:
'A {markdown} expression. You can pass this multiple times to achieve concatenation',
'A string of text that contains {MARKDOWN}. To concatenate, pass the {stringFn} function multiple times.',
values: {
markdown: 'markdown',
MARKDOWN,
stringFn: '`string`',
},
}),
font: i18n.translate('xpack.canvas.functions.markdown.args.fontHelpText', {
defaultMessage: 'Font settings. Technically, you can add other styles in here as well',
defaultMessage:
'The {CSS} font properties for the content. For example, {fontFamily} or {fontWeight}.',
values: {
CSS,
fontFamily: 'font-family',
fontWeight: 'font-weight',
},
}),
},
};

21
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/math.ts
View file

@ -8,26 +8,27 @@ import { i18n } from '@kbn/i18n';
import { math } from '../../functions/common/math';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { DATATABLE, CONTEXT, TINYMATH, TINYMATH_URL } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof math>> = {
help: i18n.translate('xpack.canvas.functions.mathHelpText', {
defaultMessage:
'Interpret a math expression, with a number or {datatable} as context. {Datatable} ' +
'columns are available by their column name. If you pass in a number it is available ' +
'as "{value}" (without the quotes)',
'Interprets a {TINYMATH} math expression using a number or {DATATABLE} as {CONTEXT}. ' +
'The {DATATABLE} columns are available by their column name. ' +
'If the {CONTEXT} is a number it is available as {value}.',
values: {
datatable: 'datatable',
Datatable: 'Datatable',
value: 'value',
TINYMATH,
CONTEXT,
DATATABLE,
value: '`value`',
},
}),
args: {
expression: i18n.translate('xpack.canvas.functions.math.args.expressionHelpText', {
defaultMessage: 'An evaluated {tinymath} expression. (See {url})',
defaultMessage: 'An evaluated {TINYMATH} expression. See {TINYMATH_URL}.',
values: {
tinymath: 'TinyMath',
url:
'[TinyMath Functions](https://www.elastic.co/guide/en/kibana/current/canvas-tinymath-functions.html)',
TINYMATH,
TINYMATH_URL,
},
}),
},

19
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/metric.ts
View file

@ -8,22 +8,33 @@ import { i18n } from '@kbn/i18n';
import { metric } from '../../functions/common/metric';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { FONT_FAMILY, FONT_WEIGHT, CSS } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof metric>> = {
help: i18n.translate('xpack.canvas.functions.metricHelpText', {
defaultMessage: 'A number with a label',
defaultMessage: 'Displays a number over a label.',
}),
args: {
label: i18n.translate('xpack.canvas.functions.metric.args.labelHelpText', {
defaultMessage: 'Text describing the metric',
defaultMessage: 'The text describing the metric.',
}),
metricFont: i18n.translate('xpack.canvas.functions.metric.args.metricFontHelpText', {
defaultMessage:
'Font settings for the metric. Technically you can stick other styles in here too!',
'The {CSS} font properties for the metric. For example, {FONT_FAMILY} or {FONT_WEIGHT}.',
values: {
CSS,
FONT_FAMILY,
FONT_WEIGHT,
},
}),
labelFont: i18n.translate('xpack.canvas.functions.metric.args.labelFontHelpText', {
defaultMessage:
'Font settings for the label. Technically you can stick other styles in here too!',
'The {CSS} font properties for the label. For example, {FONT_FAMILY} or {FONT_WEIGHT}.',
values: {
CSS,
FONT_FAMILY,
FONT_WEIGHT,
},
}),
},
};

11
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/neq.ts
View file

@ -8,14 +8,21 @@ import { i18n } from '@kbn/i18n';
import { neq } from '../../functions/common/neq';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { CONTEXT } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof neq>> = {
help: i18n.translate('xpack.canvas.functions.neqHelpText', {
defaultMessage: 'Return if the context is not equal to the argument',
defaultMessage: 'Returns whether the {CONTEXT} is not equal to the argument.',
values: {
CONTEXT,
},
}),
args: {
value: i18n.translate('xpack.canvas.functions.neq.args.valueHelpText', {
defaultMessage: 'The value to compare the context to',
defaultMessage: 'The value compared to the {CONTEXT}.',
values: {
CONTEXT,
},
}),
},
};

15
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/palette.ts
View file

@ -11,23 +11,26 @@ import { FunctionFactory } from '../../../types';
export const help: FunctionHelp<FunctionFactory<typeof palette>> = {
help: i18n.translate('xpack.canvas.functions.paletteHelpText', {
defaultMessage: 'Create a color palette',
defaultMessage: 'Creates a color palette.',
}),
args: {
color: i18n.translate('xpack.canvas.functions.palette.args.colorHelpText', {
defaultMessage:
'Palette colors, {rgba}, {hex}, or {html} color string. Pass this multiple times.',
'The palette colors. Accepts an {html} color name, {hex}, {hsl}, {hsla}, {rgb}, or {rgba}.',
values: {
rgba: 'rgba',
hex: 'hex',
html: 'HTML',
rgb: 'RGB',
rgba: 'RGBA',
hex: 'HEX',
hsl: 'HSL',
hsla: 'HSLA',
},
}),
gradient: i18n.translate('xpack.canvas.functions.palette.args.gradientHelpText', {
defaultMessage: 'Prefer to make a gradient where supported and useful?',
defaultMessage: 'Make a gradient palette where supported?',
}),
reverse: i18n.translate('xpack.canvas.functions.palette.args.reverseHelpText', {
defaultMessage: 'Reverse the palette',
defaultMessage: 'Reverse the palette?',
}),
},
};

79
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/pie.ts
View file

@ -9,50 +9,65 @@ import { pie } from '../../functions/common/pie';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { Position } from '../../../types';
import { CSS, FONT_FAMILY, FONT_WEIGHT, BOOLEAN_FALSE } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof pie>> = {
help: i18n.translate('xpack.canvas.functions.pieHelpText', {
defaultMessage: 'Configure a pie chart element',
defaultMessage: 'Configure a pie chart element.',
}),
args: {
palette: i18n.translate('xpack.canvas.functions.pie.args.paletteHelpText', {
defaultMessage: 'A {palette} object for describing the colors to use on this pie',
font: i18n.translate('xpack.canvas.functions.pie.args.fontHelpText', {
defaultMessage:
'The {CSS} font properties for the labels. For example, {FONT_FAMILY} or {FONT_WEIGHT}.',
values: {
palette: 'palette',
CSS,
FONT_FAMILY,
FONT_WEIGHT,
},
}),
hole: i18n.translate('xpack.canvas.functions.pie.args.holeHelpText', {
defaultMessage:
'Draws a hole in the pie, between `0` and `100`, as a percentage of the pie radius.',
}),
labelRadius: i18n.translate('xpack.canvas.functions.pie.args.labelRadiusHelpText', {
defaultMessage:
'The percentage of the container area to use as a radius for the label circle.',
}),
labels: i18n.translate('xpack.canvas.functions.pie.args.labelsHelpText', {
defaultMessage: 'Display the pie labels?',
}),
legend: i18n.translate('xpack.canvas.functions.pie.args.legendHelpText', {
defaultMessage:
'The legend position. For example, {positions}, or {BOOLEAN_FALSE}. When {BOOLEAN_FALSE}, the legend is hidden.',
values: {
positions: Object.values(Position)
.map(position => `\`"${position}"\``)
.join(', '),
BOOLEAN_FALSE,
},
}),
palette: i18n.translate('xpack.canvas.functions.pie.args.paletteHelpText', {
defaultMessage:
'A {palette} object for describing the colors to use in this pie chart. See {paletteFn}.',
values: {
palette: '`palette`',
paletteFn: '`palette`',
},
}),
radius: i18n.translate('xpack.canvas.functions.pie.args.radiusHelpText', {
defaultMessage:
'The radius of the pie as a percentage, between `0` and `1`, of the available space. ' +
'To automatically set the radius, use {auto}.',
values: {
auto: '`"auto"`',
},
}),
seriesStyle: i18n.translate('xpack.canvas.functions.pie.args.seriesStyleHelpText', {
defaultMessage: 'A style of a specific series',
}),
radius: i18n.translate('xpack.canvas.functions.pie.args.radiusHelpText', {
defaultMessage:
'Radius of the pie as a percentage (between 0 and 1) of the available ' +
'space. Set to `{auto}` to automatically set radius',
values: {
auto: 'auto',
},
}),
hole: i18n.translate('xpack.canvas.functions.pie.args.holeHelpText', {
defaultMessage: 'Draw a hole in the pie, 0-100, as a percentage of the pie radius',
}),
labels: i18n.translate('xpack.canvas.functions.pie.args.labelsHelpText', {
defaultMessage: 'Show pie labels?',
}),
labelRadius: i18n.translate('xpack.canvas.functions.pie.args.labelRadiusHelpText', {
defaultMessage: 'Percentage of area of container to use as radius for the label circle',
}),
font: i18n.translate('xpack.canvas.functions.pie.args.fontHelpText', {
defaultMessage: 'Label font',
}),
legend: i18n.translate('xpack.canvas.functions.pie.args.legendHelpText', {
defaultMessage: 'Legend position: {position} or {false}',
values: {
position: Object.values(Position).join(', '),
false: 'false',
},
}),
tilt: i18n.translate('xpack.canvas.functions.pie.args.tiltHelpText', {
defaultMessage: 'Percentage of tilt where 1 is fully vertical and 0 is completely flat',
defaultMessage:
'The percentage of tilt where `1` is fully vertical, and `0` is completely flat.',
}),
},
};

65
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/plot.ts
View file

@ -9,47 +9,56 @@ import { plot } from '../../functions/common/plot';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { Position } from '../../../types';
import { CSS, FONT_FAMILY, FONT_WEIGHT, BOOLEAN_FALSE } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof plot>> = {
help: i18n.translate('xpack.canvas.functions.plotHelpText', {
defaultMessage: 'Configure a {plot} element',
values: {
plot: 'plot',
},
defaultMessage: 'Configure a chart element',
}),
args: {
defaultStyle: i18n.translate('xpack.canvas.functions.plot.args.defaultStyleHelpText', {
defaultMessage: 'The default style to use for every series.',
}),
font: i18n.translate('xpack.canvas.functions.plot.args.fontHelpText', {
defaultMessage:
'The {CSS} font properties for the labels. For example, {FONT_FAMILY} or {FONT_WEIGHT}.',
values: {
CSS,
FONT_FAMILY,
FONT_WEIGHT,
},
}),
legend: i18n.translate('xpack.canvas.functions.plot.args.legendHelpText', {
defaultMessage:
'The legend position. For example, {positions}, or {BOOLEAN_FALSE}. When {BOOLEAN_FALSE}, the legend is hidden.',
values: {
positions: Object.values(Position)
.map(position => `\`"${position}"\``)
.join(', '),
BOOLEAN_FALSE,
},
}),
palette: i18n.translate('xpack.canvas.functions.plot.args.paletteHelpText', {
defaultMessage:
'A {palette} object for describing the colors to use in this chart. See {paletteFn}.',
values: {
palette: '`palette`',
paletteFn: '`palette`',
},
}),
seriesStyle: i18n.translate('xpack.canvas.functions.plot.args.seriesStyleHelpText', {
defaultMessage: 'A style of a specific series',
}),
defaultStyle: i18n.translate('xpack.canvas.functions.plot.args.defaultStyleHelpText', {
defaultMessage: 'The default style to use for every series',
}),
palette: i18n.translate('xpack.canvas.functions.plot.args.paletteHelpText', {
defaultMessage: 'A {palette} object for describing the colors to use on this plot',
xaxis: i18n.translate('xpack.canvas.functions.plot.args.xaxisHelpText', {
defaultMessage: 'The axis configuration. When {BOOLEAN_FALSE}, the axis is hidden.',
values: {
palette: 'palette',
},
}),
font: i18n.translate('xpack.canvas.functions.plot.args.fontHelpText', {
defaultMessage: 'Legend and tick mark fonts',
}),
legend: i18n.translate('xpack.canvas.functions.plot.args.legendHelpText', {
defaultMessage: 'Legend position: {position} or {false}',
values: {
position: Object.values(Position).join(', '),
false: 'false',
BOOLEAN_FALSE,
},
}),
yaxis: i18n.translate('xpack.canvas.functions.plot.args.yaxisHelpText', {
defaultMessage: 'Axis configuration, or {false} to disable',
defaultMessage: 'The axis configuration. When {BOOLEAN_FALSE}, the axis is hidden.',
values: {
false: 'false',
},
}),
xaxis: i18n.translate('xpack.canvas.functions.plot.args.xaxisHelpText', {
defaultMessage: 'Axis configuration, or {false} to disable',
values: {
false: 'false',
BOOLEAN_FALSE,
},
}),
},

26
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/ply.ts
View file

@ -8,29 +8,35 @@ import { i18n } from '@kbn/i18n';
import { ply } from '../../functions/common/ply';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { DATATABLE } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof ply>> = {
help: i18n.translate('xpack.canvas.functions.plyHelpText', {
defaultMessage:
'Subdivide a {datatable} and pass the resulting tables into an expression, then merge the output',
'Subdivides a {DATATABLE} by the unique values of the specified column, ' +
'and passes the resulting tables into an expression, then merges the outputs of each expression',
values: {
datatable: 'datatable',
DATATABLE,
},
}),
args: {
by: i18n.translate('xpack.canvas.functions.ply.args.byHelpText', {
defaultMessage: 'The column to subdivide on',
defaultMessage: 'The column to subdivide the {DATATABLE}.',
values: {
DATATABLE,
},
}),
expression: i18n.translate('xpack.canvas.functions.ply.args.expressionHelpText', {
defaultMessage:
'An expression to pass each resulting {datatable} into. Tips: \n' +
' Expressions must return a {datatable}. Use `as` to turn literals into {datatable}.\n' +
' Multiple expressions must return the same number of rows.' +
' If you need to return a differing row count, pipe into another instance of {ply}.\n' +
' If multiple expressions return the same columns, the last one wins.',
'An expression to pass each resulting {DATATABLE} into. ' +
'Tips: Expressions must return a {DATATABLE}. Use {asFn} to turn literals into {DATATABLE}s. ' +
'Multiple expressions must return the same number of rows.' +
'If you need to return a different row count, pipe into another instance of {plyFn}. ' +
'If multiple expressions returns the columns with the same name, the last one wins.',
values: {
datatable: 'datatable',
ply: 'ply',
asFn: '`as`',
DATATABLE,
plyFn: '`ply`',
},
}),
},

32
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/pointseries.ts
View file

@ -8,37 +8,37 @@ import { i18n } from '@kbn/i18n';
import { pointseries } from '../../functions/server/pointseries';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { DATATABLE, TINYMATH, TINYMATH_URL } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof pointseries>> = {
help: i18n.translate('xpack.canvas.functions.pointseriesHelpText', {
defaultMessage:
'Turn a {datatable} into a point series model. Currently we differentiate measure ' +
'from dimensions by looking for a {url}. If you enter a {tinymath} expression in your ' +
'Turn a {DATATABLE} into a point series model. Currently we differentiate measure ' +
'from dimensions by looking for a {TINYMATH} expression. See {TINYMATH_URL}. If you enter a {TINYMATH} expression in your ' +
'argument, we treat that argument as a measure, otherwise it is a dimension. Dimensions ' +
'are combined to create unique keys. Measures are then deduplicated by those keys using ' +
'the specified {tinymath} function',
'the specified {TINYMATH} function',
values: {
datatable: 'datatable',
url:
'[TinyMath function](https://www.elastic.co/guide/en/kibana/current/canvas-tinymath-functions.html)',
tinymath: 'TinyMath',
DATATABLE,
TINYMATH,
TINYMATH_URL,
},
}),
args: {
x: i18n.translate('xpack.canvas.functions.pointseries.args.xHelpText', {
defaultMessage: 'The values along the x-axis',
}),
y: i18n.translate('xpack.canvas.functions.pointseries.args.yHelpText', {
defaultMessage: 'The values along the y-axis',
}),
color: i18n.translate('xpack.canvas.functions.pointseries.args.colorHelpText', {
defaultMessage: "An expression to use in determining the mark's color",
defaultMessage: "An expression to use in determining the mark's color.",
}),
size: i18n.translate('xpack.canvas.functions.pointseries.args.sizeHelpText', {
defaultMessage: 'For elements that support it, the size of the marks',
defaultMessage: 'The size of the marks. Only applicable to supported elements.',
}),
text: i18n.translate('xpack.canvas.functions.pointseries.args.textHelpText', {
defaultMessage: 'For use in charts that support it, the text to show in the mark',
defaultMessage: 'The text to show on the mark. Only applicable to supported elements.',
}),
x: i18n.translate('xpack.canvas.functions.pointseries.args.xHelpText', {
defaultMessage: 'The values along the x-axis.',
}),
y: i18n.translate('xpack.canvas.functions.pointseries.args.yHelpText', {
defaultMessage: 'The values along the y-axis.',
}),
},
};

32
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/progress.ts
View file

@ -10,46 +10,54 @@ import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { Shape } from '../../functions/common/progress';
import { CSS, FONT_FAMILY, FONT_WEIGHT, BOOLEAN_TRUE, BOOLEAN_FALSE } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof progress>> = {
help: i18n.translate('xpack.canvas.functions.progressHelpText', {
defaultMessage: 'Configure a progress element',
defaultMessage: 'Configures a progress element.',
}),
args: {
barColor: i18n.translate('xpack.canvas.functions.progress.args.barColorHelpText', {
defaultMessage: 'Color of the background bar',
defaultMessage: 'The color of the background bar.',
}),
barWeight: i18n.translate('xpack.canvas.functions.progress.args.barWeightHelpText', {
defaultMessage: 'Thickness of the background bar',
defaultMessage: 'The thickness of the background bar.',
}),
font: i18n.translate('xpack.canvas.functions.progress.args.fontHelpText', {
defaultMessage:
'Font settings for the label. Technically you can stick other styles in here too!',
'The {CSS} font properties for the label. For example, {FONT_FAMILY} or {FONT_WEIGHT}.',
values: {
CSS,
FONT_FAMILY,
FONT_WEIGHT,
},
}),
label: i18n.translate('xpack.canvas.functions.progress.args.labelHelpText', {
defaultMessage: `Set {true}/{false} to show/hide label or provide a string to display as the label`,
defaultMessage:
'To show or hide labels, use {BOOLEAN_TRUE} or {BOOLEAN_FALSE}. Alternatively, provide a string to display as a label.',
values: {
true: 'true',
false: 'false',
BOOLEAN_TRUE,
BOOLEAN_FALSE,
},
}),
max: i18n.translate('xpack.canvas.functions.progress.args.maxHelpText', {
defaultMessage: 'Maximum value of the progress element',
defaultMessage: 'The maximum value of the progress element.',
}),
shape: i18n.translate('xpack.canvas.functions.progress.args.shapeHelpText', {
defaultMessage: `Select {list}, or {end}`,
defaultMessage: `Select {list}, or {end}.`,
values: {
list: Object.values(Shape)
.slice(0, -1)
.map(shape => `\`"${shape}"\``)
.join(', '),
end: Object.values(Shape).slice(-1)[0],
end: `\`"${Object.values(Shape).slice(-1)[0]}"\``,
},
}),
valueColor: i18n.translate('xpack.canvas.functions.progress.args.valueColorHelpText', {
defaultMessage: 'Color of the progress bar',
defaultMessage: 'The color of the progress bar.',
}),
valueWeight: i18n.translate('xpack.canvas.functions.progress.args.valueWeightHelpText', {
defaultMessage: 'Thickness of the progress bar',
defaultMessage: 'The thickness of the progress bar.',
}),
},
};

18
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/render.ts
View file

@ -8,29 +8,33 @@ import { i18n } from '@kbn/i18n';
import { render } from '../../functions/common/render';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { CONTEXT, CSS } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof render>> = {
help: i18n.translate('xpack.canvas.functions.renderHelpText', {
defaultMessage:
'Render an input as a specific element and set element level options such as styling',
'Render the {CONTEXT} as a specific element and sets element level options, such as background and border styling.',
values: {
CONTEXT,
},
}),
args: {
as: i18n.translate('xpack.canvas.functions.render.args.asHelpText', {
defaultMessage:
'The element type to use in rendering. You probably want a specialized function instead, such as `{plot}` or `{grid}`',
'The element type to render. You probably want a specialized function instead, such as {plotFn} or {shapeFn}.',
values: {
plot: 'plot',
grid: 'grid',
plotFn: '`plot`',
shapeFn: '`shape`',
},
}),
css: i18n.translate('xpack.canvas.functions.render.args.cssHelpText', {
defaultMessage: 'Any block of custom {css} to be scoped to this element.',
defaultMessage: 'Any block of custom {CSS} to be scoped to the element.',
values: {
css: 'CSS',
CSS,
},
}),
containerStyle: i18n.translate('xpack.canvas.functions.render.args.containerStyleHelpText', {
defaultMessage: 'Style for the container, including background, border, and opacity',
defaultMessage: 'The style for the container, including background, border, and opacity.',
}),
},
};

39
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/repeatImage.ts
View file

@ -8,32 +8,39 @@ import { i18n } from '@kbn/i18n';
import { repeatImage } from '../../functions/common/repeatImage';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { CONTEXT, BASE64, URL } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof repeatImage>> = {
help: i18n.translate('xpack.canvas.functions.repeatImageHelpText', {
defaultMessage: 'Configure a repeating image element',
defaultMessage: 'Configures a repeating image element.',
}),
args: {
image: i18n.translate('xpack.canvas.functions.repeatImage.args.imageHelpText', {
defaultMessage: 'The image to repeat. Usually a {dataurl} or an asset',
emptyImage: i18n.translate('xpack.canvas.functions.repeatImage.args.emptyImageHelpText', {
defaultMessage:
'Fills the difference between the {CONTEXT} and {maxArg} parameter for the element with this image' +
'Provide an image asset as a {BASE64} data {URL}, or pass in a sub-expression.',
values: {
dataurl: 'dataURL',
BASE64,
CONTEXT,
maxArg: '`max`',
URL,
},
}),
image: i18n.translate('xpack.canvas.functions.repeatImage.args.imageHelpText', {
defaultMessage:
'The image to repeat. Provide an image asset as a {BASE64} data {URL}, or pass in a sub-expression.',
values: {
BASE64,
URL,
},
}),
max: i18n.translate('xpack.canvas.functions.repeatImage.args.maxHelpText', {
defaultMessage: 'The maximum number of times the image can repeat.',
}),
size: i18n.translate('xpack.canvas.functions.repeatImage.args.sizeHelpText', {
defaultMessage:
'The maximum height or width of the image, in pixels. Eg, if you images is taller ' +
'than it is wide, this will limit its height',
}),
max: i18n.translate('xpack.canvas.functions.repeatImage.args.maxHelpText', {
defaultMessage: 'Maximum number of times the image may repeat',
}),
emptyImage: i18n.translate('xpack.canvas.functions.repeatImage.args.emptyImageHelpText', {
defaultMessage:
'Fill the difference between the input and the `{max}` parameter with this image',
values: {
max: 'max=',
},
'The maximum height or width of the image, in pixels. ' +
'When the image is taller than it is wide, this function limits the height.',
}),
},
};

15
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/replace.ts
View file

@ -8,22 +8,23 @@ import { i18n } from '@kbn/i18n';
import { replace } from '../../functions/common/replace';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { JS } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof replace>> = {
help: i18n.translate('xpack.canvas.functions.replaceImageHelpText', {
defaultMessage: 'Use a regular expression to replace parts of a string',
defaultMessage: 'Use a regular expression to replace parts of a string.',
}),
args: {
pattern: i18n.translate('xpack.canvas.functions.replace.args.patternHelpText', {
defaultMessage:
'The text or pattern of a {js} regular expression, eg "{example}". You can use capture groups here.',
'The text or pattern of a {JS} regular expression. For example, {example}. You can use capturing groups here.',
values: {
js: 'JavaScript',
example: '[aeiou]',
JS,
example: '`"[aeiou]"`',
},
}),
flags: i18n.translate('xpack.canvas.functions.replace.args.flagsHelpText', {
defaultMessage: 'Specify flags. See {url} for reference.',
defaultMessage: 'Specify flags. See {url}.',
values: {
url:
'https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp',
@ -31,9 +32,9 @@ export const help: FunctionHelp<FunctionFactory<typeof replace>> = {
}),
replacement: i18n.translate('xpack.canvas.functions.replace.args.replacementHelpText', {
defaultMessage:
'The replacement for the matching parts of string. Capture groups can be accessed by their index, eg {example}',
'The replacement for the matching parts of string. Capturing groups can be accessed by their index. For example, {example}.',
values: {
example: '$1',
example: '`"$1"`',
},
}),
},

27
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/revealImage.ts
View file

@ -9,22 +9,39 @@ import { revealImage } from '../../functions/common/revealImage';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { Position } from '../../../types';
import { BASE64, URL } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof revealImage>> = {
help: i18n.translate('xpack.canvas.functions.revealImageHelpText', {
defaultMessage: 'Configure an image reveal element',
defaultMessage: 'Configure an image reveal element.',
}),
args: {
image: i18n.translate('xpack.canvas.functions.revealImage.args.imageHelpText', {
defaultMessage: 'The image to reveal',
defaultMessage:
'The image to reveal. Provide an image asset as a {BASE64} data {URL}, ' +
'or pass in a sub-expression.',
values: {
BASE64,
URL,
},
}),
emptyImage: i18n.translate('xpack.canvas.functions.revealImage.args.emptyImageHelpText', {
defaultMessage: 'An optional background image to reveal over',
defaultMessage:
'An optional background image to reveal over. ' +
'Provide an image asset as a `{BASE64}` data {URL}, or pass in a sub-expression.',
values: {
BASE64,
URL,
},
}),
origin: i18n.translate('xpack.canvas.functions.revealImage.args.originHelpText', {
defaultMessage: 'Where to start from, eg {position}',
defaultMessage: 'The position to start the image fill. For example, {list}, or {end}.',
values: {
position: Object.values(Position).join(', '),
list: Object.values(Position)
.slice(0, -1)
.map(position => `\`"${position}"\``)
.join(', '),
end: Object.values(Position).slice(-1)[0],
},
}),
},

12
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/rounddate.ts
View file

@ -8,24 +8,24 @@ import { i18n } from '@kbn/i18n';
import { rounddate } from '../../functions/common/rounddate';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { MOMENTJS } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof rounddate>> = {
help: i18n.translate('xpack.canvas.functions.rounddateHelpText', {
defaultMessage:
'Round {ms} since epoch using a {moment} formatting string. Returns {ms} since epoch',
'Uses a {MOMENTJS} formatting string to round milliseconds since epoch, and returns milliseconds since epoch.',
values: {
ms: 'ms',
moment: 'MomentJS',
MOMENTJS,
},
}),
args: {
format: i18n.translate('xpack.canvas.functions.rounddate.args.formatHelpText', {
defaultMessage:
'{moment} format with which to bucket (See {url}). For example "{example}" would round to the month',
'The {MOMENTJS} format to use for bucketing. For example, {example} would round each date to months. See {url}.',
values: {
moment: 'MomentJS',
example: '`"YYYY-MM"`',
MOMENTJS,
url: 'https://momentjs.com/docs/#/displaying/',
example: 'YYYY-MM',
},
}),
},

4
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/rowCount.ts
View file

@ -12,10 +12,10 @@ import { FunctionFactory } from '../../../types';
export const help: FunctionHelp<FunctionFactory<typeof rowCount>> = {
help: i18n.translate('xpack.canvas.functions.rowCountHelpText', {
defaultMessage:
'Return the number of rows. Pair with {ply} to get the count of unique column ' +
'Returns the number of rows. Pair with {plyFn} to get the count of unique column ' +
'values, or combinations of unique column values.',
values: {
ply: 'ply',
plyFn: '`ply`',
},
}),
args: {},

47
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/seriesStyle.ts
View file

@ -13,39 +13,42 @@ export const help: FunctionHelp<FunctionFactory<typeof seriesStyle>> = {
help: i18n.translate('xpack.canvas.functions.seriesStyleHelpText', {
defaultMessage:
'Creates an object used for describing the properties of a series on a chart. ' +
'You would usually use this inside of a charting function',
'Use {seriesStyleFn} inside of a charting function, like {plotFn} or {pieFn}.',
values: {
seriesStyleFn: '`seriesStyle`',
pieFn: '`pie`',
plotFn: '`plot`',
},
}),
args: {
label: i18n.translate('xpack.canvas.functions.seriesStyle.args.labelHelpText', {
defaultMessage:
'The label of the line this style applies to, not the name you would like to ' +
'give the line',
bars: i18n.translate('xpack.canvas.functions.seriesStyle.args.barsHelpText', {
defaultMessage: 'The width of bars.',
}),
color: i18n.translate('xpack.canvas.functions.seriesStyle.args.colorHelpText', {
defaultMessage: 'Color to assign the line',
}),
lines: i18n.translate('xpack.canvas.functions.seriesStyle.args.linesHelpText', {
defaultMessage: 'Width of the line',
}),
bars: i18n.translate('xpack.canvas.functions.seriesStyle.args.barsHelpText', {
defaultMessage: 'Width of bars',
}),
points: i18n.translate('xpack.canvas.functions.seriesStyle.args.pointsHelpText', {
defaultMessage: 'Size of points on line',
defaultMessage: 'The line color.',
}),
fill: i18n.translate('xpack.canvas.functions.seriesStyle.args.fillHelpText', {
defaultMessage: 'Should we fill points?',
}),
stack: i18n.translate('xpack.canvas.functions.seriesStyle.args.stackHelpText', {
defaultMessage:
'Should we stack the series? This is the stack "id". Series with the same ' +
'stack id will be stacked together',
defaultMessage: 'Should we fill in the points?',
}),
horizontalBars: i18n.translate(
'xpack.canvas.functions.seriesStyle.args.horizontalBarsHelpText',
{
defaultMessage: 'Sets the orientation of bars in the chart to horizontal',
defaultMessage: 'Sets the orientation of the bars in the chart to horizontal.',
}
),
label: i18n.translate('xpack.canvas.functions.seriesStyle.args.labelHelpText', {
defaultMessage: 'The name of the series to style.',
}),
lines: i18n.translate('xpack.canvas.functions.seriesStyle.args.linesHelpText', {
defaultMessage: 'The width of the line.',
}),
points: i18n.translate('xpack.canvas.functions.seriesStyle.args.pointsHelpText', {
defaultMessage: 'Size of points on line',
}),
stack: i18n.translate('xpack.canvas.functions.seriesStyle.args.stackHelpText', {
defaultMessage:
'Specifies if the series should be stacked. The number is the stack ID. ' +
'Series with the same stack ID are stacked together.',
}),
},
};

21
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/shape.ts
View file

@ -8,32 +8,33 @@ import { i18n } from '@kbn/i18n';
import { shape } from '../../functions/common/shape';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { SVG } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof shape>> = {
help: i18n.translate('xpack.canvas.functions.shapeHelpText', {
defaultMessage: 'Create a shape',
defaultMessage: 'Create a shape.',
}),
args: {
shape: i18n.translate('xpack.canvas.functions.shape.args.shapeHelpText', {
defaultMessage: 'Pick a shape.',
}),
border: i18n.translate('xpack.canvas.functions.shape.args.borderHelpText', {
defaultMessage: 'Valid {css} color string',
defaultMessage: 'An {SVG} color for the border outlining the shape.',
values: {
css: 'CSS',
SVG,
},
}),
borderWidth: i18n.translate('xpack.canvas.functions.shape.args.borderWidthHelpText', {
defaultMessage: 'Thickness of the border',
}),
shape: i18n.translate('xpack.canvas.functions.shape.args.shapeHelpText', {
defaultMessage: 'Pick a shape',
defaultMessage: 'The thickness of the border.',
}),
fill: i18n.translate('xpack.canvas.functions.shape.args.fillHelpText', {
defaultMessage: 'Valid {css} color string',
defaultMessage: 'An {SVG} color to fill the shape.',
values: {
css: 'CSS',
SVG,
},
}),
maintainAspect: i18n.translate('xpack.canvas.functions.shape.args.maintainAspectHelpText', {
defaultMessage: 'Select true to maintain aspect ratio',
defaultMessage: `Maintain the shape's original aspect ratio?`,
}),
},
};

15
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/sort.ts
View file

@ -8,26 +8,27 @@ import { i18n } from '@kbn/i18n';
import { sort } from '../../functions/common/sort';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { DATATABLE } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof sort>> = {
help: i18n.translate('xpack.canvas.functions.sortHelpText', {
defaultMessage: 'Sorts a datatable on a column',
defaultMessage: 'Sorts a datatable by the specified column.',
}),
args: {
by: i18n.translate('xpack.canvas.functions.sort.args.byHelpText', {
defaultMessage:
'The column to sort on. If column is not specified, the {datatable} ' +
'will be sorted on the first column.',
'The column to sort by. When unspecified, the `{DATATABLE}` ' +
'is sorted by the first column.',
values: {
datatable: 'datatable',
DATATABLE,
},
}),
reverse: i18n.translate('xpack.canvas.functions.sort.args.reverseHelpText', {
defaultMessage:
'Reverse the sort order. If reverse is not specified, the {datatable} ' +
'will be sorted in ascending order.',
'Reverses the sorting order. When unspecified, the `{DATATABLE}` ' +
'is sorted in ascending order.',
values: {
datatable: 'datatable',
DATATABLE,
},
}),
},

13
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/staticColumn.ts
View file

@ -11,16 +11,21 @@ import { FunctionFactory } from '../../../types';
export const help: FunctionHelp<FunctionFactory<typeof staticColumn>> = {
help: i18n.translate('xpack.canvas.functions.staticColumnHelpText', {
defaultMessage: 'Add a column with a static value',
defaultMessage:
'Add a column with the same static value in every row. See also {alterColumnFn} and {mapColumnFn}.',
values: {
alterColumnFn: '`alterColumn`',
mapColumnFn: '`mapColumn`',
},
}),
args: {
name: i18n.translate('xpack.canvas.functions.staticColumn.args.nameHelpText', {
defaultMessage: 'The name of the new column column',
defaultMessage: 'The name of the new column column.',
}),
value: i18n.translate('xpack.canvas.functions.staticColumn.args.valueHelpText', {
defaultMessage:
'The value to insert in each column. Tip: use a sub-expression to rollup ' +
'other columns into a static value',
'The value to insert in each row in the new column. Tip: use a sub-expression to rollup ' +
'other columns into a static value.',
}),
},
};

7
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/string.ts
View file

@ -11,14 +11,11 @@ import { FunctionFactory } from '../../../types';
export const help: FunctionHelp<FunctionFactory<typeof string>> = {
help: i18n.translate('xpack.canvas.functions.stringHelpText', {
defaultMessage:
'Output a string made of other strings. Mostly useful when combined with ' +
'sub-expressions that output a string, or something castable to a string',
defaultMessage: 'Concatenates all of the arguments into a single string.',
}),
args: {
value: i18n.translate('xpack.canvas.functions.string.args.valueHelpText', {
defaultMessage:
"One or more strings to join together. Don't forget spaces " + 'where needed!',
defaultMessage: 'The values to join together into one string. Include spaces where needed.',
}),
},
};

19
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/switch.ts
View file

@ -8,17 +8,30 @@ import { i18n } from '@kbn/i18n';
import { switchFn } from '../../functions/common/switch';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { CONTEXT } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof switchFn>> = {
help: i18n.translate('xpack.canvas.functions.switchHelpText', {
defaultMessage: 'Perform conditional logic with multiple conditions',
defaultMessage:
'Performs conditional logic with multiple conditions. ' +
'See also {caseFn} which builds a {case} to pass to the {switchFn} function.',
values: {
case: '`case`',
caseFn: '`case`',
switchFn: '`switch`',
},
}),
args: {
case: i18n.translate('xpack.canvas.functions.switch.args.caseHelpText', {
defaultMessage: 'The list of conditions to check',
defaultMessage: 'The conditions to check',
}),
default: i18n.translate('xpack.canvas.functions.switch.args.defaultHelpText', {
defaultMessage: 'The default case if no cases match',
defaultMessage:
'The value returned when no conditions are met. ' +
'When unspecified and no conditions are met, the original {CONTEXT} is returned.',
values: {
CONTEXT,
},
}),
},
};

24
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/table.ts
View file

@ -8,28 +8,34 @@ import { i18n } from '@kbn/i18n';
import { table } from '../../functions/common/table';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { CSS, FONT_FAMILY, FONT_WEIGHT, BOOLEAN_FALSE } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof table>> = {
help: i18n.translate('xpack.canvas.functions.tableHelpText', {
defaultMessage: 'Configure a {datatable} element',
values: {
datatable: 'datatable',
},
defaultMessage: 'Configures a table element',
}),
args: {
font: i18n.translate('xpack.canvas.functions.table.args.fontHelpText', {
defaultMessage: 'Font style',
defaultMessage:
'The {CSS} font properties for the contents of the table. For example, {FONT_FAMILY} or {FONT_WEIGHT}.',
values: {
CSS,
FONT_FAMILY,
FONT_WEIGHT,
},
}),
paginate: i18n.translate('xpack.canvas.functions.table.args.paginateHelpText', {
defaultMessage:
'Show pagination controls. If set to false only the first page will be displayed',
'Show pagination controls? When {BOOLEAN_FALSE}, only the first page is displayed.',
values: {
BOOLEAN_FALSE,
},
}),
perPage: i18n.translate('xpack.canvas.functions.table.args.perPageHelpText', {
defaultMessage:
'Show this many rows per page. You probably want to raise this is disabling pagination',
defaultMessage: 'The number of rows to display on each page.',
}),
showHeader: i18n.translate('xpack.canvas.functions.table.args.showHeaderHelpText', {
defaultMessage: 'Show or hide the header row with titles for each column',
defaultMessage: 'Show/hide the header row with titles for each column.',
}),
},
};

11
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/tail.ts
View file

@ -8,20 +8,21 @@ import { i18n } from '@kbn/i18n';
import { tail } from '../../functions/common/tail';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { DATATABLE } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof tail>> = {
help: i18n.translate('xpack.canvas.functions.tailHelpText', {
defaultMessage: 'Get the last N rows from the end of a {datatable}. Also see `{head}`',
defaultMessage: 'Retrieves the last N rows from the end of a {DATATABLE}. See also {headFn}.',
values: {
datatable: 'datatable',
head: 'head',
DATATABLE,
headFn: '`head`',
},
}),
args: {
count: i18n.translate('xpack.canvas.functions.tail.args.countHelpText', {
defaultMessage: 'Return this many rows from the end of the {datatable}',
defaultMessage: 'The number of rows to retrieve from the end of the {DATATABLE}.',
values: {
datatable: 'datatable',
DATATABLE,
},
}),
},

29
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/timefilter.ts
View file

@ -8,36 +8,35 @@ import { i18n } from '@kbn/i18n';
import { timefilter } from '../../functions/common/timefilter';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { ISO8601, ELASTICSEARCH, DATEMATH } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof timefilter>> = {
help: i18n.translate('xpack.canvas.functions.timefilterHelpText', {
defaultMessage: 'Create a {timefilter} for querying a source',
values: {
timefilter: 'timefilter',
},
defaultMessage: 'Create a time filter for querying a source.',
}),
args: {
column: i18n.translate('xpack.canvas.functions.timefilter.args.columnHelpText', {
defaultMessage: 'The column or field to attach the filter to',
defaultMessage: 'The column or field that you want to filter.',
}),
from: i18n.translate('xpack.canvas.functions.timefilter.args.fromHelpText', {
defaultMessage: 'Beginning of the range, in {iso} or {es} {dm} format',
defaultMessage:
'The beginning of the range, in {ISO8601} or {ELASTICSEARCH} {DATEMATH} format',
values: {
iso: 'ISO8601',
es: 'Elasticsearch',
dm: 'datemath',
DATEMATH,
ELASTICSEARCH,
ISO8601,
},
}),
to: i18n.translate('xpack.canvas.functions.timefilter.args.toHelpText', {
defaultMessage: 'End of the range, in {iso} or {es} {dm} format',
defaultMessage: 'The end of the range, in {ISO8601} or {ELASTICSEARCH} {DATEMATH} format',
values: {
iso: 'ISO8601',
es: 'Elasticsearch',
dm: 'datemath',
DATEMATH,
ELASTICSEARCH,
ISO8601,
},
}),
filterGroup: i18n.translate('xpack.canvas.functions.dropdownControl.args.filterGroupHelpText', {
defaultMessage: 'Group name for the filter',
filterGroup: i18n.translate('xpack.canvas.functions.timefilter.args.filterGroupHelpText', {
defaultMessage: 'The group name for the filter.',
}),
},
};

11
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/timefilterControl.ts
View file

@ -11,20 +11,17 @@ import { FunctionFactory } from '../../../types';
export const help: FunctionHelp<FunctionFactory<typeof timefilterControl>> = {
help: i18n.translate('xpack.canvas.functions.timefilterControlHelpText', {
defaultMessage: 'Configure a {timefilter} control element',
values: {
timefilter: 'timefilter',
},
defaultMessage: 'Configures a time filter control element.',
}),
args: {
column: i18n.translate('xpack.canvas.functions.timefilterControl.args.columnHelpText', {
defaultMessage: 'The column or field to attach the filter to',
defaultMessage: 'The column or field that you want to filter.',
}),
compact: i18n.translate('xpack.canvas.functions.timefilterControl.args.compactHelpText', {
defaultMessage: 'Show the time filter as a button that triggers a popover',
defaultMessage: 'Shows the time filter as a button, which triggers a popover.',
}),
filterGroup: i18n.translate('xpack.canvas.functions.dropdownControl.args.filterGroupHelpText', {
defaultMessage: 'Group name for the filter',
defaultMessage: 'The group name for the filter.',
}),
},
};

19
x-pack/legacy/plugins/canvas/canvas_plugin_src/strings/functions/urlparam.ts
View file

@ -8,27 +8,34 @@ import { i18n } from '@kbn/i18n';
import { urlparam } from '../../functions/browser/urlparam';
import { FunctionHelp } from '.';
import { FunctionFactory } from '../../../types';
import { TYPE_STRING, URL } from '../constants';
export const help: FunctionHelp<FunctionFactory<typeof urlparam>> = {
help: i18n.translate('xpack.canvas.functions.urlparamHelpText', {
defaultMessage:
'Access {url} parameters and use them in expressions. Eg {example}. This will always return a string',
'Retreives a {URL} parameter to use in an expression. ' +
'The {urlparamFn} function always returns a {TYPE_STRING}. ' +
'For example, you can retrieve the value {value} from the parameter {myVar} from the {URL} {example}).',
values: {
url: 'URL',
example: 'https://localhost:5601/app/canvas?myVar=20',
myVar: '`myVar`',
TYPE_STRING,
URL,
urlparamFn: '`urlparam`',
value: '`"20"`',
},
}),
args: {
param: i18n.translate('xpack.canvas.functions.urlparam.args.paramHelpText', {
defaultMessage: 'The {url} hash parameter to access',
defaultMessage: 'The {URL} hash parameter to retrieve.',
values: {
url: 'URL',
URL,
},
}),
default: i18n.translate('xpack.canvas.functions.urlparam.args.defaultHelpText', {
defaultMessage: 'Return this string if the {url} parameter is not defined',
defaultMessage: 'The string returned when the {URL} parameter is unspecified.',
values: {
url: 'url',
URL,
},
}),
},

1
x-pack/legacy/plugins/canvas/common/lib/constants.ts
View file

@ -32,3 +32,4 @@ export const MIN_ZOOM_LEVEL = ZOOM_LEVELS[0];
export const MAX_ZOOM_LEVEL = ZOOM_LEVELS[ZOOM_LEVELS.length - 1];
export const WORKPAD_CANVAS_BUFFER = 32; // 32px padding around the workpad
export const CANVAS_LAYOUT_STAGE_CONTENT_SELECTOR = `canvasLayout__stageContent`;
export const DATATABLE_COLUMN_TYPES = ['string', 'number', 'null', 'boolean', 'date'];

7
x-pack/legacy/plugins/canvas/public/functions/asset.js
View file

@ -10,17 +10,16 @@ import { getAssetById } from '../state/selectors/assets';
export const asset = () => ({
name: 'asset',
aliases: [],
type: 'string',
help: 'Retrieves Canvas workpad asset objects to provide as argument values. Usually images.',
context: {
types: ['null'],
},
type: 'string',
help: 'Use Canvas workpad asset objects to provide argument values. Usually images',
args: {
id: {
aliases: ['_'],
types: ['string'],
help: 'The ID of the asset value to return',
multi: false,
help: 'The ID of the asset to retrieve.',
required: true,
},
},

6
x-pack/legacy/plugins/canvas/public/functions/filters.js
View file

@ -35,6 +35,7 @@ function getFiltersByGroup(filters, groups = [], ungrouped = false) {
export const filters = () => ({
name: 'filters',
type: 'filter',
help: 'Aggregates element filters from the workpad for use elsewhere, usually a data source.',
context: {
types: ['null'],
},
@ -42,17 +43,16 @@ export const filters = () => ({
group: {
aliases: ['_'],
types: ['string'],
help: 'The name of the filter group to use',
help: 'The name of the filter group to use.',
multi: true,
},
ungrouped: {
aliases: ['nogroup', 'nogroups'],
types: ['boolean'],
help: "Don't include filters that belong to groups",
help: 'Exclude filters that belong to a filter group?',
default: false,
},
},
help: 'Collect element filters on the workpad, usually to provide them to a data source',
fn: (_, { group, ungrouped }) => {
const filterList = getFiltersByGroup(getGlobalFilters(getState()), group, ungrouped);

15
x-pack/legacy/plugins/canvas/public/functions/timelion.js
View file

@ -11,6 +11,8 @@ import { buildBoolArray } from '../../server/lib/build_bool_array';
export const timelion = () => ({
name: 'timelion',
type: 'datatable',
help: 'Use Timelion to extract one or more timeseries from many sources.',
context: {
types: ['filter'],
},
@ -18,32 +20,31 @@ export const timelion = () => ({
query: {
types: ['string'],
aliases: ['_', 'q'],
help: 'A timelion query',
help: 'A Timelion query',
default: '".es(*)"',
},
interval: {
types: ['string'],
help: 'Bucket interval for the time series',
help: 'The bucket interval for the time series.',
default: 'auto',
},
from: {
type: ['string'],
help: 'Elasticsearch date math string for the start of the time range',
help: 'The Elasticsearch `datemath` string for the beginning of the time range.',
default: 'now-1y',
},
to: {
type: ['string'],
help: 'Elasticsearch date math string for the end of the time range',
help: 'The Elasticsearch `datemath` string for the end of the time range.',
default: 'now',
},
timezone: {
type: ['string'],
help: 'Timezone for the time range',
help:
'The timezone for the time range. See [Moment Timezone](https://momentjs.com/timezone/).',
default: 'UTC',
},
},
type: 'datatable',
help: 'Use timelion to extract one or more timeseries from many sources',
fn: (context, args) => {
// Timelion requires a time range. Use the time range from the timefilter element in the
// workpad, if it exists. Otherwise fall back on the function args.

2
x-pack/legacy/plugins/canvas/public/functions/to.js
View file

@ -10,7 +10,7 @@ import { registries } from 'plugins/interpreter/registries';
export const to = () => ({
name: 'to',
aliases: [],
help: 'Explicitly cast from one type to another',
help: 'Explicitly casts the type of the _context_ to the specified type.',
context: {},
args: {
type: {

136
x-pack/plugins/translations/translations/ja-JP.json
View file

@ -4255,174 +4255,81 @@
"xpack.canvas.elements.verticalProgressBarHelpText": "進捗状況を垂直のバーで表示します",
"xpack.canvas.elements.verticalProgressPillDisplayName": "垂直プログレスピル",
"xpack.canvas.elements.verticalProgressPillHelpText": "進捗状況を垂直のピルで表示します",
"xpack.canvas.functions.all.args.conditionHelpText": "確認する 1 つまたは複数の条件です",
"xpack.canvas.functions.allHelpText": "すべての条件が true の場合、true を返します",
"xpack.canvas.functions.alterColumn.args.columnHelpText": "変更する列の名前です",
"xpack.canvas.functions.alterColumn.args.nameHelpText": "変更後の列名です。名前を変更しない場合は未入力のままにします",
"xpack.canvas.functions.alterColumn.args.typeHelpText": "列の変換語のタイプです。タイプを変更しない場合は未入力のままにします",
"xpack.canvas.functions.alterColumn.cannotConvertTypeErrorMessage": "「{type}」に変換できません",
"xpack.canvas.functions.alterColumn.columnNotFoundErrorMessage": "列が見つかりません: 「{column}」",
"xpack.canvas.functions.alterColumnHelpText": "コアタイプ (例: {examples}) を変換し、列名を変更します",
"xpack.canvas.functions.any.args.conditionHelpText": "確認する 1 つまたは複数の条件です",
"xpack.canvas.functions.anyHelpText": "いずれかの条件が true の場合、true を返します",
"xpack.canvas.functions.as.args.nameHelpText": "列に付ける名前です",
"xpack.canvas.functions.asHelpText": "確認する 1 つまたは複数の条件です",
"xpack.canvas.functions.axisConfig.args.maxHelpText": "軸に表示する最高値です。{ms} または {iso} 文字列の数字または日付でなければなりません",
"xpack.canvas.functions.axisConfig.args.minHelpText": "軸に表示する最低値です。{ms} または {iso} 文字列の数字または日付でなければなりません",
"xpack.canvas.functions.axisConfig.args.positionHelpText": "軸ラベルの配置: {examples}",
"xpack.canvas.functions.axisConfig.args.showHelpText": "軸ラベルを表示しますか？",
"xpack.canvas.functions.axisConfig.args.tickSizeHelpText": "目盛り間の増加量。数字軸のみで使用されます",
"xpack.canvas.functions.axisConfig.invalidMaxPositionErrorMessage": "無効なデータ文字列: 「{max}」。「max」は数字、ms での日付、または ISO8601 データ文字列出なければなりません",
"xpack.canvas.functions.axisConfig.invalidMinDateStringErrorMessage": "無効なデータ文字列: 「{min}」。「min」は数字、ms での日付、または ISO8601 データ文字列出なければなりません",
"xpack.canvas.functions.axisConfig.invalidPositionErrorMessage": "無効なポジション: 「{position}」",
"xpack.canvas.functions.axisConfigHelpText": "ビジュアライゼーションの軸を構成します",
"xpack.canvas.functions.case.args.ifHelpText": "この値は条件が満たされたかどうかに使用されます。両方が入力されている場合、無名の引数を上書きします。",
"xpack.canvas.functions.case.args.thenHelpText": "条件が満たされた際に戻る値です",
"xpack.canvas.functions.case.args.whenHelpText": "この値は、条件が満たされているかどうか確認するために、コンテキストと比較されます。両方が入力されている場合、「{if}」引数で上書きされます。",
"xpack.canvas.functions.caseHelpText": "{switch} 関数に渡すケース (条件/結果を含む) を作成します",
"xpack.canvas.functions.clearHelpText": "コンテキストを消去して 0 戻します",
"xpack.canvas.functions.columns.args.excludeHelpText": "コンマ区切りの表から削除する列名のリストです",
"xpack.canvas.functions.columns.args.includeHelpText": "コンマ区切りの表に残す列名のリストです",
"xpack.canvas.functions.columnsHelpText": "データ表の列を含む、または除外します。両方指定した場合、まずこれが除外されます",
"xpack.canvas.functions.compare.args.opHelpText": "比較で使用する演算子です: {eq} (equal to)、{gt} (greater than)、{gte} (greater than or equal to)、{lt} (less than)、{lte} (less than or equal to)、{ne} または {neq} (not equal to)",
"xpack.canvas.functions.compare.args.toHelpText": "コンテキストを比較する値です。通常部分式によって返されます",
"xpack.canvas.functions.compare.invalidCompareOperatorErrorMessage": "無効な比較演算子: 「{op}」。{ops} を使用してください",
"xpack.canvas.functions.compareHelpText": "インプットを他と比較して true または false を判断します。通常「{if}」と組み合わせて使用されます。{examples} などの基本タイプにのみ使用できます。",
"xpack.canvas.functions.containerStyle.args.backgroundColorHelpText": "有効な {css} 背景色文字列",
"xpack.canvas.functions.containerStyle.args.backgroundImageHelpText": "有効な {css} 背景画像文字列",
"xpack.canvas.functions.containerStyle.args.backgroundRepeatHelpText": "有効な {css} 背景繰り返し文字列",
"xpack.canvas.functions.containerStyle.args.backgroundSizeHelpText": "有効な {css} 背景サイズ文字列",
"xpack.canvas.functions.containerStyle.args.borderHelpText": "有効な {css} 境界文字列",
"xpack.canvas.functions.containerStyle.args.borderRadiusHelpText": "境界を丸くする際に使用されるピクセル数です",
"xpack.canvas.functions.containerStyle.args.opacityHelpText": "0 から 1 までの数字で、エレメントの透明度を示します",
"xpack.canvas.functions.containerStyle.args.overflowHelpText": "コンテナーのオーバーフローを設定します",
"xpack.canvas.functions.containerStyle.args.paddingHelpText": "ピクセル単位のコンテンツの境界からの距離です",
"xpack.canvas.functions.containerStyle.invalidBackgroundImageErrorMessage": "無効な背景画像。アセットまたは URL を入力してください。",
"xpack.canvas.functions.containerStyleHelpText": "チャートの数列のプロパティの説明に使用されるオブジェクトを作成します。通常はチャート作成機能で使用します",
"xpack.canvas.functions.contextHelpText": "渡したものをすべて返します。これは、コンテキストを部分式として関数の引数として使用する際に有効です。",
"xpack.canvas.functions.csv.args.dataHelpText": "使用する {csv} データです",
"xpack.canvas.functions.csv.args.delimeterHelpText": "データの区切り文字",
"xpack.canvas.functions.csv.args.newlineHelpText": "行の区切り文字",
"xpack.canvas.functions.csv.invalidInputCSVErrorMessage": "インプット CSV の解析中にエラーが発生しました。",
"xpack.canvas.functions.csvHelpText": "{csv} インプットからデータ表を作成します",
"xpack.canvas.functions.date.args.formatHelpText": "オプションの日付文字列を解析するための {moment} フォーマットです ({url} を参照)",
"xpack.canvas.functions.date.args.valueHelpText": "新紀元からのミリ秒に解析するオプションの日付文字列有効な Javascript 日付インプット、またはフォーマット引数を使用して解析する文字列のどちらかが使用できます。{iso} 文字列を使用するか、フォーマットを提供する必要があります",
"xpack.canvas.functions.date.invalidDateInputErrorMessage": "無効な日付インプット: {date}",
"xpack.canvas.functions.dateHelpText": "現在時刻、または文字列から解析された時刻を新紀元からのミリ秒で返します",
"xpack.canvas.functions.demodata.args.typeHelpText": "使用するデモデータセットの名前です",
"xpack.canvas.functions.demodata.invalidDataSetErrorMessage": "無効なデータセット: 「{arg}」。「{ci}」または「{shirts}」を使用してください",
"xpack.canvas.functions.demodataHelpText": "プロジェクト {ci} の回数ととユーザー名、国、実行フェーズを含むデ模擬データセットです",
"xpack.canvas.functions.do.args.fnHelpText": "1 つまたは複数の部分式です。この関数は渡されたコンテキストを返すだけのため、これらの値はルートパイプラインで利用できません",
"xpack.canvas.functions.doHelpText": "複数部分式を実行します。渡されたコンテキストを返します。関数を生成するアクションの実行に有効です。",
"xpack.canvas.functions.dropdownControl.args.filterColumnHelpText": "フィルターを添付する列またはフィールドです",
"xpack.canvas.functions.dropdownControl.args.filterGroupHelpText": "フィルターのグループ名です",
"xpack.canvas.functions.dropdownControl.args.valueColumnHelpText": "ドロップダウンの固有値を抽出する元のデータ表です",
"xpack.canvas.functions.dropdownControlHelpText": "ドロップダウンフィルターのコントロールエレメントを構成します",
"xpack.canvas.functions.eq.args.valueHelpText": "コンテキストの比較対象となる値です",
"xpack.canvas.functions.eqHelpText": "コンテキストが引数と同じ場合に返します",
"xpack.canvas.functions.escount.args.indexHelpText": "インデックスパターンを指定します例: 「{example}」",
"xpack.canvas.functions.escount.args.queryHelpText": "{lucene} クエリ文字列",
"xpack.canvas.functions.escountHelpText": "{es} にクエリを実行してクエリに一致するヒット数を求めます",
"xpack.canvas.functions.esdocs.args.countHelpText": "引き戻すドキュメント数です。値が小さいほどパフォーマンスが向上します",
"xpack.canvas.functions.esdocs.args.fieldsHelpText": "フィールドのコンマ区切りのリストです。フィールドが少ないほどパフォーマンスが向上します",
"xpack.canvas.functions.esdocs.args.indexHelpText": "インデックスパターンを指定します例: 「{example}」",
"xpack.canvas.functions.esdocs.args.metaFieldsHelpText": "メタフィールドのコンマ区切りのリストです。例: 「{example}」",
"xpack.canvas.functions.esdocs.args.queryHelpText": "{lucene} クエリ文字列です",
"xpack.canvas.functions.esdocs.args.sortHelpText": "方向を「{directions}」として分類します。例: 「{example1}」または「{example2}」",
"xpack.canvas.functions.esdocsHelpText": "{es} にクエリを実行して生ドキュメントを取得します。特に多くの行を必要とする場合、希望のフィールドを指定することをお勧めします",
"xpack.canvas.functions.essql.args.countHelpText": "引き戻すドキュメント数です。値が小さいほどパフォーマンスが向上します",
"xpack.canvas.functions.essql.args.queryHelpText": "{sql} クエリ",
"xpack.canvas.functions.essql.args.timezoneHelpText": "日付演算に使用するタイムゾーンです。有効な {iso} フォーマットと {utc} オフセットの両方が使用できます",
"xpack.canvas.functions.essqlHelpText": "{essql}",
"xpack.canvas.functions.exactly.args.columnHelpText": "フィルターを添付する列またはフィールドです",
"xpack.canvas.functions.exactly.args.valueHelpText": "ホワイトスペースと大文字・小文字を含め、正確に一致させる値です",
"xpack.canvas.functions.exactlyHelpText": "特定の列をピッタリと正確な値に一致させるフィルターを作成します",
"xpack.canvas.functions.filterrows.args.fnHelpText": "データ表の各行を渡す表現です。この表現はブールを返します。行は値が true の場合残り、false の場合削除されます。",
"xpack.canvas.functions.filterrowsHelpText": "データ表の行を部分式から返された値に基づきフィルタリングします。",
"xpack.canvas.functions.formatdate.args.formatHelpText": "{moment} バケットするフォーマットです ({url} を参照)",
"xpack.canvas.functions.formatdateHelpText": "{moment} を使用して有効な日付文字列または新紀元以降の {ms} の数をフォーマットします ({url} を参照)",
"xpack.canvas.functions.formatnumber.args.formatHelpText": "{numeralJS} 文字列のフォーマットです {url}",
"xpack.canvas.functions.formatnumberHelpText": "{numeralJS} フォーマットで数字を文字列に変換します",
"xpack.canvas.functions.getCell.args.columnHelpText": "取得する列の名前です",
"xpack.canvas.functions.getCell.args.rowHelpText": "列番号で、0 から開始します",
"xpack.canvas.functions.getCell.columnNotFoundErrorMessage": "列が見つかりません: 「{column}」",
"xpack.canvas.functions.getCell.rowNotFoundErrorMessage": "行が見つかりません: 「{row}」",
"xpack.canvas.functions.getCellHelpText": "表から単一のセルを取得します",
"xpack.canvas.functions.gt.args.valueHelpText": "コンテキストの比較対象となる値です",
"xpack.canvas.functions.gte.args.valueHelpText": "コンテキストの比較対象となる値です",
"xpack.canvas.functions.gteHelpText": "コンテキストが引数以上の場合に返します",
"xpack.canvas.functions.gtHelpText": "コンテキストが引数より大きい場合に返します",
"xpack.canvas.functions.head.args.countHelpText": "{datatable} の始めからこの数の列を返します",
"xpack.canvas.functions.headHelpText": "{datatable} から初めの {n} 列を取得します。「{tail}」も参照",
"xpack.canvas.functions.if.args.conditionHelpText": "ブールが true かfalse か、通常部分式により返されます。この値が入力されていない場合は、インプットコンテキストが使用されます",
"xpack.canvas.functions.if.args.elseHelpText": "False の場合の戻り値です。他が指定されておらず、条件が false の場合、関数のインプットコンテキストが返されます",
"xpack.canvas.functions.if.args.thenHelpText": "True の場合の戻り値です。",
"xpack.canvas.functions.ifHelpText": "条件付きロジックを実行します",
"xpack.canvas.functions.image.args.dataurlHelpText": "画像の HTTP(S) URL または base64 データです。",
"xpack.canvas.functions.image.args.modeHelpText": "「{contain}」はサイズに合わせて拡大・縮小して画像全体を表示し「{cover}」はコンテナーを画像で埋め、必要に応じて両端や下をクロップします。「{stretch}」は画像の高さと幅をコンテナーの 100% になるよう変更します",
"xpack.canvas.functions.image.args.modeHelpText": "{contain}はサイズに合わせて拡大・縮小して画像全体を表示し{cover}はコンテナーを画像で埋め、必要に応じて両端や下をクロップします。{stretch}は画像の高さと幅をコンテナーの 100% になるよう変更します",
"xpack.canvas.functions.image.invalidImageModeErrorMessage": "「mode」は「{contain}」、「{cover}」、または「{stretch}」でなければなりません",
"xpack.canvas.functions.imageHelpText": "画像を表示します",
"xpack.canvas.functions.locationHelpText": "ブラウザの位置情報機能を使用して現在位置を把握します。通常非常に遅いですが、比較的正確です",
"xpack.canvas.functions.lt.args.valueHelpText": "コンテキストの比較対象となる値です",
"xpack.canvas.functions.lte.args.valueHelpText": "コンテキストの比較対象となる値です",
"xpack.canvas.functions.lteHelpText": "コンテキストが引数以下の場合に返します",
"xpack.canvas.functions.ltHelpText": "コンテキストが引数より小きい場合に返します",
"xpack.canvas.functions.mapColumn.args.expressionHelpText": "各行が単一の行として渡されるキャンバス表現です {datatable}",
"xpack.canvas.functions.mapColumn.args.nameHelpText": "結果の列の名前です",
"xpack.canvas.functions.mapColumnHelpText": "他の列の結果として計算された列を追加するかしないかです",
"xpack.canvas.functions.markdown.args.contentHelpText": "{markdown} 表現です。複数回渡して連結させることができます",
"xpack.canvas.functions.markdown.args.fontHelpText": "フォント設定です。厳密に言えば、ここに他のスタイルを追加することもできます",
"xpack.canvas.functions.markdownHelpText": "{markdown} テキストのレンダリングのエレメントです。単一の数字、メトリック、テキストの段落に有効です。",
"xpack.canvas.functions.math.args.expressionHelpText": "評価された {tinymath} 表現です。({url} を参照)",
"xpack.canvas.functions.math.emptyDatatableErrorMessage": "空のデータベース",
"xpack.canvas.functions.math.emptyExpressionErrorMessage": "空の表現",
"xpack.canvas.functions.math.executionFailedErrorMessage": "数式の実行に失敗しました。列名を確認してください",
"xpack.canvas.functions.math.tooManyResultsErrorMessage": "表現は 1 つの数字を返す必要があります。表現を {mean} または {sum} で囲んでみてください",
"xpack.canvas.functions.mathHelpText": "数字または {datatable} をコンテキストとして数式を解釈します。{Datatable} の列は列名で利用できます。数字を渡した場合、「{value}」として利用可能になります (括弧ぬき)",
"xpack.canvas.functions.metric.args.labelFontHelpText": "ラベルのフォント設定です。厳密に言えば、ここに他のスタイルを追加することもできます！",
"xpack.canvas.functions.metric.args.labelHelpText": "メトリックを説明するテキストです",
"xpack.canvas.functions.metric.args.metricFontHelpText": "メトリックのフォント設定です。厳密に言えば、ここに他のスタイルを追加することもできます！",
"xpack.canvas.functions.metricHelpText": "ラベル付きの数字です",
"xpack.canvas.functions.neq.args.valueHelpText": "コンテキストの比較対象となる値です",
"xpack.canvas.functions.neqHelpText": "コンテキストが引数と同じでない場合に返します",
"xpack.canvas.functions.palette.args.colorHelpText": "パレットからー、{rgba}、{hex}、または {html} のカラー文字列です。これを複数回渡します。",
"xpack.canvas.functions.palette.args.gradientHelpText": "サポートされていて有効な場合にグラデーションを使用しますか？",
"xpack.canvas.functions.palette.args.reverseHelpText": "パレットを反転させます",
"xpack.canvas.functions.paletteHelpText": "カラーパレットを作成します",
"xpack.canvas.functions.pie.args.fontHelpText": "ラベルのフォントです",
"xpack.canvas.functions.pie.args.holeHelpText": "円グラフに穴をあけます、0～100 で円グラフのパーセンテージを指定します",
"xpack.canvas.functions.pie.args.labelRadiusHelpText": "ラベルの円の半径として使用する、コンテナーの免責のパーセンテージです",
"xpack.canvas.functions.pie.args.labelsHelpText": "円グラフのラベルを表示しますか？",
"xpack.canvas.functions.pie.args.legendHelpText": "凡例の配置: {position} または {false}",
"xpack.canvas.functions.pie.args.paletteHelpText": "この円グラフに使用されている色を説明する {palette} オブジェクトです。",
"xpack.canvas.functions.pie.args.radiusHelpText": "利用可能なスペースのパーセンテージで示された円グラフの半径です (0 から 1 の間)。半径を自動的に設定するには「{auto}」に設定します",
"xpack.canvas.functions.pie.args.seriesStyleHelpText": "特定の数列のスタイルです",
"xpack.canvas.functions.pie.args.tiltHelpText": "1 が完全に垂直、0 が完全に平らを表す傾きのパーセンテージです",
"xpack.canvas.functions.pieHelpText": "円グラフのエレメントを構成します",
"xpack.canvas.functions.plot.args.defaultStyleHelpText": "すべての数列に使用するデフォルトのスタイルです",
"xpack.canvas.functions.plot.args.fontHelpText": "凡例と目盛りのフォントです",
"xpack.canvas.functions.plot.args.legendHelpText": "凡例の配置: {position} または {false}",
"xpack.canvas.functions.plot.args.paletteHelpText": "このプロットに使用されている色を説明する {palette} オブジェクトです。",
"xpack.canvas.functions.plot.args.seriesStyleHelpText": "特定の数列のスタイルです",
"xpack.canvas.functions.plot.args.xaxisHelpText": "軸の構成、{false} で無効にします",
"xpack.canvas.functions.plot.args.yaxisHelpText": "軸の構成、{false} で無効にします",
"xpack.canvas.functions.plotHelpText": "{plot} エレメントを構成します",
"xpack.canvas.functions.ply.args.byHelpText": "細分する列です",
"xpack.canvas.functions.ply.args.expressionHelpText": "それぞれの結果の {datatable} を渡す先の表現です。アドバイス:\n 表現は {datatable} を返す必要があります。直定数を {datatable} にするには「as」を使用します。\n 複数表現を使用する場合、同じ行数を返す必要があります。異なる行数を返す必要がある場合は、{ply} の別のインスタンスにパイピングします。\n 複数表現が同じ行を返した場合、最後の行が優先されます。",
"xpack.canvas.functions.ply.columnNotFoundErrorMessage": "列が見つかりません: 「{by}」",
"xpack.canvas.functions.ply.rowCountMismatchErrorMessage": "すべての表現が同じ行数を返す必要があります。",
"xpack.canvas.functions.plyHelpText": "{datatable} を細分して結果の表を表現に渡し、アウトプットを結合します",
"xpack.canvas.functions.pointseries.args.colorHelpText": "マークの色を決めるのに使用する表現です",
"xpack.canvas.functions.pointseries.args.sizeHelpText": "サポートしているエレメントでは、マークのサイズです。",
"xpack.canvas.functions.pointseries.args.textHelpText": "サポートしているチャートで使用された場合、マークに表示するテキストです",
"xpack.canvas.functions.pointseries.args.xHelpText": "X 軸の値です",
"xpack.canvas.functions.pointseries.args.yHelpText": "Y 軸の値です",
"xpack.canvas.functions.pointseries.unwrappedExpressionErrorMessage": "表現は {fn} などの関数で囲む必要があります",
"xpack.canvas.functions.pointseriesHelpText": "{datatable} を点の配列モデルに変換します。現在 {url} でディメンションのメジャーを区別します。引数に {tinymath} 表現が入力された場合、その引数をメジャーとして使用し、そうでない場合はディメンションになります。ディメンションを組み合わせて固有のキーを作成します。その後メジャーはそれらのキーで、指定された {tinymath} 関数を使用して複製されます。",
"xpack.canvas.functions.progress.args.barColorHelpText": "背景バーの色です",
"xpack.canvas.functions.progress.args.barWeightHelpText": "背景バーの太さです",
"xpack.canvas.functions.progress.args.fontHelpText": "ラベルのフォント設定です。厳密に言えば、ここに他のスタイルを追加することもできます！",
"xpack.canvas.functions.progress.args.labelHelpText": "{true}/{false} でラベルの表示/非表示を設定するか、ラベルとして表示する文字列を指定します",
"xpack.canvas.functions.progress.args.maxHelpText": "進捗エレメントの最高値です",
"xpack.canvas.functions.progress.args.shapeHelpText": "{list} または {end} を選択します",
"xpack.canvas.functions.progress.args.valueColorHelpText": "プログレスバーの色です",
@ -4430,27 +4337,15 @@
"xpack.canvas.functions.progress.invalidMaxValueErrorMessage": "無効な {arg} 値: 「{max, number}」。「{arg}」は 0 より大きい必要があります",
"xpack.canvas.functions.progress.invalidValueErrorMessage": "無効な値: 「{value, number}」。値は 0 と {max, number} の間でなければなりません",
"xpack.canvas.functions.progressHelpText": "進捗エレメントを構成します",
"xpack.canvas.functions.render.args.asHelpText": "レンダリングに使用するエレメントタイプです。代わりに「{plot}」や「{grid}」などの特殊な関数を使用するほうがいいでしょう",
"xpack.canvas.functions.render.args.containerStyleHelpText": "背景、境界、透明度を含む、コンテナーのスタイルです",
"xpack.canvas.functions.render.args.cssHelpText": "このエレメントの対象となるカスタム {css} のブロックです。",
"xpack.canvas.functions.renderHelpText": "インプットを特定のエレメントとしてレンダリングし、スタイルなどのエレメントレベルのオプションを設定します",
"xpack.canvas.functions.repeatImage.args.emptyImageHelpText": "この画像でインプットと「{max}」パラメーターの差を埋めます",
"xpack.canvas.functions.repeatImage.args.imageHelpText": "繰り返す画像です。通常 {dataurl} またはアセットです",
"xpack.canvas.functions.repeatImage.args.maxHelpText": "画像が繰り返される最高回数です",
"xpack.canvas.functions.repeatImage.args.sizeHelpText": "画像の高さまたは幅のピクセル単位での最高値です。例えば画像が縦長の場合、高さが制限されます",
"xpack.canvas.functions.repeatImageHelpText": "繰り返し画像エレメントを構成します",
"xpack.canvas.functions.replace.args.flagsHelpText": "フラグを指定します。{url} をご参照ください。",
"xpack.canvas.functions.replace.args.patternHelpText": "{js} 正規表現のテキストまたはパターンです。例: 「{example}」ここではキャプチャグループを使用できます。",
"xpack.canvas.functions.replace.args.replacementHelpText": "文字列の一致する部分の代わりです。キャプチャグループはノードによってアクセス可能です。例: {example}",
"xpack.canvas.functions.replaceImageHelpText": "正規表現で文字列の一部を置き換えます",
"xpack.canvas.functions.revealImage.args.emptyImageHelpText": "表示される背景画像です",
"xpack.canvas.functions.revealImage.args.imageHelpText": "表示する画像",
"xpack.canvas.functions.revealImage.args.originHelpText": "開始地点です。例: {position}",
"xpack.canvas.functions.revealImage.invalidPercentErrorMessage": "無効な値: 「{percent}」.パーセンテージは 0 と 1 の間でなければなりません ",
"xpack.canvas.functions.revealImageHelpText": "画像表示エレメントを構成します",
"xpack.canvas.functions.rounddate.args.formatHelpText": "バケットする {moment} フォーマットです ({url} を参照)例: 「{example}」は月単位で四捨五入します",
"xpack.canvas.functions.rounddateHelpText": "{moment} フォーマット文字列を使用して新世紀から {ms} を四捨五入します。新世紀からの {ms} を返します",
"xpack.canvas.functions.rowCountHelpText": "行数を返します。{ply} と組み合わせて、固有の列の値の数、または固有の列の値の組み合わせを求めます。",
"xpack.canvas.functions.seriesStyle.args.barsHelpText": "バーの幅",
"xpack.canvas.functions.seriesStyle.args.colorHelpText": "線に割り当てる色",
"xpack.canvas.functions.seriesStyle.args.fillHelpText": "点を塗りつぶしますか？",
@ -4458,43 +4353,16 @@
"xpack.canvas.functions.seriesStyle.args.labelHelpText": "このスタイルが適用される線のラベルで、線に付ける名前ではありません",
"xpack.canvas.functions.seriesStyle.args.linesHelpText": "線の幅",
"xpack.canvas.functions.seriesStyle.args.pointsHelpText": "線上の点のサイズです",
"xpack.canvas.functions.seriesStyle.args.stackHelpText": "数列をスタックしますか？これはスタック「ID」です。同じスタック ID の数列は一緒にスタックされます",
"xpack.canvas.functions.seriesStyleHelpText": "チャートの数列のプロパティの説明に使用されるオブジェクトを作成します。通常はチャート作成機能で使用します",
"xpack.canvas.functions.shape.args.borderHelpText": "有効な {css} の色の設定です",
"xpack.canvas.functions.shape.args.borderWidthHelpText": "境界の太さです",
"xpack.canvas.functions.shape.args.fillHelpText": "有効な {css} の色の設定です",
"xpack.canvas.functions.shape.args.maintainAspectHelpText": "アスペクト比を維持するには true を選択します",
"xpack.canvas.functions.shape.args.shapeHelpText": "図形を選択します",
"xpack.canvas.functions.shapeHelpText": "図形を作成します",
"xpack.canvas.functions.sort.args.byHelpText": "並べる列です。列が指定されていない場合は、{datatable} が初めの列に並べられます。",
"xpack.canvas.functions.sort.args.reverseHelpText": "並び順を反転させます。反転が指定されていない場合、{datatable} は昇順に並べられます。",
"xpack.canvas.functions.sortHelpText": "データ表を列に並べます",
"xpack.canvas.functions.staticColumn.args.nameHelpText": "新しい列の名前です",
"xpack.canvas.functions.staticColumn.args.valueHelpText": "各列に挿入する値です。ヒント: 部分式を使用して他の列を静的値にロールアップします",
"xpack.canvas.functions.staticColumnHelpText": "静的値の列を追加します",
"xpack.canvas.functions.string.args.valueHelpText": "結合させる 1 つまたは複数の文字列です。必要な場所にスペースを入れるのを忘れないでください！",
"xpack.canvas.functions.stringHelpText": "他の文字列からなる文字列をアウトプットします。主にアウトプットが文字列の部分式、または文字列にキャスト可能なものとと組み合わせると有効です。",
"xpack.canvas.functions.switch.args.caseHelpText": "確認する条件のリストです",
"xpack.canvas.functions.switch.args.defaultHelpText": "ケースが一致しなかった場合のデフォルトのケースです",
"xpack.canvas.functions.switchHelpText": "複数条件の条件付きロジックを実行します",
"xpack.canvas.functions.table.args.fontHelpText": "フォントスタイルです",
"xpack.canvas.functions.table.args.paginateHelpText": "ページ付けのコントロールを表示します。False の場合、初めのページのみが表示されます",
"xpack.canvas.functions.table.args.perPageHelpText": "1 ページごとにこの数の行を表示します。ページ付けを無効にする場合はこの値を上げることをお勧めします",
"xpack.canvas.functions.table.args.showHeaderHelpText": "各行のタイトルと共にヘッダー行を表示するかしないかです",
"xpack.canvas.functions.tableHelpText": "{datatable} エレメントを構成します",
"xpack.canvas.functions.tail.args.countHelpText": "{datatable} の終わりからこの数の行を返します",
"xpack.canvas.functions.tailHelpText": "{datatable} の終わりから N 行をを取得します。「{head}」もご参照ください",
"xpack.canvas.functions.timefilter.args.columnHelpText": "フィルターを添付する列またはフィールドです",
"xpack.canvas.functions.timefilter.args.fromHelpText": "範囲の始まりです。{iso} または {es} {dm} のフォーマットを使用します",
"xpack.canvas.functions.timefilter.args.toHelpText": "範囲の終わりです。{iso} または {es} {dm} のフォーマットを使用します",
"xpack.canvas.functions.timefilter.invalidStringErrorMessage": "無効な日付/時刻文字列: 「{str}」",
"xpack.canvas.functions.timefilterControl.args.columnHelpText": "フィルターを添付する列またはフィールドです",
"xpack.canvas.functions.timefilterControl.args.compactHelpText": "時間フィルターを、ポップオーバーを実行するボタンとして表示します",
"xpack.canvas.functions.timefilterControlHelpText": "{timefilter} コントロールエレメントを構成します",
"xpack.canvas.functions.timefilterHelpText": "ソースのクエリ用の {timefilter} を作成します",
"xpack.canvas.functions.urlparam.args.defaultHelpText": "{url} パラメーターが提供されていない場合にこの文字列を返します",
"xpack.canvas.functions.urlparam.args.paramHelpText": "アクセスする {url} ハッシュパラメーターです",
"xpack.canvas.functions.urlparamHelpText": "{url} パラメーターにアクセスして表現で使用します。例: {example}これは常に文字列を返します",
"xpack.canvas.sampleDataLinkLabel": "Canvas",
"xpack.code.featureRegistry.codeFeatureName": "コード",
"xpack.crossClusterReplication.addAutoFollowPatternButtonLabel": "自動フォローパターンを作成",
@ -10915,4 +10783,4 @@
"xpack.watcher.watchActions.logging.logTextIsRequiredValidationMessage": "ログテキストが必要です。",
"xpack.watcher.watcherDescription": "アラートの作成、管理、監視によりデータへの変更を検知します。"
}
}
}

134
x-pack/plugins/translations/translations/zh-CN.json
View file

@ -4256,174 +4256,81 @@
"xpack.canvas.elements.verticalProgressBarHelpText": "将进度显示为垂直条的一部分",
"xpack.canvas.elements.verticalProgressPillDisplayName": "垂直进度胶囊",
"xpack.canvas.elements.verticalProgressPillHelpText": "将进度显示为垂直胶囊的一部分",
"xpack.canvas.functions.all.args.conditionHelpText": "要检查的一个或多个条件",
"xpack.canvas.functions.allHelpText": "如果所有条件都为 true，则返回 true",
"xpack.canvas.functions.alterColumn.args.columnHelpText": "要更改的列的名称",
"xpack.canvas.functions.alterColumn.args.nameHelpText": "结果列名称留空将不重命名",
"xpack.canvas.functions.alterColumn.args.typeHelpText": "将列转换成的类型。留空将不更改类型",
"xpack.canvas.functions.alterColumn.cannotConvertTypeErrorMessage": "无法连接到“{type}”",
"xpack.canvas.functions.alterColumn.columnNotFoundErrorMessage": "找不到列：“{column}”",
"xpack.canvas.functions.alterColumnHelpText": "在核心类型（例如 {examples}）之间转换并重命名列",
"xpack.canvas.functions.any.args.conditionHelpText": "要检查的一个或多个条件",
"xpack.canvas.functions.anyHelpText": "如果任意条件为 true，则返回 true",
"xpack.canvas.functions.as.args.nameHelpText": "要给予列的名称",
"xpack.canvas.functions.asHelpText": "要检查的一个或多个条件",
"xpack.canvas.functions.axisConfig.args.maxHelpText": "轴上显示的最大值。必须为数值或以 {ms} 为单位的日期或 {iso} 字符串",
"xpack.canvas.functions.axisConfig.args.minHelpText": "轴上显示的最小值。必须为数值或以 {ms} 为单位的日期或 {iso} 字符串",
"xpack.canvas.functions.axisConfig.args.positionHelpText": "轴标签的位置：{examples}",
"xpack.canvas.functions.axisConfig.args.showHelpText": "显示轴标签？",
"xpack.canvas.functions.axisConfig.args.tickSizeHelpText": "在每下一刻度递增大小。仅用于数值轴",
"xpack.canvas.functions.axisConfig.invalidMaxPositionErrorMessage": "日期字符串无效：“{max}”。“max”必须是数值、以毫秒为单位的日期或 ISO8601 日期字符串",
"xpack.canvas.functions.axisConfig.invalidMinDateStringErrorMessage": "日期字符串无效：“{min}”。“min”必须是数值、以毫秒为单位的日期或 ISO8601 日期字符串",
"xpack.canvas.functions.axisConfig.invalidPositionErrorMessage": "无效的位置：“{position}”",
"xpack.canvas.functions.axisConfigHelpText": "配置可视化的轴",
"xpack.canvas.functions.case.args.ifHelpText": "此值用于表示条件是否得到满足。如果二个参数均提供，其将覆盖未命名参数。",
"xpack.canvas.functions.case.args.thenHelpText": "条件得到满足时要返回的值",
"xpack.canvas.functions.case.args.whenHelpText": "此值与上下文对比，以确定条件是否得到满足。如果两个参数均提供，其将由“{if}”参数覆盖。",
"xpack.canvas.functions.caseHelpText": "构建要传递给 {switch} 函数的 case（包括条件/结果）",
"xpack.canvas.functions.clearHelpText": "清除上下文并返回 null",
"xpack.canvas.functions.columns.args.excludeHelpText": "要从表中移除的列名称逗号分隔列表",
"xpack.canvas.functions.columns.args.includeHelpText": "要在表中保留的列名称逗号分隔列表",
"xpack.canvas.functions.columnsHelpText": "在或从数据表中包括或排除的列。如果指定二者，将首先排除",
"xpack.canvas.functions.compare.args.opHelpText": "要用于比较的运算符：{eq}（等于）、{gt}（大于）、{gte}（大于或等于）、{lt}（小于）、{lte}（小于或等于）、{ne} 或 {neq}（不等于）",
"xpack.canvas.functions.compare.args.toHelpText": "要与上下文进行比较的值，通常由子表达式返回",
"xpack.canvas.functions.compare.invalidCompareOperatorErrorMessage": "无效的比较运算符：“{op}”。使用 {ops}",
"xpack.canvas.functions.compareHelpText": "将输入与其他内容比较，以确定 true 或 false。通常与 `{if}` 一起使用。这仅适用于基元类型，如 {examples}。",
"xpack.canvas.functions.containerStyle.args.backgroundColorHelpText": "有效的 {css} 背景色字符串",
"xpack.canvas.functions.containerStyle.args.backgroundImageHelpText": "有效的 {css} 背景图字符串",
"xpack.canvas.functions.containerStyle.args.backgroundRepeatHelpText": "有效的 {css} 背景重复字符串",
"xpack.canvas.functions.containerStyle.args.backgroundSizeHelpText": "有效的 {css} 背景大小字符串",
"xpack.canvas.functions.containerStyle.args.borderHelpText": "有效的 {css} 边框字符串",
"xpack.canvas.functions.containerStyle.args.borderRadiusHelpText": "设置边框圆角时要使用的像素数",
"xpack.canvas.functions.containerStyle.args.opacityHelpText": "0 和 1 之间的数值，表示元素的透明度",
"xpack.canvas.functions.containerStyle.args.overflowHelpText": "设置容器的溢出",
"xpack.canvas.functions.containerStyle.args.paddingHelpText": "内容与边框的距离（像素）",
"xpack.canvas.functions.containerStyle.invalidBackgroundImageErrorMessage": "无效的背景图。请提供资产或 URL。",
"xpack.canvas.functions.containerStyleHelpText": "创建用于在图表上描述序列属性的对象。通常在图表函数内使用此对象",
"xpack.canvas.functions.contextHelpText": "返回传入该函数的任何内容。需要将上下文用作充当子表达式的参数时，这会非常有用",
"xpack.canvas.functions.csv.args.dataHelpText": "要使用的 {csv} 数据",
"xpack.canvas.functions.csv.args.delimeterHelpText": "数据分隔字符",
"xpack.canvas.functions.csv.args.newlineHelpText": "行分隔字符",
"xpack.canvas.functions.csv.invalidInputCSVErrorMessage": "解析输入 CSV 时出错。",
"xpack.canvas.functions.csvHelpText": "从 {csv} 输入创建数据表",
"xpack.canvas.functions.date.args.formatHelpText": "用于解析可选日期字符串的 {moment} 格式（请参见 {url}）",
"xpack.canvas.functions.date.args.valueHelpText": "解析成自 Epoch 起毫秒数的可选日期字符串。可以是有效的 Javascript 日期输入，也可以是要使用格式参数解析的字符串。必须为 {iso} 字符串，或必须提供该格式",
"xpack.canvas.functions.date.invalidDateInputErrorMessage": "无效的日期输入：{date}",
"xpack.canvas.functions.dateHelpText": "将当前时间或从字符串解析的时间返回为自 Epoch 起毫秒数",
"xpack.canvas.functions.demodata.args.typeHelpText": "要使用的演示数据集的名称",
"xpack.canvas.functions.demodata.invalidDataSetErrorMessage": "无效的数据集：“{arg}”，请使用“{ci}”或“{shirts}”。",
"xpack.canvas.functions.demodataHelpText": "包含项目 {ci} 时间以及用户名、国家/地区以及运行阶段的模拟数据集",
"xpack.canvas.functions.do.args.fnHelpText": "一个或多个子表达式。这些表达式的值在根管道中不可用，因为此函数仅返回传入的上下文。",
"xpack.canvas.functions.doHelpText": "运行多个子表达式。返回传入的上下文。适用于运行生成函数的操作。",
"xpack.canvas.functions.dropdownControl.args.filterColumnHelpText": "附加筛选的列字段",
"xpack.canvas.functions.dropdownControl.args.filterGroupHelpText": "筛选的组名称",
"xpack.canvas.functions.dropdownControl.args.valueColumnHelpText": "从其中提取下拉列表唯一值的数据表列",
"xpack.canvas.functions.dropdownControlHelpText": "配置下拉列表筛选控制元素",
"xpack.canvas.functions.eq.args.valueHelpText": "要与上下文比较的值",
"xpack.canvas.functions.eqHelpText": "如果上下文等于参数，则返回",
"xpack.canvas.functions.escount.args.indexHelpText": "指定索引模式。例如，{example}",
"xpack.canvas.functions.escount.args.queryHelpText": "{lucene} 查询字符串",
"xpack.canvas.functions.escountHelpText": "用于计数匹配查询的命中数的查询 {es}",
"xpack.canvas.functions.esdocs.args.countHelpText": "要拉取的文档数。数目越小，性能越好",
"xpack.canvas.functions.esdocs.args.fieldsHelpText": "字段逗号分隔列表。字段越少，性能越好",
"xpack.canvas.functions.esdocs.args.indexHelpText": "指定索引模式。例如，{example}",
"xpack.canvas.functions.esdocs.args.metaFieldsHelpText": "元字段逗号分隔列表，例如“{example}”",
"xpack.canvas.functions.esdocs.args.queryHelpText": "{lucene} 查询字符串",
"xpack.canvas.functions.esdocs.args.sortHelpText": "排序方向，表示为“{directions}”。例如，“{example1}”或“{example2}”",
"xpack.canvas.functions.esdocsHelpText": "查询 {es} 并获取原始文档。建议指定需要的字段，特别是要请求大量行时。",
"xpack.canvas.functions.essql.args.countHelpText": "要拉取的文档数。数目越小，性能越好",
"xpack.canvas.functions.essql.args.queryHelpText": "{sql} 查询",
"xpack.canvas.functions.essql.args.timezoneHelpText": "要用于日期操作的时区，有效的 {iso} 格式和 {utc} 偏移均适用",
"xpack.canvas.functions.essqlHelpText": "{essql}",
"xpack.canvas.functions.exactly.args.columnHelpText": "附加筛选的列字段",
"xpack.canvas.functions.exactly.args.valueHelpText": "要完全匹配的值，包括空格和大写",
"xpack.canvas.functions.exactlyHelpText": "创建使给定列匹配确切值的筛选。",
"xpack.canvas.functions.filterrows.args.fnHelpText": "要将数据表中的每行传入的表达式。表达式应返回布尔值。true 值将保留行，false 值将移除行。",
"xpack.canvas.functions.filterrowsHelpText": "根据子表达式的返回值筛选数据表中的行。",
"xpack.canvas.functions.formatdate.args.formatHelpText": "装入存储桶的 {moment} 格式（请参见 {url}）",
"xpack.canvas.functions.formatdateHelpText": "使用 {moment} 格式化有效的日期字符串或自 Epoch 起{ms}数（请参阅 {url}）",
"xpack.canvas.functions.formatnumber.args.formatHelpText": "{numeralJS} 格式字符串 {url}",
"xpack.canvas.functions.formatnumberHelpText": "使用 {numeralJS} 格式将数值转成字符串",
"xpack.canvas.functions.getCell.args.columnHelpText": "要提取的列值的名称",
"xpack.canvas.functions.getCell.args.rowHelpText": "行编号，从 0 开始",
"xpack.canvas.functions.getCell.columnNotFoundErrorMessage": "找不到列：“{column}”",
"xpack.canvas.functions.getCell.rowNotFoundErrorMessage": "找不到行：“{row}”",
"xpack.canvas.functions.getCellHelpText": "提取表中的单个单元格",
"xpack.canvas.functions.gt.args.valueHelpText": "要与上下文比较的值",
"xpack.canvas.functions.gte.args.valueHelpText": "要与上下文比较的值",
"xpack.canvas.functions.gteHelpText": "如果上下文大于或等于参数，则返回",
"xpack.canvas.functions.gtHelpText": "如果上下文大于参数，则返回",
"xpack.canvas.functions.head.args.countHelpText": "从数据库 {datatable} 的开头返回此数目的行",
"xpack.canvas.functions.headHelpText": "从 {datatable} 获取前 {n} 行。另请参见 `{tail}`",
"xpack.canvas.functions.if.args.conditionHelpText": "布尔值 true 或 false，通常由子表达式返回。如果未提供，则将使用输入上下文",
"xpack.canvas.functions.if.args.elseHelpText": "false 时的返回值。如果未指定其他条件，该条件为 false，则将返回函数的输入上下文",
"xpack.canvas.functions.if.args.thenHelpText": "true 时的返回值",
"xpack.canvas.functions.ifHelpText": "执行条件逻辑",
"xpack.canvas.functions.image.args.dataurlHelpText": "图像的 HTTP(S) URL 或 base64 数据。",
"xpack.canvas.functions.image.args.modeHelpText": "`{contain}` 将显示整个图像，图像缩放至适合大小。`{cover}` 将使用该图像填充容器，根据需要在两边或底部裁剪图像。`{stretch}` 将图像的高和宽调整为容器的 100%",
"xpack.canvas.functions.image.args.modeHelpText": "{contain} 将显示整个图像，图像缩放至适合大小。{cover} 将使用该图像填充容器，根据需要在两边或底部裁剪图像。{stretch} 将图像的高和宽调整为容器的 100%",
"xpack.canvas.functions.image.invalidImageModeErrorMessage": "“mode”必须为“{contain}”、“{cover}”或“{stretch}”",
"xpack.canvas.functions.imageHelpText": "显示图像",
"xpack.canvas.functions.locationHelpText": "使用浏览器的位置功能获取您当前的位置。通常非常缓慢，但相当准确",
"xpack.canvas.functions.lt.args.valueHelpText": "要与上下文比较的值",
"xpack.canvas.functions.lte.args.valueHelpText": "要与上下文比较的值",
"xpack.canvas.functions.lteHelpText": "如果上下文小于或等于参数，则返回",
"xpack.canvas.functions.ltHelpText": "如果上下文小于参数，则返回",
"xpack.canvas.functions.mapColumn.args.expressionHelpText": "每行均传递为单行 {datatable} 的画布表达式",
"xpack.canvas.functions.mapColumn.args.nameHelpText": "结果列的名称",
"xpack.canvas.functions.mapColumnHelpText": "添加计算为其他列的结果的列或添加未计算为其他列的结果的列",
"xpack.canvas.functions.markdown.args.contentHelpText": "{markdown} 表达式可以传递多次以实现串联",
"xpack.canvas.functions.markdown.args.fontHelpText": "字体设置。通常，也可以在此处添加其他样式",
"xpack.canvas.functions.markdownHelpText": "用于呈现 {markdown} 文本的元素。适用于单个数值、指标或文本段落。",
"xpack.canvas.functions.math.args.expressionHelpText": "已计算的 {tinymath} 表达式。（请参见 {url}）",
"xpack.canvas.functions.math.emptyDatatableErrorMessage": "空数据表",
"xpack.canvas.functions.math.emptyExpressionErrorMessage": "空表达式",
"xpack.canvas.functions.math.executionFailedErrorMessage": "无法执行数学表达式。检查您的列名称",
"xpack.canvas.functions.math.tooManyResultsErrorMessage": "表达式必须返回单个数字。尝试将您的表达式包装在 {mean} 或 {sum} 中",
"xpack.canvas.functions.mathHelpText": "以数值或 {datatable} 作为上下文来解释数学表达式。{Datatable} 可通过列名进行使用。如果传入数值，其可用为“{value}”（无引号）",
"xpack.canvas.functions.metric.args.labelFontHelpText": "标签的字体设置。通常，也可以在此处粘贴其他样式！",
"xpack.canvas.functions.metric.args.labelHelpText": "描述指标的文本",
"xpack.canvas.functions.metric.args.metricFontHelpText": "指标的字体设置。通常，也可以在此处粘贴其他样式！",
"xpack.canvas.functions.metricHelpText": "具有标签的数字",
"xpack.canvas.functions.neq.args.valueHelpText": "要与上下文比较的值",
"xpack.canvas.functions.neqHelpText": "如果上下文不等于参数，则返回",
"xpack.canvas.functions.palette.args.colorHelpText": "调色板颜色、{rgba}、{hex} 或 {html} 颜色字符串。传递多次。",
"xpack.canvas.functions.palette.args.gradientHelpText": "希望在支持以及有用的地方进行渐变？",
"xpack.canvas.functions.palette.args.reverseHelpText": "反转调色板",
"xpack.canvas.functions.paletteHelpText": "创建颜色调色板",
"xpack.canvas.functions.pie.args.fontHelpText": "标签字体",
"xpack.canvas.functions.pie.args.holeHelpText": "在饼图中画孔洞，大小为饼图半径的百分比 (0-100)",
"xpack.canvas.functions.pie.args.labelRadiusHelpText": "要用作标签圆形半径的容器的面积百分比",
"xpack.canvas.functions.pie.args.labelsHelpText": "显示饼图标签？",
"xpack.canvas.functions.pie.args.legendHelpText": "图例位置：{position} 或 {false}",
"xpack.canvas.functions.pie.args.paletteHelpText": "用于描述要在饼图上使用的颜色的 {palette} 对象",
"xpack.canvas.functions.pie.args.radiusHelpText": "饼图的半径，表示为可用空间的百分比（介于 0 和 1 之间）。设置为 `{auto}` 可自动设置半径",
"xpack.canvas.functions.pie.args.seriesStyleHelpText": "特定序列的样式",
"xpack.canvas.functions.pie.args.tiltHelpText": "倾斜百分比，其中 1 为完全垂直，0 为完全水平",
"xpack.canvas.functions.pieHelpText": "配置饼图元素",
"xpack.canvas.functions.plot.args.defaultStyleHelpText": "要用于每个序列的默认样式",
"xpack.canvas.functions.plot.args.fontHelpText": "图例和刻度线字体",
"xpack.canvas.functions.plot.args.legendHelpText": "图例位置：{position} 或 {false}",
"xpack.canvas.functions.plot.args.paletteHelpText": "用于描述要在绘图上使用的颜色的 {palette} 对象",
"xpack.canvas.functions.plot.args.seriesStyleHelpText": "特定序列的样式",
"xpack.canvas.functions.plot.args.xaxisHelpText": "轴配置，或{false} 以禁用",
"xpack.canvas.functions.plot.args.yaxisHelpText": "轴配置，或{false} 以禁用",
"xpack.canvas.functions.plotHelpText": "配置 {plot} 元素",
"xpack.canvas.functions.ply.args.byHelpText": "细分所要基于的列",
"xpack.canvas.functions.ply.args.expressionHelpText": "要将每个结果 {datatable} 传入的表达式。提示：\n 表达式必须返回 {datatable}。使用 `as` 将文本转成 {datatable}。\n 多个表达式必须返回相同数目的行。如果需要返回不同行数，使用管道将数据加载到另一 {ply} 实例中。\n 如果多个表达式返回相同的列，则最后一个优先。",
"xpack.canvas.functions.ply.columnNotFoundErrorMessage": "找不到列：“{by}”",
"xpack.canvas.functions.ply.rowCountMismatchErrorMessage": "所有表达式必须返回相同数目的行",
"xpack.canvas.functions.plyHelpText": "细分 {datatable} 并将结果表传入表达式，然后合并输出",
"xpack.canvas.functions.pointseries.args.colorHelpText": "要用于确定标记颜色的表达式",
"xpack.canvas.functions.pointseries.args.sizeHelpText": "对于支持的元素，标记的大小",
"xpack.canvas.functions.pointseries.args.textHelpText": "如果要用于支持的图表中，标记中要显示的文本",
"xpack.canvas.functions.pointseries.args.xHelpText": "X 轴上的值",
"xpack.canvas.functions.pointseries.args.yHelpText": "Y 轴上的值",
"xpack.canvas.functions.pointseries.unwrappedExpressionErrorMessage": "表达式必须包装在函数中，例如 {fn}",
"xpack.canvas.functions.pointseriesHelpText": "将 {datatable} 转成点序列模型当前我们通过寻找 {url} 区分度量和维度。如果在参数中输入 {tinymath} 表达式，我们将该参数视为度量，否则该参数为维度。维度将进行组合以创建唯一键。然后，这些键使用指定的 {tinymath} 函数消除重复的度量。",
"xpack.canvas.functions.progress.args.barColorHelpText": "背景条形的颜色",
"xpack.canvas.functions.progress.args.barWeightHelpText": "背景条形的粗细",
"xpack.canvas.functions.progress.args.fontHelpText": "标签的字体设置。通常，也可以在此处粘贴其他样式！",
"xpack.canvas.functions.progress.args.labelHelpText": "设置 {true}/{false} 以显示/隐藏标签或提供显示为标签的字符串",
"xpack.canvas.functions.progress.args.maxHelpText": "进度元素的最大值",
"xpack.canvas.functions.progress.args.shapeHelpText": "选择 {list} 或 {end}",
"xpack.canvas.functions.progress.args.valueColorHelpText": "进度条的颜色",
@ -4431,27 +4338,15 @@
"xpack.canvas.functions.progress.invalidMaxValueErrorMessage": "无效的 {arg} 值：“{max, number}”。“{arg}”必须大于 0",
"xpack.canvas.functions.progress.invalidValueErrorMessage": "无效的值：“{value, number}”。值必须介于 0 和 {max, number} 之间",
"xpack.canvas.functions.progressHelpText": "配置进度元素",
"xpack.canvas.functions.render.args.asHelpText": "要用于呈现的元素类型。您可能需要专门的函数，例如 `{plot}` 或 `{grid}`",
"xpack.canvas.functions.render.args.containerStyleHelpText": "容器的样式，包括背景、边框和透明度",
"xpack.canvas.functions.render.args.cssHelpText": "要限定于此元素的任何定制 {css} 块。",
"xpack.canvas.functions.renderHelpText": "将输入呈现为指定元素并设置元素级选项（例如样式）",
"xpack.canvas.functions.repeatImage.args.emptyImageHelpText": "使用此图像填充输入和 `{max}` 参数之间的差异",
"xpack.canvas.functions.repeatImage.args.imageHelpText": "要重复的图像。通常 {dataurl} 或资产",
"xpack.canvas.functions.repeatImage.args.maxHelpText": "图像可以重复的最大次数",
"xpack.canvas.functions.repeatImage.args.sizeHelpText": "图像的最大高度或宽度，以像素为单位。例如，如果图像的高度大于宽度，这将会限制其高度",
"xpack.canvas.functions.repeatImageHelpText": "配置重复图像元素",
"xpack.canvas.functions.replace.args.flagsHelpText": "指定标志。有关信息，请参阅 {url}。",
"xpack.canvas.functions.replace.args.patternHelpText": "{js} 正则表达式的文本或模式，例如“{example}”。您可以在此处使用捕获组。",
"xpack.canvas.functions.replace.args.replacementHelpText": "字符串匹配部分的替代。捕获组可以通过其索引（例如 {example}）进行访问。",
"xpack.canvas.functions.replaceImageHelpText": "使用正则表达式替换字符串各部分",
"xpack.canvas.functions.revealImage.args.emptyImageHelpText": "要显示的可选背景图像",
"xpack.canvas.functions.revealImage.args.imageHelpText": "要显示的图像",
"xpack.canvas.functions.revealImage.args.originHelpText": "起始位置，例如 {position}",
"xpack.canvas.functions.revealImage.invalidPercentErrorMessage": "无效的值：“{percent}”。百分比必须介于 0 和 1 之间",
"xpack.canvas.functions.revealImageHelpText": "配置图像显示元素",
"xpack.canvas.functions.rounddate.args.formatHelpText": "装入存储桶的 {moment} 格式（请参见 {url}）例如，“{example}”将舍入为月",
"xpack.canvas.functions.rounddateHelpText": "使用 {moment} 格式字符串舍入自 Epoch 起{ms}数。返回自 Epoch 起{ms}数。",
"xpack.canvas.functions.rowCountHelpText": "返回行数。与 {ply} 搭配，可获取唯一行值的计数或唯一行值的组合。",
"xpack.canvas.functions.seriesStyle.args.barsHelpText": "条形的宽度",
"xpack.canvas.functions.seriesStyle.args.colorHelpText": "要为折线分配的颜色",
"xpack.canvas.functions.seriesStyle.args.fillHelpText": "是否应填充点？",
@ -4459,43 +4354,16 @@
"xpack.canvas.functions.seriesStyle.args.labelHelpText": "此样式应用到的折线的标签，不是要为折线提供的名称",
"xpack.canvas.functions.seriesStyle.args.linesHelpText": "折线的宽度",
"xpack.canvas.functions.seriesStyle.args.pointsHelpText": "折线上的点大小",
"xpack.canvas.functions.seriesStyle.args.stackHelpText": "是否应堆叠序列？这是堆叠“id”。具有相同堆叠 ID 的序列将堆叠在一起",
"xpack.canvas.functions.seriesStyleHelpText": "创建用于在图表上描述序列属性的对象。通常在图表函数内使用此对象",
"xpack.canvas.functions.shape.args.borderHelpText": "有效的 {css} 颜色字符串",
"xpack.canvas.functions.shape.args.borderWidthHelpText": "边框的粗细",
"xpack.canvas.functions.shape.args.fillHelpText": "有效的 {css} 颜色字符串",
"xpack.canvas.functions.shape.args.maintainAspectHelpText": "选择 true 可保持纵横比",
"xpack.canvas.functions.shape.args.shapeHelpText": "选取形状",
"xpack.canvas.functions.shapeHelpText": "创建形状",
"xpack.canvas.functions.sort.args.byHelpText": "排序要基于的列。如果未指定列，将基于第一列排序 {datatable}。",
"xpack.canvas.functions.sort.args.reverseHelpText": "反向排序。如果未指定反向，将升序排序 {datatable}。",
"xpack.canvas.functions.sortHelpText": "基于列排序数据表",
"xpack.canvas.functions.staticColumn.args.nameHelpText": "新列的名称",
"xpack.canvas.functions.staticColumn.args.valueHelpText": "要插入每列的值。提示：使用子表达式将其他列汇总为静态值",
"xpack.canvas.functions.staticColumnHelpText": "添加具有静态值的列",
"xpack.canvas.functions.string.args.valueHelpText": "要联结在一起的一个或多个字符串。在需要空格的地方切勿忘记空格！",
"xpack.canvas.functions.stringHelpText": "输出由其他字符串构成的字符串。与输出字符串或可转换成字符串的内容的子表达式组合使用时非常有用",
"xpack.canvas.functions.switch.args.caseHelpText": "要检查的条件列表",
"xpack.canvas.functions.switch.args.defaultHelpText": "没有 case 匹配时的默认 case",
"xpack.canvas.functions.switchHelpText": "执行具有多个条件的条件逻辑",
"xpack.canvas.functions.table.args.fontHelpText": "字体样式",
"xpack.canvas.functions.table.args.paginateHelpText": "显示分页控件如果设置为 false，将仅显示第一页",
"xpack.canvas.functions.table.args.perPageHelpText": "每页显示此数目的行。您可能想增加此设置，这将禁用分页",
"xpack.canvas.functions.table.args.showHeaderHelpText": "显示或隐藏具有每列标题的标题行",
"xpack.canvas.functions.tableHelpText": "配置 {datatable} 元素",
"xpack.canvas.functions.tail.args.countHelpText": "从 {datatable} 结尾返回此数目的行",
"xpack.canvas.functions.tailHelpText": "从 {datatable} 结尾获取后 N 行。另请参见 `{head}`",
"xpack.canvas.functions.timefilter.args.columnHelpText": "附加筛选的列字段",
"xpack.canvas.functions.timefilter.args.fromHelpText": "范围开始，使用 {iso} 或 {es} {dm} 格式",
"xpack.canvas.functions.timefilter.args.toHelpText": "范围结束，使用 {iso} 或 {es} {dm} 格式",
"xpack.canvas.functions.timefilter.invalidStringErrorMessage": "无效的日期/时间字符串：“{str}”",
"xpack.canvas.functions.timefilterControl.args.columnHelpText": "附加筛选的列字段",
"xpack.canvas.functions.timefilterControl.args.compactHelpText": "将时间筛选显示为触发弹出框的按钮",
"xpack.canvas.functions.timefilterControlHelpText": "配置 {timefilter} 控制元素",
"xpack.canvas.functions.timefilterHelpText": "创建用于查询源的 {timefilter}",
"xpack.canvas.functions.urlparam.args.defaultHelpText": "如果未定义 {url} 参数，将返回此字符串",
"xpack.canvas.functions.urlparam.args.paramHelpText": "要访问的 {url} 哈希参数",
"xpack.canvas.functions.urlparamHelpText": "访问 {url} 参数并在表达式中使用它们。例如，{example}。这将始终返回字符串",
"xpack.canvas.sampleDataLinkLabel": "Canvas",
"xpack.code.featureRegistry.codeFeatureName": "Code",
"xpack.crossClusterReplication.addAutoFollowPatternButtonLabel": "创建自动跟随模式",