> 継続的なプロセス改善 > 決算・レポーティング：期間決算と照合 > BlackLine > データテンプレート

決算・レポーティング：期間決算と照合のデータテンプレート

BlackLine

決算・レポーティング：期間決算と照合の属性(20) 決算・レポーティング：期間決算と照合のアクティビティ(14) データ抽出ガイド(1)

決算・レポーティング：期間決算と照合のデータテンプレート

このテンプレートでは、決算・レポーティングの期間決算と照合に関するデータを準備するための手順を詳しく説明します。収集する属性や追跡する重要なアクティビティに加え、データの抽出方法も紹介します。データ準備を効率よく進め、分析を円滑に始めるためにお役立てください。

収集を推奨する属性
追跡する主なアクティビティ
BlackLineからのデータ抽出ガイド

イベントログを初めて作成する方はこちら：プロセスマイニング用イベントログの作成方法.

テンプレートをダウンロード

決算・レポーティング：期間決算と照合の属性

決算・レポーティングの期間決算と照合プロセスを詳しく分析するために、イベントログに含めることを推奨するデータ項目です。

5 必須 6 推奨 9 任意

	名前	説明
	アクティビティ ActivityName	期間決算プロセス中に発生した、特定の業務イベントまたはタスクの名称です。
説明この属性は、「照合の準備完了」や「調整仕訳の転記」など、決算・レポーティングプロセスにおける個々のステップや節目を表します。これらのイベントを時系列に並べることで、会計期間ごとのプロセスフローを再構成できます。アクティビティの順序や頻度を分析すると、実際のプロセス経路、標準手順からの逸脱、プロセスが滞るボトルネックを特定できます。プロセスマップの作成や主要なパフォーマンス指標の算出にも欠かせません。重要な理由プロセスマップの基盤となり、プロセスフロー、バリアント、例外の可視化と分析を可能にします。入手先通常、Tasks、Journals、Account Reconciliationsなど、BlackLineの各種モジュールにあるイベントログ、タスクのステータス、監査証跡から取得します。例照合の準備完了照合の認証完了調整仕訳の転記期間決算の完了
	会計期間 FinancialPeriod	月次や四半期など、特定の財務報告サイクルを識別する一意のIDです。主なケース識別子として使用します。
説明会計期間は、特定の報告サイクルにおける勘定の締め処理と照合に関するすべてのアクティビティをまとめます。たとえば、「2023-01」は2023年1月の決算業務全体を表します。プロセスマイニングでは、この属性が期間決算プロセスのエンドツーエンドの所要時間を分析するうえで欠かせません。期間ごとのサイクルタイムを比較し、傾向や季節変動、時間の経過に伴うプロセス改善の影響を特定できます。重要な理由これは、関連するすべての決算業務と照合業務を結び付ける中核的な識別子です。各期間のプロセスフローとパフォーマンスを全体的に把握できます。入手先通常、BlackLineの期間決算または照合モジュールにある報告期間のコンテキストから取得します。年と月の項目を組み合わせる場合もあります。例 2023-122024年第1四半期2023-092024年度第3期間
	開始時刻 EventTime	アクティビティまたはイベントの開始時刻を示すタイムスタンプです。
説明 EventTimeは、期間決算プロセスの特定のステップが始まった日時を正確に示します。イベントを正しい順序に並べ、プロセスの各ステップ間の所要時間を計算するうえで重要です。分析では、この属性を使ってケースごとのイベントログを時系列で作成します。サイクルタイム、待ち時間、処理時間など、時間に関するすべての指標を算出する基準となり、遅延や非効率な箇所の特定に役立ちます。重要な理由イベントの順序付け、プロセスフローの把握、所要時間に基づくパフォーマンス指標の算出に欠かせないタイムスタンプです。入手先 BlackLineのタスク、照合、仕訳レコードにある作成日、開始日、またはステータス変更時刻に該当します。例 2023-10-02T09:00:00Z2023-10-05T14:30:15Z2023-10-10T11:21:05Z
	ソースシステム SourceSystem	イベントデータの抽出元となるシステムです。
説明この属性は、プロセスデータの取得元を示します。このビューでは一貫して「BlackLine」となりますが、複数のシステムを対象とする場合は、データソースの区別に役立ちます。複数システムを対象とする分析では、この項目がデータの来歴を把握し、システムごとのパフォーマンスを比較するうえで重要です。単一システムのビューでも、データガバナンスと管理に必要なコンテキストを提供します。重要な理由データの取得元に関する重要なコンテキストを示します。データガバナンス、検証、他システムとの連携に欠かせない情報です。入手先通常、データ変換の際にレコードの取得元を示す固定値として追加します。例 BlackLineBlackLine-APIBlackLine-Reporting
	最終データ更新日時 LastDataUpdate	ソースシステムからデータが最後に更新された日時を示すタイムスタンプです。
説明この属性は、データセットが最後に更新された日時を示します。分析対象データの新しさを把握できるため、インサイトがどの時点の状況を反映しているかを確認できます。ダッシュボードを見るユーザーが分析の鮮度を把握するうえで重要です。期待値の調整に役立ち、十分に新しいデータに基づいて意思決定が行われていることを確認できます。重要な理由データがいつ更新されたかをユーザーに知らせます。分析に基づいて適切なタイミングで業務上の意思決定を行ううえで重要です。入手先このタイムスタンプは、データの抽出、変換、読み込み（ETL）の過程で生成され、保存されます。例 2024-03-15T02:00:00Z2024-03-16T02:00:00Z
	会社コード CompanyCode	財務活動を行う法人を識別するコードです。
