您的变更管理数据模板

BMC Helix ITSM

← 返回改进指南

变更管理属性 (22) 变更管理活动 (14) 提取指南 (3)

您的变更管理数据模板

此模板为收集变更管理流程分析所需的关键数据提供结构化指南。您将看到推荐属性、需要跟踪的关键活动，以及直接从系统中提取这些信息的实用指导。利用此资源，确保流程挖掘项目全面且高效。

建议收集的属性，支持深入分析
需要在流程中跟踪的关键活动和里程碑
相关源系统的具体数据提取指南

刚接触事件日志？了解如何创建流程挖掘事件日志.

下载模板

变更管理属性

建议将以下数据字段纳入事件日志，以全面分析变更管理并深入了解流程。

5 必需 6 建议 11 可选

	名称	说明
	变更请求ID ChangeRequestID	系统为变更请求生成的唯一标识符，用作主要案例标识。
说明变更请求ID是在整个生命周期内标识每项变更工作的唯一键。它汇总所有相关活动、审批和任务，构成流程挖掘中的单个案例。按此ID分析流程，可以端到端了解变更如何从初始请求走向最终关闭。这对于跟踪周期时间、识别瓶颈，以及了解单项变更的流程差异至关重要。为什么重要这是将所有相关事件连接为单个流程实例的基础属性，使变更管理流程的端到端分析成为可能。获取位置位于“CHG:Infrastructure Change”表单的“Infrastructure Change ID”字段中（字段ID：1000000182）。示例 CRQ0000001234567CRQ0000001234568CRQ0000001234569
	开始时间 EventStartTime	表示某项活动或事件开始时间的时间戳。
说明此属性记录活动发生的准确日期和时间，例如变更提交、批准或关闭的时间。该时间戳对于分析流程时间线至关重要，可用于计算活动之间的周期时间、衡量等待时间、识别随时间变化的绩效趋势，以及确定事件顺序。准确的时间戳是开展任何基于时间的流程分析的基础。为什么重要它提供计算时长、分析绩效和了解流程事件顺序所需的时间维度。获取位置来源于“CHG:ChangeRequest_AuditLog”表单中的“Audit Date”字段，或与特定状态变更关联的“Last Modified Date”。示例 2023-10-26T10:00:00Z2023-10-26T14:35:10Z2023-10-27T09:00:00Z
	活动 ActivityName	变更管理流程中执行的具体事件或任务名称。
说明此属性代表变更请求生命周期中的单个步骤或状态变更，例如“变更请求已提交”或“变更请求已批准”。这些活动构成流程图的基础节点。分析这些活动的顺序和持续时间，有助于识别流程顺序流、发现偏离标准过程的情况，并定位瓶颈。活动名称通常根据系统审计日志中记录的状态转换生成。为什么重要它定义流程步骤，使流程顺序流能够被可视化和分析，而这正是流程挖掘的核心。获取位置源自“CHG:ChangeRequest_AuditLog”表单中的状态转换，或通过跟踪“CHG:Infrastructure Change”表单中“Status”字段的变更获得。示例提交变更请求完成风险评估批准变更请求变更已实施
	最近数据更新时间 LastDataUpdate	表示此记录数据最近一次从源系统刷新时间的时间戳。
说明此属性显示数据最近一次从BMC Helix ITSM提取的日期和时间。它不是事件发生时间，而是数据提取时间。该信息对于了解所分析数据的新鲜度和管理数据刷新周期至关重要。在仪表板和报告中，此时间戳可帮助用户了解分析结果的时效性，这对于监控进行中的流程尤为重要。为什么重要它表示数据的新近程度，对于确保分析和仪表板反映流程最新状态至关重要。获取位置这是通常由ETL工具或数据管道在提取数据时生成并填充的元数据字段。示例 2023-11-01T02:00:00Z2023-11-02T02:00:00Z2023-11-03T02:00:00Z
	源系统 SourceSystem	提取数据的系统名称。
说明此属性标识流程数据的来源，在当前场景中为“BMC Helix ITSM”。在可能合并多个系统数据的环境中，它有助于数据治理和追溯。例如，后续将变更数据与财务或项目管理系统的数据合并时，该字段可明确区分数据来源。为什么重要它为数据来源提供重要背景，确保数据可追溯并得到正确解读，尤其适用于多系统分析场景。获取位置通常是在数据提取、转换和加载（ETL）过程中添加的静态值，用于标识数据集来源。示例 BMC Helix ITSMHelix ITSM生产环境BMC Remedy AR System
	优先级 Priority	分配给变更请求的优先级，用于表示其业务重要性。
说明优先级通常由Impact和Urgency共同决定，并规定变更请求的处理顺序和速度。高优先级变更通常需要更快处理，并可能适用更严格的服务级别协议（SLA）。此属性用于“Change SLA Performance”仪表板，以按不同优先级细分和分析绩效。它有助于回答“高优先级变更是否达到SLA要求”等问题，并为资源分配决策提供依据。为什么重要它支持按业务重要性细分绩效，确保最关键的变更得到高效处理并达到目标。获取位置位于“CHG:Infrastructure Change”表单的“Priority”字段中。示例关键高中低
	变更类型 ChangeType	变更的分类，例如Standard、Normal或Emergency。
说明此属性根据变更请求的性质及其必须遵循的流程对其进行分类。常见类型包括Standard（预先批准、低风险）、Normal（需要完整评估和审批）以及Emergency（因紧急问题需要加急处理）。按变更类型分析对于了解流程差异至关重要。例如，“Emergency Change Volume & Impact”仪表板依赖此字段跟踪紧急变更及其对服务稳定性的影响。它还有助于评估不同变更类型是否遵循规定路径。为什么重要它支持按不同变更工作流细分、分析和比较流程，这对于合规和绩效分析十分关键。获取位置位于“CHG:Infrastructure Change”表单的“Change Type”字段中。示例标准正常紧急无影响
	实施团队 ImplementationTeam	负责执行变更实施工作的团队。
说明此属性标识负责执行变更请求所需工作的技术或运营团队，通常对应变更生命周期实施阶段的“Assigned Group”。该信息对于“Resource Bottlenecks in Change Process”仪表板至关重要。通过分析各实施团队的活动时长和工作量，管理者可以发现负载不均、技能缺口或其他导致变更部署延迟的资源约束。为什么重要它支持按负责团队分析绩效，从而识别实施阶段与资源相关的瓶颈。获取位置位于“CHG:Infrastructure Change”表单的“ASGRP”（Assigned Group）字段中。示例服务器运维数据库管理员SAP Basis团队云基础设施
	审批组 ApproverGroup	负责在特定阶段审批变更请求的团队或小组。
说明此属性标识负责评审和授权变更的团队。由于一项变更可能包含多个审批阶段，因此生命周期中的不同阶段可能对应不同团队，例如技术审批团队和业务审批委员会。这是“Change Approval Bottlenecks”仪表板的重要属性，可按负责团队细分审批时长，帮助定位因工作负载过高或效率不足而造成流程延迟的团队。为什么重要它支持按负责团队分析审批时长，从而识别审批流程中的瓶颈。获取位置来源于管理审批并与变更请求关联的“AP:Signature”表单。审批组属于该记录的一部分。示例变更咨询委员会IT安全网络工程应用开发
	状态 Status	变更请求在生命周期中的当前状态或阶段。
说明 Status字段表示变更请求在特定时间点所处的准确阶段，例如“Draft”、“Request For Authorization”或“Completed”。活动源自这些状态之间的转换，而状态本身则适用于分析当前工作负载。此属性是“Change Throughput & Current Status”仪表板的基础，用于展示管道各阶段的变更数量。它帮助管理者了解进行中的工作和资源分配情况。为什么重要它提供变更管道的实时视图，支持分析进行中的工作以及所有变更请求的当前状态。获取位置位于“CHG:Infrastructure Change”表单的“Status”字段中。示例草稿请求授权已计划实施中已完成
	风险级别 RiskLevel	对实施变更可能带来的风险进行的评估。
