Load File
This use case loads the metadata information of a File by a reference to it.
This can be the reference.truncated of the File itself, which can be obtained from the File uploader, for example, when exchanging Files using Attributes, or the reference.truncated of a Token.
In the latter case, the Token for the File was previously created.
Loading a File that is owned by another Identity is necessary in order to be able to download the actual content of the File using the Download File use case.
If a File that has already been loaded is loaded again or its uploader loads it, this use case, like the Get File metadata use case, simply returns the metadata information of the File.
Parameters
referenceto the File.- The
passwordif the File is to be loaded from areferenceto a Token that is password protected via itspasswordProtectionproperty.
On Success
- The File that corresponds to the
reference.
On Failure
- The given
referencedoes not resolve to a File. - The File is to be loaded from a
referenceto a Token that is personalized for a different Identity via itsforIdentityproperty. - No
passwordor an incorrectpasswordwas entered in case of a File that is to be loaded from areferenceto a password protected Token.