Delen via

Notification Protocol voor servertoepassingen

BITS gebruikt de eigenschap BITSServerNotificationType om te bepalen hoe BITS de inhoud van het uploadbestand naar de servertoepassing verzendt. Als de eigenschap BITSServerNotificationType is ingesteld op 1, geeft BITS de locatie van het uploadbestand door in een header. Als de eigenschap BITSServerNotificationType is ingesteld op 2, geeft BITS de inhoud van het uploadbestand door in de hoofdtekst van de aanvraag.

Zie Verwerken van servertoepassingsfoutenvoor meer informatie over hoe BITS fouten van de servertoepassing verwerkt.

De locatie van het uploadbestand in een koptekst verzenden

BITS geeft de locatie van de upload- en antwoordbestanden door aan de servertoepassing in de headers als de eigenschap BITSServerNotificationType is ingesteld op 1. De servertoepassing opent het uploadbestand, verwerkt de gegevens en genereert vervolgens het antwoordbestand. Standaard verwijdert BITS de upload- en antwoordbestanden van de server nadat deze het antwoord van de servertoepassing heeft ontvangen. Als u bits het uploadbestand wilt kopiëren naar de locatie die is opgegeven door de externe bestandsnaam in de taak, neemt u de BITS-Copy-File-To-Destination-header op in uw antwoord. Als u de koptekst niet opneemt en u de upload- en antwoordbestanden wilt opslaan, moet u de upload- en antwoordbestanden naar een nieuwe locatie kopiëren voordat u reageert. In de volgende tabel ziet u de aanvraagheaders.

Aanvraagheader Beschrijving
BITS-Origineel-Request-URL Bevat de externe naam die is opgegeven in de taak.
BITS-aanvraag-DataFile-Name Bevat het volledige pad naar de geüploade gegevens.
BITS-antwoord-DataFile-Name Bevat het volledige pad naar waar BITS verwacht dat de servertoepassing het antwoord schrijft.

In de volgende tabel ziet u de antwoordheaders.

Antwoordheader Beschrijving
BITS-Statisch-Response-URL Facultatief. Bevat de absolute URL (geef geen relatieve URL op) naar een statisch gegevensbestand dat moet worden gebruikt als het antwoord. Het statische gegevensbestand moet toegankelijk zijn voor de BITS-client. Als u deze header gebruikt, maakt u niet het antwoordbestand dat is opgegeven in de BITS-Response-DataFile-Name aanvraagheader. Bits verwijdert dit bestand niet voor u.
BITS-Copy-File-To-Destination Facultatief. Als de eigenschap BITSServerNotificationType is ingesteld op 1 of 2, kopieert de BITS-server het uploadbestand niet naar de locatie die is opgegeven door de externe bestandsnaam in de taak. Als u bits het bestand wilt kopiëren naar de locatie die is opgegeven door de externe bestandsnaam in de taak, verzendt u deze antwoordheader. U kunt elke waarde opgeven; BITS gebruikt de waarde niet. Houd er rekening mee dat de mappen in het externe bestandspad moeten bestaan.

De volgende aanvraag toont BITS die de locatie van het uploadbestand naar de servertoepassing verzenden.

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

Hieronder ziet u het antwoord van de servertoepassing op BITS; het antwoord wordt in het bestand geplaatst dat is opgegeven door de BITS-Response-DataFile-Name aanvraagheader.

HTTP/1.1 200 - OK
Content-Length: 0

Het uploadbestand verzenden in de hoofdtekst van de aanvraag

BITS verzendt het uploadbestand in de hoofdtekst van de aanvraag als de eigenschap BITSServerNotificationType is ingesteld op 2. Door het uploadbestand in de hoofdtekst van de aanvraag te verzenden, kunnen bestaande scripts en toepassingen met minimale wijzigingen werken. Het uploadbestand en het antwoordbestand worden respectievelijk doorgegeven in de aanvraag en het antwoord. In de volgende tabel ziet u de aanvraagheader.

Aanvraagheader Beschrijving
BITS-Origineel-Request-URL Bevat de externe naam die is opgegeven in de taak.

In de volgende tabel ziet u de antwoordheaders.

Antwoordheader Beschrijving
BITS-Statisch-Response-URL Facultatief. Bevat de absolute URL (geef geen relatieve URL op) naar een statisch gegevensbestand dat moet worden gebruikt als het antwoord. Het statische gegevensbestand moet toegankelijk zijn voor de BITS-client. Als u deze header gebruikt, neemt u het antwoord niet op in de stream. Bits verwijdert dit bestand niet voor u.
BITS-Copy-File-To-Destination Facultatief. Als de eigenschap BITSServerNotificationType is ingesteld op 1 of 2, kopieert de BITS-server het uploadbestand niet naar de locatie die is opgegeven door de externe bestandsnaam in de taak. Als u bits het bestand wilt kopiëren naar de locatie die is opgegeven door de externe bestandsnaam, verzendt u deze antwoordheader. U kunt elke waarde opgeven; BITS gebruikt de waarde niet. Houd er rekening mee dat de mappen in het externe bestandspad moeten bestaan.

De volgende aanvraag toont BITS die het geüploade bestand doorgeven aan de servertoepassing in de hoofdtekst van de aanvraag.

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

Het volgende antwoord toont de servertoepassing die de antwoordgegevens doorgeeft aan BITS in de hoofdtekst van het antwoord.

HTTP/1.1 200 - OK
Content-Length: 100

100 bytes of reply data goes here

Servertoepassingsfouten afhandelen

Zie Servertoepassingsfoutenverwerken.

  • Last updated on