Doboz

A Box™ egy szolgáltatás, amely biztonságos, szinkronizált és könnyen megosztható fájlokat biztosít. Csatlakozzon a Boxhoz a fájlok kezeléséhez. Különböző műveleteket hajthat végre, például fájlokat tölthet fel, frissíthet, lekérhet és törölhet a Boxban.

Ez az összekötő a következő termékekben és régiókban érhető el:

Service	Class	Régiók
Copilot Studio	Standard	Az összes Power Automate-régió, kivéve a következőket:      - A 21Vianet által üzemeltetett China Cloud
Logikai alkalmazások	Standard	Az összes Logic Apps-régió , kivéve a következőket:      - Azure China-régiók      - Amerikai Védelmi Minisztérium (DoD)
Power Alkalmazások	Standard	Az összes Power Apps-régió , kivéve a következőket:      - A 21Vianet által üzemeltetett China Cloud
Power Automate	Standard	Az összes Power Automate-régió, kivéve a következőket:      - A 21Vianet által üzemeltetett China Cloud

Érintkezés
Név	Microsoft
URL	Microsoft LogicApps-támogatás Microsoft Power Automate-támogatás Microsoft Power Apps-támogatás

Összekötő metaadatai
Kiadó	Microsoft
Webhely	https://www.box.com/
Adatvédelmi irányelvek	https://www.box.com/legal/privacypolicy

Box API állapota

Használja ezt az erőforrást a Box API-kimaradások nyomon követéséhez

Ismert problémák és korlátozások

