Overview

You can work on Powerpoint documents using the features provided by the Powerpoint library.
Using the features, you can create new documents or open existing documents to edit and save.

The features provided by the Powerpoint library are as follows:

Creating New Powerpoint documents: NewPowerpoint, CreatePowerpoint
Opening, Saving, Closing, and Getting Powerpoint documents: OpenPowerpoint, SavePowerpoint, ClosePowerpoint, GetPowerpoint
Selecting, Getting, Adding, Deleting, and Copy Pasting Slides: SelectSlide, GetSlideCount, AddNewSlide, DeleteSlide, CopyPasteSlide
Inserting, and Replacing strings: InsertString, ReplaceString
Macro execution: ExecuteMacro

Common Properties

MORE OPTIONS

MORE OPTIONS properties
Properties	Type	Required	Unit	Auto-setting	Description
On Error	Combination box	N	-	N	Specify an action to carry out when an error occurs at the time of execution. - If not specified: Output errors and exit the task. - --Ignore--: Ignore the error. - --Retry--: Try the activity one more time. - --Goto--: Try the scenario for the specified time if the activity fails. - _Event: Select an event created within the project.

DESCRIPTION

Properties	Type	Required	Unit	Auto-Setting	Description
DESCRIPTION	Text	N	-	N	Enter the description for the activity card.The Description entered in the DESCRIPTION field is used as an description of the property. A representative value will be displayed in the absence of the DESCRIPTION input.

NewPowerpoint

Overview

This activity card creates a NewPowerpoint document.

Application procedures

In the [Output] Powerpoint field, specify the variable to assign the open Powerpoint document.

Card properties

Common	Properties	Type	Required	Unit	Auto-Setting	Description
N	[Output] Powerpoint	Variable	Y	-	Y	Specify the variable to assign the open Powerpoint document.
N	Invisible	Toggle button	N	-	Y	Set whether to deactivate the opened Powerpoint document.(Default: Off)
N	Maximize	Toggle button	N	-	Y	Set whether to maximize the window for the opened Powerpoint document. (Default: On)
Y	MORE OPTIONS	-	-	-	-	Common property of the Powerpoint library
Y	DESCRIPTION	-	-	-	-	Common property of the Powerpoint library

Example of utilization

Create a new Powerpoint document, save it after specifying a file name,  then save and close the Powerpoint document.

Sample file

Menu > Help > Samples > Sample > PowerPoint > P_NewPowerPoint_Test

Used variables

this.newPPT = Variable to assign the opened Powerpoint document

Used Properties

[Output] Powerpoint = this.newPPT
Maximize = On

Remarks

This activity card is used to create a new Powerpoint file. The file name must be entered after saving it.

Related/Similar activites

OpenPowerpoint, CreatePowerpoint, ClosePowerpoint, SavePowerpoint

CreatePowerpoint

Overview

This activity card creates a new Powerpoint document.

Application procedures

In the Path field, enter the path and file name of the Powerpoint document created.
Set the OverWrite property to select whether to overwrite any existing file with the same name.

Card properties

Common	Properties	Type	Required	Unit	Auto-setting	Description
N	Path	String	Y	-	N	Enter the path and file name of the Powerpoint document that will be created. (ex. 'C:\\ak\\Test.pptx')
N	OverWrite	Toggle Button	N	-	Y	Set whether to overwrite the document if an Powerpoint document with the same name exists. (Default: Off)
Y	MORE OPTIONS	-	-	-	-	Common property of the Powerpoint library.
Y	DESCRIPTION	-	-	-	-	Common property of the Powerpoint library.

Example of utilization

Create a new Powerpoint document with the specified name in the specified path.

Sample file

Menu > Help > Samples > Sample > PowerPoint > P_CreatePowerPoint_Test

Used variables

None

Used properties

Path = 'C:\\CreatePowerpoint.pptx'
OverWrite = Off

Related/Similar activities

NewPowerpoint, OpenPowerpoint, ClosePowerpoint, SavePowerpoint

OpenPowerpoint

Overview

This activity card opens the Powerpoint document in the specified path.

Application procedures

Ensure that the Powerpoint document to open exists in the specified path.

In the Path field, enter the path and file name of the Powerpoint document to open.
In the [Output] Powerpoint field, specify the variable to store the execution result.

Card properties

