Skip to main content
Skip table of contents

f$PGCopy (f$PGKopie)


f$PGCopy (f$PGKopie)

Copy all parameters in a parameter group to another. The parameter groups can, but do not have to, be based on one parameter group definition. Parameter content with the same name is copied. All other parameters are ignored.

Please note: the name of the parameter group is usually given in string constants, i.e. in quotation marks. If a string parameter is entered - such as in the syntax description - the value of the entered parameter is treated as the parameter group name (as long as it is a string)

Syntax:

f$PGCopy( SourcePG, DestPG[,Copyoption,Number,Parametername] )

 

Argument

Type

Meaning

 

SourcePG

String

Name of the parameter group to be copied

 

DestPG

String

Name of the parameter group to be copied to

 

Copyoption

Integer

This argument is optional. It manages what happens with parameters without content when copying the parameter group:

0 : all parameters are copied

1 : parameters are copied when they have content or are NOVAL

2 : parameters are copied when they have content

 

Count

Integer

This argument is optional. With this argument you can manage the number of indices to be copied in 1-dimension parameter groups.

If 0 is entered as the value, all indices in the parameter group are copied, or all indices from 1 until the entered parameter does not have content.

If the value != 0 is entered, the indices from 1 to Number of the parameter group are copied.

If the argument is not entered, only one index is copied.

 

Parametername

String

This argument is optional. With this argument you can manage the end of the copy process. If the value of the entered parameter in the source parameter group has no content, the copy process is terminated. If this argument is entered, it must be a valid parameter of the source parameter group.

Result:

-

 

Example:

f$PGCopy( 'Motor', 'Part' )
→ The parameter group "Motor" is copied to "Part".
f$PGCopy( 'Motor', 'Part',2 )
→ The parameter group "Motor" is copied to "Part". Only parameters with content are used.
f$PGCopy( 'Motors', 'Parts',0,0 )
→ All members of the indexed parameter group "Motors" are copied to the similarly indexed parameter group Parts

f$PGCopy( 'Motors[i]', 'Parts[i]' )
→ The member i in the indexed parameter group "Motors" is copied to the member i in the similarly indexed parameter group "Parts".
f$PGCopy( 'Motors', 'Parts',0,0,'MaterialNo' )
→ All members of the indexed parameter group "Motors" are copied to the similarly indexed parameter group "Parts" until the MaterialNo parameter in the parameter group "Motors" is NOVAL or UNDEF.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.