Style Excel-dokumenter og tilføj hyperlinks med navigationstabeller

Denne artikel forklarer, hvordan man formaterer celler og tilføjer hyperlinks til Excel-dokumenter, som du opretter med Power Query-navigationstabeller. Før du begynder, bør du gennemgå Opret Excel-dokumenter med navigationstabeller for navigationstabelskemaet, deletyper og positioneringsadfærd.

Anvend typografier

Tilføj en Styles liste til en parts Properties registrering. Hvert element indeholder et Target, som identificerer arbejdsarksceller, og et Style, som angiver deres formatering. Du kan anvende stilarter på SheetData, Table, Range, og Text dele samt på backing data-tabellen for en Chart del.

Brug denne form for hvert punkt på listen:

[Target = [Column = "Revenue"], Style = [NumberFormat = "$#,##0.00"]]

M postfeltnavne er små og små bogstaver, så skriv Target, Style, , Font, Colorog andre felter præcis som vist. Du kan bruge dokumenterede optionsværdier som Center, Double, og Solid uden hensyn til sag, men brug den dokumenterede casing. Kilde Power Query-skema-kolonnenavne i postmål og hyperlink-mappinger er små og små bogstaver.

Følgende eksempel formaterer en header, to numeriske kolonner, kolonnebredder og headerens rækkehøjde.

let
    Sales = #table(
        type table [Product = text, Revenue = number, Margin = number],
        {
            {"Northwind", 1200.5, 0.24},
            {"Contoso", 2750, 0.31}
        }
    ),
    ExcelDocument = #table(
        type table [Sheet = nullable text, Name = nullable text, PartType = nullable text, Properties = nullable record, Data = any],
        {
            {
                "Sales", "SalesData", "SheetData",
                [
                    Styles =
                    {
                        [Target = "A1:C1", Style = [Font = [Name = "Aptos", Size = 12, Family = 2, Bold = true, Color = "White"], Fill = "#305496", Alignment = [Horizontal = "Center"]]],
                        [Target = [Column = "Revenue"], Style = [NumberFormat = "$#,##0.00"]],
                        [Target = [Column = "Margin"], Style = [NumberFormat = "0.0%"]],
                        [Target = "A:A", Style = [Width = 24]],
                        [Target = "B:C", Style = [Width = 14]],
                        [Target = "1:1", Style = [RowHeight = 24]]
                    }
                ],
                Sales
            }
        }
    )
in
    ExcelDocument

Vælg et stilmål

Mål bruger absolutte koordinater i arbejdsark. Deres adresser flytter sig ikke, når en del starter et andet sted end celle A1.

Værdien Row i et postmål er en absolut, 1-baseret arbejdsarksrække. Rektangelfelter er undtagelsen: Top, Left, Bottom, og Right er nulbaserede og inkluderende.

Stilceller uden for en dels data

Et mål kan inkludere tomme celler uden for en dels data, for eksempel for at tilføje en fyldning eller kant omkring et rapportområde. Brug en eksplicit placeret Table eller Range del, når du har brug for denne adfærd. SheetData Målene er begrænset til deres dataområde. Med auto-placerede dele udsendes kun dekoration under alle arkdata pålideligt.

Hver celle, der kun er oprettet til styling, tæller med i stilmaterialiseringsgrænserne. Foretræk helkolonne- og helrækkemål for store områder.

Stilreference

Hver stilkomponent er valgfri. A Style er en delvis patch, ikke en erstatning for cellens komplette formatering. Angiv kun de felter, du vil ændre. Udeladte komponenter forbliver uændrede. Indlejrede poster er også delvise. For eksempel [Font = [Bold = true]] ændrer den fedmodighed uden at kræve eller nulstille skrifttypenavn, størrelse eller farve.

Skrifttype

Følgende eksempel anmoder om Aptos ved 12 punkter og klassificerer det som en sans serif-skrifttypefamilie:

[Font = [Name = "Aptos", Size = 12, Family = 2, Bold = true, Color = "#1F4E79"]]

Name er gemt i arbejdsbogen; den installerer eller indlejrer ikke skrifttypen. Vælg en skrifttype, der er tilgængelig for dem, der åbner arbejdsbogen. Excel kan erstatte en anden skrifttype, når den ønskede skrifttype ikke er installeret. Familyhjælper Excel med at vælge en erstatning og udelades normalt, medmindre du skal klassificere den ønskede skrifttype. For eksempel brug Family = 1 med Georgia, Family = 2 med Arial, eller Family = 3 med Consolas.