Common	Properties	Type	Required	Unit	Auto-setting	Description
N	[Output] Powerpoint	Variable	Y	-	Y	Enter a variable to identify the executed document object.
N	Path	Text	Y	-	N	Enter the path of the document to be executed (ex. 'C:\\ak\\Test.pptx')
N	Invisible	Toggle Button	N	-	Y	Set whether to deactivate the document. (Default: Off)
N	Maximize	Toggle Button	N	-	Y	Set whether to maximize the window of the document. (Default: On)
N	Execute Shell	Toggle Button	N	-	Y	Set whether the document is executed in the same way as executed by double-clicking. (Default: Off)
N	ReadOnly	Toggle Button	N	-	Y	Select whether to run the document as read-only. (Default: Off)
N	Use Password	Toggle Button	N	-	Y	Select whether to use a password. (Default: Off)
Y	MORE OPTIONS	-	-	-	-	Common property of the Powerpoint library.
Y	DESCRIPTION	-	-	-	-	Common property of the Powerpoint library.

Example of utilization

Open, and then close the previously created "CreatePowerpoint_Test.xlsx" Powerpoint document.

Sample file

Menu > Help > Samples > Sample > PowerPoint > P_OpenPowerPoint_Test

Used variables

this.openppt = Variable to specify the opened Powerpoint document

Used properties

[Output] Powerpoint = this.openPPT
Path = 'C:\\CreatePowerpoint.pptx'
Maximize = On

Remarks

Various properties, such as “Invisible,” “Maximize,” “Execute Shell,” “ReadOnly,” and “User Password” can be applied when opening an Powerpoint file. For more information, see the “Card properties” section of the OpenPowerpoint activity card.

Related/Similar activites

NewPowerpoint, CreatePowerpoint

SavePowerpoint

Overview

This activity card saves the specified Powerpoint document.

Application procedures

Ensure that an Powerpoint file to save has been opened.

In the [Input] Powerpoint field, enter the variable for the Powerpoint document to save.
To save the document in a different file name, enter the path and file name of the document in the SaveAs field.

Card properties

Common	Properties	Type	Required	Unit	Auto-setting	Description
N	[Input] Powerpoint	Variable	Y	-	Y	Enter the variable to identify the target object.
N	SaveAs	String	N	-	N	To save the document with a different name, enter the path and file name. (ex. 'C:\\ak\\Test.pptx')
Y	MORE OPTIONS	-	-	-	-	Common property of the Powerpoint library.
Y	DESCRIPTION	-	-	-	-	Common property of the Powerpoint library.

Example of utilization

Open the previously created Powerpoint file and add a new slide at a specified index. Then, save the Powerpoint file using a different name and close Powerpoint.

Sample file

Menu > Help > Samples > Sample > PowerPoint > P_SavePowerPoint_Test

Used variables

this.openppt = Variable to assign the opened Powerpoint document

Used properties

[Input] Powerpoint = this.openppt
SaveAs ='C:\\CreatePowerpoint_SaveAs.pptx'

Related/Similar activities

ewPowerpoint, OpenPowerpoint, ClosePowerpoint

ClosePowerpoint

Overview

This activity card closes an open Powerpoint document.

Application procedures

Ensure that the Powerpoint document to close has been opened.

In the [Input] Powerpoint field, enter the variable for the Powerpoint document to close.
Select whether to forcibly close the document regardless of the document status with the Force property.

Card properties

Common	Properties	Type	Required	Unit	Auto-setting	Description
N	[Input Powerpoint]	Variable	Y	-	Y	Enter the variable to assign the Powerpoint document to close.
N	Force	Toggle Button	N	-	Y	Select whether to forcibly close the Powerpoint document regardless of the document status. (Default: Off)
Y	MORE OPTIONS	-	-	-	-	Common property of the Powerpoint library.
Y	DESCRIPTION	-	-	-	-	Common property of the Powerpoint library.

Example of utilization

Open the previously created Powerpoint and add a new slide in the specified PPT document. Then, save and close the Powerpoint.

Sample File

Menu > Help > Samples > Sample > PowerPoint > P_ClosePowerPoint_Test

Used variables

this.openppt = Variable to specify the opened Powerpoint document

Used properties

[Input] Powerpoint = this.openppt
Force = Off

Related/Similar activities