说明 Risk Level是对实施变更可能造成不良后果的定性或定量评估。它是审批流程的重要输入，高风险变更通常需要接受更严格的审查。此属性是“Change Risk Profile Analysis”仪表板的核心，用于帮助相关方了解变更组合的整体风险敞口。它还可用于识别返工循环，例如初始风险评估不足，导致后续重新评估。为什么重要它为分析流程合规性和效率提供关键维度，帮助确保高风险变更得到适当审查。获取位置位于“CHG:Infrastructure Change”表单的“Risk Level”字段中。示例 1-关键2-高3-中4-低5-规划中
	SLA状态 SLAState	根据SLA目标计算得出的变更请求状态。
说明此属性表示已完成的变更请求是否达到SLA要求、存在超期风险或已经超期。系统通过比较实际完成时间戳与“SLATargetDate”计算该属性。这是“Change SLA Performance”仪表板的主要指标，可清晰简洁地衡量服务承诺达成情况，并支持按优先级、变更类型或团队切分数据，以识别SLA履行情况较差的领域。为什么重要它直接衡量绩效与承诺目标的差距，是流程效率和服务质量的重要指标。获取位置这是在数据转换过程中计算的属性，通过比较最后一项活动的时间戳与“SLATargetDate”得出。示例按时完成存在风险已超期
	SLA目标日期 SLATargetDate	变更请求应完成的目标日期和时间。
说明服务级别协议（SLA）目标日期是完成变更请求的截止时间，由其优先级和类型决定。实际完成时间将以此为基准进行衡量。此属性是“Change SLA Performance”仪表板的基础。通过比较实际关闭时间与目标时间，可以判断变更是否达到SLA要求。分析SLA绩效有助于评估整体流程效率和服务级别承诺的履行情况。为什么重要它提供绩效衡量基准，支持计算SLA合规率并识别存在风险的变更。获取位置此信息通常存储在相关SLA管理表单中，并与变更请求关联，通常也可直接在变更表单中查看。示例 2023-11-10T17:00:00Z2023-11-15T09:00:00Z2023-12-01T17:00:00Z
	关联事件ID RelatedIncidentID	由此变更引发的任何事件的标识符。
说明此属性将变更请求与其可能引发的后续事件关联起来。该关系对于了解变更对服务稳定性的下游影响至关重要。这是计算“Change-Induced Incident Rate”KPI所需的主要属性。通过跟踪这些关联，组织可以衡量变更流程质量，并识别与较高实施后问题发生率相关的变更类型、团队或服务。为什么重要它直接衡量变更造成的不良影响，是评估变更质量和风险管理有效性的关键KPI。获取位置此关系通常在事件表单（“HPD:Help Desk”）中建立，事件可在其中关联回作为其原因的变更请求。示例 INC000000987654INC000000987655INC000000987656
	关闭代码 CloseCode	表示变更关闭时最终结果的代码。
说明 Close Code为变更请求关闭提供标准化原因，例如“Successful”、“Successful with Issues”、“Backed Out”或“Cancelled”。与最终状态相比，此属性能够更细致地呈现变更结果。分析Close Code有助于评估已实施变更的质量和成功率。例如，大量“Backed Out”变更可能表明规划或测试存在问题，为流程改进提供有价值的指标。为什么重要它为每项变更提供清晰、结构化的结果，支持分析成功率以及失败或取消原因。获取位置位于“CHG:Infrastructure Change”表单的“Status Reason”或类似关闭代码字段中，该字段在最后阶段启用。示例成功成功但存在问题已回退已取消
	受影响的服务 AffectedService	受变更影响的业务或技术服务。
说明此属性将变更请求关联到配置管理数据库（CMDB）中定义的特定服务。该服务可以是面向用户的业务服务，例如“Email Services”，也可以是后端技术服务，例如“Authentication Service”。它用于“Emergency Change Volume & Impact”仪表板，将变更与受影响的服务关联起来，帮助了解不同服务的稳定性，并识别需要频繁紧急干预的服务。为什么重要它提供重要的业务背景，将技术变更与其对业务服务的影响关联起来，支持以服务为中心的流程分析。获取位置来源于“CHG:Infrastructure Change”表单中的“ServiceCI”字段或相关配置项（CI）关系。示例企业电子邮件SAP ERP客户关系管理网上银行门户
	变更提交人 ChangeSubmitter	创建并提交变更请求的人员。
说明此属性标识发起变更请求的人员，通常在系统中记录为“Submitter”或“Reported By”用户。虽然它不一定是主要分析维度，但有助于了解变更请求的来源。例如，分析大多数变更是否来自特定部门或岗位，可以洞察业务需求和规划流程。为什么重要它有助于识别变更请求的发起人，用于分析流程中的需求模式和用户行为。获取位置位于“CHG:Infrastructure Change”表单的“Submitter”字段中。示例 Allen AllbrookMary MannBob Baxter
	影响 Impact	评估变更对业务服务和IT基础设施的影响。
说明 Impact衡量变更可能对业务运营、服务和用户造成的影响。它与Urgency共同决定变更请求的Priority。在分析中，Impact用于“Change Risk Profile Analysis”仪表板，以全面呈现变更组合可能造成的业务后果。了解高影响变更的分布，有助于制定风险管理策略和资源规划。为什么重要它有助于量化变更可能造成的业务后果，从而根据服务可能受到的影响程度开展风险分析和优先级排序。获取位置位于“CHG:Infrastructure Change”表单的“Impact”字段中。示例 1-广泛影响2-重大影响3-中等影响4-轻微影响
	是否为紧急变更 IsEmergencyChange	当变更类型为“Emergency”时，该布尔标记为true。
说明此派生标记为紧急变更提供清晰的二元指示，简化分析。它基于“ChangeType”属性的值。此属性主要用于支持“Emergency Change Volume & Impact”仪表板和“Emergency Change Percentage”KPI。它支持轻松筛选和汇总紧急变更数据，无需在分析工具中编写复杂筛选逻辑，即可跟踪其频率和时间趋势。为什么重要它简化了紧急变更分析，便于筛选、制作仪表板以及计算与此类关键变更相关的KPI。获取位置这是在数据转换过程中创建的派生属性。逻辑为：IF“ChangeType”=“Emergency”THEN true ELSE false。示例 truefalse
	是否返工 IsRework	用于标识某项活动是否代表返工循环或流程中的回退步骤。
说明当变更请求在生命周期中退回上一阶段时，此布尔属性设置为true，例如从“Scheduled”退回“Risk Assessment”。此类回退通常表示返工，是效率低下的常见来源。该标记用于计算“Change Rework Rate”KPI，并支持“Change Rework & Assessment Efficiency”仪表板。它有助于量化返工频率，识别最常发生返工的具体流程步骤，从而发现初始规划和评估中的改进方向。为什么重要它通过标记属于返工循环的活动，直接识别流程低效环节，支持有针对性的改进。获取位置这是一个计算属性，通过分析案例中的活动顺序得出。数据转换过程中会应用相应逻辑，检测流程中的回退。示例 truefalse
	紧急程度 Urgency	变更的紧急程度，反映其实施的时间敏感性。
说明 Urgency表示变更需要多快实施。它与Impact共同用于计算变更请求的Priority。 Urgency是“Change Risk Profile Analysis”仪表板的重要属性，可反映变更管理流程面临的时间压力。分析紧急程度趋势，有助于发现导致大量时效性请求的潜在问题。为什么重要它反映变更的时间紧迫性，有助于分析流程是否能有效处理不同时间敏感度的请求。获取位置位于“CHG:Infrastructure Change”表单的“Urgency”字段中。示例 1-关键2-高3-中4-低
	结束时间 EventEndTime	表示某项活动或事件结束时间的时间戳。
