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

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

Workiva

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

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

このテンプレートでは、決算・レポーティング：決算期間と照合プロセスを分析するために必要なデータを収集する手順を示します。収集すべき重要な属性、追跡すべき主要なアクティビティ、Workivaから情報を抽出するための具体的なガイダンスをまとめています。このリソースを使ってデータを準備し、プロセス分析と改善に役立ててください。

収集を推奨する属性
追跡すべき主要なアクティビティ
Workivaからの抽出ガイダンス

イベントログを初めて扱いますか。学ぶプロセスマイニングのイベントログを作成する方法.

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

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

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

5 必須 6 推奨 7 任意

	名前	説明
	アクティビティ名 ActivityName	期間決算プロセス内で発生した特定のタスクまたはイベントの名前です。
説明アクティビティ名は、「ソースデータインポート」や「照合をレビューに提出」など、決算・レポーティングワークフローの1つのステップを表します。これらのアクティビティはプロセスマップを構成する基本要素であり、イベントの順序を示すために時刻が記録されます。アクティビティの分析は、プロセスマイニングの基本です。プロセスフローの可視化、タスクの順序の特定、標準手順からの逸脱の発見、各ステップの頻度と所要時間の測定に役立ちます。ボトルネック、手戻りループ、自動化の機会を特定するうえで欠かせません。重要な理由プロセスマップの中核となる属性であり、決算サイクルにおけるステップの順序を可視化・分析できます。入手先通常は、Workiva内の監査証跡、タスク管理、またはワークフローログに、特定の決算タスクや照合タスクと関連付けて記録されます。例期末決算を開始照合をレビューに提出修正仕訳転記完了財務諸表生成
	イベント時刻 EventTimestamp	特定のアクティビティまたはイベントが記録された正確な日時です。
説明イベント時刻は、アクティビティが発生した時点を示します。イベントを正しい順序に並べ、イベント間の所要時間を計算するために欠かせません。完全なイベントログには、「期間決算開始」から「期間決算完了」まで、すべてのアクティビティの時刻が記録されます。この時刻は、プロセスマイニングにおける時間ベースの分析の基盤です。サイクルタイム、待ち時間、処理時間の計算に使われ、「期間決算エンドツーエンドサイクルタイム」や「照合ボトルネック分析」などのダッシュボードに欠かせません。意味のあるプロセス分析には、正確な時刻が不可欠です。重要な理由イベントの時系列を示します。サイクルタイムなどの時間ベースの指標を計算し、プロセスの遅延を特定するために欠かせません。入手先 Workiva内のイベントログ、監査証跡、または取引記録にあり、タスクの作成時刻や完了時刻に対応します。例 2024-04-01T09:00:00Z2024-04-05T14:32:15Z2024-04-10T11:05:00Z
	財務期間 FinancialPeriod	月や四半期など、特定の財務レポートサイクルを識別する一意の識別子です。期間末決算プロセスのケースとして機能します。
説明財務期間は、特定の期間の帳簿締めに関するすべてのアクティビティをまとめる主要なケース識別子です。たとえば、「2024-Q1」や「2024-03」は1つのケースを表します。プロセスマイニングでは、財務期間ごとに分析することで、決算・レポーティングサイクル全体を把握できます。異なる期間の決算プロセスを比較し、傾向の特定、サイクルタイムの改善状況の測定、繰り返し発生するボトルネックの特定が可能です。各期間をケースとして扱うことで、プロセスのバリアントや、時間の経過に伴う標準手順への適合状況を分析できます。重要な理由分析の基準となる不可欠なケース識別子です。各期間決算サイクルをエンドツーエンドで測定し、比較できます。入手先通常は、Workivaの財務レポートまたは決算管理モジュールにあるレポート期間の情報から取得します。具体的なフィールド名については、Workivaのドキュメントを確認してください。例 2024-032024年第1四半期2023年度第12期2024年4月
	ソースシステム SourceSystem	イベントデータの元となったシステムです。
説明データを生成したアプリケーションまたはプラットフォームを識別する属性です。この分析では主に「Workiva」ですが、ERPなど他のシステムからインポートされたデータを区別するためにも使えます。複数のシステムが存在する環境では、ソースシステムを把握することがデータの系譜を理解し、データ品質を評価するうえで重要です。データの不整合が見つかった場合の根本原因分析に役立ち、アクティビティがどのように実行されたかを理解するための背景情報にもなります。重要な理由データの出所に関する重要な背景情報を提供します。データ検証や、プロセスを支える技術環境を理解するうえで重要です。入手先通常は、データの抽出・変換処理でレコードの出所を示すために設定されます。例 WorkivaSAP S/4HANAOracle NetSuite
	最終データ更新 LastDataUpdate	プロセスのデータが最後に更新された時刻を示すタイムスタンプです。
説明ソースシステムからデータセットが最後に更新された時刻を記録する属性です。更新のたびに、データセット全体にメタデータフィールドとして付与されます。ダッシュボードに最終データ更新時刻を表示することは、分析対象データの鮮度を利用者に伝えるうえで推奨される方法です。分析結果がどの時点の情報に基づくものかを理解しやすくなり、運用監視にも欠かせません。重要な理由データの適時性を利用者に伝え、分析の前提と情報が最後に更新された時点を理解できるようにします。入手先データ抽出時に、データパイプラインまたはETLツールによって生成・保存されます。例 2024-05-10T08:00:00Z2024-05-09T08:00:00Z
	GL勘定 GLAccount	照合または修正の対象となる総勘定元帳勘定の番号です。
説明照合または仕訳の対象となるGL勘定を指定する属性です。決算プロセスを詳細に分析できます。 GL勘定別の分析は、「照合ボトルネック分析」や「照合ステータスと経過期間」ダッシュボードに欠かせません。照合に最も時間がかかる勘定や、修正が最も多く必要な勘定など、問題のある勘定を特定できます。複雑な勘定やデータ品質に問題がある勘定など、影響の大きい領域に改善活動を集中させるのに役立ちます。重要な理由照合パフォーマンスを詳細に把握し、遅延や頻繁な修正の原因となる問題のある勘定を特定できます。入手先 Workiva内の照合データまたは仕訳データで主要なフィールドになります。例 11010012105003410000012300-001
	会社コード CompanyCode	決算を実施する法人を識別する一意の識別子です。
説明会社コードは、組織内の特定の法人を表します。財務決算プロセスは、連結前に会社コードごとに個別に実施されることが一般的です。この属性は、異なる法人間でプロセスをフィルタリング・比較するうえで欠かせません。「照合ステータスと経過期間」ダッシュボードでは、特定の会社まで掘り下げて分析できます。特定の法人で遅延や修正の発生率が継続的に高い場合、その法人固有のプロセスまたはデータの問題を特定する手がかりになります。重要な理由組織内の異なる法人間で、決算プロセスの効率とコンプライアンスを比較できます。入手先 Workiva内の財務データ、勘定、取引に関連付けられ、ソースERPシステムから引き継がれる可能性が高いです。例 1000US01DE015400
	担当ユーザー ResponsibleUser	アクティビティを実行した、または担当として割り当てられた人のユーザーIDまたは名前です。
説明期間決算プロセスにおける特定のタスクの責任者を識別する属性です。照合を作成した担当者や、承認したマネージャーなどが該当します。作業量とパフォーマンスの分析に欠かせません。担当ユーザーは、「期間決算の作業量分布」ダッシュボードに欠かせない属性です。マネージャーは、チームメンバー間のタスク配分を把握し、過度な負荷のリスクを特定し、リソースを適切に配分できます。また、特定のユーザーが手戻りループやプロセス逸脱に繰り返し関与している場合、研修ニーズの特定にも役立ちます。重要な理由作業量の分布、ユーザーのパフォーマンス、リソース配分を分析できます。チームの効率を管理するうえで重要です。入手先通常はWorkivaのタスク管理またはワークフローログにあり、「割り当て先」、「所有者」、「完了者」などの名前で記録されます。例 j.doeasmithRobert.Paulsonuser123
	照合カテゴリ ReconciliationCategory	照合対象となる勘定のカテゴリまたは種類です。銀行勘定や会社間取引などが該当します。