説明会社コードは、組織内の特定の法人を表します。決算業務は、連結処理の前に会社コードごとに個別に行われることがよくあります。この属性は、法人単位で決算プロセスを分析するうえで重要です。法人間の実績を比較できるため、特に会社間照合の所要時間を分析する際に役立ちます。また、決算プロセスが複雑、または非効率な法人を特定できます。重要な理由法人ごとにプロセスを分けて分析できるため、法人固有のボトルネックやパフォーマンス上の問題を特定するうえで役立ちます。入手先 BlackLineおよび接続元のERPでは、仕訳や照合など、ほとんどの財務取引で標準項目として利用できます。例 1000US01DE012500
	担当ユーザー ResponsibleUser	アクティビティを実行した、または担当するユーザーのIDまたは名前です。
説明この属性は、照合の準備や仕訳の転記など、特定のタスクを担当する個人を示します。ユーザー名、従業員ID、メールアドレスなどが該当します。担当ユーザー別のデータ分析は、業務量の分布、個人のパフォーマンス、トレーニングの必要性を把握するうえで重要です。高い成果を上げている担当者、業務が均等に割り当てられているか、手戻りやエラーが頻発している箇所などを確認できます。重要な理由業務量の分布分析、特定のユーザーグループに起因するボトルネックの特定、チームのパフォーマンス評価に欠かせません。入手先 BlackLineの各モジュールにある「割り当て先」「完了者」「作成担当者」「認証担当者」「承認者」などの項目から取得できます。例 john.doejane.smithuser123
	照合ステータス ReconciliationStatus	照合タスクの現在または最終のステータスです。
説明この属性は、特定の時点における照合の状態を記録します。たとえば、「未開始」「進行中」「認証済み」「差し戻し」などです。個々の照合の進捗と結果を把握できます。ステータス別の分析は、照合ステータス内訳ダッシュボードに欠かせません。管理者は、保留中、完了、または対応が必要な照合の件数をすぐに確認できます。ステータスの変化を追跡すると、手戻りのサイクルやレビュー・承認サイクルの遅延を特定できます。重要な理由照合の進捗と結果を明確に把握でき、滞留の特定や手順の遵守状況の確認に役立ちます。入手先 BlackLineのAccount Reconciliationsモジュールにあるレコードのステータス項目から直接取得できます。例作成済み認証済み承認済み却下済み期限超過
	終了時刻 EventEndTime	アクティビティまたはイベントの完了時刻を示すタイムスタンプです。
説明 EventEndTimeは、特定のタスクが完了した日時を正確に示します。StartTimeと組み合わせて、個々のアクティビティの処理時間を算出します。分析では、各ステップにかかった時間を算出するうえでEndTimeが重要です。プロセス全体の中で時間を要しているアクティビティを特定でき、ボトルネック分析やリソース配分の評価の基礎となります。重要な理由アクティビティの処理時間を算出できるため、ボトルネックの特定や業務効率の測定に欠かせません。入手先 BlackLineのタスク、照合、仕訳レコードにある完了日、最終更新日、または特定のステータス変更時刻に該当します。例 2023-10-02T11:30:00Z2023-10-05T15:00:45Z2023-10-10T11:25:10Z
	総勘定元帳勘定 GLAccount	照合または仕訳に関連付けられた総勘定元帳の勘定番号です。
説明この属性は、照合または調整の対象となる勘定科目表の個別の勘定を識別します。プロセス内のアクティビティを財務面から詳しく把握できます。手動仕訳調整の傾向ダッシュボードでは、総勘定元帳勘定ごとの分析が欠かせません。手作業による対応が多い勘定を特定できます。また、同じ期間内に同一勘定で複数の調整や照合が行われた場合、手戻りの検出にも役立ちます。重要な理由財務面の状況を把握し、誤りが起きやすい勘定、頻繁な調整が必要な勘定、決算の遅延につながる勘定を特定できます。入手先 BlackLineのAccount ReconciliationsモジュールとJournal Entryモジュールにある主要項目です。例 101000405020210010
	部門 Department	アクティビティまたはユーザーに関連する機能部門やチームです。
説明部門属性は、アクティビティを担当する「経理部門」や「内部監査」などの事業部門を示します。ユーザープロフィールやタスクの内容から取得することがよくあります。この情報を使うと、組織内の各部門でプロセスのパフォーマンスを比較できます。効率の高い部門、決算期間中に追加のリソースが必要な部門、部門間の引き継ぎで遅延が発生している箇所を特定できます。重要な理由異なる事業部門間のパフォーマンス比較が可能になり、部門単位の業務量やボトルネックの分析に役立ちます。入手先 BlackLineまたは関連するERPシステムで、担当ユーザーに関連付けられたユーザープロフィールデータ、あるいはタスクや総勘定元帳勘定のプロパティから取得できます。例経理部門財務計画・分析内部監査税務
	仕訳ID JournalId	個々の仕訳を識別する一意のIDです。
説明仕訳IDは、BlackLineで作成・転記された手動調整仕訳ごとに割り当てられる一意のキーです。仕訳の作成から転記まで、個別に追跡できます。手動仕訳調整の傾向ダッシュボードで重要な役割を果たします。手動調整の正確な件数を集計できるほか、データやプロセスに潜む問題の兆候となる個別の仕訳をドリルダウンして調査できます。重要な理由手動仕訳ごとに一意に識別できるため、調整件数の集計や、調整件数が多い根本原因の調査に役立ちます。入手先 BlackLineのJournalsモジュールで、仕訳ごとにシステムが自動生成する一意のIDです。例 JRN-2023-10-001JRN-2023-10-002ADJ-58321
	完了目標日 TargetCompletionDate	会計期間の決算を完了する予定日です。
