Package com.atlassian.jira.functest.framework

Interface Administration

All Known Implementing Classes:
AdministrationImpl
public interface Administration
Provides methods for carrying out administration tasks in JIRA.
Since:
v3.13

  • Field Details

  • Method Details

    • reIndex

      void reIndex()
      Reindex JIRA, waiting for JIRA to complete the task, in the default index directory.

    • setProfiling

      void setProfiling(boolean on)
      Set JIRA's profiling on or off.
      Parameters:
      on - or off

    • restoreI18nData

      void restoreI18nData(String fileName)
      Restores the specified fileName as JIRA data. Does not make english assertions.
      Parameters:
      fileName - the fiel conatining the JIRA data

    • restoreDataWithBuildNumber

      void restoreDataWithBuildNumber(String fileName, int expectedBuilderNumber)
      Basically check the passed backup to ensure that it matches the passed build number and then restore the data. An exception will be thrown if the backup does not match the passed build number.
      Parameters:
      fileName - the path of the backup.
      expectedBuilderNumber - the build number the data should have.

    • restoreData

      void restoreData(String fileName)
      Same as restoreData(String, boolean), but with useDefaultPaths set to false.

    • restoreData

      void restoreData(String fileName, boolean useDefaultPaths)
      Restores the specified fileName as JIRA data.
      Parameters:
      fileName - the XML file inside the standard backup file directory containing the JIRA data
      useDefaultPaths - if set to true, the xml backup's paths (e.g., index, attachment etc) will be ignored, and the default for those used in stead

    • restoreDataAndLogin

      void restoreDataAndLogin(String fileName, String username)
      same as restoreDataAndLogin(String, String, boolean) but with userDefaultPaths parameter set to false.

    • restoreDataAndLogin

      void restoreDataAndLogin(String fileName, String username, boolean useDefaultPaths)
      Restore the specified file and login to JIRA using the passed username.
      Parameters:
      fileName - the name of the xml file to restore.
      username - the username used to login to JIRA after the restore. The username and the password are assumed to be the same.
      useDefaultPaths - if set to true, the xml backup's paths (e.g., index, attachment etc) will be ignored, and the default for those used in stead

    • restoreDataSlowOldWayAndLogin

      void restoreDataSlowOldWayAndLogin(String fileName, String username)
      Same as restoreDataSlowOldWayAndLogin(String, String, boolean) but with useDefaultPath set to false.

    • restoreDataSlowOldWayAndLogin

      void restoreDataSlowOldWayAndLogin(String fileName, String username, boolean useDefaultPath)
      Restore the specified file data NOT using the clear cache mechanism and login to JIRA using the passed username. This is much slower than using the default methods and should only be used if there is a real reason for it. If you find yourself using this method perhaps we should be fixing the cache clearing stuff instead.
      Parameters:
      fileName - the name of the xml file to restore.
      username - the username used to login to JIRA after the restore. The username and the password are assumed to be the same.
      useDefaultPath - if set to true, the paths in the xml backup (e.g., index, and attachment) will be ignored, and their default paths used instead.

    • restoreDataSlowOldWay

      void restoreDataSlowOldWay(String fileName)
      Same as restoreDataSlowOldWay(String, boolean), except with useDefaultPaths set to false.

    • restoreDataSlowOldWay

      void restoreDataSlowOldWay(String fileName, boolean useDefaultPaths)
      Restores the specified fileName as JIRA data NOT using the clear cache mechanism. This is much slower than using the default methods and should only be used if there is a real reason for it. If you find yourself using this method perhaps we should be fixing the cache clearing stuff instead.
      Parameters:
      fileName - the XML file inside the standard backup file directory containing the JIRA data
      useDefaultPaths - if set to true, the paths in the xml backup (e.g., index, and attachment) will be ignored, and their default paths used instead.

    • restoreDataWithPluginsReload

      void restoreDataWithPluginsReload(String fileName)
      Same as restoreDataWithPluginsReload(String, boolean), except with useDefaultPaths set to false.

    • restoreDataWithPluginsReload

      void restoreDataWithPluginsReload(String fileName, boolean useDefaultPaths)

      Restores the specified fileName as JIRA data NOT using the clear cache mechanism. The plugins system is restarted.

      This restore uses the full Pico refresh the same as in Production. ie it does not do a "Quick Import".

      This is much slower than using the default methods and should only be used if there is a real reason for it.

      Parameters:
      fileName - the XML file inside the standard backup file directory containing the JIRA data
      useDefaultPaths - if set to true, the paths in the xml backup (e.g., index, and attachment) will be ignored, and their default paths used instead.

    • restoreDataSlowOldWay

      void restoreDataSlowOldWay(String path, String fileName)
      Same as restoreDataSlowOldWay(String, String, boolean), but with useDefaultPath set to false;

    • restoreDataSlowOldWay

      void restoreDataSlowOldWay(String path, String fileName, boolean useDefaultPath)
      Restores the XML file from the specified directory NOT using the clear cache mechanism. This is much slower than using the default methods and should only be used if there is a real reason for it. If you find yourself using this method perhaps we should be fixing the cache clearing stuff instead.
      Parameters:
      path - the directory in which the XML file is located
      fileName - the name of the XML file
      useDefaultPath - if set to true, the paths (e.g., attachment, index) in the xml backup will be ignored, and the default used instead

    • restoreDataWithReplacedTokens

      void restoreDataWithReplacedTokens(String originalXmlFileName, Map<String,String> replacements) throws IOException
      Same as restoreDataWithReplacedTokens(String, java.util.Map, boolean), except with useDefaultPaths set to false.
      Throws:
      IOException

    • restoreDataWithReplacedTokens

      void restoreDataWithReplacedTokens(String originalXmlFileName, Map<String,String> replacements, boolean useDefaultPaths) throws IOException
      Reads in an XML file and performs token replacements on it, writes the data to a temp file, then imports that into JIRA.

      Note: this only works when the FuncTest client is running on the same host as the JIRA server.

      For methods to create date strings to use as your tokens, check out the DateUtil class

      Parameters:
      originalXmlFileName - the name of the XML file to read in; must be located in the standard XML file directory
      replacements - a map of token replacements
      useDefaultPaths - if set to true, the paths (e.g., attachment, index) in the xml backup will be ignored, and the default used instead. If the token being replaced is part of the default paths, it is still replaced prior to restore.
      Throws:
      IOException - if there is a problem reading/writing the files

    • replaceTokensInFile

      File replaceTokensInFile(String originalXmlFileName, Map<String,String> replacements) throws IOException
      Reads in an XML file and performs token replacements on it, writes the data to a temp file which is the return value
      Parameters:
      originalXmlFileName - the name of the XML file to read in; must be located in the standard XML file directory
      replacements - a map of token replacements
      Returns:
      a new temporary file that has its tokens replaced
      Throws:
      IOException - if there is a problem reading/writing the files

    • restoreDataWithLicense

      void restoreDataWithLicense(String fileName, String licenseKey)
      same as restoreDataWithLicense(String, String, boolean), except with useDefaultPaths set to false.

    • restoreDataWithLicense

      void restoreDataWithLicense(String fileName, String licenseKey, boolean useDefaultPaths)
      Restores the specified fileName as JIRA data, using the specified License key on import.
      Parameters:
      fileName - the file conatining the JIRA data
      licenseKey - the license key to be installed
      useDefaultPaths - if set to true, the paths (e.g., attachment, index) in the xml backup will be ignored, and the default used instead

    • exportDataToFile

      File exportDataToFile(String fileName)
      Exports the current running data to the specified absolute path
      Parameters:
      fileName - to backup to. This should just be a filename because JIRA always appends ${JIRA.HOME}/export to it before doing the export. Passing a directory may make it fail on windows.
      Returns:
      export file. it will be absolute.

    • restoreBlankInstance

      void restoreBlankInstance()
      Restores a JIRA to a well known blank instance. Use this when when your test doesn't rely on specific license. So it may be run successfully with DC or Server license.

    • restoreBlankServerInstance

      void restoreBlankServerInstance()
      Restores a JIRA to blank instance with Server License. Use this when your test relies on Server license.

    • restoreBlankDataCenterInstance

      void restoreBlankDataCenterInstance()
      Restores a JIRA to blank instance with Data Center License. Use this when your test relies on DC license.

    • restoreBlankInstanceWithLicense

      void restoreBlankInstanceWithLicense(License license)
      Restores a JIRA to a well known blank instance with the supplied licence.
      Parameters:
      license - the license to be installed

    • restoreNotSetupInstance

      void restoreNotSetupInstance()
      Restores a backup file with JIRA in an not setup state.

      If you use this method, you will have to then set up JIRA from scratch!

    • restoreNotSetupInstance

      void restoreNotSetupInstance(String licenseKey)
      Restores a backup file with JIRA in an not setup state.

      If you use this method, you will have to then set up JIRA from scratch!

      Parameters:
      licenseKey - the license key to be used for restore

    • restoreNotSetupRenaissanceInstance

      @Deprecated void restoreNotSetupRenaissanceInstance(String licenseKey)
      Deprecated.
      since 7.0.1. use Administration#restoreNotSetupInstance(License) instead
      Restores a backup file with JIRA in an not setup state with roles enabled.

      If you use this method, you will have to then set up JIRA from scratch!

      Parameters:
      licenseKey - the license key to be used for restore

    • getCurrentAttachmentPath

      String getCurrentAttachmentPath()
      Obtains the current attachment path configured for JIRA.

      This method does not check whether Attachments are enabled or not. If JIRA is configured to use the "default" attachment path, then this method still returns the ACTUAL path that is used.

      The implementation navigates to the Admin Attachments Settings page and screenscrapes, so don't expect to remain on the same page as when you called the method.

      Returns:
      the current attachment path configured for JIRA.

    • activateSubTasks

      @Deprecated void activateSubTasks()
      Deprecated.
      use Subtasks.enable() instead.

    • addSubTaskType

      void addSubTaskType(String name)

    • removeGlobalPermission

      void removeGlobalPermission(int permission, String group)
      Deprecated.
      Use removeGlobalPermission(com.atlassian.jira.permission.GlobalPermissionKey, String) instead. Since v6.2.5.
      Remove a group from a given Global Permission. Ends up on the Global Permissions page.
      Parameters:
      permission - The permission to remove teh group from
      group - the group to remove

    • removeGlobalPermission

      void removeGlobalPermission(GlobalPermissionKey permission, String group)
      Remove a group from a given Global Permission. Ends up on the Global Permissions page.
      Parameters:
      permission - The permission to remove the group from
      group - the group to remove

    • addGlobalPermission

      void addGlobalPermission(int permission, String group)
      Deprecated.
      Use addGlobalPermission(com.atlassian.jira.permission.GlobalPermissionKey, String) instead. Since v6.2.5.
      Add a group to a Global permission Ends up on the Global Permissions page.
      Parameters:
      permission - the permission to add the group to
      group - The group to add

    • addGlobalPermission

      void addGlobalPermission(GlobalPermissionKey permission, String group)
      Add a group to a Global permission Ends up on the Global Permissions page.
      Parameters:
      permission - the permission to add the group to
      group - The group to add

    • switchToLicense

      void switchToLicense(License license)
      Changes JIRA's lincense to a given license object
      Parameters:
      license - license to switch to

    • switchToLicense

      void switchToLicense(String license, String description)
      Changes JIRA's lincense to a given license and asserts that the description then appears on the view license
      Parameters:
      license - license to switch to
      description - license description

    • switchToPersonalLicense

      void switchToPersonalLicense()
      Switches the license to a personal license.

    • switchToStarterLicense

      void switchToStarterLicense()
      Switches the license to a starter license.

    • getJiraHomeDirectory

      String getJiraHomeDirectory()
      Returns the JIRA home directory as reported in the System Info section
      Returns:
      the JIRA home directory as reported in the System Info section

    • copyFileToJiraImportDirectory

      void copyFileToJiraImportDirectory(File file)
      Copies a file to the JIRA import directory, presumably with the intention of testing imports directly.
      Parameters:
      file - the file to copy to JIRA_HOME/import

    • getEdition

      String getEdition()
      Returns the current edition name. This may be useful for licensing checks
      Returns:
      the current edition name
      See Also:

    • getBuildNumber

      long getBuildNumber()
      Returns ths current build number. A RuntimeException will be thrown if we can't find the build number.
      Returns:
      JIRA's build number.

    • generalConfiguration

      GeneralConfiguration generalConfiguration()
      Allows you to perform generalConfiguration actions.
      Returns:
      generalConfiguration

    • backdoor

      Backdoor backdoor()
      Allows you to perform backdoor actions
      Returns:
      backdoor

    • project

      Project project()
      Allows you to perform project actions.
      Returns:
      project

    • usersAndGroups

      UsersAndGroups usersAndGroups()
      Allows you to perform user and group actions.
      Returns:
      usersAndGroups

    • roles

      Roles roles()
      Allows you to perform role actions
      Returns:
      roles

    • customFields

      CustomFields customFields()
      Allows you to perform custom field actions.
      Returns:
      customFields

    • permissionSchemes

      PermissionSchemes permissionSchemes()
      Deprecated.
      use Backdoor.permissionSchemes()
      Allows you to modify permission schemes.
      Returns:
      permissionSchemes

    • issueSecuritySchemes

      IssueSecuritySchemes issueSecuritySchemes()
      Allows you to modify issue security schemes.
      Returns:
      issue security schemes of this administration

    • fieldConfigurations

      FieldConfigurations fieldConfigurations()
      Allows you to modify field configurations.
      Returns:
      fieldConfigurations

    • fieldConfigurationSchemes

      FieldConfigurationSchemes fieldConfigurationSchemes()
      Allows you to modify field configuration schemes.
      Returns:
      fieldConfigurationSchemes

    • projectImport

      ProjectImport projectImport()
      Allows you to perform project imports.
      Returns:
      projectImport

    • plugins

      Plugins plugins()
      Utility function to allow you some basic plugins control
      Returns:
      plugins

    • enableAccessLogging

      void enableAccessLogging()
      enable http access logging

    • attachments

      Attachments attachments()
      Returns:
      attachments

    • utilities

      Administration.Utilities utilities()
      Returns:
      utilities

    • subtasks

      Subtasks subtasks()
      Returns:
      grouping to manage administration of subtasks

    • issueLinking

      IssueLinking issueLinking()
      TGo to issue linking administration section.
      Returns:
      grouping to manage issue linking

    • timeTracking

      TimeTracking timeTracking()
      Get time tracking administration section util.
      Returns:
      time tracking configuration

    • resolutions

      Resolutions resolutions()
      Returns:
      resolution configuration

    • services

      ViewServices services()
      Returns the ViewServices object which allows you to run operations on the ViewServices page.
      Returns:
      the ViewServices object which allows you to run operations on the ViewServices page.

    • viewFieldScreens

      ViewFieldScreens viewFieldScreens()
      Field screens config.
      Returns:
      field screens config

    • workflows

      ViewWorkflows workflows()
      Manage the 'Workflows' administration page
      Returns:
      ViewWorkflows instance

    • notificationSchemes

      NotificationSchemes notificationSchemes()
      'Notification Schemes' administration section
      Returns:
      NotificationSchemes instance

    • getSystemTenantHomeDirectory

      String getSystemTenantHomeDirectory()
      Get the system tenant home directory. This does the same thing as getJiraHomeDirectory, except it doesn't cache it in a thread local. It assumes that the environment data for this administration object is for the system tenant. It should only be called when a tenant is provisioned, which should only be done on the first test to that tenant.
      Returns:
      The system tenant home directory.

    • mailServers

      MailServerAdministration mailServers()
      Gets an instance of the Mail Server Administration page.
      Returns:
      an instance of the Mail Server Administration page.

    • sharedFilters

      SharedFiltersAdministration sharedFilters()
      Gets an instance of the Shared Filters Administration page.
      Returns:
      an instance of the Shared Filters Administration page.

    • sendBulkMail

      SendBulkMail sendBulkMail()
      Gets an instance of the Send Bulk Mail Page.
      Returns:
      an instance of the Send Bulk Mail Page.

    • tabs

      AdminTabs tabs()
      Gets an instance of the AdminTabs Page Object.
      Returns:
      an instance of the AdminTabs Page Object.

    • advancedApplicationProperties

      AdvancedApplicationProperties advancedApplicationProperties()
      Gets an instance of the AdvancedApplicationProperties Page Object.
      Returns:
      an instance of the AdvancedApplicationProperties Page Object.

    • statuses

      Statuses statuses()
      Gets the instance of the Statuses page

    • waitForRestore

      void waitForRestore()
      Waits for the data import progress to complete.

    • sharedDashboards

      SharedDashboardsAdministration sharedDashboards()

    • restoreData

      void restoreData(String fileName, Administration.OutgoingMailSettings outgoingMailSetting)

    • link

      Administration.Link link()
      Retrieves the administration home link in the JIRA Header.
      Returns:
      the administration home link in the JIRA Header.