Pages: « 1 2 3 4 5 6 7 8 9 10 »
 on: June 13, 2019, 01:50:54 PM 
Started by JS_Nbg_DE - Last post by Derek Read
Yes, it is the same Programmers Guide for XMetaL Author Enterprise, XMetaL Author Essential, and XMAX. APIs specific to XMAX are identified as such.

 on: June 13, 2019, 11:17:52 AM 
Started by JS_Nbg_DE - Last post by JS_Nbg_DE
Hello *,

exists an API-Description or a programmers guide for xmax?
We use xmax 9.0.


 on: June 03, 2019, 09:01:12 AM 
Started by mikestratton99 - Last post by mikestratton99
Thank you so much for your speedy reply! Super-helpful! I am noodling on where to save the .oft (Outlook template) file.

 on: May 31, 2019, 05:17:36 PM 
Started by mikestratton99 - Last post by Derek Read
DITA supports linking to any file type.

However, what happens when the user clicks on a link to that file will depend on what format you are transforming to, what the DITA Open Toolkit creates for that link in that particular output, which application the person viewing/reading that particular output is using, and how that application (maybe a browser, but possibly also the OS, antivirus, etc) deals with the link when that person clicks on it, and whether the user has the right software installed to open and use an OFT file (ie: they have MS Outlook installed or some other software capable of using that file). Best case scenario is that it might be automatically associated with the right software like Outlook and opened. Worst case scenario is that nothing happens or the application tells the user it doesn't know what to do with an OFT file. Medium case scenario is that the application tells the user it doesn't know what to do and simply offers to save the file, or perhaps locate some software that can open it.

Lots of variables there, but perhaps some of them are within your control.

First thing I'd try is this:

1. Figure out where you are going to save the OFT file. This will either need to be a permanent location or travel with the other file you are outputting from this particular DITA task (ie: full path, or URL, or relative path).

2. Create a link from the task to the OFT file: Insert > Link > File Reference, browse to and select the OFT file. Or if the file will live on a web server then use: Insert > Link > Web Link.

3. Generate output for the task (using whatever output format you need it to be in) and see if it does what you need under whichever test conditions the person reading your output content will be using.

The following works under these specific conditions for me on Windows:

1. The <xref> @href value links to the *.oft file (ie: C:\temp\template.oft) or relative path (ie: template.oft) and @scope is set to either "peer" or "external". (see note 1)

2. Generate output in HTML form using the default DITA OT. Most people are generating some form of HTML (CHM, HTML, Java Help, etc, so this is my assumption).

3. Open the resulting HTML file in a browser.

4. In the HTML (in the browser) click on the link to the OFT file. Some versions of IE will just try to open the file, some will trigger a security warning, some will prompt you to save and / or scan for viruses then might offer to open the file. Other browsers should do similar things.

5. If whatever happens in #4 triggers the file to be opened then it might open. I have MS Outlook installed and it is associated with these files so opens the OFT file.

Note 1: The DITA specs are a bit vague on which @scope value is correct for this particular case, but the DITA OT generates a link (at least in HTML) that browsers seem to deal with in a somewhat expected way in both cases. That expected way (for me) is that because the browser itself can't open the file it either offers to save it somewhere on my system, or it saves a temp copy and offers to open it in an application or my choosing, or it saves a temp copy and then automatically opens it in MS Outlook (if I have it installed).

If all that works then you might be done -- assuming all the people reading that topic in its output form have a similar setup.

If it doesn't work then you might need to adjust attributes for the <xref> (perhaps a relative link is needed if you are shipping the OFT file together with the output topic, or perhaps if you are storing the OFT file on a web server you really should be using a URL instead). The main two for <xref> are @href and @scope (see the DITA specs for details) which you can also adjust using the Attribute Inspector (F6). Depending on the output you are generating you may also need to adjust how the DITA OT generates that output (CHM, PDF, HTML, Java Help, etc) or whichever other process you are using to generate output if it is using something other than the DITA OT, a modified copy of the DITA OT, or something else.

If things beyond how output is generated need to be modified, or controlled, I don't know that there is much else you can do unless this is part of some internal system and you can force people reading the file to follow some procedure and configure their computers a specific way. ie: If the person reading your output doesn't have or refuses to install MS Outlook what do you want them to do instead?

 on: May 31, 2019, 03:15:26 PM 
