Dela via

Notification Protocol för serverprogram

BITS använder egenskapen BITSServerNotificationType för att avgöra hur BITS skickar innehållet i uppladdningsfilen till serverprogrammet. Om egenskapen BITSServerNotificationType är inställd på 1 skickar BITS platsen för uppladdningsfilen i en rubrik. Om egenskapen BITSServerNotificationType är inställd på 2 skickar BITS innehållet i uppladdningsfilen i brödtexten i begäran.

Mer information om hur BITS hanterar fel från serverprogrammet finns i Hantera serverprogramfel.

Skicka platsen för uppladdningsfilen i ett huvud

BITS skickar platsen för uppladdnings- och svarsfilerna till serverprogrammet i rubrikerna om egenskapen BITSServerNotificationType är inställd på 1. Serverprogrammet öppnar uppladdningsfilen, bearbetar data och genererar sedan svarsfilen. Som standard tar BITS bort uppladdnings- och svarsfilerna från servern när det har fått svaret från serverprogrammet. Om du vill att BITS ska kopiera uppladdningsfilen till den plats som anges av fjärrfilnamnet i jobbet inkluderar du bits-copy-file-To-Destination-huvudet i ditt svar. Om du inte inkluderar huvudet och vill spara uppladdnings- och svarsfilerna måste du kopiera uppladdnings- och svarsfilerna till en ny plats innan du svarar. I följande tabell visas begäranderubrikerna.

Begärandehuvud Beskrivning
BITS-Original-Request-URL Innehåller det fjärrnamn som angetts i jobbet.
BITS-Request –DataFile-Name Innehåller den fullständiga sökvägen till de uppladdade data.
BITS-Response –DataFile-Name Innehåller den fullständiga sökvägen till där BITS förväntar sig att serverprogrammet ska skriva svaret.

I följande tabell visas svarsrubrikerna.

Svarsrubrik Beskrivning
BITS-Static –Response-URL Valfri. Innehåller den absoluta URL:en (ange inte en relativ URL) till en statisk datafil som ska användas som svar. Den statiska datafilen måste vara tillgänglig för BITS-klienten. Om du använder det här huvudet skapar du inte svarsfilen som anges i BITS-Response-DataFile-Name begäranderubrik. Observera att BITS inte tar bort den här filen åt dig.
BITS-Copy-File –To-Destination Valfri. Om egenskapen BITSServerNotificationType är inställd på 1 eller 2 kopierar BITS-servern som standard inte uppladdningsfilen till den plats som anges av fjärrfilens namn i jobbet. Om du vill att BITS ska kopiera filen till den plats som anges av fjärrfilnamnet i jobbet skickar du det här svarshuvudet. Du kan ange valfritt värde. BITS använder inte värdet. Observera att mapparna i fjärrfilens sökväg måste finnas.

Följande begäran visar BITS som skickar platsen för uppladdningsfilen till serverprogrammet.

POST https://myserver/myvdir/handle_upload.asp?ACCOUNT=873112 HTTP/1.1
Host: myserver
BITS-Original-Request-URL: https://front-end-server/vdir
BITS-Request-DataFile-Name: c:\physical-path\BITS-Sessions\{5e53c221-f2d6-4bf2-
b994-1dc43ceaca8d}\request
BITS-Response-DataFile-Name: c:\physical-path\BITS-Sessions\{5e53c221-f2d6-4bf2-
b994-1dc43ceaca8d}\response
Content-Length: 0

Följande visar serverprogrammets svar på BITS; svaret placeras i filen som anges av BITS-Response-DataFile-Name begäranderubrik.

HTTP/1.1 200 - OK
Content-Length: 0

Skicka uppladdningsfilen i brödtexten i begäran

BITS skickar uppladdningsfilen i brödtexten i begäran om egenskapen BITSServerNotificationType är inställd på 2. Om du skickar uppladdningsfilen i brödtexten i begäran kan befintliga skript och program fungera med minimala ändringar. Uppladdningsfilen och svarsfilen skickas i begäran respektive svaret. Följande tabell visar begärandehuvudet.

Begärandehuvud Beskrivning
BITS-Original-Request-URL Innehåller det fjärrnamn som angetts i jobbet.

I följande tabell visas svarsrubrikerna.

Svarsrubrik Beskrivning
BITS-Static –Response-URL Valfri. Innehåller den absoluta URL:en (ange inte en relativ URL) till en statisk datafil som ska användas som svar. Den statiska datafilen måste vara tillgänglig för BITS-klienten. Om du använder det här huvudet ska du inte ta med svaret i strömmen. Observera att BITS inte tar bort den här filen åt dig.
BITS-Copy-File –To-Destination Valfri. Om egenskapen BITSServerNotificationType är inställd på 1 eller 2 kopierar BITS-servern inte uppladdningsfilen till den plats som anges av fjärrfilnamnet i jobbet. Om du vill att BITS ska kopiera filen till den plats som anges av fjärrfilens namn skickar du det här svarshuvudet. Du kan ange valfritt värde. BITS använder inte värdet. Observera att mapparna i fjärrfilens sökväg måste finnas.

Följande begäran visar BITS som skickar den uppladdade filen till serverprogrammet i brödtexten i begäran.

POST https://myserver/myvdir/handle_upload.asp?ACCOUNT=873112 HTTP/1.1
Host: myserver
BITS-Original-Request-URL: https://front-end-server/vdir
Content-Length: 80000

80000 bytes of upload data goes here

Följande svar visar hur serverprogrammet skickar svarsdata till BITS i svarets brödtext.

HTTP/1.1 200 - OK
Content-Length: 100

100 bytes of reply data goes here

Hantera serverprogramfel

Se hantering av serverprogramfel.