说明结束时间表示活动完成的时间。在流程挖掘中，通常将案例中后续活动的开始时间作为当前活动的结束时间，从而明确前一步骤的持续时间。对于案例中的最后一项活动，结束时间可能与其开始时间相同，也可能采用特定的关闭时间戳。此属性对于计算每项活动的`ProcessingTime`至关重要，这是绩效分析和瓶颈识别的核心指标。它支持详细分析每个步骤所需的时间。为什么重要它支持精确计算活动时长，是识别瓶颈和衡量流程绩效的基础。获取位置这是一个计算属性，通常在数据转换过程中，通过获取某案例事件序列中下一事件的开始时间得出。示例 2023-10-26T14:35:10Z2023-10-27T09:00:00Z2023-10-27T11:20:00Z

必需建议可选

变更管理活动

在事件日志中记录以下关键流程步骤和里程碑，以准确发现流程并有效识别瓶颈。

7 建议 7 可选

	活动	说明
	创建变更请求	此活动表示系统中初始创建变更请求记录。该事件的时间取自CHG:Change表单中变更请求条目的创建时间戳。
为什么重要这是每项变更请求的起点，对于衡量完整生命周期时长和分析新增变更数量至关重要。获取位置该事件取自CHG:Change表单中的“提交日期”，或审计日志中的记录创建时间戳，例如HPD:Help Desk Audit Log。采集使用CHG:Change表单中的记录创建时间戳。事件类型 explicit
	变更已关闭	这是最后一项活动，表示系统中的变更请求正式关闭。当变更请求状态设置为“Closed”时记录此事件。
为什么重要此活动标志着变更生命周期成功结束，对于衡量端到端流程时长和整体吞吐量至关重要。获取位置根据CHG:Change表单中的状态变更历史推断，即状态变为“Closed”时记录。采集识别CHG:Change中“Status”字段更新为“Closed”的时间戳。事件类型 inferred
	变更已实施	此活动表示变更实施工作的成功完成。通常在状态更新为“Completed”，且原因表明实施成功时记录。
为什么重要这是标志部署阶段结束的重要里程碑，对于计算Change Implementation Cycle Time和分析变更引发的事件至关重要。获取位置根据CHG:Change表单推断：其中“Status”设置为“Completed”，且“Status Reason”为“Successful”。采集识别CHG:Change中“Status”字段更新为“Completed”的时间戳。事件类型 inferred
	变更已排期	此活动表示已批准的变更正式安排实施的时间点。系统通过状态变更为“Scheduled”记录此事件。
为什么重要这是表明变更已准备就绪的关键里程碑，也是计算Change Implementation Cycle Time和Average Implementation Wait Time这两项KPI的起点。获取位置根据CHG:Change表单中的状态变更历史推断，即状态变为“Scheduled”时记录。采集识别CHG:Change中“Status”字段更新为“Scheduled”的时间戳。事件类型 inferred
	完成风险评估	此活动表示已完成拟议变更的风险评估。通常可在变更请求状态更新，或特定风险评估任务关闭时记录。
为什么重要跟踪此活动对于确保遵守变更管理政策至关重要。它有助于识别评估阶段的延误，并在流程返回此步骤时分析变更返工率。获取位置根据CHG:Change表单中的状态变更推断，例如转为“Request For Change”，或根据CHG:Task表单中相关任务的完成情况推断。采集确定CHG:Task中关联的“Risk Assessment”任务标记为“Closed”或“Completed”的时间戳。事件类型 inferred
	已完成测试	表示实施后的测试或验证已完成。通常通过关闭与变更请求关联的专用测试任务来记录。
为什么重要跟踪此活动对于衡量Average Testing Cycle Time和确保质量至关重要。它有助于在最终验证前发现验证流程中的瓶颈。获取位置根据与父级变更请求关联的CHG:Task表单中测试任务记录的完成情况推断。采集识别CHG:Task中关联的“Testing”或“Validation”任务被标记为“Closed”或“Completed”的时间戳。事件类型 inferred
	批准变更请求	这是变更请求获得正式批准、可以继续推进的关键里程碑。通常可根据最终授权后状态变为“Scheduled”或“Planning In Progress”来推断。
为什么重要这标志着审批阶段结束，对于衡量审批瓶颈和平均变更审批时间KPI至关重要，也是流程中的关键决策点。获取位置根据CHG:Change表单中的状态变更历史推断，具体为请求退出“Request For Authorization”等审批状态。采集确定CHG:Change中的“Status”字段越过最终审批阶段的时间戳，例如转为“Scheduled”。事件类型 inferred
	制定实施计划	表示已创建并记录变更的详细实施计划。通常在与变更关联的规划任务完成时记录。
为什么重要完成此活动是排期和实施的前提。分析其时长有助于识别变更执行前规划阶段的延误。获取位置根据与父级变更请求关联的CHG:Task表单中某条规划任务记录的完成情况推断。采集识别CHG:Task中关联的“Implementation Planning”任务被标记为“Closed”或“Completed”的时间戳。事件类型 inferred
	变更已取消	表示变更请求在实施或完成前被取消。当变更请求状态更新为“Cancelled”时记录。
为什么重要跟踪取消情况有助于了解变更被撤回的原因，并发现初始规划不足、优先级变化或资源受限等问题。获取位置根据CHG:Change表单中的状态变更历史推断，即状态变为“Cancelled”时记录。采集识别CHG:Change中“Status”字段更新为“Cancelled”的时间戳。事件类型 inferred
	变更已验证	此活动表示变更在实施和测试后，已由相关方正式验证为成功。通常通过最终关闭前的状态变更体现。
为什么重要验证是关闭变更前的最终质量关卡，用于确认变更达到预期目标，且未造成非预期的不良影响。获取位置根据CHG:Change表单中的状态变更推断，例如状态从“Completed”变为“Verification”或“Closed”。采集识别实施活动完成后，CHG:Change中“Status”字段变为“Closed”的时间戳。事件类型 inferred
	完成影响分析	表示已完成影响分析，以确定变更可能带来的后果。通常可根据状态更新或关联任务关闭来推断。
为什么重要此活动对于了解规划效率及其对返工的影响至关重要。分析其时长和频率，有助于改进初始评估阶段。获取位置根据CHG:Task表单中“Impact Analysis”任务的完成时间戳，或CHG:Change表单中的特定状态转换推断。采集确定CHG:Task中关联的“Impact Analysis”任务标记为“Closed”或“Completed”的时间戳。事件类型 inferred
	实施后评审	表示变更实施后正式评审的完成。通常通过关闭实施后评审（PIR）任务来记录。
为什么重要此活动对于组织学习和流程改进至关重要。衡量Post-Implementation Review Rate KPI有助于确保组织从变更中总结经验。获取位置根据与父级变更请求关联的CHG:Task表单中“Post-Implementation Review”任务的完成情况推断。采集识别CHG:Task中关联的“PIR”任务被标记为“Closed”或“Completed”的时间戳。事件类型 inferred
	拒绝变更请求	此活动表示审批人已正式拒绝变更请求。该事件通过状态变为“Rejected”记录，并代表终止状态。
为什么重要跟踪拒绝情况有助于识别拒绝原因，例如信息不完整或风险过高。此类分析可以提升后续变更提交的质量。获取位置根据CHG:Change表单中的状态变更历史推断，具体为状态转为“Rejected”。采集确定CHG:Change中的“Status”字段更新为“Rejected”的时间戳。事件类型 inferred
	提交变更请求	表示正式提交变更请求，以供评审和授权。通常可根据变更请求状态从“Draft”变为“Request For Authorization”来推断。