説明この属性は、決算プロセスを完了するための正式な期限を表します。実際の完了時刻を評価する際の基準となります。「期限内の期間決算率」という重要業績評価指標（KPI）の算出に必要な日付です。「期間決算完了」アクティビティの実際の完了時刻と目標日を比較することで、期限に遅れた期間を特定し、遅延の程度を測定できます。コンプライアンスとレポーティングの観点からも重要です。重要な理由期限内に完了したかを測る基準となり、「期限内の期間決算率」など、コンプライアンスに関する重要業績評価指標（KPI）の算出に欠かせません。入手先通常、この日付はBlackLineの決算カレンダーまたはタスク管理設定で指定します。例 2023-10-15T23:59:59Z2024-01-12T23:59:59Z
	手戻りかどうか IsRework	手戻りのループに含まれるアクティビティを特定する計算済みフラグです。
説明プロセスで不要な手順の繰り返しが発生していることを示すアクティビティに、このフラグが設定されます。たとえば、同じ照合で「照合却下」の後に再び「照合準備」が行われた場合、手戻りとして判定されます。手戻りの特定は、プロセスの非効率や品質上の問題を明らかにするうえで重要です。「照合の手戻り率」という重要業績評価指標（KPI）はこの属性をもとに算出されます。初回で正しく完了できず、作業の無駄や遅延が生じている箇所を把握できます。重要な理由非効率なプロセスのループや作業の繰り返しを特定し、無駄な作業を数値化するとともに、品質上の問題の根本原因を探るのに役立ちます。入手先通常、プロセスマイニングツールのアルゴリズムが、同じケース内で繰り返されるアクティビティの並びを検出して算出します。同じ照合IDや総勘定元帳勘定が関係することがよくあります。例 truefalse
	期限内完了かどうか IsOnTime	期間決算が目標日までに完了したかを示す計算済みフラグです。
説明この真偽値の属性は、「期間決算完了」アクティビティの実際の完了時刻と、その会計期間の完了目標日を比較して算出します。期限を守れたかどうかを明確に示します。このフラグは、「期限内の期間決算率」という重要業績評価指標（KPI）の算出に使います。期限内に完了した期間と遅れた期間を簡単に絞り込み、可視化できるため、期限を過ぎた期間をすばやく特定して詳しく調査できます。重要な理由期限を守れなかったケースが明確になるため、実績を追跡しやすくなり、コンプライアンスやSLAのレポーティングにも役立ちます。入手先プロセスマイニングツールで、最後の「期間決算完了」アクティビティのタイムスタンプと完了目標日属性を比較して算出します。例 truefalse
	照合ID ReconciliationId	個々の勘定照合タスクを識別する一意のIDです。
説明照合IDは、会計期間内に特定の総勘定元帳勘定に対して行われる各照合に割り当てられる一意のキーです。これにより、個々の照合がプロセスを進む状況を正確に追跡できます。分析では、このIDを使って、同じ勘定で異なる時期に行われた照合を区別できます。詳細なドリルダウン、個別の問題の調査、各項目のステータスや履歴の正確な追跡に役立ちます。重要な理由照合項目ごとに一意のキーを付与して追跡できるため、詳細な分析や問題箇所のドリルダウンが可能になります。入手先 BlackLineのAccount Reconciliationsモジュールで、照合レコードごとにシステムが自動生成する一意のIDです。例 REC-893475REC-893476REC-893477
	照合タイプ ReconciliationType	照合を貸借対照表、損益計算書、会社間などに分類します。
説明この属性は、実施する照合の種類を分類します。照合の種類によって、複雑さやリスク、想定される完了時間が異なるため、重要な項目です。この属性で分析を分類すると、照合の種類ごとに実績や課題を比較できます。たとえば、会社間照合に標準的な貸借対照表の照合より大幅に時間がかかっているかを確認できます。重要な理由照合の種類ごとに分析を分けられます。種類によって複雑さやリスクの傾向が異なる場合に役立ちます。入手先総勘定元帳勘定のプロパティ、またはBlackLineの照合テンプレート設定から取得できます。例貸借対照表損益計算書会社間銀行勘定調整
	自動処理かどうか IsAutomated	アクティビティをシステムと人のどちらが実行したかを示す真偽値です。
説明このフラグは、低リスクの照合の自動認証など、システムが自動実行したタスクと、ユーザーが手作業で行ったタスクを区別します。決算プロセスの自動化の度合いを把握するうえで重要です。この属性を分析すると、自動化の取り組みがもたらした効果を測定できます。自動処理と手作業の速度や一貫性を比較し、効率を高めて人為的なミスを減らすために、さらなる自動化の機会を特定できます。重要な理由プロセスの自動化の度合いを測定し、手作業のタスクを自動化できる箇所を特定して、効率向上につなげられます。入手先担当ユーザーがシステムアカウントまたはサービスアカウントかどうかを確認するか、BlackLineのタスクプロパティにある特定のフラグから判定できます。例 truefalse
	調整額 AdjustmentAmount	手動調整仕訳の金額です。
説明この属性は、手動調整による財務上の影響を記録します。単一の金額として、または借方と貸方の金額を分けて表すことができます。調整件数だけでなく金額も分析すると、影響の大きさをより詳しく把握できます。特定の勘定や部門で高額または頻繁な調整が発生している場合、財務報告上の重大なリスクや、上流プロセスにおける大きな問題を示している可能性があります。重要な理由手動調整による財務上の影響を数値化し、高額な変更が発生している領域の調査に優先順位を付けられます。入手先 BlackLineのJournalsモジュールにある金額項目から取得できます。例 1500.75-250.0010000.00
	通貨 Currency	金額の通貨コードです。例：USD、EUR。
