产品开发

更新时间：2018-07-13 17:54:56

产品创建

在进行产品定义前，需要先创建一个新的产品，这里需要注意的是，产品的定义为一系列具备相同“属性”，"事件"和“服务”的设备的统一抽象，如某型号注塑机，某型号空气压缩机等。
从平台左侧的导航栏中选择设备管理->产品开发菜单，进入产品开发页面。

进入产品开发页面后，您将看到您所创建的所有产品列表，如果尚未创建任何产品，则将看到一个空的产品列表。

如需新建产品模型，可以点击上图中列表右上侧的“新增产品”按钮开始新增产品模型定义。
新增产品的第一步为填写产品的一些静态基础信息。用户根据向导选择和填入相关信息：

产品名称：开发者给产品的命名，可以为产品本身的型号，或可以标识产品特性的一段文字描述。
产品类型：

• 直连设备：泛指设备本身具备上网能，可以自行上报或帮助别的无法联网的设备上报属性，事件和接收云端服务调用的设备。可以是一个本身具备联网能力的工控机，嵌入式工控板，DTU数传设备。

• 网关：特指运行阿里云IoT边缘计算网关平台的设备。
  产品行业：选择产品所属的行业。
  硬件平台：选择产品开发所用的硬件平台。
  操作系统：选择该产品所使用的软件操作系统。
  联网方式：根据产品实际情况选择产品的联网方式。
  新字段：如部分产品有特殊的需要标识的字段，可以通过新字段选项为产品定义特殊的静态字段。
  产品描述：一段话对新建产品进行描述。
  在完成产品静态属性的填写后，选择“提交”按钮，完成产品的新建。

完成产品新建以后，您可以选择稍后对产品进行编辑，也可以立即点击“编辑改产品”按钮对产品的属性，事件，服务三大要素进行编辑。

产品定义

点击“编辑该产品”按钮，进入产品详情页。

在产品详情页中，可以看到在新建产品时编辑的相关内容，以及系统自动为产品分配的一个唯一“ProductKey”。同时，可以看到“编辑”，“发布”，“新增”三个按钮，下面分别介绍三个按钮的功能。
“编辑”按钮：点击后出现如下弹窗，用户可以对“产品名称”字段进行编辑，以及增加自定义字段。

“发布”按钮：当用户完成产品定义后，通过点击发布按钮以固化产品的属性，事件，服务三要素，同时向系统中的其他相关模块声明产品模型。产品模型发布后将无法进行修改，未经发布的产品模型将无法在项目管理的数据源应用中被使用。
“新增”按钮：产品的属性，事件，服务等特性，均通过此按钮进行新增。下面将重点介绍新增过程。
点击“新增”按钮，弹出新增自定义功能窗口，在串口中可以选择新增“属性”，“事件”，“服务”。

新增属性

功能类型：选择当前要定义的功能为“属性”，“事件”还是“服务”
功能名称：用于对功能的概括性描述的名称，可以为中文。“属性”，“事件”，“服务”三者意义相同。
标识符：由英文，数字下划线组成的功能标识，此标识主要用于将来对设备属性的引用，较为重要。“属性”，“事件”，“服务”三者意义相同。
数据类型：对于“属性”类功能的描述，需要选择“属性”的数据类型。如果将来设备上传的属性类型和定义的类型不同，将会导致属性解析失败，属性数据将不会被接收存储。
取值范围：定义属性的最大最小值。如果实际上报的属性没有落在此区间，属性值将被判定为无效，不会被记录。
单位：选择属性的单位名称，如“米”，“千瓦时”等。
读写类型：此处的读写类型中读写的主体为云端平台。
描述：对属性进行一个较为详细的描述。

新增事件

与新增“属性”不同，对于事件的定义增加了如下特性的定义：
事件类型：平台将事件分为三个类型，其中“告警”，“故障”两个类型将会被平台统计。
输出参数：此处的输出主体为端设备/系统，如报警时所携带的具体的报警描述。即通过事件上报带到平台的参数的定义。参数定义类似属性定义，可以参考属性定义。

服务定义

与事件定义类似，服务定义中增加了如下新的特性：
调用方式：定义服务的调用返回模式。“异步”调用，表示云端发出对服务的调用，而不等待和响应调用的反馈。“同步”则表示云端会在调用后等待设备端返回调用结果，直到等待超时。
输入参数：定义在服务调用时，由云端传递给边缘侧的参数。
输出参数：定义在同步调用中，由设备反馈的调用结果中所携带的参数。

完成产品定义后，在产品详情中可以看到定义出的产品各功能。

产品发布

在确认完成产品定义后，通过“发布”按钮，可以完成对产品的发布。