説明 GL勘定を論理的なカテゴリに分類し、より上位の視点で分析するための属性です。「現金」、「固定資産」、「未払費用」、「会社間取引」などが例として挙げられます。この分類により、照合の種類ごとのプロセスパフォーマンスを把握できます。「照合ボトルネック分析」では、照合カテゴリによるフィルタリングが欠かせません。たとえば、会社間取引の照合が銀行勘定の照合より継続的に長時間かかるなど、遅延が特定の領域に集中しているかを確認できます。この結果に基づき、カテゴリごとの課題に合わせた改善策を講じられます。重要な理由異なる勘定種別の照合パフォーマンスを集計・比較し、カテゴリ固有のボトルネックを明らかにできます。入手先勘定科目マスターデータの一部であり、Workivaで管理されるか、ERPから引き継がれる場合があります。例銀行口座会社間取引固定資産未払計上前払費用
	照合ステータス ReconciliationStatus	勘定照合の現在のステータスです。
説明照合がワークフローを進む状態を追跡する属性です。たとえば、「オープン」、「進行中」、「承認待ち」、「承認済み」などがあります。照合アクティビティの現在の進捗を把握できます。「照合ステータスと経過期間」ダッシュボードの中心となる属性です。オープンまたは進行中の項目を監視し、停滞している照合を特定し、期限を守るための作業の優先順位を設定できます。ステータスの変化を時間の経過とともに追跡すると、次の状態に移るまで長時間待機しているボトルネックも明らかになります。重要な理由照合の進捗をリアルタイムで監視し、停滞している項目を特定・対応することで、決算を予定どおり進められます。入手先 Workivaの照合または決算管理モジュールにおける中核的な属性です。例オープン準備完了レビュー申請済み承認済み却下
	部門 Department	アクティビティを担当する部門または機能チームです。
説明ユーザーまたはアクティビティに関連付けられた事業部門や部門を示す属性です。たとえば、「経理部門」や「内部監査」などが該当します。プロセスデータをより上位の単位で集計できます。部門別にプロセスを分析することは、「期間決算の作業量分布」ダッシュボードや、組織内の各部門におけるプロセスパフォーマンスの比較に欠かせません。部門内の構造的な問題を特定し、チーム間の効率を比較し、部門間の引き継ぎが全体のサイクルタイムに与える影響を把握できます。重要な理由事業領域ごとにプロセスを分けて分析できます。パフォーマンスの比較や、部門固有の問題の特定に役立ちます。入手先 Workivaのユーザープロファイルに保存されるか、タスクのメタデータに関連付けられている場合があります。例北米経理部門EMEAシェアードサービス内部監査財務計画・分析
	仕訳ID JournalEntryId	修正仕訳を識別する一意の識別子です。
説明決算プロセス中に転記された各仕訳、特に照合後に行われた修正に一意のIDを付与する属性です。特定の修正を元のアクティビティまで追跡できます。仕訳IDの追跡は、「照合後修正の傾向」ダッシュボードに重要です。手動修正の件数を把握し、プロセスの後半で行われた特定の仕訳を調査できます。この追跡可能性は、修正の根本原因を理解し、初期データの品質を改善するうえで重要です。重要な理由各財務修正を参照する一意の情報を提供し、手動仕訳の件数、時期、理由を詳細に分析できます。入手先 WorkivaまたはソースERPの仕訳データにおける主要なフィールドになります。例 JE202404-00123ADJ-593029100004567
	修正金額 AdjustmentAmount	修正仕訳の金額です。
説明修正の金額を記録する属性です。決算プロセス中に行われた変更の重要性を把握できます。修正金額を分析すると、照合後の修正について調査の優先順位を設定できます。金額の大きい修正は、基礎となるデータやプロセスに重大な問題がある可能性を示すため、早急な対応が必要になる場合があります。この属性により、修正を件数だけでなく金額ベースでも分析でき、「手動修正比率」KPIを支えます。重要な理由修正による財務上の影響を定量化し、重要性に基づいて調査の優先順位を設定できます。入手先 Workivaまたは接続されたERPの仕訳データテーブルに標準的に含まれるフィールドです。例 15250.75-500.00120000.00
	却下理由 RejectionReason	レビュー中に照合または財務諸表が却下された際に示される理由です。
説明項目が却下されると、レビュアーは通常、その理由を記載します。この属性には、承認基準を満たさなかった理由を説明するテキストまたはコードが記録されます。「裏付け資料が不正確」や「計算エラー」などが該当します。却下理由を分析すると、エラーや手戻りの一般的な原因を特定できます。理由を分類して件数を集計することで、プロセス改善が必要な領域、担当者への研修、より明確な手順を特定できます。手戻りループを減らし、初回承認率を高めるうえで役立つデータです。重要な理由手戻りや品質上の問題の根本原因を直接把握でき、対象を絞った研修やプロセス改善につなげられます。入手先 Workivaのワークフローでユーザーが「却下」操作を実行した際に、コメントフィールドまたは定義済みリストに記録される可能性が高いです。例裏付け資料不足計算エラー期間誤りポリシー違反
	承認後の調整 IsPostApprovalAdjustment	対応する照合が承認された後に調整仕訳が転記された場合にtrueとなる、計算フラグです。
説明イベントの順序を分析して算出するブール型フラグです。特定の勘定科目と財務期間について、「調整仕訳転記」アクティビティが「照合レビュー・承認」アクティビティの後に発生した場合、このフラグはtrueになります。それ以外の場合はfalseです。この属性は、「照合後調整の推移」ダッシュボードと「照合後調整率」KPIに欠かせません。これらのイベントが多い場合、管理が行き届いていない、上流システムのデータ品質に問題がある、またはプロセスが適切に機能していない可能性があります。大幅な手戻りが発生し、コンプライアンスリスクも高まるためです。重要な理由承認後に行われた高リスクの調整を特定し、プロセス管理とデータ品質の問題を測定できます。入手先ソース項目ではありません。関連するアクティビティのタイムスタンプを比較し、プロセスマイニングツール内のロジックで算出します。例 truefalse
	期間決算サイクルタイム PeriodCloseCycleTime	1つの財務期間について、期間決算の開始から完了までにかかる合計時間です。
説明この計算指標は、決算期間のケース全体にかかるエンドツーエンドの所要時間を表します。対象となる財務期間について、最初のアクティビティ（「決算期間開始」）から最後のアクティビティ（「決算期間完了」）までの時間差として計算されます。この属性は、「決算期間エンドツーエンドサイクルタイム」ダッシュボードと対応するKPIの主要な測定値です。時間の経過に沿って追跡することで、経営層はプロセス改善の効果を確認し、異なる事業部門や期間における決算効率を比較できます。プロセスパフォーマンスを示す上位レベルの指標の中でも、特に重要なものの一つです。重要な理由決算期間プロセス全体の開始から完了までの効率と処理速度を測定する、主要なパフォーマンス指標です。入手先プロセスマイニングツールでケース単位に計算されます。各ケースについて、最も早い開始時刻から最も遅い終了時刻を差し引いて算出します。例 P10DT5HP8DT12HP12D
	目標完了日 TargetCompletionDate	期間決算を完了するために計画された日付または期限日です。
説明目標完了日は、期間決算プロセスを完了しなければならない社内または社外の期限です。実績を測定する基準になります。「期限内期間決算率」KPIの算出に欠かせません。「期間決算完了」アクティビティの実際の完了時刻と目標完了日を比較することで、決算が期限内、前倒し、または遅延したかを判定できます。プロセスの信頼性と財務レポートのスケジュール遵守を測る重要な指標です。重要な理由期限内のパフォーマンスを測定する基準となります。決算プロセスの信頼性と予測可能性を示す重要な指標です。入手先通常は、Workivaの決算管理または計画モジュールで、財務期間ごとに設定されます。例 2024-04-102024-01-152023-10-12
	自動実行かどうか IsAutomated	アクティビティが自動化されたシステムによって実行されたか、人が実行したかを示すフラグです。
