Gambitフィールドと JQL のリファレンス
Gambit が Jira に追加するすべてのフィールド、検索できるプロパティ、そして顧客、商談、メール、売上を名前で探すときにそのまま使える JQL を紹介します。
名前で検索
Gambit はコードだけでなく名前も保存します。そのため、普段の呼び方で人や会社を検索できます。取引先は「Acme Corp (RBDIR-12)」、人物は「Jane Doe, Raj Patel +2」のように、Jira がフィールドを表示するすべての場所に表示されます。対象は、ソフトウェア スペースやサービス スペースの作業項目、検索結果、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" と記述します。
スペースと作業タイプ
セットアップ ウィザードが 3 つのスペースを作成します。ここに示すのはデフォルトのキーです。別のキーを選択した場合は、異なることがあります。
| スペース | デフォルトのキー | 作業タイプ |
|---|---|---|
| CRM | RBCRM | Deal、Lead、Follow-up、Renewal、Commitment、Approval request。プロフェッショナル サービス パックを適用した場合は、Quote や SOW などのパック固有のタイプも含まれます |
| Directory | RBDIR | Account、Contact |
| Activity | RBACT | Conversation (メール スレッドごとに 1 件)、Meeting |
CRM スペースには、Gambit Archive 作業項目も 1 件あります。この作業項目を開けるのは rainbook-admins のメンバーだけです。
Gambit 独自のフィールド
Gambit には 4 つの専用フィールドがあります。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 です (パックによってロールが追加される場合があります)。ヘルスは 0 から 100 の範囲です。70 以上が「良好」、40 から 69 が「要注意」、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 |
Account key には、取引先を参照するすべての Gambit 作業項目で、その取引先のキー (例: RBDIR-12) が保持されます。そのため、どの検索でも "Account key" ~ "RBDIR-12" を使用できます。Shared with には、非公開の商談の共有先となっている人物が一覧表示されます。
自動化でレコードを別の取引先に移動する
Jira の自動化、一括変更、CSV による更新、REST API のいずれかで、取引先責任者、商談、リードを別の取引先に移動するには、次の 2 つのフィールドのどちらかを設定します。
- Account key (最も簡単): 自動化の [作業項目を編集] アクションで
Account keyを選び、新しい取引先のキーを入力します (例:RBDIR-12)。Gambit がAccountフィールドをその取引先に設定します。 - Account: 同じアクションの [その他のオプション] › [追加フィールド] に、取引先の 4 つの値をすべて入力します。
idは取引先の作業項目 ID、nameはその要約です。
{ "fields": { "Account": { "v": 1, "key": "RBDIR-12", "id": "10123", "name": "Acme" } } }どちらの方法でも、Gambit は自身の編集画面で変更したときと同じようにレコードを移動します。以前の取引先へのリンクは削除され、取引先責任者の所属は新しい取引先に移り、レコードを閲覧できるユーザーも新しい取引先に従います。一括変更では、数分以内にレコードが順次移動されます。その 1 時間に Jira が許可する処理量を超える大きさの一括変更は、次の 1 時間で完了します。
次の場合、Gambit は変更を受け付けず、レコードが属している取引先に戻します。Directory スペースの取引先ではないキーまたは値、空にした Account key、編集画面でフィールドが必須のときに空にした Account が該当します。
検索できるプロパティ
Gambit は、作業項目に検索用のプロパティも保持しています。次のエイリアスで検索できます。
| エイリアス | 検索対象 |
|---|---|
frType | Gambit のレコードタイプ: deal、lead、renewal、conversation など |
frAccount | ある取引先のすべての Gambit 項目 |
frContacts | 取引先責任者が関わる項目 |
frDeals、frPrimaryDeal | 商談にリンクされた項目 |
frSourceId | 以前の CRM でのレコードの ID |
frEmail | メールアドレスで見つける取引先責任者 |
frContactDomain、frEmployer | メール ドメイン、または勤務先の取引先で見つける取引先責任者 |
frDomain | Web ドメインで見つける取引先 |
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 | 1 回のインポートで作成されたすべての項目 |
frHandoffRunId | 1 回のデリバリー引き継ぎで作成されたすべての項目 |
検索の例
取引先と取引先責任者:
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 の 4 つのフィールド (Account、People、Revenue impact、Health) はアプリのフィールドです。アンインストールすると値は消えますが、30 日以内に再インストールすると元に戻ります。
- Gambit の検索プロパティは作業項目に残りますが、Gambit を再インストールするまで、それらを使った検索はできません。
残るものの一覧は、管理者ガイドをご覧ください。