Show TOC

CREATE_VARIANT_WITH_FILES/URL/TABLE/AS_TABLELocate this document in the navigation structure

Use

There are four methods available for creating language and format variants:

  • CREATE_VARIANT_WITH_FILES

  • CREATE_VARIANT_WITH_TABLE

  • CREATE_VARIANT_WITH_AS_TABLE

  • CREATE_VARIANT_WITH_URL

The difference between the four methods - as with CREATE_WITH_FILES, CREATE_WITH_TABLE, CREATE_WITH_AS_TABLE, and CREATE_WITH_URL- is the source from which the data is retrieved. The source can be either a file name, a table or a URL.

The application object (document set) is identified by the attributes described in the section Parameters. The variant is also identified by attributes described in the section 'Parameters'.

The new variant is identified by the following parameters:

  • NEW_DOC_VAR_ID

    New variant ID

  • NEW_DOC_VAR_TG

    New variant tag

    The variant tag can take the following forms:

    • Original

    • Language variant

    • Format variant

    One of these forms must be transferred when the method is called. The new variant ID is returned.

The parameter PROPERTIES is used in place of the parameter SIGNATURE (see section Properties Table).

The method CREATE_VARIANT_WITH_FILES is identified by the additional parameter FILES (see section File Tables).

The method CREATE_VARIANT_WITH_TABLE is identified by the additional parameters (see sections Component Table and Content Table).

  • COMPONENTS

  • CONTENT

The method CREATE_VARIANT_WITH_AS_TABLE is identified by the additional parameters (see sections Component Table and Content Table).

  • COMPONENTS

  • ASCII_CONTENT

The method CREATE_VARIANT_WITH_URL is identified by the additional parameters (see sections Component Table and URL Table).

  • COMPONENTS

  • URIS

Note

CREATE_VARIANT_WITH_URL must always be called in conjunction with CONFIRM_CREATE so that a document can be identified as stored succcessfully.

For this method only one target URL is transferred. CONFIRM_CREATE passes on the information that the document was created successfully.