Publish

Use Publish to publish content to IBM® Cognos® Connection or to a TM1® server.

Syntax

The arguments mirror the entry boxes in the dialog box that is used in the user interface.

Publish does not appear in the macro list in the Microsoft application because the macro receives an argument. Any macro with parameters is by definition private and private macros are not shown in the macro options by default.

Publish (URL, document path, server path, name, description, screenTip)

Parameters

Table 1. Parameters for the Publish macro

Argument

Description

Data type
URL

The server to which you are publishing.

String
document path

The location of the document to be published. It is the local path of the file that you want to publish. If the path of your folder is not correct when you publish using automation, you are again prompted to log on. This is because IBM Cognos does not distinguish between non-existing folders and folders for which the user does not have permissions. This security feature helps to prevent the discovery of the folder path by trial and error.

In IBM Cognos Analytics, the folder path is a search path. For more information, see the IBM Cognos Analytics Administration Guide.

String
server path

The path in the content store where the document is saved.

String
name

The document name that will appear in IBM Cognos.

String
description

The document description that will appear in IBM Cognos.

String
screenTip

The text that users see when they point to the document in IBM Cognos.

String

Example

Following is an example of this syntax:

Publish("CAMID('::Anonymous')/folder[@name='My
Folders']","Description of 'My Folders'", "")