説明データインポートやシステム生成レポートなど、システムが自動的に実行したタスクと、ユーザーが手動で実行したタスクを区別する真偽値属性です。自動化の機会を特定するうえで欠かせません。手動タスクと自動タスクの比率、それぞれの処理時間を分析することで、反復的で時間のかかるステップを自動化するための根拠を示せます。また、人が主導するアクティビティとシステム主導のアクティビティの効率を正確に測定できます。重要な理由人によるアクティビティとシステムによるアクティビティを区別できます。自動化の機会を特定し、既存の自動化の効果を測定するうえで重要です。入手先アクティビティに関連付けられたユーザーID（「system」や「bot」ユーザーなど）、またはアクティビティ種別自体に設定された特定のフラグから導出できます。例 truefalse

必須推奨任意

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

財務決算を正確に発見・最適化するため、イベントログに記録する主要なプロセス手順とマイルストーンです。

7 推奨 7 任意

	アクティビティ	説明
	修正仕訳転記完了	照合プロセスで判明した内容に基づき、修正仕訳を作成して転記する作業を示します。Workivaでは、仕訳とそのステータスを追跡できます。
重要な理由このアクティビティは、照合後修正率KPIに欠かせません。照合承認後の修正が多い場合、ソースデータの品質またはプロセス管理に問題がある可能性があります。入手先 Workivaの仕訳モジュールに明示的なイベントとして記録され、作成時刻と転記済みであることを示すステータスが付与される可能性が高いです。取得仕訳のステータスが「転記済み」に設定された時刻を使用します。イベントタイプ explicit
	期末決算を開始	このアクティビティは、特定の会計期間における財務決算プロセスの正式な開始を示します。通常、Workiva内でユーザーが期末決算のチェックリストまたはプロセスワークフローを作成、開始した時点で発生します。
重要な理由これはエンドツーエンドのプロセスにおける主要な開始イベントです。期末決算のエンドツーエンドサイクルタイムを正確に測定し、プロセスが正式に開始された時点を特定できます。入手先このイベントは、特定の会計期間についてWorkivaで作成された主要な期末決算プロセスオブジェクト、タスクリスト、またはワークフローの作成タイムスタンプから推定される可能性があります。取得会計期間に対応する親プロセスまたはチェックリストの作成タイムスタンプを使用します。イベントタイプ inferred
	期間決算完了	財務期間における決算・レポーティングプロセス全体が正式に完了したことを示します。Workivaのプロセスワークフローにおける最終ステップです。
重要な理由プロセスの主要な終了イベントです。期間決算のエンドツーエンドサイクルタイムと、期限内期間決算率を正確に測定できます。入手先 Workivaにおける親期間決算プロセス、チェックリスト、またはワークフローの完了時刻から推定します。手動でステータスを変更する場合もあります。取得親プロセスまたは決算チェックリストの最終タスクが完了した時刻を使用します。イベントタイプ inferred
	照合レビュー完了・承認	担当マネージャーまたはレビュアーが作成済みの照合を正式に承認し、その正確性を確認する重要なマイルストーンです。通常は、タスクが「承認済み」または「完了」ステータスに移行した時点で記録されます。
重要な理由このアクティビティは、平均照合サイクルタイムと平均レビュー・承認サイクルタイムの算出に欠かせません。プロセス内の品質確認が完了したことを示します。入手先照合タスクのステータス変更、またはWorkiva内のタスク監査証跡に記録された明示的な承認イベントから推定できる可能性があります。取得ステータスが「承認済み」または「認証済み」に変わった時刻を記録します。イベントタイプ inferred
	試算表作成完了	試算表が確定し、財務諸表の作成に使用できる状態になった時点を示します。特定のタスクが完了した時点や、レポートが生成された時点から推定する場合があります。
重要な理由財務諸表を作成するための重要な前提条件です。この時点以降の所要時間を測定することで、最終レポート作成段階の効率を分析できます。入手先 Workivaのチェックリストで「試算表を確定」タスクが完了した時点、または最終TBレポートが生成された時刻から推定する可能性が高いです。取得「試算表を作成」タスクが完了した時刻、または最終TBレポートが生成された時刻です。イベントタイプ inferred
	財務諸表承認	経営陣または監査委員会が財務諸表を最終承認したことを示します。期間が正式に締められる前の、最後の主要な承認です。
重要な理由レポートが確定したことを示す重要なマイルストーンです。財務諸表自体の平均レビュー・承認サイクルタイムを測定するために欠かせません。入手先電子署名、認証プロセス、またはWorkivaの主要なレポート文書やタスクのステータスが最終的に「承認済み」に変わることで記録される可能性が高いです。取得財務諸表の最終承認ステータスが変わった時刻、または認証イベントの時刻です。イベントタイプ inferred
	財務諸表生成	貸借対照表、損益計算書、キャッシュフロー計算書など、財務諸表のドラフトが作成されたことを示します。Workivaでレポート文書が生成された時点で記録されます。
重要な理由このアクティビティの時刻は、財務諸表生成遅延時間KPIの算出に欠かせません。データ集計から最終レポート作成への移行点を示します。入手先対象期間について、Workivaプラットフォーム内の財務諸表文書またはレポートが作成された時刻、あるいは最後に大きく更新された時刻から推定できます。取得主要な財務諸表文書の作成時刻または「最終更新」時刻を使用します。イベントタイプ inferred
	ソースデータをインポート	ソースERPシステムからWorkivaプラットフォームへのデータ読み込みが完了したことを示します。試算表データ、取引明細、照合に必要なその他の補助明細などが含まれる場合があります。
重要な理由データを利用できるようになるまでの遅延は、よくあるボトルネックです。このアクティビティを追跡すると、後続の照合やレポート作成作業とは別に、データ統合の問題を切り分けられます。入手先これは、Workivaのデータ統合ログや監査証跡に明示的なイベントとして記録される場合があります。また、照合タスクを開始する前の対象期間について、最後にデータが更新された時刻から推定することもできます。取得対象期間のデータインポートまたはERP接続の更新が正常に完了した時刻です。イベントタイプ inferred
	会社間取引照合開始	会社間取引を照合する、特定性が高く複雑になりやすいプロセスの開始を示します。会社間取引照合モジュールまたは特定のタスクが開始された時点で記録されます。
重要な理由会社間取引の照合は、遅延が発生しやすい領域です。このアクティビティを切り分けることで、所要時間を測定し、これらの取引に固有のボトルネックを特定できます。入手先 Workivaのプロセスワークフロー内で、会社間取引勘定に指定されたタスクのステータスが変わった時点から推定できます。取得「会社間取引」に分類されたタスクが「進行中」ステータスに移行した時刻です。イベントタイプ inferred
	勘定照合開始	このアクティビティは、担当者が特定の勘定照合に着手したことを示します。通常は、Workivaのプロセス内でユーザーが照合タスクを初めて開くか、担当として引き受けた時点で記録されます。
重要な理由照合作業の開始を追跡することは、担当者のサイクルタイムを測定し、タスクの割り当てから実際の作業開始までに生じる遅延を特定するうえで重要です。入手先 Workivaのチェックリストまたはワークフロー内で、照合タスクのステータスが「未開始」から「進行中」などのステータスに初めて変わった時点から推定します。取得照合タスクのステータスが「進行中」などのアクティブな状態に変わった最初の時刻を検出します。イベントタイプ inferred
	期間再開	一度締めた期間を再び開き、遅れて判明した修正を転記したり、訂正したりする例外的なアクティビティです。「締め済み」からアクティブな状態へのステータス変更によって記録されます。