説明この属性は、調整額の通貨を示します。多国籍の組織では、仕訳にさまざまな現地通貨が使われます。通貨は、金額を正しく解釈するために必要な属性です。金額を正確に集計・比較できるようにし、分析やレポーティングにあたって標準通貨への換算が必要な場合にも役立ちます。重要な理由金額を正しく解釈するための情報を提供し、レポーティングに向けた適切な通貨換算を可能にします。入手先通常、BlackLineのJournalsモジュールの金額項目の近く、または関連する会社コードのプロパティにあります。例 USDEURGBPJPY

必須推奨任意

決算・レポーティング：期間決算と照合のアクティビティ

プロセスを正確に把握し、ボトルネックを特定するために、イベントログに記録する主なプロセスの手順と節目を示します。

6 推奨 8 任意

	アクティビティ	説明
	期間決算の完了	これは最終アクティビティで、決算関連のすべてのタスクが完了し、会計期間が正式に締められたことを示します。この期間には、これ以上取引を転記できません。
重要な理由これはプロセスの主な終了イベントです。期間決算全体のサイクルタイムと、期限内決算率の算出に使用します。入手先 BlackLineのClose Managementモジュールで、期間全体のステータスが「クローズ」に設定された時点で取得できます。または、決算計画の最終タスクの完了タイムスタンプから推定できます。記録期間のステータスが「クローズ」になった時刻、または最後に完了したタスクのタイムスタンプを特定します。イベントタイプ inferred
	決算期間の開始	このアクティビティは、特定の会計期間における決算プロセスの正式な開始を示します。通常、BlackLineのClose Managementモジュールで予定されたイベントとして登録され、タスクがアクティブになり、期間が「オープン」に設定されます。
重要な理由これはプロセスの主な開始イベントです。期間決算全体のサイクルタイムやソースデータ収集のリードタイムなど、すべてのサイクルタイム計算はこの時点から始まります。入手先このイベントは、BlackLineのClose Management（Task Management）モジュールから取得できると考えられます。決算計画の有効化日、または該当する会計期間で最も早いタスク開始日から推定できます。記録決算スケジュールで、タスクまたは期間が「アクティブ」になった時点に関連する最も早いタイムスタンプを特定します。イベントタイプ inferred
	照合の承認完了	勘定照合の最終承認を示し、すべてのレビュー段階が完了したことを表します。照合が最終的な承認済みステータスになった時点で、このイベントが記録されます。
重要な理由これは重要な業務単位の完了を示す節目です。照合のエンドツーエンドのサイクルタイムを測定し、承認のボトルネックを特定するうえで欠かせません。入手先 BlackLineのAccount Reconciliationモジュールにおける最終承認ステータスの変更時刻から推定します。照合のワークフローが完全に完了した時点で発生します。記録照合のステータスが「承認済み」またはワークフローの最終承認状態に変わった時点でイベントが生成されます。イベントタイプ inferred
	照合の認証完了	担当者が勘定照合の作業を完了し、正式にレビューへ提出した時点を示します。通常、BlackLineのAccount Reconciliationモジュールで照合オブジェクトのステータスが変更されたときに記録されます。
重要な理由これはプロセスにおける重要な引き継ぎ地点です。認証から承認までの時間を分析すると、照合レビューのワークフローにおけるボトルネックが明らかになり、照合承認時間の重要業績評価指標（KPI）の把握にも役立ちます。入手先 Account Reconciliationモジュールのステータス変更時刻から推定します。照合のステータスが「認証済み」またはレビュー可能な状態を示す同様のステータスに変わった時点でイベントが発生します。記録照合のステータス項目が「認証済み」に変わった時点でイベントが生成されます。イベントタイプ inferred
	調整仕訳の転記	BlackLineで作成した調整仕訳が、ソースERPシステムの総勘定元帳に正常に転記された状態です。修正が正式に記録されたことを示します。
重要な理由このアクティビティは、手動調整仕訳数の重要業績評価指標（KPI）に直接関係します。また、手作業での修正が頻繁に必要となるデータ品質の低い領域や統制上の弱点を特定するうえで重要です。入手先 BlackLineのJournal Entryモジュールでステータスが変更されたときに記録されます。仕訳のステータスが「転記済み」に更新された時点でイベントが発生し、多くの場合、ERPとの連携によって確認されます。記録仕訳のステータスが「転記済み」に変わった時点でイベントを記録します。イベントタイプ inferred
	財務諸表の作成	貸借対照表や損益計算書などの正式な財務諸表が作成された状態です。主要な報告資料一式がそろったことを示す重要な節目です。
重要な理由会計プロセスから財務報告と分析への移行を示します。このアクティビティを追跡すると、決算の最終報告段階の効率を測定できます。入手先 BlackLineのClose Managementモジュールで重要なタスクとして管理されると考えられます。このタスクの完了は、財務諸表がレビュー可能な状態になったことを示します。記録決算計画にある「財務諸表の作成」タスクの完了タイムスタンプを取得します。イベントタイプ inferred
	ソースデータの読み込み完了	ERPなどのソースシステムからBlackLineへの取引データの読み込みが完了したことを示します。この処理は、その期間の照合や仕訳入力を開始するための前提条件です。
