资产列表

更新时间:2019-9-27

1. 获取资产列表

请求地址
GET /asset
参数说明
资产查询接口支持丰富的条件过滤参数,请参见支持的查询参数附录
返回结果
{
    "offset": 0,
    "total": 0,
    "results": [
        {
            "assetTypeCode": "10",
            "assetTypeName": "家具用具及其他类",
            "useCompanyCode": "01",
            "useCompanyName": "测试企业",
            "ownCompanyCode": "01",
            "ownCompanyName": "测试企业",
            "maintainerName": "张三",
            "extensionFields": [
                {
                    "name": "品牌",
                    "value": "苹果",
                    "fieldAreaType": 1
                },
                {
                    "name": "显示器",
                    "value": "15.6",
                    "fieldAreaType": 2
                }
            ],
            "repairStatus": 0,
            "reverting": false,
            "barcode": "10010001",
            "assetTypeId": 337209,
            "name": "椅子",
            "specs": "欧尼",
            "sn": "",
            "measureUnit": "个",
            "price": 66,
            "useCompanyId": 45448,
            "districtId": 47502,
            "address": "111",
            "supervisor": "郭尚德",
            "purchasedDate": "1564156800",
            "picturePath": "/UploadImage/6b736518-9325-43bc-a6b2-4d3d4704375a.jpg",
            "thumbnailPath": "/UploadImage/c7da9110-081e-497d-89b2-ae774c950f38.jpg",
            "comment": "",
            "createdDate": "1564196745",
            "createdBy": "46967",
            "state": 2,
            "serviceLife": 60,
            "supervisorId": 46967,
            "source": 1,
            "signatureStatus": 1,
            "signaturePicturePath": "/SignatureImage/48ef0a5f-cd0e-4e0e-a387-dc67f051a0b5.jpg",
            "deleted": false,
            "lastModifyDate": "1564156800",
            "vendor": "供应商1",
            "vendorName": "联系人1",
            "vendorContact": "联系方式1",
            "maintainer": 46967,
            "maintenanceExpiredDate": "1564934400",
            "maintenanceMemo": ""
        }
    ],
    "meta": {}
}
参数 说明
offset 当前结果对于首条结果的偏移量,指定分页查询时不为0
total 所有符合查询条件的查询结果数量,指定需要结果记录数量时不为0
results 符合查询条件的资产详情集合
meta 其他信息

附录

1. 支持的查询参数

如无特别说明,下列操作对于查询实体对象中的任意属性均适用。使用时只需将其追加至请求的querystring中即可。对实体对象中不存在的属性进行操作将会得到不可预期的结果。

  • 分页
    • skip={数字} 跳过指定条数的记录数
    • take={数字} 取出指定条数的记录数
    • include=total 需要返回记录总数
  • 排序
    • orderBy=[-]{属性名称},[-]{属性名称} 返回结果按指定属性排序,在名称前加”-“表示按倒序排序。多个属性的排序可使用逗号分隔。如:orderBy=-Id,Name,-Age
  • 条件过滤
    • 不等于
      • {属性名称}!={值} 如:Id!=1
    • 大于等于
      • >{属性名称}={值} 如:>Id=1
    • 大于
      • {属性名称}>={值} 如:Id>=1
    • 小于
      • <{属性名称}={值} 如:<Id=1
    • 小于等于
      • {属性名称}<={值} 如:Id<=1
    • In
      • {属性名称}In={值,值,值} 属性的值需包含在指定的集合中,如:IdIn=1,2,3
    • Between
      • {属性名称}Between={值,值} 属性的值需处于指定的区间之间,仅支持数字,如: IdBetween=1,3
    • 字符串包含指定字符
      • {属性名称}Contains={值} 如:nameContains=abc
    • 字符串以指定字符开头
      • {属性名称}StartsWith={值} 如:nameStartsWith=abc
    • 字符串以指定字符结尾
      • {属性名称}EndsWith={值} 如:nameEndsWith=abc
  • 自定义返回结果
    • 使用Fields参数来指定返回结果中需要的属性或字段名称 如:对于员工查询接口使用Fields=Id,employeeName,返回的员工集合结果中将仅包含此2个属性。

2. 数据实体格式

1. 资产数据对象格式
属性名称 说明
address 存放地点
addressTypeCode 区域编码
addressTypeId 区域Id
addressTypeName 区域名称
amount 金额
assetTypeCode 资产分类编码
assetTypeId 资产分类Id
assetTypeName 资产分类名称
assetSpecsId 标准资产型号Id
barcode 资产编码
createdBy 创建人
createdDate 创建日期
comment 备注
deleted 是否已报废,1:是、0:否
enterpriseId 所属企业Id
id 资产Id
includedInBill 是否被其他单据占用,空值表示没被占用
measureUnit 计量单位
name 资产名称
ownCompanyCode 所属公司编码
ownCompanyId 所属公司名称
ownCompanyName 所属公司名称
purchasedDate 购入时间
picturePath 图片路径
rfid Rfid
serviceLife 使用期限
signaturePicturePath 签字图片路径
signatureStatus 签字状态,0:待签字、1:已签字、2:已打回、"":空状态
source 来源
specs 规格型号
sn SN号
state 资产状态,1&6:在用、2:闲置、3:借用、4:报废、5:调拨中、7:维修中
supervisor 管理员
supervisorId 管理员Id
user 使用人
useCompanyCode 使用公司编码
useCompanyId 使用公司Id
useCompanyName 使用公司名称
useDepartmentCode 使用部门编码
useDepartmentId 使用部门Id
useDepartmentName 使用部门名称
userEmployeeNo 使用人编号
userEmployeeName 使用人姓名
userEmployeeId 使用人Id
thumbnailPath 资产图片的缩略图路径
vendor 供应商
vendorName 供应商联系人
vendorContact 供应商联系方式
maintainer 负责人Id
maintainerName 负责人名称
maintenanceExpiredDate 维保到期日期
maintenanceMemo 维保说明
lastModifyDate 最后一次修改时间
lastModifyUserId 最后一次修改人
extensionFields 自定义字段详情集合
自定义字段详情
属性名称 说明
fieldAreaType 自定义字段类型,1:公有属性、2:分类属性、3:私有属性
name 自定义字段名称
value 自定义字段值