重要な理由重大なプロセス上の例外と手戻りが発生したことを示します。発生頻度を追跡することで、プロセス管理や確定性に関する根本的な問題を特定できます。入手先親期間決算プロセスオブジェクトのステータスが、完了または締め済みからオープンまたは進行中に戻った時点から推定します。取得期間オブジェクトのステータスが「締め済み」から「オープン」に変わったことを検出します。イベントタイプ inferred
	照合をレビューに提出	担当者が照合作業を完了し、承認のため正式に提出した時点で発生するイベントです。Workivaでは、タスクのステータスが「レビュー待ち」などに変わることで示されることが一般的です。
重要な理由担当者からレビュアーへの引き継ぎを示すため、レビュー待ち時間を測定できます。レビューおよび承認ワークフローの効率を分析するうえで重要なマイルストーンです。入手先照合タスクのステータスが「進行中」から「レビュー待ち」または「提出済み」に変わった時刻から推定します。取得ステータスが「レビュー待ち」または同等の状態に変わった時刻を記録します。イベントタイプ inferred
	照合却下	レビュアーが提出された照合に問題を見つけ、修正のため担当者に差し戻した時点で発生します。「却下」または「要修正」へのステータス変更によって記録されます。
重要な理由却下を追跡することは、手戻りループの特定、初回正解率の測定、品質上の問題が繰り返し発生する勘定や担当者の特定に欠かせません。入手先照合タスクのステータスが「却下」、「差し戻し」など、修正が必要であることを示す状態に変わった時刻から推定します。取得ステータスが「却下」または同等の状態に変わった時刻を記録します。イベントタイプ inferred
	財務諸表レビュー完了	生成された財務諸表を、ユーザーまたはユーザーグループが正確性と完全性の観点からレビューした時点で発生します。レビュータスクのステータス更新によって記録される場合があります。
重要な理由レビューサイクルを追跡することは、最終承認段階の遅延を把握するうえで重要です。ここで時間がかかると、決算全体のスケジュールに大きな影響を与える可能性があります。入手先 Workivaのプロセス内にあるレビュータスクのステータスが「レビュー待ち」から「レビュー完了」や「承認済み」などに変わった時点から推定できます。取得財務諸表のレビューサイクルが完了したことを示すステータス変更の時刻です。イベントタイプ inferred

推奨任意

抽出ガイド

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

ステップ

Workivaインスタンスにログインし、メインのアプリケーションスイッチャーからプロセスセクションに移動します。
プロセスのダッシュボードでレポートタブをクリックし、レポート画面を開きます。
作成ボタンをクリックし、Process Reportを選択して新しいレポートの作成を開始します。
レポート設定で、利用可能なプロセスの一覧から分析する決算プロセスを選択します。たとえば、「2023年第3四半期決算」を選択します。
レポートビルダーのColumnsまたはデータセクションに移動します。イベントログに必要なデータを提供する列を追加します。Task Name、Status、Last Status Change Date、Assigned User、Completed By User、および組織で使用する会社コード、GL勘定、部門のカスタムメタデータ項目を含める必要があります。
レポートのフィルターを設定します。通常は3～6か月以上の会計期間を含む日付範囲を指定します。特定の会社コードやプロセス種別など、その他の関連フィルターも追加します。
レポートを実行してデータのプレビューを生成します。列と行が想定どおり表示されることを確認します。
プレビューを確認したら、レポートをエクスポートします。エクスポート形式としてCSVを選択し、ファイルをローカルマシンにダウンロードします。
エクスポートしたCSVファイルを表計算アプリケーションで開きます。データは、タスクの現在の状態ごと、またはステータス変更ごとに1行の形式になっている可能性があります。このデータを有効なイベントログ形式に変換する必要があります。
ActivityName、EventTimestamp、FinancialPeriodの新しい列を作成します。Workivaのエクスポートデータをこれらの列にマッピングします。たとえば、「現金勘定の照合」という名前のタスクのステータスが「レビュー依頼のため提出済み」の場合、Reconciliation Submitted for Reviewアクティビティに変換します。「Last Status Change Date」はEventTimestampになります。
レポート内のタスク名とステータス変更に基づき、必須14アクティビティごとに個別の行を作成する必要があります。1つのタスクの履歴から複数の行を作成する場合があります。
変換済みのファイルをCSVとして保存します。最終的な列ヘッダーが、プロセスマイニングツールへのアップロードに必要な属性と一致していることを確認します。

設定

プロセスの選択：分析対象のタスクを含む、特定の決算プロセス（「Monthly Close Checklist」や「Quarterly Reporting Process」など）を選択する必要があります。
レポートの種類：ステータス変更履歴を含む「Process Audit Trail」や「Task Detail Report」など、過去のタスクデータを提供するレポートの種類を選択します。単純なサマリーレポートでは不十分です。
日付範囲：意味のある分析を行うため、少なくとも3～6会計期間分の完全なデータを抽出するようレポートを設定します。これにより、サイクルを比較して傾向を特定できます。
レポート列：イベントの詳細を取得する列を含めることが重要です。Task Name、Task Status、Start Date、Due Date、Completion Date、User Assigned、User Completed、最後のステータス変更のタイムスタンプのフィールドを追加します。また、CompanyCode、部門、GLAccountにマッピングするカスタムフィールドも含めます。
フィルター：フィルターを使って抽出範囲を絞り込みます。FinancialPeriod名の特定範囲、CompanyCode、またはタスクステータスで絞り込み、エクスポートのサイズを抑えながら関連データに集中できます。
前提条件：抽出を実行するユーザーには、レポート対象の特定プロセスについてWorkiva内で少なくとも読み取りアクセス権が必要です。また、レポートを作成して実行する権限も必要です。

a サンプルクエリ config

// Workiva Process Report Configuration
// This is not an executable script, but a representation of the settings to be configured in the Workiva UI.

ReportType: "Process Task Detail" or "Process Audit Trail"

// Select the primary process to report on
ProcessFilter: "[Your Period Close Process Name]"

// Define the time frame for the data export
DateRange: {
  StartDate: "[YYYY-MM-DD]",
  EndDate: "[YYYY-MM-DD]"
}

// Columns to include in the exported report
// These fields will be mapped to the event log attributes during data transformation
Columns: [
  "Process Name",         // Maps to FinancialPeriod
  "Task Name",            // Used to derive ActivityName
  "Current Status",       // Used to derive ActivityName
  "Status Change Date",   // Maps to EventTimestamp
  "Assigned To User",     // Maps to ResponsibleUser
  "Completed By User",    // Maps to ResponsibleUser
  "Start Date",           // Potential timestamp for 'Started' activities
  "Completion Date",      // Potential timestamp for 'Completed' activities

  // Add custom metadata fields configured in your Workiva process
  "[Custom Field for Company Code]", // Maps to CompanyCode
  "[Custom Field for Department]",   // Maps to Department
  "[Custom Field for GL Account]",   // Maps to GLAccount
  "[Custom Field for Reconciliation Category]" // Maps to ReconciliationCategory
]

// Filters to apply to the dataset
Filters: {
  // Add any specific filters if needed, for example, by company code
  "[Custom Field for Company Code]": "[Filter by specific company codes]"
}

// Export Format
Format: "CSV"

ステップ