1. Az összekötő nem támogatja az egyszeri bejelentkezés (SSO) kapcsolatokat, ehelyett használjon standard kapcsolatot.
2. Ne keverje össze a Fájlazonosító paramétert a tényleges fájlnévvel. A Box REST API korlátozásai miatt a következő karakterekkel rendelkező érvénytelen fájlazonosítók – [\ { } " <>] – az összekötő GetawayTimeout-hibáihoz vezethetnek.
3. A megadott elérési út minden mappája (mappa elérési útja vagy fájl elérési útja), beleértve a gyökérmappát is, legfeljebb 10000 elemet tartalmazhat.
4. Ha fájlválasztóval választ ki egy mappát, az eredményként kapott elérési út a következővel kezdődhet: "//Minden fájl", például "//Minden fájl/Saját mappa/MyFile.txt". Annak érdekében, hogy ne hozzon létre új "Minden fájl" mappát a gyökérkönyvtárban, ezt az elérési utat manuálisan a következőre kell módosítani: "/Saját mappa/MyFile.txt". A hivatkozás gyökérmappája egyetlen perjelet használ, például ://Minden fájl -> '/'.
5. Az eseményindítók szinte azonnal aktiválják a megfelelő esemény előfordulását a legtöbb esetben, de ritkán előfordulhatnak olyan esetek, amikor az eseményindító indítási késleltetése az alapul szolgáló API-korlátozások miatt akár egy napot is igénybe vehet. További információ: (Box Events API). Ebben az időszakban ajánlott egy fájlt egy mappában tartani. Ellenkező esetben a triggerlogika nem fogja jelenteni.
6. Ha egy fájl már létezik egy mappában, akkor az azonos nevű fájl újbóli feltöltése nem minősül létrehozási eseménynek, hanem frissítési eseménynek.
7. Ez az összekötő már nem táblázatos összekötő, ezért nem használható táblázatos adatforrásként – beleértve az Excel-összekötőt is.
8. Ez az összekötő no-op kérést küldhet a háttérrendszernek.

Általános korlátok

Név	Érték
Maximális fájlméret (MB-ban)	75
Mappaelemek maximális száma	10000
Az összekötőbe/onnan átvitt megabájtok maximális száma sávszélesség-időintervallumon belül (kapcsolatonként)	1000
Sávszélesség időintervalluma (ezredmásodpercben)	60000

Fokozási korlátok

Név	Hívások	Megújítási időszak
API-hívások kapcsolatonként	100	60 másodperc

Műveletek

Archívum kinyerés mappába	Kinyer egy archív fájlt egy mappába a Boxban (például: .zip).
Fájl frissítése	Frissít egy meglévő fájlt a Boxban.
Fájl létrehozása	Feltölt egy fájlt a Boxba.
Fájl metaadatainak lekérése azonosító használatával	Fájlazonosító használatával kéri le a fájl metaadatait a Boxból.
Fájl metaadatainak lekérése elérési úttal	Lekéri a fájl metaadatait a Boxból az elérési út használatával.
Fájl másolása	Fájl másolása egy fájl elérési útjára a Boxban.
Fájl törlése	Töröl egy meglévő fájlt a Boxból.
Fájlok és mappák listázása a gyökérmappában	A Box gyökérmappában lévő fájlok és mappák listája.
Fájlok és mappák listázása a mappában	A Box mappában lévő fájlok és mappák listája.
Fájltartalom lekérése azonosító használatával	A fájl tartalmát az azonosító használatával kéri le a Boxból.
Fájltartalom lekérése elérési úttal	A fájl tartalmát az elérési út használatával kéri le a Boxból.

Archívum kinyerés mappába

Műveleti azonosító:

ExtractFolderV2

Kinyer egy archív fájlt egy mappába a Boxban (például: .zip).

Paraméterek

Név	Kulcs	Szükséges	Típus	Leírás
Forrásarchívum fájl elérési útja	source	True	string	Az archív fájl elérési útja.
Célmappa elérési útja	destination	True	string	A Box elérési útja az archív tartalom kinyeréséhez.
Felülírás	overwrite		boolean	Felülírja a célfájlokat, ha igaz értékre van állítva.

Visszatér

response

array of BlobMetadata

Fájl frissítése

Műveleti azonosító:

UpdateFile

Frissít egy meglévő fájlt a Boxban.

Paraméterek

Név	Kulcs	Szükséges	Típus	Leírás
Fájlazonosító	id	True	string	A Boxban frissíteni kívánt fájl egyedi azonosítója.
Fájl tartalma	body	True	binary	A Boxban frissíteni kívánt fájl tartalma.

Visszatér

Blob metaadatai

Törzs

BlobMetadata

Fájl létrehozása

Műveleti azonosító:

CreateFile

Feltölt egy fájlt a Boxba.

Paraméterek

Név	Kulcs	Szükséges	Típus	Leírás
Mappa elérési útja	folderPath	True	string	A fájl Boxba való feltöltésének mappa elérési útja.
Fájlnév	name	True	string	A Boxban létrehozni kívánt fájl neve.
Fájl tartalma	body	True	binary	A Boxba feltölteni kívánt fájl tartalma.

Visszatér

Blob metaadatai

Törzs

BlobMetadata

Fájl metaadatainak lekérése azonosító használatával

Műveleti azonosító:

GetFileMetadata

Fájlazonosító használatával kéri le a fájl metaadatait a Boxból.

Paraméterek

Név	Kulcs	Szükséges	Típus	Leírás
Fájlazonosító	id	True	string	A fájl egyedi azonosítója a Boxban.

Visszatér

Blob metaadatai

Törzs

BlobMetadata

Fájl metaadatainak lekérése elérési úttal

Műveleti azonosító:

GetFileMetadataByPath

Lekéri a fájl metaadatait a Boxból az elérési út használatával.

Paraméterek

Név	Kulcs	Szükséges	Típus	Leírás
Fájl elérési útja	path	True	string	A fájl egyedi elérési útja a Boxban.

Visszatér

Blob metaadatai

Törzs

BlobMetadata

Fájl másolása

Műveleti azonosító:

CopyFile

Fájl másolása egy fájl elérési útjára a Boxban.

Paraméterek

Név	Kulcs	Szükséges	Típus	Leírás
Forrás URL-címe	source	True	string	A forrásfájl URL-címe.
Célfájl elérési útja	destination	True	string	A célfájl elérési útja a Boxban, beleértve a célfájlnevet is.
Felülírás	overwrite		boolean	Felülírja a célfájlt, ha igaz értékre van állítva.

Visszatér

Blob metaadatai

Törzs

BlobMetadata

Fájl törlése

Műveleti azonosító:

DeleteFile

Töröl egy meglévő fájlt a Boxból.

Paraméterek

Név	Kulcs	Szükséges	Típus	Leírás
Fájlazonosító	id	True	string	A Boxból törölni kívánt fájl egyedi azonosítója.

Fájlok és mappák listázása a gyökérmappában

Műveleti azonosító:

ListRootFolder

A Box gyökérmappában lévő fájlok és mappák listája.

Visszatér

response

array of BlobMetadata

Fájlok és mappák listázása a mappában

Műveleti azonosító:

ListFolder

A Box mappában lévő fájlok és mappák listája.

Paraméterek

Név	Kulcs	Szükséges	Típus	Leírás
Mappaazonosító	id	True	string	A Box mappájának egyedi azonosítója.

Visszatér

response

array of BlobMetadata

Fájltartalom lekérése azonosító használatával

Műveleti azonosító:

GetFileContent

A fájl tartalmát az azonosító használatával kéri le a Boxból.

Paraméterek

Név	Kulcs	Szükséges	Típus	Leírás
Fájlazonosító	id	True	string	A fájl egyedi azonosítója a Boxban.
Tartalomtípus következtetése	inferContentType		boolean	Logikai érték (igaz, hamis) a tartalomtípus bővítményen alapuló következtetéséhez.

Visszatér

A fájl tartalma.

Fájl tartalma

binary

Fájltartalom lekérése elérési úttal

Műveleti azonosító:

GetFileContentByPath

A fájl tartalmát az elérési út használatával kéri le a Boxból.

Paraméterek

Név	Kulcs	Szükséges	Típus	Leírás
Fájl elérési útja	path	True	string	A fájl egyedi elérési útja a Boxban.
Tartalomtípus következtetése	inferContentType		boolean	Logikai érték (igaz, hamis) a tartalomtípus bővítményen alapuló következtetéséhez.

Visszatér

A fájl tartalma.

Fájl tartalma

binary

Eseményindítók

Fájl létrehozásakor (csak tulajdonságok) (V2)	Ez a művelet elindít egy folyamatot, amikor egy új fájl jön létre egy mappában. Az eseményindító nem aktiválódik, ha egy fájl hozzá van adva/frissítve van egy almappában. Ha almappákon kell aktiválni, több eseményindítót kell létrehozni. Ha a "Felosztás" beállítás ki van kapcsolva a Trigger-Beállítások> sikeres eseményindító-futtatások esetében, előfordulhat, hogy a "Fájlok listája" kimenet üres tömböt eredményez.
Fájl létrehozásakor (csak tulajdonságok esetén) [ELAVULT]	Ez a művelet elavult. Használja inkább a Fájl létrehozásakor (csak tulajdonságok) (V2) parancsot. Ez a művelet elindít egy folyamatot, amikor egy új fájl jön létre egy mappában. Az eseményindító nem aktiválódik, ha egy fájl hozzá van adva/frissítve van egy almappában. Ha almappákon kell aktiválni, több eseményindítót kell létrehozni.
Fájl létrehozásakor [ELAVULT]	Elindít egy folyamatot, amikor új fájl jön létre egy Box mappában. Az eseményindító nem aktiválódik, ha egy fájl hozzá van adva/frissítve van egy almappában. Ha almappákon kell aktiválni, több eseményindítót kell létrehozni.
Fájl módosításakor (csak tulajdonságok)	Ez a művelet elindít egy folyamatot, amikor egy fájl módosul egy mappában. Az eseményindító nem aktiválódik, ha egy fájl hozzá van adva/frissítve van egy almappában. Ha almappákon kell aktiválni, több eseményindítót kell létrehozni.
Fájl módosításakor (csak tulajdonságok) (V2) (előzetes verzió)	Ez a művelet elindít egy folyamatot, amikor egy fájl módosul egy mappában. Az eseményindító nem aktiválódik, ha egy fájl hozzá van adva/frissítve van egy almappában. Ha almappákon kell aktiválni, több eseményindítót kell létrehozni. Ha a "Felosztás" beállítás ki van kapcsolva a Trigger-Beállítások> sikeres eseményindító-futtatások esetében, előfordulhat, hogy a "Fájlok listája" kimenet üres tömböt eredményez.
Fájl módosításakor [ELAVULT]	Elindít egy folyamatot, amikor egy fájl módosul egy Box mappában. Az eseményindító nem aktiválódik, ha egy fájl hozzá van adva/frissítve van egy almappában. Ha almappákon kell aktiválni, több eseményindítót kell létrehozni.

Fájl létrehozásakor (csak tulajdonságok) (V2)

Műveleti azonosító:

OnNewFilesV2

Ez a művelet elindít egy folyamatot, amikor egy új fájl jön létre egy mappában. Az eseményindító nem aktiválódik, ha egy fájl hozzá van adva/frissítve van egy almappában. Ha almappákon kell aktiválni, több eseményindítót kell létrehozni. Ha a "Felosztás" beállítás ki van kapcsolva a Trigger-Beállítások> sikeres eseményindító-futtatások esetében, előfordulhat, hogy a "Fájlok listája" kimenet üres tömböt eredményez.

Paraméterek

Név	Kulcs	Szükséges	Típus	Leírás
Mappa	folderId	True	string	A mappa egyedi azonosítója.
Visszaadandó fájlok száma	maxFileCount		integer	Egyetlen trigger futtatásával visszaadandó fájlok maximális száma (1–100). Vegye figyelembe, hogy a "Felosztás" beállítás kényszerítheti az eseményindítót az egyes elemek egyenkénti feldolgozására.

Visszatér

Blob metaadatai

Fájlok listája

BlobMetadata

Fájl létrehozásakor (csak tulajdonságok esetén) [ELAVULT]

Műveleti azonosító:

OnNewFiles

Ez a művelet elavult. Használja inkább a Fájl létrehozásakor (csak tulajdonságok) (V2) parancsot.

Ez a művelet elindít egy folyamatot, amikor egy új fájl jön létre egy mappában. Az eseményindító nem aktiválódik, ha egy fájl hozzá van adva/frissítve van egy almappában. Ha almappákon kell aktiválni, több eseményindítót kell létrehozni.

Paraméterek

Név	Kulcs	Szükséges	Típus	Leírás
Mappa	folderId	True	string	A mappa egyedi azonosítója.
Visszaadandó fájlok száma	maxFileCount		integer	Egyetlen trigger futtatásával visszaadandó fájlok maximális száma (1–100). Vegye figyelembe, hogy a "Felosztás" beállítás kényszerítheti az eseményindítót az egyes elemek egyenkénti feldolgozására.

Visszatér

Blob metaadatai

Fájlok listája

BlobMetadata

Fájl létrehozásakor [ELAVULT]

Műveleti azonosító:

OnNewFile

Elindít egy folyamatot, amikor új fájl jön létre egy Box mappában. Az eseményindító nem aktiválódik, ha egy fájl hozzá van adva/frissítve van egy almappában. Ha almappákon kell aktiválni, több eseményindítót kell létrehozni.

Paraméterek

Név	Kulcs	Szükséges	Típus	Leírás
Mappaazonosító	folderId	True	string	A Box mappájának egyedi azonosítója.
Tartalomtípus következtetése	inferContentType		boolean	Logikai érték (igaz, hamis) a tartalomtípus bővítményen alapuló következtetéséhez.

Visszatér

A fájl tartalma.

Fájl tartalma

binary

Fájl módosításakor (csak tulajdonságok)

Műveleti azonosító:

OnUpdatedFiles

Ez a művelet elindít egy folyamatot, amikor egy fájl módosul egy mappában. Az eseményindító nem aktiválódik, ha egy fájl hozzá van adva/frissítve van egy almappában. Ha almappákon kell aktiválni, több eseményindítót kell létrehozni.

Paraméterek

Név	Kulcs	Szükséges	Típus	Leírás
Mappa	folderId	True	string	Mappa kiválasztása
Visszaadandó fájlok száma	maxFileCount		integer	Egyetlen trigger futtatásával visszaadandó fájlok maximális száma (1–100). Vegye figyelembe, hogy a "Felosztás" beállítás kényszerítheti az eseményindítót az egyes elemek egyenkénti feldolgozására.

Visszatér

Blob metaadatai

Fájlok listája

BlobMetadata

Fájl módosításakor (csak tulajdonságok) (V2) (előzetes verzió)

Műveleti azonosító:

OnUpdatedFilesV2

Ez a művelet elindít egy folyamatot, amikor egy fájl módosul egy mappában. Az eseményindító nem aktiválódik, ha egy fájl hozzá van adva/frissítve van egy almappában. Ha almappákon kell aktiválni, több eseményindítót kell létrehozni. Ha a "Felosztás" beállítás ki van kapcsolva a Trigger-Beállítások> sikeres eseményindító-futtatások esetében, előfordulhat, hogy a "Fájlok listája" kimenet üres tömböt eredményez.

Paraméterek

Név	Kulcs	Szükséges	Típus	Leírás
Mappa	folderId	True	string	Mappa kiválasztása
Visszaadandó fájlok száma	maxFileCount		integer	Egyetlen trigger futtatásával visszaadandó fájlok maximális száma (1–100). Vegye figyelembe, hogy a "Felosztás" beállítás kényszerítheti az eseményindítót az egyes elemek egyenkénti feldolgozására.

Visszatér

Blob metaadatai

Fájlok listája

BlobMetadata

Fájl módosításakor [ELAVULT]

Műveleti azonosító:

OnUpdatedFile

Elindít egy folyamatot, amikor egy fájl módosul egy Box mappában. Az eseményindító nem aktiválódik, ha egy fájl hozzá van adva/frissítve van egy almappában. Ha almappákon kell aktiválni, több eseményindítót kell létrehozni.

Paraméterek

Név	Kulcs	Szükséges	Típus	Leírás
Mappaazonosító	folderId	True	string	A Box mappájának egyedi azonosítója.
Tartalomtípus következtetése	inferContentType		boolean	Logikai érték (igaz, hamis) a tartalomtípus bővítményen alapuló következtetéséhez.

Visszatér

A fájl tartalma.

Fájl tartalma

binary

Meghatározások

BlobMetadata

Blob metaadatai

Név	Ösvény	Típus	Leírás
Azonosító	Id	string	A fájl vagy mappa egyedi azonosítója.
Név	Name	string	A fájl vagy mappa neve.
Megjelenítendő név	DisplayName	string	A fájl vagy mappa megjelenítendő neve.
Útvonal	Path	string	A fájl vagy mappa elérési útja.
Utolsó módosítás	LastModified	date-time	A fájl vagy mappa utolsó módosításának dátuma és időpontja.
Méret	Size	integer	A fájl vagy mappa mérete.
Médiatípus	MediaType	string	A fájl vagy mappa médiatípusa.
IsFolder	IsFolder	boolean	Logikai érték (igaz, hamis), amely jelzi, hogy a blob mappa-e.
ETag	ETag	string	A fájl vagy mappa etagje.
FileLocator	FileLocator	string	A fájl vagy mappa fájlkeresője.
Utoljára módosította	LastModifiedBy	string	A fájlt vagy mappát utoljára módosító felhasználó.

bináris

Ez a bináris alapszintű adattípus.