为什么重要此活动启动审批流程。跟踪该活动对于衡量请求等待初始评审的时间，以及分析变更审批时间KPI至关重要。获取位置根据CHG:Change表单中的变更请求状态历史推断，具体为状态转为“Request For Authorization”。采集确定CHG:Change中的“Status”字段从“Draft”变为“Request For Authorization”的时间戳。事件类型 inferred

建议可选

提取指南

如何从BMC Helix ITSM获取数据

步骤

访问BMC Helix仪表板：登录您的BMC Helix ITSM环境。进入报告部分，通常标记为“仪表板”或“报告”。
创建新报告：新建报告或仪表板面板。选择连接到ITSM事务数据的适当数据源。
选择主数据表单：报告的核心应基于变更审计和状态历史。选择“CHG:ChangeAPDetail”表单，或类似的审计日志表单，作为主数据源。该表单包含许多活动所需的状态转换信息。
关联相关表单：要补充属性和基于任务的活动，请与其他表单建立关联。使用变更请求ID将“CHG:ChangeAPDetail”与“CHG:Infrastructure Change”关联，以获取变更类型、优先级等属性。同时，使用变更请求ID关联“TMS:Task”，以捕获任务相关活动。
定义报告列：添加需要映射到事件日志列的字段，包括“Infrastructure Change ID”（对应ChangeRequestID）、“Status”、“Actual Start Date”、“Submit Date”、“Create Date”、“Change Type”、“Priority”、“Risk Level”，以及关联任务表单中的“TaskName”和“Actual End Date”等字段。
筛选相关数据：设置筛选条件，限定数据提取范围。例如，按变更请求的“Submit Date”或“Create Date”筛选最近6个月的数据。根据需要添加状态筛选，仅保留相关变更状态，排除草稿或待处理记录。
构建事件日志逻辑：由于每项活动必须单独占一行，您需要配置报告以生成这些独立记录。通常可在仪表板工具中创建计算列，或使用自定义查询功能，将状态转换和任务完成映射为具体的“ActivityName”值，详见查询部分。
运行并预览报告：执行报告并生成数据预览。确认每一行都准确代表一项独立活动，并检查所有列是否按预期填充。
导出数据：报告定稿后，使用导出功能将数据保存为CSV或XLSX文件。
最终格式化：在电子表格应用中打开导出文件。将列标题重命名为ProcessMind所需的格式，例如“ChangeRequestID”、“ActivityName”、“EventStartTime”、“ChangeType”等。确保“EventStartTime”的日期格式统一。
保存最终事件日志：将清理并格式化后的文件保存为CSV，即可上传。

配置

主要数据源：报告应主要基于“CHG:Infrastructure Change”（用于属性和创建信息）、“CHG:ChangeAPDetail”（用于状态变更历史和审批信息）以及“TMS:Task”（用于实施和审核任务）。
日期范围：建议提取3至6个月的数据，在保证分析数据量充足的同时避免影响性能。使用“CHG:Infrastructure Change”表单中的“Submit Date”字段作为主要日期筛选条件。
关键筛选条件：按“Company”筛选，以限定特定业务单元。若其他变更类型与分析无关，也可以按“Change Type”筛选，仅包含“Normal”、“Standard”和“Emergency”变更。
前提条件：运行报告的用户必须在BMC Helix ITSM中拥有访问BMC Helix仪表板以及底层CHG和TMS应用表单的足够权限。
性能注意事项：关联多个表单并提取较长时间范围的数据可能消耗较多资源。建议在业务低峰期执行大规模提取，以尽量减少对系统性能的影响。如果报告超时，请缩短日期范围。

a 示例查询 sql

// This configuration represents the logical steps to build the report. It uses a SQL-like
// structure to illustrate how data from different sources and conditions are combined
// to form the final event log. You will implement this logic using your reporting tool's interface.

// Activity: Change Request Created
SELECT
  'Change Request Created' AS ActivityName,
  c.Infrastructure_Change_ID AS ChangeRequestID,
  c.Create_Date AS EventStartTime,
  'BMC Helix ITSM' AS SourceSystem,
  GETDATE() AS LastDataUpdate,
  c.Change_Request_Type AS ChangeType,
  c.Status AS Status,
  c.Priority AS Priority,
  c.Risk_Level AS RiskLevel,
  NULL AS ApproverGroup,
  c.ASGRP AS ImplementationTeam
FROM CHG_Infrastructure_Change c

UNION ALL

// Activity: Change Request Submitted
SELECT
  'Change Request Submitted' AS ActivityName,
  c.Infrastructure_Change_ID AS ChangeRequestID,
  c.Submit_Date AS EventStartTime,
  'BMC Helix ITSM' AS SourceSystem,
  GETDATE() AS LastDataUpdate,
  c.Change_Request_Type AS ChangeType,
  c.Status AS Status,
  c.Priority AS Priority,
  c.Risk_Level AS RiskLevel,
  NULL AS ApproverGroup,
  c.ASGRP AS ImplementationTeam
FROM CHG_Infrastructure_Change c
WHERE c.Submit_Date IS NOT NULL

UNION ALL

// Activity: Risk Assessment Performed, Impact Analysis Conducted, etc. (from Tasks)
SELECT
  CASE
    WHEN t.TaskName LIKE '%Risk Assessment%' THEN 'Risk Assessment Performed'
    WHEN t.TaskName LIKE '%Impact Analysis%' THEN 'Impact Analysis Conducted'
    WHEN t.TaskName LIKE '%Implementation Plan%' THEN 'Implementation Plan Developed'
    WHEN t.TaskName LIKE '%Implementation%' THEN 'Change Implemented'
    WHEN t.TaskName LIKE '%Testing%' THEN 'Testing Performed'
    WHEN t.TaskName LIKE '%Post-Implementation Review%' OR t.TaskName LIKE '%PIR%' THEN 'Post-Implementation Review'
    ELSE NULL
  END AS ActivityName,
  t.RootRequestID AS ChangeRequestID,
  t.Actual_End_Date AS EventStartTime,
  'BMC Helix ITSM' AS SourceSystem,
  GETDATE() AS LastDataUpdate,
  c.Change_Request_Type AS ChangeType,
  c.Status AS Status,
  c.Priority AS Priority,
  c.Risk_Level AS RiskLevel,
  NULL AS ApproverGroup,
  c.ASGRP AS ImplementationTeam
FROM TMS_Task t
JOIN CHG_Infrastructure_Change c ON t.RootRequestID = c.Infrastructure_Change_ID
WHERE t.Status = 'Closed' AND t.Actual_End_Date IS NOT NULL AND ActivityName IS NOT NULL

UNION ALL

// Activity: Status-based events (Approved, Rejected, Scheduled, Closed, Cancelled)
SELECT
  CASE
    WHEN a.Status_New = 'Scheduled' AND a.Status_Previous IN ('Request For Authorization', 'Planning In Progress') THEN 'Change Request Approved'
    WHEN a.Status_New = 'Scheduled' THEN 'Change Scheduled'
    WHEN a.Status_New = 'Rejected' THEN 'Change Request Rejected'
    WHEN a.Status_New = 'Completed' AND c.Status_Reason = 'Successful' THEN 'Change Verified' // Approximation for Verified before Closed
    WHEN a.Status_New = 'Closed' THEN 'Change Closed'
    WHEN a.Status_New = 'Cancelled' THEN 'Change Cancelled'
    ELSE NULL
  END AS ActivityName,
  a.Change_Request_ID AS ChangeRequestID,
  a.Status_Change_Date AS EventStartTime, // Placeholder for the actual timestamp field in the audit log
  'BMC Helix ITSM' AS SourceSystem,
  GETDATE() AS LastDataUpdate,
  c.Change_Request_Type AS ChangeType,
  a.Status_New AS Status,
  c.Priority AS Priority,
  c.Risk_Level AS RiskLevel,
  a.Approver_Group AS ApproverGroup, // Placeholder for the approver group field
  c.ASGRP AS ImplementationTeam
