DokumentationWorkflowsApps og tjenester
GitHub filer og branches node
Læser og skriver filer, branches og commits i et repository, f.eks. „Hvad står der i README på main?“ eller gem en fil med et commit. Se opsætning, input og output, testforløb og løsning af typiske fejl.
10 min. læsningOpdateret
Hvad noden gør
Læser og skriver filer, branches og commits i et repository, f.eks. „Hvad står der i README på main?“ eller gem en fil med et commit.
Brug GitHub filer og branches som et klart afgrænset trin i et anymize-workflow.
- Behandler 1 input.
- Leverer 1 output til efterfølgende trin.
- Kører som et normalt trin i forløbet.
Opsæt noden
- 01Åbn et workflow, og tilføj GitHub filer og branches fra nodekataloget.
- 02Hvis din GitHub-konto ikke er forbundet endnu, så forbind den direkte i nodepanelet eller under Konnektorer.
- 03Udfyld de påkrævede felter, og knyt værdier fra tidligere trin.
- 04Kør noden med et lille testsæt, og kontrollér outputtet.
- 05Forbind det vellykkede output, og aktivér først efter en samlet test.
Handlinger og tilstande
Vælg den ønskede funktion i Handling. Panelet viser derefter de relevante indstillinger.
- List branches
- List commits
- Læs fil
- Læs branch
- Opret branch
- Slet branch
- Læs commit
- Sammenlign versioner
- Læs README
- Gem fil
- Slet fil
- Søg i kode
- List tags
Indstillinger
| Felt | Betydning | Område |
|---|---|---|
| Handling | Valg: List branches, List commits, Læs fil, Læs branch, Opret branch, Slet branch, Læs commit, Sammenlign versioner, Læs README, Gem fil, Slet fil, Søg i kode, List tags | Standard |
| Ejer (bruger eller org) | GitHub-navnet, som repoet tilhører, f.eks. anymize. | Standard |
| Repository | Repositoryets navn, f.eks. hello-world. | Standard |
| Kun beskyttede branches | Indstil værdien i nodepanelet. | Standard |
| Antal (maks. 100) | Hvor mange poster der hentes pr. kald. Har ingen effekt med „Hent alle sider“, så er det altid 100 pr. side. | Standard |
| Hent alle sider | Henter flere sider, indtil alt er med, højst 1000 poster. | Standard |
| Side | Fra hvilken side der hentes, f.eks. næste side fra det forrige kald. Tomt: den første. Har ingen effekt med „Hent alle sider“. | Standard |
| Branch | Hvilken branch, f.eks. main. | Standard |
| Filsti | Sti i repositoryet, f.eks. src/index.ts eller README.md. | Standard |
| Fra person | GitHub-navn eller e-mail. | Standard |
| Ændret siden | Kun poster, der er ændret siden dette tidspunkt, f.eks. 2026-01-31T00:00:00Z. | Standard |
| Ændret indtil | Indstil værdien i nodepanelet. | Standard |
| Version (branch) | Hvilken branch der læses fra, f.eks. main. Proffer kan angive et commit-hash. | Standard |
| Ny branch | Indstil værdien i nodepanelet. | Standard |
| Udgangspunkt | Branch, tag eller commit, der forgrenes fra. Tom: standard-branchen. | Standard |
| Commit eller branch | Indstil værdien i nodepanelet. | Standard |
| Fra | Ældre version, branch eller commit. | Standard |
| Til | Nyere version, branch eller commit. | Standard |
| Indhold | Filens nye indhold. | Standard |
| Indholdet er angivet som | Valg: Tekst, Base64 | Standard |
| Commit-besked | Kort, hvad der er ændret. | Standard |
| Tidligere filversion | Kun for proffer. Tom: findes automatisk. | Standard |
| Søgeord | Et søgeord er påkrævet. Proffer kan bruge filtre, f.eks. repo:octocat/hello-world. | Standard |
| GitHub-konto | Lad feltet stå tomt, så bruger trinnet din forbundne GitHub-konto. | Standard |
| Kør én gang pr. element | Fra (standard): noden kører én gang for hele inputtet. Til: får den flere elementer (f.eks. fra „Del liste op“), kører den én gang PR. element, og {{ $json }} er så præcis dette element. Sådan arbejder du en filliste igennem post for post. | Standard |
| Hvis et element fejler | „Spring over“ skriver et `error`-felt for det fejlede element og fortsætter med resten i stedet for at miste hele kørslen på én ulæselig fil. | Standard |
| Pause mellem elementer (millisekunder) | Ventetid før hver kørsel undtagen den første. 1000 = 1 sekund pr. element. Nyttigt, hvis modparten ellers begrænser dig. Maksimalt 300000 (5 minutter). | Standard |
Input og output
| Input | Betydning | Type |
|---|---|---|
| Standard | Modtager hele resultatet fra det forrige trin. | JSON |
| Output | Betydning | Type |
|---|---|---|
| Standard | Gør resultatet tilgængeligt som JSON for næste trin. | JSON |
Noden kan behandle lister element for element. Fejlhåndtering og pause findes under avancerede indstillinger.
Eksempel og testkørsel
Læs README fra default-branchen: start med et lille og genkendeligt datasæt. Kontrollér outputtet, og brug kun felter, der faktisk findes.
Eksempel på testkørsel
{
"owner": "octocat",
"repo": "hello-world",
"path": "README.md"
}Adgang og sikkerhed
Noden arbejder med din egen forbundne GitHub-konto. Den ser og ændrer kun det, kontoen har lov til. Tjek de viste tilladelser, når du forbinder. Det passende område (Issues, Pull requests, Repos) skal også være slået til i indstillingerne for din GitHub-forbindelse under Konnektorer. Som standard er alle områder slået til.
"Tilladte handlinger" i indstillingerne for din GitHub-forbindelse under Konnektorer gælder også for denne node og tjekkes ved hver kørsel. Med "Kun læsning" eller "Læsning og kladder" kører kun de læsende handlinger: List branches, List commits, Læs fil, Læs branch, Læs commit, Sammenlign versioner, Læs README, Søg i kode, List tags. Disse handlinger kræver "Tillad ændringer": Opret branch, Slet branch, Gem fil, Slet fil.
Nøgler og loginoplysninger hører hjemme i Workflow-secrets eller i dine forbundne konti. Indsæt dem aldrig som almindelig tekst i workflow-felter, testdata eller beskrivelser.
Løs typiske fejl
- Intet output: kontrollér den seneste kørsel og felterne fra den forrige node.
- Tom variabel: åbn outputtet fra det forrige trin, og brug et felt fra de faktiske testdata.
- Forbindelse afvist: opret forbindelsen igen med de nødvendige tilladelser.
- Handling blokeret: sæt "Tilladte handlinger" for forbindelsen under Konnektorer til "Tillad ændringer", eller vælg en læsende handling.
- Listen behandles kun én gang: aktivér kørsel pr. element.