Desvendando o Arquivo XER do Primavera P6: O Guia Completo

Se você trabalha com o Oracle Primavera P6, certamente já se deparou com a extensão de arquivo .xer. Mas você sabe exatamente o que ela significa, o que contém e, mais importante, quais são suas limitações?

Neste guia completo, vamos desmistificar o formato XER, desde sua estrutura básica até os detalhes do processo de importação e exportação.

O que é um Arquivo XER?

XER é o acrônimo para Oracle Primavera Proprietary Exchange Format. Em termos simples, é um formato de arquivo proprietário usado pelo P6 EPPM (Enterprise Project Portfolio Management), incluindo a versão P6 Professional, para uma finalidade crucial: importar e exportar dados de projetos.

Pense nele como a "linguagem" que o Primavera usa para empacotar e desempacotar cronogramas, recursos e todas as informações associadas a um projeto, permitindo o intercâmbio de dados entre diferentes bancos de dados ou sistemas.

----------------------------------------------------------------------------

A Estrutura Técnica: Por Dentro de um XER

Para os mais curiosos, a estrutura de um arquivo XER é, na verdade, bastante simples.

- Formato: É um arquivo de texto puro, onde os dados são organizados em colunas separadas pelo caractere TAB (similar a um CSV, mas com um delimitador diferente).
- Visualização: Você pode abrir um arquivo XER em qualquer editor de texto (como o Bloco de Notas) ou de forma mais organizada no Excel, importando-o como um arquivo de texto delimitado por tabulação.
- Identificadores de Linha: Cada linha começa com um código especial que define seu conteúdo:

• %T: Indica o início de uma Tabela (ex: TASK, PROJECT).
• %F: Indica os Campos (colunas) da tabela.
• %R: Indica um Registro (uma linha de dados) dentro da tabela.
• %E: Marca o Fim do arquivo.

----------------------------------------------------------------------------

O Que Contém um Arquivo XER?

Um arquivo XER é surpreendentemente abrangente, organizando os dados em duas categorias hierárquicas principais: 1 - Dados de Projeto e 2 - Dados de Workspace.

1 - Dados de Projetos

Os Dados de Projeto (Project Data) representam o núcleo informacional do arquivo XER, contendo todas as informações específicas do cronograma que você gerencia no dia a dia. Estas informações são estruturadas em tabelas relacionais que preservam a integridade e os relacionamentos entre os diferentes elementos do projeto.

a) Tarefas (Atividades)

As atividades são armazenadas principalmente na tabela TASK do arquivo XER, incluindo todos os detalhes essenciais para o gerenciamento do cronograma.

Exemplo no arquivo XER:

%T	TASK
%F	task_id	proj_id	wbs_id	task_code	task_name	task_type	duration_type	status_code	act_start_date	act_end_date	early_start_date	early_end_date	late_start_date	late_end_date	target_start_date	target_end_date	act_work_qty	act_equip_qty	remain_work_qty	remain_equip_qty	target_work_qty	target_equip_qty	task_percent_comp	physical_percent_comp
%R	1001	100	2001	A1010	Mobilização da Obra	TT_Task	DT_FixDur	TK_NotStart	2024-01-15 08:00	2024-01-19 17:00	2024-01-15 08:00	2024-01-19 17:00	2024-01-15 08:00	2024-01-19 17:00		40.00	0.00	0.00	0.00	40.00	0.00	0	0
%R	1002	100	2001	A1020	Escavação Fundação	TT_Task	DT_FixDur	TK_Active	2024-01-22 08:00	2024-02-05 17:00	2024-01-22 08:00	2024-02-05 17:00	2024-01-25 08:00	2024-02-08 17:00		120.00	8.00	80.00	3.00	120.00	8.00	33	25

Em uma tabela fica assim:

b) Estrutura do Projeto (WBS)

A Estrutura Analítica do Projeto é mapeada na tabela PROJWBS, diferenciando claramente os diferentes níveis hierárquicos e tipos de elementos.

