Import/Paste Configuration Dialog - Configure Safety Program Properties Overview
Use this dialog box to configure how the safety program is imported into the project, or how it is pasted into the project using
Paste Special > With Configuration
command.The References folder can contain folders for referenced tags, data types, Add-On Instructions, or Components, depending on the imported component references.
The Import Content shows the import component and any references in the References folder. The References folder appears if there is logic that references tags, data types, Add-On Instructions, or other components.
When the imported safety program is selected in the import content, the Details pane displays the safety programs properties.
If the operation is set to use existing, then the Description, Type, and Number of rungs/lines/sheets/steps fields show the values from the project and appear dimmed. Otherwise, these fields display the values from the import file.
Parameters
Import Name
Displays the name of the safety program as read from the import file.
Operation
Identifies what is done with this safety program upon import.
The field is pre-populated; however, you can choose from a pull-down list of valid choices.
For more information, see
Import Configuration Operations
.Final Name
The final name is the name of the component as it appears in the project after the import. Changing the Final Name changes the name in all places where this component’s Import Name is referenced in the import content throughout the logic, By default, it is initialized to the Import Name.
When you click in the Final Name cell, a pull-down menu appears that lets you pick from a list of all of the components that exist in the program you are importing into.
If the Final Name collides with and existing component in the project and Overwrite is selected, the existing component is overwritten with the logic content and properties of the component in the import file.
If the component in the import file is source-protected, the Final Name field is read-only.
IMPORTANT:
You may either create or avoid a collision by modifying the final name, (based on if you modify the final name to match that of another final name in the project).
Collision Detail
Click this button to find differences between the imported component and the existing component. See below for
Component Name Collision Dialog - Property Compare Tab Overview
and Component Name Collision Dialog - Project References Tab Overview
.Description
Displays the description of the component.
The description can be changed, unless the Operation is Discard or Use Existing.
If the value in the Operation field is Overwrite or Create, you can change the description.
Schedule In
Contains the name of the existing safety task in the project, or displays Unscheduled Programs, if it is to be unscheduled. These are the only two valid choices for Safety Class programs.
Initially, this control defaults to the context from which the import was initiated, unless the Operation field is initially set to Use Existing.
When offline or when online in Program mode, a message displays in the results window, upon import, that informs you if the safety program was rescheduled or unscheduled.
When online in Run Mode, safety programs cannot be rescheduled and the Schedule In location appears dimmed. You cannot overwrite a safety program in a location different from its current location (by changing the Final Name).
If the safety program collides, then the scheduled location of the safety program cannot be changed, if modify task properties or modify controller properties privileges are not granted.
If the Operation field is set to Create or Overwrite, the pull-down menu contains the following:
- a list of all tasks in the project
- Unscheduled programs
- Controller Fault Handler
- Power-Up Handler
When the Operation field is set to Discard, you can resolve certain error conditions, by changing the selection in the Schedule In control.
When the Operation field is set to Use Existing, Schedule In contains the current location of the existing safety program in the project.
If offline or online in Remote Program mode and if the safety program is scheduled as either the Controller Fault Handler or the Power-Up Handler, then any previously scheduled safety program is given an unscheduled status (moved to the Unscheduled folder) when the import proceeds.
Preserve scheduling for child programs that already exist
Specify if child programs in the destination program remain as they are configured or are replaced with components in the source program that is being imported into the project.
If the check box is selected, then child programs that already exist in the destination program remain scheduled as they are configured in the destination program. By default, child programs are preserved in the program.
You much clear the check box if, upon import, you wish for the child program that is being imported into the project to be scheduled in the task that is identified in the Schedule In field.
Parent
Specify where the program will reside upon import.
If a parent is specified when you are importing from the Logical Organizer view, that parent is shown in this field. Otherwise, <none> is shown when there is not a parent selected or when you are importing from the Controller Organizer view.
If you want to modify the parent specification, click the down arrow to select an option.
Inhibit Program
If checked, the safety program is inhibited on import and does not execute until it is uninhibited.
The checked or unchecked state defaults to that contained in the import file (unless Operation is set to Use Existing).
If the Operation field is set to Create, Overwrite, or Discard, this field reflects the inhibit state of the safety program that is imported. The field appears dimmed if the Operation field is set to Discard.
If the Operation field is set to:
- Overwrite (that is, the imported safety program collides with an existing one and the imported component’s attributes are displayed) and
- the inhibit state of the colliding safety programs is different (that is, one is inhibited and the other is not inhibited),
then a message is displayed under the Inhibit Program checkbox indicating this condition.
A prompt dialog box displays stating that the component already exists in the project and has a different inhibit state if all the following conditions exist:
- the import component collides with a safety program in the project either initially or after a change is made to the Final Name
- the Operation field is set to Overwrite
- the inhibit state of the colliding safety programs are different
- the safety project is online
Class
Displays the attribute for the imported component or the component in the project.
Displays Standard or Safety if the controller the .L5X file is being imported into is a safety controller. (This field is shown only if the destination controller is a safety controller.)
Assigned Routines: Main
Displays the safety program’s assigned main routine.
If the Operation field is set to Overwrite, Create, or Discard, displays the attribute for the import component.
If the Operation field is set to Use Existing, displays the attribute for the component in the project.
Assigned Routine: Fault
Displays the safety program’s assigned fault routine.
If the Operation field is set to Overwrite, Create, or Discard, displays the attribute for the import component.
If the Operation field is set to Use Existing, displays the attribute for the component in the project.
The import fails if you are online in Run mode and you are replacing a safety program and a previously assigned fault routine has changed.
OK
Select this button to accept your import edits.
Cancel
Select this button to cancel your import and close this dialog box.
Help
Select this button for help on this dialog box.
Provide Feedback