NewPowerpoint, OpenPowerpoint,CreatePowerpoint, SavePowerpoint

GetPowerpoint

Overview

This activity card fetches the Powerpoint document with a specified file name from among the open Powerpoint documents.

Application procedures

Ensure that the Powerpoint document to fetch the data from has been opened.

In the [Output] Powerpoint field, specify the variable to store the execution result.
In the FileName field, enter the file name of the target Powerpoint document to fetch.
Set the Maximize property to select whether to maximize the target document window.

Card properties

Common	Properties	Type	Required	Unit	Auto-setting	Description
N	[Output] Powerpoint	Variable	Y	-	Y	Enter the variable to assign the Powerpoint document that will be returned as the result.
N	File Name	String	Y	-	N	Specify the target Powerpoint file.
N	Maximize	Toggle Button	N	-	Y	Set whether to maximize the window for the target Powerpoint document. (Default: On)
Y	MORE OPTIONS	-	-	-	-	Common property of the Powerpoint library.
Y	DESCRIPTION	-	-	-	-	Common property of the Powerpoint library.

Example of utilization

Open multiple presentations and get the instance of specified presentation using GetPowerpoint and then add a new slide to the presentation and then save and close the PPT.

Sample file

Menu > Help > Samples > Sample > PowerPoint > P_GetPowerPoint_Test

Used variables

RESULT = Variable to assign the fetched Powerpoint document

Used properties

Output [Powerpoint] = RESULT
FileName = 'Create_Powerpoint1.pptx'
Maximize = On

SelectSlide

Overview

This activity card selects a specific slide from the Powerpoint document.

Application procedures

In the Powerpoint field, enter the variable to select the slide in the powerpoint document.
In the Slide Number field, enter the slide number to select.

Card properties

Common	Properties	Type	Required	Unit	Auto-setting	Description
N	[Input] Powerpoint	Variable	Y	-	N	Enter the variable for the Powerpoint document to select the slide.
N	Slide Number	Int	Y	-	N	Enter the slide number to select. If the entered slide number is between 1 and the total number of slides, then it works. (If not and it has been run, it displays error message "Entered slide number is out of range.")
Y	MORE OPTIONS	-	-	-	-	Common Property of Powerpoint Library
Y	DESCRIPTION	-	-	-	-	Common Property of Powerpoint Library

Example of utilization

Open the previously created ppt, add multiple new slides, get then select the slide using the "SelectSlide," and save and close the ppt.

Sample file

Menu > Help > Samples > Sample > PowerPoint > P_SelectSlide_Test

Used variables

this.openppt = Variable to specify the opened Powerpoint document

Used properties

Powerpoint = this.openppt
SlideNumber = 2

Related/Similar activities

OpenPowerpoint, CreatePowerpoint, AddNewSlide, SavePowerpoint, ClosePowerpoint

GetSlideCount

Overview

This activity card gets total slide count of a PowerPoint presentation.

Application procedures

In the [Output] Count field, specify the variable to assign the slide count.
In the Powerpoint field, enter the variable of the Powerpoint document to get its slide count.

Card properties

Common	Properties	Type	Required	Unit	Auto-setting	Description
N	[Output] Count	Variable	Y	-	N	Specify the variable to assign the slide count.
N	[Input] Powerpoint	Int	Y	-	Y	Enter the variable of the Powerpoint document to get its slide count.
Y	MORE OPTIONS	-	-	-	-	Common property of the Powerpoint library.
Y	DESCRIPTION	-	-	-	-	Common property of the Powerpoint library.

Example of utilization

Open the previously created ppt, add multiple new slides, get the slide count using the "GetSlidecount," and save and close the ppt.

Sample file

Menu > Help > Samples > Sample > PowerPoint > P_GetSlideCount_Test

Used variables

this.count = get the number of slides in the specified presentation

Used properties

[Output] Count = this.count
Path = this.openppt

Related/Similar activities

OpenPowerpoint, CreatePowerpoint, AddNewSlide, SavePowerpoint, ClosePowerpoint

AddNewSlide

Overview

This activity card inserts a new slide in a Powerpoint presentation at the specified position

Application procedure

In the [Input] Powerpoint field, enter the variable of the Powerpoint document to which a new slide is to be added.
In the Slide Master, enter a slide master to select a layout for the new slide.
Select a layout to use for the new slide in the Layout field.
In the Position field, select the position and the slide number(if required) to provide the position of the slide in the presentation.