Workiva環境にWdata、Wdata Chains、必要なソース接続があり、決算期間、照合、仕訳、試算表、財務諸表のデータを読み取る権限があることを確認します。Workivaの設定はテナントによって異なるため、固定されたメニュー経路を前提とせず、接続とオブジェクトの選択には「システムに応じて設定」を使用します。
決算期間のワークフロー履歴、ソースデータのロード履歴、勘定科目照合の履歴、会社間照合の履歴、仕訳ステータスの履歴、試算表のマイルストーン、財務諸表ワークフローの履歴を含むWdataテーブルまたはソース出力を特定します。チェーンの設定セクションに、正確なオブジェクト名と列名を記録します。
入力として開始日、終了日、任意の会社フィルターを指定したWdata Chainを作成します。各ソースデータセットに対して、クエリまたはテーブル読み取りの手順を追加します。各ソース手順では、財務期間、イベントタイムスタンプ、取得可能な場合は担当ユーザー、部門、会社コード、GL勘定、照合ステータス、照合カテゴリ、最終更新タイムスタンプを返す必要があります。
ソース固有のステータスとマイルストーンの記録を、必須のActivityName値に対応付けます。対応付けでは、Period Close Initiated、Source Data Imported、Account Reconciliation Started、Intercompany Reconciliation Started、Reconciliation Submitted for Review、Reconciliation Reviewed and Approved、Reconciliation Rejected、Adjusting Journal Entry Posted、Trial Balance Prepared、Financial Statements Generated、Financial Statements Reviewed、Financial Statements Approved、Period Close Completed、Period Re-Openedの14アクティビティに対応する行を明示的に生成する必要があります。
すべてのソース手順の出力を同じスキーマに統一します。タイムスタンプを一貫したタイムゾーンと形式に変換し、ソースのタイムスタンプをEventTimestampとして保持します。SourceSystemには発生元システム名を、LastDataUpdateにはソースの更新タイムスタンプまたはチェーン実行時の更新タイムスタンプを設定します。ソースにそのマイルストーンが明示的に記録されていない限り、別のイベントの存在だけからイベントを推測しないでください。
統一した出力を結合し、ソース抽出の繰り返しによって作成された完全一致の重複レコードだけを削除します。タイムスタンプ、ユーザー、ステータス、ソース識別子のいずれかが異なるイベントは保持します。同じFinancialPeriodに対して複数の有効なイベントがある場合、それらをまとめないでください。
必須列がすべて存在し、対応するソースレコードがある場合に14のアクティビティ名がそれぞれ出力に含まれることを確認します。タイムスタンプの順序、対象期間、重複処理、推奨属性のNULL率を確認します。
統一したイベントログを指定のWdataテーブルに書き込むか、設定済みのChain出力手順を使って承認済みの外部送信先へ配信します。「出力テーブル名」と「システムに応じて設定」をテナント固有の値に置き換えます。
必要な頻度でチェーンをスケジュールします。通常は決算期間中は毎日、それ以外の期間は頻度を下げます。実行ログも保持します。ProcessMindへアップロードする場合は、FinancialPeriod、ActivityName、EventTimestamp、SourceSystem、LastDataUpdate、および利用可能な推奨属性を含むフラットファイルをエクスポートします。FinancialPeriodをケース識別子、ActivityNameをアクティビティ、EventTimestampをイベントタイムスタンプとして設定します。

設定

ソースオブジェクト：明示的なワークフロー、ステータス、マイルストーン、更新履歴を含むWdataテーブルまたは接続済みのソース出力を選択します。標準のWorkivaテーブル名や列名を前提にしないでください。
アクティビティの対応付け：14のアクティビティすべてについて、ソース条件を明示的に設定します。Pending Review、Approved、Completed、Rejected、Needs Rework、Closed、処理中の状態などのステータス値は、環境内で使用されている値と照合する必要があります。
日付範囲：業務分析では少なくとも3～6か月分を抽出します。財務期間が複数月にまたがる場合や、過去の再開を分析する場合は、対象範囲を広げます。
増分抽出：EventTimestampまたはソース更新タイムスタンプに基づくウォーターマークを使用します。遅れて到着する更新を取り込めるよう短い重複期間を設け、その後、完全に重複するレコードを削除します。
フィルター：必要な場合に限り、Company Code、FinancialPeriod、Department、照合カテゴリ、文書タイプ、ソースシステムのフィルターを適用します。有効にする前に、正確な項目名と許可されている値を確認します。
必須出力列：すべての出力行にFinancialPeriod、ActivityName、EventTimestamp、SourceSystem、LastDataUpdateが含まれている必要があります。
推奨出力列：利用可能な場合は、ResponsibleUser、Department、CompanyCode、GLAccount、ReconciliationStatus、ReconciliationCategoryを含めます。
パフォーマンス：日付と会社でソースの読み取り範囲を絞り、必要な列だけを選択し、増分ロードを使用します。大規模な履歴テーブルを繰り返し全件走査しないでください。設定済みのWdata設計で対応している場合は、データをパーティション分割またはステージングします。
スケジュール：ソースの更新が完了した後にチェーンを実行するようスケジュールします。決算期間中は毎日が一般的ですが、適切な頻度はソースの更新タイミングと業務要件によって異なります。
前提条件：必要な権限、ソース接続、Wdataへのアクセス、Wdata Chainsの利用可否、出力先への書き込み権限、該当するWorkivaライセンスをシステム管理者が確認する必要があります。
テナント固有の設定：接続名、テーブル名、列名、ステータス値、タイムゾーン、外部配信設定は、システムに応じて設定する必要があります。

a サンプルクエリ config