重要な理由データの読み込みが遅れると、決算プロセス全体の大きなボトルネックになります。このアクティビティを追跡すると、データ収集のリードタイムを測定し、上流のデータソースに関する問題を特定できます。入手先 Close Managementモジュール内の特定タスクの完了として記録される場合があります。または、該当する会計期間について、BlackLineに最初にインポートされた取引のタイムスタンプから推定できます。記録特定の「データ読み込み」タスクの完了タイムスタンプを取得するか、該当期間で最も早い取引インポートのタイムスタンプを使用します。イベントタイプ inferred
	タスクの完了	期間決算チェックリスト内の特定のタスクを、割り当てられたユーザーが完了済みにした状態です。統制チェックや報告手順など、定義された手順の完了を示します。
重要な理由タスクの完了状況を分析すると、決算期間中の進捗を詳細に把握できます。全体のスケジュールに遅れを生じさせている具体的なステップを特定するのに役立ちます。入手先 BlackLineのClose Management（Task Management）モジュールで明示的なイベントとして記録されます。ユーザーがタスクを完了済みにすると、その完了タイムスタンプが記録されます。記録ユーザーがタスクのステータスを「完了」に更新した時点で記録されます。イベントタイプ explicit
	期限超過の決算タスク	予定されていた決算タスクが、完了しないまま設定された期限を過ぎた状態です。現在時刻とタスクの期限を比較して算出するイベントです。
重要な理由決算期限に深刻な影響が出る前に、コンプライアンス上の問題や潜在的なボトルネックを把握できます。決算プロセスに先手を打って対応できます。入手先これはシステムに明示的に記録されるイベントではありません。Close Managementモジュールのデータにあるタスク完了タイムスタンプと期限の属性を比較して算出する必要があります。記録「タスク期限」と「タスク完了タイムスタンプ」を比較して算出します。完了時刻が期限を過ぎている場合、そのタスクは期限超過です。イベントタイプ calculated
	照合のレビュー完了	照合が少なくとも1段階のレビューを通過したことを示します。複数段階の承認ワークフローでは、最終承認前の中間承認にあたります。
重要な理由このアクティビティを確認すると、複雑な承認プロセスのどこで遅延が発生しているかを把握できます。初回レビューにかかる時間と、その後の上位者による承認時間を分けて分析できます。入手先 Account Reconciliationモジュールのステータス変更から推定します。レビュー権限を持つユーザーが、ワークフローを完了させない承認操作を行った時点で記録されます。記録照合のステータスが「レビュー済み」や「レベル1承認済み」などの中間承認ステータスに変わった時点でイベントを記録します。イベントタイプ inferred
	照合の差し戻し	レビュー担当者が認証済みの照合を差し戻し、修正のため担当者に返した状態です。このイベントは品質上の問題や例外を示し、手戻りのサイクルが始まったことを表します。
重要な理由このアクティビティは、プロセス品質と手戻りの測定に欠かせません。差し戻しが頻繁に発生する場合、トレーニング不足、方針の不明確さ、またはデータ品質の問題が考えられます。入手先 Account Reconciliationモジュールのステータス変更から推定します。照合のステータスが「差し戻し」に変更されたとき、または担当者のキューに戻されたときに記録されます。記録照合のステータス項目が「差し戻し」または同様の状態に更新された時点でイベントが発生します。イベントタイプ inferred
	照合の準備完了	ユーザーが勘定照合に必要な作業を行ったものの、レビューにはまだ正式に提出していない状態です。照合が「進行中」または「準備完了」を示すステータスで保存された時点で、このイベントが記録されます。
重要な理由このアクティビティを追跡すると、照合に必要な初期作業を把握できます。この時点から認証までに長い時間がかかる場合、照合が複雑であるか、担当者の業務量に問題がある可能性があります。入手先 BlackLineのAccount Reconciliationモジュールにおけるステータス変更から推定します。照合が「未開始」からアクティブな状態に初めて移行した時点に該当します。記録照合のステータスが「未開始」から「進行中」などに変わった時点でイベントを記録します。イベントタイプ inferred
	試算表の作成	試算表の暫定版または最終版が作成され、レビューされた時点を示します。最終的な財務諸表を作成する前の重要な節目です。
重要な理由このアクティビティは、決算プロセスにおける重要な統制ポイントです。安定した試算表の作成に遅れが生じている場合、先行する照合や仕訳入力のステップに大きな問題がある可能性があります。入手先 BlackLineのClose Managementモジュールで、特定のマイルストーンタスクとして管理されることがよくあります。このタスクの完了は、試算表の準備が整ったことを示します。記録決算計画にある特定の「試算表の作成」タスクの完了タイムスタンプを取得します。イベントタイプ inferred
	調整仕訳の作成	ユーザーが照合中に必要な調整を特定し、BlackLineで仕訳を作成した状態です。この仕訳は、まだERPシステムに転記されていません。
重要な理由仕訳の作成を追跡すると、調整の件数や発生時期を把握できます。問題の特定と、転記による最終的な解決を区別できます。入手先 BlackLineのJournal Entryモジュールで明示的なイベントとして記録されると考えられます。該当期間の新しい仕訳レコードが作成されると、このイベントが発生します。記録ユーザーが新しい仕訳を保存した時点でログに記録されます。イベントタイプ explicit

推奨任意

データ抽出ガイド

BlackLineからデータを取得する方法

ステップ

