Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/AllianceBioversityCIAT/alliance-research-indicators-client/llms.txt

Use this file to discover all available pages before exploring further.

Before you create a result, the system checks whether an equivalent record already exists across the CGIAR federated platforms — STAR, TIP, PRMS, and AICCRA. Understanding this duplicate-detection flow prevents fragmented reporting and keeps the result record canonical from the start.

Prerequisites

  • You must be signed in. Unauthenticated users cannot access the result-creation flow.
  • Your account must have at least the Researcher / Result Reporter role. Center Admins and MEL Regional Experts can also create results.
  • You need a clear indicator type in mind. Indicators are fixed by the Alliance framework; you cannot create a result outside the published indicator catalog.

Create a new result

1

Navigate to Load Result

In the left sidebar, select Results and then click Load Result, or navigate directly to /load-results.The page briefly shows a loading spinner while it resolves your session and then redirects you to the result-creation wizard.
2

Select an indicator type

Choose the indicator category that best matches your research result. The platform supports five indicator types:
  • Capacity Sharing
  • Innovation Development
  • Policy Change
  • OICR (Outcome Impact Case Report)
  • Innovation Use
Each indicator type unlocks a specific set of metadata tabs. The set of required fields varies by indicator.
3

Enter the result title

Provide a clear, informative title written for a non-specialist reader. Avoid acronyms, abbreviations, and technical jargon. The title limit is 30 words for most indicators and 15 words for OICR results.
Duplicate detection runs at this step. When you submit the new-result form, the API checks whether a record with the same platform code and official code already exists. If a collision is detected, the server returns a 409 Conflict response and the UI prompts you to link to the existing result instead of creating a duplicate.Choosing “link to existing” is the correct action — it preserves a single canonical record and satisfies the Alliance’s federated-reporting model. Creating a second record for the same research output will cause fragmented reporting and inflate result counts across platforms.
4

Confirm or link

  • If no duplicate is found, the result is created and you are redirected to /result/:id/general-information — the first metadata tab.
  • If a 409 conflict is returned, review the existing result displayed by the prompt. If it describes your research output, click Link to existing result to associate your work with that record instead.
5

Continue filling metadata

After the result is created, complete the tabbed metadata form. The left sidebar inside the result detail screen lists all 11 tabs with completion indicators — a green tick means the tab’s required fields are satisfied; an orange indicator means required fields are still missing.See Complete result metadata across 11 tabs for a description of every tab.

Controlled vocabularies and CLARISA

Every dropdown in the result-creation flow — institutions, countries, regions, SDGs, levers, impact areas, languages, delivery modalities — is sourced from CLARISA, the CGIAR canonical taxonomy service. Free-text entry is not available for these fields. This is intentional and enforced at the API level. Using CLARISA-controlled values ensures results are comparable across platforms and reportable to funders without manual reconciliation.
If you cannot find an institution, country, or other controlled-list value that you need, the correct resolution is to request an addition in CLARISA — not to approximate with a nearby value or enter free text. Contact your center’s MEL team to initiate a CLARISA update request.

Role-based visibility

The result you create is initially visible to:
  • You (the creator)
  • Users with the Center Admin role for your center
  • MEL Regional Experts with scope over your region
Other researchers at your center can see the result in the Results Center under All Results, but cannot edit it unless you are a principal investigator or main contact person who has granted edit access.

Next steps

Complete result metadata

Fill in all 11 metadata tabs — general information, partners, evidence, geographic scope, and more.

Submit for review

Learn the submission lifecycle and what happens after you submit a result for MEL review.

Build docs developers (and LLMs) love