Élément CreateScanJobResponse

Article
02/07/2024

L’élément CreateScanJobResponse requis contient la réponse du service d’analyse WSD à la demande d’analyse d’un client.

Utilisation

<wscn:CreateScanJobResponse>
  child elements
</wscn:CreateScanJobResponse>

Attributs

Il n’y a pas d’attributs.

Éléments enfants

Élément
DocumentFinalParameters
ImageInformation
JobId
JobToken

Éléments parents

Il n’y a pas d’éléments parents.

Remarques

Le service d’analyse WSD doit prendre en charge l’élément d’opération CreateScanJobResponse .

Le service d’analyse WSD envoie un élément d’opération CreateScanJobResponse au client en réponse à la demande CreateScanJobRequest d’un client.

Si le client a effectué une demande d’analyse valide, le service d’analyse WSD doit retourner les informations suivantes :

JobId unique pour identifier le travail. Le scanneur génère JobId d’une manière définie par l’implémentation dans les plages définies. Le service d’analyse ne doit pas réutiliser les valeurs qui ont été affectées récemment afin que les clients ne confondent pas les travaux avec les travaux plus anciens.
Identificateur unique dans JobToken. JobToken est associé à JobId pour représenter de manière unique le travail d’analyse. JobToken est passé au service d’analyse dans l’élément d’opération RetrieveImageRequest pour permettre au périphérique d’analyse de vérifier que le demandeur d’analyse a réellement créé le travail d’analyse.
ImageInformation, qui contient des informations sur les données d’image résultantes d’une analyse effectuée avec le ScanTicket en cours de validation.
DocumentFinalParameters, qui contient l’élément DocumentParameters réel que le service d’analyse utilise pour ce travail d’analyse.

Le client doit récupérer les données d’image réelles du service d’analyse en envoyant un ou plusieurs éléments d’opération RetrieveImageRequest . Le client dispose de 60 secondes pour envoyer un élément d’opération RetrieveImageRequest une fois que le service d’analyse a répondu à la demande CreateScanJobRequest du client. Si le service d’analyse ne reçoit pas de demande RetrieveImageRequest dans ce délai, il doit abandonner le travail avec un JobStateReason de JobTimedOut. Si le travail se compose de plusieurs documents, ce délai d’attente s’applique entre chaque opération RetrieveImageRequest/Response successive.

Exemples

L’exemple de code suivant illustre une réponse du service d’analyse WSD à une demande CreateScanJobRequest.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
  xmlns:soap="https://www.w3.org/2003/05/soap-envelope"
  xmlns:wsa="https://schemas.xmlsoap.org/ws/2003/03/addressing"
  xmlns:wscn="https://schemas.microsoft.com/windows/2006/01/wdp/scan"
  soap:encodingStyle='https://www.w3.org/2002/12/soap-encoding' >

  <soap:Header>
    <wsa:To>
      https://schemas.xmlsoap.org/ws/2003/03/addressing/role/anonymous
    </wsa:To>
    <wsa:Action>
      https://schemas.microsoft.com/windows/2006/01/wdp/scan/CreateScanJob
    </wsa:Action>
    <wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
    <wsa:RelatesTo>uuid:MsgIdOfTheCreateScanJobRequest</wsa:RelatesTo>
  </soap:Header>

  <soap:Body>
    <wscn:CreateScanJobResponse>
      <wscn:JobId>1</wscn:JobId>
      <wscn:JobToken>Job9876TokenString</wscn:JobToken>
      <wscn:ImageInformation>
        <wscn:MediaFrontImageInfo>
          <wscn:PixelsPerLine>900</wscn:PixelsPerLine>
          <wscn:NumberOfLines>1500</wscn:NumberOfLines>
          <wscn:BytesPerLine>113</wscn:BytesPerLine>
        </wscn:MediaFrontImageInfo>
      </wscn:ImageInformation>
      <wscn:DocumentFinalParamters>
        <wscn:Format>jfif</wscn:Format>
        <wscn:CompressionQualityFactor>45</wscn:CompressionQualityFactor>
        <wscn:ImagesToTransfer>0</wscn:ImagesToTransfer>
        <wscn:InputSource>Platen</wscn:InputSource>
        <wscn:ContentType>Auto</wscn:ContentType>
        <wscn:InputSize>
          <wscn:InputMediaSize>
            <wscn:Width wscn:Override="true">8500</wscn:Width>
            <wscn:Height wscn:Override="true">11000</wscn:Height>
          </wscn:InputMediaSize>
        </wscn:InputSize>
        <wscn:Exposure>
          <wscn:ExposureSettings>
            <wscn:Contrast wscn:UsedDefault="true">0</wscn:Contrast>
            <wscn:Brightness wscn:UsedDefault="true">0</wscn:Brightness>
            <wscn:Sharpness wscn:UsedDefault="true">0</wscn:Sharpness>
          </wscn:ExposureSettings>
        </wscn:Exposure>
        <wscn:Scaling>
          <wscn:ScalingWidth>125</wscn:ScalingWidth>
          <wscn:ScalingHeight>125</wscn:ScalingHeight>
        </wscn:Scaling>
        <wscn:Rotation wscn:UsedDefault="true">0</wscn:Rotation>
        <wscn:MediaSides>
          <wscn:MediaFront>
            <wscn:ScanRegion>
              <wscn:ScanRegionXOffset wscn:UsedDefault="true">
                0
              </wscn:ScanRegionXOffset>
              <wscn:ScanRegionYOffset wscn:UsedDefault="true">
                0
              </wscn:ScanRegionYOffset>
              <wscn:ScanRegionWidth wscn:UsedDefault="true">
                8500
              </wscn:ScanRegionWidth>
              <wscn:ScanRegionHeight wscn:UsedDefault="true">
                11000
              </wscn:ScanRegionHeight>
            </wscn:ScanRegion>
            <wscn:ColorProcessing wscn:UsedDefault="true">
              RGB24
            </wscn:ColorProcessing>
            <wscn:Resolution>
              <wscn:Width>300</wscn:Width>
              <wscn:Height>300</wscn:Height>
            </wscn:Resolution>
          </wscn:MediaFront>
        </wscn:MediaSides>
      </wscn:DocumentFinalParamters>
    </wscn:CreateScanJobResponse>
  </soap:Body>
</soap:Envelope>