Configuring PutDocDiffing

You configure PutDocDiffing in Tool Preferences.

Procedure

  1. To open AppData in Contenta Explorer, click Tools > Options > Tool Preferences.
  2. Open Global to configure PutDocDiffing for all users, or open a user desktop to configure PutDocDiffing for an individual user.
  3. Under the desktop, click Settings.
  4. Click Insert Key and add the key; Editors if it does not exist.
  5. Click the Editors key, and then then click Insert Value.
  6. Add PutDocDiffing (note that the key is case sensitive) in the Value Name field.
  7. Add the desired behavior by setting the Value Data according to the descriptions in the table below.
    Value DataDescription/Behavior
    0

    (Or if not set in the environment)

    There is no added checking for changes to the object-mapped elements (OMEs).

    1

    The adapter always saves changes silently back to Contenta.

    The check out directory is deleted.

    No log file is generated.

    This value ignores the order of the attributes.

    2The adapter always saves changes silently back to Contenta.

    Instances of changed object-mapped elements (OMEs) whose modified flags were set to “no” are written to the PutDocDiffing log file in the check out directory.

    The entity files are overwritten with new data and, in the case of files with undetected changes, the original entity file is moved to entity-name.orig.

    If there aren’t any other errors, the EpicEditCat.pl, EpicEditCheckinCat.pl, FrameEditCat.pl, FrameCheckinCat.pl, XmetalCheckinCat.pl scripts and XyeXMEditCat.exe test for the existence of the PutDocDiffing log file.

    If the log exists, a warning message is presented to the user explaining that the changed files were checked back into Contenta, the check out directory was not deleted and a log file exists in the check out directory documenting the files whose modified flag was set incorrectly.

    This value ignores the order of the attributes.

    3Instances of changed object-mapped elements (OMEs) whose modified flags were set to no are written as entity-name.new to the PutDocDiffing log file located in the check out directory.

    No data is checked in and an error is generated by the adapter after the bust activity completes.

    The error message explains that the object-mapped element (OME) changes were not checked back into Contenta, the check out directory was not deleted, and identifies the location of the PutDocDiffing log file.

    The log file documents the problems encountered and the steps required to import the changed files back into Contenta. The user is then be able to investigate the problem and determine the appropriate action required. This usually involves changing the AppData setting to 1 or 2 and re-running check in.

    This value gives the user the most control but requires manual intervention.

    This value ignores the order of the attributes.

    11

    Behavior is the same as value 1 except that the order of the attributes is not ignored.

    12

    Behavior is the same as value 2 except that the order of the attributes is not ignored.

    13

    Behavior is the same as value 3 except that the order of the attributes is not ignored.