Exemplo no arquivo XER:

%T	PROJWBS
%F	wbs_id	proj_id	obs_id	seq_num	est_wt	proj_node_flag	summary_level	wbs_name	wbs_short_name	phase_id	parent_wbs_id	ev_user_pct	ev_etc_user_value
%R	2000	100	0	1000	0.00	Y	1	Construção Edifício Comercial	Ed. Comercial		0	0.00	0.00
%R	2001	100	0	2000	0.00	N	2	01 - Infraestrutura	01-Infra	PHASE001	2000	0.00	0.00
%R	2002	100	0	3000	0.00	N	2	02 - Superestrutura	02-Super	PHASE002	2000	0.00	0.00
%R	2003	100	0	4000	0.00	N	3	02.01 - Estrutura de Concreto	02.01-Conc	PHASE002	2002	0.00	0.00

c) Recursos e Alocações

Os recursos são definidos na tabela RSRC e suas alocações nas tarefas são especificadas na tabela TASKRSRC.

Exemplo de Recursos (tabela RSRC):

%T	RSRC
%F	rsrc_id	parent_rsrc_id	rsrc_type	rsrc_name	rsrc_short_name	rsrc_tag	unit_abbrev	def_qty_per_hr	cost_per_qty	base_cost_per_qty	max_qty_per_hr
%R	3001	0	RT_Labor	Pedreiro Especializado	Pedreiro Esp	PED-ESP	h	1.00	45.00	40.00	8.00
%R	3002	0	RT_Mat	Concreto FCK25	Concreto 25	CONC-25	m³	1.00	280.00	275.00	0.00
%R	3003	0	RT_Equip	Retroescavadeira CAT 320	Retro CAT320	RET-320	h	1.00	150.00	145.00	1.00

Exemplo de Alocações (tabela TASKRSRC):

%T	TASKRSRC
%F	taskrsrc_id	task_id	rsrc_id	qty_per_hr	budg_qty	act_ot_qty	act_reg_qty	remain_qty	target_qty	cost_per_qty	act_ot_cost	act_reg_cost	remain_cost
%R	4001	1001	3001	2.00	80.00	0.00	26.40	53.60	80.00	45.00	0.00	1188.00	2412.00
%R	4002	1001	3003	1.00	40.00	0.00	13.20	26.80	40.00	150.00	0.00	1980.00	4020.00
%R	4003	1002	3002	0.50	60.00	0.00	20.00	40.00	60.00	280.00	0.00	5600.00	11200.00

d) Propriedades Customizadas

Campos personalizados são armazenados em diferentes tabelas dependendo do elemento ao qual se aplicam, como TASKPROP para propriedades de tarefas.

Exemplo no arquivo XER:

%T	TASKPROP
%F	task_id	proj_id	prop_name	prop_value	date_value	float_value	int_value
%R	1001	100	Responsável	João Silva			0
%R	1001	100	Prioridade	Alta			3
%R	1001	100	Observações	Coordenar com equipe de topografia			0
%R	1002	100	Status_Qualidade	Aprovado			0
%R	1002	100	Percentual_Medido		2024-01-28 00:00	25.50	0

e) Configurações de Agendamento

As configurações de agendamento são definidas tanto no nível do projeto (tabela PROJECT) quanto no nível das tarefas individuais.

Exemplo de configurações do projeto:

%T	PROJECT
%F	proj_id	proj_short_name	proj_name	plan_start_date	proj_end_date	scd_end_date	data_date	last_recalc_date	critical_drtn_hr_cnt	def_duration_type	task_code_base	def_calendar_id	enable_multiple_longest_path	critical_path_type	retain_logic	auto_compute_act_flag
%R	100	PROJ001	Construção Edifício Comercial	2024-01-15 08:00	2024-12-20 17:00	2024-12-20 17:00	2024-01-28 17:00	2024-01-28 18:30	0.00	DT_FixDur	1	1	N	CPT_Longest	Y	Y