前提条件：BlackLine APIアクセスの設定
- 管理者権限でBlackLineの環境にログインします。
- 管理セクションに移動し、API管理を開きます。表示されない場合は、BlackLineの管理者にお問い合わせください。
- 新しいAPIアプリケーション登録を作成し、クライアントIDとクライアントシークレットを取得します。
- 照合、タスク、仕訳、ユーザーデータに必要な読み取りスコープがアプリケーションに付与されていることを確認します。
- スクリプトの認証に使うリフレッシュトークンをアプリケーション用に発行します。
- クライアントID、クライアントシークレット、リフレッシュトークンを安全に保管します。
Python環境の準備
- Python 3.8以降がシステムにインストールされていることを確認します。
- ターミナルまたはコマンドプロンプトを開き、次のコマンドを実行して必要なライブラリをインストールします：pip install requests pandas
Pythonスクリプトの設定
- 「クエリ」セクションにあるPythonコードを、たとえばextract_blackline_data.pyという名前で保存します。
- ファイルをテキストエディターで開き、先頭にある設定セクションを確認します。
- BLACKLINE_BASE_URL、CLIENT_ID、CLIENT_SECRET、REFRESH_TOKENの仮の値を、手順1で取得した認証情報に置き換えます。
- START_DATEとEND_DATEの変数にデータ抽出期間を設定します。日付は「YYYY-MM-DD」形式で指定します。
スクリプトの処理内容の確認
- スクリプトはまず、指定された認証情報を使ってBlackLine APIに認証し、一時的なアクセストークンを取得します。
- 次に、指定した日付範囲内の照合、タスク、仕訳データを取得するAPI呼び出しを順番に実行します。
- APIのページネーションに対応する処理が含まれているため、最初のページだけでなく、すべてのレコードを取得できます。
データ変換とイベントの作成
- 取得した各レコード（照合、タスク、仕訳）を1つ以上のイベントに変換します。
- たとえば、APIから取得した1件の照合レコードから、データ内の異なるタイムスタンプ項目に基づいて、「照合準備完了」「照合認証済み」「照合承認済み」などのイベントログ行を複数作成できます。
- BlackLineのタスクリストから事前に定義した特定の名前を探し、「決算期間開始」や「財務諸表作成」などの主要な節目となるアクティビティを特定します。スクリプト内のMILESTONE_TASK_MAPPING辞書を更新し、BlackLineの設定にあるタスク名と完全に一致させてください。
スクリプトの実行
- ターミナルまたはコマンドプロンプトを開き、スクリプトを保存したディレクトリに移動します。
- 次のコマンドでスクリプトを実行します：python extract_blackline_data.py
- データの取得と処理の進行状況が、コンソールに表示されます。
出力ファイルの確認
- スクリプトの実行が完了すると、同じディレクトリにblackline_event_log.csvという名前のCSVファイルが作成されます。
- このファイルには、ProcessMindへのアップロードに必要な列を含むイベントログが保存されます。
- CSVファイルを開き、データが正しく、漏れなく含まれていることを確認してからアップロードします。

設定

API認証情報：スクリプトには、BlackLine環境で登録したAPIアプリケーションのCLIENT_ID、CLIENT_SECRET、REFRESH_TOKENが必要です。これらは機密情報として取り扱ってください。
BlackLineのベースURL：BlackLine環境のAPIベースURLを指定します。例：https://api.blackline.com/v2。
日付範囲：START_DATEとEND_DATEのパラメーターで抽出期間を指定します。初回の抽出では、分析に必要なデータを確保しつつデータ量を適切に保つため、3～6か月を推奨します。
節目となるタスクの対応付け：「期間終了」や「試算表作成」などの主要なプロセス上の節目を特定できるかどうかは、スクリプトのMILESTONE_TASK_MAPPING辞書に依存します。この対応付けを設定し、BlackLineのClose Managementで該当するタスク名と完全に一致させてください。
ページネーションの上限：LIMIT変数で、API呼び出しごとに要求するレコード数を指定します。通常は既定値で十分ですが、パフォーマンスやAPIサーバーの推奨事項に応じて調整できます。
前提条件：APIユーザーアカウントには、Account Reconciliations、Task Management、Journal Entryモジュールの読み取り権限が必要です。権限がない場合、スクリプトが失敗するか、データが不完全になる可能性があります。

クエリの例 python

import requests
import pandas as pd
import datetime
import time
import os

class=class="hl-string">"hl-comment"># --- CONFIGURATION SECTION --- #
class=class="hl-string">"hl-comment"># Replace with your BlackLine instance details
BLACKLINE_BASE_URL = class="hl-string">"https://[your-instance].blackline.com/v2" class=class="hl-string">"hl-comment"># e.g., https://api.blackline.com/v2
CLIENT_ID = os.environ.get(class="hl-string">'BLACKLINE_CLIENT_ID', class="hl-string">"YOUR_CLIENT_ID")
CLIENT_SECRET = os.environ.get(class="hl-string">'BLACKLINE_CLIENT_SECRET', class="hl-string">"YOUR_CLIENT_SECRET")
REFRESH_TOKEN = os.environ.get(class="hl-string">'BLACKLINE_REFRESH_TOKEN', class="hl-string">"YOUR_REFRESH_TOKEN")

class=class="hl-string">"hl-comment"># Date range for extraction (YYYY-MM-DD)
START_DATE = class="hl-string">"2023-01-01"
END_DATE = class="hl-string">"2023-06-30"

class=class="hl-string">"hl-comment"># API request settings
LIMIT = 100 class=class="hl-string">"hl-comment"># Records per page

class=class="hl-string">"hl-comment"># Mapping of BlackLine Task Names to ProcessMind Activity Names
class=class="hl-string">"hl-comment"># CRITICAL: Update these keys to match the exact names of tasks in your BlackLine instance.
MILESTONE_TASK_MAPPING = {
    class="hl-string">"Period Open": class="hl-string">"Period Open For Close",
    class="hl-string">"Load Source System Data": class="hl-string">"Source Data Loaded",
    class="hl-string">"Generate Preliminary Trial Balance": class="hl-string">"Trial Balance Generated",
    class="hl-string">"Generate Final Financial Statements": class="hl-string">"Financial Statements Generated",
    class="hl-string">"Close Period - Final": class="hl-string">"Period Closed"
}
class=class="hl-string">"hl-comment"># --- END CONFIGURATION --- #

