Monday for BizDoc

BizDoc extension for Monday enable interacting with BizDoc components embedded into Monday.com user interface:

Install

1. First, install Nuget:

dotnet add package BizDoc.Core.Monday

2. Create Monday app.

Add me.read, users.read, teams.read scopes. Set redirect uri to server.

Use ngrok for development.

3. Configure service in startup.cs

  AddBizDoc(...).AddMonday(options => {
    options.ApiKey = "api-key-here"; 
    options.BoardId = (context) => ...;
    options.GroupId = (context) => ...;
    options.ClientId = "client-id-here";
    options.ClientSecret = "client-secret-here";    
  }).
      UseIdentityProvider();
  ...
  UseBizDoc().
    UseMonday();

Replace the client-id, client-secret and api-key above with those of your Monday app.

If you wish to implement a custom Identity Provider, remove the UseIdentityProvider() call and register your provider with AddBizDoc().UseIdentityProvider().

4. Utilize MondayService service to create an Item in Monday.

public class MyForm : FormBase<MyFormModel> {
  private readonly MondayService _service;
  private readonly IDocumentContext _context;
  public MyForm(MondayService service, IDocumentContext context) {
    _service = service;
    _context = context;
  }
  public override Task CreateAsync(MyFormModel model) {
    _service.CreateItemAsync(_context.Document.Id, model.Subject);
  }
}

Call ChangeItemStauseAsync() and UpdateItemAsync() to to change state or add an update.

5. Install Angular library.

npm i @bizdoc/monday

app.module:

import { MondayModule } from '@bizdoc/monday';

 MondayModule.forRoot({
   clientId: 'client-id',
   components: [...]
})

Register your implementation components in forRoot() components as you would in BizDocModule.

Replace the implementation of app.component:

<bizdoc-monday></bizdoc-monday>

Style in angular.json:

  "styles": [
    "~@bizdoc/monday/assets/themes/light.min.css",
    "src/main.scss"
  ]

Monday App Features

Map Monday app features to BizDoc urls.

| Url | Purpose | -- | -- | /board | Folders and documents | /cube/{cube-name}/v/{view-name} | Cube | /item | BizDoc document of the active Monday item * | /report/{report-name} | Report | /widget/{widget-name} | Widget

• Item must have a bizdoc_id column that holds the document id.
• Items created by MondayService are set with BizDoc id.