CoE CLI әзірлеу құжаттамасы (ескірген)

Ескерім

CoE CLI ескірген және жаңа мүмкіндіктер қосылмайды. Мәселелер енді қаралмайды немесе шешілмейді.

Егер қауіпсіздік мәселесін анықтасаңыз, оны Microsoft Security Response Center-ге хабарлаңыз.

Power Platform әкімшілік орталығы қосымша, Microsoft Power Platform CLI, Power Platform API, Power Platform inventory API және Power Platform for Admins V2 коннекторы қолдануды қарастырыңыз.

Құжаттама CLI қалай жұмыс істейтінін түсінудің кілті болып табылады. Жаңа пәрмендерді қосқанда келесі құжаттаманы қарастырыңыз:

Markdown беттерін қосыңыз

Жаңа пәрменді сипаттайтын және пайдаланушыға күтілетін пайдалануды түсіндіретін анықтамаға жаңа беттерді қосыңыз.

Бетке келесіні қосуды қарастырыңыз:

  1. Операцияны қорытындылайтын статикалық кескіндер.
  2. Процесті көрсету үшін пәрмен жолын жазыңыз.

Диаграммалар

Шешім ағаштары үшін диаграммалар Су перісі арқылы жасалады.

Мысал диаграммалар:

Диаграмма стильдері

sample.mmd диаграммасын мәнерлеу үшін:

  1. Ішкі топ мәнерлерін пайдаланыңыз.

    graph
        subgraph journey[Journey]
          start(Start) --> finish(Finish Here)
        end
    
        style journey fill:transparent,stroke:green,stroke-width:2px
    
  2. Бір қалтадағы файлмен CSS стильдерді қолданыңыз. Мысалы, .mmd файлымен бір қалтада sample.css жасыңыз.

    #L-start-finish path {
       stroke: red
    }
    

Жазбалар

  1. Көрсетілген таңбаларды басқару үшін түйін пішіндерін қараңыз.

  2. Келесі тәсілді қолданып шеңберлерді мәнерлеу.

    graph TD
       subgraph Journey
          start(Start Here) ---> finish((End Here))
       end
    

    Соңындағы шеңберді жасыл түске бояу үшін CSS атрибутын^=мән таңдау құралын пайдаланыңыз. Бұл селектор қажет, өйткені әрбір элементтің Mermaid тағайындаған бірегей идентификаторы болады.

    [id^=flowchart-finish] circle {
       stroke: green;
       fill: lightgreen
    }
    
  3. Сызықты бояу. Әрбір жолда сызық болып табылатын path және көрсеткі басының айналасындағы сызық болып табылатын .path класы үшін L-бастау-аяқтау пішімі болады.

    #L-start-finsh path,
    #L-start-finsh .path
     {
       stroke: green;
    }
    

Диаграммаларды жаңарту

Әрбір диаграмма үшін статикалық кескіндер келесідей жасалады.

  1. coe-cli қалтасына өтіңіз.

    cd coe-cli
    
  2. Тұрақты файлдар

    npm run diagrams
    

Анықтама беттері

Жаңа анықтама беттерін анықтамаға қосыңыз. Анықтамадағы әрбір бет пәрмен және опциялар туралы толық ақпаратты береді. Анықтамалық Markdown файлына консоль терезесінде байланысты анықтамалық Markdown файлын көрсететін анықтама пәрмені арқылы қол жеткізуге болады.

coe help alm

Бұл пәрмен анықтама мазмұнын көрсетеді.

Пәрмен жолын жазу

Күтілетін нәтижені көрсететін пәрмендердің қысқа анимациялық жазбасын қосу үшін келесі процесті пайдаланыңыз.

  1. Unix негізіндегі терминалға termtosvg орнатыңыз.

    pip3 install --user termtosvg
    

    Бұл процесс платформаларда жұмыс істейді және келесі опциялардың кез келгенін пайдалануға болады:

    • macOS немесе Linux дистрибутивтеріндегі Native Unix қабығы.
    • Unix қабығы бар докер кескіндері.
    • Windows жүйесінде Linux үшін Windows ішкі жүйесі.
  2. Сеансты трансляциялау файлына жазыңыз.

    termtosvg record test.cast
    

    Жасалған трансляция файлы кез келген мәтіндік редактормен өңдеуге болатын қарапайым мәтіндік файл болып табылады.

  3. term-trim.ps1 арқылы үзілістерді жойыңыз.

    ./term-trim.ps1 -Input test.cast -Output test2.cast -Trim 1
    
    
  4. Svg файлын жасаңыз.

    termtosvg render test2.cast test.svg -t window_frame