Documentation Center

Setting up applicability manually

When SDL Contenta S1000D is used as a publishing platform, the product automatically sets up the necessary applicability files. Otherwise, you must set up applicability manually.

Procedure

  1. If you are using a PCT, ensure that all the product elements have a unique id attribute. To check this, open a dropdown list in the LiveContent S1000D applicability dialog interface. If it shows only "...", then your product elements have no id attributes.
  2. Add the applicability data modules you intend to use (ACT, PCT, CCT) to the same folder as the rest of your source XML data.
  3. To ensure that XML files that do not appear on the table of contents are still loaded into the XML database, add all applicability files to an S1000D 3.0 or S1000D 4.0 DML. To do this, use one of the DML files delivered with the appropriate S1000D bike data set, shipped with LiveContent S1000D, as a starting point for your own DML. The publishing process reads the valid <dmentry> elements and includes each data module reference within in the XML database.
  4. Register your DML with the publication by adding a configitem to your LiveContent S1000D publication configuration file that calls out the S1000D DML:
    <configitem name="DmList">
      <value>YOURDMLFILE.xml</value>
    </configitem>

    where YOURDMLFILE.xml is the name of your DML file.

    For an example of a LiveContent S1000D Publishing configuration file, refer to bike.xml in the templates/conf/ subdirectory of the LiveContent S1000D home directory.

  5. Run LiveContent S1000D publish by entering the following command:
    LiveContentPublish.exe -build PATH/TO/YOURDMLFILE.xml

    where PATH/TO/YOURDMLFILE.xml is the full path and filename of your DML file.

  6. Navigate to the templates/FullSupport/httpdocs/book_data/ subdirectory of the LiveContent S1000D home directory.
  7. Copy the file applic_template.xsl in this location to the templates/FullSupport/httpdocs/book_data/COLLECTION/PUBLICATION/ subdirectory of the LiveContent S1000D home directory, where COLLECTION refers to your collection and PUBLICATION refers to your publication.
  8. In this target directory, rename applic_template.xsl to applicability.xsl.
  9. Create an XML file named applicability.xml in the same location with the following contents:
    <?xml version="1.0"?>
    <?xml-stylesheet type="text/xsl" href="applicability.xsl"?>
    <dmodule>
      <act>ACTCODE</act>
      <cct>CCTCODE</cct>
      <pct>PCTCODE</pct>
    </dmodule>

    where ACTCODE, CCTCODE and PCTCODE are the data module codes for the ACT, CCT and PCT, respectively, if they are available (if you are not using a subset of these files, omit the element that references the data module).

    The data module codes in this file must comply with the following:
    • They must not include DMC-.
    • They must have an additional (non-standard compliant) dash inserted between the discode and discodev.
    • They must have an additional (non-standard compliant) dash inserted between the infocode and infocodev.

    For example, for ACTCODE you would write S1000DBIKE-AAA-D00-00-00-00-AA-00W-A-D rather than DMC-S1000DBIKE-AAA-D00-00-00-00AA-00WA-D.

  10. Save the applicability.xml file to the following subdirectory of the LiveContent S1000D home directory.

    templates/FullSupport/httpdocs/book_data/COLLECTION/PUBLICATION/

    where COLLECTION refers to your collection and PUBLICATION refers to your publication.

  11. Run the CollectionPub tool against the IETM to generate a CD image by entering one of the following commands from the LiveContent S1000D home directory:
    • Windows: CollectionPub LIVECONTENTDATA\collections\COLLECTION LIVECONTENTDATA\cdimages\COLLECTION, where LIVECONTENTDATA is the absolute path to the LiveContent S1000D data directory.
    • Linux: CollectionPub ../LiveContentData/collections/COLLECTION ../LiveContentData/cdimages/COLLECTION

    In both commands, COLLECTION is the name of your collection.

    The tool pulls in the book_data folder to which you added files, as well as the modified XML database that contains the additional data.
  12. Launch the publication.
    An applicability interface should open showing a product-centric interface or a condition-centric interface, depending on your particular mix of ACT, CCT and PCT files.