Importing formats from another file

You import formats from an open document (a Doc object), so you have to open the File object that you return from the dialog box. Here is a set of functions that you can plug into any script to get a Doc object from a file name. It first tests if the document is already open; if it is it returns it, if not, it calls another function to open it.

function getDocument (filename, structApp, visible) {
    
    // See if the document is already open.
    var doc = docIsOpen (filename);
    if (doc) {
        return doc;
    } else {
        // The document is not already open, so open it.
        return openDocOrBook (filename, structApp, false);
    }
}
function docIsOpen (filename) {
    
    // Make a File object from the file name.
    var file = File (filename);
    // Uppercase the filename for easy comparison.
    var name = file.fullName.toUpperCase ();
    // Loop through the open documents in the session.
    var doc = app.FirstOpenDoc;
    while (doc.ObjectValid () === 1) {
        // Compare the document’s name with the one we are looking for.
        if (File (doc.Name).fullName.toUpperCase () === name) {
            // The document we are looking for is open.
            doc.openedByScript = false;
            return doc;
        }
        doc = doc.NextOpenDocInSession;
    }
}
function openDocOrBook (filename, structApp, visible) {
    
    var i = 0, docOrBook = 0;
    // Get default property list for opening documents.
    var openProps = GetOpenDefaultParams ();
    // Get a property list to return any error messages.
    var retParm = new PropVals ();
    // Set specific open property values to open the document.
    i=GetPropIndex (openProps,Constants.FS_AlertUserAboutFailure);
    openProps.propVal.ival=false;
    i=GetPropIndex (openProps,Constants.FS_MakeVisible);
    openProps.propVal.ival=visible;
    i=GetPropIndex (openProps,Constants.FS_FileIsOldVersion);
    openProps.propVal.ival=Constants.FV_DoOK;
    i=GetPropIndex (openProps,Constants.FS_FileIsInUse);
    openProps.propVal.ival=Constants.FV_ResetLockAndContinue;
    i=GetPropIndex (openProps,Constants.FS_FontChangedMetric);
    openProps.propVal.ival=Constants.FV_DoOK;
    i=GetPropIndex (openProps,Constants.FS_FontNotFoundInCatalog);
    openProps.propVal.ival=Constants.FV_DoOK;
    i=GetPropIndex (openProps,Constants.FS_FontNotFoundInDoc);
    openProps.propVal.ival=Constants.FV_DoOK;
    i=GetPropIndex (openProps,Constants.FS_RefFileNotFound);
    openProps.propVal.ival=Constants.FV_AllowAllRefFilesUnFindable;
    if (structApp !== undefined) {
        i=GetPropIndex (openProps,Constants.FS_StructuredOpenApplication);
        openProps.propVal.sval=structuredApplication;
    }
    // Attempt to open the document.
    docOrBook = Open (filename,openProps,retParm);
    if (docOrBook.ObjectValid () === 1) {
        // Add a property to the document or book, indicating that the script opened it.
        docOrBook.openedByScript = true;
    }
    else {
        // If the document can't be open, print the errors to the Console.
        PrintOpenStatus (retParm);
    }
    return docOrBook; // Return the document  or book object.
}

The getDocument function is the one you call. It has three arguments:

1) filename is the absolute path to the FrameMaker file. If you have a File object, you must use the fsname property of the File object to get the platform-specific full path to the file.

2) structApp is the structured application required to open the document if it is structured. For an unstructured file, just use undefined.

3) visible is true if you want the document to be opened visibly, false if you want it to open invisibly.

The returned Doc object will have a new property on it called openedByScript. This is set to true if the function opened the document and false if it was already opened. You can use this property to decide whether or not to close the document when you are done with it.

-Rick