输入组件

输入组件提示代理输入文本并验证文本。您可以将文本输入组件的值绑定到变量。

  1. 点击输入在组件工具栏上。
  2. 在属性面板中，使用占位符框预先填充控件，并提示读者输入什么内容。变量永远不会存储占位符文本。占位符文本是指示代理的临时文本，它会被用户输入自动替换。例如：您可以使用变量的值预先填充字段。为此，请从组件属性的 “值” 列表中选择一个变量。该值在运行时自动向用户显示。变量的值会根据用户输入的文本自动更新，但需经过可选验证。
  3. 要验证用户输入，请展开 常用 组。 然后单击 验证 列表。
  4. 选择 “选择” 或 “ 自 定义” 以选择验证方法。

选择

选择允许您选择预设的验证模式。验证预设为：

电子邮件 输入必须符合电子邮件地址语法。
字母 只允许按字母顺序输入（不允许输入数字）。
字母 - 带空格 只允许按字母顺序输入并且要求单词之间有空格。 例如，“酷豆” 是可以接受的，但 “cool_beans” 不可以接受。
字母 - 带下划线 只需要字母输入（无数字）和单词之间的下划线。 例如，“cool_beans” 是可以接受的，但 “酷豆” 不可以接受。
字母数字 文本输入必须同时包含字母和数字。
字母数字 - 带空格 文本输入必须同时包含字母和数字，单词之间用空格分隔。
字母数字 - 带下划线 文本输入必须同时包含字母和数字，单词用下划线分隔。

自定义

如果预先打包的验证不够，您可以使用正则表达式来验证文本输入。从 验证 列表 中选择 自定义。然后，在文本框中输入正则表达式。正则表达式超出了本主题的讨论范围。但是，例如，假设您希望用户在文本输入中的某处输入短语 “dog”。打字dog在自定义验证属性中设置一个简单的正则表达式，该表达式接受 dog、sundog、hotdog、my good dog Penny 或其他包含该区分大小写的字符串的字符组合，但不接受 DOG Doggie 等等。

另一个例子是^[a-z]+$仅接受小写字母。

当焦点离开文本框时，将验证文本输入组件的值，以确保其符合选定的验证规则。 如果用户输入未通过验证，则边框将变为红色以表示存在验证问题。 您可以在编辑器的预览模式下测试自定义验证和预打包验证。

  • 如果用户必须在组件中键入值，则将 “需要值” 开关设置为 “是”。 默认情况下，此设置为 “否”，这意味着用户输入是可选的。 
  • 如果用户必须在组件中键入值，则将 “需要值” 开关设置为 True。 默认情况下，此设置为 False，这意味着用户输入是可选的。
  • 要设置操作，请单击未选择任何操作以下更改操作在高级属性组中。
  • 要选择操作，请单击列表中的某一行。 您可以分配先前定义的操作或创建新操作。
  • 关闭选择操作列表。

或者，设置此组件的其他属性。 例如，您可以使用边距设置调整此组件周围的间距。


通用

Value 属性将组件绑定到所选变量。例如，如果将文本输入组件绑定到变量，则输入框将始终显示该变量的值，而忽略指定的任何占位符文本。该变量会根据用户输入的文本自动更新，并经过验证处理。

其他控件（例如单选按钮）使用带有选定值文本设置的值。 在运行时选择单选按钮时，其 “所选值文本” 将成为变量的新值。 这样，每个单选按钮都可以为同一个变量分配不同的值。

当日历控件绑定到变量时，其值将设置为控件选择的日期。 由于变量可以预设视觉控件的值，也可以由它们设置，因此绑定是一种功能强大且经常使用的技术。

通过选择变量、输入文本和选择位置来配置标签。

占位符文本向用户显示提示。

对于文本输入，在用户键入输入之前，将显示占位符文本。 如果用户清除了输入框的内容，则会重新显示占位符文本。

对于下拉菜单，占位符文本提示用户进行选择。  用户选择一个项目后，占位符将被替换。

提示： 如果组件绑定到变量，则会忽略手动键入的占位符文本。如果选择了一个变量，那么它的值就会一直显示出来。 

验证可确保座席输入格式正确的文本。 当焦点离开 文本输入 框时，Genesys Cloud 会测试文本值以确保其符合选定的验证规则。 如果文本未能通过验证，边框将变为红色，表示文本存在验证问题。

