Microsoft.Common.FileUpload UI-element

Artikel
05/21/2024

Een besturingselement waarmee een gebruiker een of meer bestanden kan opgeven die moeten worden geüpload.

Ui-voorbeeld

Schermopname van het element Microsoft.Common.FileUpload UI in Azure Portal.

Schema

{
  "name": "element1",
  "type": "Microsoft.Common.FileUpload",
  "label": "Some file upload",
  "toolTip": "",
  "constraints": {
    "required": true,
    "accept": ".doc,.docx,.xml,application/msword"
  },
  "options": {
    "multiple": false,
    "uploadMode": "file",
    "openMode": "text",
    "encoding": "UTF-8"
  },
  "visible": true
}

Voorbeelduitvoer

Als options.multiple onwaar is en options.uploadMode een bestand is, heeft de uitvoer de inhoud van het bestand als een JSON-tekenreeks:

"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."

Als options.multiple waar is en options.uploadMode een bestand is, bevat de uitvoer de inhoud van de bestanden als een JSON-matrix:

[
  "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.",
  "Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.",
  "Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.",
  "Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum."
]

Als options.multiple onwaar is en options.uploadMode url is, heeft de uitvoer een URL als een JSON-tekenreeks:

"https://myaccount.blob.core.windows.net/pictures/profile.jpg?sv=2013-08-15&st=2013-08-16&se=2013-08-17&sr=c&sp=r&rscd=file;%20attachment&rsct=binary &sig=YWJjZGVmZw%3d%3d&sig=a39%2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d"

Als options.multiple waar is en options.uploadMode url is, bevat de uitvoer een lijst met URL's als een JSON-matrix:

[
  "https://myaccount.blob.core.windows.net/pictures/profile1.jpg?sv=2013-08-15&st=2013-08-16&se=2013-08-17&sr=c&sp=r&rscd=file;%20attachment&rsct=binary &sig=YWJjZGVmZw%3d%3d&sig=a39%2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d",
  "https://myaccount.blob.core.windows.net/pictures/profile2.jpg?sv=2013-08-15&st=2013-08-16&se=2013-08-17&sr=c&sp=r&rscd=file;%20attachment&rsct=binary &sig=YWJjZGVmZw%3d%3d&sig=a39%2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d",
  "https://myaccount.blob.core.windows.net/pictures/profile3.jpg?sv=2013-08-15&st=2013-08-16&se=2013-08-17&sr=c&sp=r&rscd=file;%20attachment&rsct=binary &sig=YWJjZGVmZw%3d%3d&sig=a39%2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d"
]

Bij het testen van een CreateUiDefinition worden sommige browsers (zoals Google Chrome) URL's afgekapt die zijn gegenereerd door het element Microsoft.Common.FileUpload in de browserconsole. Mogelijk moet u met de rechtermuisknop op afzonderlijke koppelingen klikken om de volledige URL's te kopiëren.

Opmerkingen

constraints.accept hiermee geeft u de typen bestanden op die worden weergegeven in het bestandsdialoogvenster van de browser. Zie de HTML5-specificatie voor toegestane waarden. De standaardwaarde is null.
Als options.multiple deze optie is ingesteld op waar, mag de gebruiker meer dan één bestand selecteren in het dialoogvenster bestand van de browser. De standaardwaarde is onwaar.
Dit element ondersteunt het uploaden van bestanden in twee modi op basis van de waarde van options.uploadMode. Als het bestand is opgegeven, heeft de uitvoer de inhoud van het bestand als blob. Als de URL is opgegeven, wordt het bestand geüpload naar een tijdelijke locatie en heeft de uitvoer de URL van de blob. Tijdelijke blobs worden na 24 uur verwijderd. De standaardwaarde is bestand.
Een geüpload bestand is beveiligd. De uitvoer-URL bevat een SAS-token voor toegang tot het bestand tijdens de implementatie.
De waarde van options.openMode bepaalt hoe het bestand wordt gelezen. Als verwacht wordt dat het bestand tekst zonder opmaak is, geeft u tekst op. Geef anders binair op. De standaardwaarde is tekst.
Als options.uploadMode deze is ingesteld op bestand en options.openMode is ingesteld op binair, wordt de uitvoer base64-gecodeerd.
options.encoding hiermee geeft u de codering die moet worden gebruikt bij het lezen van het bestand. De standaardwaarde is UTF-8 en wordt alleen gebruikt wanneer options.openMode deze is ingesteld op tekst.

Volgende stappen

Zie Aan de slag met CreateUiDefinition voor een inleiding tot het maken van UI-definities.
Zie CreateUiDefinition-elementen voor een beschrijving van algemene eigenschappen in UI-elementen.

Delen via