MSzubert/KanBo.Clientv3.0.4

Namepsaces

KanBo.Client - Main namespace containg all helpers for creating tokens and calling api KanBo.Api - Namespace containg all api methods and data structures .GetData - methods that return kanbo data .Action - methods that make some actions in kanbo .Data - kanbo data types used for varoius calls nad responses

General properties required for creating kanbo token and requester

string kanboCertificatePath = @"F:\Certs\SomeGeneratedCertificate.pfx"; string kanboCertificatePassword = @"$#testPassWord123#$"; or string thumbprint = "06 ac 19 8c 89 c3 f7 cb bd 9d 49 f8 64 15 42 2a ea 15 da 5e".Replace(" ", ""); string kanboUrl = @"https://somekanbo.azurewebsites.net"; string kanboCertificateIssuer = "kanbo-client";

Token properties

Properties required for creating user impersonating token

int kanboUserId = 1; // Id of a user that will be impersonated string kanboUserLogin = "t.name@somesp.onmicrosoft.com"; // Login of a user that will be impersonated string kanboLoginType = "upn-graph"; // Login type - used only in .AsLogin() operation

Available types:

.AsService() - service token .AsServiceWithEmail("name@test.onmicrosoft.com") - service token with email impersonation .AsKanBoUserId(kanboUserId) - user token .AsLogin(kanboUserLogin, kanboLoginType) - login token .AsEmail("name@test.onmicrosoft.com") - email token //AsLogin has build in wrappers showed below .AsSpOnpremLogin("i:0#.w|domain/login") .AsSpOnlineLogin("i:0#.f|membership|login@domain.onmicrosoft.com") .AsSpOnlineUpn("name@test.onmicrosoft.com") .AsO365UserId("2980b5dc-6c76-4867-9808-7fd00ae234c4") .AsO365Upn("name@test.onmicrosoft.com") //AsEmail has build in wrapper showed below .AsServiceWithEmail("name@test.onmicrosoft.com")

Extra Token options

.WithAuthRoles(string[] roles) - adding roles for token

Create certificate object

Example 1

var kanboCertificate = new X509Certificate2(kanboCertificatePath, kanboCertificatePassword);

Example 2

var thumbprint = "06 ac 19 8c 89 c3 f7 cb bd 9d 49 f8 64 15 42 2a ea 15 da 5e".Replace(" ", ""); using var store = new X509Store(StoreName.My, StoreLocation.LocalMachine); store.Open(OpenFlags.ReadOnly); var certificates = store.Certificates.Find(X509FindType.FindByThumbprint, thumbprint, false);

Creating requester

var req = ApiBuilder.New.WithJsonApi(kanboUrl).WithIssuer(kanboCertificateIssuer) .WithRsaSignature(kanboCertificate).AsService().Build();

Calling api

Task.Run(async () => { /* Get board with Id=1 */ var board = await req.GetData(new KanBo.Api.GetData.Board {Id = 1}); }).Wait();

Using Rich text editor

//Each line of text is equal to new rich text block var rtEd = new KanBo.Client.Helpers.RTEditor(); RichText rt = rtEd .CreateTextBlock("Some Text").CreateBold(0,4) //line of text in which 'Some' is bold .CreateCheckedItemBlock("Done item").CreateBold(0,4).GetRichText() //in new line add checked item with 'Done' bold .CreateEmptyLine() //create an empty line .CreateTextBlock("Some Text").CreateItalic(5,4) //new line with text in wich 'Text' is italic .GetRichText();

Using Config Manager to generate json config for KanBo

var cm = new ConfigManager() .SetIssuer("ui-path-actions-cert") .AddCertFromFile(kanboConfigCertificatePath) .AddServiceMapper("UiPathservice", new string[2] {"service","external-services"}) .AddUserMapper() .AddEmailMapper(new string[1] {"external-services"}) .AddLoginMapper(new string[1] {"*"}) .GetJsonConfig();