使用下拉列表选择验证方法：

 

  • 选择— 允许您选择预设的验证模式：

    电子邮件 输入必须符合电子邮件地址语法。
    字母 只允许按字母顺序输入（没有数字）
    字母 - 带空格 只允许按字母顺序输入并且要求单词之间有空格。 例如，“酷豆” 是可以接受的，但 “cool_beans” 不可以接受。
    字母 - 带下划线 只需要字母输入（无数字）和单词之间的下划线。 例如，“cool_beans” 是可以接受的，但 “酷豆” 不可以接受。
    字母数字 文本输入必须同时包含字母和数字。
    字母数字 - 带空格 文本输入必须同时包含字母和数字，单词之间用空格分隔。
    字母数字 - 带下划线 文本输入必须同时包含字母和数字，单词用下划线分隔。

  • Custom— 允许您选择字符串变量。 例如，你可以让字符串变量作为正则表达式，然后在多个页面上使用该变量来保持验证不变。 有关自定义验证方法的更多信息，请参阅文本输入脚本组件。

Requires Value True False 属性决定是否要求用户键入或选择一个值。默认值为False，表示用户交互是可选的。

用户界面直观地指示用户输入是否是可选的。可选输入由组件下方的标签指示。

 

默认情况下，文本输入 框支持单行。 当 Multiline 设置为 No（默认情况下）时，文本输入不会换行文本或垂直调整自身大小。

  • 如果将多行设置为否，您可以通过单击。
  • 如果将“多行”设置为“是”，则文本输入接受多行文本。 

密码

要为密码配置输入组件，请将 “密码” 设置为 “是”。 密码文本已隐藏。 密码的默认设置为 “否”。

显示密码切换

要显示显示密码的开关，请将 “显示密码切换” 设置为 “是”。 “显示密码切换” 的默认设置为 “否”。

布局

使用权重来影响大小调整，将宽度配置为固定大小，根据需要增大以显示内容，或者相对于其他组件消耗尽可能多的空间。

  • 自动调整大小配置组件根据其内容缩小或扩大。例如，标签的宽度可以根据其包含的文本量而增加。
  • 拉紧允许组件相对于其他组件占用尽可能多的空间，使用权重来影响尺寸调整。
    笔记：如果两个组件都设置为伸展，则默认情况下它们都被分配剩余空间的 50％。可以通过更改权重值来调整此比例。例如，如果将一个组件的权重设置为 200，将另一个组件的权重设置为 100，则第一个组件占用剩余空间的三分之二，而另一个组件只占三分之一。第一个组件的尺寸看起来是另一个组件的两倍，因为它的重量是第二个组件重量的两倍。
  • 像素设置固定像素大小。您可以在框中键入整数值，或使用向上或向下箭头来增大或减小大小。当组件具有焦点时，这些箭头可见。

使用权重来影响大小调整，将高度配置为固定大小，以便根据需要增大以显示内容，或者相对于其他组件消耗尽可能多的空间。

  • 自动调整大小配置组件根据其内容缩小或扩大。例如，标签的宽度可以根据其包含的文本量而增加。
  • 拉紧允许组件相对于其他组件占用尽可能多的空间，使用权重来影响尺寸调整。
    笔记：如果两个组件都设置为伸展，则默认情况下它们都被分配剩余空间的 50％。可以通过更改权重值来调整此比例。例如，如果将一个组件的权重设置为 200，将另一个组件的权重设置为 100，则第一个组件占用剩余空间的三分之二，而另一个组件只占三分之一。第一个组件的尺寸看起来是另一个组件的两倍，因为它的重量是第二个组件重量的两倍。
  • 像素设置固定像素大小。您可以在框中键入整数值，或使用向上或向下箭头来增大或减小大小。当组件具有焦点时，这些箭头可见。

将组件相对于其父容器向左、向右或居中对齐。

提示：如果组件的父容器的高度设置为Auto Sizing。要解决此问题，请将父容器的高度设置为Stretch或固定高度Pixels。

边距设置边框周围的左、右、上和下间距。

  1. 单击保证金的值字段。 旋转控件出现在该字段中。
  2. 使用旋转控件来增加或减少边距。 
  3. 要一次性更新所有边距值，请点击设置全部属性面板中的“边距”按钮。

Visible 属性根据布尔值（True 或 False）变量或表达式的值设置组件的可见性。

要根据变量设置 Visible 属性：

  1. 点击布局物业集团特性控制板。
  2. 在下面可见的， 点击选择变量。
  3. 选择一个变量，或者选择性地创建一个新的 “是/否” 变量，然后将该新变量分配给 Visible 属性。
  4. 在运行时，当变量的值为 True 时，组件是可见的。 相反，当变量的值为 False 时，它会被隐藏。

