public static async Task Lesson(DataServiceRestClient client)
{
await client.CreateParts(new[] { Part, SubPart });
await client.CreateCharacteristics(new[] { Characteristic, Child, SubChild });
//Depth null will result in a recursive search
var result = await client.GetCharacteristics(Part.Path, null);
Console.WriteLine($"Depth null: {result.Count()} characteristics");
//Depth 0 will return an empty list
result = await client.GetCharacteristics(Part.Path, 0);
Console.WriteLine($"Depth 0: {result.Count()} characteristics");
//Depth 1 will return the direct child characteristics
result = await client.GetCharacteristics(Part.Path, 1);
Console.WriteLine($"Depth 1: {result.Count()} characteristics");
//Depth 2 will return the direct children and their children, but not the children of subparts
result = await client.GetCharacteristics(Part.Path, 2);
Console.WriteLine($"Depth 2: {result.Count()} characteristics");
//Use UpdateParts and UpdateCharacteristics to rename entities, and modify their attributes
Part.Path = PathHelper.RoundtripString2PathInformation("P:/PartName2/");
await client.UpdateParts(new[] { Part });
}
public static InspectionPlanCharacteristicDto GetOrCreateCharacteristic(DataServiceRestClient client, string partName, string characteristicName, Dictionary <string, ushort> mapping, Dictionary <string, object> values)
{
var characteristics = client.GetCharacteristics(PathHelper.String2PartPathInformation(partName), 1).Result;
var attributes = values.Select(pair => new AttributeDto(mapping[pair.Key], pair.Value)).ToArray();
var existingCharacteristic = characteristics.FirstOrDefault(p => string.Equals(p.Path.Name, characteristicName));
if (existingCharacteristic == null)
{
existingCharacteristic = new InspectionPlanCharacteristicDto
{
Path = PathHelper.RoundtripString2PathInformation("PC:/" + partName + " / " + characteristicName + "/"),
Uuid = Guid.NewGuid(),
Attributes = attributes
};
client.CreateCharacteristics(new[]
{
existingCharacteristic
}).Wait();
}
else
{
existingCharacteristic.Attributes = attributes;
//maybe update the existing characteristic, so the attributes are up-to-date
client.UpdateCharacteristics(new[]
{
existingCharacteristic
}).Wait();
}
return(existingCharacteristic);
}
public static async Task Lesson(DataServiceRestClient client)
{
//Create the most commonly used attributes for measurement and measurement value
var configuration = await client.GetConfiguration();
if (configuration.GetDefinition(EntityDto.Measurement, MeasurementAttributeDefinition.Key) == null)
{
await client.CreateAttributeDefinition(EntityDto.Measurement, MeasurementAttributeDefinition);
}
if (configuration.GetDefinition(EntityDto.Value, ValueAttributeDefinition.Key) == null)
{
await client.CreateAttributeDefinition(EntityDto.Value, ValueAttributeDefinition);
}
//Every measurement is attached to a part, and every value is attached to a characteristic
await client.CreateParts(new[] { Part });
await client.CreateCharacteristics(new[] { Characteristic });
//The function 'CreateMeasurements' will create measurements without any values. You'll much more likely use the 'CreateMeasurementValues' function
await client.CreateMeasurementValues(new[] { Measurement });
Value.Value = new DataValueDto(0.0) //This will result in an unmeasured characteristic, because the attribute array doesn't contain K1
{
Attributes = new AttributeDto[] { }
};
await client.UpdateMeasurementValues(new[] { Measurement });
Value.Value = new DataValueDto //this will work!
{
Attributes = new[] { new AttributeDto(ValueAttributeDefinition.Key, 0.5) }
};
await client.UpdateMeasurementValues(new[] { Measurement });
var result = await client.GetMeasurementValues(
PathInformationDto.Root, // Part where to search measurements
new MeasurementValueFilterAttributesDto
{
AggregationMeasurements = AggregationMeasurementSelectionDto.All, // Decide how to include aggregated measurements in your query
CharacteristicsUuidList = null, // Use characteristic uuids to fetch single measurement values
Deep = true, // A deep search will find measurements recursively below the start path
FromModificationDate = null, // Will only search measurements with a modification date (LastModified) newer than the specified one
ToModificationDate = null, // Will only search measurements with a modification date (LastModified) older than the specified one
LimitResult = 10, // Will limit the number of returned measurements
MeasurementUuids = null, // Use measurement uuids to search for specific measurements
OrderBy = new[] // Order the returned measurements by specific attributes
{
new OrderDto(WellKnownKeys.Measurement.Time, OrderDirectionDto.Asc, EntityDto.Measurement)
},
RequestedMeasurementAttributes = null, // Specify, which measurement attributes should be returned (default: all)
RequestedValueAttributes = null, // Specify, which value attributes should be returned (default: all)
SearchCondition = new GenericSearchAttributeConditionDto // You can create more complex attribute conditions using the GenericSearchAnd, GenericSearchOr and GenericSearchNot class
{
Attribute = WellKnownKeys.Measurement.Time, //Only measurement attributes are supported
Operation = OperationDto.GreaterThan,
Value = XmlConvert.ToString(DateTime.UtcNow - TimeSpan.FromDays(2), XmlDateTimeSerializationMode.Utc)
}
});
foreach (var measurement in result)
{
Console.WriteLine(measurement.ToString());
}
}