Fyld

For en ensfarvet fyldning bruges en farve som hele stilen, som værdi, Fill eller som Fill[Color]:

[Target = "A1:C1", Style = "#FFF2CC"]
[Target = "A1:C1", Style = [Fill = "#FFF2CC"]]
[Target = "A1:C1", Style = [Fill = [Color = "#FFF2CC"]]]

En fyldpost kan indeholde PatternType, ForegroundColor, og BackgroundColor. PatternTypeaccepterer Excel-mønsternavnene, herunder None, Solid, Gray125, , Gray0625DarkGray, MediumGray, , LightGray, , og varianterne af mørke eller lyse horisontale, vertikale, diagonale, gitter- og espaliervarianter.

For en solid fyldning ForegroundColor er den synlige farve. BackgroundColor bruges kun af mønstrede fyld.

Border

Indstil Outline = true til at anvende én stil på alle fire ydre kanter af hver målrettet celle. Standardomridset er tyndt og sort.

[Target = "B2:D5", Style = [Border = [Outline = true, Style = "Medium", Color = "Red"]]]

For forskellige kanter bruges Left, Right, , Top, Bottom, eller Diagonal. En kant kan være et stilnavn eller en post, der indeholder Style og Color. Sæt DiagonalUp eller DiagonalDown vælg diagonalretningen.

Kantstilarter er , , , , , , DottedDouble, Hair, , MediumDashed, DashDotMediumDashDotDotDashDotDotMediumDashDotog .SlantDashDotDashedThickMediumThinNone

Justering

Beskyttelse

Protection understøtter de logiske felter Locked og Hidden. Disse indstillinger træder først i kraft, efter at arbejdsarket er beskyttet i Excel. Standardindstillingen for Excel-celleformater er Locked sat til true, så celler, som du ikke specificerer beskyttelse for, bliver låst, når sheet-beskyttelse aktiveres. Brug Locked sat til false for celler, der burde forblive redigerbare.

[Target = "B2:B20", Style = [Protection = [Locked = false]]]

Sæt Hidden til true for at skjule en celles formel, mens arket er beskyttet. Excel-destinationen skriver cellebeskyttelsesindstillingen, men aktiverer ikke beskyttelse i regneark; aktiver beskyttelse i Excel for Locked eller Hidden for at træde i kraft.

Talformat

NumberFormataccepterer en Excel-nummerformatkode. Den erstatter destinationens automatiske typebaserede format for de målrettede celler. Skrifttype-, fyld-, kant- og justeringsindstillingerne fortsætter med at gælde.

Ejendommen understøtter Excel's indbyggede formater og sikre brugerdefinerede formater. Det er ikke begrænset til eksemplerne i denne tabel.

[Target = [Column = "Margin"], Style = [NumberFormat = "0.0%"]]
[Target = [Column = "Revenue"], Style = [NumberFormat = "$#,##0.00"]]
[Target = [Column = "OrderDate"], Style = [NumberFormat = "yyyy-mm-dd"]]
[Target = [Column = "Code"], Style = [NumberFormat = "@"]]

Brugerdefinerede formatkoder kan indeholde op til 255 tegn. Excel-formatkoder bruger dobbelte anførselstegn omkring bogstavelig tekst. Fordobl disse anførselstegn inden for en M-tekstværdi, som i "#,##0 ""USD""". Du kan også undslippe en individuel bogstavelig karakter med et baglæns skrå. Kontroltegn, vinkelparenteser, ubalancerede citater eller parenteser, usikre ikke-escaped tekst og ikke-understøttede formattokens afvises med fejl 30078 gennem 30083.

Søjlebredde og række-højde

Width accepterer værdier fra 0 til 255. Anvend det på et helkolonnemål, et navngivet kolonnemål eller en celle eller begrænset område. Et begrænset interval har størrelsen på hver kolonne, det dækker.

For effektiv og forudsigelig størrelse:

