How to Configure the Proposed Profiling Attribute Values

[dreifsnider]

Hi,

We recently upgraded to Web Author v26 and we noticed that it includes a new dialog to easily add and modify profile attributes and their values. This is awesome!

Unfortunately, the values that are listed in the dialog do not apply to our documentation so we would like to change the displayed values:

image.png (96.57 KiB) Viewed 269 times

The What's New topic in the User Guide says:

You can configure the proposed attribute values using a subject scheme map referenced in the DITA map, or by exporting them from the Attributes and Condition Sets preferences page in the Oxygen desktop version (these exported values can then be used as imposed options in the Web Author server).

Our DITA Maps do not use subject scheme maps, so we would need to export the condition sets from Oxygen desktop, and then impose them as options in Web Author. However, our condition sets and attribute values are built from imported DITAVAL files, and I do not see an option to export either these values or condition sets:

image.png (145.27 KiB) Viewed 269 times

How can we export our current condition sets and then use them as imposed options in Web Author?

[cosminef]

Hello,

For your use case, you can use the option "Import from DITAVAL..." that can be seen in the second screenshot.
After you import your *.ditaval file, export global options from Oxygen Author:

• Go to Options

• Click on Export global options

• Name the fil and save it.

Open the saved file and search for this entry:

Code: Select all

<entry>
<String>profiling.conditions.list</String>
line of conde....
</entry>

After you identify this entry, copy its entire structure and paste it into the file named options.xml in Web Author. [1]
Now, you must restart Web Author [2] and after this, you can see your profiling attributes based on the *.ditaval file.
To apply profiling condition sets in Web Aiuthor, you can use

Code: Select all

dita.val.url

URL parameter. [3]

Regarding this matter, we would like to inform you that we are about to release a new version of Web Author, which will include Profiling condition sets features directly from the user interface, by choosing the ditaval file you want.

[1] https://www.oxygenxml.com/doc/versions/ ... a-dir.html
[2] https://www.oxygenxml.com/doc/versions/ ... start.html
[3] https://www.oxygenxml.com/doc/versions/ ... aunch.html

[dreifsnider]

Hi Cosmin,

Thank you for your reply! I was able to copy the profiling.conditions.list from our project .xpr file and paste it into Web Author's options.xml file. It now works as expected. I was also able to use a Content Completion config file (cc_config.xml) to control the values that are suggested in for the corresponding profiling attribute, so this is great for us as well.

Regarding this matter, we would like to inform you that we are about to release a new version of Web Author, which will include Profiling condition sets features directly from the user interface, by choosing the ditaval file you want.

This sounds very intriguing and I'm looking forward to seeing the actual capabilities that this introduces! Is there any more information you can share regarding this feature?

I ask because we're developing a new toolbar button that can be used to toggle a custom pseudo-class that will be used to hide/grey out elements according to their profiling attribute value. Cristian's reply in this post provided the inspiration for this idea: post42512.html#p42512.

Will this new feature in Web Author provide any of this capability or should we still proceed with developing this new toolbar button?

Thank you again!

Daniel

[cosminef]

Hello,

We have just released version 26.1 of the Oxygen XML Web Author product.
For more information and what this release brings, you can navigate to the What's New section. [1]

[1] https://www.oxygenxml.com/xml_web_author/whats_new.html

Best,
Cosmin

[dreifsnider]

Thanks Cosmin!

We're very excited for these new options, specifically the DITA-OT project file support and filtering options.

Is it possible to restrict the project or DITAVAL files that can be selected? For what it's worth, we do have profiling.conditions.set.list defined in our Oxygen project file (.xpr), that specifies the DITAVALs that can be used in our project. Is it possible to leverage this list in Web Author?

Code: Select all

<entry>
    <String>profiling.conditions.set.list</String>
    <profileConditionsSetInfo-array>
        <profileConditionsSetInfo>
            <field name="conditions">
                <serializableOrderedMap/>
            </field>
            <field name="documentTypePattern">
                <String>*DITA*</String>
            </field>
            <field name="conditionSetName">
                <String>default</String>
            </field>
            <field name="ditavalFile">
                <String>${pd}/_config/sdkdoc-frameworks/desktop/ditavals/default.ditaval</String>
            </field>
            <field name="useDITAVAL">
                <Boolean>true</Boolean>
            </field>
            <field name="shortcut">
                <null/>
            </field>
        </profileConditionsSetInfo>
        <profileConditionsSetInfo>
            <field name="conditions">
                <serializableOrderedMap/>
            </field>
            <field name="documentTypePattern">
                <String>*DITA*</String>
            </field>
            <field name="conditionSetName">
                <String>Platform A</String>
            </field>
            <field name="ditavalFile">
                <String>${pd}/_config/sdkdoc-frameworks/desktop/ditavals/platform-a.ditaval</String>
            </field>
            <field name="useDITAVAL">
                <Boolean>true</Boolean>
            </field>
            <field name="shortcut">
                <null/>
            </field>
        </profileConditionsSetInfo>
        <profileConditionsSetInfo>
            <field name="conditions">
                <serializableOrderedMap/>
            </field>
            <field name="documentTypePattern">
                <String>*DITA*</String>
            </field>
            <field name="conditionSetName">
                <String>Platform B</String>
            </field>
            <field name="ditavalFile">
                <String>${pd}/_config/sdkdoc-frameworks/desktop/ditavals/platform-b.ditaval</String>
            </field>
            <field name="useDITAVAL">
                <Boolean>true</Boolean>
            </field>
            <field name="shortcut">
                <null/>
            </field>
        </profileConditionsSetInfo>
    </profileConditionsSetInfo-array>
</entry>

Thanks again!

Daniel

[cosminef]

Hello,

Is it possible to restrict the project or DITAVAL files that can be selected?

To apply profiling condition sets in Web Aiuthor, you can use

Code: Select all

dita.val.url

URL parameter. [1]
In the link provided, search for "dita.val.url"

[1] https://www.oxygenxml.com/doc/versions/ ... aunch.html

Is it possible to leverage this list in Web Author?

This entry

Code: Select all

<String>profiling.conditions.set.list</String>

has no effect if you copy its entire structure into options.xml in Web Author.

Best,
Cosmin