WITH
period_close_initiated AS (
    SELECT
        FinancialPeriod,
        'Period Close Initiated' AS ActivityName,
        EventTimestamp,
        SourceSystem,
        LastDataUpdate,
        ResponsibleUser,
        Department,
        CompanyCode,
        GLAccount,
        ReconciliationStatus,
        ReconciliationCategory
    FROM [Your period close event source]
    WHERE EventTimestamp >= [Start date parameter]
      AND EventTimestamp < [End date parameter]
      AND ([Company Code filter] IS NULL OR CompanyCode = [Company Code filter])
      AND [Source activity or status condition for Period Close Initiated]
),
source_data_imported AS (
    SELECT
        FinancialPeriod,
        'Source Data Imported' AS ActivityName,
        EventTimestamp,
        SourceSystem,
        LastDataUpdate,
        ResponsibleUser,
        Department,
        CompanyCode,
        GLAccount,
        ReconciliationStatus,
        ReconciliationCategory
    FROM [Your source data load event source]
    WHERE EventTimestamp >= [Start date parameter]
      AND EventTimestamp < [End date parameter]
      AND ([Company Code filter] IS NULL OR CompanyCode = [Company Code filter])
      AND [Source activity or status condition for Source Data Imported]
),
account_reconciliation_started AS (
    SELECT
        FinancialPeriod,
        'Account Reconciliation Started' AS ActivityName,
        EventTimestamp,
        SourceSystem,
        LastDataUpdate,
        ResponsibleUser,
        Department,
        CompanyCode,
        GLAccount,
        ReconciliationStatus,
        ReconciliationCategory
    FROM [Your account reconciliation event source]
    WHERE EventTimestamp >= [Start date parameter]
      AND EventTimestamp < [End date parameter]
      AND ([Company Code filter] IS NULL OR CompanyCode = [Company Code filter])
      AND [Source activity or status condition for Account Reconciliation Started]
),
intercompany_reconciliation_started AS (
    SELECT
        FinancialPeriod,
        'Intercompany Reconciliation Started' AS ActivityName,
        EventTimestamp,
        SourceSystem,
        LastDataUpdate,
        ResponsibleUser,
        Department,
        CompanyCode,
        GLAccount,
        ReconciliationStatus,
        ReconciliationCategory
    FROM [Your intercompany reconciliation event source]
    WHERE EventTimestamp >= [Start date parameter]
      AND EventTimestamp < [End date parameter]
      AND ([Company Code filter] IS NULL OR CompanyCode = [Company Code filter])
      AND [Source activity or status condition for Intercompany Reconciliation Started]
),
reconciliation_submitted_for_review AS (
    SELECT
        FinancialPeriod,
        'Reconciliation Submitted for Review' AS ActivityName,
        EventTimestamp,
        SourceSystem,
        LastDataUpdate,
        ResponsibleUser,
        Department,
        CompanyCode,
        GLAccount,
        ReconciliationStatus,
        ReconciliationCategory
    FROM [Your reconciliation status history source]
    WHERE EventTimestamp >= [Start date parameter]
      AND EventTimestamp < [End date parameter]
      AND ([Company Code filter] IS NULL OR CompanyCode = [Company Code filter])
      AND [Source status condition for Reconciliation Submitted for Review]
),
reconciliation_reviewed_and_approved AS (
    SELECT
        FinancialPeriod,
        'Reconciliation Reviewed and Approved' AS ActivityName,
        EventTimestamp,
        SourceSystem,
        LastDataUpdate,
        ResponsibleUser,
        Department,
        CompanyCode,
        GLAccount,
        ReconciliationStatus,
        ReconciliationCategory
    FROM [Your reconciliation status history source]
    WHERE EventTimestamp >= [Start date parameter]
      AND EventTimestamp < [End date parameter]
      AND ([Company Code filter] IS NULL OR CompanyCode = [Company Code filter])
      AND [Source status condition for Reconciliation Reviewed and Approved]
),
reconciliation_rejected AS (
    SELECT
        FinancialPeriod,
        'Reconciliation Rejected' AS ActivityName,
        EventTimestamp,
        SourceSystem,
        LastDataUpdate,
        ResponsibleUser,
        Department,
        CompanyCode,
        GLAccount,
        ReconciliationStatus,
        ReconciliationCategory
    FROM [Your reconciliation status history source]
    WHERE EventTimestamp >= [Start date parameter]
      AND EventTimestamp < [End date parameter]
      AND ([Company Code filter] IS NULL OR CompanyCode = [Company Code filter])
      AND [Source status condition for Reconciliation Rejected]
),
adjusting_journal_entry_posted AS (
    SELECT
        FinancialPeriod,
        'Adjusting Journal Entry Posted' AS ActivityName,
        EventTimestamp,
        SourceSystem,
        LastDataUpdate,
        ResponsibleUser,
        Department,
        CompanyCode,
        GLAccount,
        ReconciliationStatus,
        ReconciliationCategory
    FROM [Your journal entry event source]
    WHERE EventTimestamp >= [Start date parameter]
      AND EventTimestamp < [End date parameter]
      AND ([Company Code filter] IS NULL OR CompanyCode = [Company Code filter])
      AND [Source status or journal type condition for Adjusting Journal Entry Posted]
),
trial_balance_prepared AS (
    SELECT
        FinancialPeriod,
        'Trial Balance Prepared' AS ActivityName,
        EventTimestamp,
        SourceSystem,
        LastDataUpdate,
        ResponsibleUser,
        Department,
        CompanyCode,
        GLAccount,
        ReconciliationStatus,
        ReconciliationCategory
    FROM [Your trial balance milestone source]
    WHERE EventTimestamp >= [Start date parameter]
      AND EventTimestamp < [End date parameter]
      AND ([Company Code filter] IS NULL OR CompanyCode = [Company Code filter])
      AND [Source activity or status condition for Trial Balance Prepared]
),
financial_statements_generated AS (
    SELECT
        FinancialPeriod,
        'Financial Statements Generated' AS ActivityName,
        EventTimestamp,
        SourceSystem,
        LastDataUpdate,
        ResponsibleUser,
        Department,
        CompanyCode,
        GLAccount,
        ReconciliationStatus,
        ReconciliationCategory
    FROM [Your financial statement generation source]
    WHERE EventTimestamp >= [Start date parameter]
      AND EventTimestamp < [End date parameter]
      AND ([Company Code filter] IS NULL OR CompanyCode = [Company Code filter])
      AND [Source activity or status condition for Financial Statements Generated]
),
financial_statements_reviewed AS (
    SELECT
        FinancialPeriod,
        'Financial Statements Reviewed' AS ActivityName,
        EventTimestamp,
        SourceSystem,
        LastDataUpdate,
        ResponsibleUser,
        Department,
        CompanyCode,
        GLAccount,
        ReconciliationStatus,
        ReconciliationCategory
    FROM [Your financial statement review source]
    WHERE EventTimestamp >= [Start date parameter]
      AND EventTimestamp < [End date parameter]
      AND ([Company Code filter] IS NULL OR CompanyCode = [Company Code filter])
      AND [Source activity or status condition for Financial Statements Reviewed]
),
financial_statements_approved AS (
    SELECT
        FinancialPeriod,
        'Financial Statements Approved' AS ActivityName,
        EventTimestamp,
        SourceSystem,
        LastDataUpdate,
        ResponsibleUser,
        Department,
        CompanyCode,
        GLAccount,
        ReconciliationStatus,
        ReconciliationCategory
    FROM [Your financial statement approval source]
    WHERE EventTimestamp >= [Start date parameter]
      AND EventTimestamp < [End date parameter]
      AND ([Company Code filter] IS NULL OR CompanyCode = [Company Code filter])
      AND [Source activity or status condition for Financial Statements Approved]
),
period_close_completed AS (
    SELECT
        FinancialPeriod,
        'Period Close Completed' AS ActivityName,
        EventTimestamp,
        SourceSystem,
        LastDataUpdate,
        ResponsibleUser,
        Department,
        CompanyCode,
        GLAccount,
        ReconciliationStatus,
        ReconciliationCategory
    FROM [Your period close event source]
    WHERE EventTimestamp >= [Start date parameter]
      AND EventTimestamp < [End date parameter]
      AND ([Company Code filter] IS NULL OR CompanyCode = [Company Code filter])
      AND [Source activity or status condition for Period Close Completed]
),
period_reopened AS (
    SELECT
        FinancialPeriod,
        'Period Re-Opened' AS ActivityName,
        EventTimestamp,
        SourceSystem,
        LastDataUpdate,
        ResponsibleUser,
        Department,
        CompanyCode,
        GLAccount,
        ReconciliationStatus,
        ReconciliationCategory
    FROM [Your period close status history source]
    WHERE EventTimestamp >= [Start date parameter]
      AND EventTimestamp < [End date parameter]
      AND ([Company Code filter] IS NULL OR CompanyCode = [Company Code filter])
      AND [Source status transition condition for Period Re-Opened]
),
all_events AS (
    SELECT * FROM period_close_initiated
    UNION ALL
    SELECT * FROM source_data_imported
    UNION ALL
    SELECT * FROM account_reconciliation_started
    UNION ALL
    SELECT * FROM intercompany_reconciliation_started
    UNION ALL
    SELECT * FROM reconciliation_submitted_for_review
    UNION ALL
    SELECT * FROM reconciliation_reviewed_and_approved
    UNION ALL
    SELECT * FROM reconciliation_rejected
    UNION ALL
    SELECT * FROM adjusting_journal_entry_posted
    UNION ALL
    SELECT * FROM trial_balance_prepared
    UNION ALL
    SELECT * FROM financial_statements_generated
    UNION ALL
    SELECT * FROM financial_statements_reviewed
    UNION ALL
    SELECT * FROM financial_statements_approved
    UNION ALL
    SELECT * FROM period_close_completed
    UNION ALL
    SELECT * FROM period_reopened
),
deduplicated_events AS (
    SELECT DISTINCT
        FinancialPeriod,
        ActivityName,
        EventTimestamp,
        SourceSystem,
        LastDataUpdate,
        ResponsibleUser,
        Department,
        CompanyCode,
        GLAccount,
        ReconciliationStatus,
        ReconciliationCategory
    FROM all_events
)
SELECT
    FinancialPeriod,
    ActivityName,
    EventTimestamp,
    SourceSystem,
    LastDataUpdate,
    ResponsibleUser,
    Department,
    CompanyCode,
    GLAccount,
    ReconciliationStatus,
    ReconciliationCategory
FROM deduplicated_events
ORDER BY FinancialPeriod, EventTimestamp, ActivityName;

ステップ