• Brug et helkolonnemål, som "A:A" når du kender arbejdsarkets position.
• Brug [Column = "Description"] når positionen kan ændre sig, men kildetabellens skema er stabilt.
• Gruppere tilstødende kolonner, der kræver samme bredde, for eksempel [Target = "B:D", Style = [Width = 14]].
• Undgå store celle-for-celle-mål, når du kun behøver at måle kolonner. Helkolonnemål materialiserer ikke alle celler.

Når flere dele automatisk bidrager med beregnede bredder til samme regnearkkolonne, bruges den største automatiske bredde, så indholdet i én del ikke indsnævrer en andens kolonne. Eksplicitte bredder har i stedet forrang: inden for én del vinder en senere lige så specifik regel; en specifik kolonneregel vinder over en arkbredde; og når overlappende dele eksplicit har samme arbejdsarkskolonne, vinder den øverste del. Definer én eksplicit bredde pr. kolonne på arbejdsarket, når det er muligt.

RowHeight accepterer værdier fra 0 til 409 point. Det virker kun med et hel-række-tekstmål, såsom "2:2" eller "2:10". Andre målformer returnerer fejl 30090.

Brug et hel-række-interval for tilstødende rækker, der deler højde, såsom [Target = "2:20", Style = [RowHeight = 18]]. Dette er mere effektivt end separate regler for hver række. Når rækkehøjdeintervaller overlapper, har senere regler forrang i overlapningen, så sæt den brede standard først og undtagelserne bagefter.

Angiv farver

Skrifttype-, fyld- og kantfarver accepterer disse former:

Combine-stilregler

Når flere regler påvirker en celle, smelter deres stilfelter sammen i listerækkefølge. En senere værdi erstatter en tidligere værdi for det samme felt, mens ikke-relaterede felter forbliver der. For eksempel fjerner en senere fyldning ikke en tidligere fed skrifttype. Rækkeregler fra generelle til specifikke.

Størrelsesfordelingen følger den prioritet, der er beskrevet i kolonnebredde og rækkehøjde, frem for almindelig feltsammensmeltning.

Almindelige mønstre

Formater en rapporthoved

[Target = "A1:E1", Style = [Font = [Name = "Aptos", Size = 12, Bold = true, Color = "White"], Fill = "#305496", Alignment = [Horizontal = "Center"]]]

Tilføj skiftevis rækkefyld

[Target = "A2:E2", Style = [Fill = "#F2F2F2"]],
[Target = "A4:E4", Style = [Fill = "#F2F2F2"]]

Formatvaluta og procentkolonner

[Target = [Column = "Revenue"], Style = [NumberFormat = "$#,##0.00"]],
[Target = [Column = "Margin"], Style = [NumberFormat = "0.0%"]]

Tilføj en kant omkring en blok

[Target = "B2:D10", Style = [Border = [Outline = true, Style = "Medium"]]]

Størrelsesgrupper af kolonner og rækker

[Target = "A:A", Style = [Width = 28]],
[Target = "B:E", Style = [Width = 14]],
[Target = "1:1", Style = [RowHeight = 26]],
[Target = "2:20", Style = [RowHeight = 18]]

Dekorer et tomt rapportområde

[Target = "G3:I5", Style = [Border = [Outline = true], Fill = "#FFF2CC"]]

Brug dette mønster kun med en eksplicit placeret Table eller Range del. For mere information, se Stilceller uden for en parts data.

Stil: Tekstdele og sammensmeltede serier

Brug en Text del til en titel, note eller anden enkelt værdi. Et afgrænset StartCell område skaber et sammensmeltet område. Stilmål bruger stadig absolutte arbejdsarkadresser.

Følgende eksempel skaber en sammenslået titel og styler dens fyld, skrifttype, justering, kant og rækkehøjder.

let
    ExcelDocument = #table(
        type table [Sheet = nullable text, Name = nullable text, PartType = nullable text, Properties = nullable record, Data = any],
        {
            {
                "Summary", "ReportTitle", "Text",
                [
                    StartCell = "B2:E3",
                    Styles =
                    {
                        [
                            Target = "B2:E3",
                            Style =
                            [
                                Font = [Bold = true, Size = 16, Color = "White"],
                                Fill = "#305496",
                                Alignment = [Horizontal = "Center", Vertical = "Center"],
                                Border = [Outline = true, Style = "Medium", Color = "#1F1F1F"]
                            ]
                        ],
                        [Target = "2:3", Style = [RowHeight = 24]]
                    }
                ],
                "Quarterly sales summary"
            }
        }
    )
