DocumentPicker.Import
---------------------

Shows dialog to import files.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [FileDialog](component_FileDialog.md) | [9.1](newinversion91.md) | ❌ No | ❌ No | ❌ No | ❌ No | ✅ Yes |

MBS( "DocumentPicker.Import"; AllowedUTIs; Flags { ; DirectoryPath } ) 

**MBS**( **"DocumentPicker.Import";** /\* Shows dialog to import files. \*/  
**$AllowedUTIs**; /\* The list of allowed universal types.e.g. "public.jpeg¶public.png" \*/   
**$Flags**; /\* Various flags.  
Value 1: Whether to allow multiple files to be selected. (iOS 11 or newer, otherwise ignored)  
Value 2: Whether to show file extensions (iOS 13 or newer, otherwise ignored)  
You can combine both flags and pass 1+2.e.g. 1 \*/   
**$DirectoryPath**) /\* Optional; The path to the directory to use as base.  
New in iOS 13.e.g. $documentFolderPath \*/ 

### Parameters

| Parameter | Description | Example | Flags |
|---|---|---|---|
| AllowedUTIs | The list of allowed universal types. | "public.jpeg¶public.png" |  |
| Flags | Various flags.   Value 1: Whether to allow multiple files to be selected. (iOS 11 or newer, otherwise ignored)   Value 2: Whether to show file extensions (iOS 13 or newer, otherwise ignored)   You can combine both flags and pass 1+2. | 1 |  |
| DirectoryPath | The path to the directory to use as base.   New in iOS 13. | $documentFolderPath | Optional      Added in version **11.0**. |

### Result

Returns OK or error.

### Description

Shows dialog to import files.  
The user selects an external document. The document picker copies the document, leaving the original unchanged.  
  
On success, we store the list of file paths and trigger script. Script is trigger with parameter "Pick" or "Cancel".  
The path list refers to a copy of the selected documents. These documents are temporary files. They remain available only until your application terminates. To keep a permanent copy, move these files to a permanent location inside your sandbox.  
  
Warning: Function returns immediately and dialog shows after function returned asynchronously.  
### Examples

Import file with DocumentPicker:

 # set script to call later   
Set Variable \[ $r ; Value: MBS ( "[DocumentPicker.SetTrigger](DocumentPickerSetTrigger.md)"; Get(FileName); "Trigger" ) \]   
  
\# allowed list of file types:   
Set Variable \[ $Types ; Value: "public.jpeg¶public.png" \]   
  
\# show import dialog:   
Set Variable \[ $r ; Value: MBS ( "DocumentPicker.Import"; $Types ; 0 ) \]  
### See also

- [DocumentPicker.Export](DocumentPickerExport.md)
- [DocumentPicker.Move](DocumentPickerMove.md)
- [DocumentPicker.Open](DocumentPickerOpen.md)
- [DocumentPicker.SetTrigger](DocumentPickerSetTrigger.md)

### Release notes

- **Version 11.0**
    - Added new DirectoryPath parameter for [DocumentPicker.Import](https://www.mbsplugins.eu/DocumentPickerImport.shtml) and [DocumentPicker.Open](https://www.mbsplugins.eu/DocumentPickerOpen.shtml) functions.
    - Changed [DocumentPicker.Import](https://www.mbsplugins.eu/DocumentPickerImport.shtml) and [DocumentPicker.Open](https://www.mbsplugins.eu/DocumentPickerOpen.shtml) to make second parameter flags, so you can decide to show file name extensions.

### Example Databases

- [iOS/Examples/DocumentPicker iOS](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/iOS/Examples/DocumentPicker%20iOS.shtml#9ScriptAnchor_)

### Blog Entries

- [MBS FileMaker Plugin, version 11.0pr5](https://www.mbsplugins.de/archive/2021-01-02/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)

This function is free to use.

Created 28th January 2019 , last changed 27th December 2020

  
[DocumentPicker.Files](DocumentPickerFiles.md) - [DocumentPicker.IsVisible](DocumentPickerIsVisible.md)

[HTML Version](DocumentPickerImport.shtml)