FROM CHG_ChangeAPDetail a // Or a similar audit form
JOIN CHG_Infrastructure_Change c ON a.Change_Request_ID = c.Infrastructure_Change_ID
WHERE ActivityName IS NOT NULL

步骤

建立数据库连接：获取BMC AR System数据库的只读凭据。使用DBeaver、SQL Server Management Studio或Oracle SQL Developer等标准SQL客户端，连接到存储BMC Helix ITSM数据的数据库实例。
确认数据库和架构：连接后，确认包含AR System视图的正确数据库和架构。此次提取的主要视图为CHG_Infrastructure_Change，同时还需要访问审计日志视图，通常名为CHG_ChangeRequest_AuditLogSystem。
检查并自定义查询：将提供的SQL查询复制到SQL客户端中，仔细检查占位符。必须将'YYYY-MM-DD'替换为所需提取周期的开始和结束日期。
配置活动逻辑：提供的查询会根据审计日志中的状态变更推断许多活动。检查每个UNION ALL代码块中的WHERE子句。您所在组织的变更管理工作流可能使用不同的状态值。例如，“Change Request Approved”活动是根据状态变更为“Scheduled”推断的。如果您的流程使用“Planning In Progress”等其他状态，则需要相应调整查询逻辑。
处理基于任务的活动：“Risk Assessment Performed”或“Testing Performed”等活动通常由与变更请求关联的独立任务管理。提供的查询会根据状态变更推断这些活动。若要提高准确性，您可能需要关联任务视图，例如TMS_Task，并筛选与变更请求相关的特定任务类型。这需要修改相应的UNION ALL代码块。
执行SQL查询：针对AR System数据库运行完整查询。执行时间取决于日期范围以及系统中的变更请求数量。
初步验证：查询完成后，快速验证结果。检查返回的总行数，确认ActivityName列包含多种预期活动，并确保ChangeRequestID和EventStartTime等关键字段不为空。
导出结果：从SQL客户端将完整结果集导出为CSV（逗号分隔值）文件。确保文件编码设置为UTF-8，避免出现字符问题。
准备上传：为文件设置合适的名称，例如bmc_change_management_event_log.csv。通常无需进一步格式化，文件现在即可上传到流程挖掘工具。

配置

数据库访问：需要对底层AR System数据库拥有只读访问权限。通常需要使用具有必要视图SELECT权限的专用数据库用户凭据，主要包括CHG_Infrastructure_Change和CHG_ChangeRequest_AuditLogSystem。
日期范围筛选：查询包含日期范围筛选占位符（'YYYY-MM-DD'），用于筛选变更请求创建日期（Submit_Date）。强烈建议先使用较短的日期范围，例如最近3至6个月，以控制性能和数据量。
公司筛选：如果您的BMC实例为多租户环境，应添加WHERE子句以筛选特定公司。例如，可在主FROM子句中添加：FROM CHG_Infrastructure_Change CIC WHERE CIC.Company = '[Your Company Name]'。
状态值自定义：提取活动的准确性很大程度上取决于变更管理流程使用的状态值。查询采用BMC标准状态值，您必须检查并根据组织的自定义工作流配置，更新WHERE子句中的相关值。
性能：在大型生产系统上直接执行数据库查询可能影响性能。建议在业务低峰期执行大规模提取，或在可用时针对生产数据库的只读副本执行。

a 示例查询 sql

SELECT
  CIC.Infrastructure_Change_ID AS ChangeRequestID,
  'Change Request Created' AS ActivityName,
  CIC.Submit_Date AS EventStartTime,
  CIC.Change_Type AS ChangeType,
  CIC.Status AS Status,
  CIC.Priority AS Priority,
  CIC.Risk_Level AS RiskLevel,
  CIC.ASLOGID AS ApproverGroup,
  CIC.ASGRP AS ImplementationTeam,
  'BMC Helix ITSM' AS SourceSystem,
  GETDATE() AS LastDataUpdate
FROM CHG_Infrastructure_Change CIC
WHERE CIC.Submit_Date BETWEEN '2023-01-01' AND '2023-12-31'

UNION ALL

SELECT
  AUD.Original_Request_ID AS ChangeRequestID,
  'Change Request Submitted' AS ActivityName,
  AUD.Audit_Date AS EventStartTime,
  CIC.Change_Type AS ChangeType,
  AUD.Fields_Changed AS Status,
  CIC.Priority AS Priority,
  CIC.Risk_Level AS RiskLevel,
  CIC.ASLOGID AS ApproverGroup,
  CIC.ASGRP AS ImplementationTeam,
  'BMC Helix ITSM' AS SourceSystem,
  GETDATE() AS LastDataUpdate
FROM CHG_ChangeRequest_AuditLogSystem AUD
JOIN CHG_Infrastructure_Change CIC ON AUD.Original_Request_ID = CIC.Infrastructure_Change_ID
WHERE AUD.Fields_Changed LIKE '%Status%Request For Authorization%'
  AND CIC.Submit_Date BETWEEN '2023-01-01' AND '2023-12-31'

UNION ALL

SELECT
  AUD.Original_Request_ID AS ChangeRequestID,
  'Risk Assessment Performed' AS ActivityName,
  AUD.Audit_Date AS EventStartTime,
  CIC.Change_Type AS ChangeType,
  AUD.Fields_Changed AS Status,
  CIC.Priority AS Priority,
  CIC.Risk_Level AS RiskLevel,
  CIC.ASLOGID AS ApproverGroup,
  CIC.ASGRP AS ImplementationTeam,
  'BMC Helix ITSM' AS SourceSystem,
  GETDATE() AS LastDataUpdate
FROM CHG_ChangeRequest_AuditLogSystem AUD
JOIN CHG_Infrastructure_Change CIC ON AUD.Original_Request_ID = CIC.Infrastructure_Change_ID
WHERE AUD.Fields_Changed LIKE '%Status%Request For Change%'
  AND CIC.Submit_Date BETWEEN '2023-01-01' AND '2023-12-31'

UNION ALL

SELECT
  AUD.Original_Request_ID AS ChangeRequestID,
  'Impact Analysis Conducted' AS ActivityName,
  AUD.Audit_Date AS EventStartTime,
  CIC.Change_Type AS ChangeType,
  AUD.Fields_Changed AS Status,
  CIC.Priority AS Priority,
  CIC.Risk_Level AS RiskLevel,
  CIC.ASLOGID AS ApproverGroup,
  CIC.ASGRP AS ImplementationTeam,
  'BMC Helix ITSM' AS SourceSystem,
  GETDATE() AS LastDataUpdate
FROM CHG_ChangeRequest_AuditLogSystem AUD
JOIN CHG_Infrastructure_Change CIC ON AUD.Original_Request_ID = CIC.Infrastructure_Change_ID
WHERE AUD.Fields_Changed LIKE '%Status%Request For Change%'
  AND CIC.Submit_Date BETWEEN '2023-01-01' AND '2023-12-31'

UNION ALL

SELECT
  AUD.Original_Request_ID AS ChangeRequestID,
  'Change Request Approved' AS ActivityName,
  AUD.Audit_Date AS EventStartTime,
  CIC.Change_Type AS ChangeType,
  AUD.Fields_Changed AS Status,
  CIC.Priority AS Priority,
  CIC.Risk_Level AS RiskLevel,
  CIC.ASLOGID AS ApproverGroup,
  CIC.ASGRP AS ImplementationTeam,
  'BMC Helix ITSM' AS SourceSystem,
  GETDATE() AS LastDataUpdate
FROM CHG_ChangeRequest_AuditLogSystem AUD
JOIN CHG_Infrastructure_Change CIC ON AUD.Original_Request_ID = CIC.Infrastructure_Change_ID
WHERE AUD.Fields_Changed LIKE '%Status%Scheduled%'
  AND CIC.Submit_Date BETWEEN '2023-01-01' AND '2023-12-31'