def get_access_token():
    class="hl-string">"""Authenticates with BlackLine API to get an access token."""
    auth_url = fclass="hl-string">"{BLACKLINE_BASE_URL.replace('/v2', '')}/oauth/token"
    payload = {
        class="hl-string">'grant_type': class="hl-string">'refresh_token',
        class="hl-string">'refresh_token': REFRESH_TOKEN,
        class="hl-string">'client_id': CLIENT_ID,
        class="hl-string">'client_secret': CLIENT_SECRET
    }
    try:
        response = requests.post(auth_url, data=payload)
        response.raise_for_status()
        return response.json()[class="hl-string">'access_token']
    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">"Error getting access token: {e}")
        return None

def fetch_paginated_data(endpoint, headers, params):
    class="hl-string">"""Fetches all data from a paginated BlackLine API endpoint."""
    all_data = []
    url = fclass="hl-string">"{BLACKLINE_BASE_URL}/{endpoint}"
    offset = 0
    while True:
        params[class="hl-string">'offset'] = offset
        try:
            response = requests.get(url, headers=headers, params=params)
            response.raise_for_status()
            data = response.json()
            records = data.get(class="hl-string">'data', [])
            all_data.extend(records)

            if len(records) < LIMIT:
                break
            offset += LIMIT
            time.sleep(0.5) class=class="hl-string">"hl-comment"># Be respectful to the API rate limits
        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Error fetching data from {endpoint}: {e}")
            break
    return all_data

