Skip to main content
Skip table of contents

openFile (PresentationUtils)

Versionshinweise

22.1, 21.2.06, 21.1.11

Code

GROOVY
IPresentationResult openFile(String fileName)

Beschreibung

Öffnet eine bestehende Präsentationsdatei. Folgende Eingabeformate werden hierbei unterstützt:

  • Microsoft Powerpoint: PPTX, PPSX, PPTM, PPSM, POTX, POTM, PPS, PPT, POT
  • OpenOffice: ODP


Parameter

  • fileName
    Name der zu öffnenden Präsentationsdatei (mit vollständiger Pfadangabe). Die angegebene Präsentationsdatei muss vorhanden sein.

Rückgabe
Ergebnis des Öffnens der Präsentationsdatei.
Folgende Methoden stehen für den Zugriff auf Rückgabeobjekt IPresentationResult zur Verfügung

  • PresentationDocument PresentationUtils.getPresentationDocument(IPresentationResult result)
    Repräsentiert die Präsentationsdatei
  • String PresentationUtils.getFileName(IPresentationResult result)
    Liefert den Namen der geöffneten Präsentationsdatei (entspricht dem übergebenen Parameter "fileName")
  • boolean PresentationUtils.isSuccessful(IPresentationResult result)
    War das Öffnen der Präsentationsdatei erfolgreich?
  • String PresentationUtils.getErrorCode(IPresentationResult result)
    Liefert den Fehlercode, falls das Öffnen der Präsentationsdatei nicht erfolgreich war. Die Fehlercodes stehen als Konstanten in der Klasse PresentationConstants zur Verfügung, z.B. PresentationConstants.ERRORCODE_GENERAL. Mit Hilfe der Fehlercodes können individuelle Ausgaben im Scripting hinterlegt werden. Folgende Fehlercodes stehen zur Verfügung:
    • PresentationConstants.ERRORCODE_FILENOTFOUND
      Die angegebene Datei konnte nicht gefunden werden.
    • PresentationConstants.ERRORCODE_NOTSUPPORTED_FILETYPE
      Dieser Dateityp wird als Präsentationsdatei nicht unterstützt.
    • PresentationConstants.ERRORCODE_GENERAL
      Ein allgemeiner Fehler ist bei der Bearbeitung der Präsentationsdatei aufgetreten.

Beispiele

GROOVY
IPresentationResult openResult = PresentationUtils.openFile("C:\\Work\\myFirstPresentation.pptx");

if (!PresentationUtils.isSuccessful(openResult))
{
    String errorCode = PresentationUtils.getErrorCode(openResult);
    
    if (PresentationConstants.ERRORCODE_FILE_NOTFOUND.equals(errorCode))
    {
      //...handle FILE_NOTFOUND
      ScriptUtils.debug("Error: Given presentation file " + openResult.getFileName() + " could not be found.");
    }
    else if (PresentationConstants.ERRORCODE_NOTSUPPORTED_FILETYPE.equals(errorCode))
    {
      //... handle NOTSUPPORTED_FILETYPE
    }
    else
    {
      //....handle PresentationConstants.ERRORCODE_GENERAL
    }
	/** do furthermore */
    return;
}

PresentationDocument presentation = null;
try
{
  presentation = PresentationUtils.getPresentationDocument(openResult);
  ...
}
finally
{
  PresentationUtils.close(presentation);
}
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.