n8n-nodes-azuredevops-advanced 0.1.1 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +244 -244
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -5,16 +5,16 @@
5
5
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
6
6
  [![n8n community node](https://img.shields.io/badge/n8n-community%20node-orange)](https://docs.n8n.io/integrations/community-nodes/)
7
7
 
8
- Azure DevOps için kapsamlı bir n8n community node paketi. Git, Pipeline, Work Items, Pull Requests, Test Plans, Boards, Wiki, Service Hooks, TFVC ve Artifacts kaynaklarını tek bir node üzerinden yönetmenizi sağlar.
8
+ A comprehensive n8n community node package for Azure DevOps integration. Manage Git, Pipelines, Work Items, Pull Requests, Test Plans, Boards, Wiki, Service Hooks, TFVC, and Artifacts all from a single node.
9
9
 
10
10
  ---
11
11
 
12
- ## İçindekiler
12
+ ## Table of Contents
13
13
 
14
- - [Özellikler](#özellikler)
15
- - [Kurulum](#kurulum)
16
- - [Kimlik Bilgileri Yapılandırması](#kimlik-bilgileri-yapılandırması)
17
- - [Kaynaklar ve Operasyonlar](#kaynaklar-ve-operasyonlar)
14
+ - [Features](#features)
15
+ - [Installation](#installation)
16
+ - [Credential Configuration](#credential-configuration)
17
+ - [Resources & Operations](#resources--operations)
18
18
  - [Git Repositories](#1-git-repositories)
19
19
  - [Pipeline (CI/CD)](#2-pipeline-cicd)
20
20
  - [Work Items](#3-work-items)
@@ -25,57 +25,57 @@ Azure DevOps için kapsamlı bir n8n community node paketi. Git, Pipeline, Work
25
25
  - [Service Hooks](#8-service-hooks)
26
26
  - [TFVC](#9-tfvc)
27
27
  - [Artifacts](#10-artifacts)
28
- - [Kullanım Örnekleri](#kullanım-örnekleri)
29
- - [Gereksinimler](#gereksinimler)
30
- - [Katkıda Bulunma](#katkıda-bulunma)
31
- - [Lisans](#lisans)
28
+ - [Usage Examples](#usage-examples)
29
+ - [Requirements](#requirements)
30
+ - [Contributing](#contributing)
31
+ - [License](#license)
32
32
 
33
33
  ---
34
34
 
35
- ## Özellikler
36
-
37
- - **10 farklı Azure DevOps kaynağı** tek node üzerinden
38
- - **40+ operasyon** ile kapsamlı otomasyon
39
- - Azure DevOps REST API **v7.1** desteği
40
- - Personal Access Token (PAT) ile güvenli kimlik doğrulama
41
- - n8n'nin hata yönetimi ve **continueOnFail** desteği
42
- - TypeScript ile geliştirilmiş, tam tip güvenliği
43
-
44
- ### Desteklenen Kaynaklar
45
-
46
- | Kaynak | Operasyon Sayısı | Açıklama |
47
- |--------|-----------------|----------|
48
- | Git Repositories | 4 | Repo listeleme, dosya okuma, branch oluşturma, commit push |
49
- | Pipeline (CI/CD) | 4 | Pipeline listeleme, çalıştırma, log alma, iptal etme |
50
- | Work Items | 6 | İş öğesi oluşturma, güncelleme, listeleme, kullanıcı ve etiket yönetimi |
51
- | Pull Requests | 5 | PR oluşturma, güncelleme, listeleme, yorum okuma |
52
- | Test Plans | 4 | Test planı, suite, case ve run listeleme |
53
- | Boards | 3 | Board, kolon ve iterasyon (sprint) listeleme |
54
- | Wiki | 4 | Wiki sayfası okuma, oluşturma, güncelleme |
55
- | Service Hooks | 2 | Webhook abonelik listeleme ve oluşturma |
56
- | TFVC | 2 | TFVC branch listeleme ve dosya okuma |
57
- | Artifacts | 2 | Feed ve paket listeleme |
35
+ ## Features
36
+
37
+ - **10 Azure DevOps resources** managed through a single node
38
+ - **40+ operations** for comprehensive automation
39
+ - Azure DevOps REST API **v7.1** support
40
+ - Secure authentication via Personal Access Token (PAT)
41
+ - Full support for n8n error handling and **continueOnFail**
42
+ - Built with TypeScript for complete type safety
43
+
44
+ ### Supported Resources
45
+
46
+ | Resource | Operations | Description |
47
+ |----------|-----------|-------------|
48
+ | Git Repositories | 4 | List repos, read files, create branches, push commits |
49
+ | Pipeline (CI/CD) | 4 | List, run, get logs, cancel pipelines |
50
+ | Work Items | 6 | Create, update, list work items; manage users and tags |
51
+ | Pull Requests | 5 | Create, update, list PRs, read comments |
52
+ | Test Plans | 4 | List test plans, suites, cases, and runs |
53
+ | Boards | 3 | List boards, columns, and iterations (sprints) |
54
+ | Wiki | 4 | Read, create, and update wiki pages |
55
+ | Service Hooks | 2 | List and create webhook subscriptions |
56
+ | TFVC | 2 | List TFVC branches and read files |
57
+ | Artifacts | 2 | List feeds and packages |
58
58
 
59
59
  ---
60
60
 
61
- ## Kurulum
61
+ ## Installation
62
62
 
63
- ### n8n Arayüzü Üzerinden (Önerilen)
63
+ ### Via n8n UI (Recommended)
64
64
 
65
- 1. n8n'de **Settings → Community Nodes** sayfasına gidin
66
- 2. **Install** butonuna tıklayın
67
- 3. Paket adını girin: `n8n-nodes-azuredevops-advanced`
68
- 4. **Install** butonuna tıklayın ve yeniden başlatmayı onaylayın
65
+ 1. In n8n, go to **Settings → Community Nodes**
66
+ 2. Click **Install**
67
+ 3. Enter the package name: `n8n-nodes-azuredevops-advanced`
68
+ 4. Click **Install** and confirm the restart
69
69
 
70
- ### npm ile Manuel Kurulum
70
+ ### Manual Installation via npm
71
71
 
72
- Kendi barındırdığınız n8n ortamında:
72
+ For self-hosted n8n environments:
73
73
 
74
74
  ```bash
75
75
  npm install n8n-nodes-azuredevops-advanced
76
76
  ```
77
77
 
78
- Docker ile çalışıyorsanız `n8n-custom-extensions` klasörüne ekleyin veya özel bir Docker image oluşturun:
78
+ If you're running Docker, add it to the `n8n-custom-extensions` folder or build a custom Docker image:
79
79
 
80
80
  ```dockerfile
81
81
  FROM n8nio/n8n
@@ -84,19 +84,19 @@ RUN cd /usr/local/lib/node_modules/n8n && npm install n8n-nodes-azuredevops-adva
84
84
 
85
85
  ---
86
86
 
87
- ## Kimlik Bilgileri Yapılandırması
87
+ ## Credential Configuration
88
88
 
89
- ### Azure DevOps Personal Access Token (PAT) Oluşturma
89
+ ### Creating an Azure DevOps Personal Access Token (PAT)
90
90
 
91
- 1. [dev.azure.com](https://dev.azure.com) adresine gidin ve oturum açın
92
- 2. Sağ üst köşede kullanıcı ikonuna tıklayın → **Personal access tokens**
93
- 3. **New Token** butonuna tıklayın
94
- 4. Token için bir isim verin (örn. `n8n-integration`)
95
- 5. **Expiration** tarihini belirleyin
96
- 6. **Scopes** bölümünde ihtiyaçlarınıza göre izinleri seçin:
91
+ 1. Go to [dev.azure.com](https://dev.azure.com) and sign in
92
+ 2. Click your user icon in the top right → **Personal access tokens**
93
+ 3. Click **New Token**
94
+ 4. Give the token a name (e.g. `n8n-integration`)
95
+ 5. Set an **Expiration** date
96
+ 6. Under **Scopes**, select the permissions you need:
97
97
 
98
- | Kapsam | İzin | Kullanılan Özellik |
99
- |--------|------|-------------------|
98
+ | Scope | Permission | Used For |
99
+ |-------|-----------|----------|
100
100
  | Code | Read & Write | Git, Pull Requests |
101
101
  | Build | Read & Execute | Pipeline |
102
102
  | Work Items | Read & Write | Work Items, Boards |
@@ -105,41 +105,41 @@ RUN cd /usr/local/lib/node_modules/n8n && npm install n8n-nodes-azuredevops-adva
105
105
  | Service Hooks | Read, Write & Manage | Service Hooks |
106
106
  | Packaging | Read | Artifacts |
107
107
 
108
- 7. **Create** butonuna tıklayın ve token'ı kopyalayın (bir daha gösterilmez!)
108
+ 7. Click **Create** and copy the token (it won't be shown again!)
109
109
 
110
- ### n8n'de Credential Oluşturma
110
+ ### Creating a Credential in n8n
111
111
 
112
- 1. n8n'de **Credentials → Add Credential** sayfasına gidin
113
- 2. **Azure DevOps Advanced API** seçin
114
- 3. Aşağıdaki bilgileri girin:
112
+ 1. In n8n, go to **Credentials → Add Credential**
113
+ 2. Select **Azure DevOps Advanced API**
114
+ 3. Fill in the following fields:
115
115
 
116
- | Alan | Açıklama | Örnek |
117
- |------|----------|-------|
118
- | Organization | Azure DevOps organizasyon adı | `mycompany` |
119
- | Personal Access Token | Yukarıda oluşturulan PAT | `xxxxxxxxxxxxxxxxxxxx` |
116
+ | Field | Description | Example |
117
+ |-------|-------------|---------|
118
+ | Organization | Your Azure DevOps organization name | `mycompany` |
119
+ | Personal Access Token | The PAT you created above | `xxxxxxxxxxxxxxxxxxxx` |
120
120
 
121
- 4. **Save** butonuna tıklayın
121
+ 4. Click **Save**
122
122
 
123
- > **Not:** Organization adını `dev.azure.com/{organization}` URL'sinden bulabilirsiniz.
123
+ > **Note:** You can find your organization name in the URL: `dev.azure.com/{organization}`
124
124
 
125
125
  ---
126
126
 
127
- ## Kaynaklar ve Operasyonlar
127
+ ## Resources & Operations
128
128
 
129
129
  ### 1. Git Repositories
130
130
 
131
- Azure DevOps Git depolarını yönetin.
131
+ Manage Azure DevOps Git repositories.
132
132
 
133
- #### Operasyonlar
133
+ #### Operations
134
134
 
135
- | Operasyon | Açıklama | Zorunlu Parametreler |
136
- |-----------|----------|---------------------|
137
- | **List Repositories** | Projedeki tüm Git repolarını listele | Project |
138
- | **Get File Content** | Belirtilen dosyanın içeriğini al | Project, Repository ID, File Path |
139
- | **Create Branch** | Yeni bir branch oluştur (main'den) | Project, Repository ID, Branch Name |
140
- | **Push Commit** | Dosya değişikliği commit et | Project, Repository ID, Branch Name, Commit Message |
135
+ | Operation | Description | Required Parameters |
136
+ |-----------|-------------|-------------------|
137
+ | **List Repositories** | List all Git repos in a project | Project |
138
+ | **Get File Content** | Retrieve the content of a file | Project, Repository ID, File Path |
139
+ | **Create Branch** | Create a new branch (from main) | Project, Repository ID, Branch Name |
140
+ | **Push Commit** | Commit a file change | Project, Repository ID, Branch Name, Commit Message |
141
141
 
142
- #### Örnek: Dosya İçeriği Alma
142
+ #### Example: Get File Content
143
143
 
144
144
  ```
145
145
  Resource: Git Repositories
@@ -149,7 +149,7 @@ Repository ID: my-repo
149
149
  File Path: /src/app.ts
150
150
  ```
151
151
 
152
- #### Örnek: Branch Oluşturma
152
+ #### Example: Create Branch
153
153
 
154
154
  ```
155
155
  Resource: Git Repositories
@@ -163,18 +163,18 @@ Branch Name: refs/heads/feature/new-feature
163
163
 
164
164
  ### 2. Pipeline (CI/CD)
165
165
 
166
- Azure DevOps build ve release pipeline'larını otomatikleştirin.
166
+ Automate Azure DevOps build and release pipelines.
167
167
 
168
- #### Operasyonlar
168
+ #### Operations
169
169
 
170
- | Operasyon | Açıklama | Zorunlu Parametreler |
171
- |-----------|----------|---------------------|
172
- | **List Pipelines** | Tüm pipeline'ları listele | Project |
173
- | **Run Pipeline** | Pipeline'ı başlat | Project, Pipeline ID |
174
- | **Get Build Logs** | Belirli bir run'ın loglarını al | Project, Pipeline ID, Run ID |
175
- | **Cancel Run** | Çalışan pipeline iptal et | Project, Pipeline ID, Run ID |
170
+ | Operation | Description | Required Parameters |
171
+ |-----------|-------------|-------------------|
172
+ | **List Pipelines** | List all pipelines | Project |
173
+ | **Run Pipeline** | Trigger a pipeline | Project, Pipeline ID |
174
+ | **Get Build Logs** | Retrieve logs for a specific run | Project, Pipeline ID, Run ID |
175
+ | **Cancel Run** | Cancel an active pipeline run | Project, Pipeline ID, Run ID |
176
176
 
177
- #### Örnek: Pipeline Tetikleme
177
+ #### Example: Trigger a Pipeline
178
178
 
179
179
  ```
180
180
  Resource: Pipeline
@@ -183,7 +183,7 @@ Project: MyProject
183
183
  Pipeline ID: 42
184
184
  ```
185
185
 
186
- #### Örnek: Build Loglarını Alma
186
+ #### Example: Get Build Logs
187
187
 
188
188
  ```
189
189
  Resource: Pipeline
@@ -197,20 +197,20 @@ Run ID: 1234
197
197
 
198
198
  ### 3. Work Items
199
199
 
200
- Azure DevOps öğelerini (Task, Bug, Epic, Feature, User Story) yönetin.
200
+ Manage Azure DevOps work items (Task, Bug, Epic, Feature, User Story).
201
201
 
202
- #### Operasyonlar
202
+ #### Operations
203
203
 
204
- | Operasyon | Açıklama | Zorunlu Parametreler |
205
- |-----------|----------|---------------------|
206
- | **Get Work Item** | Tek bir öğesini getir | Project, Work Item ID |
207
- | **List All Work Items** | WIQL sorgusuyla tüm öğelerini listele | Project |
208
- | **Create Work Item** | Yeni öğesi oluştur | Project, Work Item Type, Title |
209
- | **Update Work Item** | Mevcut öğesini güncelle | Project, Work Item ID |
210
- | **List Users** | Organizasyon kullanıcılarını listele | - |
211
- | **List Tags** | Projedeki tüm etiketleri listele | Project |
204
+ | Operation | Description | Required Parameters |
205
+ |-----------|-------------|-------------------|
206
+ | **Get Work Item** | Fetch a single work item | Project, Work Item ID |
207
+ | **List All Work Items** | List all work items via WIQL query | Project |
208
+ | **Create Work Item** | Create a new work item | Project, Work Item Type, Title |
209
+ | **Update Work Item** | Update an existing work item | Project, Work Item ID |
210
+ | **List Users** | List organization users | |
211
+ | **List Tags** | List all tags in a project | Project |
212
212
 
213
- #### Desteklenen İş Öğesi Türleri
213
+ #### Supported Work Item Types
214
214
 
215
215
  - Task
216
216
  - Bug
@@ -220,7 +220,7 @@ Azure DevOps iş öğelerini (Task, Bug, Epic, Feature, User Story) yönetin.
220
220
  - Issue
221
221
  - Test Case
222
222
 
223
- #### Desteklenen İş Öğesi Durumları
223
+ #### Supported Work Item States
224
224
 
225
225
  - New / To Do
226
226
  - Active / Doing
@@ -228,20 +228,20 @@ Azure DevOps iş öğelerini (Task, Bug, Epic, Feature, User Story) yönetin.
228
228
  - Closed / Done
229
229
  - Removed
230
230
 
231
- #### Ek Alanlar (Opsiyonel)
231
+ #### Additional Fields (Optional)
232
232
 
233
- Work Item oluştururken veya güncellerken kullanılabilecek ek alanlar:
233
+ Extra fields available when creating or updating a work item:
234
234
 
235
- | Alan Adı | Açıklama |
236
- |----------|----------|
237
- | `System.Description` | İş öğesi açıklaması (HTML destekli) |
238
- | `System.AssignedTo` | Atanan kullanıcı adı veya e-posta |
239
- | `System.State` | Durum (New, Active, Resolved, Closed) |
240
- | `Microsoft.VSTS.Common.Priority` | Öncelik (1=En Yüksek, 4=En Düşük) |
241
- | `System.Tags` | Etiketler (noktalı virgülle ayrılmış) |
242
- | `Custom.FieldName` | Özel alanlar |
235
+ | Field Name | Description |
236
+ |-----------|-------------|
237
+ | `System.Description` | Work item description (HTML supported) |
238
+ | `System.AssignedTo` | Assigned user name or email |
239
+ | `System.State` | State (New, Active, Resolved, Closed) |
240
+ | `Microsoft.VSTS.Common.Priority` | Priority (1=Highest, 4=Lowest) |
241
+ | `System.Tags` | Tags (semicolon-separated) |
242
+ | `Custom.FieldName` | Any custom field |
243
243
 
244
- #### Örnek: Bug Oluşturma
244
+ #### Example: Create a Bug
245
245
 
246
246
  ```
247
247
  Resource: Work Items
@@ -259,39 +259,39 @@ Additional Fields:
259
259
 
260
260
  ### 4. Pull Requests
261
261
 
262
- Git pull request iş akışlarını otomatikleştirin.
262
+ Automate Git pull request workflows.
263
263
 
264
- #### Operasyonlar
264
+ #### Operations
265
265
 
266
- | Operasyon | Açıklama | Zorunlu Parametreler |
267
- |-----------|----------|---------------------|
268
- | **Get Pull Request** | Tek PR getir | Project, Repository ID, PR ID |
269
- | **List Pull Requests** | Filtrelenmiş PR listesi | Project, Repository ID |
270
- | **Create Pull Request** | Yeni PR oluştur | Project, Repository ID, Source Branch, Target Branch, Title |
271
- | **Update Pull Request** | PR'ı güncelle veya merge et | Project, Repository ID, PR ID |
272
- | **Get Comments** | PR yorum thread'lerini getir | Project, Repository ID, PR ID |
266
+ | Operation | Description | Required Parameters |
267
+ |-----------|-------------|-------------------|
268
+ | **Get Pull Request** | Fetch a single PR | Project, Repository ID, PR ID |
269
+ | **List Pull Requests** | List PRs with filters | Project, Repository ID |
270
+ | **Create Pull Request** | Open a new PR | Project, Repository ID, Source Branch, Target Branch, Title |
271
+ | **Update Pull Request** | Update or merge a PR | Project, Repository ID, PR ID |
272
+ | **Get Comments** | Fetch PR review threads | Project, Repository ID, PR ID |
273
273
 
274
- #### PR Listeleme Filtreleri
274
+ #### PR Listing Filters
275
275
 
276
- | Filtre | Seçenekler |
277
- |--------|-----------|
276
+ | Filter | Options |
277
+ |--------|---------|
278
278
  | Status | active, abandoned, completed, all |
279
- | Source Branch | Kaynak branch adı |
280
- | Target Branch | Hedef branch adı |
281
- | Limit | Maksimum sonuç sayısı |
279
+ | Source Branch | Source branch name |
280
+ | Target Branch | Target branch name |
281
+ | Limit | Maximum number of results |
282
282
 
283
- #### Merge Stratejileri
283
+ #### Merge Strategies
284
284
 
285
- PR güncellerken kullanılabilecek merge stratejileri:
285
+ Merge strategies available when completing a PR:
286
286
 
287
- | Strateji | Açıklama |
288
- |----------|----------|
289
- | `noFastForward` | Merge commit oluştur |
290
- | `rebase` | Rebasing ile merge et |
291
- | `rebaseMerge` | Rebase ve merge commit |
292
- | `squash` | Tüm commitleri tek commit'e sıkıştır |
287
+ | Strategy | Description |
288
+ |----------|-------------|
289
+ | `noFastForward` | Create a merge commit |
290
+ | `rebase` | Rebase onto target branch |
291
+ | `rebaseMerge` | Rebase and create a merge commit |
292
+ | `squash` | Squash all commits into one |
293
293
 
294
- #### Örnek: PR Oluşturma
294
+ #### Example: Create a Pull Request
295
295
 
296
296
  ```
297
297
  Resource: Pull Requests
@@ -311,18 +311,18 @@ Additional Fields:
311
311
 
312
312
  ### 5. Test Plans
313
313
 
314
- Azure DevOps test yönetimini otomatikleştirin.
314
+ Automate Azure DevOps test management.
315
315
 
316
- #### Operasyonlar
316
+ #### Operations
317
317
 
318
- | Operasyon | Açıklama | Zorunlu Parametreler |
319
- |-----------|----------|---------------------|
320
- | **List Test Plans** | Tüm test planlarını listele | Project |
321
- | **List Test Suites** | Bir plan içindeki suite'leri listele | Project, Plan ID |
322
- | **List Test Cases** | Bir suite içindeki test case'leri listele | Project, Plan ID, Suite ID |
323
- | **List Test Runs** | Tüm test run'larını listele | Project |
318
+ | Operation | Description | Required Parameters |
319
+ |-----------|-------------|-------------------|
320
+ | **List Test Plans** | List all test plans | Project |
321
+ | **List Test Suites** | List suites within a plan | Project, Plan ID |
322
+ | **List Test Cases** | List test cases within a suite | Project, Plan ID, Suite ID |
323
+ | **List Test Runs** | List all test runs | Project |
324
324
 
325
- #### Örnek: Test Case Listeleme
325
+ #### Example: List Test Cases
326
326
 
327
327
  ```
328
328
  Resource: Test Plans
@@ -336,17 +336,17 @@ Suite ID: 25
336
336
 
337
337
  ### 6. Boards
338
338
 
339
- Agile board ve sprint yönetimi.
339
+ Agile board and sprint management.
340
340
 
341
- #### Operasyonlar
341
+ #### Operations
342
342
 
343
- | Operasyon | Açıklama | Zorunlu Parametreler |
344
- |-----------|----------|---------------------|
345
- | **List Boards** | Takım board'larını listele | Project, Team |
346
- | **List Board Columns** | Board kolonlarını listele | Project, Team, Board ID |
347
- | **List Iterations** | Sprint/iterasyon listesini al | Project, Team |
343
+ | Operation | Description | Required Parameters |
344
+ |-----------|-------------|-------------------|
345
+ | **List Boards** | List team boards | Project, Team |
346
+ | **List Board Columns** | List columns in a board | Project, Team, Board ID |
347
+ | **List Iterations** | Get sprint/iteration list | Project, Team |
348
348
 
349
- #### Örnek: Sprint Listesi Alma
349
+ #### Example: Get Sprint List
350
350
 
351
351
  ```
352
352
  Resource: Boards
@@ -355,7 +355,7 @@ Project: MyProject
355
355
  Team: MyProject Team
356
356
  ```
357
357
 
358
- #### Yaygın Board ID'leri
358
+ #### Common Board IDs
359
359
 
360
360
  - `Epics`
361
361
  - `Features`
@@ -366,18 +366,18 @@ Team: MyProject Team
366
366
 
367
367
  ### 7. Wiki
368
368
 
369
- Azure DevOps wiki sayfalarını yönetin.
369
+ Manage Azure DevOps wiki pages.
370
370
 
371
- #### Operasyonlar
371
+ #### Operations
372
372
 
373
- | Operasyon | Açıklama | Zorunlu Parametreler |
374
- |-----------|----------|---------------------|
375
- | **List Wikis** | Projedeki tüm wiki'leri listele | Project |
376
- | **Get Page** | Wiki sayfasını getir | Project, Wiki Identifier, Page Path |
377
- | **Create Page** | Yeni wiki sayfası oluştur | Project, Wiki Identifier, Page Path, Content |
378
- | **Update Page** | Mevcut wiki sayfasını güncelle | Project, Wiki Identifier, Page Path, Content |
373
+ | Operation | Description | Required Parameters |
374
+ |-----------|-------------|-------------------|
375
+ | **List Wikis** | List all wikis in a project | Project |
376
+ | **Get Page** | Fetch a wiki page | Project, Wiki Identifier, Page Path |
377
+ | **Create Page** | Create a new wiki page | Project, Wiki Identifier, Page Path, Content |
378
+ | **Update Page** | Update an existing wiki page | Project, Wiki Identifier, Page Path, Content |
379
379
 
380
- #### Örnek: Wiki Sayfası Oluşturma
380
+ #### Example: Create a Wiki Page
381
381
 
382
382
  ```
383
383
  Resource: Wiki
@@ -385,37 +385,37 @@ Operation: Create Page
385
385
  Project: MyProject
386
386
  Wiki Identifier: MyProject.wiki
387
387
  Page Path: /Documentation/API-Guide
388
- Content: # API Guide\n\nBu sayfa API rehberini içerir...
388
+ Content: # API Guide\n\nThis page contains the API reference...
389
389
  ```
390
390
 
391
- > **Not:** Content alanı Markdown formatını destekler.
391
+ > **Note:** The Content field supports Markdown format.
392
392
 
393
393
  ---
394
394
 
395
395
  ### 8. Service Hooks
396
396
 
397
- Azure DevOps event'leri için webhook abonelikleri yönetin.
397
+ Manage webhook subscriptions for Azure DevOps events.
398
398
 
399
- #### Operasyonlar
399
+ #### Operations
400
400
 
401
- | Operasyon | Açıklama | Zorunlu Parametreler |
402
- |-----------|----------|---------------------|
403
- | **List Subscriptions** | Tüm webhook aboneliklerini listele | - |
404
- | **Create Subscription** | Yeni webhook aboneliği oluştur | Project, Event Type, Consumer URL |
401
+ | Operation | Description | Required Parameters |
402
+ |-----------|-------------|-------------------|
403
+ | **List Subscriptions** | List all webhook subscriptions | |
404
+ | **Create Subscription** | Create a new webhook subscription | Project, Event Type, Consumer URL |
405
405
 
406
- #### Desteklenen Event Türleri
406
+ #### Supported Event Types
407
407
 
408
- | Event Türü | Açıklama |
409
- |-----------|----------|
410
- | `build.complete` | Build tamamlandı |
411
- | `git.push` | Kod push edildi |
412
- | `git.pullrequest.created` | Pull Request oluşturuldu |
413
- | `git.pullrequest.merged` | Pull Request merge edildi |
414
- | `workitem.created` | İş öğesi oluşturuldu |
415
- | `workitem.updated` | İş öğesi güncellendi |
416
- | `ms.vss-release.release-created-event` | Release oluşturuldu |
408
+ | Event Type | Description |
409
+ |-----------|-------------|
410
+ | `build.complete` | Build completed |
411
+ | `git.push` | Code pushed |
412
+ | `git.pullrequest.created` | Pull request created |
413
+ | `git.pullrequest.merged` | Pull request merged |
414
+ | `workitem.created` | Work item created |
415
+ | `workitem.updated` | Work item updated |
416
+ | `ms.vss-release.release-created-event` | Release created |
417
417
 
418
- #### Örnek: Webhook Aboneliği Oluşturma
418
+ #### Example: Create a Webhook Subscription
419
419
 
420
420
  ```
421
421
  Resource: Service Hooks
@@ -425,22 +425,22 @@ Event Type: git.push
425
425
  Consumer URL: https://your-n8n-instance.com/webhook/xyz
426
426
  ```
427
427
 
428
- > **İpucu:** Consumer URL olarak n8n Webhook node'unun URL'sini kullanarak Azure DevOps event'lerini n8n workflow'larına bağlayabilirsiniz.
428
+ > **Tip:** Use your n8n Webhook node's URL as the Consumer URL to connect Azure DevOps events directly to n8n workflows.
429
429
 
430
430
  ---
431
431
 
432
432
  ### 9. TFVC
433
433
 
434
- Team Foundation Version Control (eski versiyon kontrol sistemi) desteği.
434
+ Support for Team Foundation Version Control (legacy source control).
435
435
 
436
- #### Operasyonlar
436
+ #### Operations
437
437
 
438
- | Operasyon | Açıklama | Zorunlu Parametreler |
439
- |-----------|----------|---------------------|
440
- | **List Branches** | TFVC branch ve klasörlerini listele | Project |
441
- | **Get File Content** | TFVC'den dosya içeriği al | Project, File Path |
438
+ | Operation | Description | Required Parameters |
439
+ |-----------|-------------|-------------------|
440
+ | **List Branches** | List TFVC branches and folders | Project |
441
+ | **Get File Content** | Read a file from TFVC | Project, File Path |
442
442
 
443
- #### Örnek: TFVC Dosyası Okuma
443
+ #### Example: Read a TFVC File
444
444
 
445
445
  ```
446
446
  Resource: TFVC
@@ -449,22 +449,22 @@ Project: MyProject
449
449
  File Path: $/MyProject/src/main.cs
450
450
  ```
451
451
 
452
- > **Not:** TFVC yolları `$/` ile başlar.
452
+ > **Note:** TFVC paths start with `$/`.
453
453
 
454
454
  ---
455
455
 
456
456
  ### 10. Artifacts
457
457
 
458
- Azure Artifacts paket feed yönetimi.
458
+ Azure Artifacts package feed management.
459
459
 
460
- #### Operasyonlar
460
+ #### Operations
461
461
 
462
- | Operasyon | Açıklama | Zorunlu Parametreler |
463
- |-----------|----------|---------------------|
464
- | **List Feeds** | Tüm artifact feed'lerini listele | Project |
465
- | **List Packages** | Feed içindeki paketleri listele | Project, Feed ID |
462
+ | Operation | Description | Required Parameters |
463
+ |-----------|-------------|-------------------|
464
+ | **List Feeds** | List all artifact feeds | Project |
465
+ | **List Packages** | List packages in a feed | Project, Feed ID |
466
466
 
467
- #### Örnek: Paket Listeleme
467
+ #### Example: List Packages
468
468
 
469
469
  ```
470
470
  Resource: Artifacts
@@ -475,76 +475,76 @@ Feed ID: my-nuget-feed
475
475
 
476
476
  ---
477
477
 
478
- ## Kullanım Örnekleri
478
+ ## Usage Examples
479
479
 
480
- ### Örnek 1: Otomatik PR Oluşturma Workflow'u
480
+ ### Example 1: Automated PR Creation Workflow
481
481
 
482
- Bu workflow, bir GitHub event'inde Azure DevOps'ta otomatik PR oluşturur:
482
+ This workflow automatically creates a PR in Azure DevOps in response to an external event:
483
483
 
484
- 1. **Webhook Trigger** → GitHub push event alır
485
- 2. **Azure DevOps Advanced** (Git: Create Branch) → Yeni branch oluşturur
486
- 3. **Azure DevOps Advanced** (Pull Requests: Create) → PR açar
487
- 4. **Slack** → Ekibe bildirim gönderir
484
+ 1. **Webhook Trigger** → Receives a GitHub push event
485
+ 2. **Azure DevOps Advanced** (Git: Create Branch) → Creates a new branch
486
+ 3. **Azure DevOps Advanced** (Pull Requests: Create) → Opens a PR
487
+ 4. **Slack** → Sends a notification to the team
488
488
 
489
- ### Örnek 2: Work Item Otomasyonu
489
+ ### Example 2: Work Item Automation
490
490
 
491
- Jira'dan Azure DevOps'a iş öğesi senkronizasyonu:
491
+ Synchronize issues from Jira to Azure DevOps:
492
492
 
493
- 1. **Schedule Trigger** → Her saat çalışır
494
- 2. **Jira** → Yeni issue'ları listeler
495
- 3. **IF** → Azure DevOps'ta mevcut değilse filtreler
496
- 4. **Azure DevOps Advanced** (Work Items: Create) → Task oluşturur
497
- 5. **Jira** → Issue'yu günceller
493
+ 1. **Schedule Trigger** → Runs every hour
494
+ 2. **Jira** → Lists new issues
495
+ 3. **IF** → Filters out items already in Azure DevOps
496
+ 4. **Azure DevOps Advanced** (Work Items: Create) → Creates a Task
497
+ 5. **Jira** → Updates the original issue
498
498
 
499
- ### Örnek 3: Build Monitoring
499
+ ### Example 3: Build Monitoring
500
500
 
501
- Pipeline başarısız olduğunda uyarı gönderme:
501
+ Send an alert when a pipeline fails:
502
502
 
503
- 1. **Azure DevOps Advanced** (Service Hooks: Create Subscription) → Build event'e abone olur
504
- 2. **Webhook** → Build complete event alır
505
- 3. **IF** → Build başarısız kontrol eder
506
- 4. **Azure DevOps Advanced** (Pipeline: Get Build Logs) → Hata loglarını alır
507
- 5. **Email / Slack** → Detaylı hata bildirimi gönderir
503
+ 1. **Azure DevOps Advanced** (Service Hooks: Create Subscription) → Subscribes to build events
504
+ 2. **Webhook** → Receives the build complete event
505
+ 3. **IF** → Checks whether the build failed
506
+ 4. **Azure DevOps Advanced** (Pipeline: Get Build Logs) → Fetches error logs
507
+ 5. **Email / Slack** → Sends a detailed failure notification
508
508
 
509
509
  ---
510
510
 
511
- ## Gereksinimler
511
+ ## Requirements
512
512
 
513
513
  - **n8n** >= 1.0.0
514
514
  - **Node.js** >= 18.x
515
- - Azure DevOps hesabı ve organizasyon
516
- - Yeterli izinlere sahip Personal Access Token (PAT)
515
+ - An Azure DevOps account and organization
516
+ - A Personal Access Token (PAT) with sufficient permissions
517
517
 
518
518
  ---
519
519
 
520
- ## Geliştirme
520
+ ## Development
521
521
 
522
- Projeyi yerel ortamda çalıştırmak için:
522
+ To run the project locally:
523
523
 
524
524
  ```bash
525
- # Repoyu klonlayın
525
+ # Clone the repository
526
526
  git clone https://github.com/ertekinozturgut/n8n-nodes-azuredevops-advanced.git
527
527
  cd n8n-nodes-azuredevops-advanced
528
528
 
529
- # Bağımlılıkları yükleyin
529
+ # Install dependencies
530
530
  npm install
531
531
 
532
- # TypeScript derleme (watch mode)
532
+ # TypeScript compilation (watch mode)
533
533
  npm run dev
534
534
 
535
- # Üretim derlemesi
535
+ # Production build
536
536
  npm run build
537
537
  ```
538
538
 
539
- ### Proje Yapısı
539
+ ### Project Structure
540
540
 
541
541
  ```
542
542
  n8n-nodes-azuredevops-advanced/
543
543
  ├── nodes/
544
544
  │ └── AzureDevOpsAdvanced/
545
- │ ├── AzureDevOpsAdvanced.node.ts # Ana node implementasyonu
546
- │ ├── GenericFunctions.ts # API istek yardımcısı
547
- │ ├── azureDevOps.svg # Node ikonu
545
+ │ ├── AzureDevOpsAdvanced.node.ts # Main node implementation
546
+ │ ├── GenericFunctions.ts # API request helper
547
+ │ ├── azureDevOps.svg # Node icon
548
548
  │ └── descriptions/
549
549
  │ ├── GitDescription.ts
550
550
  │ ├── PipelineDescription.ts
@@ -558,38 +558,38 @@ n8n-nodes-azuredevops-advanced/
558
558
  │ └── ArtifactsDescription.ts
559
559
  ├── credentials/
560
560
  │ └── AzureDevOpsAdvancedApi.credentials.ts
561
- ├── dist/ # Derlenmiş JavaScript
561
+ ├── dist/ # Compiled JavaScript
562
562
  ├── package.json
563
563
  └── tsconfig.json
564
564
  ```
565
565
 
566
566
  ---
567
567
 
568
- ## Katkıda Bulunma
568
+ ## Contributing
569
569
 
570
- Katkılarınızı bekliyoruz! Lütfen şu adımları takip edin:
570
+ Contributions are welcome! Please follow these steps:
571
571
 
572
- 1. Repoyu fork edin
573
- 2. Feature branch oluşturun (`git checkout -b feature/amazing-feature`)
574
- 3. Değişikliklerinizi commit edin (`git commit -m 'Add amazing feature'`)
575
- 4. Branch'i push edin (`git push origin feature/amazing-feature`)
576
- 5. Pull Request açın
572
+ 1. Fork the repository
573
+ 2. Create a feature branch (`git checkout -b feature/amazing-feature`)
574
+ 3. Commit your changes (`git commit -m 'Add amazing feature'`)
575
+ 4. Push the branch (`git push origin feature/amazing-feature`)
576
+ 5. Open a Pull Request
577
577
 
578
- ### Bug Bildirimi
578
+ ### Bug Reports
579
579
 
580
- [GitHub Issues](https://github.com/ertekinozturgut/n8n-nodes-azuredevops-advanced/issues) sayfasından bug bildirebilir veya özellik talebinde bulunabilirsiniz.
580
+ You can report bugs or request features via [GitHub Issues](https://github.com/ertekinozturgut/n8n-nodes-azuredevops-advanced/issues).
581
581
 
582
582
  ---
583
583
 
584
- ## Lisans
584
+ ## License
585
585
 
586
- Bu proje [MIT License](LICENSE) altında lisanslanmıştır.
586
+ This project is licensed under the [MIT License](LICENSE).
587
587
 
588
588
  ---
589
589
 
590
- ## Bağlantılar
590
+ ## Links
591
591
 
592
- - [npm Paketi](https://www.npmjs.com/package/n8n-nodes-azuredevops-advanced)
593
- - [GitHub Reposu](https://github.com/ertekinozturgut/n8n-nodes-azuredevops-advanced)
594
- - [Azure DevOps REST API Dokümantasyonu](https://docs.microsoft.com/en-us/rest/api/azure/devops/)
595
- - [n8n Community Nodes Rehberi](https://docs.n8n.io/integrations/community-nodes/)
592
+ - [npm Package](https://www.npmjs.com/package/n8n-nodes-azuredevops-advanced)
593
+ - [GitHub Repository](https://github.com/ertekinozturgut/n8n-nodes-azuredevops-advanced)
594
+ - [Azure DevOps REST API Documentation](https://docs.microsoft.com/en-us/rest/api/azure/devops/)
595
+ - [n8n Community Nodes Guide](https://docs.n8n.io/integrations/community-nodes/)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "n8n-nodes-azuredevops-advanced",
3
- "version": "0.1.1",
3
+ "version": "0.1.2",
4
4
  "description": "Comprehensive Azure DevOps custom node for n8n",
5
5
  "main": "dist/nodes/AzureDevOpsAdvanced/AzureDevOpsAdvanced.node.js",
6
6
  "license": "MIT",