Card properties

Common	Properties	Type	Required	Unit	Auto-setting	Description
N	[Input] Powerpoint	Variable	Y	-	N	Enter the variable of the Powerpoint document to which a new slide is to be added.
N	Layout	String	Y	-	N	Select the Layout for the new slide: Black, Comparison, Content with Caption, Picture with Caption, Section Header, Title and Content, Title and Vertical Content, Title only, Title Slide, Two Content, Vertical Title and Text.
N	Position	Select box	Y	-	N	Select the position and the slide number(if required) to insert the slide in the presentation: Firstslide, Lastslide, or SlideIndex.
N	Slide number	Int	If Position is slide number, Y else, N	-	N	(***If Position is Slide Index) Enter the specific Index to add slide. If the entered slide number is between 1 and the total number of slides, then it works. (If not and it is executed, it displays the error message "Entered slide number is out of range.")
Y	MORE OPTIONS	-	-	-	-	Common property of the Powerpoint Library.
Y	DESCRIPTION	-	-	-	-	Common property of the Powerpoint Library.

Example of utilization

Open the previously created Powerpoint, add multiple new slides in the specified Powerpoint document, save and close the Powerpoint.

Sample file

Menu > Help > Samples > Sample > PowerPoint > P_AddNewSlide_Test

Used variables

this.openppt = Variable to specify the opened Powerpoint document

Used properties

Powerpoint = this.openppt

Related/Smiliar activities

DeleteSlide

Overview

This activity card allows you to delete a slide from a Powerpoint presentation.

Application producers

In the Powerpoint field, enter the variable of the Powerpoint document that includes the slide to be deleted.
In the SlideNumber field, enter the slide number to delete.

Card properties

Common	Properties	Type	Required	Unit	Auto-setting	Description
N	Powerpoint	Variable	Y	-	N	Enter the variable of the Powerpoint document that includes the slide to be deleted.
N	SlideNumber	Int	Y	-	N	Enter the slide number to be deleted. If the entered slide number is between 1 and the total number of slides, then it works. (If not and it is executed, it displays error message "Entered slide number is out of range.")
Y	MORE OPTIONS	-	-	-	-	Common property of the Powerpoint library.
Y	DESCRIPTION	-	-	-	-	Common property of the Powerpoint library.

Example of utilization

Open the previously created powerpoint, add multiple new slides, delete the slide, and save and close the powerpoint.

Sample file

Menu > Help > Samples > Sample > PowerPoint > P_DeleteSlide_Test

Used variables

RESULT = Variable to specify the opened Powerpoint document

Used properties

Powerpoint = RESULT
SlideNumber = 1

Related/Similar activities

AddNewSlide

CopyPasteSlide

Overview

This activity card copies the slide and pastes it to another document.

Application procedures

In the [Input] Powerpoint field, enter the variable of the Powerpoint document that includes the slide to be copied.
In the Copy Slide Number field, enter the slide number to be copied.
In the [Input] PresentationToPaste field, enter the variable of the Powerpoint document to which slide is to be pasted.
In the Paste Slide Number field, enter the slide number at which to paste.

Card properties

Common	Properties	Type	Required	Unit	Auto-settings	Description
N	[Input] Powerpoint	Variable	Y	-	N	Enter the variable of the Powerpoint document that includes the slide to copy.
N	[Input] PresentationToPaste	String	Y	-	N	Enter the variable of the Powerpoint document to which slide is to be pasted. If the entered slide number is between 1 and the total number of slides, then it works. (If not and it is executed, it display error message "Entered slide number is out of range.")
N	Copy Slide Number	Int	Y	-	N	Enter the slide number to be copied. If the entered slide number is between 1 and the total number of slides, then it works. (If not and it is executed, it displays error message "Entered slide number is out of range.")
N	Paste Slide number	Int	Y	-	N	Enter the slide number to paste. If the entered slide number is between 1 and the total number of slides, then it works. (If not and it is executed, it displays error message "Entered slide number is out of range.")
N	Move	Toggle button	N	-	N	If this option is selected, the slide is moved. Otherwise, the slide is copied. This option is not selected by default. (Default: Not used - gray)
Y	MORE OPTIONS	-	-	-	-	Common property of the Powerpoint library.
Y	DESCRIPTION	-	-	-	-	Common property of the Powerpoint library.