要根据表达式设置 Visible 属性：

  1. 点击布局物业集团特性控制板。
  2. 在可见下，选择真/假表达式。
  3. 在插入变量框中，输入一个表达式。

在运行时，当表达式为 True 时，组件可见。当表达式为错误的。

外貌

通过选择以下内容配置标签样式：

  • 字体
  • 风格
  • 大小
  • 理由

高级

Value 属性将组件绑定到所选变量。例如，如果将文本输入组件绑定到变量，则输入框将始终显示该变量的值，而忽略指定的任何占位符文本。该变量会根据用户输入的文本自动更新，并经过验证处理。

其他控件（例如单选按钮）使用带有选定值文本设置的值。 在运行时选择单选按钮时，其 “所选值文本” 将成为变量的新值。 这样，每个单选按钮都可以为同一个变量分配不同的值。

当日历控件绑定到变量时，其值将设置为控件选择的日期。 由于变量可以预设视觉控件的值，也可以由它们设置，因此绑定是一种功能强大且经常使用的技术。

占位符文本向用户显示提示。

对于文本输入，在用户键入输入之前，将显示占位符文本。 如果用户清除了输入框的内容，则会重新显示占位符文本。

对于下拉菜单，占位符文本提示用户进行选择。  用户选择一个项目后，占位符将被替换。

提示： 如果组件绑定到变量，则会忽略手动键入的占位符文本。如果选择了一个变量，那么它的值就会一直显示出来。 

默认情况下，所有组件都启用。 Disabled 属性将 True/False 变量绑定到组件，以根据该变量的运行时值禁用或启用它。

  1. 要创建 True /False 变量，请单击 变量 选项卡。
  2. 单击 “添加” 以添加变量。
  3. 选择 True /False 作为数据类型。
  4. 在 “名称” 框中，键入描述性名称。
  5. 将默认值设置为真的或者错误的。
    • 如果变量为 True，则该组件被禁用。
    • 如果变量为 False，则该组件已启用。
  6. 要保存变量，请单击 “应用”。
  7. 将变量分配给已禁用财产。以下已禁用， 点击选择变量。
  8. 选择 True /False 变量。

要测试您的工作，请单击 “ 预览”。

验证可确保座席输入格式正确的文本。 当焦点离开 文本输入 框时，Genesys Cloud 会测试文本值以确保其符合选定的验证规则。 如果文本未能通过验证，边框将变为红色，表示文本存在验证问题。

使用下拉列表选择验证方法：

 

  • 选择— 允许您选择预设的验证模式：

    电子邮件 输入必须符合电子邮件地址语法。
    字母 只允许按字母顺序输入（没有数字）
    字母 - 带空格 只允许按字母顺序输入并且要求单词之间有空格。 例如，“酷豆” 是可以接受的，但 “cool_beans” 不可以接受。
    字母 - 带下划线 只需要字母输入（无数字）和单词之间的下划线。 例如，“cool_beans” 是可以接受的，但 “酷豆” 不可以接受。
    字母数字 文本输入必须同时包含字母和数字。
    字母数字 - 带空格 文本输入必须同时包含字母和数字，单词之间用空格分隔。
    字母数字 - 带下划线 文本输入必须同时包含字母和数字，单词用下划线分隔。

  • Custom— 允许您选择字符串变量。 例如，你可以让字符串变量作为正则表达式，然后在多个页面上使用该变量来保持验证不变。 有关自定义验证方法的更多信息，请参阅文本输入脚本组件。

Requires Value True False 属性决定是否要求用户键入或选择一个值。默认值为False，表示用户交互是可选的。

用户界面直观地指示用户输入是否是可选的。可选输入由组件下方的标签指示。

 

“ 更改操作” 属性允许您设置在此组件的状态或值发生更改时执行的操作。

您可以选择 Scripter 操作、出站操作或自定义操作。 除非启用了 Outbound 属性，否则出站操作不可用。 

默认情况下，文本输入 框支持单行。 当 Multiline 设置为 No（默认情况下）时，文本输入不会换行文本或垂直调整自身大小。

  • 如果将多行设置为否，您可以通过单击。
  • 如果将“多行”设置为“是”，则文本输入接受多行文本。 

密码

要为密码配置输入组件，请将 “密码” 设置为 “是”。 密码文本已隐藏。 密码的默认设置为 “否”。

显示密码切换

要显示显示密码的开关，请将 “显示密码切换” 设置为 “是”。 “显示密码切换” 的默认设置为 “否”。