public async Task <TraceState <TState, TLinkData> > CancelTransferAsync <TLinkData>(TransferResponseInput <TLinkData> input)
{
// retrieve parent link
TransferResponseInput <TLinkData> headLinkInput = new TransferResponseInput <TLinkData>(input.TraceId, null);
TraceLink <TLinkData> parentLink = await this.GetHeadLinkAsync <TLinkData>(headLinkInput);
TLinkData data = input.Data;
SdkConfig sdkConfig = await this.GetConfigAsync();
String workflowId = sdkConfig.WorkflowId;
String configId = sdkConfig.ConfigId;
String accountId = sdkConfig.AccountId;
TraceLinkBuilderConfig <TLinkData> cfg = new TraceLinkBuilderConfig <TLinkData>()
{
// provide workflow id
WorkflowId = workflowId,
// and workflow config id
ConfigId = configId,
// and parent link to append to the existing trace
ParentLink = parentLink
};
// use a TraceLinkBuilder to create the first link
// only provide workflowId to initiate a new trace
TraceLinkBuilder <TLinkData> linkBuilder = new TraceLinkBuilder <TLinkData>(cfg);
linkBuilder // this is to cancel the transfer
.ForCancelTransfer(data)
// add creator info
.WithCreatedBy(accountId);
// call createLink helper
return(await this.CreateLinkAsync(linkBuilder));
}
/// <summary>
/// The NewTrace
/// </summary>
/// <typeparam name="TLinkData"></typeparam>
/// <param name="input">The input<see cref="NewTraceInput{TLinkData}"/></param>
/// <returns>The <see cref="Task{TraceState{TState, TLinkData}}"/></returns>
public async Task <TraceState <TState, TLinkData> > NewTraceAsync <TLinkData>(NewTraceInput <TLinkData> input)
{
//extract info from input
string actionKey = input.ActionKey;
TLinkData data = input.Data;
string groupLabel = input.GroupLabel;
SdkConfig sdkConfig = await this.GetConfigAsync();
string workflowId = sdkConfig.WorkflowId;
string configId = sdkConfig.ConfigId;
string accountId = sdkConfig.AccountId;
string groupId = sdkConfig.GetGroupId(groupLabel);
// upload files and transform data
await this.UploadFilesInLinkData(data);
TraceLinkBuilderConfig <TLinkData> cfg = new TraceLinkBuilderConfig <TLinkData>()
{
WorkflowId = workflowId,
// and workflow config id
ConfigId = configId,
};
// use a TraceLinkBuilder to create the first link
// only provide workflowId to initiate a new trace
TraceLinkBuilder <TLinkData> linkBuilder = new TraceLinkBuilder <TLinkData>(cfg);
// this is an attestation
linkBuilder.ForAttestation(actionKey, data).WithGroup(groupId).WithCreatedBy(accountId);
// call createLink helper
return(await this.CreateLinkAsync(linkBuilder));
}
/// <summary>
/// The PullTrace
/// </summary>
/// <typeparam name="TLinkData"></typeparam>
/// <param name="input">The input<see cref="PullTransferInput{TLinkData}"/></param>
/// <returns>The <see cref="Task{TraceState{TState, TLinkData}}"/></returns>
public async Task <TraceState <TState, TLinkData> > PullTraceAsync <TLinkData>(PullTransferInput <TLinkData> input)
{
// retrieve parent link
TransferResponseInput <TLinkData> headLinkInput = new TransferResponseInput <TLinkData>(input.TraceId, null);
TraceLink <TLinkData> parentLink = await this.GetHeadLinkAsync <TLinkData>(headLinkInput);
TLinkData data = input.Data;
SdkConfig sdkConfig = await this.GetConfigAsync();
string workflowId = sdkConfig.WorkflowId;
string userId = sdkConfig.UserId;
string groupId = sdkConfig.GroupId;
TraceLinkBuilderConfig <TLinkData> cfg = new TraceLinkBuilderConfig <TLinkData>()
{
// provide workflow id
WorkflowId = workflowId,
// and parent link to append to the existing trace
ParentLink = parentLink
};
// use a TraceLinkBuilder to create the first link
// only provide workflowId to initiate a new trace
TraceLinkBuilder <TLinkData> linkBuilder = new TraceLinkBuilder <TLinkData>(cfg);
// this is a push transfer
linkBuilder.ForPullTransfer(groupId, data).WithCreatedBy(userId);
// call createLink helper
return(await this.CreateLinkAsync(linkBuilder));
}
/// <summary>
/// The NewTrace
/// </summary>
/// <typeparam name="TLinkData"></typeparam>
/// <param name="input">The input<see cref="NewTraceInput{TLinkData}"/></param>
/// <returns>The <see cref="Task{TraceState{TState, TLinkData}}"/></returns>
public async Task <TraceState <TState, TLinkData> > NewTraceAsync <TLinkData>(NewTraceInput <TLinkData> input)
{
//extract info from input
string formId = input.FormId;
TLinkData data = input.Data;
SdkConfig sdkConfig = await this.GetConfigAsync();
string workflowId = sdkConfig.WorkflowId;
string userId = sdkConfig.UserId;
string ownerId = sdkConfig.OwnerId;
string groupId = sdkConfig.GroupId;
IDictionary <string, string> actionNames = sdkConfig.ActionNames;
// upload files and transform data
await this.UploadFilesInLinkData(data);
TraceLinkBuilderConfig <TLinkData> cfg = new TraceLinkBuilderConfig <TLinkData>()
{
WorkflowId = workflowId
};
// use a TraceLinkBuilder to create the first link
// only provide workflowId to initiate a new trace
TraceLinkBuilder <TLinkData> linkBuilder = new TraceLinkBuilder <TLinkData>(cfg);
var action = actionNames.ContainsKey(formId) ? actionNames[formId] : null;
// this is an attestation
linkBuilder.ForAttestation(formId, action, data).WithOwner(ownerId).WithGroup(groupId).WithCreatedBy(userId);
// call createLink helper
return(await this.CreateLinkAsync(linkBuilder));
}
/// <summary>
/// The AppendLink
/// </summary>
/// <typeparam name="TLinkData"></typeparam>
/// <param name="input">The input<see cref="AppendLinkInput{TLinkData}"/></param>
/// <returns>The <see cref="Task{TraceState{TState, TLinkData}}"/></returns>
public async Task <TraceState <TState, TLinkData> > AppendLinkAsync <TLinkData>(AppendLinkInput <TLinkData> input)
{
// retrieve parent link
TransferResponseInput <TLinkData> headLinkInput = new TransferResponseInput <TLinkData>(input.TraceId, null);
TraceLink <TLinkData> parentLink = await this.GetHeadLinkAsync <TLinkData>(headLinkInput);
//extract info from input
string actionKey = input.ActionKey;
TLinkData data = input.Data;
string groupLabel = input.GroupLabel;
SdkConfig sdkConfig = await this.GetConfigAsync();
string workflowId = sdkConfig.WorkflowId;
string configId = sdkConfig.ConfigId;
string accountId = sdkConfig.AccountId;
string groupId = sdkConfig.GetGroupId(groupLabel);
// upload files and transform data
await this.UploadFilesInLinkData(data);
TraceLinkBuilderConfig <TLinkData> cfg = new TraceLinkBuilderConfig <TLinkData>()
{
// provide workflow id
WorkflowId = workflowId,
// and workflow config id
ConfigId = configId,
// and parent link to append to the existing trace
ParentLink = parentLink
};
// use a TraceLinkBuilder to create the first link
// only provide workflowId to initiate a new trace
TraceLinkBuilder <TLinkData> linkBuilder = new TraceLinkBuilder <TLinkData>(cfg);
// this is an attestation
linkBuilder.ForAttestation(actionKey, data)
.WithGroup(groupId)
.WithCreatedBy(accountId);
// call createLink helper
return(await this.CreateLinkAsync(linkBuilder));
}
/// <summary>
/// The AppendLink
/// </summary>
/// <typeparam name="TLinkData"></typeparam>
/// <param name="input">The input<see cref="AppendLinkInput{TLinkData}"/></param>
/// <returns>The <see cref="Task{TraceState{TState, TLinkData}}"/></returns>
public async Task <TraceState <TState, TLinkData> > AppendLinkAsync <TLinkData>(AppendLinkInput <TLinkData> input)
{
// retrieve parent link
TransferResponseInput <TLinkData> headLinkInput = new TransferResponseInput <TLinkData>(input.TraceId, null);
TraceLink <TLinkData> parentLink = await this.GetHeadLinkAsync <TLinkData>(headLinkInput);
//extract info from input
string formId = input.FormId;
TLinkData data = input.Data;
SdkConfig sdkConfig = await this.GetConfigAsync();
string workflowId = sdkConfig.WorkflowId;
string userId = sdkConfig.UserId;
string ownerId = sdkConfig.OwnerId;
string groupId = sdkConfig.GroupId;
IDictionary <string, string> actionNames = sdkConfig.ActionNames;
// upload files and transform data
await this.UploadFilesInLinkData(data);
TraceLinkBuilderConfig <TLinkData> cfg = new TraceLinkBuilderConfig <TLinkData>()
{
// provide workflow id
WorkflowId = workflowId,
// and parent link to append to the existing trace
ParentLink = parentLink
};
// use a TraceLinkBuilder to create the first link
// only provide workflowId to initiate a new trace
TraceLinkBuilder <TLinkData> linkBuilder = new TraceLinkBuilder <TLinkData>(cfg);
// this is an attestation
linkBuilder.ForAttestation(formId, actionNames.ContainsKey(formId)?actionNames[formId]:null, data)
.WithOwner(ownerId)
.WithGroup(groupId)
.WithCreatedBy(userId);
// call createLink helper
return(await this.CreateLinkAsync(linkBuilder));
}
public async Task <TraceState <TState, TLinkData> > AcceptTransferAsync <TLinkData>(TransferResponseInput <TLinkData> input)
{
// retrieve parent link
TraceLink <TLinkData> parentLink = await this.GetHeadLinkAsync(input);
//extract info from input
TLinkData data = input.Data;
string groupLabel = input.GroupLabel;
SdkConfig sdkConfig = await this.GetConfigAsync();
String workflowId = sdkConfig.WorkflowId;
string configId = sdkConfig.ConfigId;
String accountId = sdkConfig.AccountId;
String groupId = sdkConfig.GetGroupId(groupLabel);
TraceLinkBuilderConfig <TLinkData> cfg = new TraceLinkBuilderConfig <TLinkData>()
{
// provide workflow id
WorkflowId = workflowId,
// and workflow config id
ConfigId = configId,
// and parent link to append to the existing trace
ParentLink = parentLink
};
// use a TraceLinkBuilder to create the first link
// only provide workflowId to initiate a new trace
TraceLinkBuilder <TLinkData> linkBuilder = new TraceLinkBuilder <TLinkData>(cfg);
// this is an attestation
linkBuilder.ForAcceptTransfer(data)
// add group info
.WithGroup(groupId)
// add creator info
.WithCreatedBy(accountId);
// call createLink helper
return(await CreateLinkAsync(linkBuilder));
}
/// <summary>
/// Creates a new Link from the given builder, signs it and executes the GraphQL
/// mutation.
/// </summary>
/// <typeparam name="TLinkData"></typeparam>
/// <param name="linkBuilder">The linkBuilder<see cref="TraceLinkBuilder{TLinkData}"/></param>
/// <param name="firstTry">if this is not the first try, do not retry</param>
/// <returns>The <see cref="Task{TraceState{TState, TLinkData}}"/></returns>
private async Task <TraceState <TState, TLinkData> > CreateLinkAsync <TLinkData>(TraceLinkBuilder <TLinkData> linkBuilder, bool firstTry = true)
{
// extract signing key from config
SdkConfig sdkConfig = await GetConfigAsync();
Ed25519PrivateKeyParameters signingPrivateKey = sdkConfig.SigningPrivateKey;
// build the link
TraceLink <TLinkData> link = linkBuilder.Build();
// sign the link
link.Sign(signingPrivateKey.GetEncoded(), "[version,data,meta]");
string linkObjJson = JsonHelper.ToJson(link.ALink);
Dictionary <string, object> linkObj = JsonHelper.ObjectToMap(link.GetLink());
Dictionary <string, object> dataObj = JsonHelper.ObjectToMap(((TraceLink <TLinkData>)link).FormData());
Dictionary <string, object> variables = new Dictionary <string, object>
{
["link"] = linkObj,
["data"] = dataObj
};
try
{
// execute graphql query
GraphQLResponse <dynamic> jsonResponse = await this.client.GraphqlAsync(GraphQL.MUTATION_CREATELINK, variables, null, null);
var trace = jsonResponse.Data.createLink.trace;
return(this.MakeTraceState <TLinkData>(trace));
}
catch (TraceSdkException e)
{
if (firstTry && e.Message == ERROR_CONFIG_DEPRECATED)
{
var cfg = await this.GetConfigAsync(true);
linkBuilder.WithConfigId(cfg.ConfigId);
link.GetLink().Signatures.Clear();
return(await this.CreateLinkAsync(linkBuilder, false));
}
throw e;
}
}
/// <summary>
/// Creates a new Link from the given builder, signs it and executes the GraphQL
/// mutation.
/// </summary>
/// <typeparam name="TLinkData"></typeparam>
/// <param name="linkBuilder">The linkBuilder<see cref="TraceLinkBuilder{TLinkData}"/></param>
/// <returns>The <see cref="Task{TraceState{TState, TLinkData}}"/></returns>
private async Task <TraceState <TState, TLinkData> > CreateLinkAsync <TLinkData>(TraceLinkBuilder <TLinkData> linkBuilder)
{
// extract signing key from config
SdkConfig sdkConfig = await GetConfigAsync();
Ed25519PrivateKeyParameters signingPrivateKey = sdkConfig.SigningPrivateKey;
// build the link
TraceLink <TLinkData> link = linkBuilder.Build();
// sign the link
link.Sign(signingPrivateKey.GetEncoded(), "[version,data,meta]");
string linkObjJson = JsonHelper.ToJson(link.ALink);
Dictionary <string, object> linkObj = JsonHelper.ObjectToMap(link.GetLink());
Dictionary <string, object> dataObj = JsonHelper.ObjectToMap(((TraceLink <TLinkData>)link).FormData());
Dictionary <string, object> variables = new Dictionary <string, object>
{
["link"] = linkObj,
["data"] = dataObj
};
// Debug.WriteLine("Request : " + JsonHelper.ToJson(dataObj));
// execute graphql query
GraphQLResponse jsonResponse = await this.client.GraphqlAsync(GraphQL.MUTATION_CREATELINK, variables, null, null);
var trace = jsonResponse.Data.createLink.trace;
return(this.MakeTraceState <TLinkData>(trace));
}
