CrowdIn Query Language (CroQL) er et værktøj til Enterprise-API’en, der muliggør at hente nødvendige lokaliseringsressourcer fra Enterprise baseret på bestemte forhold. Vha. CroQL kan kildestrenge og deres oversættelser filtreres ift. et bestemt målsprog.
CroQL-hovedoperatorer er anført nedenfor. Benyt og kombinér dem for at sætte specifikke betingelser for at hente krævet indhold fra Enterprise. Elementerne fra tabellerne nedenfor kan bruges til at danne CroQL-forespørgslen.
De aritmetiske operatorer bruges til at udføre matematiske operationer med enhver numeriske datatype.
Navn | Symbol | Eksempel |
---|---|---|
Addition | + | 1 + 9 |
Subtraktion | - | 11 - 1 |
Division | / | 20 / 2 |
Multiplikation | * | 2 * 5 |
Negation | - | -10 |
Sammenligningsoperatorer bruges til at sammenligne værdier og returnere true
eller false
.
Navn | Symbol | Aliaser | Eksempel |
---|---|---|---|
Mellem | {{expression}} mellem {{expression}} og {{expression}} | 5 mellem 1 og 10 | |
Lig med | = | 10 = 10 | |
Ikke lig med | != | ≠ | 1 != 10; 1 ≠ 10 |
Større end | > | 10 > 1 | |
Større end eller lig med | >= | ≥ | 10 >= 1; 10 ≥ 1 |
Mindre end | < | 1 < 10 | |
Mindre end eller lig med | <= | ≤ | 1 <= 10; 1 ≤ 10; |
Logiske operatører bruges til at kombinere flere booleske udtryk/værdier og give et enkelt boolesk output.
Navn | Symbol | Eksempel |
---|---|---|
Og | og | 1 < 10 and 10 > 1 |
Eller | eller | 1 < 10 or 10 > 1 |
Xor | xor | 1 < 10 xor 10 > 1 |
Ikke | ikke | not 1 < 10 |
Filtreringsoperatorer anvendes til at filtrere objekter baseret på den angivne tilstand.
Navn | Symbol | Eksempel |
---|---|---|
Filter | {{collection}} where {{predicate}} | translations where (count of votes > 0) |
Match | {{object}} med {{predicate}} | bruger med (login = "crowdin") |
Den ternære operator bruges til at tjekke en betingelse angivet i den første værdi, og er denne true
, returneres den anden værdi. Er den imidlertid false
, returneres den tredje værdi.
Navn | Symbol | Eksempel |
---|---|---|
Ternær | If {{condition}} then {{expression}} else {{expression}} | If 1 < 10 then "less" else "greater" |
Hent-operatører bruges til at hente data fra objekterne.
Navn | Symbol | Eksempel |
---|---|---|
Nævn | @user:{{string}}; @language:{{string}} | @user:"crowdin"; @language:"en" |
Medlem | {{member}} of {{object}} | antal af oversættelser |
Identifikator | {{identifier}} | text; identifier |
Skalaroperatorer bruges til at erklære værdier til videre behandling.
Navn | Symbol | Eksempel |
---|---|---|
Integer | {{integer}} | 10 |
Flydende | {{float}} | 10.01 |
Streng | {{string}} | “crowdin" |
Datotid | {{datetime}} | 'i dag'; '2021-03-16 00:00:00' |
Gruppeoperatorer bruges til at fastlægge operatorers eksekveringssrækkefølge.
Navn | Symbol | Eksempel |
---|---|---|
Gruppér | ( ) | 1 < 10 and (20 > 10 or 10 > 5) |
count of translations where ( language = @language:"uk" and ( count of approvals > 0 or count of votes > 0 ) ) = 0
Brug forespørgslen i flg. slutpunkt:
{projectId} | Type: Beskrivelse: Numerisk identifikator for ens Enterprise-projekt. |
{croql} | Type: Beskrivelse: CroQL-udtryk. |
crowdin-brugernavn
eller med ≥ 100 upvotes, kan forespørgslen se således ud:user = @user:"crowdin" or count of votes where ( is up ) >= 100
Brug forespørgslen i flg. slutpunkt:
{projectId} | Type: Beskrivelse: Numerisk identifikator for ens Enterprise-projekt. |
{croql} | Type: Beskrivelse: CroQL-udtryk. |
CroQL kan bruges i kildestrengs- og oversættelseskontekster. Brug flg. eks. som udgangspunkter ved udformning af CroQL-forespørgsler.
{
"type is plain": true,
"type is plural": false,
"type is icu": false,
"type is asset": false,
"text": "Quick Start",
"identifier": "quick_start",
"context": "quick_start",
"is visible": true,
"is hidden": false,
"comments": [
{
"has issue": false,
"has unresolved issue": false
}
],
"screenshots": [],
"translations": [
{
"text": "Швидкий старт",
"plural form": "none",
"provider is tm": false,
"provider is mt": true,
"language": 52,
"user": 1,
"votes": [
{
"is up": true,
"is down": false,
"user": 2,
"added": "2021-04-09 13:44:14"
}
],
"approvals": [
{
"user": 2,
"added": "2021-04-09 13:44:14"
}
],
"updated": "2021-04-09 10:23:17"
}
],
"added": "2021-04-08 12:33:27",
"updated": "2021-04-08 12:33:27"
}
type is plain | Type: Beskrivelse: Kildestreng med almindelig tekst. |
type is plural | Type: Beskrivelse: Kildestreng med flertalsformer. |
type is icu | Type: Beskrivelse: Kildestreng med ICU. |
type is asset | Type: Beskrivelse: Kildestreng er et aktiv. |
text | Type: Beskrivelse: Kildestrengstekst. |
identifier | Type: Beskrivelse: Kildestrengidentifikator (nøgle). |
context | Type: Beskrivelse: Kildestrengskontekst. |
is visible | Type: Beskrivelse: Kildestreng er synlig. |
is hidden | Type: Beskrivelse: Kildestreng er skjult. |
comments | Type: Beskrivelse: Kildestrengskommentarer. |
has issue | Type: Beskrivelse: Kildestreng med en problematik. |
has unresolved issue | Type: Beskrivelse: Kildestreng med en uløst problematik. |
screenshots | Type: Beskrivelse: Kildestrengsskærmfotos. |
translations | Type: Oversættelse Kildestrengsoversættelse. |
text | Type: Beskrivelse: Oversættelsestekst. |
plural form | Type: Beskrivelse: Oversættelse i flertalsform. |
provider is tm | Type: Beskrivelse: Oversættelse leveret via Oversættelseshukommelse. |
provider is mt | Type: Beskrivelse: Oversættelse leveret via Maskinoversættelsesmotor. |
language | Type: Beskrivelse: Numerisk identifikator for målsproget. |
user | Type: Beskrivelse: Numerisk identifikator på brugeren, der tilføjede en oversættelse. |
votes | Type: Beskrivelse: Rækken af stemmerne tilføjet oversættelsen. |
is up | Type: Beskrivelse: Upvote. |
is down | Type: Beskrivelse: Downvote. |
user | Type: Beskrivelse: Numerisk identifikator på brugeren, der stemte på en oversættelse. |
added | Type: Beskrivelse: Dato for, hvornår der blev stemt på en oversættelse. |
approvals | Type: Beskrivelse: Rækken af de tilføjede oversættelsesgodkendelser. |
user | Type: Beskrivelse: Numerisk identifikator på brugeren, der godkendte en oversættelse. |
added | Type: Beskrivelse: Dato for, hvornår en oversættelse blev godkendt. |
updated | Type: Beskrivelse: Dato for, hvornår en oversættelse blev opdateret. |
added | Type: Beskrivelse: Dato for, hvornår en kildestreng blev tilføjet. |
updated | Type: Beskrivelse: Dato for, hvornår en kildestreng blev opdateret. |
{
"text": "Швидкий старт",
"plural form": "none",
"provider is tm": false,
"provider is mt": true,
"user": 1,
"votes": [
{
"is up": true,
"is down": false,
"user": 2,
"added": "2021-04-09 13:44:14"
}
],
"approvals": [
{
"user": 2,
"added": "2021-04-09 13:44:14"
}
],
"updated": "2021-04-09 10:23:17"
}
text | Type: Beskrivelse: Oversættelsestekst. |
plural form | Type: Beskrivelse: Oversættelse i flertalsform. |
provider is tm | Type: Beskrivelse: Oversættelse leveret via Oversættelseshukommelse. |
provider is mt | Type: Beskrivelse: Oversættelse leveret via Maskinoversættelsesmotor. |
user | Type: Beskrivelse: Numerisk identifikator på brugeren, der tilføjede en oversættelse. |
votes | Type: Beskrivelse: Rækken af stemmerne tilføjet oversættelsen. |
is up | Type: Beskrivelse: Upvote. |
is down | Type: Beskrivelse: Downvote. |
user | Type: Beskrivelse: Numerisk identifikator på brugeren, der stemte på en oversættelse. |
added | Type: Beskrivelse: Dato for, hvornår der blev stemt på en oversættelse. |
approvals | Type: Beskrivelse: Rækken af de tilføjede oversættelsesgodkendelser. |
user | Type: Beskrivelse: Numerisk identifikator på brugeren, der godkendte en oversættelse. |
added | Type: Beskrivelse: Dato for, hvornår en oversættelse blev godkendt. |
updated | Type: Beskrivelse: Dato for, hvornår en oversættelse blev opdateret. |