前提条件：WorkivaでAPI認証情報を生成する
- OAuth2 Grantの管理権限を持つアカウントでWorkivaにログインします。
- Workiva Adminコンソールへ移動し、「OAuth2 Grants」セクションを選択します。
- 抽出スクリプト用の新しいGrantを作成します。プロセス、Task、ユーザーデータの読み取りに必要なスコープを選択します。一般的なスコープにはprocesses:read、tasks:read、users:readがあります。
- 生成されたClient IDとClient Secretを安全にコピーします。Pythonスクリプトの認証に使用します。
Python環境を設定する
- スクリプトを実行するマシンにPython 3.6以降がインストールされていることを確認します。
- pipを使って必要なPythonライブラリをインストールします。主なライブラリは、APIへのHTTPリクエストに使うrequestsと、データ操作およびCSVエクスポートに使うpandasです。
- コマンドプロンプトまたはターミナルを開き、pip install requests pandasを実行します。
Pythonスクリプトを設定する
- 提供されたPythonスクリプトを、たとえばextract_workiva_log.pyというファイルにコピーします。
- スクリプト上部のプレースホルダー値を置き換えます。対象にはCLIENT_ID、CLIENT_SECRET、START_DATE、END_DATE、PROCESS_TEMPLATE_IDSが含まれます。
- PROCESS_TEMPLATE_IDSには、分析対象とする決算・レポーティングプロセステンプレートの一意の識別子をリストで指定します。
スクリプトのロジックを理解する
- スクリプトはまず、指定された認証情報でWorkiva APIに認証し、アクセストークンを取得します。
- 次に/processesエンドポイントを照会し、指定した日付範囲内に作成され、テンプレートIDに一致するすべてのプロセスインスタンスを検索します。各プロセスインスタンスは、1つのFinancialPeriodケースを表します。
- 各プロセスインスタンスについて、/tasksエンドポイントから関連するすべてのTaskを取得します。
- Taskとその履歴またはステータス変更を順に処理し、イベントログの行を生成します。Task名とステータス更新を、あらかじめ定義した14のアクティビティに対応付けます。
抽出スクリプトを実行する
- コマンドラインまたはターミナルでpython extract_workiva_log.pyを実行します。
- APIからデータを取得すると、スクリプトは進捗状況をコンソールに表示します。
- 長期間のデータを取得する場合、APIのページネーションとレート制限により数分かかることがあります。
出力データを確認する
- スクリプトが正常に完了すると、同じディレクトリにworkiva_event_log.csvというファイルが生成されます。
- CSVファイルをスプレッドシートアプリケーションで開きます。FinancialPeriod、ActivityName、EventTimestamp、SourceSystem、LastDataUpdateの列が正しく入力されていることを確認します。
ProcessMindへのアップロードに備える
- 生成されたCSVファイルは、ProcessMindと直接互換性のある形式です。通常、追加の書式設定は必要ありません。列見出しがProcessMindの対象データモデルと一致していることを確認します。

設定

API認証情報：認証にはClient IDとClient Secretが必要です。プロセスとTaskの読み取りを許可するスコープを設定し、Workiva Adminコンソールで生成する必要があります。
プロセステンプレートID：データを抽出する決算期間プロセステンプレートの一意の識別子を指定する必要があります。これにより、関連するプロセスだけを取得できます。
日付範囲：スクリプトのSTART_DATEとEND_DATE変数で抽出期間を指定します。データ量とAPI呼び出し数を管理するため、まずは3～6か月程度の短い範囲から始めることを推奨します。
APIエンドポイントURL：スクリプトはWorkivaのv1 APIエンドポイントを使用します。Workivaインスタンスのリージョンがデフォルトと異なる場合は、URLが正しいことを確認してください。
ユーザー権限：API認証情報に関連付けられたユーザーアカウントには、抽出対象のプロセスとTaskに対する少なくとも読み取り専用アクセス権が必要です。権限が不足すると、エラーやデータの欠落が発生します。
環境変数：セキュリティを高めるため、Client IDとClient Secretはスクリプトに直接記述せず、環境変数として保存することを強く推奨します。

a サンプルクエリ python

import requests
import pandas as pd
import datetime
import time

class=class="hl-string">"hl-comment"># --- Configuration Settings --- #
class=class="hl-string">"hl-comment"># Replace with your Workiva API credentials
CLIENT_ID = class="hl-string">'YOUR_CLIENT_ID'
CLIENT_SECRET = class="hl-string">'YOUR_CLIENT_SECRET'

class=class="hl-string">"hl-comment"># Define the date range for the extraction
START_DATE = class="hl-string">'YYYY-MM-DD'
END_DATE = class="hl-string">'YYYY-MM-DD'

class=class="hl-string">"hl-comment"># Define the Process Template IDs for your Record to Report processes
PROCESS_TEMPLATE_IDS = [class="hl-string">'YOUR_PROCESS_TEMPLATE_ID_1', class="hl-string">'YOUR_PROCESS_TEMPLATE_ID_2']

class=class="hl-string">"hl-comment"># API Base URL
BASE_URL = class="hl-string">'https://api.workiva.com/v1'

class=class="hl-string">"hl-comment"># --- Function to get an OAuth2 Token --- #
def get_access_token():
    url = fclass="hl-string">'{BASE_URL}/oauth2/token'
    payload = {
        class="hl-string">'grant_type': class="hl-string">'client_credentials',
        class="hl-string">'client_id': CLIENT_ID,
        class="hl-string">'client_secret': CLIENT_SECRET
    }
    response = requests.post(url, data=payload)
    response.raise_for_status() class=class="hl-string">"hl-comment"># Raises an exception for bad status codes
    return response.json()[class="hl-string">'access_token']

class=class="hl-string">"hl-comment"># --- Function to handle paginated API calls --- #
def get_all_pages(url, headers, params):
    all_items = []
    while url:
        response = requests.get(url, headers=headers, params=params)
        response.raise_for_status()
        data = response.json()
        all_items.extend(data[class="hl-string">'data'])
        url = data.get(class="hl-string">'metadata', {}).get(class="hl-string">'nextPageUrl')
        params = None class=class="hl-string">"hl-comment"># Subsequent requests use the full nextPageUrl
        if url:
            print(fclass="hl-string">'Fetching next page: {url}')
            time.sleep(0.5) class=class="hl-string">"hl-comment"># Be respectful of API rate limits
    return all_items