UNION ALL

SELECT
  AUD.Original_Request_ID AS ChangeRequestID,
  'Change Request Rejected' AS ActivityName,
  AUD.Audit_Date AS EventStartTime,
  CIC.Change_Type AS ChangeType,
  AUD.Fields_Changed AS Status,
  CIC.Priority AS Priority,
  CIC.Risk_Level AS RiskLevel,
  CIC.ASLOGID AS ApproverGroup,
  CIC.ASGRP AS ImplementationTeam,
  'BMC Helix ITSM' AS SourceSystem,
  GETDATE() AS LastDataUpdate
FROM CHG_ChangeRequest_AuditLogSystem AUD
JOIN CHG_Infrastructure_Change CIC ON AUD.Original_Request_ID = CIC.Infrastructure_Change_ID
WHERE AUD.Fields_Changed LIKE '%Status%Rejected%'
  AND CIC.Submit_Date BETWEEN '2023-01-01' AND '2023-12-31'

UNION ALL

SELECT
  AUD.Original_Request_ID AS ChangeRequestID,
  'Implementation Plan Developed' AS ActivityName,
  AUD.Audit_Date AS EventStartTime,
  CIC.Change_Type AS ChangeType,
  AUD.Fields_Changed AS Status,
  CIC.Priority AS Priority,
  CIC.Risk_Level AS RiskLevel,
  CIC.ASLOGID AS ApproverGroup,
  CIC.ASGRP AS ImplementationTeam,
  'BMC Helix ITSM' AS SourceSystem,
  GETDATE() AS LastDataUpdate
FROM CHG_ChangeRequest_AuditLogSystem AUD
JOIN CHG_Infrastructure_Change CIC ON AUD.Original_Request_ID = CIC.Infrastructure_Change_ID
WHERE AUD.Fields_Changed LIKE '%Status%Planning In Progress%'
  AND CIC.Submit_Date BETWEEN '2023-01-01' AND '2023-12-31'

UNION ALL

SELECT
  AUD.Original_Request_ID AS ChangeRequestID,
  'Change Scheduled' AS ActivityName,
  AUD.Audit_Date AS EventStartTime,
  CIC.Change_Type AS ChangeType,
  AUD.Fields_Changed AS Status,
  CIC.Priority AS Priority,
  CIC.Risk_Level AS RiskLevel,
  CIC.ASLOGID AS ApproverGroup,
  CIC.ASGRP AS ImplementationTeam,
  'BMC Helix ITSM' AS SourceSystem,
  GETDATE() AS LastDataUpdate
FROM CHG_ChangeRequest_AuditLogSystem AUD
JOIN CHG_Infrastructure_Change CIC ON AUD.Original_Request_ID = CIC.Infrastructure_Change_ID
WHERE AUD.Fields_Changed LIKE '%Status%Scheduled%'
  AND CIC.Submit_Date BETWEEN '2023-01-01' AND '2023-12-31'

UNION ALL

SELECT
  AUD.Original_Request_ID AS ChangeRequestID,
  'Change Implemented' AS ActivityName,
  AUD.Audit_Date AS EventStartTime,
  CIC.Change_Type AS ChangeType,
  AUD.Fields_Changed AS Status,
  CIC.Priority AS Priority,
  CIC.Risk_Level AS RiskLevel,
  CIC.ASLOGID AS ApproverGroup,
  CIC.ASGRP AS ImplementationTeam,
  'BMC Helix ITSM' AS SourceSystem,
  GETDATE() AS LastDataUpdate
FROM CHG_ChangeRequest_AuditLogSystem AUD
JOIN CHG_Infrastructure_Change CIC ON AUD.Original_Request_ID = CIC.Infrastructure_Change_ID
WHERE AUD.Fields_Changed LIKE '%Status%Completed%'
  AND CIC.Submit_Date BETWEEN '2023-01-01' AND '2023-12-31'

UNION ALL

SELECT
  AUD.Original_Request_ID AS ChangeRequestID,
  'Testing Performed' AS ActivityName,
  AUD.Audit_Date AS EventStartTime,
  CIC.Change_Type AS ChangeType,
  AUD.Fields_Changed AS Status,
  CIC.Priority AS Priority,
  CIC.Risk_Level AS RiskLevel,
  CIC.ASLOGID AS ApproverGroup,
  CIC.ASGRP AS ImplementationTeam,
  'BMC Helix ITSM' AS SourceSystem,
  GETDATE() AS LastDataUpdate
FROM CHG_ChangeRequest_AuditLogSystem AUD
JOIN CHG_Infrastructure_Change CIC ON AUD.Original_Request_ID = CIC.Infrastructure_Change_ID
WHERE AUD.Fields_Changed LIKE '%Status%Completed%'
  AND CIC.Submit_Date BETWEEN '2023-01-01' AND '2023-12-31'

UNION ALL

SELECT
  AUD.Original_Request_ID AS ChangeRequestID,
  'Post-Implementation Review' AS ActivityName,
  AUD.Audit_Date AS EventStartTime,
  CIC.Change_Type AS ChangeType,
  AUD.Fields_Changed AS Status,
  CIC.Priority AS Priority,
  CIC.Risk_Level AS RiskLevel,
  CIC.ASLOGID AS ApproverGroup,
  CIC.ASGRP AS ImplementationTeam,
  'BMC Helix ITSM' AS SourceSystem,
  GETDATE() AS LastDataUpdate
FROM CHG_ChangeRequest_AuditLogSystem AUD
JOIN CHG_Infrastructure_Change CIC ON AUD.Original_Request_ID = CIC.Infrastructure_Change_ID
WHERE AUD.Fields_Changed LIKE '%Status%Closed%'
  AND CIC.Submit_Date BETWEEN '2023-01-01' AND '2023-12-31'

UNION ALL

SELECT
  AUD.Original_Request_ID AS ChangeRequestID,
  'Change Verified' AS ActivityName,
  AUD.Audit_Date AS EventStartTime,
  CIC.Change_Type AS ChangeType,
  AUD.Fields_Changed AS Status,
  CIC.Priority AS Priority,
  CIC.Risk_Level AS RiskLevel,
  CIC.ASLOGID AS ApproverGroup,
  CIC.ASGRP AS ImplementationTeam,
  'BMC Helix ITSM' AS SourceSystem,
  GETDATE() AS LastDataUpdate
FROM CHG_ChangeRequest_AuditLogSystem AUD
JOIN CHG_Infrastructure_Change CIC ON AUD.Original_Request_ID = CIC.Infrastructure_Change_ID
WHERE AUD.Fields_Changed LIKE '%Status%Closed%'
  AND CIC.Submit_Date BETWEEN '2023-01-01' AND '2023-12-31'

UNION ALL

SELECT
  AUD.Original_Request_ID AS ChangeRequestID,
  'Change Closed' AS ActivityName,
  AUD.Audit_Date AS EventStartTime,
  CIC.Change_Type AS ChangeType,
  AUD.Fields_Changed AS Status,
  CIC.Priority AS Priority,
  CIC.Risk_Level AS RiskLevel,
  CIC.ASLOGID AS ApproverGroup,
  CIC.ASGRP AS ImplementationTeam,
  'BMC Helix ITSM' AS SourceSystem,
  GETDATE() AS LastDataUpdate
FROM CHG_ChangeRequest_AuditLogSystem AUD
JOIN CHG_Infrastructure_Change CIC ON AUD.Original_Request_ID = CIC.Infrastructure_Change_ID
WHERE AUD.Fields_Changed LIKE '%Status%Closed%'
  AND CIC.Submit_Date BETWEEN '2023-01-01' AND '2023-12-31'

UNION ALL