in
    ExcelDocument

Excel gemmer en sammenslået værdi og det meste af dens formatering i ankercellen øverst til venstre. En kant er anderledes: for at gengive en omrids omkring en sammensmeltet region skal arbejdsbogen også indeholde kantformatering på de dækkede perimeterceller. Excel-destinationen opretter disse perimeterceller, når en stil bidrager Leftmed , Right, Top, eller Bottom kanter til et sammensmeltet område.

Regler, der målretter dækkede celler, kan tilføje deres egen formatering. Undgå at anvende store grænseområder pr. celle på store sammenfletninger: én sammenfletet grænseregion kan materialisere højst 1.048.576 celler, og et arbejdsark kan materialisere højst 4.194.304 stilede celler.

Tilføj links

Du kan tilføje hyperlinks til alle databærende dele: SheetData, , Table, Range, Textog backing data-tabellen for Chart.

Målet skal være en komplet, absolut http eller https URL, såsom https://www.microsoft.com. Relative URL'er, regnearkreferencer og andre ordninger som file, ftp, og mailto understøttes ikke. Denne begrænsning sikrer, at hvert udsendt hyperlink er en ekstern webforbindelse med et valideret mål. En ikke-tom, ikke-understøttet URL får destinationsskrivningen til at fejle. En null eller tom URL opretter en almindelig celle uden hyperlink.

Tilføj hyperlinks på to måder:

• Tilføj en regel til delens egenskab, Hyperlinks når en kolonne leverer URL'er.
• Tilføj Hyperlink metadata til individuelle værdier, når tekst, URL'er eller tooltips varierer efter række.

Tilføj hyperlinks fra en URL-kolonne

Hver regel i Properties[Hyperlinks] understøtter disse felter:

Reglen tilføjer, fjerner eller omdøber ikke kolonner. En nul eller tom URL forbliver en almindelig celle og skaber ikke et hyperlink.

Følgende eksempel vises Open for hver URL og overskriver den standard hyperlink-fremtoning med en eksplicit stil.

let
    Sites = #table(
        type table [Company = text, Website = nullable text],
        {
            {"Microsoft", "https://www.microsoft.com"},
            {"Power Query", "https://learn.microsoft.com/power-query/"},
            {"No website", null}
        }
    ),
    ExcelDocument = #table(
        type table [Sheet = nullable text, Name = nullable text, PartType = nullable text, Properties = nullable record, Data = any],
        {
            {
                "Links", "CompanyLinks", "Table",
                [
                    StartCell = "A1",
                    Hyperlinks =
                    {
                        [UrlColumn = "Website", DisplayText = "Open", Tooltip = "Open website"]
                    },
                    Styles =
                    {
                        [Target = [Column = "Website"], Style = [Font = [Color = "#008272", Underline = "Double", Bold = true]]]
                    }
                ],
                Sites
            }
        }
    )
in
    ExcelDocument

Tilføj hyperlinks til individuelle værdier

Vedhæft metadata i formularen value meta [Hyperlink = [Url = ..., Tooltip = ...]]. Det Url kræves i metadata-posten, men kan være null. Det er Tooltip valgfrit. Basisværdien bliver visningsværdien og bevarer sin normale datatype og talformat. Hvis basisværdien er null, og URL'en ikke er tom, vises URL'en.

Følgende eksempel bruger en hjælpefunktion til at skabe række-specifik visningstekst, URL'er og tooltips. Sammenkædede og almindelige værdier kan sameksistere i samme kolonne.

let
    MakeLink = (displayValue as any, urlValue as nullable text, optional tooltipValue as nullable text) as any =>
        if tooltipValue = null then
            displayValue meta [Hyperlink = [Url = urlValue]]
        else
            displayValue meta [Hyperlink = [Url = urlValue, Tooltip = tooltipValue]],
    Links = #table(
        type table [Resource = any],
        {
            {MakeLink("Power Query documentation", "https://learn.microsoft.com/power-query/", "Read the documentation")},
            {"Not a hyperlink"},
            {MakeLink(null, "https://www.microsoft.com")}
        }
    ),
    ExcelDocument = #table(
        type table [Sheet = nullable text, Name = nullable text, PartType = nullable text, Properties = nullable record, Data = any],
        {
            {"Resources", "ResourceLinks", "SheetData", [], Links}
        }
    )