class=class="hl-string">"hl-comment"># --- Main Extraction Logic --- #
def main():
    print(class="hl-string">'Starting Workiva data extraction...')
    access_token = get_access_token()
    headers = {class="hl-string">'Authorization': fclass="hl-string">'Bearer {access_token}'}
    event_log = []
    last_data_update = datetime.datetime.utcnow().isoformat() + class="hl-string">'Z'

    class=class="hl-string">"hl-comment"># 1. Fetch relevant processes (our cases)
    print(class="hl-string">'Fetching processes...')
    process_params = {
        class="hl-string">'filter[templateId]': class="hl-string">','.join(PROCESS_TEMPLATE_IDS),
        class="hl-string">'filter[created]': fclass="hl-string">'ge({START_DATE});lt({END_DATE})'
    }
    processes = get_all_pages(fclass="hl-string">'{BASE_URL}/processes', headers, process_params)
    print(fclass="hl-string">'Found {len(processes)} processes to analyze.')

    class=class="hl-string">"hl-comment"># 2. Iterate through each process to fetch tasks and create events
    for process in processes:
        financial_period = process.get(class="hl-string">'name', process[class="hl-string">'id'])
        process_id = process[class="hl-string">'id']
        process_owner_id = process.get(class="hl-string">'owner', {}).get(class="hl-string">'id')

        class=class="hl-string">"hl-comment"># Activity: Period Close Initiated
        event_log.append({
            class="hl-string">'FinancialPeriod': financial_period,
            class="hl-string">'ActivityName': class="hl-string">'Period Close Initiated',
            class="hl-string">'EventTimestamp': process[class="hl-string">'created'],
            class="hl-string">'ResponsibleUser': process_owner_id,
            class="hl-string">'CompanyCode': process.get(class="hl-string">'customProperties', {}).get(class="hl-string">'CompanyCode'),
            class="hl-string">'Department': None,
            class="hl-string">'GLAccount': None,
            class="hl-string">'ReconciliationStatus': None,
            class="hl-string">'ReconciliationCategory': None
        })

        class=class="hl-string">"hl-comment"># 3. Fetch all tasks for the current process
        print(fclass="hl-string">'Fetching tasks for process: {financial_period}')
        tasks = get_all_pages(fclass="hl-string">'{BASE_URL}/tasks?filter[processId]={process_id}', headers, None)

        for task in tasks:
            task_name = task.get(class="hl-string">'name', class="hl-string">'').lower()
            task_assignee_id = task.get(class="hl-string">'assignee', {}).get(class="hl-string">'id')
            task_status = task.get(class="hl-string">'status', {}).get(class="hl-string">'value', class="hl-string">'').lower()
            reconciliation_category = task.get(class="hl-string">'customProperties', {}).get(class="hl-string">'ReconciliationCategory')
            gl_account = task.get(class="hl-string">'customProperties', {}).get(class="hl-string">'GLAccount')

            class=class="hl-string">"hl-comment"># Map task creation to class="hl-string">'Started' activities
            activity_map_start = {
                class="hl-string">'import source data': class="hl-string">'Source Data Imported',
                class="hl-string">'reconcile account': class="hl-string">'Account Reconciliation Started',
                class="hl-string">'intercompany reconciliation': class="hl-string">'Intercompany Reconciliation Started',
                class="hl-string">'prepare trial balance': class="hl-string">'Trial Balance Prepared',
                class="hl-string">'generate financial statements': class="hl-string">'Financial Statements Generated',
                class="hl-string">'review financial statements': class="hl-string">'Financial Statements Reviewed',
                class="hl-string">'post adjusting journal entry': class="hl-string">'Adjusting Journal Entry Posted'
            }
            for key, activity in activity_map_start.items():
                if key in task_name:
                    event_log.append({
                        class="hl-string">'FinancialPeriod': financial_period,
                        class="hl-string">'ActivityName': activity,
                        class="hl-string">'EventTimestamp': task[class="hl-string">'created'],
                        class="hl-string">'ResponsibleUser': task_assignee_id,
                        class="hl-string">'CompanyCode': process.get(class="hl-string">'customProperties', {}).get(class="hl-string">'CompanyCode'),
                        class="hl-string">'Department': task.get(class="hl-string">'customProperties', {}).get(class="hl-string">'Department'),
                        class="hl-string">'GLAccount': gl_account,
                        class="hl-string">'ReconciliationStatus': class="hl-string">'In Progress',
                        class="hl-string">'ReconciliationCategory': reconciliation_category
                    })

            class=class="hl-string">"hl-comment"># Map task status changes and completion to other activities
            if task.get(class="hl-string">'completed'):
                activity_map_completed = {
                    class="hl-string">'reconcile account': class="hl-string">'Reconciliation Submitted for Review',
                    class="hl-string">'intercompany reconciliation': class="hl-string">'Reconciliation Submitted for Review',
                    class="hl-string">'approve reconciliation': class="hl-string">'Reconciliation Reviewed and Approved',
                    class="hl-string">'approve financial statements': class="hl-string">'Financial Statements Approved',
                    class="hl-string">'close period': class="hl-string">'Period Close Completed'
                }
                for key, activity in activity_map_completed.items():
                    if key in task_name:
                         event_log.append({
                            class="hl-string">'FinancialPeriod': financial_period,
                            class="hl-string">'ActivityName': activity,
                            class="hl-string">'EventTimestamp': task[class="hl-string">'completed'],
                            class="hl-string">'ResponsibleUser': task.get(class="hl-string">'completedBy',{}).get(class="hl-string">'id'),
                            class="hl-string">'CompanyCode': process.get(class="hl-string">'customProperties', {}).get(class="hl-string">'CompanyCode'),
                            class="hl-string">'Department': task.get(class="hl-string">'customProperties', {}).get(class="hl-string">'Department'),
                            class="hl-string">'GLAccount': gl_account,
                            class="hl-string">'ReconciliationStatus': class="hl-string">'Approved' if class="hl-string">'approve' in key else class="hl-string">'Submitted',
                            class="hl-string">'ReconciliationCategory': reconciliation_category
                        })

            if task_status == class="hl-string">'rejected':
                 event_log.append({
                    class="hl-string">'FinancialPeriod': financial_period,
                    class="hl-string">'ActivityName': class="hl-string">'Reconciliation Rejected',
                    class="hl-string">'EventTimestamp': task.get(class="hl-string">'updated'), class=class="hl-string">"hl-comment"># Use last updated time for rejection event
                    class="hl-string">'ResponsibleUser': task_assignee_id,
                    class="hl-string">'CompanyCode': process.get(class="hl-string">'customProperties', {}).get(class="hl-string">'CompanyCode'),
                    class="hl-string">'Department': task.get(class="hl-string">'customProperties', {}).get(class="hl-string">'Department'),
                    class="hl-string">'GLAccount': gl_account,
                    class="hl-string">'ReconciliationStatus': class="hl-string">'Rejected',
                    class="hl-string">'ReconciliationCategory': reconciliation_category
                })

        class=class="hl-string">"hl-comment"># Activity: Period Re-Opened (Example logic, assumes a status on the process itself)
        if process.get(class="hl-string">'status', {}).get(class="hl-string">'value') == class="hl-string">'re-opened':
            event_log.append({
                class="hl-string">'FinancialPeriod': financial_period,
                class="hl-string">'ActivityName': class="hl-string">'Period Re-Opened',
                class="hl-string">'EventTimestamp': process[class="hl-string">'updated'],
                class="hl-string">'ResponsibleUser': process_owner_id,
                class="hl-string">'CompanyCode': process.get(class="hl-string">'customProperties', {}).get(class="hl-string">'CompanyCode'),
                class="hl-string">'Department': None,
                class="hl-string">'GLAccount': None,
                class="hl-string">'ReconciliationStatus': None,
                class="hl-string">'ReconciliationCategory': None
            })

    if not event_log:
        print(class="hl-string">'No events found for the given criteria.')
        return

    class=class="hl-string">"hl-comment"># 4. Create and save the DataFrame
    print(class="hl-string">'Creating DataFrame and saving to CSV...')
    df = pd.DataFrame(event_log)

    class=class="hl-string">"hl-comment"># Add static columns
    df[class="hl-string">'SourceSystem'] = class="hl-string">'Workiva'
    df[class="hl-string">'LastDataUpdate'] = last_data_update

    class=class="hl-string">"hl-comment"># Reorder columns to a logical format
    final_columns = [
        class="hl-string">'FinancialPeriod', class="hl-string">'ActivityName', class="hl-string">'EventTimestamp', class="hl-string">'SourceSystem', class="hl-string">'LastDataUpdate',
        class="hl-string">'ResponsibleUser', class="hl-string">'Department', class="hl-string">'CompanyCode', class="hl-string">'GLAccount', class="hl-string">'ReconciliationStatus', class="hl-string">'ReconciliationCategory'
    ]
    df = df[final_columns]

    df.to_csv(class="hl-string">'workiva_event_log.csv', index=False)
    print(class="hl-string">'Extraction complete. Output saved to workiva_event_log.csv')

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

今すぐ始めませんか？

このテンプレートを使ってデータ準備を効率化し、決算・レポーティング：決算期間と照合プロセスを詳しく把握してください。今日から財務決算の改善を始められます。

改善ガイドに戻るテンプレートをダウンロード

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

ボトルネックを特定してプロセスを効率化し、サイクルタイムを30％短縮します。

無料トライアルを開始

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

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

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

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

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

抽出ガイド

Workivaのプロセスレポートとスプレッドシートのエクスポート

ステップ

設定

a サンプルクエリ config

Workiva Wdata Chainsによる自動データ抽出

ステップ

設定

a サンプルクエリ config

Workiva REST APIを使用したPythonスクリプトによる抽出

ステップ

設定

a サンプルクエリ python

今すぐ始めませんか？

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

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

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

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

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

抽出ガイド

Workivaのプロセスレポートとスプレッドシートのエクスポート

ステップ

設定

a サンプルクエリ config

Workiva Wdata Chainsによる自動データ抽出

ステップ

設定

a サンプルクエリ config

Workiva REST APIを使用したPythonスクリプトによる抽出

ステップ

設定

a サンプルクエリ python

今すぐ始めませんか？

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

プライバシーを大切にしています