Development > Utilities > Miscellaneous > Copy parameter values 

This function is used to copy the values of parameters defined at a given level (company, site, user, legal) for a given code, to a group of destination codes (company, site, user, legal, depending on the selected copy) defined by value range, using a template, or given in the form of a list.

This copy can be performed in simulation mode first (with or without details on the copied parameters).

Screen management

Entry screen

Presentation

A single entry screen makes it possible, when starting the function, to enter all the necessary parameters. When validating the entry, a confirmation is requested, then the function is launched, and a log file reports the result.

Close

 

Fields

The following fields are present on this tab :

Block number 1

  • From folder (field DOSORG)

This field is used to define the folder from which the parameters are going be copied. The possible syntaxes are described in the dedicated appendix.

  • To folder (field DOSDES)

This field is used to define the folder in which the parameters are going be copied. The possible syntaxes are described in the dedicated appendix.

  • Definition level (field NIV)

It defines the level of definition for the parameters to be copied The following values are possible:

  • company (the parameters defined at the level of a company are copied to one or several companies).
  • site (the parameters defined at the level of a site are copied to one or several sites).
  • legislation (the parameters defined at the level of a legislation are copied to one or several legislations).
  • user (the parameters defined at the level of a user are copied to one or several users).
  • field WA

 

  • Details (field DETAIL)

When this box is checked, the detail of the copied parameters along with their value can be obtained in the list. If it is not checked, only the list of the destination codes is displayed.

  • Simulation (field SIMU)

If this box is checked, the parameters copy is not carried out, and the log file provides the detail of the copies that would be performed if the operation were launched in a non-simulated mode (with or without the detail of the parameter values).

  • Deletion (field SUPP)

When this box is checked, a preliminary deletion of the parameters at the destination level is carried out before the copy. For instance, if parameters belonging to user A (some of whose parameters are inherited from the site) are copied to user B (some of whose parameters are defined at the level of the user themselves), then:

  • if the box is checked, after the copy, these parameters will be for user B inherited from the site they are dependent on (and not from the site user A is dependent on) : the local values that were not copied are lost.
  • if the box is not checked, user B keeps the local values of their parameters if the latter are not locally defined by user A.
  • Source (field ORI)

It specifies the origin (company, site, legislation, user, depending on the case) of the parameter values to be copied.

  • field ORILIB

Title associated to the previous code.

Destination

  • Type (field TYP)

It defines how to enter the destination codes (company, site, legislation, user), according to the following possibilities:

  • in the form of a start/end range code.
  • in the form of a template code.
  • in the form of a list code.
  • Destination (field DEST11)

When the parameter copy is performed to a destination defined by ranges, these two fields are used to specify the start and end codes concerned.

Depending on the case, company code ranges, site code ranges, legislation code ranges or user code ranges are entered here.

  • Until (field DEST12)

 

  • Destination (field DEST21)

When the parameter copy is made to a destination defined by a template, the template concerned is entered here.

According to the case, a company, site, legislation or user code template is entered here.

Grid List

  • field NBLIG

 

  • Code (field DEST31)

When the parameter copy is made to a destination defined by a code list, the codes concerned are entered here.

According to the case, company codes, site codes, legislation codes or user codes are entered here.

  • Description (field DESTLIB)

Title associated to the previous code.

Close

 

Messages in the log file

The log file provides information in the following form :

[Level] Origin : [NAME]

[NN] Copied parameters

Parameter [NAME]: [VALUE] ( [Title] )

[Level] Destination: [NAME]

[NN] Copied parameters

Parameter [NAME]: [VALUE] ( [Title] )

where :

  • [Level] corresponds to the company, site, legislation or user
  • [NN] provides the number of parameters involved (copied, following the line of origin, deleted, on the destination level, remembering that this line is not present if no parameter value has been deleted).
  • The detail lines with each parameter and its value are only present if the Detail box is checked.

Remarks

If parameter values existed for a given destination code, and do not exist in the start code, these values are deleted. For instance, if the CALNBRDEC parameter is set to the default value 2 for the folder, and is not defined at user level for the only user JOHN :

  • a copy of the parameters for the user JOHN to the user JIM is going to copy this parameter value.
  • Inversely, a copy of the parameters of the user JIM to the user JOHN is going to delete this parameter value for the user JOHN (since it is considered that the user has no value as such, but they must inherit the value of the upper levels).

This rule also applies when performing copies between folders. In this way, the copy of the parameters associated with JOHN in folder 1 to the user JIM in folder 2 is only going to recopy those parameters specific to JOHN (if parameters were inherited from the site, the company or the folder, they will be inherited from the site, the company or the folder, in other words, the inherited values may not be identical). If need be, it is then possible to copy the parameters of JOHN's site to JIM's site, those of JOHN's company to JIM's company etc.

Batch task

This function can be run in batch mode. The standard task ACOPADO is provided for that purpose.

Error messages

The only error messages are the generic ones.

Tables used

SEEREFERTTO Refer to documentation Implementation