Started by mikestratton99 - Last post by mikestratton99
Product: XMetaL Author Enterprise 11.0
Installer#: 11.0.0214

OS: Windows 10 Enterprise
Version: 1709
OS Build: 16299.1146

SITUATION: I was given a document in MS Word format and asked to convert it into a task topic in XMetaL. The Word doc details the procedure for how a user can report a software issue to tech support, and it contains a clickable link that opens a MS Outlook email template. (The email template is a blank trouble report that consists of a series of questions for the user to answer to describe their software issue before sending it to tech support.)

Screen shot from Word doc attached.

QUESTION: How can I create a link in my XMetaL task topic that links to/opens this same Outlook blank email template?

 on: May 29, 2019, 04:27:03 PM 
Started by jodekirk - Last post by Derek Read
In theory yes...if you can find and install a JavaScript engine that meets those needs.

Windows includes JScript and VBScript with the Windows Script Host but you can install other script engines. Such an engine would probably need to identify itself using a name other than "JScript" to avoid conflicts with the Windows Script Host version of JScript. The script engine's name is what you insert in a macro inside the MCR file used by XMetaL Author to let it know which script engine to tell Windows Script Host to use to run the script for that particular macro.

Whether such an engine exists for Windows I don't know. It needs to meet these requirements:

This would be similar to people that install and use the PerlScript (ActivePerl) or PythonScript (ActivePython) engines with XMetaL Author. Most people are using JScript or VBScript as they do not require additional software to be installed, but there are a number of XMetaL Author users that do use these other engines.

 on: May 29, 2019, 04:03:49 PM 
Started by megl - Last post by Derek Read
It sounds like this is limited to one user, so identifying what is different about this particular computer's setup would be the first step. Compare any files installed that modify or extend the XMetaL Author installation: "application customization" files (this would include CMS integration modifications or other changes to the software, primarily limited to scripting modifications or other code that is calling XMetaL APIs) as well as "document customization" files (the DTD/XSD plus any other files loaded when a particular XML file is loaded, which can include script inside MCR, CTM and possibly other files). The people that created these customizations should be able to do this.

If this is affecting multiple users then debugging can be done by the people that created any custom scripts or other code you are running then the code to examine in particular would be anything inside events corresponding to mouse clicks (On_Click, On_Double_Click), the "Selection" object in general (or the mostly equivalent "Range" object), events that fire frequently (On_Update_UI), or similar.

If that isn't possible for whatever reason please feel free to submit any customizations plus a sample XML document to XMetaL Support so they can try to reproduce the issue. If the issue is limited to one person then the most likely cause is a broken file. If the issue is affecting everyone, but has not in the past, then it is most likely that changes to the customization have been made that are buggy that were not properly tested, or that an API is being used incorrectly, or if used correctly then perhaps in an unexpected way that was unforeseen.

The more information that can be provided to XMetaL Support the better as they will likely need to reproduce your setup as closely as possible to trigger the issue.

 on: May 29, 2019, 08:06:25 AM 
Started by jodekirk - Last post by jodekirk
Is there any way to use modern JavaScript with XMetaL Developer for macros? I would like to use the new ES2015 or newer JavaScript syntax and features. Currently I have been using lots of polyfills.

I would like to use the new features such as:

I keep forgetting old JScript syntax now that I've been using modern JavaScript in other web development projects for over 4 years.

Jeremy Odekirk

 on: May 29, 2019, 07:27:54 AM 
Started by megl - Last post by megl
I have a user on Windows 10 Pro using XMetaL 12 Enterprise who is having crashing issues. Whenever text is highlighted, even just a few words, XMetaL crashes.

Any insight to a workaround or settings adjustment to resolve this would be helpful.


 on: May 22, 2019, 08:34:53 AM 
Started by dmurphy - Last post by dmurphy
Hi Derek - Sorry, I should have mentioned that in the beginning. We are using an SDL CMS. We use SuiteHelp 4 output type, which does not support DITA 1.3. I guess SuiteHelp 5 does support it.

Pages: « 1 2 3 4 5 6 7 8 9 10 »