Berreskuratu arauen zerrenda

Artikulua
10/16/2024

Arauak erregelen bidez elkartzen dira. Arau bat ez da inolako arauetan edo erregeletan egon. Erabili a GET eskaera eskuragarri dauden arau guztien zerrenda bat lortzeko, arau-arau batean edo erregeletara API deituz [Geographical URI]/api/rule. API honetara deitzeko zenbait aldakuntza daude. Hala ere, erabilera arruntena arau jakin baterako arauen zerrenda berreskuratzea da.

Oharra

API honek OAuth token bat behar du.

Goiburuak

Eman izena	Idatzi	Esperotako balioa	Beharrezkoa?
Onartu-Hizkuntza	katea	Hizkuntza-kodea (adibidez, en-US). Balio lehenetsia en-US da.	ez

Parametroak

Eman izena	Idatzi	Esperotako balioa	Beharrezkoa?
araua	katea	Arau-multzoaren izena edo ID-a edo arau-multzoaren IDen zerrenda, edo komaz edo puntu eta komaz bereizitako izenak (adibidez, "Solution Checker").	ez
includeMessageFormats	boolearra	Ezarrita dagoenean `true`, eskuragarri dauden mezuen aldaera posibleen zerrenda jasotzen da. Zerrenda hau erabilgarria da hainbat hizkuntzatara itzultzeko. Behar ez bada, ez eman parametro hau edo eman `false` balioa, parametro honek erantzun-ren tamaina handitzen duelako eta prozesatzeko denbora handitu dezakeelako.	ez

Espero diren erantzunak

HTTP egoera-kodea	Egoera	Result
200	Emaitza bat edo gehiago aurkitu dira	Ikusi adibidea artikulu honetan geroago. Emaitza bat edo gehiago itzul daitezke.
204	Ez da aurkitu emaitzarik	Ez da emaitzarik erantzun-gorputzean.
401	Ezin izan da autentifikatu	Ez da emaitzarik erantzun-gorputzean.

Espero diren erantzunen gorputza

Hurrengo taulan, eskaera bakoitzaren erantzunaren egitura azaltzen da (HTTP 200 erantzuna soilik).

Propietatea	Mota	Esperotako balioa	Beharrezkoa?
kodea	katea	Arauaren identifikatzailea, batzuetan Arauaren IDa aipatzen da.	Yes
laburpena	katea	Arauaren laburpena.	Yes
azalpena	katea	Arauaren deskribapenaren xehetasun gehiago.	Yes
guidanceUrl	URIa	Argitaratutako gidaliburua aurkitzeko URLa. Zenbait kasutan egon daitezke laguntza-gida-artikulu berezirik ez dagoenean.	Yes
sartu	boolearra	Araua azter dezaketen zerbitzurako seinaleak. Balio hau `true` API honetarako da.	No
messageTemplates	matriza	Jabetza-balioa sartzen denean bakarrik sartzen da `includeMessageFormats` dago `true`.	Ez
messageTemplates.ruleId	katea	IDaren balio bera itzultzen du `code` Jabetza.	Yes
messageTemplates.messageTemplateId	katea	Analisi estatikoaren emaitzak elkartrukatzeko formatuan (SARIF) txostena erabiltzen duen identifikatzaile bat, arauarentzako mezuen aldakuntzaren seinaleztatzeko.	Yes
messageTemplates.messageTemplate	katea	Arauak jakinarazten duen arazo-agertokiaren mezuaren aldakuntzaren testua. Testu hau formatu-kate bat da, eta SARIF txostenean emandako argumentuak mezu zehatz bat eraikitzeko erabil daitezkeen tokenak izan ditzake.	Yes

Adibidea: berreskuratu arau bateko arauak beste hizkuntza batean

Adibide honek arauko arau guztien datuak itzultzen ditu Irtenbide egiaztatzailea arauak frantses hizkuntzan. Nahi duzun hizkuntza ingelesa bada, kendu, besterik gabe, Accept-Language goiburua.

Eskaera

GET [Geographical URI]/api/rule?ruleset=083A2EF5-7E0E-4754-9D88-9455142DC08B&api-version=2.0
x-ms-correlation-id: 9E378E56-6F35-41E9-BF8B-C0CC88E2B832
Accept: application/json
Content-Type: application/json; charset=utf-8
Accept-Language: fr

erantzun

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

[
    {
        "description": "Ne pas implémenter d’activités de workflow Microsoft Dynamics CRM 4.0",
        "guidanceUrl": "https://go.microsoft.com/fwlink/?LinkID=398563&error=il-avoid-crm4-wf&client=PAChecker",
        "include": true,
        "code": "il-avoid-crm4-wf",
        "summary": "Ne pas implémenter d’activités de workflow Microsoft Dynamics CRM 4.0",
        "howToFix": {
            "summary": ""
        }
    },
    {
        "description": "Utiliser InvalidPluginExecutionException dans des plug-ins et activités de workflow",
        "guidanceUrl": "https://go.microsoft.com/fwlink/?LinkID=398563&error=il-use-standard-exception&client=PAChecker",
        "include": true,
        "code": "il-use-standard-exception",
        "summary": "Utiliser InvalidPluginExecutionException dans des plug-ins et activités de workflow",
        "howToFix": {
            "summary": ""
        }
    },
...
]

