Article

This section discusses:

IScript_GetArticleTitle
IScript_GetArticleTitleImage
IScript_GetArticleSubTitle
IScript_GetArticleBody
IScript_GetArticleImage
IScript_GetArticleAuthor
IScript_ArticleTemplate

Syntax

IScript_GetArticleTitle()

Description

IScript_GetArticleTitle retrieves the article title for an article in an issue of a publication. It accepts inputs from the query string for the publication ID, issue ID, and article ID.

The declaration is:

Declare Function IScript_GetArticleTitle PeopleCode 
WEBLIB_WEBPUB.EO_PE_ARTICLE FieldFormula;

Parameters

Function Call Parameters: None.

This table lists the Query String Parameters:

Parameter

Description

PUB

The publication ID is set in the query string by PUB=Publication ID.

The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable &Publication.

ISSUE

The issue ID is set in the query string by ISSUE=Issue ID.

The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable &Issue.

ARTICLE

The article ID is set in the query string by ARTICLE=Article ID.

The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable &Article.

Returns

Returns the article title.

Syntax

IScript_GetArticleTitleImage()

Description

IScriptGetArticleTitleImage retrieves the article title image for an article in an issue of a publication. It retrieves inputs from the query string for the publication ID, issue ID, and article ID. IScript_GetArticleTitleImage first retrieves the article title image ID. Using this ID, it calls the IScript_GetImage function to retrieve the image information.

The declaration is:

Declare Function IScript_GetArticleTitleImage PeopleCode WEBLIB_WEBPUB.EO_PE_
ARTICLE FieldFormula;

Parameters

Function Call Parameters: None.

This table lists the Query String Parameters:

Parameter	Description
PUB	The publication ID is set in the query string by `PUB=Publication ID.` The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable `&Publication.`
SECTION	The section ID is set in the query string by `SECTION=Section ID.` The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable `&Section.`
CATEGORY	The category ID is set in the query string by `CATEGORY=Category ID.` The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable `&Category.`
ISSUE	The Issue ID is set in the query string by `ISSUE=Issue ID.` The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable `&Issue`.
ARTICLE	The article ID is set in the query string by `ARTICLE=Article ID.` The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable `&Article`.

Returns

Returns the HTML image tag for the article title image.

Syntax

IScript_GetArticleSubTitle()

Description

IScript_GetArticleSubTitle retrieves the article subtitle for an article in an issue of a publication. It accepts inputs from the query string for the publication ID, issue ID, and article ID.

The declaration is:

Declare Function IScript_GetArticleSubTitle PeopleCode WEBLIB_WEBPUB.EO_PE_ART
ICLE FieldFormula;

Parameters

Function Call Parameters: None.

This table lists the Query String Parameters:

Parameter	Description
PUB	The publication ID is set in the query string by `PUB=Publication ID.` The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable `&Publication`.
ISSUE	The Issue ID is set in the query string by `ISSUE=Issue ID.` The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable `&Issue`.
ARTICLE	The article ID is set in the query string by `ARTICLE=Article ID.` The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable `&Article`.

Parameter

Description

PUB

The publication ID is set in the query string by PUB=Publication ID.

The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable &Publication.

ISSUE

The Issue ID is set in the query string by ISSUE=Issue ID.

The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable &Issue.

ARTICLE

The article ID is set in the query string by ARTICLE=Article ID.

The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable &Article.

Returns

Returns the article subtitle.

Syntax

IScript_GetArticleBody()

Description

IScript_GetArticleBody retrieves the article body text for an article in an issue of a publication. It accepts inputs from the query string for the publication ID, issue ID, and article ID.

The declaration is:

Declare Function IScript_GetArticleBody PeopleCode WEBLIB_WEBPUB.EO_PE_ARTICLE
 FieldFormula;

Parameters

Function Call Parameters: None.

This table lists the Query String Parameters:

Parameter	Description
PUB	The publication ID is set in the query string by `PUB=Publication ID.` The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable `&Publication`.
ISSUE	The Issue ID is set in the query string by `ISSUE=Issue ID.` The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable `&Issue`.
ARTICLE	The article ID is set in the query string by `ARTICLE=Article ID.` The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable `&Article`.

Parameter

Description

PUB

The publication ID is set in the query string by PUB=Publication ID.

The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable &Publication.

ISSUE

The Issue ID is set in the query string by ISSUE=Issue ID.

The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable &Issue.

ARTICLE

The article ID is set in the query string by ARTICLE=Article ID.

The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable &Article.

Returns

Returns the article body text.

Syntax