Exemplo de configurações específicas de tarefas:

%T	TASK
%F	task_id	duration_type	constraint_type	constraint_date	auto_compute_act_flag	level_flag	calendar_id	driving_path_flag	float_path_flag	guid
%R	1001	DT_FixDur	CS_MSO	2024-01-15 08:00	Y	N	1	Y	N	{12345678-1234-5678-9ABC-123456789012}
%R	1002	DT_FixDur	CS_ALAP		Y	N	1	N	Y	{12345678-1234-5678-9ABC-123456789013}

2. Dados de Workspace (Enterprise Data)

São os objetos de dados compartilhados entre múltiplos projetos dentro de um mesmo ambiente do Primavera.
- Calendários: Definições detalhadas dos calendários globais e de recursos, incluindo dias e horas de trabalho, feriados e outras exceções.
- Códigos: Todos os tipos de códigos utilizados para categorização (Códigos de Atividade, Códigos de Recurso, etc.).
- Unidades de Medida: As unidades padrão (horas, dias, toneladas) usadas para quantificar recursos e durações.

----------------------------------------------------------------------------

Nomenclatura Técnica vs Interface do Usuário - Arquivo XER

O arquivo XER utiliza uma nomenclatura técnica de banco de dados que nem sempre corresponde diretamente aos termos familiares da interface do Primavera P6. Esta diferenciação é fundamental para profissionais que trabalham com:

• Integração de dados entre sistemas
• Análise direta dos arquivos XER
• Desenvolvimento de relatórios customizados
• Migração de projetos entre plataformas

Categorias de Nomenclatura

1. Campos Exclusivos do Sistema Interno

Estes campos utilizam nomenclatura puramente técnica, sem correspondência direta na interface:

• task_id: Identificador único interno da tarefa
• wbs_id: Referência hierárquica da estrutura analítica
• proj_id: Identificador interno do projeto
• rsrc_id: Identificador único do recurso
• calendar_id: Referência interna do calendário

2. Correspondência Direta com a Interface

Campos técnicos que possuem equivalência clara na interface do usuário:

Campo Técnico (XER)	Interface P6	Descrição
task_code	Activity ID	Código identificador da atividade
task_name	Activity Name	Nome descritivo da atividade
act_start_date	Actual Start	Data real de início
act_end_date	Actual Finish	Data real de término
early_start_date	Early Start	Data mais cedo de início
early_end_date	Early Finish	Data mais cedo de término
task_percent_comp	% Complete	Percentual de progresso físico
target_work_qty	Budgeted Labor Units	Quantidade de trabalho orçada
remain_work_qty	Remaining Labor Units	Quantidade de trabalho restante
rsrc_name	Resource Name	Nome do recurso

3. Campos com Nomenclatura Parcialmente Relacionada

Alguns campos requerem interpretação contextual:

• duration_type: Relaciona-se com "Duration Type" (Fixed Duration, Fixed Work, etc.)
• constraint_type: Corresponde às restrições como "Must Start On", "Finish No Later Than"
• status_code: Estado da atividade (Not Started, In Progress, Completed)
• parent_wbs_id: Elemento pai na estrutura hierárquica

----------------------------------------------------------------------------

Tabelas Iniciais em Arquivos XER de Projetos Novos e Vazios no Oracle Primavera P6.

As tabelas listadas representam a estrutura inicial mínima de um arquivo XER gerado ao criar um projeto no Oracle Primavera P6, antes de adicionar qualquer elemento como atividades, recursos

essenciais são exportados para garantir a configuração básica do projeto. Elas incluem o cabeçalho (ERMHDR) e tabelas fundamentais como moedas padrão, estruturas organizacionais e breakdowns de trabalho iniciais.

