Gambit字段和 JQL 参考
Gambit 添加到 Jira 的所有字段、可搜索的属性，以及可直接使用的 JQL，用于按名称查找客户、商机、邮件和营收。
按名称搜索
Gambit 存储的是名称，而不只是代码，因此您可以用日常的说法查找人员和公司。在 Jira 显示字段的所有位置，客户都显示为“Acme Corp (RBDIR-12)”，人员都显示为“Jane Doe, Raj Patel +2”，包括软件和服务工作项、搜索结果、Jira 移动应用以及 CSV 导出文件。
Account.name ~ "acme"
People.names ~ "jane doe"
"Revenue impact.accountNames" ~ "acme"
project = RBDIR AND type = Contact AND summary ~ "jane doe"客户的摘要是公司名称，联系人的摘要是此人的全名，因此普通的 Jira 文本搜索也能找到它们。客户或联系人重命名后，Gambit 会在 24 小时内更新所有引用它的工作项上的名称。
如果您的站点已有名为“Account”的字段（例如 Tempo 会添加一个），Gambit 的字段将命名为“Customer account”：请写作 "Customer account".name ~ "acme"。
空间和工作类型
初始设置向导会创建三个空间。下表为默认关键字；如果您选择了其他关键字，则可能与此不同。
| 空间 | 默认关键字 | 工作类型 |
|---|---|---|
| CRM | RBCRM | Deal、Lead、Follow-up、Renewal、Commitment、Approval request；应用专业服务套件后，还有 Quote、SOW 等套件工作类型 |
| Directory | RBDIR | Account、Contact |
| Activity | RBACT | Conversation（每个邮件线程一个）、Meeting |
CRM 空间还包含一个 Gambit Archive 工作项，只有 rainbook-admins 的成员才能打开。
Gambit 自有的字段
有四个字段属于 Gambit。您可以在 JQL 中搜索它们，也可以将它们添加到软件和服务工作项的面板和筛选器中。
| 字段 | 适用于 | JQL |
|---|---|---|
Account | 商机、销售线索、跟进、续约、联系人、对话、会议，以及您为其添加该字段的软件和服务空间中的工作项 | Account.key = RBDIR-12、Account.name ~ "acme"、Account.tier = Enterprise、Account.arr > 50000 |
People | 商机、销售线索、跟进、续约、对话、会议 | People.contacts = RBDIR-88、People.names ~ "doe"、People.roles = champion、People.contactRoles = "RBDIR-88:champion"、People.primary = RBDIR-88 |
Revenue impact | 关联了客户的软件和服务工作项 | 见下文 |
Health | 客户、商机、续约 | Health < 40 |
People 字段中的角色有 champion、economic-buyer、decision-maker、influencer、user、blocker 和 other（套件可能会增加更多角色）。Health 的取值范围为 0 到 100：Healthy 为 70 及以上，Watch 为 40 到 69，At risk 为 40 以下。
Revenue impact 记录涉及的金额以及所有关联的客户：
| 内容 | JQL |
|---|---|
| 关联客户的营收 | "Revenue impact.arr" > 100000 |
| 这些客户的未结销售管道 | "Revenue impact.pipeline" > 0 |
| 健康度低于 40 的客户的营收 | "Revenue impact.atRiskArr" > 0 |
| 关联客户 | "Revenue impact.accounts" = RBDIR-12、"Revenue impact.accountNames" ~ "acme" |
| 关联客户的数量 | "Revenue impact.accountCount" >= 3 |
| 最高层级 | "Revenue impact.topTier" = Enterprise |
| 最近的续约 | "Revenue impact.renewalDate" <= endOfDay("+90d") |
| 客户请求 | "Revenue impact.requests" >= 2 |
| 上次刷新时间 | "Revenue impact.asOf" >= -7d |
金额以您站点的报表币种显示。要按涉及的金额排序，请使用 ORDER BY frArr DESC（或 ORDER BY "Revenue impact.arr" DESC）；按 Revenue impact 列本身排序时，工作项是按其关联的客户排序，而不是按金额排序。
Gambit 设置的 Jira 字段
Gambit 还会创建普通的 Jira 字段，您可以像搜索其他字段一样搜索它们（例如 "Close date" <= endOfMonth() 或 Tier = Enterprise）。负责人使用的是 Jira 的经办人字段。
| 工作类型 | 字段 |
|---|---|
| Account | Domain、Other domains、Tier、ARR、Currency、Renewal date、Industry、Employees、Account team、Next step、Gambit summary |
| Contact | Email、Other emails、Phone、Mobile、Title、LinkedIn URL、Do not contact、Account key |
| Deal | Amount、Currency、Close date、Probability、Forecast category、Loss reason、Next step、Gambit summary、Account key、Shared with |
| Lead | Lead company、Lead email、Lead phone、Lead source、Disqualify reason |
| Renewal | Amount、Currency、ARR、Renewal date、Probability、Forecast category、Loss reason |
| Commitment | Promised date、Source quote |
| Conversation | Sent at（最新一条消息）、First sent at、Direction、Message count、Capture source |
| Meeting | Meeting start、Meeting end、Join link、Location、Capture source |
| Approval request | Approval kind、Approvers、Requested by、Expires at、Reject reason |
| 导入的记录 | Source system、Source ID、Original created |
在每个引用了客户的 Gambit 工作项上，Account key 都保存该客户的键（例如 RBDIR-12），因此 "Account key" ~ "RBDIR-12" 可用于任何搜索。Shared with 列出可以访问某个私有商机的人员。
使用自动化将记录移至另一个客户
要通过 Jira 自动化、批量更改、CSV 更新或 REST API 将联系人、商机或线索移到另一个客户，请设置以下两个字段之一：
- Account key（最简单）：在自动化的编辑工作项操作中，选择
Account key，然后输入新客户的键，例如RBDIR-12。Gambit 会将Account字段设置为该客户。 - Account：在同一操作的更多选项 › 其他字段中，输入该客户的全部四个值，其中
id是客户的工作项 ID，name是其摘要：
{ "fields": { "Account": { "v": 1, "key": "RBDIR-12", "id": "10123", "name": "Acme" } } }无论使用哪种方式，Gambit 都会按其自身编辑器的方式移动记录：移除旧客户的链接，联系人的任职关系移到新客户，记录的可见范围随新客户而定。批量更改会在接下来几分钟内移动其记录；如果记录过多，超出 Jira 一小时的限额，则会在下一个小时完成。
Gambit 会拒绝以下更改，并恢复记录原有的客户：不是 Directory 空间中客户的键或值、被清空的 Account key，以及在编辑界面要求填写该字段时被清空的 Account。
可搜索的属性
Gambit 还会在其工作项上保留可供搜索的属性。请使用下方的别名搜索这些属性。
| 别名 | 可查找内容 |
|---|---|
frType | Gambit 记录类型：deal、lead、renewal、conversation 等 |
frAccount | 某个客户的所有 Gambit 条目 |
frContacts | 涉及某位联系人的条目 |
frDeals、frPrimaryDeal | 关联到某个商机的条目 |
frSourceId | 记录在原 CRM 中的 ID |
frEmail | 按电子邮件地址查找联系人 |
frContactDomain、frEmployer | 按电子邮件域名或所任职的客户查找联系人 |
frDomain | 按网站域名查找客户 |
frJsmOrg | 映射到 Jira Service Management 组织的客户 |
frHealth、frHealthBand | 健康度评分，以及分级 healthy、watch 或 at-risk |
frArr、frPipelineValue、frAtRiskArr | 营收影响金额 |
frImpactAccounts、frTopTier | 营收影响涉及的客户和最高层级 |
frThreadEmail | 与某人往来的所有邮件线程 |
frPrivate | 有人设为私有的线程（"true"） |
frThreadKey、frRootMsg、frProviderThread | 按邮件标识符查找线程 |
frEventKey | 按日历标识符查找会议 |
frProposalKind、frTargets | 按类型和所更改的记录查找审批请求 |
frImportRunId、frImportBatchId | 某次导入创建的所有内容 |
frHandoffRunId | 某次交付交接创建的所有内容 |
搜索示例
客户与人员：
frEmail = "jane@acme.com"
frDomain = "acme.com"
project = RBDIR AND type = Account AND frHealthBand = "at-risk" ORDER BY ARR DESC
project = RBDIR AND type = Account AND "Renewal date" <= endOfDay("+90d") AND Health < 70商机与销售管道：
project = RBCRM AND type = Deal AND statusCategory != Done AND Account.name ~ "acme"
project = RBCRM AND type = Deal AND People.roles = champion AND "Close date" <= endOfQuarter()
frAccount = RBDIR-12 ORDER BY updated DESC电子邮件与会议：
frThreadEmail = "jane@acme.com" ORDER BY "Sent at" DESC
project = RBACT AND type = Conversation AND Account.name ~ "acme" AND "Sent at" >= -14d
project = RBACT AND type = Meeting AND "Meeting start" >= startOfDay() AND "Meeting start" <= endOfWeek()产品和支持工作的营收影响：
"Revenue impact.arr" > 100000 AND statusCategory != Done ORDER BY frArr DESC
project = SUP AND "Revenue impact.topTier" = Enterprise AND priority in (High, Highest)
type = Bug AND "Revenue impact.accountNames" ~ "acme"请将 RBCRM、RBDIR、RBACT 和 SUP 替换为您自己的空间键。与 Jira 中的其他搜索一样，搜索结果只包含您有权打开的工作项。
邮件线程上的评论
每封已采集的邮件都是其对话上的一条评论，包含发件人、收件人、发送时间、简短预览和附件。评论属性无法在 JQL 中搜索；请改为搜索线程，可以用 frThreadEmail 按参与者搜索，也可以用 text ~ "renewal" 按文本搜索。
如果您卸载
- Jira 自身的字段、评论、附件、链接、状态和筛选器都会保留，每个工作项上的
Account key也会保留。 - Gambit 的四个字段（Account、People、Revenue impact 和 Health）是应用字段：卸载后其值会消失，如果在 30 天内重新安装，这些值会恢复。
- Gambit 的搜索属性会保留在您的工作项上，但在重新安装 Gambit 之前，无法通过这些属性搜索。
管理员指南列出了您会保留的所有内容。