Adibidea: berreskuratu guztia

Adibide honek eskuragarri dauden arau guztien datuak itzultzen ditu.

Eskaera

GET [Geographical URI]/api/rule?api-version=2.0
Accept: application/json
Content-Type: application/json; charset=utf-8

erantzun

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

[
    {
        "description": "Retrieve specific columns for an entity via query APIs",
        "guidanceUrl": "https://go.microsoft.com/fwlink/?LinkID=398563&error=il-specify-column&client=PAChecker",
        "include": true,
        "code": "il-specify-column",
        "summary": "Retrieve specific columns for an entity via query APIs",
        "howToFix": {
            "summary": ""
        }
    },
    {
        "description": "Do not duplicate plug-in step registration",
        "guidanceUrl": "https://go.microsoft.com/fwlink/?LinkID=398563&error=meta-remove-dup-reg&client=PAChecker",
        "include": true,
        "code": "meta-remove-dup-reg",
        "summary": "Do not duplicate plug-in step registration",
        "howToFix": {
            "summary": ""
        }
    },
...
]

Adibidea: berreskuratu arau bat mezuen formatuekin

Adibide honek arauko arau guztien datuak itzultzen ditu Irtenbide egiaztatzailea arauak frantses hizkuntzan. Nahi duzun hizkuntza ingelesa bada, kendu, besterik gabe, Accept-Language goiburua.

Eskaera

GET [Geographical URI]/api/rule?ruleset=083A2EF5-7E0E-4754-9D88-9455142DC08B&includeMessageFormats=true&api-version=2.0
Accept: application/json
Content-Type: application/json; charset=utf-8

erantzun

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

[
    {
        "description": "Do not implement Microsoft Dynamics CRM 4.0 workflow activities",
        "guidanceUrl": "https://go.microsoft.com/fwlink/?LinkID=398563&error=il-avoid-crm4-wf&client=PAChecker",
        "include": true,
        "code": "il-avoid-crm4-wf",
        "summary": "Do not implement Microsoft Dynamics CRM 4.0 workflow activities",
        "howToFix": {
            "summary": ""
        },
        "messageTemplates": [
            {
                "ruleId": "il-avoid-crm4-wf",
                "messageTemplateId": "message1",
                "messageTemplate": "Update the {0} class to derive from System.Workflow.Activities.CodeActivity, refactor Execute method implementation, and remove Microsoft.Crm.Workflow.CrmWorkflowActivityAttribute from type"
            },
            {
                "ruleId": "il-avoid-crm4-wf",
                "messageTemplateId": "message2",
                "messageTemplate": "Change the {0} property's type from {1} to {2} Argument &lt;T&gt; type"
            },
            {
                "ruleId": "il-avoid-crm4-wf",
                "messageTemplateId": "message3",
                "messageTemplate": "Replace the Microsoft.Crm.Workflow.Crm{0}Attribute with Microsoft.Xrm.Sdk.Workflow.{0}Attribute"
            },
            {
                "ruleId": "il-avoid-crm4-wf",
                "messageTemplateId": "message4",
                "messageTemplate": "Remove the {0} System.Workflow.ComponentModel.DependencyProperty type field"
            }
        ]
    },
    {
        "description": "Use InvalidPluginExecutionException in plug-ins and workflow activities",
        "guidanceUrl": "https://go.microsoft.com/fwlink/?LinkID=398563&error=il-use-standard-exception&client=PAChecker",
        "include": true,
        "code": "il-use-standard-exception",
        "summary": "Use InvalidPluginExecutionException in plug-ins and workflow activities",
        "howToFix": {
            "summary": ""
        },
        "messageTemplates": [
            {
                "ruleId": "il-use-standard-exception",
                "messageTemplateId": "message1",
                "messageTemplate": "An unguarded throw of type {0} was detected. Refactor this code to either throw an exception of type InvalidPluginExecutionException or guard against thrown exceptions of other types."
            },
            {
                "ruleId": "il-use-standard-exception",
                "messageTemplateId": "message2",
                "messageTemplate": "An unguarded rethrow of type {0} was detected. Refactor this code to either throw an exception of type InvalidPluginExecutionException or guard against thrown exceptions of other types."
            }
        ]
    },
...
]

Ikus baita ere

Erabili Power Apps checker web APIa
Arau multzoen zerrenda berreskuratu
Kargatu fitxategi bat
Deitu azterketa
Egiaztatu analisiaren egoera

Partekatu honen bidez:

Berreskuratu arauen zerrenda

Goiburuak

Parametroak

Espero diren erantzunak

Espero diren erantzunen gorputza

Adibidea: berreskuratu arau bateko arauak beste hizkuntza batean

Adibidea: berreskuratu guztia

Adibidea: berreskuratu arau bat mezuen formatuekin

Ikus baita ere

Oharrak

Baliabide gehigarriak