Skip to content

Commit 7e64917

Browse files
Merge pull request #313865 from dominicbetts/iot-tidy-archive
IoT: Link tidy after archive
2 parents 1e7cdb4 + 59a05ec commit 7e64917

34 files changed

Lines changed: 83 additions & 105 deletions

articles/digital-twins/concepts-models.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ Models for Azure Digital Twins are defined using the Digital Twins Definition La
2222

2323
You can view the full language description for DTDL v3 in GitHub: [DTDL Version 3 Language Description](https://github.com/Azure/opendigitaltwins-dtdl/blob/master/DTDL/v3/DTDL.v3.md). This page includes DTDL reference details and examples to help you get started writing your own DTDL models.
2424

25-
DTDL is based on JSON-LD and is programming-language independent. DTDL isn't exclusive to Azure Digital Twins. It is also used to represent device data in other IoT services such as [IoT Plug and Play](../iot/overview-iot-plug-and-play.md).
25+
DTDL is based on JSON-LD and is programming-language independent. DTDL isn't exclusive to Azure Digital Twins. It is also used to represent device data in other IoT services such as [IoT Plug and Play](/previous-versions/azure/iot/overview-iot-plug-and-play).
2626

2727
The rest of this article summarizes how the language is used in Azure Digital Twins.
2828

articles/digital-twins/how-to-parse-models.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ The capabilities of the parser include:
4141
* Determine whether a model is assignable from another model.
4242

4343
> [!NOTE]
44-
> [IoT Plug and Play](../iot/overview-iot-plug-and-play.md) devices use a small syntax variant to describe their functionality. This syntax variant is a semantically compatible subset of the DTDL that is used in Azure Digital Twins. When using the parser library, you don't need to know which syntax variant was used to create the DTDL for your digital twin. The parser will always, by default, return the same model for both IoT Plug and Play and Azure Digital Twins syntax.
44+
> [IoT Plug and Play](/previous-versions/azure/iot/overview-iot-plug-and-play) devices use a small syntax variant to describe their functionality. This syntax variant is a semantically compatible subset of the DTDL that is used in Azure Digital Twins. When using the parser library, you don't need to know which syntax variant was used to create the DTDL for your digital twin. The parser will always, by default, return the same model for both IoT Plug and Play and Azure Digital Twins syntax.
4545
4646
## Code with the parser library
4747

articles/digital-twins/overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ In Azure Digital Twins, you define the digital entities that represent the peopl
3232
You can think of these model definitions as a specialized vocabulary to describe your business. For a building management solution, for example, you might define a model that defines a *Building* type, a *Floor* type, and an *Elevator* type. Models are defined in a JSON-like language called [Digital Twins Definition Language (DTDL)](https://github.com/Azure/opendigitaltwins-dtdl/blob/master/DTDL/v3/DTDL.v3.md). In Azure Digital Twins, DTDL models describe types of entities according to their state properties, components, and relationships. You can design your own model sets from scratch, or get started with a pre-existing set of [DTDL industry ontologies](concepts-ontologies.md) based on common vocabulary for your industry.
3333

3434
>[!TIP]
35-
>Version 2 of DTDL is also used for data models throughout other Azure IoT services, including [IoT Plug and Play](../iot/overview-iot-plug-and-play.md). This compatibility helps you connect your Azure Digital Twins solution with other parts of the Azure ecosystem.
35+
>Version 2 of DTDL is also used for data models throughout other Azure IoT services, including [IoT Plug and Play](/previous-versions/azure/iot/overview-iot-plug-and-play). This compatibility helps you connect your Azure Digital Twins solution with other parts of the Azure ecosystem.
3636
3737
Once you've defined your data models, use them to create [digital twins](concepts-twins-graph.md) that represent each specific entity in your environment. For example, you might use the *Building* model definition to create several *Building*-type twins (*Building 1*, *Building 2*, and so on). You can also use the relationships in the model definitions to connect twins to each other, forming a conceptual graph.
3838

articles/iot-central/core/concepts-architecture.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,7 @@ IoT Central can also control devices by calling commands on the device. For exam
6262

6363
The telemetry, properties, and commands that a device implements are collectively known as the device capabilities. You define these capabilities in a model that the device and the IoT Central application share. In IoT Central, this model is part of the device template that defines a specific type of device. To learn more, see [Assign a device to a device template](concepts-device-templates.md#assign-a-device-to-a-device-template).
6464

65-
The device implementation should follow the [IoT Plug and Play conventions](../../iot/concepts-convention.md) to ensure that it can communicate with IoT Central. For more information, see the various language [SDKs and samples](../../iot/iot-sdks.md).
65+
The device implementation should follow the [IoT Plug and Play conventions](/previous-versions/azure/iot/concepts-convention) to ensure that it can communicate with IoT Central. For more information, see the various language [SDKs and samples](../../iot/iot-sdks.md).
6666

6767
Devices connect to IoT Central using one the supported protocols: [MQTT, AMQP, or HTTP](../../iot-hub/iot-hub-devguide-protocols.md).
6868

articles/iot-central/core/concepts-device-implementation.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ An IoT Central device template includes a _model_ that specifies the behaviors a
2727

2828
Each model has a unique _digital twin model identifier_ (DTMI), such as `dtmi:com:example:Thermostat;1`. When a device connects to IoT Central, it sends the DTMI of the model it implements. IoT Central can then assign the correct device template to the device.
2929

30-
[IoT Plug and Play](../../iot/overview-iot-plug-and-play.md) defines a set of [conventions](../../iot/concepts-convention.md) that a device should follow when it implements a Digital Twin Definition Language (DTDL) model.
30+
[IoT Plug and Play](/previous-versions/azure/iot/overview-iot-plug-and-play) defines a set of [conventions](/previous-versions/azure/iot/concepts-convention) that a device should follow when it implements a Digital Twin Definition Language (DTDL) model.
3131

3232
The [Azure IoT device SDKs](#device-sdks) include support for the IoT Plug and Play conventions.
3333

@@ -51,7 +51,7 @@ A DTDL model can be a _no-component_ or a _multi-component_ model:
5151
> [!TIP]
5252
> You can [import and export a complete device model or individual interface](howto-set-up-template.md#interfaces-and-components) from an IoT Central device template as a DTDL v2 file.
5353
54-
To learn more about device models, see the [IoT Plug and Play modeling guide](../../iot/concepts-modeling-guide.md)
54+
To learn more about device models, see the [IoT Plug and Play modeling guide](/previous-versions/azure/iot/concepts-modeling-guide)
5555

5656
### Conventions
5757

@@ -65,9 +65,9 @@ A device should follow the IoT Plug and Play conventions when it exchanges data
6565
> [!NOTE]
6666
> Currently, IoT Central does not fully support the DTDL **Array** and **Geospatial** data types.
6767
68-
To learn more about the IoT Plug and Play conventions, see [IoT Plug and Play conventions](../../iot/concepts-convention.md).
68+
To learn more about the IoT Plug and Play conventions, see [IoT Plug and Play conventions](/previous-versions/azure/iot/concepts-convention).
6969

70-
To learn more about the format of the JSON messages that a device exchanges with IoT Central, see [Telemetry, property, and command payloads](../../iot/concepts-message-payloads.md).
70+
To learn more about the format of the JSON messages that a device exchanges with IoT Central, see [Telemetry, property, and command payloads](/previous-versions/azure/iot/concepts-message-payloads).
7171

7272
### Device SDKs
7373

articles/iot-central/core/concepts-device-templates.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ ms.custom: device-developer
1515

1616
A device template in Azure IoT Central is a blueprint that defines the characteristics and behaviors of a type of device that connects to your application. For example, the device template defines the telemetry that a device sends so that IoT Central can create visualizations that use the correct units and data types. Telemetry that matches the device template definition is referred to as *modeled* data. Telemetry that doesn't match the device template definition is referred to as *unmodeled* data.
1717

18-
A solution builder adds device templates to an IoT Central application. A device developer writes the device code that implements the behaviors defined in the device template. To learn more about how to create a device template or have one automatically generated, see [Create a device template in your Azure IoT Central application](howto-set-up-template.md). To learn more about the data that a device exchanges with IoT Central, see [Telemetry, property, and command payloads](../../iot/concepts-message-payloads.md).
18+
A solution builder adds device templates to an IoT Central application. A device developer writes the device code that implements the behaviors defined in the device template. To learn more about how to create a device template or have one automatically generated, see [Create a device template in your Azure IoT Central application](howto-set-up-template.md). To learn more about the data that a device exchanges with IoT Central, see [Telemetry, property, and command payloads](/previous-versions/azure/iot/concepts-message-payloads).
1919

2020
A device template includes the following sections:
2121

@@ -88,7 +88,7 @@ The JSON file that defines the device model uses the [Digital Twin Definition La
8888
]
8989
```
9090

91-
To learn more about DTDL models, see the [IoT Plug and Play modeling guide](../../iot/concepts-modeling-guide.md).
91+
To learn more about DTDL models, see the [IoT Plug and Play modeling guide](/previous-versions/azure/iot/concepts-modeling-guide).
9292

9393
> [!NOTE]
9494
> IoT Central defines some extensions to the DTDL v2 language. To learn more, see [IoT Central extension](https://github.com/Azure/opendigitaltwins-dtdl/blob/master/DTDL/v2/DTDL.iotcentral.v2.md).
@@ -251,4 +251,4 @@ A solution developer creates views that let operators monitor and manage connect
251251

252252
## Next step
253253

254-
Now that you've learned about device templates, a suggested next step is to read [Telemetry, property, and command payloads](../../iot/concepts-message-payloads.md) to learn more about the data a device exchanges with IoT Central.
254+
Now that you've learned about device templates, a suggested next step is to read [Telemetry, property, and command payloads](/previous-versions/azure/iot/concepts-message-payloads) to learn more about the data a device exchanges with IoT Central.

articles/iot-central/core/howto-control-devices-with-rest-api.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ To learn how to control devices by using the IoT Central UI, see
3434

3535
## Components and modules
3636

37-
Components let you group and reuse device capabilities. To learn more about components and device models, see the [IoT Plug and Play modeling guide](../../iot/concepts-modeling-guide.md).
37+
Components let you group and reuse device capabilities. To learn more about components and device models, see the [IoT Plug and Play modeling guide](/previous-versions/azure/iot/concepts-modeling-guide).
3838

3939
Not all device templates use components. The following screenshot shows the device template for a simple [thermostat](https://github.com/Azure/iot-plugandplay-models/blob/main/dtmi/com/example/thermostat-2.json) where all the capabilities are defined in a single interface called the **Root component**:
4040

articles/iot-central/core/howto-set-up-template.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -102,7 +102,7 @@ To create a device model, you can:
102102

103103
1. To view the component ID, select **Edit Identity** on any of the component interfaces in the model.
104104

105-
To learn more, see the [IoT Plug and Play modeling guide](../../iot-pnp/concepts-modeling-guide.md).
105+
To learn more, see the [IoT Plug and Play modeling guide](/previous-versions/azure/iot/concepts-modeling-guide).
106106

107107
### Interfaces and components
108108

@@ -112,7 +112,7 @@ To view and manage the interfaces in your device model:
112112

113113
:::image type="content" source="media/howto-set-up-template/device-template.png" alt-text="Screenshot that shows root interface for a model":::
114114

115-
1. Select the ellipsis to add an inherited interface or component to the root interface. To learn more about interfaces and component see [multiple components](../../iot/concepts-modeling-guide.md) in the modeling guide.
115+
1. Select the ellipsis to add an inherited interface or component to the root interface. To learn more about interfaces and component see [multiple components](/previous-versions/azure/iot/concepts-modeling-guide) in the modeling guide.
116116

117117
:::image type="content" source="media/howto-set-up-template/add-interface.png" alt-text="Screenshot that shows how to add interface or component." lightbox="media/howto-set-up-template/add-interface.png":::
118118

@@ -195,7 +195,7 @@ The following table shows the configuration settings for a command capability:
195195
| Response | If enabled, a definition of the command response, including: name, display name, schema, unit, and display unit. |
196196
|Initial value | The default parameter value. This parameter is an IoT Central extension to DTDL. |
197197

198-
To learn more about how devices implement commands, see [Telemetry, property, and command payloads > Commands and long running commands](../../iot/concepts-message-payloads.md#commands).
198+
To learn more about how devices implement commands, see [Telemetry, property, and command payloads > Commands and long running commands](/previous-versions/azure/iot/concepts-message-payloads#commands).
199199

200200
#### Offline commands
201201

articles/iot-central/core/howto-transform-data.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ The following table shows three example transformation types:
3434

3535
| Transformation | Description | Example | Notes |
3636
|------------------------|-------------|----------|-------|
37-
| Message Format | Convert to or manipulate JSON messages. | CSV to JSON | At ingress. IoT Central only accepts value JSON messages. To learn more, see [Telemetry, property, and command payloads](../../iot/concepts-message-payloads.md). |
37+
| Message Format | Convert to or manipulate JSON messages. | CSV to JSON | At ingress. IoT Central only accepts value JSON messages. To learn more, see [Telemetry, property, and command payloads](/previous-versions/azure/iot/concepts-message-payloads). |
3838
| Computations | Math functions that [Azure Functions](../../azure-functions/index.yml) can execute. | Unit conversion from Fahrenheit to Celsius. | Transform using the egress pattern to take advantage of scalable device ingress through direct connection to IoT Central. Transforming the data lets you use IoT Central features such as visualizations and jobs. |
3939
| Message Enrichment | Enrichments from external data sources not found in device properties or telemetry. To learn more about internal enrichments, see [Export IoT data to cloud destinations using Blob Storage](howto-export-to-blob-storage.md). | Add weather information to messages using [location data](howto-use-location-data.md) from devices. | Transform using the egress pattern to take advantage of scalable device ingress through direct connection to IoT Central. |
4040

articles/iot-central/core/howto-use-commands.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -25,9 +25,9 @@ A device can:
2525

2626
By default, commands expect a device to be connected and fail if the device can't be reached. If you select the **Queue if offline** option in the device template UI a command can be queued until a device comes online. These *offline commands* are described in a separate section later in this article.
2727

28-
To learn about the IoT Pug and Play command conventions, see [IoT Plug and Play conventions](../../iot/concepts-convention.md).
28+
To learn about the IoT Pug and Play command conventions, see [IoT Plug and Play conventions](/previous-versions/azure/iot/concepts-convention).
2929

30-
To learn more about the command data that a device exchanges with IoT Central, see [Telemetry, property, and command payloads](../../iot/concepts-message-payloads.md).
30+
To learn more about the command data that a device exchanges with IoT Central, see [Telemetry, property, and command payloads](/previous-versions/azure/iot/concepts-message-payloads).
3131

3232
To learn how to manage commands by using the IoT Central REST API, see [How to use the IoT Central REST API to control devices](../core/howto-control-devices-with-rest-api.md).
3333

@@ -54,7 +54,7 @@ The following table shows the configuration settings for a command capability:
5454
| Request | The payload for the device command.|
5555
| Response | The payload of the device command response.|
5656

57-
To learn about the Digital Twin Definition Language (DTDL) that Azure IoT Central uses to define commands in a device template, see [IoT Plug and Play conventions > Commands](../../iot/concepts-convention.md#commands).
57+
To learn about the Digital Twin Definition Language (DTDL) that Azure IoT Central uses to define commands in a device template, see [IoT Plug and Play conventions > Commands](/previous-versions/azure/iot/concepts-convention#commands).
5858

5959
Optional fields, such as display name and description, let you add more details to the interface and capabilities.
6060

@@ -177,4 +177,4 @@ You can call commands on a device that isn't assigned to a device template. To c
177177

178178
## Next steps
179179

180-
Now that you know how to use commands in your Azure IoT Central application, see [Telemetry, property, and command payloads](../../iot/concepts-message-payloads.md) to learn more about command parameters and [Create and connect a client application to your Azure IoT Central application](tutorial-connect-device.md) to see complete code samples in different languages.
180+
Now that you know how to use commands in your Azure IoT Central application, see [Telemetry, property, and command payloads](/previous-versions/azure/iot/concepts-message-payloads) to learn more about command parameters and [Create and connect a client application to your Azure IoT Central application](tutorial-connect-device.md) to see complete code samples in different languages.

0 commit comments

Comments
 (0)