in
    ExcelDocument

Du kan vedhæfte hyperlink-metadata til værdier i stærkt typede kolonner, inklusive tal og datoer. Når en celle har både hyperlinkmetadata og en regel om matchende kolonne, har metadata-URL'en og tooltip'en forrang for den pågældende celle.

Som standard anvender destinationen en 11-punkts, enkelt understreget skrifttype, der bruger arbejdsbogens temas hyperlinkfarve (temafarve 10), den mindre skrifttype og skrifttypefamilie 2. I en ny arbejdsbog er Aptos Narrowskrifttypenavnet ; arbejdsbogens tema bestemmer den præcise synlige skrifttype og hyperlinkfarve.

Eksplicitte Styles regler er udarbejdet over standard hyperlink-stilen. For eksempel ændrer kolonne-regel-eksemplet farve, understregning og vægt, mens hyperlink-forholdet bevares. Felter, du ikke tilsidesætter, beholder deres hyperlink-standardindstillinger.

Hvert arbejdsark understøtter op til 65.530 hyperlinks.

Målretningsgrænser

• Mål skal forblive inden for Excel's gitter på 1.048.576 rækker og 16.384 kolonner. Mål uden for disse grænser returnerer fejl 30096 eller 30097.
• En regel, der materialiserer individuelle celler, kan maksimalt dække 1.048.576 celler. Et arbejdsark kan indeholde højst 4.194.304 celler, materialiseret af stilregler.
• Helkolonne- og helrækkemål repræsenteres effektivt og bruger ikke materialiseringsbudgettet pr. celle, blot fordi de spænder over arket. Foretrækker dem til bred formatering og størrelse.
• RowHeight kræver et hel-række-tekstmål. Width Man kan ikke bruge et hel-række- eller række-record-mål.
• Styling uden for en parts data har de positioneringsbegrænsninger, der er beskrevet i stilceller uden for en parts data.

Grænser og fejlfinding

For navigationstabeller og fejl, se Fejlfinding i Excel-navigationstabeller.

Almindelige problemer

En bredderegel ændrer ikke den forventede kolonne

Årsag: Et postmål som [Column = "A"] bruger kildetabellens skemanavn, ikke et Excel-kolonnebogstav. I et ark med overlappende dele kan en anden eksplicit bredde også have forrang.

Opløsning: Brug "A:A" til arbejdsark kolonne A. Brug [Column = "Description"] til kildekolonnen kaldet Description. Brug én eksplicit breddeejer for hver regneark-kolonne.

En RowHeight-regel returnerer fejl 30090

Årsag:RowHeight blev anvendt på et rekordmål eller et begrænset celleområde.

Opløsning: Brug et hel-række tekstmål, såsom [Target = "2:2", Style = [RowHeight = 30]].

Et brugerdefineret nummerformat afvises

Årsag: Bogstavelig tekst er ikke citeret eller undslipt, koden indeholder en ikke-understøttet token, eller anførselstegn eller parenteser er ubalancerede.

Opløsning: Sæt bogstavelig tekst i dobbelte anførselstegn i Excel-formatkoden. I M, fordobl disse anførselstegn, for eksempel [NumberFormat = "#,##0 ""USD"""].

En efterspurgt skrifttype ser anderledes ud i Excel

Årsag: Den ønskede skrifttype er ikke installeret på computeren, der åbner arbejdsbogen, så Excel erstatter den med en skrifttype.

Opløsning: Brug en almindeligt tilgængelig skrifttype og giv eventuelt matchende Family klassifikation for at forbedre substitutionen.

En kantstil eller farve vises ikke

Årsag: Grænseniveau Style og Color kun anvendt via stenografien Outline .

Opløsning: Tilføj Outline = true, eller definer kanter direkte, såsom [Border = [Top = [Style = "Thin", Color = "Red"]]].

Et hyperlink får destinationsskrivningen til at fejle

Årsag: En ikke-tom URL er relativ eller bruger et andet skema end http eller https.

Løsning: Giv en komplet web-URL såsom https://www.microsoft.com, eller brug null- eller tom tekst, når cellen ikke burde være et hyperlink.