SELECT
  AUD.Original_Request_ID AS ChangeRequestID,
  'Change Cancelled' AS ActivityName,
  AUD.Audit_Date AS EventStartTime,
  CIC.Change_Type AS ChangeType,
  AUD.Fields_Changed AS Status,
  CIC.Priority AS Priority,
  CIC.Risk_Level AS RiskLevel,
  CIC.ASLOGID AS ApproverGroup,
  CIC.ASGRP AS ImplementationTeam,
  'BMC Helix ITSM' AS SourceSystem,
  GETDATE() AS LastDataUpdate
FROM CHG_ChangeRequest_AuditLogSystem AUD
JOIN CHG_Infrastructure_Change CIC ON AUD.Original_Request_ID = CIC.Infrastructure_Change_ID
WHERE AUD.Fields_Changed LIKE '%Status%Cancelled%'
  AND CIC.Submit_Date BETWEEN '2023-01-01' AND '2023-12-31';

步骤

前提条件：确保系统已安装Python 3和requests库。您可以在终端或命令提示符中运行pip install requests安装该库。
获取API凭据：联系BMC Helix ITSM管理员，获取API用户凭据。该用户必须拥有“CHG:Infrastructure Change”表单的读取权限。
保存Python脚本：复制“query”部分提供的完整Python脚本，并将其保存为extract_helix_changes.py。
配置脚本变量：在文本编辑器中打开extract_helix_changes.py文件。找到顶部的配置部分，将BASE_URL、USERNAME、PASSWORD、START_DATE和END_DATE的占位值更新为您的Helix环境信息和所需日期范围。
执行提取脚本：打开终端或命令提示符，进入脚本保存目录，并运行命令：python extract_helix_changes.py。
监控执行过程：脚本会在控制台输出进度更新，显示已处理的变更请求数量。根据日期范围和数据量，执行可能需要一段时间。
获取输出文件：脚本完成后，会在同一目录生成名为change_management_event_log.csv的CSV文件。
准备上传：该CSV文件就是事件日志，包含所需的“ChangeRequestID”、“ActivityName”和“EventStartTime”列，可直接上传到ProcessMind进行分析。

配置

BASE_URL：您的BMC Helix ITSM环境的基础URL，例如https://your-company.bmc.com。
USERNAME / PASSWORD：具有“CHG:Infrastructure Change”表单读取权限的专用API用户凭据。
START_DATE / END_DATE：数据提取的日期范围，格式为“YYYY-MM-DD”。首次分析建议使用最近3至6个月的数据，在数据量和流程洞察之间取得平衡。
LIMIT：脚本中的此变量控制每次API调用获取的记录数。默认值500通常较为稳妥，但可根据环境性能和API限制进行调整。
所需权限：API用户至少必须拥有“CHG:Infrastructure Change”表单及其字段的只读权限，才能成功提取数据。

a 示例查询 python

import requests
import json
import csv
from datetime import datetime

class=class="hl-string">"hl-comment"># --- Configuration ---
class=class="hl-string">"hl-comment"># Replace with your BMC Helix environment details
BASE_URL = class="hl-string">"https://[your-helix-domain].bmc.com"
USERNAME = class="hl-string">"[your_api_user]"
PASSWORD = class="hl-string">"[your_api_password]"

class=class="hl-string">"hl-comment"># Set the date range for the extraction (YYYY-MM-DD)
START_DATE = class="hl-string">"2023-01-01"
END_DATE = class="hl-string">"2023-12-31"

class=class="hl-string">"hl-comment"># Output file name
OUTPUT_FILE = class="hl-string">"change_management_event_log.csv"

class=class="hl-string">"hl-comment"># --- End of Configuration ---

def get_auth_token(base_url, username, password):
    class="hl-string">"""Authenticates with the REST API and returns a JWT token."""
    auth_url = fclass="hl-string">"{base_url}/api/jwt/login"
    headers = {class="hl-string">"Content-Type": class="hl-string">"application/x-www-form-urlencoded"}
    data = {class="hl-string">"username": username, class="hl-string">"password": password}
    try:
        response = requests.post(auth_url, headers=headers, data=data)
        response.raise_for_status()
        return response.text
    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">"Error during authentication: {e}")
        return None

def format_timestamp(ts_string):
    class="hl-string">"""Formats Helix timestamp to ISO 8601 format."""
    if not ts_string:
        return None
    class=class="hl-string">"hl-comment"># Helix format is often class="hl-string">'YYYY-MM-DDTHH:MM:SS.sss+0000'
    try:
        dt_obj = datetime.strptime(ts_string.split(class="hl-string">'.')[0], class="hl-string">"%Y-%m-%dT%H:%M:%S")
        return dt_obj.strftime(class="hl-string">"%Y-%m-%d %H:%M:%S")
    except (ValueError, IndexError):
        return ts_string class=class="hl-string">"hl-comment"># Return as-is if format is unexpected