IScript_GetArticleImage()

Description

IScript_GetArticleImage retrieves the article image for an article in an issue of a publication. It accepts inputs from the query string for the publication ID, issue ID, and article ID. IScript_GetArticleImage retrieves the article image ID. Using this ID, it calls the IScript_GetImage function to retrieve the image information.

The declaration is:

Declare Function IScript_GetArticleImage PeopleCode WEBLIB_WEBPUB.EO_PE_ARTICLE
 FieldFormula;

Parameters

Function Call Parameters: None.

This table lists the Query String Parameters:

Parameter	Description
PUB	The publication ID is set in the query string by `PUB=Publication ID.` The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable `&Publication`.
ISSUE	The Issue ID is set in the query string by `ISSUE=Issue ID.` The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable `&Issue`.
ARTICLE	The article ID is set in the query string by `ARTICLE=Article ID.` The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable `&Article`.

Parameter

Description

PUB

The publication ID is set in the query string by PUB=Publication ID.

The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable &Publication.

ISSUE

The Issue ID is set in the query string by ISSUE=Issue ID.

The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable &Issue.

ARTICLE

The article ID is set in the query string by ARTICLE=Article ID.

The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable &Article.

Returns

Returns the HTML image tag for the article image.

Syntax

IScript_GetArticleAuthor()

Description

IScript_GetArticleAuthor retrieves the article author for an article in an issue of a publication. It accepts inputs from the query string for the publication ID, issue ID, and article ID.

The declaration is:

Declare Function IScript_GetArticleAuthor PeopleCode WEBLIB_WEBPUB.EO_PE_ARTILE
 FieldFormula;

Parameters

Function Call Parameters: None.

This table lists the Query String Parameters:

Parameter	Description
PUB	The publication ID is set in the query string by `PUB=Publication ID.` The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable `&Publication`.
ISSUE	The Issue ID is set in the query string by `ISSUE=Issue ID.` The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable `&Issue`.
ARTICLE	The article ID is set in the query string by `ARTICLE=Article ID.` The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable `&Article`.

Parameter

Description

PUB

The publication ID is set in the query string by PUB=Publication ID.

The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable &Publication.

ISSUE

The Issue ID is set in the query string by ISSUE=Issue ID.

The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable &Issue.

ARTICLE

The article ID is set in the query string by ARTICLE=Article ID.

The function must have this query string parameter to retrieve the correct values from the database. This value is retrieved in the function and set to the variable &Article.

Returns

Returns the article author.

Syntax

GetScriptContentURL(%Portal, %Node, Record.WEBLIB_WEBPUB, Field.EO_PE_TEMPLATES,  "FieldFormula", "IScript_ArticleTemplate");

Same comments as above.

Description

IScript_Article_Template assembles the article page for a section of a publication issue. It uses the article built-in functions described previously to produce each value that is required by the article page template. Passing all required parameters as bind variables to the HTML Article Page template assembles it.

Customized article page layouts require changes to the code. For example, if the HTML template has eight bind variables, IScript_GetArticleTemplate must pass eight values, including HTML markup returned by other page built-in functions, to match. Using examples from previous sections, we have:

&HTMLText = GetHTMLText(HTML.EO_PE_ARTICLETEMPLATE, &HTMLHeader, &HTMLNav1,
 IScript_GetImageFileSpec("
PWSA19OE85C"), &HTMLNav2, &HTMLCategoryImage, &HTMLTitle, &HTMLNav3, &HTMLBody,
 &HTMLFooter);

where:

EO_PE_ARTICLETEMPLATE is the article page layout.
&HTMLHeader, &HTMLNav1, &HTMLNav2, and HTMLFooter contain the HTML markup for the header, publication navigation, section navigation, and footer portions of the layout.
&HTMLNav3 is the side navigation bar that lists articles for the current section.
&HTMLCategoryImage contains the HTML markup for the category image.
&HTMLTitle is the article title image.
&HTMLBody contains the HTML markup of the article image, text, and author.
IScript_GetImageFileSpec() calls are used to retrieve the image file path and file name from the database.

Returns

Returns the HTML markup for an article in a section of a publication issue.

Example

<a href="http://jwegrzyn070500/psc/ps/EMPLOYEE/PSFT_PA/s/WEBLIB_WEBPUB.EO_PE_
TEMPLATES.FieldFormula.IScript_ArticleTemplate?PUB=PEOPLETALK&ISSUE=
JUNAUG2000&SECTION=INDUSTRY&CATEGORY=COMMUNICATE&ARTICLE=COSPRINGS">Article
 Title</a>