- Estrutura Básica: O arquivo XER começa com o cabeçalho ERMHDR, que indica a versão do P6 (como 23.12) e detalhes de exportação, seguido pelas tabelas marcadas por %T.
- Razão para Minimalismo: Em projetos novos sem dados inseridos, tabelas relacionadas a atividades ou riscos não aparecem, evitando inchaço desnecessário no arquivo.
- Importância Prática: Essa configuração inicial permite a importação limpa, sem conflitos, e serve como base para construir o cronograma.

O Que Cada Tabela Representa

- ERMHDR: Cabeçalho do arquivo, com versão do software e metadados de exportação.
- CURRTYPE: Tipos de moedas padrão usadas no projeto.
- FINTMPL: Modelos financeiros iniciais, como períodos fiscais básicos.
- OBS: Estrutura de Breakdown Organizacional (Organizational Breakdown Structure), com hierarquia padrão.
- PROJECT: Detalhes do projeto recém-criado, como ID, nome e configurações iniciais.
- CALENDAR: Calendários padrão, como o calendário global de trabalho.
- PROJWBS: Work Breakdown Structure inicial, com o nó raiz do projeto.

Essas tabelas garantem que o projeto vazio mantenha integridade básica ao ser exportado ou importado. Para mais detalhes, consulte a documentação oficial da Oracle em 

Oracle Primavera P6 EPPM XER Import/Export Data Map Guide (Project) Version 23

https://docs.oracle.com/cd/F74773_01/English/Mapping_and_Schema/xer_import_export_data_map_project/97864.htm

Oracle Primavera P6 EPPM XER Import/Export Data Map Guide (Resource Only) Version 23

https://docs.oracle.com/cd/F74773_01/English/Mapping_and_Schema/xer_import_export_data_map_resource_only/97845.htm

----------------------------------------------------------------------------

De Vazio a Completo: Como o Arquivo XER Evolui

Um dos aspectos mais interessantes do formato XER é que ele é dinâmico. O número de tabelas no arquivo cresce à medida que você adiciona dados ao seu cronograma no Primavera P6.

Pense nisso como construir uma casa: você começa com a fundação (as tabelas iniciais) e vai adicionando as paredes, o telhado e os acabamentos (novas tabelas de dados).

Por exemplo:

- Ao criar e exportar a primeira atividade, a tabela TASK aparecerá pela primeira vez no arquivo XER.

- Se você criar um relacionamento entre duas atividades, a tabela TASKPRED (Task Predecessor) será incluída na próxima exportação.
Ao alocar o primeiro recurso a uma atividade, o Primavera adicionará as tabelas RSRC (para definir o recurso) e TASKRSRC (para registrar a alocação) ao arquivo.

- E assim por diante. Cada novo tipo de dado inserido no projeto ativa a tabela correspondente no momento da exportação, construindo progressivamente o mapa de dados completo que vimos no capítulo anterior.

----------------------------------------------------------------------------

Lista das Principais Tabelas a Serem Identificadas no Arquivo XER do Primavera P6

As tabelas abaixo compõem a estrutura do arquivo XER exportado do Primavera P6 e possuem as seguintes funções:

Nome da Tabela	Descrição/Função
%T PROJECT	Armazena informações gerais do projeto (nome, datas, calendário, parâmetros).
%T PROJWBS	Define a hierarquia da Estrutura Analítica do Projeto (EAP).
%T TASK	Contém detalhes das atividades (datas, durações, recursos, status).
%T TASKMEMO	Armazena comentários e notas textuais associadas às atividades.
%T MEMOTYPE	Define os tipos de memos/comentários utilizados no projeto.
%T UDFTYPE	Gerencia os tipos de campos personalizados (User Defined Fields).
%T TASKPRED	Registra as relações de precedência entre as atividades.
%T TASKPROC	Gerencia procedimentos ou etapas específicas associadas às atividades.
%T UDFVALUE	Armazena os valores dos campos personalizados atribuídos a entidades.