Fluxuri de lucru

​

Definiți un flux de lucru

import {
  defineWorkflow,
  STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
} from 'twenty-sdk/define';

const COMPANY = STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.universalIdentifier;
const SCORE_COMPANY_FUNCTION = '0f6c0b3e-8a4f-4f0e-9d0a-3c1e5b7a2d41';

const SCORE_NEW_COMPANIES = {
  workflow: 'c2a4e6f8-1b3d-4f5a-8c7e-9d0b2a4c6e81',
  trigger: 'c2a4e6f8-1b3d-4f5a-8c7e-9d0b2a4c6e82',
  score: 'c2a4e6f8-1b3d-4f5a-8c7e-9d0b2a4c6e83',
  save: 'c2a4e6f8-1b3d-4f5a-8c7e-9d0b2a4c6e84',
};

export default defineWorkflow({
  universalIdentifier: SCORE_NEW_COMPANIES.workflow,
  name: 'Score new companies',
  version: {
    trigger: {
      universalIdentifier: SCORE_NEW_COMPANIES.trigger,
      type: 'DATABASE_EVENT',
      settings: {
        objectUniversalIdentifier: COMPANY,
        action: 'created',
      },
      nextStepIds: [SCORE_NEW_COMPANIES.score],
    },
    steps: [
      {
        universalIdentifier: SCORE_NEW_COMPANIES.score,
        name: 'Score the company',
        type: 'LOGIC_FUNCTION',
        logicFunctionUniversalIdentifier: SCORE_COMPANY_FUNCTION,
        input: { companyName: '{{trigger.properties.after.name}}' },
        nextStepIds: [SCORE_NEW_COMPANIES.save],
      },
      {
        universalIdentifier: SCORE_NEW_COMPANIES.save,
        name: 'Save the score',
        type: 'UPDATE_RECORD',
        input: {
          objectUniversalIdentifier: COMPANY,
          objectRecordId: '{{trigger.recordId}}',
          objectRecord: { leadScore: `{{${SCORE_NEW_COMPANIES.score}.score}}` },
          fieldsToUpdate: ['leadScore'],
        },
        nextStepIds: [],
      },
    ],
  },
});

• Fluxul de lucru, declanșatorul său și fiecare pas au nevoie de propriul universalIdentifier. Păstrați-le stabile între versiuni: astfel Twenty identifică fluxul de lucru instalat la următoarea instalare.
• nextStepIds conectează graful. Declanșatorul indică spre primii pași, iar fiecare pas indică spre pașii care se execută după acesta.
• Un pas citește rezultatul anterior cu {{trigger.\<path>}} sau {{\<step universalIdentifier>.\<path>}}.
• Compilarea validează întreaga definiție: tipurile de declanșatoare sau pași neacceptate, legăturile de pași defecte și referințele la pași necunoscuți o fac să eșueze.

​

Referirea la alte entități

• Obiecte și câmpuri: cele proprii ale aplicației sau cele standard prin STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS. Exemplul de mai sus presupune că aplicația definește și un câmp numeric leadScore în Companie cu defineField(): un pas de înregistrare care scrie într-un câmp lipsă din spațiul de lucru face instalarea să eșueze.
• Funcții logice: cele proprii ale aplicației, expuse ca acțiune de flux de lucru cu workflowActionTriggerSettings. Aplicația personalizată a spațiului de lucru poate, de asemenea, să facă referire la acțiunile fluxurilor de lucru ale celorlalte aplicații instalate în spațiul de lucru, la fel cum pot fluxurile de lucru create în aplicație.
• Agenți: cei proprii ai aplicației, din defineAgent().

​

Declanșatoare

​

Pași

• Pașii de înregistrare folosesc objectUniversalIdentifier în locul numelui obiectului.
• Filtrele și sortările indică spre câmpuri cu fieldMetadataUniversalIdentifier.
• Câmpurile de formular de tip RECORD își denumesc obiectul cu settings.objectUniversalIdentifier. Câmpurile de tip SELECT și MULTI_SELECT oferă opțiunile unui câmp existent de același tip, denumit cu settings.selectedFieldUniversalIdentifier.
• Pentru a executa propriul cod, utilizați un pas LOGIC_FUNCTION. Pasul Code al generatorului nu este disponibil.
• Pașii de e-mail și calendar rulează numai dacă rolul aplicației dvs. are indicatorul de permisiune corespunzător: SystemPermissionFlag.SEND_EMAIL_TOOL pentru SEND_EMAIL și DRAFT_EMAIL, SystemPermissionFlag.CREATE_CALENDAR_EVENT_TOOL pentru CREATE_CALENDAR_EVENT. Spațiul de lucru o acordă prin instalarea aplicației, iar pasul poate utiliza apoi orice cont conectat din spațiul de lucru, asemenea unui flux de lucru creat în aplicație.
• id-urile conturilor conectate sunt locale pentru fiecare spațiu de lucru, deci nu includeți unul direct în cod. Transmite contul ca variabilă. Pașii de e-mail acceptă, de asemenea, un ID de membru al spațiului de lucru, cum ar fi {{trigger.properties.after.assigneeId}}, care se rezolvă la primul cont al acelui membru care poate trimite.

​

După instalare

• Fluxul de lucru devine activ imediat ce aplicația este instalată, iar execuțiile sale apar împreună cu celelalte execuții de fluxuri de lucru ale spațiului de lucru.
• Instalarea unei versiuni noi a aplicației actualizează fluxul de lucru pe loc.
• Utilizatorii nu pot edita un flux de lucru instalat. Pentru a personaliza unul, îl duplică: copia le aparține pentru editare.