Example of utilization

Open the previously created presentation, add multiple slides and then Insert string in the specified slide copy paste slide using the "CopyPasteSlide" card. Then, save and close the Powerpoint.

Sample file

Menu > Help > Samples > Sample > PowerPoint > P_CopyPasteSlide_Test

Used variables

this.openppt = Variable to specify the opened Powerpoint document

Used properties

Powerpoint = this.openppt
Copy Slide Numer = 1
PresentationToPaste = this.openppt
Paste Slide Number = 2
Move = Off

Related/Similar activities

AddNewSlide, InsertString

ReplaceString

Overview

This activity card searches for a specific text string in a Powerpoint document and replaces it with another text string.

Application procedures

In the [Input] Powerpoint field, enter the variable of the Powerpoint document in which to search for and replace the text string.
In the StringToSearch field, enter the text string to search for.
In the StringToReplace field, enter the string to replace the searched string within single quotation marks.

Card properties

Common	Properties	Type	Required	Unit	Auto-setting	Description
N	[Input] Powerpoint	Variable	Y	-	N	Enter the variable of the Powerpoint document that includes the text to replace.
N	StringToSearch	String	N	-	N	Enter the string to search for within single quotation marks.
N	StringToReplace	String	Y	-	N	Enter the string to replace the searched string within single quotation marks.
N	PartMatch	Toggle Button	N	-	Y	Select whether to allow partial search. (Default: Used - blue)
N	CaseMatch	Toggle Button	N	-	Y	Set whether to be case-sensitive. (Default: Not used - gray)
N	Match Option	Select Box	Y	-	N	Select which occurrence to replace: All - the text is replaced at each occurrence of the searched string. First - the text is replaced at the first occurrence of the searched string. Last - the text is replaced at the last occurrence of the searched string. Specific - the text is replaced at the occurrence of the searched string specified in the Match Index property.
N	Match Index	Int	If Match Option is Specific, Y else, N	-	N	Specific index of the result value that matches the InputString. (*** Match Option is Specific, displayed)
Y	MORE OPTIONS	-	-	-	-	Common property of Powerpoint library.
Y	DESCRIPTION	-	-	-	-	Common property of Powerpoint library.

Example of utilization

Open the previously created presentation, add multiple slides and then Insert multiple Insertstrings in the specified slide and then replace the string in the "ReplaceString" card. Then, save and close the Powerpoint.

Sample file

Menu > Help > Samples > Sample > PowerPoint > P_ReplaceString_Test

Used variables

this.openppt = Variable to specify the opened Powerpoint document

Used properties

Powerpoint = Result
StringToSearch = 'Search String'
StringToReplace = 'Replace'
PartMatch = On
CaseMatch = Off
Match Option = All

Related/Similar activities

AddNewSlide,InsertString

ExecuteMacro

Overview

This activity card runs a specified macro in a macro-enabled presentation.

Application procedures

In the Powerpoint field, enter the variable of the Powerpoint document to execute the macro.
In the MacroName field, enter the name of the macro to run.
In the Parameters field, enter the necessary parameters required by the macro.

Card properties

Common	Properties	Type	Required	Unit	Auto-setting	Description
N	[Input] Powerpoint	Variable	Y	-	N	Enter the variable of the Powerpoint document in which macro is to be executed.
N	MacroName	String	Y	-	N	Enter the name of the macro to run.
N	Parameters	String	N	-	N	Enter the required parameters in the macro to be executed. If there are no parameters to enter, do not enter them. - Enter each parameter within (") and separate multiple parameters with (,). - If you enter letters and numbers inside ("), it will be processed.
Y	MORE OPTIONS	-	-	-	-	Common property of the Powerpoint library.
Y	DESCRIPTION	-	-	-	-	Common property of the Powerpoint library.

Example of utilization

Open previously created presentation and then execute specified macro using "ExecuteMacro" card, and then save and close it.

Sample file

Menu > Help > Samples > Sample > PowerPoint > P_ExecuteMacro_Test

Used variables

this.openppt = Variable to specify the opened Powerpoint document

Used properties

Powerpoint = this.openppt
MacroName = 'first'

Related/Similar activities

None