def main():
    class="hl-string">"""Main function to extract, transform, and save BlackLine data."""
    print(class="hl-string">"Starting BlackLine data extraction...")
    access_token = get_access_token()
    if not access_token:
        return

    headers = {
        class="hl-string">'Authorization': fclass="hl-string">'Bearer {access_token}',
        class="hl-string">'Content-Type': class="hl-string">'application/json'
    }

    event_log = []
    last_data_update = datetime.datetime.now().isoformat()

    class=class="hl-string">"hl-comment"># 1. Fetch and process Reconciliations
    print(class="hl-string">"Fetching reconciliations...")
    rec_params = {class="hl-string">'limit': LIMIT, class="hl-string">'updatedAfter': START_DATE, class="hl-string">'updatedBefore': END_DATE}
    reconciliations = fetch_paginated_data(class="hl-string">'reconciliations', headers, rec_params)
    for rec in reconciliations:
        common_attrs = {
            class="hl-string">'FinancialPeriod': rec.get(class="hl-string">'periodName'),
            class="hl-string">'CompanyCode': rec.get(class="hl-string">'companyCode'),
            class="hl-string">'GLAccount': rec.get(class="hl-string">'accountNumber'),
            class="hl-string">'Department': rec.get(class="hl-string">'preparer', {}).get(class="hl-string">'department'),
            class="hl-string">'SourceSystem': class="hl-string">'BlackLine',
            class="hl-string">'LastDataUpdate': last_data_update
        }
        if rec.get(class="hl-string">'preparedDate'):
            event_log.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Reconciliation Prepared', class="hl-string">'EventTime': rec[class="hl-string">'preparedDate'], class="hl-string">'ResponsibleUser': rec.get(class="hl-string">'preparer', {}).get(class="hl-string">'username'), class="hl-string">'ReconciliationStatus': class="hl-string">'Prepared'}) 
        if rec.get(class="hl-string">'certifiedDate'):
            event_log.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Reconciliation Certified', class="hl-string">'EventTime': rec[class="hl-string">'certifiedDate'], class="hl-string">'ResponsibleUser': rec.get(class="hl-string">'preparer', {}).get(class="hl-string">'username'), class="hl-string">'ReconciliationStatus': class="hl-string">'Certified'}) 
        if rec.get(class="hl-string">'reviewedDate'): class=class="hl-string">"hl-comment"># This may represent first or last review depending on config
            event_log.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Reconciliation Reviewed', class="hl-string">'EventTime': rec[class="hl-string">'reviewedDate'], class="hl-string">'ResponsibleUser': rec.get(class="hl-string">'reviewer', {}).get(class="hl-string">'username'), class="hl-string">'ReconciliationStatus': class="hl-string">'Reviewed'}) 
        if rec.get(class="hl-string">'rejectedDate'):
            event_log.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Reconciliation Rejected', class="hl-string">'EventTime': rec[class="hl-string">'rejectedDate'], class="hl-string">'ResponsibleUser': rec.get(class="hl-string">'reviewer', {}).get(class="hl-string">'username'), class="hl-string">'ReconciliationStatus': class="hl-string">'Rejected'}) 
        if rec.get(class="hl-string">'approvedDate'):
            event_log.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Reconciliation Approved', class="hl-string">'EventTime': rec[class="hl-string">'approvedDate'], class="hl-string">'ResponsibleUser': rec.get(class="hl-string">'approver', {}).get(class="hl-string">'username'), class="hl-string">'ReconciliationStatus': class="hl-string">'Approved'}) 

    class=class="hl-string">"hl-comment"># 2. Fetch and process Tasks
    print(class="hl-string">"Fetching tasks...")
    task_params = {class="hl-string">'limit': LIMIT, class="hl-string">'updatedAfter': START_DATE, class="hl-string">'updatedBefore': END_DATE}
    tasks = fetch_paginated_data(class="hl-string">'tasks', headers, task_params)
    today = datetime.datetime.now().isoformat()
    for task in tasks:
        common_attrs = {
            class="hl-string">'FinancialPeriod': task.get(class="hl-string">'periodName'),
            class="hl-string">'CompanyCode': task.get(class="hl-string">'companyCode'),
            class="hl-string">'GLAccount': None,
            class="hl-string">'Department': task.get(class="hl-string">'assignee', {}).get(class="hl-string">'department'),
            class="hl-string">'SourceSystem': class="hl-string">'BlackLine',
            class="hl-string">'LastDataUpdate': last_data_update
        }
        if task.get(class="hl-string">'status') == class="hl-string">'Completed' and task.get(class="hl-string">'completedDate'):
            activity_name = MILESTONE_TASK_MAPPING.get(task.get(class="hl-string">'name'), class="hl-string">'Task Completed')
            event_log.append({**common_attrs, class="hl-string">'ActivityName': activity_name, class="hl-string">'EventTime': task[class="hl-string">'completedDate'], class="hl-string">'ResponsibleUser': task.get(class="hl-string">'assignee', {}).get(class="hl-string">'username'), class="hl-string">'ReconciliationStatus': None})
        elif task.get(class="hl-string">'dueDate') and task.get(class="hl-string">'dueDate') < today and task.get(class="hl-string">'status') != class="hl-string">'Completed':
             event_log.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Task Delinquent', class="hl-string">'EventTime': task[class="hl-string">'dueDate'], class="hl-string">'ResponsibleUser': task.get(class="hl-string">'assignee', {}).get(class="hl-string">'username'), class="hl-string">'ReconciliationStatus': None})

    class=class="hl-string">"hl-comment"># 3. Fetch and process Journals
    print(class="hl-string">"Fetching journals...")
    journal_params = {class="hl-string">'limit': LIMIT, class="hl-string">'updatedAfter': START_DATE, class="hl-string">'updatedBefore': END_DATE}
    journals = fetch_paginated_data(class="hl-string">'journals', headers, journal_params)
    for journal in journals:
        common_attrs = {
            class="hl-string">'FinancialPeriod': journal.get(class="hl-string">'periodName'),
            class="hl-string">'CompanyCode': journal.get(class="hl-string">'companyCode'),
            class="hl-string">'GLAccount': journal.get(class="hl-string">'lines', [{}])[0].get(class="hl-string">'accountNumber'), class=class="hl-string">"hl-comment"># Get account from first line
            class="hl-string">'Department': journal.get(class="hl-string">'creator', {}).get(class="hl-string">'department'),
            class="hl-string">'SourceSystem': class="hl-string">'BlackLine',
            class="hl-string">'LastDataUpdate': last_data_update
        }
        if journal.get(class="hl-string">'createdDate'):
            event_log.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Adjusting Journal Created', class="hl-string">'EventTime': journal[class="hl-string">'createdDate'], class="hl-string">'ResponsibleUser': journal.get(class="hl-string">'creator', {}).get(class="hl-string">'username'), class="hl-string">'ReconciliationStatus': None})
        if journal.get(class="hl-string">'postedDate'):
            event_log.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Adjusting Journal Posted', class="hl-string">'EventTime': journal[class="hl-string">'postedDate'], class="hl-string">'ResponsibleUser': journal.get(class="hl-string">'poster', {}).get(class="hl-string">'username'), class="hl-string">'ReconciliationStatus': None})

    class=class="hl-string">"hl-comment"># 4. Create DataFrame and save to CSV
    if not event_log:
        print(class="hl-string">"No events found for the specified period.")
        return

    df = pd.DataFrame(event_log)
    class=class="hl-string">"hl-comment"># Add missing recommended columns with null values if they don't exist
    recommended_cols = [class="hl-string">'EventEndTime']
    for col in recommended_cols:
        if col not in df.columns:
            df[col] = None

    class=class="hl-string">"hl-comment"># Reorder columns to match ProcessMind requirements
    final_cols = [class="hl-string">'FinancialPeriod', class="hl-string">'ActivityName', class="hl-string">'EventTime', class="hl-string">'EventEndTime', class="hl-string">'SourceSystem', class="hl-string">'LastDataUpdate', class="hl-string">'ResponsibleUser', class="hl-string">'Department', class="hl-string">'ReconciliationStatus', class="hl-string">'CompanyCode', class="hl-string">'GLAccount']
    df = df[final_cols]

    output_file = class="hl-string">'blackline_event_log.csv'
    df.to_csv(output_file, index=False, date_format=class="hl-string">'%Y-%m-%dT%H:%M:%S.%f')
    print(fclass="hl-string">"Extraction complete. Event log saved to {output_file}")

if __name__ == class="hl-string">"__main__":
    main()

準備はできましたか？

このテンプレートを使うと、データを準備し、決算・レポーティングの期間決算と照合プロセスの改善に着手できます。効率と正確性の向上に向けて、今日から始めましょう。

改善ガイドに戻る

テンプレートをダウンロード

決算・レポーティングの決算締めと照合を今すぐ改善

サイクルタイムを30％短縮し、正確な財務報告を実現します。

無料トライアルを開始

クレジットカードは不要です

決算・レポーティング：期間決算と照合のデータテンプレート

決算・レポーティング：期間決算と照合のデータテンプレート

決算・レポーティング：期間決算と照合の属性

決算・レポーティング：期間決算と照合のアクティビティ

データ抽出ガイド

BlackLine REST APIを使ったPythonスクリプトによるデータ抽出

ステップ

設定

クエリの例 python

準備はできましたか？

決算・レポーティングの決算締めと照合を今すぐ改善