How Core Fields are populated on Download from Safran

Modified on Wed, 17 Jun at 2:51 PM

TABLE OF CONTENTS

Resource Core Fields
Calendar Core Fields
Activity Core Fields
Resource Assignment Core Fields
Successor Core Fields
Structure Core Fields

Safran's download is the reverse of the upload – each core field is written back to the same Safran field it was read from, so a Safran-to-Safran transfer preserves almost the whole schedule. A blank Formula means the value is written back unchanged.

Every object except the Schedule is written back: calendars, resources, activities, resource assignments, successor links, and (append-only) R-Field structures. The Schedule header (Description, dates, cutoff, Code) is not written – the import updates the existing matched project rather than overwriting its header. Outline-Code / WBS structures are not imported.

Resource Core Fields

Core field name	Api field	Formula	Data type	Description
Description	name		Text	The resource's name or title.
Code	resource_set id	Identifies the Safran resource to match	Text	The resource's unique identifier in the host system.

Calendar Core Fields

Core field name	Api field	Formula	Data type	Description
HoursPerDay	Hours		Number	The number of working hours in a standard day for this calendar.
Start	cal_start		Date	The calendar's start date.
Finish	cal_finish		Date	The calendar's finish date.
Description	Description	Written with the configured prefix / suffix	Text	The calendar's name or title.
Code	cal_id	Identifies the Safran calendar	Text	The calendar's unique identifier in the host system.

Activity Core Fields

Core field name	Api field	Formula	Data type	Description
ActivityType	act_type	Reverse of the act_type mapping used on upload	Enum	The kind of activity. Possible values: RegularActivity, MilestoneStart, MilestoneFinish, Hammock.
Description	description		Text	The activity's name or title.
MustFinishOn	fixed_finish_date		Date	Constraint date: the activity must finish exactly on this date.
MustStartOn	fixed_start_date		Date	Constraint date: the activity must start exactly on this date.
StartNoEarlierThan	target_start_early		Date	Constraint date: the activity must start on or after this date.
StartNoLaterThan	target_start_late		Date	Constraint date: the activity must start on or before this date.
StartAsLateAsPossible	as_late_as_possible_flag	1 when StartAsLateAsPossible is true	Boolean	Constraint: the activity should start as late as the schedule allows.
ActualStart	actual_start		Date	The date the activity actually started.
ActualFinish	actual_finish		Date	The date the activity actually finished.
ActualWorkHours	expended_qty		Number	Work hours already expended on the activity.
CurrentProgress	current_progress		Number	The activity's progress, as a percentage.
EarlyStart	early_start (per export scope)	Written to the matching baseline / current / revised Safran field	Date	The earliest the activity can start (forward-pass schedule date).
EarlyFinish	early_finish (per export scope)	Written to the matching baseline / current / revised Safran field	Date	The earliest the activity can finish (forward-pass schedule date).
LateStart	late_start (per export scope)	Written to the matching baseline / current / revised Safran field	Date	The latest the activity can start without delaying the project (backward pass).
LateFinish	late_finish (per export scope)	Written to the matching baseline / current / revised Safran field	Date	The latest the activity can finish without delaying the project (backward pass).
FreeFloatHours	free_float		Number	Hours the activity can slip without delaying any successor.
TotalFloatHours	total_float		Number	Hours the activity can slip without delaying the project finish.
PlannedWorkHours	scope (per export scope)	Written to the matching baseline / current / revised Safran scope field	Number	The planned / budgeted work hours for the activity.
IsAlwaysOnSchedule	on_target		Boolean	Whether the activity is flagged to always be treated as on-schedule.
CancelledDate	cancelled		Date	The date the activity was cancelled.
DurationHours	duration	Converted to the Safran duration unit	Number	The activity's duration in hours.
FrontLineDate	frontline_date		Date	The frontline (expected / forecast) date for the activity.
Calendar	calendar	Matched to the Safran calendar	Reference	The calendar that governs the activity's working time.
Code	name		Text	The activity's unique identifier in the host system.

Resource Assignment Core Fields

Core field name	Api field	Formula	Data type	Description
PlannedHours	qty		Number	Planned work hours assigned to the resource on the activity.
DurationHours	duration	Converted to the Safran duration unit	Number	Duration in hours of the resource's assignment.
ActualHours	actual_qty		Number	Actual work hours the resource has spent on the activity.
CurrentProgress	current_progress		Number	The progress of the resource's assignment, as a percentage.
EarlyStart	early_start_date		Date	The early start of the resource's assignment.
EarlyFinish	early_finish_date		Date	The early finish of the resource's assignment.
LagHours	relative_lag	Converted to the Safran lag unit	Number	The lag, in hours, applied to the assignment.
Profile	profile		Reference	The distribution profile applied to the assignment.
Resource	resource_def_id	Matched to the Safran resource	Reference	The resource assigned to the activity.
Code	name		Text	The assignment's unique identifier in the host system.

Successor Core Fields

Core field name	Api field	Formula	Data type	Description
Type	link_type	Reverse of the link_type mapping used on upload	Enum	The dependency relationship type. Possible values: StartToStart, StartToFinish, FinishToStart, FinishToFinish.
LagHours	lag_time	Converted to the Safran lag unit	Number	The lag, in hours, on the relationship.
SuccessorObject	next_id	The successor activity	Reference	The successor activity (the link target).
Code	network_id prev_id next_id link_type	Identifies the link	Text	The link's unique identifier in the host system.

Structure Core Fields

Core field name	Api field	Formula	Data type	Description
Description	reference_field.label	Written to the R-Field label when updating the description is allowed; new element values are appended	Text	The structure's name or title.