def main():
    class="hl-string">"""Main function to extract, transform, and save change management data."""
    token = get_auth_token(BASE_URL, USERNAME, PASSWORD)
    if not token:
        return

    headers = {
        class="hl-string">"Authorization": fclass="hl-string">"AR-JWT {token}",
        class="hl-string">"Content-Type": class="hl-string">"application/json"
    }

    class=class="hl-string">"hl-comment"># Field IDs for class="hl-string">'CHG:Infrastructure Change' form
    class=class="hl-string">"hl-comment"># Add any other custom fields you need here
    fields = [
        class="hl-string">"Infrastructure Change ID", class=class="hl-string">"hl-comment"># ChangeRequestID
        class="hl-string">"Create Date", class=class="hl-string">"hl-comment"># For class="hl-string">'Change Request Created'
        class="hl-string">"Submit Date", class=class="hl-string">"hl-comment"># For class="hl-string">'Change Request Submitted'
        class="hl-string">"Actual Start Date", class=class="hl-string">"hl-comment"># For class="hl-string">'Change Implemented'
        class="hl-string">"Actual End Date", class=class="hl-string">"hl-comment"># For class="hl-string">'Post-Implementation Review'
        class="hl-string">"Completed Date", class=class="hl-string">"hl-comment"># For class="hl-string">'Change Verified'
        class="hl-string">"Closed Date", class=class="hl-string">"hl-comment"># For class="hl-string">'Change Closed'
        class="hl-string">"Last Modified Date",
        class="hl-string">"Change Request Status",
        class="hl-string">"Change Type",
        class="hl-string">"Priority",
        class="hl-string">"Risk Level",
        class="hl-string">"ASLOGID", class=class="hl-string">"hl-comment"># Approver Login ID (can be used for Approver Group)
        class="hl-string">"ASGRP" class=class="hl-string">"hl-comment"># Assigned Group (can be used for Implementation Team)
    ]

    query = fclass="hl-string">"'Create Date' >= \"{START_DATE}T00:00:00Z\class="hl-string">" AND 'Create Date' <= \"{END_DATE}T23:59:59Z\class="hl-string">""
    
    all_events = []
    offset = 0
    limit = 500
    processed_count = 0

    print(class="hl-string">"Starting data extraction...")

    while True:
        api_url = fclass="hl-string">"{BASE_URL}/api/arsys/v1/entry/CHG:Infrastructure Change?q={query}&fields=values({','.join(fields)})&limit={limit}&offset={offset}"
        try:
            response = requests.get(api_url, headers=headers)
            response.raise_for_status()
            data = response.json()
            entries = data.get(class="hl-string">"entries", [])
        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Error fetching data from API: {e}")
            break

        if not entries:
            break class=class="hl-string">"hl-comment"># No more records to fetch
        
        last_data_update = datetime.now().strftime(class="hl-string">"%Y-%m-%d %H:%M:%S")

        for entry in entries:
            values = entry.get(class="hl-string">"values", {})
            change_id = values.get(class="hl-string">"Infrastructure Change ID")
            if not change_id:
                continue

            class=class="hl-string">"hl-comment"># Common attributes for all events of this case
            base_event = {
                class="hl-string">"ChangeRequestID": change_id,
                class="hl-string">"SourceSystem": class="hl-string">"BMC Helix ITSM",
                class="hl-string">"LastDataUpdate": last_data_update,
                class="hl-string">"ChangeType": values.get(class="hl-string">"Change Type"),
                class="hl-string">"Status": values.get(class="hl-string">"Change Request Status"),
                class="hl-string">"Priority": values.get(class="hl-string">"Priority"),
                class="hl-string">"RiskLevel": values.get(class="hl-string">"Risk Level"),
                class="hl-string">"ApproverGroup": values.get(class="hl-string">"ASLOGID"),
                class="hl-string">"ImplementationTeam": values.get(class="hl-string">"ASGRP")
            }
            
            status = values.get(class="hl-string">"Change Request Status")
            last_modified_date = format_timestamp(values.get(class="hl-string">"Last Modified Date"))

            class=class="hl-string">"hl-comment"># 1. Change Request Created
            if values.get(class="hl-string">"Create Date"):
                all_events.append({**base_event, class="hl-string">"ActivityName": class="hl-string">"Change Request Created", class="hl-string">"EventStartTime": format_timestamp(values.get(class="hl-string">"Create Date"))})

            class=class="hl-string">"hl-comment"># 2. Change Request Submitted
            if values.get(class="hl-string">"Submit Date"):
                all_events.append({**base_event, class="hl-string">"ActivityName": class="hl-string">"Change Request Submitted", class="hl-string">"EventStartTime": format_timestamp(values.get(class="hl-string">"Submit Date"))})
            
            class=class="hl-string">"hl-comment"># The following activities are inferred from status and key dates.
            class=class="hl-string">"hl-comment"># This logic assumes a standard process flow. Adjust if your flow differs.

            class=class="hl-string">"hl-comment"># 3. Risk Assessment Performed & 4. Impact Analysis Conducted
            class=class="hl-string">"hl-comment"># Inferred when status moves past class="hl-string">'Request For Authorization'
            if status not in [class="hl-string">'Draft', class="hl-string">'Request For Authorization'] and values.get(class="hl-string">"Submit Date"):
                all_events.append({**base_event, class="hl-string">"ActivityName": class="hl-string">"Risk Assessment Performed", class="hl-string">"EventStartTime": last_modified_date})
                all_events.append({**base_event, class="hl-string">"ActivityName": class="hl-string">"Impact Analysis Conducted", class="hl-string">"EventStartTime": last_modified_date})

            class=class="hl-string">"hl-comment"># 5. Change Request Approved
            class=class="hl-string">"hl-comment"># 7. Implementation Plan Developed
            class=class="hl-string">"hl-comment"># 8. Change Scheduled
            if status in [class="hl-string">'Scheduled', class="hl-string">'Implementation In Progress', class="hl-string">'Completed', class="hl-string">'Closed']:
                 class=class="hl-string">"hl-comment"># Use Last Modified Date as a proxy for approval/planning timestamp
                 event_time = last_modified_date
                 all_events.append({**base_event, class="hl-string">"ActivityName": class="hl-string">"Change Request Approved", class="hl-string">"EventStartTime": event_time})
                 all_events.append({**base_event, class="hl-string">"ActivityName": class="hl-string">"Implementation Plan Developed", class="hl-string">"EventStartTime": event_time})
                 all_events.append({**base_event, class="hl-string">"ActivityName": class="hl-string">"Change Scheduled", class="hl-string">"EventStartTime": event_time})

            class=class="hl-string">"hl-comment"># 6. Change Request Rejected
            if status == class="hl-string">'Rejected':
                all_events.append({**base_event, class="hl-string">"ActivityName": class="hl-string">"Change Request Rejected", class="hl-string">"EventStartTime": last_modified_date})

            class=class="hl-string">"hl-comment"># 9. Change Implemented
            if values.get(class="hl-string">"Actual Start Date"):
                all_events.append({**base_event, class="hl-string">"ActivityName": class="hl-string">"Change Implemented", class="hl-string">"EventStartTime": format_timestamp(values.get(class="hl-string">"Actual Start Date"))})

            class=class="hl-string">"hl-comment"># 10. Testing Performed
            class=class="hl-string">"hl-comment"># 11. Post-Implementation Review
            if values.get(class="hl-string">"Actual End Date"):
                event_time = format_timestamp(values.get(class="hl-string">"Actual End Date"))
                all_events.append({**base_event, class="hl-string">"ActivityName": class="hl-string">"Testing Performed", class="hl-string">"EventStartTime": event_time})
                all_events.append({**base_event, class="hl-string">"ActivityName": class="hl-string">"Post-Implementation Review", class="hl-string">"EventStartTime": event_time})
            
            class=class="hl-string">"hl-comment"># 12. Change Verified
            if values.get(class="hl-string">"Completed Date"):
                all_events.append({**base_event, class="hl-string">"ActivityName": class="hl-string">"Change Verified", class="hl-string">"EventStartTime": format_timestamp(values.get(class="hl-string">"Completed Date"))})

            class=class="hl-string">"hl-comment"># 13. Change Closed
            if status == class="hl-string">'Closed' and values.get(class="hl-string">"Closed Date"):
                all_events.append({**base_event, class="hl-string">"ActivityName": class="hl-string">"Change Closed", class="hl-string">"EventStartTime": format_timestamp(values.get(class="hl-string">"Closed Date"))})

            class=class="hl-string">"hl-comment"># 14. Change Cancelled
            if status == class="hl-string">'Cancelled':
                all_events.append({**base_event, class="hl-string">"ActivityName": class="hl-string">"Change Cancelled", class="hl-string">"EventStartTime": last_modified_date})
        
        processed_count += len(entries)
        print(fclass="hl-string">"Processed {processed_count} change requests...")
        offset += limit

    if not all_events:
        print(class="hl-string">"No events were generated. Check your date range and API permissions.")
        return

    class=class="hl-string">"hl-comment"># Write to CSV
    fieldnames = all_events[0].keys()
    with open(OUTPUT_FILE, class="hl-string">'w', newline=class="hl-string">'', encoding=class="hl-string">'utf-8') as f:
        writer = csv.DictWriter(f, fieldnames=fieldnames)
        writer.writeheader()
        writer.writerows(all_events)

    print(fclass="hl-string">"\nExtraction complete. Event log saved to {OUTPUT_FILE}")

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

准备好开始了吗？

使用此模板准备数据，立即开始优化您的变更管理流程。发现有价值的洞察，提升整个运营体系的效率。

返回改进指南下载模板

立即优化您的变更管理，避免服务中断

将变更成功率提升至95%，避免代价高昂的服务中断。

开始免费试用

无需信用卡，几分钟即可完成设置。

您的变更管理数据模板

您的变更管理数据模板

变更管理属性

变更管理活动

提取指南

BMC Helix ITSM报告及CSV/XLSX导出

步骤

配置

a 示例查询 sql

直接查询AR System数据库视图

步骤

配置

a 示例查询 sql

通过BMC Helix REST API使用Python提取数据

步骤

配置

a 示例查询 python

准备好开始了吗？

立即优化您的变更管理，避免服务中断

您的变更管理数据模板

您的变更管理数据模板

变更管理属性

变更管理活动

提取指南

BMC Helix ITSM报告及CSV/XLSX导出

步骤

配置

a 示例查询 sql

直接查询AR System数据库视图

步骤

配置

a 示例查询 sql

通过BMC Helix REST API使用Python提取数据

步骤

配置

a 示例查询 python

准备好开始了吗？

立即优化您的变更管理，避免服务中断

我们重视您的隐私