Töövoo väljundid

Töövoo väljundid võimaldavad salvestada püsivaid väljundeid, paisutamata töövoo oleku põhiandmekoormat.

Need sobivad mustanddokumentidele, eraldatud JSON plaanidele, viidetele, lähtefailide manifestidele, loodud failiteedele ning viipade ja vastuste hetktõmmistele, mida soovid hiljem uurida. See on eriti kasulik agenditöövoogudes, kus lõplik olek peaks jääma väikeseks ja loetavaks, kuigi iga käivitus võib luua suuri vaheväljundeid.

Miks kasutada töövoo oleku asemel väljundeid

Töövoo olek sobib hästi väikeste avalike andmete jaoks, mida järgmine samm kohe vajab.

Väljundid sobivad paremini siis, kui väljund on tavapärastest olekuväärtustest suurem, mõeldud peamiselt hilisemaks uurimiseks, kasulik ülevaatuse või ekspordi vaadetes või lihtsalt sobib paremini nimega väljundiks kui üheks suureks olekuandmekogumiks.

Väljundi salvestamine praeguse töövoo sammu jaoks

Kui kood juba käivitub töövoo sammu sees, kasuta Queuety::put_current_artifact():

use Queuety\Queuety;
use Queuety\Step;

final class DraftBriefStep implements Step
{
    public function handle(array $state): array
    {
        $draft = [
            'title' => 'Pricing brief',
            'body' => '...',
        ];

        Queuety::put_current_artifact(
            'draft',
            $draft,
            'json',
            [ 'source' => 'planner' ],
        );

        return [ 'draft_ready' => true ];
    }

    public function config(): array
    {
        return [];
    }
}

Queuety lisab automaatselt praeguse töövoo ID ja sammu indeksi.

Väljundi salvestamine väljastpoolt töövoogu

Kui tead juba töövoo ID-d, kasuta Queuety::put_artifact():

Queuety::put_artifact(
    $workflow_id,
    'research_brief',
    "# Research Brief\n\nDone.",
    'markdown',
    metadata: [ 'reviewed_by' => 'editor@example.com' ],
);

Väljundite uuesti lugemine

$artifact = Queuety::workflow_artifact( $workflow_id, 'draft' );

$artifacts = Queuety::workflow_artifacts( $workflow_id );

Iga väljundikirje sisaldab välju key, kind, content, metadata, step_index, created_at ja updated_at. Queuety::workflow_artifacts() jätab content välja, kui sa ei edasta seda teise argumendina: true.

Töövoo oleku integreerimine

Queuety::workflow_status() sisaldab nüüd väikest väljundite kokkuvõtet:

$status = Queuety::workflow_status( $workflow_id );

echo $status->artifact_count; // 2
print_r( $status->artifact_keys ); // ['draft', 'citations']

Nii jäävad väljundid nähtavaks, ilma et nende kogu sisu lisataks olekuväljundisse.

CLI

Töövoo väljundite loendamine:

wp queuety workflow artifacts 42

Ühe väljundi kuvamine koos sisuga:

wp queuety workflow artifact 42 draft

Vaata täielikku käsuviidet: CLI

Eksportimine ja taasesitus

Väljundid lisatakse töövoo eksporti ja kopeeritakse taasesitatud töövoogudesse.

See tähendab, et väljundeid kasutavaid agendikäivitusi saab uurida ka siis, kui neid keskkondade vahel liigutada või käivitus eksporditud täitmisajaloo põhjal uuesti luua.