GeoprocessingDataFile Class

  • GeoprocessingDataFile
  • class Esri::ArcGISRuntime::GeoprocessingDataFile

    A data file input or output parameter. More...

    Header: #include <GeoprocessingDataFile.h>
    Since: Esri::ArcGISRuntime 100.0
    Inherits: Esri::ArcGISRuntime::GeoprocessingParameter and Esri::ArcGISRuntime::RemoteResource
    Inherited By:

    Esri::ArcGISRuntime::GeoprocessingRaster

    This class was introduced in Esri::ArcGISRuntime 100.0.

    Public Functions

    GeoprocessingDataFile(const QUrl &url, QObject *parent = nullptr)
    GeoprocessingDataFile(QObject *parent = nullptr)
    virtual ~GeoprocessingDataFile() override
    Esri::ArcGISRuntime::TaskWatcher fetchFile(const QString &filePath)
    QString inputFilePath() const
    void setInputFilePath(const QString &path)
    void setUploadId(const QString &uploadId)
    void setUrl(const QUrl &url)
    QString uploadId() const

    Reimplemented Public Functions

    (obsolete) virtual Esri::ArcGISRuntime::Credential *credential() const override
    (obsolete) virtual Esri::ArcGISRuntime::RequestConfiguration requestConfiguration() const override
    (obsolete) virtual void setRequestConfiguration(const Esri::ArcGISRuntime::RequestConfiguration &requestConfiguration) override
    virtual QUrl url() const override

    Signals

    void fetchFileCompleted(QUuid taskId, const QString &filePath)

    Detailed Description

    Corresponds to GPDataFile parameter type on the service.

    Member Function Documentation

    GeoprocessingDataFile::GeoprocessingDataFile(const QUrl &url, QObject *parent = nullptr)

    Constructor that accepts an initial URL to a data file (url) and an optional parent object.

    GeoprocessingDataFile::GeoprocessingDataFile(QObject *parent = nullptr)

    Constructor that accepts an optional parent object.

    [signal] void GeoprocessingDataFile::fetchFileCompleted(QUuid taskId, const QString &filePath)

    The signal emitted when the fetchFile task completes.

    • taskId - The task ID.
    • filePath - The full path to the output file.

    [override virtual] GeoprocessingDataFile::~GeoprocessingDataFile()

    Destructor.

    Esri::ArcGISRuntime::TaskWatcher GeoprocessingDataFile::fetchFile(const QString &filePath)

    Creates a task to fetch the file at url into a file or folder at filePath.

    If filePath is a directory, the file will be given the name of the file taken from the end of url. The full file path will be available as the returned task's result. Alternatively filePath can be a destination filename within an existing directory. Note that any pre-existing file at that location with the same name will be deleted first.

    QString GeoprocessingDataFile::inputFilePath() const

    Returns the input file path of the data.

    This function was introduced in Esri::ArcGISRuntime 100.1.

    See also setInputFilePath().

    void GeoprocessingDataFile::setInputFilePath(const QString &path)

    Sets the input file path of the data path.

    Sets the input file path of this parameter. This should be the location on disk of a file that will be uploaded to the server that the geoprocessing task will run on.

    Note: Set this only for input parameters. This property will be ignored if uploadId is set.

    This function was introduced in Esri::ArcGISRuntime 100.1.

    See also inputFilePath().

    void GeoprocessingDataFile::setUploadId(const QString &uploadId)

    Sets the upload ID of this parameter to uploadId.

    This should be the item ID of an item in the geoprocessing service's.

    Note: Set this only for input parameters. This will be the upload ID of an item previously uploaded to the server. If this property is set it will cause both the inputFilePath and URL properties to be ignored.

    This function was introduced in Esri::ArcGISRuntime 100.1.

    See also uploadId().

    void GeoprocessingDataFile::setUrl(const QUrl &url)

    Sets the URL of the data file to url.

    If this object represents an input parameter, set this to a URL of the input data file. Ensure this URL is accessible to the service. A geoprocessing service can have an uploads REST resource associated with it for placing inputs.

    If this object represents an output parameter, this will be populated with the URL location of the output file on the service. The file can be retrieved by using fetchFile.

    Note: If inputFilePath or uploadId are set the URL property will be ignored.

    See also url().

    QString GeoprocessingDataFile::uploadId() const

    Returns the upload ID of this parameter.

    This will match the ID of an item in the geoprocessing service's uploads resource.

    This function was introduced in Esri::ArcGISRuntime 100.1.

    See also setUploadId().

    [override virtual] QUrl GeoprocessingDataFile::url() const

    Reimplements: RemoteResource::url() const.

    Returns the URL of the data file.

    See also setUrl().

    Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.