FleetControlIdConverter 1.2.0

Asset Id Converter

This is a library that can handle conversions of the unique ID of an asset from FleetControl.

Since FleetControl V2 only supports GUID's as an unique identifier for an asset, tables have been made in azure that have records to match the new asset ID's to their original counterparts.

It is possible to convert from the old ID (integer) to the new (GUID), and vice-versa.

Asset support

Currently this package supports the following IDs:

• Company
• Employee
• Trailer
• Vehicle

Usage example

Version 1.2.0 and up

Dependancy inject by using:

builder.Services.AddScoped<IFCAssetIdConverter, FCAssetIdConverter>();

Make sure the AzureStorageClient package has been updated to at least 1.3.0

Version 1.1.8 to 1.1.9

Dependancy inject by using:

builder.Services.AddScoped<IFCAssetIdConverter, FCAssetIdConverter>();

After this nothing else has to be added, make sure the AzureStorageClient package has been updated to at least version 1.2.0, and the storage environment for Production has been set up correctly

To use the converter you can use the following:

assetIdConverter.GetNewId(1, EntityType.Company) // Will try to search the new GUID value of the company

or

assetIdConverter.GetOldId(Guid.Parse("8102fc13-9fac-4bd8-132f-08daf273818c"), EntityType.Company) // Will try to search the old int value of the company

The supported entity types are:

• Company
• Employee
• Trailer
• Vehicle
• Activity

Version 1.1.3 and up

Dependancy inject by using:

builder.Services.AddScoped<IFCAssetIdConverter, FCAssetIdConverter>();

In your IServiceCollection configuration add the following:

Services.AddOptions<IdConverterConfiguration>().Configure<IConfiguration>((settings, configuration) =>
{
    configuration.GetSection("IdConverterConfiguration").Bind(settings);
});

then in your user secrets:

"IdConverterConfiguration": {
    "AccountName": "YOUR_ACCOUNT_NAME"
},

Version 1.1.2 and lower

! First make sure the AssetIdConverter is injected by dependancy injection, and you have the azure table service injected !

# returns the old company id
int oldCompanyId = await assetIdConverter.GetOldCompanyId(newCompanyGuid, azureTableService)

# returns the new company id
Guid newCompanyId = await assetIdConverter.GetNewCompanyId(oldCompanyId, azureTableService)

Running Tests

To be able to run the unit tests, make sure you have Azurite running on your PC, as it will use the local development environment.