본문 바로가기

카테고리 없음

Octet Stream Converter



(RFC 2045 and 2046 published November 1996, subtype last updated April November 1996) The 'octet-stream' subtype is used to indicate that a body contains arbitrary binary data. The set of currently defined parameters is: (1) TYPE - the general type or category of binary data. The mime-type application/octet-stream is actually applicable for any file type since it only represents a binary data stream. So you can convert it to any file type actually. So you can convert it to any file type actually.

-->

Various content types can flow through a logic app,for example, JSON, XML, flat files, and binary data.While Logic Apps supports all content types, some have nativesupport and don't require casting or conversion in your logic apps.Other types might require casting or conversion as necessary.This article describes how Logic Apps handles content types andhow you can correctly cast or convert these types when necessary.

Octet Stream Converter Free

To determine the appropriate way for handling content types,Logic Apps relies on the Content-Type header value in HTTP calls,for example:

  • application/json (native type)
  • text/plain (native type)

application/json

Logic Apps stores and handles any request with the application/jsoncontent type as a JavaScript Notation (JSON) object.By default, you can parse JSON content without any casting.To parse a request that has a header with the 'application/json' content type,you can use an expression. This example returns the value dog from theanimal-type array without casting:

@body('myAction')['animal-type'][0]

If you're working with JSON data that doesn't specify a header,you can manually cast that data to JSON by using thejson() function,for example:

@json(triggerBody())['animal-type']

Create tokens for JSON properties

Logic Apps provides the capability for you to generate user-friendlytokens that represent the properties in JSON content so you canreference and use those properties more easily in your logic app's workflow.

  • Request trigger

    When you use this trigger in the Logic App Designer, you can providea JSON schema that describes the payload you expect to receive.The designer parses JSON content by using this schema and generatesuser-friendly tokens that represent the properties in your JSON content.You can then easily reference and use those properties throughout yourlogic app's workflow.

    If you don't have a schema, you can generate the schema.

    1. In the Request trigger, select Use sample payload to generate schema.

    2. Under Enter or paste a sample JSON payload, provide a sample payloadand then choose Done. For example:

      The generated schema now appears in your trigger.

      Here is the underlying definition for your Request trigger in the code view editor:

    3. In your request, make sure you include a Content-Type headerand set the header's value to application/json.

  • Parse JSON action

    When you use this action in the Logic App Designer,you can parse JSON output and generate user-friendlytokens that represent the properties in your JSON content.You can then easily reference and use those propertiesthroughout your logic app's workflow. Similar tothe Request trigger, you can provide or generate aJSON schema that describes the JSON content you want to parse.That way, you can more easily consume data from Azure Service Bus,Azure Cosmos DB, and so on.

text/plain

When your logic app receives HTTP messages thathave the Content-Type header set to text/plain,your logic app stores those messages in raw form.If you include these messages in subsequent actions without casting,requests go out with the Content-Type header set to text/plain.

For example, when you're working with a flat file,you might get an HTTP request with the Content-Typeheader set to text/plain content type:

Date,Name,Address
Oct-1,Frank,123 Ave

If you then send this request on in a later action as the body for another request,for example, @body('flatfile'), that second request also has a Content-Typeheader that's set to text/plain. If you're working with data that is plain textbut didn't specify a header, you can manually cast that data to text by using thestring() functionsuch as this expression:

@string(triggerBody())

application/xml and application/octet-stream

Logic Apps always preserves the Content-Type in a received HTTP request or response.So if your logic app receives content with Content-Type set to application/octet-stream,and you include that content in a later action without casting,the outgoing request also has Content-Type set to application/octet-stream.That way, Logic Apps can guarantee that data doesn't get lost while moving through the workflow.However, the action state, or inputs and outputs, is stored in a JSON objectwhile the state moves through the workflow.

Converter functions

To preserve some data types, Logic Apps converts content to a binarybase64-encoded string with appropriate metadata that preserves boththe $content payload and the $content-type, which are automatically converted.

This list describes how Logic Apps converts content when you use thesefunctions:

  • json(): Casts data to application/json
  • xml(): Casts data to application/xml
  • binary(): Casts data to application/octet-stream
  • string(): Casts data to text/plain
  • base64(): Converts content to a base64-encoded string
  • base64toString(): Converts a base64-encoded string to text/plain
  • base64toBinary(): Converts a base64-encoded string to application/octet-stream
  • dataUri(): Converts a string to a data URI
  • dataUriToBinary(): Converts a data URI to a binary string
  • dataUriToString(): Converts a data URI to a string

Application Octet Stream Converter

Stream

Octet Stream Base64

For example, if you receive an HTTP requestwhere Content-Type set to application/xml,such as this content:

You can cast this content by using the @xml(triggerBody())expression with the xml() and triggerBody() functionsand then use this content later. Or, you can use the@xpath(xml(triggerBody()), '/CustomerName') expressionwith the xpath() and xml() functions.

Other content types

Logic Apps works with and supports other content types,but might require that you manually get the messagebody by decoding the $content variable.

For example, suppose your logic app gets triggered by a requestwith the application/x-www-url-formencoded content type.To preserve all the data, the $content variable in therequest body has a payload that's encoded as a base64 string:

CustomerName=Frank&Address=123+Avenue

Because the request isn't plain text or JSON,the request is stored in the action as follows:

Logic Apps provides native functions for handling form data, for example:

Or, you can manually access the data by using an expression such as this example:

@string(body('formdataAction'))

If you wanted the outgoing request to have the sameapplication/x-www-url-formencoded content type header,you can add the request to the action's body withoutany casting by using an expression such as @body('formdataAction').However, this method only works when the body is the onlyparameter in the body input. If you try to use the@body('formdataAction') expression in an application/json request,you get a runtime error because the body is sent encoded.

-->

The ASN.1 OCTET STRING data type is encoded into a TLV triplet that begins with a Tag byte of 0x04. The OCTET STRING and BIT STRING data types are very similar. Thus, the two types are encoded in a similar manner except that, because the trailing byte of an OCTET STRING cannot have unused bits, no leading bytes must be added to the content. The following example, adapted from the CMC Encoded ASN.1 topic, shows how the name of a certificate template is encoded as a byte array.

If the byte array contains fewer than 128 bytes, the Length field of the TLV triplet requires only one byte to specify the content length. If it is more than 127 bytes, bit 7 of the Length field is set to 1 and bits 6 through 0 specify the number of additional bytes used to identify the content length. This is shown in the following example where the high order bit of the second byte on the first line is set to 1 and the byte indicates that there is a trailing Length byte. The third byte therefore specifies that the content is 0x80 bytes long.

Related topics